substrate-ai 0.19.1 → 0.19.3

package/dist/cli/index.js

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
-import { FileStateStore, SUBSTRATE_OWNED_SETTINGS_KEYS, VALID_PHASES, WorkGraphRepository, buildPipelineStatusOutput, createDatabaseAdapter, createStateStore, detectCycles, findPackageRoot, formatOutput, formatPipelineStatusHuman, formatPipelineSummary, formatTokenTelemetry, getAllDescendantPids, getAutoHealthData, getSubstrateDefaultSettings, parseDbTimestampAsUtc, registerHealthCommand, resolveBmadMethodSrcPath, resolveBmadMethodVersion, resolveMainRepoRoot } from "../health-Cx2ZhRNT.js";
+import { FileStateStore, SUBSTRATE_OWNED_SETTINGS_KEYS, VALID_PHASES, WorkGraphRepository, buildPipelineStatusOutput, createDatabaseAdapter, createStateStore, findPackageRoot, formatOutput, formatPipelineStatusHuman, formatPipelineSummary, formatTokenTelemetry, getAllDescendantPids, getAutoHealthData, getSubstrateDefaultSettings, parseDbTimestampAsUtc, registerHealthCommand, resolveBmadMethodSrcPath, resolveBmadMethodVersion, resolveMainRepoRoot } from "../health-Cx2ZhRNT.js";
 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, EXPERIMENT_RESULT, 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, getSessionCostSummary, getSessionCostSummaryFiltered, getStoryMetricsForRun, getTokenUsageSummary, incrementRunRestarts, initSchema, initializeDolt, listRequirements, listRunMetrics, loadParentRunDecisions, supersedeDecision, tagRunAsBaseline, updatePipelineRun } from "../dist-Bm0qSZer.js";
 import "../adapter-registry-DXLMTmfD.js";
-import { AdapterTelemetryPersistence, AppError, DoltRepoMapMetaRepository, DoltSymbolRepository, ERR_REPO_MAP_STORAGE_WRITE, GitClient, GrammarLoader, RepoMapInjector, RepoMapModule, RepoMapQueryEngine, RepoMapStorage, SymbolParser, createContextCompiler, createDispatcher, createEventEmitter, createImplementationOrchestrator, createPackLoader, createPhaseOrchestrator, createStopAfterGate, createTelemetryAdvisor, formatPhaseCompletionSummary, getFactoryRunSummaries, getScenarioResultsForRun, getTwinRunsForRun, listGraphRuns, registerFactoryCommand, registerRunCommand, registerScenariosCommand, resolveStoryKeys, runAnalysisPhase, runPlanningPhase, runSolutioningPhase, validateStopAfterFromConflict } from "../run-Byzy10gG.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, registerFactoryCommand, registerRunCommand, registerScenariosCommand, resolveStoryKeys, runAnalysisPhase, runPlanningPhase, runSolutioningPhase, validateStopAfterFromConflict } from "../run-IZJRdd9a.js";
 import "../errors-BSpu7pIv.js";
 import "../routing-CcBOCuC9.js";
 import "../decisions-C0pz9Clx.js";
