@mneme-ai/core 2.31.0 → 2.33.0

package/dist/flywheel/harvest.js

@@ -0,0 +1,327 @@
+/**
+ * v2.32.0 — FLYWHEEL HARVEST stage.
+ *
+ * Pulls raw findings from every source primitive's existing ledger.
+ * Pure file reads + JSONL parsing — NO new state, NO new primitive
+ * call. Every reader is best-effort: a missing file = empty list
+ * (FLYWHEEL still emits a useful report on a fresh install).
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+function daysBetween(isoA, isoB) {
+    const a = Date.parse(isoA);
+    const b = Date.parse(isoB);
+    if (Number.isNaN(a) || Number.isNaN(b))
+        return 0;
+    return Math.max(0, Math.round((b - a) / 86_400_000));
+}
+function safeJsonl(p, limit) {
+    if (!existsSync(p))
+        return [];
+    try {
+        const body = readFileSync(p, "utf8");
+        const lines = body.split("\n").filter(Boolean);
+        const slice = lines.slice(-limit);
+        const out = [];
+        for (const ln of slice) {
+            try {
+                out.push(JSON.parse(ln));
+            }
+            catch { /* skip */ }
+        }
+        return out;
+    }
+    catch {
+        return [];
+    }
+}
+export function harvestTruthGate(repoRoot, limit) {
+    const p = join(repoRoot, ".mneme", "truth_gate", "matrix.jsonl");
+    const rows = safeJsonl(p, limit);
+    const now = new Date().toISOString();
+    const out = [];
+    for (const r of rows) {
+        const at = r.finishedAt ?? now;
+        for (const d of r.drifted ?? []) {
+            if (!d.claimId)
+                continue;
+            out.push({
+                source: "truth_gate",
+                id: `${d.claimId}`,
+                headline: d.headline ?? `TRUTH GATE drift on ${d.claimId}`,
+                severity: "warn",
+                firstSeen: at, lastSeen: at,
+                ageDays: daysBetween(at, now),
+                detail: { claimId: d.claimId },
+            });
+        }
+    }
+    return out;
+}
+export function harvestGauntlet(repoRoot, limit) {
+    const p = join(repoRoot, ".mneme", "tune", "scorecard.jsonl");
+    const rows = safeJsonl(p, limit);
+    const now = new Date().toISOString();
+    const out = [];
+    const last = rows[rows.length - 1];
+    if (!last)
+        return out;
+    const at = last.finishedAt ?? now;
+    for (const f of last.findings ?? []) {
+        if (!f.id || typeof f.stars !== "number")
+            continue;
+        if (f.stars >= 10)
+            continue;
+        out.push({
+            source: "peak_gauntlet",
+            id: f.id,
+            headline: f.title ? `${f.id} ${f.stars}★: ${f.title}` : `${f.id} ${f.stars}★`,
+            severity: f.stars <= 5 ? "block" : "warn",
+            firstSeen: at, lastSeen: at,
+            ageDays: daysBetween(at, now),
+            detail: { stars: f.stars, title: f.title },
+        });
+    }
+    return out;
+}
+export function harvestHonestMirror(repoRoot, limit) {
+    const p = join(repoRoot, ".mneme", "honest_mirror", "reports.jsonl");
+    const rows = safeJsonl(p, limit);
+    const now = new Date().toISOString();
+    const out = [];
+    for (const r of rows) {
+        if (r.trafficLight === "green")
+            continue;
+        const at = r.finishedAt ?? now;
+        for (const v of r.perVendor ?? []) {
+            if (!v.vendor || typeof v.delta !== "number")
+                continue;
+            // Skip mock vendors — their deterministic answers can't match real
+            // commit diffs, so they're not an honest calibration signal (same
+            // filter TRUTH GATE applies in probes.ts).
+            if (v.vendor.startsWith("mock") || v.vendor.includes("@mock"))
+                continue;
+            const abs = Math.abs(v.delta);
+            if (abs < 0.1)
+                continue;
+            out.push({
+                source: "honest_mirror",
+                id: `vendor:${v.vendor}`,
+                headline: `${v.vendor} calibration Δ=${(v.delta * 100).toFixed(0)}%`,
+                severity: abs >= 0.25 ? "block" : "warn",
+                firstSeen: at, lastSeen: at,
+                ageDays: daysBetween(at, now),
+                detail: { vendor: v.vendor, delta: v.delta, weight: v.weight },
+            });
+        }
+    }
+    return out;
+}
+export function harvestRewind(repoRoot, limit) {
+    const p = join(repoRoot, ".mneme", "rewind", "cards.jsonl");
+    const rows = safeJsonl(p, limit);
+    const now = new Date().toISOString();
+    const out = [];
+    for (const r of rows) {
+        if (r.regression !== "regression")
+            continue;
+        const at = r.runAt ?? now;
+        out.push({
+            source: "rewind",
+            id: `vendor:${r.vendor ?? "?"}@${r.vendorVersion ?? "?"}`,
+            headline: r.headline ?? `REWIND regression for ${r.vendor}@${r.vendorVersion}`,
+            severity: Math.abs(r.delta ?? 0) >= 0.15 ? "block" : "warn",
+            firstSeen: at, lastSeen: at,
+            ageDays: daysBetween(at, now),
+            detail: { vendor: r.vendor, vendorVersion: r.vendorVersion, delta: r.delta, weight: r.weight },
+        });
+    }
+    return out;
+}
+export function harvestHgp(repoRoot, limit) {
+    const p = join(repoRoot, ".mneme", "hgp", "registry.jsonl");
+    const rows = safeJsonl(p, limit);
+    // Collapse by id, pick top-N by severity (recompute on collapsed view).
+    const byId = new Map();
+    for (const r of rows) {
+        if (!r.hgpId)
+            continue;
+        const cur = byId.get(r.hgpId);
+        if (!cur) {
+            byId.set(r.hgpId, { ...r });
+            continue;
+        }
+        cur.lastSeen = (r.lastSeen ?? cur.lastSeen);
+        cur.observeCount = (cur.observeCount ?? 0) + (r.observeCount ?? 0);
+        cur.vendorCounts = { ...cur.vendorCounts };
+        for (const [v, c] of Object.entries(r.vendorCounts ?? {})) {
+            cur.vendorCounts[v] = (cur.vendorCounts[v] ?? 0) + c;
+        }
+    }
+    const now = new Date().toISOString();
+    const out = [];
+    for (const r of byId.values()) {
+        const sev = (r.severity ?? 0);
+        if (sev < 0.3)
+            continue;
+        out.push({
+            source: "hgp",
+            id: r.hgpId,
+            headline: `${r.hgpId} severity ${sev.toFixed(2)} · ${r.observeCount ?? 0} obs · ${Object.keys(r.vendorCounts ?? {}).length} vendor(s)`,
+            severity: sev >= 0.7 ? "block" : "warn",
+            firstSeen: r.firstSeen ?? now,
+            lastSeen: r.lastSeen ?? now,
+            ageDays: daysBetween(r.lastSeen ?? now, now),
+            detail: { hgpId: r.hgpId, simhash: r.simhash, observeCount: r.observeCount, vendorCounts: r.vendorCounts, sample: r.sample },
+        });
+    }
+    return out;
+}
+export function harvestCitizenCourt(repoRoot, limit) {
+    const p = join(repoRoot, ".mneme", "citizen_court", "verdicts.jsonl");
+    const rows = safeJsonl(p, limit);
+    const now = new Date().toISOString();
+    // Aggregate per-vendor loss count over the window. Only surface as
+    // a finding when a vendor lost >= 3 decisive votes (small-sample
+    // suppression mirrors HSC banding rules).
+    const losses = new Map();
+    for (const r of rows) {
+        if (!r.votedMostTruthful || r.votedMostTruthful === "ABSTAIN")
+            continue;
+        const parties = new Set([
+            ...(r.primaryVendor ? [r.primaryVendor] : []),
+            ...(r.reveals ?? []).map((rv) => rv.vendor ?? "").filter(Boolean),
+        ]);
+        for (const p of parties) {
+            if (p === r.votedMostTruthful)
+                continue;
+            const cur = losses.get(p) ?? { count: 0, lastAt: r.at ?? now };
+            cur.count++;
+            if (r.at && r.at > cur.lastAt)
+                cur.lastAt = r.at;
+            losses.set(p, cur);
+        }
+    }
+    const out = [];
+    for (const [vendor, info] of losses.entries()) {
+        if (info.count < 3)
+            continue;
+        out.push({
+            source: "citizen_court",
+            id: `vendor:${vendor}`,
+            headline: `CITIZEN COURT: ${vendor} lost ${info.count} verdict(s)`,
+            severity: info.count >= 10 ? "block" : "warn",
+            firstSeen: info.lastAt, lastSeen: info.lastAt,
+            ageDays: daysBetween(info.lastAt, now),
+            detail: { vendor, lossCount: info.count },
+        });
+    }
+    return out;
+}
+export function harvestCommandHistory(repoRoot, limit) {
+    const p = join(repoRoot, ".mneme", "flywheel", "cmd_history.jsonl");
+    return safeJsonl(p, limit);
+}
+// ── Marketing diff harvest ──────────────────────────────────────────
+// Scans README + docs/*.md for numeric / categorical assertions that
+// LOOK like measurable claims but have no probe binding in TRUTH GATE.
+// Recommends ADDING a probe (heal action).
+const NUMERIC_CLAIM_RX = /\b(\d{1,5})\s*(\/\s*\d{1,5})?\s*(primitives|tools|tests|cards|claims|HGP-IDs|findings|vendors|attack vectors|stars|points)\b/gi;
+const SUPERLATIVE_RX = /\b(world-first|world's first|the only|first ever|never before|no AI tool)\b/gi;
+export function harvestMarketing(repoRoot, knownBoundClaimIds) {
+    const candidates = [];
+    for (const file of ["README.md", "docs/FUNCTIONS-EN.md", "docs/FUNCTIONS-TH.md"]) {
+        const p = join(repoRoot, file);
+        if (!existsSync(p))
+            continue;
+        try {
+            const body = readFileSync(p, "utf8");
+            for (const m of body.matchAll(NUMERIC_CLAIM_RX)) {
+                candidates.push({ file, text: m[0], kind: "numeric" });
+            }
+            for (const m of body.matchAll(SUPERLATIVE_RX)) {
+                candidates.push({ file, text: m[0], kind: "superlative" });
+            }
+        }
+        catch { /* skip */ }
+    }
+    // Dedup by (file, text).
+    const seen = new Set();
+    const unique = [];
+    for (const c of candidates) {
+        const k = `${c.file}|${c.text.toLowerCase()}`;
+        if (seen.has(k))
+            continue;
+        seen.add(k);
+        unique.push(c);
+    }
+    // For v2.32.0 we report all UNIQUE claim candidates as candidates
+    // for binding — TRUTH GATE catalog growth is tracked separately.
+    // A future version will simhash-match candidates to known bound
+    // claim ids; for now we surface them all as info-level findings.
+    void knownBoundClaimIds;
+    const now = new Date().toISOString();
+    const out = [];
+    for (const c of unique) {
+        out.push({
+            source: "marketing_diff",
+            id: `${c.file}::${c.text.slice(0, 40).toLowerCase().replace(/\s+/g, "_")}`,
+            headline: `${c.kind} claim in ${c.file}: "${c.text}"`,
+            severity: "info",
+            firstSeen: now, lastSeen: now,
+            ageDays: 0,
+            detail: { file: c.file, text: c.text, kind: c.kind },
+        });
+    }
+    return out;
+}
+export function harvestLiveness(repoRoot, registrySnapshot, minDeleteAge) {
+    const p = join(repoRoot, ".mneme", "flywheel", "primitive_ledger.jsonl");
+    const beats = safeJsonl(p, 10000);
+    // FIRST-RUN GRACE: if the ledger has fewer than 5 heartbeats, we
+    // haven't seen enough live traffic to call anything "dormant" yet.
+    // Skip the dormant check until the system has been used a bit.
+    // Without this guard, the FIRST flywheel.run on a fresh install
+    // would flag every shipped primitive as dormant (correct logic but
+    // useless signal — nothing has had a chance to fire).
+    if (beats.length < 5)
+        return [];
+    const lastSeenByName = new Map();
+    const shippedByName = new Map();
+    for (const b of beats) {
+        if (!b.name)
+            continue;
+        const cur = lastSeenByName.get(b.name);
+        if (!cur || b.at > cur)
+            lastSeenByName.set(b.name, b.at);
+        if (b.shippedAt && !shippedByName.has(b.name))
+            shippedByName.set(b.name, b.shippedAt);
+    }
+    const now = new Date().toISOString();
+    const out = [];
+    for (const prim of registrySnapshot) {
+        const last = lastSeenByName.get(prim.name);
+        // Only treat as dormant if we have a known shipped date. Without
+        // shippedAt, we can't honestly say it's "old" — could be a brand
+        // new primitive that just hasn't beat yet.
+        const shipped = shippedByName.get(prim.name);
+        if (last)
+            continue; // alive
+        if (!shipped)
+            continue; // unknown age — don't flag
+        const ageDays = daysBetween(shipped, now);
+        if (ageDays < minDeleteAge)
+            continue;
+        out.push({
+            source: "primitive_registry",
+            id: prim.name,
+            headline: `Dormant primitive: ${prim.name} (shipped ${ageDays}d ago, never invoked)`,
+            severity: ageDays >= 90 ? "block" : "warn",
+            firstSeen: shipped, lastSeen: shipped,
+            ageDays,
+            detail: { name: prim.name, sinceVersion: prim.sinceVersion ?? "?" },
+        });
+    }
+    return out;
+}
+//# sourceMappingURL=harvest.js.map

package/dist/flywheel/harvest.js.map

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

package/dist/flywheel/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * v2.32.0 — FLYWHEEL public surface.
+ *
+ * Self-reflective release organ that closes 4 historic Mneme
+ * weakness loops: tool sprawl + solo-dev asymmetry + wiring lag +
+ * marketing drift. 5-stage controller HARVEST → FUSE → PRESCRIBE
+ * → EXECUTE → RECIPROCITY. Composes with TRUTH GATE + PEAK GAUNTLET
+ * + HONEST MIRROR + REWIND + HGP via the SAME
+ * .mneme/aletheia/honest_mirror_weights.json feedback file.
+ */
+export type { Severity, SignalSource, RawFinding, FusedFinding, ActionKind, PrescribedAction, ReciprocityEntry, FlywheelReport, FlywheelOptions, } from "./types.js";
+export { harvestTruthGate, harvestGauntlet, harvestHonestMirror, harvestRewind, harvestHgp, harvestCommandHistory, harvestMarketing, harvestLiveness, } from "./harvest.js";
+export type { MarketingClaim } from "./harvest.js";
+export { fuse, distinctClusterCount } from "./fuse.js";
+export { prescribe } from "./prescribe.js";
+export { computeCheatsheet, recordCommand, readHistory, renderCheatsheetMarkdown, } from "./personal_cheatsheet.js";
+export type { CheatsheetEntry, CheatsheetSnapshot } from "./personal_cheatsheet.js";
+export { heartbeat, readHeartbeats, lastSeenMap, } from "./liveness.js";
+export type { PrimitiveSnapshot } from "./liveness.js";
+export { gatherBulletinData, renderBulletinMarkdown, } from "./vendor_bulletin.js";
+export type { BulletinData } from "./vendor_bulletin.js";
+export { computeTrustDelta, recordResponse, readLedger as readReciprocityLedger, applyToAletheiaWeights, } from "./reciprocity.js";
+export type { RecordResponseParams } from "./reciprocity.js";
+export { runFlywheel, listReports, readLatestReport, verifyReport, blockingActions, __resetFlywheelChainForTest, } from "./controller.js";
+export type { RunInput, ReportLedgerEntry } from "./controller.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/flywheel/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,YAAY,EACV,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,UAAU,EAC5D,gBAAgB,EAAE,gBAAgB,EAAE,cAAc,EAAE,eAAe,GACpE,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,gBAAgB,EAAE,eAAe,EAAE,mBAAmB,EACtD,aAAa,EAAE,UAAU,EAAE,qBAAqB,EAChD,gBAAgB,EAAE,eAAe,GAClC,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,OAAO,EAAE,IAAI,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,OAAO,EACL,iBAAiB,EAAE,aAAa,EAAE,WAAW,EAAE,wBAAwB,GACxE,MAAM,0BAA0B,CAAC;AAClC,YAAY,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAEpF,OAAO,EACL,SAAS,EAAE,cAAc,EAAE,WAAW,GACvC,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAEvD,OAAO,EACL,kBAAkB,EAAE,sBAAsB,GAC3C,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEzD,OAAO,EACL,iBAAiB,EAAE,cAAc,EAAE,UAAU,IAAI,qBAAqB,EACtE,sBAAsB,GACvB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAE7D,OAAO,EACL,WAAW,EAAE,WAAW,EAAE,gBAAgB,EAAE,YAAY,EAAE,eAAe,EACzE,2BAA2B,GAC5B,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/flywheel/index.js

@@ -0,0 +1,19 @@
+/**
+ * v2.32.0 — FLYWHEEL public surface.
+ *
+ * Self-reflective release organ that closes 4 historic Mneme
+ * weakness loops: tool sprawl + solo-dev asymmetry + wiring lag +
+ * marketing drift. 5-stage controller HARVEST → FUSE → PRESCRIBE
+ * → EXECUTE → RECIPROCITY. Composes with TRUTH GATE + PEAK GAUNTLET
+ * + HONEST MIRROR + REWIND + HGP via the SAME
+ * .mneme/aletheia/honest_mirror_weights.json feedback file.
+ */
+export { harvestTruthGate, harvestGauntlet, harvestHonestMirror, harvestRewind, harvestHgp, harvestCommandHistory, harvestMarketing, harvestLiveness, } from "./harvest.js";
+export { fuse, distinctClusterCount } from "./fuse.js";
+export { prescribe } from "./prescribe.js";
+export { computeCheatsheet, recordCommand, readHistory, renderCheatsheetMarkdown, } from "./personal_cheatsheet.js";
+export { heartbeat, readHeartbeats, lastSeenMap, } from "./liveness.js";
+export { gatherBulletinData, renderBulletinMarkdown, } from "./vendor_bulletin.js";
+export { computeTrustDelta, recordResponse, readLedger as readReciprocityLedger, applyToAletheiaWeights, } from "./reciprocity.js";
+export { runFlywheel, listReports, readLatestReport, verifyReport, blockingActions, __resetFlywheelChainForTest, } from "./controller.js";
+//# sourceMappingURL=index.js.map

package/dist/flywheel/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/flywheel/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAOH,OAAO,EACL,gBAAgB,EAAE,eAAe,EAAE,mBAAmB,EACtD,aAAa,EAAE,UAAU,EAAE,qBAAqB,EAChD,gBAAgB,EAAE,eAAe,GAClC,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,IAAI,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,OAAO,EACL,iBAAiB,EAAE,aAAa,EAAE,WAAW,EAAE,wBAAwB,GACxE,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EACL,SAAS,EAAE,cAAc,EAAE,WAAW,GACvC,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,kBAAkB,EAAE,sBAAsB,GAC3C,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,iBAAiB,EAAE,cAAc,EAAE,UAAU,IAAI,qBAAqB,EACtE,sBAAsB,GACvB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,WAAW,EAAE,WAAW,EAAE,gBAAgB,EAAE,YAAY,EAAE,eAAe,EACzE,2BAA2B,GAC5B,MAAM,iBAAiB,CAAC"}

package/dist/flywheel/liveness.d.ts

@@ -0,0 +1,34 @@
+/**
+ * v2.32.0 — Primitive liveness ledger.
+ *
+ * Every time an MCP tool fires (or the universal CLI router invokes
+ * a primitive), the caller can push a heartbeat row to
+ * .mneme/flywheel/primitive_ledger.jsonl. FLYWHEEL HARVEST reads this
+ * to detect dormant primitives.
+ *
+ * v2.32.0 ships the ledger primitive + harvest reader; wiring every
+ * MCP tool to auto-push a heartbeat is a v2.32.x enhancement to avoid
+ * cross-package coupling in v1. For now, tests + manual probes push
+ * heartbeats explicitly.
+ */
+interface Heartbeat {
+    name: string;
+    at: string;
+    shippedAt?: string;
+}
+export declare function heartbeat(repoRoot: string, name: string, shippedAt?: string): void;
+export declare function readHeartbeats(repoRoot: string, limit?: number): Heartbeat[];
+/** Last-seen per primitive name. */
+export declare function lastSeenMap(repoRoot: string): Map<string, string>;
+/**
+ * Snapshot of every primitive currently registered (name +
+ * sinceVersion). Caller supplies this — we keep the dependency
+ * surface tiny by accepting a parameter (so flywheel doesn't have to
+ * cross-import the agent_manifest catalog).
+ */
+export interface PrimitiveSnapshot {
+    name: string;
+    sinceVersion?: string;
+}
+export {};
+//# sourceMappingURL=liveness.d.ts.map

package/dist/flywheel/liveness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"liveness.d.ts","sourceRoot":"","sources":["../../src/flywheel/liveness.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,UAAU,SAAS;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAYD,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAMlF;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,SAAQ,GAAG,SAAS,EAAE,CAW3E;AAED,oCAAoC;AACpC,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAOjE;AAED;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB"}

package/dist/flywheel/liveness.js

@@ -0,0 +1,63 @@
+/**
+ * v2.32.0 — Primitive liveness ledger.
+ *
+ * Every time an MCP tool fires (or the universal CLI router invokes
+ * a primitive), the caller can push a heartbeat row to
+ * .mneme/flywheel/primitive_ledger.jsonl. FLYWHEEL HARVEST reads this
+ * to detect dormant primitives.
+ *
+ * v2.32.0 ships the ledger primitive + harvest reader; wiring every
+ * MCP tool to auto-push a heartbeat is a v2.32.x enhancement to avoid
+ * cross-package coupling in v1. For now, tests + manual probes push
+ * heartbeats explicitly.
+ */
+import { existsSync, mkdirSync, appendFileSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+function dirOf(repoRoot) {
+    const d = join(repoRoot, ".mneme", "flywheel");
+    if (!existsSync(d))
+        mkdirSync(d, { recursive: true });
+    return d;
+}
+function ledgerPath(repoRoot) {
+    return join(dirOf(repoRoot), "primitive_ledger.jsonl");
+}
+export function heartbeat(repoRoot, name, shippedAt) {
+    try {
+        const row = { name, at: new Date().toISOString() };
+        if (shippedAt)
+            row.shippedAt = shippedAt;
+        appendFileSync(ledgerPath(repoRoot), JSON.stringify(row) + "\n", "utf8");
+    }
+    catch { /* best-effort */ }
+}
+export function readHeartbeats(repoRoot, limit = 10000) {
+    const p = ledgerPath(repoRoot);
+    if (!existsSync(p))
+        return [];
+    try {
+        const body = readFileSync(p, "utf8");
+        const out = [];
+        for (const ln of body.split("\n").filter(Boolean).slice(-limit)) {
+            try {
+                out.push(JSON.parse(ln));
+            }
+            catch { /* skip */ }
+        }
+        return out;
+    }
+    catch {
+        return [];
+    }
+}
+/** Last-seen per primitive name. */
+export function lastSeenMap(repoRoot) {
+    const out = new Map();
+    for (const b of readHeartbeats(repoRoot)) {
+        const cur = out.get(b.name);
+        if (!cur || b.at > cur)
+            out.set(b.name, b.at);
+    }
+    return out;
+}
+//# sourceMappingURL=liveness.js.map

package/dist/flywheel/liveness.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"liveness.js","sourceRoot":"","sources":["../../src/flywheel/liveness.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC9E,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAQjC,SAAS,KAAK,CAAC,QAAgB;IAC7B,MAAM,CAAC,GAAG,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC;IAC/C,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;QAAE,SAAS,CAAC,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,SAAS,UAAU,CAAC,QAAgB;IAClC,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,wBAAwB,CAAC,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,QAAgB,EAAE,IAAY,EAAE,SAAkB;IAC1E,IAAI,CAAC;QACH,MAAM,GAAG,GAAc,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC;QAC9D,IAAI,SAAS;YAAE,GAAG,CAAC,SAAS,GAAG,SAAS,CAAC;QACzC,cAAc,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC;IAC3E,CAAC;IAAC,MAAM,CAAC,CAAC,iBAAiB,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,QAAgB,EAAE,KAAK,GAAG,KAAK;IAC5D,MAAM,CAAC,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;IAC/B,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;QAAE,OAAO,EAAE,CAAC;IAC9B,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;QACrC,MAAM,GAAG,GAAgB,EAAE,CAAC;QAC5B,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;YAChE,IAAI,CAAC;gBAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAc,CAAC,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC,CAAC,UAAU,CAAC,CAAC;QACrE,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,EAAE,CAAC;IAAC,CAAC;AACxB,CAAC;AAED,oCAAoC;AACpC,MAAM,UAAU,WAAW,CAAC,QAAgB;IAC1C,MAAM,GAAG,GAAG,IAAI,GAAG,EAAkB,CAAC;IACtC,KAAK,MAAM,CAAC,IAAI,cAAc,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzC,MAAM,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC5B,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC,EAAE,GAAG,GAAG;YAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;IAChD,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/flywheel/personal_cheatsheet.d.ts

@@ -0,0 +1,34 @@
+/**
+ * v2.32.0 — Personal cheatsheet engine.
+ *
+ * Reads .mneme/flywheel/cmd_history.jsonl, counts invocations per
+ * command, returns top-3 along with a header explaining that the
+ * cheatsheet *shrinks* over time as the user specializes.
+ *
+ * Fresh-install fallback: if < 5 history rows, return the global
+ * recommended top-5 — the highest-leverage commands for new users.
+ */
+interface CmdHistoryRow {
+    command: string;
+    at: string;
+}
+export declare function recordCommand(repoRoot: string, command: string): void;
+export declare function readHistory(repoRoot: string, limit?: number): CmdHistoryRow[];
+export interface CheatsheetEntry {
+    command: string;
+    why: string;
+    invocations?: number;
+}
+export interface CheatsheetSnapshot {
+    entries: CheatsheetEntry[];
+    /** "personalized" | "fresh_install" */
+    mode: "personalized" | "fresh_install";
+    /** ISO of latest row used. */
+    basedOn: string | null;
+    /** Plain-English explanation for the user. */
+    header: string;
+}
+export declare function computeCheatsheet(repoRoot: string): CheatsheetSnapshot;
+export declare function renderCheatsheetMarkdown(snap: CheatsheetSnapshot): string;
+export {};
+//# sourceMappingURL=personal_cheatsheet.d.ts.map

package/dist/flywheel/personal_cheatsheet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"personal_cheatsheet.d.ts","sourceRoot":"","sources":["../../src/flywheel/personal_cheatsheet.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAaH,UAAU,aAAa;IAAG,OAAO,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;CAAE;AAYxD,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAIrE;AAED,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,SAAO,GAAG,aAAa,EAAE,CAY3E;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,uCAAuC;IACvC,IAAI,EAAE,cAAc,GAAG,eAAe,CAAC;IACvC,8BAA8B;IAC9B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,8CAA8C;IAC9C,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,kBAAkB,CAwBtE;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,kBAAkB,GAAG,MAAM,CAazE"}

package/dist/flywheel/personal_cheatsheet.js

@@ -0,0 +1,95 @@
+/**
+ * v2.32.0 — Personal cheatsheet engine.
+ *
+ * Reads .mneme/flywheel/cmd_history.jsonl, counts invocations per
+ * command, returns top-3 along with a header explaining that the
+ * cheatsheet *shrinks* over time as the user specializes.
+ *
+ * Fresh-install fallback: if < 5 history rows, return the global
+ * recommended top-5 — the highest-leverage commands for new users.
+ */
+import { existsSync, mkdirSync, appendFileSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+const GLOBAL_TOP5 = [
+    { command: "mneme verify \"<claim>\"", why: "Truth-check ANY factual claim before relaying — refuses to hallucinate." },
+    { command: "mneme welcome", why: "Install handoff + what's changed since last session — start here." },
+    { command: "mneme flywheel run", why: "Run the self-reflective audit — closes the 4 loops every release." },
+    { command: "mneme honest_mirror calibrate", why: "Tune vendor trust on YOUR own past commits — eval-aware-defeating." },
+    { command: "mneme rewind run", why: "Track vendor regression on YOUR repo as new model versions ship." },
+];
+function dirOf(repoRoot) {
+    const d = join(repoRoot, ".mneme", "flywheel");
+    if (!existsSync(d))
+        mkdirSync(d, { recursive: true });
+    return d;
+}
+function historyPath(repoRoot) {
+    return join(dirOf(repoRoot), "cmd_history.jsonl");
+}
+export function recordCommand(repoRoot, command) {
+    try {
+        appendFileSync(historyPath(repoRoot), JSON.stringify({ command, at: new Date().toISOString() }) + "\n", "utf8");
+    }
+    catch { /* best-effort */ }
+}
+export function readHistory(repoRoot, limit = 1000) {
+    const p = historyPath(repoRoot);
+    if (!existsSync(p))
+        return [];
+    try {
+        const body = readFileSync(p, "utf8");
+        const lines = body.split("\n").filter(Boolean);
+        const out = [];
+        for (const ln of lines.slice(-limit)) {
+            try {
+                out.push(JSON.parse(ln));
+            }
+            catch { /* skip */ }
+        }
+        return out;
+    }
+    catch {
+        return [];
+    }
+}
+export function computeCheatsheet(repoRoot) {
+    const history = readHistory(repoRoot, 5000);
+    if (history.length < 5) {
+        return {
+            entries: GLOBAL_TOP5.map((g) => ({ ...g })),
+            mode: "fresh_install",
+            basedOn: history.length === 0 ? null : history[history.length - 1].at,
+            header: "Fresh install — here are the 5 highest-leverage commands. Use Mneme for a few days and the cheatsheet auto-shrinks to YOUR top-3.",
+        };
+    }
+    // Count invocations per command, keep top-3.
+    const counts = new Map();
+    for (const row of history)
+        counts.set(row.command, (counts.get(row.command) ?? 0) + 1);
+    const sorted = Array.from(counts.entries()).sort((a, b) => b[1] - a[1]).slice(0, 3);
+    return {
+        entries: sorted.map(([command, n]) => ({
+            command,
+            why: GLOBAL_TOP5.find((g) => command.startsWith(g.command.split(" ")[0]))?.why ?? "Frequently used by you.",
+            invocations: n,
+        })),
+        mode: "personalized",
+        basedOn: history[history.length - 1].at,
+        header: `Personal cheatsheet: top-3 commands you actually use (from ${history.length} invocations).`,
+    };
+}
+export function renderCheatsheetMarkdown(snap) {
+    const lines = [];
+    lines.push(`# Mneme — Personal Cheatsheet`);
+    lines.push(``);
+    lines.push(`> ${snap.header}`);
+    lines.push(``);
+    for (const e of snap.entries) {
+        lines.push(`- \`${e.command}\` — ${e.why}${typeof e.invocations === "number" ? ` (${e.invocations}×)` : ""}`);
+    }
+    lines.push(``);
+    lines.push(`---`);
+    lines.push(`Mode: ${snap.mode} · basedOn: ${snap.basedOn ?? "(no history yet)"}`);
+    return lines.join("\n");
+}
+//# sourceMappingURL=personal_cheatsheet.js.map