trail-code 0.0.0-stage → 0.28.0-semantic.3

package/dist/graph/wasm-runtime.js

@@ -0,0 +1,38 @@
+/**
+ * The two web-tree-sitter runtimes WASM grammars load into, each initialised once.
+ *
+ * `Parser.init()` is not idempotent: a second call instantiates a second runtime
+ * and swaps it in, and every grammar loaded into the first one is then unusable.
+ * So every tier gets its runtime from here.
+ *
+ * - {@link webTreeSitter}, the current release, runs the breadth tier (generic.ts)
+ *   and the container tier's wrapper grammars (container.ts).
+ * - {@link depthRuntime}, web-tree-sitter 0.22.2 (the `web-tree-sitter-depth`
+ *   alias), runs the depth tier (depth-parser.ts). 0.22.2 is the tree-sitter core
+ *   the native addon (tree-sitter 0.21.1) was built with, and the core decides how
+ *   a grammar's conflicts and errors resolve. On it, every tree of the parity
+ *   corpus matched the native one; on the current core, kotlin, swift and
+ *   typescript trees did not always. Keep it pinned: bumping it is a grammar
+ *   change, to be re-checked with test/depth-parity.ts.
+ */
+import { createRequire } from "node:module";
+let init = null;
+/** The initialised current runtime, loading and initialising it on the first call. */
+export function webTreeSitter() {
+    init ??= import("web-tree-sitter").then(async (m) => {
+        await m.Parser.init();
+        return m;
+    });
+    return init;
+}
+let depth = null;
+/** The depth tier's runtime, initialised on the first call. */
+export function depthRuntime() {
+    depth ??= (async () => {
+        const Parser = createRequire(import.meta.url)("web-tree-sitter-depth");
+        await Parser.init();
+        return { load: (wasm) => Parser.Language.load(wasm), newParser: () => new Parser() };
+    })();
+    return depth;
+}
+//# sourceMappingURL=wasm-runtime.js.map

package/dist/graph/wasm-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wasm-runtime.js","sourceRoot":"","sources":["../../src/graph/wasm-runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAI5C,IAAI,IAAI,GAAkC,IAAI,CAAC;AAE/C,sFAAsF;AACtF,MAAM,UAAU,aAAa;IAC3B,IAAI,KAAK,MAAM,CAAC,iBAAiB,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE;QAClD,MAAM,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QACtB,OAAO,CAAC,CAAC;IACX,CAAC,CAAC,CAAC;IACH,OAAO,IAAI,CAAC;AACd,CAAC;AAiBD,IAAI,KAAK,GAAiC,IAAI,CAAC;AAE/C,+DAA+D;AAC/D,MAAM,UAAU,YAAY;IAC1B,KAAK,KAAK,CAAC,KAAK,IAAI,EAAE;QACpB,MAAM,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,uBAAuB,CAAqB,CAAC;QAC3F,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,OAAO,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,IAAI,MAAM,EAAE,EAAE,CAAC;IACvF,CAAC,CAAC,EAAE,CAAC;IACL,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/graph/workspace-cli.d.ts

