@mneme-ai/core 2.64.0 → 2.66.0

package/dist/reflog/index.js

@@ -0,0 +1,406 @@
+/**
+ * v2.66.0 — REFLOG: cross-session time-machine for AI-driven repos.
+ *
+ * Closes the Mneme MCP septet: bodyguard + diplomat + conscience +
+ * memory + consensus + coordination + **time machine**. With v2.66
+ * shipped, the full 7-primitive agent infrastructure stack is LIVE.
+ *
+ * Killer use case: "rewind 2 hours, keep tests" → bad commits revert,
+ * tests intact. Pre-MIRROR: `git reset --hard` is all-or-nothing —
+ * loses the good with the bad. REFLOG keeps:
+ *  - HMAC-signed checkpoints (HEAD ref + per-file SHA + AI pheromone
+ *    tag = which agent was active when each file was last touched)
+ *  - Selective rewind via path-predicate filter (include/exclude
+ *    globs) and/or AI pheromone filter (only rewind cursor's edits)
+ *  - Dry-run preview by default — shows what WOULD revert / keep
+ *  - Cryptographic audit trail of every checkpoint + rewind
+ *
+ * REFLOG is SAFE by construction: rewind() never touches the working
+ * tree. It returns a PROPOSAL (a list of files + their target SHAs).
+ * The caller applies it via a separate operation OR pastes the
+ * proposal into git/IDE for manual review.
+ *
+ * 7 wild innovations:
+ *
+ *  1. PER-FILE SHA CHECKPOINT — snapshot the SHA of every tracked
+ *     file at checkpoint time. Lets rewind operate at file
+ *     granularity, not just commit granularity.
+ *
+ *  2. AI PHEROMONE TAGGING — each checkpoint records `recentAgent`
+ *     (Claude / Cursor / Continue / Aider) inferred from env vars
+ *     (CLAUDECODE / CURSOR_AGENT / etc). Rewind can filter by
+ *     pheromone: "rewind only Cursor's edits in the last 2h".
+ *
+ *  3. PATH-PREDICATE FILTER — minimatch-style include/exclude globs.
+ *     "Rewind everything EXCEPT tests/**" keeps tests intact while
+ *     reverting production code.
+ *
+ *  4. TIME-WINDOW REWIND — `--since 2h` or `--checkpoint <id>`.
+ *     REFLOG computes the right target checkpoint then diffs.
+ *
+ *  5. DRY-RUN PROPOSAL — every rewind returns a structured
+ *     `RewindProposal` (toRevert + toKeep). The agent reviews
+ *     before applying. No accidental data loss.
+ *
+ *  6. HMAC-CHAINED REFLOG LEDGER — every checkpoint + rewind
+ *     proposal + apply event chained. Tamper-evident.
+ *
+ *  7. COMPOSES WITH SWARM BUS — when a rewind ships, REFLOG can
+ *     auto-broadcast to a swarm channel so other agents know
+ *     the working tree changed. Wire pending v2.67+.
+ *
+ * Pure ESM. Defensive — never throws.
+ */
+import { createHash, createHmac } from "node:crypto";
+import { appendFileSync, existsSync, mkdirSync, readFileSync, readdirSync, statSync, writeFileSync } from "node:fs";
+import { dirname, join, relative, sep } from "node:path";
+const KEY_ENV = "MNEME_REFLOG_KEY";
+const DEFAULT_KEY = "mneme-reflog-v1";
+function keyOf() { return process.env[KEY_ENV] ?? DEFAULT_KEY; }
+/* ── Canonical JSON HMAC ────────────────────────────────────────── */
+function canonicalJson(o) {
+    if (o === undefined)
+        return "null";
+    if (o === null || typeof o !== "object")
+        return JSON.stringify(o);
+    if (Array.isArray(o))
+        return "[" + o.map((x) => canonicalJson(x === undefined ? null : x)).join(",") + "]";
+    const entries = Object.entries(o).filter(([, v]) => v !== undefined);
+    entries.sort(([a], [b]) => a.localeCompare(b));
+    return "{" + entries.map(([k, v]) => JSON.stringify(k) + ":" + canonicalJson(v)).join(",") + "}";
+}
+function signHmac(body) {
+    return createHmac("sha256", keyOf()).update(canonicalJson(body)).digest("hex");
+}
+/* ── Pheromone detection (cheap env-var scan) ───────────────────── */
+export function detectPheromone() {
+    // Same inputs NEMESIS uses for env_scan; cheap synchronous fallback.
+    if (process.env["CLAUDECODE"] || process.env["CLAUDE_CODE_SSE_PORT"] || process.env["CLAUDE_CODE_SESSION"] || process.env["CLAUDE_CODE_ENTRYPOINT"])
+        return "claude-code";
+    if (process.env["CURSOR_AGENT"] || process.env["CURSOR_SESSION"])
+        return "cursor";
+    if (process.env["CONTINUE_AGENT"] || process.env["CONTINUE_SESSION"])
+        return "continue";
+    if (process.env["AIDER_VERSION"] || process.env["AIDER_AGENT"])
+        return "aider";
+    if (process.env["DEVIN_SESSION"])
+        return "devin";
+    if (process.env["GROK_AGENT"] || process.env["GROK_CLI"] || process.env["XAI_API_KEY"])
+        return "grok";
+    if (process.env["GEMINI_AGENT"] || process.env["GOOGLE_AI_KEY"])
+        return "gemini";
+    if (process.env["COPILOT_AGENT"])
+        return "copilot";
+    return "unknown";
+}
+/* ── File walk + SHA ────────────────────────────────────────────── */
+function sha256Hex(buf) {
+    return createHash("sha256").update(buf).digest("hex");
+}
+const DEFAULT_EXCLUDE = [
+    ".git", "node_modules", ".mneme", "dist", "build", "out", ".next", ".turbo",
+    "coverage", ".cache", ".vite", ".parcel-cache", "*.log",
+];
+function matchAny(path, patterns) {
+    // Lightweight glob: handles literal substring + leading "/" anchor + "*" wildcard.
+    const norm = path.replace(/\\/g, "/");
+    for (const p of patterns) {
+        if (p.length === 0)
+            continue;
+        if (p.startsWith("*.") && norm.endsWith(p.slice(1)))
+            return true;
+        if (p.includes("*")) {
+            const rx = new RegExp("^" + p.replace(/\./g, "\\.").replace(/\*\*/g, "::DSTAR::").replace(/\*/g, "[^/]*").replace(/::DSTAR::/g, ".*") + "$");
+            if (rx.test(norm))
+                return true;
+        }
+        else if (norm === p || norm.startsWith(p + "/") || norm.endsWith("/" + p) || norm.includes("/" + p + "/")) {
+            return true;
+        }
+        else if (norm === p)
+            return true;
+    }
+    return false;
+}
+function walkFiles(root, include, exclude, maxFiles) {
+    const out = [];
+    const queue = [root];
+    while (queue.length > 0 && out.length < maxFiles) {
+        const dir = queue.shift();
+        let entries;
+        try {
+            entries = readdirSync(dir, { withFileTypes: true });
+        }
+        catch {
+            continue;
+        }
+        for (const e of entries) {
+            const full = join(dir, e.name);
+            const rel = relative(root, full).split(sep).join("/");
+            // Skip excluded paths early.
+            if (matchAny(rel, exclude) || matchAny(e.name, exclude))
+                continue;
+            if (e.isDirectory()) {
+                queue.push(full);
+                continue;
+            }
+            if (!e.isFile())
+                continue;
+            if (include.length > 0 && !include.includes("**/*") && !matchAny(rel, include))
+                continue;
+            out.push(rel);
+            if (out.length >= maxFiles)
+                break;
+        }
+    }
+    return out;
+}
+function gitHead(cwd) {
+    try {
+        const headFile = join(cwd, ".git", "HEAD");
+        if (!existsSync(headFile))
+            return "";
+        const head = readFileSync(headFile, "utf8").trim();
+        if (head.startsWith("ref: ")) {
+            const refPath = join(cwd, ".git", head.slice(5).trim());
+            if (existsSync(refPath))
+                return readFileSync(refPath, "utf8").trim();
+            return head;
+        }
+        return head;
+    }
+    catch {
+        return "";
+    }
+}
+/* ── Checkpoint ─────────────────────────────────────────────────── */
+export function createCheckpoint(input = {}) {
+    const cwd = input.cwd ?? process.cwd();
+    const include = input.include ?? ["**/*"];
+    const exclude = [...DEFAULT_EXCLUDE, ...(input.exclude ?? [])];
+    const maxFiles = input.maxFiles ?? 5000;
+    const at = new Date().toISOString();
+    const id = sha256Hex(at + Math.random().toString()).slice(0, 16);
+    const head = gitHead(cwd);
+    const pheromone = detectPheromone();
+    const files = [];
+    for (const rel of walkFiles(cwd, include, exclude, maxFiles)) {
+        try {
+            const full = join(cwd, rel);
+            const stat = statSync(full);
+            if (stat.size > 5 * 1024 * 1024)
+                continue; // skip >5MB
+            const content = readFileSync(full);
+            files.push({ path: rel, sha: sha256Hex(content), mtimeMs: stat.mtimeMs });
+        }
+        catch { /* skip unreadable */ }
+    }
+    const body = { id, at, gitHead: head, pheromone, files, label: input.label };
+    const hmac = signHmac(body);
+    const cp = { ...body, hmac };
+    // Persist + append ledger.
+    try {
+        const p = join(cwd, ".mneme", "reflog", `checkpoint-${id}.json`);
+        mkdirSync(dirname(p), { recursive: true });
+        writeFileSync(p, JSON.stringify(cp, null, 2));
+    }
+    catch { /* noop */ }
+    appendLedger(cwd, { kind: "checkpoint", at, id, detail: `files=${files.length} pheromone=${pheromone} head=${head.slice(0, 8)}` });
+    return { ok: true, checkpoint: cp, hint: `checkpoint ${id} created · ${files.length} file(s) · pheromone=${pheromone}` };
+}
+export function listCheckpoints(cwd) {
+    const dir = join(cwd, ".mneme", "reflog");
+    if (!existsSync(dir))
+        return [];
+    const out = [];
+    let entries;
+    try {
+        entries = readdirSync(dir, { withFileTypes: true });
+    }
+    catch {
+        return [];
+    }
+    for (const e of entries) {
+        if (!e.isFile() || !e.name.startsWith("checkpoint-") || !e.name.endsWith(".json"))
+            continue;
+        try {
+            const cp = JSON.parse(readFileSync(join(dir, e.name), "utf8"));
+            out.push({ id: cp.id, at: cp.at, label: cp.label, fileCount: cp.files.length, pheromone: cp.pheromone });
+        }
+        catch { /* skip */ }
+    }
+    out.sort((a, b) => b.at.localeCompare(a.at));
+    return out;
+}
+export function readCheckpoint(cwd, id) {
+    try {
+        const p = join(cwd, ".mneme", "reflog", `checkpoint-${id}.json`);
+        if (!existsSync(p))
+            return null;
+        return JSON.parse(readFileSync(p, "utf8"));
+    }
+    catch {
+        return null;
+    }
+}
+export function verifyCheckpoint(c) {
+    if (!c || typeof c.hmac !== "string")
+        return false;
+    const { hmac, ...body } = c;
+    return signHmac(body) === hmac;
+}
+/* ── Rewind proposal ────────────────────────────────────────────── */
+function parseSince(s) {
+    // "2h" "30m" "1d" → ms ago
+    const m = /^(\d+)\s*([smhd])$/.exec(s.trim());
+    if (!m)
+        return 0;
+    const n = parseInt(m[1], 10);
+    const unit = m[2];
+    const mul = unit === "s" ? 1000 : unit === "m" ? 60000 : unit === "h" ? 3600000 : 86400000;
+    return n * mul;
+}
+export function rewindPreview(input) {
+    const cwd = input.cwd ?? process.cwd();
+    const ckpts = listCheckpoints(cwd).map((m) => readCheckpoint(cwd, m.id)).filter((x) => !!x);
+    let target = null;
+    if (input.checkpointId) {
+        target = ckpts.find((c) => c.id === input.checkpointId) ?? null;
+    }
+    else if (input.since) {
+        const cutoff = Date.now() - parseSince(input.since);
+        // Pick the LATEST checkpoint AT-OR-BEFORE cutoff (so we restore the state from before "since" ago).
+        const candidates = ckpts.filter((c) => new Date(c.at).getTime() <= cutoff);
+        target = candidates.sort((a, b) => b.at.localeCompare(a.at))[0] ?? null;
+    }
+    else {
+        // Default: previous-to-current checkpoint.
+        target = ckpts[1] ?? null;
+    }
+    if (!target) {
+        return {
+            ok: false, targetCheckpoint: { id: "", at: "" },
+            toRevert: [], toKeep: [],
+            summary: "no target checkpoint found (need at least one checkpoint matching the filter)",
+            hmac: signHmac({}),
+        };
+    }
+    const include = input.include ?? [];
+    const exclude = input.exclude ?? [];
+    const toRevert = [];
+    const toKeep = [];
+    for (const f of target.files) {
+        if (input.pheromone && target.pheromone !== input.pheromone) {
+            toKeep.push({ path: f.path, reason: `pheromone mismatch (target=${target.pheromone}, want=${input.pheromone})` });
+            continue;
+        }
+        if (exclude.length > 0 && matchAny(f.path, exclude)) {
+            toKeep.push({ path: f.path, reason: "excluded by --exclude pattern" });
+            continue;
+        }
+        if (include.length > 0 && !matchAny(f.path, include)) {
+            toKeep.push({ path: f.path, reason: "not in --include pattern" });
+            continue;
+        }
+        // Current SHA
+        let currentSha = "";
+        try {
+            const full = join(cwd, f.path);
+            if (existsSync(full))
+                currentSha = sha256Hex(readFileSync(full));
+        }
+        catch { /* leave empty */ }
+        if (currentSha === f.sha) {
+            toKeep.push({ path: f.path, reason: "no change since checkpoint" });
+            continue;
+        }
+        toRevert.push({ path: f.path, currentSha, targetSha: f.sha, targetMtimeMs: f.mtimeMs, targetPheromone: target.pheromone });
+    }
+    const summary = `rewind to ${target.id} (${target.at}) — ${toRevert.length} file(s) to revert, ${toKeep.length} kept`;
+    const body = {
+        ok: toRevert.length > 0,
+        targetCheckpoint: { id: target.id, at: target.at, label: target.label },
+        toRevert, toKeep, summary,
+    };
+    const hmac = signHmac(body);
+    appendLedger(cwd, { kind: "rewind_preview", at: new Date().toISOString(), id: target.id, detail: `toRevert=${toRevert.length} toKeep=${toKeep.length}` });
+    return { ...body, hmac };
+}
+export function verifyRewindProposal(r) {
+    if (!r || typeof r.hmac !== "string")
+        return false;
+    const { hmac, ...body } = r;
+    return signHmac(body) === hmac;
+}
+function ledgerPath(cwd) {
+    return join(cwd, ".mneme", "reflog", "ledger.jsonl");
+}
+function lastLedgerHmac(cwd) {
+    try {
+        const lines = readFileSync(ledgerPath(cwd), "utf8").trim().split(/\n/).filter((l) => l.trim().length > 0);
+        if (lines.length === 0)
+            return "";
+        return JSON.parse(lines[lines.length - 1]).hmac;
+    }
+    catch {
+        return "";
+    }
+}
+function appendLedger(cwd, entry) {
+    const prevHmac = lastLedgerHmac(cwd);
+    const body = { ...entry, prevHmac };
+    const hmac = createHmac("sha256", keyOf()).update(prevHmac).update(canonicalJson(body)).digest("hex");
+    const row = { ...body, hmac };
+    try {
+        mkdirSync(dirname(ledgerPath(cwd)), { recursive: true });
+        appendFileSync(ledgerPath(cwd), JSON.stringify(row) + "\n");
+    }
+    catch { /* noop */ }
+    return row;
+}
+export function readLedger(cwd) {
+    try {
+        return readFileSync(ledgerPath(cwd), "utf8").trim().split(/\n/).filter((l) => l.trim().length > 0).map((l) => JSON.parse(l));
+    }
+    catch {
+        return [];
+    }
+}
+export function verifyLedgerChain(cwd) {
+    const lines = readLedger(cwd);
+    let prevHmac = "";
+    for (let i = 0; i < lines.length; i++) {
+        const row = lines[i];
+        if (row.prevHmac !== prevHmac)
+            return { ok: false, rows: i, brokenAt: i };
+        const { hmac, ...body } = row;
+        const expected = createHmac("sha256", keyOf()).update(prevHmac).update(canonicalJson(body)).digest("hex");
+        if (expected !== hmac)
+            return { ok: false, rows: i, brokenAt: i };
+        prevHmac = hmac;
+    }
+    return { ok: true, rows: lines.length };
+}
+/* ── Render banner ──────────────────────────────────────────────── */
+export function renderRewindBanner(r) {
+    const lines = [
+        `⏪ REFLOG · ${r.summary}`,
+        "",
+    ];
+    for (const f of r.toRevert.slice(0, 30)) {
+        lines.push(`   ↩ ${f.path}  (now ${f.currentSha.slice(0, 8)} → ${f.targetSha.slice(0, 8)} from ${f.targetPheromone})`);
+    }
+    if (r.toRevert.length > 30)
+        lines.push(`   …and ${r.toRevert.length - 30} more`);
+    if (r.toKeep.length > 0) {
+        lines.push("");
+        lines.push(`   KEEPING (${r.toKeep.length}):`);
+        for (const k of r.toKeep.slice(0, 8)) {
+            lines.push(`     ${k.path}  — ${k.reason}`);
+        }
+        if (r.toKeep.length > 8)
+            lines.push(`     …and ${r.toKeep.length - 8} more`);
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=index.js.map

package/dist/reflog/index.js.map

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

package/dist/swarm_bus/index.d.ts

@@ -0,0 +1,163 @@
+/**
+ * v2.65.0 — SWARM BUS: cross-agent message bus over Mneme MCP.
+ *
+ * Continues Mneme MCP user-roadmap. v2.60-v2.64 quintet shipped:
+ * bodyguard / diplomat / conscience / memory / consensus. v2.65 adds
+ * the **cross-agent coordination** primitive (6th of 7).
+ *
+ * (Distinct namespace from v2.19 `swarm/` orchestrator wrapper.
+ * SWARM BUS = the actual message broker. Separate concern.)
+ *
+ * Killer use case: Claude finishes auth.ts → broadcasts on channel
+ * "team_x" → Cursor (in a different window, same Mneme MCP) receives
+ * via drain → verifies artifact HMAC → adds tests → broadcasts back.
+ * User watches the full Claude → Cursor → Continue handoff chain in
+ * `mneme swarm_bus audit`, each step HMAC-proven.
+ *
+ * Multi-agent orchestration today = framework lock-in (LangGraph,
+ * CrewAI, AutoGen). SWARM BUS = vendor-agnostic broker. Any agent
+ * that speaks MCP can join the swarm.
+ *
+ * 6 wild innovations:
+ *
+ *  1. PER-AGENT INBOX — each agent has its own queue. broadcast()
+ *     enqueues to ALL subscribers of the channel; drain() pops the
+ *     pending messages for one agent (marking them delivered).
+ *     Messages persist across process restarts.
+ *
+ *  2. LAMPORT-CLOCK CAUSAL ORDERING — broadcast bumps a per-channel
+ *     Lamport timestamp; messages delivered in causally-correct
+ *     order even when broadcasters race.
+ *
+ *  3. ARTIFACT HMAC VERIFICATION — broadcast can include
+ *     `artifactHmac` (e.g. SHA-256 of `auth.ts`). Receiving agent
+ *     re-hashes the file before acting. Tamper between broadcast
+ *     and consume is detectable.
+ *
+ *  4. CHANNEL ACL VIA PASSPORT (composes with v2.61 PASSPORT) —
+ *     channels can be `private`; subscribe + broadcast require a
+ *     valid capability passport with scope `swarm:<channel>`.
+ *     Public channels are open.
+ *
+ *  5. HANDOFF NARRATIVE — `auditHandoff(channel)` walks the ledger
+ *     and renders the agent → agent → agent chain as plain English
+ *     with HMAC proof per step. Inspector for "what did the swarm
+ *     actually do?".
+ *
+ *  6. HMAC-CHAINED LEDGER (`.mneme/swarm_bus/bus.jsonl`) — every
+ *     subscribe + broadcast + drain row's HMAC depends on prev row.
+ *     Same canonical-JSON convention as v2.61-v2.64.
+ *
+ * Pure ESM. Defensive — never throws.
+ */
+export type ChannelKind = "public" | "private";
+export interface SwarmMessage {
+    id: string;
+    at: string;
+    channel: string;
+    from: string;
+    text: string;
+    lamport: number;
+    artifactHmac?: string;
+    artifactPath?: string;
+    hmac: string;
+}
+export interface BroadcastInput {
+    channel: string;
+    from: string;
+    text: string;
+    artifactHmac?: string;
+    artifactPath?: string;
+    passportToken?: string;
+    cwd?: string;
+}
+export interface BroadcastResult {
+    ok: boolean;
+    reason: "delivered" | "channel_unknown" | "no_subscribers" | "passport_required" | "passport_invalid";
+    message?: SwarmMessage;
+    deliveredTo: string[];
+    hint: string;
+}
+export interface SubscribeInput {
+    channel: string;
+    agent: string;
+    passportToken?: string;
+    cwd?: string;
+}
+export interface SubscribeResult {
+    ok: boolean;
+    reason: "subscribed" | "already_subscribed" | "passport_required" | "passport_invalid";
+    channel: string;
+    agent: string;
+    hint: string;
+}
+export interface DrainInput {
+    agent: string;
+    channel?: string;
+    limit?: number;
+    cwd?: string;
+}
+export interface DrainResult {
+    ok: boolean;
+    messages: SwarmMessage[];
+    hint: string;
+}
+export interface CreateChannelInput {
+    channel: string;
+    kind: ChannelKind;
+    owner: string;
+    cwd?: string;
+}
+interface ChannelMeta {
+    name: string;
+    kind: ChannelKind;
+    owner: string;
+    createdAt: string;
+    lamport: number;
+    subscribers: string[];
+}
+interface LedgerEntry {
+    kind: "channel_create" | "subscribe" | "broadcast" | "drain";
+    at: string;
+    channel: string;
+    agent: string;
+    detail: string;
+    prevHmac: string;
+    hmac: string;
+}
+export declare function readLedger(cwd: string): LedgerEntry[];
+export declare function verifyLedgerChain(cwd: string): {
+    ok: boolean;
+    rows: number;
+    brokenAt?: number;
+};
+export declare function createChannel(input: CreateChannelInput): {
+    ok: boolean;
+    channel: ChannelMeta;
+    hint: string;
+};
+export declare function listChannels(cwd: string): ChannelMeta[];
+export declare function subscribe(input: SubscribeInput): Promise<SubscribeResult>;
+export declare function broadcast(input: BroadcastInput): Promise<BroadcastResult>;
+export declare function verifyMessage(m: SwarmMessage): boolean;
+export declare function drain(input: DrainInput): DrainResult;
+export declare function peekInbox(cwd: string, agent: string): SwarmMessage[];
+export interface HandoffStep {
+    step: number;
+    at: string;
+    from: string;
+    channel: string;
+    detail: string;
+    hmac: string;
+}
+export interface HandoffNarrative {
+    ok: boolean;
+    channel: string;
+    steps: HandoffStep[];
+    chain: string[];
+    rendered: string;
+}
+export declare function auditHandoff(cwd: string, channel: string): HandoffNarrative;
+export declare function renderInbox(messages: SwarmMessage[]): string;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/swarm_bus/index.d.ts.map

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