mstro-app 0.3.8 → 0.4.0

package/dist/server/mcp/bouncer-cli.js

@@ -0,0 +1,54 @@
+#!/usr/bin/env node
+// Copyright (c) 2025-present Mstro, Inc. All rights reserved.
+// Licensed under the MIT License. See LICENSE file for details.
+import { reviewOperation } from './bouncer-integration.js';
+function buildOperation(toolName, toolInput) {
+    const prefix = `${toolName}: `;
+    if (toolName === 'Bash' && toolInput.command)
+        return prefix + String(toolInput.command);
+    if (toolName === 'Edit' && toolInput.file_path)
+        return prefix + String(toolInput.file_path);
+    if (toolName === 'Write' && toolInput.file_path)
+        return prefix + String(toolInput.file_path);
+    return prefix + JSON.stringify(toolInput).slice(0, 500);
+}
+async function evaluate(rawInput) {
+    if (!rawInput.trim()) {
+        return { decision: 'allow', reason: 'Empty input' };
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(rawInput);
+    }
+    catch {
+        return { decision: 'allow', reason: 'Invalid JSON input' };
+    }
+    const toolName = parsed.tool_name || parsed.toolName || 'unknown';
+    const toolInput = parsed.input || parsed.toolInput || {};
+    const request = {
+        operation: buildOperation(toolName, toolInput),
+        context: {
+            purpose: 'Tool use request from Claude Code hook',
+            workingDirectory: process.cwd(),
+            toolName,
+            toolInput,
+        },
+    };
+    const result = await reviewOperation(request);
+    return {
+        decision: result.decision === 'deny' ? 'deny' : 'allow',
+        reason: result.reasoning,
+    };
+}
+async function main() {
+    let rawInput = '';
+    for await (const chunk of process.stdin) {
+        rawInput += chunk;
+    }
+    const result = await evaluate(rawInput);
+    console.log(JSON.stringify(result));
+}
+main().catch(() => {
+    console.log(JSON.stringify({ decision: 'allow', reason: 'Bouncer crash' }));
+});
+//# sourceMappingURL=bouncer-cli.js.map

package/dist/server/mcp/bouncer-cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bouncer-cli.js","sourceRoot":"","sources":["../../../server/mcp/bouncer-cli.ts"],"names":[],"mappings":";AACA,8DAA8D;AAC9D,gEAAgE;AAiBhE,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAE3D,SAAS,cAAc,CAAC,QAAgB,EAAE,SAAkC;IAC1E,MAAM,MAAM,GAAG,GAAG,QAAQ,IAAI,CAAC;IAC/B,IAAI,QAAQ,KAAK,MAAM,IAAI,SAAS,CAAC,OAAO;QAAE,OAAO,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IACxF,IAAI,QAAQ,KAAK,MAAM,IAAI,SAAS,CAAC,SAAS;QAAE,OAAO,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;IAC5F,IAAI,QAAQ,KAAK,OAAO,IAAI,SAAS,CAAC,SAAS;QAAE,OAAO,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7F,OAAO,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AAC1D,CAAC;AAED,KAAK,UAAU,QAAQ,CAAC,QAAgB;IACtC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC;QACrB,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC;IACtD,CAAC;IAED,IAAI,MAAuH,CAAC;IAC5H,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAChC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,oBAAoB,EAAE,CAAC;IAC7D,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,CAAC,SAAS,IAAI,MAAM,CAAC,QAAQ,IAAI,SAAS,CAAC;IAClE,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,SAAS,IAAI,EAAE,CAAC;IAEzD,MAAM,OAAO,GAAyB;QACpC,SAAS,EAAE,cAAc,CAAC,QAAQ,EAAE,SAAS,CAAC;QAC9C,OAAO,EAAE;YACP,OAAO,EAAE,wCAAwC;YACjD,gBAAgB,EAAE,OAAO,CAAC,GAAG,EAAE;YAC/B,QAAQ;YACR,SAAS;SACV;KACF,CAAC;IAEF,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,OAAO,CAAC,CAAC;IAC9C,OAAO;QACL,QAAQ,EAAE,MAAM,CAAC,QAAQ,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO;QACvD,MAAM,EAAE,MAAM,CAAC,SAAS;KACzB,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,IAAI,QAAQ,GAAG,EAAE,CAAC;IAClB,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QACxC,QAAQ,IAAI,KAAK,CAAC;IACpB,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACxC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;AACtC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE;IAChB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC,CAAC,CAAC;AAC9E,CAAC,CAAC,CAAC"}

