substrate-ai 0.1.12 → 0.1.14

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 AI Dev Toolkit Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/cli/index.js

@@ -23,6 +23,7 @@ import * as readline$1 from "readline";
 import * as readline from "readline";
 import { createInterface as createInterface$1 } from "readline";
 import { randomUUID as randomUUID$1 } from "crypto";
+import { createRequire } from "node:module";
 
 //#region src/cli/utils/formatting.ts
 /**
@@ -10179,6 +10180,109 @@ function createImplementationOrchestrator(deps) {
 	};
 }
 
+//#endregion
+//#region src/modules/implementation-orchestrator/story-discovery.ts
+/**
+* Extract all story keys (N-M format) from epics.md content.
+*
+* Supports three extraction patterns found in real epics.md files:
+*   1. Explicit key lines:  **Story key:** `7-2-human-turn-loop`  → extracts "7-2"
+*   2. Story headings:      ### Story 7.2: Human Turn Loop        → extracts "7-2"
+*   3. File path refs:      _bmad-output/implementation-artifacts/7-2-human-turn-loop.md → extracts "7-2"
+*
+* Keys are deduplicated and sorted numerically (epic number primary, story number secondary).
+*
+* @param content - Raw string content of epics.md
+* @returns Sorted, deduplicated array of story key strings in "N-M" format
+*/
+function parseStoryKeysFromEpics(content) {
+	if (content.length === 0) return [];
+	const keys = new Set();
+	const explicitKeyPattern = /\*\*Story key:\*\*\s*`?(\d+-\d+)(?:-[^`\s]*)?`?/g;
+	let match;
+	while ((match = explicitKeyPattern.exec(content)) !== null) if (match[1] !== void 0) keys.add(match[1]);
+	const headingPattern = /^###\s+Story\s+(\d+)\.(\d+)/gm;
+	while ((match = headingPattern.exec(content)) !== null) if (match[1] !== void 0 && match[2] !== void 0) keys.add(`${match[1]}-${match[2]}`);
+	const filePathPattern = /_bmad-output\/implementation-artifacts\/(\d+-\d+)-/g;
+	while ((match = filePathPattern.exec(content)) !== null) if (match[1] !== void 0) keys.add(match[1]);
+	return sortStoryKeys(Array.from(keys));
+}
+/**
+* Discover pending story keys by diffing epics.md against existing story files.
+*
+* Algorithm:
+*   1. Read _bmad-output/planning-artifacts/epics.md (falls back to _bmad-output/epics.md)
+*   2. Extract all story keys from epics.md
+*   3. Glob _bmad-output/implementation-artifacts/ for N-M-*.md files
+*   4. Return keys from step 2 that are NOT in step 3 (pending work)
+*
+* Returns an empty array (without error) if epics.md does not exist.
+*
+* @param projectRoot - Absolute path to the project root directory
+* @returns Sorted array of pending story keys in "N-M" format
+*/
+function discoverPendingStoryKeys(projectRoot) {
+	const epicsPath = findEpicsFile(projectRoot);
+	if (epicsPath === void 0) return [];
+	let content;
+	try {
+		content = readFileSync$1(epicsPath, "utf-8");
+	} catch {
+		return [];
+	}
+	const allKeys = parseStoryKeysFromEpics(content);
+	if (allKeys.length === 0) return [];
+	const existingKeys = collectExistingStoryKeys(projectRoot);
+	return allKeys.filter((k) => !existingKeys.has(k));
+}
+/**
+* Find epics.md from known candidate paths relative to projectRoot.
+*/
+function findEpicsFile(projectRoot) {
+	const candidates = ["_bmad-output/planning-artifacts/epics.md", "_bmad-output/epics.md"];
+	for (const candidate of candidates) {
+		const fullPath = join$1(projectRoot, candidate);
+		if (existsSync$1(fullPath)) return fullPath;
+	}
+	return void 0;
+}
+/**
+* Collect story keys that already have implementation artifact files.
+* Scans _bmad-output/implementation-artifacts/ for files matching N-M-*.md.
+*/
+function collectExistingStoryKeys(projectRoot) {
+	const existing = new Set();
+	const artifactsDir = join$1(projectRoot, "_bmad-output", "implementation-artifacts");
+	if (!existsSync$1(artifactsDir)) return existing;
+	let entries;
+	try {
+		entries = readdirSync$1(artifactsDir);
+	} catch {
+		return existing;
+	}
+	const filePattern = /^(\d+-\d+)-/;
+	for (const entry of entries) {
+		const name = typeof entry === "string" ? entry : entry.name;
+		if (!name.endsWith(".md")) continue;
+		const m = filePattern.exec(name);
+		if (m !== null && m[1] !== void 0) existing.add(m[1]);
+	}
+	return existing;
+}
+/**
+* Sort story keys numerically by epic number (primary) then story number (secondary).
+* E.g. ["10-1", "1-2", "2-1"] → ["1-2", "2-1", "10-1"]
+*/
+function sortStoryKeys(keys) {
+	return keys.slice().sort((a, b) => {
+		const [ae, as_] = a.split("-").map(Number);
+		const [be, bs] = b.split("-").map(Number);
+		const epicDiff = (ae ?? 0) - (be ?? 0);
+		if (epicDiff !== 0) return epicDiff;
+		return (as_ ?? 0) - (bs ?? 0);
+	});
+}
+
 //#endregion
 //#region src/modules/phase-orchestrator/built-in-phases.ts
 function logPhase(message) {
@@ -12117,12 +12221,47 @@ Analyze thoroughly and return ONLY the JSON array with no additional text.`;
 const __filename = fileURLToPath$1(import.meta.url);
 const __dirname = dirname(__filename);
 /**
-* Absolute path to the Substrate package root.
-*
-* In source:  src/cli/commands/ → 3 levels up = repo root
-* Post-build: dist/cli/commands/ → 3 levels up = dist parent = package root
+* Find the package root by walking up until we find package.json.
+* Works regardless of build output structure (tsdown bundles into
+* dist/cli/index.js, not dist/cli/commands/auto.js).
 */
