Skip to content

Cartographer (removed in 9.4.0)

CKB no longer links the Cartographer library. As of 9.4.0 there is no -tags cartographer build, no prebuilt static library fetched at build time and no third_party/cartographer directory. Every build is the same build, and no Rust toolchain is needed.

This page stays so that old links keep working. Cartographer was an optional Rust engine embedded through CGo FFI (8.5 to 9.3).


Where the useful results come from now

Measured on CKB, Lebenslauf, Ingestible and Morphon, the results worth keeping (cycles, co-change, bridges, god modules, dispersion) are now computed from CKB's own SCIP index and git history, in every build and every indexed language.

Result Now computed from Where it shows up
Import cycles The SCIP file graph, classified by import site: only imports that run when the module loads count (import type, TYPE_CHECKING blocks, dynamic import() and function-local Python imports cannot close a cycle). TypeScript, JavaScript and Python findCycles with granularity: "file", reviewPR arch-health, prepareChange risk factors
Bridges Articulation points of the file graph that cut off at least 3 files (internal/query/bridges.go) analyzeImpact risk multiplier (factor bridge_cut), arch-health (info)
God modules 15+ dependency units and 40+ declarations, a Go package counted as one unit getArchitecture (archGodModules), arch-health (warning)
Co-change partners Git history read by CKB itself (coupling.History): last 500 commits, bot, formatting and very large commits dropped getHotspots cochangePartners, getOwnership coChangePartners, scanPerformance, ckb perf coupling
Hidden coupling Co-change with no SCIP reference between the two files. Needs a SCIP index covering both files; without one nothing is reported and the response says why reviewPR coupling check
Shotgun surgery / dispersion Co-change partners plus the entropy of how the co-changes spread detectShotgunSurgery
PR split Changed files joined by SCIP references, imports and co-change in one pass reviewPR split check

getArchitecture returns archHealth (bridgeCount, cycleCount, godModuleCount, cycleLanguages), archCycles, archGodModules and archBridgeNodes from the index.


What went with it

Removed, with nothing in their place:

  • The MCP tools queryContext, contextHealth, getArchitecturalEvolution, getBlastRadius and renderArchitecture (the full preset is 106 tools, was 111). analyzeImpact and prepareChange cover blast radius.
  • exportForLLM's rankedSkeleton (tokenBudget, focusFiles), getModuleOverview's skeleton and summarizeDiff's functionChanges.
  • The layers review check (it needed a layers.toml), the project-wide health score and layer-violation count in getArchitecture, and archImpact in prepareChange and analyzeImpact.
  • The dead-code check's unreferenced-exports phase (a name heuristic below the SCIP reference count).
  • The Cartographer entries in ckb doctor and ckb status.

Building

go build -o ckb ./cmd/ckb

That is the full build. Release binaries are still built with cgo on native runners, for the tree-sitter parsers.


See also