@mneme-ai/core 2.31.0 → 2.32.0

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

package/dist/flywheel/personal_cheatsheet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"personal_cheatsheet.js","sourceRoot":"","sources":["../../src/flywheel/personal_cheatsheet.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC9E,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,WAAW,GAA4C;IAC3D,EAAE,OAAO,EAAE,0BAA0B,EAAE,GAAG,EAAE,yEAAyE,EAAE;IACvH,EAAE,OAAO,EAAE,eAAe,EAAE,GAAG,EAAE,mEAAmE,EAAE;IACtG,EAAE,OAAO,EAAE,oBAAoB,EAAE,GAAG,EAAE,mEAAmE,EAAE;IAC3G,EAAE,OAAO,EAAE,+BAA+B,EAAE,GAAG,EAAE,oEAAoE,EAAE;IACvH,EAAE,OAAO,EAAE,kBAAkB,EAAE,GAAG,EAAE,kEAAkE,EAAE;CACzG,CAAC;AAIF,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,WAAW,CAAC,QAAgB;IACnC,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,mBAAmB,CAAC,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,QAAgB,EAAE,OAAe;IAC7D,IAAI,CAAC;QACH,cAAc,CAAC,WAAW,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC;IAClH,CAAC;IAAC,MAAM,CAAC,CAAC,iBAAiB,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,QAAgB,EAAE,KAAK,GAAG,IAAI;IACxD,MAAM,CAAC,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC;IAChC,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,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC/C,MAAM,GAAG,GAAoB,EAAE,CAAC;QAChC,KAAK,MAAM,EAAE,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;YACrC,IAAI,CAAC;gBAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAkB,CAAC,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC,CAAC,UAAU,CAAC,CAAC;QACzE,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,EAAE,CAAC;IAAC,CAAC;AACxB,CAAC;AAkBD,MAAM,UAAU,iBAAiB,CAAC,QAAgB;IAChD,MAAM,OAAO,GAAG,WAAW,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IAC5C,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO;YACL,OAAO,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;YAC3C,IAAI,EAAE,eAAe;YACrB,OAAO,EAAE,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC,EAAE;YACtE,MAAM,EAAE,mIAAmI;SAC5I,CAAC;IACJ,CAAC;IACD,6CAA6C;IAC7C,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;IACzC,KAAK,MAAM,GAAG,IAAI,OAAO;QAAE,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACvF,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACpF,OAAO;QACL,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACrC,OAAO;YACP,GAAG,EAAE,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC,CAAC,EAAE,GAAG,IAAI,yBAAyB;YAC5G,WAAW,EAAE,CAAC;SACf,CAAC,CAAC;QACH,IAAI,EAAE,cAAc;QACpB,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC,EAAE;QACxC,MAAM,EAAE,8DAA8D,OAAO,CAAC,MAAM,gBAAgB;KACrG,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,IAAwB;IAC/D,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;IAC5C,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IAC/B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QAC7B,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,OAAO,QAAQ,CAAC,CAAC,GAAG,GAAG,OAAO,CAAC,CAAC,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAChH,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClB,KAAK,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,IAAI,eAAe,IAAI,CAAC,OAAO,IAAI,kBAAkB,EAAE,CAAC,CAAC;IAClF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/flywheel/prescribe.d.ts

@@ -0,0 +1,20 @@
+/**
+ * v2.32.0 — FLYWHEEL PRESCRIBE stage.
+ *
+ * Turns fused findings into 5 action kinds:
+ *
+ *   heal    — auto-draft PR to fix a TRUTH GATE drift or marketing
+ *             claim. Artifact = markdown PR body.
+ *   wire    — auto-draft PR to add CLI/MCP surface for a dormant
+ *             primitive. Artifact = checklist + concrete file paths.
+ *   delete  — recommend removing a primitive that has NO invocation
+ *             record AND no cross-source partners (truly unused).
+ *   shrink  — personal cheatsheet shrink to ≤ 3 cmds.
+ *   publish — Vendor Bulletin .md from REWIND + HGP + HONEST MIRROR.
+ *
+ * One action can close MULTIPLE findings (cluster bonus). PRESCRIBE
+ * groups findings by clusterId then emits one action per cluster.
+ */
+import type { FusedFinding, PrescribedAction } from "./types.js";
+export declare function prescribe(fused: FusedFinding[]): PrescribedAction[];
+//# sourceMappingURL=prescribe.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"prescribe.d.ts","sourceRoot":"","sources":["../../src/flywheel/prescribe.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAc,MAAM,YAAY,CAAC;AAiF7E,wBAAgB,SAAS,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,gBAAgB,EAAE,CAmBnE"}

package/dist/flywheel/prescribe.js

@@ -0,0 +1,119 @@
+/**
+ * v2.32.0 — FLYWHEEL PRESCRIBE stage.
+ *
+ * Turns fused findings into 5 action kinds:
+ *
+ *   heal    — auto-draft PR to fix a TRUTH GATE drift or marketing
+ *             claim. Artifact = markdown PR body.
+ *   wire    — auto-draft PR to add CLI/MCP surface for a dormant
+ *             primitive. Artifact = checklist + concrete file paths.
+ *   delete  — recommend removing a primitive that has NO invocation
+ *             record AND no cross-source partners (truly unused).
+ *   shrink  — personal cheatsheet shrink to ≤ 3 cmds.
+ *   publish — Vendor Bulletin .md from REWIND + HGP + HONEST MIRROR.
+ *
+ * One action can close MULTIPLE findings (cluster bonus). PRESCRIBE
+ * groups findings by clusterId then emits one action per cluster.
+ */
+function group(findings) {
+    const by = new Map();
+    for (const f of findings) {
+        const arr = by.get(f.clusterId) ?? [];
+        arr.push(f);
+        by.set(f.clusterId, arr);
+    }
+    return Array.from(by.entries()).map(([clusterId, fs]) => ({ clusterId, findings: fs }))
+        .sort((a, b) => Math.max(...b.findings.map((f) => f.compositeScore)) - Math.max(...a.findings.map((f) => f.compositeScore)));
+}
+function maxPriority(fs) {
+    return Math.max(...fs.map((f) => f.compositeScore));
+}
+function pickKind(fs) {
+    // Action kind is derived from the dominant source in the cluster.
+    // Priority order: primitive_registry → wire/delete, marketing_diff → heal,
+    // truth_gate → heal, hgp/rewind/honest_mirror → publish, command_history → shrink.
+    const sources = new Set(fs.map((f) => f.source));
+    if (sources.has("primitive_registry")) {
+        // Has cross-source partners → wire (composed with something useful).
+        // No partners → delete (truly unused).
+        const anyPartners = fs.some((f) => f.composedWith.length > 0);
+        return anyPartners ? "wire" : "delete";
+    }
+    if (sources.has("truth_gate") || sources.has("marketing_diff"))
+        return "heal";
+    if (sources.has("hgp") || sources.has("rewind") || sources.has("honest_mirror"))
+        return "publish";
+    if (sources.has("command_history"))
+        return "shrink";
+    return "heal";
+}
+function renderPRDraft(kind, fs) {
+    const lines = [];
+    lines.push(`# 🪄 FLYWHEEL ${kind.toUpperCase()} action`);
+    lines.push(``);
+    lines.push(`## Closes ${fs.length} finding(s)`);
+    lines.push(``);
+    for (const f of fs) {
+        lines.push(`- **${f.source}** ${f.id} — ${f.headline} (${f.severity}, score ${f.compositeScore})`);
+    }
+    if (fs.some((f) => f.composedWith.length > 0)) {
+        lines.push(``);
+        lines.push(`### Composition bonus`);
+        for (const f of fs) {
+            if (f.composedWith.length === 0)
+                continue;
+            lines.push(`- ${f.source}:${f.id} composes with: ${f.composedWith.map((p) => `${p.source}:${p.id}`).join(", ")}`);
+        }
+    }
+    lines.push(``);
+    lines.push(`## Suggested actions`);
+    lines.push(``);
+    if (kind === "heal") {
+        lines.push(`- Add probe binding in \`packages/core/src/truth_gate/probes.ts\``);
+        lines.push(`- Add claim row in \`packages/core/src/truth_gate/claims.ts\` referencing the new probe id`);
+        lines.push(`- OR remove the unbound marketing copy from the source file(s) listed above`);
+    }
+    else if (kind === "wire") {
+        const names = fs.map((f) => f.detail?.["name"] ?? f.id).join(", ");
+        lines.push(`- Add CLI surface for dormant primitive(s): ${names}`);
+        lines.push(`- Add MCP tool wrapper if missing`);
+        lines.push(`- Add 1 discrete pinned test that exercises the primitive`);
+        lines.push(`- Push a heartbeat row to \`.mneme/flywheel/primitive_ledger.jsonl\` to mark "alive"`);
+    }
+    else if (kind === "delete") {
+        const names = fs.map((f) => f.detail?.["name"] ?? f.id).join(", ");
+        lines.push(`- Confirm primitive(s) ${names} are NOT externally relied upon`);
+        lines.push(`- Remove the implementation file(s) + tests`);
+        lines.push(`- Remove the registry entry + manifest catalog row`);
+        lines.push(`- Update README/docs to remove any reference`);
+    }
+    else if (kind === "shrink") {
+        lines.push(`- The personal cheatsheet ledger suggests reducing the surface to the top-N most-used commands.`);
+    }
+    else if (kind === "publish") {
+        lines.push(`- Render the Vendor Bulletin markdown via \`mneme flywheel bulletin\` + post publicly`);
+        lines.push(`- Apply the auto-trust-delta from RECIPROCITY ledger to \`.mneme/aletheia/honest_mirror_weights.json\``);
+    }
+    return lines.join("\n");
+}
+export function prescribe(fused) {
+    const groups = group(fused);
+    const out = [];
+    for (const g of groups) {
+        const kind = pickKind(g.findings);
+        const priority = maxPriority(g.findings);
+        const closes = g.findings.map((f) => ({ source: f.source, id: f.id }));
+        const blocking = g.findings.some((f) => f.severity === "block");
+        const rationale = `${g.findings.length} finding(s) in cluster ${g.clusterId} (score ${priority}) — ${kind}.`;
+        out.push({
+            kind,
+            closesFindings: closes,
+            rationale,
+            artifact: renderPRDraft(kind, g.findings),
+            blocking,
+            priority,
+        });
+    }
+    return out;
+}
+//# sourceMappingURL=prescribe.js.map

package/dist/flywheel/prescribe.js.map

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

package/dist/flywheel/reciprocity.d.ts

@@ -0,0 +1,36 @@
+/**
+ * v2.32.0 — FLYWHEEL RECIPROCITY layer.
+ *
+ * Living negotiation organ with the AI vendor ecosystem. When a
+ * Vendor Bulletin is posted publicly (off-system), the user records
+ * the vendor's response here. Trust deltas auto-feed
+ * .mneme/aletheia/honest_mirror_weights.json (the same file HONEST
+ * MIRROR + REWIND already write to) — closing the loop.
+ *
+ * Trust delta rules (v2.32.0):
+ *   fix within 7 days       → +0.05
+ *   acknowledge within 7d   → +0.01
+ *   ignore > 30 days        → −0.10
+ *   disputed (with evidence)→  0.00 (neutral)
+ */
+import type { ReciprocityEntry } from "./types.js";
+export declare function computeTrustDelta(response: ReciprocityEntry["response"], reactionDays: number): number;
+export interface RecordResponseParams {
+    vendor: string;
+    bulletinSeq: number;
+    response: ReciprocityEntry["response"];
+    reactionDays: number;
+}
+export declare function recordResponse(repoRoot: string, params: RecordResponseParams): ReciprocityEntry;
+export declare function readLedger(repoRoot: string, limit?: number): ReciprocityEntry[];
+/**
+ * Apply the cumulative trust delta per vendor into the shared
+ * .mneme/aletheia/honest_mirror_weights.json file. Composes with the
+ * HONEST MIRROR + REWIND feedback loops — same destination, source
+ * field disambiguates ("reciprocity") so we never overwrite a
+ * fresher calibration.
+ *
+ * Returns the per-vendor net delta applied this run.
+ */
+export declare function applyToAletheiaWeights(repoRoot: string): Record<string, number>;
+//# sourceMappingURL=reciprocity.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reciprocity.d.ts","sourceRoot":"","sources":["../../src/flywheel/reciprocity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAKH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAYnD,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,gBAAgB,CAAC,UAAU,CAAC,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAKtG;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,gBAAgB,CAAC,UAAU,CAAC,CAAC;IACvC,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,oBAAoB,GAAG,gBAAgB,CAY/F;AAED,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,SAAM,GAAG,gBAAgB,EAAE,CAW5E;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CA4B/E"}

package/dist/flywheel/reciprocity.js

@@ -0,0 +1,113 @@
+/**
+ * v2.32.0 — FLYWHEEL RECIPROCITY layer.
+ *
+ * Living negotiation organ with the AI vendor ecosystem. When a
+ * Vendor Bulletin is posted publicly (off-system), the user records
+ * the vendor's response here. Trust deltas auto-feed
+ * .mneme/aletheia/honest_mirror_weights.json (the same file HONEST
+ * MIRROR + REWIND already write to) — closing the loop.
+ *
+ * Trust delta rules (v2.32.0):
+ *   fix within 7 days       → +0.05
+ *   acknowledge within 7d   → +0.01
+ *   ignore > 30 days        → −0.10
+ *   disputed (with evidence)→  0.00 (neutral)
+ */
+import { existsSync, mkdirSync, appendFileSync, readFileSync, writeFileSync } 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), "reciprocity.jsonl");
+}
+export function computeTrustDelta(response, reactionDays) {
+    if (response === "fix" && reactionDays <= 7)
+        return 0.05;
+    if (response === "acknowledge" && reactionDays <= 7)
+        return 0.01;
+    if (response === "ignore" && reactionDays >= 30)
+        return -0.10;
+    return 0.0;
+}
+export function recordResponse(repoRoot, params) {
+    const trustDelta = computeTrustDelta(params.response, params.reactionDays);
+    const entry = {
+        vendor: params.vendor,
+        bulletinSeq: params.bulletinSeq,
+        response: params.response,
+        reactionDays: params.reactionDays,
+        trustDelta,
+        at: new Date().toISOString(),
+    };
+    appendFileSync(ledgerPath(repoRoot), JSON.stringify(entry) + "\n", "utf8");
+    return entry;
+}
+export function readLedger(repoRoot, limit = 500) {
+    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 [];
+    }
+}
+/**
+ * Apply the cumulative trust delta per vendor into the shared
+ * .mneme/aletheia/honest_mirror_weights.json file. Composes with the
+ * HONEST MIRROR + REWIND feedback loops — same destination, source
+ * field disambiguates ("reciprocity") so we never overwrite a
+ * fresher calibration.
+ *
+ * Returns the per-vendor net delta applied this run.
+ */
+export function applyToAletheiaWeights(repoRoot) {
+    const ledger = readLedger(repoRoot);
+    const sumByVendor = {};
+    for (const e of ledger)
+        sumByVendor[e.vendor] = (sumByVendor[e.vendor] ?? 0) + e.trustDelta;
+    const aletheiaDir = join(repoRoot, ".mneme", "aletheia");
+    if (!existsSync(aletheiaDir))
+        mkdirSync(aletheiaDir, { recursive: true });
+    const aletheiaPath = join(aletheiaDir, "honest_mirror_weights.json");
+    const merged = {};
+    if (existsSync(aletheiaPath)) {
+        try {
+            Object.assign(merged, JSON.parse(readFileSync(aletheiaPath, "utf8")));
+        }
+        catch { /* corrupt — start fresh */ }
+    }
+    const applied = {};
+    for (const [vendor, delta] of Object.entries(sumByVendor)) {
+        const prior = merged[vendor]?.trust ?? 0.5;
+        // Only overwrite if the existing entry isn't from a fresher calibration
+        // pass (honest_mirror/rewind already wrote within the last hour).
+        const existing = merged[vendor];
+        if (existing && (existing.source === "honest_mirror" || existing.source === "rewind")) {
+            const minutesAgo = (Date.now() - Date.parse(existing.at)) / 60_000;
+            if (minutesAgo < 60) {
+                applied[vendor] = 0;
+                continue;
+            } // skip — fresher signal wins
+        }
+        const next = Math.max(0.1, Math.min(0.95, Number((prior + delta).toFixed(3))));
+        merged[vendor] = { trust: next, source: "reciprocity", at: new Date().toISOString() };
+        applied[vendor] = next - prior;
+    }
+    writeFileSync(aletheiaPath, JSON.stringify(merged, null, 2));
+    return applied;
+}
+//# sourceMappingURL=reciprocity.js.map

