wiki-rebuild

name	wiki-rebuild
description	Regenerate Deep Wiki derived catalogs from page frontmatter with one token-owned journaled transaction and a rebuild lifecycle record. Use for /wiki-rebuild, stale catalog repair, or wiki reindexing.
user-invocable	true
runtime_hosts	["claude","codex"]

wiki-rebuild

Pages and provenance are authoritative; catalogs are derived. Rebuild all derived artifacts with one transaction so no caller can expose a new catalog without its matching lifecycle record.

Procedure

Acquire one owner token.

{"executable":"node","argv":["<plugin_root>/scripts/wiki-runtime.js","lock","acquire","--wiki-root","ABSOLUTE_WIKI_ROOT","--operation","rebuild","--json"]}

Create one manifest with a stable operation_id. The state engine scans page frontmatter, refreshes both human and machine derived artifacts, versions any replaced content, and records one wiki-wide action in the same journal.

{"operation":"rebuild","operation_id":"01JZ7P9Q6MD7S5PB8H4Y40HJ84","pages":[],"sources":[],"events":[{"event_id":"01JZ7P9Q6MD7S5PB8H4Y40HJ85","ts":"2026-07-11T00:00:00Z","action":"rebuild","source":null,"pages_created":[],"pages_updated":[]}],"refresh_index":true,"promote_pending_scan":null}

Submit that manifest exactly once.

{"executable":"node","argv":["<plugin_root>/scripts/wiki-runtime.js","commit","--wiki-root","ABSOLUTE_WIKI_ROOT","--lock-token","LOCK_TOKEN","--manifest-file","ABSOLUTE_MANIFEST_FILE","--json"]}

On interruption, inspect the owner and recover the same journaled operation; never manufacture a second operation identifier.

{"executable":"node","argv":["<plugin_root>/scripts/wiki-runtime.js","lock","status","--wiki-root","ABSOLUTE_WIKI_ROOT","--json"]}

{"executable":"node","argv":["<plugin_root>/scripts/wiki-runtime.js","transaction","recover","--wiki-root","ABSOLUTE_WIKI_ROOT","--lock-token","LOCK_TOKEN","--operation-id","01JZ7P9Q6MD7S5PB8H4Y40HJ84","--json"]}

After terminal success, run read-only diagnostics. Any repair remains a separate explicit /wiki-lint --fix request.

{"executable":"node","argv":["<plugin_root>/scripts/wiki-runtime.js","lint","inspect","--wiki-root","ABSOLUTE_WIKI_ROOT","--json"]}

Release in a guaranteed final step with the matching token.

{"executable":"node","argv":["<plugin_root>/scripts/wiki-runtime.js","lock","release","--wiki-root","ABSOLUTE_WIKI_ROOT","--token","LOCK_TOKEN","--json"]}