@telora/daemon 0.22.245 → 0.22.290

package/dist/focus/focus-activity-producers.d.ts

@@ -0,0 +1,37 @@
+import { type FocusActivityClaim, type FocusActivitySources } from './focus-activity-sources.js';
+/** team_coding / team_reviewing: one claim per live team. */
+export declare function teamActivityClaims(sources: FocusActivitySources): FocusActivityClaim[];
+/** awaiting_slot: a spawn pass would start a team but every session slot is in use. */
+export declare function awaitingSlotClaims(sources: FocusActivitySources): FocusActivityClaim[];
+/** spawn_pending: a team spawn is queued and starts on the next spawn pass (dated by first sight). */
+export declare function spawnPendingClaims(sources: FocusActivitySources): FocusActivityClaim[];
+/** review_parked: the review-hold park is withholding the focus's queued review spawn. */
+export declare function reviewParkedClaims(sources: FocusActivitySources): FocusActivityClaim[];
+/**
+ * cooldown: the focus's next spawn is held by its spawn cooldown -- until the
+ * time it ends, or with no end when the respawn cycle is exhausted. `since` is
+ * the latest teardown; a hold with no teardown of its own (the provider's
+ * rate-limit window alone) is dated by first sight.
+ */
+export declare function cooldownClaims(sources: FocusActivitySources): FocusActivityClaim[];
+/** The statuses in which a delivery still owes work (a team would pick it up). */
+export declare const OWING_WORK_STATUSES: ReadonlySet<string>;
+/**
+ * idle: an armed focus the daemon is doing nothing else for, with the count of
+ * the deliveries it has READ that still owe work. The lowest precedence: every
+ * other entry wins over it. Dated by first sight of the idle entry.
+ *
+ * EVERY armed focus is claimed, so every armed focus of every product has an
+ * entry. The count comes from the latest SUCCESSFUL read of its deliveries: a
+ * read that fails after one succeeded leaves those rows standing
+ * (focus-activity-poll-facts.ts), so the count stays the last one the daemon
+ * saw. A focus whose deliveries have not been read yet -- listed by this poll,
+ * its delivery read still to come or failing since discovery -- publishes a
+ * null count: the inventory is UNKNOWN, so 0 always means a read that found
+ * nothing owed, never "not read". Dropping the focus instead would make an
+ * armed focus vanish from the record exactly when its reads fail. The unread
+ * entry is dated by its own first sight, so the first successful read starts
+ * the idle clock afresh rather than inheriting the time spent unread.
+ */
+export declare function idleClaims(sources: FocusActivitySources): FocusActivityClaim[];
+//# sourceMappingURL=focus-activity-producers.d.ts.map

package/dist/focus/focus-activity-producers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"focus-activity-producers.d.ts","sourceRoot":"","sources":["../../src/focus/focus-activity-producers.ts"],"names":[],"mappings":"AAqBA,OAAO,EAIL,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EAC1B,MAAM,6BAA6B,CAAC;AAErC,6DAA6D;AAC7D,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,oBAAoB,GAAG,kBAAkB,EAAE,CAUtF;AAED,uFAAuF;AACvF,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,oBAAoB,GAAG,kBAAkB,EAAE,CAKtF;AAED,sGAAsG;AACtG,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,oBAAoB,GAAG,kBAAkB,EAAE,CAMtF;AAED,0FAA0F;AAC1F,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,oBAAoB,GAAG,kBAAkB,EAAE,CAKtF;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,oBAAoB,GAAG,kBAAkB,EAAE,CAkBlF;AAED,kFAAkF;AAClF,eAAO,MAAM,mBAAmB,EAAE,WAAW,CAAC,MAAM,CAIlD,CAAC;AAEH;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,oBAAoB,GAAG,kBAAkB,EAAE,CAa9E"}

package/dist/focus/focus-activity-producers.js

