topos.mcp.tools.depgraph

Dependency-graph (.gitnexus) status and generation tools.

COMPOSABLE depends on a .gitnexus index. topos_depgraph_status lets an agent discover graph state (missing / present / stale / load_error / schema_mismatch / invalid_dir) without shelling out, and topos_generate_depgraph performs the side-effecting regeneration behind an approval-gated annotation.

topos.mcp.tools.depgraph.topos_depgraph_status(params)

Report .gitnexus availability and freshness (read-only).

Distinguishes a missing graph from a stale one and from a load/schema failure, so an agent knows whether COMPOSABLE can be trusted and what to do next. Never shells out and never mutates state.

topos.mcp.tools.depgraph.topos_generate_depgraph(params)

Generate the .gitnexus dependency graph via GitNexus (side-effecting).

Runs gitnexus analyze in the target directory. Not read-only and not idempotent — intended to be approval-gated by the client. Requires the gitnexus CLI (npm install -g gitnexus).