@nxuss/lemma 1.9.1 → 1.11.0

package/dist/cjs/utils/OutputLedger.js

@@ -0,0 +1,134 @@
+"use strict";
+/**
+ * OutputLedger — session memory of what each tool already returned.
+ *
+ * `ReadWorkspaceCache` solves this for file reads, but reads are not where the weight is.
+ * A debug loop runs `npm test` six times and `tsc --noEmit` four; each run dumps hundreds
+ * of near-identical lines into the transcript, and every one of those copies is re-sent on
+ * every later turn. By the end of a session the same failing stack trace can account for
+ * more context than the source files being debugged.
+ *
+ * So: key on (tool, call signature), remember the exact text emitted, and on a repeat
+ * answer with `IDENTICAL` or a diff instead of the payload.
+ *
+ * The correctness rule is the same one that governs the read cache, and it is absolute:
+ * a ledger hit may only suppress text the model demonstrably already received in this
+ * session. Anything else — a cold start, an evicted entry, a caller that didn't record —
+ * resolves to sending the full output. Under-suppressing costs tokens; over-suppressing
+ * costs the user a correct answer.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ledgerKey = ledgerKey;
+exports.checkOutput = checkOutput;
+exports.recordOutput = recordOutput;
+exports.resetOutputLedger = resetOutputLedger;
+const crypto_1 = __importDefault(require("crypto"));
+const OutputDelta_1 = require("./OutputDelta");
+const SharedLedgerStore_1 = require("./SharedLedgerStore");
+const entries = new Map();
+/** Mirrors the read cache's bound: this exists to save tokens, not to grow forever. */
+const MAX_LEDGER_CHARS = 2000000;
+const MAX_ENTRY_CHARS = 400000;
+let ledgerChars = 0;
+let callCounter = 0;
+function sha256(text) {
+    return crypto_1.default.createHash("sha256").update(text).digest("hex");
+}
+/**
+ * Build a stable key from the arguments that determine the output.
+ *
+ * Only pass arguments that actually change the result. Including an incidental field
+ * (a verbosity flag that doesn't alter the payload, a timestamp) makes every call a
+ * fresh key and silently disables the ledger; including too few makes two genuinely
+ * different calls collide, which would suppress output the model never saw. When unsure,
+ * include the field — a missed saving is recoverable, a wrong suppression is not.
+ */
+function ledgerKey(toolName, signature) {
+    const normalized = Object.keys(signature)
+        .sort()
+        .map((k) => `${k}=${JSON.stringify(signature[k]) ?? ""}`)
+        .join("&");
+    return `${toolName}::${normalized}`;
+}
+/**
+ * Check a freshly produced output against what this tool last returned for the same call.
+ *
+ * Always call `record` afterwards with the text you actually emitted, including when this
+ * returns `new` — otherwise the next repeat has no base to compare against.
+ */
+function checkOutput(key, text, options) {
+    let previous = entries.get(key);
+    // No in-process history for this key — check whether a sibling fork already produced
+    // this exact call in the shared conversation this process's tree inherits. Scoped and
+    // opt-in via SharedLedgerStore; a plain miss here is silent and free.
+    if (!previous) {
+        const shared = (0, SharedLedgerStore_1.getSharedEntry)(process.cwd(), "output-ledger", key);
+        if (shared) {
+            try {
+                const parsed = JSON.parse(shared);
+                previous = { text: parsed.text, hash: parsed.hash, callIndex: parsed.callIndex, at: 0 };
+            }
+            catch {
+                previous = undefined;
+            }
+        }
+    }
+    if (!previous)
+        return { status: "new", replacement: null, savedChars: 0 };
+    const hash = sha256(text);
+    if (hash === previous.hash) {
+        const marker = [
+            `IDENTICAL: ${options.label} produced byte-for-byte the same output as earlier this session (call #${previous.callIndex}).`,
+            `Nothing changed. Reuse that result rather than re-reading it here.`,
+            ...(options.rerunHint ? [options.rerunHint] : []),
+        ].join("\n");
+        return { status: "identical", replacement: marker, savedChars: Math.max(0, text.length - marker.length) };
+    }
+    const delta = (0, OutputDelta_1.shouldEmitDelta)(previous.text, text);
+    if (!delta.emit)
+        return { status: "changed", replacement: null, savedChars: 0 };
+    const marker = [
+        `CHANGED: ${options.label} — ${delta.hunkCount} hunk(s), +${delta.added}/-${delta.removed} vs. call #${previous.callIndex}.`,
+        `Everything else is unchanged from that result. Diff:`,
+        ``,
+        delta.body,
+    ].join("\n");
+    // A diff that ended up longer than the payload is a saving of zero, not a negative one;
+    // the caller decides what to emit, this only reports what was actually spared.
+    return { status: "changed", replacement: marker, savedChars: Math.max(0, text.length - marker.length) };
+}
+/** Record the text a tool emitted (the full payload, not a marker) as the base for next time. */
+function recordOutput(key, text) {
+    const previous = entries.get(key);
+    if (previous) {
+        ledgerChars -= previous.text.length;
+        // `set` on an existing key keeps its original insertion position, so delete first to
+        // make a refreshed entry count as recently-written for eviction.
+        entries.delete(key);
+    }
+    if (text.length > MAX_ENTRY_CHARS)
+        return;
+    callCounter++;
+    const hash = sha256(text);
+    entries.set(key, { text, hash, callIndex: callCounter, at: Date.now() });
+    ledgerChars += text.length;
+    (0, SharedLedgerStore_1.setSharedEntry)(process.cwd(), "output-ledger", key, JSON.stringify({ text, hash, callIndex: callCounter }));
+    while (ledgerChars > MAX_LEDGER_CHARS) {
+        const oldest = entries.keys().next();
+        if (oldest.done)
+            break;
+        const dropped = entries.get(oldest.value);
+        entries.delete(oldest.value);
+        ledgerChars -= dropped.text.length;
+    }
+}
+/** Test seam — the map is process-global and would otherwise leak between test cases. */
+function resetOutputLedger() {
+    entries.clear();
+    ledgerChars = 0;
+    callCounter = 0;
+}
+//# sourceMappingURL=OutputLedger.js.map

