maestro-flow 0.1.0

package/dashboard/dist-server/server/state/fs-watcher.js.map

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

package/dashboard/dist-server/server/state/state-manager.d.ts

@@ -0,0 +1,31 @@
+import type { BoardState, PhaseCard, TaskCard, ProjectState } from '../../shared/types.js';
+import type { DashboardEventBus } from './event-bus.js';
+export declare class StateManager {
+    private workflowRoot;
+    private readonly eventBus;
+    private board;
+    /** Cache: phase number → directory path for O(1) lookups */
+    private phaseDirCache;
+    private isSwitching;
+    constructor(workflowRoot: string, eventBus: DashboardEventBus);
+    /** Return current workspace project root (parent of .workflow/) */
+    getWorkspaceRoot(): string;
+    /** Return current .workflow/ directory path (updates on workspace switch) */
+    getWorkflowRoot(): string;
+    /** Return current board state snapshot */
+    getBoard(): BoardState;
+    /** Return project state */
+    getProject(): ProjectState;
+    /** Return a specific phase by number, or undefined */
+    getPhase(n: number): PhaseCard | undefined;
+    /** Return tasks for a given phase number */
+    getTasks(phaseNum: number): Promise<TaskCard[]>;
+    buildInitialState(): Promise<BoardState>;
+    get switching(): boolean;
+    resetForNewWorkspace(newRoot: string): Promise<void>;
+    applyFileChange(filePath: string): Promise<void>;
+    private upsertPhase;
+    private upsertScratch;
+    private readAllPhases;
+    private readAllScratch;
+}

package/dashboard/dist-server/server/state/state-manager.js

