Purpose

Update the code module index from AI-generated JSON. Only touches the code modules section of topics.md, not the knowledge files section.

Input

JSON file with schema:

{ "modules": [ { "name": "module-name", "summary": "One-line description", "files": [ {"path": "src/file.py", "description": "What this file does"} ] } ] }

Required Flow

Step 1: Write JSON to a temporary file

Use the file write tool to create a JSON file (e.g. /tmp/modules.json ).

Step 2: Run catalog-update

memory-hub catalog-update --file /tmp/modules.json

Automatically triggers catalog.repair after completion.

Output

JSON envelope with data.modules_written , data.modules_deleted , and repair results.

Error Handling

• FILE_NOT_FOUND → JSON file not found

• INVALID_JSON → file is not valid JSON

• INVALID_SCHEMA → modules is not an array