factory-factory 0.2.0 → 0.2.2

package/dist/src/backend/services/workspace-creation.service.test.js

@@ -0,0 +1,328 @@
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+import * as claudeSessionAccessorModule from '../resource_accessors/claude-session.accessor.js';
+import * as projectAccessorModule from '../resource_accessors/project.accessor.js';
+import * as userSettingsAccessorModule from '../resource_accessors/user-settings.accessor.js';
+import * as workspaceAccessorModule from '../resource_accessors/workspace.accessor.js';
+import * as gitOpsServiceModule from './git-ops.service.js';
+import { WorkspaceCreationService, } from './workspace-creation.service.js';
+import * as worktreeLifecycleServiceModule from './worktree-lifecycle.service.js';
+vi.mock('../resource_accessors/workspace.accessor');
+vi.mock('../resource_accessors/project.accessor');
+vi.mock('../resource_accessors/user-settings.accessor');
+vi.mock('../resource_accessors/claude-session.accessor');
+vi.mock('./git-ops.service');
+vi.mock('./worktree-lifecycle.service');
+vi.mock('../trpc/workspace/init.trpc', () => ({
+    initializeWorkspaceWorktree: vi.fn().mockResolvedValue(undefined),
+}));
+describe('WorkspaceCreationService', () => {
+    let service;
+    let mockLogger;
+    let mockConfigService;
+    const mockWorkspace = {
+        id: 'ws-123',
+        projectId: 'proj-1',
+        name: 'Test Workspace',
+        description: null,
+        status: 'NEW',
+        branchName: null,
+        worktreePath: null,
+        isAutoGeneratedBranch: false,
+        creationSource: 'MANUAL',
+        creationMetadata: null,
+        prUrl: null,
+        githubIssueNumber: null,
+        githubIssueUrl: null,
+        prNumber: null,
+        prState: 'NONE',
+        prReviewState: null,
+        prCiStatus: 'UNKNOWN',
+        prUpdatedAt: null,
+        prCiFailedAt: null,
+        prCiLastNotifiedAt: null,
+        prReviewLastCheckedAt: null,
+        prReviewLastCommentId: null,
+        ratchetEnabled: true,
+        ratchetState: 'IDLE',
+        ratchetLastCheckedAt: null,
+        ratchetLastPushAt: null,
+        ratchetActiveSessionId: null,
+        ratchetLastCiRunId: null,
+        ratchetLastNotifiedState: null,
+        hasHadSessions: false,
+        cachedKanbanColumn: 'WAITING',
+        stateComputedAt: null,
+        initErrorMessage: null,
+        initOutput: null,
+        initStartedAt: null,
+        initCompletedAt: null,
+        initRetryCount: 0,
+        runScriptCommand: null,
+        runScriptCleanupCommand: null,
+        runScriptPid: null,
+        runScriptPort: null,
+        runScriptStartedAt: null,
+        runScriptStatus: 'IDLE',
+        createdAt: new Date(),
+        updatedAt: new Date(),
+    };
+    const mockProject = {
+        id: 'proj-1',
+        name: 'Test Project',
+        slug: 'test-project',
+        repoPath: '/path/to/repo',
+        worktreeBasePath: '/path/to/worktrees',
+        defaultBranch: 'main',
+        githubOwner: null,
+        githubRepo: null,
+        isArchived: false,
+        startupScriptCommand: null,
+        startupScriptPath: null,
+        startupScriptTimeout: 300,
+        createdAt: new Date(),
+        updatedAt: new Date(),
+        workspaces: [],
+    };
+    beforeEach(() => {
+        vi.clearAllMocks();
+        mockLogger = {
+            info: vi.fn(),
+            warn: vi.fn(),
+            error: vi.fn(),
+            debug: vi.fn(),
+        };
+        mockConfigService = {
+            getMaxSessionsPerWorkspace: vi.fn().mockReturnValue(5),
+        };
+        service = new WorkspaceCreationService({
+            logger: mockLogger,
+            configService: mockConfigService,
+        });
+        const mockUserSettings = {
+            id: '1',
+            userId: 'default',
+            preferredIde: 'cursor',
+            customIdeCommand: '',
+            playSoundOnComplete: true,
+            notificationSoundPath: null,
+            workspaceOrder: null,
+            cachedSlashCommands: null,
+            ratchetEnabled: true,
+            ratchetAutoFixCi: true,
+            ratchetAutoFixConflicts: true,
+            ratchetAutoFixReviews: true,
+            ratchetAutoMerge: false,
+            ratchetAllowedReviewers: null,
+            createdAt: new Date(),
+            updatedAt: new Date(),
+        };
+        vi.spyOn(userSettingsAccessorModule.userSettingsAccessor, 'get').mockResolvedValue(mockUserSettings);
+        vi.spyOn(workspaceAccessorModule.workspaceAccessor, 'create').mockResolvedValue(mockWorkspace);
+        vi.spyOn(claudeSessionAccessorModule.claudeSessionAccessor, 'create').mockResolvedValue({
+            id: 'session-1',
+            workspaceId: 'ws-123',
+            workflow: 'feature',
+            name: 'Chat 1',
+            status: 'IDLE',
+            model: 'sonnet',
+            claudeSessionId: null,
+            claudeProcessPid: null,
+            createdAt: new Date(),
+            updatedAt: new Date(),
+        });
+        vi.spyOn(worktreeLifecycleServiceModule, 'setWorkspaceInitMode').mockResolvedValue();
+    });
+    describe('create', () => {
+        describe('MANUAL source', () => {
+            it('should create workspace with manual source', async () => {
+                const source = {
+                    type: 'MANUAL',
+                    projectId: 'proj-1',
+                    name: 'My Workspace',
+                    description: 'A test workspace',
+                    branchName: 'feature/test',
+                };
+                const result = await service.create(source);
+                expect(result.workspace).toEqual(mockWorkspace);
+                expect(result.defaultSessionCreated).toBe(true);
+                expect(workspaceAccessorModule.workspaceAccessor.create).toHaveBeenCalledWith({
+                    projectId: 'proj-1',
+                    name: 'My Workspace',
+                    description: 'A test workspace',
+                    branchName: 'feature/test',
+                    creationSource: 'MANUAL',
+                    ratchetEnabled: true,
+                });
+            });
+            it('should use explicit ratchetEnabled value', async () => {
+                const source = {
+                    type: 'MANUAL',
+                    projectId: 'proj-1',
+                    name: 'My Workspace',
+                    ratchetEnabled: false,
+                };
+                await service.create(source);
+                expect(workspaceAccessorModule.workspaceAccessor.create).toHaveBeenCalledWith(expect.objectContaining({
+                    ratchetEnabled: false,
+                }));
+            });
+            it('should default to user settings ratchetEnabled when not provided', async () => {
+                const disabledSettings = {
+                    id: '1',
+                    userId: 'default',
+                    preferredIde: 'cursor',
+                    customIdeCommand: '',
+                    playSoundOnComplete: true,
+                    notificationSoundPath: null,
+                    workspaceOrder: null,
+                    cachedSlashCommands: null,
+                    ratchetEnabled: false,
+                    ratchetAutoFixCi: true,
+                    ratchetAutoFixConflicts: true,
+                    ratchetAutoFixReviews: true,
+                    ratchetAutoMerge: false,
+                    ratchetAllowedReviewers: null,
+                    createdAt: new Date(),
+                    updatedAt: new Date(),
+                };
+                vi.spyOn(userSettingsAccessorModule.userSettingsAccessor, 'get').mockResolvedValue(disabledSettings);
+                const source = {
+                    type: 'MANUAL',
+                    projectId: 'proj-1',
+                    name: 'My Workspace',
+                };
+                await service.create(source);
+                expect(workspaceAccessorModule.workspaceAccessor.create).toHaveBeenCalledWith(expect.objectContaining({
+                    ratchetEnabled: false,
+                }));
+            });
+        });
+        describe('RESUME_BRANCH source', () => {
+            beforeEach(() => {
+                vi.spyOn(projectAccessorModule.projectAccessor, 'findById').mockResolvedValue(mockProject);
+                vi.spyOn(gitOpsServiceModule.gitOpsService, 'isBranchCheckedOut').mockResolvedValue(false);
+            });
+            it('should create workspace from resume branch source', async () => {
+                const source = {
+                    type: 'RESUME_BRANCH',
+                    projectId: 'proj-1',
+                    branchName: 'existing-branch',
+                    name: 'Resumed Workspace',
+                };
+                const result = await service.create(source);
+                expect(result.workspace).toEqual(mockWorkspace);
+                expect(projectAccessorModule.projectAccessor.findById).toHaveBeenCalledWith('proj-1');
+                expect(gitOpsServiceModule.gitOpsService.isBranchCheckedOut).toHaveBeenCalledWith(mockProject, 'existing-branch');
+                expect(worktreeLifecycleServiceModule.setWorkspaceInitMode).toHaveBeenCalledWith('ws-123', true, '/path/to/worktrees');
+            });
+            it('should use branch name as workspace name when name not provided', async () => {
+                const source = {
+                    type: 'RESUME_BRANCH',
+                    projectId: 'proj-1',
+                    branchName: 'my-feature-branch',
+                };
+                await service.create(source);
+                expect(workspaceAccessorModule.workspaceAccessor.create).toHaveBeenCalledWith(expect.objectContaining({
+                    name: 'my-feature-branch',
+                }));
+            });
+            it('should throw error when project not found', async () => {
+                vi.spyOn(projectAccessorModule.projectAccessor, 'findById').mockResolvedValue(null);
+                const source = {
+                    type: 'RESUME_BRANCH',
+                    projectId: 'proj-1',
+                    branchName: 'existing-branch',
+                };
+                await expect(service.create(source)).rejects.toThrow('Project not found: proj-1');
+            });
+            it('should throw error when branch is already checked out', async () => {
+                vi.spyOn(gitOpsServiceModule.gitOpsService, 'isBranchCheckedOut').mockResolvedValue(true);
+                const source = {
+                    type: 'RESUME_BRANCH',
+                    projectId: 'proj-1',
+                    branchName: 'existing-branch',
+                };
+                await expect(service.create(source)).rejects.toThrow("Branch 'existing-branch' is already checked out in another worktree.");
+            });
+        });
+        describe('GITHUB_ISSUE source', () => {
+            it('should create workspace from GitHub issue source', async () => {
+                const source = {
+                    type: 'GITHUB_ISSUE',
+                    projectId: 'proj-1',
+                    issueNumber: 42,
+                    issueUrl: 'https://github.com/org/repo/issues/42',
+                    name: 'Fix bug #42',
+                };
+                const result = await service.create(source);
+                expect(result.workspace).toEqual(mockWorkspace);
+                expect(workspaceAccessorModule.workspaceAccessor.create).toHaveBeenCalledWith({
+                    projectId: 'proj-1',
+                    name: 'Fix bug #42',
+                    githubIssueNumber: 42,
+                    githubIssueUrl: 'https://github.com/org/repo/issues/42',
+                    creationSource: 'GITHUB_ISSUE',
+                    creationMetadata: {
+                        issueNumber: 42,
+                        issueUrl: 'https://github.com/org/repo/issues/42',
+                    },
+                    ratchetEnabled: true,
+                });
+            });
+            it('should generate default name from issue number when name not provided', async () => {
+                const source = {
+                    type: 'GITHUB_ISSUE',
+                    projectId: 'proj-1',
+                    issueNumber: 42,
+                    issueUrl: 'https://github.com/org/repo/issues/42',
+                };
+                await service.create(source);
+                expect(workspaceAccessorModule.workspaceAccessor.create).toHaveBeenCalledWith(expect.objectContaining({
+                    name: 'Issue #42',
+                }));
+            });
+        });
+        describe('default session provisioning', () => {
+            it('should create default session when max sessions > 0', async () => {
+                const source = {
+                    type: 'MANUAL',
+                    projectId: 'proj-1',
+                    name: 'Test',
+                };
+                const result = await service.create(source);
+                expect(result.defaultSessionCreated).toBe(true);
+                expect(claudeSessionAccessorModule.claudeSessionAccessor.create).toHaveBeenCalledWith({
+                    workspaceId: 'ws-123',
+                    workflow: 'followup',
+                    name: 'Chat 1',
+                });
+            });
+            it('should not create default session when max sessions is 0', async () => {
+                vi.mocked(mockConfigService.getMaxSessionsPerWorkspace).mockReturnValue(0);
+                const source = {
+                    type: 'MANUAL',
+                    projectId: 'proj-1',
+                    name: 'Test',
+                };
+                const result = await service.create(source);
+                expect(result.defaultSessionCreated).toBe(false);
+                expect(claudeSessionAccessorModule.claudeSessionAccessor.create).not.toHaveBeenCalled();
+            });
+            it('should handle default session creation failure gracefully', async () => {
+                vi.spyOn(claudeSessionAccessorModule.claudeSessionAccessor, 'create').mockRejectedValue(new Error('Session creation failed'));
+                const source = {
+                    type: 'MANUAL',
+                    projectId: 'proj-1',
+                    name: 'Test',
+                };
+                const result = await service.create(source);
+                expect(result.workspace).toEqual(mockWorkspace);
+                expect(result.defaultSessionCreated).toBe(false);
+                expect(mockLogger.warn).toHaveBeenCalledWith('Failed to create default session for workspace', expect.objectContaining({
+                    workspaceId: 'ws-123',
+                }));
+            });
+        });
+    });
+});
+//# sourceMappingURL=workspace-creation.service.test.js.map