package/dist/server/services/plan/composer.d.ts

@@ -0,0 +1,4 @@
+import type { HandlerContext } from '../websocket/handler-context.js';
+import type { WSContext } from '../websocket/types.js';
+export declare function handlePlanPrompt(ctx: HandlerContext, ws: WSContext, userPrompt: string, workingDir: string): Promise<void>;
+//# sourceMappingURL=composer.d.ts.map

package/dist/server/services/plan/composer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"composer.d.ts","sourceRoot":"","sources":["../../../../server/services/plan/composer.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAkDvD,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,cAAc,EACnB,EAAE,EAAE,SAAS,EACb,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CA+Hf"}

package/dist/server/services/plan/composer.js

@@ -0,0 +1,181 @@
+// Copyright (c) 2025-present Mstro, Inc. All rights reserved.
+// Licensed under the MIT License. See LICENSE file for details.
+/**
+ * Plan Composer — Handles natural language prompts for PPS creation/editing.
+ *
+ * When a planPrompt message arrives, this builds a context-enriched prompt
+ * against the .pm/ (or legacy .plan/) directory and spawns a scoped
+ * HeadlessRunner session to execute it.
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { runWithFileLogger } from '../../cli/headless/headless-logger.js';
+import { HeadlessRunner } from '../../cli/headless/index.js';
+import { getNextId, parsePlanDirectory, resolvePmDir } from './parser.js';
+const PROMPT_TOOL_MESSAGES = {
+    Glob: 'Discovering project files...',
+    Read: 'Reading project structure...',
+    Grep: 'Searching codebase...',
+    Write: 'Creating project files...',
+    Edit: 'Updating project files...',
+    Bash: 'Running commands...',
+};
+function getPromptToolCompleteMessage(event) {
+    const input = event.completeInput;
+    if (!input)
+        return null;
+    if (event.toolName === 'Write' && input.file_path) {
+        const filename = String(input.file_path).split('/').pop() ?? '';
+        return `Created ${filename}`;
+    }
+    if (event.toolName === 'Edit' && input.file_path) {
+        const filename = String(input.file_path).split('/').pop() ?? '';
+        return `Updated ${filename}`;
+    }
+    if (event.toolName === 'Read' && input.file_path) {
+        return `Read ${String(input.file_path).split('/').slice(-2).join('/')}`;
+    }
+    return null;
+}
+function createPromptProgressTracker() {
+    const seenToolStarts = new Set();
+    return (event) => {
+        if (event.type === 'tool_start' && event.toolName) {
+            if (seenToolStarts.has(event.toolName))
+                return null;
+            seenToolStarts.add(event.toolName);
+            return PROMPT_TOOL_MESSAGES[event.toolName] ?? null;
+        }
+        if (event.type === 'tool_complete')
+            return getPromptToolCompleteMessage(event);
+        return null;
+    };
+}
+function readFileOrEmpty(path) {
+    try {
+        if (existsSync(path))
+            return readFileSync(path, 'utf-8');
+    }
+    catch { /* skip */ }
+    return '';
+}
+export async function handlePlanPrompt(ctx, ws, userPrompt, workingDir) {
+    const pmDir = resolvePmDir(workingDir) ?? join(workingDir, '.pm');
+    const stateContent = readFileOrEmpty(join(pmDir, 'STATE.md'));
+    const projectContent = readFileOrEmpty(join(pmDir, 'project.md'));
+    // Compute next available IDs
+    const fullState = parsePlanDirectory(workingDir);
+    let idInfo = '';
+    if (fullState) {
+        const nextIS = getNextId(fullState.issues, 'IS');
+        const nextBG = getNextId(fullState.issues, 'BG');
+        const nextEP = getNextId(fullState.issues, 'EP');
+        idInfo = `Next available IDs: ${nextIS}, ${nextBG}, ${nextEP}`;
+    }
+    // Read existing epic files to provide context
+    let epicContext = '';
+    if (fullState) {
+        const existingEpics = fullState.issues.filter((i) => i.type === 'epic');
+        if (existingEpics.length > 0) {
+            epicContext = `\nExisting epics:\n${existingEpics.map((e) => `- ${e.id}: ${e.title} (${e.path}, children: ${e.children.length})`).join('\n')}\n`;
+        }
+    }
+    const enrichedPrompt = `You are managing a project in the .pm/ directory format (Project Plan Spec).
+The project's current state is:
+
+<state>
+${stateContent || 'No STATE.md exists yet'}
+</state>
+
+<project>
+${projectContent || 'No project.md yet'}
+</project>
+
+${idInfo}
+${epicContext}
+
+Follow these rules:
+- When creating .pm/ files, use YAML front matter + markdown body
+- When modifying issues, preserve all existing YAML fields you don't change
+- After any state change, update STATE.md to reflect the new status
+- Use the next available ID for new entities
+- Respond briefly describing what you did
+
+Issue scoping rules (critical for execution quality):
+- Each issue is executed by a single AI agent with its own context window
+- Issues estimated at 1-3 story points execute well (focused, single concern)
+- Issues at 5 story points are viable if scoped to one subsystem
+- Issues at 8+ story points MUST be decomposed into smaller sub-issues
+- Issues at 13+ story points MUST become an epic with child issues
+- Each issue should touch one logical concern (one component, one service, one data flow)
+- If an issue requires work across multiple subsystems, split it into one issue per subsystem with blocked_by edges between them
+- Research/investigation issues should be separate from implementation issues
+
+Epic creation rules (when user asks for a feature with sub-tasks or an epic):
+- Create an EP-*.md file in .pm/backlog/ with type: epic and a children: [] field in front matter
+- Create individual IS-*.md (or BG-*.md) files for each child issue
+- Each child issue must have epic: backlog/EP-XXX.md in its front matter
+- The epic's children field must list all child paths: [backlog/IS-001.md, backlog/IS-002.md, ...]
+- Set blocked_by between child issues where there are natural dependencies
+- Give each child issue clear acceptance criteria and files to modify when possible
+- Set appropriate priorities (P0-P3) based on the issue's importance within the epic
+
+User request: ${userPrompt}`;
+    try {
+        ctx.broadcastToAll({
+            type: 'planPromptProgress',
+            data: { message: 'Starting project planning...' },
+        });
+        const runner = new HeadlessRunner({
+            workingDir,
+            directPrompt: enrichedPrompt,
+            outputCallback: (text) => {
+                ctx.send(ws, {
+                    type: 'planPromptStreaming',
+                    data: { token: text },
+                });
+            },
+            toolUseCallback: (() => {
+                const getProgressMessage = createPromptProgressTracker();
+                return (event) => {
+                    const message = getProgressMessage(event);
+                    if (message) {
+                        ctx.broadcastToAll({
+                            type: 'planPromptProgress',
+                            data: { message },
+                        });
+                    }
+                };
+            })(),
+        });
+        ctx.broadcastToAll({
+            type: 'planPromptProgress',
+            data: { message: 'Claude is planning your project...' },
+        });
+        const result = await runWithFileLogger('pm-compose', () => runner.run());
+        ctx.broadcastToAll({
+            type: 'planPromptProgress',
+            data: { message: 'Finalizing project plan...' },
+        });
+        ctx.send(ws, {
+            type: 'planPromptResponse',
+            data: {
+                response: result.completed ? 'Prompt executed successfully.' : (result.error || 'Unknown error'),
+                success: result.completed,
+                error: result.error || null,
+            },
+        });
+        // Re-parse and broadcast updated state
+        const updatedState = parsePlanDirectory(workingDir);
+        if (updatedState) {
+            ctx.broadcastToAll({ type: 'planStateUpdated', data: updatedState });
+        }
+    }
+    catch (error) {
+        ctx.send(ws, {
+            type: 'planError',
+            data: { error: error instanceof Error ? error.message : String(error) },
+        });
+    }
+}
+//# sourceMappingURL=composer.js.map

