cueline 0.1.6 → 0.2.0

package/dist/src/diagnostics/run-doctor.js

@@ -0,0 +1,197 @@
+import { loadCueLineRunStatus } from "../api-runtime-lifecycle.js";
+const PHASE_DIAGNOSES = {
+    starting: {
+        code: "RUN_START_READY",
+        severity: "info",
+        summary: "The run has not started controller work yet.",
+        action: "Continue the same run once; do not create a replacement run.",
+    },
+    prompt_not_sent: {
+        code: "PROMPT_PROVEN_NOT_SENT",
+        severity: "warning",
+        summary: "Durable request-correlated evidence proves the controller prompt was not sent.",
+        action: "Retry the same persisted turn; do not allocate a new round.",
+    },
+    controller_response_pending: {
+        code: "CONTROLLER_RESPONSE_PENDING",
+        severity: "info",
+        summary: "The controller turn was submitted and its matching response is not accepted yet.",
+        action: "Observe the exact conversation and request identity; do not resend.",
+    },
+    jobs_running: {
+        code: "PROCESS_JOBS_RUNNING",
+        severity: "info",
+        summary: "An explicitly authorized process executor still owns active local jobs.",
+        action: "Observe job progress and the active runtime owner; do not spawn duplicates.",
+    },
+    controller_decision_pending: {
+        code: "CONTROLLER_DECISION_READY",
+        severity: "info",
+        summary: "Local evidence is terminal and the controller may decide the next step.",
+        action: "Continue the same run to submit the next bounded observation.",
+    },
+    controller_archive_pending: {
+        code: "CONTROLLER_ARCHIVE_PENDING",
+        severity: "warning",
+        summary: "The run completed, but its opt-in controller conversation archive is unsettled.",
+        action: "Continue the same run once to settle the durable archive state; never repeat a started archive click.",
+    },
+    caller_jobs_pending: {
+        code: "CALLER_ADVICE_PENDING",
+        severity: "warning",
+        summary: "The controller proposed caller advice jobs that the current Codex has not completed.",
+        action: "Execute each pending caller advice job once and submit terminal evidence.",
+    },
+    caller_work_pending: {
+        code: "CALLER_WORK_NOT_STARTED",
+        severity: "warning",
+        summary: "The controller proposed local work, but no caller claim exists and work has not started.",
+        action: "Claim the exact job before making any local mutation.",
+    },
+    caller_work_claimed: {
+        code: "CALLER_WORK_CLAIMED_NOT_STARTED",
+        severity: "warning",
+        summary: "Caller work is claimed but has not been durably marked started.",
+        action: "Verify the claim proof, then start that exact claim before modifying files.",
+    },
+    caller_work_running: {
+        code: "CALLER_WORK_IN_PROGRESS",
+        severity: "info",
+        summary: "Caller work has a started claim and may already have local side effects.",
+        action: "Continue only the exact claim; never retry the work automatically.",
+    },
+    runtime_active: {
+        code: "RUNTIME_ACTIVE",
+        severity: "info",
+        summary: "A runtime owner is active even though the persisted run needs attention.",
+        action: "Observe the active owner; do not take over or start a second loop.",
+    },
+    runtime_stale: {
+        code: "RUNTIME_STALE",
+        severity: "error",
+        summary: "The durable runtime lease stopped heartbeating.",
+        action: "Inspect matching ownership evidence, then use explicit takeover or runtime reconciliation.",
+    },
+    runtime_ownership_unknown: {
+        code: "RUNTIME_OWNERSHIP_UNKNOWN",
+        severity: "error",
+        summary: "The run claims active process work without a verifiable runtime owner.",
+        action: "Inspect worker liveness and reconcile runtime state before any continuation.",
+    },
+    cancellation_pending: {
+        code: "CANCELLATION_PENDING",
+        severity: "error",
+        summary: "A durable cancellation request exists and normal continuation is forbidden.",
+        action: "Observe cancellation settlement; inspect runtime if no owner remains.",
+    },
+    reconciliation_required: {
+        code: "CONTROLLER_RECONCILIATION_REQUIRED",
+        severity: "error",
+        summary: "Controller submission or response identity remains ambiguous.",
+        action: "Reconcile the exact URL, model, round, and request identity; never resend.",
+    },
+    job_recovery_required: {
+        code: "JOB_RECOVERY_REQUIRED",
+        severity: "error",
+        summary: "Active-looking jobs survived a failed run without trustworthy ownership.",
+        action: "Reconcile each job from process and event evidence before continuing.",
+    },
+    round_limit_reached: {
+        code: "ROUND_LIMIT_REACHED",
+        severity: "error",
+        summary: "The configured controller round limit was exhausted.",
+        action: "Return the recorded failure; do not silently add another round.",
+    },
+    resume_ready: {
+        code: "RESUME_READY",
+        severity: "warning",
+        summary: "The failed run has no active work and may be resumed deliberately.",
+        action: "Review the last failure, then continue the same run if its request is still valid.",
+    },
+    complete: {
+        code: "RUN_COMPLETE",
+        severity: "info",
+        summary: "The controller accepted a complete terminal result.",
+        action: "Return the persisted result; no continuation is needed.",
+    },
+    blocked: {
+        code: "RUN_BLOCKED",
+        severity: "error",
+        summary: "The controller accepted a blocked terminal result.",
+        action: "Return the persisted blocker; do not continue automatically.",
+    },
+    cancelled: {
+        code: "RUN_CANCELLED",
+        severity: "info",
+        summary: "The run reached a cancelled terminal state.",
+        action: "Return the persisted cancellation result; do not restart it implicitly.",
+    },
+};
+function jobFinding(code, severity, message, action, jobIds) {
+    return {
+        code,
+        severity,
+        message,
+        action,
+        evidence: { count: jobIds.length, job_ids: jobIds.join(",") },
+    };
+}
+export function diagnoseCueLineRunStatus(status) {
+    const phase = PHASE_DIAGNOSES[status.phase];
+    const findings = [
+        {
+            code: phase.code,
+            severity: phase.severity,
+            message: phase.summary,
+            action: phase.action,
+            evidence: {
+                phase: status.phase,
+                runtime_ownership: status.runtime.ownership,
+                pending_turns: status.controller.pendingTurns,
+                active_jobs: status.jobs.counts.pending + status.jobs.counts.running,
+            },
+        },
+    ];
+    const ambiguous = status.jobs.items
+        .filter((job) => job.status === "ambiguous")
+        .map((job) => job.jobId);
+    if (ambiguous.length > 0) {
+        findings.push(jobFinding("AMBIGUOUS_JOB_PRESENT", "error", "Caller work may already have side effects but lacks a trustworthy terminal result.", "Inspect the exact worktree and claim evidence; never retry automatically.", ambiguous));
+    }
+    const orphaned = status.jobs.items
+        .filter((job) => job.status === "orphaned")
+        .map((job) => job.jobId);
+    if (orphaned.length > 0) {
+        findings.push(jobFinding("ORPHANED_JOB_PRESENT", "error", "Persisted process jobs have no active verified owner.", "Reconcile process liveness and append a terminal status before continuing.", orphaned));
+    }
+    const timedOut = status.jobs.items
+        .filter((job) => job.status === "timed_out")
+        .map((job) => job.jobId);
+    if (timedOut.length > 0) {
+        findings.push(jobFinding("TIMED_OUT_JOB_EVIDENCE", "warning", "One or more jobs ended at their configured deadline.", "Treat timeout as evidence for the controller; do not rerun without a new command.", timedOut));
+    }
+    const failed = status.jobs.items
+        .filter((job) => job.status === "failed")
+        .map((job) => job.jobId);
+    if (failed.length > 0) {
+        findings.push(jobFinding("FAILED_JOB_EVIDENCE", "warning", "One or more jobs returned a terminal failure.", "Submit the bounded failure evidence to the controller; do not hide or auto-retry it.", failed));
+    }
+    const outcome = findings.some((finding) => finding.severity === "error")
+        ? "blocked"
+        : findings.some((finding) => finding.severity === "warning")
+            ? "action_required"
+            : "healthy";
+    return {
+        runId: status.runId,
+        outcome,
+        phase: status.phase,
+        summary: phase.summary,
+        nextAction: status.safeNextAction,
+        eventSequence: status.lastEventSequence,
+        findings,
+    };
+}
+export async function diagnoseCueLineRun(runId, options = {}) {
+    return diagnoseCueLineRunStatus(await loadCueLineRunStatus(runId, options));
+}
+//# sourceMappingURL=run-doctor.js.map

