substrate-ai 0.20.17 → 0.20.19

package/dist/cli/index.js

@@ -4,7 +4,7 @@ import { createLogger } from "../logger-KeHncl-f.js";
 import { createEventBus } from "../helpers-CElYrONe.js";
 import { AdapterRegistry, BudgetConfigSchema, CURRENT_CONFIG_FORMAT_VERSION, CURRENT_TASK_GRAPH_VERSION, ConfigError, CostTrackerConfigSchema, DEFAULT_CONFIG, DoltClient, DoltNotInstalled, GlobalSettingsSchema, IngestionServer, MonitorDatabaseImpl, OPERATIONAL_FINDING, PartialGlobalSettingsSchema, PartialProviderConfigSchema, ProvidersSchema, RoutingRecommender, STORY_METRICS, TelemetryConfigSchema, addTokenUsage, aggregateTokenUsageForRun, checkDoltInstalled, compareRunMetrics, createAmendmentRun, createConfigSystem, createDecision, createDoltClient, createPipelineRun, getActiveDecisions, getAllCostEntriesFiltered, getBaselineRunMetrics, getDecisionsByCategory, getDecisionsByPhaseForRun, getLatestCompletedRun, getLatestRun, getPipelineRunById, getPlanningCostTotal, getRetryableEscalations, getRunMetrics, getRunningPipelineRuns, getSessionCostSummary, getSessionCostSummaryFiltered, getStoryMetricsForRun, getTokenUsageSummary, incrementRunRestarts, initSchema, initializeDolt, listRunMetrics, loadParentRunDecisions, supersedeDecision, tagRunAsBaseline, updatePipelineRun } from "../dist-CqtWS9wF.js";
 import "../adapter-registry-DXLMTmfD.js";
-import { AdapterTelemetryPersistence, AppError, DoltRepoMapMetaRepository, DoltSymbolRepository, ERR_REPO_MAP_STORAGE_WRITE, EpicIngester, GitClient, GrammarLoader, RepoMapInjector, RepoMapModule, RepoMapQueryEngine, RepoMapStorage, SymbolParser, createContextCompiler, createDispatcher, createEventEmitter, createImplementationOrchestrator, createPackLoader, createPhaseOrchestrator, createStopAfterGate, createTelemetryAdvisor, formatPhaseCompletionSummary, getFactoryRunSummaries, getScenarioResultsForRun, getTwinRunsForRun, listGraphRuns, registerExportCommand, registerFactoryCommand, registerRunCommand, registerScenariosCommand, resolveStoryKeys, runAnalysisPhase, runPlanningPhase, runSolutioningPhase, validateStopAfterFromConflict } from "../run-xQLHet2Y.js";
+import { AdapterTelemetryPersistence, AppError, DoltRepoMapMetaRepository, DoltSymbolRepository, ERR_REPO_MAP_STORAGE_WRITE, EpicIngester, GitClient, GrammarLoader, RepoMapInjector, RepoMapModule, RepoMapQueryEngine, RepoMapStorage, SymbolParser, createContextCompiler, createDispatcher, createEventEmitter, createImplementationOrchestrator, createPackLoader, createPhaseOrchestrator, createStopAfterGate, createTelemetryAdvisor, formatPhaseCompletionSummary, getFactoryRunSummaries, getScenarioResultsForRun, getTwinRunsForRun, listGraphRuns, registerExportCommand, registerFactoryCommand, registerRunCommand, registerScenariosCommand, resolveStoryKeys, runAnalysisPhase, runPlanningPhase, runSolutioningPhase, validateStopAfterFromConflict } from "../run-2nI3qh0-.js";
 import "../errors-1uLGqnvr.js";
 import "../routing-CcBOCuC9.js";
 import "../decisions-C0pz9Clx.js";
