factory-factory 0.3.18 → 0.3.19

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

@@ -0,0 +1,150 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+const prismaMock = vi.hoisted(() => ({
+    periodicTask: {
+        findUnique: vi.fn(),
+        update: vi.fn(),
+    },
+}));
+vi.mock('@/backend/db', () => ({
+    prisma: prismaMock,
+}));
+import { periodicTaskAccessor } from './periodic-task.accessor.js';
+function calendarDate(date, timezone = 'UTC') {
+    const parts = Object.fromEntries(new Intl.DateTimeFormat('en-CA', {
+        timeZone: timezone,
+        year: 'numeric',
+        month: '2-digit',
+        day: '2-digit',
+    })
+        .formatToParts(date)
+        .map(({ type, value }) => [type, value]));
+    return `${parts.year}-${parts.month}-${parts.day}`;
+}
+function getLocalParts(date, timezone) {
+    return Object.fromEntries(new Intl.DateTimeFormat('en-US', {
+        timeZone: timezone,
+        year: 'numeric',
+        month: '2-digit',
+        day: '2-digit',
+        hour: '2-digit',
+        minute: '2-digit',
+        hour12: false,
+    })
+        .formatToParts(date)
+        .map(({ type, value }) => [type, value]));
+}
+function localTime(date, timezone) {
+    const parts = getLocalParts(date, timezone);
+    return `${parts.hour}:${parts.minute}`;
+}
+describe('periodicTaskAccessor.computeNextRunAt', () => {
+    it('keeps scheduled time on the spring-forward DST transition day', () => {
+        const nextRunAt = periodicTaskAccessor.computeNextRunAt('DAILY', new Date('2024-03-09T12:00:00.000Z'), '03:30', 'America/New_York');
+        expect(nextRunAt.toISOString()).toBe('2024-03-10T07:30:00.000Z');
+    });
+    it('runs at the first valid later time when scheduled time does not exist', () => {
+        const nextRunAt = periodicTaskAccessor.computeNextRunAt('DAILY', new Date('2024-03-09T12:00:00.000Z'), '02:30', 'America/New_York');
+        expect(nextRunAt.toISOString()).toBe('2024-03-10T07:00:00.000Z');
+    });
+    it('keeps scheduled time on the fall-back DST transition day', () => {
+        const nextRunAt = periodicTaskAccessor.computeNextRunAt('DAILY', new Date('2024-11-02T12:00:00.000Z'), '03:30', 'America/New_York');
+        expect(nextRunAt.toISOString()).toBe('2024-11-03T08:30:00.000Z');
+    });
+    it('preserves scheduled time for UTC+14 day boundaries', () => {
+        const nextRunAt = periodicTaskAccessor.computeNextRunAt('DAILY', new Date('2024-01-01T00:00:00.000Z'), '03:30', 'Pacific/Kiritimati');
+        expect(nextRunAt.toISOString()).toBe('2024-01-01T13:30:00.000Z');
+    });
+    it('preserves scheduled time for UTC-12 day boundaries', () => {
+        const nextRunAt = periodicTaskAccessor.computeNextRunAt('DAILY', new Date('2024-01-01T12:00:00.000Z'), '23:30', 'Etc/GMT+12');
+        expect(nextRunAt.toISOString()).toBe('2024-01-03T11:30:00.000Z');
+    });
+    it('does not snap short cadences to scheduled times', () => {
+        const nextRunAt = periodicTaskAccessor.computeNextRunAt('EVERY_FIVE_MINUTES', new Date('2024-03-09T12:00:00.000Z'), '03:30', 'America/New_York');
+        expect(nextRunAt.toISOString()).toBe('2024-03-09T12:05:00.000Z');
+    });
+    it('preserves the anchored monthly day after clamping for a short month', () => {
+        const february = periodicTaskAccessor.computeNextRunAt('MONTHLY', new Date('2026-01-31T12:00:00.000Z'), null, null, 31);
+        const march = periodicTaskAccessor.computeNextRunAt('MONTHLY', february, null, null, 31);
+        expect(calendarDate(february)).toBe('2026-02-28');
+        expect(calendarDate(march)).toBe('2026-03-31');
+    });
+    it('preserves a day 30 monthly anchor after February', () => {
+        const february = periodicTaskAccessor.computeNextRunAt('MONTHLY', new Date('2026-01-30T12:00:00.000Z'), null, null, 30);
+        const march = periodicTaskAccessor.computeNextRunAt('MONTHLY', february, null, null, 30);
+        expect(calendarDate(february)).toBe('2026-02-28');
+        expect(calendarDate(march)).toBe('2026-03-30');
+    });
+    it('handles leap-year February while preserving a day 31 monthly anchor', () => {
+        const february = periodicTaskAccessor.computeNextRunAt('MONTHLY', new Date('2028-01-31T12:00:00.000Z'), null, null, 31);
+        const march = periodicTaskAccessor.computeNextRunAt('MONTHLY', february, null, null, 31);
+        expect(calendarDate(february)).toBe('2028-02-29');
+        expect(calendarDate(march)).toBe('2028-03-31');
+    });
+    it('falls back to the dispatch date for legacy rows without a monthly anchor', () => {
+        const next = periodicTaskAccessor.computeNextRunAt('MONTHLY', new Date('2026-02-28T12:00:00.000Z'));
+        expect(calendarDate(next)).toBe('2026-03-28');
+    });
+    it('applies scheduled time in timezone without losing the monthly anchor', () => {
+        const timezone = 'America/New_York';
+        const february = periodicTaskAccessor.computeNextRunAt('MONTHLY', new Date('2026-01-31T15:00:00.000Z'), '09:30', timezone, 31);
+        const march = periodicTaskAccessor.computeNextRunAt('MONTHLY', february, '09:30', timezone, 31);
+        expect(calendarDate(february, timezone)).toBe('2026-02-28');
+        expect(localTime(february, timezone)).toBe('09:30');
+        expect(calendarDate(march, timezone)).toBe('2026-03-31');
+        expect(localTime(march, timezone)).toBe('09:30');
+    });
+    it('keeps MONTHLY scheduled runs on the local clamped day near UTC rollover', () => {
+        const timezone = 'America/New_York';
+        const from = new Date('2026-01-31T00:05:00.000Z');
+        const nextRunAt = periodicTaskAccessor.computeNextRunAt('MONTHLY', from, '09:00', timezone);
+        expect(getLocalParts(nextRunAt, timezone)).toMatchObject({
+            year: '2026',
+            month: '02',
+            day: '28',
+            hour: '09',
+            minute: '00',
+        });
+    });
+    it('preserves local Date monthly clamping when no timezone is configured', () => {
+        const from = new Date(2026, 0, 31, 9, 5);
+        const nextRunAt = periodicTaskAccessor.computeNextRunAt('MONTHLY', from);
+        expect(nextRunAt.getTime()).toBe(new Date(2026, 1, 28, 9, 5).getTime());
+    });
+});
+describe('periodicTaskAccessor.markDispatched', () => {
+    beforeEach(() => {
+        vi.useFakeTimers();
+        vi.setSystemTime(new Date('2026-02-28T15:00:00.000Z'));
+        prismaMock.periodicTask.findUnique.mockReset();
+        prismaMock.periodicTask.update.mockReset();
+    });
+    afterEach(() => {
+        vi.useRealTimers();
+    });
+    it('lazily backfills a legacy monthly anchor from createdAt in the task timezone', async () => {
+        const timezone = 'America/Los_Angeles';
+        prismaMock.periodicTask.findUnique.mockResolvedValue({
+            createdAt: new Date('2026-02-01T07:30:00.000Z'),
+            scheduledDayOfMonth: null,
+            timezone,
+        });
+        prismaMock.periodicTask.update.mockResolvedValue({});
+        await periodicTaskAccessor.markDispatched('task-1', 'MONTHLY', '09:00', timezone, null);
+        expect(prismaMock.periodicTask.update).toHaveBeenCalledWith({
+            where: { id: 'task-1' },
+            data: expect.objectContaining({
+                scheduledDayOfMonth: 31,
+            }),
+        });
+        const updateArgs = prismaMock.periodicTask.update.mock.calls[0]?.[0];
+        const nextRunAt = updateArgs?.data.nextRunAt;
+        expect(getLocalParts(nextRunAt, timezone)).toMatchObject({
+            year: '2026',
+            month: '03',
+            day: '31',
+            hour: '09',
+            minute: '00',
+        });
+    });
+});
+//# sourceMappingURL=periodic-task.accessor.test.js.map

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

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

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;YA0CZ,YAAY;YAyCZ,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, task.scheduledTime, task.timezone);
+                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, scheduledTime, timezone) {
+    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, scheduledTime, timezone);
+        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":"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"}
+{"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"}