Skip to main content

Module graph

Module graph 

Source
Expand description

Comindly graph — the query layer a coding agent actually consumes.

Loads the resolved symbol/edge graph into an in-memory petgraph (built once, queried in microseconds) and answers the questions grep can’t:

  • CodeGraph::ripple — who breaks if I change this? Reverse-reachable callers and importers, multi-hop, across repos. The org-wide blast radius.
  • CodeGraph::thread — what does this do downstream? Forward call trace from an entry.
  • CodeGraph::zoom — show me this symbol in context. Container, members, callers, callees, importers in one structured view.
  • CodeGraph::context_pack — give me exactly what I need to read to change X safely, within a token budget. Personalized-PageRank proximity ranking, greedily packed.

Every result carries an exact file:line location and the signature, so the agent jumps straight to code instead of searching for it.

Structs§

CodeGraph
ContractRole
A symbol’s role in a contract (serves http:GET /x) and the participants on the other side.
ContractView
A contract with everyone on each side.
FlowStep
A step of a flow: the node, how it was reached and from which node.
Hop
A node plus how far it sits from the focus (BFS depth) and via which relation.
Node
A node as returned to callers — flat, printable, agent-friendly.
Zoom
The 360° view of one symbol.

Constants§

DEPENDENCY
Edge kinds meaning “src depends on dst”: what ripple and ranking traverse.
PROVIDES
Provider-side contract roles: the contract depends on its provider, so ripple crosses these against their direction (handler → route → every consumer).

Functions§

is_contract_role
Every contract-role edge kind (provider and consumer side).