factory-factory 0.3.21 → 0.4.0

package/dist/src/backend/services/ratchet/service/ratchet-state-machine.js

@@ -0,0 +1,77 @@
+import { RatchetState } from '../../../../shared/core/index.js';
+const OPEN_PR_STATES = [
+    RatchetState.CI_RUNNING,
+    RatchetState.CI_FAILED,
+    RatchetState.MERGE_CONFLICT,
+    RatchetState.REVIEW_PENDING,
+    RatchetState.READY,
+];
+export const RATCHET_VALID_TRANSITIONS = {
+    IDLE: [...OPEN_PR_STATES, RatchetState.MERGED],
+    CI_RUNNING: [
+        RatchetState.IDLE,
+        RatchetState.CI_FAILED,
+        RatchetState.MERGE_CONFLICT,
+        RatchetState.REVIEW_PENDING,
+        RatchetState.READY,
+        RatchetState.MERGED,
+    ],
+    CI_FAILED: [
+        RatchetState.IDLE,
+        RatchetState.CI_RUNNING,
+        RatchetState.MERGE_CONFLICT,
+        RatchetState.REVIEW_PENDING,
+        RatchetState.READY,
+        RatchetState.MERGED,
+    ],
+    MERGE_CONFLICT: [
+        RatchetState.IDLE,
+        RatchetState.CI_RUNNING,
+        RatchetState.CI_FAILED,
+        RatchetState.REVIEW_PENDING,
+        RatchetState.READY,
+        RatchetState.MERGED,
+    ],
+    REVIEW_PENDING: [
+        RatchetState.IDLE,
+        RatchetState.CI_RUNNING,
+        RatchetState.CI_FAILED,
+        RatchetState.MERGE_CONFLICT,
+        RatchetState.READY,
+        RatchetState.MERGED,
+    ],
+    READY: [
+        RatchetState.IDLE,
+        RatchetState.CI_RUNNING,
+        RatchetState.CI_FAILED,
+        RatchetState.MERGE_CONFLICT,
+        RatchetState.REVIEW_PENDING,
+        RatchetState.MERGED,
+    ],
+    MERGED: [RatchetState.IDLE, ...OPEN_PR_STATES],
+};
+export class RatchetStateMachineError extends Error {
+    workspaceId;
+    fromState;
+    toState;
+    constructor(workspaceId, fromState, toState, message) {
+        super(message ??
+            `Invalid ratchet state transition: ${fromState} → ${toState} (workspace: ${workspaceId})`);
+        this.workspaceId = workspaceId;
+        this.fromState = fromState;
+        this.toState = toState;
+        this.name = 'RatchetStateMachineError';
+    }
+}
+export function isValidRatchetTransition(from, to) {
+    if (from === to) {
+        return true;
+    }
+    return RATCHET_VALID_TRANSITIONS[from].includes(to);
+}
+export function assertValidRatchetTransition(workspaceId, fromState, toState) {
+    if (!isValidRatchetTransition(fromState, toState)) {
+        throw new RatchetStateMachineError(workspaceId, fromState, toState);
+    }
+}
+//# sourceMappingURL=ratchet-state-machine.js.map

