substrate-ai 0.2.9 → 0.2.11

package/dist/cli/index.js

@@ -2,7 +2,7 @@
 import { createLogger, deepMask } from "../logger-C6n1g8uP.js";
 import { AdapterRegistry, createEventBus } from "../event-bus-J-bw-pkp.js";
 import { CURRENT_CONFIG_FORMAT_VERSION, CURRENT_TASK_GRAPH_VERSION, PartialSubstrateConfigSchema, SUPPORTED_CONFIG_FORMAT_VERSIONS, SubstrateConfigSchema, defaultConfigMigrator } from "../version-manager-impl-BpVx2DkY.js";
-import { DatabaseWrapper, SUBSTRATE_OWNED_SETTINGS_KEYS, VALID_PHASES, buildPipelineStatusOutput, createContextCompiler, createDispatcher, createImplementationOrchestrator, createPackLoader, createPhaseOrchestrator, createStopAfterGate, findPackageRoot, formatOutput, formatPhaseCompletionSummary, formatPipelineStatusHuman, formatPipelineSummary, formatTokenTelemetry, getSubstrateDefaultSettings, parseDbTimestampAsUtc, registerRunCommand, resolveBmadMethodSrcPath, resolveBmadMethodVersion, resolveMainRepoRoot, runAnalysisPhase, runMigrations, runPlanningPhase, runSolutioningPhase, validateStopAfterFromConflict } from "../run-Bh7VhhyX.js";
+import { DatabaseWrapper, SUBSTRATE_OWNED_SETTINGS_KEYS, VALID_PHASES, buildPipelineStatusOutput, createContextCompiler, createDispatcher, createImplementationOrchestrator, createPackLoader, createPhaseOrchestrator, createStopAfterGate, findPackageRoot, formatOutput, formatPhaseCompletionSummary, formatPipelineStatusHuman, formatPipelineSummary, formatTokenTelemetry, getSubstrateDefaultSettings, parseDbTimestampAsUtc, registerRunCommand, resolveBmadMethodSrcPath, resolveBmadMethodVersion, resolveMainRepoRoot, runAnalysisPhase, runMigrations, runPlanningPhase, runSolutioningPhase, validateStopAfterFromConflict } from "../run-L-R_XYNT.js";
 import { ConfigError, ConfigIncompatibleFormatError } from "../errors-BPqtzQ4U.js";
 import { addTokenUsage, createDecision, getDecisionsByPhaseForRun, getLatestRun, getPipelineRunById, getTokenUsageSummary, listRequirements, updatePipelineRun } from "../decisions-DNYByk0U.js";
 import { aggregateTokenUsageForRun, compareRunMetrics, getBaselineRunMetrics, getRunMetrics, getStoryMetricsForRun, incrementRunRestarts, listRunMetrics, tagRunAsBaseline } from "../metrics-BSg8VIHd.js";
