@telora/daemon 0.22.58 → 0.22.62

package/dist/spawn/review-role-fallback.d.ts

@@ -1,141 +0,0 @@
-/**
- * Review-spawn reviewer-role fallback.
- *
- * When a coding team completes, the auto_terminate_focus_team() Postgres trigger
- * nulls product_focuses.assigned_agent_role_id -- correct team-lifecycle
- * shutdown (the Play/queue toggle cleared). But a review is a SECOND team that
- * must spawn AFTER that completion, and the pending review directive it left
- * behind still needs a role to spawn under. With assigned_agent_role_id null,
- * the listener's pending-spawn path used to skip the queued review directive
- * every poll, and the directive-executor suppressed re-firing (an equivalent
- * directive is "already queued") -- a review that can never spawn, spin-logging
- * until review_window_stalled escalates to a human at ~6h.
- *
- * This module holds the prevent-at-source decision: for a REVIEW directive with
- * a null role, resolve a layered reviewer-role fallback (the org's seeded
- * Developer role) and spawn. It mirrors nexus intake's resolveIntakeRoleLayered
- * (the org's seeded 'Developer' role is the zero-config fallback). The fallback
- * is scoped STRICTLY to review spawns: a null role on a CODING spawn is the
- * intended off-state and must NOT auto-spawn. Defense-in-depth: if even the
- * fallback resolves nothing, the caller clears the pending directive so it stops
- * spin-logging and lets the stall detector escalate promptly.
- */
-import type { AgentRole } from '../types/session.js';
-/**
- * Name of the org's auto-seeded, full-codebase agent role used as the reviewer
- * fallback. Every organization gets one on creation (migration
- * seed_default_agent_roles: 'Developer'). Mirrors nexus intake's
- * DEFAULT_INTAKE_ROLE_NAME so review-spawn and intake-spawn share the same
- * zero-config fallback identity.
- */
-export declare const DEFAULT_REVIEWER_ROLE_NAME = "Developer";
-/**
- * What to do with a pending spawn directive whose focus has a null
- * assigned_agent_role_id.
- *
- *   - skip:  a CODING directive (or no directive) -- the intended off-state
- *            (Play/queue toggle cleared). Never auto-spawn.
- *   - spawn: a REVIEW directive with a resolved fallback role -- spawn the
- *            review team under it.
- *   - clear: a REVIEW directive with NO resolvable fallback role -- drop the
- *            directive so the stranded-review re-fire suppression cannot spin
- *            forever; review_window_stalled remains the escalation path.
- */
-export type NullRoleSpawnDecision = {
-    action: 'skip';
-} | {
-    action: 'spawn';
-    role: AgentRole;
-} | {
-    action: 'clear';
-};
-/**
- * Resolve the org's seeded Developer role from an already-loaded roles
- * collection (the listener keeps every org agent role in memory). Returns the
- * first role named DEFAULT_REVIEWER_ROLE_NAME, or undefined when the org has no
- * seeded Developer role (the degenerate case the 'clear' decision handles).
- *
- * Pure and exported for unit testing.
- */
-export declare function resolveReviewerFallbackRole(roles: Iterable<AgentRole>): AgentRole | undefined;
-/**
- * Decide what to do with a null-role pending spawn directive.
- *
- * A null assigned_agent_role_id means one of THREE things, and they must be
- * told apart:
- *
- *   - An OPERATOR STOP (product_focuses.operator_stopped_at is set): the human
- *     pulled the Play toggle to halt the focus. This is authoritative and wins
- *     over everything -- when `operatorStopped` is true we `skip` for EVERY
- *     sessionType, review included, and regardless of `reopened`. The stop lever
- *     must never become the trigger for the path it was meant to stop.
- *   - A LIFECYCLE CLEAR of a FINISHED focus (operator_stopped_at null, work not
- *     reopened): auto_terminate_focus_team() nulled the role at completion. Here
- *     a review directive is a SECOND team that must spawn AFTER completion (spawn
- *     under the fallback role, else clear); a coding directive is the intended
- *     off-state and is skipped.
- *   - A LIFECYCLE CLEAR whose work was REOPENED (operator_stopped_at null,
- *     `reopened` true): a review sent completed work back, so the focus is NOT
- *     finished -- a coding directive here is NOT the off-state. It must spawn
- *     under the fallback role (else clear), the same treatment a review
- *     directive gets, so the reopened work resumes instead of stranding on a
- *     lifecycle-cleared focus. This is the fact `decideNullRoleSpawn` previously
- *     lacked: a coding directive was classified by sessionType ALONE, collapsing
- *     "finished" and "reopened" into one skip.
- *
- * With `operatorStopped` false AND `reopened` false the behaviour is
- * byte-identical to before either fact existed.
- *
- * Pure and exported for unit testing (peer of resolveReviewerFallbackRole).
- */
-export declare function decideNullRoleSpawn(input: {
-    sessionType: 'coding' | 'review' | undefined;
-    fallbackRole: AgentRole | undefined;
-    /**
-     * Whether an operator has stopped this focus (product_focuses.
-     * operator_stopped_at is set). When true, no spawn happens for any
-     * sessionType -- the operator's stop is authoritative.
-     */
-    operatorStopped: boolean;
-    /**
-     * Whether this lifecycle-cleared focus's work was REOPENED after the role was
-     * cleared (e.g. a gaps_found review re-queued a delivery: a non-terminal
-     * delivery now exists on a focus whose role auto_terminate_focus_team()
-     * nulled). Only consulted for a non-review (coding/undefined) directive; a
-     * review directive already spawns via the fallback. Defaults false, which
-     * preserves the pre-reopened behaviour exactly. Ignored when
-     * `operatorStopped` is true -- the stop always wins.
-     */
-    reopened?: boolean;
-}): NullRoleSpawnDecision;
-/**
- * Re-announce floor for the null-role "coding off-state" skip warning. The
- * warning is emitted on entry and then AT MOST once per this interval while the
- * block persists -- long enough that a stopped focus does not spin-log every
- * 30s poll, short enough that a block that persists keeps surfacing in the log
- * for as long as it lasts (instead of being announced once and then suppressed
- * forever, which made a genuinely stuck focus indistinguishable from a finished
- * one). 30 minutes.
- */
-export declare const NULL_ROLE_SKIP_REANNOUNCE_FLOOR_MS: number;
-/**
- * Rate-limited re-announce gate for the null-role "coding off-state" skip
- * warning. The listener holds a Map of focus id -> last-announce timestamp (ms)
- * for the current continuous blocked episode; this mutates it and returns
- * whether to emit the warning now:
- *
- *   - focus never announced this episode -> record `nowMs` and return true
- *     (warn on entry).
- *   - last announced >= `floorMs` ago -> record `nowMs` and return true
- *     (re-announce: the block persists, keep surfacing it).
- *   - last announced < `floorMs` ago -> return false (suppress the per-poll
- *     repeat between re-announcements).
- *
- * The listener removes the focus from the map when it resumes (role assigned,
- * directive cleared, or focus leaves the active set), so a later re-entry warns
- * immediately again. `nowMs`/`floorMs` are injectable so the decision is
- * deterministic under test. Pure w.r.t. its inputs (Map + clock in, boolean
- * out) and exported for unit testing without standing up the poll loop.
- */
-export declare function shouldWarnNullRoleSkip(lastAnnouncedAt: Map<string, number>, focusId: string, nowMs?: number, floorMs?: number): boolean;
-//# sourceMappingURL=review-role-fallback.d.ts.map

