mirror of
https://github.com/garrytan/gbrain.git
synced 2026-07-28 06:23:01 +00:00
Garry TanandClaude Opus 4.7
bfe204d871
Recursive caller (code_blast) + recursive callee (code_flow) walks land
as first-class MCP ops. The user-facing payoff for v0.34: v0.33.3
shipped flat callers/callees; v0.34 ships depth-grouped recursive walks
with cycle detection, truncation flags, freshness reporting, sink
tagging on terminal nodes, and bare-name disambiguation with
did_you_mean suggestions.
- src/core/code-intel/recursive-walk.ts: BFS over existing engine
single-hop methods (getCallersOf, getCalleesOf). Depth-grouped output;
confidence = clamp(1 / (1 + 0.3 * depth), 0.05, 1.0). Cycle detection
via visited-set; truncation enum captures both depth_cap and max_nodes
exhaustion. Source-scoped per D4 sourceId REQUIRED.
- src/core/code-intel/sinks/{ts,py,index}.ts: per-language sink patterns
as TypeScript constants (D9 — auditable literal-string + glob; NOT
regex). Pattern cache hits warm after first match per process.
TS_SINKS covers fetch, axios.*, fs.*, Bun.*, execSync, spawnSync;
PY_SINKS covers requests.*, urllib.*, subprocess.*, open, pathlib.*.
- src/core/operations.ts: code_blast + code_flow registered with
scope: 'read'. Both wrap their walks through
getCachedOrCompute (W3b) so repeat blasts in a plan-mode session hit
cache. depth + max_nodes hard-capped at handler entry per design doc
Constraints. exact: true skips bare-name disambiguation.
Response envelope (shared):
{ result: 'ok' | 'not_found' | 'ambiguous' | 'unsupported_language',
depth_groups?, cycles_detected?, truncation?, freshness?,
did_you_mean?, candidates?, supported? }
code_flow adds: terminal_nodes: [{symbol, sink_kind}] where sink_kind ∈
'db_call' | 'http_call' | 'file_io' | 'process_exec' | 'unknown'
Per D18 from eng review — only JS/TS/TSX + Python get walks. Other
languages return {result: 'unsupported_language', supported: ['ts',
'tsx','js','py']} cleanly rather than aliasing same-named callees.
test/code-intel/recursive-walk.test.ts: 11 hermetic PGLite tests:
- 7 sinks classifier cases (http_call, file_io, db_call, process_exec
for TS + Python, unknown for made-up symbol, unknown for ruby lang)
- not_found returns did_you_mean
- happy-path: caller chain emerges in depth_groups; confidence ~0.77
at depth 1
- truncation: depth_cap fires when walk exceeds depth
- sink-tagging: fetch lands in terminal_nodes with http_call kind
v0.34.0.0 scope reductions: stdio rate limiter at dispatch.ts and CLI
wrappers (gbrain blast / gbrain flow) deferred — the ops are MCP-
reachable today and the W8 release packaging step adds CLI thin-shims.
The eng-review's stdio limiter at dispatch.ts (D10) is queued behind
the eval gate run; concurrent code-intel load needed to justify it
hasn't materialized at v0.34.0.0 ship time.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>