CodeTruth Agent V3 — Module 2: Repository Graph Engine
Tag: v3.0.0-module2
Summary
Module 2 maps how a Python codebase is wired together: every function,
class, module, import, dependency, and resolved function call, as 6
structured graphs. Validated on 69 real open-source repositories (49,379
files), 0 crashes, 1,005,321 resolved call edges, governance gate
APPROVED/BLOCKED consistent with Module 1.
This release covers Module 2's Python core (V3-004 through V3-009),
frozen, plus an early multi-language extension scaffold (Java,
JavaScript/TypeScript, C/C++) - a validated baseline, not frozen.
Validation
- 31/31 unit tests pass
- 69 repos scanned, 0 crashes, 49,379 files, 515,610 functions,
84,468 classes - 1,005,321 resolved call edges (2.5x increase from initial baseline)
- 65/69 governance gate APPROVED, 4/69 correctly BLOCKED (non-Python repos)
What's New
D-001 (two-stage global build), D-002/D-003 (builtins/constructors/stdlib
whitelist), D-004 (cross-module inheritance, -53% unresolved self-calls),
Gap 1/2/3 (qualified-module resolution, local type tracking, import-cycle
detection), D-006 (nested functions), D-007 (relative import resolution).
Multi-language scaffold: Java (javalang), JavaScript/TypeScript
(tree-sitter, incl. cross-file resolution, 0 parse errors), C/C++ (regex
heuristic) - all validated with 0 crashes on real repos (Redis, u-boot,
vscode, elasticsearch, spring-boot, react, ui5-webcomponents).
Documentation
13 documents in v3/docs/module2/ covering architecture, decisions,
validation, extension guide, FAQ, gaps & roadmap, POC history, and a
quickstart with a worked example. Project-wide overview:
v3/docs/PROJECT_RECORD_v3.0.0-module2.md.
Known Limitations (Documented, By Design)
attribute_call (1,785,190 instances - requires future type inference);
D-008 package-root mismatches in some large frameworks (documented, not
yet pursued). Full detail in MODULE2_GAPS_AND_ROADMAP.md.
This release does not modify repositories and makes no code-change
decisions.