@telora/daemon 0.21.83 → 0.21.134

package/dist/testing/fixtures/index.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Shared test fixtures: typed builders for the daemon's core domain objects.
+ *
+ * Before this module, makeDelivery / makeIssue / makeConfig were copy-pasted
+ * into ~30 test files each, so a single field change to FocusDeliveryInfo /
+ * FocusIssueInfo / DaemonConfig meant editing dozens of files. These builders
+ * are the single source of truth; a type change is now one edit here.
+ *
+ * Each builder is a SUPERSET: it takes a `Partial<T>` of overrides spread last,
+ * so every existing call site keeps its specificity. The defaults below are the
+ * MAJORITY defaults observed across the suite; a file whose local builder used a
+ * different default keeps that default by passing it as an override (often via a
+ * thin file-local wrapper) so no test changes meaning.
+ *
+ * NOT included by design: `makeDeps` and `makeContext`. Those names collide
+ * across UNRELATED types -- makeDeps builds AdvanceDeliveryDeps /
+ * WorktreeStateDeps / SessionHealthDeps / various per-module `opts`; makeContext
+ * builds FocusTeamPromptContext / AssemblyContext / EvaluationContext. They are
+ * not one builder and cannot be merged into one typed function without a union
+ * or `any`, so they stay per-file. (See the delivery loop doc for the survey.)
+ */
+import type { DaemonConfig, FocusDeliveryInfo, FocusIssueInfo, FocusExecutionConfig, FocusTeamState } from '../../types/index.js';
+import type { VerificationDeps } from '../../verify/verification-deps.js';
+import type { AutoInjectDeps } from '../../security/security-auto-inject.js';
+import type { CompletionEventDeps } from '../../completion/event.js';
+import type { PrdControllerDeps } from '../../prd/controller.js';
+/**
+ * Build a FocusDeliveryInfo. Default executionStatus is 'queued' (the majority
+ * default across the suite); pass `{ executionStatus: ... }` for other states.
+ */
+export declare function makeDelivery(overrides?: Partial<FocusDeliveryInfo>): FocusDeliveryInfo;
+/**
+ * Build a FocusIssueInfo. Defaults to a To Do / Task issue on delivery-1.
+ */
+export declare function makeIssue(overrides?: Partial<FocusIssueInfo>): FocusIssueInfo;
+/**
+ * Build a DaemonConfig. Single-product, telemetry disabled, integration branch
+ * 'integration'. Pass overrides for product/branch/limits specifics.
+ */
+export declare function makeConfig(overrides?: Partial<DaemonConfig>): DaemonConfig;
+/**
+ * Build a FocusExecutionConfig. Defaults match DEFAULT_EXECUTION_CONFIG
+ * (maxWorkers 3, idle 30s, active 60s).
+ */
+export declare function makeFocusExecutionConfig(overrides?: Partial<FocusExecutionConfig>): FocusExecutionConfig;
+/**
+ * Build a FocusTeamState -- the wide in-memory team record. Centralizes the
+ * `makeTeam` / `makeTeamState` helpers that were copy-pasted into the
+ * focus-engine / watchdog / stall test files. Defaults to an executing coding
+ * team with no live process (leadPid/leadStdin null); pass overrides for the
+ * dimension under test. The many OPTIONAL clocks (lastActivityAt, shuttingDownAt,
+ * lastHandoffAt, toolActivityCount, ...) are omitted by default -- set them via
+ * the focus-team-state helpers or an override.
+ */
+export declare function makeFocusTeamState(overrides?: Partial<FocusTeamState>): FocusTeamState;
+/** Seed a VerificationDeps (verify/verification-engine runVerificationTick). */
+export declare function makeVerificationDeps(overrides?: Partial<VerificationDeps>): Partial<VerificationDeps>;
+/** Seed a CompletionEventDeps (completion/event handleCompletionEvent). */
+export declare function makeCompletionEventDeps(overrides?: Partial<CompletionEventDeps>): Partial<CompletionEventDeps>;
+/** Seed an AutoInjectDeps (security/security-auto-inject). */
+export declare function makeAutoInjectDeps(overrides?: Partial<AutoInjectDeps>): Partial<AutoInjectDeps>;
+/** Seed a PrdControllerDeps (prd/controller). */
+export declare function makePrdControllerDeps(overrides?: Partial<PrdControllerDeps>): Partial<PrdControllerDeps>;
+//# sourceMappingURL=index.d.ts.map

package/dist/testing/fixtures/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/testing/fixtures/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EACV,YAAY,EACZ,iBAAiB,EACjB,cAAc,EACd,oBAAoB,EACpB,cAAc,EACf,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAC1E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAC;AAC7E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAEjE;;;GAGG;AACH,wBAAgB,YAAY,CAAC,SAAS,GAAE,OAAO,CAAC,iBAAiB,CAAM,GAAG,iBAAiB,CAmB1F;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,SAAS,GAAE,OAAO,CAAC,cAAc,CAAM,GAAG,cAAc,CAkBjF;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,SAAS,GAAE,OAAO,CAAC,YAAY,CAAM,GAAG,YAAY,CA0B9E;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,SAAS,GAAE,OAAO,CAAC,oBAAoB,CAAM,GAC5C,oBAAoB,CAOtB;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,GAAE,OAAO,CAAC,cAAc,CAAM,GAAG,cAAc,CAoC1F;AAcD,gFAAgF;AAChF,wBAAgB,oBAAoB,CAClC,SAAS,GAAE,OAAO,CAAC,gBAAgB,CAAM,GACxC,OAAO,CAAC,gBAAgB,CAAC,CAe3B;AAED,2EAA2E;AAC3E,wBAAgB,uBAAuB,CACrC,SAAS,GAAE,OAAO,CAAC,mBAAmB,CAAM,GAC3C,OAAO,CAAC,mBAAmB,CAAC,CAS9B;AAED,8DAA8D;AAC9D,wBAAgB,kBAAkB,CAChC,SAAS,GAAE,OAAO,CAAC,cAAc,CAAM,GACtC,OAAO,CAAC,cAAc,CAAC,CAMzB;AAED,iDAAiD;AACjD,wBAAgB,qBAAqB,CACnC,SAAS,GAAE,OAAO,CAAC,iBAAiB,CAAM,GACzC,OAAO,CAAC,iBAAiB,CAAC,CAc5B"}

