mstro-app 0.4.52 → 0.5.0

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

@@ -6,13 +6,16 @@
  * reconciles state, and repeats.
  *
  * Implementation is split across focused modules:
+ * - board-config.ts          — board.md metadata reads, workspace.json active board resolution
  * - config-installer.ts      — tool permissions install/uninstall
  * - issue-prompt-builder.ts  — per-issue prompt construction
+ * - issue-writer.ts          — issue front-matter updates, recovery, revert, cancellation notes
  * - 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
+ * - progress-log.ts          — progress.md writer + output dir creation
+ * - review-gate.ts           — AI-powered quality gate (review, parse, persist, full pipeline)
  */
 import { EventEmitter } from 'node:events';
+import { DEFAULT_MAX_PARALLEL_AGENTS } from './board-config.js';
 export type ExecutionStatus = 'idle' | 'starting' | 'executing' | 'paused' | 'stopping' | 'complete' | 'error';
 export interface ExecutionMetrics {
     issuesCompleted: number;
@@ -22,44 +25,54 @@ export interface ExecutionMetrics {
     /** IDs of issues being executed in the current wave */
     currentWaveIds: string[];
 }
+/** Scope options for a single run. Passed to start(), startBoard(), startEpic(). */
+export interface StartOptions {
+    /** Epic file path — restricts execution to issues under that epic. */
+    epic?: string;
+    /** Board ID to execute (e.g. "BOARD-001"). */
+    board?: string;
+    /** Optional worktree directory for running agents. PM data is always read from workingDir. */
+    executionDir?: string;
+}
 export declare class PlanExecutor extends EventEmitter {
     private status;
-    private workingDir;
+    private readonly workingDir;
+    private readonly extraEnv?;
     private shouldStop;
     private shouldPause;
     /** AbortController for killing running HeadlessRunner processes on stop. */
     private waveAbortController;
-    private epicScope;
-    /** Cached PM directory path — resolved once per start(). */
-    private pmDir;
-    /** Board directory path (e.g. /path/.mstro/pm/boards/BOARD-001). Used for outputs, reviews, progress. */
-    private boardDir;
-    /** Board ID being executed (e.g. "BOARD-001") */
-    private boardId;
+    /** Resolved context for the current/last run — rebuilt each runStart(). */
+    private context;
+    /** Options from the last run; replayed on resume() to preserve scope. */
+    private lastStartOptions;
     private configInstaller;
-    /** Flag to prevent start() from clearing scope set by startBoard/startEpic */
-    private _scopeSetByCall;
-    /** Extra environment variables forwarded to HeadlessRunner child processes (e.g. API keys) */
-    private extraEnv?;
-    /** Optional worktree directory for running AI agents. PM data is always read from workingDir. */
-    private executionDir;
     private metrics;
     constructor(workingDir: string, options?: {
         extraEnv?: Record<string, string>;
     });
-    private validateIssuePath;
     getStatus(): ExecutionStatus;
     getMetrics(): ExecutionMetrics;
     startEpic(epicPath: string): Promise<void>;
     /** Start execution, optionally scoped to a specific board. */
     startBoard(boardId: string, executionDir?: string): Promise<void>;
-    start(): Promise<void>;
-    /** Run waves until done, paused, stopped, or stalled. */
-    private runWaveLoop;
-    private hasDeadIssues;
+    start(options?: StartOptions): Promise<void>;
     pause(): void;
     stop(): void;
     resume(): Promise<void>;
+    private runStart;
+    /** Build an immutable execution context from start options. */
+    private buildContext;
+    /**
+     * Forward module-emitted warnings as executor 'output' events so they flow
+     * through to the WebSocket broadcast like inline warnings always have.
+     */
+    private emitWarn;
+    private setIssueStatus;
+    /** Run waves until done, paused, stopped, or stalled. */
+    private runWaveLoop;
+    private effectiveBoardId;
+    private hasDeadIssues;
     private executeWave;
     /** Run a single issue via its own headless Claude Code instance with retry logic. */
     private runSingleIssue;
@@ -74,39 +87,26 @@ export declare class PlanExecutor extends EventEmitter {
      * 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;
+    /**
+     * Finalize a single issue whose status reached `in_review`/`done`. Runs the
+     * review pipeline unless the issue opted out via `reviewGate: 'none'`.
+     * Returns true when the issue is confirmed done (counted toward completions).
+     */
+    private finalizeCompletedIssue;
     /**
      * Recover from a previous interrupted execution by reverting stale
      * `in_progress` and `in_review` issues back to `todo`. Without this,
      * these issues block the dependency graph and cause the executor to
      * find zero ready issues, making "Implement" appear to do nothing.
      */
-    private recoverStaleIssues;
-    /** Read the board's maxParallelAgents setting, falling back to default. */
-    private getBoardMaxParallelAgents;
-    /** Read the board's custom review criteria, if set. */
-    private getBoardReviewCriteria;
+    private runStaleRecovery;
     private pickReadyIssues;
-    /** 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 buildCompletionReason;
-    /** Detect issues stuck in non-terminal states with no path to completion. */
-    private detectDeadState;
-    private revertIncompleteIssues;
-    private appendCancellationNote;
-    private updateIssueFrontMatter;
-    private ensureOutputDirs;
-    private appendProgressEntry;
-    private writeProgressLines;
-    /** Resolve the active board's directory path for outputs, reviews, and progress. */
-    private resolveBoardDir;
+    /**
+     * Load issues for the active execution scope. Returns the resolved boardId
+     * alongside the issues so callers can branch on board-specific logic without
+     * re-resolving the scope.
+     */
+    private loadScopedIssues;
 }
+export { DEFAULT_MAX_PARALLEL_AGENTS };
 //# 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;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAgB3C,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,4EAA4E;IAC5E,OAAO,CAAC,mBAAmB,CAAgC;IAC3D,OAAO,CAAC,SAAS,CAAuB;IACxC,4DAA4D;IAC5D,OAAO,CAAC,KAAK,CAAuB;IACpC,yGAAyG;IACzG,OAAO,CAAC,QAAQ,CAAuB;IACvC,iDAAiD;IACjD,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,eAAe,CAAkB;IACzC,8EAA8E;IAC9E,OAAO,CAAC,eAAe,CAAS;IAChC,8FAA8F;IAC9F,OAAO,CAAC,QAAQ,CAAC,CAAyB;IAC1C,iGAAiG;IACjG,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,OAAO,CAMb;gBAEU,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE;IAO/E,OAAO,CAAC,iBAAiB;IAUzB,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,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOjE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA6C5B,yDAAyD;YAC3C,WAAW;YAuBX,aAAa;IAY3B,KAAK,IAAI,IAAI;IACb,IAAI,IAAI,IAAI;IAQZ,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;YAUT,WAAW;IAyDzB,qFAAqF;YACvE,cAAc;IAsC5B;;;OAGG;YACW,YAAY;IAkC1B;;;;OAIG;YACW,oBAAoB;IAsClC,2GAA2G;YAC7F,aAAa;IAqD3B;;;;;OAKG;YACW,kBAAkB;IAiChC,2EAA2E;YAC7D,yBAAyB;IAoBvC,uDAAuD;YACzC,sBAAsB;YAsBtB,eAAe;IA6B7B,8FAA8F;YAChF,eAAe;IAmB7B,8EAA8E;IAC9E,OAAO,CAAC,iBAAiB;IAazB,iEAAiE;YACnD,aAAa;IAW3B,2EAA2E;YAC7D,sBAAsB;IAiBpC,OAAO,CAAC,oBAAoB;IAa5B,OAAO,CAAC,qBAAqB;IAS7B,6EAA6E;IAC7E,OAAO,CAAC,eAAe;YAsBT,sBAAsB;YAgBtB,sBAAsB;YAgBtB,sBAAsB;YAiBtB,gBAAgB;YAahB,mBAAmB;YA0CnB,kBAAkB;IAYhC,oFAAoF;IACpF,OAAO,CAAC,eAAe;CAUxB"}
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../../../server/services/plan/executor.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAI3C,OAAO,EACL,2BAA2B,EAK5B,MAAM,mBAAmB,CAAC;AAsB3B,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,UAAU,GAAG,WAAW,GAAG,QAAQ,GAAG,UAAU,GAAG,UAAU,GAAG,OAAO,CAAC;AAW/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,oFAAoF;AACpF,MAAM,WAAW,YAAY;IAC3B,sEAAsE;IACtE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,8CAA8C;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8FAA8F;IAC9F,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAiBD,qBAAa,YAAa,SAAQ,YAAY;IAC5C,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAyB;IACnD,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,WAAW,CAAS;IAC5B,4EAA4E;IAC5E,OAAO,CAAC,mBAAmB,CAAgC;IAC3D,2EAA2E;IAC3E,OAAO,CAAC,OAAO,CAAuB;IACtC,yEAAyE;IACzE,OAAO,CAAC,gBAAgB,CAAoB;IAC5C,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,OAAO,CAMb;gBAEU,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE;IAQ/E,SAAS,IAAI,eAAe;IAC5B,UAAU,IAAI,gBAAgB;IAE9B,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI1C,8DAA8D;IAC9D,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjE,KAAK,CAAC,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAIhD,KAAK,IAAI,IAAI;IAEb,IAAI,IAAI,IAAI;IAQZ,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;YAST,QAAQ;IAqCtB,+DAA+D;IAC/D,OAAO,CAAC,YAAY;IAgBpB;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAEd;YAEY,cAAc;IAQ5B,yDAAyD;YAC3C,WAAW;IAuBzB,OAAO,CAAC,gBAAgB;YAIV,aAAa;YASb,WAAW;IAyDzB,qFAAqF;YACvE,cAAc;IAuC5B;;;OAGG;YACW,YAAY;IAoC1B;;;;OAIG;YACW,oBAAoB;IA6BlC;;;;OAIG;YACW,sBAAsB;IAkCpC;;;;;OAKG;YACW,gBAAgB;YAmBhB,eAAe;IAyB7B;;;;OAIG;YACW,gBAAgB;CAU/B;AAGD,OAAO,EAAE,2BAA2B,EAAE,CAAC"}