Docs: AGENTS.md/GOTCHAS.md claim &+N parsing is TODO but it's implemented

[unclesp1d3r]

Summary

AGENTS.md and GOTCHAS.md both claim that magic-file &+N / &-N relative-offset parsing is "still TODO". This is stale — parsing has been implemented and is exercised by parse_offset_relative_* tests in src/parser/grammar/tests/mod.rs:292-305 (covers &0, &4, &+4, &-4, &0x10, &-0x10).

Locations

• AGENTS.md:245 — "Magic-file &+N/&-N parsing is still TODO -- relative offsets are exercised programmatically through the AST."
• GOTCHAS.md:147 (S3.11) — example uses "a child using unsupported &+N relative-offset syntax" as the canonical fail-fast trigger.

Acceptance Criteria

• AGENTS.md "Current Limitations" → "Offset Specifications" updated to reflect that &+N/&-N parsing works
• GOTCHAS.md S3.11 example changed to a still-unsupported syntax (e.g., $VAR substitution per S3.6, which remains a real fail-fast trigger)
• No code changes — purely docs

Refs

• Discovered during Evaluator: ZIP content inspection for compound document detection #51 scope audit
• Working tests: src/parser/grammar/tests/mod.rs:292-305

[coderabbitai]

🔗 Related PRs

#4 - feat: add development infrastructure, automation hooks, and comprehensive documentation [merged]
#33 - Documentation: comprehensive mdbook rewrite, rustdoc fixes, and test stability [merged]
#199 - feat(evaluator): implement indirect offset resolution (#37) [merged]
#215 - fix(regex): PR #214 follow-up review findings [merged]
#233 - fix: load and correctly evaluate /usr/share/file/magic/filesystems and adjacent magic files [merged]

---

🧪 Issue enrichment is currently in open beta.

You can configure auto-planning by selecting labels in the issue_enrichment configuration.

To disable automatic issue enrichment, add the following to your .coderabbit.yaml:

issue_enrichment:
  auto_enrich:
    enabled: false

💬 Have feedback or questions? Drop into our discord!