@@ -0,0 +1,118 @@
+// PINNED-BY-BEGIN (generated by gen:pinned-by -- do not hand-edit; checked by lint:pinned-by)
+// Pinned by: packages/daemon/src/focus/focus-activity-producers.test.ts
+// PINNED-BY-END
+/**
+ * The focus activity record's team and between-sessions producers: a live
+ * coding or review team, a spawn waiting for a session slot, a queued spawn, a
+ * spawn cooldown, a parked review, and idle. (Gate entries:
+ * focus/focus-activity-record.ts; held deliveries: focus/focus-activity-held.ts.)
+ *
+ * Each producer reports FACTS WITH TIMESTAMPS -- when a wait began, when a hold
+ * ends, how many deliveries still owe work. None classifies a focus as stalled:
+ * that judgement belongs to whoever reads the record. Which entry a focus
+ * publishes when several apply is the daemon-core precedence rule, applied by
+ * the builder; which focuses may carry a between-sessions entry at all (armed
+ * ones) is the builder's admission rule too.
+ *
+ * @module focus/focus-activity-producers
+ */
+import { DELIVERY_STATUS } from '@telora/daemon-core';
+import { armedPolledFocuses, commonFields, iso, } from './focus-activity-sources.js';
+/** team_coding / team_reviewing: one claim per live team. */
+export function teamActivityClaims(sources) {
+    return sources.teams.map((team) => ({
+        focusId: team.focusId,
+        activity: {
+            ...commonFields(sources, team.focusId),
+            kind: team.sessionType === 'review' ? 'team_reviewing' : 'team_coding',
+            sessionId: team.sessionId,
+            lastAgentEventAt: team.lastAgentEventAt === null ? null : iso(team.lastAgentEventAt),
+        },
+    }));
+}
+/** awaiting_slot: a spawn pass would start a team but every session slot is in use. */
+export function awaitingSlotClaims(sources) {
+    return sources.awaitingSlot.map(({ focusId, sinceMs }) => ({
+        focusId,
+        activity: { ...commonFields(sources, focusId), kind: 'awaiting_slot', since: iso(sinceMs) },
+    }));
+}
+/** spawn_pending: a team spawn is queued and starts on the next spawn pass (dated by first sight). */
+export function spawnPendingClaims(sources) {
+    return sources.pendingSpawns.map(({ focusId, sessionType }) => ({
+        focusId,
+        activity: { ...commonFields(sources, focusId), kind: 'spawn_pending', sessionType, since: iso(sources.now) },
+        sinceKey: `${focusId}|spawn_pending|${sessionType}`,
+    }));
+}
+/** review_parked: the review-hold park is withholding the focus's queued review spawn. */
+export function reviewParkedClaims(sources) {
+    return [...sources.reviewParks].map(([focusId, park]) => ({
+        focusId,
+        activity: { ...commonFields(sources, focusId), kind: 'review_parked', reason: park.reason, since: iso(park.sinceMs) },
+    }));
+}
+/**
+ * cooldown: the focus's next spawn is held by its spawn cooldown -- until the
+ * time it ends, or with no end when the respawn cycle is exhausted. `since` is
+ * the latest teardown; a hold with no teardown of its own (the provider's
+ * rate-limit window alone) is dated by first sight.
+ */
+export function cooldownClaims(sources) {
+    const claims = [];
+    for (const { focusId } of armedPolledFocuses(sources)) {
+        const window = sources.readCooldownWindow(focusId);
+        if (!window)
+            continue;
+        claims.push({
+            focusId,
+            activity: {
+                ...commonFields(sources, focusId),
+                kind: 'cooldown',
+                until: window.untilMs === null ? null : iso(window.untilMs),
+                since: iso(window.sinceMs ?? sources.now),
+                exhausted: window.exhausted,
+            },
+            ...(window.sinceMs === null ? { sinceKey: `${focusId}|cooldown` } : {}),
+        });
+    }
+    return claims;
+}
+/** The statuses in which a delivery still owes work (a team would pick it up). */
+export const OWING_WORK_STATUSES = new Set([
+    DELIVERY_STATUS.QUEUED,
+    DELIVERY_STATUS.CODING,
+    DELIVERY_STATUS.VERIFY_FAILED,
+]);
+/**
+ * idle: an armed focus the daemon is doing nothing else for, with the count of
+ * the deliveries it has READ that still owe work. The lowest precedence: every
+ * other entry wins over it. Dated by first sight of the idle entry.
+ *
+ * EVERY armed focus is claimed, so every armed focus of every product has an
+ * entry. The count comes from the latest SUCCESSFUL read of its deliveries: a
+ * read that fails after one succeeded leaves those rows standing
+ * (focus-activity-poll-facts.ts), so the count stays the last one the daemon
+ * saw. A focus whose deliveries have not been read yet -- listed by this poll,
+ * its delivery read still to come or failing since discovery -- publishes a
+ * null count: the inventory is UNKNOWN, so 0 always means a read that found
+ * nothing owed, never "not read". Dropping the focus instead would make an
+ * armed focus vanish from the record exactly when its reads fail. The unread
+ * entry is dated by its own first sight, so the first successful read starts
+ * the idle clock afresh rather than inheriting the time spent unread.
+ */
+export function idleClaims(sources) {
+    const claims = [];
+    for (const { focusId, deliveries } of armedPolledFocuses(sources)) {
+        const owing = deliveries === null
+            ? null
+            : deliveries.filter((d) => OWING_WORK_STATUSES.has(d.executionStatus ?? '')).length;
+        claims.push({
+            focusId,
+            activity: { ...commonFields(sources, focusId), kind: 'idle', deliveriesOwingWork: owing, since: iso(sources.now) },
+            sinceKey: owing === null ? `${focusId}|idle_unread` : `${focusId}|idle`,
+        });
+    }
+    return claims;
+}
+//# sourceMappingURL=focus-activity-producers.js.map

