fix-refslisted

# /fix refs ## Instructions ### 1. Run the reference checker ```bash python3 src/scripts/check_references.py --format json ``` ### 2. Parse findings If output is `[]` or "No broken references found": ``` ✅ No broken references found. All cross-references are valid. ``` Stop here. ### 3. Display findings ``` ═══════════════════════════════════════════════ 🔗 BROKEN REFERENCE REPORT ═══════════════════════════════════════════════ Found: {count} broken reference(s) ``` Group by file: ``` {file}: Line {line}: `{ref}` ({ref_type}) → suggested: `{suggestion}` Line {line}: `{ref}` ({ref_type}) → no suggestion ``` ### 4. Auto-fix with confirmation For each broken reference: 1. **If suggestion exists** → open the file, find the line, replace the broken ref with the suggestion. 2. **If no suggestion** → search the codebase for the closest match. If found, propose it. If not, flag for manual review. 3. **If the reference is in a code block** → skip (code blocks are not cross-references). 4. **If the reference is in an example/template** → skip (placeholders are intentional). Present a summary before applying: ``` Proposed fixes: 1. {file}:{line} — `{old}` → `{new}` 2. {file}:{line} — `{old}` → `{new}` 3. {file}:{line} — MANUAL: no match found > 1. Apply all automatic fixes > 2. Apply interactively (ask for each) > 3. Skip — just show the report ``` ### 5. Apply fixes Edit files in `.agent-src.uncondensed/` (source of truth). Regenerate `dist/age