mneme-ai 2.76.0 → 2.77.0

package/dist/commands/ui.d.ts

@@ -0,0 +1,16 @@
+/**
+ * v2.77.0 — `mneme ui` : full-screen, arrow-key interactive TUI.
+ *
+ * Zero-dependency (raw-mode stdin + ANSI), on-brand with Mneme's local-first
+ * ethos. Type plain language → the right capability surfaces; ↑↓ to navigate;
+ * Enter runs a parameterless command live (or shows how to run a parameterized
+ * one); Esc clears the query then quits. New tools appear automatically because
+ * the list IS the live MNEME_COMMAND_CATALOG. All UI LOGIC is pure + tested in
+ * src/ui/tui_core.ts; this file is just the terminal driver.
+ */
+export interface UiOptions {
+    cwd: string;
+    version?: string;
+}
+export declare function uiCommand(opts: UiOptions): Promise<void>;
+//# sourceMappingURL=ui.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ui.d.ts","sourceRoot":"","sources":["../../src/commands/ui.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAOH,MAAM,WAAW,SAAS;IAAG,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAAE;AAa7D,wBAAsB,SAAS,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAqF9D"}

package/dist/commands/ui.js

@@ -0,0 +1,114 @@
+/**
+ * v2.77.0 — `mneme ui` : full-screen, arrow-key interactive TUI.
+ *
+ * Zero-dependency (raw-mode stdin + ANSI), on-brand with Mneme's local-first
+ * ethos. Type plain language → the right capability surfaces; ↑↓ to navigate;
+ * Enter runs a parameterless command live (or shows how to run a parameterized
+ * one); Esc clears the query then quits. New tools appear automatically because
+ * the list IS the live MNEME_COMMAND_CATALOG. All UI LOGIC is pure + tested in
+ * src/ui/tui_core.ts; this file is just the terminal driver.
+ */
+import * as readline from "node:readline";
+import { spawnSync } from "node:child_process";
+import { initState, reduce, isParameterless, shellArgsFor, loadCatalog } from "../ui/tui_core.js";
+import { renderFrame, stripAnsi } from "../ui/tui_render.js";
+const ALT_ON = "\x1b[?1049h\x1b[?25l"; // enter alt-screen + hide cursor
+const ALT_OFF = "\x1b[?25h\x1b[?1049l"; // show cursor + leave alt-screen
+const HOME_CLEAR = "\x1b[H\x1b[2J";
+async function loadItems() {
+    try {
+        const core = await import("@mneme-ai/core");
+        return loadCatalog(core.agentManifest?.MNEME_COMMAND_CATALOG ?? []);
+    }
+    catch {
+        return [];
+    }
+}
+export async function uiCommand(opts) {
+    const items = await loadItems();
+    // Non-interactive fallback — a TUI needs a real TTY. Print a useful pointer
+    // instead of corrupting a pipe / CI log.
+    if (!process.stdout.isTTY || !process.stdin.isTTY || items.length === 0) {
+        process.stdout.write(items.length === 0
+            ? "mneme ui: capability catalog unavailable.\n"
+            : "mneme ui needs an interactive terminal (TTY).\n  • Run it in a real shell, or\n  • use `mneme atlas` (static capability map) / `mneme <command> --help`.\n");
+        return;
+    }
+    const rows = process.stdout.rows || 24;
+    const cols = process.stdout.columns || 80;
+    // Reserve ~9 rows for title/search/separators/detail/footer; rest is the list.
+    let state = initState(items, Math.max(3, rows - 12));
+    const paint = () => {
+        const r = process.stdout.rows || 24;
+        const c = process.stdout.columns || 80;
+        if (state.mode === "browse")
+            state = { ...state, listRows: Math.max(3, r - 12) };
+        const frame = renderFrame(state, c, r, opts.version ?? "?");
+        process.stdout.write(HOME_CLEAR + frame.join("\n"));
+    };
+    const cleanup = () => {
+        try {
+            process.stdin.setRawMode?.(false);
+        }
+        catch { /* */ }
+        process.stdin.pause();
+        process.stdout.write(ALT_OFF);
+    };
+    // Run a parameterless `mneme <verb>` live; capture output into the pane.
+    const runItem = (item) => {
+        if (!isParameterless(item)) {
+            state = { ...state, mode: "output", outputTitle: `${item.command}  (needs arguments)`, output: `This capability takes arguments, so it can't be run blind from the menu.\n\n` +
+                    `Run it yourself:\n   ${item.command}\n\n` +
+                    (item.when ? `When to use:\n   ${item.when}\n` : ""),
+            };
+            paint();
+            return;
+        }
+        const args = shellArgsFor(item);
+        process.stdout.write(HOME_CLEAR + `\x1b[1m▶ running:\x1b[0m mneme ${args.join(" ")}\n\n(please wait…)`);
+        const r = spawnSync(process.execPath, [process.argv[1], ...args], {
+            cwd: opts.cwd,
+            encoding: "utf8",
+            timeout: 60000,
+            env: { ...process.env, MNEME_WARMCALL: "0", NO_COLOR: "1" }, // fresh + clean text in the pane
+        });
+        const out = [r.stdout, r.stderr].filter(Boolean).join("\n").trim();
+        state = { ...state, mode: "output", outputTitle: `mneme ${args.join(" ")}  ${r.status === 0 ? "✓" : `(exit ${r.status ?? "?"})`}`,
+            output: stripAnsi(out || "(no output)") };
+        paint();
+    };
+    return new Promise((resolve) => {
+        process.stdout.write(ALT_ON);
+        readline.emitKeypressEvents(process.stdin);
+        try {
+            process.stdin.setRawMode?.(true);
+        }
+        catch { /* some terminals */ }
+        process.stdin.resume();
+        paint();
+        const onResize = () => paint();
+        process.stdout.on("resize", onResize);
+        const finish = () => {
+            process.stdin.removeListener("keypress", onKey);
+            process.stdout.removeListener("resize", onResize);
+            cleanup();
+            resolve();
+        };
+        const onKey = (_str, key) => {
+            const k = { name: key?.name, ctrl: !!key?.ctrl, sequence: key?.sequence };
+            const { state: next, action } = reduce(state, k);
+            state = next;
+            if (action.type === "quit") {
+                finish();
+                return;
+            }
+            if (action.type === "run") {
+                runItem(action.item);
+                return;
+            }
+            paint();
+        };
+        process.stdin.on("keypress", onKey);
+    });
+}
+//# sourceMappingURL=ui.js.map