package/dist/focus/focus-activity-producers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"focus-activity-producers.js","sourceRoot":"","sources":["../../src/focus/focus-activity-producers.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,wEAAwE;AACxE,gBAAgB;AAEhB;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EACL,kBAAkB,EAClB,YAAY,EACZ,GAAG,GAGJ,MAAM,6BAA6B,CAAC;AAErC,6DAA6D;AAC7D,MAAM,UAAU,kBAAkB,CAAC,OAA6B;IAC9D,OAAO,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAClC,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,QAAQ,EAAE;YACR,GAAG,YAAY,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC;YACtC,IAAI,EAAE,IAAI,CAAC,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,aAAa;YACtE,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,gBAAgB,EAAE,IAAI,CAAC,gBAAgB,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,gBAAgB,CAAC;SACrF;KACF,CAAC,CAAC,CAAC;AACN,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,kBAAkB,CAAC,OAA6B;IAC9D,OAAO,OAAO,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;QACzD,OAAO;QACP,QAAQ,EAAE,EAAE,GAAG,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,GAAG,CAAC,OAAO,CAAC,EAAE;KAC5F,CAAC,CAAC,CAAC;AACN,CAAC;AAED,sGAAsG;AACtG,MAAM,UAAU,kBAAkB,CAAC,OAA6B;IAC9D,OAAO,OAAO,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC,CAAC;QAC9D,OAAO;QACP,QAAQ,EAAE,EAAE,GAAG,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,WAAW,EAAE,KAAK,EAAE,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE;QAC5G,QAAQ,EAAE,GAAG,OAAO,kBAAkB,WAAW,EAAE;KACpD,CAAC,CAAC,CAAC;AACN,CAAC;AAED,0FAA0F;AAC1F,MAAM,UAAU,kBAAkB,CAAC,OAA6B;IAC9D,OAAO,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;QACxD,OAAO;QACP,QAAQ,EAAE,EAAE,GAAG,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE;KACtH,CAAC,CAAC,CAAC;AACN,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,OAA6B;IAC1D,MAAM,MAAM,GAAyB,EAAE,CAAC;IACxC,KAAK,MAAM,EAAE,OAAO,EAAE,IAAI,kBAAkB,CAAC,OAAO,CAAC,EAAE,CAAC;QACtD,MAAM,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC;QACnD,IAAI,CAAC,MAAM;YAAE,SAAS;QACtB,MAAM,CAAC,IAAI,CAAC;YACV,OAAO;YACP,QAAQ,EAAE;gBACR,GAAG,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC;gBACjC,IAAI,EAAE,UAAU;gBAChB,KAAK,EAAE,MAAM,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC;gBAC3D,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC;gBACzC,SAAS,EAAE,MAAM,CAAC,SAAS;aAC5B;YACD,GAAG,CAAC,MAAM,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,GAAG,OAAO,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACxE,CAAC,CAAC;IACL,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,kFAAkF;AAClF,MAAM,CAAC,MAAM,mBAAmB,GAAwB,IAAI,GAAG,CAAC;IAC9D,eAAe,CAAC,MAAM;IACtB,eAAe,CAAC,MAAM;IACtB,eAAe,CAAC,aAAa;CAC9B,CAAC,CAAC;AAEH;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,UAAU,CAAC,OAA6B;IACtD,MAAM,MAAM,GAAyB,EAAE,CAAC;IACxC,KAAK,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,kBAAkB,CAAC,OAAO,CAAC,EAAE,CAAC;QAClE,MAAM,KAAK,GAAG,UAAU,KAAK,IAAI;YAC/B,CAAC,CAAC,IAAI;YACN,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC,CAAC,eAAe,IAAI,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;QACtF,MAAM,CAAC,IAAI,CAAC;YACV,OAAO;YACP,QAAQ,EAAE,EAAE,GAAG,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,mBAAmB,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE;YAClH,QAAQ,EAAE,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,GAAG,OAAO,cAAc,CAAC,CAAC,CAAC,GAAG,OAAO,OAAO;SACxE,CAAC,CAAC;IACL,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/focus/focus-activity-record.d.ts

@@ -0,0 +1,58 @@
+/**
+ * The focus activity record the heartbeat publishes as `metadata.focusActivity`
+ * ({ [focusId]: FocusActivity }) -- the ONE statement of what this daemon is
+ * doing for each focus it manages. The kinds, their fields and the precedence
+ * rule are declared in `@telora/daemon-core` (focus-activity.ts); this module
+ * only BUILDS the map from in-process facts.
+ *
+ * Pull model, like the narrations map: recomputed from live in-memory state every beat,
+ * so a change surfaces within one interval and a finished gate or torn-down team
+ * drops out on its own. Nothing here is written to the database.
+ *
+ * Shape: {@link buildFocusActivityMap} runs every producer in
+ * {@link FOCUS_ACTIVITY_PRODUCERS} over the sources and keeps, per focus, the
+ * entry the daemon-core precedence rule picks (gate entries win over team and
+ * idle entries). A new kind is added as a new producer -- the builder and the
+ * heartbeat wiring do not change.
+ *
+ * Who gets an entry: a focus the daemon is DOING something for -- a live team
+ * or a gate run -- whether or not it is armed; and every ARMED focus of every
+ * product (as the latest poll read them, focus/focus-activity-poll-facts.ts),
+ * which always has at least `idle`. The between-sessions kinds (held, parked,
+ * cooldown, awaiting a slot, a pending spawn, idle) are admitted only for armed
+ * focuses, so an idle un-armed focus gets no entry.
+ *
+ * The record states facts with timestamps; it never classifies a focus as
+ * stalled. Every entry carries the spawn-teardown streak and the last-progress
+ * time, so churn is visible to whoever reads it.
+ *
+ * @module focus/focus-activity-record
+ */
+import { type FocusActivityMap } from '@telora/daemon-core';
+import { type FocusActivityClaim, type FocusActivityProducer, type FocusActivitySources } from './focus-activity-sources.js';
+/**
+ * gate_running / gate_queued, one claim per selected run with a focus. A run whose
+ * command has started is running, with the commit and timeout its registration
+ * fixed at that start (verify/gate-verdicts/gate-run-registry.ts) -- a start always
+ * names its commit. Every other run is queued on what its registration says: its
+ * focus worktree's verify interlock, naming the focus and delivery the hold
+ * judges; the daemon-wide verification serialisation, naming the run that holds
+ * the slot (running, or in its preflight) as the one ahead of it (null when none
+ * does yet); or its own preflight -- it holds its slot and is preparing the run,
+ * with nothing ahead.
+ */
+export declare function gateActivityClaims(sources: FocusActivitySources): FocusActivityClaim[];
+/** Every producer the record is built from. Order does not decide the winner; precedence does. */
+export declare const FOCUS_ACTIVITY_PRODUCERS: readonly FocusActivityProducer[];
+/** Build the per-focus map: the precedence winner among every admitted claim. Pure but for sources.firstSeen. */
+export declare function buildFocusActivityMap(sources: FocusActivitySources, producers: readonly FocusActivityProducer[]): FocusActivityMap;
+/** The record from every declared producer (FOCUS_ACTIVITY_PRODUCERS). */
+export declare function buildFocusActivityRecord(sources: FocusActivitySources): FocusActivityMap;
+/**
+ * Set `metadata.focusActivity` from the beat's sources; the key is absent when
+ * no focus has an entry. The live sources are bound at the composition root
+ * (composition/focus-activity-live-sources.ts) and reach here through the
+ * heartbeat's deps.
+ */
+export declare function applyFocusActivity(metadata: Record<string, unknown>, sources: FocusActivitySources): void;
+//# sourceMappingURL=focus-activity-record.d.ts.map

package/dist/focus/focus-activity-record.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"focus-activity-record.d.ts","sourceRoot":"","sources":["../../src/focus/focus-activity-record.ts"],"names":[],"mappings":"AAQA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,EAIL,KAAK,gBAAgB,EACtB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAGL,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EAC1B,MAAM,6BAA6B,CAAC;AAmBrC;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,oBAAoB,GAAG,kBAAkB,EAAE,CAgBtF;AAED,kGAAkG;AAClG,eAAO,MAAM,wBAAwB,EAAE,SAAS,qBAAqB,EASpE,CAAC;AAqBF,iHAAiH;AACjH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,oBAAoB,EAC7B,SAAS,EAAE,SAAS,qBAAqB,EAAE,GAC1C,gBAAgB,CAWlB;AAED,0EAA0E;AAC1E,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,oBAAoB,GAAG,gBAAgB,CAExF;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,oBAAoB,GAAG,IAAI,CAGzG"}