package/dist/src/backend/services/ratchet/service/ratchet-state-machine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ratchet-state-machine.js","sourceRoot":"","sources":["../../../../../../src/backend/services/ratchet/service/ratchet-state-machine.ts"],"names":[],"mappings":"AAoBA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,MAAM,cAAc,GAAG;IACrB,YAAY,CAAC,UAAU;IACvB,YAAY,CAAC,SAAS;IACtB,YAAY,CAAC,cAAc;IAC3B,YAAY,CAAC,cAAc;IAC3B,YAAY,CAAC,KAAK;CACV,CAAC;AAMX,MAAM,CAAC,MAAM,yBAAyB,GAAkD;IAItF,IAAI,EAAE,CAAC,GAAG,cAAc,EAAE,YAAY,CAAC,MAAM,CAAC;IAI9C,UAAU,EAAE;QACV,YAAY,CAAC,IAAI;QACjB,YAAY,CAAC,SAAS;QACtB,YAAY,CAAC,cAAc;QAC3B,YAAY,CAAC,cAAc;QAC3B,YAAY,CAAC,KAAK;QAClB,YAAY,CAAC,MAAM;KACpB;IACD,SAAS,EAAE;QACT,YAAY,CAAC,IAAI;QACjB,YAAY,CAAC,UAAU;QACvB,YAAY,CAAC,cAAc;QAC3B,YAAY,CAAC,cAAc;QAC3B,YAAY,CAAC,KAAK;QAClB,YAAY,CAAC,MAAM;KACpB;IACD,cAAc,EAAE;QACd,YAAY,CAAC,IAAI;QACjB,YAAY,CAAC,UAAU;QACvB,YAAY,CAAC,SAAS;QACtB,YAAY,CAAC,cAAc;QAC3B,YAAY,CAAC,KAAK;QAClB,YAAY,CAAC,MAAM;KACpB;IACD,cAAc,EAAE;QACd,YAAY,CAAC,IAAI;QACjB,YAAY,CAAC,UAAU;QACvB,YAAY,CAAC,SAAS;QACtB,YAAY,CAAC,cAAc;QAC3B,YAAY,CAAC,KAAK;QAClB,YAAY,CAAC,MAAM;KACpB;IACD,KAAK,EAAE;QACL,YAAY,CAAC,IAAI;QACjB,YAAY,CAAC,UAAU;QACvB,YAAY,CAAC,SAAS;QACtB,YAAY,CAAC,cAAc;QAC3B,YAAY,CAAC,cAAc;QAC3B,YAAY,CAAC,MAAM;KACpB;IAID,MAAM,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,GAAG,cAAc,CAAC;CAC/C,CAAC;AAKF,MAAM,OAAO,wBAAyB,SAAQ,KAAK;IAE/B;IACA;IACA;IAHlB,YACkB,WAAmB,EACnB,SAAuB,EACvB,OAAqB,EACrC,OAAgB;QAEhB,KAAK,CACH,OAAO;YACL,qCAAqC,SAAS,MAAM,OAAO,gBAAgB,WAAW,GAAG,CAC5F,CAAC;QARc,gBAAW,GAAX,WAAW,CAAQ;QACnB,cAAS,GAAT,SAAS,CAAc;QACvB,YAAO,GAAP,OAAO,CAAc;QAOrC,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;IACzC,CAAC;CACF;AAED,MAAM,UAAU,wBAAwB,CAAC,IAAkB,EAAE,EAAgB;IAC3E,IAAI,IAAI,KAAK,EAAE,EAAE,CAAC;QAChB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,yBAAyB,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;AACtD,CAAC;AAOD,MAAM,UAAU,4BAA4B,CAC1C,WAAmB,EACnB,SAAuB,EACvB,OAAqB;IAErB,IAAI,CAAC,wBAAwB,CAAC,SAAS,EAAE,OAAO,CAAC,EAAE,CAAC;QAClD,MAAM,IAAI,wBAAwB,CAAC,WAAW,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;IACtE,CAAC;AACH,CAAC"}

package/dist/src/backend/services/ratchet/service/ratchet-state-machine.test.d.ts

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

package/dist/src/backend/services/ratchet/service/ratchet-state-machine.test.d.ts.map

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

package/dist/src/backend/services/ratchet/service/ratchet-state-machine.test.js