package/dist/commands/ui.js.map

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

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAuIA,wBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAixMvD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAuIA,wBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAwyMvD"}

package/dist/index.js

@@ -114,6 +114,18 @@ export async function run(argv) {
         }
         catch { /* fall through to commander on failure */ }
     }
+    // v2.77.0 — INTERACTIVE-BY-DEFAULT. Bare `mneme` in a real terminal launches
+    // the full-screen TUI (type plain language → run any capability, zero
+    // memorization). Non-TTY (pipes / CI / scripts) keep the classic behavior, so
+    // nothing automated breaks. `MNEME_NO_UI=1` opts out.
+    if (slice.length === 0 && process.stdout.isTTY && process.stdin.isTTY && process.env["MNEME_NO_UI"] !== "1") {
+        try {
+            const { uiCommand } = await import("./commands/ui.js");
+            await uiCommand({ cwd: process.cwd(), version: getVersion() });
+            return;
+        }
+        catch { /* fall through to commander default on any failure */ }
+    }
     const program = new Command()
         .name("mneme")
         .description("μνήμη — the memory layer of your codebase. Knows the WHY, the WHAT, the WHERE-IT-BREAKS.")
@@ -4144,6 +4156,16 @@ export async function run(argv) {
     // command / 14k token blast-radius without deleting any command.
     // Default `mneme --help` still works (backward compat); AI agents
     // are told to use these layered surfaces instead.
+    // v2.77.0 — INTERACTIVE TUI. Type plain language → the right capability
+    // surfaces; ↑↓ navigate every command; Enter runs it. Zero memorization.
+    program
+        .command("ui")
+        .aliases(["menu", "tui"])
+        .description("🖥  Interactive full-screen menu — type plain language to search every capability, ↑↓ to navigate, Enter to run. Zero command memorization. (Needs a real terminal.)")
+        .action(async () => {
+        const { uiCommand } = await import("./commands/ui.js");
+        await uiCommand({ cwd: process.cwd(), version: getVersion() });
+    });
     program
         .command("atlas")
         .description("🗺  ATLAS HELP — six-layer discovery (TASTE · BLOOM · HOT · TAGS · INTENT · FULL). AI agents read 200 bytes here instead of 14 KB from --help.")