substrate-ai 0.2.36 → 0.2.38

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-B9OkdDIk.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-RJ0EHbfM.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-LStYIzcb.js"
+									"../run-Q-rgJf4a.js"
 );
 								const runStoryFn = async (opts) => {
 									const exitCode = await runPipeline({

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

@@ -1,20 +1,23 @@
 <!-- substrate:start -->
 ## Substrate Pipeline
 
-This project uses Substrate for automated implementation pipelines. Substrate runs are long-running (5–40 minutes). Plan accordingly.
+This project uses Substrate for automated implementation pipelines. **When the user asks you to implement, build, or run the pipeline — go straight to running substrate. Do NOT explore the codebase, read source files, or plan the implementation yourself.** Substrate orchestrates sub-agents that handle all of that.
 
 ### Running the Pipeline
 
-**Preferred — Supervisor mode** (handles stalls, auto-restarts, post-run analysis):
+**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 --stories 7-1,7-2
+substrate supervisor --output-format json
 ```
 
-**Direct mode** (simpler, no auto-recovery):
+To target specific stories (if the user names them):
 ```
-substrate run --events --stories 7-1,7-2
+substrate supervisor --output-format json --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.
+
 **CRITICAL execution rules:**
 - Pipeline runs take **5–40 minutes**. You MUST use `run_in_background: true` or `timeout: 600000` (10 min) when invoking via Bash tool. Default 2-minute timeout WILL kill the pipeline.
 - **NEVER pipe substrate output** to `head`, `tail`, `grep`, or any command that may close the pipe early — this causes EPIPE stalls that hang the process.

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

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

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

@@ -9559,6 +9559,83 @@ function sortStoryKeys(keys) {
 	});
 }
 
+//#endregion
+//#region src/modules/phase-orchestrator/phase-detection.ts
+const PHASE_ARTIFACTS = [
+	{
+		phase: "research",
+		type: "research-findings",
+		optional: true
+	},
+	{
+		phase: "analysis",
+		type: "product-brief",
+		optional: false
+	},
+	{
+		phase: "planning",
+		type: "prd",
+		optional: false
+	},
+	{
+		phase: "solutioning",
+		type: "stories",
+		optional: false
+	}
+];
+/**
+* Detect the next phase to run based on DB state.
+*
+* Detection logic:
+* 1. If stories exist (decisions/epics.md) → implementation
+* 2. Walk forward through phases checking for completion artifacts
+* 3. Skip optional phases (research) if no artifact found
+* 4. The first required phase WITHOUT an artifact is where we start
+* 5. If nothing exists → analysis (needs concept)
+*/
+function detectStartPhase(db, projectRoot) {
+	try {
+		const storyKeys = resolveStoryKeys(db, projectRoot);
+		if (storyKeys.length > 0) return {
+			phase: "implementation",
+			reason: `${storyKeys.length} stories ready for implementation`,
+			needsConcept: false
+		};
+	} catch {}
+	let lastCompletedPhase;
+	try {
+		for (const entry of PHASE_ARTIFACTS) {
+			const row = db.prepare("SELECT id FROM artifacts WHERE phase = ? AND type = ? LIMIT 1").get(entry.phase, entry.type);
+			if (row !== void 0) lastCompletedPhase = entry.phase;
+			else if (!entry.optional) {
+				const needsConcept = entry.phase === "analysis";
+				const reason = lastCompletedPhase !== void 0 ? `${lastCompletedPhase} phase complete — continuing with ${entry.phase}` : "No pipeline state found — starting from the beginning";
+				return {
+					phase: entry.phase,
+					needsConcept,
+					reason
+				};
+			}
+		}
+	} catch {
+		return {
+			phase: "analysis",
+			reason: "No pipeline state found — starting from the beginning",
+			needsConcept: true
+		};
+	}
+	if (lastCompletedPhase !== void 0) return {
+		phase: "solutioning",
+		reason: "All phases completed but no stories found — re-running solutioning",
+		needsConcept: false
+	};
+	return {
+		phase: "analysis",
+		reason: "No pipeline state found — starting from the beginning",
+		needsConcept: true
+	};
+}
+
 //#endregion
 //#region src/modules/phase-orchestrator/built-in-phases.ts
 function logPhase(message) {
@@ -13560,12 +13637,37 @@ async function runRunAction(options) {
 			return 1;
 		}
 	}
-	if (startPhase !== void 0) return runFullPipeline({
+	let effectiveStartPhase = startPhase;
+	if (effectiveStartPhase === void 0) {
+		mkdirSync(dbDir, { recursive: true });
+		try {
+			const detectDb = new DatabaseWrapper(dbPath);
+			try {
+				detectDb.open();
+				runMigrations(detectDb.db);
+				const detection = detectStartPhase(detectDb.db, projectRoot);
+				if (detection.phase !== "implementation") {
+					effectiveStartPhase = detection.phase;
+					if (outputFormat === "human") process.stdout.write(`[AUTO-DETECT] ${detection.reason}\n`);
+					if (detection.needsConcept && concept === void 0) {
+						const errorMsg = `Pipeline needs to start from ${detection.phase} phase, which requires a concept.\nProvide --concept "your idea" or --concept-file path/to/brief.md`;
+						if (outputFormat === "json") process.stdout.write(formatOutput(null, "json", false, errorMsg) + "\n");
+						else process.stderr.write(`Error: ${errorMsg}\n`);
+						detectDb.close();
+						return 1;
+					}
+				} else if (outputFormat === "human") process.stdout.write(`[AUTO-DETECT] ${detection.reason}\n`);
+			} finally {
+				detectDb.close();
+			}
+		} catch {}
+	}
+	if (effectiveStartPhase !== void 0) return runFullPipeline({
 		packName,
 		packPath,
 		dbDir,
 		dbPath,
-		startPhase,
+		startPhase: effectiveStartPhase,
 		stopAfter,
 		concept,
 		concurrency,
@@ -14431,4 +14533,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-B9OkdDIk.js.map
+//# sourceMappingURL=run-RJ0EHbfM.js.map

package/package.json

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