factory-factory 0.2.6 → 0.2.7

package/dist/src/backend/domains/workspace/query/workspace-query.service.js

@@ -0,0 +1,300 @@
+import { WorkspaceStatus } from '../../../../../prisma/generated/client.js';
+import pLimit from 'p-limit';
+import { projectAccessor } from '../../../../backend/resource_accessors/project.accessor.js';
+import { workspaceAccessor } from '../../../../backend/resource_accessors/workspace.accessor.js';
+import { FactoryConfigService } from '../../../../backend/services/factory-config.service.js';
+import { gitOpsService } from '../../../../backend/services/git-ops.service.js';
+import { createLogger } from '../../../../backend/services/logger.service.js';
+import { deriveWorkspaceSidebarStatus } from '../../../../shared/workspace-sidebar-status.js';
+import { deriveWorkspaceFlowStateFromWorkspace } from '../state/flow-state.js';
+import { computeKanbanColumn } from '../state/kanban-state.js';
+const logger = createLogger('workspace-query');
+const DEFAULT_GIT_CONCURRENCY = 3;
+const gitConcurrencyLimit = pLimit(DEFAULT_GIT_CONCURRENCY);
+const REVIEW_CACHE_TTL_MS = 60_000;
+function computePendingRequestType(sessionIds, pendingRequests) {
+    for (const sessionId of sessionIds) {
+        const request = pendingRequests.get(sessionId);
+        if (!request) {
+            continue;
+        }
+        if (request.toolName === 'ExitPlanMode') {
+            return 'plan_approval';
+        }
+        if (request.toolName === 'AskUserQuestion') {
+            return 'user_question';
+        }
+    }
+    return null;
+}
+class WorkspaceQueryService {
+    cachedReviewCount = null;
+    sessionBridge = null;
+    githubBridge = null;
+    prSnapshotBridge = null;
+    configure(bridges) {
+        this.sessionBridge = bridges.session;
+        this.githubBridge = bridges.github;
+        this.prSnapshotBridge = bridges.prSnapshot;
+    }
+    get session() {
+        if (!this.sessionBridge) {
+            throw new Error('WorkspaceQueryService not configured: session bridge missing. Call configure() first.');
+        }
+        return this.sessionBridge;
+    }
+    get github() {
+        if (!this.githubBridge) {
+            throw new Error('WorkspaceQueryService not configured: github bridge missing. Call configure() first.');
+        }
+        return this.githubBridge;
+    }
+    get prSnapshot() {
+        if (!this.prSnapshotBridge) {
+            throw new Error('WorkspaceQueryService not configured: prSnapshot bridge missing. Call configure() first.');
+        }
+        return this.prSnapshotBridge;
+    }
+    async getProjectSummaryState(projectId) {
+        const [project, workspaces] = await Promise.all([
+            projectAccessor.findById(projectId),
+            workspaceAccessor.findByProjectIdWithSessions(projectId, {
+                excludeStatuses: [WorkspaceStatus.ARCHIVED],
+            }),
+        ]);
+        const defaultBranch = project?.defaultBranch ?? 'main';
+        const allPendingRequests = this.session.getAllPendingRequests();
+        const workingStatusByWorkspace = new Map();
+        const flowStateByWorkspace = new Map();
+        const pendingRequestByWorkspace = new Map();
+        for (const workspace of workspaces) {
+            const flowState = deriveWorkspaceFlowStateFromWorkspace(workspace);
+            flowStateByWorkspace.set(workspace.id, flowState);
+            const sessionIds = workspace.claudeSessions?.map((s) => s.id) ?? [];
+            const isSessionWorking = this.session.isAnySessionWorking(sessionIds);
+            workingStatusByWorkspace.set(workspace.id, isSessionWorking || flowState.isWorking);
+            const pendingRequestType = computePendingRequestType(sessionIds, allPendingRequests);
+            pendingRequestByWorkspace.set(workspace.id, pendingRequestType);
+        }
+        const gitStatsResults = {};
+        await Promise.all(workspaces.map((workspace) => gitConcurrencyLimit(async () => {
+            if (!workspace.worktreePath) {
+                gitStatsResults[workspace.id] = null;
+                return;
+            }
+            try {
+                gitStatsResults[workspace.id] = await gitOpsService.getWorkspaceGitStats(workspace.worktreePath, defaultBranch);
+            }
+            catch (error) {
+                logger.debug('Failed to get git stats for workspace', {
+                    workspaceId: workspace.id,
+                    error: error instanceof Error ? error.message : String(error),
+                });
+                gitStatsResults[workspace.id] = null;
+            }
+        })));
+        let reviewCount = 0;
+        const now = Date.now();
+        if (this.cachedReviewCount && now - this.cachedReviewCount.fetchedAt < REVIEW_CACHE_TTL_MS) {
+            reviewCount = this.cachedReviewCount.count;
+        }
+        else {
+            try {
+                const health = await this.github.checkHealth();
+                if (health.isInstalled && health.isAuthenticated) {
+                    const prs = await this.github.listReviewRequests();
+                    reviewCount = prs.filter((pr) => pr.reviewDecision !== 'APPROVED').length;
+                    this.cachedReviewCount = { count: reviewCount, fetchedAt: now };
+                }
+            }
+            catch (error) {
+                logger.debug('Failed to fetch review count', {
+                    error: error instanceof Error ? error.message : String(error),
+                });
+            }
+        }
+        return {
+            workspaces: workspaces.map((w) => {
+                const flowState = flowStateByWorkspace.get(w.id);
+                const sessionDates = [
+                    ...(w.claudeSessions?.map((s) => s.updatedAt) ?? []),
+                    ...(w.terminalSessions?.map((s) => s.updatedAt) ?? []),
+                ].filter(Boolean);
+                const lastActivityAt = sessionDates.length > 0
+                    ? sessionDates.reduce((latest, d) => (d > latest ? d : latest)).toISOString()
+                    : null;
+                return {
+                    id: w.id,
+                    name: w.name,
+                    createdAt: w.createdAt,
+                    branchName: w.branchName,
+                    prUrl: w.prUrl,
+                    prNumber: w.prNumber,
+                    prState: w.prState,
+                    prCiStatus: w.prCiStatus,
+                    isWorking: workingStatusByWorkspace.get(w.id) ?? false,
+                    gitStats: gitStatsResults[w.id] ?? null,
+                    lastActivityAt,
+                    ratchetEnabled: w.ratchetEnabled,
+                    ratchetState: w.ratchetState,
+                    sidebarStatus: deriveWorkspaceSidebarStatus({
+                        isWorking: workingStatusByWorkspace.get(w.id) ?? false,
+                        prUrl: w.prUrl,
+                        prState: w.prState,
+                        prCiStatus: w.prCiStatus,
+                        ratchetState: w.ratchetState,
+                    }),
+                    ratchetButtonAnimated: flowState?.shouldAnimateRatchetButton ?? false,
+                    flowPhase: flowState?.phase ?? 'NO_PR',
+                    ciObservation: flowState?.ciObservation ?? 'CHECKS_UNKNOWN',
+                    runScriptStatus: w.runScriptStatus,
+                    cachedKanbanColumn: w.cachedKanbanColumn,
+                    stateComputedAt: w.stateComputedAt?.toISOString() ?? null,
+                    pendingRequestType: pendingRequestByWorkspace.get(w.id) ?? null,
+                };
+            }),
+            reviewCount,
+        };
+    }
+    async listWithKanbanState(input) {
+        const { projectId, ...filters } = input;
+        const workspaces = await workspaceAccessor.findByProjectIdWithSessions(projectId, {
+            ...filters,
+            excludeStatuses: [WorkspaceStatus.ARCHIVED],
+        });
+        const allPendingRequests = this.session.getAllPendingRequests();
+        return workspaces
+            .map((workspace) => {
+            const sessionIds = workspace.claudeSessions?.map((s) => s.id) ?? [];
+            const isSessionWorking = this.session.isAnySessionWorking(sessionIds);
+            const flowState = deriveWorkspaceFlowStateFromWorkspace(workspace);
+            const isWorking = isSessionWorking || flowState.isWorking;
+            const kanbanColumn = computeKanbanColumn({
+                lifecycle: workspace.status,
+                isWorking,
+                prState: workspace.prState,
+                hasHadSessions: workspace.hasHadSessions,
+            });
+            const pendingRequestType = computePendingRequestType(sessionIds, allPendingRequests);
+            return {
+                ...workspace,
+                kanbanColumn,
+                isWorking,
+                ratchetButtonAnimated: flowState.shouldAnimateRatchetButton,
+                flowPhase: flowState.phase,
+                ciObservation: flowState.ciObservation,
+                isArchived: false,
+                pendingRequestType,
+            };
+        })
+            .filter((workspace) => {
+            return workspace.kanbanColumn !== null;
+        })
+            .sort((a, b) => b.createdAt.getTime() - a.createdAt.getTime());
+    }
+    async refreshFactoryConfigs(projectId) {
+        const workspaces = await workspaceAccessor.findByProjectId(projectId);
+        let updatedCount = 0;
+        const errors = [];
+        for (const workspace of workspaces) {
+            if (!workspace.worktreePath) {
+                continue;
+            }
+            try {
+                const factoryConfig = await FactoryConfigService.readConfig(workspace.worktreePath);
+                await workspaceAccessor.update(workspace.id, {
+                    runScriptCommand: factoryConfig?.scripts.run ?? null,
+                    runScriptCleanupCommand: factoryConfig?.scripts.cleanup ?? null,
+                });
+                updatedCount++;
+            }
+            catch (error) {
+                errors.push({
+                    workspaceId: workspace.id,
+                    error: error instanceof Error ? error.message : String(error),
+                });
+                logger.error('Failed to refresh factory config for workspace', {
+                    workspaceId: workspace.id,
+                    error: error instanceof Error ? error.message : String(error),
+                });
+            }
+        }
+        return {
+            updatedCount,
+            totalWorkspaces: workspaces.length,
+            errors,
+        };
+    }
+    async getFactoryConfig(projectId) {
+        const project = await projectAccessor.findById(projectId);
+        if (!project) {
+            throw new Error('Project not found');
+        }
+        try {
+            const config = await FactoryConfigService.readConfig(project.repoPath);
+            return config;
+        }
+        catch (error) {
+            logger.error('Failed to read factory config', {
+                projectId,
+                error: error instanceof Error ? error.message : String(error),
+            });
+            return null;
+        }
+    }
+    async syncPRStatus(workspaceId) {
+        const workspace = await workspaceAccessor.findById(workspaceId);
+        if (!workspace) {
+            throw new Error('Workspace not found');
+        }
+        if (!workspace.prUrl) {
+            return { success: false, reason: 'no_pr_url' };
+        }
+        const prResult = await this.prSnapshot.refreshWorkspace(workspaceId, workspace.prUrl);
+        if (!(prResult.success && prResult.snapshot)) {
+            return { success: false, reason: 'fetch_failed' };
+        }
+        logger.info('PR status synced manually', {
+            workspaceId,
+            prNumber: prResult.snapshot.prNumber,
+            prState: prResult.snapshot.prState,
+        });
+        return { success: true, prState: prResult.snapshot.prState };
+    }
+    async syncAllPRStatuses(projectId) {
+        const workspaces = await workspaceAccessor.findByProjectIdWithSessions(projectId, {
+            excludeStatuses: [WorkspaceStatus.ARCHIVED],
+        });
+        const workspacesWithPRs = workspaces.filter((w) => w.prUrl !== null);
+        if (workspacesWithPRs.length === 0) {
+            return { synced: 0, failed: 0 };
+        }
+        let synced = 0;
+        let failed = 0;
+        await Promise.all(workspacesWithPRs.map((workspace) => gitConcurrencyLimit(async () => {
+            const prResult = await this.prSnapshot.refreshWorkspace(workspace.id, workspace.prUrl);
+            if (!prResult.success) {
+                failed++;
+                return;
+            }
+            synced++;
+        })));
+        logger.info('Batch PR status sync completed', { projectId, synced, failed });
+        return { synced, failed };
+    }
+    async hasChanges(workspaceId) {
+        const workspace = await workspaceAccessor.findByIdWithProject(workspaceId);
+        if (!(workspace?.worktreePath && workspace.project)) {
+            return false;
+        }
+        try {
+            const stats = await gitOpsService.getWorkspaceGitStats(workspace.worktreePath, workspace.project.defaultBranch ?? 'main');
+            return stats !== null && (stats.total > 0 || stats.hasUncommitted);
+        }
+        catch {
+            return false;
+        }
+    }
+}
+export const workspaceQueryService = new WorkspaceQueryService();
+//# sourceMappingURL=workspace-query.service.js.map