package/dist/server/services/plan/composer.js.map

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

package/dist/server/services/plan/dependency-resolver.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Dependency Resolver — Validates and computes the dependency DAG.
+ *
+ * Builds adjacency list from blocked_by/blocks fields, detects cycles,
+ * and computes the "ready to work" set.
+ */
+import type { Issue } from './types.js';
+/**
+ * Detect cycles in the dependency graph.
+ * Returns the first cycle found as an array of issue IDs, or null if acyclic.
+ */
+export declare function detectCycles(issues: Issue[]): string[] | null;
+/**
+ * Compute the set of issues that are ready to work on.
+ * An issue is ready if:
+ * - It's not an epic
+ * - Its status is backlog or todo (not started, done, or cancelled)
+ * - All its blocked_by items are done or cancelled
+ *
+ * If epicScope is provided, only returns issues belonging to that epic.
+ */
+export declare function resolveReadyToWork(issues: Issue[], epicScope?: string): Issue[];
+/**
+ * Compute the critical path through incomplete issues.
+ * Returns the longest chain of dependent issues.
+ */
+export declare function computeCriticalPath(issues: Issue[]): Issue[];
+//# sourceMappingURL=dependency-resolver.d.ts.map

package/dist/server/services/plan/dependency-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependency-resolver.d.ts","sourceRoot":"","sources":["../../../../server/services/plan/dependency-resolver.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC;;;GAGG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,EAAE,GAAG,IAAI,CAsB7D;AAuCD;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,KAAK,EAAE,CA+C/E;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,EAAE,CA0C5D"}

