mindweave 0.0.1 → 2.1.1

package/dist/tools/webSearch.js

@@ -0,0 +1,130 @@
+import { activeDriver } from "../drivers/registry.js";
+import { frameExternal } from "./untrusted.js";
+import { outputDetail } from "./detail.js";
+import { fail, failQuietly } from "./results.js";
+/** Sources listed per answer. Enough to judge the answer, short enough to read. */
+const MAX_SOURCES = 8;
+const webSearchTool = {
+    name: "web_search",
+    readOnly: true,
+    description: "Search the web and get an answer with its sources. Use it for anything that " +
+        "changed after your training data — current library APIs, recent releases, " +
+        "version-specific behaviour, whether a package still exists. " +
+        "Give a `query` the way you would type it into a search engine. " +
+        "You get an answer grounded in the pages found, plus their URLs; follow a URL " +
+        "with web_fetch when you need the full page. " +
+        "Not every model can search — if this one can't, the tool says so and you " +
+        "should ask the user for a URL instead of retrying.",
+    parameters: {
+        type: "object",
+        additionalProperties: false,
+        required: ["query"],
+        properties: {
+            query: {
+                type: "string",
+                description: "What to search for, phrased as a search query.",
+            },
+        },
+    },
+    async execute(args, ctx) {
+        const query = typeof args.query === "string" ? args.query.trim() : "";
+        if (!query)
+            return failQuietly("`query` is required.");
+        const driver = activeDriver();
+        if (!driver.webSearch) {
+            // A fact about the running model, stated once. Deliberately NOT an error:
+            // nothing went wrong and retrying will not help.
+            return {
+                output: `${driver.label} models cannot search the web, so this tool is unavailable ` +
+                    `on the current model. Ask the user for a URL and read it with web_fetch, ` +
+                    `or suggest switching models with /model.`,
+                summary: "web search unavailable on this model",
+            };
+        }
+        try {
+            // Timed here rather than inside the driver: the wait is the same wait whichever
+            // provider serves it, and measuring it at the one call site keeps every driver
+            // free of display bookkeeping.
+            const startedAt = Date.now();
+            const result = await driver.webSearch(query, { signal: ctx.abortSignal });
+            const elapsedMs = Date.now() - startedAt;
+            if (!result.answer && result.sources.length === 0) {
+                return {
+                    output: `No results for "${query}". Try different wording, or a narrower query.`,
+                    summary: `searched "${query}" (nothing found)`,
+                };
+            }
+            return {
+                output: formatSearch(query, result),
+                summary: `searched "${query}" (${result.sources.length} source${result.sources.length === 1 ? "" : "s"})`,
+                detail: formatSearchDetail(result, driver.label, elapsedMs),
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return fail(`Search failed: ${message}`);
+        }
+    },
+};
+/**
+ * Render a result for the model. Pure, so the shape is testable without a
+ * provider: answer first because that is what was asked for, sources after so a
+ * claim can be checked or followed with web_fetch.
+ */
+export function formatSearch(query, result) {
+    const lines = [];
+    if (result.answer)
+        lines.push(result.answer);
+    if (result.sources.length > 0) {
+        const shown = result.sources.slice(0, MAX_SOURCES);
+        lines.push("", "Sources:");
+        for (const [i, source] of shown.entries()) {
+            lines.push(`${i + 1}. ${source.title} — ${source.url}`);
+        }
+        const hidden = result.sources.length - shown.length;
+        if (hidden > 0)
+            lines.push(`(+${hidden} more)`);
+    }
+    if (result.partial) {
+        lines.push("", "(The search stopped early, so this may be incomplete.)");
+    }
+    // Framed as external content. This is the least trustworthy input the agent has:
+    // the model picked the query and the open web picked what came back, including the
+    // titles, which are attacker-chosen text sitting right next to a real answer.
+    return frameExternal({ tag: "web_search", attrs: { query }, what: "a web search" }, lines.join("\n"));
+}
+/**
+ * The UI-only detail block: a numbered source list, never sent to the model
+ * (that's `formatSearch`'s job, with its own framing/injection defense) — this
+ * is purely what the transcript row shows under the search. Empty when there
+ * are no sources, so a bare-answer result shows just its summary line.
+ */
+export function formatSearchDetail(result, engine, elapsedMs) {
+    if (result.sources.length === 0)
+        return "";
+    const shown = result.sources.slice(0, MAX_SOURCES);
+    const lines = [];
+    // Which service answered and how long it took. Both are omitted rather than guessed
+    // when unknown — a search row is one of the few places where the cost of the call is
+    // not otherwise visible, and an invented number would be worse than no number.
+    if (engine)
+        lines.push(`Engine: ${engine}`);
+    if (elapsedMs !== undefined)
+        lines.push(`Query time: ${formatElapsed(elapsedMs)}`);
+    lines.push(`Found ${result.sources.length} source${result.sources.length === 1 ? "" : "s"}`);
+    for (const [i, source] of shown.entries())
+        lines.push(`${i + 1}. ${source.title}`);
+    const hidden = result.sources.length - shown.length;
+    if (hidden > 0)
+        lines.push(`(+${hidden} more)`);
+    return outputDetail(lines.join("\n"));
+}
+/** A wait, at the precision it is worth reading: `310ms`, `1.4s`. */
+export function formatElapsed(ms) {
+    return ms < 1000 ? `${Math.round(ms)}ms` : `${(ms / 1000).toFixed(1)}s`;
+}
+/** The search half of the merged `web` tool. Logic unchanged. */
+export const searchWeb = webSearchTool.execute;
+/** Kept for tests that assert on the search description/flags directly. */
+export const webSearch = webSearchTool;
+//# sourceMappingURL=webSearch.js.map

package/dist/tools/webSearch.js.map

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

package/dist/tools/workspace.js

@@ -0,0 +1,212 @@
+/**
+ * workspace.ts — add another folder to the session (multi-root).
+ *
+ * One session usually has a single root, but real work spans repos: a backend and
+ * a frontend, an app and a shared library. `add_directory` lets the model honor
+ * "also work in ../api" by widening the workspace. Once added, every file tool sees
+ * it: reads, searches (`search` spans all roots, whether it is matching contents,
+ * paths, or listing), and edits, with paths
+ * labeled per root so the two never collide. The `/include` command does the same
+ * thing by hand.
+ *
+ * Each root gets its OWN code map, started in the background by `addRoot` and torn
+ * down by `removeRoot` (`chassisByRoot`). This comment used to say the chassis stayed
+ * on the primary root and added roots fell back to grep — that stopped being true when
+ * per-root chassis landed, and it described the tool as weaker than it is.
+ */
+import { promises as fs } from "node:fs";
+import { basename, isAbsolute, resolve } from "node:path";
+import { canonicalRoot, rootLabel, rootsOf } from "./paths.js";
+import { discoverRelatedRoots } from "./workspaceDiscover.js";
+import { startChassis, stopChassis } from "../alternator/lane.js";
+import { fail } from "./results.js";
+/**
+ * One tool, two levels of specificity: a `path` adds that folder, no `path` discovers.
+ *
+ * These were `add_directory` and `link_workspace`. Same intent (widen the workspace),
+ * same approval flow, same label mechanics afterwards; the only difference was whether
+ * the caller already knew which folder it wanted. That is an argument, not a tool.
+ */
+export const workspaceTool = {
+    name: "workspace",
+    deferred: true,
+    readOnly: false,
+    // What was missing is what happens AFTER: paths in a second root are label-prefixed,
+    // and a model that does not know that reads the new folder's files as if they sat
+    // under the primary root. The proactive branch also has a real refusal now (no
+    // channel to ask through), which the model has to be able to act on.
+    description: "Widen this session's workspace so you can read, search and edit across more than " +
+        "one folder: a separate backend, a frontend, a shared library.\n" +
+        "With a `path` it adds THAT folder. Use it when the user asks to include a " +
+        "directory, or when you NOTICE the task reaching into a folder that is not in the " +
+        "workspace yet — in that case set `proactive: true`, which asks the user first.\n" +
+        "With NO `path` it DISCOVERS the rest of the project — monorepo members, sibling " +
+        "repos, a backend beside a frontend — and offers the whole set. Use it when the task " +
+        "clearly spans the project. It finds folders by their project files, not by " +
+        "guessing, so it can legitimately find nothing.\n" +
+        "Either way a refusal (or no way to ask) is an ANSWER, not an error to retry: carry " +
+        "on within the folders you have and say what you found. Added folders get a LABEL " +
+        "and their files are addressed as `label/…` in every tool — that is how two roots " +
+        "holding `src/index.ts` stay distinct. The result names each label; use it from then " +
+        "on. Adding a folder already in the workspace is harmless and simply says so.",
+    parameters: {
+        type: "object",
+        additionalProperties: false,
+        properties: {
+            path: {
+                type: "string",
+                description: "The folder to add (absolute, or relative to the working directory). Omit to discover related folders instead.",
+            },
+            proactive: {
+                type: "boolean",
+                description: "Adding a known path only: set true when YOU spotted the need (not an explicit user " +
+                    "request); the user is asked to confirm first. Discovery always asks regardless.",
+            },
+        },
+    },
+    async execute(args, ctx) {
+        // The dispatch: naming a folder adds it, otherwise go and find the rest.
+        const named = typeof args.path === "string" ? args.path.trim() : "";
+        return named ? addOne(args, ctx, named) : discoverAll(ctx);
+    },
+};
+async function addOne(args, ctx, raw) {
+    const abs = isAbsolute(raw) ? resolve(raw) : resolve(ctx.cwd, raw);
+    // Proactive adds (the model noticed) ask first; explicit requests just add.
+    if (args.proactive === true) {
+        if (!(await isDir(abs)))
+            return fail(`directory not found: ${abs}`);
+        // With no way to ask, a proactive add must NOT happen. The old guard folded the
+        // missing channel into the condition, so exactly the case that needed consent
+        // silently proceeded without it — and that is the case a sub-agent is in.
+        if (!ctx.requestApproval) {
+            return {
+                output: `Did not add '${basename(abs)}' to the workspace: widening it needs the user's ` +
+                    `agreement and there is no way to ask from here. Work within the current roots, ` +
+                    `and if you genuinely need that folder, say so in your result.`,
+                summary: "cannot ask to widen workspace",
+            };
+        }
+        const choice = await ctx.requestApproval(`This work also reaches into '${basename(abs)}' (${abs}), which isn't in the workspace. Include it?`, ["Yes, include it", "No, stay in the current folder"]);
+        if (!choice.startsWith("Yes")) {
+            return { output: `Left '${basename(abs)}' out of the workspace at the user's request.`, summary: "kept workspace as-is" };
+        }
+    }
+    const result = await addRoot(ctx, abs);
+    if (result.error)
+        return fail(result.error);
+    if (result.already) {
+        return { output: `'${abs}' is already in the workspace.`, summary: `'${result.label}' already added` };
+    }
+    return {
+        output: `Added '${abs}' to the workspace as '${result.label}'. You can now read/search/edit it; refer to its files as '${result.label}/…'.`,
+        summary: `added root '${result.label}'`,
+    };
+}
+// "The user is asked to confirm" was unconditionally true in the old text and
+// conditionally true in the code. It is now unconditional in both.
+async function discoverAll(ctx) {
+    const roots = rootsOf(ctx);
+    const related = await discoverRelatedRoots(roots[0], roots);
+    if (related.length === 0) {
+        return { output: "No related project folders found to add (no monorepo config or sibling projects).", summary: "nothing to link" };
+    }
+    // Ask first (a bulk add) — list what was found. With no way to ask, do NOT proceed:
+    // this is the widest change either tool can make, and the old `if (requestApproval)`
+    // meant the absence of consent was treated as consent. A sub-agent is exactly that
+    // case, so this could silently pull in every sibling repo on the machine.
+    if (!ctx.requestApproval) {
+        return {
+            output: `Found ${related.length} related folder${related.length === 1 ? "" : "s"}, but adding ` +
+                `${related.length === 1 ? "it" : "them"} needs the user's agreement and there is no way ` +
+                `to ask from here. Name them in your result and let the user decide: ` +
+                `${related.map((r) => basename(r.path)).join(", ")}.`,
+            summary: "cannot ask to link workspace",
+        };
+    }
+    const list = related.map((r) => `• ${basename(r.path)} (${r.reason})`).join("\n");
+    const choice = await ctx.requestApproval(`Found related folders to include in the workspace:\n${list}\nInclude them?`, ["Yes, include them", "No"]);
+    if (!choice.startsWith("Yes")) {
+        return { output: "Left the workspace as-is at the user's request.", summary: "link declined" };
+    }
+    const added = [];
+    const failed = [];
+    for (const r of related) {
+        const res = await addRoot(ctx, resolve(r.path));
+        if (res.error)
+            failed.push(basename(r.path));
+        else if (res.label && !res.already)
+            added.push(res.label);
+    }
+    // A folder that was discovered but could not be added has to be named. Reporting
+    // only the successes let a partial link read as a complete one.
+    const note = failed.length > 0 ? ` Could not add ${failed.join(", ")}.` : "";
+    if (added.length === 0) {
+        return {
+            output: `No new folders were linked.${note || " Those folders were already in the workspace."}`,
+            summary: failed.length > 0 ? `linked nothing, ${failed.length} failed` : "nothing new linked",
+        };
+    }
+    return {
+        output: `Linked ${added.length} folder${added.length === 1 ? "" : "s"} into the workspace: ` +
+            `${added.join(", ")}. You can now read/search/edit across all of them (paths are 'label/…').${note}`,
+        summary: `linked ${added.join(", ")}${failed.length > 0 ? ` (${failed.length} failed)` : ""}`,
+    };
+}
+async function isDir(path) {
+    try {
+        return (await fs.stat(path)).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Add `abs` as a root on the tool context (shared, so it takes effect immediately).
+ * Validates it's an existing directory. Returns the assigned label, or a reason.
+ */
+export async function addRoot(ctx, requested) {
+    // Canonicalise, exactly as the PRIMARY root does on the way in. This was the one
+    // entry point that skipped it, and `paths.ts` states the invariant plainly: every
+    // root goes through this once so the session speaks one form of every path.
+    // Without it the dedup below is a raw string compare, so the SAME directory could
+    // be added repeatedly under different spellings — measured: `RealApi`, `realapi`
+    // and a junction pointing at it all became separate roots with separate labels, so
+    // every search walked that tree three times and reported each hit three ways.
+    const abs = await canonicalRoot(requested);
+    try {
+        const stat = await fs.stat(abs);
+        if (!stat.isDirectory())
+            return { error: `'${abs}' is not a directory.` };
+    }
+    catch {
+        return { error: `directory not found: ${requested}` };
+    }
+    const roots = ctx.roots && ctx.roots.length > 0 ? ctx.roots : [ctx.cwd];
+    if (roots.includes(abs))
+        return { already: true, label: rootLabel(roots, abs) };
+    ctx.roots = [...roots, abs];
+    // Warm a code map for the new root in the background (collision-safe via labels).
+    if (!ctx.chassisByRoot) {
+        ctx.chassisByRoot = new Map(ctx.chassis ? [[ctx.cwd, ctx.chassis]] : []);
+    }
+    ctx.chassisByRoot.set(abs, startChassis(abs));
+    return { label: rootLabel(ctx.roots, abs) };
+}
+/** Remove a root by absolute path or by its label. The primary root can't be removed. */
+export function removeRoot(ctx, pathOrLabel) {
+    const roots = rootsOf(ctx);
+    if (roots.length <= 1)
+        return { error: "nothing to remove — there's only the primary root." };
+    const match = roots.find((r, i) => i > 0 && (r === pathOrLabel || resolve(r) === resolve(pathOrLabel) || rootLabel(roots, r) === pathOrLabel));
+    if (!match)
+        return { error: `no added root matches '${pathOrLabel}'.` };
+    const label = rootLabel(roots, match);
+    ctx.roots = roots.filter((r) => r !== match);
+    // Tear down that root's code map (best-effort, in the background).
+    const ch = ctx.chassisByRoot?.get(match);
+    ctx.chassisByRoot?.delete(match);
+    void stopChassis(ch);
+    return { removed: label };
+}
+//# sourceMappingURL=workspace.js.map

package/dist/tools/workspace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.js","sourceRoot":"","sources":["../../src/tools/workspace.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAE1D,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAEpC;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,aAAa,GAAS;IACjC,IAAI,EAAE,WAAW;IACjB,QAAQ,EAAE,IAAI;IACd,QAAQ,EAAE,KAAK;IACf,qFAAqF;IACrF,kFAAkF;IAClF,+EAA+E;IAC/E,qEAAqE;IACrE,WAAW,EACT,mFAAmF;QACnF,iEAAiE;QACjE,4EAA4E;QAC5E,mFAAmF;QACnF,kFAAkF;QAClF,kFAAkF;QAClF,sFAAsF;QACtF,6EAA6E;QAC7E,kDAAkD;QAClD,qFAAqF;QACrF,mFAAmF;QACnF,mFAAmF;QACnF,sFAAsF;QACtF,8EAA8E;IAChF,UAAU,EAAE;QACV,IAAI,EAAE,QAAQ;QACd,oBAAoB,EAAE,KAAK;QAC3B,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,+GAA+G;aAClH;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,SAAS;gBACf,WAAW,EACT,qFAAqF;oBACrF,iFAAiF;aACpF;SACF;KACF;IAED,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG;QACrB,yEAAyE;QACzE,MAAM,KAAK,GAAG,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACpE,OAAO,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAC7D,CAAC;CACF,CAAC;AAEF,KAAK,UAAU,MAAM,CACnB,IAA6B,EAC7B,GAAmC,EACnC,GAAW;IAET,MAAM,GAAG,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAEnE,4EAA4E;IAC5E,IAAI,IAAI,CAAC,SAAS,KAAK,IAAI,EAAE,CAAC;QAC5B,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;YAAE,OAAO,IAAI,CAAC,wBAAwB,GAAG,EAAE,CAAC,CAAC;QACpE,gFAAgF;QAChF,8EAA8E;QAC9E,0EAA0E;QAC1E,IAAI,CAAC,GAAG,CAAC,eAAe,EAAE,CAAC;YACzB,OAAO;gBACL,MAAM,EACJ,gBAAgB,QAAQ,CAAC,GAAG,CAAC,mDAAmD;oBAChF,iFAAiF;oBACjF,+DAA+D;gBACjE,OAAO,EAAE,+BAA+B;aACzC,CAAC;QACJ,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,eAAe,CACtC,gCAAgC,QAAQ,CAAC,GAAG,CAAC,MAAM,GAAG,8CAA8C,EACpG,CAAC,iBAAiB,EAAE,gCAAgC,CAAC,CACtD,CAAC;QACF,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;YAC9B,OAAO,EAAE,MAAM,EAAE,SAAS,QAAQ,CAAC,GAAG,CAAC,+CAA+C,EAAE,OAAO,EAAE,sBAAsB,EAAE,CAAC;QAC5H,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IACvC,IAAI,MAAM,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC5C,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,OAAO,EAAE,MAAM,EAAE,IAAI,GAAG,gCAAgC,EAAE,OAAO,EAAE,IAAI,MAAM,CAAC,KAAK,iBAAiB,EAAE,CAAC;IACzG,CAAC;IACD,OAAO;QACL,MAAM,EAAE,UAAU,GAAG,0BAA0B,MAAM,CAAC,KAAK,8DAA8D,MAAM,CAAC,KAAK,MAAM;QAC3I,OAAO,EAAE,eAAe,MAAM,CAAC,KAAK,GAAG;KACxC,CAAC;AACN,CAAC;AAED,8EAA8E;AAC9E,mEAAmE;AACnE,KAAK,UAAU,WAAW,CAAC,GAAmC;IAC1D,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAC3B,MAAM,OAAO,GAAG,MAAM,oBAAoB,CAAC,KAAK,CAAC,CAAC,CAAE,EAAE,KAAK,CAAC,CAAC;IAC7D,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,EAAE,MAAM,EAAE,mFAAmF,EAAE,OAAO,EAAE,iBAAiB,EAAE,CAAC;IACrI,CAAC;IAED,oFAAoF;IACpF,qFAAqF;IACrF,mFAAmF;IACnF,0EAA0E;IAC1E,IAAI,CAAC,GAAG,CAAC,eAAe,EAAE,CAAC;QACzB,OAAO;YACL,MAAM,EACJ,SAAS,OAAO,CAAC,MAAM,kBAAkB,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,eAAe;gBACvF,GAAG,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,kDAAkD;gBACzF,sEAAsE;gBACtE,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;YACvD,OAAO,EAAE,8BAA8B;SACxC,CAAC;IACJ,CAAC;IACD,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAClF,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,eAAe,CACtC,uDAAuD,IAAI,iBAAiB,EAC5E,CAAC,mBAAmB,EAAE,IAAI,CAAC,CAC5B,CAAC;IACF,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QAC9B,OAAO,EAAE,MAAM,EAAE,iDAAiD,EAAE,OAAO,EAAE,eAAe,EAAE,CAAC;IACjG,CAAC;IAED,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QAChD,IAAI,GAAG,CAAC,KAAK;YAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;aACxC,IAAI,GAAG,CAAC,KAAK,IAAI,CAAC,GAAG,CAAC,OAAO;YAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAC5D,CAAC;IACD,iFAAiF;IACjF,gEAAgE;IAChE,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,kBAAkB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAC7E,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO;YACL,MAAM,EAAE,8BAA8B,IAAI,IAAI,+CAA+C,EAAE;YAC/F,OAAO,EAAE,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,mBAAmB,MAAM,CAAC,MAAM,SAAS,CAAC,CAAC,CAAC,oBAAoB;SAC9F,CAAC;IACJ,CAAC;IACD,OAAO;QACL,MAAM,EACJ,UAAU,KAAK,CAAC,MAAM,UAAU,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,uBAAuB;YACpF,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,2EAA2E,IAAI,EAAE;QACtG,OAAO,EAAE,UAAU,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,MAAM,UAAU,CAAC,CAAC,CAAC,EAAE,EAAE;KAC9F,CAAC;AACN,CAAC;AAED,KAAK,UAAU,KAAK,CAAC,IAAY;IAC/B,IAAI,CAAC;QACH,OAAO,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;IAC7C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,GAAgB,EAChB,SAAiB;IAEjB,iFAAiF;IACjF,kFAAkF;IAClF,4EAA4E;IAC5E,kFAAkF;IAClF,iFAAiF;IACjF,mFAAmF;IACnF,8EAA8E;IAC9E,MAAM,GAAG,GAAG,MAAM,aAAa,CAAC,SAAS,CAAC,CAAC;IAC3C,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAChC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE;YAAE,OAAO,EAAE,KAAK,EAAE,IAAI,GAAG,uBAAuB,EAAE,CAAC;IAC5E,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,KAAK,EAAE,wBAAwB,SAAS,EAAE,EAAE,CAAC;IACxD,CAAC;IACD,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACxE,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,CAAC;IAChF,GAAG,CAAC,KAAK,GAAG,CAAC,GAAG,KAAK,EAAE,GAAG,CAAC,CAAC;IAC5B,kFAAkF;IAClF,IAAI,CAAC,GAAG,CAAC,aAAa,EAAE,CAAC;QACvB,GAAG,CAAC,aAAa,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAC3E,CAAC;IACD,GAAG,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9C,OAAO,EAAE,KAAK,EAAE,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,CAAC;AAC9C,CAAC;AAED,yFAAyF;AACzF,MAAM,UAAU,UAAU,CAAC,GAAgB,EAAE,WAAmB;IAC9D,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAC3B,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC;QAAE,OAAO,EAAE,KAAK,EAAE,oDAAoD,EAAE,CAAC;IAC9F,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CACtB,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,KAAK,WAAW,IAAI,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,WAAW,CAAC,IAAI,SAAS,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,WAAW,CAAC,CACrH,CAAC;IACF,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,KAAK,EAAE,0BAA0B,WAAW,IAAI,EAAE,CAAC;IACxE,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IACtC,GAAG,CAAC,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC;IAC7C,mEAAmE;IACnE,MAAM,EAAE,GAAG,GAAG,CAAC,aAAa,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC;IACzC,GAAG,CAAC,aAAa,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;IACjC,KAAK,WAAW,CAAC,EAAE,CAAC,CAAC;IACrB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;AAC5B,CAAC"}

package/dist/tools/workspaceDiscover.js

@@ -0,0 +1,216 @@
+/**
+ * workspaceDiscover.ts — find the rest of the project to pull into the workspace.
+ *
+ * "This is only part of the work" — given the primary root, discover the related
+ * folders so the model can work across the whole thing. Two sources, in order:
+ *   1. Monorepo declarations — package.json `workspaces`, pnpm-workspace.yaml,
+ *      lerna.json, go.work, Cargo `[workspace] members`. Precise: the project
+ *      itself says what its parts are.
+ *   2. Sibling projects — if no monorepo config, the sibling folders next to the
+ *      root that look like code projects (have package.json / .git / go.mod / …).
+ *
+ * Pure discovery: it only reads and returns candidates; adding them is the caller's
+ * job (so /link and the model tool can apply their own confirmation policy).
+ */
+import { promises as fs } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+/** Markers that say "this folder is a project worth including." */
+const PROJECT_MARKERS = [
+    "package.json",
+    ".git",
+    "go.mod",
+    "Cargo.toml",
+    "pyproject.toml",
+    "requirements.txt",
+    "pom.xml",
+    "build.gradle",
+    "tsconfig.json",
+];
+/**
+ * Discover folders related to `root` that aren't already in `existing`. Monorepo
+ * members win; siblings are the fallback when there's no workspace config.
+ */
+export async function discoverRelatedRoots(root, existing) {
+    const found = new Map(); // abs path → reason
+    // 1a. package.json workspaces (array, or { packages: [...] }).
+    const pkg = await readJson(join(root, "package.json"));
+    const wsPatterns = [];
+    const ws = pkg?.workspaces;
+    if (Array.isArray(ws))
+        wsPatterns.push(...ws.filter((x) => typeof x === "string"));
+    else if (ws && typeof ws === "object" && Array.isArray(ws.packages)) {
+        wsPatterns.push(...(ws.packages.filter((x) => typeof x === "string")));
+    }
+    // 1b. pnpm + lerna patterns.
+    const pnpm = await readText(join(root, "pnpm-workspace.yaml"));
+    if (pnpm)
+        wsPatterns.push(...parseYamlPackages(pnpm));
+    const lerna = await readJson(join(root, "lerna.json"));
+    if (Array.isArray(lerna?.packages)) {
+        wsPatterns.push(...(lerna.packages.filter((x) => typeof x === "string")));
+    }
+    for (const pattern of wsPatterns) {
+        for (const dir of await expandPattern(root, pattern))
+            found.set(dir, "workspace member");
+    }
+    // 1c. go.work modules.
+    const gowork = await readText(join(root, "go.work"));
+    if (gowork) {
+        for (const use of parseGoWork(gowork)) {
+            const abs = resolve(root, use);
+            if (await isDir(abs))
+                found.set(abs, "go.work module");
+        }
+    }
+    // 1d. Cargo workspace members.
+    const cargo = await readText(join(root, "Cargo.toml"));
+    if (cargo) {
+        for (const member of parseCargoMembers(cargo)) {
+            for (const dir of await expandPattern(root, member))
+                found.set(dir, "cargo member");
+        }
+    }
+    // 2. Siblings — only when nothing was declared.
+    if (found.size === 0) {
+        for (const sib of await siblingProjects(root))
+            found.set(sib, "sibling project");
+    }
+    const skip = new Set(existing.map((r) => resolve(r)));
+    skip.add(resolve(root));
+    return [...found]
+        .filter(([abs]) => !skip.has(resolve(abs)))
+        .map(([path, reason]) => ({ path, reason }));
+}
+// ── glob expansion ───────────────────────────────────────────────────────────
+/** Expand one workspace pattern (`packages/*`, `apps/web`, …) to absolute dirs. */
+async function expandPattern(root, pattern) {
+    const norm = pattern.replace(/\\/g, "/").replace(/\/+$/, "");
+    const star = norm.indexOf("*");
+    if (star === -1) {
+        const abs = resolve(root, norm);
+        return (await isDir(abs)) ? [abs] : [];
+    }
+    // One glob level: the dirs directly under the part before the `*`.
+    const base = norm.slice(0, star).replace(/\/+$/, "");
+    const baseAbs = resolve(root, base);
+    let entries;
+    try {
+        entries = await fs.readdir(baseAbs, { withFileTypes: true });
+    }
+    catch {
+        return [];
+    }
+    return entries
+        .filter((e) => e.isDirectory() && !e.name.startsWith(".") && e.name !== "node_modules")
+        .map((e) => join(baseAbs, e.name));
+}
+// ── siblings ─────────────────────────────────────────────────────────────────
+async function siblingProjects(root) {
+    const parent = dirname(root);
+    if (parent === root)
+        return [];
+    let entries;
+    try {
+        entries = await fs.readdir(parent, { withFileTypes: true });
+    }
+    catch {
+        return [];
+    }
+    const out = [];
+    for (const e of entries) {
+        if (!e.isDirectory() || e.name.startsWith(".") || e.name === "node_modules")
+            continue;
+        const abs = join(parent, e.name);
+        if (resolve(abs) === resolve(root))
+            continue;
+        if (await looksLikeProject(abs))
+            out.push(abs);
+    }
+    return out;
+}
+async function looksLikeProject(dir) {
+    for (const marker of PROJECT_MARKERS) {
+        if (await exists(join(dir, marker)))
+            return true;
+    }
+    return false;
+}
+// ── tiny parsers ─────────────────────────────────────────────────────────────
+/** The `packages:` list from pnpm-workspace.yaml (no YAML dependency). */
+function parseYamlPackages(text) {
+    const out = [];
+    let inPackages = false;
+    for (const line of text.split("\n")) {
+        if (/^\s*packages:/.test(line)) {
+            inPackages = true;
+            continue;
+        }
+        if (!inPackages)
+            continue;
+        const m = line.match(/^\s*-\s*['"]?([^'"#]+?)['"]?\s*$/);
+        if (m)
+            out.push(m[1].trim());
+        else if (/^\S/.test(line))
+            break; // dedented to a new top-level key
+    }
+    return out;
+}
+/** `use` directives from go.work (single lines and the `use ( … )` block). */
+function parseGoWork(text) {
+    const out = new Set();
+    const block = text.match(/use\s*\(([^)]*)\)/s);
+    if (block)
+        for (const l of block[1].split("\n")) {
+            const t = l.trim();
+            if (t && !t.startsWith("//"))
+                out.add(t);
+        }
+    for (const m of text.matchAll(/^\s*use\s+(\S+)\s*$/gm))
+        out.add(m[1]);
+    return [...out];
+}
+/** `members = [ … ]` from a Cargo `[workspace]`. */
+function parseCargoMembers(text) {
+    const m = text.match(/members\s*=\s*\[([^\]]*)\]/s);
+    if (!m)
+        return [];
+    return [...m[1].matchAll(/['"]([^'"]+)['"]/g)].map((x) => x[1]);
+}
+// ── fs helpers ───────────────────────────────────────────────────────────────
+async function readText(path) {
+    try {
+        return await fs.readFile(path, "utf8");
+    }
+    catch {
+        return null;
+    }
+}
+async function readJson(path) {
+    const text = await readText(path);
+    if (!text)
+        return null;
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return null;
+    }
+}
+async function isDir(path) {
+    try {
+        return (await fs.stat(path)).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+async function exists(path) {
+    try {
+        await fs.stat(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=workspaceDiscover.js.map

package/dist/tools/workspaceDiscover.js.map

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