@nanonets/graft 0.5.1 → 0.6.0

package/dist/graph/traverse.js

@@ -82,32 +82,38 @@ export function impactOf(graph, symbol, maxDepth = 2) {
     return impactOfMany(graph, [symbol], maxDepth);
 }
 /**
- * BFS over INCOMING walk-relation edges from *multiple* seed nodes at once —
- * the multi-seed generalization of {@link impactOf} (`impactOf(g, n, d)` is
- * exactly `impactOfMany(g, [n], d)`). Used when one logical unit spans several
- * graph node ids — e.g. a file plus every symbol defined in it, since a
- * `calls`/`references`/etc. edge from another file always targets the SYMBOL
- * id, never the FILE id, so walking the file node alone misses dependents that
- * call into it rather than merely importing it.
+ * BFS over walk-relation edges from *multiple* seed nodes at once, in the given
+ * `direction` (`in` = incoming, the default — "who breaks if this changes";
+ * `out` = outgoing — "what this reaches"). The multi-seed generalization of
+ * {@link impactOf} (`impactOf(g, n, d)` is exactly `impactOfMany(g, [n], d)`).
+ * Used when one logical unit spans several graph node ids — e.g. a file plus
+ * every symbol defined in it, since a `calls`/`references`/etc. edge from
+ * another file always targets the SYMBOL id, never the FILE id, so walking the
+ * file node alone misses dependents that call into it rather than merely
+ * importing it.
  *
  * Every seed is pre-marked visited (so a seed can never appear as its own
  * hit, and an edge between two seeds is never reported), then the walk
  * proceeds exactly like `impactOf`'s: each reached node deduped by id and
  * reported once, at the depth it was first reached from *any* seed.
  */