package/dist/testing/fixtures/index.js

@@ -0,0 +1,220 @@
+/**
+ * Shared test fixtures: typed builders for the daemon's core domain objects.
+ *
+ * Before this module, makeDelivery / makeIssue / makeConfig were copy-pasted
+ * into ~30 test files each, so a single field change to FocusDeliveryInfo /
+ * FocusIssueInfo / DaemonConfig meant editing dozens of files. These builders
+ * are the single source of truth; a type change is now one edit here.
+ *
+ * Each builder is a SUPERSET: it takes a `Partial<T>` of overrides spread last,
+ * so every existing call site keeps its specificity. The defaults below are the
+ * MAJORITY defaults observed across the suite; a file whose local builder used a
+ * different default keeps that default by passing it as an override (often via a
+ * thin file-local wrapper) so no test changes meaning.
+ *
+ * NOT included by design: `makeDeps` and `makeContext`. Those names collide
+ * across UNRELATED types -- makeDeps builds AdvanceDeliveryDeps /
+ * WorktreeStateDeps / SessionHealthDeps / various per-module `opts`; makeContext
+ * builds FocusTeamPromptContext / AssemblyContext / EvaluationContext. They are
+ * not one builder and cannot be merged into one typed function without a union
+ * or `any`, so they stay per-file. (See the delivery loop doc for the survey.)
+ */
+/**
+ * Build a FocusDeliveryInfo. Default executionStatus is 'queued' (the majority
+ * default across the suite); pass `{ executionStatus: ... }` for other states.
+ */
+export function makeDelivery(overrides = {}) {
+    return {
+        id: 'd1',
+        name: 'Test Delivery',
+        description: null,
+        priorityRank: 0,
+        executionStatus: 'queued',
+        acceptanceCriteria: null,
+        techContext: null,
+        currentWorkflowStageId: null,
+        mergeCommitSha: null,
+        gitState: null,
+        injectionId: null,
+        stageDescription: null,
+        updatedAt: null,
+        gateState: null,
+        iterationCount: 0,
+        ...overrides,
+    };
+}
+/**
+ * Build a FocusIssueInfo. Defaults to a To Do / Task issue on delivery-1.
+ */
+export function makeIssue(overrides = {}) {
+    return {
+        id: 'issue-1',
+        key: 'TEL-1',
+        title: 'Test Issue',
+        description: null,
+        status: 'To Do',
+        issueType: 'Task',
+        priority: 'P1',
+        deliveryId: 'delivery-1',
+        parentIssueId: null,
+        context: null,
+        relevantFiles: null,
+        dependsOn: null,
+        createdByRoleId: null,
+        createdAt: null,
+        ...overrides,
+    };
+}
+/**
+ * Build a DaemonConfig. Single-product, telemetry disabled, integration branch
+ * 'integration'. Pass overrides for product/branch/limits specifics.
+ */
+export function makeConfig(overrides = {}) {
+    return {
+        teloraUrl: 'http://localhost',
+        trackerId: 'test-tracker',
+        organizationId: 'org-1',
+        productId: 'product-1',
+        repoPath: '/tmp/test-repo',
+        worktreeDir: '/tmp/test-repo/.telora/worktrees',
+        integrationBranch: 'integration',
+        claudeCodePath: 'claude',
+        logDir: '/tmp/test-repo/.telora/logs',
+        maxTotalSessions: 5,
+        sessionTimeoutMs: 3600000,
+        tokenLimit: 200000,
+        costLimit: 10.0,
+        mergeLockTimeoutMs: 300000,
+        mergeLockContentionWarningMs: 30000,
+        policyFailureMode: 'fail-open',
+        logMaxAgeDays: 7,
+        logMaxTotalBytes: 1073741824,
+        logMaxFiles: 500,
+        telemetry: { enabled: false, port: 4318, flushIntervalMs: 5000, retentionDays: 30 },
+        lacuna: { enabled: false, host: '127.0.0.1', port: 8787, compressEnabled: true, readyTimeoutMs: 30000 },
+        products: [{ id: 'product-1', repoPath: '/tmp/test-repo' }],
+        ...overrides,
+    };
+}
+/**
+ * Build a FocusExecutionConfig. Defaults match DEFAULT_EXECUTION_CONFIG
+ * (maxWorkers 3, idle 30s, active 60s).
+ */
+export function makeFocusExecutionConfig(overrides = {}) {
+    return {
+        maxWorkers: 3,
+        idlePollIntervalMs: 30000,
+        activePollIntervalMs: 60000,
+        ...overrides,
+    };
+}
+/**
+ * Build a FocusTeamState -- the wide in-memory team record. Centralizes the
+ * `makeTeam` / `makeTeamState` helpers that were copy-pasted into the
+ * focus-engine / watchdog / stall test files. Defaults to an executing coding
+ * team with no live process (leadPid/leadStdin null); pass overrides for the
+ * dimension under test. The many OPTIONAL clocks (lastActivityAt, shuttingDownAt,
+ * lastHandoffAt, toolActivityCount, ...) are omitted by default -- set them via
+ * the focus-team-state helpers or an override.
+ */
+export function makeFocusTeamState(overrides = {}) {
+    return {
+        focusId: 'focus-1',
+        focusName: 'Test Focus',
+        roleId: 'role-1',
+        roleName: 'Developer',
+        organizationId: 'org-1',
+        productId: 'product-1',
+        executionConfig: makeFocusExecutionConfig(),
+        pipelineConfig: null,
+        startedAt: new Date(0),
+        phase: 'executing',
+        knownDeliveryIds: new Set(),
+        mergedDeliveryIds: new Set(),
+        planningPhase: false,
+        leadSessionId: null,
+        leadPid: null,
+        leadStdin: null,
+        branchName: 'agent/dev/test',
+        worktreePath: null,
+        integrationBaseSha: null,
+        reviewSpawnTip: null,
+        deliveryStageIds: new Map(),
+        resolvingMergeConflict: false,
+        shutdownReason: null,
+        readOnly: false,
+        sessionType: 'coding',
+        lineage: 'coding',
+        completionDetector: null,
+        claudeSessionId: null,
+        lastProgressSnapshot: null,
+        noProgressCycles: 0,
+        commitNudgeAttempts: 0,
+        lastConsumedDirectiveHash: null,
+        ...overrides,
+    };
+}
+// ---------------------------------------------------------------------------
+// Wide *Deps builders.
+//
+// Each returns a Partial<XDeps> seeded with type-trivial no-op stubs (the
+// DB/IO functions tests must neutralize + the scalar identity fields), spread
+// with overrides. Partial -- NOT the full type -- because every consuming engine
+// takes `Partial<XDeps>` and merges its own production `defaultDeps`: a test
+// passes this seed, overrides the fields it asserts on, and the module fills the
+// rest. Fields with complex non-void return shapes are left to the override /
+// the module default rather than faked here.
+// ---------------------------------------------------------------------------
+/** Seed a VerificationDeps (verify/verification-engine runVerificationTick). */
+export function makeVerificationDeps(overrides = {}) {
+    return {
+        organizationId: 'org-1',
+        integrationBranch: 'integration',
+        getPendingVerifications: async () => [],
+        recordOutcome: async () => { },
+        verifyInjection: async () => { },
+        fileEscalation: async () => { },
+        emitDriftProposal: async () => { },
+        emitInwardDrift: async () => { },
+        resolveCwd: () => '/tmp/test-repo',
+        getActiveFocuses: async () => [],
+        getFocusDeliveries: async () => [],
+        ...overrides,
+    };
+}
+/** Seed a CompletionEventDeps (completion/event handleCompletionEvent). */
+export function makeCompletionEventDeps(overrides = {}) {
+    return {
+        getFocusDeliveries: async () => [],
+        getFocusIssues: async () => [],
+        createEscalation: async () => { },
+        terminateTeam: () => false,
+        hasOpenTeamFailureEscalation: async () => false,
+        ...overrides,
+    };
+}
+/** Seed an AutoInjectDeps (security/security-auto-inject). */
+export function makeAutoInjectDeps(overrides = {}) {
+    return {
+        linkFinding: async () => { },
+        writeAudit: async () => { },
+        ...overrides,
+    };
+}
+/** Seed a PrdControllerDeps (prd/controller). */
+export function makePrdControllerDeps(overrides = {}) {
+    return {
+        organizationId: 'org-1',
+        worktreeDir: '/tmp/test-repo/.telora/worktrees',
+        loadPrtGraph: async () => ({ nodes: [], edges: [] }),
+        markNodeCleared: async () => { },
+        armFocus: async () => { },
+        markPrdDone: async () => { },
+        resolveArmRoleId: async () => null,
+        loadPathways: async () => [],
+        commitPathway: async () => { },
+        fileEscalation: async () => { },
+        ...overrides,
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/testing/fixtures/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/testing/fixtures/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAcH;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,YAAwC,EAAE;IACrE,OAAO;QACL,EAAE,EAAE,IAAI;QACR,IAAI,EAAE,eAAe;QACrB,WAAW,EAAE,IAAI;QACjB,YAAY,EAAE,CAAC;QACf,eAAe,EAAE,QAAQ;QACzB,kBAAkB,EAAE,IAAI;QACxB,WAAW,EAAE,IAAI;QACjB,sBAAsB,EAAE,IAAI;QAC5B,cAAc,EAAE,IAAI;QACpB,QAAQ,EAAE,IAAI;QACd,WAAW,EAAE,IAAI;QACjB,gBAAgB,EAAE,IAAI;QACtB,SAAS,EAAE,IAAI;QACf,SAAS,EAAE,IAAI;QACf,cAAc,EAAE,CAAC;QACjB,GAAG,SAAS;KACb,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,YAAqC,EAAE;IAC/D,OAAO;QACL,EAAE,EAAE,SAAS;QACb,GAAG,EAAE,OAAO;QACZ,KAAK,EAAE,YAAY;QACnB,WAAW,EAAE,IAAI;QACjB,MAAM,EAAE,OAAO;QACf,SAAS,EAAE,MAAM;QACjB,QAAQ,EAAE,IAAI;QACd,UAAU,EAAE,YAAY;QACxB,aAAa,EAAE,IAAI;QACnB,OAAO,EAAE,IAAI;QACb,aAAa,EAAE,IAAI;QACnB,SAAS,EAAE,IAAI;QACf,eAAe,EAAE,IAAI;QACrB,SAAS,EAAE,IAAI;QACf,GAAG,SAAS;KACb,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,YAAmC,EAAE;IAC9D,OAAO;QACL,SAAS,EAAE,kBAAkB;QAC7B,SAAS,EAAE,cAAc;QACzB,cAAc,EAAE,OAAO;QACvB,SAAS,EAAE,WAAW;QACtB,QAAQ,EAAE,gBAAgB;QAC1B,WAAW,EAAE,kCAAkC;QAC/C,iBAAiB,EAAE,aAAa;QAChC,cAAc,EAAE,QAAQ;QACxB,MAAM,EAAE,6BAA6B;QACrC,gBAAgB,EAAE,CAAC;QACnB,gBAAgB,EAAE,OAAO;QACzB,UAAU,EAAE,MAAM;QAClB,SAAS,EAAE,IAAI;QACf,kBAAkB,EAAE,MAAM;QAC1B,4BAA4B,EAAE,KAAK;QACnC,iBAAiB,EAAE,WAAW;QAC9B,aAAa,EAAE,CAAC;QAChB,gBAAgB,EAAE,UAAU;QAC5B,WAAW,EAAE,GAAG;QAChB,SAAS,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE,aAAa,EAAE,EAAE,EAAE;QACnF,MAAM,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE;QACvG,QAAQ,EAAE,CAAC,EAAE,EAAE,EAAE,WAAW,EAAE,QAAQ,EAAE,gBAAgB,EAAE,CAAC;QAC3D,GAAG,SAAS;KACG,CAAC;AACpB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,wBAAwB,CACtC,YAA2C,EAAE;IAE7C,OAAO;QACL,UAAU,EAAE,CAAC;QACb,kBAAkB,EAAE,KAAK;QACzB,oBAAoB,EAAE,KAAK;QAC3B,GAAG,SAAS;KACb,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,kBAAkB,CAAC,YAAqC,EAAE;IACxE,OAAO;QACL,OAAO,EAAE,SAAS;QAClB,SAAS,EAAE,YAAY;QACvB,MAAM,EAAE,QAAQ;QAChB,QAAQ,EAAE,WAAW;QACrB,cAAc,EAAE,OAAO;QACvB,SAAS,EAAE,WAAW;QACtB,eAAe,EAAE,wBAAwB,EAAE;QAC3C,cAAc,EAAE,IAAI;QACpB,SAAS,EAAE,IAAI,IAAI,CAAC,CAAC,CAAC;QACtB,KAAK,EAAE,WAAW;QAClB,gBAAgB,EAAE,IAAI,GAAG,EAAU;QACnC,iBAAiB,EAAE,IAAI,GAAG,EAAU;QACpC,aAAa,EAAE,KAAK;QACpB,aAAa,EAAE,IAAI;QACnB,OAAO,EAAE,IAAI;QACb,SAAS,EAAE,IAAI;QACf,UAAU,EAAE,gBAAgB;QAC5B,YAAY,EAAE,IAAI;QAClB,kBAAkB,EAAE,IAAI;QACxB,cAAc,EAAE,IAAI;QACpB,gBAAgB,EAAE,IAAI,GAAG,EAAyB;QAClD,sBAAsB,EAAE,KAAK;QAC7B,cAAc,EAAE,IAAI;QACpB,QAAQ,EAAE,KAAK;QACf,WAAW,EAAE,QAAQ;QACrB,OAAO,EAAE,QAAQ;QACjB,kBAAkB,EAAE,IAAI;QACxB,eAAe,EAAE,IAAI;QACrB,oBAAoB,EAAE,IAAI;QAC1B,gBAAgB,EAAE,CAAC;QACnB,mBAAmB,EAAE,CAAC;QACtB,yBAAyB,EAAE,IAAI;QAC/B,GAAG,SAAS;KACb,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,uBAAuB;AACvB,EAAE;AACF,0EAA0E;AAC1E,8EAA8E;AAC9E,iFAAiF;AACjF,6EAA6E;AAC7E,iFAAiF;AACjF,8EAA8E;AAC9E,6CAA6C;AAC7C,8EAA8E;AAE9E,gFAAgF;AAChF,MAAM,UAAU,oBAAoB,CAClC,YAAuC,EAAE;IAEzC,OAAO;QACL,cAAc,EAAE,OAAO;QACvB,iBAAiB,EAAE,aAAa;QAChC,uBAAuB,EAAE,KAAK,IAAI,EAAE,CAAC,EAAE;QACvC,aAAa,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;QAC7B,eAAe,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;QAC/B,cAAc,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;QAC9B,iBAAiB,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;QACjC,eAAe,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;QAC/B,UAAU,EAAE,GAAG,EAAE,CAAC,gBAAgB;QAClC,gBAAgB,EAAE,KAAK,IAAI,EAAE,CAAC,EAAE;QAChC,kBAAkB,EAAE,KAAK,IAAI,EAAE,CAAC,EAAE;QAClC,GAAG,SAAS;KACb,CAAC;AACJ,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,uBAAuB,CACrC,YAA0C,EAAE;IAE5C,OAAO;QACL,kBAAkB,EAAE,KAAK,IAAI,EAAE,CAAC,EAAE;QAClC,cAAc,EAAE,KAAK,IAAI,EAAE,CAAC,EAAE;QAC9B,gBAAgB,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;QAChC,aAAa,EAAE,GAAG,EAAE,CAAC,KAAK;QAC1B,4BAA4B,EAAE,KAAK,IAAI,EAAE,CAAC,KAAK;QAC/C,GAAG,SAAS;KACb,CAAC;AACJ,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,kBAAkB,CAChC,YAAqC,EAAE;IAEvC,OAAO;QACL,WAAW,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;QAC3B,UAAU,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;QAC1B,GAAG,SAAS;KACb,CAAC;AACJ,CAAC;AAED,iDAAiD;AACjD,MAAM,UAAU,qBAAqB,CACnC,YAAwC,EAAE;IAE1C,OAAO;QACL,cAAc,EAAE,OAAO;QACvB,WAAW,EAAE,kCAAkC;QAC/C,YAAY,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;QACpD,eAAe,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;QAC/B,QAAQ,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;QACxB,WAAW,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;QAC3B,gBAAgB,EAAE,KAAK,IAAI,EAAE,CAAC,IAAI;QAClC,YAAY,EAAE,KAAK,IAAI,EAAE,CAAC,EAAE;QAC5B,aAAa,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;QAC7B,cAAc,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;QAC9B,GAAG,SAAS;KACb,CAAC;AACJ,CAAC"}

package/dist/update/build-info.d.ts

@@ -12,6 +12,7 @@ export interface BuildInfo {
     builtAt: string;
     expectedMigrations: string[];
 }
+export declare function defaultBuildInfoPath(): string;
 export declare function readBuildInfo(path?: string, reader?: (p: string) => string): BuildInfo;
 export declare function getExpectedMigrations(path?: string, reader?: (p: string) => string): string[];
 //# sourceMappingURL=build-info.d.ts.map

package/dist/update/build-info.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"build-info.d.ts","sourceRoot":"","sources":["../../src/update/build-info.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,kBAAkB,EAAE,MAAM,EAAE,CAAC;CAC9B;AAiBD,wBAAgB,aAAa,CAC3B,IAAI,GAAE,MAA+B,EACrC,MAAM,GAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAwC,GAC9D,SAAS,CAYX;AAED,wBAAgB,qBAAqB,CACnC,IAAI,CAAC,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,GAC7B,MAAM,EAAE,CAEV"}
+{"version":3,"file":"build-info.d.ts","sourceRoot":"","sources":["../../src/update/build-info.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,kBAAkB,EAAE,MAAM,EAAE,CAAC;CAC9B;AAQD,wBAAgB,oBAAoB,IAAI,MAAM,CAO7C;AAED,wBAAgB,aAAa,CAC3B,IAAI,GAAE,MAA+B,EACrC,MAAM,GAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAwC,GAC9D,SAAS,CAYX;AAED,wBAAgB,qBAAqB,CACnC,IAAI,CAAC,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,GAC7B,MAAM,EAAE,CAEV"}

package/dist/update/build-info.js

@@ -15,7 +15,7 @@ const EMPTY = {
     builtAt: '1970-01-01T00:00:00.000Z',
     expectedMigrations: [],
 };
-function defaultBuildInfoPath() {
+export function defaultBuildInfoPath() {
     // packages/daemon/src/build-info.ts (source)
     //   -> packages/daemon/build-info.json
     // packages/daemon/dist/build-info.js (compiled)

package/dist/update/build-info.js.map

@@ -1 +1 @@
-{"version":3,"file":"build-info.js","sourceRoot":"","sources":["../../src/update/build-info.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQ7C,MAAM,KAAK,GAAc;IACvB,SAAS,EAAE,SAAS;IACpB,OAAO,EAAE,0BAA0B;IACnC,kBAAkB,EAAE,EAAE;CACvB,CAAC;AAEF,SAAS,oBAAoB;IAC3B,6CAA6C;IAC7C,uCAAuC;IACvC,gDAAgD;IAChD,uCAAuC;IACvC,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACrD,OAAO,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,iBAAiB,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,aAAa,CAC3B,OAAe,oBAAoB,EAAE,EACrC,SAAgC,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,CAAC,EAAE,OAAO,CAAC;IAE/D,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;QACzB,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAuB,CAAC;QACrD,OAAO;YACL,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,KAAK,CAAC,SAAS;YAC9C,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,KAAK,CAAC,OAAO;YACxC,kBAAkB,EAAE,MAAM,CAAC,kBAAkB,IAAI,EAAE;SACpD,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,IAAa,EACb,MAA8B;IAE9B,OAAO,aAAa,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,kBAAkB,CAAC;AACxD,CAAC"}
+{"version":3,"file":"build-info.js","sourceRoot":"","sources":["../../src/update/build-info.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQ7C,MAAM,KAAK,GAAc;IACvB,SAAS,EAAE,SAAS;IACpB,OAAO,EAAE,0BAA0B;IACnC,kBAAkB,EAAE,EAAE;CACvB,CAAC;AAEF,MAAM,UAAU,oBAAoB;IAClC,6CAA6C;IAC7C,uCAAuC;IACvC,gDAAgD;IAChD,uCAAuC;IACvC,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACrD,OAAO,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,iBAAiB,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,aAAa,CAC3B,OAAe,oBAAoB,EAAE,EACrC,SAAgC,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,CAAC,EAAE,OAAO,CAAC;IAE/D,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;QACzB,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAuB,CAAC;QACrD,OAAO;YACL,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,KAAK,CAAC,SAAS;YAC9C,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,KAAK,CAAC,OAAO;YACxC,kBAAkB,EAAE,MAAM,CAAC,kBAAkB,IAAI,EAAE;SACpD,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,IAAa,EACb,MAA8B;IAE9B,OAAO,aAAa,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,kBAAkB,CAAC;AACxD,CAAC"}

package/dist/verify/stall-detector-config.d.ts

@@ -16,4 +16,12 @@ export declare function resolveReviewWindowStaleHours(): number;
 export declare function resolveReviewCycleCap(): number;
 /** Resolve the idle-team stall threshold in hours (env override or default). */
 export declare function resolveIdleTeamStallHours(): number;
+/** Resolve the review-exit hand-off cap (env override or default 3). */
+export declare function resolveReviewHandoffCap(): number;
+/** Resolve the review-liveness window in minutes (env override or default 15). */
+export declare function resolveReviewLivenessWindowMinutes(): number;
+/** Resolve the respawn-cycle max total duration in hours (env override or default 2). */
+export declare function resolveRespawnCycleMaxHours(): number;
+/** Resolve the respawn-cycle max cumulative teardown count (env override or default 12). */
+export declare function resolveRespawnCycleMaxCount(): number;
 //# sourceMappingURL=stall-detector-config.d.ts.map

package/dist/verify/stall-detector-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stall-detector-config.d.ts","sourceRoot":"","sources":["../../src/verify/stall-detector-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,uEAAuE;AACvE,wBAAgB,sBAAsB,IAAI,MAAM,CAE/C;AAED,wFAAwF;AACxF,wBAAgB,6BAA6B,IAAI,MAAM,CAEtD;AAED,0EAA0E;AAC1E,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C;AAED,gFAAgF;AAChF,wBAAgB,yBAAyB,IAAI,MAAM,CAElD"}
+{"version":3,"file":"stall-detector-config.d.ts","sourceRoot":"","sources":["../../src/verify/stall-detector-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAsBH,uEAAuE;AACvE,wBAAgB,sBAAsB,IAAI,MAAM,CAE/C;AAED,wFAAwF;AACxF,wBAAgB,6BAA6B,IAAI,MAAM,CAEtD;AAED,0EAA0E;AAC1E,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C;AAED,gFAAgF;AAChF,wBAAgB,yBAAyB,IAAI,MAAM,CAElD;AASD,wEAAwE;AACxE,wBAAgB,uBAAuB,IAAI,MAAM,CAEhD;AAED,kFAAkF;AAClF,wBAAgB,kCAAkC,IAAI,MAAM,CAE3D;AAED,yFAAyF;AACzF,wBAAgB,2BAA2B,IAAI,MAAM,CAEpD;AAED,4FAA4F;AAC5F,wBAAgB,2BAA2B,IAAI,MAAM,CAEpD"}

package/dist/verify/stall-detector-config.js

@@ -9,6 +9,24 @@
  * can no longer silently fall back to a default on a typo'd value.
  */
 import { loadEnvConfig } from '@telora/daemon-core';
+/**
+ * Raw positive-number env read with a fallback default, for knobs whose canonical
+ * Zod + ENV_VAR_METADATA declaration IS in packages/daemon-core/src/env-config.ts
+ * but which the REGISTRY-INSTALLED daemon-core does not yet carry: the daemon
+ * compiles against the published dist, so loadEnvConfig() cannot see a freshly
+ * added field until a daemon-core republish + pin bump lands. These reads are
+ * allowlisted in scripts/lint-config.json under "env-reads" with that reason.
+ * Once daemon-core is republished + pinned, switch each caller to loadEnvConfig()
+ * and remove the allowlist entry (mirrors the TELORA_SHORTFALL_DISPOSITION_ATTEMPT_CAP
+ * precedent). Invalid (non-positive / non-numeric) values fall back to the default
+ * rather than throwing -- the loud-fail happens at loadEnvConfig once republished.
+ */
+function parsePositive(raw, fallback) {
+    if (raw === undefined || raw === '')
+        return fallback;
+    const n = Number(raw);
+    return Number.isFinite(n) && n > 0 ? n : fallback;
+}
 /** Resolve the verify_failed re-code cap (env override or default). */
 export function resolveVerifyFailedCap() {
     return loadEnvConfig().TELORA_VERIFY_FAILED_ITERATION_CAP;
@@ -25,4 +43,26 @@ export function resolveReviewCycleCap() {
 export function resolveIdleTeamStallHours() {
     return loadEnvConfig().TELORA_IDLE_TEAM_STALL_HOURS;
 }
+// NOTE: the four resolvers below read process.env RAW (via rawPositiveNumber)
+// rather than loadEnvConfig() because their knobs are PENDING a daemon-core
+// republish (see rawPositiveNumber). The canonical declarations already live in
+// packages/daemon-core/src/env-config.ts; switch these to loadEnvConfig() and
+// drop the scripts/lint-config.json env-reads allowlist entries once daemon-core
+// is republished + pinned.
+/** Resolve the review-exit hand-off cap (env override or default 3). */
+export function resolveReviewHandoffCap() {
+    return parsePositive(process.env.TELORA_REVIEW_HANDOFF_CAP, 3);
+}
+/** Resolve the review-liveness window in minutes (env override or default 15). */
+export function resolveReviewLivenessWindowMinutes() {
+    return parsePositive(process.env.TELORA_REVIEW_LIVENESS_WINDOW_MINUTES, 15);
+}
+/** Resolve the respawn-cycle max total duration in hours (env override or default 2). */
+export function resolveRespawnCycleMaxHours() {
+    return parsePositive(process.env.TELORA_RESPAWN_CYCLE_MAX_HOURS, 2);
+}
+/** Resolve the respawn-cycle max cumulative teardown count (env override or default 12). */
+export function resolveRespawnCycleMaxCount() {
+    return parsePositive(process.env.TELORA_RESPAWN_CYCLE_MAX_COUNT, 12);
+}
 //# sourceMappingURL=stall-detector-config.js.map

package/dist/verify/stall-detector-config.js.map

@@ -1 +1 @@
-{"version":3,"file":"stall-detector-config.js","sourceRoot":"","sources":["../../src/verify/stall-detector-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,uEAAuE;AACvE,MAAM,UAAU,sBAAsB;IACpC,OAAO,aAAa,EAAE,CAAC,kCAAkC,CAAC;AAC5D,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,6BAA6B;IAC3C,OAAO,aAAa,EAAE,CAAC,gCAAgC,CAAC;AAC1D,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,qBAAqB;IACnC,OAAO,aAAa,EAAE,CAAC,uBAAuB,CAAC;AACjD,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,yBAAyB;IACvC,OAAO,aAAa,EAAE,CAAC,4BAA4B,CAAC;AACtD,CAAC"}
+{"version":3,"file":"stall-detector-config.js","sourceRoot":"","sources":["../../src/verify/stall-detector-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD;;;;;;;;;;;GAWG;AACH,SAAS,aAAa,CAAC,GAAuB,EAAE,QAAgB;IAC9D,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,EAAE;QAAE,OAAO,QAAQ,CAAC;IACrD,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IACtB,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;AACpD,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,sBAAsB;IACpC,OAAO,aAAa,EAAE,CAAC,kCAAkC,CAAC;AAC5D,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,6BAA6B;IAC3C,OAAO,aAAa,EAAE,CAAC,gCAAgC,CAAC;AAC1D,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,qBAAqB;IACnC,OAAO,aAAa,EAAE,CAAC,uBAAuB,CAAC;AACjD,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,yBAAyB;IACvC,OAAO,aAAa,EAAE,CAAC,4BAA4B,CAAC;AACtD,CAAC;AAED,8EAA8E;AAC9E,4EAA4E;AAC5E,gFAAgF;AAChF,8EAA8E;AAC9E,iFAAiF;AACjF,2BAA2B;AAE3B,wEAAwE;AACxE,MAAM,UAAU,uBAAuB;IACrC,OAAO,aAAa,CAAC,OAAO,CAAC,GAAG,CAAC,yBAAyB,EAAE,CAAC,CAAC,CAAC;AACjE,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,kCAAkC;IAChD,OAAO,aAAa,CAAC,OAAO,CAAC,GAAG,CAAC,qCAAqC,EAAE,EAAE,CAAC,CAAC;AAC9E,CAAC;AAED,yFAAyF;AACzF,MAAM,UAAU,2BAA2B;IACzC,OAAO,aAAa,CAAC,OAAO,CAAC,GAAG,CAAC,8BAA8B,EAAE,CAAC,CAAC,CAAC;AACtE,CAAC;AAED,4FAA4F;AAC5F,MAAM,UAAU,2BAA2B;IACzC,OAAO,aAAa,CAAC,OAAO,CAAC,GAAG,CAAC,8BAA8B,EAAE,EAAE,CAAC,CAAC;AACvE,CAAC"}

package/dist/verify/stall-detectors.d.ts

@@ -109,33 +109,76 @@ export declare function exceedsVerifyFailedCap(delivery: Pick<FocusDeliveryInfo,
 export declare function checkVerifyFailedCapForFocus(ctx: FocusStallContext, deliveries: FocusDeliveryInfo[], deps?: VerifyFailedCapDeps): Promise<void>;
 export interface ReviewWindowDeps {
     /**
-     * File the review_window_stalled escalation through the cause-keyed idempotent
-     * gate: at most one open row per focus, and a dismissed one keeps the same stale
-     * review window silent (dismissal memory) until the focus's review state changes.
+     * Clear the focus's stale review window (review_requested_at = null). The
+     * daemon OWNS this act -- queries/focuses.ts clearReviewRequestedAt, already
+     * called from the review-exit paths -- so a stale window it detects is cleared
+     * by the daemon itself (TEL, delivery 7), not handed to an operator via an
+     * escalation that merely names `telora_product_focus update
+     * clearReviewRequest=true`. Injected for tests. Defaults to clearReviewRequestedAt.
      */
-    fileEscalation: (params: FileEscalationIdempotentParams) => Promise<FileEscalationIdempotentResult>;
-    /** Focus IDs that currently have an active REVIEW team. Defaults to live teams. */
+    clearReviewWindow: (focusId: string) => Promise<void>;
+    /** Focus IDs that currently have a REVIEW team PRESENT. Defaults to live teams. */
     activeReviewFocusIds: () => Set<string>;
+    /**
+     * The review team's per-team last-activity epoch ms, or null when nothing has
+     * been recorded yet. Presence alone is not liveness -- this distinguishes a
+     * review that is genuinely progressing from a respawn loop's idle-exiting
+     * teams. Defaults to the live per-team activity clock.
+     */
+    getReviewTeamLastActivityAt: (focusId: string) => number | null;
     /** Current epoch ms; injectable for tests. Defaults to Date.now. */
     now?: () => number;
     /** Override the staleness threshold (hours) for tests; defaults to env-config. */
     thresholdHours?: number;
+    /** Override the review-liveness window (minutes) for tests; defaults to env-config. */
+    livenessWindowMinutes?: number;
 }
 /** Focus IDs that currently have an active REVIEW team (live default). */
 export declare function activeReviewFocusIds(): Set<string>;
+/**
+ * Pure decision: is a review GENUINELY active -- progressing, not merely present?
+ *
+ * Mere team presence is NOT liveness: a loop that respawns an idle review team
+ * every few minutes always has a team present, so presence taken as "a review is
+ * running" starves the very staleness escalation that exists to catch the loop.
+ * A review counts as genuinely active only when a team is present AND its
+ * per-team activity clock is fresh (last agent event within `livenessWindowMs`).
+ *
+ * A frozen clock (an idle-exiting respawn team) or a null clock (present but has
+ * produced no event) is NOT genuinely active. Treating null as not-active is safe
+ * because it only matters once review_requested_at is itself past the staleness
+ * threshold (isReviewWindowStale gates on that first): a just-spawned review is
+ * within the threshold and never trips, but a "review" that has produced zero
+ * events for hours is exactly the wedge. Mirrors the sibling team-idle detector's
+ * liveness-not-presence distinction. Exported for direct unit testing.
+ */
+export declare function isReviewGenuinelyActive(hasReviewTeam: boolean, lastReviewActivityMs: number | null, nowMs: number, livenessWindowMs: number): boolean;
 /**
  * Pure decision: is this focus's review window stale? True when a
- * review_requested_at exists, is older than `thresholdMs`, and the focus has no
- * active review team. A completed review clears review_requested_at, so a
- * still-set timestamp older than the threshold with no active review team means
- * the review never ran (or never finished). Exported for direct unit testing.
+ * review_requested_at exists, is older than `thresholdMs`, and NO review is
+ * GENUINELY ACTIVE (progressing) on the focus. A completed review clears
+ * review_requested_at, so a still-set timestamp older than the threshold with no
+ * genuinely-active review means the review never ran, never finished, OR is stuck
+ * in a respawn loop whose idle-exiting teams never progress. The second argument
+ * is genuine liveness (isReviewGenuinelyActive), NOT mere team presence -- that is
+ * what stops the loop's own respawns from masking the stale window. Exported for
+ * direct unit testing.
  */
-export declare function isReviewWindowStale(reviewRequestedAt: string | null, hasActiveReview: boolean, nowMs: number, thresholdMs: number): boolean;
+export declare function isReviewWindowStale(reviewRequestedAt: string | null, reviewGenuinelyActive: boolean, nowMs: number, thresholdMs: number): boolean;
 /**
- * Check ONE focus for a stale review window and file a review_window_stalled
- * escalation (needs_operator) -- at most one open per focus. The caller
- * (runCascadeChecks) passes the focus's review_requested_at, so this rides the
- * existing review-handling seam rather than fanning out its own focus scan.
+ * Check ONE focus for a stale review window and, when stale, CLEAR it -- the
+ * daemon owns the clearing act (clearReviewRequestedAt), so it does not file a
+ * needs_operator escalation that merely names the same operator MCP call
+ * (`clearReviewRequest=true`) it could perform itself (TEL, delivery 7). The
+ * caller (runCascadeChecks) passes the focus's review_requested_at, so this
+ * rides the existing review-handling seam rather than fanning out its own scan.
+ *
+ * Why clearing is the right autonomous act: a stale window (threshold exceeded,
+ * no genuinely-active review) means the review never ran or is stuck in a
+ * respawn loop. focus-phase.ts returns 'reviewing' while review_requested_at is
+ * set, so winding_down is unreachable until it clears. Clearing unblocks the
+ * phase; if a review genuinely still needs to run, the normal auto-review path
+ * re-opens the window -- self-healing on the same detector, never a human hold.
  */
 export declare function checkReviewWindowStaleForFocus(ctx: FocusStallContext, reviewRequestedAt: string | null, deps?: ReviewWindowDeps): Promise<void>;
 export interface IdleTeamStallDeps {

package/dist/verify/stall-detectors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stall-detectors.d.ts","sourceRoot":"","sources":["../../src/verify/stall-detectors.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"stall-detectors.d.ts","sourceRoot":"","sources":["../../src/verify/stall-detectors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAM3D,OAAO,EAEL,KAAK,8BAA8B,EACnC,KAAK,8BAA8B,EACpC,MAAM,sCAAsC,CAAC;AAiB9C;;;;;;;;;;GAUG;AACH,eAAO,MAAM,4BAA4B,4BAA4B,CAAC;AACtE,eAAO,MAAM,0BAA0B,0BAA0B,CAAC;AAElE,yEAAyE;AACzE,MAAM,WAAW,iBAAiB;IAChC,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAgCD,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,cAAc,EAAE,CAAC,MAAM,EAAE,8BAA8B,KAAK,OAAO,CAAC,8BAA8B,CAAC,CAAC;IACpG,6EAA6E;IAC7E,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAMD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,OAAO,GAAG,OAAO,CAIhE;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,IAAI,CAAC,iBAAiB,EAAE,iBAAiB,GAAG,gBAAgB,GAAG,WAAW,CAAC,EACrF,GAAG,EAAE,MAAM,GACV,OAAO,CAIT;AAED;;;;;;GAMG;AACH,wBAAsB,4BAA4B,CAChD,GAAG,EAAE,iBAAiB,EACtB,UAAU,EAAE,iBAAiB,EAAE,EAC/B,IAAI,GAAE,mBAAgD,GACrD,OAAO,CAAC,IAAI,CAAC,CAiEf;AAID,MAAM,WAAW,gBAAgB;IAC/B;;;;;;;OAOG;IACH,iBAAiB,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD,mFAAmF;IACnF,oBAAoB,EAAE,MAAM,GAAG,CAAC,MAAM,CAAC,CAAC;IACxC;;;;;OAKG;IACH,2BAA2B,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;IAChE,oEAAoE;IACpE,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,kFAAkF;IAClF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,uFAAuF;IACvF,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,0EAA0E;AAC1E,wBAAgB,oBAAoB,IAAI,GAAG,CAAC,MAAM,CAAC,CAMlD;AASD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,uBAAuB,CACrC,aAAa,EAAE,OAAO,EACtB,oBAAoB,EAAE,MAAM,GAAG,IAAI,EACnC,KAAK,EAAE,MAAM,EACb,gBAAgB,EAAE,MAAM,GACvB,OAAO,CAIT;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CACjC,iBAAiB,EAAE,MAAM,GAAG,IAAI,EAChC,qBAAqB,EAAE,OAAO,EAC9B,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,GAClB,OAAO,CAMT;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,8BAA8B,CAClD,GAAG,EAAE,iBAAiB,EACtB,iBAAiB,EAAE,MAAM,GAAG,IAAI,EAChC,IAAI,GAAE,gBAA0C,GAC/C,OAAO,CAAC,IAAI,CAAC,CA4Cf;AAID,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,iBAAiB,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;IACtD;;;;;;OAMG;IACH,iBAAiB,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC;IAChD;;;;;;;OAOG;IACH,WAAW,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC;IAC1C,oEAAoE;IACpE,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,wEAAwE;IACxE,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,6EAA6E;AAC7E,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAG1D;AASD;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAC/B,cAAc,EAAE,MAAM,GAAG,IAAI,EAC7B,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,GAClB,OAAO,CAGT;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,iBAAiB,EACtB,IAAI,GAAE,iBAA4C,GACjD,IAAI,CAwBN"}