@osolmaz/pi-workflows 0.8.0 → 0.8.2

package/dist/job-progress/types.d.ts

@@ -1,65 +0,0 @@
-import type { ProgressEstimate, ProgressTrackState, WorkflowProgressData } from "../workflows/index.js";
-export declare const JOB_PROGRESS_SCHEMA: "pi-workflows.job-progress.v1";
-export type JobProgressState = "queued" | "running" | "waiting" | "blocked" | "completed" | "failed" | "cancelled" | "unknown";
-export type JobProgressTrack = {
-    key: string;
-    data: WorkflowProgressData;
-};
-export type JobProgressCost = {
-    settledUsd: number;
-    reservedUsd: number;
-};
-export type JobProgressSnapshot = {
-    schema: typeof JOB_PROGRESS_SCHEMA;
-    application: string;
-    component: string;
-    jobId: string;
-    sourceRevision: string;
-    contractHash: string;
-    sequence: number;
-    state: JobProgressState;
-    phase: string;
-    startedAt: string;
-    updatedAt: string;
-    deadlineAt?: string;
-    finishedAt?: string;
-    tracks: JobProgressTrack[];
-    cost?: JobProgressCost;
-};
-export type JobProgressIdentity = Pick<JobProgressSnapshot, "application" | "component" | "jobId" | "sourceRevision" | "contractHash" | "startedAt"> & {
-    deadlineAt?: string;
-};
-export type JobProgressUpdate = {
-    state?: JobProgressState;
-    phase?: string;
-    tracks?: JobProgressTrack[];
-    cost?: JobProgressCost;
-    finishedAt?: string;
-    force?: boolean;
-};
-export type JobProgressPublish = (snapshot: JobProgressSnapshot, signal: AbortSignal) => Promise<void>;
-type JobProgressReporterBaseOptions = JobProgressIdentity & {
-    initialState?: Exclude<JobProgressState, "completed" | "failed" | "cancelled">;
-    initialPhase?: string;
-    publish: JobProgressPublish;
-    minimumIntervalMs?: number;
-    publishTimeoutMs?: number;
-    now?: () => Date;
-};
-export type JobProgressReporterOptions = JobProgressReporterBaseOptions & ({
-    initialTracks: JobProgressTrack[];
-    previousSnapshot?: never;
-} | {
-    initialTracks?: JobProgressTrack[];
-    previousSnapshot: JobProgressSnapshot;
-});
-export type JobProgressPublishResult = {
-    snapshot: JobProgressSnapshot;
-    published: boolean;
-};
-export type JobProgressEstimate = {
-    snapshot: JobProgressSnapshot;
-    tracks: ProgressTrackState[];
-    estimates: ProgressEstimate[];
-};
-export {};

package/dist/job-progress/types.js

@@ -1,2 +0,0 @@
-export const JOB_PROGRESS_SCHEMA = "pi-workflows.job-progress.v1";
-//# sourceMappingURL=types.js.map

package/dist/job-progress/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/job-progress/types.ts"],"names":[],"mappings":"AAMA,MAAM,CAAC,MAAM,mBAAmB,GAAG,8BAAuC,CAAC"}

package/dist/job-progress/validation.d.ts

@@ -1,5 +0,0 @@
-import { type JobProgressSnapshot, type JobProgressState } from "./types.js";
-export declare const MAX_JOB_PROGRESS_BYTES: number;
-export declare const MAX_JOB_PROGRESS_TRACKS = 128;
-export declare function validateJobProgressSnapshot(value: unknown): JobProgressSnapshot;
-export declare function isTerminalJobProgressState(state: JobProgressState): state is "completed" | "failed" | "cancelled";

package/dist/job-progress/validation.js

