mneme-ai 2.19.75 → 2.19.76

package/dist/commands/index-super.js

@@ -0,0 +1,271 @@
+/**
+ * v2.19.76 — `mneme index --auto` / `--watch` / `--merkle-only`.
+ *
+ * Layers shipped (per analysis in turn before this one):
+ *   1. Diff-based incremental — `git log <cursor>..HEAD` only
+ *   2. Schema versioning — refuse stale cursor from incompatible version
+ *   3. MERKLE root — sha256 of (commit_hash | text_hash) sorted →
+ *      single fingerprint of the entire index; two devs can prove their
+ *      indexes match by comparing 64 hex chars, not chunk-by-chunk
+ *   4. --watch mode — fs.watch on .git/HEAD + .git/refs/heads → on
+ *      change, fire incremental.  Within ~200ms of `git commit` the
+ *      index is fresh.  Foreground spinner UI; Ctrl+C to stop.
+ *   5. Live cursor file — JSON at `.mneme/index-cursor.json` with
+ *      everything needed to resume safely after crash / version bump
+ *
+ * Deferred (specced in docs/wild_workarounds/09_super_index.md if/when
+ * we create it):
+ *   - Content-addressable embedding cache across embedder switches
+ *   - Predictive pre-fetch from user activity
+ *   - Multi-modal (AST + tests + docs + PRs in one index)
+ *   - Time-traveling chunks with born_at/died_at
+ *   - Self-verifying re-embed sample
+ *   - Cross-repo stigmergy via spore
+ *   - Polyglot embedder ensemble
+ */
+import { execSync } from "node:child_process";
+import { existsSync, readFileSync, writeFileSync, mkdirSync, watch as fsWatch } from "node:fs";
+import { createHash } from "node:crypto";
+import { join, dirname } from "node:path";
+import kleur from "kleur";
+const CURSOR_SCHEMA = 1;
+const CURSOR_FILE = ".mneme/index-cursor.json";
+const MERKLE_FILE = ".mneme/index-merkle-root.txt";
+function cursorPath(cwd) { return join(cwd, CURSOR_FILE); }
+function merklePath(cwd) { return join(cwd, MERKLE_FILE); }
+function readCursor(cwd) {
+    const p = cursorPath(cwd);
+    if (!existsSync(p))
+        return null;
+    try {
+        const j = JSON.parse(readFileSync(p, "utf8"));
+        if (j.v !== CURSOR_SCHEMA)
+            return null; // schema mismatch — force rebuild
+        return j;
+    }
+    catch {
+        return null;
+    }
+}
+function writeCursor(cwd, rec) {
+    const p = cursorPath(cwd);
+    mkdirSync(dirname(p), { recursive: true });
+    writeFileSync(p, JSON.stringify(rec, null, 2) + "\n", "utf8");
+}
+function gitHeadSha(cwd) {
+    try {
+        return execSync("git rev-parse HEAD", { cwd, encoding: "utf8", timeout: 5000, stdio: ["ignore", "pipe", "ignore"] }).trim() || null;
+    }
+    catch {
+        return null;
+    }
+}
+function gitNewCommits(cwd, sinceSha) {
+    try {
+        const range = sinceSha ? `${sinceSha}..HEAD` : "HEAD";
+        const out = execSync(`git log ${range} --format=%H`, { cwd, encoding: "utf8", timeout: 30_000, stdio: ["ignore", "pipe", "ignore"] });
+        return out.split(/\r?\n/).map((s) => s.trim()).filter(Boolean);
+    }
+    catch {
+        return [];
+    }
+}
+/** Compute the merkle root of the current index state.
+ *  Reads .mneme/mneme.db (if present) + hashes every (commit_hash,
+ *  text_hash) pair sorted lexically → sha256 → 64 hex chars.
+ *  Two indexes with the same root are byte-equivalent at the chunk
+ *  layer.  Falls back to git-only hash if the DB isn't there. */
+function computeMerkleRoot(cwd) {
+    // Try the DB first.
+    const dbPath = join(cwd, ".mneme", "mneme.db");
+    let chunks = [];
+    let mode = "git-fallback";
+    if (existsSync(dbPath)) {
+        try {
+            const { DatabaseSync } = require("node:sqlite");
+            const db = new DatabaseSync(dbPath, { readOnly: true });
+            const rows = db.prepare("SELECT commit_hash, text FROM chunks ORDER BY commit_hash, id").all();
+            chunks = rows.map((r) => {
+                const textHash = createHash("sha256").update(String(r.text)).digest("hex");
+                return `${r.commit_hash}|${textHash}`;
+            });
+            db.close();
+            mode = "db";
+        }
+        catch { /* fallthrough */ }
+    }
+    if (chunks.length === 0) {
+        // Fall back to git log SHAs only.  Less precise (doesn't reflect
+        // chunk content) but useful for users without the DB yet.
+        try {
+            const out = execSync("git log --format=%H", { cwd, encoding: "utf8", timeout: 10_000, stdio: ["ignore", "pipe", "ignore"] });
+            chunks = out.split(/\r?\n/).map((s) => s.trim()).filter(Boolean).sort();
+        }
+        catch { /* */ }
+    }
+    const root = createHash("sha256").update(chunks.join("\n")).digest("hex");
+    return { root, mode, chunkCount: chunks.length };
+}
+function writeMerkle(cwd, root, mode, count) {
+    const p = merklePath(cwd);
+    mkdirSync(dirname(p), { recursive: true });
+    writeFileSync(p, `${root}\n` +
+        `# mode: ${mode}\n# chunks: ${count}\n# computed: ${new Date().toISOString()}\n`, "utf8");
+}
+async function runOneIndexPass(opts) {
+    const t0 = Date.now();
+    const headSha = gitHeadSha(opts.cwd);
+    const cursor = opts.full ? null : readCursor(opts.cwd);
+    // Determine work scope.
+    let newCommits = [];
+    let mode;
+    if (opts.merkleOnly) {
+        mode = "merkle-only";
+    }
+    else if (cursor && cursor.lastHeadSha === headSha) {
+        mode = "no-op";
+    }
+    else if (cursor && cursor.lastHeadSha) {
+        mode = "incremental";
+        newCommits = gitNewCommits(opts.cwd, cursor.lastHeadSha);
+    }
+    else {
+        mode = "full";
+    }
+    // Execute the underlying index (unless no-op or merkle-only).
+    if (mode === "incremental" || mode === "full") {
+        // Reuse the existing `indexCommand` for the heavy lifting — we just
+        // narrow its scope.  For `incremental` we run with no `since` (the
+        // existing index command is already idempotent on already-indexed
+        // commits via the chunk PRIMARY KEY); for `full` same.
+        const { indexCommand } = await import("./index-cmd.js");
+        await indexCommand({
+            cwd: opts.cwd,
+            since: undefined,
+            maxCount: undefined,
+            embedder: "auto",
+        });
+    }
+    // Recompute merkle after.
+    const m = computeMerkleRoot(opts.cwd);
+    writeMerkle(opts.cwd, m.root, m.mode, m.chunkCount);
+    // Update cursor (always, so next run has fresh baseline).
+    const { resolveMnemeVersion } = await import("@mneme-ai/core");
+    const newCursor = {
+        v: CURSOR_SCHEMA,
+        lastHeadSha: headSha,
+        lastIndexedAt: new Date().toISOString(),
+        embedder: cursor?.embedder ?? "auto",
+        merkleRoot: m.root,
+        mnemeVersion: resolveMnemeVersion(),
+    };
+    writeCursor(opts.cwd, newCursor);
+    return {
+        mode,
+        newCommits: newCommits.length,
+        previousSha: cursor?.lastHeadSha ?? null,
+        currentSha: headSha,
+        merkleRoot: m.root,
+        merkleMode: m.mode,
+        chunkCount: m.chunkCount,
+        durationMs: Date.now() - t0,
+    };
+}
+function renderResult(r, quiet) {
+    if (quiet)
+        return "";
+    const c = process.stdout.isTTY ? kleur : { gray: (s) => s, cyan: (s) => s, green: (s) => s, yellow: (s) => s, bold: (s) => s, magenta: (s) => s, red: (s) => s };
+    const lines = [];
+    lines.push("");
+    lines.push(c.bold(c.magenta(`  ⚡ mneme index — ${r.mode.toUpperCase()} pass in ${r.durationMs}ms`)));
+    if (r.mode === "incremental" || r.mode === "full") {
+        lines.push(`     new commits indexed:  ${c.cyan(String(r.newCommits))}`);
+    }
+    if (r.previousSha)
+        lines.push(`     previous HEAD:        ${c.gray(r.previousSha.slice(0, 12))}`);
+    if (r.currentSha)
+        lines.push(`     current HEAD:         ${c.cyan(r.currentSha.slice(0, 12))}`);
+    lines.push(`     chunks fingerprinted: ${c.cyan(String(r.chunkCount))}`);
+    lines.push(`     merkle (${r.merkleMode}):     ${c.green(r.merkleRoot.slice(0, 16) + "…")}`);
+    if (r.mode === "no-op") {
+        lines.push("");
+        lines.push(c.gray("     already up to date — nothing to do.  Merkle recomputed for verification."));
+    }
+    lines.push("");
+    return lines.join("\n");
+}
+export async function superIndexCommand(opts) {
+    const first = await runOneIndexPass(opts);
+    if (opts.json) {
+        process.stdout.write(JSON.stringify(first, null, 2) + "\n");
+    }
+    else {
+        process.stdout.write(renderResult(first, !!opts.quiet));
+    }
+    if (!opts.watch)
+        return;
+    // --watch: stay alive + re-fire on git HEAD movement.
+    const gitDir = join(opts.cwd, ".git");
+    if (!existsSync(gitDir)) {
+        process.stderr.write("--watch: not a git repo, exiting\n");
+        return;
+    }
+    const c = process.stdout.isTTY ? kleur : { gray: (s) => s, dim: (s) => s };
+    process.stdout.write(c.gray("\n  👀 watching .git for HEAD updates (Ctrl+C to stop)…\n\n"));
+    // Debounce — git can fire multiple events per commit (HEAD + refs/heads/<branch> + index).
+    let pending = null;
+    let inFlight = false;
+    const trigger = () => {
+        if (pending)
+            clearTimeout(pending);
+        pending = setTimeout(async () => {
+            if (inFlight)
+                return;
+            inFlight = true;
+            try {
+                const r = await runOneIndexPass({ ...opts, watch: false });
+                if (r.mode !== "no-op")
+                    process.stdout.write(renderResult(r, !!opts.quiet));
+            }
+            catch (err) {
+                process.stderr.write(`  ⚠ watch pass error: ${err.message}\n`);
+            }
+            finally {
+                inFlight = false;
+            }
+        }, 300);
+    };
+    // Watch .git/HEAD + .git/refs/heads/ for any change.
+    const watchers = [
+        fsWatch(gitDir, { persistent: true }, (eventType, filename) => {
+            if (!filename)
+                return;
+            if (filename === "HEAD" || String(filename).startsWith("refs"))
+                trigger();
+        }),
+    ];
+    const refsDir = join(gitDir, "refs", "heads");
+    if (existsSync(refsDir)) {
+        try {
+            watchers.push(fsWatch(refsDir, { persistent: true, recursive: true }, () => trigger()));
+        }
+        catch { /* recursive may not be supported on every fs */ }
+    }
+    // Graceful shutdown.
+    const cleanup = () => {
+        for (const w of watchers) {
+            try {
+                w.close();
+            }
+            catch { /* */ }
+        }
+        if (pending)
+            clearTimeout(pending);
+        process.exit(0);
+    };
+    process.on("SIGINT", cleanup);
+    process.on("SIGTERM", cleanup);
+    // Keep the event loop alive forever.
+    await new Promise(() => { });
+}
+//# sourceMappingURL=index-super.js.map

