factory-factory 0.2.5 → 0.2.7

package/dist/src/backend/domains/session/lifecycle/session.process-manager.test.js

@@ -0,0 +1,127 @@
+import { EventEmitter } from 'node:events';
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+import { unsafeCoerce } from '../../../../test-utils/unsafe-coerce.js';
+import { ClaudeClient } from '../claude/client.js';
+import { SessionProcessManager } from './session.process-manager.js';
+class MockClaudeClient extends EventEmitter {
+    isRunning = vi.fn(() => true);
+    stop = vi.fn(() => Promise.resolve());
+    kill = vi.fn();
+    getPid = vi.fn(() => 42);
+}
+describe('SessionProcessManager', () => {
+    beforeEach(() => {
+        vi.restoreAllMocks();
+    });
+    it('reuses pending creation to avoid duplicate clients', async () => {
+        const manager = new SessionProcessManager();
+        const options = { workingDir: '/tmp', sessionId: 's1' };
+        const handlers = {};
+        const context = { workspaceId: 'w1', workingDir: '/tmp' };
+        const client = new MockClaudeClient();
+        let resolveCreate = () => undefined;
+        let createCallCount = 0;
+        const createSpy = vi.spyOn(ClaudeClient, 'create').mockImplementation(() => {
+            createCallCount++;
+            return new Promise((resolve) => {
+                resolveCreate = resolve;
+            });
+        });
+        const first = manager.getOrCreateClient('s1', options, handlers, context);
+        const second = manager.getOrCreateClient('s1', options, handlers, context);
+        await Promise.resolve();
+        resolveCreate(unsafeCoerce(client));
+        const [client1, client2] = await Promise.all([first, second]);
+        expect(createCallCount).toBe(1);
+        expect(createSpy).toHaveBeenCalledTimes(1);
+        expect(client1).toBe(client);
+        expect(client2).toBe(client);
+    });
+    it('invokes session_id handler and skips exit handler when stopping', async () => {
+        const manager = new SessionProcessManager();
+        const options = { workingDir: '/tmp', sessionId: 's1' };
+        const context = { workspaceId: 'w1', workingDir: '/tmp' };
+        const client = new MockClaudeClient();
+        vi.spyOn(ClaudeClient, 'create').mockResolvedValue(unsafeCoerce(client));
+        const onSessionId = vi.fn().mockResolvedValue(undefined);
+        const onExit = vi.fn().mockResolvedValue(undefined);
+        await manager.createClient('s1', options, { onSessionId, onExit }, context);
+        client.emit('session_id', 'claude-123');
+        expect(onSessionId).toHaveBeenCalledWith('s1', 'claude-123');
+        client.stop = vi.fn().mockImplementation(() => {
+            client.emit('exit');
+            return Promise.resolve();
+        });
+        await manager.stopClient('s1');
+        expect(onExit).not.toHaveBeenCalled();
+    });
+    it('preserves lock during concurrent operations even if client exits', async () => {
+        const manager = new SessionProcessManager();
+        const options = { workingDir: '/tmp', sessionId: 's1' };
+        const handlers = {};
+        const context = { workspaceId: 'w1', workingDir: '/tmp' };
+        const client1 = new MockClaudeClient();
+        let createCallCount = 0;
+        let resolveCreate = () => undefined;
+        vi.spyOn(ClaudeClient, 'create').mockImplementation(() => {
+            createCallCount++;
+            return new Promise((resolve) => {
+                resolveCreate = resolve;
+            });
+        });
+        const firstCall = manager.getOrCreateClient('s1', options, handlers, context);
+        const secondCall = manager.getOrCreateClient('s1', options, handlers, context);
+        await Promise.resolve();
+        resolveCreate(unsafeCoerce(client1));
+        const firstClient = await firstCall;
+        expect(firstClient).toBe(client1);
+        client1.emit('exit', { code: 0 });
+        await Promise.resolve();
+        const secondClient = await secondCall;
+        expect(secondClient).toBe(client1);
+        expect(createCallCount).toBe(1);
+    });
+    it('clears both creationLocks and lockRefCounts in stopAllClients', async () => {
+        const manager = new SessionProcessManager();
+        const options = { workingDir: '/tmp', sessionId: 's1' };
+        const handlers = {};
+        const context = { workspaceId: 'w1', workingDir: '/tmp' };
+        const client = new MockClaudeClient();
+        vi.spyOn(ClaudeClient, 'create').mockResolvedValue(unsafeCoerce(client));
+        await manager.getOrCreateClient('s1', options, handlers, context);
+        expect(manager.getClient('s1')).toBeDefined();
+        await manager.stopAllClients();
+        expect(manager.getClient('s1')).toBeUndefined();
+        const client2 = new MockClaudeClient();
+        vi.spyOn(ClaudeClient, 'create').mockResolvedValue(unsafeCoerce(client2));
+        const newClient = await manager.getOrCreateClient('s1', options, handlers, context);
+        expect(newClient).toBe(client2);
+    });
+    it('properly awaits pending creation to prevent premature ref count cleanup', async () => {
+        const manager = new SessionProcessManager();
+        const options = { workingDir: '/tmp', sessionId: 's1' };
+        const handlers = {};
+        const context = { workspaceId: 'w1', workingDir: '/tmp' };
+        const client = new MockClaudeClient();
+        let resolveCreate = () => undefined;
+        let createCallCount = 0;
+        vi.spyOn(ClaudeClient, 'create').mockImplementation(() => {
+            createCallCount++;
+            return new Promise((resolve) => {
+                resolveCreate = resolve;
+            });
+        });
+        const firstCall = manager.getOrCreateClient('s1', options, handlers, context);
+        await Promise.resolve();
+        const secondCall = manager.getOrCreateClient('s1', options, handlers, context);
+        const thirdCall = manager.getOrCreateClient('s1', options, handlers, context);
+        await Promise.resolve();
+        resolveCreate(unsafeCoerce(client));
+        const [first, second, third] = await Promise.all([firstCall, secondCall, thirdCall]);
+        expect(first).toBe(client);
+        expect(second).toBe(client);
+        expect(third).toBe(client);
+        expect(createCallCount).toBe(1);
+    });
+});
+//# sourceMappingURL=session.process-manager.test.js.map

