agentera 3.0.0-dev.5 → 3.0.0-dev.7

package/dist/state/progressCommit.js

@@ -0,0 +1,289 @@
+import { ancestorState } from "../core/git.js";
+import { loadYamlMapping } from "../core/yaml.js";
+/**
+ * Shared progress-commit and git-ancestry logic. Faithful TS port of
+ * `scripts/progress_commit.py`.
+ */
+export const COMMIT_HASH_RE = /^[0-9a-fA-F]{7,40}$/;
+/**
+ * Leading verifiable git hash in a cycle `commit` value, else `null`. `pending`,
+ * `N/A …` and non-hash free text are exempt; non-string values return `null`.
+ */
+export function commitToken(value) {
+    if (typeof value !== "string") {
+        return null;
+    }
+    const text = value.trim();
+    if (!text) {
+        return null;
+    }
+    const token = text.split(/\s+/)[0];
+    const low = token.toLowerCase();
+    if (low === "pending" || low.startsWith("n/a")) {
+        return null;
+    }
+    return COMMIT_HASH_RE.test(token) ? token : null;
+}
+function changeHas(changes, key) {
+    return changes instanceof Map ? changes.has(key) : Object.prototype.hasOwnProperty.call(changes, key);
+}
+function changeGet(changes, key) {
+    return changes instanceof Map ? changes.get(key) : changes[key];
+}
+function changeSize(changes) {
+    return changes instanceof Map ? changes.size : Object.keys(changes).length;
+}
+function splitKeepEnds(text) {
+    const matches = text.match(/[^\n]*\n|[^\n]+/g);
+    return matches ?? [];
+}
+/**
+ * Replace the `commit:` field of specific cycles, preserving the rest. `changes`
+ * maps cycle number to the new `commit` value. Multi-line commit scalars are
+ * replaced wholesale, dropping their continuation lines.
+ */
+export function rewriteCycleCommits(text, changes) {
+    if (changeSize(changes) === 0) {
+        return text;
+    }
+    const numberRe = /^-\s+number:\s*(\d+)\s*$/;
+    const listItemRe = /^-\s/;
+    const commitRe = /^(\s+)commit:\s*.*$/;
+    const topKeyRe = /^[A-Za-z_]/;
+    const lines = splitKeepEnds(text);
+    const out = [];
+    let inCycles = false;
+    let current = null;
+    let i = 0;
+    const total = lines.length;
+    while (i < total) {
+        const line = lines[i];
+        const body = line.endsWith("\n") ? line.slice(0, -1) : line;
+        if (topKeyRe.test(body)) {
+            inCycles = body.startsWith("cycles:");
+            current = null;
+            out.push(line);
+            i += 1;
+            continue;
+        }
+        if (inCycles) {
+            const numberMatch = numberRe.exec(body);
+            if (numberMatch) {
+                current = parseInt(numberMatch[1], 10);
+                out.push(line);
+                i += 1;
+                continue;
+            }
+            if (listItemRe.test(body)) {
+                current = null;
+                out.push(line);
+                i += 1;
+                continue;
+            }
+            const commitMatch = commitRe.exec(body);
+            if (commitMatch && current !== null && changeHas(changes, current)) {
+                const indent = commitMatch[1];
+                const keyIndent = indent.length;
+                const newline = line.endsWith("\n") ? "\n" : "";
+                out.push(`${indent}commit: "${changeGet(changes, current)}"${newline}`);
+                i += 1;
+                while (i < total) {
+                    const cont = lines[i].endsWith("\n") ? lines[i].slice(0, -1) : lines[i];
+                    if (!cont.trim()) {
+                        break;
+                    }
+                    const leading = (cont.match(/^ */)?.[0].length) ?? 0;
+                    if (leading > keyIndent && !listItemRe.test(cont)) {
+                        i += 1;
+                        continue;
+                    }
+                    break;
+                }
+                current = null;
+                continue;
+            }
+        }
+        out.push(line);
+        i += 1;
+    }
+    return out.join("");
+}
+/**
+ * Classify progress cycle commits and decide the backfill outcome. Pure with
+ * respect to the artifact: parses `text` and inspects git ancestry but never
+ * reads or writes the progress file.
+ */
+export function computeBackfill(text, options = {}) {
+    const mode = options.mode ?? "check";
+    const targetCommit = options.targetCommit ?? null;
+    let targetCycle = options.targetCycle ?? null;
+    const cwd = options.cwd ?? ".";
+    let data;
+    try {
+        data = loadYamlMapping(text);
+    }
+    catch (exc) {
+        return {
+            status: "error",
+            exitCode: 2,
+            operations: [],
+            changes: [],
+            message: `cannot parse progress artifact: ${exc.message}`,
+        };
+    }
+    const cyclesRaw = data && typeof data === "object" ? data.cycles : null;
+    if (!Array.isArray(cyclesRaw)) {
+        return {
+            status: "noop",
+            exitCode: 0,
+            operations: [],
+            changes: [],
+            message: "progress artifact has no cycles list",
+        };
+    }
+    if (ancestorState("HEAD", cwd) === "unavailable") {
+        return {
+            status: "noop",
+            exitCode: 0,
+            operations: [],
+            changes: [],
+            message: "git HEAD unavailable; cannot verify commit ancestry",
+        };
+    }
+    const fullCycles = [];
+    for (const c of cyclesRaw) {
+        if (c && typeof c === "object" && !Array.isArray(c)) {
+            const num = c.number;
+            if (typeof num === "number" && Number.isInteger(num)) {
+                fullCycles.push([num, c.commit]);
+            }
+        }
+    }
+    let targetToken = null;
+    if (targetCommit) {
+        const trimmed = targetCommit.trim();
+        targetToken = trimmed ? trimmed.split(/\s+/)[0] : "";
+        const state = targetToken ? ancestorState(targetToken, cwd) : "unknown";
+        if (state !== "ancestor") {
+            return {
+                status: "error",
+                exitCode: 2,
+                operations: [],
+                changes: [],
+                message: `refusing to backfill commit '${targetCommit}': it is ${state} relative to HEAD. ` +
+                    "Backfill only a commit already in HEAD's history; commit the product change first, " +
+                    "then backfill from a later commit (never amend to backfill).",
+            };
+        }
+        const known = new Set(fullCycles.map(([n]) => n));
+        if (targetCycle !== null && !known.has(targetCycle)) {
+            return {
+                status: "error",
+                exitCode: 2,
+                operations: [],
+                changes: [],
+                message: `cycle ${targetCycle} not found in progress cycles`,
+            };
+        }
+        if (targetCycle === null) {
+            targetCycle =
+                fullCycles.find(([, cv]) => {
+                    const tok = commitToken(cv);
+                    return tok === null || ancestorState(tok ?? "", cwd) === "stale";
+                })?.[0] ?? null;
+        }
+        if (targetCycle === null) {
+            return {
+                status: "noop",
+                exitCode: 0,
+                operations: [],
+                changes: [],
+                message: "no pending or stale cycle to backfill; pass --cycle N to target one",
+            };
+        }
+    }
+    const changes = new Map();
+    const operations = [];
+    for (const [number, commitValue] of fullCycles) {
+        if (number === targetCycle && targetToken) {
+            let action = "set-commit";
+            let state = "ancestor";
+            if (commitToken(commitValue) === targetToken) {
+                action = "none";
+                state = "ancestor";
+            }
+            else {
+                changes.set(number, targetToken);
+            }
+            operations.push({ cycle: number, commit: targetToken, state, action });
+            continue;
+        }
+        const token = commitToken(commitValue);
+        if (token === null) {
+            operations.push({ cycle: number, commit: commitValue, state: "exempt", action: "none" });
+            continue;
+        }
+        const state = ancestorState(token, cwd);
+        if (state === "stale") {
+            changes.set(number, "pending");
+            operations.push({ cycle: number, commit: token, state: "stale", action: "reset-to-pending" });
+        }
+        else {
+            operations.push({ cycle: number, commit: token, state, action: "none" });
+        }
+    }
+    const sortedChanges = [...changes.entries()].sort((a, b) => b[0] - a[0]);
+    if (changes.size === 0) {
+        return { status: "clean", exitCode: 0, operations, changes: sortedChanges, message: null };
+    }
+    if (mode === "fix") {
+        return { status: "fixed", exitCode: 0, operations, changes: sortedChanges, message: null };
+    }
+    return { status: "action-needed", exitCode: 1, operations, changes: sortedChanges, message: null };
+}
+/**
+ * Flag progress cycle `commit` hashes that are not ancestors of HEAD. Faithful
+ * port of progress_commit.validate_progress_commits.
+ */
+export function validateProgressCommits(content, cwd = ".") {
+    let data;
+    try {
+        data = loadYamlMapping(content);
+    }
+    catch {
+        return [];
+    }
+    if (!data || typeof data !== "object" || Array.isArray(data)) {
+        return [];
+    }
+    const cycles = data.cycles;
+    if (!Array.isArray(cycles)) {
+        return [];
+    }
+    if (ancestorState("HEAD", cwd) === "unavailable") {
+        return [];
+    }
+    const violations = [];
+    for (const entry of cycles) {
+        if (!entry || typeof entry !== "object" || Array.isArray(entry)) {
+            continue;
+        }
+        const raw = entry.commit;
+        if (typeof raw !== "string") {
+            continue;
+        }
+        const token = commitToken(raw);
+        if (token === null) {
+            continue;
+        }
+        if (ancestorState(token, cwd) === "stale") {
+            const number = entry.number ?? "?";
+            violations.push(`progress: cycle ${number} commit '${token}' is not an ancestor of HEAD ` +
+                "(stale or self-referential); set it to `pending` or run " +
+                "`agentera check backfill --mode fix`, then forward-fill the product commit " +
+                "(never amend to backfill)");
+        }
+    }
+    return violations;
+}
+//# sourceMappingURL=progressCommit.js.map