package/dist/focus/focus-activity-record.js

@@ -0,0 +1,138 @@
+// PINNED-BY-BEGIN (generated by gen:pinned-by -- do not hand-edit; checked by lint:pinned-by)
+// Pinned by: packages/daemon/src/focus/focus-activity-producers.test.ts,
+//   packages/daemon/src/focus/focus-activity-progress-clock.test.ts,
+//   packages/daemon/src/focus/focus-activity-record.test.ts,
+//   packages/daemon/src/focus/focus-activity-team-clock.test.ts,
+//   packages/daemon/src/verify/gate-verdicts/gate-run-activity.test.ts
+// PINNED-BY-END
+/**
+ * The focus activity record the heartbeat publishes as `metadata.focusActivity`
+ * ({ [focusId]: FocusActivity }) -- the ONE statement of what this daemon is
+ * doing for each focus it manages. The kinds, their fields and the precedence
+ * rule are declared in `@telora/daemon-core` (focus-activity.ts); this module
+ * only BUILDS the map from in-process facts.
+ *
+ * Pull model, like the narrations map: recomputed from live in-memory state every beat,
+ * so a change surfaces within one interval and a finished gate or torn-down team
+ * drops out on its own. Nothing here is written to the database.
+ *
+ * Shape: {@link buildFocusActivityMap} runs every producer in
+ * {@link FOCUS_ACTIVITY_PRODUCERS} over the sources and keeps, per focus, the
+ * entry the daemon-core precedence rule picks (gate entries win over team and
+ * idle entries). A new kind is added as a new producer -- the builder and the
+ * heartbeat wiring do not change.
+ *
+ * Who gets an entry: a focus the daemon is DOING something for -- a live team
+ * or a gate run -- whether or not it is armed; and every ARMED focus of every
+ * product (as the latest poll read them, focus/focus-activity-poll-facts.ts),
+ * which always has at least `idle`. The between-sessions kinds (held, parked,
+ * cooldown, awaiting a slot, a pending spawn, idle) are admitted only for armed
+ * focuses, so an idle un-armed focus gets no entry.
+ *
+ * The record states facts with timestamps; it never classifies a focus as
+ * stalled. Every entry carries the spawn-teardown streak and the last-progress
+ * time, so churn is visible to whoever reads it.
+ *
+ * @module focus/focus-activity-record
+ */
+import { pickFocusActivity, } from '@telora/daemon-core';
+import { commonFields, iso, } from './focus-activity-sources.js';
+import { awaitingSlotClaims, cooldownClaims, idleClaims, reviewParkedClaims, spawnPendingClaims, teamActivityClaims, } from './focus-activity-producers.js';
+import { deliveryHeldClaims } from './focus-activity-held.js';
+/** The run ahead of a queued one, by what it waits on (see gateActivityClaims). */
+function aheadOf(run, slotHolder) {
+    if (run.wait.on === 'worktree_interlock')
+        return { focusId: run.wait.aheadFocusId, deliveryId: run.wait.aheadDeliveryId };
+    if (run.wait.on === 'preflight')
+        return { focusId: null, deliveryId: null };
+    return { focusId: slotHolder?.focusId ?? null, deliveryId: slotHolder?.deliveryId ?? null };
+}
+/**
+ * gate_running / gate_queued, one claim per selected run with a focus. A run whose
+ * command has started is running, with the commit and timeout its registration
+ * fixed at that start (verify/gate-verdicts/gate-run-registry.ts) -- a start always
+ * names its commit. Every other run is queued on what its registration says: its
+ * focus worktree's verify interlock, naming the focus and delivery the hold
+ * judges; the daemon-wide verification serialisation, naming the run that holds
+ * the slot (running, or in its preflight) as the one ahead of it (null when none
+ * does yet); or its own preflight -- it holds its slot and is preparing the run,
+ * with nothing ahead.
+ */
+export function gateActivityClaims(sources) {
+    const slotHolder = sources.gateRuns.find((r) => r.startedAt !== null || r.wait.on === 'preflight') ?? null;
+    const claims = [];
+    for (const run of sources.gateRuns) {
+        if (run.focusId === null)
+            continue;
+        const common = commonFields(sources, run.focusId);
+        const ahead = aheadOf(run, slotHolder);
+        const activity = run.startedAt !== null && run.sha !== null
+            ? { ...common, kind: 'gate_running', deliveryId: run.deliveryId, sha: run.sha, startedAt: iso(run.startedAt), timeoutMs: run.timeoutMs }
+            : {
+                ...common, kind: 'gate_queued', deliveryId: run.deliveryId, queuedAt: iso(run.selectedAt),
+                waitingOn: run.wait.on, aheadFocusId: ahead.focusId, aheadDeliveryId: ahead.deliveryId,
+            };
+        claims.push({ focusId: run.focusId, activity });
+    }
+    return claims;
+}
+/** Every producer the record is built from. Order does not decide the winner; precedence does. */
+export const FOCUS_ACTIVITY_PRODUCERS = [
+    gateActivityClaims,
+    teamActivityClaims,
+    deliveryHeldClaims,
+    reviewParkedClaims,
+    cooldownClaims,
+    awaitingSlotClaims,
+    spawnPendingClaims,
+    idleClaims,
+];
+/** The kinds any focus may carry (the daemon is doing something for it); every other kind needs an armed focus. */
+const DOING_KINDS = new Set(['gate_running', 'gate_queued', 'team_reviewing', 'team_coding']);
+/** Date each winner that carries no start of its own by the first beat it was seen, and forget the rest. */
+function stampObservedSince(winners, sources) {
+    const map = {};
+    const observed = new Set();
+    for (const [focusId, { activity, sinceKey }] of winners) {
+        if (sinceKey !== undefined && 'since' in activity) {
+            observed.add(sinceKey);
+            map[focusId] = { ...activity, since: iso(sources.firstSeen.observe(sinceKey, sources.now)) };
+        }
+        else {
+            map[focusId] = activity;
+        }
+    }
+    sources.firstSeen.retainOnly(observed);
+    return map;
+}
+/** Build the per-focus map: the precedence winner among every admitted claim. Pure but for sources.firstSeen. */
+export function buildFocusActivityMap(sources, producers) {
+    const armed = new Set(sources.polledFocuses.filter((f) => f.armed).map((f) => f.focusId));
+    const winners = new Map();
+    for (const produce of producers) {
+        for (const claim of produce(sources)) {
+            if (!DOING_KINDS.has(claim.activity.kind) && !armed.has(claim.focusId))
+                continue;
+            const current = winners.get(claim.focusId);
+            if (pickFocusActivity(current?.activity, claim.activity) === claim.activity)
+                winners.set(claim.focusId, claim);
+        }
+    }
+    return stampObservedSince(winners, sources);
+}
+/** The record from every declared producer (FOCUS_ACTIVITY_PRODUCERS). */
+export function buildFocusActivityRecord(sources) {
+    return buildFocusActivityMap(sources, FOCUS_ACTIVITY_PRODUCERS);
+}
+/**
+ * Set `metadata.focusActivity` from the beat's sources; the key is absent when
+ * no focus has an entry. The live sources are bound at the composition root
+ * (composition/focus-activity-live-sources.ts) and reach here through the
+ * heartbeat's deps.
+ */
+export function applyFocusActivity(metadata, sources) {
+    const focusActivity = buildFocusActivityRecord(sources);
+    if (Object.keys(focusActivity).length > 0)
+        metadata.focusActivity = focusActivity;
+}
+//# sourceMappingURL=focus-activity-record.js.map

