KB Health

Audit the knowledge base for structural and content issues. Reports problems and, with --fix, repairs what can be fixed automatically (broken links, missing index entries). Human review is required for content issues (stale claims, empty sections).

Triggers

• "check KB health" → full audit
• "find orphan pages" → orphan check only
• "regenerate KB index" → --index-only
• /kb-health → direct invocation

Parameters

--path <subtree> (optional)

Scope the check to a subdirectory (e.g., --path .aiwg/kb/entities/). Defaults to full KB root.

--kb <path> (optional)

Root of the knowledge base. Default: resolved by aiwg kb path (#965), which reads resolveStorage('kb') and honors any roots.kb override in .aiwg/storage.config. On the default fs backend this is .aiwg/kb/.