factory-factory 0.4.9 → 0.4.11

package/dist/src/backend/services/ratchet/service/ratchet-observation-watcher.test.js

@@ -0,0 +1,179 @@
+import { beforeEach, expect, it, vi } from 'vitest';
+const mocks = vi.hoisted(() => ({
+    listEnabled: vi.fn(),
+    listPending: vi.fn(),
+    markChecked: vi.fn(),
+    register: vi.fn(),
+    snapshot: vi.fn(),
+    get: vi.fn(),
+}));
+vi.mock('@/backend/services/job-runner.service', () => ({
+    jobRunner: { register: mocks.register, start: vi.fn(), stop: vi.fn() },
+}));
+vi.mock('@/backend/services/workspace', () => ({
+    workspacePRMonitoringService: mocks,
+    workspacePrSnapshotService: { list: mocks.snapshot },
+}));
+import { RatchetService, RATCHET_DISPATCH_CHANGED, RATCHET_STATE_CHANGED, RATCHET_TOGGLED, } from './ratchet.service.js';
+beforeEach(() => {
+    mocks.listEnabled.mockReset();
+    mocks.listPending.mockReset().mockResolvedValue([]);
+    mocks.markChecked.mockReset().mockResolvedValue(undefined);
+    mocks.snapshot.mockReset().mockResolvedValue([]);
+    mocks.get.mockReset().mockResolvedValue({ enabled: true, bindingRevision: 7 });
+});
+it('observes every association and wakes the main queue once without creating fixer sessions', async () => {
+    mocks.listEnabled.mockResolvedValue([
+        {
+            workspaceId: 'w',
+            enabled: true,
+            workspace: {
+                prs: [
+                    {
+                        id: 'p1',
+                        state: 'OPEN',
+                        ciStatus: 'FAILURE',
+                        hasMergeConflict: false,
+                        reviewState: null,
+                    },
+                    {
+                        id: 'p2',
+                        state: 'MERGED',
+                        ciStatus: 'SUCCESS',
+                        hasMergeConflict: false,
+                        reviewState: null,
+                    },
+                ],
+            },
+        },
+    ]);
+    mocks.listPending.mockResolvedValue([]);
+    const observe = vi.fn().mockResolvedValue(true), wake = vi.fn().mockResolvedValue(undefined);
+    const ratchetService = new RatchetService();
+    ratchetService.configure({ observe, wake, setMonitoring: vi.fn() });
+    await ratchetService.checkAllWorkspaces();
+    expect(observe.mock.calls.map((c) => c[0])).toEqual([
+        { workspaceId: 'w', prId: 'p1' },
+        { workspaceId: 'w', prId: 'p2' },
+    ]);
+    expect(wake).toHaveBeenCalledExactlyOnceWith('w');
+    expect(mocks.register).toHaveBeenCalledWith(expect.objectContaining({ name: 'pr-event-poll', intervalMs: 120_000 }));
+    observe.mockClear().mockImplementation((target) => {
+        if (target.prId === 'p1') {
+            return Promise.reject(new Error('Repository is inaccessible'));
+        }
+        return Promise.resolve(true);
+    });
+    wake.mockClear();
+    await ratchetService.checkAllWorkspaces();
+    expect(observe.mock.calls.map((c) => c[0].prId)).toEqual(['p1', 'p2']);
+    expect(wake).toHaveBeenCalledExactlyOnceWith('w');
+    observe.mockClear().mockRejectedValue(new Error('HTTP 429 rate limit'));
+    wake.mockClear();
+    await ratchetService.checkAllWorkspaces();
+    expect(observe).toHaveBeenCalledTimes(1);
+    expect(wake).toHaveBeenCalledExactlyOnceWith('w');
+});
+const config = {
+    workspaceId: 'w',
+    enabled: true,
+    workspace: {
+        prs: [
+            { id: 'p1', state: 'OPEN', ciStatus: 'FAILURE', hasMergeConflict: false, reviewState: null },
+        ],
+    },
+};
+function deferred() {
+    let resolve;
+    const promise = new Promise((done) => {
+        resolve = done;
+    });
+    return { promise, resolve };
+}
+it.each(['all', 'single'])('does not begin %s workspace checks after stopping during the query', async (scope) => {
+    const loaded = deferred();
+    mocks.listEnabled.mockReturnValue(loaded.promise);
+    const observe = vi.fn().mockResolvedValue(true);
+    const wake = vi.fn().mockResolvedValue(undefined);
+    const service = new RatchetService();
+    service.configure({ observe, wake, setMonitoring: vi.fn() });
+    const checking = scope === 'all' ? service.checkAllWorkspaces() : service.checkWorkspaceById('w');
+    await service.stop();
+    loaded.resolve([config]);
+    await checking;
+    expect(observe).not.toHaveBeenCalled();
+    expect(wake).not.toHaveBeenCalled();
+});
+it.each([
+    { deliveryMode: 'DEDICATED' },
+    { resume: true },
+    { recipientSessionId: 'replacement' },
+])('refreshes monitoring projection without a false state reset for %j', async (options) => {
+    const service = new RatchetService();
+    const setMonitoring = vi.fn().mockResolvedValue({ status: 'updated', bindingRevision: 8 });
+    service.configure({ observe: vi.fn(), wake: vi.fn(), setMonitoring });
+    const toggled = vi.fn(), changed = vi.fn();
+    service.on(RATCHET_TOGGLED, toggled);
+    service.on(RATCHET_DISPATCH_CHANGED, changed);
+    await service.setWorkspaceRatcheting('w', true, { ...options, expectedBindingRevision: 7 });
+    expect(toggled).not.toHaveBeenCalled();
+    expect(changed).toHaveBeenCalledExactlyOnceWith({ workspaceId: 'w' });
+});
+it.each([false, true])('publishes only an actual enablement transition to %s', async (enabled) => {
+    mocks.get.mockResolvedValue({ enabled: !enabled, bindingRevision: 7 });
+    const service = new RatchetService();
+    const setMonitoring = vi.fn().mockResolvedValue({ status: 'updated', bindingRevision: 8 });
+    service.configure({ observe: vi.fn(), wake: vi.fn(), setMonitoring });
+    const toggled = vi.fn(), changed = vi.fn();
+    service.on(RATCHET_TOGGLED, toggled);
+    service.on(RATCHET_DISPATCH_CHANGED, changed);
+    await service.setWorkspaceRatcheting('w', enabled);
+    expect(toggled).toHaveBeenCalledExactlyOnceWith({
+        workspaceId: 'w',
+        enabled,
+        ratchetState: 'IDLE',
+    });
+    expect(changed).not.toHaveBeenCalled();
+});
+it('preserves the displayed revision rather than substituting the latest one', async () => {
+    const service = new RatchetService();
+    const setMonitoring = vi.fn().mockRejectedValue(new Error('revision changed'));
+    service.configure({ observe: vi.fn(), wake: vi.fn(), setMonitoring });
+    const toggled = vi.fn(), changed = vi.fn();
+    service.on(RATCHET_TOGGLED, toggled);
+    service.on(RATCHET_DISPATCH_CHANGED, changed);
+    await expect(service.setWorkspaceRatcheting('w', true, { expectedBindingRevision: 6 })).rejects.toThrow('revision changed');
+    expect(setMonitoring).toHaveBeenCalledWith(expect.objectContaining({ expectedBindingRevision: 6 }));
+    expect(toggled).not.toHaveBeenCalled();
+    expect(changed).not.toHaveBeenCalled();
+});
+it.each(['markChecked', 'listPending', 'wake', 'snapshot'])('does not continue delivery or publish state after stopping during %s', async (stage) => {
+    mocks.listEnabled.mockResolvedValue([config]);
+    const entered = deferred();
+    const release = deferred();
+    const observe = vi.fn().mockResolvedValue(true);
+    const wake = vi.fn().mockResolvedValue(undefined);
+    const paused = stage === 'wake' ? wake : mocks[stage];
+    paused.mockImplementation(() => {
+        entered.resolve();
+        return release.promise;
+    });
+    const service = new RatchetService();
+    service.configure({ observe, wake, setMonitoring: vi.fn() });
+    const dispatchChanged = vi.fn(), stateChanged = vi.fn();
+    service.on(RATCHET_DISPATCH_CHANGED, dispatchChanged);
+    service.on(RATCHET_STATE_CHANGED, stateChanged);
+    const checking = service.checkAllWorkspaces();
+    await entered.promise;
+    await service.stop();
+    release.resolve([]);
+    await checking;
+    if (stage === 'markChecked' || stage === 'listPending') {
+        expect(wake).not.toHaveBeenCalled();
+    }
+    if (stage !== 'snapshot') {
+        expect(dispatchChanged).not.toHaveBeenCalled();
+    }
+    expect(stateChanged).not.toHaveBeenCalled();
+});
+//# sourceMappingURL=ratchet-observation-watcher.test.js.map

