mstro-app 0.4.1 → 0.4.3

package/dist/server/services/websocket/plan-handlers.js

@@ -7,10 +7,11 @@
  * Follows the same pattern as quality-handlers.ts and git-handlers.ts.
  */
 import { existsSync, mkdirSync, readFileSync, unlinkSync, writeFileSync } from 'node:fs';
-import { join, resolve } from 'node:path';
+import { basename, join, resolve } from 'node:path';
 import { handlePlanPrompt } from '../plan/composer.js';
 import { PlanExecutor } from '../plan/executor.js';
-import { getNextId, parsePlanDirectory, parseSingleIssue, parseSingleMilestone, parseSingleSprint, planDirExists, resolvePmDir } from '../plan/parser.js';
+import { replaceFrontMatterField } from '../plan/front-matter.js';
+import { defaultPmDir, getNextBoardId, getNextBoardNumber, getNextId, getNextSprintId, parseBoardArtifacts, parseBoardDirectory, parsePlanDirectory, parseSingleIssue, parseSingleMilestone, parseSingleSprint, parseSprintArtifacts, planDirExists, resolvePmDir } from '../plan/parser.js';
 import { PlanWatcher } from '../plan/watcher.js';
 const watcherCache = new Map();
 const executorCache = new Map();
@@ -189,11 +190,25 @@ export function handlePlanMessage(ctx, ws, msg, _tabId, workingDir, permission)
         planDeleteIssue: () => handleDeleteIssue(ctx, ws, msg, workingDir, permission),
         planScaffold: () => handleScaffold(ctx, ws, msg, workingDir, permission),
         planPrompt: () => handlePrompt(ctx, ws, msg, workingDir, permission),
-        planExecute: () => handleExecute(ctx, ws, workingDir, permission),
+        planExecute: () => handleExecute(ctx, ws, msg, workingDir, permission),
         planExecuteEpic: () => handleExecuteEpic(ctx, ws, msg, workingDir, permission),
         planPause: () => handlePause(ctx, ws, workingDir, permission),
         planStop: () => handleStop(ctx, ws, workingDir, permission),
         planResume: () => handleResume(ctx, ws, workingDir, permission),
+        // Board lifecycle
+        planCreateBoard: () => handleCreateBoard(ctx, ws, msg, workingDir, permission),
+        planUpdateBoard: () => handleUpdateBoard(ctx, ws, msg, workingDir, permission),
+        planArchiveBoard: () => handleArchiveBoard(ctx, ws, msg, workingDir, permission),
+        planGetBoard: () => handleGetBoard(ctx, ws, msg, workingDir),
+        planGetBoardState: () => handleGetBoardState(ctx, ws, msg, workingDir),
+        planReorderBoards: () => handleReorderBoards(ctx, ws, msg, workingDir, permission),
+        planSetActiveBoard: () => handleSetActiveBoard(ctx, ws, msg, workingDir, permission),
+        planGetBoardArtifacts: () => handleGetBoardArtifacts(ctx, ws, msg, workingDir),
+        // Sprint lifecycle (legacy)
+        planCreateSprint: () => handleCreateSprint(ctx, ws, msg, workingDir, permission),
+        planActivateSprint: () => handleActivateSprint(ctx, ws, msg, workingDir, permission),
+        planCompleteSprint: () => handleCompleteSprint(ctx, ws, msg, workingDir, permission),
+        planGetSprintArtifacts: () => handleGetSprintArtifacts(ctx, ws, msg, workingDir),
     };
     const handler = handlers[msg.type];
     if (!handler)
@@ -209,10 +224,44 @@ export function handlePlanMessage(ctx, ws, msg, _tabId, workingDir, permission)
 // ============================================================================
 // Read-only handlers
 // ============================================================================
