factory-factory 0.4.0 → 0.4.1

package/dist/src/backend/services/workspace/service/lifecycle/workspace-pr-snapshot.service.js

@@ -0,0 +1,32 @@
+import { workspaceAccessor } from '../../../../../backend/services/workspace/resources/workspace.accessor.js';
+class WorkspacePrSnapshotService {
+    record(workspaceId, data) {
+        return workspaceAccessor.update(workspaceId, {
+            prUrl: data.prUrl,
+            prNumber: data.prNumber,
+            prState: data.prState,
+            prReviewState: data.prReviewState,
+            prCiStatus: data.prCiStatus,
+            prUpdatedAt: data.prUpdatedAt,
+            prCiFailedAt: data.prCiFailedAt,
+            prCiLastNotifiedAt: data.prCiLastNotifiedAt,
+            prReviewLastCheckedAt: data.prReviewLastCheckedAt,
+            prReviewLastCommentId: data.prReviewLastCommentId,
+            branchName: data.branchName,
+        });
+    }
+    attachDiscoveredPRIfClaimMatches(workspaceId, prUrl, claim, prUpdatedAt) {
+        return workspaceAccessor.attachDiscoveredPRIfClaimMatches(workspaceId, prUrl, claim, prUpdatedAt);
+    }
+    updatePRSnapshotIfUrlMatches(workspaceId, prUrl, snapshot, prUpdatedAt) {
+        return workspaceAccessor.updatePRSnapshotIfUrlMatches(workspaceId, prUrl, snapshot, prUpdatedAt);
+    }
+    applyPrSnapshotWithDispatchReset(workspaceId, observation) {
+        return workspaceAccessor.applyPrSnapshotWithDispatchReset(workspaceId, observation);
+    }
+    applyCIObservationWithDispatchReset(workspaceId, observation) {
+        return workspaceAccessor.applyCIObservationWithDispatchReset(workspaceId, observation);
+    }
+}
+export const workspacePrSnapshotService = new WorkspacePrSnapshotService();
+//# sourceMappingURL=workspace-pr-snapshot.service.js.map

package/dist/src/backend/services/workspace/service/lifecycle/workspace-pr-snapshot.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-pr-snapshot.service.js","sourceRoot":"","sources":["../../../../../../../src/backend/services/workspace/service/lifecycle/workspace-pr-snapshot.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,2DAA2D,CAAC;AAkB9F,MAAM,0BAA0B;IAC9B,MAAM,CAAC,WAAmB,EAAE,IAA+B;QACzD,OAAO,iBAAiB,CAAC,MAAM,CAAC,WAAW,EAAE;YAC3C,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,kBAAkB,EAAE,IAAI,CAAC,kBAAkB;YAC3C,qBAAqB,EAAE,IAAI,CAAC,qBAAqB;YACjD,qBAAqB,EAAE,IAAI,CAAC,qBAAqB;YACjD,UAAU,EAAE,IAAI,CAAC,UAAU;SAC5B,CAAC,CAAC;IACL,CAAC;IAED,gCAAgC,CAC9B,WAAmB,EACnB,KAAa,EACb,KAAuB,EACvB,WAAiB;QAEjB,OAAO,iBAAiB,CAAC,gCAAgC,CACvD,WAAW,EACX,KAAK,EACL,KAAK,EACL,WAAW,CACZ,CAAC;IACJ,CAAC;IAED,4BAA4B,CAC1B,WAAmB,EACnB,KAAa,EACb,QAA0B,EAC1B,WAAiB;QAEjB,OAAO,iBAAiB,CAAC,4BAA4B,CACnD,WAAW,EACX,KAAK,EACL,QAAQ,EACR,WAAW,CACZ,CAAC;IACJ,CAAC;IAED,gCAAgC,CAC9B,WAAmB,EACnB,WAAqF;QAErF,OAAO,iBAAiB,CAAC,gCAAgC,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;IACtF,CAAC;IAED,mCAAmC,CACjC,WAAmB,EACnB,WAAwF;QAExF,OAAO,iBAAiB,CAAC,mCAAmC,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;IACzF,CAAC;CACF;AAED,MAAM,CAAC,MAAM,0BAA0B,GAAG,IAAI,0BAA0B,EAAE,CAAC"}

package/dist/src/backend/services/workspace/service/lifecycle/workspace-pr-snapshot.service.test.d.ts

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

package/dist/src/backend/services/workspace/service/lifecycle/workspace-pr-snapshot.service.test.d.ts.map

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

package/dist/src/backend/services/workspace/service/lifecycle/workspace-pr-snapshot.service.test.js

