@telora/daemon 0.22.208 → 0.22.227

package/dist/completion/team-progress-measure.js

@@ -0,0 +1,285 @@
+// PINNED-BY-BEGIN (generated by gen:pinned-by -- do not hand-edit; checked by lint:pinned-by)
+// Pinned by: packages/daemon/src/completion/team-progress-measure.test.ts,
+//   packages/daemon/src/spawn/progress-measure-wiring.test.ts,
+//   packages/daemon/src/verify/team-stall-reapers.test.ts
+// PINNED-BY-END
+/**
+ * The ONE measure of whether a focus team made progress.
+ *
+ * Every no-progress decision that can end a team reads it: the scope-coverage
+ * counter (completion/event-phases.ts, through progress-snapshot.ts), the
+ * cross-respawn delivery-advancement guard (delivery-advancement-guard.ts), the
+ * continuation budget (spawn/lead-continuation.ts) and the unproductive-handoff
+ * backstop (event-phases.ts). A cycle made progress when ANY of these moved since
+ * the previous one:
+ *
+ *   - a delivery execution_status (or the delivery set);
+ *   - the issue fingerprint ({issueId -> status});
+ *   - the focus worktree HEAD (a commit);
+ *   - the team's agent activity (TeamActivityMarks.agentActivitySeq);
+ *   - the worktree's uncommitted diff (TeamActivityMarks.worktreeDiffFingerprint).
+ *
+ * WHY the last two (2026-09-24, "A ruling reaches the gate it rules on"): the
+ * lead parked while its background workers edited, the daemon re-woke it every
+ * ~20s, and each wake returned in seconds as a completion cycle. The watchdogs
+ * counted only status, issues and HEAD, so uncommitted edits and live workers
+ * read as zero progress and the team was killed as team_failure ~3 minutes in,
+ * with the log reading "last agent event ~0m ago".
+ *
+ * WHICH agent events count. Worker events always count: a background agent's
+ * `system/task_*` events (keyed by a task the lead started with a backgrounded
+ * or agent task type) and a teammate's subagent_activity. The lead's own events
+ * count only on a turn the daemon did NOT start by re-waking it (a mid-focus
+ * handoff, a re-engagement, a continuation turn -- noteDaemonPoke), and never on
+ * its kickoff turn. A lead that answers each re-wake with a few tool calls and
+ * changes nothing is exactly the team the no-progress guards exist to end, so its
+ * replies to the daemon are not activity; whatever such a reply CHANGES is still
+ * seen by the diff, HEAD, issue and status axes. A heartbeat (one long tool call
+ * still running) counts only while the team has a worker that is live when it
+ * arrives: it is then the signal that keeps the worker live, and liveness and
+ * progress must not disagree -- a worker the daemon waits on is never reaped as
+ * still (TEL-8). A heartbeat with no live worker -- none started, or one that
+ * went quiet -- is the lead's own call: never progress, and it does not revive
+ * a quiet worker (TEL-9), or a lead's heartbeats would keep an idle team alive.
+ *
+ * The activity counter is per FOCUS, not per team, so it survives a respawn and
+ * the cross-respawn guard can compare it; a fresh counter after a daemon restart
+ * reads as one moved cycle against a hydrated prior, which errs toward patience
+ * once and never toward a kill.
+ *
+ * @module completion/team-progress-measure
+ */
+import { createHash } from 'node:crypto';
+import { lstatSync, readFileSync, readlinkSync } from 'node:fs';
+import { join } from 'node:path';
+import { runGitSync } from '../git/types.js';
+/**
+ * Stable, key-order-independent fingerprint of the work-issue state. Sorting by
+ * issue id makes it depend only on the set of issues and their statuses, so a
+ * fetch that returns issues in a different order does not manufacture progress.
+ */
+export function computeIssueFingerprint(issues) {
+    return issues.map(i => `${i.id}:${i.status ?? ''}`).sort().join('|');
+}
+function statusesEqual(a, b) {
+    const aKeys = Object.keys(a);
+    if (aKeys.length !== Object.keys(b).length)
+        return false;
+    return aKeys.every(key => Object.prototype.hasOwnProperty.call(b, key) && a[key] === b[key]);
+}
+/** True when the team's activity moved between two readings (either unreadable axis is not compared). */
+export function teamActivityMoved(prior, current) {
+    if (!prior || !current)
+        return false;
+    if (prior.agentActivitySeq !== current.agentActivitySeq)
+        return true;
+    return prior.worktreeDiffFingerprint !== null
+        && current.worktreeDiffFingerprint !== null
+        && prior.worktreeDiffFingerprint !== current.worktreeDiffFingerprint;
+}
+/** THE measure: true when any axis moved between two readings (module doc). */
+export function teamProgressMoved(prior, current) {
+    if (!statusesEqual(prior.deliveryStatuses, current.deliveryStatuses))
+        return true;
+    if (prior.focusHeadSha !== current.focusHeadSha)
+        return true;
+    if (prior.issueFingerprint !== undefined && current.issueFingerprint !== undefined
+        && prior.issueFingerprint !== current.issueFingerprint)
+        return true;
+    return teamActivityMoved(prior.activity, current.activity);
+}
+const activityByFocus = new Map();
+function focusActivity(focusId) {
+    let entry = activityByFocus.get(focusId);
+    if (!entry) {
+        entry = { seq: 0, liveWorkerTasks: new Set(), lastWorkerEventAt: null };
+        activityByFocus.set(focusId, entry);
+    }
+    return entry;
+}
+/** The focus's activity count now (0 before any activity). */
+export function readTeamActivitySeq(focusId) {
+    return activityByFocus.get(focusId)?.seq ?? 0;
+}
+/** Count one unit of team activity for the focus. */
+export function recordTeamProgressActivity(focusId) {
+    focusActivity(focusId).seq += 1;
+}
+function recordWorkerEvent(focusId, nowMs, countsAsProgress) {
+    const entry = focusActivity(focusId);
+    entry.lastWorkerEventAt = nowMs;
+    if (countsAsProgress)
+        entry.seq += 1;
+}
+/**
+ * The daemon is about to re-wake the lead (handoff, re-engagement, continuation).
+ * The lead's events until its next result are its reply to the daemon, not
+ * activity of its own (module doc).
+ */
+export function noteDaemonPoke(teamState, nowMs = Date.now()) {
+    teamState.lastDaemonPokeAt = nowMs;
+}
+/** True while the lead's current turn is its kickoff or a reply to a daemon re-wake. */
+export function leadTurnIsDaemonStarted(teamState) {
+    if (teamState.lastLeadResultAt == null)
+        return true;
+    return teamState.lastDaemonPokeAt != null && teamState.lastDaemonPokeAt >= teamState.lastLeadResultAt;
+}
+/** Classify one neutral event from the team's stream (module doc). */
+export function noteTeamAgentEvent(teamState, focusId, event, nowMs = Date.now()) {
+    switch (event.kind) {
+        case 'result':
+            teamState.lastLeadResultAt = nowMs;
+            return;
+        case 'heartbeat':
+            // A long call still running. While a worker is live AT THE HEARTBEAT, the
+            // heartbeat is what keeps it live (teamWorkersLive), and a worker the
+            // daemon holds its wakes for is a working team: the same signal is
+            // progress. Otherwise -- no worker, or one that went quiet -- it is the
+            // lead's own call: it neither counts nor revives a quiet worker (TEL-9).
+            if (event.parentToolUseId && teamWorkersLive(focusId, nowMs))
+                recordWorkerEvent(focusId, nowMs, true);
+            return;
+        case 'subagent_activity': {
+            const entry = focusActivity(focusId);
+            if (event.phase === 'completed')
+                entry.liveWorkerTasks.delete(event.agentId);
+            else
+                entry.liveWorkerTasks.add(event.agentId);
+            recordWorkerEvent(focusId, nowMs, true);
+            return;
+        }
+        default:
+            if (!leadTurnIsDaemonStarted(teamState))
+                recordTeamProgressActivity(focusId);
+    }
+}
+/** Task types whose task is a worker running beside the lead rather than one of the lead's own calls. */
+function isWorkerTask(raw) {
+    return raw['is_backgrounded'] === true || raw['task_type'] === 'local_agent' || raw['task_type'] === 'remote_agent';
+}
+const ENDED_TASK_STATUSES = new Set(['completed', 'failed', 'stopped', 'killed', 'cancelled']);
+/**
+ * Classify one raw engine event. Background workers surface in the Claude
+ * stream only as `system/task_*` events (their tool calls are not attributed),
+ * so they are read here, off the raw channel, keyed by the task id the
+ * task_started event declared a worker.
+ */
+export function noteTeamRawEvent(focusId, raw, nowMs = Date.now()) {
+    if (raw === null || typeof raw !== 'object')
+        return;
+    const event = raw;
+    if (event['type'] !== 'system')
+        return;
+    const subtype = event['subtype'];
+    const taskId = event['task_id'];
+    if (typeof subtype !== 'string' || typeof taskId !== 'string')
+        return;
+    const entry = focusActivity(focusId);
+    if (subtype === 'task_started') {
+        if (!isWorkerTask(event))
+            return;
+        entry.liveWorkerTasks.add(taskId);
+        recordWorkerEvent(focusId, nowMs, true);
+        return;
+    }
+    // task_updated carries its changes in a patch: a call the lead moved to the
+    // background becomes a worker there.
+    const patch = subtype === 'task_updated' && event['patch'] !== null && typeof event['patch'] === 'object'
+        ? event['patch']
+        : null;
+    if (patch?.['is_backgrounded'] === true)
+        entry.liveWorkerTasks.add(taskId);
+    if (!entry.liveWorkerTasks.has(taskId))
+        return;
+    const status = patch ? patch['status'] : subtype === 'task_notification' ? event['status'] : undefined;
+    if (typeof status === 'string' && ENDED_TASK_STATUSES.has(status))
+        entry.liveWorkerTasks.delete(taskId);
+    recordWorkerEvent(focusId, nowMs, true);
+}
+/**
+ * How long a started worker may go without a single event before it is treated
+ * as quiet. A worker inside one long tool call still heartbeats (~30s), so this
+ * only lapses for a worker that has genuinely stopped reporting.
+ */
+export const WORKER_QUIET_MS = 5 * 60_000;
+/** True while the team has a started worker that has not ended and is still reporting. */
+export function teamWorkersLive(focusId, nowMs = Date.now()) {
+    const entry = activityByFocus.get(focusId);
+    if (!entry || entry.liveWorkerTasks.size === 0 || entry.lastWorkerEventAt === null)
+        return false;
+    return nowMs - entry.lastWorkerEventAt < WORKER_QUIET_MS;
+}
+/** Ms until a live team's workers would go quiet if they stopped reporting now; null when none are live. */
+export function teamWorkersQuietInMs(focusId, nowMs = Date.now()) {
+    if (!teamWorkersLive(focusId, nowMs))
+        return null;
+    const last = activityByFocus.get(focusId)?.lastWorkerEventAt ?? nowMs;
+    return Math.max(1, last + WORKER_QUIET_MS - nowMs);
+}
+/** How many started workers have not ended (0 when none). */
+export function liveWorkerCount(focusId) {
+    return activityByFocus.get(focusId)?.liveWorkerTasks.size ?? 0;
+}
+/**
+ * A new team starts with no live workers of its own: a background worker does
+ * not survive the session that spawned it. The activity COUNT is kept (module doc).
+ */
+export function resetTeamWorkers(focusId) {
+    const entry = activityByFocus.get(focusId);
+    if (!entry)
+        return;
+    entry.liveWorkerTasks.clear();
+    entry.lastWorkerEventAt = null;
+}
+/** Test-only: forget every focus. */
+export function __resetTeamProgressMeasureForTesting() {
+    activityByFocus.clear();
+}
+/** Content of one worktree path for the fingerprint: its bytes, a symlink's target, or its absence. */
+function worktreePathContent(absPath) {
+    try {
+        const st = lstatSync(absPath);
+        if (st.isSymbolicLink())
+            return `symlink:${readlinkSync(absPath)}`;
+        if (!st.isFile())
+            return `kind:${st.isDirectory() ? 'dir' : 'other'}`;
+        return readFileSync(absPath);
+    }
+    catch {
+        return 'absent'; // deleted in the worktree
+    }
+}
+/**
+ * Fingerprint of the worktree's uncommitted CONTENT: the bytes of every path
+ * that differs from HEAD or is untracked (its absence, for a deletion), plus the
+ * staged index entries (`git diff --cached --raw`: the index blob of each staged
+ * change), so a staged-only change moves it too. Content, not metadata: two
+ * different edits of the same size under the same mtime still move it. Reads
+ * only the changed files -- cheap enough for every completion. Null when git
+ * cannot be read, which the measure does not compare.
+ */
+export function readWorktreeDiffFingerprint(worktreePath, run = runGitSync) {
+    const changed = run(['diff', 'HEAD', '--name-only', '-z'], worktreePath);
+    const untracked = run(['ls-files', '--others', '--exclude-standard', '-z'], worktreePath);
+    const staged = run(['diff', '--cached', '--raw', '-z', '--no-abbrev'], worktreePath);
+    if (!changed.success || !untracked.success || !staged.success)
+        return null;
+    const paths = [...new Set(`${changed.output}\0${untracked.output}`.split('\0').filter(p => p.length > 0))].sort();
+    const hash = createHash('sha1');
+    hash.update(`staged\0${staged.output}\n`);
+    for (const path of paths) {
+        hash.update(`${path}\0`);
+        hash.update(worktreePathContent(join(worktreePath, path)));
+        hash.update('\n');
+    }
+    return hash.digest('hex');
+}
+/** The focus's two activity axes, read now. */
+export function readTeamActivityMarks(focusId, worktreePath, readDiff = readWorktreeDiffFingerprint) {
+    return {
+        agentActivitySeq: readTeamActivitySeq(focusId),
+        worktreeDiffFingerprint: worktreePath ? readDiff(worktreePath) : null,
+    };
+}
+//# sourceMappingURL=team-progress-measure.js.map

