fix(docs-version-sync): use the .git marker for the repo root

[mesutoezdil]

TL;DR

go run -C tools/docs-version-sync . --target main, the command in docs/AGENTS.md, failed with imports.yaml not found. findRepoRoot looked for imports.yaml, which this repository does not use. It now resolves the root from the .git marker, and the imports.yaml references are removed from the root AGENTS.md.

QA

go test ./... in tools/docs-version-sync passes, including TestFindRepoRoot covering .git as a directory, .git as a worktree file, and the not-found case. Verified go run -C tools/docs-version-sync . --target main now runs from a nested directory.

Issues

Closes #549

Summary by CodeRabbit

• Bug Fixes

  • Improved repository detection for documentation version synchronization in standard and worktree-based Git setups.
  • Updated error messages when a repository root cannot be found.

• Tests

  • Added coverage for Git directories, worktree pointers, and missing repository metadata.

• Documentation

  • Clarified guidance for determining ownership and build instructions within nested project areas.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Enterprise

Run ID: cd38e2fb-5601-4656-abbd-80991bba5e50

📥 Commits

Reviewing files that changed from the base of the PR and between 61ac660 and f1805d0.

📒 Files selected for processing (1)

• AGENTS.md

🚧 Files skipped from review as they are similar to previous changes (1)

• AGENTS.md

---

📝 Walkthrough

Walkthrough

Repository guidance now uses nested AGENTS.md files for subtree ownership. findRepoRoot detects .git directory and gitdir-file markers, with tests covering nested traversal, symlink resolution, and missing-marker failures.

Changes

Repository-root resolution

Layer / File(s)	Summary
Root marker detection and validation AGENTS.md, tools/docs-version-sync/main.go, tools/docs-version-sync/main_test.go	Guidance no longer lists imports.yaml. findRepoRoot detects .git markers, and tests cover directory, gitdir-file, nested, symlink, and failure cases.

Estimated code review effort: 2 (Simple) | ~10 minutes

Suggested reviewers: balajinvda

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title uses the required Conventional Commit format and accurately describes the repository-root bug fix.
Linked Issues check	✅ Passed	The changes address issue #549 by using the .git marker, adding coverage, and removing the misleading imports.yaml guidance.
Out of Scope Changes check	✅ Passed	All changes support issue #549 and its documented objectives; no unrelated changes are present.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests

---

_{Comment @coderabbitai help to get the list of available commands.}