mneme-ai 2.123.0 → 2.124.0

package/dist/commands/outline.d.ts

@@ -0,0 +1,16 @@
+/**
+ * `mneme outline <file>` (v2.124.0) — read a file's STRUCTURE for a fraction of
+ * the tokens, then fetch the EXACT slice you need.
+ *
+ * The honest answer to "context-loading hyper-inflation": instead of an agent
+ * Reading a whole 70-line (or 700-line) file into its context to orient itself,
+ * it reads the structural skeleton (every symbol + line range, bodies elided),
+ * then `--region <symbol|L1-L2>` fetches the byte-exact code only where it edits.
+ *
+ *   mneme outline src/foo.ts                 # the skeleton (cheap orientation)
+ *   mneme outline src/foo.ts --region add    # byte-exact slice of `add`
+ *   mneme outline src/foo.ts --region L40-L80 --json
+ */
+import type { Command } from "commander";
+export declare function registerOutlineCommands(program: Command): void;
+//# sourceMappingURL=outline.d.ts.map

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

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

package/dist/commands/outline.js

@@ -0,0 +1,76 @@
+/**
+ * `mneme outline <file>` (v2.124.0) — read a file's STRUCTURE for a fraction of
+ * the tokens, then fetch the EXACT slice you need.
+ *
+ * The honest answer to "context-loading hyper-inflation": instead of an agent
+ * Reading a whole 70-line (or 700-line) file into its context to orient itself,
+ * it reads the structural skeleton (every symbol + line range, bodies elided),
+ * then `--region <symbol|L1-L2>` fetches the byte-exact code only where it edits.
+ *
+ *   mneme outline src/foo.ts                 # the skeleton (cheap orientation)
+ *   mneme outline src/foo.ts --region add    # byte-exact slice of `add`
+ *   mneme outline src/foo.ts --region L40-L80 --json
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { resolve } from "node:path";
+import { outline } 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 registerOutlineCommands(program) {
+    program
+        .command("outline <file>")
+        .alias("glance")
+        .description("🔭 Read a file's STRUCTURE (every symbol + line range, bodies elided) for a fraction of the tokens, instead of loading the whole file. `--region <symbol|L1-L2>` fetches the byte-EXACT slice to edit. Orient cheap → edit exact.")
+        .option("--region <selector>", "fetch the byte-exact slice for a symbol name or an L<a>-L<b> range.")
+        .option("--json", "structured JSON output.")
+        .action((file, opts) => {
+        const cwd = process.cwd();
+        const p = resolve(cwd, file);
+        if (!existsSync(p)) {
+            out(`✗ file not found: ${file}`);
+            process.exitCode = 1;
+            return;
+        }
+        let src = "";
+        try {
+            src = readFileSync(p, "utf8");
+        }
+        catch (e) {
+            out(`✗ read failed: ${e.message}`);
+            process.exitCode = 1;
+            return;
+        }
+        if (opts.region) {
+            const r = outline.extractRegion(src, opts.region);
+            if (!r.ok) {
+                out(`✗ ${r.note}`);
+                process.exitCode = 1;
+                return;
+            }
+            if (opts.json) {
+                outJson(r);
+                return;
+            }
+            out(`# ${file} · L${r.startLine}-${r.endLine} (byte-exact)`);
+            out(r.text);
+            return;
+        }
+        const o = outline.extractOutline(src);
+        const rendered = outline.renderOutline(o, { path: file });
+        const m = outline.measureReduction(src.length, rendered.length);
+        // record the measured saving into the signed treasury ledger (Pay-per-Token-Saved)
+        try {
+            appendSaving(cwd, { source: "outline", tokensBefore: m.estTokensBefore, tokensAfter: m.estTokensAfter });
+        }
+        catch { /* best-effort */ }
+        if (opts.json) {
+            outJson({ outline: o, rendered, measure: m });
+            return;
+        }
+        process.stdout.write(rendered);
+        out(`\n— ${o.symbolCount} symbols · ~${m.estTokensBefore} tok → ~${m.estTokensAfter} tok (${m.reductionPct}% less) · to edit: mneme outline ${file} --region <symbol|L1-L2>`);
+        out(`  (${m.note})`);
+    });
+}
+//# sourceMappingURL=outline.js.map

package/dist/commands/outline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"outline.js","sourceRoot":"","sources":["../../src/commands/outline.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":"AAqJA,wBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAugNvD"}
+{"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"}

package/dist/index.js

@@ -82,6 +82,7 @@ import { registerMapCommands } from "./commands/map.js";
 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 { registerTrustCommands } from "./commands/trust.js";
 import { registerNuclearCommands } from "./commands/nuclear-cli.js";
 import { registerOvernightCommand } from "./commands/overnight.js";
@@ -4709,6 +4710,7 @@ export async function run(argv) {
     registerEgressCommands(program);
     registerExecCommands(program);
     registerBequestCommands(program);
+    registerOutlineCommands(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