Purpose

Check and fix consistency of the topics.md index against actual .memory/ files.

Checks

• Dead links → topics.md references non-existent files → auto-delete (fixed )

• Missing registration → bucket files not indexed in topics.md → ai_actions

• Duplicate topics → same topic header appears multiple times → manual_actions

• Invalid anchors → #anchor not found in target file → ai_actions (if close match) or manual_actions

Required Flow

memory-hub catalog-repair

Output

JSON envelope with:

• data.fixed : auto-fixed items

• data.ai_actions : items AI should self-heal

• data.manual_actions : items requiring human confirmation

Post-Processing

After receiving results:

• ai_actions non-empty → AI executes self-healing (register missing files via memory.index , fix anchors), then runs catalog-repair again to confirm cleared

• manual_actions non-empty → report to user before task ends