package/dist/server/services/plan/dependency-resolver.js

@@ -0,0 +1,154 @@
+// Copyright (c) 2025-present Mstro, Inc. All rights reserved.
+// Licensed under the MIT License. See LICENSE file for details.
+/**
+ * Detect cycles in the dependency graph.
+ * Returns the first cycle found as an array of issue IDs, or null if acyclic.
+ */
+export function detectCycles(issues) {
+    const issueByPath = new Map();
+    for (const issue of issues) {
+        issueByPath.set(issue.path, issue);
+    }
+    // DFS with coloring: 0=white, 1=gray, 2=black
+    const color = new Map();
+    const parent = new Map();
+    for (const issue of issues) {
+        color.set(issue.path, 0);
+    }
+    for (const issue of issues) {
+        if (color.get(issue.path) === 0) {
+            const cycle = dfs(issue.path, issueByPath, color, parent);
+            if (cycle)
+                return cycle;
+        }
+    }
+    return null;
+}
+function dfs(path, issueByPath, color, parent) {
+    color.set(path, 1); // Gray
+    const issue = issueByPath.get(path);
+    if (!issue) {
+        color.set(path, 2);
+        return null;
+    }
+    for (const dep of issue.blocks) {
+        if (!issueByPath.has(dep))
+            continue;
+        const depColor = color.get(dep);
+        if (depColor === 1) {
+            // Found cycle — reconstruct
+            const cycle = [dep, path];
+            let cur = path;
+            while (parent.has(cur) && parent.get(cur) !== dep) {
+                cur = parent.get(cur);
+                cycle.push(cur);
+            }
+            return cycle.map(p => issueByPath.get(p)?.id || p);
+        }
+        if (depColor === 0) {
+            parent.set(dep, path);
+            const cycle = dfs(dep, issueByPath, color, parent);
+            if (cycle)
+                return cycle;
+        }
+    }
+    color.set(path, 2); // Black
+    return null;
+}
+/**
+ * Compute the set of issues that are ready to work on.
+ * An issue is ready if:
+ * - It's not an epic
+ * - Its status is backlog or todo (not started, done, or cancelled)
+ * - All its blocked_by items are done or cancelled
+ *
+ * If epicScope is provided, only returns issues belonging to that epic.
+ */
+export function resolveReadyToWork(issues, epicScope) {
+    const issueByPath = new Map();
+    for (const issue of issues) {
+        issueByPath.set(issue.path, issue);
+    }
+    const readyStatuses = new Set(['backlog', 'todo']);
+    const doneStatuses = new Set(['done', 'cancelled']);
+    const priorityOrder = { P0: 0, P1: 1, P2: 2, P3: 3 };
+    // Build set of child paths for epic scoping
+    let epicChildPaths = null;
+    if (epicScope) {
+        const epic = issueByPath.get(epicScope);
+        if (epic) {
+            epicChildPaths = new Set(epic.children);
+            // Also include issues that reference this epic via their epic field
+            for (const issue of issues) {
+                if (issue.epic === epicScope)
+                    epicChildPaths.add(issue.path);
+            }
+        }
+    }
+    return issues
+        .filter(issue => {
+        if (issue.type === 'epic')
+            return false;
+        if (!readyStatuses.has(issue.status))
+            return false;
+        // If scoped to an epic, only include that epic's children
+        if (epicChildPaths && !epicChildPaths.has(issue.path))
+            return false;
+        // Check all blockers are resolved
+        if (issue.blockedBy.length > 0) {
+            const allResolved = issue.blockedBy.every(bp => {
+                const blocker = issueByPath.get(bp);
+                return blocker && doneStatuses.has(blocker.status);
+            });
+            if (!allResolved)
+                return false;
+        }
+        return true;
+    })
+        .sort((a, b) => {
+        // Sort by priority (P0 first)
+        return (priorityOrder[a.priority] ?? 9) - (priorityOrder[b.priority] ?? 9);
+    });
+}
+/**
+ * Compute the critical path through incomplete issues.
+ * Returns the longest chain of dependent issues.
+ */
+export function computeCriticalPath(issues) {
+    const issueByPath = new Map();
+    for (const issue of issues) {
+        issueByPath.set(issue.path, issue);
+    }
+    const doneStatuses = new Set(['done', 'cancelled']);
+    const incompleteIssues = issues.filter(i => !doneStatuses.has(i.status) && i.type !== 'epic');
+    // Compute longest path using DFS with memoization
+    const longestFrom = new Map();
+    function getLongest(path) {
+        if (longestFrom.has(path))
+            return longestFrom.get(path);
+        const issue = issueByPath.get(path);
+        if (!issue || doneStatuses.has(issue.status)) {
+            longestFrom.set(path, []);
+            return [];
+        }
+        // Set sentinel before recursing to break cycles
+        longestFrom.set(path, [issue]);
+        let best = [];
+        for (const dep of issue.blocks) {
+            const sub = getLongest(dep);
+            if (sub.length > best.length)
+                best = sub;
+        }
+        const result = [issue, ...best];
+        longestFrom.set(path, result);
+        return result;
+    }
+    let criticalPath = [];
+    for (const issue of incompleteIssues) {
+        const path = getLongest(issue.path);
+        if (path.length > criticalPath.length)
+            criticalPath = path;
+    }
+    return criticalPath;
+}
+//# sourceMappingURL=dependency-resolver.js.map