package/dist/completion/team-progress-measure.js.map

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

package/dist/completion/team-stillness.d.ts

@@ -0,0 +1,76 @@
+/**
+ * How long a focus team has been STILL, by the one progress measure -- the
+ * reading the completion-event-independent reapers act on.
+ *
+ * The stalled-team backstop (verify/stalled-team-backstop.ts) and the blind
+ * idle-team timer (verify/stall-detectors.ts checkIdleTeamStallForFocus) exist
+ * for teams whose completion event never fires, so they cannot read the
+ * completion path's per-cycle snapshot. They used to read only the raw
+ * last-agent-event clock, which moves on EVERY event -- a lead's reply to a
+ * daemon re-wake and a heartbeat included, both of which the measure says are
+ * not progress -- and which cannot see a moving diff, HEAD, issue or status.
+ * They now read this module instead: the per-focus cascade pass takes a reading
+ * of the measure's axes for every focus with a live team on each poll
+ * (observeLiveTeamProgress -- its ONE writer; the agent-activity axis is the
+ * measure's FILTERED count, not the raw clock), and readTeamLastProgressAt
+ * answers when any axis last moved.
+ *
+ * Two answers are withheld (null: "not stalled -- do not reap"):
+ *   - a team that has produced no event yet (still initializing), exactly as
+ *     the raw clock read;
+ *   - a team whose latest reading could not read a required axis (the issue
+ *     list, or HEAD / the diff of a registered worktree). Stillness is only
+ *     established by a reading that saw every axis; an unreadable one proves
+ *     neither movement nor stillness, so it authorizes no reap, and the first
+ *     readable reading after it starts a fresh window.
+ *
+ * In memory, per daemon process: after a restart the first reading is a
+ * baseline (it counts as movement), which errs toward patience once and never
+ * toward a reap.
+ *
+ * @module completion/team-stillness
+ */
+import type { FocusDeliveryInfo, FocusIssueInfo, TeamProgressAxes } from '../types/index.js';
+/** A reading of the measure's axes, and whether every required axis was read. */
+export interface ProgressReading {
+    axes: TeamProgressAxes;
+    readable: boolean;
+}
+/**
+ * The measure's axes for a focus now, read from its registered worktree. HEAD
+ * and the diff are required when a worktree is registered: either unreadable
+ * makes the reading unreadable.
+ */
+export declare function readFocusProgress(focusId: string, deliveries: Pick<FocusDeliveryInfo, 'id' | 'executionStatus'>[], issues: Pick<FocusIssueInfo, 'id' | 'status'>[]): ProgressReading;
+/**
+ * Record a reading of the measure for a focus. A readable reading stamps
+ * `nowMs` as the last movement when it is the first, the first after an
+ * unreadable one (a fresh window), or when any axis moved since the last
+ * readable one. An unreadable reading changes no movement
+ * instant; it only marks the latest reading unreadable.
+ */
+export declare function observeTeamProgress(focusId: string, reading: ProgressReading, nowMs: number): void;
+/**
+ * When the team last showed progress by the ONE measure, for the reapers.
+ * Null -- never stalled -- while the team has produced no event yet, before its
+ * first reading, or while its latest reading was unreadable.
+ */
+export declare function readTeamLastProgressAt(focusId: string): number | null;
+/** What a cascade-pass reading needs; defaults are production, tests inject. */
+export interface ObserveLiveTeamDeps {
+    isTeamLive: (focusId: string) => boolean;
+    getFocusIssues: (focusId: string) => Promise<Pick<FocusIssueInfo, 'id' | 'status'>[]>;
+    readProgress: typeof readFocusProgress;
+    now: () => number;
+}
+/**
+ * The cascade pass's reading (the ONE writer): for a focus with a live team,
+ * read the measure's axes and record them; for a focus without one, forget its
+ * readings. An unreadable issue list is an unreadable reading (fail closed).
+ */
+export declare function observeLiveTeamProgress(focusId: string, deliveries: Pick<FocusDeliveryInfo, 'id' | 'executionStatus'>[], deps?: Partial<ObserveLiveTeamDeps>): Promise<void>;
+/** Forget a focus's readings (its team is gone; the next team starts a new baseline). */
+export declare function forgetTeamProgress(focusId: string): void;
+/** Test-only: forget every focus. */
+export declare function __resetTeamStillnessForTesting(): void;
+//# sourceMappingURL=team-stillness.d.ts.map