package/dist/cjs/utils/OutputLedger.js.map

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

package/dist/cjs/utils/ReadWorkspaceCache.d.ts

@@ -15,8 +15,14 @@ export interface ReadDedupCheck {
 }
 /** Check whether this exact (path, view) content was already sent this session. */
 export declare function checkAlreadySent(resolvedPath: string, view: ReadView, rawContent: string): ReadDedupCheck;
+/**
+ * The text last emitted for this (path, view), or null if we have none — because this is
+ * the first read, or because the entry was evicted under the size cap. A null here means
+ * "send the full file", never "assume it is unchanged".
+ */
+export declare function getLastEmitted(resolvedPath: string, view: ReadView): string | null;
 /** Record that this content was just sent, so future identical reads short-circuit. */
-export declare function recordSent(resolvedPath: string, view: ReadView, hash: string): void;
-/** Test seam — the map is process-global and would otherwise leak between test cases. */
+export declare function recordSent(resolvedPath: string, view: ReadView, hash: string, emitted?: string): void;
+/** Test seam — the maps are process-global and would otherwise leak between test cases. */
 export declare function resetReadCache(): void;
 //# sourceMappingURL=ReadWorkspaceCache.d.ts.map

package/dist/cjs/utils/ReadWorkspaceCache.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ReadWorkspaceCache.d.ts","sourceRoot":"","sources":["../../../src/utils/ReadWorkspaceCache.ts"],"names":[],"mappings":"AAYA;;;;GAIG;AACH,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAaD,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,OAAO,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,mFAAmF;AACnF,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,GAAG,cAAc,CAKzG;AAED,uFAAuF;AACvF,wBAAgB,UAAU,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAEnF;AAED,yFAAyF;AACzF,wBAAgB,cAAc,IAAI,IAAI,CAErC"}
+{"version":3,"file":"ReadWorkspaceCache.d.ts","sourceRoot":"","sources":["../../../src/utils/ReadWorkspaceCache.ts"],"names":[],"mappings":"AAiCA;;;;GAIG;AACH,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAaD,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,OAAO,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CACd;AAiBD,mFAAmF;AACnF,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,GAAG,cAAc,CAOzG;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,IAAI,CAKlF;AAED,uFAAuF;AACvF,wBAAgB,UAAU,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAsCrG;AAED,2FAA2F;AAC3F,wBAAgB,cAAc,IAAI,IAAI,CAIrC"}

