substrate-ai 0.2.17 → 0.2.19

package/README.md

@@ -4,7 +4,7 @@
 
 # Substrate
 
-Substrate is an autonomous software development pipeline you operate from Claude Code. Describe your project, and Substrate coordinates multiple AI coding agents (Claude Code, Codex, Gemini CLI) working in parallel across isolated branches — from concept through implementation and code review. A built-in supervisor watches for stalls, auto-recovers, and after each run analyzes what happened and experiments with improvements — closing the loop automatically.
+Most multi-agent coding tools help you run AI sessions in parallel — but leave planning, quality control, and learning up to you. Substrate is different: it packages structured planning methodology, multi-agent parallel execution, automated code review cycles, and self-improvement into a single pipeline. Describe your project concept, and Substrate takes it from analysis through implementation and review — coordinating multiple AI coding agents (Claude Code, Codex, Gemini CLI) across isolated worktree branches while a supervisor watches for stalls, auto-recovers, and after each run experiments with improvements to close the loop automatically.
 
 Unlike API-based orchestrators, Substrate routes work through the CLI tools you already have installed, maximizing your existing AI subscriptions before falling back to pay-per-token billing. Runs are persistent and resumable with full cost visibility across every provider.
 

package/dist/cli/index.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { DatabaseWrapper, SUBSTRATE_OWNED_SETTINGS_KEYS, VALID_PHASES, buildPipelineStatusOutput, createContextCompiler, createDispatcher, createImplementationOrchestrator, createPackLoader, createPhaseOrchestrator, createStopAfterGate, findPackageRoot, formatOutput, formatPhaseCompletionSummary, formatPipelineStatusHuman, formatPipelineSummary, formatTokenTelemetry, getAllDescendantPids, getAutoHealthData, getSubstrateDefaultSettings, registerHealthCommand, registerRunCommand, resolveBmadMethodSrcPath, resolveBmadMethodVersion, resolveMainRepoRoot, runAnalysisPhase, runMigrations, runPlanningPhase, runSolutioningPhase, validateStopAfterFromConflict } from "../run-CLpXJNQ8.js";
+import { DatabaseWrapper, SUBSTRATE_OWNED_SETTINGS_KEYS, VALID_PHASES, buildPipelineStatusOutput, createContextCompiler, createDispatcher, createImplementationOrchestrator, createPackLoader, createPhaseOrchestrator, createStopAfterGate, findPackageRoot, formatOutput, formatPhaseCompletionSummary, formatPipelineStatusHuman, formatPipelineSummary, formatTokenTelemetry, getAllDescendantPids, getAutoHealthData, getSubstrateDefaultSettings, registerHealthCommand, registerRunCommand, resolveBmadMethodSrcPath, resolveBmadMethodVersion, resolveMainRepoRoot, runAnalysisPhase, runMigrations, runPlanningPhase, runSolutioningPhase, validateStopAfterFromConflict } from "../run-mFmS2pw6.js";
 import { createLogger, deepMask } from "../logger-D2fS2ccL.js";
 import { AdapterRegistry, createEventBus } from "../event-bus-BMxhfxfT.js";
 import { CURRENT_CONFIG_FORMAT_VERSION, CURRENT_TASK_GRAPH_VERSION, PartialSubstrateConfigSchema, SUPPORTED_CONFIG_FORMAT_VERSIONS, SubstrateConfigSchema, defaultConfigMigrator } from "../version-manager-impl-CZ6KF1Ds.js";