package/dist/completion/team-stillness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"team-stillness.d.ts","sourceRoot":"","sources":["../../src/completion/team-stillness.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAkB7F,iFAAiF;AACjF,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,gBAAgB,CAAC;IACvB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,IAAI,CAAC,iBAAiB,EAAE,IAAI,GAAG,iBAAiB,CAAC,EAAE,EAC/D,MAAM,EAAE,IAAI,CAAC,cAAc,EAAE,IAAI,GAAG,QAAQ,CAAC,EAAE,GAC9C,eAAe,CAQjB;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAWlG;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAKrE;AAED,gFAAgF;AAChF,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC;IACzC,cAAc,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,cAAc,EAAE,IAAI,GAAG,QAAQ,CAAC,EAAE,CAAC,CAAC;IACtF,YAAY,EAAE,OAAO,iBAAiB,CAAC;IACvC,GAAG,EAAE,MAAM,MAAM,CAAC;CACnB;AASD;;;;GAIG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,IAAI,CAAC,iBAAiB,EAAE,IAAI,GAAG,iBAAiB,CAAC,EAAE,EAC/D,IAAI,GAAE,OAAO,CAAC,mBAAmB,CAAM,GACtC,OAAO,CAAC,IAAI,CAAC,CAef;AAED,yFAAyF;AACzF,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAExD;AAED,qCAAqC;AACrC,wBAAgB,8BAA8B,IAAI,IAAI,CAErD"}