@@ -0,0 +1,65 @@
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+const { mockApplyCIObservationWithDispatchReset, mockApplyPrSnapshotWithDispatchReset, mockAttachDiscoveredPRIfClaimMatches, mockUpdatePRSnapshotIfUrlMatches, } = vi.hoisted(() => ({
+    mockApplyCIObservationWithDispatchReset: vi.fn(),
+    mockApplyPrSnapshotWithDispatchReset: vi.fn(),
+    mockAttachDiscoveredPRIfClaimMatches: vi.fn(),
+    mockUpdatePRSnapshotIfUrlMatches: vi.fn(),
+}));
+vi.mock('@/backend/services/workspace/resources/workspace.accessor', () => ({
+    workspaceAccessor: {
+        applyCIObservationWithDispatchReset: (...args) => mockApplyCIObservationWithDispatchReset(...args),
+        applyPrSnapshotWithDispatchReset: (...args) => mockApplyPrSnapshotWithDispatchReset(...args),
+        attachDiscoveredPRIfClaimMatches: (...args) => mockAttachDiscoveredPRIfClaimMatches(...args),
+        updatePRSnapshotIfUrlMatches: (...args) => mockUpdatePRSnapshotIfUrlMatches(...args),
+    },
+}));
+import { workspacePrSnapshotService } from './workspace-pr-snapshot.service.js';
+describe('workspacePrSnapshotService', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    it('guards discovered PR attachment with the current discovery claim', async () => {
+        const claim = {
+            branchName: 'feature/discovery',
+            checkedAt: new Date('2026-07-17T12:00:00.000Z'),
+            retryCount: 2,
+            nextCheckAt: new Date('2026-07-17T12:06:00.000Z'),
+        };
+        const updatedAt = new Date('2026-07-17T12:01:00.000Z');
+        mockAttachDiscoveredPRIfClaimMatches.mockResolvedValue(true);
+        await expect(workspacePrSnapshotService.attachDiscoveredPRIfClaimMatches('workspace-1', 'https://github.com/org/repo/pull/1', claim, updatedAt)).resolves.toBe(true);
+        expect(mockAttachDiscoveredPRIfClaimMatches).toHaveBeenCalledWith('workspace-1', 'https://github.com/org/repo/pull/1', claim, updatedAt);
+    });
+    it('guards snapshot updates with the attached PR URL', async () => {
+        const snapshot = {
+            prNumber: 1,
+            prState: 'OPEN',
+            prReviewState: null,
+            prCiStatus: 'SUCCESS',
+        };
+        const updatedAt = new Date('2026-07-17T12:02:00.000Z');
+        mockUpdatePRSnapshotIfUrlMatches.mockResolvedValue(false);
+        await expect(workspacePrSnapshotService.updatePRSnapshotIfUrlMatches('workspace-1', 'https://github.com/org/repo/pull/1', snapshot, updatedAt)).resolves.toBe(false);
+        expect(mockUpdatePRSnapshotIfUrlMatches).toHaveBeenCalledWith('workspace-1', 'https://github.com/org/repo/pull/1', snapshot, updatedAt);
+    });
+    it('owns atomic PR aggregate dispatch reset persistence', async () => {
+        const observation = {
+            prNumber: 1,
+            prState: 'OPEN',
+            prReviewState: null,
+            prCiStatus: 'SUCCESS',
+            prUpdatedAt: new Date('2026-07-17T12:03:00.000Z'),
+        };
+        await workspacePrSnapshotService.applyPrSnapshotWithDispatchReset('workspace-1', observation);
+        expect(mockApplyPrSnapshotWithDispatchReset).toHaveBeenCalledWith('workspace-1', observation);
+    });
+    it('owns atomic CI observation dispatch reset persistence', async () => {
+        const observation = {
+            prCiStatus: 'FAILURE',
+            prUpdatedAt: new Date('2026-07-17T12:04:00.000Z'),
+        };
+        await workspacePrSnapshotService.applyCIObservationWithDispatchReset('workspace-1', observation);
+        expect(mockApplyCIObservationWithDispatchReset).toHaveBeenCalledWith('workspace-1', observation);
+    });
+});
+//# sourceMappingURL=workspace-pr-snapshot.service.test.js.map

package/dist/src/backend/services/workspace/service/lifecycle/workspace-pr-snapshot.service.test.js.map

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

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