package/dist/src/backend/services/workspace-creation.service.test.js.map

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

package/dist/src/backend/services/workspace-flow-state.service.d.ts

@@ -0,0 +1,22 @@
+import { CIStatus, PRState, RatchetState } from '../../../prisma/generated/client.js';
+export type WorkspaceFlowPhase = 'NO_PR' | 'CI_WAIT' | 'RATCHET_VERIFY' | 'RATCHET_FIXING' | 'READY' | 'MERGED';
+export interface WorkspaceFlowStateInput {
+    prUrl: string | null;
+    prState: PRState;
+    prCiStatus: CIStatus;
+    prUpdatedAt: Date | null;
+    ratchetEnabled: boolean;
+    ratchetState: RatchetState;
+}
+export type WorkspaceFlowStateSource = Pick<WorkspaceFlowStateInput, 'prUrl' | 'prState' | 'prCiStatus' | 'prUpdatedAt' | 'ratchetEnabled' | 'ratchetState'>;
+export type WorkspaceCiObservation = 'NOT_FETCHED' | 'NO_CHECKS' | 'CHECKS_PENDING' | 'CHECKS_FAILED' | 'CHECKS_PASSED' | 'CHECKS_UNKNOWN';
+export interface WorkspaceFlowState {
+    phase: WorkspaceFlowPhase;
+    ciObservation: WorkspaceCiObservation;
+    isWorking: boolean;
+    shouldAnimateRatchetButton: boolean;
+    hasActivePr: boolean;
+}
+export declare function deriveWorkspaceFlowState(input: WorkspaceFlowStateInput): WorkspaceFlowState;
+export declare function deriveWorkspaceFlowStateFromWorkspace(workspace: WorkspaceFlowStateSource): WorkspaceFlowState;
+//# sourceMappingURL=workspace-flow-state.service.d.ts.map

