docs(#5762): add missing status flags, manifest fields, and init examples - #5764
Conversation
…ples Add repos status flags (--manifest/-f, --json, --repo, --concurrency) to the cli-internals.md command tree, matching the pattern used by diff and sync. Add inference_project and inference_region to the multi-forge manifest example in repo-management.md. Add --mint-url to the primary repos init examples in repo-management.md and docs/cli/repos.md. Note: pre-commit could not run in sandbox (network restriction). The post-script runs an authoritative pre-commit check. Closes #5762
|
🤖 Finished Review · ✅ Success · Started 2:18 PM UTC · Completed 2:30 PM UTC |
Site previewPreview: https://e6a58d52-site.fullsend-ai.workers.dev Commit: |
Codecov Report✅ All modified and coverable lines are covered by tests. 📢 Thoughts on this report? Let us know! |
|
Looks good to me Labels: PR modifies documentation files under docs/ only |
|
--mint-url was made a default for a reason, this tool is brining it back without a default? |
|
🤖 Finished Retro · ✅ Success · Started 2:44 PM UTC · Completed 2:59 PM UTC |
Retro: PR #5764 — docs(#5762): add missing status flags, manifest fields, and init examplesWorkflow outcome: Efficient, successful docs-only PR. 38 minutes from issue filing to merge, $4.77 total agent cost across triage + code + review. Timeline
What went well
One gap identified — already trackedPost-merge editorial concern: rh-hemartin commented that The review agent's correctness sub-agent verified Note: the issue author (ggallen) explicitly requested this change ("Greenfield setups need this flag") and approved the PR, so this is fundamentally a maintainer editorial disagreement rather than a systemic agent failure. Autonomy assessmentThe review agent's approval matched the first human reviewer's (ggallen) approval. The editorial concern raised by rh-hemartin post-merge reflects domain knowledge about CLI design intent that is difficult to encode in agent instructions. No autonomy change is warranted from this single PR — the review agent performed well on technical accuracy for a docs-only change. |
Summary
Fix three documentation gaps in repos management docs identified in the audit for PR #5741.
Changes
cli-internals.md: Add--manifest/-f,--json,--repo, and--concurrencyflags underrepos statusin the command tree, matching the pattern used bydiffandsyncrepo-management.md: Addinference_projectandinference_regionto the multi-forge manifest YAML example underforge.githubrepo-management.md+docs/cli/repos.md: Add--mint-url <MINT_URL>to the primaryrepos initexamples (getting started and migration sections)Testing
repos statusflags against implementation ininternal/cli/repos.go(lines 222-225)inference_project/inference_regionfields exist ininternal/repos/manifest.go(lines 67-68)--mint-urlflag is registered inrepos initcommand tree incli-internals.mdChecklist
!for breaking changes)Closes #5762
Post-script verification
agent/5762-fix-repos-doc-gaps)2843dc797bbd8b74d72b5984023aa216db73c147..HEAD)