@rasensio/aidlc 1.63.0 → 1.65.0

package/dist/autopilot/driver.d.ts

@@ -15,7 +15,8 @@
  *
  * @module
  */
-import type { AutopilotConfig, AutopilotItem, AutopilotPaths, AutopilotState } from './state.js';
+import type { Notice } from './notify.js';
+import type { AutopilotConfig, AutopilotItem, AutopilotPaths, AutopilotState, ItemStep } from './state.js';
 import { type PausePhase, type Stops } from './stops.js';
 export interface RunResult {
     status: number;
@@ -23,6 +24,16 @@ export interface RunResult {
     stderr: string;
     dry?: boolean;
 }
+/** How a spawned agent ended, as seen by the process that spawned it. */
+export interface AgentExit {
+    /** null when a signal ended it. */
+    code: number | null;
+    signal: string | null;
+    /** From spawn to exit. */
+    ms: number;
+    /** At most 4 KB of what this launch wrote to the item's log — never an earlier launch's (codex-preset-removed-flag/AC-8). */
+    output: string;
+}
 export interface DriverCtx {
     /** Primary checkout — where merges and releases happen. */
     repo: string;
@@ -49,12 +60,22 @@ export interface DriverCtx {
         boot: string | null;
         ns: string | null;
     } | null;
+    /**
+     * How `pid` ended, or null when this process did not spawn it or it has not ended.
+     * Absent is the same as null: the pass cannot tell (codex-preset-removed-flag/AC-11).
+     */
+    exited?(pid: number): AgentExit | null;
     kill(pid: number): void;
     fs: {
         read(path: string): string | null;
         exists(path: string): boolean;
         write(path: string, text: string): void;
     };
+    /**
+     * Tell a person something needs them or is done. Absent sends nothing: only a
+     * background run sets it (autopilot-live-progress/AC-20, AC-23).
+     */
+    notify?(notice: Notice): void;
 }
 /** How many builds a run may still start, and what to tell it (autopilot-on-demand/AC-7). */
 export interface Budget {
@@ -85,6 +106,20 @@ export declare function conflictPrompt(item: {
 }): string;
 /** The stops an item is held to: those recorded when it started (autopilot-stop-controls/AC-6). */
 export declare function itemStops(item: AutopilotItem): Stops;
+/**
+ * A non-zero exit sooner than this after launch is a launch failure, not a failed
+ * build. Argument and startup errors exit in well under a second; a session that
+ * fails later prints a banner first, which names nothing (codex-preset-removed-flag/AC-6, AC-10).
+ */
+export declare const LAUNCH_FAILURE_MS = 30000;
+/**
+ * The first non-blank line of `text`, terminal escapes and control characters removed,
+ * at most 200 characters; null when there is none (codex-preset-removed-flag/AC-12).
+ * The first line, not `fail`'s last: for an argument error the last is the usage line.
+ */
+export declare function firstOutputLine(text: string): string | null;
+/** The instance's `current_phase` in its worktree, or null when unreadable. Shared with the view. */
+export declare function instancePhase(read: (path: string) => string | null, item: Pick<AutopilotItem, 'name' | 'worktree'>): string | null;
 /**
  * Return every item whose failure is resumable to the step it failed in, and
  * clear the error. Called when a run starts: asking to run is asking to retry
@@ -112,5 +147,21 @@ export type ApproveOutcome = {
 export declare function approveItem(state: AutopilotState, name: string): ApproveOutcome;
 /** One pass. Returns the new state; the caller saves it (not in a dry run). */
 export declare function tick(ctx: DriverCtx, state: AutopilotState, budget?: Budget): AutopilotState;
+/** Each item's step by name, to compare against after a change (autopilot-live-progress/AC-11). */
+export declare function stepsOf(state: AutopilotState): Map<string, ItemStep>;
+/**
+ * Stamp `step_since` on every item whose step differs from `before`; a new item has
+ * no entry there and is stamped too. Diffing here, rather than at each of the
+ * fourteen places a step is set, means a new handler cannot forget it.
+ */
+export declare function markStepChanges(state: AutopilotState, before: Map<string, ItemStep>, now: number): void;
+/**
+ * The driver's line, shared by `status` and the watch view.
+ *
+ * @param stopped - whether the STOP file exists.
+ * @param lastPass - how to show the last pass's time; `status` shows it as stored.
+ */
+export declare function driverLine(stopped: boolean, state: AutopilotState, now: number, lastPass?: (iso: string) => string): string;
+export declare function queueLine(state: AutopilotState): string | null;
 export declare function statusLines(ctx: Pick<DriverCtx, 'fs' | 'paths' | 'now'>, state: AutopilotState): string[];
 //# sourceMappingURL=driver.d.ts.map

package/dist/autopilot/driver.d.ts.map

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

package/dist/autopilot/driver.js

@@ -96,18 +96,49 @@ export function conflictPrompt(item) {
         `\`git fetch origin main\` and \`git merge origin/main\` on this branch, resolve every conflict keeping ` +
         `the intent of both sides, run the tests, commit the merge, and stop. Do not push, merge or release.`);
 }
+/**
+ * Record `text` as the item's last event for the view. The same text again keeps
+ * the time it was first said: "waiting for checks to start, 12m ago"
+ * (autopilot-live-progress/AC-12).
+ */
+function record(ctx, item, text) {
+    if (item.last_event?.text === text)
+        return;
+    item.last_event = { at: new Date(ctx.now()).toISOString(), text };
+}
+/** Say a line about an item — the same line as ever — and record it. */
+function tell(ctx, item, text) {
+    ctx.say(`${item.name}: ${text}`);
+    record(ctx, item, text);
+}
+/**
+ * Notices go out at a transition, never from an observation a pass repeats, so a
+ * queue halted for five hours notifies once with no record of what was sent
+ * (autopilot-live-progress/AC-16).
+ */
+function notice(ctx, title, message) {
+    ctx.notify?.({ title: `autopilot: ${title}`, message });
+}
 /**
  * Put an item in `error`. `resume` names the step `aidlc autopilot run` returns
  * it to; leave it out for a failure at or after the merge, which stays a
  * person's call (autopilot-merge-lane-stalls-on-conflicts/AC-14, AC-16).
+ *
+ * Never reached for an item already in `error` — handlers are picked by step and
+ * `serveQueue` returns on an errored head — so this notifies once per failure
+ * (autopilot-live-progress/AC-15).
  */
-function failItem(item, error, resume) {
+function failItem(ctx, state, item, error, resume) {
     item.step = 'error';
     item.error = error;
     if (resume)
         item.resume_step = resume;
     else
         delete item.resume_step;
+    // Recorded, not said: half the callers print nothing today, and what is printed must not change.
+    record(ctx, item, error);
+    const title = error.startsWith('release failed') ? 'release failed' : state.queue.includes(item.name) ? 'queue halted' : 'item stopped';
+    notice(ctx, title, `${item.name}: ${error}`);
 }
 function dequeue(state, item) {
     state.queue = state.queue.filter((n) => n !== item.name);
@@ -121,6 +152,37 @@ export function itemStops(item) {
     return item.stops ?? LEGACY_STOPS;
 }
 const itemPauses = (item) => pauseEnv(itemStops(item), item.approved ?? []);
+/**
+ * A non-zero exit sooner than this after launch is a launch failure, not a failed
+ * build. Argument and startup errors exit in well under a second; a session that
+ * fails later prints a banner first, which names nothing (codex-preset-removed-flag/AC-6, AC-10).
+ */
+export const LAUNCH_FAILURE_MS = 30_000;
+const REASON_MAX = 200;
+/**
+ * The first non-blank line of `text`, terminal escapes and control characters removed,
+ * at most 200 characters; null when there is none (codex-preset-removed-flag/AC-12).
+ * The first line, not `fail`'s last: for an argument error the last is the usage line.
+ */
+export function firstOutputLine(text) {
+    const plain = text.replace(/\x1b\[[0-?]*[ -/]*[@-~]/g, '').replace(/[\x00-\x08\x0b-\x1f\x7f]/g, '');
+    const line = plain.split('\n').map((l) => l.trim()).find((l) => l !== '');
+    return line === undefined ? null : line.slice(0, REASON_MAX);
+}
+/**
+ * The park reason for an agent that failed to launch, or null when it did not or the
+ * pass cannot tell. Its first line, not its stderr: both streams share the log by
+ * design, and an argument error is printed before anything else
+ * (codex-preset-removed-flag/AC-6, AC-7, AC-11).
+ */
+function launchFailure(ctx, item) {
+    const exit = item.pid === null ? null : ctx.exited?.(item.pid) ?? null;
+    if (exit === null || exit.code === 0 || exit.ms >= LAUNCH_FAILURE_MS)
+        return null;
+    const how = exit.code === null ? `signal ${exit.signal ?? 'unknown'}` : `exit ${exit.code}`;
+    const line = firstOutputLine(exit.output);
+    return line === null ? `agent failed to launch (${how}) with no output` : `agent failed to launch (${how}): ${line}`;
+}
 function launchAgent(ctx, item, prompt) {
     const command = ctx.config?.agent_command ?? [];
     const argv = command.map((a) => (a === '{prompt}' ? prompt : a));
@@ -142,7 +204,7 @@ function launchAgent(ctx, item, prompt) {
         item.pid_boot = id.boot;
         item.pid_ns = id.ns;
     }
-    ctx.say(`${item.name}: agent started (pid ${item.pid})`);
+    tell(ctx, item, `agent started (pid ${item.pid})`);
 }
 function drop(state, item, budget) {
     state.items = state.items.filter((i) => i !== item);
@@ -152,18 +214,23 @@ function drop(state, item, budget) {
 function park(ctx, io, state, item, reason, budget) {
     const r = io.cli(['roadmap', 'park', item.name, '--reason', reason]);
     if (r.status !== 0) {
-        failItem(item, `park failed: ${fail(r)}`);
-        ctx.say(`${item.name}: could not park — ${item.error}`);
+        failItem(ctx, state, item, `park failed: ${fail(r)}`);
+        tell(ctx, item, `could not park — ${item.error}`);
         return;
     }
     io.cli(['release', item.name]);
-    ctx.say(`${item.name}: parked — ${reason}`);
+    tell(ctx, item, `parked — ${reason}`);
+    notice(ctx, 'item parked', `${item.name}: ${reason}`);
     drop(state, item, budget);
 }
-function currentPhase(ctx, item) {
-    const yaml = ctx.fs.read(`${item.worktree}/.aidlc/state/${item.name}/instance.yaml`) ?? '';
+/** The instance's `current_phase` in its worktree, or null when unreadable. Shared with the view. */
+export function instancePhase(read, item) {
+    const yaml = read(`${item.worktree}/.aidlc/state/${item.name}/instance.yaml`) ?? '';
     return /^current_phase:\s*(\S+)/m.exec(yaml)?.[1] ?? null;
 }
+function currentPhase(ctx, item) {
+    return instancePhase(ctx.fs.read, item);
+}
 /** A phase file's own top-level status, not an artifact's indented one. */
 const COMPLETE_RE = /^status:\s*complete\s*$/m;
 function phaseComplete(ctx, item, phase) {
@@ -181,7 +248,8 @@ function awaitIfPaused(ctx, item) {
     item.step = 'awaiting-review';
     item.review = phase;
     item.pid = null;
-    ctx.say(`${item.name}: paused after ${phase} for your review — \`aidlc autopilot approve ${item.name}\` carries it on`);
+    tell(ctx, item, `paused after ${phase} for your review — \`aidlc autopilot approve ${item.name}\` carries it on`);
+    notice(ctx, 'review needed', `${item.name}: paused after ${phase} — aidlc autopilot approve ${item.name}`);
     return true;
 }
 function advanceBuilding(ctx, io, state, item, budget) {
@@ -205,18 +273,26 @@ function advanceBuilding(ctx, io, state, item, budget) {
         return;
     }
     if (ctx.fs.exists(`${ctx.repo}/.aidlc/roadmap/hold/${item.file}`)) {
-        ctx.say(`${item.name}: the agent parked it`);
+        tell(ctx, item, 'the agent parked it');
+        notice(ctx, 'item parked', `${item.name}: parked by its agent — the reason is in the item's history`);
         drop(state, item, budget);
         return;
     }
     if (awaitIfPaused(ctx, item))
         return;
+    // Before the phase: a relaunch that never started would otherwise push and open
+    // the pull request as if it had finished (codex-preset-removed-flag/AC-9).
+    const launch = launchFailure(ctx, item);
+    if (launch !== null) {
+        park(ctx, io, state, item, launch, budget);
+        return;
+    }
     const phase = currentPhase(ctx, item);
     if (phase !== 'deployment') {
         park(ctx, io, state, item, `agent exited before the release boundary (phase ${phase ?? 'unknown'})`, budget);
         return;
     }
-    openPullRequest(ctx, io, item);
+    openPullRequest(ctx, io, state, item);
 }
 /**
  * The pass after `aidlc autopilot approve`: wait again at the next completed pause,
@@ -228,7 +304,7 @@ function advanceApproved(ctx, io, state, item) {
         return;
     if (currentPhase(ctx, item) === 'deployment') {
         item.step = 'building';
-        openPullRequest(ctx, io, item);
+        openPullRequest(ctx, io, state, item);
         return;
     }
     // A relaunch is a build like any other: it waits for a slot, ahead of new items,
@@ -236,26 +312,26 @@ function advanceApproved(ctx, io, state, item) {
     if (building(state) >= buildSlots(ctx))
         return;
     item.step = 'building';
-    ctx.say(`${item.name}: approved — relaunching the agent to carry on`);
+    tell(ctx, item, 'approved — relaunching the agent to carry on');
     launchAgent(ctx, item, agentPrompt(item, itemPauses(item)));
 }
-function openPullRequest(ctx, io, item) {
+function openPullRequest(ctx, io, state, item) {
     const push = io.call('git', ['push', '-u', 'origin', item.branch], { cwd: item.worktree });
     if (push.status !== 0) {
-        failItem(item, `push failed: ${fail(push)}`, 'building');
+        failItem(ctx, state, item, `push failed: ${fail(push)}`, 'building');
         return;
     }
     if (!item.pr) {
         const pr = io.call('gh', ['pr', 'create', '--base', 'main', '--head', item.branch, '--fill'], { cwd: item.worktree });
         const n = /\/pull\/(\d+)/.exec(pr.stdout)?.[1];
         if (pr.status !== 0 || (!n && !pr.dry)) {
-            failItem(item, `pr create failed: ${fail(pr)}`, 'building');
+            failItem(ctx, state, item, `pr create failed: ${fail(pr)}`, 'building');
             return;
         }
         item.pr = n ? Number(n) : null;
     }
     item.step = 'pr-open';
-    ctx.say(`${item.name}: pull request #${item.pr} open`);
+    tell(ctx, item, `pull request #${item.pr} open`);
 }
 /** `gh pr view`, or null when it cannot be read. Read-only, so a dry run makes it too. */
 function prView(ctx, io, item) {
@@ -277,7 +353,7 @@ function prView(ctx, io, item) {
 function droppedIfMerged(ctx, state, item, view, budget) {
     if (view?.state !== 'MERGED')
         return false;
-    ctx.say(`${item.name}: pull request #${item.pr} was merged outside autopilot — no longer tracked`);
+    tell(ctx, item, `pull request #${item.pr} was merged outside autopilot — no longer tracked`);
     drop(state, item, budget);
     return true;
 }
@@ -292,7 +368,7 @@ function answeredByPerson(ctx, io, state, item, view, budget) {
         return true;
     }
     if (view?.state === 'CLOSED') {
-        ctx.say(`${item.name}: pull request #${item.pr} was closed without merging — no longer tracked`);
+        tell(ctx, item, `pull request #${item.pr} was closed without merging — no longer tracked`);
         drop(state, item, budget);
         return true;
     }
@@ -307,31 +383,35 @@ function closeOut(ctx, io, state, item, budget) {
     if (branch.stdout.trim() !== 'main' && !ctx.dryRun) {
         // The merge is done; trying again next pass loses nothing, and an `error` here
         // could only be cleared by `forget`, which skips the close-out altogether.
-        ctx.say(`${item.name}: merged — closing it out waits for the primary checkout to be on main (it is on ${branch.stdout.trim()})`);
+        tell(ctx, item, `merged — closing it out waits for the primary checkout to be on main (it is on ${branch.stdout.trim()})`);
         return;
     }
     const pull = io.call('git', ['pull', '--rebase', '--autostash'], { cwd: ctx.repo });
     if (pull.status !== 0) {
-        failItem(item, `pull failed: ${fail(pull)}`);
-        ctx.say(`${item.name}: ${item.error}`);
+        const error = `pull failed: ${fail(pull)}`;
+        failItem(ctx, state, item, error);
+        tell(ctx, item, error);
         return;
     }
     // Closed by hand already: nothing to transition, and a second close-out commit
     // would fail on an empty index (autopilot-stop-controls/AC-22).
     if (COMPLETE_RE.test(ctx.fs.read(`${ctx.repo}/.aidlc/state/${item.name}/phase-deployment.yaml`) ?? '')) {
-        ctx.say(`${item.name}: pull request #${item.pr} merged, and already closed on main — no longer tracked`);
+        tell(ctx, item, `pull request #${item.pr} merged, and already closed on main — no longer tracked`);
+        notice(ctx, 'item closed', `${item.name}: pull request #${item.pr} merged, and already closed on main`);
         drop(state, item, budget);
         return;
     }
     for (const [label, step] of closeSteps(ctx, io, item)) {
         const r = step();
         if (r.status !== 0) {
-            failItem(item, `${label} failed: ${fail(r)}`);
-            ctx.say(`${item.name}: ${item.error}`);
+            const error = `${label} failed: ${fail(r)}`;
+            failItem(ctx, state, item, error);
+            tell(ctx, item, error);
             return;
         }
     }
-    ctx.say(`${item.name}: pull request #${item.pr} merged by you, and closed`);
+    tell(ctx, item, `pull request #${item.pr} merged by you, and closed`);
+    notice(ctx, 'item closed', `${item.name}: pull request #${item.pr} merged by you, and closed`);
     drop(state, item, budget);
 }
 /** Close the instance on main. Shared by both close-outs so they cannot drift. */
@@ -368,7 +448,7 @@ function handleConflict(ctx, io, state, item, budget) {
     item.conflict_fixes = tries + 1;
     dequeue(state, item);
     item.step = 'building';
-    ctx.say(`${item.name}: conflicts with main — relaunching the agent to resolve it (attempt ${tries + 1} of ${CONFLICT_FIX_LIMIT})`);
+    tell(ctx, item, `conflicts with main — relaunching the agent to resolve it (attempt ${tries + 1} of ${CONFLICT_FIX_LIMIT})`);
     launchAgent(ctx, item, conflictPrompt(item));
 }
 /**
@@ -385,14 +465,14 @@ function upToDateWithMain(ctx, io, state, item, resume, budget) {
     const wt = { cwd: item.worktree };
     const fetch = io.call('git', ['fetch', 'origin', 'main'], wt);
     if (fetch.status !== 0) {
-        failItem(item, `update from main failed: ${fail(fetch)}`, resume);
+        failItem(ctx, state, item, `update from main failed: ${fail(fetch)}`, resume);
         return false;
     }
     const contains = io.call('git', ['merge-base', '--is-ancestor', 'origin/main', 'HEAD'], wt);
     if (contains.status === 0)
         return true;
     if (contains.status !== 1) {
-        failItem(item, `update from main failed: ${fail(contains)}`, resume);
+        failItem(ctx, state, item, `update from main failed: ${fail(contains)}`, resume);
         return false;
     }
     const merge = io.call('git', ['merge', '--no-edit', 'origin/main'], wt);
@@ -405,11 +485,11 @@ function upToDateWithMain(ctx, io, state, item, resume, budget) {
     const push = io.call('git', ['push', 'origin', item.branch], wt);
     if (push.status !== 0) {
         // The merge commit is local; the building step pushes it again on resume.
-        failItem(item, `push failed: ${fail(push)}`, 'building');
+        failItem(ctx, state, item, `push failed: ${fail(push)}`, 'building');
         return false;
     }
     item.step = 'pr-open';
-    ctx.say(`${item.name}: brought up to date with main — waiting for CI on the new head`);
+    tell(ctx, item, 'brought up to date with main — waiting for CI on the new head');
     return false;
 }
 function advancePr(ctx, io, state, item, budget) {
@@ -427,37 +507,43 @@ function advancePr(ctx, io, state, item, budget) {
         return;
     }
     if (checks.length === 0) {
+        item.ci = 'waiting';
         // GitHub runs no pull_request checks on a PR that conflicts, so "no checks
         // yet" would otherwise be waited on forever (AC-12).
         if (view?.mergeable === 'CONFLICTING') {
-            ctx.say(`${item.name}: pull request #${item.pr} conflicts with main and has no checks`);
+            tell(ctx, item, `pull request #${item.pr} conflicts with main and has no checks`);
             upToDateWithMain(ctx, io, state, item, 'pr-open', budget);
             return;
         }
-        ctx.say(`${item.name}: pull request #${item.pr} — waiting for checks to start`);
+        tell(ctx, item, `pull request #${item.pr} — waiting for checks to start`);
         return;
     }
-    if (checks.some((c) => c.bucket === 'pending'))
+    if (checks.some((c) => c.bucket === 'pending')) {
+        item.ci = 'pending';
         return;
+    }
     const failing = checks.filter((c) => c.bucket === 'fail' || c.bucket === 'cancel').map((c) => c.name);
     if (failing.length === 0) {
+        item.ci = 'passed';
         if (atPr) {
             item.step = 'awaiting-merge';
-            ctx.say(`${item.name}: CI green — pull request #${item.pr} waits for you to merge it`);
+            tell(ctx, item, `CI green — pull request #${item.pr} waits for you to merge it`);
+            notice(ctx, 'merge needed', `${item.name}: pull request #${item.pr} waits for you to merge it`);
             return;
         }
         item.step = 'queued';
         if (!state.queue.includes(item.name))
             state.queue.push(item.name);
-        ctx.say(`${item.name}: CI green, queued for merge`);
+        tell(ctx, item, 'CI green, queued for merge');
         return;
     }
+    item.ci = 'failed';
     item.ci_failures = (item.ci_failures ?? 0) + 1;
     if (item.ci_failures >= CI_FAILURE_LIMIT) {
         park(ctx, io, state, item, `CI failed twice: ${failing.join(', ')}`, budget);
         return;
     }
-    ctx.say(`${item.name}: CI failed (${failing.join(', ')}), relaunching the agent once`);
+    tell(ctx, item, `CI failed (${failing.join(', ')}), relaunching the agent once`);
     item.step = 'building';
     launchAgent(ctx, item, fixPrompt(item, failing));
 }
@@ -490,6 +576,7 @@ function serveQueue(ctx, io, state, budget) {
         return;
     }
     if (item.step === 'error') {
+        // An observation repeated every pass: the failure that halted the queue already notified.
         ctx.say(`queue halted: ${item.name} — ${item.error}`);
         return;
     }
@@ -499,7 +586,7 @@ function serveQueue(ctx, io, state, budget) {
     try {
         const status = JSON.parse(runs.stdout || '[]')[0]?.status;
         if (status === 'queued' || status === 'in_progress') {
-            ctx.say(`${item.name}: waiting — a release is already in flight`);
+            tell(ctx, item, 'waiting — a release is already in flight');
             return;
         }
     }
@@ -508,7 +595,7 @@ function serveQueue(ctx, io, state, budget) {
     }
     const branch = io.call('git', ['rev-parse', '--abbrev-ref', 'HEAD'], { cwd: ctx.repo });
     if (branch.stdout.trim() !== 'main' && !ctx.dryRun) {
-        failItem(item, `primary checkout is on ${branch.stdout.trim()}, not main`, 'queued');
+        failItem(ctx, state, item, `primary checkout is on ${branch.stdout.trim()}, not main`, 'queued');
         return;
     }
     if (!upToDateWithMain(ctx, io, state, item, 'queued', budget))
@@ -517,7 +604,7 @@ function serveQueue(ctx, io, state, budget) {
     const head = io.call('git', ['rev-parse', 'HEAD'], { cwd: item.worktree });
     const sha = head.stdout.trim();
     if ((head.status !== 0 || !/^[0-9a-f]{7,64}$/.test(sha)) && !ctx.dryRun) {
-        failItem(item, `merge failed: cannot read the branch head (${fail(head)})`, 'queued');
+        failItem(ctx, state, item, `merge failed: cannot read the branch head (${fail(head)})`, 'queued');
         return;
     }
     const release = ctx.config?.release_command;
@@ -540,12 +627,14 @@ function serveQueue(ctx, io, state, budget) {
         if (r.status !== 0) {
             // Halt. Only a failed merge resumes on the next `autopilot run`; from the
             // pull on, the merge has happened and a half-done release is for a person (AC-16).
-            failItem(item, `${label} failed: ${fail(r)}`, label === 'merge' ? 'queued' : undefined);
-            ctx.say(`${item.name}: ${item.error} — queue halted`);
+            const error = `${label} failed: ${fail(r)}`;
+            failItem(ctx, state, item, error, label === 'merge' ? 'queued' : undefined);
+            tell(ctx, item, `${error} — queue halted`);
             return;
         }
     }
-    ctx.say(`${item.name}: merged${releases ? ', released' : ''} and closed`);
+    tell(ctx, item, `merged${releases ? ', released' : ''} and closed`);
+    notice(ctx, releases ? 'item released' : 'item merged', `${item.name}: merged${releases ? ', released' : ''} and closed`);
     drop(state, item, budget);
 }
 /**
@@ -563,6 +652,7 @@ function parkUnstartable(ctx, io, file, failure) {
         return false;
     }
     ctx.say(`could not start ${file}: ${error} — parked`);
+    notice(ctx, 'item parked', `${file}: could not start: ${error}`);
     return true;
 }
 function startBuilds(ctx, io, state, budget) {
@@ -700,6 +790,7 @@ export function tick(ctx, state, budget) {
         return state;
     }
     const io = makeIO(ctx);
+    const before = stepsOf(state);
     try {
         for (const item of [...state.items]) {
             // `awaiting-review` is passed over: nothing to read until a person approves.
@@ -724,9 +815,26 @@ export function tick(ctx, state, budget) {
         state.backoff_until = new Date(ctx.now() + state.backoff_ms).toISOString();
         ctx.say(`rate limited (${err.message}) — backing off until ${state.backoff_until}`);
     }
+    markStepChanges(state, before, ctx.now());
     state.last_tick = new Date(ctx.now()).toISOString();
     return state;
 }
+/** Each item's step by name, to compare against after a change (autopilot-live-progress/AC-11). */
+export function stepsOf(state) {
+    return new Map(state.items.map((i) => [i.name, i.step]));
+}
+/**
+ * Stamp `step_since` on every item whose step differs from `before`; a new item has
+ * no entry there and is stamped too. Diffing here, rather than at each of the
+ * fourteen places a step is set, means a new handler cannot forget it.
+ */
+export function markStepChanges(state, before, now) {
+    const at = new Date(now).toISOString();
+    for (const item of state.items) {
+        if (before.get(item.name) !== item.step)
+            item.step_since = { step: item.step, at };
+    }
+}
 /** What a person is being waited on for, in words (autopilot-stop-controls/AC-14, AC-20). */
 function waitingFor(i) {
     if (i.step === 'awaiting-review') {
@@ -738,22 +846,33 @@ function waitingFor(i) {
         return ` — waiting for you to merge pull request #${i.pr}`;
     return '';
 }
+/**
+ * The driver's line, shared by `status` and the watch view.
+ *
+ * @param stopped - whether the STOP file exists.
+ * @param lastPass - how to show the last pass's time; `status` shows it as stored.
+ */
+export function driverLine(stopped, state, now, lastPass = (iso) => iso) {
+    if (stopped)
+        return 'driver: stopped (STOP file present)';
+    if (state.backoff_until && now < Date.parse(state.backoff_until))
+        return `driver: backing off until ${state.backoff_until}`;
+    return `driver: last pass ${state.last_tick ? lastPass(state.last_tick) : 'never'}`;
+}
+export function queueLine(state) {
+    return state.queue.length > 0 ? `merge queue: ${state.queue.join(' → ')}` : null;
+}
 export function statusLines(ctx, state) {
-    const lines = [];
-    if (ctx.fs.exists(ctx.paths.stop))
-        lines.push('driver: stopped (STOP file present)');
-    else if (state.backoff_until && ctx.now() < Date.parse(state.backoff_until))
-        lines.push(`driver: backing off until ${state.backoff_until}`);
-    else
-        lines.push(`driver: last pass ${state.last_tick ?? 'never'}`);
+    const lines = [driverLine(ctx.fs.exists(ctx.paths.stop), state, ctx.now())];
     if (state.items.length === 0)
         lines.push('no items in flight');
     for (const i of state.items) {
         lines.push(`${i.name}: ${i.step}${i.pr ? ` PR #${i.pr}` : ''} — CI failures ${i.ci_failures ?? 0}` +
             `${waitingFor(i)}${i.error ? ` — last error: ${i.error}` : ''}`);
     }
-    if (state.queue.length > 0)
-        lines.push(`merge queue: ${state.queue.join(' → ')}`);
+    const queue = queueLine(state);
+    if (queue !== null)
+        lines.push(queue);
     return lines;
 }
 //# sourceMappingURL=driver.js.map