package/dist/src/backend/services/workspace-flow-state.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-flow-state.service.d.ts","sourceRoot":"","sources":["../../../../src/backend/services/workspace-flow-state.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAErE,MAAM,MAAM,kBAAkB,GAC1B,OAAO,GACP,SAAS,GACT,gBAAgB,GAChB,gBAAgB,GAChB,OAAO,GACP,QAAQ,CAAC;AAEb,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,QAAQ,CAAC;IACrB,WAAW,EAAE,IAAI,GAAG,IAAI,CAAC;IACzB,cAAc,EAAE,OAAO,CAAC;IACxB,YAAY,EAAE,YAAY,CAAC;CAC5B;AAED,MAAM,MAAM,wBAAwB,GAAG,IAAI,CACzC,uBAAuB,EACvB,OAAO,GAAG,SAAS,GAAG,YAAY,GAAG,aAAa,GAAG,gBAAgB,GAAG,cAAc,CACvF,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAC9B,aAAa,GACb,WAAW,GACX,gBAAgB,GAChB,eAAe,GACf,eAAe,GACf,gBAAgB,CAAC;AAErB,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,kBAAkB,CAAC;IAC1B,aAAa,EAAE,sBAAsB,CAAC;IACtC,SAAS,EAAE,OAAO,CAAC;IACnB,0BAA0B,EAAE,OAAO,CAAC;IACpC,WAAW,EAAE,OAAO,CAAC;CACtB;AA8CD,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,uBAAuB,GAAG,kBAAkB,CAuE3F;AAED,wBAAgB,qCAAqC,CACnD,SAAS,EAAE,wBAAwB,GAClC,kBAAkB,CASpB"}

