[efraespada]

Generated repository guidance now links to shared Copilot documentation at canonical HTTPS URLs, so contributors in target repositories can open those pages without a copied documentation tree. Setup can also safely upgrade unchanged, setup-owned legacy guides while preserving the existing conflict behavior for edited or unowned files.

What changed

• Point shared documentation links in generated guides to the canonical vypdev/copilot pages on master, while keeping links to installed artifacts local.
• Document how setup upgrades hash-owned legacy guides, backs them up, and preserves edited or unowned guides.
• Refresh the collaboration contract, catalog evidence, checked-in guide, and packaged CLI and Action bundles.
• Add regression coverage for links in targets without a documentation tree and safe legacy guide upgrades.

Validation

• Guidance and setup file tests: 49 passed.
• Full mandatory build, test, and lint checks passed: 630 suites and 9,441 tests; 35 existing tests were skipped. Normal commit hooks passed.
• TypeScript, documentation, specification/catalog, and generated-bundle validators passed.
• npm package validation and packaged CLI/API/local web smoke checks passed.
• Source documentation paths were verified through GitHub; Graphify AST was updated.

Closes #539

[docs-page]

To preview the documentation for this pull request, visit the following URL:

docs.page/vypdev/copilot~540

Documentation is deployed and generated using docs.page

[vypbot]

Copilot approval · Human review needed

Status: A protected workflow, policy, or trust-boundary file changed.
Completed: 1/1 observed checks succeeded; Bugbot complete.
Action required: Ask a human reviewer to decide.
Impact: No new approval is confirmed for this revision.
See checks

Technical evidence

Revision: 15aec2949dfe; base: 605bd0f8539a; reason: protected-path.

[codecov-commenter]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 93.37%. Comparing base (274db40) to head (15aec29).
⚠️ Report is 1443 commits behind head on develop.

Additional details and impacted files

@@             Coverage Diff             @@
##           develop     #540      +/-   ##
===========================================
+ Coverage    90.94%   93.37%   +2.43%     
===========================================
  Files          135      896     +761     
  Lines         6251    27907   +21656     
  Branches      1338     8120    +6782     
===========================================
+ Hits          5685    26059   +20374     
- Misses         172      733     +561     
- Partials       394     1115     +721     

Files with missing lines	Coverage Δ
...ation/policies/repository_agent_guidance_policy.ts	100.00% <ø> (ø)

... and 962 files with indirect coverage changes

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[vypbot]

Bugbot: review complete

Current status: No active findings on 15aec29.

Pull request · Verified commit · Workflow run