substrate-ai 0.3.0 → 0.3.1

package/dist/cli/index.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { DEFAULT_CONFIG, DEFAULT_ROUTING_POLICY, DatabaseWrapper, DoltNotInstalled, FileStateStore, SUBSTRATE_OWNED_SETTINGS_KEYS, VALID_PHASES, buildPipelineStatusOutput, checkDoltInstalled, createConfigSystem, createContextCompiler, createDispatcher, createDoltClient, createImplementationOrchestrator, createPackLoader, createPhaseOrchestrator, createStateStore, createStopAfterGate, findPackageRoot, formatOutput, formatPhaseCompletionSummary, formatPipelineStatusHuman, formatPipelineSummary, formatTokenTelemetry, getAllDescendantPids, getAutoHealthData, getSubstrateDefaultSettings, initializeDolt, parseDbTimestampAsUtc, registerHealthCommand, registerRunCommand, resolveBmadMethodSrcPath, resolveBmadMethodVersion, resolveMainRepoRoot, resolveStoryKeys, runAnalysisPhase, runMigrations, runPlanningPhase, runSolutioningPhase, validateStopAfterFromConflict } from "../run-DO9n3cwy.js";
+import { DEFAULT_CONFIG, DEFAULT_ROUTING_POLICY, DatabaseWrapper, DoltNotInstalled, FileStateStore, SUBSTRATE_OWNED_SETTINGS_KEYS, VALID_PHASES, buildPipelineStatusOutput, checkDoltInstalled, createConfigSystem, createContextCompiler, createDispatcher, createDoltClient, createImplementationOrchestrator, createPackLoader, createPhaseOrchestrator, createStateStore, createStopAfterGate, findPackageRoot, formatOutput, formatPhaseCompletionSummary, formatPipelineStatusHuman, formatPipelineSummary, formatTokenTelemetry, getAllDescendantPids, getAutoHealthData, getSubstrateDefaultSettings, initializeDolt, parseDbTimestampAsUtc, registerHealthCommand, registerRunCommand, resolveBmadMethodSrcPath, resolveBmadMethodVersion, resolveMainRepoRoot, resolveStoryKeys, runAnalysisPhase, runMigrations, runPlanningPhase, runSolutioningPhase, validateStopAfterFromConflict } from "../run-DNURadtJ.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";
@@ -681,7 +681,7 @@ async function runInitAction(options) {
 					process.stderr.write(`✗ Dolt initialization failed: ${msg}\n`);
 					return INIT_EXIT_ERROR;
 				}
-				logger$16.warn("Dolt auto-init failed (non-blocking)", { error: msg });
+				logger$16.warn({ error: msg }, "Dolt auto-init failed (non-blocking)");
 			}
 		}
 		else logger$16.debug("Dolt step was skipped (--no-dolt)");
