Edge cases

Notes on unusual situations and how the tool behaves.

Solved

Problems we hit early and fixed deliberately:

• Per-file const maps for static keys — why merged-repo scans are weaker than per-file scans for template rebuilds.
• CLI --json command parity — COMMANDS_WITH_JSON_OUTPUT vs human-only paths; fill / printCommandSummary / single-document stdout for scripts.

When to add a page

Add a solved/ page when:

• The bug or confusion was real in production or review, and
• The fix is stable and worth remembering for future contributors and agents.

Skip documenting one-off test quirks unless they affect users.