mindweave 0.0.1 → 2.1.2

package/dist/tools/registry.js

@@ -0,0 +1,120 @@
+import { readFile } from "./readFile.js";
+import { writeFile } from "./writeFile.js";
+import { edit } from "./edit.js";
+import { runCommand } from "./runCommand.js";
+import { search } from "./search.js";
+import { outlineTool, definitionTool, referencesTool } from "./codeIntel.js";
+import { readSymbolTool } from "./readSymbol.js";
+import { replaceSymbolBody } from "./replaceSymbol.js";
+import { diagnosticsTool } from "./diagnostics.js";
+import { web } from "./web.js";
+import { screenshot } from "./screenshot.js";
+import { exitPlan } from "./exitPlan.js";
+import { todoWrite } from "./todo.js";
+import { useSkill } from "./useSkill.js";
+import { governor, createSkill } from "./governorTools.js";
+import { saveMemoryTool } from "./saveMemory.js";
+import { askUserTool } from "./askUser.js";
+import { workspaceTool } from "./workspace.js";
+import { shellsTool, killShell } from "./shellTools.js";
+import { spawnSubagent } from "./subagent.js";
+import { sessionsTool } from "./sessionTools.js";
+import { findTools } from "./mcpSearch.js";
+import { mcpResourceTool } from "./mcpResources.js";
+import { addMcpServer } from "./mcpAdd.js";
+export const TOOLS = [
+    // Discovery (read-only)
+    search,
+    readFile,
+    web,
+    // Code intelligence (read-only, chassis-backed)
+    outlineTool,
+    definitionTool,
+    referencesTool,
+    readSymbolTool,
+    diagnosticsTool,
+    // Background shells (read-only: inspect long-running commands)
+    shellsTool,
+    // External integrations (read-only: finds MCP tools, and reads the DATA servers expose
+    // as opposed to the actions they perform)
+    findTools,
+    mcpResourceTool,
+    // Own history (read-only: what this agent did in this project before)
+    sessionsTool,
+    // Skills (read-only: loads a procedure into context on demand)
+    useSkill,
+    // Clarification (read-only: asks the user a focused question, changes nothing)
+    askUserTool,
+    // Sight (read-only: photographs one approved window, changes nothing)
+    screenshot,
+    // Planning (read-only, and offered only while planning — see `planOnly`)
+    exitPlan,
+    // Action (mutating)
+    writeFile,
+    edit,
+    replaceSymbolBody,
+    spawnSubagent,
+    runCommand,
+    todoWrite,
+    workspaceTool,
+    killShell,
+    // Cross-session memory (mutating: persists what the model is asked to remember)
+    saveMemoryTool,
+    // Governor (mutating: persist a rule / forbidden path / skill for the project)
+    governor,
+    addMcpServer,
+    createSkill,
+];
+/** Look up a tool by the name the model called. */
+export function findTool(name) {
+    return TOOLS.find((tool) => tool.name === name);
+}
+/**
+ * The OpenAI-style `tools[]` array we send to the provider so the model knows
+ * what it can call. Built straight from the registry — one source of truth.
+ *
+ * In `planMode` (the CLI's Architect mode) only read-only tools are advertised,
+ * so the model plans and researches without ever being offered edit/write/run.
+ * `readOnlyOnly` does the same filtering without the plan framing — used to make a
+ * research sub-agent read-only. Execution is guarded independently in the engine,
+ * so a stray mutating call is still refused — this just keeps the model from
+ * reaching for one.
+ */
+export function toolSchemas(opts = {}) {
+    const readOnly = opts.planMode || opts.readOnlyOnly;
+    // `planOnly` runs the filter the other way: those tools exist BECAUSE planning is
+    // happening, so they appear only in plan mode and are hidden the rest of the time.
+    // A read-only sub-agent is not planning, so it does not get them either.
+    //
+    // `deferred` is the third filter: a deferred tool is held back UNTIL the model has
+    // surfaced it through find_tools, which records it in `ctx.activatedTools`. From then on
+    // it is advertised like any other tool.
+    //
+    // Delivering the schema only in the search RESULT (an appended message) is not enough on
+    // its own: a strict function-calling model — every OpenAI-compatible provider (GLM,
+    // DeepSeek, Qwen, …) — only emits a tool call for a function that is actually in the
+    // request's `tools` array. A schema shown as text is callable in name only; the model
+    // reads it, "knows" it should use the tool, and cannot, so it stalls. Adding the tool
+    // here once activated is what makes it real. The cost is one prefix rebuild the first
+    // time each capability is used — deliberately paid, because a tool that cannot be called
+    // is worse than a cache miss. Activation is monotonic (the set only grows), so the
+    // rebuild happens once per capability, not once per call. Nothing activated → identical
+    // bytes to before, so the common session pays nothing.
+    const activated = opts.ctx?.activatedTools;
+    const tools = (readOnly ? TOOLS.filter((tool) => tool.readOnly) : TOOLS)
+        .filter((tool) => (tool.planOnly ? opts.planMode === true : true))
+        .filter((tool) => !tool.deferred || (activated?.has(tool.name) ?? false))
+        // `relevantWhen` needs the live session; with no ctx (a schema-shape test, a
+        // count) the tool is shown, because hiding it would be a false negative about
+        // what the registry contains.
+        .filter((tool) => !tool.relevantWhen || !opts.ctx || tool.relevantWhen(opts.ctx));
+    return tools.map((tool) => ({
+        type: "function",
+        function: {
+            name: tool.name,
+            description: tool.description,
+            parameters: tool.parameters,
+        },
+    }));
+}
+//# sourceMappingURL=registry.js.map

