factory-factory 0.3.17 → 0.3.19

package/dist/src/backend/services/periodic-task/service/periodic-task.service.d.ts

@@ -1,5 +1,7 @@
 import type { createLogger } from '../../../../backend/services/logger.service.js';
+import { WorkspaceStatus } from '../../../../shared/core/index.js';
 type Logger = ReturnType<typeof createLogger>;
+export declare const PERIODIC_TASK_READY_WITHOUT_PR_GRACE_MS: number;
 export interface PeriodicTaskWorkspaceBridge {
     createWorkspaceForTask(params: {
         projectId: string;
@@ -12,9 +14,11 @@ export interface PeriodicTaskWorkspaceBridge {
 }
 export interface PeriodicTaskWorkspaceStatusBridge {
     getWorkspaceStatus(workspaceId: string): Promise<{
-        status: string;
+        status: WorkspaceStatus;
         prUrl: string | null;
         prNumber: number | null;
+        isAgentWorking: boolean;
+        initCompletedAt: Date | null;
     } | null>;
 }
 export declare class PeriodicTaskService {

package/dist/src/backend/services/periodic-task/service/periodic-task.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"periodic-task.service.d.ts","sourceRoot":"","sources":["../../../../../../src/backend/services/periodic-task/service/periodic-task.service.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AAItE,KAAK,MAAM,GAAG,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC;AAG9C,MAAM,WAAW,2BAA2B;IAC1C,sBAAsB,CAAC,MAAM,EAAE;QAC7B,SAAS,EAAE,MAAM,CAAC;QAClB,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,cAAc,EAAE,MAAM,CAAC;KACxB,GAAG,OAAO,CAAC;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACtC;AAGD,MAAM,WAAW,iCAAiC;IAChD,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC;QAC/C,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;QACrB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;KACzB,GAAG,IAAI,CAAC,CAAC;CACX;AAED,qBAAa,mBAAmB;IASlB,OAAO,CAAC,QAAQ,CAAC,MAAM;IARnC,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAA8B;IAC9C,OAAO,CAAC,YAAY,CAA+B;IACnD,OAAO,CAAC,YAAY,CAA6B;IAEjD,OAAO,CAAC,eAAe,CAA4C;IACnE,OAAO,CAAC,YAAY,CAAkD;gBAEzC,MAAM,EAAE,MAAM;IAE3C,SAAS,CAAC,OAAO,EAAE;QACjB,SAAS,EAAE,2BAA2B,CAAC;QACvC,MAAM,EAAE,iCAAiC,CAAC;KAC3C,GAAG,IAAI;IAKR,KAAK,IAAI,IAAI;IASP,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;YAab,OAAO;YAiBP,YAAY;YAwCZ,YAAY;YAuCZ,sBAAsB;YActB,oBAAoB;IAiDlC,OAAO,CAAC,KAAK;IAWb,OAAO,CAAC,SAAS;CAUlB"}
+{"version":3,"file":"periodic-task.service.d.ts","sourceRoot":"","sources":["../../../../../../src/backend/services/periodic-task/service/periodic-task.service.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AAEtE,OAAO,EAA4B,eAAe,EAAE,MAAM,eAAe,CAAC;AAE1E,KAAK,MAAM,GAAG,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC;AAE9C,eAAO,MAAM,uCAAuC,QAAa,CAAC;AAGlE,MAAM,WAAW,2BAA2B;IAC1C,sBAAsB,CAAC,MAAM,EAAE;QAC7B,SAAS,EAAE,MAAM,CAAC;QAClB,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,cAAc,EAAE,MAAM,CAAC;KACxB,GAAG,OAAO,CAAC;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACtC;AAGD,MAAM,WAAW,iCAAiC;IAChD,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC;QAC/C,MAAM,EAAE,eAAe,CAAC;QACxB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;QACrB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;QACxB,cAAc,EAAE,OAAO,CAAC;QACxB,eAAe,EAAE,IAAI,GAAG,IAAI,CAAC;KAC9B,GAAG,IAAI,CAAC,CAAC;CACX;AAED,qBAAa,mBAAmB;IASlB,OAAO,CAAC,QAAQ,CAAC,MAAM;IARnC,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAA8B;IAC9C,OAAO,CAAC,YAAY,CAA+B;IACnD,OAAO,CAAC,YAAY,CAA6B;IAEjD,OAAO,CAAC,eAAe,CAA4C;IACnE,OAAO,CAAC,YAAY,CAAkD;gBAEzC,MAAM,EAAE,MAAM;IAE3C,SAAS,CAAC,OAAO,EAAE;QACjB,SAAS,EAAE,2BAA2B,CAAC;QACvC,MAAM,EAAE,iCAAiC,CAAC;KAC3C,GAAG,IAAI;IAKR,KAAK,IAAI,IAAI;IASP,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;YAab,OAAO;YAiBP,YAAY;YA2CZ,YAAY;YAgDZ,sBAAsB;YActB,oBAAoB;IAkElC,OAAO,CAAC,KAAK;IAWb,OAAO,CAAC,SAAS;CAUlB"}

package/dist/src/backend/services/periodic-task/service/periodic-task.service.js

@@ -1,6 +1,8 @@
 import { toError } from '../../../../backend/lib/error-utils.js';
 import { SERVICE_INTERVAL_MS } from '../../../../backend/services/constants.js';
 import { periodicTaskAccessor } from '../../../../backend/services/periodic-task/resources/periodic-task.accessor.js';
+import { WorkspaceStatus } from '../../../../shared/core/index.js';
+export const PERIODIC_TASK_READY_WITHOUT_PR_GRACE_MS = 5 * 60_000;
 export class PeriodicTaskService {
     logger;
     isShuttingDown = false;
@@ -67,7 +69,7 @@ export class PeriodicTaskService {
                     });
                     continue;
                 }
-                await this.dispatchTask(task.id, task.projectId, task.name, task.prompt, task.cadence);
+                await this.dispatchTask(task.id, task.projectId, task.name, task.prompt, task.cadence, task.scheduledTime, task.timezone, task.scheduledDayOfMonth);
             }
             catch (error) {
                 this.logger.error('Failed to dispatch periodic task', {
@@ -77,13 +79,13 @@ export class PeriodicTaskService {
             }
         }
     }
-    async dispatchTask(taskId, projectId, name, prompt, cadence) {
+    async dispatchTask(taskId, projectId, name, prompt, cadence, scheduledTime, timezone, scheduledDayOfMonth) {
         if (!this.workspaceBridge) {
             this.logger.warn('Periodic task service not configured — skipping dispatch');
             return;
         }
         this.logger.info('Dispatching periodic task', { taskId, name });
-        await periodicTaskAccessor.markDispatched(taskId, cadence);
+        await periodicTaskAccessor.markDispatched(taskId, cadence, scheduledTime, timezone, scheduledDayOfMonth);
         const result = await this.workspaceBridge.createWorkspaceForTask({
             projectId,
             name: `${name} — ${new Date().toLocaleDateString()}`,
@@ -134,7 +136,7 @@ export class PeriodicTaskService {
                 });
                 return;
             }
-            if (ws.status === 'FAILED' || ws.status === 'ARCHIVED') {
+            if (ws.status === WorkspaceStatus.FAILED || ws.status === WorkspaceStatus.ARCHIVED) {
                 await periodicTaskAccessor.updateExecution(execution.id, {
                     status: 'FAILED',
                     errorMessage: `Workspace ended in ${ws.status} state`,
@@ -144,6 +146,20 @@ export class PeriodicTaskService {
                     executionId: execution.id,
                     workspaceStatus: ws.status,
                 });
+                return;
+            }
+            const readyWithoutPrGraceElapsed = ws.initCompletedAt !== null &&
+                Date.now() - ws.initCompletedAt.getTime() >= PERIODIC_TASK_READY_WITHOUT_PR_GRACE_MS;
+            if (ws.status === WorkspaceStatus.READY && !ws.isAgentWorking && readyWithoutPrGraceElapsed) {
+                await periodicTaskAccessor.updateExecution(execution.id, {
+                    status: 'FAILED',
+                    errorMessage: 'Workspace is READY without a PR and no agent work is active',
+                    completedAt: new Date(),
+                });
+                this.logger.warn('Periodic task execution finished without PR', {
+                    executionId: execution.id,
+                    workspaceStatus: ws.status,
+                });
             }
         }
         catch (error) {

package/dist/src/backend/services/periodic-task/service/periodic-task.service.js.map

@@ -1 +1 @@
-{"version":3,"file":"periodic-task.service.js","sourceRoot":"","sources":["../../../../../../src/backend/services/periodic-task/service/periodic-task.service.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAEnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,mEAAmE,CAAC;AAwBzG,MAAM,OAAO,mBAAmB;IASD;IARrB,cAAc,GAAG,KAAK,CAAC;IACvB,QAAQ,GAAyB,IAAI,CAAC;IACtC,YAAY,GAA0B,IAAI,CAAC;IAC3C,YAAY,GAAwB,IAAI,CAAC;IAEzC,eAAe,GAAuC,IAAI,CAAC;IAC3D,YAAY,GAA6C,IAAI,CAAC;IAEtE,YAA6B,MAAc;QAAd,WAAM,GAAN,MAAM,CAAQ;IAAG,CAAC;IAE/C,SAAS,CAAC,OAGT;QACC,IAAI,CAAC,eAAe,GAAG,OAAO,CAAC,SAAS,CAAC;QACzC,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC;IACrC,CAAC;IAED,KAAK;QACH,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;YAC3B,OAAO;QACT,CAAC;QACD,IAAI,CAAC,cAAc,GAAG,KAAK,CAAC;QAC5B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAC;QACnD,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;IACjC,CAAC;IAED,KAAK,CAAC,IAAI;QACR,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnB,OAAO;QACT,CAAC;QACD,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC;QAC3B,IAAI,CAAC,SAAS,EAAE,CAAC;QACjB,MAAM,IAAI,CAAC,QAAQ,CAAC;QACpB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;IACpD,CAAC;IAIO,KAAK,CAAC,OAAO;QACnB,OAAO,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC;YAC5B,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;gBAC1B,MAAM,IAAI,CAAC,sBAAsB,EAAE,CAAC;YACtC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,0BAA0B,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;YAChE,CAAC;YAED,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC;gBACzB,MAAM,IAAI,CAAC,KAAK,CAAC,mBAAmB,CAAC,gBAAgB,CAAC,CAAC;YACzD,CAAC;QACH,CAAC;IACH,CAAC;IAIO,KAAK,CAAC,YAAY;QACxB,MAAM,QAAQ,GAAG,MAAM,oBAAoB,CAAC,YAAY,EAAE,CAAC;QAC3D,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,OAAO;QACT,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,0BAA0B,EAAE,EAAE,KAAK,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;QAEzE,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;YAC5B,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;gBACxB,MAAM;YACR,CAAC;YAED,IAAI,CAAC;gBAEH,MAAM,OAAO,GAAG,MAAM,oBAAoB,CAAC,mBAAmB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBACxE,IAAI,OAAO,EAAE,CAAC;oBACZ,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,2DAA2D,EAAE;wBAC7E,MAAM,EAAE,IAAI,CAAC,EAAE;wBACf,QAAQ,EAAE,IAAI,CAAC,IAAI;qBACpB,CAAC,CAAC;oBACH,SAAS;gBACX,CAAC;gBAED,MAAM,IAAI,CAAC,YAAY,CACrB,IAAI,CAAC,EAAE,EACP,IAAI,CAAC,SAAS,EACd,IAAI,CAAC,IAAI,EACT,IAAI,CAAC,MAAM,EACX,IAAI,CAAC,OAA8B,CACpC,CAAC;YACJ,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,kCAAkC,EAAE;oBACpD,MAAM,EAAE,IAAI,CAAC,EAAE;oBACf,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,OAAO;iBAC9B,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,YAAY,CACxB,MAAc,EACd,SAAiB,EACjB,IAAY,EACZ,MAAc,EACd,OAA4B;QAE5B,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC;YAC1B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,0DAA0D,CAAC,CAAC;YAC7E,OAAO;QACT,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,2BAA2B,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QAIhE,MAAM,oBAAoB,CAAC,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAE3D,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,sBAAsB,CAAC;YAC/D,SAAS;YACT,IAAI,EAAE,GAAG,IAAI,MAAM,IAAI,IAAI,EAAE,CAAC,kBAAkB,EAAE,EAAE;YACpD,MAAM;YACN,cAAc,EAAE,MAAM;SACvB,CAAC,CAAC;QAEH,MAAM,oBAAoB,CAAC,eAAe,CAAC;YACzC,cAAc,EAAE,MAAM;YACtB,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,MAAM,EAAE,SAAS;SAClB,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,0BAA0B,EAAE;YAC3C,MAAM;YACN,WAAW,EAAE,MAAM,CAAC,WAAW;SAChC,CAAC,CAAC;IACL,CAAC;IAIO,KAAK,CAAC,sBAAsB;QAClC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;YACvB,OAAO;QACT,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,oBAAoB,CAAC,qBAAqB,EAAE,CAAC;QACnE,KAAK,MAAM,SAAS,IAAI,OAAO,EAAE,CAAC;YAChC,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;gBACxB,MAAM;YACR,CAAC;YACD,MAAM,IAAI,CAAC,oBAAoB,CAAC,SAAS,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,oBAAoB,CAAC,SAGlC;QACC,IAAI,CAAC;YACH,IAAI,CAAC,CAAC,SAAS,CAAC,WAAW,IAAI,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC;gBAClD,OAAO;YACT,CAAC;YAED,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,kBAAkB,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;YAC7E,IAAI,CAAC,EAAE,EAAE,CAAC;gBACR,OAAO;YACT,CAAC;YAED,IAAI,EAAE,CAAC,KAAK,EAAE,CAAC;gBACb,MAAM,oBAAoB,CAAC,eAAe,CAAC,SAAS,CAAC,EAAE,EAAE;oBACvD,MAAM,EAAE,YAAY;oBACpB,KAAK,EAAE,EAAE,CAAC,KAAK;oBACf,QAAQ,EAAE,EAAE,CAAC,QAAQ;oBACrB,WAAW,EAAE,IAAI,IAAI,EAAE;iBACxB,CAAC,CAAC;gBACH,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,2CAA2C,EAAE;oBAC5D,WAAW,EAAE,SAAS,CAAC,EAAE;oBACzB,KAAK,EAAE,EAAE,CAAC,KAAK;iBAChB,CAAC,CAAC;gBACH,OAAO;YACT,CAAC;YAED,IAAI,EAAE,CAAC,MAAM,KAAK,QAAQ,IAAI,EAAE,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;gBACvD,MAAM,oBAAoB,CAAC,eAAe,CAAC,SAAS,CAAC,EAAE,EAAE;oBACvD,MAAM,EAAE,QAAQ;oBAChB,YAAY,EAAE,sBAAsB,EAAE,CAAC,MAAM,QAAQ;oBACrD,WAAW,EAAE,IAAI,IAAI,EAAE;iBACxB,CAAC,CAAC;gBACH,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,gCAAgC,EAAE;oBACjD,WAAW,EAAE,SAAS,CAAC,EAAE;oBACzB,eAAe,EAAE,EAAE,CAAC,MAAM;iBAC3B,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,kCAAkC,EAAE;gBACpD,WAAW,EAAE,SAAS,CAAC,EAAE;gBACzB,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,OAAO;aAC9B,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAIO,KAAK,CAAC,EAAU;QACtB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;YAC7B,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC;YAC5B,IAAI,CAAC,YAAY,GAAG,UAAU,CAAC,GAAG,EAAE;gBAClC,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;gBACzB,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;gBACzB,OAAO,EAAE,CAAC;YACZ,CAAC,EAAE,EAAE,CAAC,CAAC;QACT,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,SAAS;QACf,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,YAAY,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YAChC,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QAC3B,CAAC;QACD,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,IAAI,CAAC,YAAY,EAAE,CAAC;YACpB,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QAC3B,CAAC;IACH,CAAC;CACF"}
+{"version":3,"file":"periodic-task.service.js","sourceRoot":"","sources":["../../../../../../src/backend/services/periodic-task/service/periodic-task.service.ts"],"names":[],"mappings":"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"}

package/dist/src/backend/services/periodic-task/service/periodic-task.service.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=periodic-task.service.test.d.ts.map

package/dist/src/backend/services/periodic-task/service/periodic-task.service.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"periodic-task.service.test.d.ts","sourceRoot":"","sources":["../../../../../../src/backend/services/periodic-task/service/periodic-task.service.test.ts"],"names":[],"mappings":""}

package/dist/src/backend/services/periodic-task/service/periodic-task.service.test.js

@@ -0,0 +1,144 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+import { WorkspaceStatus } from '../../../../shared/core/index.js';
+const mockUpdateExecution = vi.hoisted(() => vi.fn());
+vi.mock('@/backend/services/periodic-task/resources/periodic-task.accessor', () => ({
+    periodicTaskAccessor: {
+        updateExecution: (...args) => mockUpdateExecution(...args),
+    },
+}));
+import { PERIODIC_TASK_READY_WITHOUT_PR_GRACE_MS, PeriodicTaskService, } from './periodic-task.service.js';
+const now = new Date('2026-05-20T12:00:00Z');
+const logger = {
+    info: vi.fn(),
+    debug: vi.fn(),
+    warn: vi.fn(),
+    error: vi.fn(),
+};
+async function checkSingleExecution(service, execution) {
+    const method = Reflect.get(service, 'checkSingleExecution');
+    await method.call(service, execution);
+}
+function createServiceWithWorkspaceStatus(status) {
+    const service = new PeriodicTaskService(logger);
+    service.configure({
+        workspace: {
+            createWorkspaceForTask: vi.fn(),
+        },
+        status: {
+            getWorkspaceStatus: vi.fn().mockResolvedValue({
+                initCompletedAt: now,
+                ...status,
+            }),
+        },
+    });
+    return service;
+}
+describe('PeriodicTaskService', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+        vi.useFakeTimers();
+        vi.setSystemTime(now);
+    });
+    afterEach(() => {
+        vi.useRealTimers();
+    });
+    it('marks stale READY executions without PR or active agent work as failed', async () => {
+        const service = createServiceWithWorkspaceStatus({
+            status: WorkspaceStatus.READY,
+            prUrl: null,
+            prNumber: null,
+            isAgentWorking: false,
+            initCompletedAt: new Date(Date.now() - PERIODIC_TASK_READY_WITHOUT_PR_GRACE_MS - 1),
+        });
+        await checkSingleExecution(service, {
+            id: 'exec-1',
+            workspaceId: 'ws-1',
+            startedAt: new Date(Date.now() - PERIODIC_TASK_READY_WITHOUT_PR_GRACE_MS - 1),
+        });
+        expect(mockUpdateExecution).toHaveBeenCalledWith('exec-1', expect.objectContaining({
+            status: 'FAILED',
+            errorMessage: 'Workspace is READY without a PR and no agent work is active',
+            completedAt: expect.any(Date),
+        }));
+    });
+    it('keeps recent READY executions without PR running during the grace period', async () => {
+        const service = createServiceWithWorkspaceStatus({
+            status: WorkspaceStatus.READY,
+            prUrl: null,
+            prNumber: null,
+            isAgentWorking: false,
+            initCompletedAt: new Date(Date.now() - PERIODIC_TASK_READY_WITHOUT_PR_GRACE_MS + 1),
+        });
+        await checkSingleExecution(service, {
+            id: 'exec-1',
+            workspaceId: 'ws-1',
+            startedAt: new Date(Date.now() - PERIODIC_TASK_READY_WITHOUT_PR_GRACE_MS - 1),
+        });
+        expect(mockUpdateExecution).not.toHaveBeenCalled();
+    });
+    it('does not count provisioning time against the READY without PR grace period', async () => {
+        const service = createServiceWithWorkspaceStatus({
+            status: WorkspaceStatus.READY,
+            prUrl: null,
+            prNumber: null,
+            isAgentWorking: false,
+            initCompletedAt: new Date(Date.now() - 1),
+        });
+        await checkSingleExecution(service, {
+            id: 'exec-1',
+            workspaceId: 'ws-1',
+            startedAt: new Date(Date.now() - PERIODIC_TASK_READY_WITHOUT_PR_GRACE_MS - 1),
+        });
+        expect(mockUpdateExecution).not.toHaveBeenCalled();
+    });
+    it('keeps READY executions running when workspace readiness time is unavailable', async () => {
+        const service = createServiceWithWorkspaceStatus({
+            status: WorkspaceStatus.READY,
+            prUrl: null,
+            prNumber: null,
+            isAgentWorking: false,
+            initCompletedAt: null,
+        });
+        await checkSingleExecution(service, {
+            id: 'exec-1',
+            workspaceId: 'ws-1',
+            startedAt: new Date(Date.now() - PERIODIC_TASK_READY_WITHOUT_PR_GRACE_MS - 1),
+        });
+        expect(mockUpdateExecution).not.toHaveBeenCalled();
+    });
+    it('keeps READY executions running while agent work is active', async () => {
+        const service = createServiceWithWorkspaceStatus({
+            status: WorkspaceStatus.READY,
+            prUrl: null,
+            prNumber: null,
+            isAgentWorking: true,
+            initCompletedAt: new Date(Date.now() - PERIODIC_TASK_READY_WITHOUT_PR_GRACE_MS - 1),
+        });
+        await checkSingleExecution(service, {
+            id: 'exec-1',
+            workspaceId: 'ws-1',
+            startedAt: new Date(Date.now() - PERIODIC_TASK_READY_WITHOUT_PR_GRACE_MS - 1),
+        });
+        expect(mockUpdateExecution).not.toHaveBeenCalled();
+    });
+    it('marks executions with PRs as PR_CREATED', async () => {
+        const service = createServiceWithWorkspaceStatus({
+            status: WorkspaceStatus.READY,
+            prUrl: 'https://github.com/purplefish-ai/factory-factory/pull/1',
+            prNumber: 1,
+            isAgentWorking: false,
+        });
+        await checkSingleExecution(service, {
+            id: 'exec-1',
+            workspaceId: 'ws-1',
+            startedAt: new Date(Date.now() - PERIODIC_TASK_READY_WITHOUT_PR_GRACE_MS - 1),
+        });
+        expect(mockUpdateExecution).toHaveBeenCalledWith('exec-1', expect.objectContaining({
+            status: 'PR_CREATED',
+            prUrl: 'https://github.com/purplefish-ai/factory-factory/pull/1',
+            prNumber: 1,
+            completedAt: expect.any(Date),
+        }));
+    });
+});
+//# sourceMappingURL=periodic-task.service.test.js.map

package/dist/src/backend/services/periodic-task/service/periodic-task.service.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"periodic-task.service.test.js","sourceRoot":"","sources":["../../../../../../src/backend/services/periodic-task/service/periodic-task.service.test.ts"],"names":[],"mappings":"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"}

package/dist/src/backend/services/ratchet/service/ratchet-decision-logging.helpers.d.ts

@@ -0,0 +1,64 @@
+import type { createLogger } from '../../../../backend/services/logger.service.js';
+import type { RatchetState } from '../../../../shared/core/index.js';
+import type { PRStateInfo, RatchetAction, RatchetDecisionContext, WorkspaceWithPR } from './ratchet.types.js';
+type Logger = ReturnType<typeof createLogger>;
+export declare function buildRatchetingLogContext(params: {
+    workspace: WorkspaceWithPR;
+    previousState: RatchetState;
+    newState: RatchetState;
+    action: RatchetAction;
+    prStateInfo: PRStateInfo | null;
+    prNumber: number | null;
+    decisionContext: RatchetDecisionContext | null;
+    logger: Logger;
+}): {
+    workspaceId: string;
+    prUrl: string;
+    prNumber: number | null;
+    prState: string | null;
+    ciStatus: import("../../../../shared/core/index.js").CIStatus | null;
+    hasChangesRequested: boolean | null;
+    hasMergeConflict: boolean | null;
+    snapshotKey: string | null;
+    ciSnapshotKey: string | null;
+    snapshotComparison: {
+        previousDispatchSnapshotKey: string | null;
+        currentSnapshotKey: string;
+        changedSinceLastDispatch: boolean;
+    } | null;
+    previousState: RatchetState;
+    newState: RatchetState;
+    ratchetEnabled: boolean;
+    ratchetActiveSessionId: string | null;
+    ratchetLastCiRunId: string | null;
+    ciStatusCheckRollup: import("./ratchet.types.js").RatchetStatusCheckRollupItem[] | null;
+    ciFailedChecks: {
+        name: string;
+        status: string | null;
+        conclusion: string | null;
+        runId: string | null;
+        detailsUrl: string | null;
+    }[];
+    prReviewLastCheckedAt: string | null;
+    latestReviewActivityAt: string | null;
+    reviewTimestampComparison: {
+        prReviewLastCheckedAt: string | null;
+        latestReviewActivityAt: string | null;
+        prReviewLastCheckedAtMs: number | null;
+        latestReviewActivityAtMs: number | null;
+        deltaMs: number | null;
+        hasNewReviewActivitySinceLastDispatch: boolean;
+    } | null;
+    actionType: "COMPLETED" | "WAITING" | "ERROR" | "FIXER_ACTIVE" | "TRIGGERED_FIXER" | "DISABLED";
+};
+export declare function logWorkspaceRatchetingDecision(params: {
+    workspace: WorkspaceWithPR;
+    previousState: RatchetState;
+    newState: RatchetState;
+    action: RatchetAction;
+    prStateInfo: PRStateInfo | null;
+    decisionContext?: RatchetDecisionContext | null;
+    logger: Logger;
+}): void;
+export {};
+//# sourceMappingURL=ratchet-decision-logging.helpers.d.ts.map

package/dist/src/backend/services/ratchet/service/ratchet-decision-logging.helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ratchet-decision-logging.helpers.d.ts","sourceRoot":"","sources":["../../../../../../src/backend/services/ratchet/service/ratchet-decision-logging.helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AACtE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,KAAK,EACV,WAAW,EACX,aAAa,EACb,sBAAsB,EACtB,eAAe,EAChB,MAAM,iBAAiB,CAAC;AAOzB,KAAK,MAAM,GAAG,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC;AAqB9C,wBAAgB,yBAAyB,CAAC,MAAM,EAAE;IAChD,SAAS,EAAE,eAAe,CAAC;IAC3B,aAAa,EAAE,YAAY,CAAC;IAC5B,QAAQ,EAAE,YAAY,CAAC;IACvB,MAAM,EAAE,aAAa,CAAC;IACtB,WAAW,EAAE,WAAW,GAAG,IAAI,CAAC;IAChC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,eAAe,EAAE,sBAAsB,GAAG,IAAI,CAAC;IAC/C,MAAM,EAAE,MAAM,CAAC;CAChB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA6CA;AAED,wBAAgB,8BAA8B,CAAC,MAAM,EAAE;IACrD,SAAS,EAAE,eAAe,CAAC;IAC3B,aAAa,EAAE,YAAY,CAAC;IAC5B,QAAQ,EAAE,YAAY,CAAC;IACvB,MAAM,EAAE,aAAa,CAAC;IACtB,WAAW,EAAE,WAAW,GAAG,IAAI,CAAC;IAChC,eAAe,CAAC,EAAE,sBAAsB,GAAG,IAAI,CAAC;IAChD,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,IAAI,CA4BP"}

package/dist/src/backend/services/ratchet/service/ratchet-decision-logging.helpers.js

@@ -0,0 +1,76 @@
+import { buildFailedCheckDiagnostics, buildReviewTimestampDiagnostics, buildSnapshotDiagnostics, } from './ratchet-pr-state.helpers.js';
+function describeNonRatchetingReason(action) {
+    switch (action.type) {
+        case 'WAITING':
+            return action.reason;
+        case 'FIXER_ACTIVE':
+            return `Ratchet fixer session is already active (${action.sessionId})`;
+        case 'DISABLED':
+            return action.reason;
+        case 'COMPLETED':
+            return 'PR is already merged';
+        case 'ERROR':
+            return action.error;
+    }
+    const exhaustiveCheck = action;
+    throw new Error(`Unhandled ratchet action: ${JSON.stringify(exhaustiveCheck)}`);
+}
+export function buildRatchetingLogContext(params) {
+    const { workspace, previousState, newState, action, prStateInfo, prNumber, decisionContext, logger, } = params;
+    const reviewDiagnostics = buildReviewTimestampDiagnostics(workspace, prStateInfo, decisionContext, logger);
+    const snapshotDiagnostics = buildSnapshotDiagnostics(workspace, prStateInfo, decisionContext);
+    const latestReviewActivityAt = reviewDiagnostics.latestReviewActivityAtMs;
+    return {
+        workspaceId: workspace.id,
+        prUrl: workspace.prUrl,
+        prNumber,
+        prState: prStateInfo?.prState ?? null,
+        ciStatus: prStateInfo?.ciStatus ?? null,
+        hasChangesRequested: prStateInfo?.hasChangesRequested ?? null,
+        hasMergeConflict: prStateInfo?.hasMergeConflict ?? null,
+        snapshotKey: prStateInfo?.snapshotKey ?? null,
+        ciSnapshotKey: snapshotDiagnostics.ciSnapshotKey,
+        snapshotComparison: snapshotDiagnostics.snapshotComparison,
+        previousState,
+        newState,
+        ratchetEnabled: workspace.ratchetEnabled,
+        ratchetActiveSessionId: workspace.ratchetActiveSessionId,
+        ratchetLastCiRunId: workspace.ratchetLastCiRunId,
+        ciStatusCheckRollup: prStateInfo?.statusCheckRollup ?? null,
+        ciFailedChecks: buildFailedCheckDiagnostics(prStateInfo),
+        prReviewLastCheckedAt: workspace.prReviewLastCheckedAt?.toISOString() ?? null,
+        latestReviewActivityAt: latestReviewActivityAt
+            ? new Date(latestReviewActivityAt).toISOString()
+            : null,
+        reviewTimestampComparison: reviewDiagnostics.reviewTimestampComparison,
+        actionType: action.type,
+    };
+}
+export function logWorkspaceRatchetingDecision(params) {
+    const { workspace, previousState, newState, action, prStateInfo, logger } = params;
+    const decisionContext = params.decisionContext ?? null;
+    const prNumber = prStateInfo?.prNumber ?? workspace.prNumber;
+    const prNumberLabel = prNumber ?? 'unknown';
+    const workspacePrPrefix = `workspace ${workspace.id} for PR #${prNumberLabel}`;
+    const context = buildRatchetingLogContext({
+        workspace,
+        previousState,
+        newState,
+        action,
+        prStateInfo,
+        prNumber,
+        decisionContext,
+        logger,
+    });
+    if (action.type === 'TRIGGERED_FIXER') {
+        logger.info(`Ratcheting ${workspacePrPrefix}`, {
+            ...context,
+            sessionId: action.sessionId,
+            promptSent: action.promptSent,
+        });
+        return;
+    }
+    const reason = describeNonRatchetingReason(action);
+    logger.info(`Not ratcheting ${workspacePrPrefix} because ${reason}`, context);
+}
+//# sourceMappingURL=ratchet-decision-logging.helpers.js.map

package/dist/src/backend/services/ratchet/service/ratchet-decision-logging.helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ratchet-decision-logging.helpers.js","sourceRoot":"","sources":["../../../../../../src/backend/services/ratchet/service/ratchet-decision-logging.helpers.ts"],"names":[],"mappings":"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"}

package/dist/src/backend/services/ratchet/service/ratchet-workspace-check-coordinator.d.ts

@@ -0,0 +1,9 @@
+import type { WorkspaceRatchetResult, WorkspaceWithPR } from './ratchet.types.js';
+export declare class RatchetWorkspaceCheckCoordinator {
+    private readonly getTimeoutMs;
+    private readonly inFlightWorkspaceChecks;
+    constructor(getTimeoutMs: () => number);
+    run(workspace: WorkspaceWithPR, runner: () => Promise<WorkspaceRatchetResult>): Promise<WorkspaceRatchetResult>;
+    private withTimeout;
+}
+//# sourceMappingURL=ratchet-workspace-check-coordinator.d.ts.map

package/dist/src/backend/services/ratchet/service/ratchet-workspace-check-coordinator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ratchet-workspace-check-coordinator.d.ts","sourceRoot":"","sources":["../../../../../../src/backend/services/ratchet/service/ratchet-workspace-check-coordinator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAE/E,qBAAa,gCAAgC;IAG/B,OAAO,CAAC,QAAQ,CAAC,YAAY;IAFzC,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAAsD;gBAEjE,YAAY,EAAE,MAAM,MAAM;IAEvD,GAAG,CACD,SAAS,EAAE,eAAe,EAC1B,MAAM,EAAE,MAAM,OAAO,CAAC,sBAAsB,CAAC,GAC5C,OAAO,CAAC,sBAAsB,CAAC;IAelC,OAAO,CAAC,WAAW;CAmBpB"}

package/dist/src/backend/services/ratchet/service/ratchet-workspace-check-coordinator.js

@@ -0,0 +1,36 @@
+export class RatchetWorkspaceCheckCoordinator {
+    getTimeoutMs;
+    inFlightWorkspaceChecks = new Map();
+    constructor(getTimeoutMs) {
+        this.getTimeoutMs = getTimeoutMs;
+    }
+    run(workspace, runner) {
+        const existing = this.inFlightWorkspaceChecks.get(workspace.id);
+        if (existing) {
+            return this.withTimeout(workspace, existing);
+        }
+        const inFlight = runner().finally(() => {
+            if (this.inFlightWorkspaceChecks.get(workspace.id) === inFlight) {
+                this.inFlightWorkspaceChecks.delete(workspace.id);
+            }
+        });
+        this.inFlightWorkspaceChecks.set(workspace.id, inFlight);
+        return this.withTimeout(workspace, inFlight);
+    }
+    withTimeout(workspace, checkPromise) {
+        const timeoutMs = this.getTimeoutMs();
+        return new Promise((resolve, reject) => {
+            const timeout = setTimeout(() => {
+                if (this.inFlightWorkspaceChecks.get(workspace.id) === checkPromise) {
+                    this.inFlightWorkspaceChecks.delete(workspace.id);
+                }
+                reject(new Error(`Workspace check timed out after ${timeoutMs}ms`));
+            }, timeoutMs);
+            timeout.unref?.();
+            checkPromise.then(resolve, reject).finally(() => {
+                clearTimeout(timeout);
+            });
+        });
+    }
+}
+//# sourceMappingURL=ratchet-workspace-check-coordinator.js.map

package/dist/src/backend/services/ratchet/service/ratchet-workspace-check-coordinator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ratchet-workspace-check-coordinator.js","sourceRoot":"","sources":["../../../../../../src/backend/services/ratchet/service/ratchet-workspace-check-coordinator.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,gCAAgC;IAGd;IAFZ,uBAAuB,GAAG,IAAI,GAAG,EAA2C,CAAC;IAE9F,YAA6B,YAA0B;QAA1B,iBAAY,GAAZ,YAAY,CAAc;IAAG,CAAC;IAE3D,GAAG,CACD,SAA0B,EAC1B,MAA6C;QAE7C,MAAM,QAAQ,GAAG,IAAI,CAAC,uBAAuB,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QAChE,IAAI,QAAQ,EAAE,CAAC;YACb,OAAO,IAAI,CAAC,WAAW,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QAC/C,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE;YACrC,IAAI,IAAI,CAAC,uBAAuB,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC,KAAK,QAAQ,EAAE,CAAC;gBAChE,IAAI,CAAC,uBAAuB,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;YACpD,CAAC;QACH,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,uBAAuB,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;QACzD,OAAO,IAAI,CAAC,WAAW,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAC/C,CAAC;IAEO,WAAW,CACjB,SAA0B,EAC1B,YAA6C;QAE7C,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;QACtC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC9B,IAAI,IAAI,CAAC,uBAAuB,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC,KAAK,YAAY,EAAE,CAAC;oBACpE,IAAI,CAAC,uBAAuB,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;gBACpD,CAAC;gBACD,MAAM,CAAC,IAAI,KAAK,CAAC,mCAAmC,SAAS,IAAI,CAAC,CAAC,CAAC;YACtE,CAAC,EAAE,SAAS,CAAC,CAAC;YACd,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;YAElB,YAAY,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE;gBAC9C,YAAY,CAAC,OAAO,CAAC,CAAC;YACxB,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/src/backend/services/ratchet/service/ratchet-workspace-check-coordinator.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ratchet-workspace-check-coordinator.test.d.ts.map

package/dist/src/backend/services/ratchet/service/ratchet-workspace-check-coordinator.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ratchet-workspace-check-coordinator.test.d.ts","sourceRoot":"","sources":["../../../../../../src/backend/services/ratchet/service/ratchet-workspace-check-coordinator.test.ts"],"names":[],"mappings":""}

package/dist/src/backend/services/ratchet/service/ratchet-workspace-check-coordinator.test.js

@@ -0,0 +1,25 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+import { RatchetWorkspaceCheckCoordinator } from './ratchet-workspace-check-coordinator.js';
+describe('RatchetWorkspaceCheckCoordinator', () => {
+    beforeEach(() => {
+        vi.useFakeTimers();
+    });
+    afterEach(() => {
+        vi.useRealTimers();
+    });
+    it('applies the workspace timeout to reused in-flight checks', async () => {
+        const coordinator = new RatchetWorkspaceCheckCoordinator(() => 1000);
+        const workspace = { id: 'workspace-1' };
+        const runner = vi.fn(() => new Promise(() => {
+        }));
+        const firstRun = coordinator.run(workspace, runner);
+        const secondRun = coordinator.run(workspace, runner);
+        expect(runner).toHaveBeenCalledTimes(1);
+        const firstExpectation = expect(firstRun).rejects.toThrow('Workspace check timed out after 1000ms');
+        const secondExpectation = expect(secondRun).rejects.toThrow('Workspace check timed out after 1000ms');
+        await vi.advanceTimersByTimeAsync(1000);
+        await firstExpectation;
+        await secondExpectation;
+    });
+});
+//# sourceMappingURL=ratchet-workspace-check-coordinator.test.js.map

package/dist/src/backend/services/ratchet/service/ratchet-workspace-check-coordinator.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ratchet-workspace-check-coordinator.test.js","sourceRoot":"","sources":["../../../../../../src/backend/services/ratchet/service/ratchet-workspace-check-coordinator.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAEzE,OAAO,EAAE,gCAAgC,EAAE,MAAM,uCAAuC,CAAC;AAEzF,QAAQ,CAAC,kCAAkC,EAAE,GAAG,EAAE;IAChD,UAAU,CAAC,GAAG,EAAE;QACd,EAAE,CAAC,aAAa,EAAE,CAAC;IACrB,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,EAAE,CAAC,aAAa,EAAE,CAAC;IACrB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0DAA0D,EAAE,KAAK,IAAI,EAAE;QACxE,MAAM,WAAW,GAAG,IAAI,gCAAgC,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;QACrE,MAAM,SAAS,GAAG,EAAE,EAAE,EAAE,aAAa,EAAqB,CAAC;QAC3D,MAAM,MAAM,GAAG,EAAE,CAAC,EAAE,CAClB,GAAG,EAAE,CACH,IAAI,OAAO,CAAyB,GAAG,EAAE;QAEzC,CAAC,CAAC,CACL,CAAC;QAEF,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QACpD,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QAErD,MAAM,CAAC,MAAM,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;QAExC,MAAM,gBAAgB,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,OAAO,CACvD,wCAAwC,CACzC,CAAC;QACF,MAAM,iBAAiB,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,OAAO,CACzD,wCAAwC,CACzC,CAAC;QAEF,MAAM,EAAE,CAAC,wBAAwB,CAAC,IAAI,CAAC,CAAC;QAExC,MAAM,gBAAgB,CAAC;QACvB,MAAM,iBAAiB,CAAC;IAC1B,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/src/backend/services/ratchet/service/ratchet.service.d.ts

@@ -1,7 +1,7 @@
 import { EventEmitter } from 'node:events';
 import { CIStatus, RatchetState } from '../../../../shared/core/index.js';
 import type { RatchetGitHubBridge, RatchetPRSnapshotBridge, RatchetSessionBridge } from './bridges.js';
-import type { RatchetCheckResult, WorkspaceRatchetResult } from './ratchet.types.js';
+import type { PRStateInfo, RatchetAction, RatchetCheckResult, RatchetDecisionContext, WorkspaceRatchetResult, WorkspaceWithPR } from './ratchet.types.js';
 export type { RatchetAction, RatchetCheckResult, WorkspaceRatchetResult } from './ratchet.types.js';
 export declare const RATCHET_STATE_CHANGED: "ratchet_state_changed";
 export declare const RATCHET_TOGGLED: "ratchet_toggled";
@@ -22,7 +22,7 @@ declare class RatchetService extends EventEmitter {
     private sleepTimeout;
     private sleepResolve;
     private workspaceCheckTimeoutMs;
-    private readonly inFlightWorkspaceChecks;
+    private readonly checkCoordinator;
     private cachedAuthenticatedUsername;
     private readonly backoff;
     private readonly reviewPollTrackers;
@@ -46,16 +46,49 @@ declare class RatchetService extends EventEmitter {
     checkWorkspaceById(workspaceId: string): Promise<WorkspaceRatchetResult | null>;
     clearRatchetActiveSessionIfMatching(workspaceId: string, sessionId: string): Promise<void>;
     private runWorkspaceCheckSafely;
-    private withWorkspaceCheckTimeout;
-    private runWorkspaceCheck;
     setWorkspaceRatcheting(workspaceId: string, enabled: boolean): Promise<void>;
     private processWorkspace;
     private logWorkspaceRatchetingDecision;
-    private buildRatchetingLogContext;
-    private buildSnapshotDiagnostics;
-    private buildReviewTimestampDiagnostics;
-    private buildFailedCheckDiagnostics;
-    private describeNonRatchetingReason;
+    buildRatchetingLogContext(workspace: WorkspaceWithPR, previousState: RatchetState, newState: RatchetState, action: RatchetAction, prStateInfo: PRStateInfo | null, prNumber: number | null, decisionContext: RatchetDecisionContext | null): {
+        workspaceId: string;
+        prUrl: string;
+        prNumber: number | null;
+        prState: string | null;
+        ciStatus: CIStatus | null;
+        hasChangesRequested: boolean | null;
+        hasMergeConflict: boolean | null;
+        snapshotKey: string | null;
+        ciSnapshotKey: string | null;
+        snapshotComparison: {
+            previousDispatchSnapshotKey: string | null;
+            currentSnapshotKey: string;
+            changedSinceLastDispatch: boolean;
+        } | null;
+        previousState: RatchetState;
+        newState: RatchetState;
+        ratchetEnabled: boolean;
+        ratchetActiveSessionId: string | null;
+        ratchetLastCiRunId: string | null;
+        ciStatusCheckRollup: import("./ratchet.types.js").RatchetStatusCheckRollupItem[] | null;
+        ciFailedChecks: {
+            name: string;
+            status: string | null;
+            conclusion: string | null;
+            runId: string | null;
+            detailsUrl: string | null;
+        }[];
+        prReviewLastCheckedAt: string | null;
+        latestReviewActivityAt: string | null;
+        reviewTimestampComparison: {
+            prReviewLastCheckedAt: string | null;
+            latestReviewActivityAt: string | null;
+            prReviewLastCheckedAtMs: number | null;
+            latestReviewActivityAtMs: number | null;
+            deltaMs: number | null;
+            hasNewReviewActivitySinceLastDispatch: boolean;
+        } | null;
+        actionType: "COMPLETED" | "WAITING" | "ERROR" | "FIXER_ACTIVE" | "TRIGGERED_FIXER" | "DISABLED";
+    };
     private buildRatchetDecisionContext;
     private collectRatchetingActivityChecks;
     private decideRatchetAction;

package/dist/src/backend/services/ratchet/service/ratchet.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ratchet.service.d.ts","sourceRoot":"","sources":["../../../../../../src/backend/services/ratchet/service/ratchet.service.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ratchet.service.d.ts","sourceRoot":"","sources":["../../../../../../src/backend/services/ratchet/service/ratchet.service.ts"],"names":[],"mappings":"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"}