package/dist/src/backend/domains/workspace/query/workspace-query.service.js.map

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

package/dist/src/backend/domains/workspace/state/flow-state.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=flow-state.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"flow-state.d.ts","sourceRoot":"","sources":["../../../../../../src/backend/domains/workspace/state/flow-state.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;AA6CD,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,uBAAuB,GAAG,kBAAkB,CAuE3F;AAED,wBAAgB,qCAAqC,CACnD,SAAS,EAAE,wBAAwB,GAClC,kBAAkB,CASpB"}

package/dist/src/backend/domains/workspace/state/flow-state.js

@@ -0,0 +1,108 @@
+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.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=flow-state.js.map

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

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

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

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

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

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

package/dist/src/backend/domains/workspace/state/flow-state.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 './flow-state.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=flow-state.test.js.map

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

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

package/dist/src/backend/domains/workspace/state/init-policy.d.ts

@@ -0,0 +1,14 @@
+import type { WorkspaceStatus } from '../../../../../prisma/generated/client.js';
+import type { WorkspaceInitBanner, WorkspaceInitPhase } from '../../../../shared/workspace-init.js';
+export interface WorkspaceInitPolicyInput {
+    status: WorkspaceStatus;
+    worktreePath?: string | null;
+    initErrorMessage?: string | null;
+}
+export interface WorkspaceInitPolicy {
+    phase: WorkspaceInitPhase;
+    banner: WorkspaceInitBanner | null;
+    dispatchPolicy: 'allowed' | 'blocked' | 'manual_resume';
+}
+export declare function getWorkspaceInitPolicy(input: WorkspaceInitPolicyInput): WorkspaceInitPolicy;
+//# sourceMappingURL=init-policy.d.ts.map

package/dist/src/backend/domains/workspace/state/init-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-policy.d.ts","sourceRoot":"","sources":["../../../../../../src/backend/domains/workspace/state/init-policy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,KAAK,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAEvF,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,eAAe,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,kBAAkB,CAAC;IAC1B,MAAM,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACnC,cAAc,EAAE,SAAS,GAAG,SAAS,GAAG,eAAe,CAAC;CACzD;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,wBAAwB,GAAG,mBAAmB,CAoE3F"}