package/dist/src/backend/domains/session/lifecycle/session.process-manager.test.js.map

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

package/dist/src/backend/domains/session/lifecycle/session.prompt-builder.d.ts

@@ -0,0 +1,29 @@
+export type BuildPromptInput = {
+    workflow: string;
+    workspace: {
+        branchName?: string | null;
+        isAutoGeneratedBranch?: boolean;
+        hasHadSessions?: boolean;
+        name: string;
+        description?: string | null;
+    };
+    project?: {
+        githubOwner?: string | null;
+    } | null;
+};
+export type BuildPromptResult = {
+    workflowPrompt: string | undefined;
+    systemPrompt: string | undefined;
+    injectedBranchRename: boolean;
+};
+export declare class SessionPromptBuilder {
+    private static readonly PROMPTED_WORKFLOWS;
+    shouldInjectBranchRename(workspace: {
+        branchName?: string | null;
+        isAutoGeneratedBranch?: boolean;
+        hasHadSessions?: boolean;
+    }): boolean;
+    buildSystemPrompt({ workflow, workspace, project }: BuildPromptInput): BuildPromptResult;
+}
+export declare const sessionPromptBuilder: SessionPromptBuilder;
+//# sourceMappingURL=session.prompt-builder.d.ts.map

package/dist/src/backend/domains/session/lifecycle/session.prompt-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.prompt-builder.d.ts","sourceRoot":"","sources":["../../../../../../src/backend/domains/session/lifecycle/session.prompt-builder.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE;QACT,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC3B,qBAAqB,CAAC,EAAE,OAAO,CAAC;QAChC,cAAc,CAAC,EAAE,OAAO,CAAC;QACzB,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KAC7B,CAAC;IACF,OAAO,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,CAAC;CAClD,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,cAAc,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,oBAAoB,EAAE,OAAO,CAAC;CAC/B,CAAC;AAEF,qBAAa,oBAAoB;IAK/B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAAmD;IAa7F,wBAAwB,CAAC,SAAS,EAAE;QAClC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC3B,qBAAqB,CAAC,EAAE,OAAO,CAAC;QAChC,cAAc,CAAC,EAAE,OAAO,CAAC;KAC1B,GAAG,OAAO;IAQX,iBAAiB,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE,gBAAgB,GAAG,iBAAiB;CAmBzF;AAED,eAAO,MAAM,oBAAoB,sBAA6B,CAAC"}

package/dist/src/backend/domains/session/lifecycle/session.prompt-builder.js