+function findPackageRoot(startDir) {
+	let dir = startDir;
+	while (dir !== dirname(dir)) {
+		if (existsSync(join(dir, "package.json"))) return dir;
+		dir = dirname(dir);
+	}
+	return startDir;
+}
 const PACKAGE_ROOT = join(__dirname, "..", "..", "..");
+/**
+* Resolve the absolute path to the bmad-method package's src/ directory.
+* Uses createRequire so it works in ESM without import.meta.resolve polyfills.
+* Returns null if bmad-method is not installed.
+*/
+function resolveBmadMethodSrcPath(fromDir = __dirname) {
+	try {
+		const require = createRequire(join(fromDir, "synthetic.js"));
+		const pkgJsonPath = require.resolve("bmad-method/package.json");
+		return join(dirname(pkgJsonPath), "src");
+	} catch {
+		return null;
+	}
+}
+/**
+* Read the version field from bmad-method's package.json.
+* Returns 'unknown' if not resolvable.
+*/
+function resolveBmadMethodVersion(fromDir = __dirname) {
+	try {
+		const require = createRequire(join(fromDir, "synthetic.js"));
+		const pkgJsonPath = require.resolve("bmad-method/package.json");
+		const pkg = require(pkgJsonPath);
+		return pkg.version ?? "unknown";
+	} catch {
+		return "unknown";
+	}
+}
 const logger$3 = createLogger("auto-cmd");
 /** BMAD baseline token total for full pipeline comparison (analysis+planning+solutioning+implementation) */
 const BMAD_BASELINE_TOKENS_FULL = 56800;
@@ -12321,6 +12460,70 @@ function formatPipelineSummary(run, tokenSummary, decisionsCount, storiesCount,
 	];
 	return lines.join("\n");
 }
