@telora/daemon 0.22.289 → 0.22.293

package/dist/focus/focus-activity-poll-facts.js

@@ -0,0 +1,110 @@
+// 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-team-clock.test.ts,
+//   packages/daemon/src/focus/heartbeat-focus-activity.test.ts,
+//   packages/daemon/src/spawn/team-working-delivery.test.ts
+// PINNED-BY-END
+/**
+ * The focus and delivery rows the poll loop already reads, kept for the
+ * heartbeat's focus activity record (focus/focus-activity-record.ts).
+ *
+ * The teamless auto-advance pass (focus/focus-poller-auto-advance.ts
+ * checkDeliveryAutoAdvance) reads every active focus of every product and every
+ * such focus's deliveries on each poll. Its two reads are wrapped at the
+ * composition root (composition/runtime-delivery-advance-context.ts) with the
+ * observers below, so the record knows which focuses are ARMED and what their
+ * deliveries hold at NO extra query: the heartbeat reads the latest poll's rows.
+ *
+ * Replacement, not accumulation: a product's focus list is replaced wholesale
+ * by each successful read of it, and a focus's deliveries by each read of them,
+ * so a focus that stops being active drops out on the next poll. A failed read
+ * records nothing and leaves the previous rows standing (the observed-at time
+ * says how old they are): a delivery read that fails after one succeeded keeps
+ * the last good rows, it never blanks them.
+ *
+ * The same reads (and the pass's per-delivery issue reads, observeDeliveryIssues)
+ * feed the per-focus progress clock (daemon-state/focus-progress-clock.ts) as its
+ * RECOVERY path: the daemon's own status writes stamp the clock when they land,
+ * and a read stamps it only for movement written elsewhere (an agent closing an
+ * issue over MCP). They also tell the clock which focus a delivery or issue
+ * belongs to, which is how a landed write is attributed.
+ *
+ * @module focus/focus-activity-poll-facts
+ */
+import { forgetFocusProgress, observeDeliveryProgress, observeIssueProgress } from '../daemon-state/focus-progress-clock.js';
+const focusesByProduct = new Map();
+const deliveriesByFocus = new Map();
+/** Record one product's active focus list (replaces that product's previous list). */
+export function recordPolledFocuses(productKey, rows) {
+    focusesByProduct.set(productKey, rows.map((r) => ({ focus_id: r.focus_id, assigned_agent_role_id: r.assigned_agent_role_id })));
+}
+/** Record one focus's deliveries (replaces its previous rows). */
+export function recordPolledDeliveries(focusId, rows, now = Date.now()) {
+    observeDeliveryProgress(focusId, rows, now);
+    deliveriesByFocus.set(focusId, {
+        rows: rows.map((d) => ({ id: d.id, executionStatus: d.executionStatus ?? null, gateState: d.gateState ?? null })),
+        at: now,
+    });
+}
+/** Every active focus the latest poll of each product saw, with its latest deliveries. Prunes rows of focuses no longer listed. */
+export function polledFocusSnapshot() {
+    const out = new Map();
+    for (const rows of focusesByProduct.values()) {
+        for (const row of rows) {
+            const d = deliveriesByFocus.get(row.focus_id);
+            out.set(row.focus_id, {
+                focusId: row.focus_id,
+                armed: row.assigned_agent_role_id != null,
+                deliveries: d?.rows ?? null,
+                deliveriesObservedAt: d?.at ?? null,
+            });
+        }
+    }
+    for (const focusId of deliveriesByFocus.keys()) {
+        if (out.has(focusId))
+            continue;
+        deliveriesByFocus.delete(focusId);
+        forgetFocusProgress(focusId);
+    }
+    return [...out.values()];
+}
+/** Wrap an active-focus read so each successful result is recorded under the product it was read for. */
+export function observeActiveFocuses(read) {
+    return async (organizationId, productId) => {
+        const rows = await read(organizationId, productId);
+        recordPolledFocuses(productId ?? '', rows);
+        return rows;
+    };
+}
+/** Wrap a focus-deliveries read so each successful result is recorded for the focus. */
+export function observeFocusDeliveries(read) {
+    return async (focusId) => {
+        const rows = await read(focusId);
+        recordPolledDeliveries(focusId, rows);
+        return rows;
+    };
+}
+/** The focus whose latest delivery read listed `deliveryId`, or null. */
+function polledFocusOfDelivery(deliveryId) {
+    for (const [focusId, { rows }] of deliveriesByFocus)
+        if (rows.some((d) => d.id === deliveryId))
+            return focusId;
+    return null;
+}
+/** Wrap a delivery-issues read so each successful result feeds the focus's progress clock (an issue moving to Done). */
+export function observeDeliveryIssues(read) {
+    return async (deliveryId) => {
+        const rows = await read(deliveryId);
+        const focusId = polledFocusOfDelivery(deliveryId);
+        if (focusId !== null)
+            observeIssueProgress(focusId, deliveryId, rows, Date.now());
+        return rows;
+    };
+}
+/** Test-only: forget every polled row. */
+export function __resetPolledFocusFactsForTests() {
+    focusesByProduct.clear();
+    deliveriesByFocus.clear();
+}
+//# sourceMappingURL=focus-activity-poll-facts.js.map

