pi-harness-runtime 1.1.452 → 1.1.454

package/AGENTS.md

@@ -46,8 +46,21 @@ A task with a cheap tier and an expensive tier MUST use the cheap tier while the
    {
      "metadata": {
        "validationPlan": {
-         "fast": { "command": "bun test tests/fast", "expectedDurationMs": 18000, "datasetSize": 100 },
-         "full": { "command": "bun test tests/full", "expectedDurationMs": 2400000, "datasetSize": 10000 },
+         "fast": {
+           "command": "bun test tests/fast",
+           "expectedDurationMs": 18000,
+           "datasetSize": 100,
+           "owner": "the agent that runs the validation",
+           "passCriteria": ["every record is written once", "the counts of source and target match"],
+           "failureAction": "stop the job and report the failure of the pilot"
+         },
+         "full": {
+           "command": "bun test tests/full",
+           "expectedDurationMs": 2400000,
+           "datasetSize": 10000,
+           "owner": "the agent that runs the validation",
+           "scaleUpFrom": "fast"
+         },
          "budgetMinutes": 90,
          "finalTierRequired": true
        }
@@ -57,6 +70,8 @@ A task with a cheap tier and an expensive tier MUST use the cheap tier while the
 
    The harness never guesses a tier from a command string. Without a declared plan the current behaviour is unchanged.
 
+   A tier that declares `scaleUpFrom: "fast"` is the scale-up of a large job: it only counts when the fast tier passed. The fast tier of such a plan is the representative pilot and declares `"representative": true`.
+
 2. **Iterate on the fast tier.** After every code edit, rerun the fast tier plus the focused unit/type checks the edit touches.
 
 3. **Run the full tier once.** Run the full tier as the final acceptance check, when the implementation and the fast tier are stable.
@@ -71,7 +86,9 @@ A task with a cheap tier and an expensive tier MUST use the cheap tier while the
 
 8. **The fast tier must be representative.** A small fixture keeps the shape of the data (optional fields, relations, uniqueness, boundary values, aggregates under test), not just the row count. Use deterministic data with cleanup so repeated runs do not accumulate rows.
 
-9. **Record every tier run in the ledger.** The harness never runs the tests, so the run is recorded by whoever knows the result:
+9. **A large job starts with a measured pilot.** The pilot is the fast tier: it runs over a representative subset (100 records when that is safe) and it is measured, not assumed. The scale-up only starts when the pilot passed, the pilot ran on the declared number of records, and the run stayed inside the budget. A pilot that fails stops the job: report the finding instead of scaling up. The batches of a scale-up are bounded and explicit (`packages/jev-judge/src/batch-plan.ts`), a failed batch is retried instead of restarting the job, and the concurrency limit is always a declared number.
+
+10. **Record every tier run in the ledger.** The harness never runs the tests, so the run is recorded by whoever knows the result:
 
    ```bash
    bun scripts/validation-run.ts --item 12 --tier fast --status passed --duration 18s --dataset 100
@@ -83,6 +100,8 @@ A task with a cheap tier and an expensive tier MUST use the cheap tier while the
 **What the harness does with the plan:**
 
 - The continuation message carries the plan, the recorded tier state and the remaining budget, so the agent never re-runs a tier that already passed.
+- A scale-up that ran before its pilot passed does not count: the final tier stays pending and the task stays open.
+- The status line names the phase, the progress, the validation state and the children that really ran.
 - When `budgetMinutes` is spent, the item pauses at a safe boundary: nothing is dispatched, the work stays open, and the reason is reported.
 - When a todo with `finalTierRequired` is marked complete while that tier is pending or failed, the completion report is suppressed and the item is named instead. A todo may not be reported as done on the strength of an unreported run.
 
@@ -353,6 +372,16 @@ todo create "Replace Film icon with themed icon"
 
 **IMPORTANT**: The `todo` tool and `bd` commands are DIFFERENT systems. Use `todo` for local task tracking.
 
+**Who owns the todo list.** The **agent** creates the todos, the harness
+only reads them. Two consequences:
+
+- The kind of a todo is read from `metadata.kind` first and from the title
+  prefix second. An explicit kind is more reliable than a prefix, and the
+  agent can always set it.
+- When the todo provider is not available, the harness says so: the status
+  line reads `[?] TODOS unavailable` and the agent is told that the phase
+  gate is not active. The harness never claims a gate it cannot enforce.
+
 ---
 
 ## Phase Model: Implementation, Review, Validation (CRITICAL)

package/CHANGELOG.md

@@ -2,6 +2,63 @@
 
 All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
 
+### [1.1.454](https://github.com/ManotLuijiu/pi-harness-runtime/compare/v1.1.448...v1.1.454) (2026-10-27)
+
+
+### Features
+
+* **delegation:** a child is only a child when it really ran ([ac4e678](https://github.com/ManotLuijiu/pi-harness-runtime/commit/ac4e6782d7d4bc4941e458425c8a9f38a51fc9d4))
+* **delegation:** the scope of a request is measured before it is judged ([684b6a5](https://github.com/ManotLuijiu/pi-harness-runtime/commit/684b6a55184f63d3be24c48dcecfb0b13410dc15))
+* **jev:** the pending question carries the ask and the answer ([a792133](https://github.com/ManotLuijiu/pi-harness-runtime/commit/a792133e517fb8c12d3363e98942f3af30270f27))
+* **merge:** a manual run can leave the merge to the pull request event ([b3d1950](https://github.com/ManotLuijiu/pi-harness-runtime/commit/b3d1950b5941c78ccd56951acdafd1d4afbe1bff))
+* **phase:** the agent owns the todo list and the harness says so ([c489370](https://github.com/ManotLuijiu/pi-harness-runtime/commit/c489370bd7926aece8cb1a77aa20ca2d2672f1fb))
+* **review:** the review starts on its own when the implementation is done ([04f51f5](https://github.com/ManotLuijiu/pi-harness-runtime/commit/04f51f599cd3222b6c74dd8fadb1373bd72d9bd7))
+* **status:** the status line names the phase, the progress and the children ([0167bf3](https://github.com/ManotLuijiu/pi-harness-runtime/commit/0167bf396a0b987c1d44f3b869351976a951dd65))
+* **test:** the task waits for the final tier of the validation plan ([fa147db](https://github.com/ManotLuijiu/pi-harness-runtime/commit/fa147dbf7d50d56e6ea48c6d8fbb4fcb190caf8a))
+* **validation:** a large job starts with a measured pilot ([425964b](https://github.com/ManotLuijiu/pi-harness-runtime/commit/425964b04a3d4fa02adfabed47ff62c5ec2b9c28))
+
+
+### Bug Fixes
+
+* **hooks:** a tag is checked through the commit behind it ([c823e8e](https://github.com/ManotLuijiu/pi-harness-runtime/commit/c823e8e1f6973c62b5449a97c101759a4d5cbba5))
+* **jev:** the alternatives of a question are parsed without a quadratic pattern ([63016a3](https://github.com/ManotLuijiu/pi-harness-runtime/commit/63016a3f0488acb801990dd46770c00d382b5858))
+* **keys:** the key directory is audited as a tree ([081cc75](https://github.com/ManotLuijiu/pi-harness-runtime/commit/081cc75ac8ceff36b0d619c3f76371dc08459d3c))
+* **merge:** the boolean input is read as a boolean ([971b716](https://github.com/ManotLuijiu/pi-harness-runtime/commit/971b7169a43db382dbdeb6bb9bab02ab56e0351c))
+* **merge:** the manual job needs the right of the merge ([7ba685e](https://github.com/ManotLuijiu/pi-harness-runtime/commit/7ba685ec43d815f90aa35b742579e87e76c69209))
+* **merge:** the merge of the pull request is the GraphQL mutation ([972bab4](https://github.com/ManotLuijiu/pi-harness-runtime/commit/972bab4b0f7faf1b0047f3bb767ef6db3de4b2fa))
+* **merge:** the workflow merges the pull request the gates cleared ([d7639ec](https://github.com/ManotLuijiu/pi-harness-runtime/commit/d7639ec9b83723510acb4a5c4e23d5d6167c3af6))
+* **release:** a manual release keeps the version of its manifest ([122e661](https://github.com/ManotLuijiu/pi-harness-runtime/commit/122e661ea48cb8aff14c71dbd0221a4cf0ba4c8e))
+* **release:** the release pull request names the version of its branch ([a846e83](https://github.com/ManotLuijiu/pi-harness-runtime/commit/a846e83e6de6e529f4bca05e869db0b5eebb37c5))
+* **release:** the release scans the tree of the commit it publishes ([7d47a0b](https://github.com/ManotLuijiu/pi-harness-runtime/commit/7d47a0b5406480a1e1d3a52623a76aabd1e2d0ba))
+
+### [1.1.453](https://github.com/ManotLuijiu/pi-harness-runtime/compare/v1.1.448...v1.1.453) (2026-10-27)
+
+
+### Features
+
+* **delegation:** a child is only a child when it really ran ([ac4e678](https://github.com/ManotLuijiu/pi-harness-runtime/commit/ac4e6782d7d4bc4941e458425c8a9f38a51fc9d4))
+* **delegation:** the scope of a request is measured before it is judged ([684b6a5](https://github.com/ManotLuijiu/pi-harness-runtime/commit/684b6a55184f63d3be24c48dcecfb0b13410dc15))
+* **jev:** the pending question carries the ask and the answer ([a792133](https://github.com/ManotLuijiu/pi-harness-runtime/commit/a792133e517fb8c12d3363e98942f3af30270f27))
+* **merge:** a manual run can leave the merge to the pull request event ([b3d1950](https://github.com/ManotLuijiu/pi-harness-runtime/commit/b3d1950b5941c78ccd56951acdafd1d4afbe1bff))
+* **phase:** the agent owns the todo list and the harness says so ([c489370](https://github.com/ManotLuijiu/pi-harness-runtime/commit/c489370bd7926aece8cb1a77aa20ca2d2672f1fb))
+* **review:** the review starts on its own when the implementation is done ([04f51f5](https://github.com/ManotLuijiu/pi-harness-runtime/commit/04f51f599cd3222b6c74dd8fadb1373bd72d9bd7))
+* **status:** the status line names the phase, the progress and the children ([0167bf3](https://github.com/ManotLuijiu/pi-harness-runtime/commit/0167bf396a0b987c1d44f3b869351976a951dd65))
+* **test:** the task waits for the final tier of the validation plan ([fa147db](https://github.com/ManotLuijiu/pi-harness-runtime/commit/fa147dbf7d50d56e6ea48c6d8fbb4fcb190caf8a))
+* **validation:** a large job starts with a measured pilot ([425964b](https://github.com/ManotLuijiu/pi-harness-runtime/commit/425964b04a3d4fa02adfabed47ff62c5ec2b9c28))
+
+
+### Bug Fixes
+
+* **hooks:** a tag is checked through the commit behind it ([c823e8e](https://github.com/ManotLuijiu/pi-harness-runtime/commit/c823e8e1f6973c62b5449a97c101759a4d5cbba5))
+* **jev:** the alternatives of a question are parsed without a quadratic pattern ([63016a3](https://github.com/ManotLuijiu/pi-harness-runtime/commit/63016a3f0488acb801990dd46770c00d382b5858))
+* **keys:** the key directory is audited as a tree ([081cc75](https://github.com/ManotLuijiu/pi-harness-runtime/commit/081cc75ac8ceff36b0d619c3f76371dc08459d3c))
+* **merge:** the boolean input is read as a boolean ([971b716](https://github.com/ManotLuijiu/pi-harness-runtime/commit/971b7169a43db382dbdeb6bb9bab02ab56e0351c))
+* **merge:** the manual job needs the right of the merge ([7ba685e](https://github.com/ManotLuijiu/pi-harness-runtime/commit/7ba685ec43d815f90aa35b742579e87e76c69209))
+* **merge:** the merge of the pull request is the GraphQL mutation ([972bab4](https://github.com/ManotLuijiu/pi-harness-runtime/commit/972bab4b0f7faf1b0047f3bb767ef6db3de4b2fa))
+* **merge:** the workflow merges the pull request the gates cleared ([d7639ec](https://github.com/ManotLuijiu/pi-harness-runtime/commit/d7639ec9b83723510acb4a5c4e23d5d6167c3af6))
+* **release:** a manual release keeps the version of its manifest ([122e661](https://github.com/ManotLuijiu/pi-harness-runtime/commit/122e661ea48cb8aff14c71dbd0221a4cf0ba4c8e))
+* **release:** the release scans the tree of the commit it publishes ([7d47a0b](https://github.com/ManotLuijiu/pi-harness-runtime/commit/7d47a0b5406480a1e1d3a52623a76aabd1e2d0ba))
+
 ### [1.1.452](https://github.com/ManotLuijiu/pi-harness-runtime/compare/v1.1.448...v1.1.452) (2026-10-27)
 
 

package/index.ts

@@ -557,11 +557,35 @@ async function initTwoPhaseReview(pi: ExtensionAPI): Promise<void> {
 		return { available: true, pendingFinalTier, failedFinalTier, incompletePlan };
 	};
 
+	/**
+	 * The delegation state of the session.
+	 *
+	 * The numbers are the observed ones: the children that really ran and
+	 * the groups the harness measured. A plan that was never dispatched
+	 * shows zero dispatched children.
+	 */
+	const readDelegation = () => {
+		const harness = sharedState.delegationHarness as
+			| import("./packages/jev-judge/dist/delegation-harness.js").DelegationHarness
+			| null
+			| undefined;
+		if (!harness) return undefined;
+		try {
+			const receipt = harness.getReceipt();
+			const groups = receipt?.decision.workGroups?.length ?? 0;
+			const dispatched = harness.getChildren().length;
+			return { groups, dispatched };
+		} catch {
+			return undefined;
+		}
+	};
+
 	try {
 		await mod.initTwoPhaseReview({
 			pi,
 			readTodos,
 			readValidation,
+			readDelegation,
 			workspaceRoot: () => {
 				try {
 					return realpathSync(process.cwd());
@@ -903,6 +927,58 @@ async function initAutoContinue(pi: ExtensionAPI): Promise<void> {
 				logToFile("[Delegation]", "The delegation steer failed:", oneLineError(error));
 			}
 		}
+
+		// The children of a delegation are observed, not assumed. The
+		// harness does not dispatch anything: the agent sends the measured
+		// groups to the sub-agent tool, and the tool events are the proof
+		// that a child really ran.
+		pi.on("tool_execution_start", (event) => {
+			try {
+				const toolEvent = event as {
+					toolCallId?: string;
+					toolName?: string;
+					args?: unknown;
+				};
+				const child = sharedState.delegationHarness?.observeToolStart?.({
+					toolCallId: String(toolEvent.toolCallId ?? ""),
+					toolName: String(toolEvent.toolName ?? ""),
+					args: toolEvent.args,
+				});
+				if (child) {
+					logToFile(
+						"[Delegation]",
+						`A child was dispatched: ${child.toolName} (${child.groupId ?? "no group"})`,
+					);
+				}
+			} catch (error) {
+				logToFile("[Delegation]", "The child could not be recorded:", oneLineError(error));
+			}
+		});
+
+		pi.on("tool_execution_end", (event) => {
+			try {
+				const toolEvent = event as {
+					toolCallId?: string;
+					toolName?: string;
+					result?: unknown;
+					isError?: boolean;
+				};
+				const child = sharedState.delegationHarness?.observeToolEnd?.({
+					toolCallId: String(toolEvent.toolCallId ?? ""),
+					toolName: String(toolEvent.toolName ?? ""),
+					result: toolEvent.result,
+					isError: toolEvent.isError === true,
+				});
+				if (child) {
+					logToFile(
+						"[Delegation]",
+						`The child ended: ${child.toolName} (${child.status})${child.model ? `, model ${child.model}` : ""}`,
+					);
+				}
+			} catch (error) {
+				logToFile("[Delegation]", "The child could not be closed:", oneLineError(error));
+			}
+		});
 		let _sessionId = Date.now().toString(36); // Track session for cancellation
 		let _lastNotifiedQuestion = ""; // Track last question to prevent repeat notifications
 		let _completedNotifiedFor: string | null = null; // Track completion notification deduplication

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-harness-runtime",
-  "version": "1.1.452",
+  "version": "1.1.454",
   "description": "[BETA] Codex-style /usage status + autonomous coding harness for pi. Not production ready — expect breaking changes.",
   "type": "module",
   "scripts": {

package/packages/agent-policy/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/agent-policy",
-  "version": "1.1.452",
+  "version": "1.1.454",
   "description": "Agent policy runtime for pi-harness - enforces mandatory rule delivery and mutation gating",
   "type": "module",
   "main": "./dist/index.js",

package/packages/auth/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/auth",
-  "version": "1.1.452",
+  "version": "1.1.454",
   "description": "pi-harness-runtime — auth",
   "type": "module",
   "main": "./dist/index.js",

package/packages/autonomous-runtime/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/autonomous-runtime",
-  "version": "1.1.452",
+  "version": "1.1.454",
   "description": "Autonomous Operations Runtime — task inbox, lease management, and worker lifecycle (RFC-0101)",
   "type": "module",
   "main": "./dist/index.js",

package/packages/checkpoint/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/checkpoint",
-  "version": "1.1.452",
+  "version": "1.1.454",
   "description": "Enhanced checkpoint system with incremental snapshots, diff-based storage, and recovery strategies",
   "type": "module",
   "main": "./dist/index.js",

package/packages/clipboard/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/clipboard",
-  "version": "1.1.452",
+  "version": "1.1.454",
   "type": "module",
   "main": "src/index.ts",
   "exports": {

package/packages/codex-watcher/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/codex-watcher",
-  "version": "1.1.452",
+  "version": "1.1.454",
   "description": "Watches Codex CLI sessions and emits visible messages for PING-PONG monitoring",
   "type": "module",
   "main": "./dist/src/index.js",

package/packages/config-capture/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moocoding/config-capture",
-  "version": "1.1.452",
+  "version": "1.1.454",
   "description": "Auto-capture API-fetched configuration values to AGENTS.md",
   "type": "module",
   "main": "src/index.ts",

package/packages/contracts/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/contracts",
-  "version": "1.1.452",
+  "version": "1.1.454",
   "type": "module",
   "description": "RPC schema definitions for pi-harness runtime",
   "main": "./dist/index.js",

package/packages/cookie-sanitizer/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/cookie-sanitizer",
-  "version": "1.1.452",
+  "version": "1.1.454",
   "description": "pi-harness-runtime — cookie sanitizer (provider-quota cookie file normaliser)",
   "type": "module",
   "main": "./dist/index.js",

package/packages/evaluation-engine/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/evaluation-engine",
-  "version": "1.1.452",
+  "version": "1.1.454",
   "description": "Evaluation engine for pi-harness runtime (RFC-0057)",
   "type": "module",
   "main": "./dist/index.js",

package/packages/event-bus/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/event-bus",
-  "version": "1.1.452",
+  "version": "1.1.454",
   "type": "module",
   "main": "src/index.ts",
   "exports": {

package/packages/event-store/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/event-store",
-  "version": "1.1.452",
+  "version": "1.1.454",
   "type": "module",
   "main": "src/index.ts",
   "exports": {

package/packages/experience-replay/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/experience-replay",
-  "version": "1.1.452",
+  "version": "1.1.454",
   "description": "Experience replay for debugging and reproducibility (RFC-0059)",
   "type": "module",
   "main": "./dist/index.js",

package/packages/file-copy-helper/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moocoding/file-copy-helper",
-  "version": "1.1.452",
+  "version": "1.1.454",
   "description": "Injects cp/sudo cp rule when user asks to mimic/copy files",
   "type": "module",
   "main": "dist/index.js",

package/packages/intent-analyzer/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/intent-analyzer",
-  "version": "1.1.452",
+  "version": "1.1.454",
   "type": "module",
   "main": "src/index.ts",
   "exports": {

package/packages/jev-judge/dist/batch-plan.d.ts

@@ -0,0 +1,150 @@
+/**
+ * The batches of a large job.
+ *
+ * A large job does not run in one piece. It starts with a measured pilot
+ * and continues in bounded batches, and the state of every batch is kept
+ * so a failure resumes instead of restarting.
+ *
+ * Every number here is either given or measured. The harness never
+ * estimates a duration from a number it invented: an estimate needs a
+ * measured cost per record, and without one the estimate is unknown.
+ */
+/** The kind of a batch. */
+export type BatchKind = "pilot" | "scale-up";
+/** The state of a batch. */
+export type BatchStatus = "pending" | "running" | "done" | "failed";
+/**
+ * One batch of a large job.
+ */
+export interface Batch {
+    /** The id of the batch. */
+    id: string;
+    /** The kind of the batch. */
+    kind: BatchKind;
+    /** The first record of the batch (inclusive). */
+    from: number;
+    /** The last record of the batch (inclusive). */
+    to: number;
+    /** The number of records of the batch. */
+    records: number;
+    /** The state of the batch. */
+    status: BatchStatus;
+    /** How often the batch was tried. */
+    attempts: number;
+    /** The measured duration of the batch. */
+    durationMs?: number;
+    /** The reason of a failure. */
+    failure?: string;
+}
+/**
+ * The plan of a large job.
+ *
+ * The limits are explicit: the size of the pilot, the size of a batch,
+ * the number of batches that may run at the same time and the budget.
+ */
+export interface BatchPlan {
+    /** The number of records of the whole job. */
+    totalRecords: number;
+    /** The number of records of the representative pilot. */
+    pilotRecords: number;
+    /** The maximum number of records of a scale-up batch. */
+    maxBatchRecords: number;
+    /** The maximum number of batches that may run at the same time. */
+    maxConcurrentBatches: number;
+    /**
+     * The measured cost of one record, in milliseconds.
+     *
+     * Without a measured cost the estimated duration of the job is
+     * unknown, and the plan says so.
+     */
+    msPerRecord?: number;
+    /** The budget of the whole job, in minutes. */
+    budgetMinutes?: number;
+    /** How often a failed batch is tried again. */
+    maxAttempts?: number;
+}
+/**
+ * The progress of the batches.
+ */
+export interface BatchProgress {
+    /** The batches that are done. */
+    done: number;
+    /** The batches that failed. */
+    failed: number;
+    /** The batches that still have to run. */
+    pending: number;
+    /** The records that are done. */
+    recordsDone: number;
+    /** The records of the whole job. */
+    recordsTotal: number;
+    /** The measured duration of the finished batches. */
+    durationMs: number;
+}
+/**
+ * The batches of a job.
+ *
+ * The first batch is the pilot. The rest are the scale-up, in the order
+ * of the records.
+ */
+export declare function buildBatches(plan: BatchPlan): Batch[];
+/**
+ * The estimated duration of the whole job.
+ *
+ * The estimate needs a measured cost per record. Without one the answer
+ * is unknown: the plan never guesses a duration.
+ */
+export declare function estimateJobMs(plan: BatchPlan): number | undefined;
+/**
+ * May the scale-up start?
+ *
+ * The pilot has to be done and it has to have passed. A failed pilot
+ * stops the job: the plan never scales up on a failure.
+ */
+export declare function mayStartScaleUp(batches: Batch[]): boolean;
+/**
+ * The batches that may run now.
+ *
+ * The scale-up waits for the pilot, the limit of parallel batches is
+ * respected, and a batch that already used up its attempts is never
+ * offered again.
+ */
+export declare function nextBatches(batches: Batch[], plan: BatchPlan): Batch[];
+/**
+ * The result of one batch attempt.
+ */
+export interface BatchResult {
+    /** The id of the batch. */
+    id: string;
+    /** Did the batch succeed? */
+    ok: boolean;
+    /** The measured duration of the attempt. */
+    durationMs?: number;
+    /** The reason of a failure. */
+    failure?: string;
+}
+/**
+ * Record the result of a batch attempt.
+ *
+ * A failed batch keeps its place: the batches that are done are never
+ * repeated, and a failed batch is tried again until it used up its
+ * attempts.
+ */
+export declare function recordBatchResult(batches: Batch[], result: BatchResult): Batch[];
+/**
+ * The progress of the batches.
+ */
+export declare function batchProgress(batches: Batch[]): BatchProgress;
+/**
+ * Is the job over the budget?
+ *
+ * The budget is a limit, not a wish: a job that spent it stops and
+ * reports. A budget that was never measured cannot be spent.
+ */
+export declare function overBudget(plan: BatchPlan, elapsedMs: number | undefined): boolean;
+/**
+ * The description of the batches, for the status line.
+ *
+ * The line is plain ASCII and names the measured facts.
+ */
+export declare function describeBatches(batches: Batch[]): string;
+//# sourceMappingURL=batch-plan.d.ts.map

package/packages/jev-judge/dist/batch-plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch-plan.d.ts","sourceRoot":"","sources":["../src/batch-plan.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,2BAA2B;AAC3B,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,UAAU,CAAC;AAE7C,4BAA4B;AAC5B,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEpE;;GAEG;AACH,MAAM,WAAW,KAAK;IACrB,2BAA2B;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,6BAA6B;IAC7B,IAAI,EAAE,SAAS,CAAC;IAChB,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,gDAAgD;IAChD,EAAE,EAAE,MAAM,CAAC;IACX,0CAA0C;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,8BAA8B;IAC9B,MAAM,EAAE,WAAW,CAAC;IACpB,qCAAqC;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,0CAA0C;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+BAA+B;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;GAKG;AACH,MAAM,WAAW,SAAS;IACzB,8CAA8C;IAC9C,YAAY,EAAE,MAAM,CAAC;IACrB,yDAAyD;IACzD,YAAY,EAAE,MAAM,CAAC;IACrB,yDAAyD;IACzD,eAAe,EAAE,MAAM,CAAC;IACxB,mEAAmE;IACnE,oBAAoB,EAAE,MAAM,CAAC;IAC7B;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+CAA+C;IAC/C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,+CAA+C;IAC/C,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC7B,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,+BAA+B;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,0CAA0C;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,oCAAoC;IACpC,YAAY,EAAE,MAAM,CAAC;IACrB,qDAAqD;IACrD,UAAU,EAAE,MAAM,CAAC;CACnB;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,SAAS,GAAG,KAAK,EAAE,CAiCrD;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,GAAG,SAAS,CAIjE;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,KAAK,EAAE,GAAG,OAAO,CAIzD;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,GAAG,KAAK,EAAE,CAiBtE;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC3B,2BAA2B;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,6BAA6B;IAC7B,EAAE,EAAE,OAAO,CAAC;IACZ,4CAA4C;IAC5C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+BAA+B;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,WAAW,GAAG,KAAK,EAAE,CAYhF;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,KAAK,EAAE,GAAG,aAAa,CAyB7D;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CACzB,IAAI,EAAE,SAAS,EACf,SAAS,EAAE,MAAM,GAAG,SAAS,GAC3B,OAAO,CAIT;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,KAAK,EAAE,GAAG,MAAM,CAQxD"}