@@ -0,0 +1,29 @@
+import { buildBranchRenameInstruction } from '../../../../backend/prompts/branch-rename.js';
+import { getWorkflowContent } from '../../../../backend/prompts/workflows.js';
+export class SessionPromptBuilder {
+    static PROMPTED_WORKFLOWS = new Set(['ci-fix', 'pr-review-fix', 'ratchet']);
+    shouldInjectBranchRename(workspace) {
+        return (!!workspace.branchName &&
+            !!workspace.isAutoGeneratedBranch &&
+            workspace.hasHadSessions === false);
+    }
+    buildSystemPrompt({ workflow, workspace, project }) {
+        const workflowPrompt = SessionPromptBuilder.PROMPTED_WORKFLOWS.has(workflow)
+            ? (getWorkflowContent(workflow) ?? undefined)
+            : undefined;
+        let systemPrompt = workflowPrompt;
+        let injectedBranchRename = false;
+        if (this.shouldInjectBranchRename(workspace)) {
+            const branchRenameInstruction = buildBranchRenameInstruction({
+                branchPrefix: project?.githubOwner ?? '',
+                workspaceName: workspace.name,
+                workspaceDescription: workspace.description ?? undefined,
+            });
+            systemPrompt = branchRenameInstruction + (workflowPrompt ?? '');
+            injectedBranchRename = true;
+        }
+        return { workflowPrompt, systemPrompt, injectedBranchRename };
+    }
+}
+export const sessionPromptBuilder = new SessionPromptBuilder();
+//# sourceMappingURL=session.prompt-builder.js.map

package/dist/src/backend/domains/session/lifecycle/session.prompt-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.prompt-builder.js","sourceRoot":"","sources":["../../../../../../src/backend/domains/session/lifecycle/session.prompt-builder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,4BAA4B,EAAE,MAAM,iCAAiC,CAAC;AAC/E,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAoBjE,MAAM,OAAO,oBAAoB;IAKvB,MAAM,CAAU,kBAAkB,GAAG,IAAI,GAAG,CAAC,CAAC,QAAQ,EAAE,eAAe,EAAE,SAAS,CAAC,CAAC,CAAC;IAa7F,wBAAwB,CAAC,SAIxB;QACC,OAAO,CACL,CAAC,CAAC,SAAS,CAAC,UAAU;YACtB,CAAC,CAAC,SAAS,CAAC,qBAAqB;YACjC,SAAS,CAAC,cAAc,KAAK,KAAK,CACnC,CAAC;IACJ,CAAC;IAED,iBAAiB,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAoB;QAClE,MAAM,cAAc,GAAG,oBAAoB,CAAC,kBAAkB,CAAC,GAAG,CAAC,QAAQ,CAAC;YAC1E,CAAC,CAAC,CAAC,kBAAkB,CAAC,QAAQ,CAAC,IAAI,SAAS,CAAC;YAC7C,CAAC,CAAC,SAAS,CAAC;QACd,IAAI,YAAY,GAAG,cAAc,CAAC;QAClC,IAAI,oBAAoB,GAAG,KAAK,CAAC;QAEjC,IAAI,IAAI,CAAC,wBAAwB,CAAC,SAAS,CAAC,EAAE,CAAC;YAC7C,MAAM,uBAAuB,GAAG,4BAA4B,CAAC;gBAC3D,YAAY,EAAE,OAAO,EAAE,WAAW,IAAI,EAAE;gBACxC,aAAa,EAAE,SAAS,CAAC,IAAI;gBAC7B,oBAAoB,EAAE,SAAS,CAAC,WAAW,IAAI,SAAS;aACzD,CAAC,CAAC;YACH,YAAY,GAAG,uBAAuB,GAAG,CAAC,cAAc,IAAI,EAAE,CAAC,CAAC;YAChE,oBAAoB,GAAG,IAAI,CAAC;QAC9B,CAAC;QAED,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,oBAAoB,EAAE,CAAC;IAChE,CAAC;;AAGH,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,oBAAoB,EAAE,CAAC"}

package/dist/src/backend/domains/session/lifecycle/session.prompt-builder.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.prompt-builder.test.d.ts","sourceRoot":"","sources":["../../../../../../src/backend/domains/session/lifecycle/session.prompt-builder.test.ts"],"names":[],"mappings":""}

package/dist/src/backend/domains/session/lifecycle/session.prompt-builder.test.js

