mindweave 0.0.1 → 2.1.2

package/dist/cli/bootstrap.js

@@ -0,0 +1,279 @@
+/**
+ * bootstrap.ts — make `mindweave` runnable from any directory.
+ *
+ * The whole point of a global command is that you `cd` into ANY project, type
+ * `mindweave`, and it works — including the API key. A random project won't carry
+ * Mindweave's `.env`, so the key has to live somewhere global. We layer config the
+ * way every CLI does, lowest priority first:
+ *
+ *   1. ~/.mindweave/.env   — the global store (write your key here once).
+ *   2. <project>/.env  — per-project overrides (optional).
+ *   3. real shell env  — always wins (export a provider's key for a one-off).
+ *
+ * We parse `.env` ourselves (a tiny, dependency-free reader) so we control that
+ * precedence exactly: a value is only applied if the variable isn't already set,
+ * and we load project before global — so shell > project > global falls out
+ * naturally. On first run we also drop a commented template at ~/.mindweave/.env so
+ * the user has an obvious place to paste their key.
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { stateRoot } from "../memory/store.js";
+import { allProviders } from "../drivers/registry.js";
+import { keysFor, slotVar } from "./keyStore.js";
+/**
+ * The global Mindweave config directory (~/.mindweave).
+ *
+ * The SAME directory the state lives in, and now the same function that resolves it.
+ * They were computed separately and only one honoured `MINDWEAVE_STATE_DIR`, so a test
+ * run — or anyone relocating Mindweave's files — moved the sessions and left the config
+ * behind in the real home. The suite creates this template, which meant a clean machine
+ * got a config file written into `~/.mindweave` by `npm test`: exactly the pollution
+ * scripts/testState.mjs exists to prevent, still open on the config side.
+ */
+export function globalConfigDir() {
+    return stateRoot();
+}
+/** The global env file (~/.mindweave/.env) — where the API key lives. */
+export function globalEnvPath() {
+    return join(globalConfigDir(), ".env");
+}
+/**
+ * Load configuration into process.env. Call once, before anything reads a key.
+ * Order matters: project first, then global, each set-if-absent, so already-set
+ * shell variables win and a project `.env` overrides the global one.
+ */
+export function loadConfig(cwd = process.cwd()) {
+    ensureGlobalTemplate();
+    reloadConfig(cwd);
+}
+/**
+ * Re-read the env files into process.env without recreating the template. Used to
+ * pick up a key the user just pasted while Mindweave is already running — once a real
+ * key appears we adopt it with no restart. (Empty values are ignored, so the
+ * blank key lines in the fresh template never count as "set".)
+ */
+export function reloadConfig(cwd = process.cwd()) {
+    applyEnvFile(join(cwd, ".env"));
+    applyEnvFile(globalEnvPath());
+    activateStoredKeys();
+}
+/**
+ * Point each provider at its first stored key, unless something already has.
+ *
+ * Storage is `VAR_1..VAR_9` and the LIVE key is the bare `VAR` that every driver reads —
+ * two roles, deliberately two variables. Nothing on disk fills the live one, so without
+ * this a key added through /key would be written, reloaded, and then invisible on the
+ * next launch: the app would ask for a key it already had.
+ *
+ * Set-if-absent, so a shell export still wins and a key chosen for this session with
+ * /key is not overwritten by a later reload.
+ */
+function activateStoredKeys() {
+    for (const provider of allProviders()) {
+        if (process.env[provider.apiKeyEnv]?.trim())
+            continue;
+        const first = keysFor(provider.apiKeyEnv)[0];
+        if (first)
+            process.env[provider.apiKeyEnv] = first.value;
+    }
+}
+/**
+ * True once the named provider's key is available from any source.
+ *
+ * The variable name is a parameter rather than a constant because which key is
+ * needed depends on which model the user is about to run — each provider declares
+ * its own in its manifest. This module stays a plain config utility and never
+ * imports the driver registry.
+ */
+export function hasApiKey(envVar) {
+    return Boolean(process.env[envVar]);
+}
+/**
+ * Persist a key the user typed in the terminal: write it into ~/.mindweave/.env (so
+ * it's there next launch too) and apply it to this process right away (so the
+ * chat can start immediately — no restart). Updates that provider's line in place,
+ * preserving every other line, so adding a second provider's key never disturbs
+ * the first one.
+ */
+/**
+ * Write a variable into the global env file, or remove it when `value` is null.
+ *
+ * One place, because saving and removing have to agree about the file's shape — a
+ * remover that only deleted from `process.env` would leave the key on disk and it would
+ * come back on the next launch.
+ */
+function writeEnvVar(envVar, value) {
+    const NL = String.fromCharCode(10);
+    const dir = globalConfigDir();
+    if (!existsSync(dir))
+        mkdirSync(dir, { recursive: true });
+    const path = globalEnvPath();
+    let existing = "";
+    try {
+        existing = readFileSync(path, "utf8");
+    }
+    catch {
+        /* no file yet */
+    }
+    // Find the variable's line the way applyEnvFile READS it: leading spaces or tabs, and
+    // an optional `export ` prefix, are both accepted there. A writer that matched neither
+    // would fail to find a line the reader had loaded, append a second one, and let the
+    // stale line win on the next launch — a key updated in the app but not on disk. Only
+    // spaces and tabs, never `\s`, so the match cannot run across a line break.
+    const body = `(?:export[ \\t]+)?${envVar}=`;
+    let next;
+    if (value === null) {
+        // Take the trailing newline with the line, then collapse any blank run left behind.
+        const remove = new RegExp(`^[ \\t]*${body}.*(?:\\r?\\n|$)`, "m");
+        next = existing.replace(remove, "").replace(new RegExp(`${NL}{3,}`, "g"), NL + NL);
+    }
+    else {
+        const line = `${envVar}=${value}`;
+        const replace = new RegExp(`^[ \\t]*${body}.*$`, "m");
+        next = replace.test(existing)
+            ? existing.replace(replace, line)
+            : (existing ? existing.replace(/\s*$/, NL) : "") + line + NL;
+    }
+    writeFileSync(path, next, { mode: 0o600 });
+}
+/**
+ * Move a bare `VAR=value` into `VAR_1`, once, so storage and the live key stop sharing a
+ * variable. An existing config or a shell export arrives that way; everything written
+ * after this point is numbered.
+ */
+function normalizeLegacy(apiKeyEnv) {
+    const bare = process.env[apiKeyEnv]?.trim();
+    if (!bare)
+        return;
+    if (process.env[slotVar(apiKeyEnv, 1)]?.trim())
+        return;
+    process.env[slotVar(apiKeyEnv, 1)] = bare;
+    writeEnvVar(slotVar(apiKeyEnv, 1), bare);
+    writeEnvVar(apiKeyEnv, null);
+}
+/** Store a key in a slot. Slot 1 also becomes the live key when nothing else is. */
+export function saveApiKey(apiKeyEnv, key, slot = 1) {
+    const trimmed = key.trim();
+    if (!trimmed)
+        return;
+    normalizeLegacy(apiKeyEnv);
+    const envVar = slotVar(apiKeyEnv, slot);
+    process.env[envVar] = trimmed;
+    writeEnvVar(envVar, trimmed);
+    if (!process.env[apiKeyEnv]?.trim() || slot === 1)
+        process.env[apiKeyEnv] = trimmed;
+}
+/**
+ * Remove one stored key, closing the gap behind it.
+ *
+ * Slots are renumbered so there is never a hole: with `_2` gone, `_3` becomes `_2`. A
+ * hole reads fine to a program and badly to a person opening the file. Cleared first and
+ * rewritten from 1, because renumbering in place would overwrite a value before it had
+ * been moved.
+ */
+export function removeApiKey(apiKeyEnv, slot) {
+    normalizeLegacy(apiKeyEnv);
+    const before = keysFor(apiKeyEnv);
+    const live = process.env[apiKeyEnv]?.trim();
+    const remaining = before.filter((k) => k.slot !== slot);
+    for (const k of before) {
+        delete process.env[k.envVar];
+        writeEnvVar(k.envVar, null);
+    }
+    remaining.forEach((k, i) => {
+        const envVar = slotVar(apiKeyEnv, i + 1);
+        process.env[envVar] = k.value;
+        writeEnvVar(envVar, k.value);
+    });
+    // Removing the key that was in use must not leave the provider pointing at nothing.
+    if (!remaining.some((k) => k.value === live)) {
+        if (remaining[0])
+            process.env[apiKeyEnv] = remaining[0].value;
+        else
+            delete process.env[apiKeyEnv];
+    }
+}
+/**
+ * Make a stored key the one the drivers send, for this session.
+ *
+ * Assigned into the variable they already read, and the stored slots are left alone: a
+ * key that is merely rate-limited today belongs back in its usual place tomorrow, and
+ * choosing one should not reorder a file the user maintains.
+ */
+export function useApiKey(apiKeyEnv, slot) {
+    const found = keysFor(apiKeyEnv).find((k) => k.slot === slot);
+    if (!found)
+        return false;
+    process.env[apiKeyEnv] = found.value;
+    return true;
+}
+/**
+ * What lands in ~/.mindweave/.env the first time Mindweave runs.
+ *
+ * Every provider, because this is the file a new user actually opens — it listed two of
+ * thirteen, and someone who came for Gemini or Groq found no sign their provider existed.
+ * Built from the registry rather than typed out, so a new driver cannot be forgotten
+ * here (docsCurrent.test.ts holds the same line for .env.example and PROVIDERS.md).
+ */
+const GLOBAL_ENV_TEMPLATE = [
+    "# Mindweave global config — applies in every project.",
+    "# Paste a key below (no quotes needed). You only need the one for the provider you",
+    "# actually use; fill in several and /provider moves between them.",
+    "",
+    // The name on its OWN line, never trailing the assignment. `KEY=   # DeepSeek` reads
+    // fine and parses as a VALUE of "# DeepSeek", so every provider would have reported a
+    // key it did not have: no first-run prompt, and every request rejected with no
+    // explanation. Caught by reading the parsed result rather than the file.
+    ...allProviders().flatMap((p) => [`# ${p.label}`, `${p.apiKeyEnv}=`]),
+    "",
+    "# Optional:",
+    "# MINDWEAVE_MODEL — which model to open with. Run /model in Mindweave for the list.",
+    "# MINDWEAVE_MODEL=",
+    "",
+].join(String.fromCharCode(10));
+/** Create ~/.mindweave/.env with a commented template the first time we run. */
+function ensureGlobalTemplate() {
+    try {
+        const dir = globalConfigDir();
+        if (!existsSync(dir))
+            mkdirSync(dir, { recursive: true });
+        const path = globalEnvPath();
+        if (!existsSync(path)) {
+            writeFileSync(path, GLOBAL_ENV_TEMPLATE, { mode: 0o600 });
+        }
+    }
+    catch {
+        // Best-effort: if we can't write the template, config loading still works.
+    }
+}
+/** Apply a single .env file (set-if-absent), tolerating a missing/garbled file. */
+function applyEnvFile(path) {
+    let text;
+    try {
+        text = readFileSync(path, "utf8");
+    }
+    catch {
+        return; // no file here — fine
+    }
+    for (const raw of text.split(/\r?\n/)) {
+        const line = raw.trim();
+        if (!line || line.startsWith("#"))
+            continue;
+        const body = line.startsWith("export ") ? line.slice(7) : line;
+        const eq = body.indexOf("=");
+        if (eq <= 0)
+            continue;
+        const key = body.slice(0, eq).trim();
+        if (!key || key in process.env)
+            continue; // already set wins
+        let value = body.slice(eq + 1).trim();
+        if (value.length >= 2 && (value[0] === '"' || value[0] === "'") && value[value.length - 1] === value[0]) {
+            value = value.slice(1, -1);
+        }
+        if (!value)
+            continue; // ignore empty assignments (e.g. the blank template line)
+        process.env[key] = value;
+    }
+}
+//# sourceMappingURL=bootstrap.js.map