@@ -5198,7 +5198,7 @@ async function runSupervisorAction(options, deps = {}) {
 								await initSchema(expAdapter);
 								const { runRunAction: runPipeline } = await import(
 									/* @vite-ignore */
-									"../run-CZW8qqr5.js"
+									"../run-BNCfGm5V.js"
 );
 								const runStoryFn = async (opts) => {
 									const exitCode = await runPipeline({

package/dist/{run-xQLHet2Y.js → run-2nI3qh0-.js}

@@ -5737,6 +5737,19 @@ async function runCreateStory(deps, params) {
 	}
 	const implementationDecisions = await getImplementationDecisions(deps, pipelineRunId);
 	const epicShardContent = getEpicShard(implementationDecisions, epicId, deps.projectRoot, storyKey);
+	let effectiveSourceAcHash = source_ac_hash;
+	if (epicShardContent.length > 0) {
+		const storySection = extractStorySection(epicShardContent, storyKey);
+		if (storySection !== null) {
+			const computedHash = hashSourceAcSection(storySection);
+			if (source_ac_hash !== void 0 && source_ac_hash !== computedHash) logger$18.debug({
+				storyKey,
+				suppliedHash: source_ac_hash,
+				computedHash
+			}, "Orchestrator-supplied source_ac_hash differs from epic_shard content hash — using computed (Story 58-18)");
+			effectiveSourceAcHash = computedHash;
+		}
+	}
 	const prevDevNotesContent = getPrevDevNotes(implementationDecisions, epicId);
 	let storyDefinitionContent = "";
 	try {
@@ -5780,9 +5793,9 @@ async function runCreateStory(deps, params) {
 			content: storyTemplateContent,
 			priority: "important"
 		},
-		...source_ac_hash !== void 0 ? [{
+		...effectiveSourceAcHash !== void 0 ? [{
 			name: "source_ac_hash",
-			content: source_ac_hash,
+			content: effectiveSourceAcHash,
 			priority: "required"
 		}] : []
 	], TOKEN_CEILING);
@@ -5968,27 +5981,24 @@ function getEpicShard(decisions, epicId, projectRoot, storyKey) {
 		}
 		const epicShard = decisions.find((d) => d.category === "epic-shard" && d.key === epicId);
 		const shardContent = epicShard?.value;
-		if (shardContent) {
-			if (storyKey) {
-				const storySection = extractStorySection(shardContent, storyKey);
-				if (storySection) {
-					logger$18.debug({
-						epicId,
-						storyKey
-					}, "Extracted per-story section from epic shard (pre-37-0 fallback)");
-					return storySection;
-				}
+		if (shardContent && storyKey) {
+			const storySection = extractStorySection(shardContent, storyKey);
+			if (storySection) {
 				logger$18.debug({
 					epicId,
 					storyKey
-				}, "No matching story section found — using full epic shard");
+				}, "Extracted per-story section from epic shard (pre-37-0 fallback)");
+				return storySection;
 			}
-			return shardContent;
+			logger$18.info({
+				epicId,
+				storyKey
+			}, "Story section absent in decisions-store shard — attempting file-based fallback before returning stale shard");
 		}
 		if (projectRoot) {
 			const fallback = readEpicShardFromFile(projectRoot, epicId);
 			if (fallback) {
-				logger$18.info({ epicId }, "Using file-based fallback for epic shard (decisions table empty)");
+				logger$18.info({ epicId }, "Using file-based fallback for epic shard");
 				if (storyKey) {
 					const storySection = extractStorySection(fallback, storyKey);
 					if (storySection) {
@@ -6002,6 +6012,7 @@ function getEpicShard(decisions, epicId, projectRoot, storyKey) {
 				return fallback;
 			}
 		}
+		if (shardContent) return shardContent;
 		return "";
 	} catch (err) {
 		logger$18.warn({
@@ -8776,6 +8787,13 @@ async function seedEpicShards(db, projectRoot) {
 	for (const shard of shards) {
 		const subsections = parseStorySubsections(shard.epicId, shard.content);
 		for (const subsection of subsections) {
+			if (subsection.content.length > MAX_EPIC_SHARD_CHARS) logger$11.warn({
+				epicId: shard.epicId,
+				storyKey: subsection.key,
+				originalLength: subsection.content.length,
+				truncatedLength: MAX_EPIC_SHARD_CHARS,
+				droppedChars: subsection.content.length - MAX_EPIC_SHARD_CHARS
+			}, `Epic shard for ${subsection.key} exceeded ${MAX_EPIC_SHARD_CHARS}-char cap and was truncated; tail content lost from decisions store. Consider splitting the story or raising MAX_EPIC_SHARD_CHARS.`);
 			await createDecision(db, {
 				pipeline_run_id: null,
 				phase: "implementation",
@@ -8897,25 +8915,46 @@ function parseEpicShards(content) {
 * Parse an epic section's content into per-story subsections.
 *
 * Matches story headings using three patterns:
-*   - Markdown headings: #{2,6} Story \d+-\d+  (e.g., ### Story 37-1: Title)
-*   - Bold:              **Story \d+-\d+**       (e.g., **Story 37-1**)
-*   - Bare key:          \d+-\d+:\s              (e.g., 37-1: Title — must start at line start)
+*   - Markdown headings: #{2,6} Story \d+[-._ ]\d+  (e.g., ### Story 37-1: Title or ### Story 1.1)
+*   - Bold:              **Story \d+[-._ ]\d+**     (e.g., **Story 37-1**)
+*   - Bare key:          \d+[-._ ]\d+:\s            (e.g., 37-1: Title — must start at line start)
 *
 * Each subsection spans from its heading to the next matching heading or EOF.
 *
+* Story 58-17: separator normalization. The original regex required `\d+-\d+`
+* (dash-only). Strata uses `### Story 1.1` (dot-separated) per its BMAD-template
+* convention. Without separator-agnostic parsing, every Story 1.X heading was
+* silently invisible to this parser, the matches.length === 0 fallback path
+* fired, the entire epic was stored as ONE per-epic decision (key=epicId)
+* truncated at 12K chars. All stories past the truncation point (1.6, 1.8,
+* 1.9+ in strata's case) were lost from the decisions store, which is the
+* actual root cause of strata obs_2026-04-20_001 — create-story received
+* empty input for those stories and hallucinated specs from domain priors.
+*
+* Epic 58-5 already made `extractStorySection` separator-agnostic for the
+* same reason; this matches that precedent at the seed-time parser.
+*
+* Captured storyKey is normalized to canonical dash-form (`1.1` → `1-1`) so
+* decision keys are consistent regardless of the source heading style — a
+* `--stories 1-9` CLI invocation finds the shard whether the epic used dot,
+* dash, underscore, or space separators.
+*
 * AC3: If no story headings are found, returns a single per-epic fallback entry
 * keyed by epicId — preserving backward-compatible behaviour for unstructured epics.
 */
 function parseStorySubsections(epicId, epicContent) {
-	const storyPattern = /(?:^#{2,6}\s+Story\s+(\d+-\d+)|^\*\*Story\s+(\d+-\d+)\*\*|^(\d+-\d+):\s)/gim;
+	const storyPattern = /(?:^#{2,6}\s+Story\s+(\d+[-._ ]\d+)|^\*\*Story\s+(\d+[-._ ]\d+)\*\*|^(\d+[-._ ]\d+):\s)/gim;
 	const matches = [];
 	let match$2;
 	while ((match$2 = storyPattern.exec(epicContent)) !== null) {
-		const storyKey = match$2[1] ?? match$2[2] ?? match$2[3];
-		if (storyKey !== void 0) matches.push({
-			storyKey,
-			startIdx: match$2.index
-		});
+		const rawKey = match$2[1] ?? match$2[2] ?? match$2[3];
+		if (rawKey !== void 0) {
+			const storyKey = rawKey.replace(/[._ ]/g, "-");
+			matches.push({
+				storyKey,
+				startIdx: match$2.index
+			});
+		}
 	}
 	if (matches.length === 0) return [{
 		key: epicId,
@@ -43291,11 +43330,11 @@ async function runRunAction(options) {
 			});
 			process.on("SIGINT", () => {
 				ingestionServer.stop();
-				process.exit(130);
+				setTimeout(() => process.exit(130), 6e3).unref();
 			});
 			process.on("SIGTERM", () => {
 				ingestionServer.stop();
-				process.exit(143);
+				setTimeout(() => process.exit(143), 6e3).unref();
 			});
 		}
 		if (telemetryPersistence !== void 0) {
@@ -43825,11 +43864,11 @@ async function runFullPipeline(options) {
 					});
 					process.on("SIGINT", () => {
 						fpIngestionServer.stop();
-						process.exit(130);
+						setTimeout(() => process.exit(130), 6e3).unref();
 					});
 					process.on("SIGTERM", () => {
 						fpIngestionServer.stop();
-						process.exit(143);
+						setTimeout(() => process.exit(143), 6e3).unref();
 					});
 				}
 				const fpTelemetryPersistence = fullTelemetryEnabled ? new AdapterTelemetryPersistence(adapter) : void 0;
@@ -44052,4 +44091,4 @@ function registerRunCommand(program, _version = "0.0.0", projectRoot = process.c
 
 //#endregion
 export { AdapterTelemetryPersistence, AppError, DoltRepoMapMetaRepository, DoltSymbolRepository, ERR_REPO_MAP_STORAGE_WRITE, EpicIngester, GitClient, GrammarLoader, RepoMapInjector, RepoMapModule, RepoMapQueryEngine, RepoMapStorage, SymbolParser, createContextCompiler, createDispatcher, createEventEmitter, createImplementationOrchestrator, createPackLoader, createPhaseOrchestrator, createStopAfterGate, createTelemetryAdvisor, formatPhaseCompletionSummary, getFactoryRunSummaries, getScenarioResultsForRun, getTwinRunsForRun, listGraphRuns, normalizeGraphSummaryToStatus, registerExportCommand, registerFactoryCommand, registerRunCommand, registerScenariosCommand, resolveMaxReviewCycles, resolveStoryKeys, runAnalysisPhase, runPlanningPhase, runRunAction, runSolutioningPhase, validateStopAfterFromConflict, wireNdjsonEmitter };
-//# sourceMappingURL=run-xQLHet2Y.js.map
+//# sourceMappingURL=run-2nI3qh0-.js.map

package/dist/{run-CZW8qqr5.js → run-BNCfGm5V.js}

@@ -2,7 +2,7 @@ import "./health-ZGa9E0D2.js";
 import "./logger-KeHncl-f.js";
 import "./helpers-CElYrONe.js";
 import "./dist-CqtWS9wF.js";
-import { normalizeGraphSummaryToStatus, registerRunCommand, resolveMaxReviewCycles, runRunAction, wireNdjsonEmitter } from "./run-xQLHet2Y.js";
+import { normalizeGraphSummaryToStatus, registerRunCommand, resolveMaxReviewCycles, runRunAction, wireNdjsonEmitter } from "./run-2nI3qh0-.js";
 import "./routing-CcBOCuC9.js";
 import "./decisions-C0pz9Clx.js";
 

package/package.json

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

package/packs/bmad/prompts/create-story.md

@@ -29,6 +29,24 @@ Using the context above, write a complete, implementation-ready story file for s
 Use the title, description, and acceptance criteria from the Story Definition — do NOT substitute
 a different story from the epic scope. The story key, title, and core scope are non-negotiable.
 
+## Input Validation (fail-loud)
+
+Before anything else, verify the input contains the source Acceptance Criteria for story `{{story_key}}`. Scan `Epic Scope` and `Story Definition` for BOTH:
+
+- A heading matching `Story {{story_key}}` (separators: `-`, `.`, `_`, space).
+- An AC-bearing block within that section (`## Acceptance Criteria`, `### Acceptance Criteria`, `**Acceptance Criteria:**`, etc.).
+
+If either is missing — shard truncated, context about other stories only — **do not infer, guess, or hallucinate an AC from the story key or domain priors**. A prior substrate session recorded a shape-specific drift exactly here: no source AC for a "graph builder" story → the agent invented a LanceDB+class-based spec, contradicting the author's explicit "plain JSON adjacency list" directive, purely from a trained pattern.
+
+Instead, emit immediately per the Output Contract below:
+
+```yaml
+result: failure
+error: source-ac-content-missing
+```
+
+Do NOT write a partial story file. Do NOT paraphrase surrounding context. Do NOT dispatch Write. The orchestrator treats this as terminal — the correct outcome when the input pipeline has degraded.
+
 ## Instructions
 
 1. **Use the Story Definition as your primary input** — it specifies exactly what this story builds. The epic scope provides surrounding context only.