mneme-ai 3.127.0 → 3.129.0

package/dist/commands/seance.d.ts

@@ -0,0 +1,12 @@
+/**
+ * `mneme seance` (v3.128.0) — talk to your past self. Reconstruct the decision
+ * context around any commit (or "N months ago") from real git history — what you
+ * said, what you were working on, the TODOs you had open, and what you abandoned —
+ * all cited to real commits. Then reason FROM it (HPE-guarded), never invent.
+ *
+ *   mneme seance --at <ref>
+ *   mneme seance --months 8
+ */
+import type { Command } from "commander";
+export declare function registerSeanceCommands(program: Command): void;
+//# sourceMappingURL=seance.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"seance.d.ts","sourceRoot":"","sources":["../../src/commands/seance.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAwCzC,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAuB7D"}

package/dist/commands/seance.js

@@ -0,0 +1,103 @@
+/**
+ * `mneme seance` (v3.128.0) — talk to your past self. Reconstruct the decision
+ * context around any commit (or "N months ago") from real git history — what you
+ * said, what you were working on, the TODOs you had open, and what you abandoned —
+ * all cited to real commits. Then reason FROM it (HPE-guarded), never invent.
+ *
+ *   mneme seance --at <ref>
+ *   mneme seance --months 8
+ */
+import { spawnSync } from "node:child_process";
+import { seance } from "@mneme-ai/core";
+function out(s) { process.stdout.write(s + "\n"); }
+function git(args) { const r = spawnSync("git", args, { encoding: "utf8", maxBuffer: 128 * 1024 * 1024 }); return r.status === 0 ? (r.stdout || "") : ""; }
+function readCommits(max = 4000) {
+    const US = "\x1f", RS = "\x1e";
+    const o = git(["log", "--no-merges", "-n", String(max), `--format=${RS}%H${US}%an${US}%at${US}%s${US}%b`]);
+    const byHash = new Map();
+    for (const blk of o.split(RS)) {
+        if (!blk.trim())
+            continue;
+        const [hash, author, at, subject, ...rest] = blk.split(US);
+        if (!hash)
+            continue;
+        byHash.set(hash.trim(), { hash: hash.trim(), author: (author || "").trim(), ts: parseInt(at || "0", 10) || 0, subject: (subject || "").trim(), body: (rest.join(US) || "").trim(), files: [] });
+    }
+    return [...byHash.values()];
+}
+/** Resolve --at ref or --months N to a full commit hash. */
+function resolveRef(ref, months) {
+    if (ref) {
+        const h = git(["rev-parse", ref]).trim();
+        return h ? { ref, hash: h } : null;
+    }
+    if (months) {
+        const h = git(["rev-list", "-1", `--before=${months} months ago`, "HEAD"]).trim();
+        return h ? { ref: `${months} months ago`, hash: h } : null;
+    }
+    const h = git(["rev-parse", "HEAD"]).trim();
+    return h ? { ref: "HEAD", hash: h } : null;
+}
+/** TODO/FIXME alive at a ref → cited file:line. */
+function todosAtRef(hash) {
+    const o = git(["grep", "-nI", "-E", "TODO|FIXME|HACK|XXX", hash, "--", "*.ts", "*.tsx", "*.js", "*.py", "*.go", "*.rs", "*.rb", "*.java"]);
+    const todos = [];
+    for (const line of o.split("\n")) {
+        // format: <ref>:<file>:<line>:<text>
+        const m = line.match(/^[^:]+:([^:]+):(\d+):(.*)$/);
+        if (m)
+            todos.push({ file: m[1], line: parseInt(m[2], 10), text: m[3].trim().slice(0, 120) });
+        if (todos.length >= 30)
+            break;
+    }
+    return todos;
+}
+export function registerSeanceCommands(program) {
+    program
+        .command("seance")
+        .description("🔮 SÉANCE — talk to your past self. Reconstruct the DECISION CONTEXT around any commit (what you said · were working on · had open as TODOs · abandoned), cited to real commits, so you (or an agent) can answer 'why did I choose this?' grounded in the record — never invented. Git-native shared context, local-first. HONEST: deterministic projection of git, not spirit-channeling; HPE-guard any answer.")
+        .option("--at <ref>", "a commit ref / sha / tag to summon")
+        .option("--months <n>", "summon your self from N months ago")
+        .option("--json", "JSON output (the full grounded packet)")
+        .action((opts) => {
+        const commits = readCommits();
+        if (!commits.length) {
+            out("no commits found (run inside a git repo)");
+            process.exitCode = 2;
+            return;
+        }
+        const r = resolveRef(opts.at, opts.months);
+        if (!r) {
+            out("could not resolve that ref");
+            process.exitCode = 2;
+            return;
+        }
+        const packet = seance.reconstructSeance(commits, r.hash, { ref: r.ref, todosThen: todosAtRef(r.hash), now: Math.floor(Date.now() / 1000) });
+        if (opts.json) {
+            out(JSON.stringify(packet, null, 2));
+            return;
+        }
+        out(`🔮 SÉANCE — your self at ${packet.at.ref} (${packet.at.monthsAgo} month(s) ago · ${packet.at.hash})`);
+        out(`\n  💬 What you said:\n     "${packet.decision.subject}"${packet.decision.body ? `\n     ${packet.decision.body.split("\n")[0]}` : ""}`);
+        if (packet.themes.length)
+            out(`\n  🎯 What you were focused on:  ${packet.themes.join(" · ")}`);
+        if (packet.window.length) {
+            out(`\n  🕰  Leading up to it:`);
+            for (const w of packet.window.slice(0, 6))
+                out(`     ${w.hash}  ${w.subject}`);
+        }
+        if (packet.abandoned.length) {
+            out(`\n  👻 Paths you abandoned:`);
+            for (const a of packet.abandoned)
+                out(`     ${a.hash}  ${a.subject}`);
+        }
+        if (packet.todosThen.length) {
+            out(`\n  📌 Intentions you had open then:`);
+            for (const t of packet.todosThen.slice(0, 6))
+                out(`     ${t.file}:${t.line}  ${t.text}`);
+        }
+        out(`\n  🧷 ${packet.citations.length} citations · packetId ${packet.packetId.slice(0, 16)}…`);
+        out(`  ${packet.groundingNote}`);
+    });
+}
+//# sourceMappingURL=seance.js.map

package/dist/commands/seance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"seance.js","sourceRoot":"","sources":["../../src/commands/seance.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":"AA0MA,wBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA6mNvD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AA2MA,wBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA8mNvD"}

package/dist/index.js

@@ -133,6 +133,7 @@ import { registerStatguardCommands } from "./commands/statguard.js";
 import { registerHpeCommands } from "./commands/hpe.js";
 import { registerVericertCommands } from "./commands/vericert.js";
 import { registerPersonaCommands } from "./commands/persona.js";
+import { registerSeanceCommands } from "./commands/seance.js";
 import { registerMoatCommands } from "./commands/moat.js";
 import { attachRegretOracle } from "./commands/regret.js";
 import { registerTrustCommands } from "./commands/trust.js";
@@ -4823,6 +4824,7 @@ export async function run(argv) {
     registerHpeCommands(program);
     registerVericertCommands(program);
     registerPersonaCommands(program);
+    registerSeanceCommands(program);
     registerMoatCommands(program);
     // ─── Trust calibrator (v1.31.0) -- per-subsystem precision/recall/band
     registerTrustCommands(program);