package/dist/cjs/utils/ReadWorkspaceCache.js

@@ -4,14 +4,32 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.checkAlreadySent = checkAlreadySent;
+exports.getLastEmitted = getLastEmitted;
 exports.recordSent = recordSent;
 exports.resetReadCache = resetReadCache;
 const crypto_1 = __importDefault(require("crypto"));
+const SharedLedgerStore_1 = require("./SharedLedgerStore");
 // Session-scoped (lives for the MCP server process lifetime, which is normally the
 // whole conversation). Tracks the content hash we last actually sent back to the
 // model for a given (filePath, view) pair, so a second identical read doesn't
 // resend content the model already has in its own context.
 const lastSent = new Map();
+/**
+ * The exact text emitted for each key, kept so a later read of a *changed* file can be
+ * answered with a diff instead of the whole file again. Only what the model actually
+ * received is stored — diffing against anything else would describe a document it never
+ * had.
+ */
+const lastEmitted = new Map();
+/**
+ * Total characters held in `lastEmitted`. This cache exists to save tokens, so it must
+ * not grow without bound in a long session; past the cap the least-recently-written
+ * entries are dropped and those reads simply fall back to sending the full file.
+ */
+const MAX_EMITTED_CHARS = 2000000;
+/** A single entry larger than this is never stored — one huge file would evict everything else. */
+const MAX_ENTRY_CHARS = 400000;
+let emittedChars = 0;
 function sha256(content) {
     return crypto_1.default.createHash("sha256").update(content).digest("hex");
 }
@@ -25,19 +43,79 @@ function cacheKey(resolvedPath, view) {
     ];
     return parts.join("::");
 }