@@ -0,0 +1,243 @@
+import type { RatchetDispatchOutcome } from '../../../../../../prisma/generated/client.js';
+import type { RatchetState } from '../../../../../shared/core/index.js';
+declare class WorkspaceRatchetService {
+    findCandidates(): Promise<{
+        id: string;
+        prUrl: string;
+        prNumber: number | null;
+        prState: import("../../../../../shared/core/index.js").PRState;
+        prCiStatus: import("../../../../../shared/core/index.js").CIStatus;
+        defaultSessionProvider: import("../../../../../../prisma/generated/client.js").WorkspaceProviderSelection;
+        ratchetSessionProvider: import("../../../../../../prisma/generated/client.js").WorkspaceProviderSelection;
+        ratchetEnabled: boolean;
+        ratchetState: RatchetState;
+        ratchetActiveSessionId: string | null;
+        ratchetLastCiRunId: string | null;
+        ratchetDispatchOutcome: RatchetDispatchOutcome | null;
+        ratchetDispatchRetryCount: number;
+        prReviewLastCheckedAt: Date | null;
+    }[]>;
+    findCandidateById(workspaceId: string): Promise<{
+        id: string;
+        prUrl: string;
+        prNumber: number | null;
+        prState: import("../../../../../shared/core/index.js").PRState;
+        prCiStatus: import("../../../../../shared/core/index.js").CIStatus;
+        defaultSessionProvider: import("../../../../../../prisma/generated/client.js").WorkspaceProviderSelection;
+        ratchetSessionProvider: import("../../../../../../prisma/generated/client.js").WorkspaceProviderSelection;
+        ratchetEnabled: boolean;
+        ratchetState: RatchetState;
+        ratchetActiveSessionId: string | null;
+        ratchetLastCiRunId: string | null;
+        ratchetDispatchOutcome: RatchetDispatchOutcome | null;
+        ratchetDispatchRetryCount: number;
+        prReviewLastCheckedAt: Date | null;
+    } | null>;
+    recordSessionEnd(workspaceId: string, sessionId: string, outcome: Exclude<RatchetDispatchOutcome, 'RUNNING'>): Promise<boolean>;
+    recordDispatchIfEnabled(workspaceId: string, input: {
+        sessionId: string;
+        snapshotKey: string;
+        retryCount: number;
+    }): Promise<boolean>;
+    adoptActiveSessionIfEnabled(workspaceId: string, sessionId: string): Promise<boolean>;
+    transitionStateIfEnabled(workspaceId: string, from: RatchetState, data: {
+        ratchetState: RatchetState;
+        ratchetLastCheckedAt: Date;
+    }): Promise<boolean>;
+    settleIdleWhileDisabled(workspaceId: string, from: RatchetState): Promise<boolean>;
+    clearActiveSession(workspaceId: string): Promise<{
+        name: string;
+        updatedAt: Date;
+        id: string;
+        projectId: string;
+        description: string | null;
+        status: import("../../../../../../prisma/generated/client.js").WorkspaceStatus;
+        worktreePath: string | null;
+        branchName: string | null;
+        isAutoGeneratedBranch: boolean;
+        creationSource: import("../../../../../../prisma/generated/client.js").WorkspaceCreationSource;
+        creationMetadata: import("@prisma/client/runtime/client").JsonValue | null;
+        initErrorMessage: string | null;
+        initOutput: string | null;
+        initStartedAt: Date | null;
+        initCompletedAt: Date | null;
+        initScriptPid: number | null;
+        initRetryCount: number;
+        runScriptCommand: string | null;
+        runScriptPostRunCommand: string | null;
+        runScriptCleanupCommand: string | null;
+        runScriptPid: number | null;
+        runScriptPort: number | null;
+        runScriptStartedAt: Date | null;
+        runScriptStatus: import("../../../../../../prisma/generated/client.js").RunScriptStatus;
+        prUrl: string | null;
+        githubIssueNumber: number | null;
+        githubIssueUrl: string | null;
+        linearIssueId: string | null;
+        linearIssueIdentifier: string | null;
+        linearIssueUrl: string | null;
+        defaultSessionProvider: import("../../../../../../prisma/generated/client.js").WorkspaceProviderSelection;
+        ratchetSessionProvider: import("../../../../../../prisma/generated/client.js").WorkspaceProviderSelection;
+        createdAt: Date;
+        prNumber: number | null;
+        prState: import("../../../../../../prisma/generated/client.js").PRState;
+        prReviewState: string | null;
+        prCiStatus: import("../../../../../../prisma/generated/client.js").CIStatus;
+        prUpdatedAt: Date | null;
+        prDiscoveryLastCheckedAt: Date | null;
+        prDiscoveryRetryCount: number;
+        prDiscoveryNextCheckAt: Date | null;
+        prCiFailedAt: Date | null;
+        prCiLastNotifiedAt: Date | null;
+        prReviewLastCheckedAt: Date | null;
+        prReviewLastCommentId: string | null;
+        ratchetEnabled: boolean;
+        ratchetState: import("../../../../../../prisma/generated/client.js").RatchetState;
+        ratchetLastCheckedAt: Date | null;
+        ratchetActiveSessionId: string | null;
+        ratchetLastCiRunId: string | null;
+        ratchetDispatchOutcome: RatchetDispatchOutcome | null;
+        ratchetDispatchRetryCount: number;
+        mode: import("../../../../../../prisma/generated/client.js").WorkspaceMode;
+        autoIterationStatus: import("../../../../../../prisma/generated/client.js").AutoIterationStatus | null;
+        autoIterationConfig: import("@prisma/client/runtime/client").JsonValue | null;
+        autoIterationProgress: import("@prisma/client/runtime/client").JsonValue | null;
+        autoIterationSessionId: string | null;
+        periodicTaskId: string | null;
+        parentWorkspaceId: string | null;
+        hasHadSessions: boolean;
+        cachedKanbanColumn: import("../../../../../../prisma/generated/client.js").KanbanColumn;
+        stateComputedAt: Date | null;
+    }>;
+    enable(workspaceId: string): Promise<{
+        name: string;
+        updatedAt: Date;
+        id: string;
+        projectId: string;
+        description: string | null;
+        status: import("../../../../../../prisma/generated/client.js").WorkspaceStatus;
+        worktreePath: string | null;
+        branchName: string | null;
+        isAutoGeneratedBranch: boolean;
+        creationSource: import("../../../../../../prisma/generated/client.js").WorkspaceCreationSource;
+        creationMetadata: import("@prisma/client/runtime/client").JsonValue | null;
+        initErrorMessage: string | null;
+        initOutput: string | null;
+        initStartedAt: Date | null;
+        initCompletedAt: Date | null;
+        initScriptPid: number | null;
+        initRetryCount: number;
+        runScriptCommand: string | null;
+        runScriptPostRunCommand: string | null;
+        runScriptCleanupCommand: string | null;
+        runScriptPid: number | null;
+        runScriptPort: number | null;
+        runScriptStartedAt: Date | null;
+        runScriptStatus: import("../../../../../../prisma/generated/client.js").RunScriptStatus;
+        prUrl: string | null;
+        githubIssueNumber: number | null;
+        githubIssueUrl: string | null;
+        linearIssueId: string | null;
+        linearIssueIdentifier: string | null;
+        linearIssueUrl: string | null;
+        defaultSessionProvider: import("../../../../../../prisma/generated/client.js").WorkspaceProviderSelection;
+        ratchetSessionProvider: import("../../../../../../prisma/generated/client.js").WorkspaceProviderSelection;
+        createdAt: Date;
+        prNumber: number | null;
+        prState: import("../../../../../../prisma/generated/client.js").PRState;
+        prReviewState: string | null;
+        prCiStatus: import("../../../../../../prisma/generated/client.js").CIStatus;
+        prUpdatedAt: Date | null;
+        prDiscoveryLastCheckedAt: Date | null;
+        prDiscoveryRetryCount: number;
+        prDiscoveryNextCheckAt: Date | null;
+        prCiFailedAt: Date | null;
+        prCiLastNotifiedAt: Date | null;
+        prReviewLastCheckedAt: Date | null;
+        prReviewLastCommentId: string | null;
+        ratchetEnabled: boolean;
+        ratchetState: import("../../../../../../prisma/generated/client.js").RatchetState;
+        ratchetLastCheckedAt: Date | null;
+        ratchetActiveSessionId: string | null;
+        ratchetLastCiRunId: string | null;
+        ratchetDispatchOutcome: RatchetDispatchOutcome | null;
+        ratchetDispatchRetryCount: number;
+        mode: import("../../../../../../prisma/generated/client.js").WorkspaceMode;
+        autoIterationStatus: import("../../../../../../prisma/generated/client.js").AutoIterationStatus | null;
+        autoIterationConfig: import("@prisma/client/runtime/client").JsonValue | null;
+        autoIterationProgress: import("@prisma/client/runtime/client").JsonValue | null;
+        autoIterationSessionId: string | null;
+        periodicTaskId: string | null;
+        parentWorkspaceId: string | null;
+        hasHadSessions: boolean;
+        cachedKanbanColumn: import("../../../../../../prisma/generated/client.js").KanbanColumn;
+        stateComputedAt: Date | null;
+    }>;
+    disable(workspaceId: string): Promise<{
+        name: string;
+        updatedAt: Date;
+        id: string;
+        projectId: string;
+        description: string | null;
+        status: import("../../../../../../prisma/generated/client.js").WorkspaceStatus;
+        worktreePath: string | null;
+        branchName: string | null;
+        isAutoGeneratedBranch: boolean;
+        creationSource: import("../../../../../../prisma/generated/client.js").WorkspaceCreationSource;
+        creationMetadata: import("@prisma/client/runtime/client").JsonValue | null;
+        initErrorMessage: string | null;
+        initOutput: string | null;
+        initStartedAt: Date | null;
+        initCompletedAt: Date | null;
+        initScriptPid: number | null;
+        initRetryCount: number;
+        runScriptCommand: string | null;
+        runScriptPostRunCommand: string | null;
+        runScriptCleanupCommand: string | null;
+        runScriptPid: number | null;
+        runScriptPort: number | null;
+        runScriptStartedAt: Date | null;
+        runScriptStatus: import("../../../../../../prisma/generated/client.js").RunScriptStatus;
+        prUrl: string | null;
+        githubIssueNumber: number | null;
+        githubIssueUrl: string | null;
+        linearIssueId: string | null;
+        linearIssueIdentifier: string | null;
+        linearIssueUrl: string | null;
+        defaultSessionProvider: import("../../../../../../prisma/generated/client.js").WorkspaceProviderSelection;
+        ratchetSessionProvider: import("../../../../../../prisma/generated/client.js").WorkspaceProviderSelection;
+        createdAt: Date;
+        prNumber: number | null;
+        prState: import("../../../../../../prisma/generated/client.js").PRState;
+        prReviewState: string | null;
+        prCiStatus: import("../../../../../../prisma/generated/client.js").CIStatus;
+        prUpdatedAt: Date | null;
+        prDiscoveryLastCheckedAt: Date | null;
+        prDiscoveryRetryCount: number;
+        prDiscoveryNextCheckAt: Date | null;
+        prCiFailedAt: Date | null;
+        prCiLastNotifiedAt: Date | null;
+        prReviewLastCheckedAt: Date | null;
+        prReviewLastCommentId: string | null;
+        ratchetEnabled: boolean;
+        ratchetState: import("../../../../../../prisma/generated/client.js").RatchetState;
+        ratchetLastCheckedAt: Date | null;
+        ratchetActiveSessionId: string | null;
+        ratchetLastCiRunId: string | null;
+        ratchetDispatchOutcome: RatchetDispatchOutcome | null;
+        ratchetDispatchRetryCount: number;
+        mode: import("../../../../../../prisma/generated/client.js").WorkspaceMode;
+        autoIterationStatus: import("../../../../../../prisma/generated/client.js").AutoIterationStatus | null;
+        autoIterationConfig: import("@prisma/client/runtime/client").JsonValue | null;
+        autoIterationProgress: import("@prisma/client/runtime/client").JsonValue | null;
+        autoIterationSessionId: string | null;
+        periodicTaskId: string | null;
+        parentWorkspaceId: string | null;
+        hasHadSessions: boolean;
+        cachedKanbanColumn: import("../../../../../../prisma/generated/client.js").KanbanColumn;
+        stateComputedAt: Date | null;
+    }>;
+}
+export declare const workspaceRatchetService: WorkspaceRatchetService;
+export {};
+//# sourceMappingURL=workspace-ratchet.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-ratchet.service.d.ts","sourceRoot":"","sources":["../../../../../../../src/backend/services/workspace/service/lifecycle/workspace-ratchet.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAEjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElD,cAAM,uBAAuB;IAC3B,cAAc;;;;;;;;;;;;;;;;IAId,iBAAiB,CAAC,WAAW,EAAE,MAAM;;;;;;;;;;;;;;;;IAIrC,gBAAgB,CACd,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,OAAO,CAAC,sBAAsB,EAAE,SAAS,CAAC;IAKrD,uBAAuB,CACrB,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE;IAKvE,2BAA2B,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;IAIlE,wBAAwB,CACtB,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,YAAY,EAClB,IAAI,EAAE;QAAE,YAAY,EAAE,YAAY,CAAC;QAAC,oBAAoB,EAAE,IAAI,CAAA;KAAE;IAKlE,uBAAuB,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY;IAI/D,kBAAkB,CAAC,WAAW,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAItC,MAAM,CAAC,WAAW,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAI1B,OAAO,CAAC,WAAW,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAU5B;AAED,eAAO,MAAM,uBAAuB,yBAAgC,CAAC"}

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