package/dist/completion/team-stillness.js

@@ -0,0 +1,96 @@
+// PINNED-BY-BEGIN (generated by gen:pinned-by -- do not hand-edit; checked by lint:pinned-by)
+// Pinned by: packages/daemon/src/verify/stall-detectors-clock-wiring.test.ts,
+//   packages/daemon/src/verify/team-stall-reapers.test.ts
+// PINNED-BY-END
+import { getFocusWorktree } from '../focus/focus-worktree-state.js';
+import { getActiveTeams, getTeamLastActivityAt } from '../focus/focus-team-state.js';
+import { getFocusIssues } from '../queries/focuses.js';
+import { readWorktreeHeadSha } from '../git/index.js';
+import { takeDeliveryAdvancementSnapshot } from './delivery-advancement-guard.js';
+import { readTeamActivityMarks, teamProgressMoved } from './team-progress-measure.js';
+const observations = new Map();
+/**
+ * The measure's axes for a focus now, read from its registered worktree. HEAD
+ * and the diff are required when a worktree is registered: either unreadable
+ * makes the reading unreadable.
+ */
+export function readFocusProgress(focusId, deliveries, issues) {
+    const worktreePath = getFocusWorktree(focusId)?.worktreePath ?? null;
+    const head = worktreePath ? readWorktreeHeadSha(worktreePath) : null;
+    const activity = readTeamActivityMarks(focusId, worktreePath);
+    return {
+        axes: takeDeliveryAdvancementSnapshot(deliveries, issues, head, activity),
+        readable: worktreePath === null || (head !== null && activity.worktreeDiffFingerprint !== null),
+    };
+}
+/**
+ * Record a reading of the measure for a focus. A readable reading stamps
+ * `nowMs` as the last movement when it is the first, the first after an
+ * unreadable one (a fresh window), or when any axis moved since the last
+ * readable one. An unreadable reading changes no movement
+ * instant; it only marks the latest reading unreadable.
+ */
+export function observeTeamProgress(focusId, reading, nowMs) {
+    const prior = observations.get(focusId);
+    if (!reading.readable) {
+        if (prior)
+            prior.readable = false;
+        else
+            observations.set(focusId, { axes: reading.axes, movedAt: nowMs, readable: false });
+        return;
+    }
+    // A reading after an unreadable one is a fresh baseline: the blind interval
+    // proved nothing, so it must not count toward a stall window (TEL-8).
+    const movedAt = !prior || !prior.readable || teamProgressMoved(prior.axes, reading.axes) ? nowMs : prior.movedAt;
+    observations.set(focusId, { axes: reading.axes, movedAt, readable: true });
+}
+/**
+ * When the team last showed progress by the ONE measure, for the reapers.
+ * Null -- never stalled -- while the team has produced no event yet, before its
+ * first reading, or while its latest reading was unreadable.
+ */
+export function readTeamLastProgressAt(focusId) {
+    if (getTeamLastActivityAt(focusId) === null)
+        return null;
+    const observation = observations.get(focusId);
+    if (!observation || !observation.readable)
+        return null;
+    return observation.movedAt;
+}
+const defaultObserveDeps = {
+    isTeamLive: (focusId) => getActiveTeams().has(focusId),
+    getFocusIssues,
+    readProgress: readFocusProgress,
+    now: () => Date.now(),
+};
+/**
+ * The cascade pass's reading (the ONE writer): for a focus with a live team,
+ * read the measure's axes and record them; for a focus without one, forget its
+ * readings. An unreadable issue list is an unreadable reading (fail closed).
+ */
+export async function observeLiveTeamProgress(focusId, deliveries, deps = {}) {
+    const d = { ...defaultObserveDeps, ...deps };
+    if (!d.isTeamLive(focusId)) {
+        forgetTeamProgress(focusId);
+        return;
+    }
+    let issues;
+    try {
+        issues = await d.getFocusIssues(focusId);
+    }
+    catch {
+        const prior = observations.get(focusId);
+        observeTeamProgress(focusId, { axes: prior?.axes ?? { deliveryStatuses: {}, focusHeadSha: null }, readable: false }, d.now());
+        return;
+    }
+    observeTeamProgress(focusId, d.readProgress(focusId, deliveries, issues), d.now());
+}
+/** Forget a focus's readings (its team is gone; the next team starts a new baseline). */
+export function forgetTeamProgress(focusId) {
+    observations.delete(focusId);
+}
+/** Test-only: forget every focus. */
+export function __resetTeamStillnessForTesting() {
+    observations.clear();
+}
+//# sourceMappingURL=team-stillness.js.map

