substrate-ai 0.8.1 → 0.8.3

package/dist/cli/index.js

@@ -2,7 +2,7 @@
 import { DoltClient, DoltNotInstalled, FileStateStore, SUBSTRATE_OWNED_SETTINGS_KEYS, VALID_PHASES, WorkGraphRepository, buildPipelineStatusOutput, checkDoltInstalled, createDatabaseAdapter, createDoltClient, createStateStore, detectCycles, findPackageRoot, formatOutput, formatPipelineStatusHuman, formatPipelineSummary, formatTokenTelemetry, getAllDescendantPids, getAutoHealthData, getSubstrateDefaultSettings, initSchema, initializeDolt, isSyncAdapter, parseDbTimestampAsUtc, registerHealthCommand, resolveBmadMethodSrcPath, resolveBmadMethodVersion, resolveMainRepoRoot } from "../health-C-VRJruD.js";
 import { createLogger } from "../logger-D2fS2ccL.js";
 import { AdapterRegistry } from "../adapter-registry-D2zdMwVu.js";
-import { AdapterTelemetryPersistence, AppError, DEFAULT_CONFIG, DEFAULT_ROUTING_POLICY, DoltRepoMapMetaRepository, DoltSymbolRepository, ERR_REPO_MAP_STORAGE_WRITE, GitClient, GrammarLoader, IngestionServer, RepoMapInjector, RepoMapModule, RepoMapQueryEngine, RepoMapStorage, SymbolParser, createConfigSystem, createContextCompiler, createDispatcher, createEventEmitter, createImplementationOrchestrator, createPackLoader, createPhaseOrchestrator, createStopAfterGate, createTelemetryAdvisor, formatPhaseCompletionSummary, registerRunCommand, resolveStoryKeys, runAnalysisPhase, runPlanningPhase, runSolutioningPhase, validateStopAfterFromConflict } from "../run-VMOBJZ7f.js";
+import { AdapterTelemetryPersistence, AppError, DEFAULT_CONFIG, DEFAULT_ROUTING_POLICY, DoltRepoMapMetaRepository, DoltSymbolRepository, ERR_REPO_MAP_STORAGE_WRITE, GitClient, GrammarLoader, IngestionServer, RepoMapInjector, RepoMapModule, RepoMapQueryEngine, RepoMapStorage, SymbolParser, createConfigSystem, createContextCompiler, createDispatcher, createEventEmitter, createImplementationOrchestrator, createPackLoader, createPhaseOrchestrator, createStopAfterGate, createTelemetryAdvisor, formatPhaseCompletionSummary, registerRunCommand, resolveStoryKeys, runAnalysisPhase, runPlanningPhase, runSolutioningPhase, validateStopAfterFromConflict } from "../run-CG1LOXIa.js";
 import { CURRENT_CONFIG_FORMAT_VERSION, CURRENT_TASK_GRAPH_VERSION, PartialSubstrateConfigSchema } from "../config-migrator-CtGelIsG.js";
 import { ConfigError, createEventBus } from "../helpers-CpMs8VZX.js";
 import { RoutingRecommender } from "../routing-BVrxrM6v.js";
@@ -15,7 +15,7 @@ import { Command } from "commander";
 import { fileURLToPath } from "url";
 import { dirname, join, resolve } from "path";
 import { access, mkdir, readFile, writeFile } from "fs/promises";
-import { chmodSync, cpSync, existsSync, mkdirSync, readFileSync, readdirSync, realpathSync, statSync, unlinkSync, writeFileSync } from "fs";
+import { appendFileSync, chmodSync, cpSync, existsSync, mkdirSync, readFileSync, readdirSync, realpathSync, statSync, unlinkSync, writeFileSync } from "fs";
 import yaml from "js-yaml";
 import { createRequire } from "node:module";
 import * as path$2 from "node:path";
