cgraphx 1.4.1 → 2.0.0

package/scripts/agent-eval/probe-sweep.mjs

@@ -1,119 +0,0 @@
-#!/usr/bin/env node
-// probe-sweep — direct MCP test across N repos × N tools, no claude needed.
-//
-// Measures response characteristics (size, sections present, signals fired)
-// for each (repo, query) pair against the built dist/. Sub-second per probe;
-// the full sweep below runs in ~10-30s vs hours for a real claude audit.
-//
-// Use this to iterate on backend changes rapidly: change tools.ts /
-// context-builder, npm run build, re-run probe-sweep, compare. Once a
-// change looks good on probe metrics, run a focused claude audit for the
-// few repos that matter to confirm end-to-end cost behavior.
-//
-// Usage: node scripts/agent-eval/probe-sweep.mjs [--tool=context|explore|trace] [--repos=a,b,c]
-import { pathToFileURL } from 'node:url';
-import { resolve } from 'node:path';
-
-const args = Object.fromEntries(
-  process.argv.slice(2).map(a => a.startsWith('--') ? a.slice(2).split('=') : [a, true])
-);
-const TOOL = args.tool ?? 'context';
-
-const load = (rel) => import(pathToFileURL(resolve(rel)).href);
-const idx = await load('dist/index.js');
-const tools = await load('dist/mcp/tools.js');
-const CodeGraph = idx.default?.default ?? idx.default ?? idx.CodeGraph;
-const ToolHandler = tools.ToolHandler ?? tools.default?.ToolHandler;
-
-// Each entry: repo, query, optional 2nd arg for trace (from, to).
-// The query is the same prompt used in the real claude audits, so probe
-// output is directly comparable to the agent's would-be input.
-const SWEEP = [
-  // Small realworld template repos (the loss cases from the cross-language sweep)
-  { id: 'gin-rw',        repo: '/tmp/codegraph-corpus/gin-realworld',         q: 'How does this Gin app route a request through its middleware chain to a handler?' },
-  { id: 'go-mux',        repo: '/tmp/codegraph-corpus/go-mux',                q: 'How does this gorilla/mux app route a request to its handler?' },
-  { id: 'fastapi-rw',    repo: '/tmp/codegraph-corpus/fastapi-realworld',     q: 'How does FastAPI route a request through its dependencies to a handler?' },
-  { id: 'spring-pc',     repo: '/tmp/codegraph-corpus/spring-petclinic',      q: 'How does Spring route an HTTP request to a controller method?' },
-  { id: 'axum-rw',       repo: '/tmp/codegraph-corpus/rust-axum-realworld',   q: 'How does Axum route a request to its handler in this app?' },
-  { id: 'express-rw',    repo: '/tmp/codegraph-corpus/express-realworld',     q: 'How does this Express app route a request through middleware to a handler?' },
-  { id: 'kotlin-pc',     repo: '/tmp/codegraph-corpus/kotlin-petclinic',      q: 'How does the Kotlin Spring app route an HTTP request to its handler?' },
-  { id: 'flask-mb',      repo: '/tmp/codegraph-corpus/flask-microblog',       q: 'How does this Flask app route a request to a view function?' },
-  { id: 'vapor-tpl',     repo: '/tmp/codegraph-corpus/vapor-template',        q: 'How does Vapor route an HTTP request to its handler?' },
-  { id: 'cpp-leveldb',   repo: '/tmp/codegraph-corpus/cpp-leveldb',           q: 'How does LevelDB handle a Put operation through to disk?' },
-  { id: 'lualine',       repo: '/tmp/codegraph-corpus/lualine.nvim',          q: 'How does lualine assemble and render the statusline?' },
-  { id: 'drupal-admin',  repo: '/tmp/codegraph-corpus/drupal-admintoolbar',   q: 'How does the Drupal admin toolbar module render its toolbar?' },
-  { id: 'svelte-rw',     repo: '/tmp/codegraph-corpus/svelte-realworld',      q: 'How does this SvelteKit app route a request to a handler?' },
-  { id: 'react-rw',      repo: '/tmp/codegraph-corpus/react-realworld',       q: 'How does this React app fetch and display articles?' },
-  { id: 'rails-rw',      repo: '/tmp/codegraph-corpus/rails-realworld',       q: 'How does Rails route a request to a controller action?' },
-  { id: 'flask-rest',    repo: '/tmp/codegraph-corpus/flask-restful-realworld', q: 'How does Flask-RESTful route a request to a resource method?' },
-  { id: 'laravel-rw',    repo: '/tmp/codegraph-corpus/laravel-realworld',     q: 'How does Laravel route a request to the controller method?' },
-  { id: 'aspnet-rw',     repo: '/tmp/codegraph-corpus/aspnet-realworld',      q: 'How does ASP.NET route a request to the controller action?' },
-  // The iter7 wins/ties (to make sure we don't regress)
-  { id: 'cobra',         repo: '/tmp/codegraph-corpus/cobra',                 q: 'How does cobra parse commands and flags?' },
-  { id: 'sinatra',       repo: '/tmp/codegraph-corpus/sinatra',               q: 'How does sinatra route a request to its handler?' },
-  { id: 'slim',          repo: '/tmp/codegraph-corpus/slim',                  q: 'How does slim route a request and apply middleware?' },
-];
-
-// Detect signals in response text — these are the levers we've added that
-// otherwise only show up via "agent ran X more tool calls" downstream.
-const detect = (text) => ({
-  hasEntryPoints: /^### Entry Points/m.test(text),
-  hasRelatedSymbols: /^### Related Symbols/m.test(text),
-  hasFlowTrace: /^## Inline flow trace/m.test(text),
-  hasRouteManifest: /^## Routing manifest/m.test(text),
-  hasTopHandler: /^### Top handler file/m.test(text),
-  hasSmallRepoTail: /This project is small/.test(text),
-});
-
-const filterRepos = args.repos ? new Set(String(args.repos).split(',')) : null;
-const subjects = SWEEP.filter(s => !filterRepos || filterRepos.has(s.id));
-
-const t0 = Date.now();
-const rows = [];
-for (const s of subjects) {
-  try {
-    const cg = CodeGraph.openSync(s.repo);
-    const handler = new ToolHandler(cg);
-    const t1 = Date.now();
-    const res = await handler.execute('codegraph_' + TOOL,
-      TOOL === 'context' ? { task: s.q } :
-      TOOL === 'explore' ? { query: s.q } : { from: 'main', to: 'main' });
-    const text = res.content?.[0]?.text ?? '';
-    const signals = detect(text);
-    rows.push({
-      id: s.id,
-      ms: Date.now() - t1,
-      chars: text.length,
-      lines: text.split('\n').length,
-      ...signals,
-    });
-    try { cg.close?.(); } catch {}
-  } catch (e) {
-    rows.push({ id: s.id, error: String(e).slice(0, 80) });
-  }
-}
-
-// Pretty-print as a compact table.
-const fmt = (r) =>
-  r.error
-    ? `  ${r.id.padEnd(13)} ERROR: ${r.error}`
-    : `  ${r.id.padEnd(13)} ${String(r.chars).padStart(6)}c ${String(r.lines).padStart(4)}L ${String(r.ms).padStart(4)}ms` +
-      ` ${r.hasEntryPoints ? 'EP ' : '   '}` +
-      `${r.hasFlowTrace ? 'TRC ' : '    '}` +
-      `${r.hasRouteManifest ? 'MAN ' : '    '}` +
-      `${r.hasTopHandler ? 'HND ' : '    '}` +
-      `${r.hasSmallRepoTail ? 'TAIL' : '    '}`;
-console.log(`=== probe-sweep tool=${TOOL} n=${subjects.length} (${Date.now() - t0}ms total) ===`);
-console.log('  id            chars  lines    ms signals');
-console.log('  ' + '-'.repeat(56));
-for (const r of rows) console.log(fmt(r));
-
-// Sum + medians for the size pillar
-const sizes = rows.filter(r => !r.error).map(r => r.chars);
-sizes.sort((a, b) => a - b);
-const median = sizes[Math.floor(sizes.length / 2)];
-const sum = sizes.reduce((a, b) => a + b, 0);
-console.log(`  ${'-'.repeat(64)}`);
-console.log(`  median=${median}c  total=${sum}c  ` +
-  `manifest=${rows.filter(r => r.hasRouteManifest).length}/${rows.filter(r => !r.error).length}  ` +
-  `top-handler=${rows.filter(r => r.hasTopHandler).length}/${rows.filter(r => !r.error).length}`);