package/dist/server/services/plan/dependency-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependency-resolver.js","sourceRoot":"","sources":["../../../../server/services/plan/dependency-resolver.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAC9D,gEAAgE;AAWhE;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,MAAe;IAC1C,MAAM,WAAW,GAAG,IAAI,GAAG,EAAiB,CAAC;IAC7C,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACrC,CAAC;IAED,8CAA8C;IAC9C,MAAM,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAC;IACxC,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;IAEzC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IAC3B,CAAC;IAED,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YAChC,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;YAC1D,IAAI,KAAK;gBAAE,OAAO,KAAK,CAAC;QAC1B,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,GAAG,CACV,IAAY,EACZ,WAA+B,EAC/B,KAA0B,EAC1B,MAA2B;IAE3B,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO;IAC3B,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACpC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QACnB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;QAC/B,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,SAAS;QACpC,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAChC,IAAI,QAAQ,KAAK,CAAC,EAAE,CAAC;YACnB,4BAA4B;YAC5B,MAAM,KAAK,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YAC1B,IAAI,GAAG,GAAG,IAAI,CAAC;YACf,OAAO,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,GAAG,EAAE,CAAC;gBAClD,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAE,CAAC;gBACvB,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAClB,CAAC;YACD,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC;QACrD,CAAC;QACD,IAAI,QAAQ,KAAK,CAAC,EAAE,CAAC;YACnB,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YACtB,MAAM,KAAK,GAAG,GAAG,CAAC,GAAG,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;YACnD,IAAI,KAAK;gBAAE,OAAO,KAAK,CAAC;QAC1B,CAAC;IACH,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ;IAC5B,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAe,EAAE,SAAkB;IACpE,MAAM,WAAW,GAAG,IAAI,GAAG,EAAiB,CAAC;IAC7C,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACrC,CAAC;IAED,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;IACnD,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC;IAEpD,MAAM,aAAa,GAA2B,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC;IAE7E,4CAA4C;IAC5C,IAAI,cAAc,GAAuB,IAAI,CAAC;IAC9C,IAAI,SAAS,EAAE,CAAC;QACd,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACxC,IAAI,IAAI,EAAE,CAAC;YACT,cAAc,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACxC,oEAAoE;YACpE,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;gBAC3B,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS;oBAAE,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC/D,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,MAAM;SACV,MAAM,CAAC,KAAK,CAAC,EAAE;QACd,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM;YAAE,OAAO,KAAK,CAAC;QACxC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC;YAAE,OAAO,KAAK,CAAC;QAEnD,0DAA0D;QAC1D,IAAI,cAAc,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC;YAAE,OAAO,KAAK,CAAC;QAEpE,kCAAkC;QAClC,IAAI,KAAK,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC/B,MAAM,WAAW,GAAG,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE;gBAC7C,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBACpC,OAAO,OAAO,IAAI,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YACrD,CAAC,CAAC,CAAC;YACH,IAAI,CAAC,WAAW;gBAAE,OAAO,KAAK,CAAC;QACjC,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC,CAAC;SACD,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACb,8BAA8B;QAC9B,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;IAC7E,CAAC,CAAC,CAAC;AACP,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAe;IACjD,MAAM,WAAW,GAAG,IAAI,GAAG,EAAiB,CAAC;IAC7C,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACrC,CAAC;IAED,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC;IACpD,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC;IAE9F,kDAAkD;IAClD,MAAM,WAAW,GAAG,IAAI,GAAG,EAAmB,CAAC;IAE/C,SAAS,UAAU,CAAC,IAAY;QAC9B,IAAI,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,OAAO,WAAW,CAAC,GAAG,CAAC,IAAI,CAAE,CAAC;QAEzD,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACpC,IAAI,CAAC,KAAK,IAAI,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;YAC7C,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAC1B,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,gDAAgD;QAChD,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;QAE/B,IAAI,IAAI,GAAY,EAAE,CAAC;QACvB,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;YAC/B,MAAM,GAAG,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;YAC5B,IAAI,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM;gBAAE,IAAI,GAAG,GAAG,CAAC;QAC3C,CAAC;QAED,MAAM,MAAM,GAAG,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,CAAC;QAChC,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC9B,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,IAAI,YAAY,GAAY,EAAE,CAAC;IAC/B,KAAK,MAAM,KAAK,IAAI,gBAAgB,EAAE,CAAC;QACrC,MAAM,IAAI,GAAG,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACpC,IAAI,IAAI,CAAC,MAAM,GAAG,YAAY,CAAC,MAAM;YAAE,YAAY,GAAG,IAAI,CAAC;IAC7D,CAAC;IAED,OAAO,YAAY,CAAC;AACtB,CAAC"}

