Keep the bundle's graph connected and its metadata honest. okq reports the problems; you fix them in the files. See okq-reference for the command contract.

Health checks

okq --bundle <dir> deadlinks   # links pointing at missing/renamed concepts
okq --bundle <dir> orphans     # concepts with no inbound links (stale candidates)
okq --bundle <dir> stats       # distribution, link density, hubs — spot outliers

Clean output means nothing to fix. Run all three after any rename, move, or delete.

Audit a document against the code

The checks above catch structural rot. This catches semantic rot — a doc that parses and links fine but no longer matches what the code does. Do this when auditing a doc, after a feature changes, or when a doc is suspected stale.

okq-maintain

Health checks

Audit a document against the code