Full Structural
Intelligence
Every command is a precision instrument. Every metric is derived from your actual graph, not heuristics, not approximations.
Parse the repo with Tree-sitter, persist the graph to a local DuckDB vault, and re-index on file change as you work. A regex fallback keeps extraction working when a grammar query can't compile.
Look up any symbol by name or pattern and get its canonical graph ID. Query templates cover the common questions so agents don't have to write raw SQL.
Find the call and import paths between any two symbols using weighted edges. Bidirectional blast radius with hop distance and a risk score per path.
A 6-signal risk score per symbol: gravity (PageRank), cyclomatic complexity, authorship entropy, churn, fan-out, and debt markers, combined into one number you can act on.
Detect circular dependencies via Tarjan SCC, god objects, and orphaned exports. Add your own rules, surface refactor advice, and block commits when structural risk climbs too high.
Rename a symbol across every proven caller with a dry-run preview before anything changes. Prune dead code, and diff the structure between two analyses to see what moved.
Group files into functional clusters by combining call density with directory proximity, and surface structural similarity across repositories.
A real-time, force-directed Mirror dashboard of the graph at localhost:3333, topology held in memory, full symbol metadata loaded on click. Plus static blueprint and context exports.
Run the MCP server with live tool descriptions, link multiple repositories into one graph, and scaffold project setup and documentation.
13 MCP Tools
All agent interactions go through these tools. No raw SQL. No filesystem access. Pure structural intelligence over JSON-RPC.
| Tool | Domain | Capabilities |
|---|---|---|
| conducks_query | Discovery | Search the graph for symbols by name or pattern. Fuzzy and template modes. |
| conducks_status | Analysis | Structural health: hotspots, entry points, and layer distribution. |
| conducks_explain | Metrics | 6-signal risk breakdown for a single symbol. |
| conducks_impact | Tracing | Blast radius upstream and downstream, with hop distance and risk per path. |
| conducks_trace | Tracing | Trace execution or data flow from a symbol; pathfind between two. |
| conducks_audit | Governance | Circular dependencies, god objects, orphans, and custom rule checks. |
| conducks_context | Discovery | Collect structural context around a symbol within a graph radius. |
| conducks_flows | Tracing | List execution flows, each a named entry point and the symbols it calls. |
| conducks_prune | Evolution | Find dead code: orphaned symbols, unused exports, and stale imports. |
| conducks_diff | Evolution | Structural diff against previous graph states. |
| conducks_rename | Evolution | Graph-verified rename across all structural references. |
| conducks_graph_query | Discovery | Run a raw SELECT against the DuckDB graph store. |
| conducks_guide | Guidance | Architectural guidance: engineering standards and rules. |