package/dist/tools/registry.js.map

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

package/dist/tools/replaceSymbol.js

@@ -0,0 +1,141 @@
+import { recordWrite, relativize, resolvePath } from "./paths.js";
+import { applyEol } from "./eol.js";
+import { editDetail, lineCount, magnitude, withScope } from "./detail.js";
+import { numberedWindow } from "./editWindow.js";
+import { normalizeLf } from "./editCore.js";
+import { prepareEditTarget, unreadError, fail, failQuietly, errText } from "./editTarget.js";
+import { allChassis, symbolSpans } from "./chassisMux.js";
+import { rawLines, spliceLines } from "./spanCore.js";
+import { writeFileAtomic } from "./atomicWrite.js";
+export const replaceSymbolBody = {
+    name: "replace_symbol_body",
+    /** Deferred: `edit` handles ordinary changes, including most whole-function rewrites.
+     *  This is the specialised span-swap, wanted deliberately when it is wanted. */
+    deferred: true,
+    readOnly: false,
+    // Two problems. The description implied `path` resolves any ambiguity, but a name
+    // defined TWICE IN ONE FILE cannot be narrowed by a path at all, and there is no
+    // other parameter for it — a model following the old text would keep re-sending the
+    // same path and getting the same refusal. The escape hatch is the edit tool, and it now
+    // says so. It also never mentioned that the result comes back line-numbered, which is
+    // the thing that lets a rewrite be followed by more edits without re-reading.
+    description: "Replace a whole symbol (function, class, method, type, and so on) with a new " +
+        "definition, by name. Give the symbol `name` and the complete `new_definition`, its " +
+        "signature AND body. The tool locates the symbol and swaps its lines, so no exact " +
+        "old_string is needed. Read the symbol first with read_symbol. " +
+        "AMBIGUITY IS REFUSED, never guessed: if the name resolves to more than one symbol " +
+        "nothing is written and you are shown the candidates. When those are in different " +
+        "files, `path` picks one. When the SAME file defines the name twice, `path` cannot " +
+        "help and there is no parameter that can, so use edit with an exact old_string " +
+        "instead. " +
+        "On success you get the new definition back WITH line numbers, so you can make " +
+        "further edits from the result instead of re-reading the file. " +
+        "A `new_definition` identical to what is already there is refused rather than " +
+        "written as a no-op edit. " +
+        "Prefer this when you are rewriting a whole function or class; use edit for changes " +
+        "WITHIN one.",
+    parameters: {
+        type: "object",
+        additionalProperties: false,
+        required: ["name", "new_definition"],
+        properties: {
+            name: { type: "string", description: "The symbol to replace." },
+            new_definition: {
+                type: "string",
+                description: "The complete replacement definition — signature and body, as it should appear in the file.",
+            },
+            path: {
+                type: "string",
+                description: "File the symbol is in (optional; disambiguates a name defined in several files).",
+            },
+        },
+    },
+    async execute(args, ctx) {
+        const name = typeof args.name === "string" ? args.name.trim() : "";
+        if (!name)
+            return failQuietly("`name` is required.");
+        if (typeof args.new_definition !== "string" || args.new_definition.trim() === "") {
+            return failQuietly("`new_definition` is required and must not be empty (use edit to delete a symbol).");
+        }
+        if (allChassis(ctx).length === 0) {
+            return fail("the code map isn't available here — use edit with an exact old_string instead.");
+        }
+        const rawPath = typeof args.path === "string" && args.path.trim() ? args.path.trim() : undefined;
+        const wantAbs = rawPath ? resolvePath(ctx, rawPath) : undefined;
+        const spans = await symbolSpans(ctx, name, wantAbs ? { path: wantAbs } : {});
+        if (spans.length === 0) {
+            return fail(`couldn't locate a symbol named '${name}'${rawPath ? ` in ${rawPath}` : ""}. ` +
+                "Read it first (read_symbol / outline), or use edit with an exact old_string.");
+        }
+        // Ambiguous → refuse and list. Never guess which definition to overwrite.
+        if (spans.length > 1) {
+            const list = spans.map((s) => `${relativize(ctx, s.file)}:${s.start}-${s.end}`).join(", ");
+            const hint = new Set(spans.map((s) => s.file)).size > 1 ? "pass `path` to pick one" : "the name is defined more than once here";
+            return fail(`'${name}' is ambiguous (${list}) — ${hint}. No changes were written.`);
+        }
+        const span = spans[0];
+        const abs = resolvePath(ctx, span.file);
+        const target = await prepareEditTarget(ctx, abs, "editing");
+        if (!target.ok)
+            return target.error;
+        // Unlike `edit`, this tool quotes NOTHING of what is already there — it names a
+        // symbol and hands over a whole new body. So there is no match that could serve as
+        // evidence the model knows what it is replacing, and read-before-edit stays a hard
+        // refusal here. The relaxed rule in `edit` is earned by the old_string; without one,
+        // it would just be overwriting a definition sight unseen.
+        if (target.unread)
+            return unreadError(abs);
+        const { filePath, content, eol } = target;
+        const before = normalizeLf(content);
+        const oldBody = rawLines(before, span.start, span.end);
+        const updatedNorm = spliceLines(before, span.start, span.end, args.new_definition);
+        if (updatedNorm === before) {
+            return failQuietly(`\`new_definition\` matches the current definition of '${name}' — nothing to change.`);
+        }
+        const updated = applyEol(updatedNorm, eol);
+        // Snapshot the pre-edit bytes for /undo before touching disk.
+        ctx.checkpoints?.backup(filePath, content, updated);
+        try {
+            await writeFileAtomic(filePath, updated);
+        }
+        catch (error) {
+            return fail(`could not write ${relativize(ctx, filePath)}: ${errText(error)}`);
+        }
+        await recordWrite(ctx, filePath, {
+            start: span.start,
+            end: span.start + normalizeLf(args.new_definition).split("\n").length - 1,
+        });
+        const shown = relativize(ctx, filePath);
+        // Show the new definition WITH fresh line numbers, so the model can keep editing
+        // from the result rather than re-reading the file.
+        const newStart = charAtLine(updatedNorm, span.start); // start char of the replaced region
+        const newLineCount = normalizeLf(args.new_definition).split("\n").length;
+        const window = numberedWindow(updatedNorm, newStart, newStart + args.new_definition.length);
+        // Scope: which symbol, the span it used to occupy, and the ± lines — so a whole-
+        // symbol rewrite reads as "reserveBook · was L120-138 · −18 +24", not a bare diff.
+        const removed = lineCount(oldBody);
+        const scope = `${span.name} · was L${span.start}-${span.end} · ${magnitude(removed, newLineCount)}`;
+        return {
+            output: `Replaced ${span.kind} ${span.name} in ${shown} ` +
+                `(was lines ${span.start}-${span.end}, now ${newLineCount} line${newLineCount === 1 ? "" : "s"}).\n` +
+                `New definition — line-numbered so you can make further edits without re-reading:\n${window}`,
+            summary: `replaced ${span.name} in ${shown} · ${scope}`,
+            detail: withScope(scope, editDetail(oldBody, args.new_definition)),
+            detailKind: "diff",
+        };
+    },
+};
+/** The char offset of the first character of 1-based `line` in LF text. */
+function charAtLine(text, line) {
+    let offset = 0;
+    let current = 1;
+    while (current < line) {
+        const nl = text.indexOf("\n", offset);
+        if (nl === -1)
+            return text.length;
+        offset = nl + 1;
+        current++;
+    }
+    return offset;
+}
+//# sourceMappingURL=replaceSymbol.js.map