+/**
+* Subdirectories of bmad-method/src/ that constitute the framework.
+* tea/ is an optional add-on that may or may not be present in the package.
+*/
+const BMAD_FRAMEWORK_DIRS = [
+	"core",
+	"bmm",
+	"tea"
+];
+/**
+* Scaffold the BMAD framework from the bmad-method npm dependency into
+* <projectRoot>/_bmad/.
+*
+* Behaviour:
+* - If _bmad/ already exists and --force is NOT set → skip silently.
+* - If _bmad/ already exists and --force IS set → warn and replace.
+* - Copies each of BMAD_FRAMEWORK_DIRS from bmad-method/src/ that exist.
+* - Generates a minimal _config/config.yaml stub if it doesn't already exist.
+* - Logs "Scaffolding BMAD framework from bmad-method@<version>".
+*/
+async function scaffoldBmadFramework(projectRoot, force, outputFormat) {
+	const bmadDest = join(projectRoot, "_bmad");
+	const bmadExists = existsSync(bmadDest);
+	if (bmadExists && !force) return;
+	const bmadSrc = resolveBmadMethodSrcPath();
+	if (!bmadSrc) {
+		if (outputFormat !== "json") process.stderr.write("Warning: bmad-method is not installed. BMAD framework not scaffolded. Run: npm install bmad-method\n");
+		return;
+	}
+	const version = resolveBmadMethodVersion();
+	if (force && bmadExists) process.stderr.write(`Warning: Replacing existing _bmad/ framework with bmad-method@${version}\n`);
+	process.stdout.write(`Scaffolding BMAD framework from bmad-method@${version}\n`);
+	logger$3.info({
+		version,
+		dest: bmadDest
+	}, "Scaffolding BMAD framework");
+	for (const dir of BMAD_FRAMEWORK_DIRS) {
+		const srcDir = join(bmadSrc, dir);
+		if (existsSync(srcDir)) {
+			const destDir = join(bmadDest, dir);
+			mkdirSync(destDir, { recursive: true });
+			cpSync(srcDir, destDir, { recursive: true });
+			logger$3.info({
+				dir,
+				dest: destDir
+			}, "Scaffolded BMAD framework directory");
+		}
+	}
+	const configDir = join(bmadDest, "_config");
+	const configFile = join(configDir, "config.yaml");
+	if (!existsSync(configFile)) {
+		mkdirSync(configDir, { recursive: true });
+		const configStub = [
+			"# BMAD framework configuration",
+			`# Scaffolded from bmad-method@${version} by substrate auto init`,
+			"# This file is project-specific — customize as needed.",
+			"user_name: Human",
+			"communication_language: English",
+			"document_output_language: English"
+		].join("\n") + "\n";
+		await writeFile(configFile, configStub, "utf8");
+		logger$3.info({ configFile }, "Generated _bmad/_config/config.yaml stub");
+	}
+}
 async function runAutoInit(options) {
 	const { pack: packName, projectRoot, outputFormat, force = false } = options;
 	const packPath = join(projectRoot, "packs", packName);
@@ -12328,10 +12531,12 @@ async function runAutoInit(options) {
 	const dbDir = join(dbRoot, ".substrate");
 	const dbPath = join(dbDir, "substrate.db");
 	try {
+		await scaffoldBmadFramework(projectRoot, force, outputFormat);
 		const localManifest = join(packPath, "manifest.yaml");
 		let scaffolded = false;
 		if (!existsSync(localManifest) || force) {
-			const bundledPackPath = join(PACKAGE_ROOT, "packs", packName);
+			const packageRoot = findPackageRoot(__dirname);
+			const bundledPackPath = join(packageRoot, "packs", packName);
 			if (!existsSync(join(bundledPackPath, "manifest.yaml"))) {
 				const errorMsg = `Pack '${packName}' not found locally or in bundled packs. Try reinstalling Substrate.`;
 				if (outputFormat === "json") process.stdout.write(formatOutput(null, "json", false, errorMsg) + "\n");
@@ -12493,6 +12698,10 @@ async function runAutoRun(options) {
 				} catch {}
 				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`);
+			}
 			if (storyKeys.length === 0) {
 				if (outputFormat === "human") process.stdout.write("No pending stories found in decision store.\n");
 				else process.stdout.write(formatOutput({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "substrate-ai",
-  "version": "0.1.12",
+  "version": "0.1.14",
   "description": "Substrate — multi-agent orchestration daemon for AI coding agents",
   "type": "module",
   "license": "MIT",
@@ -59,6 +59,7 @@
   "dependencies": {
     "@types/better-sqlite3": "^7.6.13",
     "better-sqlite3": "^12.6.2",
+    "bmad-method": "^6.0.3",
     "commander": "^12.1.0",
     "js-yaml": "^4.1.1",
     "pino": "^9.6.0",