@@ -0,0 +1,56 @@
+import type { EngineConfig } from "../ai/providers.js";
+import type { Direction } from "./traverse.js";
+export interface WorkspaceBuildOptions {
+    deep: boolean;
+    extensions?: string[];
+    concurrency?: number;
+    /** Max concept synthesis batches in flight per child (default 4). */
+    synthConcurrency?: number;
+    /** Provider/model/key config for child builds — WITHOUT any contextDir
+     * override, so each child writes to its own `<child>/graft/`. */
+    childConfig: EngineConfig;
+    override?: string;
+    /** The CLI's `--include-dir` override, if any. Persisted into EACH CHILD's
+     * own state (not the parent's) before that child builds: children are
+     * independent repos with their own local settings and can later be rebuilt
+     * directly without seeing the parent invocation's flags. */
+    includeDirs?: string[];
+    /** An explicit CLI submodule choice to persist into every child repo. */
+    followSubmodules?: boolean;
+    /** An explicit CLI nested-clone choice to persist into every child repo. */
+    followNestedRepos?: boolean;
+    /** An explicit CLI --include-md choice to persist into every child repo. */
+    includeMd?: boolean;
+    /** Repo-relative dirs to limit .md indexing to, persisted into each child. */
+    mdOnlyDirs?: string[];
+    /** Whether to include openspec/changes/archive/ .md files; persisted into each child. */
+    includeOpenSpecArchive?: boolean;
+    /** The npm package this runs from, for the fix in the native-parser notice. */
+    packageName?: string;
+}
+/** Build every git child into its own committable `graft/`, then replace the
+ * parent's `graft/` with `workspace.json`. Prints the one-time split warning
+ * first when migrating away from a mega-graph. */
+export declare function runWorkspaceBuild(root: string, opts: WorkspaceBuildOptions): Promise<void>;
+export declare function runWorkspaceAsk(root: string, override: string | undefined, query: string, opts: {
+    limit?: number;
+    source?: boolean;
+    full?: boolean;
+    in?: string;
+    json?: boolean;
+}): void;
+export declare function runWorkspaceGrep(root: string, override: string | undefined, pattern: string, opts: {
+    ignoreCase?: boolean;
+    fixed?: boolean;
+    json?: boolean;
+}): void;
+export declare function runWorkspaceMap(root: string, override: string | undefined, opts: {
+    maxDirs?: number;
+}): void;
+export declare function runWorkspaceCheck(root: string, override?: string): Promise<void>;
+export declare function runWorkspaceCallers(root: string, override: string | undefined, symbol: string, opts: {
+    direction?: Direction;
+    depth?: number;
+    in?: string;
+}): void;
+//# sourceMappingURL=workspace-cli.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-cli.d.ts","sourceRoot":"","sources":["../../src/graph/workspace-cli.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAa/C,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,OAAO,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qEAAqE;IACrE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;qEACiE;IACjE,WAAW,EAAE,YAAY,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;gEAG4D;IAC5D,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,yEAAyE;IACzE,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,4EAA4E;IAC5E,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,4EAA4E;IAC5E,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,8EAA8E;IAC9E,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,yFAAyF;IACzF,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,+EAA+E;IAC/E,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;kDAEkD;AAClD,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAyDhG;AAED,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,KAAK,EAAE,MAAM,EACb,IAAI,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,GACtF,IAAI,CAIN;AAED,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE;IAAE,UAAU,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,GAC9D,IAAI,CAYN;AAED,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,IAAI,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GACzB,IAAI,CAEN;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAItF;AAED,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE;IAAE,SAAS,CAAC,EAAE,SAAS,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,GAC3D,IAAI,CAON"}

package/dist/graph/workspace-cli.js