package/scripts/agent-eval/probe-trace.mjs

@@ -1,20 +0,0 @@
-#!/usr/bin/env node
-// Probe codegraph_trace against an index using the built dist.
-// Usage: node probe-trace.mjs <repo-with-.cgraphx> <from> <to>
-import { pathToFileURL } from 'node:url';
-import { resolve } from 'node:path';
-
-const [, , repo, from, to] = process.argv;
-if (!repo || !from || !to) { console.error('usage: probe-trace.mjs <repo> <from> <to>'); process.exit(1); }
-
-const load = async (rel) => import(pathToFileURL(resolve(rel)).href);
-const idx = await load('dist/index.js');
-const tools = await load('dist/mcp/tools.js');
-const CodeGraph = idx.default?.default ?? idx.default ?? idx.CodeGraph;
-const ToolHandler = tools.ToolHandler ?? tools.default?.ToolHandler;
-
-const cg = CodeGraph.openSync(repo);
-const h = new ToolHandler(cg);
-const res = await h.execute('codegraph_trace', { from, to });
-console.log(res.content?.[0]?.text ?? '(no text)');
-try { cg.close?.(); } catch {}

package/scripts/agent-eval/redirect-read-hook.sh

@@ -1,38 +0,0 @@
-#!/usr/bin/env bash
-# PreToolUse(Read) REDIRECT hook — prototype for A/B (P1: get agents off Read and
-# onto codegraph_node during implementation, not just for Q&A).
-#
-# When the agent Reads a SOURCE file, deny it and steer to codegraph_node's
-# file-view, which (as of the Lever-1 change) returns the WHOLE file verbatim
-# WITH line numbers — imports, top-level code, comments and all — PLUS the file's
-# blast radius, in one call. That output is a strict superset of Read, so the
-# redirect is lossless: the agent loses nothing by taking it, and gains who-
-# depends-on-this for the edit it's about to make.
-#
-# Differs from block-read-hook.sh (which steers to explore/node-by-symbol): this
-# names the FILE-VIEW path explicitly (file:"<base>" + includeCode:true), the
-# 1:1 Read replacement we're trying to get picked during implementation.
-#
-# Non-source files (configs, docs, lockfiles, .env) pass through to a real Read.
-# A redirect to a file cgraphx hasn't indexed SELF-CORRECTS: the file-view
-# replies "No indexed file matches … Read it directly", so a just-created file
-# never dead-ends — the agent Reads it on the next turn.
-#
-# Wire via:  claude ... --settings <settings-with-this-as-PreToolUse(Read)>
-# Eval artifact only. The production version is an indexed-aware `cgraphx`
-# subcommand (cross-platform — no bash/jq — and queries the index so it never
-# bounces a new/un-indexed file), wired opt-in by the installer.
-set -uo pipefail
-input="$(cat)"
-fp="$(printf '%s' "$input" | jq -r '.tool_input.file_path // empty' 2>/dev/null)"
-[ -n "$fp" ] || exit 0
-base="$(basename "$fp")"
-
-case "$fp" in
-  *.ts|*.tsx|*.js|*.jsx|*.mjs|*.cjs|*.py|*.go|*.rs|*.java|*.rb|*.php|*.swift|*.kt|*.kts|*.scala|*.c|*.cc|*.cpp|*.h|*.hpp|*.cs|*.lua|*.vue|*.svelte|*.m|*.mm)
-    msg="codegraph has this file indexed (kept in sync on every edit). Call codegraph_node with file:\"$base\" and includeCode:true instead of Read — it returns the WHOLE file verbatim WITH line numbers (imports, top-level code and all — safe to base an Edit on) PLUS which files depend on it, in one call. Treat its output as already-Read; do not Read this file. (If it answers that the file isn't indexed — e.g. you just created it — then Read it directly.)"
-    jq -n --arg m "$msg" '{hookSpecificOutput:{hookEventName:"PreToolUse",permissionDecision:"deny",permissionDecisionReason:$m}}'
-    exit 0
-    ;;
-esac
-exit 0