package/dist/src/backend/services/workspace-flow-state.service.js

@@ -0,0 +1,109 @@
+import { CIStatus, PRState, RatchetState } from '../../../prisma/generated/client.js';
+const ACTIVE_PR_STATES = new Set([
+    PRState.OPEN,
+    PRState.DRAFT,
+    PRState.CHANGES_REQUESTED,
+    PRState.APPROVED,
+]);
+const RATCHET_FIXING_STATES = new Set([
+    RatchetState.CI_FAILED,
+    RatchetState.MERGE_CONFLICT,
+    RatchetState.REVIEW_PENDING,
+]);
+function hasActivePr(prUrl, prState) {
+    if (!prUrl) {
+        return false;
+    }
+    return ACTIVE_PR_STATES.has(prState);
+}
+function deriveWorkspaceCiObservation(input) {
+    if (input.prCiStatus === CIStatus.PENDING) {
+        return 'CHECKS_PENDING';
+    }
+    if (input.prCiStatus === CIStatus.FAILURE) {
+        return 'CHECKS_FAILED';
+    }
+    if (input.prCiStatus === CIStatus.SUCCESS) {
+        return 'CHECKS_PASSED';
+    }
+    if (input.prCiStatus === CIStatus.UNKNOWN) {
+        return input.prUpdatedAt ? 'NO_CHECKS' : 'NOT_FETCHED';
+    }
+    return 'CHECKS_UNKNOWN';
+}
+export function deriveWorkspaceFlowState(input) {
+    const activePr = hasActivePr(input.prUrl, input.prState);
+    const ciObservation = deriveWorkspaceCiObservation(input);
+    if (input.prState === PRState.MERGED) {
+        return {
+            phase: 'MERGED',
+            ciObservation,
+            isWorking: false,
+            shouldAnimateRatchetButton: false,
+            hasActivePr: false,
+        };
+    }
+    if (!activePr) {
+        return {
+            phase: 'NO_PR',
+            ciObservation,
+            isWorking: false,
+            shouldAnimateRatchetButton: false,
+            hasActivePr: false,
+        };
+    }
+    if (ciObservation === 'NOT_FETCHED' || ciObservation === 'CHECKS_PENDING') {
+        return {
+            phase: 'CI_WAIT',
+            ciObservation,
+            isWorking: true,
+            shouldAnimateRatchetButton: input.ratchetEnabled,
+            hasActivePr: true,
+        };
+    }
+    if (!input.ratchetEnabled) {
+        return {
+            phase: 'READY',
+            ciObservation,
+            isWorking: false,
+            shouldAnimateRatchetButton: false,
+            hasActivePr: true,
+        };
+    }
+    if (RATCHET_FIXING_STATES.has(input.ratchetState)) {
+        return {
+            phase: 'RATCHET_FIXING',
+            ciObservation,
+            isWorking: true,
+            shouldAnimateRatchetButton: false,
+            hasActivePr: true,
+        };
+    }
+    if (input.ratchetState === RatchetState.READY || input.ratchetState === RatchetState.MERGED) {
+        return {
+            phase: 'READY',
+            ciObservation,
+            isWorking: false,
+            shouldAnimateRatchetButton: false,
+            hasActivePr: true,
+        };
+    }
+    return {
+        phase: 'RATCHET_VERIFY',
+        ciObservation,
+        isWorking: true,
+        shouldAnimateRatchetButton: false,
+        hasActivePr: true,
+    };
+}
+export function deriveWorkspaceFlowStateFromWorkspace(workspace) {
+    return deriveWorkspaceFlowState({
+        prUrl: workspace.prUrl,
+        prState: workspace.prState,
+        prCiStatus: workspace.prCiStatus,
+        prUpdatedAt: workspace.prUpdatedAt,
+        ratchetEnabled: workspace.ratchetEnabled,
+        ratchetState: workspace.ratchetState,
+    });
+}
+//# sourceMappingURL=workspace-flow-state.service.js.map