@@ -2833,7 +2833,7 @@ async function runSupervisorAction(options, deps = {}) {
 								const expDb = expDbWrapper.db;
 								const { runRunAction: runPipeline } = await import(
 									/* @vite-ignore */
-									"../run-p1rj6v-u.js"
+									"../run-C8aOWnKG.js"
 );
 								const runStoryFn = async (opts) => {
 									const exitCode = await runPipeline({
@@ -2973,6 +2973,7 @@ async function runSupervisorAction(options, deps = {}) {
 function registerSupervisorCommand(program, _version = "0.0.0", projectRoot = process.cwd()) {
 	program.command("supervisor").description("Monitor a pipeline run and automatically recover from stalls").option("--poll-interval <seconds>", "Health poll interval in seconds", (v) => parseInt(v, 10), 60).option("--stall-threshold <seconds>", "Staleness in seconds before killing a stalled pipeline", (v) => parseInt(v, 10), 600).option("--max-restarts <n>", "Maximum automatic restarts before aborting", (v) => parseInt(v, 10), 3).option("--run-id <id>", "Pipeline run ID to monitor (defaults to latest)").option("--pack <name>", "Methodology pack name", "bmad").option("--project-root <path>", "Project root directory", projectRoot).option("--output-format <format>", "Output format: human (default) or json", "human").option("--experiment", "After post-run analysis, enter experiment mode: create branches, apply modifications, run single-story experiments, and report verdicts (Story 17-4)", false).option("--max-experiments <n>", "Maximum number of experiments to run per analysis cycle (default: 2, Story 17-4 AC6)", (v) => parseInt(v, 10), 2).action(async (opts) => {
 		const outputFormat = opts.outputFormat === "json" ? "json" : "human";
+		if (opts.stallThreshold < 120) console.warn(`Warning: --stall-threshold ${opts.stallThreshold}s is below 120s. Agent steps typically take 45-90s. This may cause false stall detections and wasted restarts.`);
 		const exitCode = await runSupervisorAction({
 			pollInterval: opts.pollInterval,
 			stallThreshold: opts.stallThreshold,

package/dist/{run-p1rj6v-u.js → run-C8aOWnKG.js}

@@ -1,6 +1,6 @@
 import "./logger-C6n1g8uP.js";
 import "./event-bus-J-bw-pkp.js";
-import { registerRunCommand, runRunAction } from "./run-Bh7VhhyX.js";
+import { registerRunCommand, runRunAction } from "./run-L-R_XYNT.js";
 import "./decisions-DNYByk0U.js";
 import "./metrics-BSg8VIHd.js";
 

package/dist/{run-Bh7VhhyX.js → run-L-R_XYNT.js}

@@ -874,6 +874,7 @@ function createPackLoader() {
 */
 /** Canonical pipeline phase names. This is the single source of truth for all phase lists. */
 const VALID_PHASES = [
+	"research",
 	"analysis",
 	"planning",
 	"solutioning",
@@ -2214,10 +2215,14 @@ Options:
 - \`--stories <keys>\` — Comma-separated story keys to process (e.g., \`7-1,7-2\`)
 - \`--verbose\` — Enable verbose logging output
 - \`--pack <name>\` — Methodology pack name (default: bmad)
-- \`--from <phase>\` — Start from this phase: analysis, planning, solutioning, implementation
+- \`--from <phase>\` — Start from this phase: research, analysis, planning, solutioning, implementation
 - \`--stop-after <phase>\` — Stop pipeline after this phase completes
 - \`--concurrency <n>\` — Maximum parallel conflict groups (default: 3)
 - \`--output-format <format>\` — Output format: human (default) or json
+- \`--concept <text>\` — Inline concept text (required when --from analysis)
+- \`--research\` — Enable the research phase even if not set in the pack config
+- \`--skip-research\` — Skip the research phase even if enabled in the pack config
+- \`--skip-ux\` — Skip the UX design phase even if enabled in the pack config
 - \`--help-agent\` — Print this agent instruction fragment and exit
 
 Examples:
@@ -2284,12 +2289,51 @@ Options:
 - \`--analysis <run-id>\` — Read and output the analysis report with optimization recommendations for a specific run
 - \`--output-format <format>\` — Output format: human (default) or json
 
+### substrate export
+Export decision store contents as human-readable markdown files.
+
+\`\`\`
+substrate export [options]
+\`\`\`
+
+Options:
+- \`--run-id <id>\` — Pipeline run ID to export (defaults to latest run)
+- \`--output-dir <path>\` — Directory to write exported files to (default: _bmad-output/planning-artifacts/)
+- \`--output-format <format>\` — Output format: human (default) or json
+
 ### substrate health
 Check pipeline health, stall detection, and process status.
 
 \`\`\`
 substrate health [--output-format json]
 \`\`\`
+
+### substrate cost
+Show cost breakdown for the current session.
+
+\`\`\`
+substrate cost [--output-format json]
+\`\`\`
+
+### substrate amend
+Run an amendment pipeline against a completed run.
+
+\`\`\`
+substrate amend [options]
+\`\`\`
+
+### substrate brainstorm
+Interactive multi-persona brainstorm session with Pragmatic Engineer, Product Thinker, and Devil's Advocate.
+
+\`\`\`
+substrate brainstorm [options]
+\`\`\`
+
+Session commands: \`!wrap\` (save & exit), \`!quit\` (exit without saving), \`!help\`
+
+## Environment Variables
+
+- \`SUBSTRATE_MEMORY_THRESHOLD_MB\` — Override the free-memory threshold (in MB) for agent dispatch. Default: 512. On macOS, the conservative memory detection may report low availability even when ample RAM exists. Lower this (e.g., 256) if pipelines stall due to memory pressure false positives.
 `;
 }
 /**
@@ -2841,7 +2885,14 @@ const logger$12 = createLogger("agent-dispatch");
 const SHUTDOWN_GRACE_MS = 1e4;
 const SHUTDOWN_MAX_WAIT_MS = 3e4;
 const CHARS_PER_TOKEN = 4;
-const MIN_FREE_MEMORY_BYTES = 512 * 1024 * 1024;
+const MIN_FREE_MEMORY_BYTES = (() => {
+	const envMB = process.env.SUBSTRATE_MEMORY_THRESHOLD_MB;
+	if (envMB) {
+		const parsed = parseInt(envMB, 10);
+		if (!isNaN(parsed) && parsed >= 0) return parsed * 1024 * 1024;
+	}
+	return 512 * 1024 * 1024;
+})();
 const MEMORY_PRESSURE_POLL_MS = 1e4;
 /**
 * Get available system memory in bytes, accounting for platform differences.
@@ -10281,7 +10332,7 @@ async function runRunAction(options) {
 		}
 	}
 	let concept;
-	if (startPhase === "analysis" || startPhase === void 0) {
+	if (startPhase === "research" || startPhase === "analysis" || startPhase === void 0) {
 		if (conceptFile !== void 0 && conceptFile !== "") try {
 			concept = await readFile(conceptFile, "utf-8");
 		} catch (err) {
@@ -10292,8 +10343,8 @@ async function runRunAction(options) {
 			return 1;
 		}
 		else if (conceptArg !== void 0 && conceptArg !== "") concept = conceptArg;
-		else if (startPhase === "analysis") {
-			const errorMsg = "--concept or --concept-file required when starting from analysis phase";
+		else if (startPhase === "research" || startPhase === "analysis") {
+			const errorMsg = "--concept or --concept-file required when starting from research or analysis phase";
 			if (outputFormat === "json") process.stdout.write(formatOutput(null, "json", false, errorMsg) + "\n");
 			else process.stderr.write(`Error: ${errorMsg}\n`);
 			return 1;
@@ -11102,4 +11153,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, getSubstrateDefaultSettings, parseDbTimestampAsUtc, registerRunCommand, resolveBmadMethodSrcPath, resolveBmadMethodVersion, resolveMainRepoRoot, runAnalysisPhase, runMigrations, runPlanningPhase, runRunAction, runSolutioningPhase, validateStopAfterFromConflict };
-//# sourceMappingURL=run-Bh7VhhyX.js.map
+//# sourceMappingURL=run-L-R_XYNT.js.map

package/package.json

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