package/dist/spawn/review-role-fallback.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"review-role-fallback.d.ts","sourceRoot":"","sources":["../../src/spawn/review-role-fallback.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAErD;;;;;;GAMG;AACH,eAAO,MAAM,0BAA0B,cAAc,CAAC;AAEtD;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,qBAAqB,GAC7B;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GAClB;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,SAAS,CAAA;CAAE,GACpC;IAAE,MAAM,EAAE,OAAO,CAAA;CAAE,CAAC;AAExB;;;;;;;GAOG;AACH,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,QAAQ,CAAC,SAAS,CAAC,GACzB,SAAS,GAAG,SAAS,CAKvB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE;IACzC,WAAW,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC7C,YAAY,EAAE,SAAS,GAAG,SAAS,CAAC;IACpC;;;;OAIG;IACH,eAAe,EAAE,OAAO,CAAC;IACzB;;;;;;;;OAQG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,GAAG,qBAAqB,CAkBxB;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,kCAAkC,QAAc,CAAC;AAE9D;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,sBAAsB,CACpC,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EACpC,OAAO,EAAE,MAAM,EACf,KAAK,GAAE,MAAmB,EAC1B,OAAO,GAAE,MAA2C,GACnD,OAAO,CAKT"}

package/dist/spawn/review-role-fallback.js