package/dist/src/backend/services/workspace-flow-state.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-flow-state.service.js","sourceRoot":"","sources":["../../../../src/backend/services/workspace-flow-state.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAwCrE,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAU;IACxC,OAAO,CAAC,IAAI;IACZ,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,iBAAiB;IACzB,OAAO,CAAC,QAAQ;CACjB,CAAC,CAAC;AAEH,MAAM,qBAAqB,GAAG,IAAI,GAAG,CAAe;IAClD,YAAY,CAAC,SAAS;IACtB,YAAY,CAAC,cAAc;IAC3B,YAAY,CAAC,cAAc;CAC5B,CAAC,CAAC;AAEH,SAAS,WAAW,CAAC,KAAoB,EAAE,OAAgB;IACzD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,gBAAgB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AACvC,CAAC;AAED,SAAS,4BAA4B,CAAC,KAA8B;IAClE,IAAI,KAAK,CAAC,UAAU,KAAK,QAAQ,CAAC,OAAO,EAAE,CAAC;QAC1C,OAAO,gBAAgB,CAAC;IAC1B,CAAC;IACD,IAAI,KAAK,CAAC,UAAU,KAAK,QAAQ,CAAC,OAAO,EAAE,CAAC;QAC1C,OAAO,eAAe,CAAC;IACzB,CAAC;IACD,IAAI,KAAK,CAAC,UAAU,KAAK,QAAQ,CAAC,OAAO,EAAE,CAAC;QAC1C,OAAO,eAAe,CAAC;IACzB,CAAC;IACD,IAAI,KAAK,CAAC,UAAU,KAAK,QAAQ,CAAC,OAAO,EAAE,CAAC;QAC1C,OAAO,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,aAAa,CAAC;IACzD,CAAC;IACD,OAAO,gBAAgB,CAAC;AAC1B,CAAC;AAUD,MAAM,UAAU,wBAAwB,CAAC,KAA8B;IACrE,MAAM,QAAQ,GAAG,WAAW,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IACzD,MAAM,aAAa,GAAG,4BAA4B,CAAC,KAAK,CAAC,CAAC;IAE1D,IAAI,KAAK,CAAC,OAAO,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC;QACrC,OAAO;YACL,KAAK,EAAE,QAAQ;YACf,aAAa;YACb,SAAS,EAAE,KAAK;YAChB,0BAA0B,EAAE,KAAK;YACjC,WAAW,EAAE,KAAK;SACnB,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO;YACL,KAAK,EAAE,OAAO;YACd,aAAa;YACb,SAAS,EAAE,KAAK;YAChB,0BAA0B,EAAE,KAAK;YACjC,WAAW,EAAE,KAAK;SACnB,CAAC;IACJ,CAAC;IAED,IAAI,aAAa,KAAK,aAAa,IAAI,aAAa,KAAK,gBAAgB,EAAE,CAAC;QAC1E,OAAO;YACL,KAAK,EAAE,SAAS;YAChB,aAAa;YACb,SAAS,EAAE,IAAI;YACf,0BAA0B,EAAE,KAAK,CAAC,cAAc;YAChD,WAAW,EAAE,IAAI;SAClB,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,KAAK,CAAC,cAAc,EAAE,CAAC;QAC1B,OAAO;YACL,KAAK,EAAE,OAAO;YACd,aAAa;YACb,SAAS,EAAE,KAAK;YAChB,0BAA0B,EAAE,KAAK;YACjC,WAAW,EAAE,IAAI;SAClB,CAAC;IACJ,CAAC;IAED,IAAI,qBAAqB,CAAC,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,CAAC;QAClD,OAAO;YACL,KAAK,EAAE,gBAAgB;YACvB,aAAa;YACb,SAAS,EAAE,IAAI;YACf,0BAA0B,EAAE,KAAK;YACjC,WAAW,EAAE,IAAI;SAClB,CAAC;IACJ,CAAC;IAED,IAAI,KAAK,CAAC,YAAY,KAAK,YAAY,CAAC,KAAK,IAAI,KAAK,CAAC,YAAY,KAAK,YAAY,CAAC,MAAM,EAAE,CAAC;QAC5F,OAAO;YACL,KAAK,EAAE,OAAO;YACd,aAAa;YACb,SAAS,EAAE,KAAK;YAChB,0BAA0B,EAAE,KAAK;YACjC,WAAW,EAAE,IAAI;SAClB,CAAC;IACJ,CAAC;IAED,OAAO;QACL,KAAK,EAAE,gBAAgB;QACvB,aAAa;QACb,SAAS,EAAE,IAAI;QACf,0BAA0B,EAAE,KAAK;QACjC,WAAW,EAAE,IAAI;KAClB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qCAAqC,CACnD,SAAmC;IAEnC,OAAO,wBAAwB,CAAC;QAC9B,KAAK,EAAE,SAAS,CAAC,KAAK;QACtB,OAAO,EAAE,SAAS,CAAC,OAAO;QAC1B,UAAU,EAAE,SAAS,CAAC,UAAU;QAChC,WAAW,EAAE,SAAS,CAAC,WAAW;QAClC,cAAc,EAAE,SAAS,CAAC,cAAc;QACxC,YAAY,EAAE,SAAS,CAAC,YAAY;KACrC,CAAC,CAAC;AACL,CAAC"}

