Semantic – Reducing LLM "Agent Loops" by 27.78% via AST Logic Graphs

Summary

Semantic Agent Cognitive Layer (MVP) Local Rust service for deterministic code retrieval by symbol, span, and logic graph. IDE Semantic-First Integration Use the semantic-first integration guide for RooCode/KiloCode/Codex/Claude wiring, middleware policy controls, and end-to-end flow diagrams: docs/IDE_SEMANTIC_FIRST.md docs/TOOL_CALLING_GUIDE.md (objective + usage of API and MCP tool callings) docs/AB_TEST_DEV_RESULTS.md (development benchmark history and latest metrics) engine shared contracts parser Tree-sitter extraction storage SQLite + Tantivy indexer repo indexing orchestration retrieval operation handlers watcher incremental file updates api Axum JSON service Implemented semantic layers now include logic nodes, persisted control/data-flow edges, semantic node labels, and graph-backed clustering/ranking. cargo run -p api -- ./test_repo Service binds to $SEMANTIC_API_BASE_URL. Optional Project Summariser Add-On A companion crate (project_summariser) generates a compact, LLM-ready project map at session start — no LLM call required, built entirely from the existing index. curl "$SEMANTIC_API_BASE_URL/project_summary?max_tokens=800&format=markdown" Or via MCP retrieve tool: { "operation": "GetProjectSummary", "max_tokens": 800 } Or prepended automatically on ide_autoroute with include_summary=true: { "task": "add due date to tasks", "include_summary": true } Output (~400–800 tokens): per-file purpose sentence, top symbols, project narrative, module dependency sketch. JSON and markdown formats supported. See semantic_project_summariser/PLAN.md (sibling folder) for the full design. Optional Token Tracking Add-On An optional local companion in this repository can track token usage per task across retrieve, ide_autoroute, and edit. Copy .semantic/token_tracking.example.toml to .semantic/token_tracking.toml. Set enabled = true. Run the core API as usual. Run the dashboard: cargo run -p token_tracking -- ./test_repo Telemetry is written as NDJSON to .semantic/token_tr...