@@ -0,0 +1,111 @@
+/**
+ * CLI print/exit wrappers + per-child build orchestration for workspace
+ * federation. Kept out of both `cli.ts` (so routing there stays a one-liner
+ * per command) and `workspace.ts` (so the core stays free of process/exit and
+ * engine dependencies). The federated command bodies live in `workspace.ts`;
+ * this file only renders them and wires the child builds through the engine.
+ */
+import { Graft } from "../engine.js";
+import { contextDirFor, ensureGitignored } from "../context/node-file.js";
+import { patchBuildConfig } from "../util/state.js";
+import { brand, cmd, PACKAGE_FOR } from "../brand.js";
+import { nativeFallbackNotice } from "./native.js";
+import { formatAsk } from "../ask/ask.js";
+import { federateAsk, federateCallers, federateCheck, federateGrep, federateMap, formatGrepResult, migrationNote, splitWorkspace, zeroHitNote, } from "./workspace.js";
+/** Build every git child into its own committable `graft/`, then replace the
+ * parent's `graft/` with `workspace.json`. Prints the one-time split warning
+ * first when migrating away from a mega-graph. */
+export async function runWorkspaceBuild(root, opts) {
+    // Depth grammars load once per process, so the children share one answer:
+    // collected here and printed once at the end, not once per repo.
+    const fellBack = { languages: new Set(), packages: new Set() };
+    const buildChild = async (childDir, childName) => {
+        // Persisted BEFORE the child build itself runs, same as the single-repo
+        // path in cli.ts, so this build and every later no-flag child build agree.
+        const childConfigPatch = {};
+        if (opts.includeDirs && opts.includeDirs.length > 0) {
+            childConfigPatch.includeDirs = opts.includeDirs;
+        }
+        if (opts.followSubmodules !== undefined) {
+            childConfigPatch.followSubmodules = opts.followSubmodules;
+        }
+        if (opts.followNestedRepos !== undefined) {
+            childConfigPatch.followNestedRepos = opts.followNestedRepos;
+        }
+        if (opts.includeMd !== undefined) {
+            childConfigPatch.includeMd = opts.includeMd;
+        }
+        if (opts.mdOnlyDirs && opts.mdOnlyDirs.length > 0) {
+            childConfigPatch.mdOnlyDirs = opts.mdOnlyDirs;
+        }
+        if (opts.includeOpenSpecArchive !== undefined) {
+            childConfigPatch.includeOpenSpecArchive = opts.includeOpenSpecArchive;
+        }
+        if (Object.keys(childConfigPatch).length > 0) {
+            patchBuildConfig(childDir, childConfigPatch);
+        }
+        const engine = new Graft({ ...opts.childConfig, contextDir: undefined });
+        if (opts.deep)
+            await engine.init(childDir, { extensions: opts.extensions, synthConcurrency: opts.synthConcurrency });
+        const g = await engine.graph(childDir, { llm: opts.deep, concurrency: opts.concurrency });
+        console.log(`✓ ${childName}/: ${g.nodes} nodes, ${g.edges} edges, ${g.cards} cards [${g.languages.join(", ")}]`);
+        for (const e of g.errors)
+            console.error(`✗ ${childName}/: ${e}`);
+        for (const l of g.nativeFallback?.languages ?? [])
+            fellBack.languages.add(l);
+        for (const p of g.nativeFallback?.packages ?? [])
+            fellBack.packages.add(p);
+    };
+    const { children } = await splitWorkspace(root, opts.override, buildChild, ({ children, migrated }) => {
+        if (migrated)
+            console.error(migrationNote(children));
+        console.error(`building ${children.length} workspace repos: ${children.join(", ")}`);
+    });
+    // Each child self-ignored during its own build; the parent's federation
+    // index (graft/workspace.json) is written outside buildGraph, so ignore it here too.
+    ensureGitignored(root, contextDirFor(root, opts.override));
+    console.log(`✓ workspace: ${children.length} repos federated → graft/workspace.json`);
+    console.log(`  graft/ is git-ignored — each teammate runs \`${cmd("graft build")}\` to regenerate it locally.`);
+    const notice = nativeFallbackNotice({ languages: [...fellBack.languages].sort(), packages: [...fellBack.packages].sort() }, opts.packageName ?? PACKAGE_FOR[brand()]);
+    if (notice)
+        console.error(notice);
+}
+export function runWorkspaceAsk(root, override, query, opts) {
+    const r = federateAsk(root, override, query, { limit: opts.limit, source: opts.source, full: opts.full, in: opts.in });
+    if (opts.json)
+        console.log(JSON.stringify(r, null, 2));
+    else
+        process.stdout.write(formatAsk(r));
+}
+export function runWorkspaceGrep(root, override, pattern, opts) {
+    const { result, coverage } = federateGrep(root, override, pattern, { ignoreCase: opts.ignoreCase, fixed: opts.fixed });
+    if (opts.json) {
+        console.log(JSON.stringify(result, null, 2));
+        return;
+    }
+    if (result.totalHits === 0) {
+        console.error(coverage ? `${zeroHitNote(result)}\n${coverage}` : zeroHitNote(result));
+        return;
+    }
+    process.stdout.write(formatGrepResult(result));
+    if (coverage)
+        console.log(coverage);
+}
+export function runWorkspaceMap(root, override, opts) {
+    process.stdout.write(federateMap(root, override, { maxDirs: opts.maxDirs }));
+}
+export async function runWorkspaceCheck(root, override) {
+    const { text, ok } = await federateCheck(root, override);
+    process.stdout.write(text);
+    if (!ok)
+        process.exit(1);
+}
+export function runWorkspaceCallers(root, override, symbol, opts) {
+    const { text, found } = federateCallers(root, override, symbol, opts);
+    if (!found) {
+        console.error(`✗ ${text}`);
+        process.exit(1);
+    }
+    process.stdout.write(text + "\n");
+}
+//# sourceMappingURL=workspace-cli.js.map

package/dist/graph/workspace-cli.js.map

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

package/dist/graph/workspace.d.ts

