mneme-ai 2.125.0 → 2.126.0

package/dist/commands/scaffold.d.ts

@@ -0,0 +1,16 @@
+/**
+ * `mneme scaffold` (v2.126.0) — the honest core of "Blueprint Inflation": an
+ * agent emits a tiny spec, Mneme expands it into deterministic boilerplate
+ * locally (no syntax errors, no re-typing), saving OUTPUT tokens.
+ *
+ * HONEST scope: KNOWN templates only (ts-model + CRUD, test-skeleton, config).
+ * It does NOT generate arbitrary business logic — it leaves TODO markers exactly
+ * where you must write the real logic.
+ *
+ *   mneme scaffold --spec '{"kind":"ts-model","model":"User","fields":{"id":"string","email":"string"},"crud":true}'
+ *   mneme scaffold --spec-file blueprint.json --out src/        # write the files
+ *   mneme scaffold --spec '{"kind":"config","format":"env","entries":{"port":3000}}' --json
+ */
+import type { Command } from "commander";
+export declare function registerScaffoldCommands(program: Command): void;
+//# sourceMappingURL=scaffold.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.d.ts","sourceRoot":"","sources":["../../src/commands/scaffold.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AASzC,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAmC/D"}

package/dist/commands/scaffold.js

@@ -0,0 +1,92 @@
+/**
+ * `mneme scaffold` (v2.126.0) — the honest core of "Blueprint Inflation": an
+ * agent emits a tiny spec, Mneme expands it into deterministic boilerplate
+ * locally (no syntax errors, no re-typing), saving OUTPUT tokens.
+ *
+ * HONEST scope: KNOWN templates only (ts-model + CRUD, test-skeleton, config).
+ * It does NOT generate arbitrary business logic — it leaves TODO markers exactly
+ * where you must write the real logic.
+ *
+ *   mneme scaffold --spec '{"kind":"ts-model","model":"User","fields":{"id":"string","email":"string"},"crud":true}'
+ *   mneme scaffold --spec-file blueprint.json --out src/        # write the files
+ *   mneme scaffold --spec '{"kind":"config","format":"env","entries":{"port":3000}}' --json
+ */
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from "node:fs";
+import { resolve, join, dirname } from "node:path";
+import { scaffold } from "@mneme-ai/core";
+import { appendSaving } from "./savings.js";
+function out(s) { process.stdout.write(s + "\n"); }
+function outJson(o) { process.stdout.write(JSON.stringify(o, null, 2) + "\n"); }
+export function registerScaffoldCommands(program) {
+    program
+        .command("scaffold")
+        .description("🧱 Expand a compact SPEC into deterministic boilerplate locally (saves OUTPUT tokens). KNOWN templates only: ts-model (+CRUD), test-skeleton, config — leaves TODO markers where YOU write the real logic. NOT a generator of arbitrary business logic.")
+        .option("--spec <json>", "the blueprint spec as inline JSON.")
+        .option("--spec-file <path>", "read the spec JSON from a file.")
+        .option("--out <dir>", "write the generated files under this dir (else print to stdout).")
+        .option("--json", "structured JSON output (files + measured saving).")
+        .action((opts) => {
+        let raw = opts.spec;
+        if (!raw && opts.specFile) {
+            try {
+                if (existsSync(opts.specFile))
+                    raw = readFileSync(opts.specFile, "utf8");
+            }
+            catch { /* */ }
+        }
+        if (!raw) {
+            out("✗ provide --spec '<json>' or --spec-file <path>");
+            process.exitCode = 1;
+            return;
+        }
+        let spec;
+        try {
+            spec = JSON.parse(raw);
+        }
+        catch (e) {
+            out(`✗ invalid spec JSON: ${e.message}`);
+            process.exitCode = 1;
+            return;
+        }
+        const r = scaffold.scaffold(spec);
+        if (!r.ok) {
+            out(`✗ ${r.error ?? "scaffold failed"}`);
+            out(`  ${r.note}`);
+            process.exitCode = 1;
+            return;
+        }
+        // record the OUTPUT-token saving into the signed treasury ledger
+        try {
+            appendSaving(process.cwd(), { source: "scaffold", tokensBefore: r.measure.codeTokens, tokensAfter: r.measure.specTokens });
+        }
+        catch { /* */ }
+        if (opts.json) {
+            outJson(r);
+            return;
+        }
+        if (opts.out) {
+            const cwd = process.cwd();
+            for (const f of r.files) {
+                const p = resolve(cwd, join(opts.out, f.path));
+                try {
+                    if (!existsSync(dirname(p)))
+                        mkdirSync(dirname(p), { recursive: true });
+                    writeFileSync(p, f.content);
+                    out(`✓ wrote ${join(opts.out, f.path)} (${f.content.split("\n").length} lines)`);
+                }
+                catch (e) {
+                    out(`✗ write ${f.path}: ${e.message}`);
+                }
+            }
+        }
+        else {
+            for (const f of r.files) {
+                out(`# ── ${f.path} ──`);
+                process.stdout.write(f.content);
+            }
+        }
+        out(`\n🧱 ${r.kind}: spec ~${r.measure.specTokens} tok → ~${r.measure.codeTokens} tok of code (${r.measure.outputReductionPct}% output-token saving, ${r.measure.expansionRatio}× expansion)`);
+        out(`  ${r.note}`);
+    });
+}
+//# sourceMappingURL=scaffold.js.map

package/dist/commands/scaffold.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.js","sourceRoot":"","sources":["../../src/commands/scaffold.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":"AAsJA,wBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAwgNvD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAuJA,wBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAygNvD"}

package/dist/index.js

@@ -83,6 +83,7 @@ import { registerEgressCommands } from "./commands/egress.js";
 import { registerExecCommands } from "./commands/exec.js";
 import { registerBequestCommands } from "./commands/bequest.js";
 import { registerOutlineCommands } from "./commands/outline.js";
+import { registerScaffoldCommands } from "./commands/scaffold.js";
 import { registerTrustCommands } from "./commands/trust.js";
 import { registerNuclearCommands } from "./commands/nuclear-cli.js";
 import { registerOvernightCommand } from "./commands/overnight.js";
@@ -4711,6 +4712,7 @@ export async function run(argv) {
     registerExecCommands(program);
     registerBequestCommands(program);
     registerOutlineCommands(program);
+    registerScaffoldCommands(program);
     // ─── Trust calibrator (v1.31.0) -- per-subsystem precision/recall/band
     registerTrustCommands(program);
     // ─── Wisdom reactor (v1.33.0) -- five nuclear-physics formulas as Mneme metrics