CLI

The codingest command builds a .kgl code graph from a checkout or from git revision(s), and checks whether an existing graph is stale. It’s a port of KGLite’s former kglite code-tree subcommand.

Two ways to install the exact same command:

pip install codingest           # the Python wheel bundles the `codingest` command
# or
cargo install codingest-cli     # pure-Rust binary, no Python

The wheel links the codingest-cli Rust library into its extension and exposes it through a console-script shim, so pip install codingest gives you the same codingest build/status command as cargo install codingest-cli — no separate install. This makes the pip-only flow pip install kglite codingest && kglite skill install self-sufficient (the installed code-review skill shells out to codingest build/status).

(Requires kglite 0.14.0 on crates.io — see the home page.)

codingest build

Parse a directory into a graph and write it to a .kgl:

codingest build /path/to/repo
# → /path/to/repo/.kglite/code-review.kgl

Build committed content at specific git revisions — a multi-rev merged graph with one node per entity across revs (each node carries revs: [str] membership; scope a query with WHERE 'v2.0' IN n.revs):

codingest build /path/to/repo --revs v1.0 v2.0

Common options:

  • --output <path> — where to write the .kgl (default <repo>/.kglite/code-review.kgl).

  • --rev <revspec> — build a single git revision instead of the working tree.

  • --revs <r1> <r2> … — merge several revisions into one graph.

  • --include-docs — also ingest markdown as :Doc nodes linked to the code they mention.

  • --no-tests — exclude test files/dirs from the graph.

Run codingest build --help for the full flag list.

codingest status

Report whether a previously-built graph is stale relative to the current tree (so a wrapper can decide whether to rebuild):

codingest status /path/to/repo

Querying the result

The output is an ordinary kglite .kgl — query or inspect it with any kglite surface:

kglite query /path/to/repo/.kglite/code-review.kgl \
  "MATCH (f:Function)-[:CALLS]->(g:Function) RETURN f.name, g.name LIMIT 20"

or in Python, kglite.load("…/.kglite/code-review.kgl").

Accuracy harness

The codingest library crate also ships codingest_stats, a JSON accuracy harness (CALLS-resolution stats + node/edge counts) used by the determinism gate:

cargo run -p codingest --bin codingest_stats --release -- /path/to/repo