package/dist/focus/focus-activity-poll-facts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"focus-activity-poll-facts.js","sourceRoot":"","sources":["../../src/focus/focus-activity-poll-facts.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,yEAAyE;AACzE,qEAAqE;AACrE,iEAAiE;AACjE,gEAAgE;AAChE,4DAA4D;AAC5D,gBAAgB;AAEhB;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,MAAM,yCAAyC,CAAC;AA0B7H,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAAqC,CAAC;AACtE,MAAM,iBAAiB,GAAG,IAAI,GAAG,EAA2D,CAAC;AAE7F,sFAAsF;AACtF,MAAM,UAAU,mBAAmB,CAAC,UAAkB,EAAE,IAA+B;IACrF,gBAAgB,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,sBAAsB,EAAE,CAAC,CAAC,sBAAsB,EAAE,CAAC,CAAC,CAAC,CAAC;AAClI,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,sBAAsB,CAAC,OAAe,EAAE,IAA+B,EAAE,MAAc,IAAI,CAAC,GAAG,EAAE;IAC/G,uBAAuB,CAAC,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;IAC5C,iBAAiB,CAAC,GAAG,CAAC,OAAO,EAAE;QAC7B,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,eAAe,EAAE,CAAC,CAAC,eAAe,IAAI,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,IAAI,IAAI,EAAE,CAAC,CAAC;QACjH,EAAE,EAAE,GAAG;KACR,CAAC,CAAC;AACL,CAAC;AAED,mIAAmI;AACnI,MAAM,UAAU,mBAAmB;IACjC,MAAM,GAAG,GAAG,IAAI,GAAG,EAAuB,CAAC;IAC3C,KAAK,MAAM,IAAI,IAAI,gBAAgB,CAAC,MAAM,EAAE,EAAE,CAAC;QAC7C,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,MAAM,CAAC,GAAG,iBAAiB,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YAC9C,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,EAAE;gBACpB,OAAO,EAAE,GAAG,CAAC,QAAQ;gBACrB,KAAK,EAAE,GAAG,CAAC,sBAAsB,IAAI,IAAI;gBACzC,UAAU,EAAE,CAAC,EAAE,IAAI,IAAI,IAAI;gBAC3B,oBAAoB,EAAE,CAAC,EAAE,EAAE,IAAI,IAAI;aACpC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IACD,KAAK,MAAM,OAAO,IAAI,iBAAiB,CAAC,IAAI,EAAE,EAAE,CAAC;QAC/C,IAAI,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC;YAAE,SAAS;QAC/B,iBAAiB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAClC,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;AAC3B,CAAC;AAED,yGAAyG;AACzG,MAAM,UAAU,oBAAoB,CAClC,IAAkE;IAElE,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,EAAE;QACzC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,cAAc,EAAE,SAAS,CAAC,CAAC;QACnD,mBAAmB,CAAC,SAAS,IAAI,EAAE,EAAE,IAAI,CAAC,CAAC;QAC3C,OAAO,IAAI,CAAC;IACd,CAAC,CAAC;AACJ,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,sBAAsB,CACpC,IAAuC;IAEvC,OAAO,KAAK,EAAE,OAAO,EAAE,EAAE;QACvB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,CAAC;QACjC,sBAAsB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACtC,OAAO,IAAI,CAAC;IACd,CAAC,CAAC;AACJ,CAAC;AAED,yEAAyE;AACzE,SAAS,qBAAqB,CAAC,UAAkB;IAC/C,KAAK,MAAM,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,IAAI,iBAAiB;QAAE,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,UAAU,CAAC;YAAE,OAAO,OAAO,CAAC;IAC/G,OAAO,IAAI,CAAC;AACd,CAAC;AAED,wHAAwH;AACxH,MAAM,UAAU,qBAAqB,CACnC,IAA0C;IAE1C,OAAO,KAAK,EAAE,UAAU,EAAE,EAAE;QAC1B,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,CAAC;QACpC,MAAM,OAAO,GAAG,qBAAqB,CAAC,UAAU,CAAC,CAAC;QAClD,IAAI,OAAO,KAAK,IAAI;YAAE,oBAAoB,CAAC,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;QAClF,OAAO,IAAI,CAAC;IACd,CAAC,CAAC;AACJ,CAAC;AAED,0CAA0C;AAC1C,MAAM,UAAU,+BAA+B;IAC7C,gBAAgB,CAAC,KAAK,EAAE,CAAC;IACzB,iBAAiB,CAAC,KAAK,EAAE,CAAC;AAC5B,CAAC"}

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