@@ -0,0 +1,42 @@
+import { workspaceAccessor } from '../../../../../backend/services/workspace/resources/workspace.accessor.js';
+class WorkspaceRatchetService {
+    findCandidates() {
+        return workspaceAccessor.findWithPRsForRatchet();
+    }
+    findCandidateById(workspaceId) {
+        return workspaceAccessor.findForRatchetById(workspaceId);
+    }
+    recordSessionEnd(workspaceId, sessionId, outcome) {
+        return workspaceAccessor.recordRatchetSessionEnd(workspaceId, sessionId, outcome);
+    }
+    recordDispatchIfEnabled(workspaceId, input) {
+        return workspaceAccessor.recordRatchetDispatchIfEnabled(workspaceId, input);
+    }
+    adoptActiveSessionIfEnabled(workspaceId, sessionId) {
+        return workspaceAccessor.adoptRatchetActiveSessionIfEnabled(workspaceId, sessionId);
+    }
+    transitionStateIfEnabled(workspaceId, from, data) {
+        return workspaceAccessor.transitionRatchetStateIfEnabled(workspaceId, from, data);
+    }
+    settleIdleWhileDisabled(workspaceId, from) {
+        return workspaceAccessor.settleRatchetIdleWhileDisabled(workspaceId, from);
+    }
+    clearActiveSession(workspaceId) {
+        return workspaceAccessor.update(workspaceId, { ratchetActiveSessionId: null });
+    }
+    enable(workspaceId) {
+        return workspaceAccessor.update(workspaceId, { ratchetEnabled: true });
+    }
+    disable(workspaceId) {
+        return workspaceAccessor.update(workspaceId, {
+            ratchetEnabled: false,
+            ratchetState: 'IDLE',
+            ratchetActiveSessionId: null,
+            ratchetLastCiRunId: null,
+            ratchetDispatchOutcome: null,
+            ratchetDispatchRetryCount: 0,
+        });
+    }
+}
+export const workspaceRatchetService = new WorkspaceRatchetService();
+//# sourceMappingURL=workspace-ratchet.service.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-ratchet.service.js","sourceRoot":"","sources":["../../../../../../../src/backend/services/workspace/service/lifecycle/workspace-ratchet.service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,2DAA2D,CAAC;AAG9F,MAAM,uBAAuB;IAC3B,cAAc;QACZ,OAAO,iBAAiB,CAAC,qBAAqB,EAAE,CAAC;IACnD,CAAC;IAED,iBAAiB,CAAC,WAAmB;QACnC,OAAO,iBAAiB,CAAC,kBAAkB,CAAC,WAAW,CAAC,CAAC;IAC3D,CAAC;IAED,gBAAgB,CACd,WAAmB,EACnB,SAAiB,EACjB,OAAmD;QAEnD,OAAO,iBAAiB,CAAC,uBAAuB,CAAC,WAAW,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;IACpF,CAAC;IAED,uBAAuB,CACrB,WAAmB,EACnB,KAAqE;QAErE,OAAO,iBAAiB,CAAC,8BAA8B,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;IAC9E,CAAC;IAED,2BAA2B,CAAC,WAAmB,EAAE,SAAiB;QAChE,OAAO,iBAAiB,CAAC,kCAAkC,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;IACtF,CAAC;IAED,wBAAwB,CACtB,WAAmB,EACnB,IAAkB,EAClB,IAAgE;QAEhE,OAAO,iBAAiB,CAAC,+BAA+B,CAAC,WAAW,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IACpF,CAAC;IAED,uBAAuB,CAAC,WAAmB,EAAE,IAAkB;QAC7D,OAAO,iBAAiB,CAAC,8BAA8B,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;IAC7E,CAAC;IAED,kBAAkB,CAAC,WAAmB;QACpC,OAAO,iBAAiB,CAAC,MAAM,CAAC,WAAW,EAAE,EAAE,sBAAsB,EAAE,IAAI,EAAE,CAAC,CAAC;IACjF,CAAC;IAED,MAAM,CAAC,WAAmB;QACxB,OAAO,iBAAiB,CAAC,MAAM,CAAC,WAAW,EAAE,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC,CAAC;IACzE,CAAC;IAED,OAAO,CAAC,WAAmB;QACzB,OAAO,iBAAiB,CAAC,MAAM,CAAC,WAAW,EAAE;YAC3C,cAAc,EAAE,KAAK;YACrB,YAAY,EAAE,MAAM;YACpB,sBAAsB,EAAE,IAAI;YAC5B,kBAAkB,EAAE,IAAI;YACxB,sBAAsB,EAAE,IAAI;YAC5B,yBAAyB,EAAE,CAAC;SAC7B,CAAC,CAAC;IACL,CAAC;CACF;AAED,MAAM,CAAC,MAAM,uBAAuB,GAAG,IAAI,uBAAuB,EAAE,CAAC"}