package/dist/tools/replaceSymbol.js.map

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

package/dist/tools/results.js

@@ -0,0 +1,15 @@
+/** A failure the user should see: a refusal, a missing file, a command that exited badly. */
+export function fail(message) {
+    return { output: `Error: ${message}`, isError: true, summary: message };
+}
+/**
+ * A failure the model is expected to fix by itself, this turn.
+ *
+ * Identical to `fail` for the model — same error text, same `isError`, so nothing about
+ * its recovery changes — but marked `quiet` so the UI does not paint a red row for what
+ * is really a mid-thought correction. See `ToolResult.quiet` for where the line sits.
+ */
+export function failQuietly(message) {
+    return { output: `Error: ${message}`, isError: true, summary: message, quiet: true };
+}
+//# sourceMappingURL=results.js.map

package/dist/tools/results.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"results.js","sourceRoot":"","sources":["../../src/tools/results.ts"],"names":[],"mappings":"AASA,6FAA6F;AAC7F,MAAM,UAAU,IAAI,CAAC,OAAe;IAClC,OAAO,EAAE,MAAM,EAAE,UAAU,OAAO,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AAC1E,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,OAAe;IACzC,OAAO,EAAE,MAAM,EAAE,UAAU,OAAO,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AACvF,CAAC"}