@@ -0,0 +1,171 @@
+import { describe, expect, it, vi } from 'vitest';
+vi.mock('@/backend/prompts/branch-rename', () => ({
+    buildBranchRenameInstruction: vi.fn(),
+}));
+vi.mock('@/backend/prompts/workflows', () => ({
+    getWorkflowContent: vi.fn(),
+}));
+vi.mock('@/backend/services/logger.service', () => ({
+    createLogger: () => ({
+        debug: vi.fn(),
+        info: vi.fn(),
+        warn: vi.fn(),
+        error: vi.fn(),
+    }),
+}));
+import { buildBranchRenameInstruction } from '../../../../backend/prompts/branch-rename.js';
+import { getWorkflowContent } from '../../../../backend/prompts/workflows.js';
+import { SessionPromptBuilder } from './session.prompt-builder.js';
+describe('SessionPromptBuilder', () => {
+    describe('shouldInjectBranchRename', () => {
+        const builder = new SessionPromptBuilder();
+        it('returns true when branch is auto-generated and no sessions have run', () => {
+            expect(builder.shouldInjectBranchRename({
+                branchName: 'auto-branch',
+                isAutoGeneratedBranch: true,
+                hasHadSessions: false,
+            })).toBe(true);
+        });
+        it('returns false when workspace has already had sessions', () => {
+            expect(builder.shouldInjectBranchRename({
+                branchName: 'auto-branch',
+                isAutoGeneratedBranch: true,
+                hasHadSessions: true,
+            })).toBe(false);
+        });
+        it('returns false when branch is not auto-generated', () => {
+            expect(builder.shouldInjectBranchRename({
+                branchName: 'feature/my-branch',
+                isAutoGeneratedBranch: false,
+                hasHadSessions: false,
+            })).toBe(false);
+        });
+        it('returns false when branch name is missing', () => {
+            expect(builder.shouldInjectBranchRename({
+                branchName: null,
+                isAutoGeneratedBranch: true,
+                hasHadSessions: false,
+            })).toBe(false);
+        });
+        it('returns false when isAutoGeneratedBranch is undefined', () => {
+            expect(builder.shouldInjectBranchRename({
+                branchName: 'some-branch',
+                isAutoGeneratedBranch: undefined,
+                hasHadSessions: false,
+            })).toBe(false);
+        });
+        it('returns false when hasHadSessions is undefined (safer default for older workspaces)', () => {
+            expect(builder.shouldInjectBranchRename({
+                branchName: 'auto-branch',
+                isAutoGeneratedBranch: true,
+                hasHadSessions: undefined,
+            })).toBe(false);
+        });
+    });
+    it('injects branch rename instruction for auto-generated branches on first session', () => {
+        vi.mocked(getWorkflowContent).mockReturnValue('workflow');
+        vi.mocked(buildBranchRenameInstruction).mockReturnValue('rename');
+        const builder = new SessionPromptBuilder();
+        const result = builder.buildSystemPrompt({
+            workflow: 'ci-fix',
+            workspace: {
+                branchName: 'auto-branch',
+                isAutoGeneratedBranch: true,
+                hasHadSessions: false,
+                name: 'Workspace A',
+                description: 'desc',
+            },
+            project: { githubOwner: 'owner' },
+        });
+        expect(result.systemPrompt).toBe('renameworkflow');
+        expect(result.workflowPrompt).toBe('workflow');
+        expect(result.injectedBranchRename).toBe(true);
+    });
+    it('uses workflow prompt without branch rename when branch is not auto-generated', () => {
+        vi.mocked(getWorkflowContent).mockReturnValue('workflow');
+        const builder = new SessionPromptBuilder();
+        const result = builder.buildSystemPrompt({
+            workflow: 'ci-fix',
+            workspace: {
+                branchName: 'feature/real',
+                isAutoGeneratedBranch: false,
+                hasHadSessions: false,
+                name: 'Workspace B',
+                description: null,
+            },
+            project: { githubOwner: 'owner' },
+        });
+        expect(result.systemPrompt).toBe('workflow');
+        expect(result.workflowPrompt).toBe('workflow');
+        expect(result.injectedBranchRename).toBe(false);
+    });
+    it('returns undefined system prompt when workflow prompt is missing', () => {
+        vi.mocked(getWorkflowContent).mockReturnValue(null);
+        const builder = new SessionPromptBuilder();
+        const result = builder.buildSystemPrompt({
+            workflow: 'missing',
+            workspace: {
+                branchName: null,
+                isAutoGeneratedBranch: false,
+                name: 'Workspace C',
+                description: null,
+            },
+            project: null,
+        });
+        expect(result.systemPrompt).toBeUndefined();
+        expect(result.workflowPrompt).toBeUndefined();
+        expect(result.injectedBranchRename).toBe(false);
+    });
+    it('does not inject branch rename when isAutoGeneratedBranch is undefined', () => {
+        vi.mocked(getWorkflowContent).mockReturnValue('workflow');
+        const builder = new SessionPromptBuilder();
+        const result = builder.buildSystemPrompt({
+            workflow: 'ci-fix',
+            workspace: {
+                branchName: 'some-branch',
+                name: 'Workspace D',
+                description: null,
+            },
+            project: { githubOwner: 'owner' },
+        });
+        expect(result.systemPrompt).toBe('workflow');
+        expect(result.workflowPrompt).toBe('workflow');
+        expect(result.injectedBranchRename).toBe(false);
+    });
+    it('does not inject branch rename when workspace has already had sessions', () => {
+        vi.mocked(getWorkflowContent).mockReturnValue('workflow');
+        const builder = new SessionPromptBuilder();
+        const result = builder.buildSystemPrompt({
+            workflow: 'ci-fix',
+            workspace: {
+                branchName: 'auto-branch',
+                isAutoGeneratedBranch: true,
+                hasHadSessions: true,
+                name: 'Workspace F',
+                description: 'desc',
+            },
+            project: { githubOwner: 'owner' },
+        });
+        expect(result.systemPrompt).toBe('workflow');
+        expect(result.workflowPrompt).toBe('workflow');
+        expect(result.injectedBranchRename).toBe(false);
+    });
+    it('uses default Claude prompt for regular user sessions', () => {
+        vi.mocked(getWorkflowContent).mockReturnValue('workflow');
+        const builder = new SessionPromptBuilder();
+        const result = builder.buildSystemPrompt({
+            workflow: 'followup',
+            workspace: {
+                branchName: null,
+                isAutoGeneratedBranch: false,
+                name: 'Workspace E',
+                description: null,
+            },
+            project: null,
+        });
+        expect(result.systemPrompt).toBeUndefined();
+        expect(result.workflowPrompt).toBeUndefined();
+        expect(result.injectedBranchRename).toBe(false);
+    });
+});
+//# sourceMappingURL=session.prompt-builder.test.js.map