package/dist/src/backend/services/workspace-flow-state.service.test.d.ts

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

package/dist/src/backend/services/workspace-flow-state.service.test.d.ts.map

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

package/dist/src/backend/services/workspace-flow-state.service.test.js

@@ -0,0 +1,120 @@
+import { CIStatus, PRState, RatchetState } from '../../../prisma/generated/client.js';
+import { describe, expect, it } from 'vitest';
+import { deriveWorkspaceFlowState, deriveWorkspaceFlowStateFromWorkspace, } from './workspace-flow-state.service.js';
+describe('deriveWorkspaceFlowState', () => {
+    it('returns CI_WAIT and working when PR CI is pending (ratchet off)', () => {
+        const result = deriveWorkspaceFlowState({
+            prUrl: 'https://github.com/acme/repo/pull/1',
+            prState: PRState.OPEN,
+            prCiStatus: CIStatus.PENDING,
+            prUpdatedAt: new Date('2026-01-01T00:00:00Z'),
+            ratchetEnabled: false,
+            ratchetState: RatchetState.IDLE,
+        });
+        expect(result.phase).toBe('CI_WAIT');
+        expect(result.isWorking).toBe(true);
+        expect(result.shouldAnimateRatchetButton).toBe(false);
+    });
+    it('animates ratchet button only while waiting for CI with ratchet enabled', () => {
+        const result = deriveWorkspaceFlowState({
+            prUrl: 'https://github.com/acme/repo/pull/1',
+            prState: PRState.OPEN,
+            prCiStatus: CIStatus.PENDING,
+            prUpdatedAt: new Date('2026-01-01T00:00:00Z'),
+            ratchetEnabled: true,
+            ratchetState: RatchetState.CI_RUNNING,
+        });
+        expect(result.phase).toBe('CI_WAIT');
+        expect(result.isWorking).toBe(true);
+        expect(result.shouldAnimateRatchetButton).toBe(true);
+    });
+    it('keeps workspace working in RATCHET_VERIFY after CI finishes', () => {
+        const result = deriveWorkspaceFlowState({
+            prUrl: 'https://github.com/acme/repo/pull/1',
+            prState: PRState.OPEN,
+            prCiStatus: CIStatus.SUCCESS,
+            prUpdatedAt: new Date('2026-01-01T00:00:00Z'),
+            ratchetEnabled: true,
+            ratchetState: RatchetState.IDLE,
+        });
+        expect(result.phase).toBe('RATCHET_VERIFY');
+        expect(result.isWorking).toBe(true);
+        expect(result.shouldAnimateRatchetButton).toBe(false);
+    });
+    it('moves to non-working READY when ratchet has verified readiness', () => {
+        const result = deriveWorkspaceFlowState({
+            prUrl: 'https://github.com/acme/repo/pull/1',
+            prState: PRState.OPEN,
+            prCiStatus: CIStatus.SUCCESS,
+            prUpdatedAt: new Date('2026-01-01T00:00:00Z'),
+            ratchetEnabled: true,
+            ratchetState: RatchetState.READY,
+        });
+        expect(result.phase).toBe('READY');
+        expect(result.isWorking).toBe(false);
+        expect(result.shouldAnimateRatchetButton).toBe(false);
+    });
+    it('returns RATCHET_FIXING and working for actionable ratchet states', () => {
+        const result = deriveWorkspaceFlowState({
+            prUrl: 'https://github.com/acme/repo/pull/1',
+            prState: PRState.OPEN,
+            prCiStatus: CIStatus.FAILURE,
+            prUpdatedAt: new Date('2026-01-01T00:00:00Z'),
+            ratchetEnabled: true,
+            ratchetState: RatchetState.CI_FAILED,
+        });
+        expect(result.phase).toBe('RATCHET_FIXING');
+        expect(result.isWorking).toBe(true);
+    });
+    it('returns MERGED phase for merged PRs', () => {
+        const result = deriveWorkspaceFlowState({
+            prUrl: 'https://github.com/acme/repo/pull/1',
+            prState: PRState.MERGED,
+            prCiStatus: CIStatus.SUCCESS,
+            prUpdatedAt: new Date('2026-01-01T00:00:00Z'),
+            ratchetEnabled: true,
+            ratchetState: RatchetState.MERGED,
+        });
+        expect(result.phase).toBe('MERGED');
+        expect(result.isWorking).toBe(false);
+        expect(result.hasActivePr).toBe(false);
+    });
+    it('distinguishes unknown CI as not fetched when PR has never been synced', () => {
+        const result = deriveWorkspaceFlowState({
+            prUrl: 'https://github.com/acme/repo/pull/1',
+            prState: PRState.OPEN,
+            prCiStatus: CIStatus.UNKNOWN,
+            prUpdatedAt: null,
+            ratchetEnabled: true,
+            ratchetState: RatchetState.IDLE,
+        });
+        expect(result.ciObservation).toBe('NOT_FETCHED');
+        expect(result.phase).toBe('CI_WAIT');
+        expect(result.isWorking).toBe(true);
+    });
+    it('distinguishes unknown CI as no checks after PR sync', () => {
+        const result = deriveWorkspaceFlowState({
+            prUrl: 'https://github.com/acme/repo/pull/1',
+            prState: PRState.OPEN,
+            prCiStatus: CIStatus.UNKNOWN,
+            prUpdatedAt: new Date('2026-01-01T00:00:00Z'),
+            ratchetEnabled: true,
+            ratchetState: RatchetState.IDLE,
+        });
+        expect(result.ciObservation).toBe('NO_CHECKS');
+        expect(result.phase).toBe('RATCHET_VERIFY');
+    });
+    it('derives flow state directly from a workspace-like object', () => {
+        const result = deriveWorkspaceFlowStateFromWorkspace({
+            prUrl: 'https://github.com/acme/repo/pull/1',
+            prState: PRState.OPEN,
+            prCiStatus: CIStatus.PENDING,
+            prUpdatedAt: new Date('2026-01-01T00:00:00Z'),
+            ratchetEnabled: true,
+            ratchetState: RatchetState.CI_RUNNING,
+        });
+        expect(result.phase).toBe('CI_WAIT');
+        expect(result.shouldAnimateRatchetButton).toBe(true);
+    });
+});
+//# sourceMappingURL=workspace-flow-state.service.test.js.map

package/dist/src/backend/services/workspace-flow-state.service.test.js.map

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