package/scripts/agent-eval/run-agent.sh

@@ -1,34 +0,0 @@
-#!/usr/bin/env bash
-# Headless Claude Code run against a repo with cgraphx MCP, capturing the
-# full stream-json so we can see tool calls + token usage. Complements the
-# interactive itrun.sh: headless gives a clean per-tool breakdown + exact
-# tokens/cost, but defaults to the general-purpose subagent (not Explore).
-# To force the Explore path, ask for it in the prompt.
-#
-# Usage: run-agent.sh <repo-path> <label> "<prompt>"
-# Env: AGENT_EVAL_OUT (default /tmp/agent-eval), CG_BIN (cgraphx dist binary)
-set -uo pipefail
-
-REPO="$1"; LABEL="$2"; PROMPT="$3"
-CG_BIN="${CG_BIN:-$(command -v cgraphx || echo /usr/local/bin/cgraphx)}"
-OUT_DIR="${AGENT_EVAL_OUT:-/tmp/agent-eval}"; mkdir -p "$OUT_DIR"
-OUT="$OUT_DIR/run-${LABEL}.jsonl"
-
-MCP_CONFIG=$(cat <<JSON
-{"mcpServers":{"cgraphx":{"command":"${CG_BIN}","args":["serve","--mcp","--path","${REPO}"]}}}
-JSON
-)
-
-echo "→ running [$LABEL] in $REPO"
-cd "$REPO" || exit 1
-
-claude -p "$PROMPT" \
-  --output-format stream-json --verbose \
-  --permission-mode bypassPermissions \
-  --model "${MODEL:-sonnet}" --effort "${EFFORT:-high}" \
-  --max-budget-usd 2 \
-  --strict-mcp-config --mcp-config "$MCP_CONFIG" \
-  > "$OUT" 2>"$OUT_DIR/run-${LABEL}.err"
-
-echo "exit: $? | wrote $OUT ($(wc -l < "$OUT") lines)"
-node "$(cd "$(dirname "$0")" && pwd)/parse-run.mjs" "$OUT" 2>/dev/null || true

