Write API reference docs to the nearest .github, not the repo root

[xavierjohn]

Issue

The packed Trellis.ApiReference.targets copies the shipped API-reference markdown to <gitRoot>/.github on build. In a repository whose subfolders are themselves projects - each with its own .github - building a subproject dumps the docs at the OUTER repo root instead of the subproject's own .github.

Fix

Walk up from the project directory and copy to the nearest existing .github, bounded so the search never crosses above the .git repository root (it cannot escape into an unrelated parent). If no .github exists between the project and the repo root, fall back to creating .github/ at the repo root - the previous behavior for a normal single-repo consumer. The TrellisApiReferenceRoot override is unchanged.

Validation

This targets file is identical to the one shipped by the Trellis framework packages; the same change was validated there end-to-end through a packed consumer on a local feed plus an MSBuild harness (nearest-.github selected; root-only unchanged; no-.github falls back to root; a .github above the repo root is not selected; override honored).

[github-actions]

Test Results

102 tests  ±0   102 ✅ ±0   14s ⏱️ -1s
  3 suites ±0     0 💤 ±0 
  3 files   ±0     0 ❌ ±0 

Results for commit c496ad8. ± Comparison against base commit f5f30ba.

♻️ This comment has been updated with latest results.

[Copilot]

Pull request overview

This PR updates the packed MSBuild targets (Trellis.ApiReference.targets) so API reference markdown is copied to the nearest existing .github/ directory above the project (but not above the .git repo root), instead of always targeting the outer repository root .github/. This helps multi-project repositories where subfolders are independent projects with their own .github/.

Changes:

• Adjust destination selection logic to prefer the nearest existing .github/ directory when syncing API reference docs.
• Bound the upward search so it won’t select a .github/ above the nearest .git repository root.
• Preserve the TrellisApiReferenceRoot override behavior while updating how the final output directory is derived.

[codecov-commenter]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 83.52%. Comparing base (7f3e6ce) to head (c496ad8).
⚠️ Report is 4 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff             @@
##             main      #64      +/-   ##
==========================================
+ Coverage   83.37%   83.52%   +0.15%     
==========================================
  Files          24       24              
  Lines         439      443       +4     
  Branches       68       70       +2     
==========================================
+ Hits          366      370       +4     
  Misses         56       56              
  Partials       17       17              

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.