substrate-ai 0.2.38 → 0.2.40

package/dist/cli/index.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { DEFAULT_CONFIG, DEFAULT_ROUTING_POLICY, DatabaseWrapper, SUBSTRATE_OWNED_SETTINGS_KEYS, VALID_PHASES, buildPipelineStatusOutput, createConfigSystem, createContextCompiler, createDispatcher, createImplementationOrchestrator, createPackLoader, createPhaseOrchestrator, createStopAfterGate, findPackageRoot, formatOutput, formatPhaseCompletionSummary, formatPipelineStatusHuman, formatPipelineSummary, formatTokenTelemetry, getAllDescendantPids, getAutoHealthData, getSubstrateDefaultSettings, parseDbTimestampAsUtc, registerHealthCommand, registerRunCommand, resolveBmadMethodSrcPath, resolveBmadMethodVersion, resolveMainRepoRoot, resolveStoryKeys, runAnalysisPhase, runMigrations, runPlanningPhase, runSolutioningPhase, validateStopAfterFromConflict } from "../run-RJ0EHbfM.js";
+import { DEFAULT_CONFIG, DEFAULT_ROUTING_POLICY, DatabaseWrapper, SUBSTRATE_OWNED_SETTINGS_KEYS, VALID_PHASES, buildPipelineStatusOutput, createConfigSystem, createContextCompiler, createDispatcher, createImplementationOrchestrator, createPackLoader, createPhaseOrchestrator, createStopAfterGate, findPackageRoot, formatOutput, formatPhaseCompletionSummary, formatPipelineStatusHuman, formatPipelineSummary, formatTokenTelemetry, getAllDescendantPids, getAutoHealthData, getSubstrateDefaultSettings, parseDbTimestampAsUtc, registerHealthCommand, registerRunCommand, resolveBmadMethodSrcPath, resolveBmadMethodVersion, resolveMainRepoRoot, resolveStoryKeys, runAnalysisPhase, runMigrations, runPlanningPhase, runSolutioningPhase, validateStopAfterFromConflict } from "../run-DphVZduv.js";
 import { createLogger } from "../logger-D2fS2ccL.js";
 import { AdapterRegistry } from "../adapter-registry-PsWhP_1Q.js";
 import { CURRENT_CONFIG_FORMAT_VERSION, CURRENT_TASK_GRAPH_VERSION, PartialSubstrateConfigSchema } from "../config-migrator-DSi8KhQC.js";