package/dist/server/services/plan/executor.d.ts

@@ -0,0 +1,110 @@
+/**
+ * Plan Executor — Wave-based execution with Claude Code Agent Teams.
+ *
+ * Reads the dependency DAG from .pm/, picks ALL unblocked issues per wave,
+ * spawns a coordinator Claude session that uses Agent Teams to execute them
+ * in parallel, then reconciles state and repeats for newly-unblocked issues.
+ */
+import { EventEmitter } from 'node:events';
+export type ExecutionStatus = 'idle' | 'starting' | 'executing' | 'paused' | 'stopping' | 'complete' | 'error';
+export interface ExecutionMetrics {
+    issuesCompleted: number;
+    issuesAttempted: number;
+    totalDuration: number;
+    currentIssueId: string | null;
+    /** IDs of issues being executed in the current wave */
+    currentWaveIds: string[];
+}
+export declare class PlanExecutor extends EventEmitter {
+    private status;
+    private workingDir;
+    private shouldStop;
+    private shouldPause;
+    private epicScope;
+    private metrics;
+    constructor(workingDir: string);
+    getStatus(): ExecutionStatus;
+    getMetrics(): ExecutionMetrics;
+    startEpic(epicPath: string): Promise<void>;
+    start(): Promise<void>;
+    pause(): void;
+    stop(): void;
+    resume(): Promise<void>;
+    private executeWave;
+    /**
+     * After a wave, check each issue's status on disk.
+     * `status: done` in issue front matter is the single completion signal.
+     * Output doc existence is NOT used as a proxy — code-focused issues
+     * (bug fixes, refactors) don't produce docs but are still valid completions.
+     */
+    private reconcileWaveResults;
+    private pickReadyIssues;
+    /**
+     * Build the team lead prompt for a wave of issues.
+     * Uses Agent Teams for true parallel execution as separate processes —
+     * each teammate gets its own context window and sends idle notifications
+     * when done. The team is created implicitly by the first Agent(team_name=...) call.
+     */
+    private buildCoordinatorPrompt;
+    /**
+     * Revert issues that stayed in_progress after a failed wave.
+     */
+    private revertIncompleteIssues;
+    /** Saved content of any pre-existing .claude/settings.json so we can restore it */
+    private savedClaudeSettings;
+    private claudeSettingsInstalled;
+    /**
+     * Pre-approve tools in project .claude/settings.json so Agent Teams
+     * teammates can work without interactive permission prompts.
+     * Teammates are separate processes that inherit the lead's permission
+     * settings. Without pre-approved tools, they hit interactive prompts
+     * that can't be answered in headless/background mode (known bug #25254).
+     */
+    private installTeammatePermissions;
+    /**
+     * Restore original .claude/settings.json after wave execution.
+     */
+    private uninstallTeammatePermissions;
+    /** Saved content of any pre-existing .mcp.json so we can restore it */
+    private savedMcpJson;
+    private mcpJsonInstalled;
+    /**
+     * Write .mcp.json in the working directory so Agent Teams teammates
+     * (separate processes) auto-discover the bouncer MCP server.
+     * This is essential — teammates don't inherit --mcp-config or
+     * --permission-prompt-tool from the team lead. .mcp.json project-level
+     * discovery + global PreToolUse hooks are the two bouncer paths for teammates.
+     *
+     * Also generates ~/.mstro/mcp-config.json for the team lead (--mcp-config).
+     */
+    private installBouncerForSubagents;
+    /**
+     * Restore or remove .mcp.json after execution.
+     */
+    private uninstallBouncerForSubagents;
+    /**
+     * Resolve the canonical output path for an issue in .pm/out/.
+     * This is the PM system's internal execution artifact — always under
+     * PM control. User-facing delivery to output_file happens via publishOutputs().
+     */
+    private resolveOutputPath;
+    /**
+     * List existing execution output docs in .pm/out/.
+     * Single canonical location — no split-brain lookup.
+     */
+    private listExistingDocs;
+    /**
+     * Copy confirmed-done outputs from .pm/out/ to user-specified output_file paths.
+     * Only copies for issues that completed successfully and have output_file set.
+     * Failures are non-fatal — the canonical artifact in .pm/out/ is always safe.
+     */
+    private publishOutputs;
+    private slugify;
+    private updateIssueFrontMatter;
+    /**
+     * Append a progress log entry after a wave completes.
+     * Re-reads issue files from disk to determine which actually completed.
+     */
+    private appendProgressEntry;
+}
+//# sourceMappingURL=executor.d.ts.map