-export function impactOfMany(graph, seeds, maxDepth = 2) {
+export function impactOfMany(graph, seeds, maxDepth = 2, direction = "in") {
     const byId = new Map(graph.nodes.map((n) => [n.id, n]));
-    // target id → incoming {source, relation} pairs, restricted to walk relations.
-    const incoming = new Map();
+    // Adjacency keyed for the walk direction, restricted to walk relations:
+    //   'in'  → key = edge.target, neighbour = edge.source (who points AT key)
+    //   'out' → key = edge.source, neighbour = edge.target (what key points TO)
+    const adj = new Map();
     for (const e of graph.edges) {
         if (!WALK_RELATIONS.has(e.relation))
             continue;
-        const arr = incoming.get(e.target);
-        const entry = { source: e.source, relation: e.relation };
+        const key = direction === "in" ? e.target : e.source;
+        const other = direction === "in" ? e.source : e.target;
+        const entry = { other, relation: e.relation };
+        const arr = adj.get(key);
         if (arr)
             arr.push(entry);
         else
-            incoming.set(e.target, [entry]);
+            adj.set(key, [entry]);
     }
     const visited = new Set(seeds.map((s) => s.id));
     const hits = [];
@@ -115,12 +121,12 @@ export function impactOfMany(graph, seeds, maxDepth = 2) {
     for (let depth = 1; depth <= maxDepth && frontier.length > 0; depth++) {
         const next = [];
         for (const current of frontier) {
-            for (const { source, relation } of incoming.get(current) ?? []) {
-                if (visited.has(source))
+            for (const { other, relation } of adj.get(current) ?? []) {
+                if (visited.has(other))
                     continue;
-                visited.add(source);
-                hits.push({ node: byId.get(source) ?? null, id: source, relation, depth });
-                next.push(source);
+                visited.add(other);
+                hits.push({ node: byId.get(other) ?? null, id: other, relation, depth });
+                next.push(other);
             }
         }
         frontier = next;
@@ -141,7 +147,27 @@ function symbolsInFile(graph, fileNode) {
  * see this module's header and `impactOfMany`'s doc for why. Symbol-kind
  * queries keep using plain `impactOf`; this is only for file-kind matches.
  */
-export function impactOfFile(graph, fileNode, maxDepth = 2) {
-    return impactOfMany(graph, [fileNode, ...symbolsInFile(graph, fileNode)], maxDepth);
+export function impactOfFile(graph, fileNode, maxDepth = 2, direction = "in") {
+    return impactOfMany(graph, [fileNode, ...symbolsInFile(graph, fileNode)], maxDepth, direction);
+}
+/**
+ * The single entry point behind `graft callers` and the MCP `graft_callers`
+ * tool, covering all of what were once three commands:
+ *   - `direction:in,  depth:1`  → callers      (who calls/references this)
+ *   - `direction:out, depth:1`  → callees      (what this calls/references)
+ *   - `direction:in,  depth>1`  → blast radius  (transitive dependents)
+ *   - `direction:out, depth>1`  → transitive dependencies
+ *
+ * Depth 1 uses the plain single-hop scan ({@link callersOf}/{@link calleesOf})
+ * so `graft callers <symbol>` output is unchanged. Depth >1 runs the BFS, and
+ * for a `kind: 'file'` seed aggregates over the symbols the file defines (see
+ * {@link impactOfMany}) so file-level dependents aren't silently dropped.
+ */
+export function edgeWalk(graph, node, direction, depth) {
+    if (depth <= 1)
+        return direction === "in" ? callersOf(graph, node) : calleesOf(graph, node);
+    if (node.kind === "file")
+        return impactOfFile(graph, node, depth, direction);
+    return impactOfMany(graph, [node], depth, direction);
 }
 //# sourceMappingURL=traverse.js.map

package/dist/graph/traverse.js.map

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

package/dist/graph/workspace.d.ts

@@ -0,0 +1,136 @@
+import { type AskIndex } from "../ask/index-file.js";
+import { type GraphBuildResult } from "./build.js";
+import { type GraphCheckResult } from "./check.js";
+import { type RepoMap } from "./map.js";
+import type { GraphV1 } from "./types.js";
+/** The parent-side manifest — the ONLY thing a workspace parent's graft/ holds. */
+export interface WorkspaceV1 {
+    version: 1;
+    /** Immediate child git repos, as dir names, sorted. */
+    children: string[];
+}
+export declare const WORKSPACE_FILE = "workspace.json";
+/** `<contextDir>/workspace.json` — sibling of where `.graph/` would live. */
+export declare function workspacePath(outDir: string): string;
+/** Read the workspace manifest for the repo/parent at `root` (respecting the
+ * `--dir` override like every other reader). Null when absent or malformed —
+ * a non-workspace root costs one `existsSync`. */
+export declare function readWorkspace(root: string, contextDirOverride?: string): WorkspaceV1 | null;
+/** Write the manifest (children sorted; deterministic bytes, like writeGraph). */
+export declare function writeWorkspace(outDir: string, ws: WorkspaceV1): string;
+/** Build-time workspace detection: `root` has NO `.git` of its own and >=2
+ * immediate git children (a `.git` FILE — worktree/submodule — counts).
+ * Returns the sorted child names, or null when `root` is a normal repo/dir. */
+export declare function isWorkspaceRoot(root: string): string[] | null;
+export interface WorkspaceGraphs {
+    /** All children listed in the manifest. */
+    children: string[];
+    /** Children with a built graph, in manifest order. Each child's graph and
+     * sidecar come from ITS OWN `graft/` via the shared caches. */
+    built: {
+        child: string;
+        contextDir: string;
+        graph: GraphV1;
+        askIndex: AskIndex | null;
+    }[];
+    /** Children without a built graph — surfaced, never silently skipped. */
+    unbuilt: string[];
+    /** The surfacing line, set whenever `unbuilt` is non-empty. */
+    note?: string;
+}
+/** Load every child's graph via `loadGraphCached` (the only graph loader).
+ * Null when `root` is not a workspace (no manifest). */
+export declare function loadWorkspaceGraphs(root: string, contextDirOverride?: string): WorkspaceGraphs | null;
+/** Merge the built children into one virtual graph whose scopes are each
+ * child's scopes prefixed `<child>/` (child root scope → `<child>`). With >=2
+ * built children this is always multi-scope, so `ask` takes its per-scope
+ * RRF path and labels every hit with its repo. Null when nothing is built. */
+export declare function mergeWorkspaceGraphs(built: WorkspaceGraphs["built"]): GraphV1 | null;
+/** Merge the children's build-time ask sidecars to match the merged graph:
+ * doc ids prefixed, and each doc's path bag gains the child dir's tokens —
+ * exactly what live tokenization of the prefixed path would produce, so the
+ * sidecar stays a provably exact cache. `df`/`docCount`/`avgBodyLen` are
+ * recomputed over the merged docs. Null (→ live-tokenization fallback, same
+ * degradation as any stale sidecar) unless EVERY built child has a sidecar
+ * that exactly covers its graph. */
+export declare function mergeWorkspaceAskIndexes(built: WorkspaceGraphs["built"]): AskIndex | null;
+/** One-call federation for graph-consuming commands (grep, callers/callees,
+ * impact, MCP): null when `root` is not a workspace; otherwise the merged
+ * graph (null when no child is built) plus the unbuilt-children note. */
+export declare function loadFederatedGraph(root: string, contextDirOverride?: string): {
+    graph: GraphV1 | null;
+    note?: string;
+} | null;
+/** Federation inputs for `ask`: the merged graph + merged sidecar + each built
+ * child's context dir (for its concept nodes). `ask` feeds the merged graph to
+ * its existing multi-scope pipeline, so `rankScopesAndFuse` does the fair
+ * cross-repo fusion with `<child>/`-prefixed scope labels. */
+export declare function federateAsk(root: string, contextDirOverride?: string): {
+    graph: GraphV1 | null;
+    askIndex: AskIndex | null;
+    built: {
+        child: string;
+        contextDir: string;
+    }[];
+    note?: string;
+} | null;
+/** EXACT migration wording (asserted by tests) for a parent whose old combined
+ * graph is being replaced by the workspace manifest. */
+export declare function migrationNote(children: string[]): string;
+export interface WorkspaceBuildResult {
+    children: {
+        child: string;
+        result: GraphBuildResult;
+    }[];
+    workspacePath: string;
+    /** True when a pre-existing combined graph at the parent was replaced. */
+    migrated: boolean;
+    /** The exact {@link migrationNote} wording, set only when `migrated`. */
+    migrationNote?: string;
+}
+/**
+ * `graft build` at a workspace parent: build each child's graph into the child
+ * (plain `buildGraph(childDir)` — nothing parent-side touches it, which is what
+ * makes the result byte-identical to a standalone build), then write the
+ * parent manifest. A pre-existing mega-graph (`graft/.graph/wiring.json` at
+ * the parent) is replaced: its `.graph/` and `.cache/` are deleted AFTER the
+ * children built successfully, so a failed child build never destroys the old
+ * (still-working) graph.
+ */
+export declare function buildWorkspace(root: string, opts?: {
+    contextDir?: string;
+}): Promise<WorkspaceBuildResult>;
+/** Human report for a workspace build — the migration note (when migrating)
+ * first, then one ✓ line per child, then where the manifest went. */
+export declare function formatWorkspaceBuild(r: WorkspaceBuildResult): string;
+export interface WorkspaceCheck {
+    children: {
+        child: string;
+        missing: boolean;
+        ok: boolean;
+        summary: string;
+        result: GraphCheckResult;
+    }[];
+    /** True when any child that HAS a graph is stale — unbuilt alone never fails. */
+    failed: boolean;
+}
+/** Per-child drift check ({@link checkGraph} in each child repo). */
+export declare function checkWorkspace(root: string, contextDirOverride?: string): WorkspaceCheck;
+export declare function formatWorkspaceCheck(c: WorkspaceCheck): string;
+export interface WorkspaceMap {
+    children: {
+        child: string;
+        map: RepoMap;
+    }[];
+    note?: string;
+}
+/** Per-child repo maps, the directory budget split evenly across the built
+ * children. Null when `root` is not a workspace. */
+export declare function buildWorkspaceMap(root: string, opts?: {
+    maxDirs?: number;
+    contextDir?: string;
+}): WorkspaceMap | null;
+/** One section per child (its own `formatRepoMap` report under a `<child>/`
+ * heading), plus the unbuilt-children note when present. */
+export declare function formatWorkspaceMap(m: WorkspaceMap): string;
+//# sourceMappingURL=workspace.d.ts.map

package/dist/graph/workspace.d.ts.map

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

package/dist/graph/workspace.js

@@ -0,0 +1,339 @@
+/**
+ * Workspace federation — a parent directory with >=2 immediate git children
+ * and no own `.git` is a WORKSPACE, not a repo. Building there builds each
+ * child's graph INTO THE CHILD (`<child>/graft/`, committable in that repo,
+ * byte-identical to a standalone build — the parent never influences a child
+ * build) and leaves the parent holding ONLY `graft/workspace.json`: a manifest
+ * of child dir names, no nodes or edges.
+ *
+ * Queries at the parent federate across the children's graphs:
+ *   - `ask` merges the child graphs into one virtual corpus whose ranking
+ *     scopes are `<child>/<scope>` (child root scope → `<child>`), so the
+ *     existing per-scope RRF pipeline (`rankScopesAndFuse`) does the fair
+ *     cross-repo fusion — a big repo can't drown a small one, and every hit
+ *     is labeled with the repo it came from.
+ *   - `grep` / `callers` / `callees` / `impact` run over the same merged
+ *     graph: node ids and paths are prefixed `<child>/`, edges never cross
+ *     children, so in-degree/coupling stays each child's own.
+ *   - `map` and `check` run per child (see {@link buildWorkspaceMap} /
+ *     {@link checkWorkspace}).
+ *
+ * Migration: a parent that HAS an old combined ("mega") graph gets it replaced
+ * by the workspace manifest on the next `graft build` there — loudly, via
+ * {@link migrationNote} — and never any other way: a stale mega-graph parent
+ * keeps answering `check`/queries as before until the user rebuilds.
+ *
+ * Unbuilt children are surfaced, never silently skipped: every loader here
+ * carries a "N of M workspace repos have graphs; run graft build to cover X"
+ * note that each command attaches to its output.
+ */
+import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
+import { join, resolve } from "node:path";
+import { contextDirFor, CACHE_DIR } from "../context/node-file.js";
+import { counts, tokenize } from "../ask/index-file.js";
+import { buildGraph } from "./build.js";
+import { checkGraph } from "./check.js";
+import { loadGraphCached, loadAskIndexCached } from "./load.js";
+import { buildRepoMap, formatRepoMap } from "./map.js";
+import { discoverWorkspaceChildren, scopesOfGraph } from "./scopes.js";
+import { GRAPH_DIR, wiringPath } from "./write.js";
+export const WORKSPACE_FILE = "workspace.json";
+/** `<contextDir>/workspace.json` — sibling of where `.graph/` would live. */
+export function workspacePath(outDir) {
+    return join(outDir, WORKSPACE_FILE);
+}
+/** Read the workspace manifest for the repo/parent at `root` (respecting the
+ * `--dir` override like every other reader). Null when absent or malformed —
+ * a non-workspace root costs one `existsSync`. */
+export function readWorkspace(root, contextDirOverride) {
+    const path = workspacePath(contextDirFor(resolve(root), contextDirOverride));
+    if (!existsSync(path))
+        return null;
+    try {
+        const raw = JSON.parse(readFileSync(path, "utf8"));
+        if (!raw ||
+            typeof raw !== "object" ||
+            raw.version !== 1 ||
+            !Array.isArray(raw.children) ||
+            !raw.children.every((c) => typeof c === "string" && c.length > 0)) {
+            return null;
+        }
+        return { version: 1, children: raw.children };
+    }
+    catch {
+        return null;
+    }
+}
+/** Write the manifest (children sorted; deterministic bytes, like writeGraph). */
+export function writeWorkspace(outDir, ws) {
+    const path = workspacePath(outDir);
+    mkdirSync(outDir, { recursive: true });
+    const sorted = { version: 1, children: [...ws.children].sort() };
+    writeFileSync(path, JSON.stringify(sorted, null, 2) + "\n");
+    return path;
+}
+/** Build-time workspace detection: `root` has NO `.git` of its own and >=2
+ * immediate git children (a `.git` FILE — worktree/submodule — counts).
+ * Returns the sorted child names, or null when `root` is a normal repo/dir. */
+export function isWorkspaceRoot(root) {
+    const absRoot = resolve(root);
+    if (existsSync(join(absRoot, ".git")))
+        return null;
+    const children = discoverWorkspaceChildren(absRoot).sort();
+    return children.length >= 2 ? children : null;
+}
+/** Load every child's graph via `loadGraphCached` (the only graph loader).
+ * Null when `root` is not a workspace (no manifest). */
+export function loadWorkspaceGraphs(root, contextDirOverride) {
+    const ws = readWorkspace(root, contextDirOverride);
+    if (!ws)
+        return null;
+    const absRoot = resolve(root);
+    const built = [];
+    const unbuilt = [];
+    for (const child of ws.children) {
+        // children always use their own default graft/ — that's what makes each
+        // child's graph committable in (and byte-identical to) the child repo.
+        const contextDir = contextDirFor(join(absRoot, child));
+        const graph = loadGraphCached(contextDir);
+        if (graph)
+            built.push({ child, contextDir, graph, askIndex: loadAskIndexCached(contextDir) });
+        else
+            unbuilt.push(child);
+    }
+    const note = unbuilt.length
+        ? `${built.length} of ${ws.children.length} workspace repos have graphs; run graft build to cover ${unbuilt.join(", ")}`
+        : undefined;
+    return { children: ws.children, built, unbuilt, note };
+}
+// ── Merging: one virtual graph, everything prefixed `<child>/` ───────────────
+/** Prefix a child's nodes/edges with `<child>/` so ids and paths are unique
+ * and workspace-relative (pointers open from the parent cwd). Edge endpoints
+ * that aren't node ids (unresolved import module strings) stay untouched. */
+function prefixChild(child, g) {
+    const ids = new Set(g.nodes.map((n) => n.id));
+    const pre = (id) => (ids.has(id) ? `${child}/${id}` : id);
+    return {
+        nodes: g.nodes.map((n) => ({ ...n, id: `${child}/${n.id}`, path: `${child}/${n.path}` })),
+        edges: g.edges.map((e) => ({ ...e, source: pre(e.source), target: pre(e.target) })),
+    };
+}
+/** Merge the built children into one virtual graph whose scopes are each
+ * child's scopes prefixed `<child>/` (child root scope → `<child>`). With >=2
+ * built children this is always multi-scope, so `ask` takes its per-scope
+ * RRF path and labels every hit with its repo. Null when nothing is built. */
+export function mergeWorkspaceGraphs(built) {
+    if (built.length === 0)
+        return null;
+    const nodes = [];
+    const edges = [];
+    const langs = new Set();
+    const scopes = [];
+    for (const { child, graph } of built) {
+        const p = prefixChild(child, graph);
+        nodes.push(...p.nodes);
+        edges.push(...p.edges);
+        for (const l of graph.meta.languages)
+            langs.add(l);
+        for (const s of scopesOfGraph(graph)) {
+            const prefix = s.prefix ? `${child}/${s.prefix}` : child;
+            scopes.push({ prefix, label: prefix, markers: s.markers });
+        }
+    }
+    // rule-7 ordering (prefix-length desc, then lexicographic) — scopeOf depends on it.
+    scopes.sort((a, b) => b.prefix.length - a.prefix.length || a.prefix.localeCompare(b.prefix));
+    return {
+        meta: {
+            version: 1,
+            nodeCount: nodes.length,
+            edgeCount: edges.length,
+            languages: [...langs].sort(),
+            scopes,
+        },
+        nodes,
+        edges,
+    };
+}
+function addBag(into, pairs) {
+    for (const [t, c] of pairs)
+        into.set(t, (into.get(t) ?? 0) + c);
+}
+/** Merge the children's build-time ask sidecars to match the merged graph:
+ * doc ids prefixed, and each doc's path bag gains the child dir's tokens —
+ * exactly what live tokenization of the prefixed path would produce, so the
+ * sidecar stays a provably exact cache. `df`/`docCount`/`avgBodyLen` are
+ * recomputed over the merged docs. Null (→ live-tokenization fallback, same
+ * degradation as any stale sidecar) unless EVERY built child has a sidecar
+ * that exactly covers its graph. */
+export function mergeWorkspaceAskIndexes(built) {
+    if (built.length === 0)
+        return null;
+    for (const { graph, askIndex } of built) {
+        if (!askIndex || askIndex.docs.length !== graph.nodes.length)
+            return null;
+        const byId = new Set(askIndex.docs.map((d) => d.id));
+        if (!graph.nodes.every((n) => byId.has(n.id)))
+            return null;
+    }
+    const docs = [];
+    const df = new Map();
+    let bodyLenSum = 0;
+    for (const { child, askIndex } of built) {
+        const childTokens = [...counts(tokenize(child)).entries()];
+        for (const d of askIndex.docs) {
+            const path = new Map();
+            addBag(path, childTokens);
+            addBag(path, d.path);
+            const doc = { id: `${child}/${d.id}`, name: d.name, path: [...path.entries()], body: d.body };
+            docs.push(doc);
+            const bag = new Set([...doc.name, ...doc.path, ...doc.body].map(([t]) => t));
+            for (const t of bag)
+                df.set(t, (df.get(t) ?? 0) + 1);
+            for (const [, c] of d.body)
+                bodyLenSum += c;
+        }
+    }
+    return {
+        version: 1,
+        avgBodyLen: docs.length ? bodyLenSum / docs.length : 0,
+        df: [...df.entries()],
+        docCount: docs.length,
+        docs,
+    };
+}
+/** One-call federation for graph-consuming commands (grep, callers/callees,
+ * impact, MCP): null when `root` is not a workspace; otherwise the merged
+ * graph (null when no child is built) plus the unbuilt-children note. */
+export function loadFederatedGraph(root, contextDirOverride) {
+    const wg = loadWorkspaceGraphs(root, contextDirOverride);
+    if (!wg)
+        return null;
+    return { graph: mergeWorkspaceGraphs(wg.built), note: wg.note };
+}
+/** Federation inputs for `ask`: the merged graph + merged sidecar + each built
+ * child's context dir (for its concept nodes). `ask` feeds the merged graph to
+ * its existing multi-scope pipeline, so `rankScopesAndFuse` does the fair
+ * cross-repo fusion with `<child>/`-prefixed scope labels. */
+export function federateAsk(root, contextDirOverride) {
+    const wg = loadWorkspaceGraphs(root, contextDirOverride);
+    if (!wg)
+        return null;
+    return {
+        graph: mergeWorkspaceGraphs(wg.built),
+        askIndex: mergeWorkspaceAskIndexes(wg.built),
+        built: wg.built.map(({ child, contextDir }) => ({ child, contextDir })),
+        note: wg.note,
+    };
+}
+// ── Build + migration ────────────────────────────────────────────────────────
+/** EXACT migration wording (asserted by tests) for a parent whose old combined
+ * graph is being replaced by the workspace manifest. */
+export function migrationNote(children) {
+    return (`⚠ this folder contains ${children.length} separate git repos — splitting: each repo now gets ` +
+        `its own committable graft/ (${children.map((c) => `${c}/graft/`).join(", ")}); the combined ` +
+        `graph here is replaced by a workspace index. Queries from here now search all repos, fairly.`);
+}
+/**
+ * `graft build` at a workspace parent: build each child's graph into the child
+ * (plain `buildGraph(childDir)` — nothing parent-side touches it, which is what
+ * makes the result byte-identical to a standalone build), then write the
+ * parent manifest. A pre-existing mega-graph (`graft/.graph/wiring.json` at
+ * the parent) is replaced: its `.graph/` and `.cache/` are deleted AFTER the
+ * children built successfully, so a failed child build never destroys the old
+ * (still-working) graph.
+ */
+export async function buildWorkspace(root, opts = {}) {
+    const absRoot = resolve(root);
+    const children = discoverWorkspaceChildren(absRoot).sort();
+    const outDir = contextDirFor(absRoot, opts.contextDir);
+    const hadMegaGraph = existsSync(wiringPath(outDir));
+    const results = [];
+    for (const child of children) {
+        results.push({ child, result: await buildGraph(join(absRoot, child)) });
+    }
+    if (hadMegaGraph) {
+        rmSync(join(outDir, GRAPH_DIR), { recursive: true, force: true });
+        rmSync(join(outDir, CACHE_DIR), { recursive: true, force: true });
+    }
+    const path = writeWorkspace(outDir, { version: 1, children });
+    return {
+        children: results,
+        workspacePath: path,
+        migrated: hadMegaGraph,
+        migrationNote: hadMegaGraph ? migrationNote(children) : undefined,
+    };
+}
+/** Human report for a workspace build — the migration note (when migrating)
+ * first, then one ✓ line per child, then where the manifest went. */
+export function formatWorkspaceBuild(r) {
+    const lines = [];
+    if (r.migrationNote)
+        lines.push(r.migrationNote);
+    for (const { child, result } of r.children) {
+        lines.push(`✓ ${child}/: ${result.nodes} nodes, ${result.edges} edges, ${result.cards} cards [${result.languages.join(", ")}]`);
+        for (const e of result.errors)
+            lines.push(`✗ ${child}/: ${e}`);
+    }
+    lines.push(`  → ${r.workspacePath}`);
+    lines.push(`  queries here now federate across: ${r.children.map((c) => `${c.child}/`).join(", ")}`);
+    return lines.join("\n");
+}
+/** Per-child drift check ({@link checkGraph} in each child repo). */
+export function checkWorkspace(root, contextDirOverride) {
+    const ws = readWorkspace(root, contextDirOverride);
+    const children = ws?.children ?? [];
+    const absRoot = resolve(root);
+    const rows = children.map((child) => {
+        const result = checkGraph(join(absRoot, child));
+        if (result.missing) {
+            return { child, missing: true, ok: false, summary: "no graph — run `graft build` to cover it", result };
+        }
+        if (result.ok)
+            return { child, missing: false, ok: true, summary: "OK — wiring graph in sync", result };
+        const parts = [];
+        if (result.changed.length)
+            parts.push(`${result.changed.length} changed`);
+        if (result.added.length)
+            parts.push(`${result.added.length} added`);
+        if (result.removed.length)
+            parts.push(`${result.removed.length} removed`);
+        if (result.stale.length)
+            parts.push(`${result.stale.length} stale summaries`);
+        return { child, missing: false, ok: false, summary: `STALE — ${parts.join(", ")} (run \`graft build\` in ${child}/)`, result };
+    });
+    return { children: rows, failed: rows.some((r) => !r.missing && !r.ok) };
+}
+export function formatWorkspaceCheck(c) {
+    const lines = [`workspace check — ${c.children.length} repos`, ""];
+    for (const row of c.children)
+        lines.push(`${row.child}/: ${row.summary}`);
+    lines.push("");
+    lines.push(c.failed
+        ? "workspace check: STALE — rebuild the repos above and commit their graft/."
+        : "workspace check: OK");
+    return lines.join("\n");
+}
+/** Per-child repo maps, the directory budget split evenly across the built
+ * children. Null when `root` is not a workspace. */
+export function buildWorkspaceMap(root, opts = {}) {
+    const wg = loadWorkspaceGraphs(root, opts.contextDir);
+    if (!wg)
+        return null;
+    const per = Math.max(1, Math.floor((opts.maxDirs ?? 16) / Math.max(1, wg.built.length)));
+    return {
+        children: wg.built.map(({ child, graph }) => ({ child, map: buildRepoMap(graph, { maxDirs: per }) })),
+        note: wg.note,
+    };
+}
+/** One section per child (its own `formatRepoMap` report under a `<child>/`
+ * heading), plus the unbuilt-children note when present. */
+export function formatWorkspaceMap(m) {
+    const lines = [`workspace map — ${m.children.length} repo${m.children.length === 1 ? "" : "s"}`];
+    for (const { child, map } of m.children) {
+        lines.push("", `── ${child}/ ──`, formatRepoMap(map).trimEnd());
+    }
+    if (m.note)
+        lines.push("", m.note);
+    return lines.join("\n") + "\n";
+}
+//# sourceMappingURL=workspace.js.map

package/dist/graph/workspace.js.map

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

package/dist/hosts/instructions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"instructions.d.ts","sourceRoot":"","sources":["../../src/hosts/instructions.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,wBAAgB,eAAe,IAAI,MAAM,CAoCxC;AAED,wBAAgB,UAAU,IAAI,MAAM,CAOnC;AAED,wBAAgB,YAAY,IAAI,MAAM,CAMrC;AAED,wBAAgB,YAAY,IAAI,MAAM,CAGrC"}
+{"version":3,"file":"instructions.d.ts","sourceRoot":"","sources":["../../src/hosts/instructions.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,wBAAgB,eAAe,IAAI,MAAM,CAqCxC;AAED,wBAAgB,UAAU,IAAI,MAAM,CAOnC;AAED,wBAAgB,YAAY,IAAI,MAAM,CAMrC;AAED,wBAAgB,YAAY,IAAI,MAAM,CAGrC"}