@nanonets/graft 0.5.1 → 0.7.0

package/dist/claude/hooks.js

@@ -5,6 +5,7 @@ import { readWiring } from './stats.js';
 import { formatBlastRadius, relevantRetrieval, formatOrientation } from './format.js';
 import { patchStats, readStats, acquireLock, readSession, writeSession } from './state.js';
 import { graftCliPath, claudeScriptPath } from './paths.js';
+import { scopeOf, scopesOfGraph } from '../graph/scopes.js';
 /** Prompts shorter than this never trigger retrieval — they are almost always
  * conversational ("yes go ahead", "thanks") and the coverage gate can't judge
  * them reliably with so few terms. */
@@ -34,7 +35,12 @@ export function underGraft(dir, file) {
 }
 function graftJson(dir, args) {
     try {
-        const out = execFileSync(process.execPath, [graftCliPath(), ...args], { cwd: dir, encoding: 'utf8', timeout: 8000, stdio: ['ignore', 'pipe', 'ignore'] });
+        // GRAFT_TEST_CLI is a test seam (mirrors GRAFT_TEST_STDIN/GRAFT_TEST_SYNC_RUN) so
+        // tests can point the prompt hook's `graft ask`/`graft check` calls at a stub
+        // script and observe the exact args it was invoked with, instead of shelling
+        // out to the real CLI (which isn't built relative to the TS source under test).
+        const cliPath = process.env.GRAFT_TEST_CLI ?? graftCliPath();
+        const out = execFileSync(process.execPath, [cliPath, ...args], { cwd: dir, encoding: 'utf8', timeout: 8000, stdio: ['ignore', 'pipe', 'ignore'] });
         return JSON.parse(out);
     }
     catch (e) {
@@ -69,6 +75,49 @@ async function handlePostEdit(input, dir) {
             emit('PostToolUse', br);
     }
 }
+/**
+ * The "you're working in backend/, weight it" hint: on a multi-scope repo,
+ * narrow the prompt hook's `ask` call to whatever scope the last-edited file
+ * (`stats.lastFile`, captured at {@link handlePostEdit}) sits in.
+ *
+ * `lastFile` is only a basename (not a repo-relative path — see
+ * `handlePostEdit`), so this is a best-effort lookup against the CURRENT
+ * graph: any file node whose path ends in `/<lastFile>` (or equals it, for a
+ * repo-root file). Fails soft in every direction a hook must never crash on —
+ * no graph, a single-scope graph, a lastFile no longer in the graph (moved,
+ * deleted, or edited before the first build), or a basename that lands in
+ * more than one scope (ambiguous: could be either sub-project) all skip the
+ * hint silently, logging one line to stderr so the miss is visible without
+ * ever failing the hook.
+ */
+export function lastFileScopeHint(dir, lastFile) {
+    if (!lastFile)
+        return null;
+    try {
+        const w = readWiring(dir);
+        if (!w)
+            return null;
+        const scopes = scopesOfGraph(w);
+        if (scopes.length <= 1)
+            return null; // single-scope: no hint, no --in
+        const matches = (w.nodes ?? []).filter((n) => n.kind === 'file' && (n.path === lastFile || n.path.endsWith(`/${lastFile}`)));
+        if (matches.length === 0) {
+            console.error(`[graft] prompt hook: lastFile "${lastFile}" not found in the graph — skipping scope hint`);
+            return null;
+        }
+        const prefixes = new Set(matches.map((n) => scopeOf(n.path, scopes).prefix));
+        if (prefixes.size > 1) {
+            console.error(`[graft] prompt hook: lastFile "${lastFile}" matches more than one scope — skipping scope hint`);
+            return null;
+        }
+        const [prefix] = prefixes;
+        return prefix === '' ? null : prefix; // root scope: nothing to narrow
+    }
+    catch (e) {
+        console.error(`[graft] prompt hook: scope hint lookup failed (${e?.message ?? e}) — skipping`);
+        return null;
+    }
+}
 function handleStop(dir) {
     // sync-run.js ships next to this module inside the package, so it resolves in
     // any repo that installs graft (not just graft's own). Defensive existsSync:
@@ -119,7 +168,13 @@ export async function main(event) {
         // pulls spans itself via `graft ask --source` when a pointer looks right.
         // relevantRetrieval then drops the pack entirely when the prompt barely
         // overlaps the top hit or when every hit was already injected this session.
-        const ask = graftJson(dir, ['ask', prompt, '.', '--json', '-n', '3']);
+        const askArgs = ['ask', prompt, '.', '--json', '-n', '3'];
+        // "You're working in backend/, weight it": only fires on a multi-scope
+        // repo whose lastFile resolves cleanly to one scope — see lastFileScopeHint.
+        const scopeHint = lastFileScopeHint(dir, readStats(dir)?.lastFile);
+        if (scopeHint)
+            askArgs.push('--in', scopeHint);
+        const ask = graftJson(dir, askArgs);
         if (!ask)
             return;
         const id = input.session_id || 'default';

package/dist/claude/hooks.js.map

@@ -1 +1 @@
-{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../src/claude/hooks.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../src/claude/hooks.ts"],"names":[],"mappings":"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"}

package/dist/claude/init.d.ts

@@ -1,7 +1,10 @@
+import { type McpWrite } from '../hosts/mcp-config.js';
 export interface InitResult {
     settingsPath: string;
     shims: string[];
     skill: string;
+    /** the `.mcp.json` write registering the graft MCP server for Claude Code. */
+    mcp: McpWrite;
     warnings: string[];
     built: boolean;
 }

package/dist/claude/init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/claude/init.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,UAAU;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,UAAU,CAgCjG"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/claude/init.ts"],"names":[],"mappings":"AAOA,OAAO,EAA8B,KAAK,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAEnF,MAAM,WAAW,UAAU;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,8EAA8E;IAC9E,GAAG,EAAE,QAAQ,CAAC;IACd,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,UAAU,CAqCjG"}

package/dist/claude/init.js

@@ -5,6 +5,7 @@ import { mergeGraftSettings } from './settings-merge.js';
 import { statuslineShim, hooksShim } from './shim-template.js';
 import { skillTemplate } from './skill-template.js';
 import { claudeDistDir } from './paths.js';
+import { mergeJsonKey, SERVER_ENTRY } from '../hosts/mcp-config.js';
 export function runInit(dir, opts = {}) {
     const helpersDir = join(dir, '.claude', 'helpers');
     mkdirSync(helpersDir, { recursive: true });
@@ -29,6 +30,10 @@ export function runInit(dir, opts = {}) {
     mkdirSync(skillDir, { recursive: true });
     const skillPath = join(skillDir, 'SKILL.md');
     writeFileSync(skillPath, skillTemplate());
+    // Register the graft MCP server in the project's .mcp.json so Claude Code
+    // exposes graft_ask/graft_callers/etc. as tools — the same keyed merge the
+    // other hosts use (existing servers preserved; unparseable files skipped).
+    const mcp = mergeJsonKey('claude', join(dir, '.mcp.json'), 'mcpServers', SERVER_ENTRY);
     let built = false;
     const wiring = join(dir, 'graft', '.graph', 'wiring.json');
     if (opts.build !== false && opts.cliPath && !existsSync(wiring)) {
@@ -38,6 +43,6 @@ export function runInit(dir, opts = {}) {
         }
         catch { /* build best-effort; user can run `graft build` manually */ }
     }
-    return { settingsPath, shims: [sl, hk], skill: skillPath, warnings, built };
+    return { settingsPath, shims: [sl, hk], skill: skillPath, mcp, warnings, built };
 }
 //# sourceMappingURL=init.js.map

package/dist/claude/init.js.map

@@ -1 +1 @@
-{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/claude/init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACxF,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAU3C,MAAM,UAAU,OAAO,CAAC,GAAW,EAAE,OAA8C,EAAE;IACnF,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;IACnD,SAAS,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE3C,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,EAAE,SAAS,EAAE,eAAe,CAAC,CAAC;IAC3D,IAAI,QAAQ,GAAwB,EAAE,CAAC;IACvC,IAAI,CAAC;QAAC,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC,CAAC,gCAAgC,CAAC,CAAC;IAC7G,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IAC1D,aAAa,CAAC,YAAY,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;IAEpE,MAAM,EAAE,GAAG,IAAI,CAAC,UAAU,EAAE,sBAAsB,CAAC,CAAC;IACpD,MAAM,EAAE,GAAG,IAAI,CAAC,UAAU,EAAE,iBAAiB,CAAC,CAAC;IAC/C,MAAM,QAAQ,GAAG,aAAa,EAAE,CAAC,CAAC,kEAAkE;IACpG,aAAa,CAAC,EAAE,EAAE,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC;IAAC,SAAS,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;IAClE,aAAa,CAAC,EAAE,EAAE,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC;IAAC,SAAS,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;IAE7D,mFAAmF;IACnF,mFAAmF;IACnF,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;IACzD,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACzC,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IAC7C,aAAa,CAAC,SAAS,EAAE,aAAa,EAAE,CAAC,CAAC;IAE1C,IAAI,KAAK,GAAG,KAAK,CAAC;IAClB,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;IAC3D,IAAI,IAAI,CAAC,KAAK,KAAK,KAAK,IAAI,IAAI,CAAC,OAAO,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QAChE,IAAI,CAAC;YACH,YAAY,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;YAC9G,KAAK,GAAG,IAAI,CAAC;QACf,CAAC;QAAC,MAAM,CAAC,CAAC,4DAA4D,CAAC,CAAC;IAC1E,CAAC;IACD,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;AAC9E,CAAC"}
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/claude/init.ts"],"names":[],"mappings":"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"}

package/dist/claude/skill-template.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skill-template.d.ts","sourceRoot":"","sources":["../../src/claude/skill-template.ts"],"names":[],"mappings":"AAKA,wBAAgB,aAAa,IAAI,MAAM,CA2EtC"}
+{"version":3,"file":"skill-template.d.ts","sourceRoot":"","sources":["../../src/claude/skill-template.ts"],"names":[],"mappings":"AAKA,wBAAgB,aAAa,IAAI,MAAM,CAsFtC"}

package/dist/claude/skill-template.js

@@ -31,12 +31,17 @@ same understanding costs thousands.
   ask is top-N and WILL miss instances; grep is the tool for "find them all".
 - **A file's whole API surface** → \`graft skeleton <file>\` — every signature in
   ~200 tokens. One call beats several asks when you just need "what's in here".
-- **Who uses / what breaks if I change X** → \`graft callers <symbol>\` or
-  \`graft impact <symbol>\`; what X itself depends on → \`graft callees <symbol>\`.
-  Run one of these before editing a symbol.
+- **Who uses / what breaks if I change X** → \`graft callers <symbol>\` (add
+  \`--depth N\` to walk transitively for the full blast radius); what X itself
+  depends on → \`graft callers <symbol> --direction out\`. Run one before
+  editing a symbol.
 - **First contact with an unfamiliar repo** → \`graft map\` — token-budgeted
   orientation (dir clusters, hubs, hotspots). Read the hub cards it names rather
   than asking per subsystem.
+- **Monorepos / a folder of multiple repos** → graft ranks fairly across
+  sub-projects instead of letting the biggest one drown the rest; hits carry
+  \`[scope/]\` labels naming which sub-project they're from. Know where you're
+  working? Narrow with \`graft ask "<task>" --in <scope>/\`.
 
 You can also grep / ls / cat inside \`graft/\` directly (the nodes are plain
 markdown; \`graft/INDEX.md\` lists them) — but the commands above are faster and
@@ -62,13 +67,19 @@ exhaustive where it matters, so reach for them first.
   that is expected, not a graft failure.
 
 **Precise graph modes** — for structural questions, skip ranking and go
-straight to precomputed edges:
+straight to precomputed edges. It's all one command, \`graft callers\`:
 
-- \`graft callers <symbol>\` / \`graft callees <symbol>\` — who breaks if this
-  changes / what does this call — precomputed edges, exact answers; structural
-  phrasing inside ask ("who calls X") routes here too.
-- \`graft impact <symbol> [-d N]\` — BFS over incoming edges out to depth N: the
-  full blast radius of a change.
+- \`graft callers <symbol>\` — who calls/references this (exact edges, not text);
+  structural phrasing inside ask ("who calls X") routes here too.
+- \`graft callers <symbol> --direction out\` — the reverse: what this symbol
+  itself calls/depends on (the old \`callees\`).
+- \`graft callers <symbol> --depth N\` — walk transitively out to depth N for the
+  full blast radius of a change (the old \`impact\`).
+
+When the graft MCP server is connected, the same operations are exposed as
+tools — \`graft_ask\`, \`graft_callers\` (with \`direction\`/\`depth\`),
+\`graft_grep\`, \`graft_skeleton\`, \`graft_map\` — prefer whichever surface is
+available.
 
 If a returned span is truncated ("+N more lines"), open the file at that exact
 range before finalizing.

package/dist/claude/skill-template.js.map

@@ -1 +1 @@
-{"version":3,"file":"skill-template.js","sourceRoot":"","sources":["../../src/claude/skill-template.ts"],"names":[],"mappings":"AAAA,uFAAuF;AACvF,0FAA0F;AAC1F,sFAAsF;AACtF,uFAAuF;AACvF,oCAAoC;AACpC,MAAM,UAAU,aAAa;IAC3B,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyER,CAAC;AACF,CAAC"}
+{"version":3,"file":"skill-template.js","sourceRoot":"","sources":["../../src/claude/skill-template.ts"],"names":[],"mappings":"AAAA,uFAAuF;AACvF,0FAA0F;AAC1F,sFAAsF;AACtF,uFAAuF;AACvF,oCAAoC;AACpC,MAAM,UAAU,aAAa;IAC3B,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoFR,CAAC;AACF,CAAC"}

package/dist/cli.d.ts

@@ -1,19 +1,8 @@
 #!/usr/bin/env node
 /**
- * `graft` CLI. Commands:
- *
- *   build   build graft/ from your code (structural graph; --deep adds LLM summaries).
- *   ask     query the graph ($0, no LLM).
- *   check   fail if graft/ has drifted from the code — for CI.
- *   viz     serve the interactive graph viewer.
- *   mcp     serve the graph over MCP (stdio) for coding agents.
- *   callers / callees / impact   precise graph traversal for a symbol ($0, no LLM).
- *   grep    regex search over indexed files, grouped by enclosing symbol, ranked by coupling ($0, no LLM).
- *   map     token-budgeted repo orientation — dir clusters, hubs, hotspots ($0, no LLM).
- *   init    set up the Claude Code integration (.claude/ statusline + hooks) in this repo.
- *
- * Git is the sync: commit graft/ and anyone who clones the repo has the
- * graph, with no setup.
+ * `graft` CLI. Commands: build, ask, check, viz, mcp, callers, skeleton, grep,
+ * map, init. Git is the sync: commit graft/ and a clone has the graph. A
+ * workspace parent (≥2 git children) federates query commands across children.
  */
 import "dotenv/config";
 //# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,eAAe,CAAC"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;;GAIG;AACH,OAAO,eAAe,CAAC"}

package/dist/cli.js

@@ -1,19 +1,8 @@
 #!/usr/bin/env node
 /**
- * `graft` CLI. Commands:
- *
- *   build   build graft/ from your code (structural graph; --deep adds LLM summaries).
- *   ask     query the graph ($0, no LLM).
- *   check   fail if graft/ has drifted from the code — for CI.
- *   viz     serve the interactive graph viewer.
- *   mcp     serve the graph over MCP (stdio) for coding agents.
- *   callers / callees / impact   precise graph traversal for a symbol ($0, no LLM).
- *   grep    regex search over indexed files, grouped by enclosing symbol, ranked by coupling ($0, no LLM).
- *   map     token-budgeted repo orientation — dir clusters, hubs, hotspots ($0, no LLM).
- *   init    set up the Claude Code integration (.claude/ statusline + hooks) in this repo.
- *
- * Git is the sync: commit graft/ and anyone who clones the repo has the
- * graph, with no setup.
+ * `graft` CLI. Commands: build, ask, check, viz, mcp, callers, skeleton, grep,
+ * map, init. Git is the sync: commit graft/ and a clone has the graph. A
+ * workspace parent (≥2 git children) federates query commands across children.
  */
 import "dotenv/config";
 import { Command } from "commander";
@@ -28,6 +17,8 @@ import { runHostsInit } from "./hosts/init.js";
 import { hostIds } from "./hosts/registry.js";
 import { contextDirFor } from "./context/node-file.js";
 import { loadGraphCached } from "./graph/load.js";
+import { isWorkspaceBuildRoot, readWorkspace } from "./graph/workspace.js";
+import { runWorkspaceAsk, runWorkspaceBuild, runWorkspaceCallers, runWorkspaceCheck, runWorkspaceGrep, runWorkspaceMap, } from "./graph/workspace-cli.js";
 import { formatInitEpilogue } from "./cli-epilogue.js";
 import { formatUpgradeReport, formatVersionReport, getNpmViewVersion, readCurrentVersion, runUpgrade } from "./cli-meta.js";
 const program = new Command();
@@ -52,9 +43,7 @@ function cliConfig() {
         baseUrl: o.baseUrl,
     };
 }
-function engineFrom() {
-    return new Graft(cliConfig());
-}
+const engineFrom = () => new Graft(cliConfig());
 program
     .command("version")
     .description("Print the installed version and the latest published on npm")
@@ -90,8 +79,7 @@ program
         .sort((a, b) => b[1] - a[1])
         .map(([k, n]) => `${n} ${k}`)
         .join(", ");
-    // --deep needs a key; without one, degrade to the $0 structural build
-    // rather than failing — the wiring graph is still worth having.
+    // --deep needs a key; without one, degrade to the $0 structural build.
     let deep = opts.deep;
     const resolved = resolveConfig(cliConfig());
     if (deep && !resolved.apiKey) {
@@ -103,8 +91,20 @@ program
     if (deep && resolved.usedLegacyEnv) {
         console.error("⚠ using OPENROUTER_API_KEY (deprecated) — prefer GRAFT_API_KEY + GRAFT_BASE_URL.");
     }
-    // --deep: concept nodes first (they're LLM prose; the wiring cards link up to
-    // them), then the wiring graph rewrites the cards + INDEX with those up-links.
+    // Workspace parent: build each child into its OWN graft/ + a workspace index.
+    const buildRoot = resolve(dir);
+    const buildGlobalDir = program.opts().dir;
+    if (isWorkspaceBuildRoot(buildRoot, buildGlobalDir)) {
+        await runWorkspaceBuild(buildRoot, {
+            deep: !!deep,
+            extensions: opts.extensions,
+            concurrency,
+            childConfig: cliConfig(),
+            override: buildGlobalDir,
+        });
+        return;
+    }
+    // --deep: concept nodes first, then the wiring graph links cards up to them.
     if (deep) {
         const c = await engine.init(dir, {
             extensions: opts.extensions,
@@ -115,7 +115,7 @@ program
         for (const e of c.errors)
             console.error(`✗ ${e}`);
     }
-    // Wiring graph (Tier-2 cards + Tier-3 wiring.json) — always. LLM meaning only with --deep.
+    // Wiring graph — always; LLM meaning only with --deep.
     const g = await engine.graph(dir, {
         llm: deep,
         concurrency,
@@ -141,10 +141,26 @@ program
     .option("-n, --limit <n>", "max results", "8")
     .option("--source", "inline the source at each file:line hit (retriever mode — the pack IS the answer, no need to re-open files)")
     .option("--full", "with --source: inline whole definition spans instead of the default ≤8-line crux excerpts")
+    .option("--in <path>", "narrow to nodes under this path prefix, filtered before scoring (segment-aware, like scopeOf)")
     .option("--json", "output the result as JSON")
     .action(async (query, dir, opts) => {
+    const askGlobalDir = program.opts().dir;
+    if (readWorkspace(resolve(dir), askGlobalDir)) {
+        runWorkspaceAsk(resolve(dir), askGlobalDir, query, {
+            limit: Number(opts.limit), source: opts.source, full: opts.full, in: opts.in, json: opts.json,
+        });
+        return;
+    }
     const engine = engineFrom();
-    const r = engine.ask(dir, query, { limit: Number(opts.limit), source: opts.source, full: opts.full });
+    let r;
+    try {
+        r = engine.ask(dir, query, { limit: Number(opts.limit), source: opts.source, full: opts.full, in: opts.in });
+    }
+    catch (err) {
+        console.error(`✗ ${err instanceof Error ? err.message : String(err)}`);
+        process.exit(1);
+        return;
+    }
     if (opts.json) {
         console.log(JSON.stringify(r, null, 2));
     }
@@ -175,14 +191,17 @@ program
     .option("-e, --extensions <exts...>", "code extensions to include")
     .option("--json", "output the drift as JSON")
     .action((dir, opts) => {
+    const checkGlobalDir = program.opts().dir;
+    if (readWorkspace(resolve(dir), checkGlobalDir)) {
+        runWorkspaceCheck(resolve(dir), checkGlobalDir);
+        return;
+    }
     const engine = engineFrom();
     const r = engine.check(dir, { extensions: opts.extensions });
     const g = engine.checkGraph(dir); // graph.json is only judged when it exists
-    // Neither layer has ever been built → nothing to check.
+    // A layer that IS present must be in sync; a never-built layer (keyless
+    // build skips the markdown layer) is informational, not a failure.
     const bothMissing = r.missing && g.missing;
-    // A layer that IS present must be in sync; a layer that was never built
-    // (keyless `graft build` skips the markdown/concept layer) is informational,
-    // not a failure — the wiring graph stands on its own.
     const markdownFail = !r.missing && !r.ok;
     const wiringFail = !g.missing && !g.ok;
     if (opts.json) {
@@ -224,8 +243,7 @@ program
         console.error(`✗ no context graph at ${contextDir} — run \`graft build --deep\` first`);
         process.exit(1);
     }
-    // dist/cli.js → dist/viewer/ (prebuilt at package build time)
-    const viewerDir = fileURLToPath(new URL("./viewer/", import.meta.url));
+    const viewerDir = fileURLToPath(new URL("./viewer/", import.meta.url)); // prebuilt
     const srv = await startVizServer({
         contextDir,
         viewerDir,
@@ -240,7 +258,7 @@ program
 });
 program
     .command("mcp")
-    .description("Serve the graph over MCP (stdio) — exposes graft_ask / graft_check / graft_blast_radius as tools")
+    .description("Serve the graph over MCP (stdio) — exposes graft_ask, graft_callers, graft_grep, graft_skeleton, graft_map and graft_check as tools")
     .argument("[dir]", "repository root", ".")
     .action(async (dir) => {
     const { resolve } = await import("node:path");
@@ -248,38 +266,34 @@ program
     const globalOpts = program.opts();
     startMcpServer(resolve(dir), globalOpts.dir);
 });
-function traverseAction(kind) {
-    return async (symbol, dir, opts) => {
-        const { runTraverseCommand } = await import("./graph/traverse-cli.js");
-        const globalOpts = program.opts();
-        runTraverseCommand(kind, symbol, dir, { in: opts.in, json: opts.json, depth: opts.depth, globalDir: globalOpts.dir });
-    };
-}
 program
     .command("callers")
-    .description("Who calls/references/imports/implements/extends a symbol ($0, no LLM)")
-    .argument("<symbol>", "bare name, qualified (Class.method), or package-qualified (pkg.Fn)")
-    .argument("[dir]", "repository root", ".")
-    .option("--in <path>", "narrow matches to nodes whose path contains this substring")
-    .option("--json", "output as JSON")
-    .action(traverseAction("callers"));
-program
-    .command("callees")
-    .description("What a symbol calls/references/imports/implements/extends ($0, no LLM)")
-    .argument("<symbol>", "bare name, qualified (Class.method), or package-qualified (pkg.Fn)")
-    .argument("[dir]", "repository root", ".")
-    .option("--in <path>", "narrow matches to nodes whose path contains this substring")
-    .option("--json", "output as JSON")
-    .action(traverseAction("callees"));
-program
-    .command("impact")
-    .description("BFS over incoming edges — who breaks if this symbol changes ($0, no LLM)")
+    .description("Who calls/references a symbol ($0, no LLM). --direction out gives callees (what it calls); --depth N walks transitively for full blast radius")
     .argument("<symbol>", "bare name, qualified (Class.method), or package-qualified (pkg.Fn)")
     .argument("[dir]", "repository root", ".")
-    .option("-d, --depth <n>", "max BFS depth (default 2)")
+    .option("--direction <in|out>", 'edge direction: "in" = callers (default), "out" = callees')
+    .option("-d, --depth <n>", "walk transitively up to N hops for blast radius (default 1)")
     .option("--in <path>", "narrow matches to nodes whose path contains this substring")
     .option("--json", "output as JSON")
-    .action(traverseAction("impact"));
+    .action(async (symbol, dir, opts) => {
+    const globalOpts = program.opts();
+    if (!opts.json && readWorkspace(resolve(dir), globalOpts.dir)) {
+        runWorkspaceCallers(resolve(dir), globalOpts.dir, symbol, {
+            direction: opts.direction === "out" ? "out" : "in",
+            depth: opts.depth ? Number(opts.depth) : undefined,
+            in: opts.in,
+        });
+        return;
+    }
+    const { runCallersCommand } = await import("./graph/traverse-cli.js");
+    runCallersCommand(symbol, dir, {
+        direction: opts.direction,
+        depth: opts.depth,
+        in: opts.in,
+        json: opts.json,
+        globalDir: globalOpts.dir,
+    });
+});
 program
     .command("grep")
     .description("Regex search over indexed files, hits grouped by enclosing symbol and ranked by coupling ($0, no LLM)")
@@ -290,8 +304,14 @@ program
     .option("--in <path>", "narrow to files whose path contains this substring")
     .option("--json", "output as JSON")
     .action(async (pattern, dir, opts) => {
-    const { runGrepCommand } = await import("./search/grep-cli.js");
     const globalOpts = program.opts();
+    if (readWorkspace(resolve(dir), globalOpts.dir)) {
+        runWorkspaceGrep(resolve(dir), globalOpts.dir, pattern, {
+            ignoreCase: opts.ignoreCase, fixed: opts.fixed, json: opts.json,
+        });
+        return;
+    }
+    const { runGrepCommand } = await import("./search/grep-cli.js");
     runGrepCommand(pattern, dir, {
         ignoreCase: opts.ignoreCase,
         fixed: opts.fixed,
@@ -307,17 +327,9 @@ program
     .option("--max-dirs <n>", "max directory entries shown, rest counted into dropped (default 16)")
     .option("--json", "output as JSON")
     .action(async (dir, opts) => {
-    const { buildRepoMap, formatRepoMap } = await import("./graph/map.js");
     const root = resolve(dir);
     const globalOpts = program.opts();
-    const contextDir = contextDirFor(root, globalOpts.dir);
-    const graph = loadGraphCached(contextDir);
-    if (!graph) {
-        console.error("✗ no graph — run graft build first");
-        process.exit(1);
-        return;
-    }
-    let maxDirs;
+    let maxDirsW;
     if (opts.maxDirs !== undefined) {
         const n = parseInt(opts.maxDirs, 10);
         if (!Number.isFinite(n) || n <= 0) {
@@ -325,9 +337,21 @@ program
             process.exit(1);
             return;
         }
-        maxDirs = n;
+        maxDirsW = n;
+    }
+    if (!opts.json && readWorkspace(root, globalOpts.dir)) {
+        runWorkspaceMap(root, globalOpts.dir, { maxDirs: maxDirsW });
+        return;
+    }
+    const { buildRepoMap, formatRepoMap } = await import("./graph/map.js");
+    const contextDir = contextDirFor(root, globalOpts.dir);
+    const graph = loadGraphCached(contextDir);
+    if (!graph) {
+        console.error("✗ no graph — run graft build first");
+        process.exit(1);
+        return;
     }
-    const map = buildRepoMap(graph, { maxDirs });
+    const map = buildRepoMap(graph, { maxDirs: maxDirsW });
     if (opts.json) {
         console.log(JSON.stringify(map, null, 2));
         return;
@@ -336,7 +360,7 @@ program
 });
 program
     .command("init")
-    .description("Wire Graft into the AI coding agents used with this repo (instruction files; full hooks + statusline for Claude Code)")
+    .description("Wire Graft into the AI coding agents used with this repo (instruction files + MCP server; full hooks + statusline + MCP for Claude Code)")
     .argument("[dir]", "target repo directory", ".")
     .option("--no-build", "skip building the graph (wire files only)")
     .option("--agents <ids...>", `only these agents (${hostIds().join(", ")}, claude)`)
@@ -369,6 +393,12 @@ program
         for (const s of res.shims)
             console.error(`✓ wrote ${s}`);
         console.error(`✓ wrote ${res.skill}`);
+        if (res.mcp.action === "skipped-unparseable")
+            console.error(`⚠ .mcp.json: ${res.mcp.path} left unchanged (not valid JSON) — add the graft server manually`);
+        else if (res.mcp.action === "unchanged")
+            console.error(`· mcp claude: ${res.mcp.path} (already registered)`);
+        else
+            console.error(`✓ mcp claude: ${res.mcp.path} (${res.mcp.action}) — restart Claude Code to load the graft MCP server`);
         console.error(res.built ? "✓ built the graph (graft build)" : "· skipped graph build");
         for (const w of res.warnings)
             console.error(`⚠ ${w}`);
@@ -385,7 +415,6 @@ program
             console.error(`✓ ${w.id}: ${w.path} (${w.action})`);
         if (!explicit && !opts.allAgents && r.written.length === 0)
             console.error("· no other agents detected (see --list-agents / --all-agents)");
-        // r.unknown is always empty here — ids are validated above, before any writes.
         for (const m of r.mcp)
             console.error(`✓ mcp ${m.id}: ${m.path} (${m.action})`);
         for (const h of r.hooks)