@@ -1,227 +0,0 @@
-import { validateProgressData } from "../workflows/index.js";
-import { JOB_PROGRESS_SCHEMA, } from "./types.js";
-export const MAX_JOB_PROGRESS_BYTES = 64 * 1024;
-export const MAX_JOB_PROGRESS_TRACKS = 128;
-const SNAPSHOT_FIELDS = new Set([
-    "schema",
-    "application",
-    "component",
-    "jobId",
-    "sourceRevision",
-    "contractHash",
-    "sequence",
-    "state",
-    "phase",
-    "startedAt",
-    "updatedAt",
-    "deadlineAt",
-    "finishedAt",
-    "tracks",
-    "cost",
-]);
-const TRACK_FIELDS = new Set(["key", "data"]);
-const COST_FIELDS = new Set(["settledUsd", "reservedUsd"]);
-const STATES = new Set([
-    "queued",
-    "running",
-    "waiting",
-    "blocked",
-    "completed",
-    "failed",
-    "cancelled",
-    "unknown",
-]);
-const KEY_PATTERN = /^[A-Za-z0-9][A-Za-z0-9._:/-]{0,127}$/;
-const RFC_3339_PATTERN = /^(\d{4})-(\d{2})-(\d{2})T(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|[+-](?:[01]\d|2[0-3]):[0-5]\d)$/;
-export function validateJobProgressSnapshot(value) {
-    const bytes = jsonBytes(value);
-    if (bytes > MAX_JOB_PROGRESS_BYTES) {
-        throw new Error(`job progress snapshot must be at most ${MAX_JOB_PROGRESS_BYTES} bytes`);
-    }
-    if (!isRecord(value))
-        throw new Error("job progress snapshot must be an object");
-    rejectUnknown(value, SNAPSHOT_FIELDS, "job progress");
-    if (value.schema !== JOB_PROGRESS_SCHEMA) {
-        throw new Error(`job progress.schema must equal ${JOB_PROGRESS_SCHEMA}`);
-    }
-    const application = requiredText(value.application, "job progress.application", 100);
-    const component = requiredText(value.component, "job progress.component", 100);
-    const jobId = requiredText(value.jobId, "job progress.jobId", 200);
-    const sourceRevision = requiredText(value.sourceRevision, "job progress.sourceRevision", 200);
-    const contractHash = requiredText(value.contractHash, "job progress.contractHash", 200);
-    const sequence = requiredInteger(value.sequence, "job progress.sequence");
-    const state = requiredState(value.state);
-    const phase = requiredText(value.phase, "job progress.phase", 100);
-    const startedAt = requiredTimestamp(value.startedAt, "job progress.startedAt");
-    const updatedAt = requiredTimestamp(value.updatedAt, "job progress.updatedAt");
-    const deadlineAt = optionalTimestamp(value.deadlineAt, "job progress.deadlineAt");
-    const finishedAt = optionalTimestamp(value.finishedAt, "job progress.finishedAt");
-    const tracks = requiredTracks(value.tracks);
-    const cost = optionalCost(value.cost);
-    if (Date.parse(updatedAt) < Date.parse(startedAt)) {
-        throw new Error("job progress.updatedAt must not be before startedAt");
-    }
-    if (deadlineAt !== undefined && Date.parse(deadlineAt) <= Date.parse(startedAt)) {
-        throw new Error("job progress.deadlineAt must be after startedAt");
-    }
-    if (finishedAt !== undefined && Date.parse(finishedAt) < Date.parse(startedAt)) {
-        throw new Error("job progress.finishedAt must not be before startedAt");
-    }
-    if (finishedAt !== undefined && Date.parse(finishedAt) > Date.parse(updatedAt)) {
-        throw new Error("job progress.finishedAt must not be after updatedAt");
-    }
-    if (isTerminal(state) && finishedAt === undefined) {
-        throw new Error("job progress.finishedAt is required for a terminal state");
-    }
-    if (!isTerminal(state) && finishedAt !== undefined) {
-        throw new Error("job progress.finishedAt is allowed only for a terminal state");
-    }
-    if (isTerminal(state) && tracks.some((track) => !isTerminalTrack(track))) {
-        throw new Error("job progress tracks must be terminal when the job state is terminal");
-    }
-    return {
-        schema: JOB_PROGRESS_SCHEMA,
-        application,
-        component,
-        jobId,
-        sourceRevision,
-        contractHash,
-        sequence,
-        state,
-        phase,
-        startedAt,
-        updatedAt,
-        ...(deadlineAt === undefined ? {} : { deadlineAt }),
-        ...(finishedAt === undefined ? {} : { finishedAt }),
-        tracks,
-        ...(cost === undefined ? {} : { cost }),
-    };
-}
-export function isTerminalJobProgressState(state) {
-    return isTerminal(state);
-}
-function requiredTracks(value) {
-    if (!Array.isArray(value))
-        throw new Error("job progress.tracks must be an array");
-    if (value.length < 1)
-        throw new Error("job progress.tracks must contain at least one entry");
-    if (value.length > MAX_JOB_PROGRESS_TRACKS) {
-        throw new Error(`job progress.tracks must contain at most ${MAX_JOB_PROGRESS_TRACKS} entries`);
-    }
-    const keys = new Set();
-    return value.map((item, index) => {
-        if (!isRecord(item))
-            throw new Error(`job progress.tracks[${index}] must be an object`);
-        rejectUnknown(item, TRACK_FIELDS, `job progress.tracks[${index}]`);
-        if (typeof item.key !== "string" || !KEY_PATTERN.test(item.key)) {
-            throw new Error(`job progress.tracks[${index}].key must match [A-Za-z0-9][A-Za-z0-9._:/-]{0,127}`);
-        }
-        if (keys.has(item.key))
-            throw new Error(`job progress track key ${item.key} is duplicated`);
-        keys.add(item.key);
-        if (!isRecord(item.data)) {
-            throw new Error(`job progress.tracks[${index}].data must be an object`);
-        }
-        return { key: item.key, data: structuredClone(validateProgressData(item.data)) };
-    });
-}
-function optionalCost(value) {
-    if (value === undefined)
-        return undefined;
-    if (!isRecord(value))
-        throw new Error("job progress.cost must be an object");
-    rejectUnknown(value, COST_FIELDS, "job progress.cost");
-    return {
-        settledUsd: requiredNonNegative(value.settledUsd, "job progress.cost.settledUsd"),
-        reservedUsd: requiredNonNegative(value.reservedUsd, "job progress.cost.reservedUsd"),
-    };
-}
-function requiredState(value) {
-    if (typeof value !== "string" || !STATES.has(value)) {
-        throw new Error("job progress.state is invalid");
-    }
-    return value;
-}
-function requiredText(value, field, max) {
-    if (typeof value !== "string" || value.trim().length < 1 || value.trim().length > max) {
-        throw new Error(`${field} must be 1 to ${max} characters`);
-    }
-    if ([...value].some(isControlCharacter))
-        throw new Error(`${field} must not contain control characters`);
-    return value;
-}
-function requiredInteger(value, field) {
-    if (!Number.isSafeInteger(value) || value < 0) {
-        throw new Error(`${field} must be a non-negative safe integer`);
-    }
-    return value;
-}
-function requiredNonNegative(value, field) {
-    if (typeof value !== "number" || !Number.isFinite(value) || value < 0) {
-        throw new Error(`${field} must be a finite non-negative number`);
-    }
-    return value;
-}
-function requiredTimestamp(value, field) {
-    const parsed = optionalTimestamp(value, field);
-    if (parsed === undefined)
-        throw new Error(`${field} is required`);
-    return parsed;
-}
-function optionalTimestamp(value, field) {
-    if (value === undefined)
-        return undefined;
-    if (typeof value !== "string") {
-        throw new Error(`${field} must be an RFC 3339 timestamp with an offset`);
-    }
-    const match = RFC_3339_PATTERN.exec(value);
-    if (match === null || !validCalendarDate(match[1], match[2], match[3])) {
-        throw new Error(`${field} must be an RFC 3339 timestamp with an offset`);
-    }
-    return value;
-}
-function validCalendarDate(yearText, monthText, dayText) {
-    const year = Number(yearText);
-    const month = Number(monthText);
-    const day = Number(dayText);
-    if (!Number.isInteger(year) || year < 1 || month < 1 || month > 12 || day < 1)
-        return false;
-    return day <= new Date(Date.UTC(year, month, 0)).getUTCDate();
-}
-function rejectUnknown(value, allowed, field) {
-    for (const key of Object.keys(value)) {
-        if (!allowed.has(key))
-            throw new Error(`${field}.${key} is not supported`);
-    }
-}
-function isRecord(value) {
-    if (value === null || typeof value !== "object" || Array.isArray(value))
-        return false;
-    const prototype = Object.getPrototypeOf(value);
-    return prototype === Object.prototype || prototype === null;
-}
-function jsonBytes(value) {
-    let encoded;
-    try {
-        encoded = JSON.stringify(value);
-    }
-    catch {
-        throw new Error("job progress snapshot must be JSON serializable");
-    }
-    if (encoded === undefined)
-        throw new Error("job progress snapshot must be JSON serializable");
-    return Buffer.byteLength(encoded, "utf8");
-}
-function isControlCharacter(character) {
-    const code = character.codePointAt(0) ?? 0;
-    return code < 32 || (code >= 127 && code <= 159);
-}
-function isTerminal(state) {
-    return state === "completed" || state === "failed" || state === "cancelled";
-}
-function isTerminalTrack(track) {
-    return (track.data.status === "completed" ||
-        track.data.status === "failed" ||
-        track.data.status === "cancelled");
-}
-//# sourceMappingURL=validation.js.map

