@mneme-ai/core 2.65.0 → 2.67.0

package/dist/protoplasm/types.d.ts

@@ -0,0 +1,84 @@
+/**
+ * 🦠 PROTOPLASM — types
+ *
+ * Live atom embedded in every function. Reports super_quan findings to
+ * orchestrator. Orchestrator decides: HEALTHY → crawl-and-learn,
+ * BROKEN → wisdom-space root-cause + heal.
+ */
+export type ProbeOutcome = "healthy" | "warn" | "broken";
+/** A single recorded invocation snapshot. */
+export interface InvocationSnapshot {
+    fnId: string;
+    ts: string;
+    durationMs: number;
+    args: {
+        count: number;
+        shape: string;
+    };
+    output: {
+        kind: "ok" | "throw";
+        shape?: string;
+        errorClass?: string;
+    };
+}
+/** Statistical baseline for a single function (rolling). */
+export interface FunctionBaseline {
+    fnId: string;
+    samples: number;
+    durationMean: number;
+    durationStdev: number;
+    errorRate: number;
+    argShapeEntropy: number;
+    outputShapeEntropy: number;
+    lastUpdate: string;
+}
+/** Result of a single super_quan probe run. */
+export interface SuperQuanFinding {
+    fnId: string;
+    at: string;
+    outcome: ProbeOutcome;
+    zScores: Record<string, number>;
+    quantumSignals: QuantumSignals;
+    rootCauseHints: string[];
+    evidence: string;
+    hmac: string;
+    prev: string;
+}
+/** Quantum-inspired signals (analogues, not literal QM). */
+export interface QuantumSignals {
+    /** Shannon entropy of output distribution. Low = collapse to single state. High = decoherence. */
+    outputEntropy: number;
+    /** Chaos-input divergence — how much the function's output varies given structured perturbation. */
+    chaosDivergence: number;
+    /** Cross-function correlation — does this function's broken state coincide w/ neighbors? */
+    neighborCorrelation: number;
+    /** Superposition collapse score — proportion of calls that produce typed output vs throw. */
+    collapseStability: number;
+}
+export interface WisdomRootCause {
+    fnId: string;
+    hypothesis: string;
+    upstreamSuspects: string[];
+    confidence: number;
+    proposedHeal: HealAction[];
+}
+export interface HealAction {
+    kind: "retry-with-backoff" | "fallback-to-cached" | "request-supernova-restart" | "raise-truth-gate-block" | "noop";
+    rationale: string;
+}
+export interface CrawlPlan {
+    trigger: "healthy-burst" | "scheduled" | "manual";
+    fnId: string;
+    searchTopics: string[];
+    budgetMs: number;
+    estimatedROI: number;
+}
+export interface ProtoplasmConfig {
+    baselineSamplesMin: number;
+    zScoreWarn: number;
+    zScoreBroken: number;
+    ledgerDir: string;
+    hmacKey: string;
+    crawlOnHealthyEvery: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/protoplasm/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/protoplasm/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEzD,6CAA6C;AAC7C,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACvC,MAAM,EAAE;QAAE,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACvE;AAED,4DAA4D;AAC5D,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,+CAA+C;AAC/C,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,YAAY,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,cAAc,EAAE,cAAc,CAAC;IAC/B,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,4DAA4D;AAC5D,MAAM,WAAW,cAAc;IAC7B,kGAAkG;IAClG,aAAa,EAAE,MAAM,CAAC;IACtB,oGAAoG;IACpG,eAAe,EAAE,MAAM,CAAC;IACxB,4FAA4F;IAC5F,mBAAmB,EAAE,MAAM,CAAC;IAC5B,6FAA6F;IAC7F,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,UAAU,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,oBAAoB,GAAG,oBAAoB,GAAG,2BAA2B,GAAG,wBAAwB,GAAG,MAAM,CAAC;IACpH,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,eAAe,GAAG,WAAW,GAAG,QAAQ,CAAC;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,mBAAmB,EAAE,MAAM,CAAC;CAC7B"}

package/dist/protoplasm/types.js

@@ -0,0 +1,9 @@
+/**
+ * 🦠 PROTOPLASM — types
+ *
+ * Live atom embedded in every function. Reports super_quan findings to
+ * orchestrator. Orchestrator decides: HEALTHY → crawl-and-learn,
+ * BROKEN → wisdom-space root-cause + heal.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/protoplasm/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/protoplasm/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/protoplasm/wal.d.ts

@@ -0,0 +1,46 @@
+/**
+ * 🩸 PROTOPLASM — WAL (Write-Ahead Log)
+ *
+ * Survives uncatchable kills (SIGKILL, SIGSEGV, OS reboot).
+ *
+ * Strategy: every baseline mutation persists to disk BEFORE RAM update.
+ * Process death = baseline survives. Next start reads WAL → reconstructs.
+ *
+ * WAL format: append-only JSONL at .mneme/protoplasm/wal.jsonl
+ * Each row = { ts, fnId, op, payload, prevHmac, hmac }
+ *
+ * Compaction: when WAL exceeds 5MB, snapshot baselines to baselines.json
+ * + truncate WAL to entries since snapshot.
+ */
+import type { FunctionBaseline } from "./types.js";
+export type WalOp = "baseline_set" | "buffer_evict" | "config_set";
+export interface WalRow {
+    ts: string;
+    fnId: string;
+    op: WalOp;
+    payload: unknown;
+    prevHmac: string;
+    hmac: string;
+}
+export declare class Wal {
+    private path;
+    private secret;
+    private lastHmac;
+    private compactionThresholdBytes;
+    constructor(walDir: string, secret: string);
+    private computeLastHmac;
+    /** Append op to WAL. Synchronous + flush — survives unexpected death. */
+    append(op: WalOp, fnId: string, payload: unknown): WalRow;
+    /** Replay WAL → reconstruct baseline map. Idempotent. */
+    replay(): Map<string, FunctionBaseline>;
+    /** Verify chain integrity (chain HMAC continuity). */
+    verify(): {
+        ok: boolean;
+        rows: number;
+        brokenAt?: number;
+    };
+    /** Compact WAL → snapshot if file exceeds threshold. */
+    private maybeCompact;
+    path_for_test(): string;
+}
+//# sourceMappingURL=wal.d.ts.map

package/dist/protoplasm/wal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wal.d.ts","sourceRoot":"","sources":["../../src/protoplasm/wal.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAKH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,MAAM,MAAM,KAAK,GAAG,cAAc,GAAG,cAAc,GAAG,YAAY,CAAC;AAEnE,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,KAAK,CAAC;IACV,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAmBD,qBAAa,GAAG;IACd,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAkB;IAClC,OAAO,CAAC,wBAAwB,CAAmB;gBAEvC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAO1C,OAAO,CAAC,eAAe;IAWvB,yEAAyE;IACzE,MAAM,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM;IAUzD,yDAAyD;IACzD,MAAM,IAAI,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAsBvC,sDAAsD;IACtD,MAAM,IAAI;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE;IAiB1D,wDAAwD;IACxD,OAAO,CAAC,YAAY;IAiBpB,aAAa,IAAI,MAAM;CACxB"}

package/dist/protoplasm/wal.js

@@ -0,0 +1,145 @@
+/**
+ * 🩸 PROTOPLASM — WAL (Write-Ahead Log)
+ *
+ * Survives uncatchable kills (SIGKILL, SIGSEGV, OS reboot).
+ *
+ * Strategy: every baseline mutation persists to disk BEFORE RAM update.
+ * Process death = baseline survives. Next start reads WAL → reconstructs.
+ *
+ * WAL format: append-only JSONL at .mneme/protoplasm/wal.jsonl
+ * Each row = { ts, fnId, op, payload, prevHmac, hmac }
+ *
+ * Compaction: when WAL exceeds 5MB, snapshot baselines to baselines.json
+ * + truncate WAL to entries since snapshot.
+ */
+import { existsSync, statSync, readFileSync, appendFileSync, writeFileSync, mkdirSync, renameSync } from "node:fs";
+import { join } from "node:path";
+import { createHmac } from "node:crypto";
+/** Recursive canonical JSON: sort all keys at every depth, drop undefined. */
+function canonical(v) {
+    if (v === null || typeof v !== "object")
+        return v;
+    if (Array.isArray(v))
+        return v.map(canonical);
+    const out = {};
+    for (const k of Object.keys(v).sort()) {
+        const val = v[k];
+        if (val !== undefined)
+            out[k] = canonical(val);
+    }
+    return out;
+}
+function hmacRow(prev, body, secret) {
+    const canon = JSON.stringify(canonical(body));
+    return createHmac("sha256", secret).update(prev + "::" + canon).digest("hex").slice(0, 16);
+}
+export class Wal {
+    path;
+    secret;
+    lastHmac = "0".repeat(16);
+    compactionThresholdBytes = 5 * 1024 * 1024; // 5MB
+    constructor(walDir, secret) {
+        mkdirSync(walDir, { recursive: true });
+        this.path = join(walDir, "wal.jsonl");
+        this.secret = secret;
+        this.lastHmac = this.computeLastHmac();
+    }
+    computeLastHmac() {
+        if (!existsSync(this.path))
+            return "0".repeat(16);
+        try {
+            const content = readFileSync(this.path, "utf8").trim();
+            if (!content)
+                return "0".repeat(16);
+            const lines = content.split("\n");
+            const last = JSON.parse(lines[lines.length - 1]);
+            return last.hmac;
+        }
+        catch {
+            return "0".repeat(16);
+        }
+    }
+    /** Append op to WAL. Synchronous + flush — survives unexpected death. */
+    append(op, fnId, payload) {
+        const body = { ts: new Date().toISOString(), fnId, op, payload, prevHmac: this.lastHmac };
+        const hmac = hmacRow(this.lastHmac, body, this.secret);
+        const row = { ...body, hmac };
+        appendFileSync(this.path, JSON.stringify(row) + "\n", { encoding: "utf8", flush: true });
+        this.lastHmac = hmac;
+        this.maybeCompact();
+        return row;
+    }
+    /** Replay WAL → reconstruct baseline map. Idempotent. */
+    replay() {
+        const baselines = new Map();
+        const snapshotPath = this.path.replace("wal.jsonl", "baselines.json");
+        // Load snapshot first (compaction product)
+        if (existsSync(snapshotPath)) {
+            try {
+                const snap = JSON.parse(readFileSync(snapshotPath, "utf8"));
+                for (const [k, v] of Object.entries(snap))
+                    baselines.set(k, v);
+            }
+            catch { /* ignore corrupt snapshot — fall back to full WAL */ }
+        }
+        if (!existsSync(this.path))
+            return baselines;
+        const content = readFileSync(this.path, "utf8").trim();
+        if (!content)
+            return baselines;
+        for (const line of content.split("\n")) {
+            try {
+                const row = JSON.parse(line);
+                if (row.op === "baseline_set")
+                    baselines.set(row.fnId, row.payload);
+            }
+            catch { /* skip malformed */ }
+        }
+        return baselines;
+    }
+    /** Verify chain integrity (chain HMAC continuity). */
+    verify() {
+        if (!existsSync(this.path))
+            return { ok: true, rows: 0 };
+        const lines = readFileSync(this.path, "utf8").trim().split("\n").filter(Boolean);
+        let prev = "0".repeat(16);
+        for (let i = 0; i < lines.length; i++) {
+            try {
+                const row = JSON.parse(lines[i]);
+                if (row.prevHmac !== prev)
+                    return { ok: false, rows: lines.length, brokenAt: i };
+                const { hmac, ...body } = row;
+                const recomputed = hmacRow(prev, body, this.secret);
+                if (recomputed !== hmac)
+                    return { ok: false, rows: lines.length, brokenAt: i };
+                prev = hmac;
+            }
+            catch {
+                return { ok: false, rows: lines.length, brokenAt: i };
+            }
+        }
+        return { ok: true, rows: lines.length };
+    }
+    /** Compact WAL → snapshot if file exceeds threshold. */
+    maybeCompact() {
+        try {
+            const sz = statSync(this.path).size;
+            if (sz < this.compactionThresholdBytes)
+                return;
+            const baselines = this.replay();
+            const snapshotPath = this.path.replace("wal.jsonl", "baselines.json");
+            const obj = {};
+            for (const [k, v] of baselines)
+                obj[k] = v;
+            writeFileSync(snapshotPath, JSON.stringify(obj), "utf8");
+            // Truncate WAL atomically: write empty + reset chain
+            const tmpPath = this.path + ".tmp";
+            writeFileSync(tmpPath, "", "utf8");
+            renameSync(tmpPath, this.path);
+            this.lastHmac = "0".repeat(16);
+        }
+        catch { /* compaction is best-effort */ }
+    }
+    path_for_test() { return this.path; }
+}
+//# sourceMappingURL=wal.js.map

package/dist/protoplasm/wal.js.map

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

package/dist/protoplasm/wisdom_space.d.ts

@@ -0,0 +1,30 @@
+/**
+ * 🦠 PROTOPLASM — wisdom_space
+ *
+ * When orchestrator marks a finding BROKEN → wisdom_space diagnoses root cause.
+ *
+ * Strategy:
+ *   1. Collect last N findings across ALL functions in same time window
+ *   2. Score upstream suspects by co-occurrence (broke around same time)
+ *   3. Detect "neighbor-broken-first" patterns (this fn broke 30s AFTER fnX broke)
+ *   4. Emit hypothesis + proposed heal actions
+ *
+ * The "wisdom" is the cross-function correlation — single-function metrics
+ * can't see "I broke because dep X broke 30 seconds ago".
+ */
+import type { SuperQuanFinding, WisdomRootCause } from "./types.js";
+interface DiagnoseInput {
+    brokenFinding: SuperQuanFinding;
+    recentLedger: SuperQuanFinding[];
+    windowMs?: number;
+}
+export declare function diagnose(input: DiagnoseInput): WisdomRootCause;
+/** Quick summary of recent ledger health. */
+export declare function ledgerHealth(recent: SuperQuanFinding[]): {
+    broken: number;
+    warn: number;
+    healthy: number;
+    brokenRate: number;
+};
+export {};
+//# sourceMappingURL=wisdom_space.d.ts.map

package/dist/protoplasm/wisdom_space.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wisdom_space.d.ts","sourceRoot":"","sources":["../../src/protoplasm/wisdom_space.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAc,MAAM,YAAY,CAAC;AAEhF,UAAU,aAAa;IACrB,aAAa,EAAE,gBAAgB,CAAC;IAChC,YAAY,EAAE,gBAAgB,EAAE,CAAC;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,eAAe,CA0D9D;AAED,6CAA6C;AAC7C,wBAAgB,YAAY,CAAC,MAAM,EAAE,gBAAgB,EAAE,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAM9H"}

package/dist/protoplasm/wisdom_space.js

@@ -0,0 +1,77 @@
+/**
+ * 🦠 PROTOPLASM — wisdom_space
+ *
+ * When orchestrator marks a finding BROKEN → wisdom_space diagnoses root cause.
+ *
+ * Strategy:
+ *   1. Collect last N findings across ALL functions in same time window
+ *   2. Score upstream suspects by co-occurrence (broke around same time)
+ *   3. Detect "neighbor-broken-first" patterns (this fn broke 30s AFTER fnX broke)
+ *   4. Emit hypothesis + proposed heal actions
+ *
+ * The "wisdom" is the cross-function correlation — single-function metrics
+ * can't see "I broke because dep X broke 30 seconds ago".
+ */
+export function diagnose(input) {
+    const window = input.windowMs ?? 60_000;
+    const brokenAt = new Date(input.brokenFinding.at).getTime();
+    const inWindow = input.recentLedger.filter((f) => Math.abs(new Date(f.at).getTime() - brokenAt) <= window);
+    // Upstream suspects: other fns that turned broken WITHIN the window AND earlier
+    const earlierBroken = inWindow.filter((f) => f.fnId !== input.brokenFinding.fnId
+        && f.outcome === "broken"
+        && new Date(f.at).getTime() < brokenAt);
+    // Score by recency (earlier → higher suspect score)
+    const suspects = earlierBroken
+        .map((f) => ({ fnId: f.fnId, age: brokenAt - new Date(f.at).getTime(), reason: f.evidence }))
+        .sort((a, b) => b.age - a.age); // older = upstream
+    const upstreamSuspects = suspects.slice(0, 5).map((s) => s.fnId);
+    let hypothesis;
+    let confidence = 0.4;
+    const heals = [];
+    if (upstreamSuspects.length >= 2) {
+        hypothesis = `cascade failure from upstream: ${upstreamSuspects.join(" → ")}`;
+        confidence = 0.85;
+        heals.push({ kind: "request-supernova-restart", rationale: "multiple upstream functions broken — restart cycle to clear shared state" });
+        heals.push({ kind: "raise-truth-gate-block", rationale: "cascade detected — block any new release tag until heal verified" });
+    }
+    else if (upstreamSuspects.length === 1) {
+        hypothesis = `proximate cause: ${upstreamSuspects[0]} broke earlier in window`;
+        confidence = 0.7;
+        heals.push({ kind: "retry-with-backoff", rationale: "single upstream suspect — retry after upstream stabilizes" });
+    }
+    else {
+        // No upstream suspects → check quantum signals
+        const qs = input.brokenFinding.quantumSignals;
+        if (qs.collapseStability < 0.5) {
+            hypothesis = "intrinsic instability — function throws on >50% of calls";
+            confidence = 0.6;
+            heals.push({ kind: "fallback-to-cached", rationale: "high throw rate — serve cached last-good response" });
+        }
+        else if (qs.chaosDivergence > 3) {
+            hypothesis = "duration variance spiking — likely external dep slowdown (network/disk/db)";
+            confidence = 0.55;
+            heals.push({ kind: "retry-with-backoff", rationale: "transient slowdown — backoff + retry" });
+        }
+        else {
+            hypothesis = "unknown — z-score breach but no clear pattern";
+            confidence = 0.3;
+            heals.push({ kind: "noop", rationale: "insufficient signal — record + observe one more cycle before acting" });
+        }
+    }
+    return {
+        fnId: input.brokenFinding.fnId,
+        hypothesis,
+        upstreamSuspects,
+        confidence,
+        proposedHeal: heals,
+    };
+}
+/** Quick summary of recent ledger health. */
+export function ledgerHealth(recent) {
+    const broken = recent.filter((f) => f.outcome === "broken").length;
+    const warn = recent.filter((f) => f.outcome === "warn").length;
+    const healthy = recent.filter((f) => f.outcome === "healthy").length;
+    const total = recent.length || 1;
+    return { broken, warn, healthy, brokenRate: broken / total };
+}
+//# sourceMappingURL=wisdom_space.js.map

package/dist/protoplasm/wisdom_space.js.map

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

package/dist/reflog/index.d.ts

@@ -0,0 +1,165 @@
+/**
+ * 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.
+ */
+export interface FileSha {
+    /** Relative path from repo root, forward slashes. */
+    path: string;
+    /** SHA-256 hex of file content. "" if file absent. */
+    sha: string;
+    /** mtime ms. */
+    mtimeMs: number;
+}
+export interface Checkpoint {
+    id: string;
+    at: string;
+    /** Best-effort git HEAD ref at checkpoint time (empty if not a git repo). */
+    gitHead: string;
+    /** Pheromone tag: which AI agent was active. */
+    pheromone: string;
+    /** Per-file SHA snapshot. */
+    files: FileSha[];
+    /** Optional reason / label (e.g. "before refactor"). */
+    label?: string;
+    hmac: string;
+}
+export interface CheckpointInput {
+    /** Working directory. */
+    cwd?: string;
+    /** Optional label. */
+    label?: string;
+    /** Path globs to include (default ["**\/*"]). */
+    include?: string[];
+    /** Path globs to exclude. */
+    exclude?: string[];
+    /** Max files to track (default 5000). */
+    maxFiles?: number;
+}
+export interface RewindInput {
+    /** Working directory. */
+    cwd?: string;
+    /** Time window: "2h" / "30m" / "1d". Mutually exclusive with checkpointId. */
+    since?: string;
+    /** Specific checkpoint to rewind to. */
+    checkpointId?: string;
+    /** Include path globs (default = everything). */
+    include?: string[];
+    /** Exclude path globs (default = empty). */
+    exclude?: string[];
+    /** Only rewind files last touched by THIS pheromone. */
+    pheromone?: string;
+}
+export interface RewindEntry {
+    /** Relative path. */
+    path: string;
+    /** Current SHA. */
+    currentSha: string;
+    /** Target SHA (what to restore to). */
+    targetSha: string;
+    /** mtime at the target checkpoint. */
+    targetMtimeMs: number;
+    /** Pheromone tag at target checkpoint. */
+    targetPheromone: string;
+}
+export interface RewindProposal {
+    ok: boolean;
+    /** Target checkpoint. */
+    targetCheckpoint: {
+        id: string;
+        at: string;
+        label?: string;
+    };
+    /** Files that would be reverted. */
+    toRevert: RewindEntry[];
+    /** Files that would be kept (filtered out OR not in target checkpoint). */
+    toKeep: Array<{
+        path: string;
+        reason: string;
+    }>;
+    /** Plain-English summary. */
+    summary: string;
+    hmac: string;
+}
+export declare function detectPheromone(): string;
+export declare function createCheckpoint(input?: CheckpointInput): {
+    ok: boolean;
+    checkpoint: Checkpoint;
+    hint: string;
+};
+export declare function listCheckpoints(cwd: string): Array<{
+    id: string;
+    at: string;
+    label?: string;
+    fileCount: number;
+    pheromone: string;
+}>;
+export declare function readCheckpoint(cwd: string, id: string): Checkpoint | null;
+export declare function verifyCheckpoint(c: Checkpoint): boolean;
+export declare function rewindPreview(input: RewindInput): RewindProposal;
+export declare function verifyRewindProposal(r: RewindProposal): boolean;
+interface LedgerEntry {
+    kind: "checkpoint" | "rewind_preview" | "rewind_apply";
+    at: string;
+    id: 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 renderRewindBanner(r: RewindProposal): string;
+export {};
+//# sourceMappingURL=index.d.ts.map

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

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