package/dist/tools/ripgrep.js

@@ -0,0 +1,145 @@
+/**
+ * ripgrep.ts — run the `rg` binary for fast, precise search.
+ *
+ * ripgrep is the precise, fast ground-truth scanner: it walks the tree itself
+ * (memory-mapped, multithreaded), respects .gitignore, and streams back only
+ * matches — the project is never loaded into the agent. We shell out to it and
+ * parse the lines.
+ *
+ * WHERE THE BINARY COMES FROM, in order:
+ *   1. `MINDWEAVE_RIPGREP_PATH`, for anyone who wants a specific build.
+ *   2. The copy that ships with Mindweave (`@vscode/ripgrep`, an OPTIONAL dependency
+ *      resolving to a per-platform package, so npm installs the one binary this machine
+ *      needs and nothing is downloaded at install time).
+ *   3. `rg` on PATH, for a system install.
+ *
+ * Bundling matters more than it sounds. The two search engines are NOT equivalent: only
+ * ripgrep honours `.gitignore`, and the walk re-reads every candidate file in Node. A
+ * user who never installs ripgrep silently gets the slower, less accurate one forever,
+ * and nothing on screen says so — which is exactly the sort of invisible degradation
+ * this project keeps finding after the fact.
+ *
+ * OPTIONAL, deliberately. If the platform package is missing — an unsupported
+ * architecture, a locked-down registry, `--no-optional` — resolution simply falls
+ * through and the pure-Node walk (walk.ts) still answers every search. Search getting
+ * slower is an acceptable failure; `npm install mindweave` failing is not.
+ */
+import { spawn } from "node:child_process";
+import { createRequire } from "node:module";
+/**
+ * The bundled binary's path, or undefined if this platform's package isn't installed.
+ *
+ * Resolved through `require.resolve` rather than an `import`, because the whole point is
+ * that this may legitimately be absent: a static import of a missing optional dependency
+ * is a module-load crash, and the fallback it was meant to allow never gets to run.
+ */
+function bundledRipgrep() {
+    try {
+        const require = createRequire(import.meta.url);
+        const binary = process.platform === "win32" ? "rg.exe" : "rg";
+        return require.resolve(`@vscode/ripgrep-${process.platform}-${process.arch}/bin/${binary}`);
+    }
+    catch {
+        return undefined;
+    }
+}
+const RG = process.env.MINDWEAVE_RIPGREP_PATH || bundledRipgrep() || "rg";
+const MAX_BUFFER = 20_000_000; // 20 MB — big monorepos can emit a lot of paths
+const TIMEOUT_MS = 20_000;
+let probe;
+/**
+ * Force the built-in walker even where ripgrep is installed.
+ *
+ * Search has two engines and picks one from what happens to be on the machine, so
+ * every run exercises exactly one of them: this machine has ripgrep, the CI runners
+ * do not, and neither ever covered both. The two have already drifted apart once —
+ * only ripgrep honoured `.gitignore` until v1.9.3, while both claimed to — and a
+ * difference like that is invisible until someone runs the other path.
+ *
+ * Setting this lets one machine test both, which is what the CI matrix uses.
+ */
+const FORCED_OFF = process.env.MINDWEAVE_NO_RIPGREP === "1";
+/** Which binary search will use, for diagnostics and for the test that proves the
+ *  bundled one is actually reachable rather than merely declared in package.json. */
+export function ripgrepPath() {
+    return RG;
+}
+/** Reset the cached probe. Tests only — the env var is read per probe, not per call. */
+export function resetRipgrepProbe() {
+    probe = undefined;
+}
+/** True if `rg` is runnable. Probed once and cached for the session. */
+export function ripgrepAvailable() {
+    if (FORCED_OFF)
+        return Promise.resolve(false);
+    if (!probe) {
+        probe = new Promise((resolve) => {
+            try {
+                const child = spawn(RG, ["--version"], {
+                    windowsHide: true,
+                    stdio: ["ignore", "ignore", "ignore"],
+                });
+                child.on("error", () => resolve(false));
+                child.on("close", (code) => resolve(code === 0));
+            }
+            catch {
+                resolve(false);
+            }
+        });
+    }
+    return probe;
+}
+/** Run ripgrep with `args`, working from `cwd`. Never throws — failures surface
+ *  in the returned code/stderr so the tool can report them cleanly. */
+export function runRipgrep(args, cwd) {
+    return new Promise((resolve) => {
+        let out = "";
+        let err = "";
+        let truncated = false;
+        let settled = false;
+        const finish = (code, stderr) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            const lines = out
+                .split("\n")
+                .map((l) => (l.endsWith("\r") ? l.slice(0, -1) : l))
+                .filter(Boolean);
+            resolve({ lines, code, stderr: stderr.trim(), truncated });
+        };
+        let child;
+        try {
+            child = spawn(RG, args, { cwd, windowsHide: true });
+        }
+        catch (error) {
+            resolve({ lines: [], code: -1, stderr: String(error), truncated: false });
+            return;
+        }
+        const timer = setTimeout(() => {
+            try {
+                child.kill();
+            }
+            catch {
+                /* already gone */
+            }
+            finish(null, "ripgrep timed out");
+        }, TIMEOUT_MS);
+        child.stdout?.on("data", (d) => {
+            if (truncated)
+                return;
+            out += d.toString("utf8");
+            if (out.length > MAX_BUFFER) {
+                out = out.slice(0, MAX_BUFFER);
+                truncated = true;
+            }
+        });
+        child.stderr?.on("data", (d) => {
+            if (err.length < 8192)
+                err += d.toString("utf8");
+        });
+        child.on("error", () => finish(-1, "ripgrep failed to start"));
+        child.on("close", (code) => finish(code, err));
+    });
+}
+//# sourceMappingURL=ripgrep.js.map

package/dist/tools/ripgrep.js.map

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