+/** Create the .mstro/pm/ directory structure with a default board. */
+function scaffoldPmDirectory(workingDir, name) {
+    const planDir = defaultPmDir(workingDir);
+    const boardId = 'BOARD-001';
+    const boardDir = join(planDir, 'boards', boardId);
+    for (const dir of ['milestones', 'templates']) {
+        mkdirSync(join(planDir, dir), { recursive: true });
+    }
+    for (const dir of ['backlog', 'out', 'reviews']) {
+        mkdirSync(join(boardDir, dir), { recursive: true });
+    }
+    writeFileSync(join(planDir, 'project.md'), buildProjectMarkdown(name), 'utf-8');
+    const workspace = { activeBoardId: boardId, boardOrder: [boardId] };
+    writeFileSync(join(planDir, 'workspace.json'), JSON.stringify(workspace, null, 2), 'utf-8');
+    const today = new Date().toISOString().split('T')[0];
+    writeFileSync(join(boardDir, 'board.md'), `---
+id: ${boardId}
+title: "Board 1"
+status: draft
+created: "${today}"
+completed_at: null
+goal: ""
+---
+
+# Board 1
+
+## Goal
+
+## Notes
+`, 'utf-8');
+    writeFileSync(join(boardDir, 'STATE.md'), buildStateMarkdown(name), 'utf-8');
+    writeFileSync(join(boardDir, 'progress.md'), '# Board Progress\n', 'utf-8');
+}
 function handlePlanInit(ctx, ws, workingDir) {
+    // Auto-scaffold if .mstro/pm/ doesn't exist
     if (!planDirExists(workingDir)) {
-        ctx.send(ws, { type: 'planNotFound', data: {} });
-        return;
+        const projectName = basename(workingDir) || 'My Project';
+        scaffoldPmDirectory(workingDir, projectName);
     }
     const fullState = parsePlanDirectory(workingDir);
     if (!fullState) {
@@ -273,26 +322,41 @@ function handleGetMilestone(ctx, ws, msg, workingDir) {
 // ============================================================================
 // Mutation handlers
 // ============================================================================
+/** Resolve backlog directory and existing issues for a board or legacy layout. */
+function resolveBacklogContext(pmDir, workingDir, boardId) {
+    const fullState = parsePlanDirectory(workingDir);
+    const effectiveBoardId = boardId || fullState?.workspace?.activeBoardId;
+    if (effectiveBoardId && existsSync(join(pmDir, 'boards', effectiveBoardId))) {
+        const boardState = parseBoardDirectory(pmDir, effectiveBoardId);
+        return {
+            backlogDir: join(pmDir, 'boards', effectiveBoardId, 'backlog'),
+            issues: boardState?.issues ?? [],
+            pathPrefix: `boards/${effectiveBoardId}/backlog`,
+        };
+    }
+    return {
+        backlogDir: join(pmDir, 'backlog'),
+        issues: fullState?.issues ?? [],
+        pathPrefix: 'backlog',
+    };
+}
 function handleCreateIssue(ctx, ws, msg, workingDir, permission) {
     if (denyIfViewOnly(ctx, ws, permission))
         return;
-    const { title, type = 'issue', priority = 'P2', labels = [], sprint, description = '' } = msg.data || {};
+    const { title, type = 'issue', priority = 'P2', labels = [], sprint, description = '', boardId } = msg.data || {};
     if (!title) {
         ctx.send(ws, { type: 'planError', data: { error: 'Title required' } });
         return;
     }
-    const pmDir = resolvePmDir(workingDir) ?? join(workingDir, '.pm');
-    const backlogDir = join(pmDir, 'backlog');
-    if (!existsSync(backlogDir)) {
+    const pmDir = resolvePmDir(workingDir) ?? defaultPmDir(workingDir);
+    const { backlogDir, issues, pathPrefix } = resolveBacklogContext(pmDir, workingDir, boardId);
+    if (!existsSync(backlogDir))
         mkdirSync(backlogDir, { recursive: true });
-    }
-    const fullState = parsePlanDirectory(workingDir);
     const prefix = type === 'bug' ? 'BG' : type === 'epic' ? 'EP' : 'IS';
-    const id = fullState ? getNextId(fullState.issues, prefix) : `${prefix}-001`;
-    const content = buildIssueMarkdown(id, title, type, priority, labels, sprint, description);
+    const id = getNextId(issues, prefix);
     const fileName = `${id}.md`;
-    writeFileSync(join(backlogDir, fileName), content, 'utf-8');
-    const issue = parseSingleIssue(workingDir, `backlog/${fileName}`);
+    writeFileSync(join(backlogDir, fileName), buildIssueMarkdown(id, title, type, priority, labels, sprint, description), 'utf-8');
+    const issue = parseSingleIssue(workingDir, `${pathPrefix}/${fileName}`);
     ctx.broadcastToAll({ type: 'planIssueCreated', data: issue });
 }
 function handleUpdateIssue(ctx, ws, msg, workingDir, permission) {
@@ -308,26 +372,16 @@ function handleUpdateIssue(ctx, ws, msg, workingDir, permission) {
         ctx.send(ws, { type: 'planError', data: { error: `File not found: ${path}` } });
         return;
     }
-    const content = readFileSync(fullPath, 'utf-8');
-    const match = content.match(/^---\n([\s\S]*?)\n---\n?([\s\S]*)$/);
-    if (!match) {
+    let content = readFileSync(fullPath, 'utf-8');
+    if (!content.match(/^---\n/)) {
         ctx.send(ws, { type: 'planError', data: { error: 'Invalid file format' } });
         return;
     }
-    let yamlStr = match[1];
-    const body = match[2];
     for (const [key, value] of Object.entries(fields)) {
         const yamlKey = key.replace(/([A-Z])/g, '_$1').toLowerCase();
-        const yamlValue = formatYamlValue(value);
-        const regex = new RegExp(`^${yamlKey}:.*$`, 'm');
-        if (regex.test(yamlStr)) {
-            yamlStr = yamlStr.replace(regex, `${yamlKey}: ${yamlValue}`);
-        }
-        else {
-            yamlStr += `\n${yamlKey}: ${yamlValue}`;
-        }
+        content = replaceFrontMatterField(content, yamlKey, formatYamlValue(value));
     }
-    writeFileSync(fullPath, `---\n${yamlStr}\n---\n${body}`, 'utf-8');
+    writeFileSync(fullPath, content, 'utf-8');
     const issue = parseSingleIssue(workingDir, path);
     ctx.broadcastToAll({ type: 'planIssueUpdated', data: issue });
 }
@@ -351,13 +405,7 @@ function handleScaffold(ctx, ws, msg, workingDir, permission) {
     if (denyIfViewOnly(ctx, ws, permission))
         return;
     const name = msg.data?.name || 'My Project';
-    const planDir = join(workingDir, '.pm');
-    for (const dir of ['backlog', 'sprints', 'milestones', 'docs', 'docs/decisions']) {
-        mkdirSync(join(planDir, dir), { recursive: true });
-    }
-    writeFileSync(join(planDir, 'project.md'), buildProjectMarkdown(name), 'utf-8');
-    writeFileSync(join(planDir, 'STATE.md'), buildStateMarkdown(name), 'utf-8');
-    writeFileSync(join(planDir, 'progress.md'), '# Progress Log\n', 'utf-8');
+    scaffoldPmDirectory(workingDir, name);
     const fullState = parsePlanDirectory(workingDir);
     ctx.broadcastToAll({ type: 'planScaffolded', data: fullState });
 }
@@ -368,11 +416,12 @@ function handlePrompt(ctx, ws, msg, workingDir, permission) {
     if (denyIfViewOnly(ctx, ws, permission))
         return;
     const prompt = msg.data?.prompt;
+    const boardId = msg.data?.boardId;
     if (!prompt) {
         ctx.send(ws, { type: 'planError', data: { error: 'Prompt required' } });
         return;
     }
-    handlePlanPrompt(ctx, ws, prompt, workingDir).catch(error => {
+    handlePlanPrompt(ctx, ws, prompt, workingDir, boardId).catch(error => {
         ctx.send(ws, {
             type: 'planError',
             data: { error: error instanceof Error ? error.message : String(error) },
@@ -418,6 +467,9 @@ function wireExecutorEvents(executor, ctx, workingDir) {
             ctx.broadcastToAll({ type: 'planStateUpdated', data: fullState });
         }
     });
+    executor.on('reviewProgress', (data) => {
+        ctx.broadcastToAll({ type: 'planReviewProgress', data });
+    });
     executor.on('complete', (reason) => {
         ctx.broadcastToAll({ type: 'planExecutionComplete', data: { reason, metrics: executor.getMetrics() } });
     });
@@ -425,7 +477,7 @@ function wireExecutorEvents(executor, ctx, workingDir) {
         ctx.broadcastToAll({ type: 'planExecutionError', data: { error } });
     });
 }
-function handleExecute(ctx, ws, workingDir, permission) {
+function handleExecute(ctx, ws, msg, workingDir, permission) {
     if (denyIfViewOnly(ctx, ws, permission))
         return;
     const executor = getExecutor(workingDir);
@@ -434,8 +486,11 @@ function handleExecute(ctx, ws, workingDir, permission) {
         return;
     }
     wireExecutorEvents(executor, ctx, workingDir);
-    ctx.send(ws, { type: 'planExecutionStarted', data: { status: 'executing' } });
-    executor.start().catch(error => {
+    // Execute the board the user is looking at, falling back to workspace.json activeBoardId
+    const boardId = msg.data?.boardId;
+    ctx.send(ws, { type: 'planExecutionStarted', data: { status: 'executing', boardId } });
+    const startPromise = boardId ? executor.startBoard(boardId) : executor.start();
+    startPromise.catch(error => {
         ctx.send(ws, {
             type: 'planExecutionError',
             data: { error: error instanceof Error ? error.message : String(error) },
@@ -491,4 +546,427 @@ function handleResume(ctx, ws, workingDir, permission) {
         });
     }
 }
+// ============================================================================
+// Board lifecycle handlers
+// ============================================================================
+function handleCreateBoard(ctx, ws, msg, workingDir, permission) {
+    if (denyIfViewOnly(ctx, ws, permission))
+        return;
+    const pmDir = resolvePmDir(workingDir);
+    if (!pmDir) {
+        ctx.send(ws, { type: 'planError', data: { error: 'No PM directory found' } });
+        return;
+    }
+    const fullState = parsePlanDirectory(workingDir);
+    if (!fullState)
+        return;
+    const boardId = getNextBoardId(fullState.boards);
+    const boardNum = getNextBoardNumber(fullState.boards);
+    const title = msg.data?.title || `Board ${boardNum}`;
+    const goal = msg.data?.goal || '';
+    const boardDir = join(pmDir, 'boards', boardId);
+    // Create directory structure
+    for (const dir of ['backlog', 'out', 'reviews']) {
+        mkdirSync(join(boardDir, dir), { recursive: true });
+    }
+    // Create board.md
+    const today = new Date().toISOString().split('T')[0];
+    writeFileSync(join(boardDir, 'board.md'), `---
+id: ${boardId}
+title: "${title.replace(/"/g, '\\"')}"
+status: draft
+created: "${today}"
+completed_at: null
+goal: "${goal.replace(/"/g, '\\"')}"
+---
+
+# ${title}
+
+## Goal
+${goal}
+
+## Notes
+`, 'utf-8');
+    // Create STATE.md
+    writeFileSync(join(boardDir, 'STATE.md'), `---
+project: ../../project.md
+board: board.md
+paused: false
+---
+
+# Board State
+
+## Ready to Work
+
+## In Progress
+
+## Blocked
+
+## Recently Completed
+
+## Warnings
+`, 'utf-8');
+    // Create progress.md
+    writeFileSync(join(boardDir, 'progress.md'), '# Board Progress\n', 'utf-8');
+    // Update workspace.json
+    const wsPath = join(pmDir, 'workspace.json');
+    if (!existsSync(wsPath)) {
+        writeFileSync(wsPath, JSON.stringify({ activeBoardId: null, boardOrder: [] }, null, 2), 'utf-8');
+    }
+    const workspaceContent = readFileSync(wsPath, 'utf-8');
+    const workspace = JSON.parse(workspaceContent);
+    workspace.boardOrder.push(boardId);
+    if (!workspace.activeBoardId) {
+        workspace.activeBoardId = boardId;
+    }
+    writeFileSync(join(pmDir, 'workspace.json'), JSON.stringify(workspace, null, 2), 'utf-8');
+    const boardState = parseBoardDirectory(pmDir, boardId);
+    if (boardState) {
+        ctx.broadcastToAll({ type: 'planBoardCreated', data: boardState.board });
+        ctx.broadcastToAll({ type: 'planWorkspaceUpdated', data: workspace });
+    }
+}
+function handleUpdateBoard(ctx, ws, msg, workingDir, permission) {
+    if (denyIfViewOnly(ctx, ws, permission))
+        return;
+    const { boardId, fields } = msg.data || {};
+    if (!boardId || !fields) {
+        ctx.send(ws, { type: 'planError', data: { error: 'Board ID and fields required' } });
+        return;
+    }
+    const pmDir = resolvePmDir(workingDir);
+    if (!pmDir)
+        return;
+    const boardMdPath = join(pmDir, 'boards', boardId, 'board.md');
+    if (!existsSync(boardMdPath)) {
+        ctx.send(ws, { type: 'planError', data: { error: `Board not found: ${boardId}` } });
+        return;
+    }
+    let content = readFileSync(boardMdPath, 'utf-8');
+    for (const [key, value] of Object.entries(fields)) {
+        const yamlKey = key.replace(/([A-Z])/g, '_$1').toLowerCase();
+        content = replaceFrontMatterField(content, yamlKey, formatYamlValue(value));
+    }
+    writeFileSync(boardMdPath, content, 'utf-8');
+    const boardState = parseBoardDirectory(pmDir, boardId);
+    if (boardState) {
+        ctx.broadcastToAll({ type: 'planBoardUpdated', data: boardState.board });
+    }
+}
+function handleArchiveBoard(ctx, ws, msg, workingDir, permission) {
+    if (denyIfViewOnly(ctx, ws, permission))
+        return;
+    const boardId = msg.data?.boardId;
+    if (!boardId) {
+        ctx.send(ws, { type: 'planError', data: { error: 'Board ID required' } });
+        return;
+    }
+    const pmDir = resolvePmDir(workingDir);
+    if (!pmDir)
+        return;
+    const boardMdPath = join(pmDir, 'boards', boardId, 'board.md');
+    if (!existsSync(boardMdPath)) {
+        ctx.send(ws, { type: 'planError', data: { error: `Board not found: ${boardId}` } });
+        return;
+    }
+    // Set status to archived
+    let content = readFileSync(boardMdPath, 'utf-8');
+    content = replaceFrontMatterField(content, 'status', 'archived');
+    writeFileSync(boardMdPath, content, 'utf-8');
+    // Remove from workspace.json boardOrder and update activeBoardId if needed
+    const workspacePath = join(pmDir, 'workspace.json');
+    if (existsSync(workspacePath)) {
+        const workspace = JSON.parse(readFileSync(workspacePath, 'utf-8'));
+        workspace.boardOrder = workspace.boardOrder.filter(id => id !== boardId);
+        if (workspace.activeBoardId === boardId) {
+            workspace.activeBoardId = workspace.boardOrder[0] || null;
+        }
+        writeFileSync(workspacePath, JSON.stringify(workspace, null, 2), 'utf-8');
+        ctx.broadcastToAll({ type: 'planWorkspaceUpdated', data: workspace });
+    }
+    const boardState = parseBoardDirectory(pmDir, boardId);
+    if (boardState) {
+        ctx.broadcastToAll({ type: 'planBoardArchived', data: boardState.board });
+    }
+}
+function handleGetBoard(ctx, ws, msg, workingDir) {
+    const boardId = msg.data?.boardId;
+    if (!boardId) {
+        ctx.send(ws, { type: 'planError', data: { error: 'Board ID required' } });
+        return;
+    }
+    const pmDir = resolvePmDir(workingDir);
+    if (!pmDir)
+        return;
+    const boardState = parseBoardDirectory(pmDir, boardId);
+    if (!boardState) {
+        ctx.send(ws, { type: 'planError', data: { error: `Board not found: ${boardId}` } });
+        return;
+    }
+    ctx.send(ws, { type: 'planBoardState', data: boardState });
+}
+function handleGetBoardState(ctx, ws, msg, workingDir) {
+    handleGetBoard(ctx, ws, msg, workingDir);
+}
+function handleReorderBoards(ctx, ws, msg, workingDir, permission) {
+    if (denyIfViewOnly(ctx, ws, permission))
+        return;
+    const boardOrder = msg.data?.boardOrder;
+    if (!Array.isArray(boardOrder)) {
+        ctx.send(ws, { type: 'planError', data: { error: 'boardOrder array required' } });
+        return;
+    }
+    const pmDir = resolvePmDir(workingDir);
+    if (!pmDir)
+        return;
+    const workspacePath = join(pmDir, 'workspace.json');
+    if (!existsSync(workspacePath))
+        return;
+    const workspace = JSON.parse(readFileSync(workspacePath, 'utf-8'));
+    workspace.boardOrder = boardOrder;
+    writeFileSync(workspacePath, JSON.stringify(workspace, null, 2), 'utf-8');
+    ctx.broadcastToAll({ type: 'planWorkspaceUpdated', data: workspace });
+}
+function handleSetActiveBoard(ctx, ws, msg, workingDir, permission) {
+    if (denyIfViewOnly(ctx, ws, permission))
+        return;
+    const boardId = msg.data?.boardId;
+    if (!boardId) {
+        ctx.send(ws, { type: 'planError', data: { error: 'Board ID required' } });
+        return;
+    }
+    const pmDir = resolvePmDir(workingDir);
+    if (!pmDir)
+        return;
+    const workspacePath = join(pmDir, 'workspace.json');
+    if (!existsSync(workspacePath))
+        return;
+    const workspace = JSON.parse(readFileSync(workspacePath, 'utf-8'));
+    workspace.activeBoardId = boardId;
+    writeFileSync(workspacePath, JSON.stringify(workspace, null, 2), 'utf-8');
+    ctx.broadcastToAll({ type: 'planWorkspaceUpdated', data: workspace });
+    // Also send the active board's full state
+    const boardState = parseBoardDirectory(pmDir, boardId);
+    if (boardState) {
+        ctx.send(ws, { type: 'planBoardState', data: boardState });
+    }
+}
+function handleGetBoardArtifacts(ctx, ws, msg, workingDir) {
+    const boardId = msg.data?.boardId;
+    if (!boardId) {
+        ctx.send(ws, { type: 'planError', data: { error: 'Board ID required' } });
+        return;
+    }
+    const artifacts = parseBoardArtifacts(workingDir, boardId);
+    if (!artifacts) {
+        ctx.send(ws, { type: 'planBoardArtifacts', data: { boardId, progressLog: '', outputFiles: [], reviewResults: [] } });
+        return;
+    }
+    ctx.send(ws, { type: 'planBoardArtifacts', data: artifacts });
+}
+// ============================================================================
+// Sprint lifecycle handlers (legacy — kept for backward compatibility)
+// ============================================================================
+function buildSprintMarkdown(id, title, goal, start, end, issueRefs) {
+    const issuesYaml = issueRefs.length > 0
+        ? `\n${issueRefs.map(p => `  - ${p}`).join('\n')}`
+        : ' []';
+    return `---
+id: ${id}
+title: "${title.replace(/"/g, '\\"')}"
+status: planned
+start: "${start}"
+end: "${end}"
+goal: "${goal.replace(/"/g, '\\"')}"
+capacity: null
+committed: null
+completed: null
+completed_at: null
+issues:${issuesYaml}
+---
+
+# ${id}: ${title}
+
+## Sprint Goal
+${goal}
+
+## Issues
+| Issue | Title | Points | Status |
+|---|---|---|---|
+`;
+}
+/** Assign issues to a sprint by updating their front matter sprint field. */
+function assignIssuesToSprint(workingDir, issues, issueIds, sprintPath) {
+    for (const issueId of issueIds) {
+        const issue = issues.find(i => i.id === issueId);
+        if (!issue)
+            continue;
+        const fullPath = resolvePlanPath(workingDir, issue.path);
+        if (!fullPath || !existsSync(fullPath))
+            continue;
+        const content = replaceFrontMatterField(readFileSync(fullPath, 'utf-8'), 'sprint', sprintPath);
+        writeFileSync(fullPath, content, 'utf-8');
+    }
+}
+function handleCreateSprint(ctx, ws, msg, workingDir, permission) {
+    if (denyIfViewOnly(ctx, ws, permission))
+        return;
+    const { title, goal = '', start = '', end = '', issueIds = [] } = msg.data || {};
+    if (!title) {
+        ctx.send(ws, { type: 'planError', data: { error: 'Sprint title required' } });
+        return;
+    }
+    const pmDir = resolvePmDir(workingDir) ?? defaultPmDir(workingDir);
+    const sprintsDir = join(pmDir, 'sprints');
+    if (!existsSync(sprintsDir))
+        mkdirSync(sprintsDir, { recursive: true });
+    const fullState = parsePlanDirectory(workingDir);
+    const id = fullState ? getNextSprintId(fullState.sprints) : 'SPRINT-001';
+    const issueRefs = issueIds.map((issueId) => {
+        const issue = fullState?.issues.find(i => i.id === issueId);
+        return issue ? issue.path : `backlog/${issueId}.md`;
+    });
+    writeFileSync(join(sprintsDir, `${id}.md`), buildSprintMarkdown(id, title, goal, start, end, issueRefs), 'utf-8');
+    const sandboxDir = join(sprintsDir, id);
+    mkdirSync(join(sandboxDir, 'out'), { recursive: true });
+    mkdirSync(join(sandboxDir, 'reviews'), { recursive: true });
+    writeFileSync(join(sandboxDir, 'progress.md'), `# ${id}: ${title} — Progress Log\n`, 'utf-8');
+    if (issueRefs.length > 0 && fullState) {
+        assignIssuesToSprint(workingDir, fullState.issues, issueIds, `sprints/${id}.md`);
+    }
+    const sprint = parseSingleSprint(workingDir, `sprints/${id}.md`);
+    ctx.broadcastToAll({ type: 'planSprintCreated', data: sprint });
+}
+/** Promote sprint issues from 'backlog' to 'todo' status. */
+function promoteSprintIssues(pmDir, sprint, allIssues) {
+    for (const issueSummary of sprint.issues) {
+        const issue = allIssues.find(i => i.id === issueSummary.id || i.path === issueSummary.path);
+        if (!issue || issue.status !== 'backlog')
+            continue;
+        const issuePath = join(pmDir, issue.path);
+        if (!existsSync(issuePath))
+            continue;
+        writeFileSync(issuePath, replaceFrontMatterField(readFileSync(issuePath, 'utf-8'), 'status', 'todo'), 'utf-8');
+    }
+}
+/** Update a file's front matter field if the file exists. */
+function updateFileField(filePath, field, value) {
+    if (!existsSync(filePath))
+        return;
+    writeFileSync(filePath, replaceFrontMatterField(readFileSync(filePath, 'utf-8'), field, value), 'utf-8');
+}
+function handleActivateSprint(ctx, ws, msg, workingDir, permission) {
+    if (denyIfViewOnly(ctx, ws, permission))
+        return;
+    const sprintId = msg.data?.sprintId;
+    if (!sprintId) {
+        ctx.send(ws, { type: 'planError', data: { error: 'Sprint ID required' } });
+        return;
+    }
+    const fullState = parsePlanDirectory(workingDir);
+    if (!fullState) {
+        ctx.send(ws, { type: 'planError', data: { error: 'No project found' } });
+        return;
+    }
+    const currentActive = fullState.sprints.find(s => s.status === 'active');
+    if (currentActive && currentActive.id !== sprintId) {
+        ctx.send(ws, { type: 'planError', data: { error: `Sprint ${currentActive.id} is already active. Complete it first.` } });
+        return;
+    }
+    const sprint = fullState.sprints.find(s => s.id === sprintId);
+    if (!sprint) {
+        ctx.send(ws, { type: 'planError', data: { error: `Sprint not found: ${sprintId}` } });
+        return;
+    }
+    const pmDir = resolvePmDir(workingDir);
+    if (!pmDir)
+        return;
+    updateFileField(join(pmDir, sprint.path), 'status', 'active');
+    updateFileField(join(pmDir, 'STATE.md'), 'current_sprint', `"${sprint.path}"`);
+    promoteSprintIssues(pmDir, sprint, fullState.issues);
+    const updatedSprint = parseSingleSprint(workingDir, sprint.path);
+    ctx.broadcastToAll({ type: 'planSprintUpdated', data: updatedSprint });
+    const updatedState = parsePlanDirectory(workingDir);
+    if (updatedState) {
+        ctx.broadcastToAll({ type: 'planStateUpdated', data: updatedState });
+    }
+}
+function handleCompleteSprint(ctx, ws, msg, workingDir, permission) {
+    if (denyIfViewOnly(ctx, ws, permission))
+        return;
+    const sprintId = msg.data?.sprintId;
+    if (!sprintId) {
+        ctx.send(ws, { type: 'planError', data: { error: 'Sprint ID required' } });
+        return;
+    }
+    const fullState = parsePlanDirectory(workingDir);
+    if (!fullState) {
+        ctx.send(ws, { type: 'planError', data: { error: 'No project found' } });
+        return;
+    }
+    const sprint = fullState.sprints.find(s => s.id === sprintId);
+    if (!sprint) {
+        ctx.send(ws, { type: 'planError', data: { error: `Sprint not found: ${sprintId}` } });
+        return;
+    }
+    const pmDir = resolvePmDir(workingDir);
+    if (!pmDir)
+        return;
+    const now = new Date().toISOString();
+    // Compute execution summary from sprint issues
+    const sprintIssues = fullState.issues.filter(i => i.sprint === sprint.path);
+    const completedIssues = sprintIssues.filter(i => i.status === 'done').length;
+    const failedIssues = sprintIssues.filter(i => i.status !== 'done' && i.status !== 'cancelled').length;
+    // Update sprint file with completion data
+    const sprintPath = join(pmDir, sprint.path);
+    if (existsSync(sprintPath)) {
+        let content = readFileSync(sprintPath, 'utf-8');
+        content = replaceFrontMatterField(content, 'status', 'completed');
+        content = replaceFrontMatterField(content, 'completed_at', `"${now}"`);
+        content = replaceFrontMatterField(content, 'completed', String(completedIssues));
+        // Write execution summary if not already present
+        if (!content.includes('execution_summary:')) {
+            const summaryYaml = [
+                'execution_summary:',
+                `  total_issues: ${sprintIssues.length}`,
+                `  completed_issues: ${completedIssues}`,
+                `  failed_issues: ${failedIssues}`,
+            ].join('\n');
+            // Insert before the closing --- of front matter (second occurrence)
+            const fmClose = content.indexOf('\n---', content.indexOf('---') + 3);
+            if (fmClose !== -1) {
+                content = `${content.slice(0, fmClose)}\n${summaryYaml}${content.slice(fmClose)}`;
+            }
+        }
+        writeFileSync(sprintPath, content, 'utf-8');
+    }
+    // Clear STATE.md current_sprint
+    const statePath = join(pmDir, 'STATE.md');
+    if (existsSync(statePath)) {
+        let stateContent = readFileSync(statePath, 'utf-8');
+        stateContent = replaceFrontMatterField(stateContent, 'current_sprint', 'null');
+        writeFileSync(statePath, stateContent, 'utf-8');
+    }
+    const updatedSprint = parseSingleSprint(workingDir, sprint.path);
+    ctx.broadcastToAll({ type: 'planSprintCompleted', data: updatedSprint });
+    // Refresh full state
+    const updatedState = parsePlanDirectory(workingDir);
+    if (updatedState) {
+        ctx.broadcastToAll({ type: 'planStateUpdated', data: updatedState });
+    }
+}
+function handleGetSprintArtifacts(ctx, ws, msg, workingDir) {
+    const sprintId = msg.data?.sprintId;
+    if (!sprintId) {
+        ctx.send(ws, { type: 'planError', data: { error: 'Sprint ID required' } });
+        return;
+    }
+    const artifacts = parseSprintArtifacts(workingDir, sprintId);
+    if (!artifacts) {
+        // Fall back to empty artifacts if sandbox dir doesn't exist yet
+        ctx.send(ws, { type: 'planSprintArtifacts', data: { sprintId, progressLog: '', outputFiles: [], reviewResults: [] } });
+        return;
+    }
+    ctx.send(ws, { type: 'planSprintArtifacts', data: artifacts });
+}
 //# sourceMappingURL=plan-handlers.js.map