package/dist/completion/team-stillness.js.map

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

package/dist/completion/worker-wait.d.ts

@@ -0,0 +1,84 @@
+/**
+ * A lead waiting on its workers is left to wait.
+ *
+ * On 2026-09-24 ("A ruling reaches the gate it rules on") a lead handed its
+ * edits to background workers and ended its turn while they ran. The daemon
+ * re-woke it with a mid-focus handoff every ~20s; each wake returned in seconds
+ * and was counted as an empty completion cycle, until the team was killed as a
+ * team_failure with its workers still editing. The daemon's own pokes were the
+ * cycles.
+ *
+ * So while the team's workers are live (completion/team-progress-measure.ts
+ * teamWorkersLive: a started worker that has not ended and is still reporting),
+ * the daemon sends the lead no handoff, no re-engagement and no continuation
+ * turn. The lead is next woken by:
+ *   - its workers' completion -- the engine itself resumes the lead on a
+ *     worker's task notification, and that turn's result is an ordinary cycle;
+ *   - genuinely new work: a delivery the team has not been shown, or an issue
+ *     that appeared since the team was last handed its work;
+ *   - the normal handoff path once the workers go quiet (WORKER_QUIET_MS with no
+ *     event) -- a re-check is scheduled for exactly then.
+ * A lead whose workers have all finished is re-engaged as before, and a team
+ * with no events at all is still reaped by the stalled-team backstop.
+ *
+ * The wait is logged ONCE per park episode (teamState.waitingOnWorkersSince).
+ *
+ * @module completion/worker-wait
+ */
+import type { FocusDeliveryInfo, FocusIssueInfo, FocusTeamState } from '../types/index.js';
+type WaitState = Pick<FocusTeamState, 'waitingOnWorkersSince' | 'shownIssueIds'>;
+/**
+ * Record the issues the lead has now been handed (at every wake actually sent),
+ * so an issue that appears later is recognisably new.
+ */
+export declare function recordIssuesShown(teamState: WaitState, issues: Pick<FocusIssueInfo, 'id'>[]): void;
+/** True when an issue exists that the lead has not been handed (none, before any record). */
+export declare function hasUnshownIssue(teamState: WaitState, issues: Pick<FocusIssueInfo, 'id'>[]): boolean;
+/**
+ * Genuinely new work for a lead waiting on its workers: an agent-actionable
+ * delivery the team has never been told about, or an issue on a delivery the
+ * running arm owes that the lead has not been handed. Work RECORDED as new
+ * intent under the arm is invisible to the team and wakes nothing.
+ */
+export declare function hasUnshownWork(teamState: FocusTeamState, deliveries: FocusDeliveryInfo[], issues: Pick<FocusIssueInfo, 'id' | 'deliveryId'>[]): boolean;
+/**
+ * While the lead waits on live workers, what the waiting re-check does next:
+ * a number is "still waiting -- check again in that many ms" (no completion
+ * cycle, no wake); null is "re-drive the completion decision now", because the
+ * workers are done or quiet, or because work the lead has not been shown has
+ * ARRIVED -- that arrival is itself the trigger, not the next unrelated event.
+ */
+export declare function nextWorkerWaitCheck(args: {
+    teamState: FocusTeamState;
+    focusId: string;
+    quietInMs: number | null;
+    readWork: () => Promise<{
+        deliveries: FocusDeliveryInfo[];
+        issues: FocusIssueInfo[];
+    }>;
+}): Promise<number | null>;
+/**
+ * How often a waiting lead's focus is re-read for newly arrived work -- the
+ * daemon's own poll cadence, so new work reaches a waiting lead no later than
+ * it would reach an idle one.
+ */
+export declare const WORKER_WAIT_RECHECK_MS = 30000;
+/**
+ * Decide whether to HOLD a wake to the lead because its workers are live.
+ * Returns true to hold (send nothing). Logs once per park episode, and ends the
+ * episode (so the next one logs again) whenever a wake is let through.
+ */
+export declare function holdWakeForLiveWorkers(args: {
+    teamState: WaitState;
+    focusId: string;
+    focusName: string;
+    nowMs: number;
+    workersLive: boolean;
+    /** Genuinely new work the lead has not been shown (a delivery or an issue). */
+    hasUnshownWork: boolean;
+    issues: Pick<FocusIssueInfo, 'id'>[];
+    /** What the held wake would have been, for the log line. */
+    wakeKind: string;
+}): boolean;
+export {};
+//# sourceMappingURL=worker-wait.d.ts.map