package/dist/focus/focus-activity-record.js.map

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

package/dist/focus/focus-activity-sources.d.ts

@@ -0,0 +1,95 @@
+/**
+ * The in-process facts the focus activity record (focus/focus-activity-record.ts)
+ * is built from, the claim a producer makes, and the fields every entry
+ * carries. Split out so the producers (focus/focus-activity-producers.ts,
+ * focus/focus-activity-held.ts) and the builder share one declaration without
+ * an import cycle.
+ *
+ * Every source is a snapshot taken at the beat: the builder and producers are
+ * pure over it. The one piece of carried state is the {@link FirstSeenTracker}:
+ * a fact with no recorded start time (an idle focus, a pending spawn, an
+ * operator hold marker) is dated by the first beat the daemon saw it standing.
+ *
+ * @module focus/focus-activity-sources
+ */
+import type { FocusActivity, FocusActivityCommon } from '@telora/daemon-core';
+import type { GateRunView } from '../verify/gate-verdicts/gate-run-registry.js';
+import type { ReviewPark } from '../daemon-state/review-park-record.js';
+import type { SpawnCooldownWindow } from '../supervision/spawn-cooldown-window.js';
+import type { PolledFocus } from './focus-activity-poll-facts.js';
+/** A live team as the record reads it. */
+export interface TeamView {
+    focusId: string;
+    sessionType: 'coding' | 'review';
+    sessionId: string | null;
+    /** Epoch ms of the team's last agent event (focus-team-state's in-memory activity clock), or null. */
+    lastAgentEventAt: number | null;
+}
+/** A queued team spawn as the record reads it. */
+export interface PendingSpawnView {
+    focusId: string;
+    sessionType: 'coding' | 'review';
+}
+/**
+ * Dates a standing fact by the first beat it was seen. `observe` returns the
+ * first time the key was observed in the current unbroken run of beats;
+ * `retainOnly` forgets every key not observed this beat, so a fact that stops
+ * and starts again is dated from its restart.
+ */
+export declare class FirstSeenTracker {
+    private readonly seen;
+    observe(key: string, now: number): number;
+    retainOnly(keys: ReadonlySet<string>): void;
+}
+/** The in-process facts the record is built from, as of one beat. */
+export interface FocusActivitySources {
+    /** The daemon clock at this beat (epoch ms). */
+    now: number;
+    /** Every selected, unfinished gate run (verify/gate-verdicts/gate-run-registry.ts). */
+    gateRuns: readonly GateRunView[];
+    /**
+     * When the focus's work last moved forward -- a delivery advancing or an issue
+     * moving to Done (daemon-state/focus-progress-clock.ts) -- in epoch ms, or null.
+     * Kept per focus, not per team, so it survives teardowns and the gaps between sessions.
+     */
+    readLastProgressAt: (focusId: string) => number | null;
+    /** The focus's spawn-teardown streak (supervision/spawn-cooldown.ts getRespawnCycleStreak), or null. */
+    readTeardownStreak: (focusId: string) => {
+        firstTime: number;
+        count: number;
+    } | null;
+    /** Every live team (daemon-state/focus-team-state.ts). */
+    teams: readonly TeamView[];
+    /** Focuses a spawn pass left waiting for a session slot, with when the wait began (daemon-state/awaiting-slot.ts). */
+    awaitingSlot: readonly {
+        focusId: string;
+        sinceMs: number;
+    }[];
+    /** Queued team spawns (directive/directive-queue.ts). */
+    pendingSpawns: readonly PendingSpawnView[];
+    /** Standing review parks (daemon-state/review-park-record.ts). */
+    reviewParks: ReadonlyMap<string, ReviewPark>;
+    /** The cooldown window holding the focus's next spawn now, or null (spawn/next-spawn-cooldown.ts). */
+    readCooldownWindow: (focusId: string) => SpawnCooldownWindow | null;
+    /** The active focuses and their deliveries as the latest poll read them (focus/focus-activity-poll-facts.ts). */
+    polledFocuses: readonly PolledFocus[];
+    /** Dates facts that carry no start time of their own. */
+    firstSeen: FirstSeenTracker;
+}
+/** One producer's claim about one focus. */
+export interface FocusActivityClaim {
+    focusId: string;
+    activity: FocusActivity;
+    /**
+     * Present when the fact has no recorded start: the builder replaces the
+     * entry's `since` with the first beat this key was seen (FirstSeenTracker).
+     */
+    sinceKey?: string;
+}
+export type FocusActivityProducer = (sources: FocusActivitySources) => FocusActivityClaim[];
+export declare const iso: (ms: number) => string;
+/** The fields every entry carries: the beat's clock, the teardown streak, the last progress. */
+export declare function commonFields(sources: FocusActivitySources, focusId: string): FocusActivityCommon;
+/** The armed focuses the latest poll saw. */
+export declare function armedPolledFocuses(sources: FocusActivitySources): PolledFocus[];
+//# sourceMappingURL=focus-activity-sources.d.ts.map