package/dist/server/services/plan/executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../../../server/services/plan/executor.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAW3C,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,UAAU,GAAG,WAAW,GAAG,QAAQ,GAAG,UAAU,GAAG,UAAU,GAAG,OAAO,CAAC;AAE/G,MAAM,WAAW,gBAAgB;IAC/B,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,uDAAuD;IACvD,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,qBAAa,YAAa,SAAQ,YAAY;IAC5C,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,OAAO,CAMb;gBAEU,UAAU,EAAE,MAAM;IAK9B,SAAS,IAAI,eAAe;IAI5B,UAAU,IAAI,gBAAgB;IAIxB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK1C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAyC5B,KAAK,IAAI,IAAI;IAIb,IAAI,IAAI,IAAI;IAIZ,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;YAQT,WAAW;IA8EzB;;;;;OAKG;IACH,OAAO,CAAC,oBAAoB;IA8B5B,OAAO,CAAC,eAAe;IAmBvB;;;;;OAKG;IACH,OAAO,CAAC,sBAAsB;IAuH9B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAgB9B,mFAAmF;IACnF,OAAO,CAAC,mBAAmB,CAAuB;IAClD,OAAO,CAAC,uBAAuB,CAAS;IAExC;;;;;;OAMG;IACH,OAAO,CAAC,0BAA0B;IAkDlC;;OAEG;IACH,OAAO,CAAC,4BAA4B;IAoBpC,uEAAuE;IACvE,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,gBAAgB,CAAS;IAEjC;;;;;;;;OAQG;IACH,OAAO,CAAC,0BAA0B;IAgClC;;OAEG;IACH,OAAO,CAAC,4BAA4B;IAsBpC;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;IAMzB;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAexB;;;;OAIG;IACH,OAAO,CAAC,cAAc;IAyCtB,OAAO,CAAC,OAAO;IAQf,OAAO,CAAC,sBAAsB;IAa9B;;;OAGG;IACH,OAAO,CAAC,mBAAmB;CA6C5B"}