Full Structural
Intelligence
Every command is a precision instrument. Every metric is derived from your actual graph — not heuristics, not approximations.
Full structural pulse via Wasm Tree-sitter, DuckDB graph persistence, and multi-core Map-Reduce. Processes 9,230 nodes and 61,352 edges in 9 seconds. Real-time FS monitoring via MicroPulseService for sub-second re-induction on file change.
Symbol lookup by fuzzy match or regex against the Atom Map. Returns canonical FQN IDs. Named template mode exposes 19 pre-built SQL templates. Filter mode provides a typed builder — agents never write raw SQL.
Weighted Dijkstra pathfinding between any two symbols. Edge weights: call=1.0, import=0.7, inheritance=1.2, db_write=1.5, pub_sub=1.3. Bidirectional blast radius with hop distance and risk score per path.
6-signal composite risk decomposition: Gravity (PageRank), Complexity (cyclomatic), Entropy (Shannon authorship), Churn (commit frequency), FanOut (outbound edges), Debt (marker count). BFS-based test coverage mapping traces from test nodes to production symbols.
Sentinel integrity checks: circular dependency detection via Tarjan SCC, god object detection, orphan export identification. Custom rules via sentinel.json. Longitudinal audit via windowed SQL (LAG + AVG OVER PARTITION). Co-Change Engine surfaces Architectural Lies — files that change together but have no structural edge.
Graph-Verified Refactoring: atomically renames a symbol across all proven callers via IMPORTS + CALLS traversal with rollback on failure. Chronoscopic structural diff between any two pulse IDs. Longitudinal drift analysis tracks entropy spikes and architectural decay.
Cross-repo structural similarity via topological signatures. DAAC Clustering groups files into functional communities (Auth, Billing, Core) by combining call-density graph relationships with directory proximity. Co-Change Engine formula: NCoChange(i,j) = Commits(i,j) / sqrt(Commits(i) · Commits(j)).
Real-time Kinetic Mirror dashboard at port 3333. Force-directed graph with Photon Path focusing, adaptive semantic scaling (namespace labels always visible, symbol labels at zoom ≥ 1.2), Nearest Visible Parent edge promotion, and Neon Glass sidebar. Skeleton & Meat: topology in RAM, full metadata on-click.
MCP JSON-RPC server with HyperToon registry and live tool description loading — updating docs auto-updates agent understanding without restart. Federated linking via Additive Hydration merges multiple synapses without overwriting. Verified: 5,000 foundation nodes merged into a 1,624-node target (6,624 total).
9 Unified 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_status | Analysis | Hotspots, structural pillars, entry points, layer distribution, anomaly summary |
| conducks_query | Discovery | Symbol lookup, namespace scoping, template mode (19 templates), filter mode |
| conducks_explain | Metrics | 6-signal risk decomposition, bus factor, staleness, commit entropy |
| conducks_impact | Kinetic | Blast radius upstream/downstream, hop distance, risk-by-path |
| conducks_trace | Kinetic | Pathfinding, execution circuits, data flow chains via PULSES_TO edges |
| conducks_audit | Governance | Sentinel checks, cycle detection, god objects, Architectural Lies, archeology mode |
| conducks_evolution | Evolution | GVR rename, structural diff by pulse ID, drift analysis |
| conducks_system | System | Architecture context generation, installer, multi-workspace federation |
| conducks_link | Federation | Federated repo linking, cross-synapse edge resolution, Additive Hydration |