package/dist/cli/bootstrap.js.map

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

package/dist/cli/chatAnchor.js

@@ -0,0 +1,94 @@
+/**
+ * chatAnchor.ts — where the transcript sits inside the chat viewport.
+ *
+ * The viewport is a fixed-height clipped box and the transcript renders in FULL
+ * inside it; a vertical offset decides which part shows. That mechanism is
+ * deliberately dumb — no height estimation, no per-block scrolling — because both
+ * of those were tried and both are why it broke. This module owns the decision that
+ * positions it, so the rule can be tested instead of eyeballed.
+ *
+ * Two regimes, and the whole point of the shape below is that they cannot interfere:
+ *
+ *   - The transcript OVERFLOWS. Then it scrolls, and the offset is negative:
+ *     `-shift` slides the content up so the newest lines are on screen. `scrollUp`
+ *     counts lines back from the bottom, so 0 always means pinned to the newest and
+ *     fresh output stays put with no special case.
+ *   - The transcript FITS. Then there is nothing to scroll, and the only question is
+ *     where the spare rows go. They used to go below the text, stranding a short
+ *     conversation at the top of the screen with a growing void above the input box.
+ *     They now go above it, so the conversation rests on the input the way a chat is
+ *     expected to.
+ *
+ * HOW the spare rows are moved matters more than it looks. The obvious version — pad
+ * the transcript down by `chatRows - contentHeight` — was written first and a render
+ * probe rejected it: `chatRows` is a MEASURED value that lags a frame, and on the
+ * first render it is not yet known at all. Padding by a stale number leaves a gap on
+ * a good frame and, when the number is too large, pushes the whole conversation down
+ * past the clip edge and off the screen.
+ *
+ * So the offset here is only ever the scroll offset, and the resting case is done in
+ * the layout instead: `restsOnFooter` tells the view to put a flex-grow spacer ABOVE
+ * the transcript. Yoga then measures the leftover space itself, in the same pass that
+ * lays the frame out, and no stale measurement can be wrong about it.
+ */
+/**
+ * Position the transcript.
+ *
+ * @param contentHeight measured height of the whole transcript, in rows
+ * @param chatRows      measured height of the viewport it renders into
+ * @param scrollUp      lines the user has scrolled back from the newest
+ */
+export function chatLayout(contentHeight, chatRows, scrollUp) {
+    // A viewport of zero rows would compute an offset that slides the ENTIRE
+    // transcript off the top — every line hidden, with nothing on screen to explain
+    // it. App already clamps this, but a positioning rule should not depend on its
+    // caller to stay sane: one row always shows the newest line, which is the right
+    // failure for a viewport too small to be useful.
+    const rows = Math.max(1, chatRows);
+    const maxScroll = Math.max(0, contentHeight - rows);
+    const scrolled = Math.min(Math.max(0, scrollUp), maxScroll);
+    const shift = maxScroll - scrolled;
+    return {
+        // `|| 0` because negating zero yields `-0`, which is the same frame but a
+        // different value to anything comparing with Object.is.
+        marginTop: -shift || 0,
+        // Nothing to scroll means nothing to scroll TO — the transcript is short, and
+        // the spare rows belong above it.
+        restsOnFooter: maxScroll === 0,
+        maxScroll,
+        scrolled,
+    };
+}
+/**
+ * Where the reader should sit after the transcript re-wraps at a new width.
+ *
+ * `scrollUp` counts LINES back from the newest, and a line is not a stable unit
+ * across a resize: narrow the terminal and every wrapped paragraph grows more rows,
+ * so the same count lands somewhere else entirely. Being at the bottom survives that
+ * by luck, because zero is zero at any width, but any scrolled-back reader is moved
+ * without touching anything.
+ *
+ * The position is therefore carried as a PROPORTION of the scrollable range, which is
+ * the one thing about "where I was reading" that a re-wrap preserves. It is not exact
+ * — the same fraction of a taller transcript is a slightly different paragraph — but
+ * it keeps the reader within a line or two of where they were, where a raw line count
+ * can move them by pages.
+ *
+ * Pinned to the newest stays pinned, though that falls out of the arithmetic on its
+ * own — a red-check showed the guard below is not what produces it. What the guard is
+ * really for is a NEGATIVE position, which the proportion would carry through into a
+ * negative offset and slide the transcript off the top of the viewport.
+ */
+export function reflowScroll(scrolled, oldMaxScroll, newMaxScroll) {
+    if (scrolled <= 0)
+        return 0;
+    if (newMaxScroll <= 0)
+        return 0;
+    // Nothing scrollable before means there is no proportion to carry; the reader was
+    // looking at the whole transcript, and the bottom is where they still belong.
+    if (oldMaxScroll <= 0)
+        return 0;
+    const fraction = Math.min(1, scrolled / oldMaxScroll);
+    return Math.min(newMaxScroll, Math.round(fraction * newMaxScroll));
+}
+//# sourceMappingURL=chatAnchor.js.map

