Indexing¶
Commands that build and maintain the axiom-graph index.
axiom-graph¶
Axiom-graph – project knowledge indexer for AI agents.
Usage
axiom-graph [OPTIONS] COMMAND [ARGS]...
init¶
Initialise (or re-initialise) the axiom-graph index for PROJECT_ROOT.
Creates .axiom_graph/graph.db, runs a full scan, and establishes code_hash/desc_hash baselines for every node. This is the safe first-run command.
If the database already exists, prompts for confirmation before wiping and rebuilding all baselines.
Usage
axiom-graph init [OPTIONS] PROJECT_ROOT
Options
- --id <project_id>¶
Project ID prefix (default: directory name)
Arguments
- PROJECT_ROOT¶
Required argument
build¶
Scan PROJECT_ROOT and add newly-discovered nodes/edges.
Always runs in discovery-only mode: only new nodes are inserted, existing ones are untouched (staleness signals preserved). Edges are always updated.
To reset all baselines, use axiom-graph init instead.
Usage
axiom-graph build [OPTIONS] PROJECT_ROOT
Options
- --id <project_id>¶
Project ID prefix (default: directory name)
- --purge¶
Remove NOT_FOUND nodes after build
Arguments
- PROJECT_ROOT¶
Required argument
check¶
Report per-node staleness / confidence status (two-dimensional).
By default only non-VERIFIED nodes are shown. Pass –all for a full inventory. A summary line is always printed first.
Usage
axiom-graph check [OPTIONS] PROJECT_ROOT
Options
- --all¶
Show all nodes including VERIFIED (default: problems only).
- --fail-on <fail_on>¶
Exit 1 if matching problem nodes remain after verification promotion.
- Default:
'none'- Options:
none | stale | unverified | any
- --format <output_format>¶
Output format.
- Default:
'text'- Options:
text | json
- --strict-annotations¶
Exit 1 if any annotation finding surfaced (composable with –fail-on=stale).
Arguments
- PROJECT_ROOT¶
Required argument
mark-clean¶
Mark NODE_ID as manually verified clean (MANUAL_VERIFIED).
Usage
axiom-graph mark-clean [OPTIONS] NODE_ID PROJECT_ROOT
Options
- --reason <reason>¶
Why the documentation is still accurate.
Arguments
- NODE_ID¶
Required argument
- PROJECT_ROOT¶
Required argument
link¶
Add a typed edge from FROM_NODE_ID to another node.
The edge type must be a valid ontology edge and the from/to node types must satisfy the ontology rules – an error is raised otherwise.
Example (test validates production code)::
- axiom-graph link pm_mvp::tests.test_db::test_get_engine
–edge-type validates –to pm_mvp::pm.database::get_engine .
Usage
axiom-graph link [OPTIONS] FROM_NODE_ID PROJECT_ROOT
Options
- --edge-type <edge_type>¶
Required Edge type from the ontology (validates, documents, constrains, supersedes, …).
- --to <to_node_id>¶
Required Target node ID.
Arguments
- FROM_NODE_ID¶
Required argument
- PROJECT_ROOT¶
Required argument
checkout¶
Copy the axiom-graph DB into WORKTREE_PATH via VACUUM INTO.
Usage
axiom-graph checkout [OPTIONS] WORKTREE_PATH
Options
- -p, --project-root <project_root>¶
Source project root.
- --force¶
Overwrite existing DB in target.
Arguments
- WORKTREE_PATH¶
Required argument