package/dist/completion/worker-wait.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-wait.d.ts","sourceRoot":"","sources":["../../src/completion/worker-wait.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAQ3F,KAAK,SAAS,GAAG,IAAI,CAAC,cAAc,EAAE,uBAAuB,GAAG,eAAe,CAAC,CAAC;AAEjF;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,cAAc,EAAE,IAAI,CAAC,EAAE,GAAG,IAAI,CAElG;AAED,6FAA6F;AAC7F,wBAAgB,eAAe,CAAC,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,cAAc,EAAE,IAAI,CAAC,EAAE,GAAG,OAAO,CAGnG;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,SAAS,EAAE,cAAc,EACzB,UAAU,EAAE,iBAAiB,EAAE,EAC/B,MAAM,EAAE,IAAI,CAAC,cAAc,EAAE,IAAI,GAAG,YAAY,CAAC,EAAE,GAClD,OAAO,CAOT;AAED;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,EAAE;IAC9C,SAAS,EAAE,cAAc,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,EAAE,MAAM,OAAO,CAAC;QAAE,UAAU,EAAE,iBAAiB,EAAE,CAAC;QAAC,MAAM,EAAE,cAAc,EAAE,CAAA;KAAE,CAAC,CAAC;CACxF,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAWzB;AAED;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,QAAS,CAAC;AAE7C;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE;IAC3C,SAAS,EAAE,SAAS,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,OAAO,CAAC;IACrB,+EAA+E;IAC/E,cAAc,EAAE,OAAO,CAAC;IACxB,MAAM,EAAE,IAAI,CAAC,cAAc,EAAE,IAAI,CAAC,EAAE,CAAC;IACrC,4DAA4D;IAC5D,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,OAAO,CAuBV"}