package/dist/cli/chatAnchor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chatAnchor.js","sourceRoot":"","sources":["../../src/cli/chatAnchor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAqBH;;;;;;GAMG;AACH,MAAM,UAAU,UAAU,CAAC,aAAqB,EAAE,QAAgB,EAAE,QAAgB;IAClF,yEAAyE;IACzE,gFAAgF;IAChF,+EAA+E;IAC/E,gFAAgF;IAChF,iDAAiD;IACjD,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;IACnC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC,CAAC;IACpD,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,CAAC,EAAE,SAAS,CAAC,CAAC;IAC5D,MAAM,KAAK,GAAG,SAAS,GAAG,QAAQ,CAAC;IACnC,OAAO;QACL,0EAA0E;QAC1E,wDAAwD;QACxD,SAAS,EAAE,CAAC,KAAK,IAAI,CAAC;QACtB,8EAA8E;QAC9E,kCAAkC;QAClC,aAAa,EAAE,SAAS,KAAK,CAAC;QAC9B,SAAS;QACT,QAAQ;KACT,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,YAAY,CAAC,QAAgB,EAAE,YAAoB,EAAE,YAAoB;IACvF,IAAI,QAAQ,IAAI,CAAC;QAAE,OAAO,CAAC,CAAC;IAC5B,IAAI,YAAY,IAAI,CAAC;QAAE,OAAO,CAAC,CAAC;IAChC,kFAAkF;IAClF,8EAA8E;IAC9E,IAAI,YAAY,IAAI,CAAC;QAAE,OAAO,CAAC,CAAC;IAChC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,GAAG,YAAY,CAAC,CAAC;IACtD,OAAO,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,YAAY,CAAC,CAAC,CAAC;AACrE,CAAC"}

