mindweave 0.0.1 → 2.1.2

package/dist/project/context.js

@@ -0,0 +1,425 @@
+/**
+ * context.ts — the project orientation snapshot.
+ *
+ * Without this, Mindweave starts BLIND: the system prompt tells it nothing about the
+ * project it's sitting in — not the working directory, the OS, whether it's a git
+ * repo, what kind of project it is, or its shape. It would burn a list→read→read
+ * just to answer "what is this?". The fix is to gather a small, budgeted snapshot
+ * ONCE at session start:
+ *
+ *   - an <environment> block (cwd, is-git-repo, platform, OS, date) plus a git-status
+ *     snapshot (branch, `status --short`, recent commits), so the first turn is oriented.
+ *   - a budgeted project snapshot (name, a capped file tree, key manifests) so the
+ *     FIRST answer is already informed.
+ *
+ * This module gathers both ONCE at session start — a
+ * snapshot in time, not a live view (it does not update as the conversation runs;
+ * the model uses tools for anything current or deeper). It is fully
+ * deterministic: no model calls, no tokens to build. The heavy structural map is
+ * the chassis (alternator); this is the shallow, always-on orientation layer that
+ * sits above it.
+ *
+ * Pure facts, no instructions: deciding what to DO with the project is the model's
+ * job. We only hand it the lay of the land.
+ */
+import { spawn } from "node:child_process";
+import { promises as fs } from "node:fs";
+import { release } from "node:os";
+import { join, basename } from "node:path";
+import { DEFAULT_IGNORES } from "../tools/walk.js";
+import { commandShellLabel } from "../tools/runCommand.js";
+// ── budgets (tunable, model-agnostic) ────────────────────────────────────────
+const TREE_MAX_DEPTH = envInt("MINDWEAVE_CONTEXT_TREE_DEPTH", 3);
+const TREE_MAX_LINES = envInt("MINDWEAVE_CONTEXT_TREE_LINES", 120);
+const TREE_MAX_FILES = envInt("MINDWEAVE_CONTEXT_TREE_FILES", 60);
+const GIT_STATUS_MAX_CHARS = 2_000;
+const GIT_LOG_COUNT = 5;
+const README_MAX_CHARS = 800;
+const GIT_TIMEOUT_MS = 2_500;
+// Docs & notes: the curated, high-signal list of planning/notes docs (roadmaps,
+// feature plans, design notes). Surfaced so the model always KNOWS these exist and
+// what they are, without having to "remember" them across sessions or dig them out of
+// the raw file tree.
+const DOCS_MAX_COUNT = 15;
+const DOC_DESC_MAX_CHARS = 100;
+const DOC_READ_BYTES = 1_024;
+// ── collection ───────────────────────────────────────────────────────────────
+/**
+ * Gather the snapshot for `cwd`. Best-effort throughout: any piece that fails or
+ * is absent is simply omitted, so this never throws and never blocks startup for
+ * long (git is time-boxed).
+ */
+export async function collectProjectContext(cwd) {
+    const [git, signals, tree, readme, docs] = await Promise.all([
+        collectGit(cwd),
+        collectSignals(cwd),
+        collectTree(cwd),
+        collectReadme(cwd),
+        collectDocs(cwd),
+    ]);
+    return { environment: collectEnvironment(cwd), git, signals, tree, readme, docs };
+}
+function collectEnvironment(cwd) {
+    return {
+        cwd,
+        platform: process.platform,
+        osVersion: release(),
+        shell: commandShellLabel(),
+        runtime: `Node ${process.version}`,
+        date: localDate(),
+    };
+}
+async function collectGit(cwd) {
+    const inside = (await runGit(["rev-parse", "--is-inside-work-tree"], cwd))?.trim();
+    if (inside !== "true")
+        return null;
+    const [branchRaw, statusRaw, logRaw] = await Promise.all([
+        runGit(["rev-parse", "--abbrev-ref", "HEAD"], cwd),
+        runGit(["--no-optional-locks", "status", "--short"], cwd),
+        runGit(["--no-optional-locks", "log", "--oneline", "-n", String(GIT_LOG_COUNT)], cwd),
+    ]);
+    const branch = branchRaw?.trim() || "(detached)";
+    let status = (statusRaw ?? "").trim();
+    if (status.length > GIT_STATUS_MAX_CHARS) {
+        status = status.slice(0, GIT_STATUS_MAX_CHARS) + "\n… (truncated; run `git status` for the rest)";
+    }
+    return {
+        branch,
+        status: status || "(clean)",
+        recentCommits: (logRaw ?? "").trim(),
+    };
+}
+/** Manifest → the labels and metadata it implies. */
+async function collectSignals(cwd) {
+    const kinds = new Set();
+    const manifests = [];
+    const scripts = [];
+    let name;
+    const has = async (f) => {
+        try {
+            await fs.access(join(cwd, f));
+            manifests.push(f);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    };
+    if (await has("package.json")) {
+        const pkg = await readJson(join(cwd, "package.json"));
+        if (pkg) {
+            if (typeof pkg.name === "string")
+                name = pkg.name;
+            if (pkg.scripts && typeof pkg.scripts === "object") {
+                scripts.push(...Object.keys(pkg.scripts));
+            }
+            const ts = !!(pkg.devDependencies?.typescript || pkg.dependencies?.typescript);
+            kinds.add(ts ? "Node/TypeScript" : "Node/JavaScript");
+        }
+        else {
+            kinds.add("Node");
+        }
+    }
+    // tsconfig confirms TypeScript, but don't double up if package.json already said so.
+    if ((await has("tsconfig.json")) && !kinds.has("Node/TypeScript"))
+        kinds.add("TypeScript");
+    if (await has("pyproject.toml")) {
+        kinds.add("Python");
+        name ??= await tomlName(join(cwd, "pyproject.toml"));
+    }
+    if (await has("requirements.txt"))
+        kinds.add("Python");
+    if (await has("Cargo.toml")) {
+        kinds.add("Rust");
+        name ??= await tomlName(join(cwd, "Cargo.toml"));
+    }
+    if (await has("go.mod"))
+        kinds.add("Go");
+    if (await has("pom.xml"))
+        kinds.add("Java/Maven");
+    if (await has("build.gradle") || (await has("build.gradle.kts")))
+        kinds.add("Java/Gradle");
+    if (await has("Gemfile"))
+        kinds.add("Ruby");
+    if (await has("composer.json"))
+        kinds.add("PHP");
+    if (await has("CMakeLists.txt"))
+        kinds.add("C/C++");
+    return { name, kinds: [...kinds], scripts, manifests };
+}
+/**
+ * A budgeted, sorted, pre-order directory tree. Depth, total
+ * lines, and file count are all capped so a huge repo degrades to a partial tree
+ * instead of exploding the prompt. Skips DEFAULT_IGNORES and dotfiles/dirs.
+ */
+async function collectTree(cwd) {
+    const lines = [];
+    let fileCount = 0;
+    let truncated = false;
+    const recurse = async (absDir, depth) => {
+        if (truncated || depth > TREE_MAX_DEPTH)
+            return;
+        let entries;
+        try {
+            entries = await fs.readdir(absDir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        const dirs = entries
+            .filter((e) => e.isDirectory() && !DEFAULT_IGNORES.has(e.name) && !e.name.startsWith("."))
+            .map((e) => e.name)
+            .sort();
+        const files = entries
+            .filter((e) => e.isFile() && !e.name.startsWith("."))
+            .map((e) => e.name)
+            .sort();
+        for (const f of files) {
+            if (lines.length >= TREE_MAX_LINES || fileCount >= TREE_MAX_FILES) {
+                truncated = true;
+                return;
+            }
+            lines.push("  ".repeat(depth) + f);
+            fileCount += 1;
+        }
+        for (const d of dirs) {
+            if (lines.length >= TREE_MAX_LINES) {
+                truncated = true;
+                return;
+            }
+            lines.push("  ".repeat(depth) + d + "/");
+            await recurse(join(absDir, d), depth + 1);
+        }
+    };
+    await recurse(cwd, 0);
+    return { lines, fileCount, truncated };
+}
+/** The opening of a README, if there is one — orients on intent the tree can't. */
+async function collectReadme(cwd) {
+    for (const name of ["README.md", "README.rst", "README.txt", "README"]) {
+        try {
+            const raw = (await fs.readFile(join(cwd, name), "utf8")).trim();
+            if (!raw)
+                continue;
+            return raw.length > README_MAX_CHARS ? raw.slice(0, README_MAX_CHARS) + "\n… (truncated)" : raw;
+        }
+        catch {
+            /* try the next candidate */
+        }
+    }
+    return null;
+}
+/**
+ * Find the project's planning/notes docs — feature plans, roadmaps, design notes,
+ * TODOs — anywhere within the walked tree, and read a one-line descriptor for each.
+ * This is the curated counterpart to the raw file tree: instead of one filename among
+ * dozens, the model gets "notez/feature-ideas.md — Feature ideas" and knows to reach
+ * for it. Deterministic and one-time, so nothing has to be "remembered" across
+ * sessions. Best-effort: unreadable files are skipped, never thrown.
+ */
+async function collectDocs(cwd) {
+    const found = [];
+    const recurse = async (absDir, rel, depth) => {
+        if (depth > TREE_MAX_DEPTH || found.length >= DOCS_MAX_COUNT * 4)
+            return;
+        let entries;
+        try {
+            entries = await fs.readdir(absDir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const e of entries) {
+            if (e.name.startsWith("."))
+                continue;
+            if (e.isFile() && isNotableDoc(e.name)) {
+                found.push({ path: rel ? `${rel}/${e.name}` : e.name, depth });
+            }
+        }
+        for (const e of entries) {
+            if (e.isDirectory() && !DEFAULT_IGNORES.has(e.name) && !e.name.startsWith(".")) {
+                await recurse(join(absDir, e.name), rel ? `${rel}/${e.name}` : e.name, depth + 1);
+            }
+        }
+    };
+    await recurse(cwd, "", 0);
+    // Shallowest first (root docs matter most), then alphabetical; then cap.
+    found.sort((a, b) => a.depth - b.depth || a.path.localeCompare(b.path));
+    const top = found.slice(0, DOCS_MAX_COUNT);
+    const docs = await Promise.all(top.map(async ({ path }) => ({ path, desc: await docDescriptor(join(cwd, path)) })));
+    return docs;
+}
+/**
+ * Whether a filename is a planning/notes doc worth surfacing. Markdown files qualify,
+ * as do a handful of conventional names (TODO, ROADMAP, …) whatever their extension.
+ * README (shown separately), MINDWEAVE.md (the memory file itself), and legal boilerplate
+ * are deliberately excluded.
+ */
+function isNotableDoc(name) {
+    const lower = name.toLowerCase();
+    if (lower.startsWith("readme") || lower === "mindweave.md")
+        return false;
+    if (/^(license|licence|copying|code_of_conduct|contributing|authors|notice)\b/.test(lower))
+        return false;
+    const dot = lower.lastIndexOf(".");
+    const ext = dot > 0 ? lower.slice(dot) : "";
+    const base = dot > 0 ? lower.slice(0, dot) : lower;
+    if (ext === ".md" || ext === ".mdx" || ext === ".markdown")
+        return true;
+    return ["todo", "roadmap", "changelog", "notes", "tasks", "plan", "plans", "ideas", "design"].includes(base);
+}
+/** A short descriptor for a doc: its first Markdown heading, else its first non-empty
+ *  line (YAML frontmatter skipped). "" when the file is empty or unreadable. */
+async function docDescriptor(absPath) {
+    let raw;
+    try {
+        const fh = await fs.open(absPath, "r");
+        try {
+            const buf = Buffer.alloc(DOC_READ_BYTES);
+            const { bytesRead } = await fh.read(buf, 0, DOC_READ_BYTES, 0);
+            raw = buf.toString("utf8", 0, bytesRead);
+        }
+        finally {
+            await fh.close();
+        }
+    }
+    catch {
+        return "";
+    }
+    const lines = raw.split(/\r?\n/);
+    let i = 0;
+    // Skip a leading YAML frontmatter block (--- … ---).
+    if (lines[0]?.trim() === "---") {
+        i = 1;
+        while (i < lines.length && lines[i]?.trim() !== "---")
+            i += 1;
+        i += 1;
+    }
+    for (; i < lines.length; i += 1) {
+        const line = (lines[i] ?? "").trim();
+        if (!line)
+            continue;
+        const text = line.replace(/^#+\s*/, "").trim(); // strip Markdown heading marks
+        if (!text)
+            continue;
+        return text.length > DOC_DESC_MAX_CHARS ? text.slice(0, DOC_DESC_MAX_CHARS) + "…" : text;
+    }
+    return "";
+}
+// ── rendering ────────────────────────────────────────────────────────────────
+/**
+ * Render the snapshot into the text injected into the system prompt, or "" if
+ * there is genuinely nothing to say. Two tagged blocks: <environment> (the env block)
+ * and <project_overview> (signals + tree + README + git status).
+ */
+export function renderProjectContext(pc) {
+    const env = pc.environment;
+    const out = [];
+    out.push("<environment>\n" +
+        `Working directory: ${env.cwd}\n` +
+        `Git repo: ${pc.git ? `yes (branch ${pc.git.branch})` : "no"}\n` +
+        `Platform: ${env.platform}\n` +
+        `OS version: ${env.osVersion}\n` +
+        `Shell: ${env.shell}\n` +
+        `Runtime: ${env.runtime}\n` +
+        `Today's date: ${env.date}\n` +
+        "</environment>");
+    const overview = [];
+    const s = pc.signals;
+    const head = [s.name, s.kinds.length ? s.kinds.join(", ") : null].filter(Boolean).join(" — ");
+    overview.push(`Project: ${head || basename(env.cwd) || env.cwd}`);
+    if (s.scripts.length)
+        overview.push(`Scripts: ${s.scripts.join(", ")}`);
+    if (pc.docs.length) {
+        overview.push("Docs & notes (planning/roadmap/design docs in this project — read one when it's relevant):\n" +
+            pc.docs.map((d) => `- ${d.path}${d.desc ? ` — ${d.desc}` : ""}`).join("\n"));
+    }
+    if (pc.tree.lines.length) {
+        const note = pc.tree.truncated ? " (partial — ask tools for more)" : "";
+        overview.push(`Structure${note} — snapshot, ignores ${[...DEFAULT_IGNORES].slice(0, 3).join("/")}/…:\n` +
+            pc.tree.lines.join("\n"));
+    }
+    if (pc.readme)
+        overview.push(`README (excerpt):\n${pc.readme}`);
+    if (pc.git) {
+        const git = [`Git status (snapshot at session start) — branch ${pc.git.branch}`];
+        if (pc.git.recentCommits)
+            git.push(`Recent commits:\n${pc.git.recentCommits}`);
+        git.push(`Changes:\n${pc.git.status}`);
+        overview.push(git.join("\n"));
+    }
+    out.push("<project_overview>\n" + overview.join("\n\n") + "\n</project_overview>");
+    return out.join("\n\n");
+}
+/** Convenience: collect + render in one call. "" when there's nothing useful. */
+export async function projectContextText(cwd) {
+    return renderProjectContext(await collectProjectContext(cwd));
+}
+// ── helpers ──────────────────────────────────────────────────────────────────
+/** Run a git command, time-boxed; resolves to stdout on success, null otherwise. */
+function runGit(args, cwd, timeoutMs = GIT_TIMEOUT_MS) {
+    return new Promise((resolve) => {
+        let child;
+        try {
+            child = spawn("git", args, { cwd, windowsHide: true });
+        }
+        catch {
+            resolve(null);
+            return;
+        }
+        let out = "";
+        let done = false;
+        const finish = (v) => {
+            if (done)
+                return;
+            done = true;
+            clearTimeout(timer);
+            resolve(v);
+        };
+        const timer = setTimeout(() => {
+            try {
+                child.kill();
+            }
+            catch {
+                /* already gone */
+            }
+            finish(null);
+        }, timeoutMs);
+        child.stdout?.on("data", (c) => {
+            if (out.length < 64_000)
+                out += c.toString("utf8");
+        });
+        child.on("error", () => finish(null));
+        child.on("close", (code) => finish(code === 0 ? out : null));
+    });
+}
+async function readJson(path) {
+    try {
+        return JSON.parse(await fs.readFile(path, "utf8"));
+    }
+    catch {
+        return null;
+    }
+}
+/** Pull `name = "..."` from a TOML manifest's [package]/[project] table, cheaply. */
+async function tomlName(path) {
+    try {
+        const text = await fs.readFile(path, "utf8");
+        const m = text.match(/^\s*name\s*=\s*["']([^"']+)["']/m);
+        return m?.[1];
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Local YYYY-MM-DD (the user's calendar day, not UTC). */
+function localDate() {
+    const d = new Date();
+    const p = (n) => String(n).padStart(2, "0");
+    return `${d.getFullYear()}-${p(d.getMonth() + 1)}-${p(d.getDate())}`;
+}
+function envInt(name, fallback) {
+    const v = Number(process.env[name]);
+    return Number.isFinite(v) && v > 0 ? Math.floor(v) : fallback;
+}
+//# sourceMappingURL=context.js.map

package/dist/project/context.js.map

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

package/dist/tools/approval.js

@@ -0,0 +1,189 @@
+import { dirname, relative, isAbsolute } from "node:path";
+import { fail } from "./results.js";
+const ALLOW = "Yes, allow it this time";
+const DENY = "No, keep it protected";
+const DEFER = "Let me tell you what to do";
+/**
+ * What the approval channel resolves with when the user dismisses the question
+ * instead of answering it (Esc).
+ *
+ * Dismissing used to resolve with the SECOND option, which is right for a
+ * Yes/No/Defer prompt and wrong for anything else. `ask_user` supplies arbitrary
+ * options, so escaping "Postgres or SQLite?" told the model the user had chosen
+ * SQLite — a preference they never expressed, reported to the model as fact.
+ *
+ * Every other caller tests for its own affirmative and treats anything else as a
+ * refusal, so this value declines safely everywhere without them knowing about it.
+ * Only a caller that must tell "declined" apart from "chose the second option"
+ * needs to compare against it.
+ */
+export const APPROVAL_DISMISSED = "\u0000dismissed";
+/**
+ * Marks an answer the user TYPED rather than picked, so a caller can tell them apart.
+ *
+ * Leading space, like APPROVAL_DISMISSED: an option label never starts with one, so a
+ * typed answer can never be mistaken for a choice and vice versa.
+ */
+export const APPROVAL_TEXT = " text:";
+/** The typed answer, or null when this was an ordinary choice. */
+export function readFreeText(answer) {
+    return answer.startsWith(APPROVAL_TEXT) ? answer.slice(APPROVAL_TEXT.length) : null;
+}
+/**
+ * Offer to lift a forbidden path. Returns `null` to proceed (the user allowed it),
+ * or a ToolResult the caller should return (refused or deferred). `refusal` is the
+ * message used when there's no channel to ask through.
+ */
+export async function requestForbiddenLift(ctx, pattern, action, refusal, noun = "protected path") {
+    if (!ctx.requestApproval) {
+        return {
+            output: `Error: ${refusal}`,
+            isError: true,
+            summary: `Forbidden ${noun}: ${pattern} → access denied`,
+            displayKind: "governor",
+            displayName: "Governor",
+        };
+    }
+    const choice = await ctx.requestApproval(`This is blocked by a ${noun} rule ('${pattern}'). Allow ${action} anyway?`, [ALLOW, DENY, DEFER]);
+    if (choice === ALLOW) {
+        liftForbidden(ctx, pattern);
+        return null; // proceed
+    }
+    if (choice === DEFER) {
+        return {
+            output: `Stopped: '${pattern}' is protected. The user will tell you how to proceed — wait for their direction instead of touching it.`,
+            isError: true,
+            summary: `Rule fired: ${pattern} → ${action} → DEFERRED`,
+            displayKind: "governor",
+            displayName: "Governor",
+        };
+    }
+    return {
+        output: `Refused: '${pattern}' is protected and the user declined to lift it. Find another way that doesn't touch it.`,
+        isError: true,
+        summary: `Rule fired: ${pattern} → ${action} → BLOCKED`,
+        displayKind: "governor",
+        displayName: "Governor",
+    };
+}
+const AGENT_ALLOW = "Yes, you can use it";
+const AGENT_DENY = "No, leave it alone";
+/**
+ * Ask before touching another coding agent's data (its saved sessions, memory,
+ * rules or skills).
+ *
+ * The default is NOT to look. Finding another tool's history in a project is like
+ * finding someone else's notebook on a shared desk: the right move is to say it's
+ * there, not to read it and start quoting it back as your own recollection. So the
+ * model surfaces it and the user decides.
+ *
+ * Returns `null` to proceed (the user allowed it), or a ToolResult the caller
+ * should return. A yes is remembered for the rest of the session, per tool, so the
+ * user is asked once rather than per file.
+ */
+export async function requestAgentDataAccess(ctx, tool, action) {
+    if (ctx.agentDataAllowed?.has(tool))
+        return null; // already allowed this session
+    const refusal = `that belongs to ${tool}, a different coding tool that has worked in this project. ` +
+        `Its sessions, memory and rules are not yours. Tell the user it's there and let them decide.`;
+    if (!ctx.requestApproval) {
+        return { output: `Error: ${refusal}`, isError: true, summary: `skipped ${tool}'s data` };
+    }
+    const choice = await ctx.requestApproval(`${action} belongs to ${tool}, another coding tool that has worked here.\n` +
+        `Its saved sessions, memory and rules are separate from mine. Use it anyway?`, [AGENT_ALLOW, AGENT_DENY, DEFER]);
+    if (choice === AGENT_ALLOW) {
+        if (!ctx.agentDataAllowed)
+            ctx.agentDataAllowed = new Set();
+        ctx.agentDataAllowed.add(tool);
+        return null; // proceed
+    }
+    if (choice === DEFER) {
+        return {
+            output: `Stopped: that is ${tool}'s data. The user will say how to proceed — wait for their ` +
+                `direction rather than reading it.`,
+            isError: true,
+            summary: `awaiting direction on ${tool}'s data`,
+        };
+    }
+    return {
+        output: `Refused: ${refusal} Continue without it, and do not present anything from it as your ` +
+            `own history with the user.`,
+        isError: true,
+        summary: `left ${tool}'s data alone`,
+    };
+}
+/** Drop a pattern from the live (session-only) deny-list. A new object forces the
+ *  matcher to recompile; the on-disk rule is left intact. */
+function liftForbidden(ctx, pattern) {
+    const g = ctx.governance;
+    if (!g)
+        return;
+    // Remembered because the lift exists ONLY in memory and governance is re-read from
+    // disk when the files change. Without this, a hand-edit to any rule file anywhere in
+    // the project would quietly resurrect a pattern the user had explicitly allowed, and
+    // the next write to that path would be blocked by a decision they had already made.
+    g.lifted = [...(g.lifted ?? []), pattern];
+    // Filter BOTH lists: a lift may be for a forbidden path or a forbidden command,
+    // and a pattern won't collide across the two, so dropping it from each is safe.
+    g.forbidden = {
+        ...g.forbidden,
+        patterns: g.forbidden.patterns.filter((p) => p !== pattern),
+        commands: (g.forbidden.commands ?? []).filter((c) => c !== pattern),
+    };
+    g.notices = [...(g.notices ?? []), `Approval lifted: '${pattern}' → session scope → ALLOWED`];
+}
+/** The answers offered when a write lands outside the workspace. */
+const OUTSIDE_OPTIONS = [
+    "Yes, write it",
+    "Yes, and allow this folder for the session",
+    "No, keep to the workspace",
+];
+/**
+ * Ask before writing somewhere the workspace does not cover.
+ *
+ * Lightning means "do not ask me about the work", and everything inside the folders the
+ * user opened IS the work. A path outside all of them is a different claim: nothing the
+ * user chose says the agent may write there, and an absolute path is easy for a model to
+ * produce from a stale assumption about where it is.
+ *
+ * The line is drawn where it is because an auto-accept mode allows a write only when the
+ * path is inside an allowed working directory, and anything outside falls through to a
+ * prompt. The second option scopes the grant to that FOLDER for the session, as theirs
+ * does, so a run that legitimately writes next door asks once rather than every file.
+ *
+ * Returns a refusal to hand back, or null to proceed. Fails CLOSED: with no way to ask,
+ * the write does not happen. Reads are untouched — this is about changing things.
+ */
+export async function requestOutsideWorkspaceWrite(ctx, filePath, action) {
+    if (insideWorkspace(ctx, filePath))
+        return null;
+    const dir = dirname(filePath);
+    if (ctx.allowedOutsideDirs?.has(dir))
+        return null;
+    if (!ctx.requestApproval) {
+        return fail(`Refusing to ${action}: it is outside the workspace (${ctx.roots?.join(", ") ?? ctx.cwd}) ` +
+            `and there is no way to ask the user from here. Work inside the project, or ask them ` +
+            `to add that folder with /include.`);
+    }
+    const choice = await ctx.requestApproval("Write outside the workspace?", [...OUTSIDE_OPTIONS], `Action: ${action}
+File: ${filePath}
+Workspace: ${(ctx.roots ?? [ctx.cwd]).join(", ")}`, "Permission Request");
+    if (choice === OUTSIDE_OPTIONS[1]) {
+        ctx.allowedOutsideDirs = new Set([...(ctx.allowedOutsideDirs ?? []), dir]);
+        return null;
+    }
+    if (choice === OUTSIDE_OPTIONS[0])
+        return null;
+    return fail(`Stopped: the user declined a write outside the workspace (${filePath}). Keep to the ` +
+        `project folders, and say what you were trying to do if you need somewhere else.`);
+}
+/** Is this path inside one of the folders the user opened? */
+export function insideWorkspace(ctx, filePath) {
+    const roots = ctx.roots && ctx.roots.length > 0 ? ctx.roots : [ctx.cwd];
+    return roots.some((root) => {
+        const rel = relative(root, filePath);
+        // "" is the root itself; a `..` prefix means the path climbed out of it.
+        return rel === "" || (!rel.startsWith("..") && !isAbsolute(rel));
+    });
+}
+//# sourceMappingURL=approval.js.map

package/dist/tools/approval.js.map

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