package/dist/focus/focus-activity-sources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"focus-activity-sources.d.ts","sourceRoot":"","sources":["../../src/focus/focus-activity-sources.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,mBAAmB,EAAuB,MAAM,qBAAqB,CAAC;AACnG,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8CAA8C,CAAC;AAChF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uCAAuC,CAAC;AACxE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yCAAyC,CAAC;AACnF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAElE,0CAA0C;AAC1C,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,QAAQ,GAAG,QAAQ,CAAC;IACjC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,sGAAsG;IACtG,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAED,kDAAkD;AAClD,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,QAAQ,GAAG,QAAQ,CAAC;CAClC;AAED;;;;;GAKG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA6B;IAElD,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM;IAOzC,UAAU,CAAC,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,IAAI;CAG5C;AAED,qEAAqE;AACrE,MAAM,WAAW,oBAAoB;IACnC,gDAAgD;IAChD,GAAG,EAAE,MAAM,CAAC;IACZ,uFAAuF;IACvF,QAAQ,EAAE,SAAS,WAAW,EAAE,CAAC;IACjC;;;;OAIG;IACH,kBAAkB,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;IACvD,wGAAwG;IACxG,kBAAkB,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACrF,0DAA0D;IAC1D,KAAK,EAAE,SAAS,QAAQ,EAAE,CAAC;IAC3B,sHAAsH;IACtH,YAAY,EAAE,SAAS;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC9D,yDAAyD;IACzD,aAAa,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAC3C,kEAAkE;IAClE,WAAW,EAAE,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAC7C,sGAAsG;IACtG,kBAAkB,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,mBAAmB,GAAG,IAAI,CAAC;IACpE,iHAAiH;IACjH,aAAa,EAAE,SAAS,WAAW,EAAE,CAAC;IACtC,yDAAyD;IACzD,SAAS,EAAE,gBAAgB,CAAC;CAC7B;AAED,4CAA4C;AAC5C,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,aAAa,CAAC;IACxB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,qBAAqB,GAAG,CAAC,OAAO,EAAE,oBAAoB,KAAK,kBAAkB,EAAE,CAAC;AAE5F,eAAO,MAAM,GAAG,GAAI,IAAI,MAAM,KAAG,MAAoC,CAAC;AAQtE,gGAAgG;AAChG,wBAAgB,YAAY,CAAC,OAAO,EAAE,oBAAoB,EAAE,OAAO,EAAE,MAAM,GAAG,mBAAmB,CAOhG;AAED,6CAA6C;AAC7C,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,oBAAoB,GAAG,WAAW,EAAE,CAE/E"}

