Skip to content

Local code intelligence for developers and AI agents. Connect code, docs and infrastructure in a persistent graph, with CBM Lens, MCP tools, agent integrations and change-aware test selection.

Merge origin/main into feat/infra-graph

Martin Vogel8a7cbab13b87
diff --cc README.md
index 3f3b6c6b7,1ef376d9a..39e0eb1f2
--- a/README.md
+++ b/README.md
@@@ -35,8 -35,8 +35,8 @@@ High-quality parsing through [tree-sitt
- **162 languages** — vendored tree-sitter grammars compiled into the binary. Nothing to install, nothing that breaks.
- **120x fewer tokens** — 5 structural queries: ~3,400 tokens vs ~412,000 via file-by-file search. One graph query replaces dozens of grep/read cycles.
- **45 supported automatic/conditional client surfaces** — `install` configures detected clients and safely activates conditional clients only when their documented platform, marker, or explicit existing config path is present. See [Multi-Agent Support](#multi-agent-support) for the complete matrix and manual/UI-only boundaries.
- - **Built-in graph visualization** — 3D interactive UI at `localhost:9749`, served from the binary itself.
+ - **CBM Atlas** — the built-in human interface at `localhost:9749`: a reading IDE over the index (explorer and read-only Monaco reader, a semantic twin that follows the caret, flow, bug-hunt and change-scope reading modes, the 3D galaxy, source-cited answers, project management), served from the binary itself.
-- **Infrastructure-as-code indexing** — Dockerfiles, Kubernetes manifests, and Kustomize overlays indexed as graph nodes with cross-references. `Resource` nodes for K8s kinds, `Module` nodes for Kustomize overlays with `IMPORTS` edges to referenced resources.
+- **Infrastructure-as-code indexing** — Dockerfiles, container images, docker compose, Kubernetes manifests, and Kustomize overlays indexed as graph nodes with cross-references. `Resource` nodes for K8s kinds and compose services, `Image` nodes joining the images that are built and run, `Module` nodes for Kustomize overlays with `IMPORTS` edges to referenced resources — a Service walks to the program its container runs.
- **17 MCP tools** — search, trace, architecture, impact analysis, targeted index-coverage checks, Cypher queries, dead code detection, cross-service HTTP linking, ADR management, and more.
## Quick Start
diff --cc src/mcp/mcp.c
index 5d7b4c158,e89120eee..4bd085a26
--- a/src/mcp/mcp.c
+++ b/src/mcp/mcp.c
@@@ -562,9 -564,6 +564,8 @@@ static const tool_def_t TOOLS[] =
"\"query\":{\"type\":\"string\"},"
"\"label\":{\"type\":\"string\"},\"name_pattern\":{\"type\":\"string\"},\"qn_pattern\":{"
"\"type\":\"string\"},\"file_pattern\":{\"type\":\"string\"},"
- "\"kind\":{\"type\":\"string\",\"description\":\"Infra object kind of a Resource, e.g. "
- "Deployment, HelmRelease.\"},\"namespace\":{\"type\":\"string\",\"description\":"
- "\"Effective Kubernetes namespace of a Resource.\"},"
++ "\"kind\":{\"type\":\"string\",\"description\":\"Resource kind, e.g. Deployment.\"},"
++ "\"namespace\":{\"type\":\"string\",\"description\":\"Resource namespace.\"},"
"\"relationship\":{\"type\":\"string\"},\"min_degree\":{\"type\":\"integer\"},"
"\"max_degree\":{\"type\":\"integer\"},\"exclude_entry_points\":{\"type\":\"boolean\"},"
"\"include_connected\":{\"type\":\"boolean\"},\"semantic_query\":{"
@@@ -622,13 -621,8 +623,12 @@@
"\"cursor\":{\"type\":\"string\",\"description\":\"Pass next/next_cursor with traversal "
"args unchanged; budget may increase.\"},"
"\"mode\":{"
- "\"type\":\"string\",\"enum\":[\"calls\",\"data_flow\",\"cross_service\"],\"default\":"
- "\"calls\",\"description\":\"calls, argument-aware data_flow, or service edges.\"},"
+ "\"type\":\"string\",\"enum\":[\"calls\",\"data_flow\",\"cross_service\",\"topology\","
+ "\"deploy\",\"run\"],"
- "\"default\":\"calls\",\"description\":\"calls, argument-aware data_flow, service edges, "
- "topology: infra objects, routes and controllers (start at a Resource or Route), "
- "deploy: scripts, make targets and charts a CI job, script or rule runs and deploys, or "
- "run: what a Service or workload runs (image, Dockerfile, the program and its "
- "environment).\"},"
++ "\"default\":\"calls\",\"description\":\"calls; argument-aware data_flow; service edges; "
++ "topology: infra objects, routes, controllers (from a Resource/Route); deploy: what CI "
++ "jobs and scripts run and deploy; run: what a Service runs (image, Dockerfile, program, "
++ "env).\"},"
"\"parameter_name\":{\"type\":\"string\",\"description\":\"data_flow parameter filter.\"},"
"\"edge_types\":{\"type\":\"array\",\"items\":{"
"\"type\":\"string\"}},\"risk_labels\":{\"type\":\"boolean\",\"default\":false,"
diff --cc tests/test_mcp.c
index abd19c124,4c2aeaad8..1dda2a5d1
--- a/tests/test_mcp.c
+++ b/tests/test_mcp.c
@@@ -1371,9 -1371,9 +1371,11 @@@ TEST(mcp_metadata_byte_budget)
char *json = cbm_mcp_tools_list();
ASSERT_NOT_NULL(json);
/* Seed discovery and independent pagination have a reviewed budget:
-- * 20 KiB overall; only detect_changes may exceed the 3200-byte per-tool
++ * 21 KiB overall (raised from 20 KiB for the infra filters and the
++ * topology/deploy/run trace modes: one usage hint per mode keeps them
++ * findable); only detect_changes may exceed the 3200-byte per-tool
* ceiling, with its own 4096-byte bound. */
-- ASSERT_LT((int)strlen(json), 20 * 1024);
++ ASSERT_LT((int)strlen(json), 21 * 1024);
yyjson_doc *doc = yyjson_read(json, strlen(json), 0);
ASSERT_NOT_NULL(doc);