update-source-map

Run the regenerate.py script with the workspace root path, for example python3 scripts/regenerate.py <workspace_root>. It auto-detects whether to create or update, scans the workspace, and writes SOURCE_MAP.md, source_map.json, and curated_summaries.json into the x_temp output directory.

Re-run the same regenerate command; the skill detects existing SOURCE_MAP.md and source_map.json files and switches to update mode automatically. The new output includes a diff section listing added and removed files, and existing curated summaries are preserved.

No, PDF files are indexed by metadata only, including size and modification date. The skill never reads PDF binary contents, and only Markdown files get word counts and H2/H3 heading extraction.

By default the scan skips node_modules, .git, .venv, dist, build, __pycache__, notes.assets, and x_temp directories, plus .DS_Store files. You can add custom exclusions with the --exclude flag or change scanned extensions with --ext.

No, curated_summaries.json entries are loaded and preserved across every regeneration in update mode. Only entries pointing to files that no longer exist are dropped, and new files simply start without a curated entry.

No, the skill only writes inside its output directory, defaulting to x_temp. It never modifies files elsewhere in the workspace and explicitly skips files whose names contain markers like no modify, no-edit, or readonly.