package/dist/src/backend/domains/session/lifecycle/session.prompt-builder.test.js.map

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

package/dist/src/backend/domains/session/lifecycle/session.repository.d.ts

@@ -0,0 +1,33 @@
+import type { ClaudeSession, Project, Workspace } from '../../../../../prisma/generated/client.js';
+type SessionAccessor = {
+    findById(id: string): Promise<ClaudeSession | null>;
+    findByWorkspaceId(workspaceId: string): Promise<ClaudeSession[]>;
+    update(id: string, data: Partial<Pick<ClaudeSession, 'status' | 'claudeProcessPid' | 'claudeSessionId' | 'claudeProjectPath'>>): Promise<ClaudeSession>;
+    delete(id: string): Promise<ClaudeSession>;
+};
+type WorkspaceAccessor = {
+    findById(id: string): Promise<Workspace | null>;
+    markHasHadSessions(id: string): Promise<void>;
+    clearRatchetActiveSession(workspaceId: string, sessionId: string): Promise<void>;
+};
+type ProjectAccessor = {
+    findById(id: string): Promise<Project | null>;
+};
+export declare class SessionRepository {
+    private readonly sessions;
+    private readonly workspaces;
+    private readonly projects;
+    constructor(sessions?: SessionAccessor, workspaces?: WorkspaceAccessor, projects?: ProjectAccessor);
+    getSessionById(sessionId: string): Promise<ClaudeSession | null>;
+    getSessionsByWorkspaceId(workspaceId: string): Promise<ClaudeSession[]>;
+    getWorkspaceById(workspaceId: string): Promise<Workspace | null>;
+    getProjectById(projectId: string): Promise<Project | null>;
+    markWorkspaceHasHadSessions(workspaceId: string): Promise<void>;
+    clearRatchetActiveSession(workspaceId: string, sessionId: string): Promise<void>;
+    updateSession(sessionId: string, data: Partial<Pick<ClaudeSession, 'status' | 'claudeProcessPid' | 'claudeSessionId' | 'claudeProjectPath'>>): Promise<ClaudeSession>;
+    private updateSessionWithGuards;
+    deleteSession(sessionId: string): Promise<ClaudeSession>;
+}
+export declare const sessionRepository: SessionRepository;
+export {};
+//# sourceMappingURL=session.repository.d.ts.map