@@ -1605,6 +1605,26 @@ function buildStackAwareDevNotes(profile) {
 //#region src/cli/commands/init.ts
 const logger$15 = createLogger("init");
 const __dirname = dirname(new URL(import.meta.url).pathname);
+const SCAFFOLD_VERSION_REGEX = /<!-- substrate:version=([\d.]+) -->/;
+/**
+* Read the substrate package version from package.json at the given root.
+*/
+function readSubstrateVersion(pkgRoot) {
+	try {
+		const pkg = JSON.parse(readFileSync$1(join(pkgRoot, "package.json"), "utf8"));
+		return pkg.version ?? "0.0.0";
+	} catch {
+		return "0.0.0";
+	}
+}
+/**
+* Extract the version stamped in an existing CLAUDE.md scaffold section.
+* Returns null if no version stamp found.
+*/
+function extractScaffoldVersion(content) {
+	const match = SCAFFOLD_VERSION_REGEX.exec(content);
+	return match?.[1] ?? null;
+}
 const INIT_EXIT_SUCCESS = 0;
 const INIT_EXIT_ERROR = 1;
 const BMAD_FRAMEWORK_DIRS = [
@@ -1671,6 +1691,8 @@ async function scaffoldClaudeMd(projectRoot, profile) {
 		logger$15.warn({ templatePath }, "CLAUDE.md substrate section template not found; skipping");
 		return;
 	}
+	const substrateVersion = readSubstrateVersion(pkgRoot);
+	sectionContent = sectionContent.replace("{{SUBSTRATE_VERSION}}", substrateVersion);
 	if (!sectionContent.endsWith("\n")) sectionContent += "\n";
 	const devNotesSection = buildStackAwareDevNotes(profile ?? null);
 	let existingContent = "";
@@ -1684,8 +1706,11 @@ async function scaffoldClaudeMd(projectRoot, profile) {
 	else newContent = sectionContent;
 	else {
 		let updatedExisting;
-		if (existingContent.includes(CLAUDE_MD_START_MARKER)) updatedExisting = existingContent.replace(new RegExp(`${CLAUDE_MD_START_MARKER.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}[\\s\\S]*?${CLAUDE_MD_END_MARKER.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}`), sectionContent.trimEnd());
-		else {
+		if (existingContent.includes(CLAUDE_MD_START_MARKER)) {
+			const existingVersion = extractScaffoldVersion(existingContent);
+			if (existingVersion && existingVersion !== substrateVersion) process.stderr.write(`Updating CLAUDE.md substrate scaffold from v${existingVersion} → v${substrateVersion}\n`);
+			updatedExisting = existingContent.replace(new RegExp(`${CLAUDE_MD_START_MARKER.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}[\\s\\S]*?${CLAUDE_MD_END_MARKER.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}`), sectionContent.trimEnd());
+		} else {
 			const separator = existingContent.endsWith("\n") ? "\n" : "\n\n";
 			updatedExisting = existingContent + separator + sectionContent;
 		}
@@ -2634,26 +2659,6 @@ function registerConfigCommand(program, _version) {
 	});
 }
 
-//#endregion
-//#region src/modules/work-graph/errors.ts
-/**
-* Work-graph error types.
-*
-* Story 31-7: Cycle Detection in Work Graph
-*/
-/**
-* Thrown by `EpicIngester.ingest()` when the provided dependency list
-* contains a cycle.  The `cycle` field contains the path of story keys
-* that form the cycle (first and last element are the same).
-*/
-var CyclicDependencyError = class extends Error {
-	constructor(cycle) {
-		super(`Cyclic dependency detected: ${cycle.join(" → ")}`);
-		this.cycle = cycle;
-		this.name = "CyclicDependencyError";
-	}
-};
-
 //#endregion
 //#region src/cli/commands/resume.ts
 const logger$13 = createLogger("resume-cmd");
@@ -4542,7 +4547,7 @@ async function runSupervisorAction(options, deps = {}) {
 								await initSchema(expAdapter);
 								const { runRunAction: runPipeline } = await import(
 									/* @vite-ignore */
-									"../run-CzEyqOom.js"
+									"../run-YadN-tFg.js"
 );
 								const runStoryFn = async (opts) => {
 									const exitCode = await runPipeline({
@@ -8620,64 +8625,6 @@ var EpicParser = class {
 	}
 };
 
-//#endregion
-//#region src/modules/work-graph/epic-ingester.ts
-var EpicIngester = class {
-	adapter;
-	constructor(adapter) {
-		this.adapter = adapter;
-	}
-	/**
-	* Upsert stories and sync dependencies into the database.
-	*
-	* Both operations are wrapped in a single transaction: if either fails the
-	* entire batch is rolled back.
-	*
-	* @param stories      - Parsed story metadata from `EpicParser.parseStories()`.
-	* @param dependencies - Parsed dependency edges from `EpicParser.parseDependencies()`.
-	* @returns `IngestResult` with counts of affected rows.
-	*/
-	async ingest(stories, dependencies) {
-		const cycle = detectCycles(dependencies);
-		if (cycle !== null) throw new CyclicDependencyError(cycle);
-		return this.adapter.transaction(async (tx) => {
-			let storiesUpserted = 0;
-			for (const story of stories) {
-				const existing = await tx.query("SELECT status FROM wg_stories WHERE story_key = ?", [story.story_key]);
-				if (existing.length > 0) await tx.query("UPDATE wg_stories SET title = ?, updated_at = ? WHERE story_key = ?", [
-					story.title,
-					new Date().toISOString(),
-					story.story_key
-				]);
-				else {
-					const now = new Date().toISOString();
-					await tx.query("INSERT INTO wg_stories (story_key, epic, title, status, created_at, updated_at) VALUES (?, ?, ?, ?, ?, ?)", [
-						story.story_key,
-						String(story.epic_num),
-						story.title,
-						"planned",
-						now,
-						now
-					]);
-					storiesUpserted++;
-				}
-			}
-			const epicNum = stories.length > 0 ? stories[0].epic_num : null;
-			if (epicNum !== null) await tx.query(`DELETE FROM story_dependencies WHERE source = 'explicit' AND story_key LIKE ?`, [`${epicNum}-%`]);
-			for (const dep of dependencies) await tx.query("INSERT INTO story_dependencies (story_key, depends_on, dependency_type, source) VALUES (?, ?, ?, ?)", [
-				dep.story_key,
-				dep.depends_on,
-				dep.dependency_type,
-				dep.source
-			]);
-			return {
-				storiesUpserted,
-				dependenciesReplaced: dependencies.length
-			};
-		});
-	}
-};
-
 //#endregion
 //#region src/cli/commands/ingest-epic.ts
 function registerIngestEpicCommand(program) {

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

@@ -1,4 +1,5 @@
 <!-- substrate:start -->
+<!-- substrate:version={{SUBSTRATE_VERSION}} -->
 ## Substrate Pipeline
 
 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.