package/dist/cli/commandArgs.js

@@ -0,0 +1,79 @@
+/**
+ * commandArgs.ts — turning what someone typed after a command into a choice.
+ *
+ * `/model`, `/think` and `/compact` all took an argument and threw it away without a
+ * word. Naming a model after `/model` opened the picker as if you had typed nothing,
+ * which reads as the app not having heard you — and is worse than an error, because an
+ * error tells you to try something else and silence tells you nothing.
+ *
+ * Terminal agents generally accept an argument on all three, so it is what someone
+ * will type without thinking about it — which is exactly when silence is worst.
+ *
+ * Nothing here knows any provider's lineup: the candidates are handed in by the caller,
+ * which reads them from the registry. That is the rule for core code, and it is also
+ * what makes this testable without a key.
+ *
+ * The matching is deliberately forgiving in a bounded way: exact id, then exact label,
+ * then a UNIQUE prefix, then a UNIQUE substring. Never a "closest guess" — picking a
+ * model or a reasoning budget is a decision with a cost attached, and quietly choosing
+ * the nearest thing to a typo is how you end up billed for the wrong one. Ambiguity
+ * and misses both come back as a message naming the real options.
+ */
+function norm(s) {
+    return s.trim().toLowerCase();
+}
+/** "a, b or c" — a list a person reads, not a machine dump. */
+function list(items) {
+    if (items.length <= 1)
+        return items[0] ?? "";
+    return `${items.slice(0, -1).join(", ")} or ${items[items.length - 1]}`;
+}
+/**
+ * Which candidate the typed argument means.
+ *
+ * `what` names the thing being chosen, so the message reads as a sentence rather than
+ * as a template ("No model called…", "No reasoning level called…").
+ */
+export function resolveChoice(arg, candidates, what) {
+    const wanted = norm(arg);
+    if (!wanted)
+        return { kind: "error", message: `Which ${what}?` };
+    const names = candidates.map((c) => c.label);
+    // Exact wins outright, and is checked against BOTH the id and the label — the id is
+    // what a script or a copied command line carries, the label is what the picker shows.
+    const exact = candidates.findIndex((c) => norm(c.label) === wanted || (c.id !== undefined && norm(c.id) === wanted));
+    if (exact >= 0)
+        return { kind: "match", index: exact };
+    const starts = matchesFor(candidates, (c) => startsWith(c, wanted));
+    if (starts.length === 1)
+        return { kind: "match", index: starts[0] };
+    if (starts.length > 1)
+        return { kind: "error", message: ambiguous(arg, starts.map((i) => names[i])) };
+    const contains = matchesFor(candidates, (c) => includes(c, wanted));
+    if (contains.length === 1)
+        return { kind: "match", index: contains[0] };
+    if (contains.length > 1)
+        return { kind: "error", message: ambiguous(arg, contains.map((i) => names[i])) };
+    return {
+        kind: "error",
+        message: `No ${what} called "${arg.trim()}". Available: ${list(names)}.`,
+    };
+}
+function matchesFor(candidates, pred) {
+    const out = [];
+    candidates.forEach((c, i) => {
+        if (pred(c))
+            out.push(i);
+    });
+    return out;
+}
+function startsWith(c, wanted) {
+    return norm(c.label).startsWith(wanted) || (c.id !== undefined && norm(c.id).startsWith(wanted));
+}
+function includes(c, wanted) {
+    return norm(c.label).includes(wanted) || (c.id !== undefined && norm(c.id).includes(wanted));
+}
+function ambiguous(arg, matched) {
+    return `"${arg.trim()}" matches ${list(matched)}. Which one?`;
+}
+//# sourceMappingURL=commandArgs.js.map

