mneme-ai 2.75.2 → 2.77.0

package/dist/ui/tui_core.d.ts

@@ -0,0 +1,63 @@
+/**
+ * v2.77.0 — INTERACTIVE TUI core (pure, dependency-free, fully testable).
+ *
+ * The driver (commands/ui.ts) owns raw-mode stdin + the alt-screen; everything
+ * here is pure: load the capability catalog, fuzzy-filter/rank it, fold a
+ * keypress into new state, and render state → lines. Pure functions = the TUI
+ * logic is unit-tested without a terminal.
+ *
+ * Design goal: the user types plain language ("how do I check if a claim is
+ * true") and the right capability surfaces — zero command memorization. New
+ * tools appear automatically because the list is the live MNEME_COMMAND_CATALOG.
+ */
+export interface CapItem {
+    command: string;
+    alias?: string;
+    since: string;
+    what: string;
+    when: string;
+    group: string;
+}
+export interface UiState {
+    query: string;
+    all: CapItem[];
+    filtered: CapItem[];
+    selected: number;
+    scrollTop: number;
+    listRows: number;
+    mode: "browse" | "output";
+    output?: string;
+    outputTitle?: string;
+}
+export type UiAction = {
+    type: "none";
+} | {
+    type: "quit";
+} | {
+    type: "run";
+    item: CapItem;
+};
+export interface KeyEvent {
+    name?: string;
+    ctrl?: boolean;
+    sequence?: string;
+}
+/** Normalize a raw manifest entry into a CapItem (defensive). */
+export declare function toCapItem(raw: unknown): CapItem | null;
+export declare function loadCatalog(rawList: unknown[]): CapItem[];
+/** Filter + rank. Empty query → all (stable). Multi-term = AND (every term
+ *  must match somewhere); score = sum of per-term best scores. */
+export declare function filterItems(all: CapItem[], query: string): CapItem[];
+export declare function initState(all: CapItem[], listRows: number): UiState;
+/** Fold a keypress into new state + an action for the driver to perform.
+ *  Pure: same (state, key) → same (state, action). */
+export declare function reduce(state: UiState, key: KeyEvent): {
+    state: UiState;
+    action: UiAction;
+};
+/** Does this catalog command take arguments (placeholders) or is it MCP-only?
+ *  Such commands can't be run blind from the TUI — we show the template. */
+export declare function isParameterless(item: CapItem): boolean;
+/** The shell argv (after "mneme") for a parameterless command. */
+export declare function shellArgsFor(item: CapItem): string[];
+//# sourceMappingURL=tui_core.d.ts.map

package/dist/ui/tui_core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tui_core.d.ts","sourceRoot":"","sources":["../../src/ui/tui_core.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,WAAW,OAAO;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,OAAO;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,OAAO,EAAE,CAAC;IACf,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,MAAM,QAAQ,GAChB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC;AAEnC,MAAM,WAAW,QAAQ;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAID,iEAAiE;AACjE,wBAAgB,SAAS,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,GAAG,IAAI,CAYtD;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,CAMzD;AAqBD;kEACkE;AAClE,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,EAAE,CAYpE;AAID,wBAAgB,SAAS,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEnE;AAqBD;sDACsD;AACtD,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,QAAQ,CAAA;CAAE,CA2B1F;AAID;4EAC4E;AAC5E,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAKtD;AAED,kEAAkE;AAClE,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,EAAE,CAEpD"}

package/dist/ui/tui_core.js