@@ -0,0 +1,43 @@
+import { type FocusActivityClaim, type FocusActivitySources } from './focus-activity-sources.js';
+/**
+ * team_coding / team_reviewing / team_planning / team_resolving: one claim per
+ * live team. A team working a delivery is published coding or reviewing THAT
+ * delivery. A team with no delivery to work is never a delivery-less coding or
+ * review team: it is planning (its focus has none yet) or resolving (every
+ * delivery is done or cancelled -- the escalation-answer re-arm).
+ */
+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;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,oBAAoB,GAAG,kBAAkB,EAAE,CAetF;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,130 @@
+// 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 / team_planning / team_resolving: one claim per
+ * live team. A team working a delivery is published coding or reviewing THAT
+ * delivery. A team with no delivery to work is never a delivery-less coding or
+ * review team: it is planning (its focus has none yet) or resolving (every
+ * delivery is done or cancelled -- the escalation-answer re-arm).
+ */
+export function teamActivityClaims(sources) {
+    return sources.teams.map((team) => {
+        const clocks = {
+            ...commonFields(sources, team.focusId),
+            sessionId: team.sessionId,
+            lastAgentEventAt: team.lastAgentEventAt === null ? null : iso(team.lastAgentEventAt),
+        };
+        let activity;
+        if (team.deliveryId !== null) {
+            activity = { ...clocks, kind: team.sessionType === 'review' ? 'team_reviewing' : 'team_coding', deliveryId: team.deliveryId };
+        }
+        else {
+            activity = { ...clocks, kind: team.resolving ? 'team_resolving' : 'team_planning' };
+        }
+        return { focusId: team.focusId, activity };
+    });
+}
+/** 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":"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"}

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":"AASA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;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;AAuBF,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,141 @@
+// 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/spawn/team-working-delivery.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', 'team_planning', 'team_resolving',
+]);
+/** 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,99 @@
+/**
+ * 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;
+    /** The delivery the team is working, observed from its own issue calls (team-working-delivery.ts), or null. */
+    deliveryId: string | null;
+    /** Spawned with no delivery to work on a focus whose deliveries are all terminal (team-working-delivery.ts). */
+    resolving: boolean;
+}
+/** 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":"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"}