package/dist/src/diagnostics/run-doctor.js.map

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

package/dist/src/jobs/status.d.ts

@@ -20,9 +20,11 @@ export interface JobStatus {
     result?: JobResult;
     error?: string;
 }
+export declare function parseJobStatus(source: string, expectedJobId?: string): JobStatus;
 /**
- * Stores one atomically replaced JSON status file per job. The write format is
- * deliberately small so foreground and background work share the same view.
+ * Stores one replaceable JSON status plus an immutable anchor for the first
+ * terminal result. Readers prefer the anchor, preventing stale writers from
+ * regressing completed work or authorizing a duplicate spawn.
  */
 export declare class JobStatusStore {
     #private;
@@ -30,4 +32,5 @@ export declare class JobStatusStore {
     write(status: JobStatus): Promise<void>;
     read(jobId: string): Promise<JobStatus | undefined>;
     pathFor(jobId: string): string;
+    terminalPathFor(jobId: string): string;
 }

package/dist/src/jobs/status.js

@@ -1,7 +1,100 @@
-import { mkdir, readFile, rename, writeFile } from "node:fs/promises";
+import { readFile } from "node:fs/promises";
 import path from "node:path";
 import { CueLineError } from "../core/errors.js";
-import { runtimePidTag } from "../core/runtime.js";
+import { canonicalJson } from "../core/ids.js";
+import { atomicCreateJson, atomicWriteJson } from "../state/atomic-write.js";
+const JOB_STATUS_KINDS = new Set([
+    "pending",
+    "running",
+    "succeeded",
+    "failed",
+    "timed_out",
+    "cancelled",
+    "ambiguous",
+]);
+const JOB_RESULT_STATUSES = new Set([
+    "succeeded",
+    "failed",
+    "timed_out",
+    "cancelled",
+    "ambiguous",
+]);
+function validTimestamp(value) {
+    return typeof value === "string" && Number.isFinite(Date.parse(value));
+}
+function optionalString(value) {
+    return value === undefined || typeof value === "string";
+}
+function validJobResult(value, expectedStatus) {
+    if (typeof value !== "object" || value === null || Array.isArray(value))
+        return false;
+    const result = value;
+    return (typeof result.status === "string" &&
+        JOB_RESULT_STATUSES.has(result.status) &&
+        result.status === expectedStatus &&
+        (result.exitCode === null || Number.isSafeInteger(result.exitCode)) &&
+        typeof result.stdout === "string" &&
+        typeof result.stderr === "string" &&
+        typeof result.output === "string" &&
+        typeof result.emptyOutput === "boolean" &&
+        result.emptyOutput === (result.output.length === 0) &&
+        typeof result.timedOut === "boolean" &&
+        result.timedOut === (expectedStatus === "timed_out") &&
+        typeof result.cancelled === "boolean" &&
+        result.cancelled === (expectedStatus === "cancelled") &&
+        typeof result.ambiguousSideEffects === "boolean" &&
+        result.retryable === false &&
+        validTimestamp(result.startedAt) &&
+        validTimestamp(result.finishedAt) &&
+        Date.parse(result.finishedAt) >= Date.parse(result.startedAt));
+}
+function assertJobStatus(value, expectedJobId) {
+    const invalid = () => {
+        throw new CueLineError("JOB_STATUS_INVALID", `persisted job status${expectedJobId === undefined ? "" : ` for '${expectedJobId}'`} has an invalid structure`, expectedJobId === undefined ? undefined : { details: { jobId: expectedJobId } });
+    };
+    if (typeof value !== "object" || value === null || Array.isArray(value))
+        invalid();
+    const status = value;
+    if (typeof status.jobId !== "string" ||
+        (expectedJobId !== undefined && status.jobId !== expectedJobId) ||
+        (status.execution !== "foreground" && status.execution !== "background") ||
+        typeof status.status !== "string" ||
+        !JOB_STATUS_KINDS.has(status.status) ||
+        !validTimestamp(status.startedAt) ||
+        !optionalString(status.runId) ||
+        !optionalString(status.jobKey) ||
+        !optionalString(status.lane) ||
+        (status.mode !== undefined && status.mode !== "advise" && status.mode !== "work") ||
+        !optionalString(status.runnerId) ||
+        !optionalString(status.model) ||
+        !optionalString(status.provider) ||
+        !optionalString(status.phase) ||
+        (status.lastProgressAt !== undefined && !validTimestamp(status.lastProgressAt)) ||
+        (status.pid !== undefined && (!Number.isSafeInteger(status.pid) || status.pid < 1)) ||
+        (status.finishedAt !== undefined &&
+            (!validTimestamp(status.finishedAt) ||
+                Date.parse(status.finishedAt) < Date.parse(status.startedAt))) ||
+        !optionalString(status.error) ||
+        (status.result !== undefined &&
+            !validJobResult(status.result, status.status)) ||
+        ((status.status === "pending" || status.status === "running") &&
+            (status.result !== undefined || status.finishedAt !== undefined))) {
+        invalid();
+    }
+    if (!/^[A-Za-z0-9][A-Za-z0-9_-]*$/.test(status.jobId))
+        invalid();
+}
+export function parseJobStatus(source, expectedJobId) {
+    let parsed;
+    try {
+        parsed = JSON.parse(source);
+    }
+    catch {
+        throw new CueLineError("JOB_STATUS_INVALID", `persisted job status${expectedJobId === undefined ? "" : ` for '${expectedJobId}'`} is not valid JSON`, expectedJobId === undefined ? undefined : { details: { jobId: expectedJobId } });
+    }
+    assertJobStatus(parsed, expectedJobId);
+    return parsed;
+}
 function assertSafeJobId(jobId) {
     if (!/^[A-Za-z0-9][A-Za-z0-9_-]*$/.test(jobId)) {
         throw new CueLineError("JOB_ID_INVALID", "job id contains unsupported path characters", {
@@ -9,9 +102,13 @@ function assertSafeJobId(jobId) {
         });
     }
 }
+function isTerminalStatus(status) {
+    return status.status !== "pending" && status.status !== "running";
+}
 /**
- * Stores one atomically replaced JSON status file per job. The write format is
- * deliberately small so foreground and background work share the same view.
+ * Stores one replaceable JSON status plus an immutable anchor for the first
+ * terminal result. Readers prefer the anchor, preventing stale writers from
+ * regressing completed work or authorizing a duplicate spawn.
  */
 export class JobStatusStore {
     #directory;
@@ -19,33 +116,96 @@ export class JobStatusStore {
         this.#directory = path.resolve(rootDirectory, "jobs");
     }
     async write(status) {
-        assertSafeJobId(status.jobId);
-        await mkdir(this.#directory, { recursive: true });
-        const target = this.pathFor(status.jobId);
-        const temporary = `${target}.${runtimePidTag()}.${Date.now()}.tmp`;
-        await writeFile(temporary, `${JSON.stringify(status)}\n`, "utf8");
-        await rename(temporary, target);
+        assertJobStatus(status, status.jobId);
+        const jsonStatus = JSON.parse(JSON.stringify(status));
+        const existingTerminal = await this.#anchorLegacyTerminal(status.jobId);
+        if (isTerminalStatus(jsonStatus)) {
+            let committed = existingTerminal;
+            if (committed === undefined) {
+                const created = await atomicCreateJson(this.terminalPathFor(status.jobId), jsonStatus);
+                committed = created ? jsonStatus : await this.#readTerminal(status.jobId);
+            }
+            if (committed === undefined) {
+                throw new CueLineError("JOB_STATUS_TERMINAL_WRITE_FAILED", `Terminal job status disappeared while being committed: ${status.jobId}`);
+            }
+            if (canonicalJson(committed) !== canonicalJson(jsonStatus)) {
+                throw new CueLineError("JOB_STATUS_TERMINAL_CONFLICT", `Job '${status.jobId}' already has different terminal execution evidence.`, {
+                    details: {
+                        jobId: status.jobId,
+                        committedStatus: committed.status,
+                        rejectedStatus: jsonStatus.status,
+                    },
+                });
+            }
+            await atomicWriteJson(this.pathFor(status.jobId), committed);
+            return;
+        }
+        if (existingTerminal !== undefined) {
+            await atomicWriteJson(this.pathFor(status.jobId), existingTerminal);
+            throw this.#alreadyTerminalError(status.jobId, existingTerminal.status);
+        }
+        await atomicWriteJson(this.pathFor(status.jobId), jsonStatus);
+        const concurrentTerminal = await this.#readTerminal(status.jobId);
+        if (concurrentTerminal !== undefined) {
+            await atomicWriteJson(this.pathFor(status.jobId), concurrentTerminal);
+            throw this.#alreadyTerminalError(status.jobId, concurrentTerminal.status);
+        }
     }
     async read(jobId) {
         assertSafeJobId(jobId);
+        const terminal = await this.#readTerminal(jobId);
+        if (terminal !== undefined)
+            return terminal;
+        return this.#readPath(this.pathFor(jobId), jobId);
+    }
+    async #anchorLegacyTerminal(jobId) {
+        const anchored = await this.#readTerminal(jobId);
+        if (anchored !== undefined)
+            return anchored;
+        const current = await this.#readPath(this.pathFor(jobId), jobId);
+        if (current === undefined || !isTerminalStatus(current))
+            return undefined;
+        const created = await atomicCreateJson(this.terminalPathFor(jobId), current);
+        if (created)
+            return current;
+        return this.#readTerminal(jobId);
+    }
+    async #readTerminal(jobId) {
+        const status = await this.#readPath(this.terminalPathFor(jobId), jobId);
+        if (status !== undefined && !isTerminalStatus(status)) {
+            throw new CueLineError("JOB_STATUS_TERMINAL_INVALID", `Terminal anchor for job '${jobId}' contains a non-terminal status.`);
+        }
+        return status;
+    }
+    async #readPath(target, jobId) {
+        let source;
         try {
-            const source = await readFile(this.pathFor(jobId), "utf8");
-            return JSON.parse(source);
+            source = await readFile(target, "utf8");
         }
         catch (error) {
             if (isNotFound(error)) {
                 return undefined;
             }
+            if (error instanceof CueLineError)
+                throw error;
             throw new CueLineError("JOB_STATUS_READ_FAILED", `unable to read job status: ${jobId}`, {
                 cause: error,
                 details: { jobId },
             });
         }
+        return parseJobStatus(source, jobId);
+    }
+    #alreadyTerminalError(jobId, committedStatus) {
+        return new CueLineError("JOB_STATUS_ALREADY_TERMINAL", `Job '${jobId}' already has terminal status '${committedStatus}'; refusing a non-terminal update.`, { details: { jobId, committedStatus } });
     }
     pathFor(jobId) {
         assertSafeJobId(jobId);
         return path.join(this.#directory, `${jobId}.json`);
     }
+    terminalPathFor(jobId) {
+        assertSafeJobId(jobId);
+        return path.join(this.#directory, `${jobId}.terminal`);
+    }
 }
 function isNotFound(error) {
     return typeof error === "object" && error !== null && "code" in error && error.code === "ENOENT";

package/dist/src/jobs/status.js.map

@@ -1 +1 @@
-{"version":3,"file":"status.js","sourceRoot":"","sources":["../../../src/jobs/status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AA0BnD,SAAS,eAAe,CAAC,KAAa;IACpC,IAAI,CAAC,6BAA6B,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAC/C,MAAM,IAAI,YAAY,CAAC,gBAAgB,EAAE,6CAA6C,EAAE;YACtF,OAAO,EAAE,EAAE,KAAK,EAAE;SACnB,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,OAAO,cAAc;IAChB,UAAU,CAAS;IAE5B,YAAY,aAAqB;QAC/B,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;IACxD,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,MAAiB;QAC3B,eAAe,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC9B,MAAM,KAAK,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAClD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC1C,MAAM,SAAS,GAAG,GAAG,MAAM,IAAI,aAAa,EAAE,IAAI,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC;QACnE,MAAM,SAAS,CAAC,SAAS,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAClE,MAAM,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IAClC,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,KAAa;QACtB,eAAe,CAAC,KAAK,CAAC,CAAC;QACvB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,CAAC;YAC3D,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAc,CAAC;QACzC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;gBACtB,OAAO,SAAS,CAAC;YACnB,CAAC;YACD,MAAM,IAAI,YAAY,CAAC,wBAAwB,EAAE,8BAA8B,KAAK,EAAE,EAAE;gBACtF,KAAK,EAAE,KAAK;gBACZ,OAAO,EAAE,EAAE,KAAK,EAAE;aACnB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,CAAC,KAAa;QACnB,eAAe,CAAC,KAAK,CAAC,CAAC;QACvB,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,GAAG,KAAK,OAAO,CAAC,CAAC;IACrD,CAAC;CACF;AAED,SAAS,UAAU,CAAC,KAAc;IAChC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,MAAM,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC;AACnG,CAAC"}
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../../src/jobs/status.ts"],"names":[],"mappings":"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"}

package/dist/src/jobs/supervisor.js

@@ -93,13 +93,60 @@ export class JobSupervisor {
     }
     async completeOnce(spec, running, release) {
         let terminal;
-        let progressWrites = Promise.resolve();
-        const persistProgress = (update) => {
-            progressWrites = progressWrites.then(async () => {
-                running.current = { ...running.current, ...update };
-                await this.options.statusStore.write(running.current);
+        let pendingProgress;
+        let progressWriter;
+        let progressWriteFailed = false;
+        let progressWriteFailure;
+        let acceptsProgress = true;
+        const ensureProgressWriter = () => {
+            if (progressWriteFailed) {
+                return Promise.reject(progressWriteFailure);
+            }
+            if (progressWriter !== undefined) {
+                return progressWriter;
+            }
+            const writer = (async () => {
+                while (pendingProgress !== undefined) {
+                    const update = pendingProgress;
+                    pendingProgress = undefined;
+                    running.current = { ...running.current, ...update };
+                    await this.options.statusStore.write(running.current);
+                }
+            })()
+                .catch((error) => {
+                progressWriteFailed = true;
+                progressWriteFailure = error;
+                pendingProgress = undefined;
+                throw error;
+            })
+                .finally(() => {
+                if (progressWriter === writer) {
+                    progressWriter = undefined;
+                }
+                if (pendingProgress !== undefined && !progressWriteFailed) {
+                    void ensureProgressWriter().catch(() => undefined);
+                }
             });
-            return progressWrites;
+            progressWriter = writer;
+            return writer;
+        };
+        const persistProgress = (update) => {
+            if (!acceptsProgress) {
+                return Promise.resolve();
+            }
+            if (progressWriteFailed) {
+                return Promise.reject(progressWriteFailure);
+            }
+            pendingProgress = { ...pendingProgress, ...update };
+            return ensureProgressWriter();
+        };
+        const flushProgress = async () => {
+            while (pendingProgress !== undefined || progressWriter !== undefined) {
+                await (progressWriter ?? ensureProgressWriter());
+            }
+            if (progressWriteFailed) {
+                throw progressWriteFailure;
+            }
         };
         try {
             const result = await this.runner.run(spec, {
@@ -115,11 +162,13 @@ export class JobSupervisor {
                     ...(progress.provider === undefined ? {} : { provider: progress.provider }),
                 }),
             });
-            await progressWrites;
+            acceptsProgress = false;
+            await flushProgress();
             terminal = this.withResult(running.current, result);
         }
         catch (error) {
-            await progressWrites.catch(() => undefined);
+            acceptsProgress = false;
+            await flushProgress().catch(() => undefined);
             const finishedAt = new Date().toISOString();
             terminal = {
                 ...running.current,

package/dist/src/jobs/supervisor.js.map

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

package/dist/src/observation/run-diff.d.ts

@@ -0,0 +1,39 @@
+import type { CueLineRuntimeOptions } from "../api-contracts.js";
+type DiffValue = string | number | boolean | null;
+export interface CueLineRunDiffOptions extends Pick<CueLineRuntimeOptions, "environment" | "home" | "now"> {
+}
+export interface CueLineRunDiffProjection {
+    runId: string;
+    status: string;
+    executor: string;
+    allowProcessExecution: boolean;
+    phase: string;
+    round: number;
+    maxRounds: number;
+    lastEventSequence: number;
+    runtimeOwnership: string;
+    cancellationRequested: boolean;
+    pendingControllerTurns: number;
+    acceptedCommands: number;
+    archiveStatus: string;
+    jobs: {
+        total: number;
+        counts: Record<string, number>;
+    };
+    continueAllowed: boolean;
+    safeNextAction: string;
+}
+export interface CueLineRunDiffChange {
+    field: string;
+    left: DiffValue;
+    right: DiffValue;
+}
+export interface CueLineRunDiff {
+    schema: "cueline-run-diff/0.1";
+    equivalent: boolean;
+    left: CueLineRunDiffProjection;
+    right: CueLineRunDiffProjection;
+    changes: CueLineRunDiffChange[];
+}
+export declare function compareCueLineRuns(leftRunId: string, rightRunId: string, options?: CueLineRunDiffOptions): Promise<CueLineRunDiff>;
+export {};