factory-factory 0.2.6 → 0.2.8

package/dist/src/backend/services/workspace-snapshot-store.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-snapshot-store.service.d.ts","sourceRoot":"","sources":["../../../../src/backend/services/workspace-snapshot-store.service.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EACV,QAAQ,EACR,YAAY,EACZ,OAAO,EACP,YAAY,EACZ,eAAe,EACf,eAAe,EAChB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAYhF,MAAM,MAAM,kBAAkB,GAC1B,WAAW,GACX,IAAI,GACJ,SAAS,GACT,SAAS,GACT,WAAW,GACX,gBAAgB,CAAC;AAMrB,MAAM,MAAM,kBAAkB,GAC1B,OAAO,GACP,SAAS,GACT,gBAAgB,GAChB,gBAAgB,GAChB,OAAO,GACP,QAAQ,CAAC;AAMb,MAAM,MAAM,sBAAsB,GAC9B,aAAa,GACb,WAAW,GACX,gBAAgB,GAChB,eAAe,GACf,eAAe,GACf,gBAAgB,CAAC;AAErB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,MAAM,MAAM,uBAAuB,GAAG,cAAc,CAAC;AAOrD,MAAM,WAAW,sBAAsB;IAErC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAGlB,OAAO,EAAE,MAAM,CAAC;IAGhB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IAGf,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,eAAe,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,QAAQ,CAAC;IACrB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,cAAc,EAAE,OAAO,CAAC;IACxB,YAAY,EAAE,YAAY,CAAC;IAC3B,eAAe,EAAE,eAAe,CAAC;IACjC,cAAc,EAAE,OAAO,CAAC;IAGxB,SAAS,EAAE,OAAO,CAAC;IACnB,kBAAkB,EAAE,eAAe,GAAG,eAAe,GAAG,IAAI,CAAC;IAC7D,gBAAgB,EAAE,uBAAuB,EAAE,CAAC;IAG5C,QAAQ,EAAE;QACR,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,cAAc,EAAE,OAAO,CAAC;KACzB,GAAG,IAAI,CAAC;IACT,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAG9B,aAAa,EAAE,sBAAsB,CAAC;IACtC,YAAY,EAAE,YAAY,GAAG,IAAI,CAAC;IAClC,SAAS,EAAE,kBAAkB,CAAC;IAC9B,aAAa,EAAE,sBAAsB,CAAC;IACtC,qBAAqB,EAAE,OAAO,CAAC;IAG/B,eAAe,EAAE,MAAM,CAAC,kBAAkB,EAAE,MAAM,CAAC,CAAC;CACrD;AAOD,MAAM,WAAW,mBAAmB;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IAGnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,cAAc,CAAC,EAAE,OAAO,CAAC;IAGzB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,QAAQ,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAG5B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,kBAAkB,CAAC,EAAE,eAAe,GAAG,eAAe,GAAG,IAAI,CAAC;IAC9D,gBAAgB,CAAC,EAAE,uBAAuB,EAAE,CAAC;IAG7C,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,YAAY,CAAC,EAAE,YAAY,CAAC;IAG5B,eAAe,CAAC,EAAE,eAAe,CAAC;IAGlC,QAAQ,CAAC,EAAE;QACT,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,cAAc,EAAE,OAAO,CAAC;KACzB,GAAG,IAAI,CAAC;IACT,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAOD,MAAM,WAAW,qBAAqB;IACpC,eAAe,EAAE,CAAC,KAAK,EAAE;QACvB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;QACrB,OAAO,EAAE,OAAO,CAAC;QACjB,UAAU,EAAE,QAAQ,CAAC;QACrB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;QAC3B,cAAc,EAAE,OAAO,CAAC;QACxB,YAAY,EAAE,YAAY,CAAC;KAC5B,KAAK;QACJ,KAAK,EAAE,kBAAkB,CAAC;QAC1B,aAAa,EAAE,sBAAsB,CAAC;QACtC,SAAS,EAAE,OAAO,CAAC;QACnB,0BAA0B,EAAE,OAAO,CAAC;KACrC,CAAC;IACF,mBAAmB,EAAE,CAAC,KAAK,EAAE;QAC3B,SAAS,EAAE,eAAe,CAAC;QAC3B,SAAS,EAAE,OAAO,CAAC;QACnB,OAAO,EAAE,OAAO,CAAC;QACjB,cAAc,EAAE,OAAO,CAAC;KACzB,KAAK,YAAY,GAAG,IAAI,CAAC;IAC1B,mBAAmB,EAAE,CAAC,KAAK,EAAE;QAC3B,SAAS,EAAE,OAAO,CAAC;QACnB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;QACrB,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;QACxB,UAAU,EAAE,QAAQ,GAAG,IAAI,CAAC;QAC5B,YAAY,EAAE,YAAY,GAAG,IAAI,CAAC;KACnC,KAAK,sBAAsB,CAAC;CAC9B;AAMD,eAAO,MAAM,gBAAgB,EAAG,kBAA2B,CAAC;AAC5D,eAAO,MAAM,gBAAgB,EAAG,kBAA2B,CAAC;AAE5D,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,sBAAsB,CAAC;CAC/B;AAED,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAoDD,qBAAa,sBAAuB,SAAQ,YAAY;IACtD,OAAO,CAAC,OAAO,CAA6C;IAC5D,OAAO,CAAC,YAAY,CAAkC;IACtD,OAAO,CAAC,SAAS,CAAsC;IAMvD,SAAS,CAAC,GAAG,EAAE,qBAAqB,GAAG,IAAI;IAQ3C,OAAO,KAAK,MAAM,GAKjB;IAKD,OAAO,CAAC,kBAAkB;IAsC1B,OAAO,CAAC,gBAAgB;IA0BxB,OAAO,CAAC,qBAAqB;IAsC7B,OAAO,CAAC,kBAAkB;IA6B1B,MAAM,CACJ,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,mBAAmB,EAC3B,MAAM,EAAE,MAAM,EACd,SAAS,CAAC,EAAE,MAAM,GACjB,IAAI;IAgDP,MAAM,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAiCpC,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,sBAAsB,GAAG,SAAS;IAOzE,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,sBAAsB,EAAE;IAa3D,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAQnD,kBAAkB,IAAI,MAAM,EAAE;IAO9B,IAAI,IAAI,MAAM;IAOd,KAAK,IAAI,IAAI;CAKd;AAMD,eAAO,MAAM,sBAAsB,wBAA+B,CAAC"}

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

