@deepthonk/core 0.1.5 → 0.2.0

package/dist/checkpointStore.js

@@ -0,0 +1,351 @@
+import { createHash, randomUUID } from "node:crypto";
+import { mkdir, readFile, rename, writeFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { ConfigError } from "./errors.js";
+import { runLimitedPhase } from "./phaseRunner.js";
+export const traceSchemaVersion = 2;
+export async function runCheckpointedPhase(options) {
+    assertUniqueWorkIds(options.jobs);
+    const manifest = await ensurePhaseManifest(options.runDir, options.phaseKey, options.jobs);
+    const results = new Array(options.jobs.length);
+    const missing = [];
+    const reused = [];
+    for (let index = 0; index < options.jobs.length; index += 1) {
+        const job = options.jobs[index];
+        const inputHash = manifest.work[index].input_hash;
+        const checkpoint = await readValidCheckpoint(options.runDir, options.phaseKey, job.id, inputHash, options.validateOutput);
+        if (!checkpoint) {
+            missing.push({ index, job, inputHash });
+            continue;
+        }
+        results[index] = checkpoint.output;
+        reused.push({ job, checkpoint });
+    }
+    if (options.onResult && reused.length > 0) {
+        function* reusedCallbacks() {
+            for (const item of reused) {
+                yield async () => {
+                    await options.onResult(item.checkpoint.output, {
+                        workId: item.job.id,
+                        reused: true,
+                        receiptUsage: item.checkpoint.usage
+                    });
+                };
+            }
+        }
+        // Receipt replay is local I/O, not provider work. Give it a separate bounded
+        // fan-out so TraceStore can coalesce append-ready rows even when model
+        // concurrency is deliberately one.
+        await runLimitedPhase(reusedCallbacks(), Math.min(32, reused.length), { signal: options.signal });
+    }
+    function* pendingJobs() {
+        for (const pending of missing) {
+            yield async (signal) => {
+                const output = await pending.job.run(signal);
+                if (options.validateOutput && !options.validateOutput(output)) {
+                    throw new ConfigError(`Checkpoint job ${pending.job.id} produced an invalid output.`, {
+                        code: "trace.checkpoint_output_invalid",
+                        retryable: false
+                    });
+                }
+                const usage = pending.job.receiptUsage?.();
+                await writeCheckpoint(options.runDir, options.phaseKey, pending.job.id, pending.inputHash, output, usage);
+                await options.onResult?.(output, { workId: pending.job.id, reused: false, receiptUsage: usage });
+                return { index: pending.index, output };
+            };
+        }
+    }
+    const completed = await runLimitedPhase(pendingJobs(), options.concurrency, { signal: options.signal });
+    for (const item of completed)
+        results[item.index] = item.output;
+    if (results.some((value) => value === undefined)) {
+        throw new ConfigError(`Phase ${options.phaseKey} did not produce every checkpointed result.`, {
+            code: "trace.checkpoint_incomplete",
+            retryable: true
+        });
+    }
+    return results;
+}
+export async function writePhaseCommit(runDir, phaseKey, artifacts) {
+    await readJsonStrictOptional(commitPath(runDir, phaseKey));
+    const manifest = await readPhaseManifest(runDir, phaseKey);
+    if (!manifest)
+        throw traceIntegrityError(`Missing manifest for phase ${phaseKey}.`);
+    validateManifest(manifest, phaseKey);
+    const checkpointHashes = {};
+    for (const work of manifest.work) {
+        const checkpoint = await readValidCheckpoint(runDir, phaseKey, work.work_id, work.input_hash);
+        if (!checkpoint)
+            throw traceIntegrityError(`Missing or invalid checkpoint ${work.work_id} for phase ${phaseKey}.`);
+        checkpointHashes[work.work_id] = checkpointBindingHash(checkpoint);
+    }
+    const commit = {
+        schema_version: 2,
+        phase_key: phaseKey,
+        manifest_hash: manifest.manifest_hash,
+        checkpoint_hashes: checkpointHashes,
+        artifact_hashes: Object.fromEntries(Object.entries(artifacts).map(([name, value]) => [name, hashValue(value)])),
+        committed_at: new Date().toISOString()
+    };
+    await writeJsonAtomic(commitPath(runDir, phaseKey), commit);
+    return commit;
+}
+export async function validatePhaseCommit(runDir, phaseKey, artifacts) {
+    const commit = await readJsonStrictOptional(commitPath(runDir, phaseKey));
+    if (!commit || commit.schema_version !== 2 || commit.phase_key !== phaseKey) {
+        throw traceIntegrityError(`Missing or invalid phase commit for ${phaseKey}.`);
+    }
+    const manifest = await readPhaseManifest(runDir, phaseKey);
+    if (!manifest)
+        throw traceIntegrityError(`Missing manifest for committed phase ${phaseKey}.`);
+    validateManifest(manifest, phaseKey);
+    if (commit.manifest_hash !== manifest.manifest_hash) {
+        throw traceIntegrityError(`Manifest hash changed for committed phase ${phaseKey}.`);
+    }
+    const expectedCheckpointHashes = {};
+    for (const work of manifest.work) {
+        const checkpoint = await readValidCheckpoint(runDir, phaseKey, work.work_id, work.input_hash);
+        if (!checkpoint)
+            throw traceIntegrityError(`Checkpoint ${work.work_id} is invalid for committed phase ${phaseKey}.`);
+        expectedCheckpointHashes[work.work_id] = checkpointBindingHash(checkpoint);
+    }
+    if (stableJson(commit.checkpoint_hashes) !== stableJson(expectedCheckpointHashes)) {
+        throw traceIntegrityError(`Checkpoint bindings changed for committed phase ${phaseKey}.`);
+    }
+    if (artifacts) {
+        const expectedArtifacts = Object.fromEntries(Object.entries(artifacts).map(([name, value]) => [name, hashValue(value)]));
+        if (stableJson(commit.artifact_hashes) !== stableJson(expectedArtifacts)) {
+            throw traceIntegrityError(`Artifact bindings changed for committed phase ${phaseKey}.`);
+        }
+    }
+    return commit;
+}
+export async function validatePhaseCommitIfPresent(runDir, phaseKey, artifacts) {
+    const commit = await readJsonStrictOptional(commitPath(runDir, phaseKey));
+    if (!commit)
+        return undefined;
+    return validatePhaseCommit(runDir, phaseKey, artifacts);
+}
+export async function readValidatedPhaseReceiptUsage(runDir, phaseKey) {
+    const manifest = await readPhaseManifest(runDir, phaseKey);
+    if (!manifest)
+        return [];
+    validateManifest(manifest, phaseKey);
+    const usage = [];
+    for (const work of manifest.work) {
+        const checkpoint = await readValidCheckpoint(runDir, phaseKey, work.work_id, work.input_hash);
+        if (!checkpoint)
+            continue;
+        if (Array.isArray(checkpoint.usage))
+            usage.push(...checkpoint.usage);
+    }
+    return usage;
+}
+export function hashValue(value) {
+    return `sha256:${createHash("sha256").update(stableJson(value)).digest("hex")}`;
+}
+export function stableJson(value) {
+    if (Array.isArray(value))
+        return `[${value.map(stableJson).join(",")}]`;
+    if (value && typeof value === "object") {
+        const entries = Object.entries(value)
+            .filter(([, inner]) => inner !== undefined)
+            .sort(([left], [right]) => left.localeCompare(right))
+            .map(([key, inner]) => `${JSON.stringify(key)}:${stableJson(inner)}`);
+        return `{${entries.join(",")}}`;
+    }
+    return JSON.stringify(value) ?? "null";
+}
+async function ensurePhaseManifest(runDir, phaseKey, jobs) {
+    const work = jobs.map((job) => ({ work_id: job.id, input_hash: hashValue(job.input) }));
+    const manifestHash = hashValue({ schema_version: 2, phase_key: phaseKey, work });
+    const existing = await readPhaseManifest(runDir, phaseKey);
+    if (existing) {
+        validateManifest(existing, phaseKey);
+        if (existing.manifest_hash !== manifestHash || stableJson(existing.work) !== stableJson(work)) {
+            throw traceIntegrityError(`Manifest inputs changed for phase ${phaseKey}.`);
+        }
+        return existing;
+    }
+    const manifest = {
+        schema_version: 2,
+        phase_key: phaseKey,
+        manifest_hash: manifestHash,
+        work,
+        created_at: new Date().toISOString()
+    };
+    await writeJsonAtomic(manifestPath(runDir, phaseKey), manifest);
+    return manifest;
+}
+async function readPhaseManifest(runDir, phaseKey) {
+    return readJsonStrictOptional(manifestPath(runDir, phaseKey));
+}
+function validateManifest(manifest, phaseKey) {
+    const workValid = Array.isArray(manifest.work) &&
+        new Set(manifest.work.map((item) => item.work_id)).size === manifest.work.length &&
+        manifest.work.every((item) => item &&
+            typeof item.work_id === "string" &&
+            item.work_id.length > 0 &&
+            typeof item.input_hash === "string" &&
+            /^sha256:[0-9a-f]{64}$/.test(item.input_hash));
+    const expectedHash = hashValue({ schema_version: 2, phase_key: phaseKey, work: manifest.work });
+    if (manifest.schema_version !== 2 ||
+        manifest.phase_key !== phaseKey ||
+        manifest.manifest_hash !== expectedHash ||
+        !workValid) {
+        throw traceIntegrityError(`Manifest is invalid for phase ${phaseKey}.`);
+    }
+}
+async function readValidCheckpoint(runDir, phaseKey, workId, inputHash, validateOutput) {
+    const checkpoint = await readJson(checkpointPath(runDir, phaseKey, workId));
+    if (!checkpoint)
+        return undefined;
+    if (checkpoint.schema_version !== 2 ||
+        checkpoint.phase_key !== phaseKey ||
+        checkpoint.work_id !== workId ||
+        checkpoint.input_hash !== inputHash ||
+        checkpoint.output_hash !== hashValue(checkpoint.output) ||
+        checkpoint.usage_hash !== hashValue(checkpoint.usage ?? null) ||
+        !/^sha256:[0-9a-f]{64}$/.test(checkpoint.output_hash) ||
+        !/^sha256:[0-9a-f]{64}$/.test(checkpoint.usage_hash) ||
+        !/^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(checkpoint.attempt_id) ||
+        typeof checkpoint.completed_at !== "string" ||
+        !Number.isFinite(Date.parse(checkpoint.completed_at)) ||
+        new Date(checkpoint.completed_at).toISOString() !== checkpoint.completed_at ||
+        (validateOutput && !validateOutput(checkpoint.output))) {
+        return undefined;
+    }
+    if (!(await promptReferencesValid(runDir, checkpoint.output)))
+        return undefined;
+    return checkpoint;
+}
+async function promptReferencesValid(runDir, value) {
+    const references = [];
+    collectPromptReferences(value, references);
+    for (const reference of references) {
+        if (!/^sha256:[0-9a-f]{64}$/.test(reference.sha256))
+            return false;
+        const path = `artifacts/prompts/${reference.sha256.slice("sha256:".length)}.json`;
+        if (reference.path !== path)
+            return false;
+        try {
+            const raw = await readFile(join(runDir, path), "utf8");
+            const digest = `sha256:${createHash("sha256").update(raw).digest("hex")}`;
+            if (digest !== reference.sha256)
+                return false;
+        }
+        catch {
+            return false;
+        }
+    }
+    return true;
+}
+function collectPromptReferences(value, out) {
+    if (Array.isArray(value)) {
+        for (const item of value)
+            collectPromptReferences(item, out);
+        return;
+    }
+    if (!value || typeof value !== "object")
+        return;
+    const record = value;
+    const promptRef = record.promptRef;
+    if (promptRef && typeof promptRef === "object" && !Array.isArray(promptRef)) {
+        const reference = promptRef;
+        if (typeof reference.sha256 === "string" && typeof reference.path === "string") {
+            out.push({ sha256: reference.sha256, path: reference.path });
+        }
+        else {
+            out.push({ sha256: "invalid", path: "invalid" });
+        }
+    }
+    for (const [key, inner] of Object.entries(record)) {
+        if (key !== "promptRef")
+            collectPromptReferences(inner, out);
+    }
+}
+async function writeCheckpoint(runDir, phaseKey, workId, inputHash, output, usage) {
+    const checkpoint = {
+        schema_version: 2,
+        phase_key: phaseKey,
+        work_id: workId,
+        input_hash: inputHash,
+        output_hash: hashValue(output),
+        output,
+        usage,
+        usage_hash: hashValue(usage ?? null),
+        attempt_id: randomUUID(),
+        completed_at: new Date().toISOString()
+    };
+    await writeJsonAtomic(checkpointPath(runDir, phaseKey, workId), checkpoint);
+}
+function checkpointBindingHash(checkpoint) {
+    return hashValue({
+        schema_version: checkpoint.schema_version,
+        phase_key: checkpoint.phase_key,
+        work_id: checkpoint.work_id,
+        input_hash: checkpoint.input_hash,
+        output_hash: checkpoint.output_hash,
+        usage_hash: checkpoint.usage_hash,
+        attempt_id: checkpoint.attempt_id,
+        completed_at: checkpoint.completed_at
+    });
+}
+function assertUniqueWorkIds(jobs) {
+    const ids = new Set();
+    for (const job of jobs) {
+        if (!job.id || ids.has(job.id)) {
+            throw new ConfigError(`Checkpoint work IDs must be non-empty and unique; received ${job.id || "empty ID"}.`, {
+                code: "trace.work_id_invalid",
+                retryable: false
+            });
+        }
+        ids.add(job.id);
+    }
+}
+function manifestPath(runDir, phaseKey) {
+    return join(runDir, "manifests", `${phaseFileKey(phaseKey)}.json`);
+}
+function commitPath(runDir, phaseKey) {
+    return join(runDir, "commits", `${phaseFileKey(phaseKey)}.json`);
+}
+function checkpointPath(runDir, phaseKey, workId) {
+    return join(runDir, "checkpoints", phaseFileKey(phaseKey), `${hashValue(workId).slice("sha256:".length)}.json`);
+}
+function phaseFileKey(phaseKey) {
+    return encodeURIComponent(phaseKey).replaceAll("%", "_");
+}
+async function readJson(path) {
+    try {
+        return JSON.parse(await readFile(path, "utf8"));
+    }
+    catch (error) {
+        if (error.code === "ENOENT")
+            return undefined;
+        return undefined;
+    }
+}
+async function readJsonStrictOptional(path) {
+    try {
+        return JSON.parse(await readFile(path, "utf8"));
+    }
+    catch (error) {
+        if (error.code === "ENOENT")
+            return undefined;
+        throw traceIntegrityError(`Could not parse ${path}: ${error.message}`);
+    }
+}
+async function writeJsonAtomic(path, value) {
+    await mkdir(dirname(path), { recursive: true });
+    const temporary = `${path}.${randomUUID()}.tmp`;
+    await writeFile(temporary, `${JSON.stringify(value, null, 2)}\n`, "utf8");
+    await rename(temporary, path);
+}
+function traceIntegrityError(message) {
+    return new ConfigError(message, {
+        code: "resume.trace_v2_integrity",
+        retryable: false,
+        fix: "Restore the matching manifest/checkpoint/commit files, or start a fresh run."
+    });
+}
+//# sourceMappingURL=checkpointStore.js.map

package/dist/checkpointStore.js.map

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

package/dist/critique.d.ts

@@ -1,2 +1,4 @@
 import type { Candidate, Comparison } from "./schemas.js";
-export declare function aggregateCritiques(candidates: Candidate[], comparisons: Comparison[]): Map<string, string>;
+export declare function aggregateCritiques(candidates: Candidate[], comparisons: Comparison[], options?: {
+    aggregateChars?: number;
+}): Map<string, string>;

package/dist/critique.js

@@ -1,21 +1,22 @@
-export function aggregateCritiques(candidates, comparisons) {
+export function aggregateCritiques(candidates, comparisons, options = {}) {
+    const aggregateChars = options.aggregateChars ?? 16_000;
     const chunks = new Map(candidates.map((candidate) => [
         candidate.id,
         {
             wins: [],
             ties: [],
-            losses: []
+            losses: [],
+            seen: new Set()
         }
     ]));
     for (const comparison of comparisons) {
         const aBucket = bucketFor("A", comparison.winner);
         const bBucket = bucketFor("B", comparison.winner);
-        chunks.get(comparison.presentedAOriginalId)?.[aBucket].push(selfRelative(comparison.critiqueForA, "A"));
-        chunks.get(comparison.presentedBOriginalId)?.[bBucket].push(selfRelative(comparison.critiqueForB, "B"));
+        addCritique(chunks.get(comparison.presentedAOriginalId), aBucket, selfRelative(comparison.critiqueForA, "A"));
+        addCritique(chunks.get(comparison.presentedBOriginalId), bBucket, selfRelative(comparison.critiqueForB, "B"));
     }
-    return new Map([...chunks.entries()].map(([id, critiques]) => [
-        id,
-        [...critiques.wins, ...critiques.ties, ...critiques.losses].filter(Boolean).length > 0
+    return new Map([...chunks.entries()].map(([id, critiques]) => {
+        const value = [...critiques.wins, ...critiques.ties, ...critiques.losses].filter(Boolean).length > 0
             ? [
                 formatSection("Feedback from comparisons this solution won", critiques.wins),
                 formatSection("Feedback from comparisons this solution tied", critiques.ties),
@@ -23,8 +24,22 @@ export function aggregateCritiques(candidates, comparisons) {
             ]
                 .filter(Boolean)
                 .join("\n\n")
-            : "No specific critique was produced. Improve correctness, completeness, and clarity."
-    ]));
+            : "No specific critique was produced. Improve correctness, completeness, and clarity.";
+        return [id, truncateCritique(value, aggregateChars)];
+    }));
+}
+function addCritique(chunks, bucket, critique) {
+    const normalized = critique.trim();
+    if (!chunks || !normalized || chunks.seen.has(normalized))
+        return;
+    chunks.seen.add(normalized);
+    chunks[bucket].push(normalized);
+}
+function truncateCritique(value, maxChars) {
+    if (value.length <= maxChars)
+        return value;
+    const marker = "\n\n[Critique truncated.]";
+    return `${value.slice(0, Math.max(0, maxChars - marker.length))}${marker}`.slice(0, maxChars);
 }
 function bucketFor(side, winner) {
     if (winner === "tie")

package/dist/critique.js.map

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

package/dist/index.d.ts

@@ -2,6 +2,7 @@ export * from "./bradleyTerry.js";
 export * from "./artifacts.js";
 export * from "./budget.js";
 export * from "./budgetTracker.js";
+export * from "./checkpointStore.js";
 export * from "./critique.js";
 export * from "./errors.js";
 export * from "./json.js";

package/dist/index.js

@@ -2,6 +2,7 @@ export * from "./bradleyTerry.js";
 export * from "./artifacts.js";
 export * from "./budget.js";
 export * from "./budgetTracker.js";
+export * from "./checkpointStore.js";
 export * from "./critique.js";
 export * from "./errors.js";
 export * from "./json.js";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,OAAO,EAAE,4BAA4B,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AACrF,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,OAAO,EAAE,4BAA4B,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AACrF,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC"}

package/dist/lifecycle.d.ts

@@ -76,6 +76,7 @@ export interface UsageDelta {
 export type CallRole = "generator" | "judge" | "mutator" | "finalizer";
 export interface UsageRecord {
     schema_version: 1;
+    usage_id?: string;
     ts: string;
     phase: string;
     role: CallRole;

package/dist/phaseRunner.d.ts

@@ -1 +1,6 @@
-export declare function runLimitedPhase<T>(jobs: ReadonlyArray<() => Promise<T>>, concurrency: number): Promise<T[]>;
+export type PhaseJob<T> = (signal: AbortSignal) => Promise<T>;
+export interface RunLimitedPhaseOptions {
+    signal?: AbortSignal;
+}
+export declare const maxPhaseConcurrency = 1024;
+export declare function runLimitedPhase<T>(jobs: Iterable<PhaseJob<T>>, concurrency: number, options?: RunLimitedPhaseOptions): Promise<T[]>;

package/dist/phaseRunner.js

@@ -1,26 +1,60 @@
-import pLimit from "p-limit";
-export async function runLimitedPhase(jobs, concurrency) {
-    const limit = pLimit(concurrency);
-    const results = new Array(jobs.length);
-    const completed = new Array(jobs.length).fill(false);
+export const maxPhaseConcurrency = 1_024;
+export async function runLimitedPhase(jobs, concurrency, options = {}) {
+    if (!Number.isInteger(concurrency) || concurrency < 1 || concurrency > maxPhaseConcurrency) {
+        throw new RangeError(`Phase concurrency must be a positive integer no greater than ${maxPhaseConcurrency}, got ${concurrency}.`);
+    }
+    const iterator = jobs[Symbol.iterator]();
+    const results = [];
+    const controller = new AbortController();
+    let nextIndex = 0;
     let firstError;
-    await Promise.all(jobs.map((job, index) => limit(async () => {
-        if (firstError !== undefined)
-            return;
-        try {
-            results[index] = await job();
-            completed[index] = true;
+    const abort = () => {
+        if (firstError === undefined)
+            firstError = abortReason(options.signal);
+        if (!controller.signal.aborted)
+            controller.abort(firstError);
+    };
+    if (options.signal?.aborted)
+        abort();
+    else
+        options.signal?.addEventListener("abort", abort, { once: true });
+    const worker = async () => {
+        while (firstError === undefined) {
+            const next = iterator.next();
+            if (next.done)
+                return;
+            const index = nextIndex;
+            nextIndex += 1;
+            try {
+                results[index] = await next.value(controller.signal);
+            }
+            catch (error) {
+                if (firstError === undefined) {
+                    firstError = error;
+                    if (!controller.signal.aborted)
+                        controller.abort(error);
+                }
+                return;
+            }
         }
-        catch (error) {
-            if (firstError === undefined)
-                firstError = error;
-        }
-    })));
+    };
+    try {
+        await Promise.all(Array.from({ length: concurrency }, () => worker()));
+    }
+    finally {
+        options.signal?.removeEventListener("abort", abort);
+        if (firstError !== undefined)
+            iterator.return?.();
+    }
     if (firstError !== undefined)
         throw firstError;
-    if (completed.some((value) => !value)) {
-        throw new Error("Phase completed without producing every result.");
-    }
     return results;
 }
+function abortReason(signal) {
+    if (signal?.reason !== undefined)
+        return signal.reason;
+    const error = new Error("Phase aborted.");
+    error.name = "AbortError";
+    return error;
+}
 //# sourceMappingURL=phaseRunner.js.map

package/dist/phaseRunner.js.map

@@ -1 +1 @@
-{"version":3,"file":"phaseRunner.js","sourceRoot":"","sources":["../src/phaseRunner.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,SAAS,CAAC;AAE7B,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,IAAqC,EACrC,WAAmB;IAEnB,MAAM,KAAK,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;IAClC,MAAM,OAAO,GAAG,IAAI,KAAK,CAAI,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1C,MAAM,SAAS,GAAG,IAAI,KAAK,CAAU,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC9D,IAAI,UAAmB,CAAC;IAExB,MAAM,OAAO,CAAC,GAAG,CACf,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CACtB,KAAK,CAAC,KAAK,IAAI,EAAE;QACf,IAAI,UAAU,KAAK,SAAS;YAAE,OAAO;QACrC,IAAI,CAAC;YACH,OAAO,CAAC,KAAK,CAAC,GAAG,MAAM,GAAG,EAAE,CAAC;YAC7B,SAAS,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;QAC1B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,UAAU,KAAK,SAAS;gBAAE,UAAU,GAAG,KAAK,CAAC;QACnD,CAAC;IACH,CAAC,CAAC,CACH,CACF,CAAC;IAEF,IAAI,UAAU,KAAK,SAAS;QAAE,MAAM,UAAU,CAAC;IAC/C,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;IACrE,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}
+{"version":3,"file":"phaseRunner.js","sourceRoot":"","sources":["../src/phaseRunner.ts"],"names":[],"mappings":"AAMA,MAAM,CAAC,MAAM,mBAAmB,GAAG,KAAK,CAAC;AAEzC,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,IAA2B,EAC3B,WAAmB,EACnB,UAAkC,EAAE;IAEpC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,WAAW,CAAC,IAAI,WAAW,GAAG,CAAC,IAAI,WAAW,GAAG,mBAAmB,EAAE,CAAC;QAC3F,MAAM,IAAI,UAAU,CAClB,gEAAgE,mBAAmB,SAAS,WAAW,GAAG,CAC3G,CAAC;IACJ,CAAC;IACD,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;IACzC,MAAM,OAAO,GAAQ,EAAE,CAAC;IACxB,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,IAAI,UAAmB,CAAC;IACxB,MAAM,KAAK,GAAG,GAAS,EAAE;QACvB,IAAI,UAAU,KAAK,SAAS;YAAE,UAAU,GAAG,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACvE,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,OAAO;YAAE,UAAU,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IAC/D,CAAC,CAAC;IACF,IAAI,OAAO,CAAC,MAAM,EAAE,OAAO;QAAE,KAAK,EAAE,CAAC;;QAChC,OAAO,CAAC,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAEtE,MAAM,MAAM,GAAG,KAAK,IAAmB,EAAE;QACvC,OAAO,UAAU,KAAK,SAAS,EAAE,CAAC;YAChC,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC;YAC7B,IAAI,IAAI,CAAC,IAAI;gBAAE,OAAO;YACtB,MAAM,KAAK,GAAG,SAAS,CAAC;YACxB,SAAS,IAAI,CAAC,CAAC;YACf,IAAI,CAAC;gBACH,OAAO,CAAC,KAAK,CAAC,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;YACvD,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;oBAC7B,UAAU,GAAG,KAAK,CAAC;oBACnB,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,OAAO;wBAAE,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;gBAC1D,CAAC;gBACD,OAAO;YACT,CAAC;QACH,CAAC;IACH,CAAC,CAAC;IAEF,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IACzE,CAAC;YAAS,CAAC;QACT,OAAO,CAAC,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QACpD,IAAI,UAAU,KAAK,SAAS;YAAE,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;IACpD,CAAC;IACD,IAAI,UAAU,KAAK,SAAS;QAAE,MAAM,UAAU,CAAC;IAC/C,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,WAAW,CAAC,MAA+B;IAClD,IAAI,MAAM,EAAE,MAAM,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC,MAAM,CAAC;IACvD,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,gBAAgB,CAAC,CAAC;IAC1C,KAAK,CAAC,IAAI,GAAG,YAAY,CAAC;IAC1B,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/resume.d.ts

@@ -44,10 +44,15 @@ export declare function resumeConfigError(message: string, code: string, fix?: s
 export declare function assertNoLegacyRedactedBudget(config: Record<string, unknown>): void;
 export declare function repairLegacyBudgetConfig(runDir: string, replacements: Record<string, number>): Promise<string[]>;
 export declare function toResumePlanStatus(runDir: string, runId: string, plan: InternalResumePlan): ResumePlanStatus;
-export declare function pruneTraceToPlan(trace: ResumeTrace, plan: InternalResumePlan): ResumeTrace;
+export declare function pruneTraceToPlan(trace: ResumeTrace, plan: InternalResumePlan, options?: {
+    dropUsageIds?: ReadonlySet<string>;
+}): ResumeTrace;
 export declare function buildPopulationMap(config: RunConfig, populations: Map<number, Candidate[]>, candidates: Candidate[], plan: InternalResumePlan): Map<number, Candidate[]>;
 export declare function groupComparisons(comparisons: Comparison[]): Map<number | "final", Comparison[]>;
 export declare function reconstructScores(config: RunConfig, populationByGeneration: Map<number, Candidate[]>, comparisonsByGeneration: Map<number | "final", Comparison[]>, existingScores: BtScore[], plan: InternalResumePlan, runId?: string): Map<number | "final", BtScore[]>;
 export declare function replayBudgetUsage(config: RunConfig, usage: UsageRecord[]): BudgetTracker;
+export declare function applyUsageRecords(tracker: BudgetTracker, usage: UsageRecord[]): void;
+export declare function validateUsageRecords(usage: UsageRecord[]): void;
+export declare function validatedReceiptUsageIds(usage: unknown[]): Set<string>;
 export declare function persistPrunedTrace(runDir: string, pruned: ResumeTrace): Promise<void>;
 export declare function assertNoPruneInProgress(runDir: string): void;