package/dist/src/backend/services/workspace/service/lifecycle/workspace-relationships.service.d.ts

@@ -0,0 +1,186 @@
+declare class WorkspaceRelationshipsService {
+    findChildrenWithStatus(parentWorkspaceId: string): Promise<({
+        project: {
+            name: string;
+            updatedAt: Date;
+            id: string;
+            createdAt: Date;
+            slug: string;
+            repoPath: string;
+            worktreeBasePath: string;
+            defaultBranch: string;
+            githubOwner: string | null;
+            githubRepo: string | null;
+            isArchived: boolean;
+            issueProvider: import("../../../../../../prisma/generated/enums.js").IssueProvider;
+            issueTrackerConfig: import("@prisma/client/runtime/client").JsonValue | null;
+            startupScriptCommand: string | null;
+            startupScriptPath: string | null;
+            startupScriptTimeout: number;
+        };
+        agentSessions: {
+            name: string | null;
+            model: string;
+            workflow: string;
+            provider: import("../../../../../../prisma/generated/enums.js").SessionProvider;
+            updatedAt: Date;
+            id: string;
+            status: import("../../../../../../prisma/generated/enums.js").SessionStatus;
+            createdAt: Date;
+            workspaceId: string;
+            providerSessionId: string | null;
+            providerProjectPath: string | null;
+            providerProcessPid: number | null;
+            providerMetadata: import("@prisma/client/runtime/client").JsonValue | null;
+        }[];
+    } & {
+        name: string;
+        updatedAt: Date;
+        id: string;
+        projectId: string;
+        description: string | null;
+        status: import("../../../../../../prisma/generated/enums.js").WorkspaceStatus;
+        worktreePath: string | null;
+        branchName: string | null;
+        isAutoGeneratedBranch: boolean;
+        creationSource: import("../../../../../../prisma/generated/enums.js").WorkspaceCreationSource;
+        creationMetadata: import("@prisma/client/runtime/client").JsonValue | null;
+        initErrorMessage: string | null;
+        initOutput: string | null;
+        initStartedAt: Date | null;
+        initCompletedAt: Date | null;
+        initScriptPid: number | null;
+        initRetryCount: number;
+        runScriptCommand: string | null;
+        runScriptPostRunCommand: string | null;
+        runScriptCleanupCommand: string | null;
+        runScriptPid: number | null;
+        runScriptPort: number | null;
+        runScriptStartedAt: Date | null;
+        runScriptStatus: import("../../../../../../prisma/generated/enums.js").RunScriptStatus;
+        prUrl: string | null;
+        githubIssueNumber: number | null;
+        githubIssueUrl: string | null;
+        linearIssueId: string | null;
+        linearIssueIdentifier: string | null;
+        linearIssueUrl: string | null;
+        defaultSessionProvider: import("../../../../../../prisma/generated/enums.js").WorkspaceProviderSelection;
+        ratchetSessionProvider: import("../../../../../../prisma/generated/enums.js").WorkspaceProviderSelection;
+        createdAt: Date;
+        prNumber: number | null;
+        prState: import("../../../../../../prisma/generated/enums.js").PRState;
+        prReviewState: string | null;
+        prCiStatus: import("../../../../../../prisma/generated/enums.js").CIStatus;
+        prUpdatedAt: Date | null;
+        prDiscoveryLastCheckedAt: Date | null;
+        prDiscoveryRetryCount: number;
+        prDiscoveryNextCheckAt: Date | null;
+        prCiFailedAt: Date | null;
+        prCiLastNotifiedAt: Date | null;
+        prReviewLastCheckedAt: Date | null;
+        prReviewLastCommentId: string | null;
+        ratchetEnabled: boolean;
+        ratchetState: import("../../../../../../prisma/generated/enums.js").RatchetState;
+        ratchetLastCheckedAt: Date | null;
+        ratchetActiveSessionId: string | null;
+        ratchetLastCiRunId: string | null;
+        ratchetDispatchOutcome: import("../../../../../../prisma/generated/enums.js").RatchetDispatchOutcome | null;
+        ratchetDispatchRetryCount: number;
+        mode: import("../../../../../../prisma/generated/enums.js").WorkspaceMode;
+        autoIterationStatus: import("../../../../../../prisma/generated/enums.js").AutoIterationStatus | null;
+        autoIterationConfig: import("@prisma/client/runtime/client").JsonValue | null;
+        autoIterationProgress: import("@prisma/client/runtime/client").JsonValue | null;
+        autoIterationSessionId: string | null;
+        periodicTaskId: string | null;
+        parentWorkspaceId: string | null;
+        hasHadSessions: boolean;
+        cachedKanbanColumn: import("../../../../../../prisma/generated/enums.js").KanbanColumn;
+        stateComputedAt: Date | null;
+    })[]>;
+    findParent(childWorkspaceId: string): Promise<({
+        project: {
+            name: string;
+            updatedAt: Date;
+            id: string;
+            createdAt: Date;
+            slug: string;
+            repoPath: string;
+            worktreeBasePath: string;
+            defaultBranch: string;
+            githubOwner: string | null;
+            githubRepo: string | null;
+            isArchived: boolean;
+            issueProvider: import("../../../../../../prisma/generated/enums.js").IssueProvider;
+            issueTrackerConfig: import("@prisma/client/runtime/client").JsonValue | null;
+            startupScriptCommand: string | null;
+            startupScriptPath: string | null;
+            startupScriptTimeout: number;
+        };
+    } & {
+        name: string;
+        updatedAt: Date;
+        id: string;
+        projectId: string;
+        description: string | null;
+        status: import("../../../../../../prisma/generated/enums.js").WorkspaceStatus;
+        worktreePath: string | null;
+        branchName: string | null;
+        isAutoGeneratedBranch: boolean;
+        creationSource: import("../../../../../../prisma/generated/enums.js").WorkspaceCreationSource;
+        creationMetadata: import("@prisma/client/runtime/client").JsonValue | null;
+        initErrorMessage: string | null;
+        initOutput: string | null;
+        initStartedAt: Date | null;
+        initCompletedAt: Date | null;
+        initScriptPid: number | null;
+        initRetryCount: number;
+        runScriptCommand: string | null;
+        runScriptPostRunCommand: string | null;
+        runScriptCleanupCommand: string | null;
+        runScriptPid: number | null;
+        runScriptPort: number | null;
+        runScriptStartedAt: Date | null;
+        runScriptStatus: import("../../../../../../prisma/generated/enums.js").RunScriptStatus;
+        prUrl: string | null;
+        githubIssueNumber: number | null;
+        githubIssueUrl: string | null;
+        linearIssueId: string | null;
+        linearIssueIdentifier: string | null;
+        linearIssueUrl: string | null;
+        defaultSessionProvider: import("../../../../../../prisma/generated/enums.js").WorkspaceProviderSelection;
+        ratchetSessionProvider: import("../../../../../../prisma/generated/enums.js").WorkspaceProviderSelection;
+        createdAt: Date;
+        prNumber: number | null;
+        prState: import("../../../../../../prisma/generated/enums.js").PRState;
+        prReviewState: string | null;
+        prCiStatus: import("../../../../../../prisma/generated/enums.js").CIStatus;
+        prUpdatedAt: Date | null;
+        prDiscoveryLastCheckedAt: Date | null;
+        prDiscoveryRetryCount: number;
+        prDiscoveryNextCheckAt: Date | null;
+        prCiFailedAt: Date | null;
+        prCiLastNotifiedAt: Date | null;
+        prReviewLastCheckedAt: Date | null;
+        prReviewLastCommentId: string | null;
+        ratchetEnabled: boolean;
+        ratchetState: import("../../../../../../prisma/generated/enums.js").RatchetState;
+        ratchetLastCheckedAt: Date | null;
+        ratchetActiveSessionId: string | null;
+        ratchetLastCiRunId: string | null;
+        ratchetDispatchOutcome: import("../../../../../../prisma/generated/enums.js").RatchetDispatchOutcome | null;
+        ratchetDispatchRetryCount: number;
+        mode: import("../../../../../../prisma/generated/enums.js").WorkspaceMode;
+        autoIterationStatus: import("../../../../../../prisma/generated/enums.js").AutoIterationStatus | null;
+        autoIterationConfig: import("@prisma/client/runtime/client").JsonValue | null;
+        autoIterationProgress: import("@prisma/client/runtime/client").JsonValue | null;
+        autoIterationSessionId: string | null;
+        periodicTaskId: string | null;
+        parentWorkspaceId: string | null;
+        hasHadSessions: boolean;
+        cachedKanbanColumn: import("../../../../../../prisma/generated/enums.js").KanbanColumn;
+        stateComputedAt: Date | null;
+    }) | null>;
+}
+export declare const workspaceRelationshipsService: WorkspaceRelationshipsService;
+export {};
+//# sourceMappingURL=workspace-relationships.service.d.ts.map