@@ -0,0 +1,212 @@
+import { EventEmitter } from 'node:events';
+import { createLogger } from './logger.service.js';
+export const SNAPSHOT_CHANGED = 'snapshot_changed';
+export const SNAPSHOT_REMOVED = 'snapshot_removed';
+const WORKSPACE_FIELDS = ['name', 'status', 'createdAt', 'branchName', 'hasHadSessions'];
+const PR_FIELDS = ['prUrl', 'prNumber', 'prState', 'prCiStatus', 'prUpdatedAt'];
+const SESSION_FIELDS = ['isWorking', 'pendingRequestType', 'sessionSummaries'];
+const RATCHET_FIELDS = ['ratchetEnabled', 'ratchetState'];
+const RUN_SCRIPT_FIELDS = ['runScriptStatus'];
+const RECONCILIATION_FIELDS = ['gitStats', 'lastActivityAt'];
+const FIELD_GROUP_MAPPINGS = [
+    { group: 'workspace', fields: WORKSPACE_FIELDS },
+    { group: 'pr', fields: PR_FIELDS },
+    { group: 'session', fields: SESSION_FIELDS },
+    { group: 'ratchet', fields: RATCHET_FIELDS },
+    { group: 'runScript', fields: RUN_SCRIPT_FIELDS },
+    { group: 'reconciliation', fields: RECONCILIATION_FIELDS },
+];
+const logger = createLogger('workspace-snapshot-store');
+function createDefaultFieldTimestamps() {
+    return {
+        workspace: 0,
+        pr: 0,
+        session: 0,
+        ratchet: 0,
+        runScript: 0,
+        reconciliation: 0,
+    };
+}
+export class WorkspaceSnapshotStore extends EventEmitter {
+    entries = new Map();
+    projectIndex = new Map();
+    deriveFns = null;
+    configure(fns) {
+        this.deriveFns = fns;
+        logger.info('Snapshot store configured with derivation functions');
+    }
+    get derive() {
+        if (!this.deriveFns) {
+            throw new Error('WorkspaceSnapshotStore not configured: call configure() first.');
+        }
+        return this.deriveFns;
+    }
+    createDefaultEntry(workspaceId, projectId) {
+        return {
+            workspaceId,
+            projectId,
+            version: 0,
+            computedAt: '',
+            source: '',
+            name: '',
+            status: 'NEW',
+            createdAt: '',
+            branchName: null,
+            prUrl: null,
+            prNumber: null,
+            prState: 'NONE',
+            prCiStatus: 'UNKNOWN',
+            prUpdatedAt: null,
+            ratchetEnabled: false,
+            ratchetState: 'IDLE',
+            runScriptStatus: 'IDLE',
+            hasHadSessions: false,
+            isWorking: false,
+            pendingRequestType: null,
+            sessionSummaries: [],
+            gitStats: null,
+            lastActivityAt: null,
+            sidebarStatus: { activityState: 'IDLE', ciState: 'NONE' },
+            kanbanColumn: null,
+            flowPhase: 'NO_PR',
+            ciObservation: 'NOT_FETCHED',
+            ratchetButtonAnimated: false,
+            fieldTimestamps: createDefaultFieldTimestamps(),
+        };
+    }
+    mergeFieldGroups(entry, update, ts) {
+        for (const mapping of FIELD_GROUP_MAPPINGS) {
+            const hasFieldsInGroup = mapping.fields.some((field) => update[field] !== undefined);
+            if (!hasFieldsInGroup || ts <= entry.fieldTimestamps[mapping.group]) {
+                continue;
+            }
+            entry.fieldTimestamps[mapping.group] = ts;
+            for (const field of mapping.fields) {
+                const value = update[field];
+                if (value !== undefined) {
+                    entry[field] = value;
+                }
+            }
+        }
+    }
+    recomputeDerivedState(entry) {
+        const flowState = this.derive.deriveFlowState({
+            prUrl: entry.prUrl,
+            prState: entry.prState,
+            prCiStatus: entry.prCiStatus,
+            prUpdatedAt: entry.prUpdatedAt,
+            ratchetEnabled: entry.ratchetEnabled,
+            ratchetState: entry.ratchetState,
+        });
+        const effectiveIsWorking = entry.isWorking || flowState.isWorking;
+        entry.flowPhase = flowState.phase;
+        entry.ciObservation = flowState.ciObservation;
+        entry.ratchetButtonAnimated = flowState.shouldAnimateRatchetButton;
+        entry.kanbanColumn = this.derive.computeKanbanColumn({
+            lifecycle: entry.status,
+            isWorking: effectiveIsWorking,
+            prState: entry.prState,
+            hasHadSessions: entry.hasHadSessions,
+        });
+        entry.sidebarStatus = this.derive.deriveSidebarStatus({
+            isWorking: effectiveIsWorking,
+            prUrl: entry.prUrl,
+            prState: entry.prState,
+            prCiStatus: entry.prCiStatus,
+            ratchetState: entry.ratchetState,
+        });
+    }
+    updateProjectIndex(workspaceId, newProjectId, oldProjectId) {
+        if (oldProjectId && oldProjectId !== newProjectId) {
+            const oldSet = this.projectIndex.get(oldProjectId);
+            if (oldSet) {
+                oldSet.delete(workspaceId);
+                if (oldSet.size === 0) {
+                    this.projectIndex.delete(oldProjectId);
+                }
+            }
+        }
+        let projectSet = this.projectIndex.get(newProjectId);
+        if (!projectSet) {
+            projectSet = new Set();
+            this.projectIndex.set(newProjectId, projectSet);
+        }
+        projectSet.add(workspaceId);
+    }
+    upsert(workspaceId, update, source, timestamp) {
+        const ts = timestamp ?? Date.now();
+        let entry = this.entries.get(workspaceId);
+        const oldProjectId = entry?.projectId;
+        if (!entry) {
+            if (!update.projectId) {
+                throw new Error(`Cannot create snapshot for workspace ${workspaceId}: projectId is required on first upsert.`);
+            }
+            entry = this.createDefaultEntry(workspaceId, update.projectId);
+        }
+        if (update.projectId !== undefined) {
+            entry.projectId = update.projectId;
+        }
+        this.mergeFieldGroups(entry, update, ts);
+        this.recomputeDerivedState(entry);
+        entry.version += 1;
+        entry.computedAt = new Date().toISOString();
+        entry.source = source;
+        this.updateProjectIndex(workspaceId, entry.projectId, oldProjectId);
+        this.entries.set(workspaceId, entry);
+        this.emit(SNAPSHOT_CHANGED, {
+            workspaceId,
+            projectId: entry.projectId,
+            entry,
+        });
+        logger.debug('Snapshot updated', { workspaceId, version: entry.version, source });
+    }
+    remove(workspaceId) {
+        const entry = this.entries.get(workspaceId);
+        if (!entry) {
+            return false;
+        }
+        this.entries.delete(workspaceId);
+        const projectSet = this.projectIndex.get(entry.projectId);
+        if (projectSet) {
+            projectSet.delete(workspaceId);
+            if (projectSet.size === 0) {
+                this.projectIndex.delete(entry.projectId);
+            }
+        }
+        const event = {
+            workspaceId,
+            projectId: entry.projectId,
+        };
+        this.emit(SNAPSHOT_REMOVED, event);
+        logger.debug('Snapshot removed', { workspaceId, projectId: entry.projectId });
+        return true;
+    }
+    getByWorkspaceId(workspaceId) {
+        return this.entries.get(workspaceId);
+    }
+    getByProjectId(projectId) {
+        const workspaceIds = this.projectIndex.get(projectId);
+        if (!workspaceIds) {
+            return [];
+        }
+        return [...workspaceIds]
+            .map((id) => this.entries.get(id))
+            .filter((entry) => entry !== undefined);
+    }
+    getVersion(workspaceId) {
+        return this.entries.get(workspaceId)?.version;
+    }
+    getAllWorkspaceIds() {
+        return [...this.entries.keys()];
+    }
+    size() {
+        return this.entries.size;
+    }
+    clear() {
+        this.entries.clear();
+        this.projectIndex.clear();
+        logger.info('Snapshot store cleared');
+    }
+}
+export const workspaceSnapshotStore = new WorkspaceSnapshotStore();
+//# sourceMappingURL=workspace-snapshot-store.service.js.map

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

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

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

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

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

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

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