@@ -0,0 +1,66 @@
+import { describe, expect, it } from 'vitest';
+import { RatchetState } from '../../../../shared/core/index.js';
+import { assertValidRatchetTransition, isValidRatchetTransition, RATCHET_VALID_TRANSITIONS, RatchetStateMachineError, } from './ratchet-state-machine.js';
+const ALL_STATES = Object.values(RatchetState);
+const OPEN_PR_STATES = [
+    RatchetState.CI_RUNNING,
+    RatchetState.CI_FAILED,
+    RatchetState.MERGE_CONFLICT,
+    RatchetState.REVIEW_PENDING,
+    RatchetState.READY,
+];
+describe('ratchet state machine', () => {
+    it('declares transitions for every ratchet state', () => {
+        expect(Object.keys(RATCHET_VALID_TRANSITIONS).sort()).toEqual([...ALL_STATES].sort());
+    });
+    it('allows every state to settle to IDLE (PR closed / ratchet disabled)', () => {
+        for (const from of ALL_STATES) {
+            if (from === RatchetState.IDLE) {
+                continue;
+            }
+            expect(isValidRatchetTransition(from, RatchetState.IDLE)).toBe(true);
+        }
+    });
+    it('allows IDLE to move to any observed PR state', () => {
+        for (const to of [...OPEN_PR_STATES, RatchetState.MERGED]) {
+            expect(isValidRatchetTransition(RatchetState.IDLE, to)).toBe(true);
+        }
+    });
+    it('allows open-PR states to move between each other and to MERGED', () => {
+        for (const from of OPEN_PR_STATES) {
+            for (const to of [...OPEN_PR_STATES, RatchetState.MERGED]) {
+                if (from === to) {
+                    continue;
+                }
+                expect(isValidRatchetTransition(from, to)).toBe(true);
+            }
+        }
+    });
+    it('allows MERGED to move to open-PR states (workspace PR pointer switch)', () => {
+        for (const to of OPEN_PR_STATES) {
+            expect(isValidRatchetTransition(RatchetState.MERGED, to)).toBe(true);
+        }
+    });
+    it('treats same-state writes as valid refreshes, not transitions', () => {
+        for (const state of ALL_STATES) {
+            expect(RATCHET_VALID_TRANSITIONS[state]).not.toContain(state);
+            expect(isValidRatchetTransition(state, state)).toBe(true);
+        }
+    });
+    describe('assertValidRatchetTransition', () => {
+        it('does not throw for a valid transition', () => {
+            expect(() => assertValidRatchetTransition('ws-1', RatchetState.CI_FAILED, RatchetState.IDLE)).not.toThrow();
+        });
+        it('throws RatchetStateMachineError naming the workspace and states when invalid', () => {
+            const error = new RatchetStateMachineError('ws-1', RatchetState.MERGED, RatchetState.CI_RUNNING);
+            expect(error.name).toBe('RatchetStateMachineError');
+            expect(error.workspaceId).toBe('ws-1');
+            expect(error.fromState).toBe(RatchetState.MERGED);
+            expect(error.toState).toBe(RatchetState.CI_RUNNING);
+            expect(error.message).toContain('MERGED');
+            expect(error.message).toContain('CI_RUNNING');
+            expect(error.message).toContain('ws-1');
+        });
+    });
+});
+//# sourceMappingURL=ratchet-state-machine.test.js.map

package/dist/src/backend/services/ratchet/service/ratchet-state-machine.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ratchet-state-machine.test.js","sourceRoot":"","sources":["../../../../../../src/backend/services/ratchet/service/ratchet-state-machine.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EACL,4BAA4B,EAC5B,wBAAwB,EACxB,yBAAyB,EACzB,wBAAwB,GACzB,MAAM,yBAAyB,CAAC;AAEjC,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;AAC/C,MAAM,cAAc,GAAG;IACrB,YAAY,CAAC,UAAU;IACvB,YAAY,CAAC,SAAS;IACtB,YAAY,CAAC,cAAc;IAC3B,YAAY,CAAC,cAAc;IAC3B,YAAY,CAAC,KAAK;CACV,CAAC;AAEX,QAAQ,CAAC,uBAAuB,EAAE,GAAG,EAAE;IACrC,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;QACtD,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IACxF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qEAAqE,EAAE,GAAG,EAAE;QAC7E,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;YAC9B,IAAI,IAAI,KAAK,YAAY,CAAC,IAAI,EAAE,CAAC;gBAC/B,SAAS;YACX,CAAC;YACD,MAAM,CAAC,wBAAwB,CAAC,IAAI,EAAE,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvE,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;QACtD,KAAK,MAAM,EAAE,IAAI,CAAC,GAAG,cAAc,EAAE,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC;YAC1D,MAAM,CAAC,wBAAwB,CAAC,YAAY,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrE,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gEAAgE,EAAE,GAAG,EAAE;QACxE,KAAK,MAAM,IAAI,IAAI,cAAc,EAAE,CAAC;YAClC,KAAK,MAAM,EAAE,IAAI,CAAC,GAAG,cAAc,EAAE,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC1D,IAAI,IAAI,KAAK,EAAE,EAAE,CAAC;oBAChB,SAAS;gBACX,CAAC;gBACD,MAAM,CAAC,wBAAwB,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACxD,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uEAAuE,EAAE,GAAG,EAAE;QAC/E,KAAK,MAAM,EAAE,IAAI,cAAc,EAAE,CAAC;YAChC,MAAM,CAAC,wBAAwB,CAAC,YAAY,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvE,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8DAA8D,EAAE,GAAG,EAAE;QACtE,KAAK,MAAM,KAAK,IAAI,UAAU,EAAE,CAAC;YAC/B,MAAM,CAAC,yBAAyB,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;YAC9D,MAAM,CAAC,wBAAwB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,8BAA8B,EAAE,GAAG,EAAE;QAC5C,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;YAC/C,MAAM,CAAC,GAAG,EAAE,CACV,4BAA4B,CAAC,MAAM,EAAE,YAAY,CAAC,SAAS,EAAE,YAAY,CAAC,IAAI,CAAC,CAChF,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QAClB,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,8EAA8E,EAAE,GAAG,EAAE;YAKtF,MAAM,KAAK,GAAG,IAAI,wBAAwB,CACxC,MAAM,EACN,YAAY,CAAC,MAAM,EACnB,YAAY,CAAC,UAAU,CACxB,CAAC;YACF,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;YACpD,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACvC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;YAClD,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC;YACpD,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;YAC1C,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;YAC9C,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAC1C,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

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

