Inspection¶

Commands that query the graph.

axiom-graph¶

Axiom-graph – project knowledge indexer for AI agents.

Usage

axiom-graph [OPTIONS] COMMAND [ARGS]...

list¶

List nodes, optionally filtered by type or tag.

Usage

axiom-graph list [OPTIONS] PROJECT_ROOT

Options

--type <node_type>¶: Filter by node type.

--tag <tag>¶: Filter by tag.

Arguments

PROJECT_ROOT¶: Required argument

graph¶

Show the edge graph for NODE_ID.

Usage

axiom-graph graph [OPTIONS] NODE_ID PROJECT_ROOT

Options

--direction <direction>¶

Default:: 'out'
Options:: in | out | both

--depth <depth>¶

Default:: 1

Arguments

NODE_ID¶: Required argument

PROJECT_ROOT¶: Required argument

report¶

Impact report: what changed since a checkpoint, SHA, or datetime.

Resolution order: –since-sha (checkpoint with matching SHA), then –since (datetime), then the most recent checkpoint. If no reference point exists, all history is included.

Usage

axiom-graph report [OPTIONS] PROJECT_ROOT

Options

--since-sha <since_sha>¶: Git SHA (prefix) of a checkpoint to start from.

--since <since_timestamp>¶: ISO-8601 datetime cutoff.

--format <output_format>¶

Output format.

Default:: 'text'
Options:: text | json

--change-type <change_type_pattern>¶: Glob pattern for change types (e.g. STALE, LINK_*, AGENT_*).

--node <node_pattern>¶: Glob pattern for node IDs (e.g. axiom_graph::axiom_graph.viz.*).

--node-type <node_type_filter>¶

Filter to nodes of this type.

Options:: atomic_process | composite_process | entity

--list-refs¶: List available reference points (SHAs/checkpoints) and exit.

Arguments

PROJECT_ROOT¶: Required argument

history¶

Manage and inspect node change history.

Usage

axiom-graph history [OPTIONS] COMMAND [ARGS]...

agent-verified¶

List nodes whose most-recent history row is AGENT_VERIFIED (pre-push gate).

Usage

axiom-graph history agent-verified [OPTIONS] PROJECT_ROOT

Arguments

PROJECT_ROOT¶: Required argument

checkpoint¶

Insert a CHECKPOINT semantic marker on qualifying nodes.

Records the current timestamp and HEAD git SHA as a preserved CHECKPOINT row on each matching node. No history rows are deleted; the 100-row hard cap in upsert_node_conn is the only pruning mechanism.

Usage

axiom-graph history checkpoint [OPTIONS] PROJECT_ROOT

Options

--node-types <node_types>¶

Comma-separated node types to apply to.

Default:: 'atomic_process,composite_process'

-m, --message <message>¶: Optional message stored in checkpoint meta.

Arguments

PROJECT_ROOT¶: Required argument