package/dist/job-progress/validation.js.map

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

package/docs/JOB_PROGRESS.md

@@ -1,119 +0,0 @@
-# Durable job progress
-
-`@osolmaz/pi-workflows/job-progress` lets a remote job publish progress that a Pi Workflows monitor can validate and measure. It uses the existing `pi-workflows.progress.v1` track contract and ETA estimator.
-
-## Report progress
-
-Create one reporter for one physical job. Inject the storage write so the package remains independent of a cloud provider.
-
-```ts
-import { createJobProgressReporter } from "@osolmaz/pi-workflows/job-progress";
-
-const reporter = createJobProgressReporter({
-  application: "example",
-  component: "batch-worker",
-  jobId: process.env.JOB_ID ?? "local",
-  sourceRevision: "abc123",
-  contractHash: "def456",
-  startedAt: new Date().toISOString(),
-  initialTracks: [
-    {
-      key: "overall",
-      data: {
-        schema: "pi-workflows.progress.v1",
-        status: "running",
-        phase: "starting",
-      },
-    },
-  ],
-  minimumIntervalMs: 30_000,
-  publishTimeoutMs: 15_000,
-  publish: async (snapshot, signal) => {
-    await bucket.writeText(progressPath, JSON.stringify(snapshot), { signal });
-  },
-});
-
-await reporter.report({
-  phase: "processing",
-  tracks: [
-    {
-      key: "records",
-      data: {
-        schema: "pi-workflows.progress.v1",
-        status: "running",
-        phase: "processing",
-        completed: 400,
-        total: 1_000,
-        unit: "records",
-      },
-    },
-  ],
-});
-```
-
-The first update, each phase change, and each terminal update publishes immediately. Other updates are coalesced until `minimumIntervalMs` has passed. Call `flush()` at a durable checkpoint or before exit when the current snapshot has not been published.
-
-On process restart, read and validate the existing snapshot and pass it as `previousSnapshot`. The reporter continues its sequence number and rejects an identity, deadline, or terminal-state mismatch.
-
-The reporter keeps the latest snapshot after a write failure. The application decides when to log and retry that failure. A timed-out storage write remains serialized until the underlying write settles, so an older write cannot overwrite a newer snapshot. Storage adapters must honor the abort signal and settle after cancellation. A progress failure must not replace receipt or checkpoint validation.
-
-## Finish a job
-
-A terminal update gets a finish timestamp and publishes immediately:
-
-```ts
-await reporter.report({
-  state: "completed",
-  phase: "complete",
-  tracks: [
-    {
-      key: "records",
-      data: {
-        schema: "pi-workflows.progress.v1",
-        status: "completed",
-        phase: "complete",
-        completed: 1_000,
-        total: 1_000,
-        unit: "records",
-      },
-    },
-  ],
-});
-```
-
-A terminal snapshot is not a receipt. Receipts, manifests, hashes, and durable application outputs remain authoritative.
-
-## Store and discover snapshots
-
-Write one mutable snapshot per physical job:
-
-```text
-<existing-bucket>/<application-prefix>/runs/<job-id>/progress.json
-```
-
-Add these immutable labels to the job or schedule:
-
-```text
-progress_schema=pi-workflows.job-progress.v1
-progress_bucket=<existing-bucket>
-progress_prefix=<application-prefix>/runs
-```
-
-A monitor reads the labels, forms `<progress_prefix>/<job-id>/progress.json`, validates the snapshot with `validateJobProgressSnapshot`, and publishes its tracks with stable keys. It should retain consecutive snapshots so Pi Workflows can estimate a conservative ETA from measured rates.
-
-## Estimate from snapshots
-
-```ts
-import { estimateJobProgress } from "@osolmaz/pi-workflows/job-progress";
-
-const result = estimateJobProgress(previousSnapshots);
-for (const estimate of result.estimates) {
-  console.log(estimate.key, estimate.remainingMedianMs);
-}
-```
-
-The estimator returns no measured ETA until a track has a known total and enough positive progress samples. A source-provided `sourceEstimatedFinishAt` remains available through the normal progress contract.
-
-## Data boundary
-
-Snapshots may contain identifiers, phases, counters, totals, timestamps, and cost totals. Do not put credentials, environment values, input records, model responses, logs, or private content in a snapshot. The strict validator rejects unknown fields and limits the encoded snapshot to 64 KiB.