package/dist/src/backend/domains/session/lifecycle/session.repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.repository.d.ts","sourceRoot":"","sources":["../../../../../../src/backend/domains/session/lifecycle/session.repository.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAO5E,KAAK,eAAe,GAAG;IACrB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC;IACpD,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;IACjE,MAAM,CACJ,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,OAAO,CACX,IAAI,CAAC,aAAa,EAAE,QAAQ,GAAG,kBAAkB,GAAG,iBAAiB,GAAG,mBAAmB,CAAC,CAC7F,GACA,OAAO,CAAC,aAAa,CAAC,CAAC;IAC1B,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;CAC5C,CAAC;AAEF,KAAK,iBAAiB,GAAG;IACvB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC;IAChD,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,yBAAyB,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAClF,CAAC;AAEF,KAAK,eAAe,GAAG;IACrB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;CAC/C,CAAC;AAEF,qBAAa,iBAAiB;IAE1B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAFR,QAAQ,GAAE,eAAuC,EACjD,UAAU,GAAE,iBAAqC,EACjD,QAAQ,GAAE,eAAiC;IAG9D,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAIhE,wBAAwB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAIvE,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IAIhE,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAI1D,2BAA2B,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/D,yBAAyB,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIhF,aAAa,CACX,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,OAAO,CACX,IAAI,CAAC,aAAa,EAAE,QAAQ,GAAG,kBAAkB,GAAG,iBAAiB,GAAG,mBAAmB,CAAC,CAC7F,GACA,OAAO,CAAC,aAAa,CAAC;YAIX,uBAAuB;IAuBrC,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;CAGzD;AAED,eAAO,MAAM,iBAAiB,mBAA0B,CAAC"}

package/dist/src/backend/domains/session/lifecycle/session.repository.js

@@ -0,0 +1,51 @@
+import { claudeSessionAccessor, projectAccessor, workspaceAccessor, } from '../../../../backend/resource_accessors/index.js';
+export class SessionRepository {
+    sessions;
+    workspaces;
+    projects;
+    constructor(sessions = claudeSessionAccessor, workspaces = workspaceAccessor, projects = projectAccessor) {
+        this.sessions = sessions;
+        this.workspaces = workspaces;
+        this.projects = projects;
+    }
+    getSessionById(sessionId) {
+        return this.sessions.findById(sessionId);
+    }
+    getSessionsByWorkspaceId(workspaceId) {
+        return this.sessions.findByWorkspaceId(workspaceId);
+    }
+    getWorkspaceById(workspaceId) {
+        return this.workspaces.findById(workspaceId);
+    }
+    getProjectById(projectId) {
+        return this.projects.findById(projectId);
+    }
+    markWorkspaceHasHadSessions(workspaceId) {
+        return this.workspaces.markHasHadSessions(workspaceId);
+    }
+    clearRatchetActiveSession(workspaceId, sessionId) {
+        return this.workspaces.clearRatchetActiveSession(workspaceId, sessionId);
+    }
+    updateSession(sessionId, data) {
+        return this.updateSessionWithGuards(sessionId, data);
+    }
+    async updateSessionWithGuards(sessionId, data) {
+        if (Object.hasOwn(data, 'claudeSessionId')) {
+            const current = await this.sessions.findById(sessionId);
+            if (!current) {
+                throw new Error(`Session not found: ${sessionId}`);
+            }
+            const currentSessionId = current.claudeSessionId;
+            const nextSessionId = data.claudeSessionId ?? null;
+            if (currentSessionId && nextSessionId !== currentSessionId) {
+                throw new Error(`claudeSessionId is immutable for session ${sessionId}: ${currentSessionId} -> ${String(nextSessionId)}`);
+            }
+        }
+        return this.sessions.update(sessionId, data);
+    }
+    deleteSession(sessionId) {
+        return this.sessions.delete(sessionId);
+    }
+}
+export const sessionRepository = new SessionRepository();
+//# sourceMappingURL=session.repository.js.map