package/dist/state/progressCommit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"progressCommit.js","sourceRoot":"","sources":["../../src/state/progressCommit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAElD;;;GAGG;AAEH,MAAM,CAAC,MAAM,cAAc,GAAG,qBAAqB,CAAC;AAEpD;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC1B,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACnC,MAAM,GAAG,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;IAChC,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QAC/C,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;AACnD,CAAC;AAID,SAAS,SAAS,CAAC,OAAkB,EAAE,GAAW;IAChD,OAAO,OAAO,YAAY,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;AACxG,CAAC;AAED,SAAS,SAAS,CAAC,OAAkB,EAAE,GAAW;IAChD,OAAO,OAAO,YAAY,GAAG,CAAC,CAAC,CAAE,OAAO,CAAC,GAAG,CAAC,GAAG,CAAY,CAAC,CAAC,CAAE,OAAkC,CAAC,GAAG,CAAC,CAAC;AAC1G,CAAC;AAED,SAAS,UAAU,CAAC,OAAkB;IACpC,OAAO,OAAO,YAAY,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;AAC7E,CAAC;AAED,SAAS,aAAa,CAAC,IAAY;IACjC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;IAC/C,OAAO,OAAO,IAAI,EAAE,CAAC;AACvB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAY,EAAE,OAAkB;IAClE,IAAI,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC9B,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,QAAQ,GAAG,0BAA0B,CAAC;IAC5C,MAAM,UAAU,GAAG,MAAM,CAAC;IAC1B,MAAM,QAAQ,GAAG,qBAAqB,CAAC;IACvC,MAAM,QAAQ,GAAG,YAAY,CAAC;IAC9B,MAAM,KAAK,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,IAAI,OAAO,GAAkB,IAAI,CAAC;IAClC,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC;IAC3B,OAAO,CAAC,GAAG,KAAK,EAAE,CAAC;QACjB,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACtB,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAC5D,IAAI,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACxB,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;YACtC,OAAO,GAAG,IAAI,CAAC;YACf,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACf,CAAC,IAAI,CAAC,CAAC;YACP,SAAS;QACX,CAAC;QACD,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,WAAW,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACxC,IAAI,WAAW,EAAE,CAAC;gBAChB,OAAO,GAAG,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACvC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACf,CAAC,IAAI,CAAC,CAAC;gBACP,SAAS;YACX,CAAC;YACD,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC1B,OAAO,GAAG,IAAI,CAAC;gBACf,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACf,CAAC,IAAI,CAAC,CAAC;gBACP,SAAS;YACX,CAAC;YACD,MAAM,WAAW,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACxC,IAAI,WAAW,IAAI,OAAO,KAAK,IAAI,IAAI,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC;gBACnE,MAAM,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;gBAC9B,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC;gBAChC,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;gBAChD,GAAG,CAAC,IAAI,CAAC,GAAG,MAAM,YAAY,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,OAAO,EAAE,CAAC,CAAC;gBACxE,CAAC,IAAI,CAAC,CAAC;gBACP,OAAO,CAAC,GAAG,KAAK,EAAE,CAAC;oBACjB,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;oBACxE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;wBACjB,MAAM;oBACR,CAAC;oBACD,MAAM,OAAO,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;oBACrD,IAAI,OAAO,GAAG,SAAS,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;wBAClD,CAAC,IAAI,CAAC,CAAC;wBACP,SAAS;oBACX,CAAC;oBACD,MAAM;gBACR,CAAC;gBACD,OAAO,GAAG,IAAI,CAAC;gBACf,SAAS;YACX,CAAC;QACH,CAAC;QACD,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACf,CAAC,IAAI,CAAC,CAAC;IACT,CAAC;IACD,OAAO,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACtB,CAAC;AAyBD;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY,EAAE,UAA2B,EAAE;IACzE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC;IACrC,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,IAAI,CAAC;IAClD,IAAI,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,IAAI,CAAC;IAC9C,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC;IAE/B,IAAI,IAA6B,CAAC;IAClC,IAAI,CAAC;QACH,IAAI,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL,MAAM,EAAE,OAAO;YACf,QAAQ,EAAE,CAAC;YACX,UAAU,EAAE,EAAE;YACd,OAAO,EAAE,EAAE;YACX,OAAO,EAAE,mCAAoC,GAAa,CAAC,OAAO,EAAE;SACrE,CAAC;IACJ,CAAC;IACD,MAAM,SAAS,GAAG,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAE,IAAgC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;IACrG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QAC9B,OAAO;YACL,MAAM,EAAE,MAAM;YACd,QAAQ,EAAE,CAAC;YACX,UAAU,EAAE,EAAE;YACd,OAAO,EAAE,EAAE;YACX,OAAO,EAAE,sCAAsC;SAChD,CAAC;IACJ,CAAC;IAED,IAAI,aAAa,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,aAAa,EAAE,CAAC;QACjD,OAAO;YACL,MAAM,EAAE,MAAM;YACd,QAAQ,EAAE,CAAC;YACX,UAAU,EAAE,EAAE;YACd,OAAO,EAAE,EAAE;YACX,OAAO,EAAE,qDAAqD;SAC/D,CAAC;IACJ,CAAC;IAED,MAAM,UAAU,GAA6B,EAAE,CAAC;IAChD,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;QAC1B,IAAI,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;YACpD,MAAM,GAAG,GAAI,CAA6B,CAAC,MAAM,CAAC;YAClD,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC;gBACrD,UAAU,CAAC,IAAI,CAAC,CAAC,GAAG,EAAG,CAA6B,CAAC,MAAM,CAAC,CAAC,CAAC;YAChE,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,WAAW,GAAkB,IAAI,CAAC;IACtC,IAAI,YAAY,EAAE,CAAC;QACjB,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,EAAE,CAAC;QACpC,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACrD,MAAM,KAAK,GAAG,WAAW,CAAC,CAAC,CAAC,aAAa,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACxE,IAAI,KAAK,KAAK,UAAU,EAAE,CAAC;YACzB,OAAO;gBACL,MAAM,EAAE,OAAO;gBACf,QAAQ,EAAE,CAAC;gBACX,UAAU,EAAE,EAAE;gBACd,OAAO,EAAE,EAAE;gBACX,OAAO,EACL,gCAAgC,YAAY,YAAY,KAAK,qBAAqB;oBAClF,qFAAqF;oBACrF,8DAA8D;aACjE,CAAC;QACJ,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAClD,IAAI,WAAW,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC;YACpD,OAAO;gBACL,MAAM,EAAE,OAAO;gBACf,QAAQ,EAAE,CAAC;gBACX,UAAU,EAAE,EAAE;gBACd,OAAO,EAAE,EAAE;gBACX,OAAO,EAAE,SAAS,WAAW,+BAA+B;aAC7D,CAAC;QACJ,CAAC;QACD,IAAI,WAAW,KAAK,IAAI,EAAE,CAAC;YACzB,WAAW;gBACT,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE;oBACzB,MAAM,GAAG,GAAG,WAAW,CAAC,EAAE,CAAC,CAAC;oBAC5B,OAAO,GAAG,KAAK,IAAI,IAAI,aAAa,CAAC,GAAG,IAAI,EAAE,EAAE,GAAG,CAAC,KAAK,OAAO,CAAC;gBACnE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;QACpB,CAAC;QACD,IAAI,WAAW,KAAK,IAAI,EAAE,CAAC;YACzB,OAAO;gBACL,MAAM,EAAE,MAAM;gBACd,QAAQ,EAAE,CAAC;gBACX,UAAU,EAAE,EAAE;gBACd,OAAO,EAAE,EAAE;gBACX,OAAO,EAAE,qEAAqE;aAC/E,CAAC;QACJ,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC1C,MAAM,UAAU,GAAwB,EAAE,CAAC;IAC3C,KAAK,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,IAAI,UAAU,EAAE,CAAC;QAC/C,IAAI,MAAM,KAAK,WAAW,IAAI,WAAW,EAAE,CAAC;YAC1C,IAAI,MAAM,GAAG,YAAY,CAAC;YAC1B,IAAI,KAAK,GAAG,UAAU,CAAC;YACvB,IAAI,WAAW,CAAC,WAAW,CAAC,KAAK,WAAW,EAAE,CAAC;gBAC7C,MAAM,GAAG,MAAM,CAAC;gBAChB,KAAK,GAAG,UAAU,CAAC;YACrB,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;YACnC,CAAC;YACD,UAAU,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;YACvE,SAAS;QACX,CAAC;QACD,MAAM,KAAK,GAAG,WAAW,CAAC,WAAW,CAAC,CAAC;QACvC,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YACnB,UAAU,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;YACzF,SAAS;QACX,CAAC;QACD,MAAM,KAAK,GAAG,aAAa,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QACxC,IAAI,KAAK,KAAK,OAAO,EAAE,CAAC;YACtB,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;YAC/B,UAAU,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,kBAAkB,EAAE,CAAC,CAAC;QAChG,CAAC;aAAM,CAAC;YACN,UAAU,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QAC3E,CAAC;IACH,CAAC;IAED,MAAM,aAAa,GAA4B,CAAC,GAAG,OAAO,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;IAClG,IAAI,OAAO,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,UAAU,EAAE,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC7F,CAAC;IACD,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;QACnB,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,UAAU,EAAE,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC7F,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,QAAQ,EAAE,CAAC,EAAE,UAAU,EAAE,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AACrG,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,OAAe,EAAE,MAAc,GAAG;IACxE,IAAI,IAA6B,CAAC;IAClC,IAAI,CAAC;QACH,IAAI,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;IAClC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7D,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,MAAM,MAAM,GAAI,IAAgC,CAAC,MAAM,CAAC;IACxD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3B,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,IAAI,aAAa,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,aAAa,EAAE,CAAC;QACjD,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAChE,SAAS;QACX,CAAC;QACD,MAAM,GAAG,GAAI,KAAiC,CAAC,MAAM,CAAC;QACtD,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;YAC5B,SAAS;QACX,CAAC;QACD,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;QAC/B,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YACnB,SAAS;QACX,CAAC;QACD,IAAI,aAAa,CAAC,KAAK,EAAE,GAAG,CAAC,KAAK,OAAO,EAAE,CAAC;YAC1C,MAAM,MAAM,GAAI,KAAiC,CAAC,MAAM,IAAI,GAAG,CAAC;YAChE,UAAU,CAAC,IAAI,CACb,mBAAmB,MAAM,YAAY,KAAK,+BAA+B;gBACvE,0DAA0D;gBAC1D,6EAA6E;gBAC7E,2BAA2B,CAC9B,CAAC;QACJ,CAAC;IACH,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/state/startupAnalysis/benchmark.js

@@ -0,0 +1,371 @@
+import fs from "node:fs";
+import path from "node:path";
+import { spawnSync as _spawnSync } from "node:child_process";
+import { pyJsonIndent } from "../../core/pyjson.js";
+import { loadTomlFile } from "../../core/toml.js";
+import { resolveSourceRoot } from "../../core/sourceRoot.js";
+import { loadContract, parseTimestamp, formatTimestamp } from "./contract.js";
+import { inc, counterDict, safeInt, pyJsonDumps } from "./helpers.js";
+import { boundedRuntimeStatus } from "./threshold.js";
+import { classifyStartupRecords } from "./records.js";
+import { renderStartupReport } from "./report.js";
+export const STARTUP_INTERMEDIATE_ENVELOPE = "startup_state_analysis_v1";
+export const BENCHMARK_HISTORY_JSONL = "runs.jsonl";
+export const BENCHMARK_LATEST_REPORT_JSON = "latest-report.json";
+export const BENCHMARK_LATEST_REPORT_MARKDOWN = "latest-report.md";
+const TOKEN_AGGREGATE_FIELDS = new Set([
+    "token_estimator_version",
+    "estimated_raw_after_cli_tokens",
+    "estimated_redundant_raw_tokens",
+    "estimated_raw_after_cli_tokens_by_artifact",
+    "estimated_redundant_raw_tokens_by_artifact",
+]);
+function maxRecordTimestamp(records, after = null) {
+    let latest = null;
+    for (const record of records) {
+        if (!record || typeof record !== "object" || Array.isArray(record))
+            continue;
+        const ts = parseTimestamp(record.timestamp);
+        if (ts === null)
+            continue;
+        if (after !== null && ts.getTime() <= after.getTime())
+            continue;
+        if (latest === null || ts.getTime() > latest.getTime())
+            latest = ts;
+    }
+    return latest;
+}
+function artifactLabelCounts(sequences) {
+    const counts = {};
+    for (const sequence of sequences) {
+        for (const event of Array.isArray(sequence.events) ? sequence.events : []) {
+            if (event && typeof event === "object" && !Array.isArray(event) && typeof event.artifact_label === "string") {
+                inc(counts, event.artifact_label);
+            }
+        }
+    }
+    return counterDict(counts);
+}
+function runtimeRecordCounts(records) {
+    const counts = {};
+    for (const record of records) {
+        if (record && typeof record === "object") {
+            const runtime = record.runtime;
+            if (typeof runtime === "string")
+                inc(counts, runtime);
+        }
+    }
+    return counterDict(counts);
+}
+function agenteraVersion(root = resolveSourceRoot()) {
+    try {
+        const data = loadTomlFile(path.join(root, "pyproject.toml")); // cast: IO boundary — TOML parse of pyproject.toml
+        const project = data.project;
+        if (project && typeof project === "object" && typeof project.version === "string") {
+            return project.version;
+        }
+    }
+    catch {
+        return "unknown";
+    }
+    return "unknown";
+}
+function gitOutput(args, root = resolveSourceRoot()) {
+    const result = _spawnSync("git", args, { cwd: root, encoding: "utf8", timeout: 5000 });
+    if (result.error || result.status !== 0)
+        return null;
+    return (result.stdout ?? "").trim();
+}
+function gitMetadata(root = resolveSourceRoot()) {
+    const commit = gitOutput(["rev-parse", "HEAD"], root) || "unknown";
+    const status = gitOutput(["status", "--porcelain"], root);
+    return { git_commit: commit, git_dirty: status !== null ? Boolean(status) : false };
+}
+function runtimeScope(metrics, approvedScope = null) {
+    if (approvedScope && approvedScope.length > 0) {
+        return [...new Set(approvedScope.filter((l) => l).map((l) => String(l)))].sort();
+    }
+    const labels = new Set();
+    for (const item of Array.isArray(metrics.runtime_coverage) ? metrics.runtime_coverage : []) {
+        if (item && typeof item === "object" && !Array.isArray(item) && typeof item.runtime === "string")
+            labels.add(item.runtime);
+    }
+    const runtimeCounts = metrics.runtime_record_counts;
+    if (runtimeCounts && typeof runtimeCounts === "object") {
+        for (const label of Object.keys(runtimeCounts))
+            if (label)
+                labels.add(String(label));
+    }
+    const sorted = [...labels].sort();
+    return sorted.length > 0 ? sorted : ["unknown"];
+}
+function runtimeScopeMatches(row, scope) {
+    const value = row.runtime_scope;
+    if (!Array.isArray(value))
+        return false;
+    const a = value.map((l) => String(l)).sort();
+    const b = scope.map((l) => String(l)).sort();
+    return a.length === b.length && a.every((v, i) => v === b[i]);
+}
+export function previousBenchmarkWatermark(benchmarkDir, scope) {
+    const historyPath = path.join(benchmarkDir, BENCHMARK_HISTORY_JSONL);
+    let lines;
+    try {
+        lines = fs.readFileSync(historyPath, "utf8").split(/\r\n|\r|\n/);
+    }
+    catch {
+        return null;
+    }
+    let watermark = null;
+    for (const line of lines) {
+        if (!line.trim())
+            continue;
+        let row;
+        try {
+            row = JSON.parse(line);
+        }
+        catch {
+            continue;
+        }
+        if (!row || typeof row !== "object" || !runtimeScopeMatches(row, scope))
+            continue;
+        const candidate = parseTimestamp(row.benchmark_watermark_at);
+        if (candidate !== null)
+            watermark = candidate;
+    }
+    return watermark;
+}
+function previousBenchmarkRow(benchmarkDir, scope) {
+    const historyPath = path.join(benchmarkDir, BENCHMARK_HISTORY_JSONL);
+    let lines;
+    try {
+        lines = fs.readFileSync(historyPath, "utf8").split(/\r\n|\r|\n/);
+    }
+    catch {
+        return null;
+    }
+    let previous = null;
+    for (const line of lines) {
+        if (!line.trim())
+            continue;
+        let row;
+        try {
+            row = JSON.parse(line);
+        }
+        catch {
+            continue;
+        }
+        if (row && typeof row === "object" && runtimeScopeMatches(row, scope))
+            previous = row;
+    }
+    return previous;
+}
+function withEstimatedTokensSaved(metrics, benchmarkDir, scope) {
+    const enriched = { ...metrics };
+    const previous = previousBenchmarkRow(benchmarkDir, scope);
+    const currentVersion = enriched.token_estimator_version;
+    const currentRedundant = enriched.estimated_redundant_raw_tokens;
+    let reason = null;
+    let saved = null;
+    if (previous === null) {
+        reason = "previous_row_missing";
+    }
+    else if (![...TOKEN_AGGREGATE_FIELDS].every((f) => f in previous)) {
+        reason = "previous_missing_token_estimates";
+    }
+    else if (previous.contract_version !== enriched.contract_version) {
+        reason = "contract_version_mismatch";
+    }
+    else if (previous.benchmark_mode !== (enriched.benchmark_mode || "full_boundary_snapshot")) {
+        reason = "benchmark_mode_mismatch";
+    }
+    else if (!runtimeScopeMatches(previous, scope)) {
+        reason = "runtime_scope_mismatch";
+    }
+    else if (previous.token_estimator_version !== currentVersion) {
+        reason = "estimator_version_mismatch";
+    }
+    else if (!(typeof previous.estimated_redundant_raw_tokens === "number" && Number.isInteger(previous.estimated_redundant_raw_tokens)) ||
+        !(typeof currentRedundant === "number" && Number.isInteger(currentRedundant))) {
+        reason = "previous_missing_token_estimates";
+    }
+    else {
+        saved = previous.estimated_redundant_raw_tokens - currentRedundant;
+    }
+    enriched.estimated_tokens_saved_vs_previous = saved;
+    enriched.estimated_tokens_saved_vs_previous_null_reason = reason;
+    return enriched;
+}
+export function buildBenchmarkHistoryRow(metrics, scope = null) {
+    const recommendation = metrics && typeof metrics === "object" && metrics.startup_recommendation && typeof metrics.startup_recommendation === "object" && !Array.isArray(metrics.startup_recommendation)
+        ? metrics.startup_recommendation
+        : {};
+    return {
+        contract_version: metrics.contract_version ?? null,
+        generated_at: metrics.generated_at ?? null,
+        agentera_version: agenteraVersion(),
+        ...gitMetadata(),
+        runtime_scope: runtimeScope(metrics, scope),
+        benchmark_mode: metrics.benchmark_mode || "full_boundary_snapshot",
+        benchmark_previous_watermark_at: metrics.benchmark_previous_watermark_at ?? null,
+        benchmark_window_started_after: metrics.benchmark_window_started_after ?? null,
+        benchmark_watermark_at: metrics.benchmark_watermark_at ?? null,
+        total_records: safeInt(metrics.total_records),
+        total_state_sequences: safeInt(metrics.total_state_sequences),
+        state_sequences_with_raw_after_cli: safeInt(metrics.state_sequences_with_raw_after_cli),
+        state_sequences_with_redundant_raw_access: safeInt(metrics.state_sequences_with_redundant_raw_access),
+        raw_after_cli_rate: metrics.raw_after_cli_sequence_rate ?? 0,
+        redundant_raw_access_rate: metrics.redundant_raw_sequence_rate ?? 0,
+        cli_state_command_counts: metrics.cli_state_command_counts ?? {},
+        raw_artifact_access_after_cli_counts: metrics.raw_artifact_access_after_cli_counts ?? {},
+        redundant_raw_artifact_access_counts: metrics.redundant_raw_artifact_access_counts ?? {},
+        token_estimator_version: metrics.token_estimator_version ?? null,
+        estimated_raw_after_cli_tokens: safeInt(metrics.estimated_raw_after_cli_tokens),
+        estimated_redundant_raw_tokens: safeInt(metrics.estimated_redundant_raw_tokens),
+        estimated_raw_after_cli_tokens_by_artifact: metrics.estimated_raw_after_cli_tokens_by_artifact ?? {},
+        estimated_redundant_raw_tokens_by_artifact: metrics.estimated_redundant_raw_tokens_by_artifact ?? {},
+        estimated_tokens_saved_vs_previous: metrics.estimated_tokens_saved_vs_previous ?? null,
+        estimated_tokens_saved_vs_previous_null_reason: metrics.estimated_tokens_saved_vs_previous_null_reason ?? null,
+        per_capability_state_counts: metrics.per_capability_state_counts ?? {},
+        degradation_reason_counts: metrics.degradation_reason_counts ?? {},
+        bounded_degradation_counts: {
+            record_or_sequence: metrics.degradation_reason_counts ?? {},
+            runtime_status: metrics.runtime_status_counts ?? {},
+        },
+        startup_recommendation_action: recommendation.action ?? null,
+    };
+}
+function temporaryPeerPath(p) {
+    const ts = new Date().toISOString().replace(/[-:.TZ]/g, "");
+    const dir = path.dirname(p);
+    const base = path.basename(p);
+    return path.join(dir, `.${base}.${process.pid}.${ts}.tmp`);
+}
+export function persistStartupBenchmark(metrics, benchmarkDir, scope = null) {
+    const resolvedDir = path.resolve(benchmarkDir);
+    if (!path.isAbsolute(resolvedDir)) {
+        throw new Error("benchmark directory must be an absolute path");
+    }
+    const resolvedScope = runtimeScope(metrics, scope);
+    const enriched = withEstimatedTokensSaved(metrics, resolvedDir, resolvedScope);
+    const structuredText = pyJsonIndent(enriched) + "\n";
+    const humanText = renderStartupReport(enriched);
+    const rowText = pyJsonDumps(buildBenchmarkHistoryRow(enriched, resolvedScope)) + "\n";
+    fs.mkdirSync(resolvedDir, { recursive: true });
+    const historyPath = path.join(resolvedDir, BENCHMARK_HISTORY_JSONL);
+    const jsonPath = path.join(resolvedDir, BENCHMARK_LATEST_REPORT_JSON);
+    const markdownPath = path.join(resolvedDir, BENCHMARK_LATEST_REPORT_MARKDOWN);
+    const jsonTmp = temporaryPeerPath(jsonPath);
+    const markdownTmp = temporaryPeerPath(markdownPath);
+    try {
+        fs.writeFileSync(jsonTmp, structuredText);
+        fs.writeFileSync(markdownTmp, humanText);
+        fs.appendFileSync(historyPath, rowText);
+        fs.renameSync(jsonTmp, jsonPath);
+        fs.renameSync(markdownTmp, markdownPath);
+    }
+    catch (err) {
+        for (const tmp of [jsonTmp, markdownTmp]) {
+            try {
+                fs.unlinkSync(tmp);
+            }
+            catch {
+                /* ignore */
+            }
+        }
+        throw err;
+    }
+    return { history: historyPath, structured: jsonPath, human_readable: markdownPath };
+}
+export function buildStartupIntermediate(corpus, opts) {
+    const salt = opts.salt;
+    const loaded = opts.contract ?? loadContract();
+    let records = corpus && typeof corpus === "object" && !Array.isArray(corpus) ? (corpus.records ?? []) : [];
+    if (!Array.isArray(records))
+        records = [];
+    let metadata = corpus && typeof corpus === "object" && !Array.isArray(corpus) ? (corpus.metadata ?? {}) : {};
+    if (!metadata || typeof metadata !== "object" || Array.isArray(metadata))
+        metadata = {};
+    let runtimeStatuses = metadata.runtime_statuses;
+    if (!Array.isArray(runtimeStatuses))
+        runtimeStatuses = [];
+    const boundaryInfo = loaded.boundary && typeof loaded.boundary === "object" && !Array.isArray(loaded.boundary) ? loaded.boundary : {};
+    const boundary = parseTimestamp(boundaryInfo.committed_at);
+    const windowStartedAfter = opts.benchmarkWindowStartedAfter ?? boundary;
+    const watermarkAt = opts.benchmarkWatermarkAt ?? maxRecordTimestamp(records, windowStartedAfter);
+    const classified = classifyStartupRecords(corpus, { salt, contract: loaded });
+    const sequences = (Array.isArray(classified.state_gathering_sequences) ? classified.state_gathering_sequences : []);
+    const degradations = classified.degradations;
+    const runtimeCoverage = runtimeStatuses
+        .filter((s) => Boolean(s && typeof s === "object" && !Array.isArray(s)))
+        .map((s) => boundedRuntimeStatus(s));
+    return {
+        output_envelope: STARTUP_INTERMEDIATE_ENVELOPE,
+        contract_version: loaded.version ?? null,
+        boundary_source: boundaryInfo.source ?? null,
+        boundary_commit: boundaryInfo.commit ?? null,
+        boundary_committed_at: boundaryInfo.committed_at ?? null,
+        benchmark_mode: opts.benchmarkMode || "full_boundary_snapshot",
+        benchmark_previous_watermark_at: formatTimestamp(opts.benchmarkPreviousWatermarkAt ?? null),
+        benchmark_window_started_after: formatTimestamp(windowStartedAfter),
+        benchmark_watermark_at: formatTimestamp(watermarkAt),
+        corpus_adapter_version: metadata.adapter_version ?? null,
+        runtime_coverage: runtimeCoverage,
+        runtime_record_counts: runtimeRecordCounts(records),
+        total_records_read: records.length,
+        total_state_sequences: sequences.length,
+        artifact_label_counts: artifactLabelCounts(sequences),
+        state_gathering_sequences: sequences,
+        degradations,
+        compatibility_note: "Section 22 corpus records are read-only; startup state data is emitted only in startup_state_analysis_v1.",
+    };
+}
+export function buildNoRuntimeStartupIntermediate(opts = {}) {
+    const loaded = opts.contract ?? loadContract();
+    const boundaryInfo = loaded.boundary && typeof loaded.boundary === "object" && !Array.isArray(loaded.boundary) ? loaded.boundary : {};
+    const boundary = parseTimestamp(boundaryInfo.committed_at);
+    const windowStartedAfter = opts.benchmarkPreviousWatermarkAt ?? boundary;
+    return {
+        output_envelope: STARTUP_INTERMEDIATE_ENVELOPE,
+        contract_version: loaded.version ?? null,
+        boundary_source: boundaryInfo.source ?? null,
+        boundary_commit: boundaryInfo.commit ?? null,
+        boundary_committed_at: boundaryInfo.committed_at ?? null,
+        benchmark_mode: opts.benchmarkMode ?? "since_previous_benchmark",
+        benchmark_previous_watermark_at: formatTimestamp(opts.benchmarkPreviousWatermarkAt ?? null),
+        benchmark_window_started_after: formatTimestamp(windowStartedAfter),
+        benchmark_watermark_at: formatTimestamp(opts.benchmarkPreviousWatermarkAt ?? null),
+        corpus_adapter_version: null,
+        runtime_coverage: [{ runtime: "none", status: "skipped", reason: "no_runtime_stores_approved", record_count: 0 }],
+        runtime_record_counts: {},
+        total_records_read: 0,
+        total_state_sequences: 0,
+        artifact_label_counts: {},
+        state_gathering_sequences: [],
+        degradations: [],
+        compatibility_note: "No runtime stores were approved, so no local runtime history was read.",
+    };
+}
+export function extractStartupIntermediateFromCorpusFile(corpusPath, opts) {
+    let corpus;
+    try {
+        corpus = JSON.parse(fs.readFileSync(corpusPath, "utf8"));
+    }
+    catch {
+        corpus = {
+            metadata: {
+                runtime_statuses: [
+                    { runtime: "local-corpus", status: "degraded", reason: "schema_divergent", error_count: 1 },
+                ],
+            },
+            records: [],
+        };
+    }
+    const intermediate = buildStartupIntermediate(corpus, { salt: opts.salt, contract: opts.contract ?? null });
+    if (opts.outputPath) {
+        fs.mkdirSync(path.dirname(opts.outputPath), { recursive: true });
+        fs.writeFileSync(opts.outputPath, pyJsonIndent(intermediate) + "\n");
+    }
+    return intermediate;
+}
+//# sourceMappingURL=benchmark.js.map