package/dist/cli/commandArgs.js.map

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

package/dist/cli/commandRoute.js

@@ -0,0 +1,78 @@
+/**
+ * commandRoute.ts — deciding WHICH command a typed line is.
+ *
+ * This used to be the condition half of a 460-line `if (name === "/x")` chain inside a
+ * React component, which is why every one of the eighteen commands had zero coverage:
+ * there was nothing to call. The bodies still live in `App.tsx`. Only the decision
+ * moved here, because the decision is where the defects were:
+ *
+ *  - **`/mcp add` and `/mcp remove` were DEAD.** The guard read
+ *    `/^(add|remove|rm)\b/` on screen, but the byte where `\b` should have been was a
+ *    literal backspace (0x08) — an escape lost somewhere in editing. The pattern
+ *    therefore required the user to type a backspace character, so it never matched
+ *    anything, and every `/mcp add …` silently opened the server-health view instead.
+ *    The command was advertised in its own `/help` description the whole time.
+ *  - The unknown-command reply listed thirteen of the eighteen commands, hardcoded. It
+ *    had drifted, and the four it omitted included `/help`.
+ *
+ * Both are the same shape as the bugs found in the queue and the first run: the feature
+ * worked, the routing to it did not, and reading the code did not show it — the first
+ * one was INVISIBLE in the source, which is why the verb list here is data rather than
+ * a pattern. There is nothing in `["add","remove","rm"]` that can be mistyped into
+ * something that still compiles and never matches.
+ *
+ * Order matters and is deliberate: a builtin beats a project skill, a project skill
+ * beats a third-party server's prompt. A server cannot shadow `/undo`, and a project's
+ * own command always wins over something a dependency installed.
+ */
+import { findSkill } from "../governor/skills.js";
+import { parsePromptCommand } from "../mcp/prompts.js";
+/** The sub-commands `/mcp` understands as configuration rather than as a status view. */
+export const MCP_CONFIG_VERBS = ["add", "remove", "rm"];
+/**
+ * Split a typed line into the command word and its argument.
+ *
+ * The name is lowercased so `/Help` works; the argument is not, because it is as
+ * likely to be a path, a label or a directive, and lowercasing `/include SRC/Api`
+ * would break it on a case-sensitive checkout.
+ */
+export function parseCommandLine(raw) {
+    const trimmed = raw.trim();
+    const first = trimmed.split(/\s+/)[0] ?? "";
+    return { name: first.toLowerCase(), arg: trimmed.slice(first.length).trim() };
+}
+export function routeCommand(raw, catalog) {
+    const { name, arg } = parseCommandLine(raw);
+    if (catalog.builtins.includes(name)) {
+        // `/mcp` is the one builtin that splits: with a configuration verb it writes the
+        // server config, bare it shows server health. An EXACT first word — a prefix match
+        // would send `/mcp rmdir-server` to the remove branch, which fails its own exact
+        // check one layer down and falls through to being parsed as an ADD.
+        if (name === "/mcp") {
+            const verb = arg.split(/\s+/)[0]?.toLowerCase() ?? "";
+            if (MCP_CONFIG_VERBS.includes(verb)) {
+                return { kind: "mcp-config", arg };
+            }
+        }
+        return { kind: "builtin", name, arg };
+    }
+    // A project's own skill beats a server's prompt of the same name.
+    const skill = findSkill(catalog.skills, name);
+    if (skill)
+        return { kind: "skill", skill, arg };
+    const promptRef = parsePromptCommand(name);
+    if (promptRef)
+        return { kind: "prompt", server: promptRef.server, prompt: promptRef.name, arg };
+    return { kind: "unknown", name };
+}
+/**
+ * What to say when nothing matched.
+ *
+ * The old message hardcoded thirteen command names and had drifted from the real
+ * eighteen — including omitting `/help`, the one that would have answered the
+ * question. Pointing at `/help` cannot drift, and is shorter than the list it replaces.
+ */
+export function unknownCommandMessage(name) {
+    return `Unknown command ${name}. /help lists every command.`;
+}
+//# sourceMappingURL=commandRoute.js.map