@@ -1,9 +1,10 @@
 import type { WorkspaceRatchetResult, WorkspaceWithPR } from './ratchet.types.js';
+export type WorkspaceCheckScheduler = (task: () => Promise<WorkspaceRatchetResult>) => Promise<WorkspaceRatchetResult>;
 export declare class RatchetWorkspaceCheckCoordinator {
     private readonly getTimeoutMs;
     private readonly inFlightWorkspaceChecks;
     constructor(getTimeoutMs: () => number);
-    run(workspace: WorkspaceWithPR, runner: () => Promise<WorkspaceRatchetResult>): Promise<WorkspaceRatchetResult>;
+    run(workspace: WorkspaceWithPR, runner: (signal: AbortSignal, commitSideEffects: () => void) => Promise<WorkspaceRatchetResult>, schedule?: WorkspaceCheckScheduler): 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

@@ -1 +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"}
+{"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;AAS/E,MAAM,MAAM,uBAAuB,GAAG,CACpC,IAAI,EAAE,MAAM,OAAO,CAAC,sBAAsB,CAAC,KACxC,OAAO,CAAC,sBAAsB,CAAC,CAAC;AAIrC,qBAAa,gCAAgC;IAG/B,OAAO,CAAC,QAAQ,CAAC,YAAY;IAFzC,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAA6C;gBAExD,YAAY,EAAE,MAAM,MAAM;IAEvD,GAAG,CACD,SAAS,EAAE,eAAe,EAC1B,MAAM,EAAE,CAAC,MAAM,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,IAAI,KAAK,OAAO,CAAC,sBAAsB,CAAC,EAC/F,QAAQ,GAAE,uBAAwC,GACjD,OAAO,CAAC,sBAAsB,CAAC;YAiCpB,WAAW;CAuB1B"}

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

@@ -1,33 +1,59 @@
+const runImmediately = (task) => task();
 export class RatchetWorkspaceCheckCoordinator {
     getTimeoutMs;
     inFlightWorkspaceChecks = new Map();
     constructor(getTimeoutMs) {
         this.getTimeoutMs = getTimeoutMs;
     }
-    run(workspace, runner) {
+    run(workspace, runner, schedule = runImmediately) {
         const existing = this.inFlightWorkspaceChecks.get(workspace.id);
         if (existing) {
-            return this.withTimeout(workspace, existing);
+            return this.withTimeout(existing);
         }
-        const inFlight = runner().finally(() => {
+        const controller = new AbortController();
+        let markStarted;
+        const started = new Promise((resolve) => {
+            markStarted = resolve;
+        });
+        const inFlight = {
+            controller,
+            promise: null,
+            started,
+            timeoutDisabled: false,
+        };
+        const promise = schedule(async () => {
+            markStarted();
+            controller.signal.throwIfAborted();
+            return await runner(controller.signal, () => {
+                inFlight.timeoutDisabled = true;
+            });
+        }).finally(() => {
             if (this.inFlightWorkspaceChecks.get(workspace.id) === inFlight) {
                 this.inFlightWorkspaceChecks.delete(workspace.id);
             }
         });
+        inFlight.promise = promise;
         this.inFlightWorkspaceChecks.set(workspace.id, inFlight);
-        return this.withTimeout(workspace, inFlight);
+        return this.withTimeout(inFlight);
     }
-    withTimeout(workspace, checkPromise) {
+    async withTimeout(inFlight) {
+        await inFlight.started;
+        const promise = inFlight.promise;
+        if (!promise) {
+            throw new Error('Workspace check started without a scheduled promise');
+        }
         const timeoutMs = this.getTimeoutMs();
         return new Promise((resolve, reject) => {
             const timeout = setTimeout(() => {
-                if (this.inFlightWorkspaceChecks.get(workspace.id) === checkPromise) {
-                    this.inFlightWorkspaceChecks.delete(workspace.id);
+                if (inFlight.timeoutDisabled) {
+                    return;
                 }
-                reject(new Error(`Workspace check timed out after ${timeoutMs}ms`));
+                const timeoutError = new Error(`Workspace check timed out after ${timeoutMs}ms`);
+                inFlight.controller.abort(timeoutError);
+                reject(timeoutError);
             }, timeoutMs);
             timeout.unref?.();
-            checkPromise.then(resolve, reject).finally(() => {
+            promise.then(resolve, reject).finally(() => {
                 clearTimeout(timeout);
             });
         });

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

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

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

@@ -21,5 +21,96 @@ describe('RatchetWorkspaceCheckCoordinator', () => {
         await firstExpectation;
         await secondExpectation;
     });
+    it('aborts the shared runner when a workspace check times out', async () => {
+        const coordinator = new RatchetWorkspaceCheckCoordinator(() => 1000);
+        const workspace = { id: 'workspace-abort' };
+        let receivedSignal;
+        const runner = vi.fn((signal) => {
+            receivedSignal = signal;
+            return new Promise((_resolve, reject) => {
+                signal?.addEventListener('abort', () => reject(signal.reason), { once: true });
+            });
+        });
+        const firstRun = coordinator.run(workspace, runner);
+        const secondRun = coordinator.run(workspace, runner);
+        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;
+        expect(runner).toHaveBeenCalledTimes(1);
+        expect(receivedSignal?.aborted).toBe(true);
+        expect(receivedSignal?.reason).toEqual(new Error('Workspace check timed out after 1000ms'));
+    });
+    it('keeps sharing an aborted runner until its cleanup settles', async () => {
+        const coordinator = new RatchetWorkspaceCheckCoordinator(() => 1000);
+        const workspace = { id: 'workspace-cleanup' };
+        let finishCleanup;
+        const cleanupBarrier = new Promise((resolve) => {
+            finishCleanup = resolve;
+        });
+        const runner = vi.fn(async (signal) => {
+            await new Promise((resolve) => {
+                signal.addEventListener('abort', () => resolve(), { once: true });
+            });
+            await cleanupBarrier;
+            signal.throwIfAborted();
+            throw new Error('unreachable');
+        });
+        const first = coordinator.run(workspace, runner);
+        const firstExpectation = expect(first).rejects.toThrow('Workspace check timed out after 1000ms');
+        await vi.advanceTimersByTimeAsync(1000);
+        await firstExpectation;
+        const joinedDuringCleanup = coordinator.run(workspace, runner);
+        expect(runner).toHaveBeenCalledTimes(1);
+        finishCleanup();
+        await expect(joinedDuringCleanup).rejects.toThrow('Workspace check timed out after 1000ms');
+        expect(runner).toHaveBeenCalledTimes(1);
+    });
+    it('starts the timeout only after the scheduler starts the runner', async () => {
+        const coordinator = new RatchetWorkspaceCheckCoordinator(() => 1000);
+        const workspace = { id: 'workspace-queued' };
+        let startScheduledRunner;
+        const schedule = vi.fn((task) => new Promise((resolve, reject) => {
+            startScheduledRunner = () => {
+                task().then(resolve, reject);
+            };
+        }));
+        const runner = vi.fn((signal) => new Promise((_resolve, reject) => {
+            signal.addEventListener('abort', () => reject(signal.reason), { once: true });
+        }));
+        const result = coordinator.run(workspace, runner, schedule);
+        await vi.advanceTimersByTimeAsync(5000);
+        expect(runner).not.toHaveBeenCalled();
+        startScheduledRunner();
+        const expectation = expect(result).rejects.toThrow('Workspace check timed out after 1000ms');
+        await vi.advanceTimersByTimeAsync(1000);
+        await expectation;
+        expect(runner).toHaveBeenCalledTimes(1);
+    });
+    it('lets a committed side-effect phase finish after the timeout budget', async () => {
+        const coordinator = new RatchetWorkspaceCheckCoordinator(() => 1000);
+        const workspace = { id: 'workspace-committed' };
+        let finishCommit;
+        const commitBarrier = new Promise((resolve) => {
+            finishCommit = resolve;
+        });
+        const expected = {
+            workspaceId: workspace.id,
+            previousState: 'IDLE',
+            newState: 'IDLE',
+            action: { type: 'WAITING', reason: 'committed' },
+        };
+        const result = coordinator.run(workspace, async (signal, commitSideEffects) => {
+            signal.throwIfAborted();
+            commitSideEffects();
+            await commitBarrier;
+            signal.throwIfAborted();
+            return expected;
+        });
+        await vi.advanceTimersByTimeAsync(5000);
+        finishCommit();
+        await expect(result).resolves.toEqual(expected);
+    });
 });
 //# sourceMappingURL=ratchet-workspace-check-coordinator.test.js.map

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

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

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

@@ -1,7 +1,8 @@
 import { EventEmitter } from 'node:events';
+import type { RatchetDispatchOutcome } from '../../../../../prisma/generated/client.js';
 import { CIStatus, RatchetState } from '../../../../shared/core/index.js';
 import type { RatchetGitHubBridge, RatchetPRSnapshotBridge, RatchetSessionBridge } from './bridges.js';
-import type { PRStateInfo, RatchetAction, RatchetCheckResult, RatchetDecisionContext, WorkspaceRatchetResult, WorkspaceWithPR } from './ratchet.types.js';
+import type { RatchetCheckResult, WorkspaceRatchetResult } 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";
@@ -16,6 +17,9 @@ export interface RatchetToggledEvent {
     enabled: boolean;
     ratchetState: RatchetState;
 }
+export interface RatchetCheckOptions {
+    bypassPrFetchCooldown?: boolean;
+}
 declare class RatchetService extends EventEmitter {
     private isShuttingDown;
     private monitorLoop;
@@ -25,7 +29,6 @@ declare class RatchetService extends EventEmitter {
     private readonly checkCoordinator;
     private cachedAuthenticatedUsername;
     private readonly backoff;
-    private readonly reviewPollTrackers;
     private sessionBridge;
     private githubBridge;
     private snapshotBridge;
@@ -43,74 +46,27 @@ declare class RatchetService extends EventEmitter {
     private sleep;
     private wakeSleep;
     checkAllWorkspaces(): Promise<RatchetCheckResult>;
-    checkWorkspaceById(workspaceId: string): Promise<WorkspaceRatchetResult | null>;
-    clearRatchetActiveSessionIfMatching(workspaceId: string, sessionId: string): Promise<void>;
+    checkWorkspaceById(workspaceId: string, opts?: RatchetCheckOptions): Promise<WorkspaceRatchetResult | null>;
+    recordSessionEnd(workspaceId: string, sessionId: string, outcome: Exclude<RatchetDispatchOutcome, 'RUNNING'>): Promise<void>;
+    markPrClosed(workspaceId: string): Promise<void>;
     private runWorkspaceCheckSafely;
     setWorkspaceRatcheting(workspaceId: string, enabled: boolean): Promise<void>;
     private processWorkspace;
     private logWorkspaceRatchetingDecision;
-    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;
+    private decideDiedFixerRetry;
     private applyRatchetDecision;
     private hasActionableFixTrigger;
-    private shouldSkipCleanPR;
-    private hasNewReviewActivitySinceLastDispatch;
-    private processReviewCommentPoll;
-    private handleReviewCommentPoll;
+    private finishRatchetCheck;
     private hasStateChangedSinceLastDispatch;
     private updateWorkspaceAfterCheck;
-    private getActiveRatchetSession;
+    private checkActiveFixerSession;
     private hasActiveSession;
     private fetchPRState;
-    private computeDispatchSnapshotKey;
-    private computeLatestReviewActivityAtMs;
     private getAuthenticatedUsernameCached;
-    private determineRatchetState;
     private triggerFixer;
-    private setActiveSession;
-    private clearActiveSession;
-    private resetDispatchState;
+    private stopActiveRatchetSessionsAfterDisable;
 }
 export declare const ratchetService: RatchetService;
 //# sourceMappingURL=ratchet.service.d.ts.map

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":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAWjE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAiB,MAAM,eAAe,CAAC;AACtE,OAAO,KAAK,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AACpG,OAAO,KAAK,EAMV,kBAAkB,EAGlB,sBAAsB,EAEvB,MAAM,iBAAiB,CAAC;AAiCzB,YAAY,EAAE,aAAa,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAEjG,eAAO,MAAM,qBAAqB,EAAG,uBAAgC,CAAC;AACtE,eAAO,MAAM,eAAe,EAAG,iBAA0B,CAAC;AAE1D,MAAM,WAAW,wBAAwB;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,YAAY,CAAC;IACxB,OAAO,EAAE,YAAY,CAAC;IAEtB,UAAU,CAAC,EAAE,QAAQ,CAAC;CACvB;AAED,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,YAAY,CAAC;CAC5B;AAED,MAAM,WAAW,mBAAmB;IAQlC,qBAAqB,CAAC,EAAE,OAAO,CAAC;CACjC;AAED,cAAM,cAAe,SAAQ,YAAY;IACvC,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,WAAW,CAA8B;IACjD,OAAO,CAAC,YAAY,CAA+B;IACnD,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,uBAAuB,CAA4C;IAC3E,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAE/B;IACF,OAAO,CAAC,2BAA2B,CAA2C;IAC9E,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0B;IAElD,OAAO,CAAC,aAAa,CAAqC;IAC1D,OAAO,CAAC,YAAY,CAAoC;IACxD,OAAO,CAAC,cAAc,CAAwC;IAE9D,SAAS,CAAC,OAAO,EAAE;QACjB,OAAO,EAAE,oBAAoB,CAAC;QAC9B,MAAM,EAAE,mBAAmB,CAAC;QAC5B,QAAQ,EAAE,uBAAuB,CAAC;KACnC,GAAG,IAAI;IAMR,OAAO,KAAK,OAAO,GAOlB;IAED,OAAO,KAAK,MAAM,GAOjB;IAED,OAAO,KAAK,QAAQ,GAOnB;IAED,KAAK,IAAI,IAAI;IAWP,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;YAab,iBAAiB;IAwB/B,OAAO,CAAC,KAAK;IA2Bb,OAAO,CAAC,SAAS;IAOX,kBAAkB,IAAI,OAAO,CAAC,kBAAkB,CAAC;IA+BjD,kBAAkB,CACtB,WAAW,EAAE,MAAM,EACnB,IAAI,CAAC,EAAE,mBAAmB,GACzB,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC;IAgCnC,gBAAgB,CACpB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,OAAO,CAAC,sBAAsB,EAAE,SAAS,CAAC,GAClD,OAAO,CAAC,IAAI,CAAC;IAkBV,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAkCxC,uBAAuB;IA8B/B,sBAAsB,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;YA8CpE,gBAAgB;IA4I9B,OAAO,CAAC,8BAA8B;YAkBxB,2BAA2B;YA8C3B,mBAAmB;YAqFnB,oBAAoB;YAuBpB,oBAAoB;IAwBlC,OAAO,CAAC,uBAAuB;YAYjB,kBAAkB;IA4FhC,OAAO,CAAC,gCAAgC;YAO1B,yBAAyB;YAoDzB,uBAAuB;YAWvB,gBAAgB;YAOhB,YAAY;YAgBZ,8BAA8B;YAU9B,YAAY;YAmBZ,qCAAqC;CAwBpD;AAED,eAAO,MAAM,cAAc,gBAAuB,CAAC"}