Name the Off-Grammar --branch Outcome in AUDIT.md

[ptr727]

Summary

The --branch paragraph in AUDIT.md named two outcomes of a --branch value: a ref that resolves, and a ref that does not resolve. It did not name the third, a value off the groundTruthBranch grammar, which spec/audit.py refuses before any read with exit 2 and one stderr line. This adds one sentence naming that outcome and where the grammar lives, GROUND_TRUTH_BRANCH_PATTERN in spec/validate.py.

The issue places the paragraph in section 1. It sits in section 8 ("Report"), and the edit is made where the paragraph actually is.

Verification

• python3 spec/audit.py --branch 'a/../zen' ProjectTemplate printed one stderr line and exited 2, before any read.
• scripts/prose_lint.py --diff origin/develop, scripts/repo_gate.py --check eol, spec/validate.py, and scripts/docker_lint.py (markdownlint, cspell) all pass.
• Two local-strict-review passes ran over the branch diff and are recorded. The first found the new sentence over the 25-word cap, so it is split in two. The second found nothing.

Closes on promotion: #1509

🤖 Generated with Claude Code

[coderabbitai]

Warning

Review limit reached

You've used all free OSS reviews for now. Wait for the free limit to reset to keep reviewing this public repository.

Next included review available in 38 minutes.

Check out review usage here.

View limit details

Limit details: You’ve used the included review currently available.

Learn how review limits work.

Review configuration:

⚙️ Run configuration

• Configuration used: Repository: ptr727/ProjectTemplate/.coderabbit.yaml
• Review profile: CHILL
• Plan: Advanced
• Run ID: 3d30916f-f2b0-42d3-a510-0bc19ab23c04

---

📥 Commits

Reviewing files that changed from the base of the PR and between ff99b26 and 9d2d4d4.

---

📒 Files selected for processing (1)

• AUDIT.md

---

• Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

---

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

[Copilot]

🟢 Approval recommended

No unresolved review issues remain.

0 open findings

What changed in this PR

Documents the invalid --branch outcome in AUDIT.md, including its grammar source and validation behavior.

Changes:

• Names GROUND_TRUTH_BRANCH_PATTERN.
• Documents rejection before reads with exit code 2.

File	Description
AUDIT.md	Clarifies invalid --branch handling.

🧠 Review effort: Lite

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
⚠️ Please upload report for BASE (develop@ff99b26). Learn more about missing BASE report.

Additional details and impacted files

@@            Coverage Diff             @@
##             develop    #2695   +/-   ##
==========================================
  Coverage           ?   59.58%           
==========================================
  Files              ?       16           
  Lines              ?     8317           
  Branches           ?        0           
==========================================
  Hits               ?     4956           
  Misses             ?     3361           
  Partials           ?        0           

Flag	Coverage Δ
python-3.13	59.58% <ø> (?)

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ 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.

[ptr727]

@coderabbitai review

[coderabbitai]

⚠️ Action not completed

Review rate limited.

Note: CodeRabbit is an incremental review system and does not re-review already reviewed commits. This command is applicable only when automatic reviews are paused.