@@ -0,0 +1,392 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+vi.mock('./logger.service', () => ({
+    createLogger: () => ({
+        info: vi.fn(),
+        debug: vi.fn(),
+        warn: vi.fn(),
+        error: vi.fn(),
+    }),
+}));
+import { KanbanColumn } from '../../../prisma/generated/client.js';
+import { SNAPSHOT_CHANGED, SNAPSHOT_REMOVED, WorkspaceSnapshotStore, } from './workspace-snapshot-store.service.js';
+function makeUpdate(overrides = {}) {
+    return {
+        projectId: 'project-1',
+        name: 'Test Workspace',
+        status: 'READY',
+        createdAt: '2026-01-01T00:00:00Z',
+        branchName: 'feature/test',
+        prUrl: null,
+        prNumber: null,
+        prState: 'NONE',
+        prCiStatus: 'UNKNOWN',
+        prUpdatedAt: null,
+        ratchetEnabled: false,
+        ratchetState: 'IDLE',
+        runScriptStatus: 'IDLE',
+        hasHadSessions: false,
+        isWorking: false,
+        pendingRequestType: null,
+        gitStats: null,
+        lastActivityAt: null,
+        ...overrides,
+    };
+}
+describe('WorkspaceSnapshotStore', () => {
+    let store;
+    beforeEach(() => {
+        store = new WorkspaceSnapshotStore();
+        store.configure({
+            deriveFlowState: (_input) => ({
+                phase: 'NO_PR',
+                ciObservation: 'CHECKS_UNKNOWN',
+                isWorking: false,
+                shouldAnimateRatchetButton: false,
+            }),
+            computeKanbanColumn: (_input) => KanbanColumn.WORKING,
+            deriveSidebarStatus: (_input) => ({
+                activityState: 'IDLE',
+                ciState: 'NONE',
+            }),
+        });
+    });
+    describe('STORE-01: Basic CRUD operations', () => {
+        it('creates entry on first upsert', () => {
+            store.upsert('ws-1', makeUpdate({ projectId: 'proj-A' }), 'test', 100);
+            const entry = store.getByWorkspaceId('ws-1');
+            expect(entry).toBeDefined();
+            expect(entry.workspaceId).toBe('ws-1');
+            expect(entry.projectId).toBe('proj-A');
+        });
+        it('returns undefined for non-existent workspaceId', () => {
+            expect(store.getByWorkspaceId('nonexistent')).toBeUndefined();
+        });
+        it('updates existing entry on subsequent upsert', () => {
+            store.upsert('ws-1', makeUpdate({ name: 'Original' }), 'test', 100);
+            store.upsert('ws-1', makeUpdate({ name: 'Updated' }), 'test', 200);
+            const entry = store.getByWorkspaceId('ws-1');
+            expect(entry.name).toBe('Updated');
+        });
+        it('getByProjectId returns entries for a project', () => {
+            store.upsert('ws-1', makeUpdate({ projectId: 'proj-A' }), 'test', 100);
+            store.upsert('ws-2', makeUpdate({ projectId: 'proj-A' }), 'test', 100);
+            store.upsert('ws-3', makeUpdate({ projectId: 'proj-B' }), 'test', 100);
+            const projA = store.getByProjectId('proj-A');
+            const projB = store.getByProjectId('proj-B');
+            expect(projA).toHaveLength(2);
+            expect(projB).toHaveLength(1);
+        });
+        it('getByProjectId returns empty array for unknown project', () => {
+            expect(store.getByProjectId('nonexistent')).toEqual([]);
+        });
+        it('size returns correct count', () => {
+            store.upsert('ws-1', makeUpdate(), 'test', 100);
+            store.upsert('ws-2', makeUpdate(), 'test', 100);
+            store.upsert('ws-3', makeUpdate(), 'test', 100);
+            expect(store.size()).toBe(3);
+        });
+    });
+    describe('STORE-02: Version counter', () => {
+        it('version starts at 1 on first upsert', () => {
+            store.upsert('ws-1', makeUpdate(), 'test', 100);
+            const entry = store.getByWorkspaceId('ws-1');
+            expect(entry.version).toBe(1);
+        });
+        it('version increments on each upsert', () => {
+            for (let i = 0; i < 5; i++) {
+                store.upsert('ws-1', makeUpdate(), 'test', 100 + i);
+            }
+            const entry = store.getByWorkspaceId('ws-1');
+            expect(entry.version).toBe(5);
+        });
+        it('each workspace has independent version counter', () => {
+            store.upsert('ws-A', makeUpdate(), 'test', 100);
+            store.upsert('ws-A', makeUpdate(), 'test', 200);
+            store.upsert('ws-B', makeUpdate(), 'test', 100);
+            expect(store.getByWorkspaceId('ws-A').version).toBe(2);
+            expect(store.getByWorkspaceId('ws-B').version).toBe(1);
+        });
+        it('getVersion returns version for existing entry', () => {
+            store.upsert('ws-1', makeUpdate(), 'test', 100);
+            const entry = store.getByWorkspaceId('ws-1');
+            expect(store.getVersion('ws-1')).toBe(entry.version);
+        });
+        it('getVersion returns undefined for non-existent entry', () => {
+            expect(store.getVersion('nonexistent')).toBeUndefined();
+        });
+    });
+    describe('STORE-03: Debug metadata', () => {
+        it('sets computedAt as ISO timestamp on upsert', () => {
+            store.upsert('ws-1', makeUpdate(), 'test', 100);
+            const entry = store.getByWorkspaceId('ws-1');
+            const parsed = new Date(entry.computedAt);
+            expect(parsed.getTime()).not.toBeNaN();
+        });
+        it('sets source from upsert argument', () => {
+            store.upsert('ws-1', makeUpdate(), 'event:pr_state_change', 100);
+            const entry = store.getByWorkspaceId('ws-1');
+            expect(entry.source).toBe('event:pr_state_change');
+        });
+        it('updates computedAt and source on each upsert', () => {
+            store.upsert('ws-1', makeUpdate(), 'source-1', 100);
+            const firstComputedAt = store.getByWorkspaceId('ws-1').computedAt;
+            store.upsert('ws-1', makeUpdate(), 'source-2', 200);
+            const entry2 = store.getByWorkspaceId('ws-1');
+            expect(entry2.source).toBe('source-2');
+            expect(entry2.computedAt).toBeDefined();
+            expect(firstComputedAt).toBeDefined();
+        });
+    });
+    describe('STORE-04: Cleanup on remove', () => {
+        it('remove deletes entry', () => {
+            store.upsert('ws-1', makeUpdate(), 'test', 100);
+            store.remove('ws-1');
+            expect(store.getByWorkspaceId('ws-1')).toBeUndefined();
+        });
+        it('remove cleans up project index', () => {
+            store.upsert('ws-1', makeUpdate({ projectId: 'proj-A' }), 'test', 100);
+            store.upsert('ws-2', makeUpdate({ projectId: 'proj-A' }), 'test', 100);
+            store.remove('ws-1');
+            expect(store.getByProjectId('proj-A')).toHaveLength(1);
+            store.remove('ws-2');
+            expect(store.getByProjectId('proj-A')).toEqual([]);
+        });
+        it('remove returns true when entry existed', () => {
+            store.upsert('ws-1', makeUpdate(), 'test', 100);
+            expect(store.remove('ws-1')).toBe(true);
+        });
+        it('remove returns false when entry did not exist', () => {
+            expect(store.remove('nonexistent')).toBe(false);
+        });
+        it('removed entry cannot be queried', () => {
+            store.upsert('ws-1', makeUpdate(), 'test', 100);
+            store.remove('ws-1');
+            expect(store.getByWorkspaceId('ws-1')).toBeUndefined();
+            expect(store.getVersion('ws-1')).toBeUndefined();
+        });
+        it('clear removes all entries', () => {
+            store.upsert('ws-1', makeUpdate({ projectId: 'proj-A' }), 'test', 100);
+            store.upsert('ws-2', makeUpdate({ projectId: 'proj-A' }), 'test', 100);
+            store.upsert('ws-3', makeUpdate({ projectId: 'proj-B' }), 'test', 100);
+            store.clear();
+            expect(store.size()).toBe(0);
+            expect(store.getByProjectId('proj-A')).toEqual([]);
+            expect(store.getByProjectId('proj-B')).toEqual([]);
+        });
+    });
+    describe('STORE-06: Field-level timestamps for concurrent update safety', () => {
+        it('newer timestamp overwrites fields', () => {
+            store.upsert('ws-1', makeUpdate({ name: 'old' }), 'test', 100);
+            store.upsert('ws-1', { name: 'new' }, 'test', 200);
+            const entry = store.getByWorkspaceId('ws-1');
+            expect(entry.name).toBe('new');
+        });
+        it('older timestamp does not overwrite newer fields', () => {
+            store.upsert('ws-1', makeUpdate({ name: 'new' }), 'test', 200);
+            store.upsert('ws-1', { name: 'old' }, 'test', 100);
+            const entry = store.getByWorkspaceId('ws-1');
+            expect(entry.name).toBe('new');
+        });
+        it('different field groups can update independently', () => {
+            store.upsert('ws-1', { projectId: 'project-1', name: 'workspace-name', status: 'READY' }, 'test', 100);
+            store.upsert('ws-1', { prUrl: 'https://github.com/test/pr/1', prState: 'OPEN' }, 'test', 50);
+            const entry = store.getByWorkspaceId('ws-1');
+            expect(entry.name).toBe('workspace-name');
+            expect(entry.prUrl).toBe('https://github.com/test/pr/1');
+            expect(entry.prState).toBe('OPEN');
+        });
+        it('same-timestamp updates are not accepted (strictly newer required)', () => {
+            store.upsert('ws-1', makeUpdate({ name: 'original' }), 'test', 100);
+            store.upsert('ws-1', { name: 'attempted-overwrite' }, 'test', 100);
+            const entry = store.getByWorkspaceId('ws-1');
+            expect(entry.name).toBe('original');
+        });
+    });
+    describe('Project index management', () => {
+        it('handles project index when projectId changes', () => {
+            store.upsert('ws-1', makeUpdate({ projectId: 'proj-A' }), 'test', 100);
+            store.upsert('ws-1', makeUpdate({ projectId: 'proj-B' }), 'test', 200);
+            const projA = store.getByProjectId('proj-A');
+            const projB = store.getByProjectId('proj-B');
+            expect(projA.find((e) => e.workspaceId === 'ws-1')).toBeUndefined();
+            expect(projB.find((e) => e.workspaceId === 'ws-1')).toBeDefined();
+        });
+        it('project index is cleaned up when last entry removed', () => {
+            store.upsert('ws-1', makeUpdate({ projectId: 'proj-A' }), 'test', 100);
+            store.remove('ws-1');
+            expect(store.getByProjectId('proj-A')).toEqual([]);
+        });
+    });
+    describe('STORE-05 + STORE-06: Derived state recomputation', () => {
+        beforeEach(() => {
+            store.configure({
+                deriveFlowState: (input) => ({
+                    phase: input.prUrl ? 'CI_WAIT' : 'NO_PR',
+                    ciObservation: input.prCiStatus === 'SUCCESS'
+                        ? 'CHECKS_PASSED'
+                        : 'CHECKS_UNKNOWN',
+                    isWorking: input.prUrl !== null && input.prCiStatus === 'PENDING',
+                    shouldAnimateRatchetButton: input.ratchetEnabled && input.prCiStatus === 'PENDING',
+                }),
+                computeKanbanColumn: (input) => {
+                    if (input.isWorking) {
+                        return KanbanColumn.WORKING;
+                    }
+                    if (input.prState === 'MERGED') {
+                        return KanbanColumn.DONE;
+                    }
+                    return KanbanColumn.WAITING;
+                },
+                deriveSidebarStatus: (input) => ({
+                    activityState: input.isWorking ? 'WORKING' : 'IDLE',
+                    ciState: input.prUrl ? 'RUNNING' : 'NONE',
+                }),
+            });
+        });
+        it('derived state is computed on first upsert', () => {
+            store.upsert('ws-1', makeUpdate({ prUrl: null }), 'test', 100);
+            const entry = store.getByWorkspaceId('ws-1');
+            expect(entry.flowPhase).toBe('NO_PR');
+            expect(entry.kanbanColumn).toBe('WAITING');
+            expect(entry.sidebarStatus.ciState).toBe('NONE');
+        });
+        it('derived state recomputes when raw fields change', () => {
+            store.upsert('ws-1', makeUpdate({ prUrl: null }), 'test', 100);
+            expect(store.getByWorkspaceId('ws-1').flowPhase).toBe('NO_PR');
+            store.upsert('ws-1', { prUrl: 'https://github.com/org/repo/pull/1', prCiStatus: 'PENDING' }, 'test', 200);
+            const entry = store.getByWorkspaceId('ws-1');
+            expect(entry.flowPhase).toBe('CI_WAIT');
+            expect(entry.sidebarStatus.ciState).toBe('RUNNING');
+        });
+        it('kanbanColumn reflects isWorking from flow state', () => {
+            store.upsert('ws-1', makeUpdate({
+                prUrl: 'https://github.com/org/repo/pull/1',
+                prCiStatus: 'PENDING',
+            }), 'test', 100);
+            const entry = store.getByWorkspaceId('ws-1');
+            expect(entry.kanbanColumn).toBe('WORKING');
+        });
+        it('ratchetButtonAnimated reflects flow state', () => {
+            store.upsert('ws-1', makeUpdate({
+                ratchetEnabled: true,
+                prUrl: 'https://github.com/org/repo/pull/1',
+                prCiStatus: 'PENDING',
+            }), 'test', 100);
+            const entry = store.getByWorkspaceId('ws-1');
+            expect(entry.ratchetButtonAnimated).toBe(true);
+        });
+        it('derived state uses effective isWorking (session OR flow)', () => {
+            store.upsert('ws-1', makeUpdate({ isWorking: true, prUrl: null }), 'test', 100);
+            const entry = store.getByWorkspaceId('ws-1');
+            expect(entry.sidebarStatus.activityState).toBe('WORKING');
+        });
+        it('authoritative isWorking=false is not overridden by stale session summaries', () => {
+            store.upsert('ws-1', makeUpdate({
+                isWorking: true,
+                sessionSummaries: [
+                    {
+                        sessionId: 's-1',
+                        name: 'Chat 1',
+                        workflow: 'followup',
+                        model: 'claude-sonnet',
+                        persistedStatus: 'RUNNING',
+                        runtimePhase: 'running',
+                        processState: 'alive',
+                        activity: 'WORKING',
+                        updatedAt: '2026-01-01T00:00:00Z',
+                        lastExit: null,
+                    },
+                ],
+            }), 'test', 100);
+            store.upsert('ws-1', { isWorking: false }, 'test', 200);
+            const entry = store.getByWorkspaceId('ws-1');
+            expect(entry.isWorking).toBe(false);
+            expect(entry.sidebarStatus.activityState).toBe('IDLE');
+            expect(entry.kanbanColumn).toBe('WAITING');
+        });
+    });
+    describe('Event emission', () => {
+        it('emits snapshot_changed on upsert', () => {
+            const handler = vi.fn();
+            store.on(SNAPSHOT_CHANGED, handler);
+            store.upsert('ws-1', makeUpdate({ projectId: 'proj-A' }), 'test', 100);
+            expect(handler).toHaveBeenCalledTimes(1);
+            const event = handler.mock.calls[0][0];
+            expect(event.workspaceId).toBe('ws-1');
+            expect(event.projectId).toBe('proj-A');
+            expect(event.entry).toBeDefined();
+            expect(event.entry.workspaceId).toBe('ws-1');
+        });
+        it('emits snapshot_removed on remove', () => {
+            const handler = vi.fn();
+            store.on(SNAPSHOT_REMOVED, handler);
+            store.upsert('ws-1', makeUpdate({ projectId: 'proj-A' }), 'test', 100);
+            store.remove('ws-1');
+            expect(handler).toHaveBeenCalledTimes(1);
+            const event = handler.mock.calls[0][0];
+            expect(event.workspaceId).toBe('ws-1');
+            expect(event.projectId).toBe('proj-A');
+        });
+        it('does not emit snapshot_removed for non-existent entry', () => {
+            const handler = vi.fn();
+            store.on(SNAPSHOT_REMOVED, handler);
+            store.remove('nonexistent');
+            expect(handler).not.toHaveBeenCalled();
+        });
+        it('snapshot_changed event has fully consistent entry', () => {
+            store.configure({
+                deriveFlowState: (input) => ({
+                    phase: input.prUrl ? 'CI_WAIT' : 'NO_PR',
+                    ciObservation: 'CHECKS_UNKNOWN',
+                    isWorking: false,
+                    shouldAnimateRatchetButton: false,
+                }),
+                computeKanbanColumn: (_input) => KanbanColumn.WORKING,
+                deriveSidebarStatus: (_input) => ({
+                    activityState: 'IDLE',
+                    ciState: 'NONE',
+                }),
+            });
+            const handler = vi.fn();
+            store.on(SNAPSHOT_CHANGED, handler);
+            store.upsert('ws-1', makeUpdate({ prUrl: 'https://github.com/org/repo/pull/1' }), 'test', 100);
+            const event = handler.mock.calls[0][0];
+            expect(event.entry.flowPhase).toBe('CI_WAIT');
+        });
+        it('emits one event per upsert call', () => {
+            const handler = vi.fn();
+            store.on(SNAPSHOT_CHANGED, handler);
+            store.upsert('ws-1', makeUpdate(), 'test', 100);
+            store.upsert('ws-1', makeUpdate(), 'test', 200);
+            store.upsert('ws-1', makeUpdate(), 'test', 300);
+            expect(handler).toHaveBeenCalledTimes(3);
+        });
+    });
+    describe('Error handling', () => {
+        it('throws on upsert without configure()', () => {
+            const unconfiguredStore = new WorkspaceSnapshotStore();
+            expect(() => {
+                unconfiguredStore.upsert('ws-1', makeUpdate(), 'test', 100);
+            }).toThrow('not configured');
+        });
+        it('throws on first upsert without projectId', () => {
+            const { projectId: _, ...updateWithoutProjectId } = makeUpdate();
+            expect(() => {
+                store.upsert('ws-1', updateWithoutProjectId, 'test', 100);
+            }).toThrow('projectId');
+        });
+    });
+    describe('ARCH-02: No domain imports', () => {
+        it('service file has zero imports from @/backend/domains/', () => {
+            const serviceFilePath = path.resolve(import.meta.dirname, 'workspace-snapshot-store.service.ts');
+            const content = fs.readFileSync(serviceFilePath, 'utf-8');
+            const importLines = content.split('\n').filter((line) => /^\s*import\s/.test(line));
+            for (const line of importLines) {
+                expect(line).not.toContain('@/backend/domains/');
+            }
+        });
+    });
+});
+//# sourceMappingURL=workspace-snapshot-store.service.test.js.map