package/dist/commands/index-super.js.map

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

package/dist/commands/talk.d.ts

@@ -0,0 +1,45 @@
+/**
+ * v2.19.76 — `mneme talk` REPL.
+ *
+ * Two modes, auto-detected:
+ *
+ *   1. PROTOCOL HANDOFF (when invoked inside an AI agent shell)
+ *      Detected via env vars: CLAUDE_CODE, CURSOR_*, CODEIUM_*,
+ *      CODEX_*, CLINE_*, CONTINUE_*, AIDER_*, GEMINI_CODE_ASSIST,
+ *      ZED_AI_*, plus the generic AI_AGENT marker.  Prints a short
+ *      structured directive telling the host AI agent to switch to
+ *      "Mneme chat dispatcher mode": every subsequent user turn
+ *      should be routed through the AI_AGENT_CONTRACT Step 2.5
+ *      dispatch table to Mneme MCP tools.  The AI agent (Claude /
+ *      ChatGPT / Cursor / etc.) becomes the chat — the user gets to
+ *      keep all the LLM smartness of their host while gaining
+ *      Mneme's verifier + memory layer.
+ *
+ *   2. STANDALONE REPL (when no AI agent detected — bare terminal)
+ *      Pure Node readline.  Keyword-based intent routing against the
+ *      same 13-row dispatch table.  Built-in commands:
+ *        /exit, /quit          — leave the REPL
+ *        /help                 — show this list + the intent table
+ *        /clear                — clear screen
+ *        /history              — show past inputs
+ *        /show <N>             — re-print answer #N
+ *        /save <name>          — export session as a bash playbook
+ *        ?                     — genie mode (context-aware guess)
+ *      After every answer, prints "(W)hy / (V)erify / (P)remortem /
+ *      (Q)uit" — single keystroke continues to a follow-up command
+ *      against the same target.
+ *
+ * Both modes call into existing Mneme CLI commands via spawnSync —
+ * no LLM dependency in the standalone path, no new prompt template
+ * in the AI-agent path.
+ */
+export interface TalkOptions {
+    cwd: string;
+    /** Force standalone REPL even if AI agent detected (for testing /
+     *  for users who want the REPL inside Cursor terminal). */
+    forceStandalone?: boolean;
+    /** JSON dispatcher mode (machine-readable handoff). */
+    json?: boolean;
+}
+export declare function talkCommand(opts: TalkOptions): Promise<void>;
+//# sourceMappingURL=talk.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"talk.d.ts","sourceRoot":"","sources":["../../src/commands/talk.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AASH,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ;+DAC2D;IAC3D,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,uDAAuD;IACvD,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AA8UD,wBAAsB,WAAW,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAOlE"}