package/scripts/agent-eval/run-all.sh

@@ -1,69 +0,0 @@
-#!/usr/bin/env bash
-# With/without A/B (and optional interactive) eval for a cgraphx version on a
-# repo. Codegraph is the ONLY variable: both arms launch claude with
-# --strict-mcp-config — with = cgraphx-only MCP (pointed at $CG_BIN),
-# without = empty MCP. Built-in Read/Grep/Bash stay available in both arms.
-#
-# Usage: run-all.sh <repo-path> "<question>" [headless|tmux|all]
-# Env:   CG_BIN          cgraphx binary (default: command -v cgraphx)
-#        AGENT_EVAL_OUT  output dir (default: /tmp/agent-eval)
-#        MODEL / EFFORT  claude model/effort (default: sonnet / high — the
-#                        standing A/B policy; see CLAUDE.md, don't raise)
-set -uo pipefail
-
-REPO="${1:?usage: run-all.sh <repo-path> \"<question>\" [headless|tmux|all]}"
-Q="${2:?question required}"
-MODE="${3:-headless}"
-CG_BIN="${CG_BIN:-$(command -v cgraphx)}"
-OUT="${AGENT_EVAL_OUT:-/tmp/agent-eval}"
-HARNESS="$(cd "$(dirname "$0")" && pwd)"
-mkdir -p "$OUT"
-
-[ -n "$CG_BIN" ] || { echo "no cgraphx binary on PATH (set CG_BIN)"; exit 1; }
-[ -d "$REPO/.cgraphx" ] || { echo "no .cgraphx index at $REPO — index it first"; exit 1; }
-case "$MODE" in headless|tmux|all) ;; *) echo "mode must be headless|tmux|all (got '$MODE')"; exit 1;; esac
-
-# MCP config files (path form avoids inline-JSON quoting through tmux).
-cat > "$OUT/mcp-cgraphx.json" <<JSON
-{"mcpServers":{"cgraphx":{"command":"$CG_BIN","args":["serve","--mcp","--path","$REPO"]}}}
-JSON
-echo '{"mcpServers":{}}' > "$OUT/mcp-empty.json"
-
-echo "###### cgraphx: $CG_BIN"
-echo "###### repo:      $REPO"
-echo "###### question:  $Q"
-echo
-
-# Headless arm: claude -p with stream-json -> exact tool sequence + tokens/cost.
-headless() {
-  local label="$1" cfg="$2"
-  echo "############################## HEADLESS [$label] ##############################"
-  ( cd "$REPO" && claude -p "$Q" \
-      --output-format stream-json --verbose \
-      --permission-mode bypassPermissions \
-      --model "${MODEL:-sonnet}" --effort "${EFFORT:-high}" \
-      --max-budget-usd 4 \
-      --strict-mcp-config --mcp-config "$cfg" \
-      > "$OUT/run-$label.jsonl" 2>"$OUT/run-$label.err" )
-  echo "exit $? -> $OUT/run-$label.jsonl ($(wc -l < "$OUT/run-$label.jsonl" | tr -d ' ') lines)"
-  tail -2 "$OUT/run-$label.err" 2>/dev/null
-  node "$HARNESS/parse-run.mjs" "$OUT/run-$label.jsonl" 2>&1 || true
-  echo
-}
-
-if [ "$MODE" = headless ] || [ "$MODE" = all ]; then
-  headless "headless-with"    "$OUT/mcp-cgraphx.json"
-  headless "headless-without" "$OUT/mcp-empty.json"
-fi
-
-if [ "$MODE" = tmux ] || [ "$MODE" = all ]; then
-  echo "############################## INTERACTIVE [with] ##############################"
-  CLAUDE_EXTRA_ARGS="--model ${MODEL:-sonnet} --effort ${EFFORT:-high} --strict-mcp-config --mcp-config $OUT/mcp-cgraphx.json" \
-    bash "$HARNESS/itrun.sh" "$REPO" "int-with" "$Q" 2>&1 || echo "[itrun WITH failed]"
-  echo
-  echo "############################## INTERACTIVE [without] ##############################"
-  CLAUDE_EXTRA_ARGS="--model ${MODEL:-sonnet} --effort ${EFFORT:-high} --strict-mcp-config --mcp-config $OUT/mcp-empty.json" \
-    bash "$HARNESS/itrun.sh" "$REPO" "int-without" "$Q" 2>&1 || echo "[itrun WITHOUT failed]"
-  echo
-fi
-echo "############################## RUN-ALL COMPLETE ##############################"