@@ -0,0 +1,158 @@
+/**
+ * v2.77.0 — INTERACTIVE TUI core (pure, dependency-free, fully testable).
+ *
+ * The driver (commands/ui.ts) owns raw-mode stdin + the alt-screen; everything
+ * here is pure: load the capability catalog, fuzzy-filter/rank it, fold a
+ * keypress into new state, and render state → lines. Pure functions = the TUI
+ * logic is unit-tested without a terminal.
+ *
+ * Design goal: the user types plain language ("how do I check if a claim is
+ * true") and the right capability surfaces — zero command memorization. New
+ * tools appear automatically because the list is the live MNEME_COMMAND_CATALOG.
+ */
+/* ── catalog ─────────────────────────────────────────────────────────── */
+/** Normalize a raw manifest entry into a CapItem (defensive). */
+export function toCapItem(raw) {
+    if (!raw || typeof raw !== "object")
+        return null;
+    const r = raw;
+    if (typeof r.command !== "string" || r.command.length === 0)
+        return null;
+    return {
+        command: r.command,
+        alias: typeof r.alias === "string" ? r.alias : undefined,
+        since: typeof r.since === "string" ? r.since : "?",
+        what: typeof r.what === "string" ? r.what : "",
+        when: typeof r.when === "string" ? r.when : "",
+        group: typeof r.group === "string" ? r.group : "core",
+    };
+}
+export function loadCatalog(rawList) {
+    const out = [];
+    for (const r of rawList ?? []) {
+        const c = toCapItem(r);
+        if (c)
+            out.push(c);
+    }
+    // De-dup by command; stable.
+    const seen = new Set();
+    return out.filter((c) => (seen.has(c.command) ? false : (seen.add(c.command), true)));
+}
+/* ── fuzzy filter + ranking ──────────────────────────────────────────── */
+/** Score one item against one lowercased term. Higher = better; 0 = no match.
+ *  Weights: command-name >> alias > group > what > when. */
+function scoreTerm(item, term) {
+    const cmd = item.command.toLowerCase();
+    const alias = (item.alias ?? "").toLowerCase();
+    const what = item.what.toLowerCase();
+    const when = item.when.toLowerCase();
+    const group = item.group.toLowerCase();
+    let s = 0;
+    if (cmd.includes(term))
+        s = Math.max(s, cmd.startsWith(term) || cmd.includes(" " + term) ? 100 : 70);
+    if (alias && alias.includes(term))
+        s = Math.max(s, 60);
+    if (group.includes(term))
+        s = Math.max(s, 40);
+    if (what.includes(term))
+        s = Math.max(s, 25);
+    if (when.includes(term))
+        s = Math.max(s, 12);
+    return s;
+}
+/** Filter + rank. Empty query → all (stable). Multi-term = AND (every term
+ *  must match somewhere); score = sum of per-term best scores. */
+export function filterItems(all, query) {
+    const q = query.trim().toLowerCase();
+    if (q.length === 0)
+        return all.slice();
+    const terms = q.split(/\s+/).filter(Boolean);
+    const scored = [];
+    for (const item of all) {
+        let total = 0;
+        let ok = true;
+        for (const t of terms) {
+            const s = scoreTerm(item, t);
+            if (s === 0) {
+                ok = false;
+                break;
+            }
+            total += s;
+        }
+        if (ok)
+            scored.push({ item, score: total });
+    }
+    scored.sort((a, b) => (b.score - a.score) || a.item.command.localeCompare(b.item.command));
+    return scored.map((s) => s.item);
+}
+/* ── state ───────────────────────────────────────────────────────────── */
+export function initState(all, listRows) {
+    return { query: "", all, filtered: all.slice(), selected: 0, scrollTop: 0, listRows: Math.max(1, listRows), mode: "browse" };
+}
+function clampScroll(s) {
+    // Keep selected within the visible window.
+    let scrollTop = s.scrollTop;
+    if (s.selected < scrollTop)
+        scrollTop = s.selected;
+    else if (s.selected >= scrollTop + s.listRows)
+        scrollTop = s.selected - s.listRows + 1;
+    scrollTop = Math.max(0, Math.min(scrollTop, Math.max(0, s.filtered.length - s.listRows)));
+    return { ...s, scrollTop };
+}
+function refilter(s) {
+    const filtered = filterItems(s.all, s.query);
+    return clampScroll({ ...s, filtered, selected: filtered.length === 0 ? 0 : Math.min(s.selected, filtered.length - 1) });
+}
+/** True for a single printable character we should append to the query. */
+function isPrintable(k) {
+    return !k.ctrl && typeof k.sequence === "string" && k.sequence.length === 1 && k.sequence >= " " && k.sequence !== "\x7f";
+}
+/** Fold a keypress into new state + an action for the driver to perform.
+ *  Pure: same (state, key) → same (state, action). */
+export function reduce(state, key) {
+    // Output pane: any key returns to browse.
+    if (state.mode === "output") {
+        return { state: { ...state, mode: "browse", output: undefined, outputTitle: undefined }, action: { type: "none" } };
+    }
+    const name = key.name ?? "";
+    if (key.ctrl && (name === "c"))
+        return { state, action: { type: "quit" } };
+    switch (name) {
+        case "escape":
+            // Esc clears the query first; a second Esc (empty query) quits.
+            if (state.query.length > 0)
+                return { state: refilter({ ...state, query: "" }), action: { type: "none" } };
+            return { state, action: { type: "quit" } };
+        case "return": {
+            const item = state.filtered[state.selected];
+            return item ? { state, action: { type: "run", item } } : { state, action: { type: "none" } };
+        }
+        case "up": return { state: clampScroll({ ...state, selected: Math.max(0, state.selected - 1) }), action: { type: "none" } };
+        case "down": return { state: clampScroll({ ...state, selected: Math.min(Math.max(0, state.filtered.length - 1), state.selected + 1) }), action: { type: "none" } };
+        case "pageup": return { state: clampScroll({ ...state, selected: Math.max(0, state.selected - state.listRows) }), action: { type: "none" } };
+        case "pagedown": return { state: clampScroll({ ...state, selected: Math.min(Math.max(0, state.filtered.length - 1), state.selected + state.listRows) }), action: { type: "none" } };
+        case "home": return { state: clampScroll({ ...state, selected: 0 }), action: { type: "none" } };
+        case "end": return { state: clampScroll({ ...state, selected: Math.max(0, state.filtered.length - 1) }), action: { type: "none" } };
+        case "backspace": return { state: state.query.length > 0 ? refilter({ ...state, query: state.query.slice(0, -1) }) : state, action: { type: "none" } };
+        default:
+            if (isPrintable(key))
+                return { state: refilter({ ...state, query: state.query + key.sequence }), action: { type: "none" } };
+            return { state, action: { type: "none" } };
+    }
+}
+/* ── run classification ──────────────────────────────────────────────── */
+/** Does this catalog command take arguments (placeholders) or is it MCP-only?
+ *  Such commands can't be run blind from the TUI — we show the template. */
+export function isParameterless(item) {
+    const c = item.command;
+    if (/[.]/.test(c.split(" ")[0] ?? ""))
+        return false; // mneme.x.y MCP tool, not a shell verb
+    if (/[<\[]/.test(c))
+        return false; // has <arg> / [opt]
+    return /^mneme\s+\S/.test(c); // a real `mneme <verb...>` shell command
+}
+/** The shell argv (after "mneme") for a parameterless command. */
+export function shellArgsFor(item) {
+    return item.command.replace(/^mneme\s+/, "").trim().split(/\s+/).filter(Boolean);
+}
+//# sourceMappingURL=tui_core.js.map

package/dist/ui/tui_core.js.map

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

package/dist/ui/tui_render.d.ts

@@ -0,0 +1,11 @@
+/**
+ * v2.77.0 — INTERACTIVE TUI renderer (pure: state → lines). No terminal needed
+ * to test layout; the driver just joins these lines + paints the screen.
+ */
+import type { UiState } from "./tui_core.js";
+/** Visible width ignoring ANSI (good enough for our ASCII + a few emoji). */
+export declare function stripAnsi(s: string): string;
+export declare function truncate(s: string, width: number): string;
+/** Render the whole frame as an array of lines (each padded to `cols`). */
+export declare function renderFrame(state: UiState, cols: number, rows: number, version?: string): string[];
+//# sourceMappingURL=tui_render.d.ts.map

package/dist/ui/tui_render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tui_render.d.ts","sourceRoot":"","sources":["../../src/ui/tui_render.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAW,MAAM,eAAe,CAAC;AAUtD,6EAA6E;AAC7E,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAA6C;AAEzF,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAIzD;AAeD,2EAA2E;AAC3E,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,SAAM,GAAG,MAAM,EAAE,CA2C/F"}

package/dist/ui/tui_render.js

@@ -0,0 +1,107 @@
+/**
+ * v2.77.0 — INTERACTIVE TUI renderer (pure: state → lines). No terminal needed
+ * to test layout; the driver just joins these lines + paints the screen.
+ */
+import { isParameterless } from "./tui_core.js";
+const ESC = "\x1b[";
+const INV = `${ESC}7m`; // inverse (selected row)
+const DIM = `${ESC}2m`;
+const BOLD = `${ESC}1m`;
+const CYAN = `${ESC}36m`;
+const RST = `${ESC}0m`;
+/** Visible width ignoring ANSI (good enough for our ASCII + a few emoji). */
+export function stripAnsi(s) { return s.replace(/\x1b\[[0-9;]*m/g, ""); }
+export function truncate(s, width) {
+    const plain = stripAnsi(s);
+    if (plain.length <= width)
+        return s + " ".repeat(Math.max(0, width - plain.length));
+    return plain.slice(0, Math.max(0, width - 1)) + "…";
+}
+function wrap(s, width, maxLines) {
+    const words = s.split(/\s+/);
+    const lines = [];
+    let cur = "";
+    for (const w of words) {
+        if ((cur + (cur ? " " : "") + w).length > width) {
+            if (cur)
+                lines.push(cur);
+            cur = w;
+        }
+        else
+            cur += (cur ? " " : "") + w;
+        if (lines.length >= maxLines)
+            break;
+    }
+    if (cur && lines.length < maxLines)
+        lines.push(cur);
+    return lines.slice(0, maxLines);
+}
+/** Render the whole frame as an array of lines (each padded to `cols`). */
+export function renderFrame(state, cols, rows, version = "?") {
+    const W = Math.max(40, cols);
+    if (state.mode === "output")
+        return renderOutput(state, W, rows);
+    const lines = [];
+    // 0 — title
+    lines.push(truncate(`${BOLD}${CYAN}⏳ Mneme${RST}${DIM} — interactive · type to search · ↑↓ move · Enter run · Esc clear/quit${RST}  ${DIM}v${version}${RST}`, W));
+    // 1 — search box
+    const count = `${DIM}(${state.filtered.length}/${state.all.length})${RST}`;
+    lines.push(truncate(`${BOLD}🔎 ${RST}${state.query}${BOLD}▏${RST} ${count}`, W));
+    lines.push(truncate(`${DIM}${"─".repeat(W)}${RST}`, W));
+    // list window
+    const win = state.filtered.slice(state.scrollTop, state.scrollTop + state.listRows);
+    if (win.length === 0) {
+        lines.push(truncate(`${DIM}  no capability matches “${state.query}” — try fewer / different words${RST}`, W));
+        for (let i = 1; i < state.listRows; i++)
+            lines.push(" ".repeat(W));
+    }
+    else {
+        for (let i = 0; i < state.listRows; i++) {
+            const item = win[i];
+            if (!item) {
+                lines.push(" ".repeat(W));
+                continue;
+            }
+            const isSel = state.scrollTop + i === state.selected;
+            const tag = `${DIM}[${item.group}]${RST}`;
+            const body = `${isSel ? "▶ " : "  "}${item.command}`;
+            const row = truncate(`${body}  ${tag}`, W);
+            lines.push(isSel ? `${INV}${truncate(body + "  [" + item.group + "]", W)}${RST}` : row);
+        }
+    }
+    // detail pane for the selected item
+    lines.push(truncate(`${DIM}${"─".repeat(W)}${RST}`, W));
+    const sel = state.filtered[state.selected];
+    if (sel) {
+        lines.push(truncate(`${BOLD}${sel.command}${RST} ${DIM}· ${sel.group} · since ${sel.since}${RST}`, W));
+        for (const l of wrap(sel.what, W - 2, 3))
+            lines.push(truncate("  " + l, W));
+        if (sel.when)
+            for (const l of wrap(`when: ${sel.when}`, W - 2, 2))
+                lines.push(truncate(`  ${DIM}${l}${RST}`, W));
+        lines.push(truncate(runHint(sel), W));
+    }
+    // footer
+    lines.push(truncate(`${DIM}${"─".repeat(W)}${RST}`, W));
+    lines.push(truncate(`${DIM}↑↓ navigate · PgUp/PgDn · type to search · Enter ${isParameterless(sel ?? {}) ? "run" : "show usage"} · Esc clear/quit${RST}`, W));
+    return lines;
+}
+function runHint(item) {
+    if (isParameterless(item))
+        return `  ${CYAN}↵ Enter${RST}${DIM} runs this now${RST}`;
+    if (/^[a-z_]+\.[a-z_]/i.test(item.command.split(" ")[0] ?? ""))
+        return `  ${DIM}MCP tool — call from your AI agent: ${item.command}${RST}`;
+    return `  ${DIM}needs arguments — run: ${item.command}${RST}`;
+}
+function renderOutput(state, W, rows) {
+    const lines = [];
+    lines.push(truncate(`${BOLD}${CYAN}▶ ${state.outputTitle ?? "output"}${RST}`, W));
+    lines.push(truncate(`${DIM}${"─".repeat(W)}${RST}`, W));
+    const body = (state.output ?? "").split(/\r?\n/);
+    const max = Math.max(3, rows - 4);
+    for (let i = 0; i < max; i++)
+        lines.push(truncate(body[i] ?? "", W));
+    lines.push(truncate(`${DIM}— press any key to return to the menu —${RST}`, W));
+    return lines;
+}
+//# sourceMappingURL=tui_render.js.map

package/dist/ui/tui_render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tui_render.js","sourceRoot":"","sources":["../../src/ui/tui_render.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD,MAAM,GAAG,GAAG,OAAO,CAAC;AACpB,MAAM,GAAG,GAAG,GAAG,GAAG,IAAI,CAAC,CAAK,yBAAyB;AACrD,MAAM,GAAG,GAAG,GAAG,GAAG,IAAI,CAAC;AACvB,MAAM,IAAI,GAAG,GAAG,GAAG,IAAI,CAAC;AACxB,MAAM,IAAI,GAAG,GAAG,GAAG,KAAK,CAAC;AACzB,MAAM,GAAG,GAAG,GAAG,GAAG,IAAI,CAAC;AAEvB,6EAA6E;AAC7E,MAAM,UAAU,SAAS,CAAC,CAAS,IAAY,OAAO,CAAC,CAAC,OAAO,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;AAEzF,MAAM,UAAU,QAAQ,CAAC,CAAS,EAAE,KAAa;IAC/C,MAAM,KAAK,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;IAC3B,IAAI,KAAK,CAAC,MAAM,IAAI,KAAK;QAAE,OAAO,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IACpF,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC;AACtD,CAAC;AAED,SAAS,IAAI,CAAC,CAAS,EAAE,KAAa,EAAE,QAAgB;IACtD,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC7B,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,IAAI,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,GAAG,KAAK,EAAE,CAAC;YAAC,IAAI,GAAG;gBAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAAC,GAAG,GAAG,CAAC,CAAC;QAAC,CAAC;;YAClF,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,KAAK,CAAC,MAAM,IAAI,QAAQ;YAAE,MAAM;IACtC,CAAC;IACD,IAAI,GAAG,IAAI,KAAK,CAAC,MAAM,GAAG,QAAQ;QAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACpD,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;AAClC,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,WAAW,CAAC,KAAc,EAAE,IAAY,EAAE,IAAY,EAAE,OAAO,GAAG,GAAG;IACnF,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;IAC7B,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,YAAY,CAAC,KAAK,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC;IAEjE,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,YAAY;IACZ,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,IAAI,GAAG,IAAI,UAAU,GAAG,GAAG,GAAG,yEAAyE,GAAG,KAAK,GAAG,IAAI,OAAO,GAAG,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;IAClK,iBAAiB;IACjB,MAAM,KAAK,GAAG,GAAG,GAAG,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,MAAM,IAAI,GAAG,EAAE,CAAC;IAC3E,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,IAAI,MAAM,GAAG,GAAG,KAAK,CAAC,KAAK,GAAG,IAAI,IAAI,GAAG,IAAI,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;IACjF,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;IAExD,cAAc;IACd,MAAM,GAAG,GAAG,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,SAAS,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC;IACpF,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrB,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,GAAG,4BAA4B,KAAK,CAAC,KAAK,kCAAkC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;QAC9G,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC,EAAE;YAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IACrE,CAAC;SAAM,CAAC;QACN,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC,EAAE,EAAE,CAAC;YACxC,MAAM,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;YACpB,IAAI,CAAC,IAAI,EAAE,CAAC;gBAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;gBAAC,SAAS;YAAC,CAAC;YACnD,MAAM,KAAK,GAAG,KAAK,CAAC,SAAS,GAAG,CAAC,KAAK,KAAK,CAAC,QAAQ,CAAC;YACrD,MAAM,GAAG,GAAG,GAAG,GAAG,IAAI,IAAI,CAAC,KAAK,IAAI,GAAG,EAAE,CAAC;YAC1C,MAAM,IAAI,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;YACrD,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,IAAI,KAAK,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC;YAC3C,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,QAAQ,CAAC,IAAI,GAAG,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG,GAAG,EAAE,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QAC1F,CAAC;IACH,CAAC;IAED,oCAAoC;IACpC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;IACxD,MAAM,GAAG,GAAG,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC3C,IAAI,GAAG,EAAE,CAAC;QACR,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,IAAI,GAAG,GAAG,CAAC,OAAO,GAAG,GAAG,IAAI,GAAG,KAAK,GAAG,CAAC,KAAK,YAAY,GAAG,CAAC,KAAK,GAAG,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;QACvG,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAC5E,IAAI,GAAG,CAAC,IAAI;YAAE,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,SAAS,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,GAAG,GAAG,CAAC,GAAG,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;QACjH,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACxC,CAAC;IAED,SAAS;IACT,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;IACxD,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,GAAG,oDAAoD,eAAe,CAAC,GAAG,IAAK,EAAc,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,oBAAoB,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;IAC3K,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,OAAO,CAAC,IAAa;IAC5B,IAAI,eAAe,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,IAAI,UAAU,GAAG,GAAG,GAAG,iBAAiB,GAAG,EAAE,CAAC;IACrF,IAAI,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAAE,OAAO,KAAK,GAAG,uCAAuC,IAAI,CAAC,OAAO,GAAG,GAAG,EAAE,CAAC;IAC3I,OAAO,KAAK,GAAG,0BAA0B,IAAI,CAAC,OAAO,GAAG,GAAG,EAAE,CAAC;AAChE,CAAC;AAED,SAAS,YAAY,CAAC,KAAc,EAAE,CAAS,EAAE,IAAY;IAC3D,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,IAAI,GAAG,IAAI,KAAK,KAAK,CAAC,WAAW,IAAI,QAAQ,GAAG,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;IAClF,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;IACxD,MAAM,IAAI,GAAG,CAAC,KAAK,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACjD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,GAAG,CAAC,CAAC,CAAC;IAClC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,EAAE;QAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;IACrE,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,GAAG,0CAA0C,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;IAC/E,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/util/json_arg.d.ts

@@ -0,0 +1,31 @@
+/**
+ * v2.76.0 — Windows-tolerant `--json` argument parser.
+ *
+ * THE BUG. `mneme <family> <action> --json '{"a":1}'` works in bash, but on
+ * Windows the user shells through cmd.exe, which:
+ *   • does NOT treat single quotes as quoting → the arg arrives as the literal
+ *     string `'{"a":1}'` (surrounding single quotes included) → JSON.parse fails;
+ *   • can strip the inner double quotes from `--json "{\"a\":1}"` → `{a:1}`.
+ * Either way, programmatic integration on Windows was painful (the only reliable
+ * path was `node <binpath> ... ` with shell:false). This helper makes the raw
+ * `--json` value robust by trying, in order:
+ *   0. JSON.parse as-is
+ *   1. strip ONE layer of surrounding matching quotes cmd left literal (' " `)
+ *   2. JSON5-lite repair: single-quoted strings → double-quoted; bare
+ *      identifier keys → quoted (handles cmd that dropped the inner quotes)
+ *
+ * Pure + dependency-free. Never throws — returns a structured result so the
+ * caller can print a helpful hint (use a file / stdin) on total failure.
+ */
+export interface JsonArgOk {
+    ok: true;
+    value: unknown;
+    repaired: boolean;
+}
+export interface JsonArgErr {
+    ok: false;
+    error: string;
+}
+export type JsonArgResult = JsonArgOk | JsonArgErr;
+export declare function parseJsonArg(raw: unknown): JsonArgResult;
+//# sourceMappingURL=json_arg.d.ts.map

package/dist/util/json_arg.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json_arg.d.ts","sourceRoot":"","sources":["../../src/util/json_arg.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,MAAM,WAAW,SAAS;IAAG,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAC;CAAE;AAC3E,MAAM,WAAW,UAAU;IAAG,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;CAAE;AACzD,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,UAAU,CAAC;AAiBnD,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,aAAa,CA0BxD"}

package/dist/util/json_arg.js

@@ -0,0 +1,66 @@
+/**
+ * v2.76.0 — Windows-tolerant `--json` argument parser.
+ *
+ * THE BUG. `mneme <family> <action> --json '{"a":1}'` works in bash, but on
+ * Windows the user shells through cmd.exe, which:
+ *   • does NOT treat single quotes as quoting → the arg arrives as the literal
+ *     string `'{"a":1}'` (surrounding single quotes included) → JSON.parse fails;
+ *   • can strip the inner double quotes from `--json "{\"a\":1}"` → `{a:1}`.
+ * Either way, programmatic integration on Windows was painful (the only reliable
+ * path was `node <binpath> ... ` with shell:false). This helper makes the raw
+ * `--json` value robust by trying, in order:
+ *   0. JSON.parse as-is
+ *   1. strip ONE layer of surrounding matching quotes cmd left literal (' " `)
+ *   2. JSON5-lite repair: single-quoted strings → double-quoted; bare
+ *      identifier keys → quoted (handles cmd that dropped the inner quotes)
+ *
+ * Pure + dependency-free. Never throws — returns a structured result so the
+ * caller can print a helpful hint (use a file / stdin) on total failure.
+ */
+function tryParse(s) {
+    try {
+        return JSON.parse(s);
+    }
+    catch {
+        return undefined;
+    }
+}
+/** JSON5-lite: convert single-quoted strings to double-quoted + quote bare keys.
+ *  Best-effort string surgery for cmd-mangled JSON; only used as a last resort
+ *  after strict parses fail, so it can never corrupt already-valid JSON. */
+function repair(s) {
+    return s
+        // 'value' / 'key'  →  "value" / "key"   (single-quoted tokens with no escapes)
+        .replace(/'([^'\\]*)'/g, '"$1"')
+        // {key:  ,key:  →  {"key":  ,"key":   (bare identifier keys)
+        .replace(/([{,]\s*)([A-Za-z_$][\w$]*)\s*:/g, '$1"$2":');
+}
+export function parseJsonArg(raw) {
+    if (typeof raw !== "string")
+        return { ok: false, error: "value is not a string" };
+    let s = raw.trim();
+    if (s.length === 0)
+        return { ok: false, error: "empty --json value" };
+    // 0. strict, as-is.
+    let v = tryParse(s);
+    if (v !== undefined)
+        return { ok: true, value: v, repaired: false };
+    // 1. strip ONE layer of surrounding matching quotes (the cmd.exe single-quote case).
+    const q = s[0];
+    if ((q === "'" || q === '"' || q === "`") && s[s.length - 1] === q && s.length >= 2) {
+        const inner = s.slice(1, -1);
+        v = tryParse(inner);
+        if (v !== undefined)
+            return { ok: true, value: v, repaired: true };
+        s = inner; // keep the unwrapped form for the repair pass
+    }
+    // 2. JSON5-lite repair (single-quoted / unquoted-key JSON).
+    v = tryParse(repair(s));
+    if (v !== undefined)
+        return { ok: true, value: v, repaired: true };
+    return {
+        ok: false,
+        error: "could not parse --json (even after Windows-shell quote repair). On cmd.exe, prefer the explicit --<field> flags, or pass the payload via a file/stdin.",
+    };
+}
+//# sourceMappingURL=json_arg.js.map

package/dist/util/json_arg.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json_arg.js","sourceRoot":"","sources":["../../src/util/json_arg.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAMH,SAAS,QAAQ,CAAC,CAAS;IACzB,IAAI,CAAC;QAAC,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,SAAS,CAAC;IAAC,CAAC;AAC3D,CAAC;AAED;;4EAE4E;AAC5E,SAAS,MAAM,CAAC,CAAS;IACvB,OAAO,CAAC;QACN,+EAA+E;SAC9E,OAAO,CAAC,cAAc,EAAE,MAAM,CAAC;QAChC,6DAA6D;SAC5D,OAAO,CAAC,kCAAkC,EAAE,SAAS,CAAC,CAAC;AAC5D,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,GAAY;IACvC,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,uBAAuB,EAAE,CAAC;IAClF,IAAI,CAAC,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IACnB,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,oBAAoB,EAAE,CAAC;IAEtE,oBAAoB;IACpB,IAAI,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IACpB,IAAI,CAAC,KAAK,SAAS;QAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;IAEpE,qFAAqF;IACrF,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACf,IAAI,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;QACpF,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAC7B,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;QACpB,IAAI,CAAC,KAAK,SAAS;YAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QACnE,CAAC,GAAG,KAAK,CAAC,CAAC,8CAA8C;IAC3D,CAAC;IAED,4DAA4D;IAC5D,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IACxB,IAAI,CAAC,KAAK,SAAS;QAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAEnE,OAAO;QACL,EAAE,EAAE,KAAK;QACT,KAAK,EAAE,wJAAwJ;KAChK,CAAC;AACJ,CAAC"}