package/dist/focus/focus-activity-sources.js

@@ -0,0 +1,45 @@
+// PINNED-BY-BEGIN (generated by gen:pinned-by -- do not hand-edit; checked by lint:pinned-by)
+// Pinned by: packages/daemon/src/focus/focus-activity-producers.test.ts,
+//   packages/daemon/src/focus/focus-activity-record.test.ts
+// PINNED-BY-END
+/**
+ * Dates a standing fact by the first beat it was seen. `observe` returns the
+ * first time the key was observed in the current unbroken run of beats;
+ * `retainOnly` forgets every key not observed this beat, so a fact that stops
+ * and starts again is dated from its restart.
+ */
+export class FirstSeenTracker {
+    seen = new Map();
+    observe(key, now) {
+        const first = this.seen.get(key);
+        if (first !== undefined)
+            return first;
+        this.seen.set(key, now);
+        return now;
+    }
+    retainOnly(keys) {
+        for (const key of this.seen.keys())
+            if (!keys.has(key))
+                this.seen.delete(key);
+    }
+}
+export const iso = (ms) => new Date(ms).toISOString();
+function streakField(sources, focusId) {
+    const streak = sources.readTeardownStreak(focusId);
+    // A count-0 entry is a rate-limit hold only: no teardown has happened.
+    return streak && streak.count > 0 ? { count: streak.count, firstAt: iso(streak.firstTime) } : null;
+}
+/** The fields every entry carries: the beat's clock, the teardown streak, the last progress. */
+export function commonFields(sources, focusId) {
+    const progress = sources.readLastProgressAt(focusId);
+    return {
+        computedAt: iso(sources.now),
+        spawnTeardownStreak: streakField(sources, focusId),
+        lastProgressAt: progress === null ? null : iso(progress),
+    };
+}
+/** The armed focuses the latest poll saw. */
+export function armedPolledFocuses(sources) {
+    return sources.polledFocuses.filter((f) => f.armed);
+}
+//# sourceMappingURL=focus-activity-sources.js.map

package/dist/focus/focus-activity-sources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"focus-activity-sources.js","sourceRoot":"","sources":["../../src/focus/focus-activity-sources.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,yEAAyE;AACzE,4DAA4D;AAC5D,gBAAgB;AAsChB;;;;;GAKG;AACH,MAAM,OAAO,gBAAgB;IACV,IAAI,GAAG,IAAI,GAAG,EAAkB,CAAC;IAElD,OAAO,CAAC,GAAW,EAAE,GAAW;QAC9B,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,KAAK,CAAC;QACtC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QACxB,OAAO,GAAG,CAAC;IACb,CAAC;IAED,UAAU,CAAC,IAAyB;QAClC,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;YAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;gBAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAChF,CAAC;CACF;AA6CD,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC,EAAU,EAAU,EAAE,CAAC,IAAI,IAAI,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;AAEtE,SAAS,WAAW,CAAC,OAA6B,EAAE,OAAe;IACjE,MAAM,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC;IACnD,uEAAuE;IACvE,OAAO,MAAM,IAAI,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AACrG,CAAC;AAED,gGAAgG;AAChG,MAAM,UAAU,YAAY,CAAC,OAA6B,EAAE,OAAe;IACzE,MAAM,QAAQ,GAAG,OAAO,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC;IACrD,OAAO;QACL,UAAU,EAAE,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC;QAC5B,mBAAmB,EAAE,WAAW,CAAC,OAAO,EAAE,OAAO,CAAC;QAClD,cAAc,EAAE,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC;KACzD,CAAC;AACJ,CAAC;AAED,6CAA6C;AAC7C,MAAM,UAAU,kBAAkB,CAAC,OAA6B;IAC9D,OAAO,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;AACtD,CAAC"}

package/dist/focus/focus-branch-ahead.d.ts

@@ -2,10 +2,8 @@
  * Landed-work check for focus completion.
  *
  * A focus reads complete only when its agent work has measurably LANDED where a
- * human inspecting the tree will find it. The observed failure: an agent branch
- * carried four substantive commits, was never merged, and the board still read
- * complete because completion was inferred from delivery status, not from where
- * the work actually landed.
+ * human inspecting the tree will find it -- never from delivery status alone,
+ * which can read complete while the work sits unmerged on an agent branch.
  *
  * This reads branch state DETERMINISTICALLY from git (a standing daemon
  * invariant -- never inferred from agent claims): true when the focus's agent
@@ -14,12 +12,18 @@
  * the branch is ahead; the merge-back loop lands the branch (the normal outcome)
  * and files a stuck_focus_branch escalation for a genuinely-unmergeable one.
  *
+ * History: docs/daemon/history-team-lifecycle.md (focus/focus-branch-ahead.ts).
+ *
  * @module focus-branch-ahead
  */
-import { getAllFocusWorktrees } from './focus-worktree-state.js';
-import { branchHasUnmergedCommits } from '../worktree/index.js';
+import type { getAllFocusWorktrees } from '../worktree/focus-worktree-state.js';
+import type { branchHasUnmergedCommits } from '../worktree/index.js';
 import type { DaemonConfig } from '../types/index.js';