package/dist/src/backend/domains/session/lifecycle/session.repository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.repository.js","sourceRoot":"","sources":["../../../../../../src/backend/domains/session/lifecycle/session.repository.ts"],"names":[],"mappings":"AACA,OAAO,EACL,qBAAqB,EACrB,eAAe,EACf,iBAAiB,GAClB,MAAM,oCAAoC,CAAC;AAwB5C,MAAM,OAAO,iBAAiB;IAET;IACA;IACA;IAHnB,YACmB,WAA4B,qBAAqB,EACjD,aAAgC,iBAAiB,EACjD,WAA4B,eAAe;QAF3C,aAAQ,GAAR,QAAQ,CAAyC;QACjD,eAAU,GAAV,UAAU,CAAuC;QACjD,aAAQ,GAAR,QAAQ,CAAmC;IAC3D,CAAC;IAEJ,cAAc,CAAC,SAAiB;QAC9B,OAAO,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IAC3C,CAAC;IAED,wBAAwB,CAAC,WAAmB;QAC1C,OAAO,IAAI,CAAC,QAAQ,CAAC,iBAAiB,CAAC,WAAW,CAAC,CAAC;IACtD,CAAC;IAED,gBAAgB,CAAC,WAAmB;QAClC,OAAO,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;IAC/C,CAAC;IAED,cAAc,CAAC,SAAiB;QAC9B,OAAO,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IAC3C,CAAC;IAED,2BAA2B,CAAC,WAAmB;QAC7C,OAAO,IAAI,CAAC,UAAU,CAAC,kBAAkB,CAAC,WAAW,CAAC,CAAC;IACzD,CAAC;IAED,yBAAyB,CAAC,WAAmB,EAAE,SAAiB;QAC9D,OAAO,IAAI,CAAC,UAAU,CAAC,yBAAyB,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;IAC3E,CAAC;IAED,aAAa,CACX,SAAiB,EACjB,IAEC;QAED,OAAO,IAAI,CAAC,uBAAuB,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IACvD,CAAC;IAEO,KAAK,CAAC,uBAAuB,CACnC,SAAiB,EACjB,IAEC;QAED,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,iBAAiB,CAAC,EAAE,CAAC;YAC3C,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;YACxD,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,MAAM,IAAI,KAAK,CAAC,sBAAsB,SAAS,EAAE,CAAC,CAAC;YACrD,CAAC;YACD,MAAM,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC;YACjD,MAAM,aAAa,GAAG,IAAI,CAAC,eAAe,IAAI,IAAI,CAAC;YACnD,IAAI,gBAAgB,IAAI,aAAa,KAAK,gBAAgB,EAAE,CAAC;gBAC3D,MAAM,IAAI,KAAK,CACb,4CAA4C,SAAS,KAAK,gBAAgB,OAAO,MAAM,CAAC,aAAa,CAAC,EAAE,CACzG,CAAC;YACJ,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IAC/C,CAAC;IAED,aAAa,CAAC,SAAiB;QAC7B,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACzC,CAAC;CACF;AAED,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,iBAAiB,EAAE,CAAC"}

package/dist/src/backend/domains/session/lifecycle/session.repository.test.d.ts

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

package/dist/src/backend/domains/session/lifecycle/session.repository.test.d.ts.map

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

package/dist/src/backend/domains/session/lifecycle/session.repository.test.js

@@ -0,0 +1,61 @@
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+import { unsafeCoerce } from '../../../../test-utils/unsafe-coerce.js';
+import { SessionRepository } from './session.repository.js';
+const createSession = (overrides) => ({
+    id: 's1',
+    workspaceId: 'w1',
+    name: null,
+    workflow: 'default',
+    model: 'sonnet',
+    status: 'IDLE',
+    claudeSessionId: null,
+    claudeProjectPath: null,
+    claudeProcessPid: null,
+    createdAt: new Date('2026-01-01T00:00:00.000Z'),
+    updatedAt: new Date('2026-01-01T00:00:00.000Z'),
+    ...overrides,
+});
+describe('SessionRepository', () => {
+    const sessions = {
+        findById: vi.fn(),
+        findByWorkspaceId: vi.fn(),
+        update: vi.fn(),
+        delete: vi.fn(),
+    };
+    const workspaces = {
+        findById: vi.fn(),
+        markHasHadSessions: vi.fn(),
+        clearRatchetActiveSession: vi.fn(),
+    };
+    const projects = {
+        findById: vi.fn(),
+    };
+    const repository = new SessionRepository(unsafeCoerce(sessions), workspaces, projects);
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    it('allows first non-null claudeSessionId assignment', async () => {
+        sessions.findById.mockResolvedValue(createSession({ claudeSessionId: null }));
+        sessions.update.mockResolvedValue(createSession({ claudeSessionId: 'claude-1' }));
+        const updated = await repository.updateSession('s1', { claudeSessionId: 'claude-1' });
+        expect(updated.claudeSessionId).toBe('claude-1');
+        expect(sessions.update).toHaveBeenCalledWith('s1', { claudeSessionId: 'claude-1' });
+    });
+    it('allows idempotent re-write of same claudeSessionId', async () => {
+        sessions.findById.mockResolvedValue(createSession({ claudeSessionId: 'claude-1' }));
+        sessions.update.mockResolvedValue(createSession({ claudeSessionId: 'claude-1' }));
+        await repository.updateSession('s1', { claudeSessionId: 'claude-1' });
+        expect(sessions.update).toHaveBeenCalledWith('s1', { claudeSessionId: 'claude-1' });
+    });
+    it('rejects changing an existing claudeSessionId', async () => {
+        sessions.findById.mockResolvedValue(createSession({ claudeSessionId: 'claude-1' }));
+        await expect(repository.updateSession('s1', { claudeSessionId: 'claude-2' })).rejects.toThrow(/immutable/);
+        expect(sessions.update).not.toHaveBeenCalled();
+    });
+    it('rejects clearing an existing claudeSessionId', async () => {
+        sessions.findById.mockResolvedValue(createSession({ claudeSessionId: 'claude-1' }));
+        await expect(repository.updateSession('s1', { claudeSessionId: null })).rejects.toThrow(/immutable/);
+        expect(sessions.update).not.toHaveBeenCalled();
+    });
+});
+//# sourceMappingURL=session.repository.test.js.map