package/dist/cli/commandRoute.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commandRoute.js","sourceRoot":"","sources":["../../src/cli/commandRoute.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAElD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD,yFAAyF;AACzF,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,CAAU,CAAC;AASjE;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAC1C,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IAC3B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC5C,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,WAAW,EAAE,EAAE,GAAG,EAAE,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;AAChF,CAAC;AAuBD,MAAM,UAAU,YAAY,CAAC,GAAW,EAAE,OAAqB;IAC7D,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC;IAE5C,IAAI,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACpC,iFAAiF;QACjF,mFAAmF;QACnF,iFAAiF;QACjF,oEAAoE;QACpE,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;YACpB,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;YACtD,IAAK,gBAAsC,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC3D,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,GAAG,EAAE,CAAC;YACrC,CAAC;QACH,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC;IACxC,CAAC;IAED,kEAAkE;IAClE,MAAM,KAAK,GAAG,SAAS,CAAC,OAAO,CAAC,MAAqB,EAAE,IAAI,CAAC,CAAC;IAC7D,IAAI,KAAK;QAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;IAEhD,MAAM,SAAS,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;IAC3C,IAAI,SAAS;QAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC;IAEhG,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;AACnC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAAY;IAChD,OAAO,mBAAmB,IAAI,8BAA8B,CAAC;AAC/D,CAAC"}

