mneme-ai 2.173.0 → 2.175.0

package/dist/commands/goldilocks.d.ts

@@ -0,0 +1,13 @@
+/**
+ * `mneme goldilocks` (v2.174) — config-fragility / "habitable-zone" analyzer.
+ * The honest core of the cosmic fine-tuning idea: find the band of values where
+ * a config still works + how close your current value is to the nearest cliff.
+ *
+ *   mneme goldilocks                                  # self-test (gauntlet 100)
+ *   mneme goldilocks scan --cmd "node bench.js {v}" --param max_tokens --lo 256 --hi 16000 --current 4000
+ *     → runs the command with {v} substituted (exit 0 = pass), bisects the cliffs,
+ *       and reports ROBUST / TIGHT / KNIFE-EDGE / UNSTABLE + the margin.
+ */
+import type { Command } from "commander";
+export declare function registerGoldilocksCommands(program: Command): void;
+//# sourceMappingURL=goldilocks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"goldilocks.d.ts","sourceRoot":"","sources":["../../src/commands/goldilocks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMzC,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAkCjE"}

package/dist/commands/goldilocks.js

@@ -0,0 +1,52 @@
+import { spawnSync } from "node:child_process";
+import { goldilocks, notary } from "@mneme-ai/core";
+function out(s) { process.stdout.write(s + "\n"); }
+export function registerGoldilocksCommands(program) {
+    const g = program
+        .command("goldilocks")
+        .description("🌗 GOLDILOCKS — config-fragility analyzer. Given a numeric config value, a range, and a pass/fail command, it finds the 'habitable zone' (the band where the system still works) by bisecting to each cliff, and tells you how close your value sits to breaking: ROBUST / TIGHT / KNIFE-EDGE / UNSTABLE. The honest engineering core of 'fine-tuning' — sensitivity analysis on an oracle you supply, not cosmology.")
+        .action(() => {
+        const r = goldilocks.goldilocksGauntlet();
+        out(`🌗 GOLDILOCKS — habitable-zone analyzer self-test  (gauntlet ${r.score}/100)`);
+        for (const c of r.checks)
+            out(`  ${c.pass ? "✓" : "✗"} ${c.name.padEnd(18)} ${c.detail}`);
+        process.exitCode = r.score === 100 ? 0 : 2;
+    });
+    g.command("scan")
+        .description("find the habitable zone of a config value via a pass/fail command (exit 0 = pass). exit 2 if TIGHT/KNIFE-EDGE/UNSTABLE.")
+        .requiredOption("--cmd <cmd>", "shell command with {v} substituted for the candidate value; exit 0 = pass")
+        .requiredOption("--lo <n>", "low end of the search range", parseFloat)
+        .requiredOption("--hi <n>", "high end of the search range", parseFloat)
+        .requiredOption("--current <n>", "the current/configured value", parseFloat)
+        .option("--param <name>", "a label for the parameter", "value")
+        .option("--json", "JSON output")
+        .action((opts) => {
+        const oracle = (v) => {
+            const cmd = opts.cmd.replace(/\{v\}/g, String(v));
+            try {
+                return spawnSync(cmd, { shell: true, stdio: "ignore", timeout: 120_000 }).status === 0;
+            }
+            catch {
+                return false;
+            }
+        };
+        const z = goldilocks.habitableZone(oracle, { lo: opts.lo, hi: opts.hi, current: opts.current });
+        let signed = { param: opts.param, ...z };
+        try {
+            signed = { ...signed, _proof: notary.issueReceipt(process.cwd(), { kind: "claim-verdict", subject: `goldilocks:${opts.param}`, payload: { verdict: z.verdict, margin: z.margin }, includePayload: true }) };
+        }
+        catch { /* unsigned */ }
+        if (opts.json) {
+            out(JSON.stringify(signed, null, 2));
+            process.exitCode = z.verdict === "ROBUST" ? 0 : 2;
+            return;
+        }
+        const icon = z.verdict === "ROBUST" ? "✓" : z.verdict === "UNSTABLE" ? "🛑" : "⚠";
+        out(`${icon} ${opts.param} = ${opts.current} → ${z.verdict}`);
+        if (z.passesNow)
+            out(`   habitable zone: [${z.lowOpen ? "≤" : ""}${z.lowEdge.toPrecision(5)}, ${z.highEdge.toPrecision(5)}${z.highOpen ? "+" : ""}] · nearest cliff ${z.margin.toPrecision(4)} away (${(z.marginPct * 100).toFixed(1)}% of range)`);
+        out(`   ${z.reason}`);
+        process.exitCode = z.verdict === "ROBUST" ? 0 : 2;
+    });
+}
+//# sourceMappingURL=goldilocks.js.map

package/dist/commands/goldilocks.js.map

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

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAgLA,wBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAglNvD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAiLA,wBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAilNvD"}

package/dist/index.js

@@ -97,6 +97,7 @@ import { registerTrustlessCommands } from "./commands/trustless.js";
 import { registerMatrixCommands } from "./commands/matrix.js";
 import { registerAdamasCommands } from "./commands/adamas.js";
 import { registerPrismCommands } from "./commands/prism.js";
+import { registerGoldilocksCommands } from "./commands/goldilocks.js";
 import { registerAxiaCommands } from "./commands/axia.js";
 import { registerPceCommands } from "./commands/pce.js";
 import { registerHauntCommands } from "./commands/haunt.js";
@@ -4758,6 +4759,7 @@ export async function run(argv) {
     registerMatrixCommands(program);
     registerAdamasCommands(program);
     registerPrismCommands(program);
+    registerGoldilocksCommands(program);
     registerAxiaCommands(program);
     registerPceCommands(program);
     registerHauntCommands(program);