@@ -0,0 +1,297 @@
+import { readdir } from 'node:fs/promises';
+import { join, relative, resolve } from 'node:path';
+import { SSE_EVENT_TYPES } from '../../shared/constants.js';
+import { readJsonSafe } from './file-reader.js';
+import { toForwardSlash } from '../../shared/utils.js';
+// ---------------------------------------------------------------------------
+// StateManager — in-memory projection of .workflow/ directory
+// ---------------------------------------------------------------------------
+export class StateManager {
+    workflowRoot;
+    eventBus;
+    board;
+    /** Cache: phase number → directory path for O(1) lookups */
+    phaseDirCache = new Map();
+    isSwitching = false;
+    constructor(workflowRoot, eventBus) {
+        this.workflowRoot = workflowRoot;
+        this.eventBus = eventBus;
+        this.board = emptyBoard();
+    }
+    /** Return current workspace project root (parent of .workflow/) */
+    getWorkspaceRoot() {
+        return resolve(this.workflowRoot, '..');
+    }
+    /** Return current .workflow/ directory path (updates on workspace switch) */
+    getWorkflowRoot() {
+        return this.workflowRoot;
+    }
+    /** Return current board state snapshot */
+    getBoard() {
+        return this.board;
+    }
+    /** Return project state */
+    getProject() {
+        return this.board.project;
+    }
+    /** Return a specific phase by number, or undefined */
+    getPhase(n) {
+        return this.board.phases.find((p) => p.phase === n);
+    }
+    /** Return tasks for a given phase number */
+    async getTasks(phaseNum) {
+        // Use cached directory path if available
+        const cached = this.phaseDirCache.get(phaseNum);
+        if (cached)
+            return readPhaseTasks(cached);
+        const phaseDir = await findPhaseDir(this.workflowRoot, phaseNum);
+        if (!phaseDir)
+            return [];
+        this.phaseDirCache.set(phaseNum, phaseDir);
+        return readPhaseTasks(phaseDir);
+    }
+    // -------------------------------------------------------------------------
+    // Full state build — scans the entire .workflow/ directory
+    // -------------------------------------------------------------------------
+    async buildInitialState() {
+        const project = await readJsonSafe(join(this.workflowRoot, 'state.json'));
+        const phases = await this.readAllPhases();
+        const scratch = await this.readAllScratch();
+        this.board = {
+            project: project ?? emptyProject(),
+            phases,
+            scratch,
+            lastUpdated: new Date().toISOString(),
+        };
+        this.eventBus.emit(SSE_EVENT_TYPES.BOARD_FULL, this.board);
+        return this.board;
+    }
+    // -------------------------------------------------------------------------
+    // Workspace switch — replace root, rebuild state, broadcast switch event
+    // -------------------------------------------------------------------------
+    get switching() {
+        return this.isSwitching;
+    }
+    async resetForNewWorkspace(newRoot) {
+        if (this.isSwitching) {
+            throw new Error('Workspace switch already in progress.');
+        }
+        this.isSwitching = true;
+        try {
+            this.phaseDirCache.clear();
+            this.workflowRoot = newRoot;
+            await this.buildInitialState();
+            this.eventBus.emit(SSE_EVENT_TYPES.WORKSPACE_SWITCHED, { workspace: resolve(newRoot, '..') });
+        }
+        finally {
+            this.isSwitching = false;
+        }
+    }
+    // -------------------------------------------------------------------------
+    // Delta update — re-read a single changed file and emit event
+    // -------------------------------------------------------------------------
+    async applyFileChange(filePath) {
+        const rel = toForwardSlash(relative(this.workflowRoot, filePath));
+        // state.json — project-level change
+        if (rel === 'state.json') {
+            const project = await readJsonSafe(filePath);
+            if (project) {
+                this.board.project = project;
+                this.board.lastUpdated = new Date().toISOString();
+                this.eventBus.emit(SSE_EVENT_TYPES.PROJECT_UPDATED, this.board.project);
+            }
+            return;
+        }
+        // phases/<slug>/index.json — phase updated
+        const phaseIndexMatch = rel.match(/^phases\/[^/]+\/index\.json$/);
+        if (phaseIndexMatch) {
+            const phase = await readJsonSafe(filePath);
+            if (phase) {
+                this.upsertPhase(phase);
+                this.board.lastUpdated = new Date().toISOString();
+                this.eventBus.emit(SSE_EVENT_TYPES.PHASE_UPDATED, phase);
+            }
+            return;
+        }
+        // phases/<slug>/.task/TASK-*.json — task updated
+        const taskMatch = rel.match(/^phases\/[^/]+\/\.task\/TASK-.*\.json$/);
+        if (taskMatch) {
+            const task = await readJsonSafe(filePath);
+            if (task) {
+                this.board.lastUpdated = new Date().toISOString();
+                this.eventBus.emit(SSE_EVENT_TYPES.TASK_UPDATED, task);
+            }
+            return;
+        }
+        // scratch/<slug>/index.json — scratch task updated
+        const scratchMatch = rel.match(/^scratch\/[^/]+\/index\.json$/);
+        if (scratchMatch) {
+            const scratch = await readJsonSafe(filePath);
+            if (scratch) {
+                this.upsertScratch(scratch);
+                this.board.lastUpdated = new Date().toISOString();
+                this.eventBus.emit(SSE_EVENT_TYPES.SCRATCH_UPDATED, scratch);
+            }
+            return;
+        }
+    }
+    // -------------------------------------------------------------------------
+    // Internal helpers
+    // -------------------------------------------------------------------------
+    upsertPhase(phase) {
+        phase = normalizePhase(phase);
+        const idx = this.board.phases.findIndex((p) => p.phase === phase.phase);
+        if (idx >= 0) {
+            this.board.phases[idx] = phase;
+        }
+        else {
+            this.board.phases.push(phase);
+            this.board.phases.sort((a, b) => a.phase - b.phase);
+        }
+    }
+    upsertScratch(card) {
+        const idx = this.board.scratch.findIndex((s) => s.id === card.id);
+        if (idx >= 0) {
+            this.board.scratch[idx] = card;
+        }
+        else {
+            this.board.scratch.push(card);
+        }
+    }
+    async readAllPhases() {
+        const phasesDir = join(this.workflowRoot, 'phases');
+        const slugs = await safeReaddir(phasesDir);
+        const phases = [];
+        this.phaseDirCache.clear();
+        for (const slug of slugs) {
+            const dirPath = join(phasesDir, slug);
+            const indexPath = join(dirPath, 'index.json');
+            const phase = await readJsonSafe(indexPath);
+            if (phase) {
+                phases.push(normalizePhase(phase));
+                this.phaseDirCache.set(phase.phase, dirPath);
+            }
+        }
+        phases.sort((a, b) => a.phase - b.phase);
+        return phases;
+    }
+    async readAllScratch() {
+        const scratchDir = join(this.workflowRoot, 'scratch');
+        const slugs = await safeReaddir(scratchDir);
+        const cards = [];
+        for (const slug of slugs) {
+            const indexPath = join(scratchDir, slug, 'index.json');
+            const card = await readJsonSafe(indexPath);
+            if (card) {
+                cards.push(card);
+            }
+        }
+        return cards;
+    }
+}
+// ---------------------------------------------------------------------------
+// Module-level helpers
+// ---------------------------------------------------------------------------
+async function findPhaseDir(workflowRoot, phaseNum) {
+    const phasesDir = join(workflowRoot, 'phases');
+    const slugs = await safeReaddir(phasesDir);
+    for (const slug of slugs) {
+        const indexPath = join(phasesDir, slug, 'index.json');
+        const phase = await readJsonSafe(indexPath);
+        if (phase && phase.phase === phaseNum) {
+            return join(phasesDir, slug);
+        }
+    }
+    return null;
+}
+async function readPhaseTasks(phaseDir) {
+    const taskDir = join(phaseDir, '.task');
+    const entries = await safeReaddirFiles(taskDir);
+    const tasks = [];
+    for (const entry of entries) {
+        if (!entry.startsWith('TASK-') || !entry.endsWith('.json'))
+            continue;
+        const task = await readJsonSafe(join(taskDir, entry));
+        if (task) {
+            tasks.push(task);
+        }
+    }
+    return tasks;
+}
+async function safeReaddir(dir) {
+    try {
+        const entries = await readdir(dir, { withFileTypes: true });
+        return entries.filter((e) => e.isDirectory()).map((e) => e.name);
+    }
+    catch {
+        return [];
+    }
+}
+async function safeReaddirFiles(dir) {
+    try {
+        const entries = await readdir(dir, { withFileTypes: true });
+        return entries.filter((e) => e.isFile()).map((e) => e.name);
+    }
+    catch {
+        return [];
+    }
+}
+function emptyProject() {
+    return {
+        version: '1.0',
+        project_name: '',
+        current_milestone: '',
+        current_phase: 0,
+        status: 'idle',
+        phases_summary: { total: 0, completed: 0, in_progress: 0, pending: 0 },
+        last_updated: new Date().toISOString(),
+        accumulated_context: { key_decisions: [], blockers: [], deferred: [] },
+    };
+}
+function emptyBoard() {
+    return {
+        project: emptyProject(),
+        phases: [],
+        scratch: [],
+        lastUpdated: new Date().toISOString(),
+    };
+}
+/** Fill missing fields in PhaseCard so components never crash on partial data */
+function normalizePhase(p) {
+    const raw = p;
+    if (p.execution && raw.verification && raw.validation && raw.uat && raw.reflection
+        && Array.isArray(p.success_criteria) && Array.isArray(p.requirements)
+        && Array.isArray(raw.verification?.must_haves))
+        return p;
+    return {
+        ...p,
+        goal: p.goal ?? '',
+        success_criteria: p.success_criteria ?? [],
+        requirements: p.requirements ?? [],
+        spec_ref: p.spec_ref ?? null,
+        plan: p.plan ?? { task_ids: [], task_count: 0, complexity: null, waves: [] },
+        execution: p.execution ?? { method: '', started_at: null, completed_at: null, tasks_completed: 0, tasks_total: 0, current_wave: 0, commits: [] },
+        verification: {
+            status: raw.verification?.status ?? 'pending',
+            verified_at: raw.verification?.verified_at ?? null,
+            must_haves: raw.verification?.must_haves ?? [],
+            gaps: raw.verification?.gaps ?? [],
+        },
+        validation: {
+            status: raw.validation?.status ?? 'pending',
+            test_coverage: raw.validation?.test_coverage ?? null,
+            gaps: raw.validation?.gaps ?? [],
+        },
+        uat: {
+            status: raw.uat?.status ?? 'pending',
+            test_count: raw.uat?.test_count ?? 0,
+            passed: raw.uat?.passed ?? 0,
+            gaps: raw.uat?.gaps ?? [],
+        },
+        reflection: {
+            rounds: raw.reflection?.rounds ?? 0,
+            strategy_adjustments: raw.reflection?.strategy_adjustments ?? [],
+        },
+    };
+}
+//# sourceMappingURL=state-manager.js.map