package/dist/flywheel/reciprocity.js.map

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

package/dist/flywheel/types.d.ts

@@ -0,0 +1,117 @@
+/**
+ * v2.32.0 — FLYWHEEL types.
+ *
+ * FLYWHEEL is the self-reflective release organ. It consumes signals
+ * from the 5 existing audit primitives (TRUTH GATE, PEAK GAUNTLET,
+ * HONEST MIRROR, REWIND, HGP) + command-history + primitive registry,
+ * fuses them via cross-pollination, and prescribes 5 action kinds
+ * (Heal / Wire / Delete / Shrink / Publish). Closes the 4 weakness
+ * loops Mneme has historically suffered from:
+ *
+ *   1. Tool sprawl       → Shrink (personal cheatsheet ≤ 3 cmds)
+ *   2. Solo-dev asymmetry → Publish (Vendor Bulletin .md) + cross-vendor reciprocity
+ *   3. Wiring lag         → Wire   (dormant primitives flagged + auto-PR draft)
+ *   4. Marketing drift    → Heal   (unbound claims flagged + auto-PR draft)
+ *
+ * 5-stage controller:
+ *   HARVEST → FUSE → PRESCRIBE → EXECUTE → RECIPROCITY
+ *
+ * The CREATIVE part: stage 5 RECIPROCITY records vendor responses to
+ * past bulletins. Vendors that fix within 7 days get +0.05 trust boost
+ * (auto-feeds aletheia weights); vendors that ignore for 30+ days get
+ * −0.10 penalty. Living negotiation organ with the AI vendor ecosystem.
+ */
+/** Severity ladder shared across all findings. */
+export type Severity = "info" | "warn" | "block";
+/** Source primitives we ingest signal from. */
+export type SignalSource = "truth_gate" | "peak_gauntlet" | "honest_mirror" | "rewind" | "hgp" | "command_history" | "primitive_registry" | "marketing_diff";
+export interface RawFinding {
+    /** Source primitive + finding id (stable per source). */
+    source: SignalSource;
+    id: string;
+    /** Human-readable headline. */
+    headline: string;
+    severity: Severity;
+    /** ISO timestamp of when the finding was first observed. */
+    firstSeen: string;
+    /** ISO timestamp of the freshest observation. */
+    lastSeen: string;
+    /** Free-form structured detail per source. */
+    detail?: Record<string, unknown>;
+    /** Per-source freshness in days; lower = fresher. */
+    ageDays: number;
+}
+/** Cross-pollinated finding after FUSE stage. */
+export interface FusedFinding extends RawFinding {
+    /** Other source findings related by signature / claim / vendor / simhash. */
+    composedWith: Array<{
+        source: SignalSource;
+        id: string;
+    }>;
+    /** Composite priority 0..1 — higher = more urgent. */
+    compositeScore: number;
+    /** Sortable cluster id (findings in same cluster share root cause). */
+    clusterId: string;
+}
+export type ActionKind = "heal" | "wire" | "delete" | "shrink" | "publish";
+export interface PrescribedAction {
+    kind: ActionKind;
+    /** Findings this action closes. */
+    closesFindings: Array<{
+        source: SignalSource;
+        id: string;
+    }>;
+    /** What changes if executed. Plain-English. */
+    rationale: string;
+    /** Concrete artifact: PR draft markdown / cheatsheet text / bulletin .md. */
+    artifact: string;
+    /** Should this action BLOCK publish if not executed? */
+    blocking: boolean;
+    /** Composite priority inherited from the highest-priority finding closed. */
+    priority: number;
+}
+export interface ReciprocityEntry {
+    vendor: string;
+    /** Bulletin seq this records a response to. */
+    bulletinSeq: number;
+    /** "fix" | "ignore" | "acknowledge" | "disputed". */
+    response: "fix" | "ignore" | "acknowledge" | "disputed";
+    /** Days between bulletin emission and observed response (NaN if no response). */
+    reactionDays: number;
+    /** Trust delta to apply to vendor's aletheia weight (+0.05 fix, -0.10 ignore, ±0 ack/disputed). */
+    trustDelta: number;
+    /** ISO of when the response was recorded. */
+    at: string;
+}
+export interface FlywheelReport {
+    spec: {
+        name: "MNEME-FLYWHEEL";
+        version: "1.0";
+    };
+    startedAt: string;
+    finishedAt: string;
+    totalMs: number;
+    /** Number of raw findings harvested per source. */
+    harvestCounts: Record<SignalSource, number>;
+    fusedCount: number;
+    clusterCount: number;
+    actions: PrescribedAction[];
+    /** Reciprocity ledger snapshot at run time. */
+    reciprocity: ReciprocityEntry[];
+    /** Aggregate health 0..100 (1 − fraction of BLOCK actions). */
+    health: number;
+    trafficLight: "green" | "yellow" | "red";
+    headline: string;
+    hmac: string;
+    seq: number;
+    bodyDigest: string;
+}
+export interface FlywheelOptions {
+    /** Limit raw findings per source to bound work. */
+    perSourceLimit?: number;
+    /** Min cluster size to recommend a deletion (default 0 = any dormant primitive gets a delete option). */
+    minDeleteAge?: number;
+    /** If true, skip the EXECUTE side-effects (no Aletheia weights write). Useful for dry-runs. */
+    dryRun?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/flywheel/types.js

@@ -0,0 +1,25 @@
+/**
+ * v2.32.0 — FLYWHEEL types.
+ *
+ * FLYWHEEL is the self-reflective release organ. It consumes signals
+ * from the 5 existing audit primitives (TRUTH GATE, PEAK GAUNTLET,
+ * HONEST MIRROR, REWIND, HGP) + command-history + primitive registry,
+ * fuses them via cross-pollination, and prescribes 5 action kinds
+ * (Heal / Wire / Delete / Shrink / Publish). Closes the 4 weakness
+ * loops Mneme has historically suffered from:
+ *
+ *   1. Tool sprawl       → Shrink (personal cheatsheet ≤ 3 cmds)
+ *   2. Solo-dev asymmetry → Publish (Vendor Bulletin .md) + cross-vendor reciprocity
+ *   3. Wiring lag         → Wire   (dormant primitives flagged + auto-PR draft)
+ *   4. Marketing drift    → Heal   (unbound claims flagged + auto-PR draft)
+ *
+ * 5-stage controller:
+ *   HARVEST → FUSE → PRESCRIBE → EXECUTE → RECIPROCITY
+ *
+ * The CREATIVE part: stage 5 RECIPROCITY records vendor responses to
+ * past bulletins. Vendors that fix within 7 days get +0.05 trust boost
+ * (auto-feeds aletheia weights); vendors that ignore for 30+ days get
+ * −0.10 penalty. Living negotiation organ with the AI vendor ecosystem.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/flywheel/types.js.map

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