package/scripts/agent-eval/run-arms.sh

@@ -1,56 +0,0 @@
-#!/usr/bin/env bash
-# Tool-surface ablation — run ONE repo+question under ONE arm.
-#
-# Arms vary (exposed cgraphx tools, trace-first steering). Tools are trimmed
-# SERVER-SIDE via CGRAPHX_MCP_TOOLS in the MCP config's `env` block, so an
-# ablated tool is genuinely absent from ListTools — no deferred-ToolSearch or
-# denied-call confound (which --disallowedTools would introduce). Steering is
-# injected with --append-system-prompt, so no rebuild of the shipped
-# server-instructions is needed to A/B it.
-#
-#   A control       all tools            no steering
-#   B steer         all tools            trace-first
-#   C no-explore    hide explore         trace-first
-#   D trace-centric hide explore+context trace-first
-#   E control-probe hide explore+context trace-first  (caller passes a NON-flow Q)
-#
-# Usage: run-arms.sh <repo-path> "<question>" <A|B|C|D|E> [run-id]
-set -uo pipefail
-REPO="${1:?repo path}"; Q="${2:?question}"; ARM="${3:?arm A-E}"; RID="${4:-1}"
-CG_BIN="${CG_BIN:-$(command -v cgraphx)}"
-OUT="${ARMS_OUT:-/tmp/arms}/$(basename "$REPO")"
-mkdir -p "$OUT"
-[ -n "$CG_BIN" ] || { echo "no cgraphx binary (set CG_BIN)"; exit 1; }
-[ -d "$REPO/.cgraphx" ] || { echo "no .cgraphx index at $REPO"; exit 1; }
-
-STEER='Flow questions ("how does X reach/become Y", "trace the flow", request to handler, state to render): call codegraph_trace(from,to) FIRST — one call returns the whole path. Use codegraph_context/search only to locate the two endpoint symbols if you do not know them. Do NOT reconstruct the path with repeated search/callers/explore.'
-KEEP_NO_EXPLORE="trace,search,node,context,callers,callees,impact,files,status"
-KEEP_TRACE_CENTRIC="trace,search,node,callers,callees,impact,files,status"
-
-case "$ARM" in
-  A|G|H|I) TOOLS="";            STEERING="" ;;  # no steering; H = body-trace, I = body-trace + destination callees (sufficiency)
-  B|F) TOOLS="";                STEERING="$STEER" ;;  # F = B's surface, run on the body-inlining trace build
-  C) TOOLS="$KEEP_NO_EXPLORE";  STEERING="$STEER" ;;
-  D|E) TOOLS="$KEEP_TRACE_CENTRIC"; STEERING="$STEER" ;;
-  *) echo "bad arm '$ARM' (want A|B|C|D|E)"; exit 1 ;;
-esac
-
-CFG="$OUT/mcp-$ARM.json"
-if [ -n "$TOOLS" ]; then
-  cat > "$CFG" <<JSON
-{"mcpServers":{"cgraphx":{"command":"$CG_BIN","args":["serve","--mcp","--path","$REPO"],"env":{"CGRAPHX_MCP_TOOLS":"$TOOLS"}}}}
-JSON
-else
-  cat > "$CFG" <<JSON
-{"mcpServers":{"cgraphx":{"command":"$CG_BIN","args":["serve","--mcp","--path","$REPO"]}}}
-JSON
-fi
-
-LOG="$OUT/$ARM-r$RID.jsonl"; ERR="$OUT/$ARM-r$RID.err"
-ARGS=( -p "$Q" --output-format stream-json --verbose
-       --permission-mode bypassPermissions --model "${MODEL:-sonnet}" --effort "${EFFORT:-high}" --max-budget-usd 4
-       --strict-mcp-config --mcp-config "$CFG" )
-[ -n "$STEERING" ] && ARGS+=( --append-system-prompt "$STEERING" )
-
-( cd "$REPO" && claude "${ARGS[@]}" > "$LOG" 2>"$ERR" )
-echo "[$(basename "$REPO") $ARM r$RID] exit $? -> $LOG ($(wc -l < "$LOG" | tr -d ' ') lines)"