package/dashboard/dist-server/server/state/state-manager.js.map

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

package/dashboard/dist-server/server/state/state-manager.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dashboard/dist-server/server/state/state-manager.test.js

@@ -0,0 +1,258 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import { mkdtemp, rm, mkdir, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { tmpdir } from 'node:os';
+import { StateManager } from './state-manager.js';
+import { DashboardEventBus } from './event-bus.js';
+import { SSE_EVENT_TYPES } from '../../shared/constants.js';
+describe('StateManager', () => {
+    let tempDir;
+    let eventBus;
+    let manager;
+    beforeEach(async () => {
+        tempDir = await mkdtemp(join(tmpdir(), 'state-mgr-'));
+        eventBus = new DashboardEventBus();
+        manager = new StateManager(tempDir, eventBus);
+    });
+    afterEach(async () => {
+        await rm(tempDir, { recursive: true, force: true });
+    });
+    describe('getBoard / getProject / getPhase', () => {
+        it('returns empty board initially', () => {
+            const board = manager.getBoard();
+            expect(board.project.project_name).toBe('');
+            expect(board.phases).toEqual([]);
+            expect(board.scratch).toEqual([]);
+        });
+        it('getProject returns empty project initially', () => {
+            const project = manager.getProject();
+            expect(project.status).toBe('idle');
+            expect(project.version).toBe('1.0');
+        });
+        it('getPhase returns undefined for non-existent phase', () => {
+            expect(manager.getPhase(1)).toBeUndefined();
+        });
+    });
+    describe('buildInitialState', () => {
+        it('reads state.json and emits board:full', async () => {
+            const emitSpy = vi.spyOn(eventBus, 'emit');
+            const stateJson = {
+                version: '1.0',
+                project_name: 'test-project',
+                current_milestone: 'M1',
+                current_phase: 1,
+                status: 'active',
+                phases_summary: { total: 1, completed: 0, in_progress: 1, pending: 0 },
+                last_updated: '2026-01-01T00:00:00Z',
+                accumulated_context: { key_decisions: [], blockers: [], deferred: [] },
+            };
+            await writeFile(join(tempDir, 'state.json'), JSON.stringify(stateJson));
+            const board = await manager.buildInitialState();
+            expect(board.project.project_name).toBe('test-project');
+            expect(board.project.status).toBe('active');
+            expect(emitSpy).toHaveBeenCalledWith(SSE_EVENT_TYPES.BOARD_FULL, board);
+        });
+        it('returns empty project when state.json is missing', async () => {
+            const board = await manager.buildInitialState();
+            expect(board.project.project_name).toBe('');
+        });
+        it('reads phases from phases/ directory', async () => {
+            await mkdir(join(tempDir, 'phases', 'phase-1-setup'), { recursive: true });
+            const phaseCard = {
+                phase: 1,
+                title: 'Setup',
+                slug: 'phase-1-setup',
+                status: 'executing',
+                tasks_summary: { total: 2, completed: 1, in_progress: 1, pending: 0, failed: 0 },
+            };
+            await writeFile(join(tempDir, 'phases', 'phase-1-setup', 'index.json'), JSON.stringify(phaseCard));
+            const board = await manager.buildInitialState();
+            expect(board.phases).toHaveLength(1);
+            expect(board.phases[0].title).toBe('Setup');
+            expect(manager.getPhase(1)?.title).toBe('Setup');
+        });
+        it('reads scratch cards from scratch/ directory', async () => {
+            await mkdir(join(tempDir, 'scratch', 'quick-fix'), { recursive: true });
+            const scratchCard = {
+                id: 'scratch-quick-fix',
+                title: 'Quick Fix',
+                slug: 'quick-fix',
+                status: 'active',
+            };
+            await writeFile(join(tempDir, 'scratch', 'quick-fix', 'index.json'), JSON.stringify(scratchCard));
+            const board = await manager.buildInitialState();
+            expect(board.scratch).toHaveLength(1);
+            expect(board.scratch[0].title).toBe('Quick Fix');
+        });
+        it('handles missing phases/ directory gracefully', async () => {
+            // phases/ directory does not exist
+            const board = await manager.buildInitialState();
+            expect(board.phases).toEqual([]);
+        });
+        it('sorts phases by phase number', async () => {
+            await mkdir(join(tempDir, 'phases', 'phase-2-impl'), { recursive: true });
+            await mkdir(join(tempDir, 'phases', 'phase-1-setup'), { recursive: true });
+            await writeFile(join(tempDir, 'phases', 'phase-2-impl', 'index.json'), JSON.stringify({ phase: 2, title: 'Impl', slug: 'phase-2-impl', status: 'pending' }));
+            await writeFile(join(tempDir, 'phases', 'phase-1-setup', 'index.json'), JSON.stringify({ phase: 1, title: 'Setup', slug: 'phase-1-setup', status: 'completed' }));
+            const board = await manager.buildInitialState();
+            expect(board.phases[0].phase).toBe(1);
+            expect(board.phases[1].phase).toBe(2);
+        });
+    });
+    describe('getTasks', () => {
+        it('reads tasks from phase .task/ directory', async () => {
+            await mkdir(join(tempDir, 'phases', 'phase-1-setup', '.task'), { recursive: true });
+            await writeFile(join(tempDir, 'phases', 'phase-1-setup', 'index.json'), JSON.stringify({ phase: 1, title: 'Setup', slug: 'phase-1-setup', status: 'executing' }));
+            await writeFile(join(tempDir, 'phases', 'phase-1-setup', '.task', 'TASK-001.json'), JSON.stringify({ id: 'TASK-001', title: 'Do stuff', status: 'pending' }));
+            // Build state first to populate phase dir cache
+            await manager.buildInitialState();
+            const tasks = await manager.getTasks(1);
+            expect(tasks).toHaveLength(1);
+            expect(tasks[0].id).toBe('TASK-001');
+        });
+        it('returns empty array for non-existent phase', async () => {
+            const tasks = await manager.getTasks(999);
+            expect(tasks).toEqual([]);
+        });
+        it('uses cached directory path on second call', async () => {
+            await mkdir(join(tempDir, 'phases', 'phase-1-setup', '.task'), { recursive: true });
+            await writeFile(join(tempDir, 'phases', 'phase-1-setup', 'index.json'), JSON.stringify({ phase: 1, title: 'Setup', slug: 'phase-1-setup', status: 'executing' }));
+            await writeFile(join(tempDir, 'phases', 'phase-1-setup', '.task', 'TASK-001.json'), JSON.stringify({ id: 'TASK-001', title: 'Task 1', status: 'pending' }));
+            await manager.buildInitialState();
+            // First call populates cache, second uses it
+            const tasks1 = await manager.getTasks(1);
+            const tasks2 = await manager.getTasks(1);
+            expect(tasks1).toEqual(tasks2);
+        });
+        it('skips non-TASK files in .task/ directory', async () => {
+            await mkdir(join(tempDir, 'phases', 'phase-1-setup', '.task'), { recursive: true });
+            await writeFile(join(tempDir, 'phases', 'phase-1-setup', 'index.json'), JSON.stringify({ phase: 1, title: 'Setup', slug: 'phase-1-setup', status: 'executing' }));
+            await writeFile(join(tempDir, 'phases', 'phase-1-setup', '.task', 'TASK-001.json'), JSON.stringify({ id: 'TASK-001', title: 'Task 1', status: 'pending' }));
+            await writeFile(join(tempDir, 'phases', 'phase-1-setup', '.task', 'README.md'), 'not a task');
+            await manager.buildInitialState();
+            const tasks = await manager.getTasks(1);
+            expect(tasks).toHaveLength(1);
+        });
+    });
+    describe('applyFileChange', () => {
+        it('updates project on state.json change', async () => {
+            const emitSpy = vi.spyOn(eventBus, 'emit');
+            await manager.buildInitialState();
+            const newState = {
+                version: '1.0',
+                project_name: 'updated-project',
+                current_milestone: 'M2',
+                current_phase: 2,
+                status: 'active',
+                phases_summary: { total: 2, completed: 1, in_progress: 1, pending: 0 },
+                last_updated: '2026-01-02T00:00:00Z',
+                accumulated_context: { key_decisions: [], blockers: [], deferred: [] },
+            };
+            await writeFile(join(tempDir, 'state.json'), JSON.stringify(newState));
+            await manager.applyFileChange(join(tempDir, 'state.json'));
+            expect(manager.getProject().project_name).toBe('updated-project');
+            expect(emitSpy).toHaveBeenCalledWith(SSE_EVENT_TYPES.PROJECT_UPDATED, expect.objectContaining({ project_name: 'updated-project' }));
+        });
+        it('updates phase on phase index.json change', async () => {
+            const emitSpy = vi.spyOn(eventBus, 'emit');
+            await manager.buildInitialState();
+            await mkdir(join(tempDir, 'phases', 'phase-1-setup'), { recursive: true });
+            const phaseCard = { phase: 1, title: 'Setup', slug: 'phase-1-setup', status: 'completed' };
+            await writeFile(join(tempDir, 'phases', 'phase-1-setup', 'index.json'), JSON.stringify(phaseCard));
+            await manager.applyFileChange(join(tempDir, 'phases', 'phase-1-setup', 'index.json'));
+            expect(manager.getPhase(1)?.status).toBe('completed');
+            expect(emitSpy).toHaveBeenCalledWith(SSE_EVENT_TYPES.PHASE_UPDATED, phaseCard);
+        });
+        it('upserts new phase into board', async () => {
+            await manager.buildInitialState();
+            expect(manager.getBoard().phases).toHaveLength(0);
+            await mkdir(join(tempDir, 'phases', 'phase-1-setup'), { recursive: true });
+            await writeFile(join(tempDir, 'phases', 'phase-1-setup', 'index.json'), JSON.stringify({ phase: 1, title: 'Setup', slug: 'phase-1-setup', status: 'pending' }));
+            await manager.applyFileChange(join(tempDir, 'phases', 'phase-1-setup', 'index.json'));
+            expect(manager.getBoard().phases).toHaveLength(1);
+        });
+        it('emits task:updated on TASK file change', async () => {
+            const emitSpy = vi.spyOn(eventBus, 'emit');
+            await manager.buildInitialState();
+            await mkdir(join(tempDir, 'phases', 'phase-1-setup', '.task'), { recursive: true });
+            const taskCard = { id: 'TASK-001', title: 'Do stuff', status: 'completed' };
+            await writeFile(join(tempDir, 'phases', 'phase-1-setup', '.task', 'TASK-001.json'), JSON.stringify(taskCard));
+            await manager.applyFileChange(join(tempDir, 'phases', 'phase-1-setup', '.task', 'TASK-001.json'));
+            expect(emitSpy).toHaveBeenCalledWith(SSE_EVENT_TYPES.TASK_UPDATED, taskCard);
+        });
+        it('emits scratch:updated on scratch index change', async () => {
+            const emitSpy = vi.spyOn(eventBus, 'emit');
+            await manager.buildInitialState();
+            await mkdir(join(tempDir, 'scratch', 'quick-fix'), { recursive: true });
+            const scratchCard = { id: 'scratch-quick-fix', title: 'Quick Fix', slug: 'quick-fix', status: 'active' };
+            await writeFile(join(tempDir, 'scratch', 'quick-fix', 'index.json'), JSON.stringify(scratchCard));
+            await manager.applyFileChange(join(tempDir, 'scratch', 'quick-fix', 'index.json'));
+            expect(emitSpy).toHaveBeenCalledWith(SSE_EVENT_TYPES.SCRATCH_UPDATED, scratchCard);
+        });
+        it('ignores unrecognized file paths', async () => {
+            const emitSpy = vi.spyOn(eventBus, 'emit');
+            await manager.buildInitialState();
+            // Clear the emit calls from buildInitialState
+            emitSpy.mockClear();
+            await manager.applyFileChange(join(tempDir, 'random', 'file.txt'));
+            expect(emitSpy).not.toHaveBeenCalled();
+        });
+        it('handles invalid JSON in state.json gracefully', async () => {
+            await manager.buildInitialState();
+            const originalName = manager.getProject().project_name;
+            await writeFile(join(tempDir, 'state.json'), '{invalid json');
+            // readJsonSafe will retry then throw, but applyFileChange should handle it
+            // The project should remain unchanged since parsing failed
+            // readJsonSafe returns null on ENOENT but throws on parse error after retries
+            // In this case the error propagates - let's verify it doesn't crash the manager
+            try {
+                await manager.applyFileChange(join(tempDir, 'state.json'));
+            }
+            catch {
+                // Parse errors may propagate - that's expected behavior
+            }
+            // Project should either be unchanged or updated (depending on error handling)
+            expect(manager.getProject()).toBeDefined();
+        });
+    });
+    describe('upsertPhase sorting', () => {
+        it('maintains sorted order when inserting phases out of order', async () => {
+            await manager.buildInitialState();
+            // Insert phase 3 first, then phase 1
+            await mkdir(join(tempDir, 'phases', 'phase-3-verify'), { recursive: true });
+            await writeFile(join(tempDir, 'phases', 'phase-3-verify', 'index.json'), JSON.stringify({ phase: 3, title: 'Verify', slug: 'phase-3-verify', status: 'pending' }));
+            await manager.applyFileChange(join(tempDir, 'phases', 'phase-3-verify', 'index.json'));
+            await mkdir(join(tempDir, 'phases', 'phase-1-setup'), { recursive: true });
+            await writeFile(join(tempDir, 'phases', 'phase-1-setup', 'index.json'), JSON.stringify({ phase: 1, title: 'Setup', slug: 'phase-1-setup', status: 'pending' }));
+            await manager.applyFileChange(join(tempDir, 'phases', 'phase-1-setup', 'index.json'));
+            const phases = manager.getBoard().phases;
+            expect(phases[0].phase).toBe(1);
+            expect(phases[1].phase).toBe(3);
+        });
+        it('replaces existing phase on update', async () => {
+            await manager.buildInitialState();
+            await mkdir(join(tempDir, 'phases', 'phase-1-setup'), { recursive: true });
+            await writeFile(join(tempDir, 'phases', 'phase-1-setup', 'index.json'), JSON.stringify({ phase: 1, title: 'Setup', slug: 'phase-1-setup', status: 'pending' }));
+            await manager.applyFileChange(join(tempDir, 'phases', 'phase-1-setup', 'index.json'));
+            expect(manager.getPhase(1)?.status).toBe('pending');
+            // Update same phase
+            await writeFile(join(tempDir, 'phases', 'phase-1-setup', 'index.json'), JSON.stringify({ phase: 1, title: 'Setup', slug: 'phase-1-setup', status: 'completed' }));
+            await manager.applyFileChange(join(tempDir, 'phases', 'phase-1-setup', 'index.json'));
+            expect(manager.getPhase(1)?.status).toBe('completed');
+            expect(manager.getBoard().phases).toHaveLength(1);
+        });
+    });
+    describe('upsertScratch', () => {
+        it('replaces existing scratch card on update', async () => {
+            await manager.buildInitialState();
+            await mkdir(join(tempDir, 'scratch', 'quick-fix'), { recursive: true });
+            await writeFile(join(tempDir, 'scratch', 'quick-fix', 'index.json'), JSON.stringify({ id: 'scratch-quick-fix', title: 'Quick Fix v1', slug: 'quick-fix', status: 'active' }));
+            await manager.applyFileChange(join(tempDir, 'scratch', 'quick-fix', 'index.json'));
+            await writeFile(join(tempDir, 'scratch', 'quick-fix', 'index.json'), JSON.stringify({ id: 'scratch-quick-fix', title: 'Quick Fix v2', slug: 'quick-fix', status: 'completed' }));
+            await manager.applyFileChange(join(tempDir, 'scratch', 'quick-fix', 'index.json'));
+            expect(manager.getBoard().scratch).toHaveLength(1);
+            expect(manager.getBoard().scratch[0].title).toBe('Quick Fix v2');
+        });
+    });
+});
+//# sourceMappingURL=state-manager.test.js.map