@@ -1362,7 +1362,7 @@ async function runStatusAction(options) {
 		if (stateStore) try {
 			storeStories = await stateStore.queryStories({});
 		} catch (err) {
-			logger$13.debug("StateStore query failed, continuing without store data", { err });
+			logger$13.debug({ err }, "StateStore query failed, continuing without store data");
 		}
 		if (outputFormat === "json") {
 			const statusOutput = buildPipelineStatusOutput(run, tokenSummary, decisionsCount, storiesCount);
@@ -2664,7 +2664,7 @@ async function runSupervisorAction(options, deps = {}) {
 								const expDb = expDbWrapper.db;
 								const { runRunAction: runPipeline } = await import(
 									/* @vite-ignore */
-									"../run-DP932Mmn.js"
+									"../run-D6WEx9l2.js"
 );
 								const runStoryFn = async (opts) => {
 									const exitCode = await runPipeline({
@@ -3291,8 +3291,12 @@ function registerMigrateCommand(program) {
 			}
 			const result = await migrateDataToDolt(client, snapshot.storyMetrics, false);
 			if (result.metricsWritten > 0) try {
-				await client.exec("add .");
-				await client.exec("commit -m \"Migrate historical data from SQLite\"");
+				await client.execArgs(["add", "."]);
+				await client.execArgs([
+					"commit",
+					"-m",
+					"Migrate historical data from SQLite"
+				]);
 			} catch (execErr) {
 				const msg = execErr instanceof Error ? execErr.message : String(execErr);
 				process.stderr.write(`Warning: Dolt commit failed (non-fatal): ${msg}\n`);

package/dist/index.d.ts

@@ -1227,6 +1227,11 @@ interface OrchestratorEvents {
     modifiedInterfaces: string[];
     potentiallyAffectedTests: string[];
   };
+  /** Dolt merge conflict detected when merging a story branch into main */
+  'pipeline:state-conflict': {
+    storyKey: string;
+    conflict: unknown;
+  };
   /** Per-story metrics snapshot emitted when a story reaches a terminal state (Story 24-4) */
   'story:metrics': {
     storyKey: string;

package/dist/{run-DP932Mmn.js → run-D6WEx9l2.js}

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

package/dist/{run-DO9n3cwy.js → run-DNURadtJ.js}

@@ -7766,7 +7766,8 @@ var DoltStateStore = class DoltStateStore {
 			const entries = [];
 			for (const row of rows) {
 				const hash = String(row.commit_hash ?? "");
-				const timestamp = row.date instanceof Date ? row.date.toISOString() : String(row.date ?? "");
+				const dateVal = row.date;
+				const timestamp = dateVal instanceof Date ? dateVal.toISOString() : String(dateVal ?? "");
 				const message = String(row.message ?? "");
 				const author = row.committer ? String(row.committer) : void 0;
 				const storyKeyMatch = /story\/([0-9]+-[0-9]+)/i.exec(message);
@@ -9241,7 +9242,7 @@ function createImplementationOrchestrator(deps) {
 					storyKey
 				}, "mergeStory failed");
 			});
-			else if (updates.phase === "ESCALATED" || updates.phase === "FAILED") stateStore?.rollbackStory(storyKey).catch((err) => logger$24.warn({
+			else if (updates.phase === "ESCALATED") stateStore?.rollbackStory(storyKey).catch((err) => logger$24.warn({
 				err,
 				storyKey
 			}, "rollbackStory failed — branch may persist"));
@@ -10733,7 +10734,11 @@ function resolveStoryKeys(db, projectRoot, opts) {
 		const allContent = shardRows.map((r) => r.value).join("\n");
 		if (allContent.length > 0) keys = parseStoryKeysFromEpics(allContent);
 	} catch {}
-	if (keys.length === 0) keys = discoverPendingStoryKeys(projectRoot);
+	if (keys.length === 0) keys = discoverPendingStoryKeys(projectRoot, opts?.epicNumber);
+	if (opts?.epicNumber !== void 0 && keys.length > 0) {
+		const prefix = `${opts.epicNumber}-`;
+		keys = keys.filter((k) => k.startsWith(prefix));
+	}
 	if (opts?.filterCompleted === true && keys.length > 0) {
 		const completedKeys = getCompletedStoryKeys(db);
 		keys = keys.filter((k) => !completedKeys.has(k));
@@ -10781,21 +10786,33 @@ function parseStoryKeysFromEpics(content) {
 * @param projectRoot - Absolute path to the project root directory
 * @returns Sorted array of pending story keys in "N-M" format
 */
-function discoverPendingStoryKeys(projectRoot) {
+function discoverPendingStoryKeys(projectRoot, epicNumber) {
 	let allKeys = [];
-	const epicsPath = findEpicsFile(projectRoot);
-	if (epicsPath !== void 0) try {
-		const content = readFileSync$1(epicsPath, "utf-8");
-		allKeys = parseStoryKeysFromEpics(content);
-	} catch {}
-	if (allKeys.length === 0) {
+	if (epicNumber !== void 0) {
 		const epicFiles = findEpicFiles(projectRoot);
-		for (const epicFile of epicFiles) try {
+		const targetPattern = new RegExp(`^epic-${epicNumber}[^0-9]`);
+		const matched = epicFiles.filter((f) => targetPattern.test(f.split("/").pop()));
+		for (const epicFile of matched) try {
 			const content = readFileSync$1(epicFile, "utf-8");
 			const keys = parseStoryKeysFromEpics(content);
 			allKeys.push(...keys);
 		} catch {}
 		allKeys = sortStoryKeys([...new Set(allKeys)]);
+	} else {
+		const epicsPath = findEpicsFile(projectRoot);
+		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)]);
+		}
 	}
 	if (allKeys.length === 0) return [];
 	const existingKeys = collectExistingStoryKeys(projectRoot);
@@ -14884,7 +14901,7 @@ function mapInternalPhaseToEventPhase(internalPhase) {
 	}
 }
 async function runRunAction(options) {
-	const { pack: packName, from: startPhase, stopAfter, concept: conceptArg, conceptFile, stories: storiesArg, concurrency, outputFormat, projectRoot, events: eventsFlag, verbose: verboseFlag, tui: tuiFlag, skipUx, research: researchFlag, skipResearch: skipResearchFlag, skipPreflight, registry: injectedRegistry } = options;
+	const { pack: packName, from: startPhase, stopAfter, concept: conceptArg, conceptFile, stories: storiesArg, concurrency, outputFormat, projectRoot, events: eventsFlag, verbose: verboseFlag, tui: tuiFlag, skipUx, research: researchFlag, skipResearch: skipResearchFlag, skipPreflight, epic: epicNumber, registry: injectedRegistry } = options;
 	if (startPhase !== void 0 && !VALID_PHASES.includes(startPhase)) {
 		const errorMsg = `Invalid phase '${startPhase}'. Valid phases: ${VALID_PHASES.join(", ")}`;
 		if (outputFormat === "json") process.stdout.write(formatOutput(null, "json", false, errorMsg) + "\n");
@@ -15008,6 +15025,7 @@ async function runRunAction(options) {
 		...researchFlag === true ? { research: true } : {},
 		...skipResearchFlag === true ? { skipResearch: true } : {},
 		...skipPreflight === true ? { skipPreflight: true } : {},
+		...epicNumber !== void 0 ? { epic: epicNumber } : {},
 		...injectedRegistry !== void 0 ? { registry: injectedRegistry } : {}
 	});
 	let storyKeys = [...parsedStoryKeys];
@@ -15056,8 +15074,11 @@ async function runRunAction(options) {
 				storyKeys = storyKeys.filter((k) => !completedStoryKeys.has(k));
 			}
 			if (storyKeys.length === 0) {
-				storyKeys = discoverPendingStoryKeys(projectRoot);
-				if (storyKeys.length > 0) process.stdout.write(`Discovered ${storyKeys.length} pending stories from epics.md: ${storyKeys.join(", ")}\n`);
+				storyKeys = discoverPendingStoryKeys(projectRoot, epicNumber);
+				if (storyKeys.length > 0) {
+					const scopeLabel = epicNumber !== void 0 ? `epic ${epicNumber}` : "epics.md";
+					process.stdout.write(`Discovered ${storyKeys.length} pending stories from ${scopeLabel}: ${storyKeys.join(", ")}\n`);
+				}
 			}
 			if (storyKeys.length === 0) {
 				if (outputFormat === "human") process.stdout.write("No pending stories found in decision store.\n");
@@ -15755,7 +15776,10 @@ async function runFullPipeline(options) {
 						process.stdout.write(`  [ESCALATED] ${payload.storyKey}: ${payload.lastVerdict}\n`);
 					});
 				}
-				const storyKeys = resolveStoryKeys(db, projectRoot, { explicit: explicitStories });
+				const storyKeys = resolveStoryKeys(db, projectRoot, {
+					explicit: explicitStories,
+					epicNumber: options.epic
+				});
 				if (storyKeys.length === 0 && outputFormat === "human") process.stdout.write("[IMPLEMENTATION] No stories found. Run solutioning first or pass --stories.\n");
 				if (outputFormat === "human") process.stdout.write(`[IMPLEMENTATION] Starting ${storyKeys.length} stories with concurrency=${concurrency}\n`);
 				await orchestrator.run(storyKeys);
@@ -15819,7 +15843,7 @@ async function runFullPipeline(options) {
 	}
 }
 function registerRunCommand(program, _version = "0.0.0", projectRoot = process.cwd(), registry) {
-	program.command("run").description("Run the autonomous pipeline (use --from to start from a specific phase)").option("--pack <name>", "Methodology pack name", "bmad").option("--from <phase>", "Start from this phase: analysis, planning, solutioning, implementation").option("--stop-after <phase>", "Stop pipeline after this phase completes").option("--concept <text>", "Inline concept text (required when --from analysis)").option("--concept-file <path>", "Path to a file containing the concept text").option("--stories <keys>", "Comma-separated story keys (e.g., 10-1,10-2)").option("--concurrency <n>", "Maximum parallel conflict groups", (v) => parseInt(v, 10), 3).option("--project-root <path>", "Project root directory", projectRoot).option("--output-format <format>", "Output format: human (default) or json", "human").option("--events", "Emit structured NDJSON events on stdout for programmatic consumption").option("--verbose", "Show detailed pino log output").option("--help-agent", "Print a machine-optimized prompt fragment for AI agents and exit").option("--tui", "Show TUI dashboard").option("--skip-ux", "Skip the UX design phase even if enabled in the pack manifest").option("--research", "Enable the research phase even if not set in the pack manifest").option("--skip-research", "Skip the research phase even if enabled in the pack manifest").option("--skip-preflight", "Skip the pre-flight build check (escape hatch for known-broken projects)").action(async (opts) => {
+	program.command("run").description("Run the autonomous pipeline (use --from to start from a specific phase)").option("--pack <name>", "Methodology pack name", "bmad").option("--from <phase>", "Start from this phase: analysis, planning, solutioning, implementation").option("--stop-after <phase>", "Stop pipeline after this phase completes").option("--concept <text>", "Inline concept text (required when --from analysis)").option("--concept-file <path>", "Path to a file containing the concept text").option("--stories <keys>", "Comma-separated story keys (e.g., 10-1,10-2)").option("--epic <n>", "Scope story discovery to a single epic number (e.g., 27)", (v) => parseInt(v, 10)).option("--concurrency <n>", "Maximum parallel conflict groups", (v) => parseInt(v, 10), 3).option("--project-root <path>", "Project root directory", projectRoot).option("--output-format <format>", "Output format: human (default) or json", "human").option("--events", "Emit structured NDJSON events on stdout for programmatic consumption").option("--verbose", "Show detailed pino log output").option("--help-agent", "Print a machine-optimized prompt fragment for AI agents and exit").option("--tui", "Show TUI dashboard").option("--skip-ux", "Skip the UX design phase even if enabled in the pack manifest").option("--research", "Enable the research phase even if not set in the pack manifest").option("--skip-research", "Skip the research phase even if enabled in the pack manifest").option("--skip-preflight", "Skip the pre-flight build check (escape hatch for known-broken projects)").action(async (opts) => {
 		if (opts.helpAgent) {
 			process.exitCode = await runHelpAgent();
 			return;
@@ -15843,6 +15867,7 @@ function registerRunCommand(program, _version = "0.0.0", projectRoot = process.c
 			concept: opts.concept,
 			conceptFile: opts.conceptFile,
 			stories: opts.stories,
+			epic: opts.epic,
 			concurrency: opts.concurrency,
 			outputFormat,
 			projectRoot: opts.projectRoot,
@@ -15861,4 +15886,4 @@ function registerRunCommand(program, _version = "0.0.0", projectRoot = process.c
 
 //#endregion
 export { DEFAULT_CONFIG, DEFAULT_ROUTING_POLICY, DatabaseWrapper, DoltNotInstalled, FileStateStore, SUBSTRATE_OWNED_SETTINGS_KEYS, VALID_PHASES, buildPipelineStatusOutput, checkDoltInstalled, createConfigSystem, createContextCompiler, createDispatcher, createDoltClient, createImplementationOrchestrator, createPackLoader, createPhaseOrchestrator, createStateStore, createStopAfterGate, findPackageRoot, formatOutput, formatPhaseCompletionSummary, formatPipelineStatusHuman, formatPipelineSummary, formatTokenTelemetry, getAllDescendantPids, getAutoHealthData, getSubstrateDefaultSettings, initializeDolt, parseDbTimestampAsUtc, registerHealthCommand, registerRunCommand, resolveBmadMethodSrcPath, resolveBmadMethodVersion, resolveMainRepoRoot, resolveStoryKeys, runAnalysisPhase, runMigrations, runPlanningPhase, runRunAction, runSolutioningPhase, validateStopAfterFromConflict };
-//# sourceMappingURL=run-DO9n3cwy.js.map
+//# sourceMappingURL=run-DNURadtJ.js.map

package/package.json

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