substrate-ai 0.2.8 → 0.2.10

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-DbRH_r_-.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-XqzHIF6m.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-aGFwcIFG.js"
+									"../run-CDdKFwfI.js"
 );
 								const runStoryFn = async (opts) => {
 									const exitCode = await runPipeline({

package/dist/{run-aGFwcIFG.js → run-CDdKFwfI.js}

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

package/dist/{run-DbRH_r_-.js → run-XqzHIF6m.js}

@@ -8,12 +8,12 @@ import { existsSync, mkdirSync, readFileSync } from "fs";
 import yaml from "js-yaml";
 import { createRequire } from "node:module";
 import { z } from "zod";
-import { spawn } from "node:child_process";
+import { execSync, spawn } from "node:child_process";
 import { dirname as dirname$1, join as join$1, resolve as resolve$1 } from "node:path";
 import BetterSqlite3 from "better-sqlite3";
 import { fileURLToPath } from "node:url";
 import { existsSync as existsSync$1, readFileSync as readFileSync$1, readdirSync as readdirSync$1 } from "node:fs";
-import { freemem } from "node:os";
+import { freemem, platform } from "node:os";
 import { randomUUID } from "node:crypto";
 import { readFile as readFile$1, stat as stat$1 } from "node:fs/promises";
 
@@ -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",
@@ -2843,6 +2844,50 @@ const SHUTDOWN_MAX_WAIT_MS = 3e4;
 const CHARS_PER_TOKEN = 4;
 const MIN_FREE_MEMORY_BYTES = 512 * 1024 * 1024;
 const MEMORY_PRESSURE_POLL_MS = 1e4;
+/**
+* Get available system memory in bytes, accounting for platform differences.
+*
+* On macOS, the previous approach (free + inactive pages) dramatically
+* overestimates availability because inactive pages may be compressed,
+* swapped, or require I/O to reclaim. With heavy agent concurrency, this
+* leads to spawning too many processes and triggering real memory pressure.
+*
+* New approach:
+* 1. Check kern.memorystatus_vm_pressure_level — the kernel's own assessment.
+*    Level >= 2 (warn/critical) means the system is already pressured.
+* 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,
+*    decompression, or may already be backing the compressor.
+*/
+function getAvailableMemory() {
+	if (platform() === "darwin") {
+		try {
+			const pressureLevel = parseInt(execSync("sysctl -n kern.memorystatus_vm_pressure_level", {
+				timeout: 1e3,
+				encoding: "utf-8"
+			}).trim(), 10);
+			if (pressureLevel >= 2) {
+				logger$12.warn({ pressureLevel }, "macOS kernel reports memory pressure");
+				return 0;
+			}
+		} catch {}
+		try {
+			const vmstat = execSync("vm_stat", {
+				timeout: 2e3,
+				encoding: "utf-8"
+			});
+			const pageSize = parseInt(vmstat.match(/page size of (\d+)/)?.[1] ?? "4096", 10);
+			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;
+		} catch {
+			return freemem();
+		}
+	}
+	return freemem();
+}
 var MutableDispatchHandle = class {
 	id;
 	status;
@@ -3242,7 +3287,7 @@ var DispatcherImpl = class {
 		if (idx !== -1) this._queue.splice(idx, 1);
 	}
 	_isMemoryPressured() {
-		const free = freemem();
+		const free = getAvailableMemory();
 		if (free < MIN_FREE_MEMORY_BYTES) {
 			logger$12.warn({
 				freeMB: Math.round(free / 1024 / 1024),
@@ -10237,7 +10282,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) {
@@ -10248,8 +10293,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;
@@ -11058,4 +11103,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-DbRH_r_-.js.map
+//# sourceMappingURL=run-XqzHIF6m.js.map

package/package.json

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