package/dist/cli/compaction.js

@@ -0,0 +1,69 @@
+/**
+ * compaction.ts — how a compaction reports itself, as pure text (no React).
+ *
+ *   [████████████████████] 100%  context full
+ *   ✔ Reclaimed 106K tokens (22K / 128K)
+ *   [███░░░░░░░░░░░░░░░░░]  17%  context used
+ *
+ * Compaction is the one piece of background machinery worth showing. Everything else
+ * Mindweave does to manage context is invisible on purpose, but a summarizing pass
+ * REWRITES the conversation — the model will not remember the middle of it afterwards
+ * — and a user who does not know that happened is left wondering why it forgot.
+ *
+ * ONE block, already settled. There is no "Compacting…" state that later fills in: the
+ * before-figure is only interesting next to the after-figure, and a row that changes
+ * under the reader is the exact transition the transcript design removes elsewhere.
+ *
+ * The numbers are the SAME arithmetic the compaction thresholds run on (transcript
+ * estimate + measured overhead). That coupling is deliberate. If the estimate is off,
+ * the bar is wrong in precisely the way the decision to compact was wrong, so what the
+ * user sees is what the system actually believed — rather than a second, prettier
+ * number that disagrees with the machinery.
+ */
+import { formatTokens } from "../dynamo/pricing.js";
+/** Cells in a bar. Matches the reference design; shrinks only on a narrow terminal. */
+const BAR_CELLS = 20;
+const FULL = "█";
+const EMPTY = "░";
+/** A `[████░░░░]` bar for a fraction of the window (pure). Clamped, so a measurement
+ *  that overshoots the window renders as full rather than overflowing the row. */
+export function bar(used, window, cells = BAR_CELLS) {
+    const safeCells = Math.max(4, cells);
+    const frac = window > 0 ? Math.min(1, Math.max(0, used / window)) : 0;
+    // Round rather than floor, so a nearly-full context does not read as one cell short —
+    // but never round UP to full while any room remains, which would say "full" wrongly.
+    let filled = Math.round(frac * safeCells);
+    if (frac < 1 && filled === safeCells)
+        filled = safeCells - 1;
+    if (frac > 0 && filled === 0)
+        filled = 1; // and never show a used context as empty
+    return `[${FULL.repeat(filled)}${EMPTY.repeat(safeCells - filled)}]`;
+}
+/** The percentage shown beside a bar (pure), right-aligned to three columns so the
+ *  before/after pair line up whatever the digits. */
+export function percent(used, window) {
+    const pct = window > 0 ? Math.round((used / window) * 100) : 0;
+    return `${Math.min(100, Math.max(0, pct))}%`.padStart(4);
+}
+/**
+ * The finished block, one string per row (pure).
+ *
+ * `width` shrinks the bars on a narrow terminal rather than letting a row wrap, since
+ * a wrapped bar reads as two broken bars.
+ */
+export function compactionLines(r, width = 80) {
+    // Row overhead: the two-space indent, the brackets, a space, four percent columns,
+    // two spaces, and the label. Leave the bar whatever is left, within reason.
+    const cells = Math.max(4, Math.min(BAR_CELLS, width - 26));
+    const reclaimed = Math.max(0, r.before - r.after);
+    // Labelled "before"/"after" rather than the reference's "Context Full"/"Context
+    // Used". That wording only reads correctly when the pass ran at 100%, and `/compact`
+    // can be typed at any moment — a bar showing 75% next to the words "context full"
+    // is a caption contradicting the picture directly above it.
+    return [
+        `${bar(r.before, r.window, cells)} ${percent(r.before, r.window)}  before`,
+        `✔ Reclaimed ${formatTokens(reclaimed)} tokens (${formatTokens(r.after)} / ${formatTokens(r.window)})`,
+        `${bar(r.after, r.window, cells)} ${percent(r.after, r.window)}  after`,
+    ];
+}
+//# sourceMappingURL=compaction.js.map