@@ -1,114 +0,0 @@
-// PINNED-BY-BEGIN (generated by gen:pinned-by -- do not hand-edit; checked by lint:pinned-by)
-// Pinned by: packages/daemon/src/focus/listener-operator-stop-drop.test.ts,
-//   packages/daemon/src/spawn/review-role-fallback.test.ts
-// PINNED-BY-END
-/**
- * Name of the org's auto-seeded, full-codebase agent role used as the reviewer
- * fallback. Every organization gets one on creation (migration
- * seed_default_agent_roles: 'Developer'). Mirrors nexus intake's
- * DEFAULT_INTAKE_ROLE_NAME so review-spawn and intake-spawn share the same
- * zero-config fallback identity.
- */
-export const DEFAULT_REVIEWER_ROLE_NAME = 'Developer';
-/**
- * Resolve the org's seeded Developer role from an already-loaded roles
- * collection (the listener keeps every org agent role in memory). Returns the
- * first role named DEFAULT_REVIEWER_ROLE_NAME, or undefined when the org has no
- * seeded Developer role (the degenerate case the 'clear' decision handles).
- *
- * Pure and exported for unit testing.
- */
-export function resolveReviewerFallbackRole(roles) {
-    for (const role of roles) {
-        if (role.name === DEFAULT_REVIEWER_ROLE_NAME)
-            return role;
-    }
-    return undefined;
-}
-/**
- * Decide what to do with a null-role pending spawn directive.
- *
- * A null assigned_agent_role_id means one of THREE things, and they must be
- * told apart:
- *
- *   - An OPERATOR STOP (product_focuses.operator_stopped_at is set): the human
- *     pulled the Play toggle to halt the focus. This is authoritative and wins
- *     over everything -- when `operatorStopped` is true we `skip` for EVERY
- *     sessionType, review included, and regardless of `reopened`. The stop lever
- *     must never become the trigger for the path it was meant to stop.
- *   - A LIFECYCLE CLEAR of a FINISHED focus (operator_stopped_at null, work not
- *     reopened): auto_terminate_focus_team() nulled the role at completion. Here
- *     a review directive is a SECOND team that must spawn AFTER completion (spawn
- *     under the fallback role, else clear); a coding directive is the intended
- *     off-state and is skipped.
- *   - A LIFECYCLE CLEAR whose work was REOPENED (operator_stopped_at null,
- *     `reopened` true): a review sent completed work back, so the focus is NOT
- *     finished -- a coding directive here is NOT the off-state. It must spawn
- *     under the fallback role (else clear), the same treatment a review
- *     directive gets, so the reopened work resumes instead of stranding on a
- *     lifecycle-cleared focus. This is the fact `decideNullRoleSpawn` previously
- *     lacked: a coding directive was classified by sessionType ALONE, collapsing
- *     "finished" and "reopened" into one skip.
- *
- * With `operatorStopped` false AND `reopened` false the behaviour is
- * byte-identical to before either fact existed.
- *
- * Pure and exported for unit testing (peer of resolveReviewerFallbackRole).
- */
-export function decideNullRoleSpawn(input) {
-    if (input.operatorStopped)
-        return { action: 'skip' };
-    // A review directive spawns the review team under the fallback (unchanged).
-    if (input.sessionType === 'review') {
-        return input.fallbackRole
-            ? { action: 'spawn', role: input.fallbackRole }
-            : { action: 'clear' };
-    }
-    // A coding/undefined directive on reopened work is NOT the off-state: spawn
-    // the reopened work under the fallback (else clear), just like a review.
-    if (input.reopened) {
-        return input.fallbackRole
-            ? { action: 'spawn', role: input.fallbackRole }
-            : { action: 'clear' };
-    }
-    // A coding/undefined directive on a genuinely finished focus stays the
-    // intended off-state.
-    return { action: 'skip' };
-}
-/**
- * Re-announce floor for the null-role "coding off-state" skip warning. The
- * warning is emitted on entry and then AT MOST once per this interval while the
- * block persists -- long enough that a stopped focus does not spin-log every
- * 30s poll, short enough that a block that persists keeps surfacing in the log
- * for as long as it lasts (instead of being announced once and then suppressed
- * forever, which made a genuinely stuck focus indistinguishable from a finished
- * one). 30 minutes.
- */
-export const NULL_ROLE_SKIP_REANNOUNCE_FLOOR_MS = 30 * 60_000;
-/**
- * Rate-limited re-announce gate for the null-role "coding off-state" skip
- * warning. The listener holds a Map of focus id -> last-announce timestamp (ms)
- * for the current continuous blocked episode; this mutates it and returns
- * whether to emit the warning now:
- *
- *   - focus never announced this episode -> record `nowMs` and return true
- *     (warn on entry).
- *   - last announced >= `floorMs` ago -> record `nowMs` and return true
- *     (re-announce: the block persists, keep surfacing it).
- *   - last announced < `floorMs` ago -> return false (suppress the per-poll
- *     repeat between re-announcements).
- *
- * The listener removes the focus from the map when it resumes (role assigned,
- * directive cleared, or focus leaves the active set), so a later re-entry warns
- * immediately again. `nowMs`/`floorMs` are injectable so the decision is
- * deterministic under test. Pure w.r.t. its inputs (Map + clock in, boolean
- * out) and exported for unit testing without standing up the poll loop.
- */
-export function shouldWarnNullRoleSkip(lastAnnouncedAt, focusId, nowMs = Date.now(), floorMs = NULL_ROLE_SKIP_REANNOUNCE_FLOOR_MS) {
-    const prev = lastAnnouncedAt.get(focusId);
-    if (prev !== undefined && nowMs - prev < floorMs)
-        return false;
-    lastAnnouncedAt.set(focusId, nowMs);
-    return true;
-}
-//# sourceMappingURL=review-role-fallback.js.map