@@ -2581,7 +2581,7 @@ async function runSupervisorAction(options, deps = {}) {
 								const expDb = expDbWrapper.db;
 								const { runRunAction: runPipeline } = await import(
 									/* @vite-ignore */
-									"../run-Q-rgJf4a.js"
+									"../run-CwENzFYi.js"
 );
 								const runStoryFn = async (opts) => {
 									const exitCode = await runPipeline({

package/dist/cli/templates/claude-md-substrate-section.md

@@ -8,12 +8,12 @@ This project uses Substrate for automated implementation pipelines. **When the u
 **Just run it.** Substrate auto-detects which pipeline phase to start from (analysis → planning → solutioning → implementation) and auto-discovers pending stories. You do not need to determine the phase or find story keys manually.
 
 ```
-substrate supervisor --output-format json
+substrate run --events
 ```
 
 To target specific stories (if the user names them):
 ```
-substrate supervisor --output-format json --stories 1-1,1-2,1-3
+substrate run --events --stories 1-1,1-2,1-3
 ```
 
 If substrate needs input it can't auto-detect (e.g., a project concept for analysis), it will exit with a clear error message telling you what to provide.
@@ -36,13 +36,18 @@ Check process health if pipeline seems quiet:
 substrate health --output-format json
 ```
 
+For long-running pipelines, attach the **supervisor** for automatic stall detection, kill-and-restart recovery, and post-run analysis. The supervisor monitors an active run — it does not start one. Start it alongside `substrate run`:
+```
+substrate supervisor --output-format json
+```
+
 **Interpreting silence:** No output for 5 minutes = normal (agent is working). No output for 15+ minutes = likely stalled. Use `substrate health` to confirm, then consider killing and resuming.
 
 ### After Pipeline Completes
 
 1. **Summarize results** conversationally: X succeeded, Y failed, Z escalated
 2. **Check metrics**: `substrate metrics --output-format json`
-3. **Read analysis** (if supervisor mode): `substrate metrics --analysis <run_id> --output-format json`
+3. **Read analysis** (if supervisor was attached): `substrate metrics --analysis <run_id> --output-format json`
 
 ### Handling Escalations and Failures
 
@@ -57,7 +62,7 @@ substrate health --output-format json
 | Command | Purpose |
 |---|---|
 | `substrate run --events` | Run pipeline with NDJSON event stream |
-| `substrate supervisor --output-format json` | Run with auto-recovery and analysis |
+| `substrate supervisor --output-format json` | Monitor active run with auto-recovery and post-run analysis |
 | `substrate status --output-format json` | Poll current pipeline state |
 | `substrate health --output-format json` | Check process health and stall detection |
 | `substrate metrics --output-format json` | View historical run metrics |

package/dist/{run-Q-rgJf4a.js → run-CwENzFYi.js}

@@ -1,4 +1,4 @@
-import { registerRunCommand, runRunAction } from "./run-RJ0EHbfM.js";
+import { registerRunCommand, runRunAction } from "./run-DphVZduv.js";
 import "./logger-D2fS2ccL.js";
 import "./config-migrator-DSi8KhQC.js";
 import "./helpers-RL22dYtn.js";

package/dist/{run-RJ0EHbfM.js → run-DphVZduv.js}

@@ -9460,8 +9460,10 @@ function parseStoryKeysFromEpics(content) {
 	const explicitKeyPattern = /\*\*Story key:\*\*\s*`?(\d+-\d+)(?:-[^`\s]*)?`?/g;
 	let match;
 	while ((match = explicitKeyPattern.exec(content)) !== null) if (match[1] !== void 0) keys.add(match[1]);
-	const headingPattern = /^###\s+Story\s+(\d+)\.(\d+)/gm;
+	const headingPattern = /^###\s+Story\s+(\d+)[.\-](\d+)/gm;
 	while ((match = headingPattern.exec(content)) !== null) if (match[1] !== void 0 && match[2] !== void 0) keys.add(`${match[1]}-${match[2]}`);
+	const inlineStoryPattern = /Story\s+(\d+)-(\d+)[:\s]/g;
+	while ((match = inlineStoryPattern.exec(content)) !== null) if (match[1] !== void 0 && match[2] !== void 0) keys.add(`${match[1]}-${match[2]}`);
 	const filePathPattern = /_bmad-output\/implementation-artifacts\/(\d+-\d+)-/g;
 	while ((match = filePathPattern.exec(content)) !== null) if (match[1] !== void 0) keys.add(match[1]);
 	return sortStoryKeys(Array.from(keys));
@@ -9481,21 +9483,34 @@ function parseStoryKeysFromEpics(content) {
 * @returns Sorted array of pending story keys in "N-M" format
 */
 function discoverPendingStoryKeys(projectRoot) {
+	let allKeys = [];
 	const epicsPath = findEpicsFile(projectRoot);
-	if (epicsPath === void 0) return [];
-	let content;
-	try {
-		content = readFileSync$1(epicsPath, "utf-8");
-	} catch {
-		return [];
+	if (epicsPath !== void 0) try {
+		const content = readFileSync$1(epicsPath, "utf-8");
+		allKeys = parseStoryKeysFromEpics(content);
+	} catch {}
+	if (allKeys.length === 0) {
+		const epicFiles = findEpicFiles(projectRoot);
+		for (const epicFile of epicFiles) try {
+			const content = readFileSync$1(epicFile, "utf-8");
+			const keys = parseStoryKeysFromEpics(content);
+			allKeys.push(...keys);
+		} catch {}
+		allKeys = sortStoryKeys([...new Set(allKeys)]);
 	}
-	const allKeys = parseStoryKeysFromEpics(content);
 	if (allKeys.length === 0) return [];
 	const existingKeys = collectExistingStoryKeys(projectRoot);
 	return allKeys.filter((k) => !existingKeys.has(k));
 }
 /**
-* Find epics.md from known candidate paths relative to projectRoot.
+* Find epic files from known candidate paths relative to projectRoot.
+*
+* Checks for:
+*   1. epics.md (consolidated epic file)
+*   2. Individual epic-*.md files in planning-artifacts/
+*
+* Returns a single path for epics.md, or undefined if not found.
+* For individual epic files, use findEpicFiles() instead.
 */
 function findEpicsFile(projectRoot) {
 	const candidates = ["_bmad-output/planning-artifacts/epics.md", "_bmad-output/epics.md"];
@@ -9506,6 +9521,20 @@ function findEpicsFile(projectRoot) {
 	return void 0;
 }
 /**
+* Find individual epic-*.md files in the planning artifacts directory.
+* Returns paths sorted alphabetically.
+*/
+function findEpicFiles(projectRoot) {
+	const planningDir = join$1(projectRoot, "_bmad-output", "planning-artifacts");
+	if (!existsSync$1(planningDir)) return [];
+	try {
+		const entries = readdirSync$1(planningDir, { encoding: "utf-8" });
+		return entries.filter((e) => /^epic-\d+.*\.md$/.test(e)).sort().map((e) => join$1(planningDir, e));
+	} catch {
+		return [];
+	}
+}
+/**
 * Collect story keys that already have implementation artifact files.
 * Scans _bmad-output/implementation-artifacts/ for files matching N-M-*.md.
 */
@@ -14533,4 +14562,4 @@ function registerRunCommand(program, _version = "0.0.0", projectRoot = process.c
 
 //#endregion
 export { DEFAULT_CONFIG, DEFAULT_ROUTING_POLICY, DatabaseWrapper, SUBSTRATE_OWNED_SETTINGS_KEYS, VALID_PHASES, buildPipelineStatusOutput, createConfigSystem, createContextCompiler, createDispatcher, createImplementationOrchestrator, createPackLoader, createPhaseOrchestrator, createStopAfterGate, findPackageRoot, formatOutput, formatPhaseCompletionSummary, formatPipelineStatusHuman, formatPipelineSummary, formatTokenTelemetry, getAllDescendantPids, getAutoHealthData, getSubstrateDefaultSettings, parseDbTimestampAsUtc, registerHealthCommand, registerRunCommand, resolveBmadMethodSrcPath, resolveBmadMethodVersion, resolveMainRepoRoot, resolveStoryKeys, runAnalysisPhase, runMigrations, runPlanningPhase, runRunAction, runSolutioningPhase, validateStopAfterFromConflict };
-//# sourceMappingURL=run-RJ0EHbfM.js.map
+//# sourceMappingURL=run-DphVZduv.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "substrate-ai",
-  "version": "0.2.38",
+  "version": "0.2.40",
   "description": "Substrate — multi-agent orchestration daemon for AI coding agents",
   "type": "module",
   "license": "MIT",