catalog-repair

Purpose

.memory/

Checks

1. Dead links → topics.md references non-existent files → auto-delete (

   fixed

   )
2. Missing registration → bucket files not indexed in topics.md →

   ai_actions

3. Duplicate topics → same topic header appears multiple times →

   manual_actions

4. Invalid anchors →

   #anchor

   not found in target file →

   ai_actions

   (if close match) or

   manual_actions

Required Flow

memory-hub catalog-repair

Output

• data.fixed

  : auto-fixed items

• data.ai_actions

  : items AI should self-heal

• data.manual_actions

  : items requiring human confirmation

Post-Processing

• ai_actions

  non-empty → AI executes self-healing (register missing files via

  memory.write

  , fix anchors), then runs

  catalog-repair

  again to confirm cleared

• manual_actions

  non-empty → report to user before task ends