@@ -2842,7 +2842,7 @@ async function runSupervisorAction(options, deps = {}) {
 								const expDb = expDbWrapper.db;
 								const { runRunAction: runPipeline } = await import(
 									/* @vite-ignore */
-									"../run-DPrhfU2T.js"
+									"../run-CUGB4FQx.js"
 );
 								const runStoryFn = async (opts) => {
 									const exitCode = await runPipeline({

package/dist/{run-DPrhfU2T.js → run-CUGB4FQx.js}

@@ -1,4 +1,4 @@
-import { registerRunCommand, runRunAction } from "./run-CLpXJNQ8.js";
+import { registerRunCommand, runRunAction } from "./run-mFmS2pw6.js";
 import "./logger-D2fS2ccL.js";
 import "./event-bus-BMxhfxfT.js";
 import "./decisions-Dq4cAA2L.js";

package/dist/{run-CLpXJNQ8.js → run-mFmS2pw6.js}

@@ -2806,7 +2806,24 @@ function extractYamlBlock(output) {
 	if (!output || output.trim() === "") return null;
 	const fencedResult = extractLastFencedYaml(output);
 	if (fencedResult !== null) return fencedResult;
-	return extractUnfencedYaml(output);
+	const stripped = stripTrailingFence(output);
+	return extractUnfencedYaml(stripped);
+}
+/**
+* Strip a trailing markdown fence that wraps the entire remaining output.
+* Handles: "```yaml\nverdict: ...\n```" → "verdict: ..."
+*/
+function stripTrailingFence(output) {
+	const trimmed = output.trimEnd();
+	if (!trimmed.endsWith("```")) return output;
+	const body = trimmed.slice(0, -3).trimEnd();
+	const lastOpen = body.lastIndexOf("```");
+	if (lastOpen === -1) return output;
+	const beforeFence = body.slice(0, lastOpen);
+	const fenceLine = body.slice(lastOpen);
+	if (beforeFence.length > 0 && !beforeFence.endsWith("\n")) return output;
+	const afterOpen = fenceLine.replace(/^```(?:yaml)?\s*\n?/, "");
+	return beforeFence + afterOpen;
 }
 /**
 * Find all fenced YAML blocks (```yaml...``` or ```...```) and return the last one.
@@ -2907,7 +2924,7 @@ const MIN_FREE_MEMORY_BYTES = (() => {
 		const parsed = parseInt(envMB, 10);
 		if (!isNaN(parsed) && parsed >= 0) return parsed * 1024 * 1024;
 	}
-	return 512 * 1024 * 1024;
+	return 256 * 1024 * 1024;
 })();
 const MEMORY_PRESSURE_POLL_MS = 1e4;
 /**
@@ -2920,7 +2937,12 @@ const MEMORY_PRESSURE_POLL_MS = 1e4;
 *
 * New approach:
 * 1. Check kern.memorystatus_vm_pressure_level — the kernel's own assessment.
-*    Level >= 2 (warn/critical) means the system is already pressured.
+*    Level 4 (critical) = hard gate, return 0.
+*    Level 2 (warn) = halve the vm_stat estimate as a conservative signal.
+*    Level 1 (normal) = trust vm_stat as-is.
+*    Note: level 2 fires frequently on macOS when the compressor is active,
+*    even with gigabytes of reclaimable memory. Hard-gating at 2 caused
+*    false stalls on 24GB+ machines with >50% free RAM.
 * 2. Use a conservative page calculation: free + purgeable + speculative.
 *    These categories are truly reclaimable without I/O or decompression.
 *    Inactive pages are excluded because they may require disk I/O,
@@ -2928,13 +2950,14 @@ const MEMORY_PRESSURE_POLL_MS = 1e4;
 */
 function getAvailableMemory() {
 	if (platform() === "darwin") {
+		let pressureLevel = 0;
 		try {
-			const pressureLevel = parseInt(execSync("sysctl -n kern.memorystatus_vm_pressure_level", {
+			pressureLevel = parseInt(execSync("sysctl -n kern.memorystatus_vm_pressure_level", {
 				timeout: 1e3,
 				encoding: "utf-8"
 			}).trim(), 10);
-			if (pressureLevel >= 2) {
-				logger$13.warn({ pressureLevel }, "macOS kernel reports memory pressure");
+			if (pressureLevel >= 4) {
+				logger$13.warn({ pressureLevel }, "macOS kernel reports critical memory pressure");
 				return 0;
 			}
 		} catch {}
@@ -2947,7 +2970,15 @@ function getAvailableMemory() {
 			const free = parseInt(vmstat.match(/Pages free:\s+(\d+)/)?.[1] ?? "0", 10);
 			const purgeable = parseInt(vmstat.match(/Pages purgeable:\s+(\d+)/)?.[1] ?? "0", 10);
 			const speculative = parseInt(vmstat.match(/Pages speculative:\s+(\d+)/)?.[1] ?? "0", 10);
-			return (free + purgeable + speculative) * pageSize;
+			const available = (free + purgeable + speculative) * pageSize;
+			if (pressureLevel >= 2) {
+				logger$13.warn({
+					pressureLevel,
+					availableBeforeDiscount: available
+				}, "macOS kernel reports memory pressure — discounting estimate");
+				return Math.floor(available / 2);
+			}
+			return available;
 		} catch {
 			return freemem();
 		}
@@ -4458,10 +4489,13 @@ const logger$8 = createLogger("compiled-workflows:code-review");
 const TOKEN_CEILING = 1e5;
 /**
 * Default fallback result when dispatch fails or times out.
+* Uses NEEDS_MINOR_FIXES (not NEEDS_MAJOR_REWORK) so a parse/schema failure
+* doesn't trigger a full rework cycle. The orchestrator's phantom-review
+* detection handles retries, and escalation kicks in at max review cycles.
 */
 function defaultFailResult(error, tokenUsage) {
 	return {
-		verdict: "NEEDS_MAJOR_REWORK",
+		verdict: "NEEDS_MINOR_FIXES",
 		issues: 0,
 		issue_list: [],
 		error,
@@ -4649,7 +4683,7 @@ async function runCodeReview(deps, params) {
 			details
 		}, "Code-review output schema validation failed");
 		return {
-			verdict: "NEEDS_MAJOR_REWORK",
+			verdict: "NEEDS_MINOR_FIXES",
 			issues: 0,
 			issue_list: [],
 			error: "schema_validation_failed",
@@ -4666,7 +4700,7 @@ async function runCodeReview(deps, params) {
 			details
 		}, "Code-review output failed schema validation");
 		return {
-			verdict: "NEEDS_MAJOR_REWORK",
+			verdict: "NEEDS_MINOR_FIXES",
 			issues: 0,
 			issue_list: [],
 			error: "schema_validation_failed",
@@ -5575,6 +5609,7 @@ function createImplementationOrchestrator(deps) {
 					storyKey,
 					storyFilePath
 				}, "Found existing story file — skipping create-story");
+				endPhase(storyKey, "create-story");
 				eventBus.emit("orchestrator:story-phase-complete", {
 					storyKey,
 					phase: "IN_STORY_CREATION",
@@ -11473,4 +11508,4 @@ function registerRunCommand(program, _version = "0.0.0", projectRoot = process.c
 
 //#endregion
 export { DatabaseWrapper, SUBSTRATE_OWNED_SETTINGS_KEYS, VALID_PHASES, buildPipelineStatusOutput, createContextCompiler, createDispatcher, createImplementationOrchestrator, createPackLoader, createPhaseOrchestrator, createStopAfterGate, findPackageRoot, formatOutput, formatPhaseCompletionSummary, formatPipelineStatusHuman, formatPipelineSummary, formatTokenTelemetry, getAllDescendantPids, getAutoHealthData, getSubstrateDefaultSettings, registerHealthCommand, registerRunCommand, resolveBmadMethodSrcPath, resolveBmadMethodVersion, resolveMainRepoRoot, runAnalysisPhase, runMigrations, runPlanningPhase, runRunAction, runSolutioningPhase, validateStopAfterFromConflict };
-//# sourceMappingURL=run-CLpXJNQ8.js.map
+//# sourceMappingURL=run-mFmS2pw6.js.map

package/package.json

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

package/packs/bmad/prompts/code-review.md

@@ -45,7 +45,7 @@ Adversarial code review. Find what's wrong. Validate story claims against actual
 
 ## Output Contract
 
-After completing the review, emit ONLY this YAML block — no other text:
+After completing the review, emit ONLY raw YAML — no markdown fences, no ``` wrappers, no other text:
 
 ```yaml
 verdict: SHIP_IT