package/docs/plans/2026-08-17-durable-job-progress-plan.md

@@ -1,176 +0,0 @@
-# Durable job progress
-
-## Problem
-
-Long-running remote jobs can expose state only through logs and final receipts. A monitor can confirm that a job is running, but it cannot give a reliable progress value or remaining time when the job does not publish a completed count, a total, and source timestamps.
-
-xTap Pool and OurModels need the same durable progress contract. The contract must work with their existing Hugging Face Buckets, survive worker restarts, and use the ETA estimator that Pi Workflows already uses for `pi-workflows.progress.v1` tracks.
-
-## Requirements
-
-The implementation must:
-
-- add one storage-neutral job progress API to `@osolmaz/pi-workflows`
-- reuse `pi-workflows.progress.v1` for progress tracks
-- write one mutable snapshot for each physical job in the application's existing Bucket
-- let monitors discover the snapshot from immutable job labels
-- let Pi Workflows validate the snapshot and estimate remaining time from repeated samples
-- let xTap Pool report restore, review, recovery, and publication progress
-- let OurModels report discovery, processing, cache, and publication progress
-- keep receipts, content hashes, manifests, and databases authoritative
-- avoid secrets, post text, model output, and other private content in progress snapshots
-- preserve one physical enrichment job at a time during the xTap Pool change
-- leave the OurModels replacement schedule suspended until a paid run is separately approved
-
-## Non-goals
-
-This work does not add:
-
-- a new remote store
-- a metrics database
-- a second ETA protocol
-- a Pi core change
-- a service or daemon
-- a compatibility path for an older snapshot schema
-- automatic authority to retry, deploy, publish, or spend money
-
-## Public contract
-
-The npm package exports a new subpath:
-
-```ts
-import {
-  createJobProgressReporter,
-  estimateJobProgress,
-  validateJobProgressSnapshot,
-  type JobProgressSnapshot,
-} from "@osolmaz/pi-workflows/job-progress";
-```
-
-A snapshot has schema `pi-workflows.job-progress.v1` and contains:
-
-- stable application and component names
-- the physical job identifier
-- source and work-contract identifiers
-- a monotonic sequence number
-- job state and current phase
-- start, update, optional deadline, and optional finish timestamps
-- one or more keyed `pi-workflows.progress.v1` tracks
-- optional settled cost and active reservation facts
-
-The validator is strict. It rejects unknown fields, duplicate track keys, invalid timestamps, non-finite values, invalid progress tracks, and oversized snapshots.
-
-The reporter accepts an injected asynchronous `publish(snapshot)` callback. Pi Workflows does not import a Hugging Face client. The reporter:
-
-- keeps sequence numbers monotonic within the process
-- rejects regressions within one phase and epoch
-- coalesces frequent updates with a configurable minimum interval
-- flushes phase changes and terminal states immediately
-- bounds publication time with an abort deadline
-- preserves the most recent unsent snapshot after a transient publication failure
-- never includes arbitrary metadata or environment values
-
-A terminal snapshot is operational evidence only. The application's receipt and durable output validation still decide whether work succeeded.
-
-## Storage and discovery
-
-Each application writes snapshots to its existing Bucket.
-
-xTap Pool uses:
-
-```text
-osolmaz/xtap-pool-bucket/operations/enrichment/runs/<job-id>/progress.json
-```
-
-OurModels uses:
-
-```text
-osolmaz/ourmodels-data/<prefix>/operations/community-posts/runs/<job-id>/progress.json
-```
-
-Each schedule supplies these immutable labels:
-
-```text
-progress_schema=pi-workflows.job-progress.v1
-progress_bucket=<bucket>
-progress_prefix=<path-before-job-id>
-```
-
-A monitor reads the labels, appends the physical job identifier and `progress.json`, reads the snapshot with existing local Hugging Face authentication, validates it, and publishes each track under a stable workflow progress key. The monitor does not trust an ETA string from logs. It uses source finish time when the snapshot provides one, or the existing conservative estimator after enough measured samples.
-
-## xTap Pool tracks
-
-The enrichment worker reports these stable tracks when facts are measurable:
-
-| Key                | Unit       | Source                                             |
-| ------------------ | ---------- | -------------------------------------------------- |
-| `database-restore` | bytes      | downloaded database bytes and expected object size |
-| `registry-replay`  | events     | replayed registry events and discovered total      |
-| `registry-scan`    | candidates | durable scan cursor and fixed candidate total      |
-| `queue`            | records    | terminal records and durable queue total           |
-| `publication`      | bytes      | uploaded and verified database bytes               |
-| `overall`          | phases     | completed phases and fixed phase count             |
-
-Phase-only states remain valid when a total is not yet known. The worker must not invent totals.
-
-The existing three unresolved records must receive durable outcomes under the fixed full-response deadline or become exactly validated blocked records. The worker then publishes and verifies the index before its final receipt is accepted.
-
-## OurModels tracks
-
-The community-posts worker reports these stable tracks when facts are measurable:
-
-| Key               | Unit    | Source                                          |
-| ----------------- | ------- | ----------------------------------------------- |
-| `model-discovery` | models  | discovered and inspected model count            |
-| `community-posts` | models  | processed models and fixed discovered total     |
-| `cache`           | records | durable cached model results and expected total |
-| `publication`     | bytes   | uploaded and verified artifact bytes            |
-| `overall`         | phases  | completed phases and fixed phase count          |
-
-The worker continues to use its existing receipt and manifest rules. A progress write failure must not corrupt a useful checkpoint or published result.
-
-## Delivery sequence
-
-1. Add and release `@osolmaz/pi-workflows/job-progress` as version `0.8.0`.
-2. Add snapshot discovery guidance to the bundled monitor skill.
-3. Update xTap Pool to use `0.8.0`, add measured callbacks, and add schedule labels.
-4. Merge and deploy xTap Pool, then replace the old suspended schedule.
-5. End the old physical job only when the replacement source is ready and the one-job rule can be preserved.
-6. Start one instrumented xTap Pool recovery job under the existing restoration budget.
-7. Update OurModels to use `0.8.0`, add measured callbacks, and replace old schedules with one suspended instrumented schedule.
-8. Do not start a paid OurModels run until its measured cost range and ceiling receive the required approval.
-9. Start a Pi monitor that reads both progress surfaces and displays current progress and ETA.
-
-## Acceptance checks
-
-Pi Workflows must pass:
-
-```bash
-npm run check
-npm run test:e2e
-npx slophammer-ts@latest dry .
-npx slophammer-ts@latest check . --only ts.dependency-boundaries-required
-```
-
-Tests must cover strict validation, unknown fields, duplicate keys, monotonic updates, phase resets, coalescing, transient publication failure, deadline abort, terminal flush, and ETA estimation from snapshots.
-
-xTap Pool must pass its repository checks, including mutation testing. A live recovery must show a valid snapshot in the existing index Bucket, and repeated monitor samples must produce a measured ETA when a track has a known total and positive progress.
-
-OurModels must pass:
-
-```bash
-npm run check
-npm run coverage
-npm run dry
-npm run mutate
-node scripts/test-bounds-engine.mjs
-node scripts/validate-model-data.mjs
-```
-
-Its replacement schedule must remain suspended with only the approved two secrets until a paid run is authorized.
-
-## Recovery
-
-If a progress publication fails, the worker keeps useful work and retries only the latest snapshot at the next bounded update. If the job ends before that succeeds, the receipt and durable outputs remain authoritative and the monitor marks progress stale.
-
-If a repeated deterministic worker defect appears, stop the affected job and schedule. Preserve all existing Bucket objects and return the exact failing phase, source revision, snapshot, receipt state, and last valid durable outputs.

package/src/job-progress/index.ts

@@ -1,24 +0,0 @@
-export {
-  createJobProgressReporter,
-  estimateJobProgress,
-  type JobProgressReporter,
-} from "./reporter.js";
-export {
-  isTerminalJobProgressState,
-  MAX_JOB_PROGRESS_BYTES,
-  MAX_JOB_PROGRESS_TRACKS,
-  validateJobProgressSnapshot,
-} from "./validation.js";
-export {
-  JOB_PROGRESS_SCHEMA,
-  type JobProgressCost,
-  type JobProgressEstimate,
-  type JobProgressIdentity,
-  type JobProgressPublish,
-  type JobProgressPublishResult,
-  type JobProgressReporterOptions,
-  type JobProgressSnapshot,
-  type JobProgressState,
-  type JobProgressTrack,
-  type JobProgressUpdate,
-} from "./types.js";