package/dist/src/backend/services/workspace/service/lifecycle/workspace-relationships.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-relationships.service.d.ts","sourceRoot":"","sources":["../../../../../../../src/backend/services/workspace/service/lifecycle/workspace-relationships.service.ts"],"names":[],"mappings":"AAEA,cAAM,6BAA6B;IACjC,sBAAsB,CAAC,iBAAiB,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAIhD,UAAU,CAAC,gBAAgB,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAGpC;AAED,eAAO,MAAM,6BAA6B,+BAAsC,CAAC"}

package/dist/src/backend/services/workspace/service/lifecycle/workspace-relationships.service.js

@@ -0,0 +1,11 @@
+import { workspaceAccessor } from '../../../../../backend/services/workspace/resources/workspace.accessor.js';
+class WorkspaceRelationshipsService {
+    findChildrenWithStatus(parentWorkspaceId) {
+        return workspaceAccessor.findChildrenWithStatus(parentWorkspaceId);
+    }
+    findParent(childWorkspaceId) {
+        return workspaceAccessor.findParentWorkspace(childWorkspaceId);
+    }
+}
+export const workspaceRelationshipsService = new WorkspaceRelationshipsService();
+//# sourceMappingURL=workspace-relationships.service.js.map

package/dist/src/backend/services/workspace/service/lifecycle/workspace-relationships.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-relationships.service.js","sourceRoot":"","sources":["../../../../../../../src/backend/services/workspace/service/lifecycle/workspace-relationships.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,2DAA2D,CAAC;AAE9F,MAAM,6BAA6B;IACjC,sBAAsB,CAAC,iBAAyB;QAC9C,OAAO,iBAAiB,CAAC,sBAAsB,CAAC,iBAAiB,CAAC,CAAC;IACrE,CAAC;IAED,UAAU,CAAC,gBAAwB;QACjC,OAAO,iBAAiB,CAAC,mBAAmB,CAAC,gBAAgB,CAAC,CAAC;IACjE,CAAC;CACF;AAED,MAAM,CAAC,MAAM,6BAA6B,GAAG,IAAI,6BAA6B,EAAE,CAAC"}