package/dist/src/backend/services/ratchet/service/ratchet-observation-watcher.test.js.map

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

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

@@ -1,9 +1,6 @@
 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, RatchetWorkspaceBridge } from './bridges.js';
-import type { RatchetCheckResult, WorkspaceRatchetResult } from './ratchet.types.js';
-export type { RatchetAction, RatchetCheckResult, WorkspaceRatchetResult } from './ratchet.types.js';
+import { type CIStatus, RatchetState } from '../../../../shared/core/index.js';
+import type { PRTarget, PRDeliveryMode } from '../../../../shared/pr-monitoring.js';
 export declare const RATCHET_STATE_CHANGED: 'ratchet_state_changed';
 export declare const RATCHET_TOGGLED: 'ratchet_toggled';
 export declare const RATCHET_DISPATCH_CHANGED: 'ratchet_dispatch_changed';
@@ -12,6 +9,7 @@ export interface RatchetDispatchChangedEvent {
 }
 export interface RatchetStateChangedEvent {
     workspaceId: string;
+    prId?: string;
     fromState: RatchetState;
     toState: RatchetState;
     prCiStatus?: CIStatus;
@@ -21,59 +19,87 @@ export interface RatchetToggledEvent {
     enabled: boolean;
     ratchetState: RatchetState;
 }
-export interface RatchetCheckOptions {
-    bypassPrFetchCooldown?: boolean;
+export type RatchetAction = {
+    type: 'WAITING';
+    reason: string;
+} | {
+    type: 'EVENTS_QUEUED';
+} | {
+    type: 'ERROR';
+    error: string;
+};
+export interface WorkspaceRatchetResult {
+    workspaceId: string;
+    previousState: RatchetState;
+    newState: RatchetState;
+    action: RatchetAction;
+}
+export interface RatchetCheckResult {
+    checked: number;
+    stateChanges: number;
+    actionsTriggered: number;
+    results: WorkspaceRatchetResult[];
+}
+interface MonitoringBridge {
+    retireLegacy?(): Promise<unknown>;
+    observe(target: PRTarget, signal?: AbortSignal): Promise<boolean>;
+    wake(workspaceId: string): Promise<void>;
+    setMonitoring(input: {
+        workspaceId: string;
+        enabled: boolean;
+        recipientSessionId?: string | null;
+        deliveryMode?: PRDeliveryMode;
+        resume?: boolean;
+        expectedBindingRevision: number;
+    }): Promise<{
+        status: 'updated';
+        bindingRevision: number;
+    } | {
+        status: 'recipient_required';
+        bindingRevision: number;
+        candidates: {
+            id: string;
+            name: string | null;
+            provider: string;
+        }[];
+    }>;
 }
-declare class RatchetService extends EventEmitter {
-    private runSignal;
+export declare class RatchetService extends EventEmitter {
+    private bridge;
     private stopped;
-    private workspaceCheckTimeoutMs;
-    private readonly checkCoordinator;
-    private cachedAuthenticatedUsername;
-    private readonly backoff;
-    private sessionBridge;
-    private githubBridge;
-    private snapshotBridge;
-    private workspaceBridge;
+    private backoff;
+    private limit;
+    private checking;
+    private controllers;
     constructor();
-    private get isShuttingDown();
-    configure(bridges: {
-        session: RatchetSessionBridge;
-        github: RatchetGitHubBridge;
-        snapshot: RatchetPRSnapshotBridge;
-        workspace: RatchetWorkspaceBridge;
-    }): void;
-    private get workspace();
-    private get session();
-    private get github();
-    private get snapshot();
-    start(): void;
+    configure(bridge: MonitoringBridge): void;
+    start(): Promise<void>;
     stop(): Promise<void>;
-    private runCycle;
-    private nextPollDelay;
-    checkAllWorkspaces(): Promise<RatchetCheckResult>;
-    checkWorkspaceById(workspaceId: string, opts?: RatchetCheckOptions): Promise<WorkspaceRatchetResult | null>;
-    recordSessionEnd(workspaceId: string, sessionId: string, outcome: Exclude<RatchetDispatchOutcome, 'RUNNING'>): Promise<void>;
-    private runWorkspaceCheckSafely;
-    setWorkspaceRatcheting(workspaceId: string, enabled: boolean): Promise<void>;
-    private processWorkspace;
-    private logWorkspaceRatchetingDecision;
-    private buildRatchetDecisionContext;
-    private decideRatchetAction;
-    private recordDispatchStalled;
-    private decideDiedFixerRetry;
-    private applyRatchetDecision;
-    private hasActionableFixTrigger;
-    private finishRatchetCheck;
-    private hasStateChangedSinceLastDispatch;
-    private updateWorkspaceAfterCheck;
-    private checkActiveFixerSession;
-    private hasActiveSession;
-    private fetchPRState;
-    private getAuthenticatedUsernameCached;
-    private triggerFixer;
-    private stopActiveRatchetSessionsForMergedPr;
-    private stopActiveRatchetSessionsAfterDisable;
+    checkAllWorkspaces(signal?: AbortSignal): Promise<RatchetCheckResult>;
+    checkWorkspaceById(workspaceId: string, _options?: {
+        bypassPrFetchCooldown?: boolean;
+    }): Promise<WorkspaceRatchetResult | null>;
+    private check;
+    private observeAssociations;
+    private emitStateChange;
+    setWorkspaceRatcheting(workspaceId: string, enabled: boolean, options?: {
+        recipientSessionId?: string | null;
+        expectedBindingRevision?: number;
+        deliveryMode?: PRDeliveryMode;
+        resume?: boolean;
+    }): Promise<{
+        status: 'updated';
+        bindingRevision: number;
+    } | {
+        status: 'recipient_required';
+        bindingRevision: number;
+        candidates: {
+            id: string;
+            name: string | null;
+            provider: string;
+        }[];
+    }>;
 }
 export declare const ratchetService: RatchetService;
+export {};
 //# 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;AAU3C,OAAO,EAAE,KAAK,QAAQ,EAAsB,YAAY,EAAE,MAAM,eAAe,CAAC;AAChF,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAIvE,eAAO,MAAM,qBAAqB,EAAG,uBAAgC,CAAC;AACtE,eAAO,MAAM,eAAe,EAAG,iBAA0B,CAAC;AAC1D,eAAO,MAAM,wBAAwB,EAAG,0BAAmC,CAAC;AAC5E,MAAM,WAAW,2BAA2B;IAC1C,WAAW,EAAE,MAAM,CAAC;CACrB;AACD,MAAM,WAAW,wBAAwB;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,YAAY,CAAC;IACxB,OAAO,EAAE,YAAY,CAAC;IACtB,UAAU,CAAC,EAAE,QAAQ,CAAC;CACvB;AACD,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,YAAY,CAAC;CAC5B;AACD,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACnC;IAAE,IAAI,EAAE,eAAe,CAAA;CAAE,GACzB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AACrC,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,YAAY,CAAC;IAC5B,QAAQ,EAAE,YAAY,CAAC;IACvB,MAAM,EAAE,aAAa,CAAC;CACvB;AACD,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,OAAO,EAAE,sBAAsB,EAAE,CAAC;CACnC;AACD,UAAU,gBAAgB;IACxB,YAAY,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAClC,OAAO,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAClE,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,aAAa,CAAC,KAAK,EAAE;QACnB,WAAW,EAAE,MAAM,CAAC;QACpB,OAAO,EAAE,OAAO,CAAC;QACjB,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACnC,YAAY,CAAC,EAAE,cAAc,CAAC;QAC9B,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,uBAAuB,EAAE,MAAM,CAAC;KACjC,GAAG,OAAO,CACP;QAAE,MAAM,EAAE,SAAS,CAAC;QAAC,eAAe,EAAE,MAAM,CAAA;KAAE,GAC9C;QACE,MAAM,EAAE,oBAAoB,CAAC;QAC7B,eAAe,EAAE,MAAM,CAAC;QACxB,UAAU,EAAE;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;KACrE,CACJ,CAAC;CACH;AA+BD,qBAAa,cAAe,SAAQ,YAAY;IAC9C,OAAO,CAAC,MAAM,CAAiC;IAC/C,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,OAAO,CAA0B;IACzC,OAAO,CAAC,KAAK,CAAa;IAC1B,OAAO,CAAC,QAAQ,CAAsD;IACtE,OAAO,CAAC,WAAW,CAA8B;IACjD,cAaC;IACD,SAAS,CAAC,MAAM,EAAE,gBAAgB,QAEjC;IACK,KAAK,kBAMV;IACK,IAAI,kBAMT;IACK,kBAAkB,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAiB1E;IACK,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE;QAAE,qBAAqB,CAAC,EAAE,OAAO,CAAA;KAAE,0CAQ3F;IACD,OAAO,CAAC,KAAK;YA8EC,mBAAmB;IAwBjC,OAAO,CAAC,eAAe;IAajB,sBAAsB,CAC1B,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE;QACR,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACnC,uBAAuB,CAAC,EAAE,MAAM,CAAC;QACjC,YAAY,CAAC,EAAE,cAAc,CAAC;QAC9B,MAAM,CAAC,EAAE,OAAO,CAAC;KAClB;gBAlOW,SAAS;yBAAmB,MAAM;;gBAElC,oBAAoB;yBACX,MAAM;oBACX;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAA;SAAE,EAAE;OAoPxE;CACF;AACD,eAAO,MAAM,cAAc,gBAAuB,CAAC"}