package/dist/cli/compaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compaction.js","sourceRoot":"","sources":["../../src/cli/compaction.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAKpD,uFAAuF;AACvF,MAAM,SAAS,GAAG,EAAE,CAAC;AACrB,MAAM,IAAI,GAAG,GAAG,CAAC;AACjB,MAAM,KAAK,GAAG,GAAG,CAAC;AAElB;kFACkF;AAClF,MAAM,UAAU,GAAG,CAAC,IAAY,EAAE,MAAc,EAAE,KAAK,GAAG,SAAS;IACjE,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IACrC,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACtE,sFAAsF;IACtF,qFAAqF;IACrF,IAAI,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,SAAS,CAAC,CAAC;IAC1C,IAAI,IAAI,GAAG,CAAC,IAAI,MAAM,KAAK,SAAS;QAAE,MAAM,GAAG,SAAS,GAAG,CAAC,CAAC;IAC7D,IAAI,IAAI,GAAG,CAAC,IAAI,MAAM,KAAK,CAAC;QAAE,MAAM,GAAG,CAAC,CAAC,CAAC,yCAAyC;IACnF,OAAO,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,SAAS,GAAG,MAAM,CAAC,GAAG,CAAC;AACvE,CAAC;AAED;qDACqD;AACrD,MAAM,UAAU,OAAO,CAAC,IAAY,EAAE,MAAc;IAClD,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,GAAG,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/D,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,CAAmB,EAAE,KAAK,GAAG,EAAE;IAC7D,mFAAmF;IACnF,4EAA4E;IAC5E,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,GAAG,EAAE,CAAC,CAAC,CAAC;IAC3D,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;IAClD,gFAAgF;IAChF,qFAAqF;IACrF,kFAAkF;IAClF,4DAA4D;IAC5D,OAAO;QACL,GAAG,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,UAAU;QAC1E,eAAe,YAAY,CAAC,SAAS,CAAC,YAAY,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG;QACtG,GAAG,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,SAAS;KACxE,CAAC;AACJ,CAAC"}