-/** Injected seam so the check is unit-testable without a real worktree/git. */
+/**
+ * The check's collaborators (the worktree map and the git read). Required; the
+ * production binding is built at the composition root
+ * (composition/runtime-contexts.ts, `focusBranchAhead`).
+ */
 export interface FocusBranchAheadDeps {
     getAllFocusWorktrees: typeof getAllFocusWorktrees;
     branchHasUnmergedCommits: typeof branchHasUnmergedCommits;
@@ -38,5 +42,5 @@ export interface FocusBranchAheadDeps {
  * for work that genuinely cannot land, and the evaluate phase re-checks every
  * tick so a transient false-open self-corrects.
  */
-export declare function focusBranchAhead(focusId: string, productConfig: DaemonConfig, deps?: FocusBranchAheadDeps): boolean;
+export declare function focusBranchAhead(focusId: string, productConfig: DaemonConfig, deps: FocusBranchAheadDeps): boolean;
 //# sourceMappingURL=focus-branch-ahead.d.ts.map

package/dist/focus/focus-branch-ahead.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"focus-branch-ahead.d.ts","sourceRoot":"","sources":["../../src/focus/focus-branch-ahead.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD,+EAA+E;AAC/E,MAAM,WAAW,oBAAoB;IACnC,oBAAoB,EAAE,OAAO,oBAAoB,CAAC;IAClD,wBAAwB,EAAE,OAAO,wBAAwB,CAAC;CAC3D;AAOD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,aAAa,EAAE,YAAY,EAC3B,IAAI,GAAE,oBAAkC,GACvC,OAAO,CAQT"}
+{"version":3,"file":"focus-branch-ahead.d.ts","sourceRoot":"","sources":["../../src/focus/focus-branch-ahead.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAChF,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AACrE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,oBAAoB,EAAE,OAAO,oBAAoB,CAAC;IAClD,wBAAwB,EAAE,OAAO,wBAAwB,CAAC;CAC3D;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,aAAa,EAAE,YAAY,EAC3B,IAAI,EAAE,oBAAoB,GACzB,OAAO,CAQT"}

package/dist/focus/focus-branch-ahead.js

@@ -1,30 +1,6 @@
 // PINNED-BY-BEGIN (generated by gen:pinned-by -- do not hand-edit; checked by lint:pinned-by)
 // Pinned by: packages/daemon/src/focus/focus-branch-ahead.test.ts
 // PINNED-BY-END
-/**
- * Landed-work check for focus completion.
- *
- * A focus reads complete only when its agent work has measurably LANDED where a
- * human inspecting the tree will find it. The observed failure: an agent branch
- * carried four substantive commits, was never merged, and the board still read
- * complete because completion was inferred from delivery status, not from where
- * the work actually landed.
- *
- * This reads branch state DETERMINISTICALLY from git (a standing daemon
- * invariant -- never inferred from agent claims): true when the focus's agent
- * branch carries commits not reachable from the product's integration branch.
- * The focus-completion evaluate phase consults it and holds `complete` open while
- * the branch is ahead; the merge-back loop lands the branch (the normal outcome)
- * and files a stuck_focus_branch escalation for a genuinely-unmergeable one.
- *
- * @module focus-branch-ahead
- */
-import { getAllFocusWorktrees } from './focus-worktree-state.js';
-import { branchHasUnmergedCommits } from '../worktree/index.js';
-const defaultDeps = {
-    getAllFocusWorktrees,
-    branchHasUnmergedCommits,
-};
 /**
  * True when the focus's agent branch carries commits not reachable from the
  * product's integration branch -- i.e. its work has NOT landed.
@@ -39,7 +15,7 @@ const defaultDeps = {
  * for work that genuinely cannot land, and the evaluate phase re-checks every
  * tick so a transient false-open self-corrects.
  */
-export function focusBranchAhead(focusId, productConfig, deps = defaultDeps) {
+export function focusBranchAhead(focusId, productConfig, deps) {
     const wt = deps.getAllFocusWorktrees().get(focusId);
     if (!wt)
         return false;

package/dist/focus/focus-branch-ahead.js.map

@@ -1 +1 @@
-{"version":3,"file":"focus-branch-ahead.js","sourceRoot":"","sources":["../../src/focus/focus-branch-ahead.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,kEAAkE;AAClE,gBAAgB;AAEhB;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAShE,MAAM,WAAW,GAAyB;IACxC,oBAAoB;IACpB,wBAAwB;CACzB,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,gBAAgB,CAC9B,OAAe,EACf,aAA2B,EAC3B,OAA6B,WAAW;IAExC,MAAM,EAAE,GAAG,IAAI,CAAC,oBAAoB,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACpD,IAAI,CAAC,EAAE;QAAE,OAAO,KAAK,CAAC;IACtB,OAAO,IAAI,CAAC,wBAAwB,CAClC,EAAE,CAAC,UAAU,EACb,aAAa,CAAC,iBAAiB,EAC/B,aAAa,CAAC,QAAQ,CACvB,CAAC;AACJ,CAAC"}
+{"version":3,"file":"focus-branch-ahead.js","sourceRoot":"","sources":["../../src/focus/focus-branch-ahead.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,kEAAkE;AAClE,gBAAgB;AAmChB;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,gBAAgB,CAC9B,OAAe,EACf,aAA2B,EAC3B,IAA0B;IAE1B,MAAM,EAAE,GAAG,IAAI,CAAC,oBAAoB,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACpD,IAAI,CAAC,EAAE;QAAE,OAAO,KAAK,CAAC;IACtB,OAAO,IAAI,CAAC,wBAAwB,CAClC,EAAE,CAAC,UAAU,EACb,aAAa,CAAC,iBAAiB,EAC/B,aAAa,CAAC,QAAQ,CACvB,CAAC;AACJ,CAAC"}