mstro-app 0.4.2 → 0.4.4

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

@@ -1,9 +1,15 @@
 /**
  * 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.
+ * Orchestrates the execution loop: picks ready issues, executes waves,
+ * runs AI review gate, reconciles state, and repeats.
+ *
+ * Implementation is split across focused modules:
+ * - config-installer.ts  — teammate permissions + bouncer MCP install/uninstall
+ * - prompt-builder.ts    — Agent Teams coordinator prompt construction
+ * - output-manager.ts    — output path resolution, listing, publishing
+ * - review-gate.ts       — AI-powered quality gate (review, parse, persist)
+ * - front-matter.ts      — YAML front matter field editing utility
  */
 import { EventEmitter } from 'node:events';
 export type ExecutionStatus = 'idle' | 'starting' | 'executing' | 'paused' | 'stopping' | 'complete' | 'error';
@@ -21,98 +27,56 @@ export declare class PlanExecutor extends EventEmitter {
     private shouldStop;
     private shouldPause;
     private epicScope;
+    /** Board directory path (e.g. /path/.pm/boards/BOARD-001). Used for outputs, reviews, progress. */
+    private boardDir;
+    /** Board ID being executed (e.g. "BOARD-001") */
+    private boardId;
+    private configInstaller;
+    /** Flag to prevent start() from clearing scope set by startBoard/startEpic */
+    private _scopeSetByCall;
     private metrics;
     constructor(workingDir: string);
     getStatus(): ExecutionStatus;
     getMetrics(): ExecutionMetrics;
     startEpic(epicPath: string): Promise<void>;
+    /** Start execution, optionally scoped to a specific board. */
+    startBoard(boardId: string): Promise<void>;
     start(): Promise<void>;
+    /** Run waves until done, paused, stopped, or stalled. Returns 'stalled' if zero-completion cap hit. */
+    private runWaveLoop;
     pause(): void;
     stop(): void;
     resume(): Promise<void>;
     private executeWave;
     /**
      * Post-wave operations wrapped individually so a failure in one
-     * (e.g. reconcileState hitting a concurrent write from PlanWatcher)
      * doesn't prevent the others or kill the while loop in start().
      */
     private finalizeWave;
     /**
-     * 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.
+     * After a wave, check each issue's status on disk and run the AI review gate.
+     * Issues that agents marked as `done` are moved to `in_review`, reviewed,
+     * and either confirmed `done` (passed) or reverted to `todo` (failed).
      */
     private reconcileWaveResults;
+    /** Run the review gate for a single issue that agents marked as done. Returns 1 if passed, 0 otherwise. */
+    private runReviewGate;
     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.
-     */
+    /** Load issues from a specific board, auto-activating draft boards. Returns null on error. */
+    private loadBoardIssues;
+    /** Load project-level issues (legacy or no boards). Returns null on error. */
+    private loadProjectIssues;
+    /** Activate a draft board by updating its status in board.md. */
+    private activateBoard;
+    /** Check if all issues in a board are done and mark board as completed. */
+    private tryCompleteBoardIfDone;
+    private resolveActiveBoardId;
     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;
-    /** Copy a single confirmed-done output to the user-specified output_file path. */
-    private publishSingleOutput;
-    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 ensureOutputDirs;
     private appendProgressEntry;
+    private writeProgressLines;
+    /** Resolve the active board's directory path for outputs, reviews, and progress. */
+    private resolveBoardDir;
 }
 //# sourceMappingURL=executor.d.ts.map

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

@@ -1 +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;AAK/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;IAoD5B,KAAK,IAAI,IAAI;IAIb,IAAI,IAAI,IAAI;IAIZ,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;YAQT,WAAW;IA4EzB;;;;OAIG;IACH,OAAO,CAAC,YAAY;IA8BpB;;;;;OAKG;IACH,OAAO,CAAC,oBAAoB;IAmC5B,OAAO,CAAC,eAAe;IAmBvB;;;;;OAKG;IACH,OAAO,CAAC,sBAAsB;IAsI9B;;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;IAStB,kFAAkF;IAClF,OAAO,CAAC,mBAAmB;IAkC3B,OAAO,CAAC,OAAO;IAQf,OAAO,CAAC,sBAAsB;IAa9B;;;OAGG;IACH,OAAO,CAAC,mBAAmB;CA6C5B"}
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../../../server/services/plan/executor.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAe3C,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,UAAU,GAAG,WAAW,GAAG,QAAQ,GAAG,UAAU,GAAG,UAAU,GAAG,OAAO,CAAC;AAc/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,mGAAmG;IACnG,OAAO,CAAC,QAAQ,CAAuB;IACvC,iDAAiD;IACjD,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,eAAe,CAAkB;IACzC,8EAA8E;IAC9E,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,OAAO,CAMb;gBAEU,UAAU,EAAE,MAAM;IAM9B,SAAS,IAAI,eAAe;IAC5B,UAAU,IAAI,gBAAgB;IAExB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMhD,8DAA8D;IACxD,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAM1C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAqC5B,uGAAuG;YACzF,WAAW;IAmBzB,KAAK,IAAI,IAAI;IACb,IAAI,IAAI,IAAI;IAEZ,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;YAUT,WAAW;IAwEzB;;;OAGG;IACH,OAAO,CAAC,YAAY;IAkCpB;;;;OAIG;YACW,oBAAoB;IAqClC,2GAA2G;YAC7F,aAAa;IA4C3B,OAAO,CAAC,eAAe;IAwBvB,8FAA8F;IAC9F,OAAO,CAAC,eAAe;IAmBvB,8EAA8E;IAC9E,OAAO,CAAC,iBAAiB;IAazB,iEAAiE;IACjE,OAAO,CAAC,aAAa;IASrB,2EAA2E;IAC3E,OAAO,CAAC,sBAAsB;IAe9B,OAAO,CAAC,oBAAoB;IAa5B,OAAO,CAAC,sBAAsB;IAc9B,OAAO,CAAC,sBAAsB;IAQ9B,OAAO,CAAC,gBAAgB;IAaxB,OAAO,CAAC,mBAAmB;IA2C3B,OAAO,CAAC,kBAAkB;IAW1B,oFAAoF;IACpF,OAAO,CAAC,eAAe;CAUxB"}