package/dist/spawn/review-role-fallback.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"review-role-fallback.js","sourceRoot":"","sources":["../../src/spawn/review-role-fallback.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,4EAA4E;AAC5E,2DAA2D;AAC3D,gBAAgB;AA2BhB;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,WAAW,CAAC;AAmBtD;;;;;;;GAOG;AACH,MAAM,UAAU,2BAA2B,CACzC,KAA0B;IAE1B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,IAAI,KAAK,0BAA0B;YAAE,OAAO,IAAI,CAAC;IAC5D,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAmBnC;IACC,IAAI,KAAK,CAAC,eAAe;QAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IACrD,4EAA4E;IAC5E,IAAI,KAAK,CAAC,WAAW,KAAK,QAAQ,EAAE,CAAC;QACnC,OAAO,KAAK,CAAC,YAAY;YACvB,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,YAAY,EAAE;YAC/C,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;IAC1B,CAAC;IACD,4EAA4E;IAC5E,yEAAyE;IACzE,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QACnB,OAAO,KAAK,CAAC,YAAY;YACvB,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,YAAY,EAAE;YAC/C,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;IAC1B,CAAC;IACD,uEAAuE;IACvE,sBAAsB;IACtB,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;AAC5B,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,kCAAkC,GAAG,EAAE,GAAG,MAAM,CAAC;AAE9D;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,sBAAsB,CACpC,eAAoC,EACpC,OAAe,EACf,QAAgB,IAAI,CAAC,GAAG,EAAE,EAC1B,UAAkB,kCAAkC;IAEpD,MAAM,IAAI,GAAG,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC1C,IAAI,IAAI,KAAK,SAAS,IAAI,KAAK,GAAG,IAAI,GAAG,OAAO;QAAE,OAAO,KAAK,CAAC;IAC/D,eAAe,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IACpC,OAAO,IAAI,CAAC;AACd,CAAC"}