package/scripts/agent-eval/seq-matrix.mjs

@@ -1,137 +0,0 @@
-#!/usr/bin/env node
-// Mine the surviving A/B stream-json logs (/tmp/ab-matrix/<Cell>/run-headless-*.jsonl)
-// for what the aggregate matrix can't see: the call SEQUENCE and per-call output SIZE.
-//
-// Answers three questions:
-//   1. Trace adoption — on a flow question, does the with-arm actually call codegraph_trace?
-//   2. Payload size vs repo size — is trace path-scoped (tiny, size-independent) while
-//      explore is breadth-scoped (grows with the repo / over-returns on small repos)?
-//   3. Round-trips — num_turns with vs without (the real wall-clock driver).
-//
-// Usage: node scripts/agent-eval/seq-matrix.mjs [/tmp/ab-matrix]
-import { readFileSync, readdirSync, existsSync } from 'fs';
-import { join } from 'path';
-
-const AB = process.argv[2] || '/tmp/ab-matrix';
-const MD = new URL('../../docs/benchmarks/codegraph-ab-matrix.md', import.meta.url).pathname;
-
-// repo -> {lang,size,files} from the published matrix table
-const repoMeta = {};
-if (existsSync(MD)) for (const line of readFileSync(MD, 'utf8').split('\n')) {
-  const m = line.match(/^\|\s*([^|]+?)\s*\|\s*(S|M|L)\s*\|\s*`([^`]+)`\s*\|\s*(\d+)\s*\|/);
-  if (m) repoMeta[m[3]] = { lang: m[1].trim(), size: m[2], files: +m[4] };
-}
-
-const cgShort = (n) => n.replace('mcp__cgraphx__codegraph_', '').replace('mcp__cgraphx__', '');
-const tag = (n) => n === 'Read' ? 'R' : n === 'Grep' ? 'G' : n === 'Glob' ? 'Gl'
-  : n === 'Bash' ? 'B' : n === 'Task' ? 'Ag' : n === 'ToolSearch' ? 'TS'
-  : n.includes('codegraph') ? cgShort(n) : n;
-
-function parse(file) {
-  if (!existsSync(file)) return null;
-  const lines = readFileSync(file, 'utf8').split('\n').filter(Boolean);
-  const calls = []; let result = null, initCg = 0;
-  for (const l of lines) {
-    let ev; try { ev = JSON.parse(l); } catch { continue; }
-    if (ev.type === 'system' && ev.subtype === 'init') initCg = (ev.tools || []).filter(t => /codegraph/.test(t)).length;
-    if (ev.type === 'assistant') for (const b of (ev.message?.content || [])) if (b.type === 'tool_use') {
-      const i = b.input || {};
-      const q = i.query ?? i.symbol ?? i.task ?? (i.from && i.to ? `${i.from}->${i.to}` : (i.file_path || i.command || ''));
-      calls.push({ id: b.id, name: b.name, q: String(q ?? '').slice(0, 38), out: 0 });
-    }
-    if (ev.type === 'user') for (const b of (ev.message?.content || [])) if (b.type === 'tool_result') {
-      const c = b.content;
-      const txt = typeof c === 'string' ? c : Array.isArray(c) ? c.map(x => x?.text || '').join('') : '';
-      const call = calls.find(k => k.id === b.tool_use_id); if (call) call.out = txt.length;
-    }
-    if (ev.type === 'result') result = ev;
-  }
-  const cg = calls.filter(c => c.name.includes('codegraph'));
-  const perTool = {};
-  for (const c of cg) { const k = cgShort(c.name); (perTool[k] ??= { n: 0, out: 0 }); perTool[k].n++; perTool[k].out += c.out; }
-  const traceIdx = cg.findIndex(c => c.name.includes('trace'));
-  const u = result?.usage || {};
-  return {
-    initCg, cg, perTool,
-    cgSeq: cg.map(c => cgShort(c.name)),
-    seq: calls.map(c => tag(c.name)),
-    reads: calls.filter(c => c.name === 'Read').length,
-    greps: calls.filter(c => c.name === 'Grep').length,
-    cgOut: cg.reduce((s, c) => s + c.out, 0),
-    traceUsed: traceIdx >= 0,
-    afterTrace: traceIdx >= 0 ? cg.slice(traceIdx + 1).map(c => cgShort(c.name)) : null,
-    turns: result?.num_turns ?? null,
-    dur: result?.duration_ms ? Math.round(result.duration_ms / 1000) : null,
-    cost: result?.total_cost_usd || 0,
-  };
-}
-
-const cells = [];
-for (const d of readdirSync(AB)) {
-  const dir = join(AB, d);
-  if (!existsSync(join(dir, 'run-headless-with.jsonl'))) continue;
-  const log = existsSync(join(AB, d + '.log')) ? readFileSync(join(AB, d + '.log'), 'utf8') : '';
-  const repo = (log.match(/repo:\s*\S*\/([^\s/]+)/) || [])[1] || d;
-  const question = (log.match(/question:\s*(.+)/) || [])[1] || '';
-  cells.push({ cell: d, repo, question, ...(repoMeta[repo] || {}),
-    with: parse(join(dir, 'run-headless-with.jsonl')),
-    without: parse(join(dir, 'run-headless-without.jsonl')) });
-}
-cells.sort((a, b) => (a.files || 0) - (b.files || 0));
-
-const k = (n) => (n / 1000).toFixed(1);
-const pad = (s, n) => String(s).padEnd(n);
-
-// ---- per-cell sequence table ----
-console.log('\n=== PER-CELL: with-arm cgraphx sequence + payload (sorted by repo size) ===');
-console.log(pad('repo', 22), pad('files', 6), 'trace', pad('cg-call sequence', 40), pad('cgOutK', 7), 'turns(w/wo)');
-for (const c of cells) {
-  const w = c.with;
-  console.log(
-    pad(c.repo, 22), pad(c.files ?? '?', 6),
-    pad(w.traceUsed ? 'YES' : 'no', 5),
-    pad(w.cgSeq.join(',') || '(none)', 40),
-    pad(k(w.cgOut), 7),
-    `${w.turns}/${c.without?.turns}`,
-  );
-}
-
-// ---- trace adoption ----
-const flow = cells; // every matrix question is a canonical flow question by design
-const used = flow.filter(c => c.with.traceUsed);
-console.log(`\n=== TRACE ADOPTION (all ${flow.length} cells are flow questions) ===`);
-console.log(`trace called in ${used.length}/${flow.length} cells`);
-console.log('used trace:', used.map(c => c.repo).join(', ') || '(none)');
-if (used.length) console.log('after-trace follow-ups:', used.map(c => `${c.repo}[${c.with.afterTrace.join(',') || 'none'}]`).join('  '));
-
-// ---- payload size by repo-size tier ----
-const tier = (f) => f < 200 ? 'S(<200)' : f < 2000 ? 'M(<2000)' : 'L(>=2000)';
-const byTier = {};
-for (const c of cells) { (byTier[tier(c.files || 0)] ??= []).push(c.with.cgOut); }
-console.log('\n=== with-arm TOTAL cgraphx payload by repo-size tier ===');
-for (const t of ['S(<200)', 'M(<2000)', 'L(>=2000)']) {
-  const a = byTier[t] || []; if (!a.length) continue;
-  const avg = a.reduce((s, x) => s + x, 0) / a.length;
-  console.log(`  ${pad(t, 10)} n=${a.length}  avg cgOut=${k(avg)}K  range ${k(Math.min(...a))}-${k(Math.max(...a))}K`);
-}
-
-// ---- per-tool usage + avg payload (breadth vs path evidence) ----
-const tot = {};
-for (const c of cells) for (const [name, v] of Object.entries(c.with.perTool)) {
-  (tot[name] ??= { n: 0, out: 0 }); tot[name].n += v.n; tot[name].out += v.out;
-}
-console.log('\n=== cgraphx tool usage across all cells (n calls, avg payload/call) ===');
-for (const [name, v] of Object.entries(tot).sort((a, b) => b[1].n - a[1].n)) {
-  console.log(`  ${pad(name, 10)} calls=${pad(v.n, 4)} avg=${k(v.out / v.n)}K/call  total=${k(v.out)}K`);
-}
-
-// ---- round-trips ----
-const sum = (arr, f) => arr.reduce((s, x) => s + (f(x) || 0), 0);
-const wTurns = sum(cells, c => c.with.turns), woTurns = sum(cells, c => c.without?.turns);
-const wCalls = sum(cells, c => c.with.cg.length);
-const tsAll = cells.every(c => c.with.seq[0] === 'TS');
-console.log('\n=== ROUND-TRIPS ===');
-console.log(`turns: with=${wTurns}  without=${woTurns}  (${((1 - wTurns / woTurns) * 100).toFixed(0)}% fewer with)`);
-console.log(`avg turns/cell: with=${(wTurns / cells.length).toFixed(1)}  without=${(woTurns / cells.length).toFixed(1)}`);
-console.log(`total cgraphx calls=${wCalls} (avg ${(wCalls / cells.length).toFixed(1)}/cell)`);
-console.log(`every with-arm opens with a ToolSearch round-trip (deferred tools): ${tsAll ? 'YES — 1 fixed tax/run' : 'no'}`);