+function getSharedRead(resolvedPath, view) {
+    const raw = (0, SharedLedgerStore_1.getSharedEntry)(process.cwd(), "read-cache", cacheKey(resolvedPath, view));
+    if (!raw)
+        return null;
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
 /** Check whether this exact (path, view) content was already sent this session. */
 function checkAlreadySent(resolvedPath, view, rawContent) {
     const hash = sha256(rawContent);
     const key = cacheKey(resolvedPath, view);
-    const unchanged = lastSent.get(key) === hash;
+    // In-process history wins; a sibling fork's shared entry only counts when this process
+    // has never seen the key itself — same "opt-in, scoped, fail-open" contract as OutputLedger.
+    const unchanged = lastSent.has(key) ? lastSent.get(key) === hash : getSharedRead(resolvedPath, view)?.hash === hash;
     return { unchanged, hash };
 }
+/**
+ * The text last emitted for this (path, view), or null if we have none — because this is
+ * the first read, or because the entry was evicted under the size cap. A null here means
+ * "send the full file", never "assume it is unchanged".
+ */
+function getLastEmitted(resolvedPath, view) {
+    const key = cacheKey(resolvedPath, view);
+    const local = lastEmitted.get(key);
+    if (local !== undefined)
+        return local;
+    return getSharedRead(resolvedPath, view)?.emitted ?? null;
+}
 /** Record that this content was just sent, so future identical reads short-circuit. */
-function recordSent(resolvedPath, view, hash) {
-    lastSent.set(cacheKey(resolvedPath, view), hash);
+function recordSent(resolvedPath, view, hash, emitted) {
+    const key = cacheKey(resolvedPath, view);
+    lastSent.set(key, hash);
+    // Mirrors the local size cap: an oversized entry is skipped locally too, so keeping it
+    // out of the shared file avoids bloating something every sibling process reads on every hit.
+    if (emitted === undefined || emitted.length <= MAX_ENTRY_CHARS) {
+        (0, SharedLedgerStore_1.setSharedEntry)(process.cwd(), "read-cache", key, JSON.stringify({ hash, emitted }));
+    }
+    if (emitted === undefined)
+        return;
+    const previous = lastEmitted.get(key);
+    if (previous !== undefined) {
+        emittedChars -= previous.length;
+        // Map keeps insertion order, and `set` on an existing key does not move it. Deleting
+        // first is what makes a refreshed entry count as recently-written for eviction.
+        lastEmitted.delete(key);
+    }
+    if (emitted.length > MAX_ENTRY_CHARS) {
+        // Too big to keep. Drop any stale copy rather than leaving a diff base that no longer
+        // matches what the model holds.
+        lastEmitted.delete(key);
+        return;
+    }
+    lastEmitted.set(key, emitted);
+    emittedChars += emitted.length;
+    // Map iteration is insertion-ordered, and re-inserting on every write above moves a
+    // refreshed key to the back — so evicting from the front drops the least-recently-written.
+    while (emittedChars > MAX_EMITTED_CHARS) {
+        const oldest = lastEmitted.keys().next();
+        if (oldest.done)
+            break;
+        const dropped = lastEmitted.get(oldest.value);
+        lastEmitted.delete(oldest.value);
+        emittedChars -= dropped.length;
+    }
 }
-/** Test seam — the map is process-global and would otherwise leak between test cases. */
+/** Test seam — the maps are process-global and would otherwise leak between test cases. */
 function resetReadCache() {
     lastSent.clear();
+    lastEmitted.clear();
+    emittedChars = 0;
 }
 //# sourceMappingURL=ReadWorkspaceCache.js.map

package/dist/cjs/utils/ReadWorkspaceCache.js.map

@@ -1 +1 @@
-{"version":3,"file":"ReadWorkspaceCache.js","sourceRoot":"","sources":["../../../src/utils/ReadWorkspaceCache.ts"],"names":[],"mappings":";;;;;AAyCA,4CAKC;AAGD,gCAEC;AAGD,wCAEC;AAxDD,oDAA4B;AAE5B,mFAAmF;AACnF,iFAAiF;AACjF,8EAA8E;AAC9E,2DAA2D;AAC3D,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAkB,CAAC;AAE3C,SAAS,MAAM,CAAC,OAAe;IAC7B,OAAO,gBAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACnE,CAAC;AAcD,SAAS,QAAQ,CAAC,YAAoB,EAAE,IAAc;IACpD,MAAM,KAAK,GAAG;QACZ,YAAY;QACZ,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI;QAC1B,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI;QAC9B,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,GAAG;QACrC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG;KACpC,CAAC;IACF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAOD,mFAAmF;AACnF,SAAgB,gBAAgB,CAAC,YAAoB,EAAE,IAAc,EAAE,UAAkB;IACvF,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC;IAChC,MAAM,GAAG,GAAG,QAAQ,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;IACzC,MAAM,SAAS,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC;IAC7C,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;AAC7B,CAAC;AAED,uFAAuF;AACvF,SAAgB,UAAU,CAAC,YAAoB,EAAE,IAAc,EAAE,IAAY;IAC3E,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,YAAY,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC;AACnD,CAAC;AAED,yFAAyF;AACzF,SAAgB,cAAc;IAC5B,QAAQ,CAAC,KAAK,EAAE,CAAC;AACnB,CAAC"}
+{"version":3,"file":"ReadWorkspaceCache.js","sourceRoot":"","sources":["../../../src/utils/ReadWorkspaceCache.ts"],"names":[],"mappings":"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"}

package/dist/cjs/utils/RoiLedger.d.ts

@@ -0,0 +1,31 @@
+/**
+ * RoiLedger — per-(repo, tool) net token history, persisted across sessions.
+ *
+ * `SavingsLedger` already tracks saved/spent totals, but only by *source* (cache,
+ * contextSqueeze, ...) and only in `~/.lemma-cache/ledger.json` — one file, no notion of
+ * which repo or which specific tool earned its keep. That is not enough to answer "does
+ * `affected_tests` pay for its schema in THIS repo", which is what `tool-profiles.ts` needs
+ * to auto-tune the advertised surface instead of relying purely on the hand-curated
+ * `CORE_TOOL_NAMES` list.
+ *
+ * Scope: one small JSON file per repo, keyed by a hash of the repo path, holding cumulative
+ * (calls, tokensSaved, tokensSpent) per tool name. Fail-open throughout — a lookup or write
+ * that errors must never break the caller; it just means no history this time.
+ *
+ * Hard rule inherited from `tool-profiles.ts`: the tool surface resolves once at startup and
+ * never mutates mid-session. This ledger is written continuously, but only ever *read* by
+ * `resolveToolSurface` once, at process start — so a promotion always reflects PRIOR
+ * sessions, never the one currently running.
+ */
+export interface ToolRoiStats {
+    calls: number;
+    tokensSaved: number;
+    tokensSpent: number;
+}
+export declare function recordRoiSaved(repoRoot: string, tool: string, tokensSaved: number): void;
+export declare function recordRoiSpent(repoRoot: string, tool: string, tokensSpent: number): void;
+/** All per-tool history for this repo, or an empty map if none exists yet or the read fails. */
+export declare function getRoiStats(repoRoot: string): Record<string, ToolRoiStats>;
+/** Test seam only — production code should never need to wipe another repo's history. */
+export declare function resetRoiLedger(repoRoot: string): void;
+//# sourceMappingURL=RoiLedger.d.ts.map

package/dist/cjs/utils/RoiLedger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RoiLedger.d.ts","sourceRoot":"","sources":["../../../src/utils/RoiLedger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAMH,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB;AA8DD,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAExF;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAExF;AAED,gGAAgG;AAChG,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAM1E;AAED,yFAAyF;AACzF,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAMrD"}

package/dist/cjs/utils/RoiLedger.js

@@ -0,0 +1,113 @@
+"use strict";
+/**
+ * RoiLedger — per-(repo, tool) net token history, persisted across sessions.
+ *
+ * `SavingsLedger` already tracks saved/spent totals, but only by *source* (cache,
+ * contextSqueeze, ...) and only in `~/.lemma-cache/ledger.json` — one file, no notion of
+ * which repo or which specific tool earned its keep. That is not enough to answer "does
+ * `affected_tests` pay for its schema in THIS repo", which is what `tool-profiles.ts` needs
+ * to auto-tune the advertised surface instead of relying purely on the hand-curated
+ * `CORE_TOOL_NAMES` list.
+ *
+ * Scope: one small JSON file per repo, keyed by a hash of the repo path, holding cumulative
+ * (calls, tokensSaved, tokensSpent) per tool name. Fail-open throughout — a lookup or write
+ * that errors must never break the caller; it just means no history this time.
+ *
+ * Hard rule inherited from `tool-profiles.ts`: the tool surface resolves once at startup and
+ * never mutates mid-session. This ledger is written continuously, but only ever *read* by
+ * `resolveToolSurface` once, at process start — so a promotion always reflects PRIOR
+ * sessions, never the one currently running.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.recordRoiSaved = recordRoiSaved;
+exports.recordRoiSpent = recordRoiSpent;
+exports.getRoiStats = getRoiStats;
+exports.resetRoiLedger = resetRoiLedger;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const crypto_1 = __importDefault(require("crypto"));
+const HOME = process.env.HOME || process.env.USERPROFILE || "~";
+const ROI_DIR = path_1.default.join(HOME, ".lemma-cache", "roi");
+function repoHash(repoRoot) {
+    return crypto_1.default.createHash("sha256").update(path_1.default.resolve(repoRoot)).digest("hex").slice(0, 16);
+}
+function roiFilePath(repoRoot) {
+    return path_1.default.join(ROI_DIR, `${repoHash(repoRoot)}.json`);
+}
+function emptyStats() {
+    return { calls: 0, tokensSaved: 0, tokensSpent: 0 };
+}
+function load(repoRoot) {
+    try {
+        const p = roiFilePath(repoRoot);
+        if (fs_1.default.existsSync(p)) {
+            const parsed = JSON.parse(fs_1.default.readFileSync(p, "utf8"));
+            if (parsed && typeof parsed === "object" && parsed.tools)
+                return parsed;
+        }
+    }
+    catch {
+        // Corrupt or unreadable file must never break the caller — start clean for this write.
+    }
+    return { tools: {}, updatedAt: Date.now() };
+}
+function save(repoRoot, data) {
+    try {
+        if (!fs_1.default.existsSync(ROI_DIR))
+            fs_1.default.mkdirSync(ROI_DIR, { recursive: true });
+        data.updatedAt = Date.now();
+        fs_1.default.writeFileSync(roiFilePath(repoRoot), JSON.stringify(data, null, 2), "utf8");
+    }
+    catch {
+        // Non-critical: losing one write just means the next read sees slightly stale history.
+    }
+}
+function bump(repoRoot, tool, field, amount) {
+    if (!tool || !(amount > 0))
+        return;
+    try {
+        const data = load(repoRoot);
+        const stats = data.tools[tool] || emptyStats();
+        if (field === "tokensSaved")
+            stats.tokensSaved += amount;
+        else
+            stats.tokensSpent += amount;
+        // `calls` counts either kind of event once — it is "how many times this tool did
+        // something billable", not a sum of both fields.
+        stats.calls += 1;
+        data.tools[tool] = stats;
+        save(repoRoot, data);
+    }
+    catch {
+        // Fail-open: ROI bookkeeping must never be why a tool call fails.
+    }
+}
+function recordRoiSaved(repoRoot, tool, tokensSaved) {
+    bump(repoRoot, tool, "tokensSaved", tokensSaved);
+}
+function recordRoiSpent(repoRoot, tool, tokensSpent) {
+    bump(repoRoot, tool, "tokensSpent", tokensSpent);
+}
+/** All per-tool history for this repo, or an empty map if none exists yet or the read fails. */
+function getRoiStats(repoRoot) {
+    try {
+        return load(repoRoot).tools;
+    }
+    catch {
+        return {};
+    }
+}
+/** Test seam only — production code should never need to wipe another repo's history. */
+function resetRoiLedger(repoRoot) {
+    try {
+        if (fs_1.default.existsSync(roiFilePath(repoRoot)))
+            fs_1.default.unlinkSync(roiFilePath(repoRoot));
+    }
+    catch {
+        // ignore
+    }
+}
+//# sourceMappingURL=RoiLedger.js.map

package/dist/cjs/utils/RoiLedger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RoiLedger.js","sourceRoot":"","sources":["../../../src/utils/RoiLedger.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;GAkBG;;;;;AAwEH,wCAEC;AAED,wCAEC;AAGD,kCAMC;AAGD,wCAMC;AA9FD,4CAAoB;AACpB,gDAAwB;AACxB,oDAA4B;AAa5B,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,GAAG,CAAC;AAChE,MAAM,OAAO,GAAG,cAAI,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,EAAE,KAAK,CAAC,CAAC;AAEvD,SAAS,QAAQ,CAAC,QAAgB;IAChC,OAAO,gBAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,cAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAC/F,CAAC;AAED,SAAS,WAAW,CAAC,QAAgB;IACnC,OAAO,cAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;AAC1D,CAAC;AAED,SAAS,UAAU;IACjB,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,CAAC;AACtD,CAAC;AAED,SAAS,IAAI,CAAC,QAAgB;IAC5B,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC;QAChC,IAAI,YAAE,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;YACrB,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAE,CAAC,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;YACtD,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,KAAK;gBAAE,OAAO,MAAiB,CAAC;QACrF,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,uFAAuF;IACzF,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;AAC9C,CAAC;AAED,SAAS,IAAI,CAAC,QAAgB,EAAE,IAAa;IAC3C,IAAI,CAAC;QACH,IAAI,CAAC,YAAE,CAAC,UAAU,CAAC,OAAO,CAAC;YAAE,YAAE,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACxE,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC5B,YAAE,CAAC,aAAa,CAAC,WAAW,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IACjF,CAAC;IAAC,MAAM,CAAC;QACP,uFAAuF;IACzF,CAAC;AACH,CAAC;AAED,SAAS,IAAI,CAAC,QAAgB,EAAE,IAAY,EAAE,KAAoC,EAAE,MAAc;IAChG,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;QAAE,OAAO;IACnC,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC5B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,UAAU,EAAE,CAAC;QAC/C,IAAI,KAAK,KAAK,aAAa;YAAE,KAAK,CAAC,WAAW,IAAI,MAAM,CAAC;;YACpD,KAAK,CAAC,WAAW,IAAI,MAAM,CAAC;QACjC,iFAAiF;QACjF,iDAAiD;QACjD,KAAK,CAAC,KAAK,IAAI,CAAC,CAAC;QACjB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;QACzB,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IACvB,CAAC;IAAC,MAAM,CAAC;QACP,kEAAkE;IACpE,CAAC;AACH,CAAC;AAED,SAAgB,cAAc,CAAC,QAAgB,EAAE,IAAY,EAAE,WAAmB;IAChF,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,aAAa,EAAE,WAAW,CAAC,CAAC;AACnD,CAAC;AAED,SAAgB,cAAc,CAAC,QAAgB,EAAE,IAAY,EAAE,WAAmB;IAChF,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,aAAa,EAAE,WAAW,CAAC,CAAC;AACnD,CAAC;AAED,gGAAgG;AAChG,SAAgB,WAAW,CAAC,QAAgB;IAC1C,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC;IAC9B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,yFAAyF;AACzF,SAAgB,cAAc,CAAC,QAAgB;IAC7C,IAAI,CAAC;QACH,IAAI,YAAE,CAAC,UAAU,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;YAAE,YAAE,CAAC,UAAU,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC;IACjF,CAAC;IAAC,MAAM,CAAC;QACP,SAAS;IACX,CAAC;AACH,CAAC"}

package/dist/cjs/utils/SharedLedgerStore.d.ts

@@ -0,0 +1,26 @@
+/**
+ * SharedLedgerStore — file-backed cross-process backing for `OutputLedger` and
+ * `ReadWorkspaceCache`, so subagents that genuinely share a conversation (a `fork`, which
+ * inherits the parent's full context) don't independently re-read the same files or re-run
+ * the same commands the parent already put in that shared context.
+ *
+ * OFF BY DEFAULT — opt in with `LEMMA_SHARED_LEDGER=1` (or `mcp.sharedLedger: true` in
+ * lemma.config.json) AND a `LEMMA_AGENT_TREE_ID` env var identifying the fork tree. Both are
+ * required on purpose:
+ *
+ * - Without a tree id, every process on the machine would share one ledger, and a plain
+ *   fresh subagent (no inherited context) would get told a file is "UNCHANGED" or a command
+ *   "IDENTICAL" for content it never actually received — suppressing content the model
+ *   never saw, which is the one thing these caches must never do.
+ * - The tree id scopes sharing to processes an orchestrator has explicitly declared share a
+ *   context (i.e. `fork` subagents of the same parent), which is the only case where "another
+ *   process already has this" is actually true for THIS process too.
+ *
+ * TTL is short (30 min): a fork tree is a single task, not a persistent cache.
+ */
+export declare function isSharedLedgerEnabled(cwd?: string): boolean;
+/** Get a shared value for `key` (namespaced), or null if disabled, missing, or expired. */
+export declare function getSharedEntry(cwd: string, namespace: "output-ledger" | "read-cache", key: string): string | null;
+/** Record a value under `key` (namespaced) for other trees-scoped processes to read. */
+export declare function setSharedEntry(cwd: string, namespace: "output-ledger" | "read-cache", key: string, value: string): void;
+//# sourceMappingURL=SharedLedgerStore.d.ts.map

package/dist/cjs/utils/SharedLedgerStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SharedLedgerStore.d.ts","sourceRoot":"","sources":["../../../src/utils/SharedLedgerStore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AASH,wBAAgB,qBAAqB,CAAC,GAAG,GAAE,MAAsB,GAAG,OAAO,CAa1E;AAgDD,2FAA2F;AAC3F,wBAAgB,cAAc,CAC5B,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,eAAe,GAAG,YAAY,EACzC,GAAG,EAAE,MAAM,GACV,MAAM,GAAG,IAAI,CAWf;AAED,wFAAwF;AACxF,wBAAgB,cAAc,CAC5B,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,eAAe,GAAG,YAAY,EACzC,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,GACZ,IAAI,CAcN"}

package/dist/cjs/utils/SharedLedgerStore.js

@@ -0,0 +1,130 @@
+"use strict";
+/**
+ * SharedLedgerStore — file-backed cross-process backing for `OutputLedger` and
+ * `ReadWorkspaceCache`, so subagents that genuinely share a conversation (a `fork`, which
+ * inherits the parent's full context) don't independently re-read the same files or re-run
+ * the same commands the parent already put in that shared context.
+ *
+ * OFF BY DEFAULT — opt in with `LEMMA_SHARED_LEDGER=1` (or `mcp.sharedLedger: true` in
+ * lemma.config.json) AND a `LEMMA_AGENT_TREE_ID` env var identifying the fork tree. Both are
+ * required on purpose:
+ *
+ * - Without a tree id, every process on the machine would share one ledger, and a plain
+ *   fresh subagent (no inherited context) would get told a file is "UNCHANGED" or a command
+ *   "IDENTICAL" for content it never actually received — suppressing content the model
+ *   never saw, which is the one thing these caches must never do.
+ * - The tree id scopes sharing to processes an orchestrator has explicitly declared share a
+ *   context (i.e. `fork` subagents of the same parent), which is the only case where "another
+ *   process already has this" is actually true for THIS process too.
+ *
+ * TTL is short (30 min): a fork tree is a single task, not a persistent cache.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isSharedLedgerEnabled = isSharedLedgerEnabled;
+exports.getSharedEntry = getSharedEntry;
+exports.setSharedEntry = setSharedEntry;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const crypto_1 = __importDefault(require("crypto"));
+const HOME = process.env.HOME || process.env.USERPROFILE || "~";
+const TTL_MS = 30 * 60 * 1000;
+function isSharedLedgerEnabled(cwd = process.cwd()) {
+    if (!process.env.LEMMA_AGENT_TREE_ID)
+        return false;
+    if (process.env.LEMMA_SHARED_LEDGER === "1")
+        return true;
+    try {
+        const configPath = path_1.default.join(cwd, "lemma.config.json");
+        if (fs_1.default.existsSync(configPath)) {
+            const config = JSON.parse(fs_1.default.readFileSync(configPath, "utf8"));
+            return config?.mcp?.sharedLedger === true;
+        }
+    }
+    catch {
+        // Config errors must never silently turn ON cross-process sharing.
+    }
+    return false;
+}
+function workspaceHash(cwd) {
+    return crypto_1.default.createHash("sha256").update(path_1.default.resolve(cwd)).digest("hex").slice(0, 16);
+}
+function storeDir(cwd) {
+    const treeId = process.env.LEMMA_AGENT_TREE_ID;
+    if (!treeId)
+        return null;
+    // Sanitize: the tree id lands in a path segment.
+    const safeTreeId = treeId.replace(/[^a-zA-Z0-9_-]/g, "").slice(0, 64) || "default";
+    return path_1.default.join(HOME, ".lemma-cache", "session", workspaceHash(cwd), safeTreeId);
+}
+function storeFile(cwd, namespace) {
+    const dir = storeDir(cwd);
+    if (!dir)
+        return null;
+    return path_1.default.join(dir, `${namespace}.json`);
+}
+function loadStore(cwd, namespace) {
+    try {
+        const file = storeFile(cwd, namespace);
+        if (!file || !fs_1.default.existsSync(file))
+            return {};
+        const parsed = JSON.parse(fs_1.default.readFileSync(file, "utf8"));
+        return parsed && typeof parsed === "object" ? parsed : {};
+    }
+    catch {
+        return {};
+    }
+}
+function saveStore(cwd, namespace, data) {
+    try {
+        const dir = storeDir(cwd);
+        const file = storeFile(cwd, namespace);
+        if (!dir || !file)
+            return;
+        if (!fs_1.default.existsSync(dir))
+            fs_1.default.mkdirSync(dir, { recursive: true });
+        fs_1.default.writeFileSync(file, JSON.stringify(data), "utf8");
+    }
+    catch {
+        // Fail-open: the caller falls back to in-process-only behavior.
+    }
+}
+/** Get a shared value for `key` (namespaced), or null if disabled, missing, or expired. */
+function getSharedEntry(cwd, namespace, key) {
+    if (!isSharedLedgerEnabled(cwd))
+        return null;
+    try {
+        const data = loadStore(cwd, namespace);
+        const entry = data[key];
+        if (!entry)
+            return null;
+        if (Date.now() - entry.at > TTL_MS)
+            return null;
+        return entry.value;
+    }
+    catch {
+        return null;
+    }
+}
+/** Record a value under `key` (namespaced) for other trees-scoped processes to read. */
+function setSharedEntry(cwd, namespace, key, value) {
+    if (!isSharedLedgerEnabled(cwd))
+        return;
+    try {
+        const data = loadStore(cwd, namespace);
+        data[key] = { value, at: Date.now() };
+        // Bound the file: drop expired entries whenever we touch it, rather than growing forever.
+        const now = Date.now();
+        for (const k of Object.keys(data)) {
+            if (now - data[k].at > TTL_MS)
+                delete data[k];
+        }
+        saveStore(cwd, namespace, data);
+    }
+    catch {
+        // Fail-open.
+    }
+}
+//# sourceMappingURL=SharedLedgerStore.js.map

package/dist/cjs/utils/SharedLedgerStore.js.map

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