@@ -272,49 +272,56 @@ const STACK_MARKERS = [
 		language: "go",
 		buildTool: "go",
 		buildCommand: "go build ./...",
-		testCommand: "go test ./..."
+		testCommand: "go test ./...",
+		installCommand: "go get <package>"
 	},
 	{
 		file: "build.gradle.kts",
 		language: "kotlin",
 		buildTool: "gradle",
 		buildCommand: "./gradlew build",
-		testCommand: "./gradlew test"
+		testCommand: "./gradlew test",
+		installCommand: "add dependency to build.gradle.kts"
 	},
 	{
 		file: "build.gradle",
 		language: "java",
 		buildTool: "gradle",
 		buildCommand: "./gradlew build",
-		testCommand: "./gradlew test"
+		testCommand: "./gradlew test",
+		installCommand: "add dependency to build.gradle"
 	},
 	{
 		file: "pom.xml",
 		language: "java",
 		buildTool: "maven",
 		buildCommand: "mvn compile",
-		testCommand: "mvn test"
+		testCommand: "mvn test",
+		installCommand: "add dependency to pom.xml"
 	},
 	{
 		file: "Cargo.toml",
 		language: "rust",
 		buildTool: "cargo",
 		buildCommand: "cargo build",
-		testCommand: "cargo test"
+		testCommand: "cargo test",
+		installCommand: "cargo add <package>"
 	},
 	{
 		file: "pyproject.toml",
 		language: "python",
 		buildTool: "pip",
 		buildCommand: "pip install -e .",
-		testCommand: "pytest"
+		testCommand: "pytest",
+		installCommand: "pip install <package>"
 	},
 	{
 		file: "package.json",
 		language: "typescript",
 		buildTool: "npm",
 		buildCommand: "npm run build",
-		testCommand: "npm test"
+		testCommand: "npm test",
+		installCommand: "npm install <package>"
 	}
 ];
 async function fileExists(filePath) {
@@ -333,22 +340,26 @@ async function detectNodeBuildTool(dir) {
 	if (await fileExists(path$2.join(dir, "pnpm-lock.yaml"))) return {
 		buildTool: "pnpm",
 		buildCommand: "pnpm run build",
-		testCommand: "pnpm test"
+		testCommand: "pnpm test",
+		installCommand: "pnpm add <package>"
 	};
 	if (await fileExists(path$2.join(dir, "yarn.lock"))) return {
 		buildTool: "yarn",
 		buildCommand: "yarn build",
-		testCommand: "yarn test"
+		testCommand: "yarn test",
+		installCommand: "yarn add <package>"
 	};
 	if (await fileExists(path$2.join(dir, "bun.lockb"))) return {
 		buildTool: "bun",
 		buildCommand: "bun run build",
-		testCommand: "bun test"
+		testCommand: "bun test",
+		installCommand: "bun add <package>"
 	};
 	return {
 		buildTool: "npm",
 		buildCommand: "npm run build",
-		testCommand: "npm test"
+		testCommand: "npm test",
+		installCommand: "npm install <package>"
 	};
 }
 /**
@@ -372,7 +383,8 @@ async function detectSingleProjectStack(dir) {
 				language: "typescript",
 				buildTool: nodeInfo.buildTool,
 				buildCommand: nodeInfo.buildCommand,
-				testCommand: nodeInfo.testCommand
+				testCommand: nodeInfo.testCommand,
+				installCommand: nodeInfo.installCommand
 			};
 		}
 		if (marker.file === "pyproject.toml") {
@@ -382,7 +394,8 @@ async function detectSingleProjectStack(dir) {
 				language: "python",
 				buildTool: hasPoetry ? "poetry" : "pip",
 				buildCommand: hasPoetry ? "poetry build" : "pip install -e .",
-				testCommand: "pytest"
+				testCommand: "pytest",
+				installCommand: hasPoetry ? "poetry add <package>" : "pip install <package>"
 			};
 		}
 		return {
@@ -390,7 +403,8 @@ async function detectSingleProjectStack(dir) {
 			language: marker.language,
 			buildTool: marker.buildTool,
 			buildCommand: marker.buildCommand,
-			testCommand: marker.testCommand
+			testCommand: marker.testCommand,
+			installCommand: marker.installCommand
 		};
 	}
 	return {
@@ -398,7 +412,8 @@ async function detectSingleProjectStack(dir) {
 		language: "typescript",
 		buildTool: "npm",
 		buildCommand: "npm run build",
-		testCommand: "npm test"
+		testCommand: "npm test",
+		installCommand: "npm install <package>"
 	};
 }
 /**
@@ -435,6 +450,7 @@ async function detectMonorepoProfile(rootDir) {
 		tool: "turborepo",
 		buildCommand: "npx turbo build",
 		testCommand: "npx turbo test",
+		installCommand: "npm install <package>",
 		packages
 	} };
 }
@@ -469,6 +485,7 @@ async function detectProjectProfile(rootDir) {
 		framework: stackEntry.framework,
 		buildCommand: stackEntry.buildCommand ?? "npm run build",
 		testCommand: stackEntry.testCommand ?? "npm test",
+		installCommand: stackEntry.installCommand ?? "npm install <package>",
 		packages: []
 	} };
 }
@@ -1190,6 +1207,19 @@ async function runInitAction(options) {
 		await scaffoldStatuslineScript(projectRoot);
 		await scaffoldClaudeSettings(projectRoot);
 		await scaffoldClaudeCommands(projectRoot, outputFormat);
+		const gitignorePath = join(projectRoot, ".gitignore");
+		const runtimeEntries = [".substrate/orchestrator.pid", ".substrate/current-run-id"];
+		try {
+			const existing = existsSync(gitignorePath) ? readFileSync(gitignorePath, "utf-8") : "";
+			const missing = runtimeEntries.filter((e) => !existing.includes(e));
+			if (missing.length > 0) {
+				const block = "\n# Substrate runtime files\n" + missing.join("\n") + "\n";
+				appendFileSync(gitignorePath, block);
+				logger$18.info({ entries: missing }, "Added substrate runtime files to .gitignore");
+			}
+		} catch (err) {
+			logger$18.debug({ err }, "Could not update .gitignore (non-fatal)");
+		}
 		const doltMode = options.doltMode ?? "auto";
 		let doltInitialized = false;
 		if (doltMode !== "skip") try {
@@ -3516,7 +3546,7 @@ async function runSupervisorAction(options, deps = {}) {
 								await initSchema(expAdapter);
 								const { runRunAction: runPipeline } = await import(
 									/* @vite-ignore */
-									"../run-C2dsqnZU.js"
+									"../run-CoRKAliC.js"
 );
 								const runStoryFn = async (opts) => {
 									const exitCode = await runPipeline({

package/dist/{run-VMOBJZ7f.js → run-CG1LOXIa.js}

@@ -7196,6 +7196,41 @@ function resolveDefaultTestPatterns(projectRoot) {
 	return VITEST_DEFAULT_PATTERNS;
 }
 
+//#endregion
+//#region src/modules/compiled-workflows/install-command.ts
+/**
+* Returns the install command string for the current project.
+* Used as a template variable ({{install_command}}) in the dev-story prompt.
+*/
+function resolveInstallCommand(projectRoot) {
+	if (!projectRoot) return "the appropriate package install command for this project";
+	const profilePath = join$1(projectRoot, ".substrate", "project-profile.yaml");
+	if (!existsSync$1(profilePath)) return "the appropriate package install command for this project";
+	try {
+		const content = readFileSync$1(profilePath, "utf-8");
+		const match$1 = content.match(/^\s*installCommand:\s*['"]?(.+?)['"]?\s*$/m);
+		if (match$1?.[1]) return match$1[1];
+		const toolMatch = content.match(/^\s*buildTool:\s*['"]?(\w+)['"]?\s*$/m);
+		if (toolMatch?.[1]) {
+			const tool = toolMatch[1];
+			const commands = {
+				npm: "npm install <package>",
+				pnpm: "pnpm add <package>",
+				yarn: "yarn add <package>",
+				bun: "bun add <package>",
+				go: "go get <package>",
+				cargo: "cargo add <package>",
+				pip: "pip install <package>",
+				poetry: "poetry add <package>",
+				gradle: "add dependency to build.gradle",
+				maven: "add dependency to pom.xml"
+			};
+			return commands[tool] ?? "the appropriate package install command for this project";
+		}
+	} catch {}
+	return "the appropriate package install command for this project";
+}
+
 //#endregion
 //#region src/modules/compiled-workflows/dev-story.ts
 const logger$16 = createLogger("compiled-workflows:dev-story");
@@ -7419,6 +7454,11 @@ async function runDevStory(deps, params) {
 			name: "verify_command",
 			content: deps.pack.manifest.verifyCommand !== false ? deps.pack.manifest.verifyCommand ?? "npx turbo build" : "",
 			priority: "optional"
+		},
+		{
+			name: "install_command",
+			content: resolveInstallCommand(deps.projectRoot),
+			priority: "optional"
 		}
 	];
 	const { prompt, tokenCount, truncated } = assemblePrompt(template, sections, TOKEN_CEILING);
@@ -14509,12 +14549,42 @@ function createImplementationOrchestrator(deps) {
 		}
 		endPhase(storyKey, "dev-story");
 		{
-			const buildVerifyResult = config.skipBuildVerify === true ? { status: "skipped" } : runBuildVerification({
+			let buildVerifyResult = config.skipBuildVerify === true ? { status: "skipped" } : runBuildVerification({
 				verifyCommand: pack.manifest.verifyCommand,
 				verifyTimeoutMs: pack.manifest.verifyTimeoutMs,
 				projectRoot: projectRoot ?? process.cwd(),
 				changedFiles: gitDiffFiles
 			});
+			if (buildVerifyResult.status === "passed") {
+				const resolvedRootForTsc = projectRoot ?? process.cwd();
+				const tscBin = join$1(resolvedRootForTsc, "node_modules", ".bin", "tsc");
+				const hasTsc = existsSync$1(tscBin) && existsSync$1(join$1(resolvedRootForTsc, "tsconfig.json"));
+				if (hasTsc) try {
+					execSync(`"${tscBin}" --noEmit`, {
+						cwd: resolvedRootForTsc,
+						timeout: 12e4,
+						encoding: "utf-8",
+						stdio: [
+							"pipe",
+							"pipe",
+							"pipe"
+						]
+					});
+					logger$25.info({ storyKey }, "Secondary typecheck (tsc --noEmit) passed");
+				} catch (tscErr) {
+					const tscOutput = tscErr instanceof Error && "stdout" in tscErr ? String(tscErr.stdout ?? "").slice(0, 2e3) : "";
+					logger$25.warn({
+						storyKey,
+						tscOutput
+					}, "Secondary typecheck (tsc --noEmit) failed — treating as build failure");
+					buildVerifyResult = {
+						status: "failed",
+						exitCode: 2,
+						output: `tsc --noEmit failed:\n${tscOutput}`,
+						reason: "build-verification-failed"
+					};
+				}
+			}
 			if (buildVerifyResult.status === "passed") {
 				eventBus.emit("story:build-verification-passed", { storyKey });
 				logger$25.info({ storyKey }, "Build verification passed");
@@ -21325,4 +21395,4 @@ function registerRunCommand(program, _version = "0.0.0", projectRoot = process.c
 
 //#endregion
 export { AdapterTelemetryPersistence, AppError, DEFAULT_CONFIG, DEFAULT_ROUTING_POLICY, DoltRepoMapMetaRepository, DoltSymbolRepository, ERR_REPO_MAP_STORAGE_WRITE, GitClient, GrammarLoader, IngestionServer, RepoMapInjector, RepoMapModule, RepoMapQueryEngine, RepoMapStorage, SymbolParser, createConfigSystem, createContextCompiler, createDispatcher, createEventEmitter, createImplementationOrchestrator, createPackLoader, createPhaseOrchestrator, createStopAfterGate, createTelemetryAdvisor, formatPhaseCompletionSummary, registerRunCommand, resolveStoryKeys, runAnalysisPhase, runPlanningPhase, runRunAction, runSolutioningPhase, validateStopAfterFromConflict };
-//# sourceMappingURL=run-VMOBJZ7f.js.map
+//# sourceMappingURL=run-CG1LOXIa.js.map

package/dist/{run-C2dsqnZU.js → run-CoRKAliC.js}

@@ -1,6 +1,6 @@
 import "./health-C-VRJruD.js";
 import "./logger-D2fS2ccL.js";
-import { registerRunCommand, runRunAction } from "./run-VMOBJZ7f.js";
+import { registerRunCommand, runRunAction } from "./run-CG1LOXIa.js";
 import "./config-migrator-CtGelIsG.js";
 import "./helpers-CpMs8VZX.js";
 import "./routing-BVrxrM6v.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "substrate-ai",
-  "version": "0.8.1",
+  "version": "0.8.3",
   "description": "Substrate — multi-agent orchestration daemon for AI coding agents",
   "type": "module",
   "license": "MIT",
@@ -44,6 +44,7 @@
     "README.md"
   ],
   "scripts": {
+    "agent-memory:bootstrap": "node scripts/bootstrap-agent-memory.mjs",
     "build": "tsdown",
     "postbuild": "cp -r src/cli/templates dist/cli/templates && cp src/modules/state/schema.sql dist/schema.sql",
     "dev": "tsx watch src/cli/index.ts",

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

@@ -39,7 +39,7 @@ Implement the story above completely. Follow tasks in exact order. Do not stop u
    - Make tests pass with minimal code
    - Refactor while keeping tests green
    - **Use exact names from the story spec.** When the story specifies a field, variable, class, or method name, use that exact name in your implementation. Only deviate if the name would cause a compilation error (e.g., conflicts with a reserved word or inherited property), and add a code comment explaining why.
-   - **If you import a new package that is not already in package.json, install it immediately** (`npm install <package>` or the appropriate workspace command). The build verification gate runs after dev-story — missing dependencies will fail the build and escalate the story.
+   - **If you import a new package that is not already installed, install it immediately** (`{{install_command}}` or the appropriate workspace command). The build verification gate runs after dev-story — missing dependencies will fail the build and escalate the story.
 
 3. **After each task**:
    - Verify tests pass