@@ -0,0 +1,172 @@
+import { type Direction } from "./traverse.js";
+import type { GraphV1 } from "./types.js";
+import { type AskResult } from "../ask/ask.js";
+import { type GrepResult } from "../search/grep.js";
+import { formatGrepResult, zeroHitNote } from "../search/grep-cli.js";
+/** The parent index written to `<parent>/graft/workspace.json`. Nodes/edges
+ * never live at the parent — they live in each child's own `graft/`. */
+export interface WorkspaceV1 {
+    version: 1;
+    /** Immediate child dir names that are git repos, sorted. */
+    children: string[];
+    /**
+     * Dirs to skip during auto-discovery. Edit this list to permanently exclude
+     * a repo from the workspace — `trail build` will preserve and respect it.
+     * Paths are relative to the workspace root (e.g. `"Trail-Code"`, `"SDK"`).
+     */
+    excludeFromDiscovery?: string[];
+    /**
+     * Git remote URLs of shared knowledge repos (team docs, rules, glossaries).
+     * `trail init` clones each one into the workspace root if it isn't already
+     * present, wires it, and runs `trail build --include-md` on it automatically.
+     * Committed to version control so every team member gets the same repos.
+     *
+     * Example: ["https://gitlab.com/detacoop/equipo-desarrolladores/detacoop-knowledge"]
+     */
+    knowledgeRepos?: string[];
+}
+/** Absolute path to the knowledge-repos config for a workspace root. Always committed. */
+export declare function knowledgeReposPath(root: string): string;
+/** Read the list of knowledge repo URLs for a workspace root. */
+export declare function readKnowledgeRepos(root: string): string[];
+/** Write the list of knowledge repo URLs. Ensures .trail/ exists. */
+export declare function writeKnowledgeRepos(root: string, urls: string[]): void;
+/** Absolute path to the workspace index for a parent root (`<dir>/graft/workspace.json`). */
+export declare function workspacePath(root: string, override?: string): string;
+/** Read the workspace index, or null when the parent has none (not a workspace,
+ * or unparseable/foreign json — treated the same as absent). */
+export declare function readWorkspace(root: string, override?: string): WorkspaceV1 | null;
+/** Write the workspace index, sorting children for a stable, minimal git diff.
+ * Preserves `excludeFromDiscovery` across rebuilds. */
+export declare function writeWorkspace(root: string, ws: WorkspaceV1, override?: string): string;
+/** A parent is a workspace BUILD target when it has no own `.git` and ≥2 git
+ * children — or it was already split (a `workspace.json` is present). The
+ * no-own-`.git` guard keeps a normal repo with git submodules from being
+ * mistaken for a workspace. */
+/**
+ * Walk up from `dir` to find the nearest directory with knowledgeRepos configured
+ * (.trail/knowledge-repos.json). Works for repos, workspaces, and plain folders.
+ * Falls back to the first workspace found if none has knowledgeRepos.
+ */
+export declare function findWorkspaceRoot(dir: string): string | null;
+export declare function isWorkspaceBuildRoot(root: string, override?: string): boolean;
+/** True when the parent has a mega-graph from an older single-graph build
+ * (`graft/.graph/wiring.json`) — the thing a workspace build migrates away. */
+export declare function hasMegaGraph(root: string, override?: string): boolean;
+/** The EXACT split warning printed once, when a mega-graph parent is first
+ * built as a workspace. Templated on the child list so it names the real repos. */
+export declare function migrationNote(children: string[]): string;
+/** Remove the parent's entire `graft/` tree — the mega-graph, its `.cache`, and
+ * any stale cards — so after `writeWorkspace` the parent holds ONLY
+ * workspace.json. Child graphs live in sibling `<child>/graft/`, never under
+ * this dir, so they are untouched. */
+export declare function clearParentGraft(root: string, override?: string): void;
+export interface LoadedChild {
+    child: string;
+    graph: GraphV1;
+}
+export interface WorkspaceGraphs {
+    /** Children (from workspace.json when present, else discovered) that have a
+     * built graph, in sorted child order. */
+    loaded: LoadedChild[];
+    /** Listed children with no built graph yet — surfaced, never silently skipped. */
+    missing: string[];
+}
+/** Load each child's graph via `loadGraphCached`. Children come from
+ * workspace.json when present, otherwise from live git-child discovery (a
+ * not-yet-built workspace). A child without a built graph is counted into
+ * `missing`, not dropped. */
+export declare function loadWorkspaceGraphs(root: string, override?: string): WorkspaceGraphs;
+/** "2 of 3 workspace repos have graphs; run graft build to cover repoC" — the
+ * coverage line federated commands append when some listed child is unbuilt.
+ * Empty string when every child has a graph. */
+export declare function coverageNote(g: WorkspaceGraphs): string;
+export interface FederateAskOptions {
+    limit?: number;
+    source?: boolean;
+    full?: boolean;
+    graphRank?: boolean;
+    /** Narrow to one child (`repoA`) or a sub-scope within it (`repoA/backend`).
+     * A prefix matching NO child throws, listing the repos. */
+    in?: string;
+    /** @internal File-level child RRF plus an exact workspace baseline top lock. */
+    fileTopLock?: boolean;
+}
+/**
+ * Federated `ask` across a workspace: run each child's own ask pipeline, then
+ * fuse ALL the children's scope lists with `fuseScopes` (reciprocal rank). Each
+ * child contributes one fusion scope per intra-child scope, labeled
+ * `<child>/<scope>` (or just `<child>` for a child's root scope), so a big repo
+ * can't drown a small one — rank positions are comparable across repos where
+ * raw scores are not.
+ *
+ * Rank fusion is still right HERE, and only here: each child was scored against
+ * its own corpus, so cross-child scores share no scale. Within a single repo
+ * that is no longer true — `rankScopesAndFuse` gives every scope the same
+ * statistics and the same denominator and combines them by score.
+ *
+ * Returns a normal `AskResult`; `formatAsk` renders it unchanged, labeling each
+ * hit `[<child>/…]` via the standard multi-scope path.
+ */
+export declare function federateAsk(root: string, override: string | undefined, query: string, opts?: FederateAskOptions): AskResult;
+/** Merge every child's `GrepResult` into one, prefixing group paths with the
+ * child dir and re-sorting by coupling (inDegree desc, path asc) across repos.
+ * In-degree stays each child's own — it comes from that child's graph. */
+export declare function federateGrep(root: string, override: string | undefined, pattern: string, opts?: {
+    ignoreCase?: boolean;
+    fixed?: boolean;
+}): {
+    result: GrepResult;
+    coverage: string;
+};
+/** One `graft map` section per child (each child's own map, budget split evenly
+ * across the loaded children), joined under `<child>/` headers. */
+export declare function federateMap(root: string, override: string | undefined, opts?: {
+    maxDirs?: number;
+}): string;
+/** Per-child drift status. `ok` is false when any BUILT child is stale — an
+ * unbuilt child is surfaced (coverage), never a failure. */
+export declare function federateCheck(root: string, override?: string): Promise<{
+    text: string;
+    ok: boolean;
+}>;
+/** Resolve a symbol across every child, grouped per child. Reuses the shared
+ * traverse-cli formatters so each block reads exactly like `graft callers`. */
+export declare function federateCallers(root: string, override: string | undefined, symbol: string, opts?: {
+    direction?: Direction;
+    depth?: number;
+    in?: string;
+}): {
+    text: string;
+    found: boolean;
+};
+/**
+ * Split a parent into a workspace: build each git child (via the supplied
+ * `buildChild` callback, so this stays free of any engine/LLM dependency),
+ * then REPLACE the parent's `graft/` with just `workspace.json`. `onStart`
+ * fires once — before any child is built — carrying whether this build is a
+ * mega-graph migration, so the caller can print the one-time split warning
+ * first, exactly as the spec requires.
+ *
+ * The child build writes into `<child>/graft/` and is byte-identical to
+ * building that child standalone (`buildChild` is just `buildGraph(childDir)`),
+ * because nothing about the parent path enters the child's build.
+ */
+export declare function splitWorkspace(root: string, override: string | undefined, buildChild: (childDir: string, childName: string) => Promise<void>, onStart?: (info: {
+    children: string[];
+    migrated: boolean;
+}) => void): Promise<{
+    children: string[];
+    migrated: boolean;
+}>;
+export { formatGrepResult, zeroHitNote };
+/**
+ * Federated semantic search across all workspace children.
+ * For each child, queries that child's embeddings DB and prefixes hits with
+ * `[child/]`. All hits are merged, sorted by score desc, top `limit` returned.
+ */
+export declare function federateSemantic(root: string, override: string | undefined, query: string, limit: number): Promise<{
+    text: string;
+    isError: boolean;
+}>;
+//# 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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"}