package/dist/src/backend/domains/session/lifecycle/session.repository.test.js.map

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

package/dist/src/backend/domains/session/lifecycle/session.service.d.ts

@@ -0,0 +1,67 @@
+import { type SessionRuntimeState } from '../../../../shared/session-runtime.js';
+import type { ClaudeClient } from '../claude/client.js';
+import type { ResourceUsage } from '../claude/process.js';
+import type { RegisteredProcess } from '../claude/registry.js';
+import type { ClientCreatedCallback as ProcessClientCreatedCallback, SessionProcessManager } from './session.process-manager.js';
+import type { SessionPromptBuilder } from './session.prompt-builder.js';
+import type { SessionRepository } from './session.repository.js';
+export type ClientCreatedCallback = ProcessClientCreatedCallback;
+declare class SessionService {
+    private readonly repository;
+    private readonly promptBuilder;
+    private readonly processManager;
+    private getClientWorkingState;
+    private isStaleLoadingRuntime;
+    setOnClientCreated(callback: ClientCreatedCallback): void;
+    constructor(options?: {
+        repository?: SessionRepository;
+        promptBuilder?: SessionPromptBuilder;
+        processManager?: SessionProcessManager;
+    });
+    startClaudeSession(sessionId: string, options?: {
+        initialPrompt?: string;
+    }): Promise<void>;
+    stopClaudeSession(sessionId: string, options?: {
+        cleanupTransientRatchetSession?: boolean;
+    }): Promise<void>;
+    private loadSessionForStop;
+    private updateStoppedSessionState;
+    private cleanupTransientRatchetOnStop;
+    stopWorkspaceSessions(workspaceId: string): Promise<void>;
+    getOrCreateClient(sessionId: string, options?: {
+        thinkingEnabled?: boolean;
+        permissionMode?: 'bypassPermissions' | 'plan';
+        model?: string;
+    }): Promise<ClaudeClient>;
+    getClient(sessionId: string): ClaudeClient | undefined;
+    getRuntimeSnapshot(sessionId: string): SessionRuntimeState;
+    private buildClientEventHandlers;
+    getClaudeProcess(sessionId: string): RegisteredProcess | undefined;
+    isSessionRunning(sessionId: string): boolean;
+    isSessionWorking(sessionId: string): boolean;
+    isAnySessionWorking(sessionIds: string[]): boolean;
+    getSessionOptions(sessionId: string): Promise<{
+        workingDir: string;
+        resumeClaudeSessionId: string | undefined;
+        systemPrompt: string | undefined;
+        model: string;
+    } | null>;
+    getAllActiveProcesses(): Array<{
+        sessionId: string;
+        pid: number | undefined;
+        status: string;
+        isRunning: boolean;
+        resourceUsage: ResourceUsage | null;
+        idleTimeMs: number;
+    }>;
+    getAllClients(): IterableIterator<[string, ClaudeClient]>;
+    stopAllClients(timeoutMs?: number): Promise<void>;
+    private shouldStopWorkspaceSession;
+    private waitForPendingClient;
+    private stopWorkspaceSession;
+    private buildClientOptions;
+    private loadSessionContext;
+}
+export declare const sessionService: SessionService;
+export {};
+//# sourceMappingURL=session.service.d.ts.map