substrate-ai 0.17.2 → 0.18.1

package/dist/adapter-registry-bsm0SCZW.js

@@ -0,0 +1,4 @@
+import { AdapterRegistry } from "./dist-Bm0qSZer.js";
+import "./adapter-registry-DXLMTmfD.js";
+
+export { AdapterRegistry };

package/dist/cli/index.js

@@ -1,15 +1,15 @@
 #!/usr/bin/env node
-import { FileStateStore, SUBSTRATE_OWNED_SETTINGS_KEYS, VALID_PHASES, WorkGraphRepository, buildPipelineStatusOutput, createDatabaseAdapter, createStateStore, detectCycles, findPackageRoot, formatOutput, formatPipelineStatusHuman, formatPipelineSummary, formatTokenTelemetry, getAllDescendantPids, getAutoHealthData, getSubstrateDefaultSettings, parseDbTimestampAsUtc, registerHealthCommand, resolveBmadMethodSrcPath, resolveBmadMethodVersion, resolveMainRepoRoot } from "../health-DswaC1q5.js";
+import { FileStateStore, SUBSTRATE_OWNED_SETTINGS_KEYS, VALID_PHASES, WorkGraphRepository, buildPipelineStatusOutput, createDatabaseAdapter, createStateStore, detectCycles, findPackageRoot, formatOutput, formatPipelineStatusHuman, formatPipelineSummary, formatTokenTelemetry, getAllDescendantPids, getAutoHealthData, getSubstrateDefaultSettings, parseDbTimestampAsUtc, registerHealthCommand, resolveBmadMethodSrcPath, resolveBmadMethodVersion, resolveMainRepoRoot } from "../health-Cx2ZhRNT.js";
 import { createLogger } from "../logger-KeHncl-f.js";
 import { createEventBus } from "../helpers-CElYrONe.js";
-import { AdapterRegistry, BudgetConfigSchema, CURRENT_CONFIG_FORMAT_VERSION, CURRENT_TASK_GRAPH_VERSION, ConfigError, CostTrackerConfigSchema, DEFAULT_CONFIG, DoltClient, DoltNotInstalled, EXPERIMENT_RESULT, GlobalSettingsSchema, IngestionServer, MonitorDatabaseImpl, OPERATIONAL_FINDING, PartialGlobalSettingsSchema, PartialProviderConfigSchema, ProvidersSchema, RoutingRecommender, STORY_METRICS, TelemetryConfigSchema, addTokenUsage, aggregateTokenUsageForRun, checkDoltInstalled, compareRunMetrics, createAmendmentRun, createConfigSystem, createDecision, createDoltClient, createPipelineRun, getActiveDecisions, getAllCostEntriesFiltered, getBaselineRunMetrics, getDecisionsByCategory, getDecisionsByPhaseForRun, getLatestCompletedRun, getLatestRun, getPipelineRunById, getPlanningCostTotal, getRetryableEscalations, getRunMetrics, getSessionCostSummary, getSessionCostSummaryFiltered, getStoryMetricsForRun, getTokenUsageSummary, incrementRunRestarts, initSchema, initializeDolt, listRequirements, listRunMetrics, loadParentRunDecisions, supersedeDecision, tagRunAsBaseline, updatePipelineRun } from "../dist-CLvAwmT7.js";
+import { AdapterRegistry, BudgetConfigSchema, CURRENT_CONFIG_FORMAT_VERSION, CURRENT_TASK_GRAPH_VERSION, ConfigError, CostTrackerConfigSchema, DEFAULT_CONFIG, DoltClient, DoltNotInstalled, EXPERIMENT_RESULT, GlobalSettingsSchema, IngestionServer, MonitorDatabaseImpl, OPERATIONAL_FINDING, PartialGlobalSettingsSchema, PartialProviderConfigSchema, ProvidersSchema, RoutingRecommender, STORY_METRICS, TelemetryConfigSchema, addTokenUsage, aggregateTokenUsageForRun, checkDoltInstalled, compareRunMetrics, createAmendmentRun, createConfigSystem, createDecision, createDoltClient, createPipelineRun, getActiveDecisions, getAllCostEntriesFiltered, getBaselineRunMetrics, getDecisionsByCategory, getDecisionsByPhaseForRun, getLatestCompletedRun, getLatestRun, getPipelineRunById, getPlanningCostTotal, getRetryableEscalations, getRunMetrics, getSessionCostSummary, getSessionCostSummaryFiltered, getStoryMetricsForRun, getTokenUsageSummary, incrementRunRestarts, initSchema, initializeDolt, listRequirements, listRunMetrics, loadParentRunDecisions, supersedeDecision, tagRunAsBaseline, updatePipelineRun } from "../dist-Bm0qSZer.js";
 import "../adapter-registry-DXLMTmfD.js";
-import { AdapterTelemetryPersistence, AppError, DoltRepoMapMetaRepository, DoltSymbolRepository, ERR_REPO_MAP_STORAGE_WRITE, GitClient, GrammarLoader, RepoMapInjector, RepoMapModule, RepoMapQueryEngine, RepoMapStorage, SymbolParser, createContextCompiler, createDispatcher, createEventEmitter, createImplementationOrchestrator, createPackLoader, createPhaseOrchestrator, createStopAfterGate, createTelemetryAdvisor, formatPhaseCompletionSummary, getFactoryRunSummaries, getScenarioResultsForRun, getTwinRunsForRun, listGraphRuns, registerFactoryCommand, registerRunCommand, registerScenariosCommand, resolveStoryKeys, runAnalysisPhase, runPlanningPhase, runSolutioningPhase, validateStopAfterFromConflict } from "../run-Bku8fmY3.js";
-import "../errors-D1LU8CZ9.js";
+import { AdapterTelemetryPersistence, AppError, DoltRepoMapMetaRepository, DoltSymbolRepository, ERR_REPO_MAP_STORAGE_WRITE, GitClient, GrammarLoader, RepoMapInjector, RepoMapModule, RepoMapQueryEngine, RepoMapStorage, SymbolParser, createContextCompiler, createDispatcher, createEventEmitter, createImplementationOrchestrator, createPackLoader, createPhaseOrchestrator, createStopAfterGate, createTelemetryAdvisor, formatPhaseCompletionSummary, getFactoryRunSummaries, getScenarioResultsForRun, getTwinRunsForRun, listGraphRuns, registerFactoryCommand, registerRunCommand, registerScenariosCommand, resolveStoryKeys, runAnalysisPhase, runPlanningPhase, runSolutioningPhase, validateStopAfterFromConflict } from "../run-gXtnH8lO.js";
+import "../errors-BSpu7pIv.js";
 import "../routing-CcBOCuC9.js";
 import "../decisions-C0pz9Clx.js";
 import "../version-manager-impl-BmOWu8ml.js";
-import { registerUpgradeCommand } from "../upgrade-DT0I_-1E.js";
+import { registerUpgradeCommand } from "../upgrade-BcL4ZV3o.js";
 import { Command } from "commander";
 import { fileURLToPath } from "url";
 import { dirname, join, resolve } from "path";
@@ -24,7 +24,7 @@ import { isAbsolute, join as join$1 } from "node:path";
 import { z } from "zod";
 import * as fs from "node:fs/promises";
 import { access as access$1, readFile as readFile$1, readdir as readdir$1 } from "node:fs/promises";
-import { appendFileSync, chmodSync, cpSync, existsSync as existsSync$1, mkdirSync as mkdirSync$1, readFileSync as readFileSync$1, readdirSync as readdirSync$1, realpathSync, statSync, unlinkSync, writeFileSync as writeFileSync$1 } from "fs";
+import { appendFileSync, chmodSync, cpSync, existsSync as existsSync$1, mkdirSync as mkdirSync$1, readFileSync as readFileSync$1, readdirSync as readdirSync$1, realpathSync, rmSync as rmSync$1, statSync, unlinkSync, writeFileSync as writeFileSync$1 } from "fs";
 import { homedir } from "os";
 import { createRequire } from "node:module";
 import { fileURLToPath as fileURLToPath$1 } from "node:url";
@@ -1802,6 +1802,132 @@ async function compileBmadAgents(bmadDir) {
 	} catch {}
 	return compiled;
 }
+/**
+* Parse a single CSV line, respecting double-quoted fields that may contain
+* commas and escaped quotes (RFC 4180). Returns an array of field values.
+*/
+function parseCSVLine(line) {
+	const fields = [];
+	let current = "";
+	let inQuotes = false;
+	for (let i = 0; i < line.length; i++) {
+		const ch = line[i];
+		if (inQuotes) if (ch === "\"") if (i + 1 < line.length && line[i + 1] === "\"") {
+			current += "\"";
+			i++;
+		} else inQuotes = false;
+		else current += ch;
+		else if (ch === "\"") inQuotes = true;
+		else if (ch === ",") {
+			fields.push(current);
+			current = "";
+		} else current += ch;
+	}
+	fields.push(current);
+	return fields;
+}
+/**
+* Prepare the `.claude/skills/` directory by cleaning stale bmad-prefixed entries.
+* Returns the skills directory path.
+*/
+function prepareSkillsDir(projectRoot) {
+	const skillsDir = join(projectRoot, ".claude", "skills");
+	mkdirSync$1(skillsDir, { recursive: true });
+	try {
+		for (const entry of readdirSync$1(skillsDir, { withFileTypes: true })) if (entry.isDirectory() && entry.name.startsWith("bmad")) rmSync$1(join(skillsDir, entry.name), {
+			recursive: true,
+			force: true
+		});
+	} catch {}
+	return skillsDir;
+}
+/**
+* Install skills from `_bmad/_config/skill-manifest.csv` into `.claude/skills/`.
+*
+* Each row in the CSV specifies a canonicalId and a path to the SKILL.md file.
+* The entire source directory (dirname of the path) is copied to
+* `.claude/skills/<canonicalId>/`, matching bmad-method's installVerbatimSkills.
+*
+* @returns Number of skills installed.
+*/
+function installSkillsFromManifest(projectRoot, bmadDir) {
+	const csvPath = join(bmadDir, "_config", "skill-manifest.csv");
+	if (!existsSync$1(csvPath)) return 0;
+	const csvContent = readFileSync$1(csvPath, "utf-8");
+	const lines = csvContent.split("\n").filter((l) => l.trim() !== "");
+	if (lines.length < 2) return 0;
+	const headers = parseCSVLine(lines[0]);
+	const canonicalIdIdx = headers.indexOf("canonicalId");
+	const pathIdx = headers.indexOf("path");
+	if (canonicalIdIdx < 0 || pathIdx < 0) return 0;
+	const bmadFolderName = "_bmad";
+	const bmadPrefix = bmadFolderName + "/";
+	const skillsDir = prepareSkillsDir(projectRoot);
+	let count = 0;
+	for (let i = 1; i < lines.length; i++) {
+		const fields = parseCSVLine(lines[i]);
+		const canonicalId = fields[canonicalIdIdx]?.trim();
+		const skillPath = fields[pathIdx]?.trim();
+		if (!canonicalId || !skillPath) continue;
+		const relativePath = skillPath.startsWith(bmadPrefix) ? skillPath.slice(bmadPrefix.length) : skillPath;
+		const sourceFile = join(bmadDir, relativePath);
+		const sourceDir = dirname(sourceFile);
+		if (!existsSync$1(sourceDir)) continue;
+		const destDir = join(skillsDir, canonicalId);
+		mkdirSync$1(destDir, { recursive: true });
+		cpSync(sourceDir, destDir, { recursive: true });
+		count++;
+	}
+	return count;
+}
+/**
+* Install skills directly from bmad-method source directories.
+*
+* Scans `src/core-skills/` and `src/bmm-skills/` (recursively) in the
+* bmad-method package for directories containing SKILL.md. Each directory
+* name is used as the canonicalId.
+*
+* This is the primary installation path for bmad-method v6.2.0+ where
+* skill-manifest.csv may be empty (it's populated by the full IDE installer,
+* which substrate doesn't call).
+*
+* @param installerLibPath - Path to bmad-method's tools/cli/installers/lib/
+* @returns Number of skills installed.
+*/
+function installSkillsFromSource(projectRoot, installerLibPath) {
+	const bmadMethodRoot = resolve(installerLibPath, "..", "..", "..", "..");
+	const skillRoots = [join(bmadMethodRoot, "src", "core-skills"), join(bmadMethodRoot, "src", "bmm-skills")];
+	const skillsDir = prepareSkillsDir(projectRoot);
+	let count = 0;
+	for (const root of skillRoots) {
+		if (!existsSync$1(root)) continue;
+		count += copySkillDirsRecursive(root, skillsDir);
+	}
+	return count;
+}
+/**
+* Recursively find directories containing SKILL.md and copy them to destRoot.
+* The directory name becomes the canonicalId (skill target directory name).
+*/
+function copySkillDirsRecursive(dir, destRoot) {
+	if (!existsSync$1(dir)) return 0;
+	let count = 0;
+	try {
+		const entries = readdirSync$1(dir, { withFileTypes: true });
+		for (const entry of entries) {
+			if (!entry.isDirectory()) continue;
+			const childPath = join(dir, entry.name);
+			const skillFile = join(childPath, "SKILL.md");
+			if (existsSync$1(skillFile)) {
+				const destDir = join(destRoot, entry.name);
+				mkdirSync$1(destDir, { recursive: true });
+				cpSync(childPath, destDir, { recursive: true });
+				count++;
+			} else count += copySkillDirsRecursive(childPath, destRoot);
+		}
+	} catch {}
+	return count;
+}
 async function scaffoldClaudeCommands(projectRoot, outputFormat) {
 	const bmadDir = join(projectRoot, "_bmad");
 	if (!existsSync$1(bmadDir)) return;
@@ -1840,11 +1966,11 @@ async function scaffoldClaudeCommands(projectRoot, outputFormat) {
 		if (existsSync$1(workflowGenPath)) {
 			const workflowMod = _require(workflowGenPath);
 			WorkflowCommandGenerator = resolveExport(workflowMod, "WorkflowCommandGenerator");
-		} else logger$15.info("bmad-method workflow-command-generator not available; skipping workflow commands");
+		} else logger$15.info("bmad-method workflow-command-generator not available; will try skill-based installation");
 		if (existsSync$1(taskToolGenPath)) {
 			const taskToolMod = _require(taskToolGenPath);
 			TaskToolCommandGenerator = resolveExport(taskToolMod, "TaskToolCommandGenerator");
-		} else logger$15.info("bmad-method task-tool-command-generator not available; skipping task/tool commands");
+		} else logger$15.info("bmad-method task-tool-command-generator not available; will try skill-based installation");
 		let ManifestGenerator = null;
 		if (existsSync$1(manifestGenPath)) {
 			const manifestMod = _require(manifestGenPath);
@@ -1896,12 +2022,19 @@ async function scaffoldClaudeCommands(projectRoot, outputFormat) {
 			const { artifacts: taskToolArtifacts } = await taskToolGen.collectTaskToolArtifacts(bmadDir);
 			taskToolCount = typeof taskToolGen.writeDashArtifacts === "function" ? await taskToolGen.writeDashArtifacts(commandsDir, taskToolArtifacts) : await writeDashFallback(commandsDir, taskToolArtifacts, ["task", "tool"]);
 		}
-		const total = agentCount + workflowCount + taskToolCount;
-		if (outputFormat !== "json") process.stdout.write(`Generated ${String(total)} Claude Code commands (${String(agentCount)} agents, ${String(workflowCount)} workflows, ${String(taskToolCount)} tasks/tools)\n`);
+		let skillCount = 0;
+		if (!WorkflowCommandGenerator && !TaskToolCommandGenerator) {
+			skillCount = installSkillsFromSource(projectRoot, installerLibPath);
+			if (skillCount === 0) skillCount = installSkillsFromManifest(projectRoot, bmadDir);
+		}
+		const total = agentCount + workflowCount + taskToolCount + skillCount;
+		if (outputFormat !== "json") if (skillCount > 0) process.stdout.write(`Generated ${String(total)} Claude Code commands (${String(agentCount)} agents, ${String(skillCount)} skills)\n`);
+		else process.stdout.write(`Generated ${String(total)} Claude Code commands (${String(agentCount)} agents, ${String(workflowCount)} workflows, ${String(taskToolCount)} tasks/tools)\n`);
 		logger$15.info({
 			agentCount,
 			workflowCount,
 			taskToolCount,
+			skillCount,
 			total,
 			commandsDir
 		}, "Generated .claude/commands/");
@@ -3055,7 +3188,7 @@ async function runStatusAction(options) {
 			if (run === void 0) run = await getLatestRun(adapter);
 		}
 		if (run === void 0) {
-			const { inspectProcessTree } = await import("../health-GEDGgGan.js");
+			const { inspectProcessTree } = await import("../health-DRywcMxP.js");
 			const substrateDirPath = join(projectRoot, ".substrate");
 			const processInfo = inspectProcessTree({
 				projectRoot,
@@ -3940,7 +4073,7 @@ function defaultSupervisorDeps() {
 				if (cached === null) {
 					const { AdapterRegistry: AR } = await import(
 						/* @vite-ignore */
-						"../adapter-registry-DbLuI3IA.js"
+						"../adapter-registry-bsm0SCZW.js"
 );
 					cached = new AR();
 					await cached.discoverAndRegister();
@@ -4294,10 +4427,17 @@ async function runSupervisorAction(options, deps = {}) {
 	}
 	while (true) {
 		const health = await getHealth({
-			runId,
+			runId: state.runId ?? runId,
 			projectRoot
 		});
 		const ts = new Date().toISOString();
+		if (state.runId === void 0 && health.run_id !== null) {
+			state = {
+				...state,
+				runId: health.run_id
+			};
+			log(`Supervisor: auto-bound to active run ${health.run_id}`);
+		}
 		if (outputFormat === "json") {
 			const tokenSnapshot = health.run_id !== null ? await getTokenSnapshot(health.run_id, projectRoot) : {
 				input: 0,
@@ -4375,11 +4515,11 @@ async function runSupervisorAction(options, deps = {}) {
 						try {
 							const { createExperimenter } = await import(
 								/* @vite-ignore */
-								"../experimenter-D0k2wT3I.js"
+								"../experimenter-DV-ZC-uX.js"
 );
 							const { getLatestRun: getLatest } = await import(
 								/* @vite-ignore */
-								"../decisions-CGNEausW.js"
+								"../decisions-DMpHsVUn.js"
 );
 							const expAdapter = createDatabaseAdapter({
 								backend: "auto",
@@ -4389,7 +4529,7 @@ async function runSupervisorAction(options, deps = {}) {
 								await initSchema(expAdapter);
 								const { runRunAction: runPipeline } = await import(
 									/* @vite-ignore */
-									"../run-N5rHJu-Y.js"
+									"../run-m7RCkpmx.js"
 );
 								const runStoryFn = async (opts) => {
 									const exitCode = await runPipeline({
@@ -4919,7 +5059,7 @@ async function runMetricsAction(options) {
 			const routingConfigPath = join(dbDir, "routing.yml");
 			let routingConfig = null;
 			if (existsSync$1(routingConfigPath)) try {
-				const { loadModelRoutingConfig } = await import("../routing-B1aoIz7L.js");
+				const { loadModelRoutingConfig } = await import("../routing-CXLeUI-t.js");
 				routingConfig = loadModelRoutingConfig(routingConfigPath);
 			} catch {}
 			if (routingConfig === null) routingConfig = {
@@ -8756,8 +8896,8 @@ async function createProgram() {
 /** Fire-and-forget startup version check (story 8.3, AC3/AC5) */
 function checkForUpdatesInBackground(currentVersion) {
 	if (process.env.SUBSTRATE_NO_UPDATE_CHECK === "1") return;
-	import("../upgrade-DPdh5w4p.js").then(async () => {
-		const { createVersionManager } = await import("../version-manager-impl-BHnUB2tl.js");
+	import("../upgrade-CbwnF2hv.js").then(async () => {
+		const { createVersionManager } = await import("../version-manager-impl-DBx3ovp9.js");
 		const vm = createVersionManager();
 		const result = await vm.checkForUpdates();
 		if (result.updateAvailable) {

package/dist/{decisions-CGNEausW.js → decisions-DMpHsVUn.js}

@@ -1,4 +1,4 @@
-import { addTokenUsage, createDecision, createPipelineRun, createRequirement, getArtifactByTypeForRun, getArtifactsByRun, getDecisionsByCategory, getDecisionsByPhase, getDecisionsByPhaseForRun, getLatestRun, getPipelineRunById, getRunningPipelineRuns, getTokenUsageSummary, listRequirements, registerArtifact, updateDecision, updatePipelineRun, updatePipelineRunConfig, upsertDecision } from "./dist-CLvAwmT7.js";
+import { addTokenUsage, createDecision, createPipelineRun, createRequirement, getArtifactByTypeForRun, getArtifactsByRun, getDecisionsByCategory, getDecisionsByPhase, getDecisionsByPhaseForRun, getLatestRun, getPipelineRunById, getRunningPipelineRuns, getTokenUsageSummary, listRequirements, registerArtifact, updateDecision, updatePipelineRun, updatePipelineRunConfig, upsertDecision } from "./dist-Bm0qSZer.js";
 import "./decisions-C0pz9Clx.js";
 
 export { getLatestRun };

package/dist/{dist-CLvAwmT7.js → dist-Bm0qSZer.js}

@@ -3004,12 +3004,15 @@ async function updatePipelineRunConfig(adapter, id, configJson) {
 async function createPipelineRun(adapter, input) {
 	const validated = CreatePipelineRunInputSchema.parse(input);
 	const id = crypto.randomUUID();
-	await adapter.query(`INSERT INTO pipeline_runs (id, methodology, current_phase, status, config_json)
-     VALUES (?, ?, ?, 'running', ?)`, [
+	const nowUtc = new Date().toISOString();
+	await adapter.query(`INSERT INTO pipeline_runs (id, methodology, current_phase, status, config_json, created_at, updated_at)
+     VALUES (?, ?, ?, 'running', ?, ?, ?)`, [
 		id,
 		validated.methodology,
 		validated.start_phase ?? null,
-		validated.config_json ?? null
+		validated.config_json ?? null,
+		nowUtc,
+		nowUtc
 	]);
 	const rows = await adapter.query("SELECT * FROM pipeline_runs WHERE id = ?", [id]);
 	return rows[0];
@@ -10236,4 +10239,4 @@ async function callLLM(params) {
 
 //#endregion
 export { ADVISORY_NOTES, AdapterRegistry, AdtError, BudgetConfigSchema, CURRENT_CONFIG_FORMAT_VERSION, CURRENT_TASK_GRAPH_VERSION, Categorizer, ClaudeCodeAdapter, CodexCLIAdapter, ConfigError, ConfigIncompatibleFormatError, ConsumerAnalyzer, CostTrackerConfigSchema, DEFAULT_CONFIG, DEFAULT_GLOBAL_SETTINGS, DispatcherImpl, DoltClient, DoltNotInstalled, DoltQueryError, ESCALATION_DIAGNOSIS, EXPERIMENT_RESULT, EfficiencyScorer, GeminiCLIAdapter, GlobalSettingsSchema, IngestionServer, LogTurnAnalyzer, ModelRoutingConfigSchema, MonitorDatabaseImpl, OPERATIONAL_FINDING, PartialGlobalSettingsSchema, PartialProviderConfigSchema, ProviderPolicySchema, ProvidersSchema, Recommender, RoutingConfigError, RoutingRecommender, RoutingResolver, RoutingTelemetry, RoutingTokenAccumulator, RoutingTuner, STORY_METRICS, STORY_OUTCOME, SubstrateConfigSchema, TASK_TYPE_PHASE_MAP, TEST_EXPANSION_FINDING, TEST_PLAN, TelemetryConfigSchema, TelemetryNormalizer, TelemetryPipeline, TurnAnalyzer, VersionManagerImpl, addTokenUsage, aggregateTokenUsageForRun, aggregateTokenUsageForStory, buildAuditLogEntry, buildBranchName, buildModificationDirective, buildPRBody, buildWorktreePath, callLLM, checkDoltInstalled, compareRunMetrics, createAmendmentRun, createConfigSystem, createDatabaseAdapter as createDatabaseAdapter$1, createDecision, createDoltClient, createExperimenter, createPipelineRun, createRequirement, createVersionManager, detectInterfaceChanges, determineVerdict, getActiveDecisions, getAllCostEntriesFiltered, getArtifactByTypeForRun, getArtifactsByRun, getBaselineRunMetrics, getDecisionsByCategory, getDecisionsByPhase, getDecisionsByPhaseForRun, getLatestCompletedRun, getLatestRun, getModelTier, getPipelineRunById, getPlanningCostTotal, getRetryableEscalations, getRunMetrics, getRunningPipelineRuns, getSessionCostSummary, getSessionCostSummaryFiltered, getStoryMetricsForRun, getTokenUsageSummary, incrementRunRestarts, initSchema, initializeDolt, listRequirements, listRunMetrics, loadModelRoutingConfig, loadParentRunDecisions, registerArtifact, resolvePromptFile, supersedeDecision, tagRunAsBaseline, updateDecision, updatePipelineRun, updatePipelineRunConfig, upsertDecision, writeRunMetrics, writeStoryMetrics };
-//# sourceMappingURL=dist-CLvAwmT7.js.map
+//# sourceMappingURL=dist-Bm0qSZer.js.map

package/dist/{errors-D1LU8CZ9.js → errors-BSpu7pIv.js}

@@ -1,4 +1,4 @@
-import { AdtError } from "./dist-CLvAwmT7.js";
+import { AdtError } from "./dist-Bm0qSZer.js";
 
 //#region src/core/errors.ts
 /** Error thrown when task configuration is invalid */
@@ -71,4 +71,4 @@ var TaskGraphIncompatibleFormatError = class extends AdtError {
 
 //#endregion
 export { BudgetExceededError, GitError, RecoveryError, TaskConfigError, TaskGraphCycleError, TaskGraphError, TaskGraphIncompatibleFormatError, WorkerError, WorkerNotFoundError };
-//# sourceMappingURL=errors-D1LU8CZ9.js.map
+//# sourceMappingURL=errors-BSpu7pIv.js.map

package/dist/{experimenter-D0k2wT3I.js → experimenter-DV-ZC-uX.js}

@@ -1,3 +1,3 @@
-import { buildAuditLogEntry, buildBranchName, buildModificationDirective, buildPRBody, buildWorktreePath, createExperimenter, determineVerdict, resolvePromptFile } from "./dist-CLvAwmT7.js";
+import { buildAuditLogEntry, buildBranchName, buildModificationDirective, buildPRBody, buildWorktreePath, createExperimenter, determineVerdict, resolvePromptFile } from "./dist-Bm0qSZer.js";
 
 export { createExperimenter };

package/dist/{health-DswaC1q5.js → health-Cx2ZhRNT.js}

@@ -1,5 +1,5 @@
 import { createLogger } from "./logger-KeHncl-f.js";
-import { DoltClient, DoltQueryError, createDatabaseAdapter$1 as createDatabaseAdapter, getLatestRun, getPipelineRunById, initSchema } from "./dist-CLvAwmT7.js";
+import { DoltClient, DoltQueryError, createDatabaseAdapter$1 as createDatabaseAdapter, getLatestRun, getPipelineRunById, initSchema } from "./dist-Bm0qSZer.js";
 import { createRequire } from "module";
 import { dirname, join } from "path";
 import { existsSync, readFileSync } from "node:fs";
@@ -1930,4 +1930,4 @@ function registerHealthCommand(program, _version = "0.0.0", projectRoot = proces
 
 //#endregion
 export { BMAD_BASELINE_TOKENS_FULL, DEFAULT_STALL_THRESHOLD_SECONDS, DoltMergeConflict, FileStateStore, STOP_AFTER_VALID_PHASES, STORY_KEY_PATTERN$1 as STORY_KEY_PATTERN, SUBSTRATE_OWNED_SETTINGS_KEYS, VALID_PHASES, WorkGraphRepository, __commonJS, __require, __toESM, buildPipelineStatusOutput, createDatabaseAdapter$1 as createDatabaseAdapter, createStateStore, detectCycles, findPackageRoot, formatOutput, formatPipelineStatusHuman, formatPipelineSummary, formatTokenTelemetry, getAllDescendantPids, getAutoHealthData, getSubstrateDefaultSettings, inspectProcessTree, isOrchestratorProcessLine, parseDbTimestampAsUtc, registerHealthCommand, resolveBmadMethodSrcPath, resolveBmadMethodVersion, resolveMainRepoRoot, runHealthAction, validateStoryKey };
-//# sourceMappingURL=health-DswaC1q5.js.map
+//# sourceMappingURL=health-Cx2ZhRNT.js.map

package/dist/{health-GEDGgGan.js → health-DRywcMxP.js}

@@ -1,6 +1,6 @@
-import { DEFAULT_STALL_THRESHOLD_SECONDS, getAllDescendantPids, getAutoHealthData, inspectProcessTree, isOrchestratorProcessLine, registerHealthCommand, runHealthAction } from "./health-DswaC1q5.js";
+import { DEFAULT_STALL_THRESHOLD_SECONDS, getAllDescendantPids, getAutoHealthData, inspectProcessTree, isOrchestratorProcessLine, registerHealthCommand, runHealthAction } from "./health-Cx2ZhRNT.js";
 import "./logger-KeHncl-f.js";
-import "./dist-CLvAwmT7.js";
+import "./dist-Bm0qSZer.js";
 import "./decisions-C0pz9Clx.js";
 
 export { inspectProcessTree };

package/dist/index.js

@@ -1,8 +1,8 @@
 import { childLogger, createLogger, logger } from "./logger-KeHncl-f.js";
 import { assertDefined, createEventBus, createTuiApp, deepClone, formatDuration, generateId, isPlainObject, isTuiCapable, printNonTtyWarning, sleep, withRetry } from "./helpers-CElYrONe.js";
-import { AdapterRegistry, AdtError, ClaudeCodeAdapter, CodexCLIAdapter, ConfigError, ConfigIncompatibleFormatError, GeminiCLIAdapter } from "./dist-CLvAwmT7.js";
+import { AdapterRegistry, AdtError, ClaudeCodeAdapter, CodexCLIAdapter, ConfigError, ConfigIncompatibleFormatError, GeminiCLIAdapter } from "./dist-Bm0qSZer.js";
 import "./adapter-registry-DXLMTmfD.js";
-import { BudgetExceededError, GitError, RecoveryError, TaskConfigError, TaskGraphCycleError, TaskGraphError, TaskGraphIncompatibleFormatError, WorkerError, WorkerNotFoundError } from "./errors-D1LU8CZ9.js";
+import { BudgetExceededError, GitError, RecoveryError, TaskConfigError, TaskGraphCycleError, TaskGraphError, TaskGraphIncompatibleFormatError, WorkerError, WorkerNotFoundError } from "./errors-BSpu7pIv.js";
 
 //#region src/core/di.ts
 /**

package/dist/{routing-B1aoIz7L.js → routing-CXLeUI-t.js}

@@ -1,4 +1,4 @@
-import { ModelRoutingConfigSchema, ProviderPolicySchema, RoutingConfigError, RoutingRecommender, RoutingResolver, RoutingTelemetry, RoutingTokenAccumulator, RoutingTuner, TASK_TYPE_PHASE_MAP, getModelTier, loadModelRoutingConfig } from "./dist-CLvAwmT7.js";
+import { ModelRoutingConfigSchema, ProviderPolicySchema, RoutingConfigError, RoutingRecommender, RoutingResolver, RoutingTelemetry, RoutingTokenAccumulator, RoutingTuner, TASK_TYPE_PHASE_MAP, getModelTier, loadModelRoutingConfig } from "./dist-Bm0qSZer.js";
 import "./routing-CcBOCuC9.js";
 
 export { loadModelRoutingConfig };

package/dist/{run-Bku8fmY3.js → run-gXtnH8lO.js}

@@ -1,7 +1,7 @@
-import { BMAD_BASELINE_TOKENS_FULL, DoltMergeConflict, FileStateStore, STOP_AFTER_VALID_PHASES, STORY_KEY_PATTERN, VALID_PHASES, WorkGraphRepository, __commonJS, __require, __toESM, buildPipelineStatusOutput, createDatabaseAdapter, formatOutput, formatPipelineSummary, formatTokenTelemetry, inspectProcessTree, parseDbTimestampAsUtc, resolveMainRepoRoot, validateStoryKey } from "./health-DswaC1q5.js";
+import { BMAD_BASELINE_TOKENS_FULL, DoltMergeConflict, FileStateStore, STOP_AFTER_VALID_PHASES, STORY_KEY_PATTERN, VALID_PHASES, WorkGraphRepository, __commonJS, __require, __toESM, buildPipelineStatusOutput, createDatabaseAdapter, formatOutput, formatPipelineSummary, formatTokenTelemetry, inspectProcessTree, parseDbTimestampAsUtc, resolveMainRepoRoot, validateStoryKey } from "./health-Cx2ZhRNT.js";
 import { createLogger } from "./logger-KeHncl-f.js";
 import { TypedEventBusImpl, createEventBus, createTuiApp, isTuiCapable, printNonTtyWarning, sleep } from "./helpers-CElYrONe.js";
-import { ADVISORY_NOTES, Categorizer, ConsumerAnalyzer, DEFAULT_GLOBAL_SETTINGS, DispatcherImpl, DoltClient, ESCALATION_DIAGNOSIS, EfficiencyScorer, IngestionServer, LogTurnAnalyzer, OPERATIONAL_FINDING, Recommender, RoutingRecommender, RoutingResolver, RoutingTelemetry, RoutingTokenAccumulator, RoutingTuner, STORY_METRICS, STORY_OUTCOME, SubstrateConfigSchema, TEST_EXPANSION_FINDING, TEST_PLAN, TelemetryNormalizer, TelemetryPipeline, TurnAnalyzer, addTokenUsage, aggregateTokenUsageForRun, aggregateTokenUsageForStory, callLLM, createConfigSystem, createDatabaseAdapter$1, createDecision, createPipelineRun, createRequirement, detectInterfaceChanges, getArtifactByTypeForRun, getArtifactsByRun, getDecisionsByCategory, getDecisionsByPhase, getDecisionsByPhaseForRun, getPipelineRunById, getRunningPipelineRuns, getStoryMetricsForRun, getTokenUsageSummary, initSchema, loadModelRoutingConfig, registerArtifact, updatePipelineRun, updatePipelineRunConfig, upsertDecision, writeRunMetrics, writeStoryMetrics } from "./dist-CLvAwmT7.js";
+import { ADVISORY_NOTES, Categorizer, ConsumerAnalyzer, DEFAULT_GLOBAL_SETTINGS, DispatcherImpl, DoltClient, ESCALATION_DIAGNOSIS, EfficiencyScorer, IngestionServer, LogTurnAnalyzer, OPERATIONAL_FINDING, Recommender, RoutingRecommender, RoutingResolver, RoutingTelemetry, RoutingTokenAccumulator, RoutingTuner, STORY_METRICS, STORY_OUTCOME, SubstrateConfigSchema, TEST_EXPANSION_FINDING, TEST_PLAN, TelemetryNormalizer, TelemetryPipeline, TurnAnalyzer, addTokenUsage, aggregateTokenUsageForRun, aggregateTokenUsageForStory, callLLM, createConfigSystem, createDatabaseAdapter$1, createDecision, createPipelineRun, createRequirement, detectInterfaceChanges, getArtifactByTypeForRun, getArtifactsByRun, getDecisionsByCategory, getDecisionsByPhase, getDecisionsByPhaseForRun, getPipelineRunById, getRunningPipelineRuns, getStoryMetricsForRun, getTokenUsageSummary, initSchema, loadModelRoutingConfig, registerArtifact, updatePipelineRun, updatePipelineRunConfig, upsertDecision, writeRunMetrics, writeStoryMetrics } from "./dist-Bm0qSZer.js";
 import { basename, dirname, extname, join } from "path";
 import { access, readFile, readdir, stat } from "fs/promises";
 import { EventEmitter } from "node:events";
@@ -10149,6 +10149,9 @@ function createImplementationOrchestrator(deps) {
 				completedDispatches: completed,
 				queuedDispatches: queued
 			});
+			if (config.pipelineRunId !== void 0) updatePipelineRun(db, config.pipelineRunId, { current_phase: "implementation" }).catch((err) => {
+				logger$21.debug({ err }, "Heartbeat: failed to touch updated_at (non-fatal)");
+			});
 			const elapsed = Date.now() - _lastProgressTs;
 			let childPids = [];
 			let childActive = false;
@@ -22250,12 +22253,17 @@ var RunStateManager = class {
 * or `PARTIAL_SUCCESS` for the pipeline to exit normally.
 *
 * Story 42-16.
+* Story 49-3: AutoSummarizer integration for long-running convergence loops.
 */
 /**
 * Create a new `ConvergenceController` instance backed by an in-memory outcome map.
+*
+* @param config - Optional configuration. Pass `{ autoSummarizer }` to enable
+*                 automatic context compression in long-running convergence loops.
 */
-function createConvergenceController() {
+function createConvergenceController(config) {
 	const outcomes = new Map();
+	let storedContexts = [];
 	/** Returns true only when id is non-empty AND exists in graph.nodes. */
 	function isValidTarget(id, graph) {
 		return id !== "" && graph.nodes.has(id);
@@ -22315,6 +22323,23 @@ function createConvergenceController() {
 			];
 			for (const candidate of candidates) if (isValidTarget(candidate, graph)) return candidate;
 			return null;
+		},
+		recordIterationContext(ctx) {
+			storedContexts.push(ctx);
+		},
+		async prepareForIteration(currentIndex) {
+			if (!config?.autoSummarizer || storedContexts.length === 0) return storedContexts;
+			const uncompressedContexts = storedContexts.filter((c) => !("compressed" in c));
+			if (config.autoSummarizer.shouldTrigger(uncompressedContexts)) {
+				const compressionResult = await config.autoSummarizer.compress(uncompressedContexts, currentIndex);
+				const alreadyCompressed = storedContexts.filter((c) => "compressed" in c);
+				const merged = [...alreadyCompressed, ...compressionResult.iterations].sort((a, b) => a.index - b.index);
+				storedContexts = merged;
+			}
+			return storedContexts;
+		},
+		getStoredContexts() {
+			return storedContexts;
 		}
 	};
 }
@@ -22925,6 +22950,43 @@ async function getFactoryRunSummaries(adapter, limit = 20) {
 	});
 }
 
+//#endregion
+//#region packages/factory/dist/graph/fidelity.js
+/**
+* Map a raw fidelity string to a SummaryLevel for context compression.
+*
+* Returns null when no summarization should be applied (fidelity is 'full',
+* empty, or an unrecognized value). Used by the executor before every node
+* dispatch to determine whether to call summaryEngine.summarize().
+*/
+function parseFidelityLevel(fidelity) {
+	const FIDELITY_MAP = {
+		high: "high",
+		"summary:high": "high",
+		medium: "medium",
+		"summary:medium": "medium",
+		low: "low",
+		draft: "low",
+		"summary:low": "low"
+	};
+	return FIDELITY_MAP[fidelity] ?? null;
+}
+/**
+* Resolve the effective fidelity string for a node about to be dispatched.
+*
+* Precedence (highest to lowest):
+*   1. incomingEdge.fidelity (non-empty)
+*   2. node.fidelity (non-empty)
+*   3. graph.defaultFidelity (non-empty)
+*   4. '' (no fidelity set — parseFidelityLevel will return null)
+*/
+function resolveFidelity(node, incomingEdge, graph) {
+	if (incomingEdge?.fidelity) return incomingEdge.fidelity;
+	if (node.fidelity) return node.fidelity;
+	if (graph.defaultFidelity) return graph.defaultFidelity;
+	return "";
+}
+
 //#endregion
 //#region packages/factory/dist/graph/executor.js
 /**
@@ -23060,6 +23122,7 @@ function createGraphExecutor() {
 		let firstResumedFidelity = "";
 		let skipCycleCheck = false;
 		let skipCompletedPush = false;
+		let lastIncomingEdge = void 0;
 		let scenarioManifest = null;
 		if (config.scenarioStore) scenarioManifest = await config.scenarioStore.discover();
 		const runStateManager = config.dotSource ? new RunStateManager({ runDir: config.logsRoot }) : null;
@@ -23207,6 +23270,7 @@ function createGraphExecutor() {
 						satisfactionScoreHistory: plateauResult.scores
 					});
 					injectRemediationContext(context, remediation);
+					await controller.prepareForIteration(convergenceIteration);
 					skipCycleCheck = true;
 					currentNode = retryNode;
 					continue;
@@ -23273,6 +23337,25 @@ function createGraphExecutor() {
 				fidelity: firstResumedFidelity
 			} : currentNode;
 			firstResumedFidelity = "";
+			if (config.summaryEngine) {
+				const effectiveFidelity = resolveFidelity(nodeToDispatch, lastIncomingEdge, graph);
+				const summaryLevel = parseFidelityLevel(effectiveFidelity);
+				if (summaryLevel !== null) {
+					const nodeContextContent = context.getString("factory.nodeContext", "");
+					if (nodeContextContent !== "") {
+						const summary = await config.summaryEngine.summarize(nodeContextContent, summaryLevel);
+						context.set("factory.compressedNodeContext", summary.content);
+						context.set("factory.nodeContext", summary.content);
+						config.eventBus?.emit("graph:context-summarized", {
+							runId: config.runId,
+							nodeId: nodeToDispatch.id,
+							level: summaryLevel,
+							originalTokenCount: summary.originalTokenCount ?? 0,
+							summaryTokenCount: summary.summaryTokenCount ?? 0
+						});
+					}
+				}
+			}
 			const startedAt = Date.now();
 			let outcome = await dispatchWithRetry(nodeToDispatch, context, graph, config, nodeRetries);
 			if (Date.now() - startedAt < 50) await new Promise((r) => setTimeout(r, 50));
@@ -23311,6 +23394,11 @@ function createGraphExecutor() {
 			{
 				const controllerStatus = outcome.status === "SUCCESS" ? "SUCCESS" : outcome.status === "PARTIAL_SUCCESS" ? "PARTIAL_SUCCESS" : "FAILURE";
 				controller.recordOutcome(nodeToDispatch.id, controllerStatus);
+				const iterContent = context.getString("factory.nodeContext", "");
+				controller.recordIterationContext({
+					index: convergenceIteration,
+					content: iterContent
+				});
 			}
 			if (outcome.contextUpdates) for (const [key, value] of Object.entries(outcome.contextUpdates)) context.set(key, value);
 			context.set("outcome", outcome.status.toLowerCase());
@@ -23398,6 +23486,7 @@ function createGraphExecutor() {
 			}
 			const nextNode = graph.nodes.get(edge.toNode);
 			if (!nextNode) throw new Error(`Edge target node "${edge.toNode}" not found in graph`);
+			lastIncomingEdge = edge;
 			currentNode = nextNode;
 		}
 	} };
@@ -36236,6 +36325,419 @@ function registerScenariosCommand(program) {
 	});
 }
 
+//#endregion
+//#region packages/factory/dist/context/summary-cache.js
+var SummaryCache = class {
+	config;
+	constructor(config) {
+		this.config = config;
+	}
+	summaryPath(hash, level) {
+		return join$1(this.config.storageDir, this.config.runId, "summaries", `${hash}-${level}.json`);
+	}
+	originalPath(hash) {
+		return join$1(this.config.storageDir, this.config.runId, "summaries", `${hash}.orig`);
+	}
+	async put(summary, originalContent) {
+		const dir = join$1(this.config.storageDir, this.config.runId, "summaries");
+		await mkdir$1(dir, { recursive: true });
+		const record = {
+			summary,
+			cachedAt: new Date().toISOString()
+		};
+		await writeFile$1(this.summaryPath(summary.originalHash, summary.level), JSON.stringify(record, null, 2));
+		if (originalContent !== void 0 && this.config.storeOriginals !== false) await writeFile$1(this.originalPath(summary.originalHash), originalContent);
+	}
+	async get(originalHash, level) {
+		try {
+			const raw = await readFile$1(this.summaryPath(originalHash, level), "utf-8");
+			const record = JSON.parse(raw);
+			return record.summary;
+		} catch (err) {
+			if (err.code === "ENOENT") return null;
+			throw err;
+		}
+	}
+	async getOriginal(originalHash) {
+		try {
+			return await readFile$1(this.originalPath(originalHash), "utf-8");
+		} catch (err) {
+			if (err.code === "ENOENT") return null;
+			throw err;
+		}
+	}
+};
+var CachingSummaryEngine = class {
+	inner;
+	cache;
+	name;
+	constructor(inner, cache) {
+		this.inner = inner;
+		this.cache = cache;
+		this.name = `caching(${inner.name})`;
+	}
+	async summarize(content, targetLevel, opts) {
+		const originalHash = createHash("sha256").update(content).digest("hex");
+		const cached = await this.cache.get(originalHash, targetLevel);
+		if (cached !== null) return cached;
+		const summary = await this.inner.summarize(content, targetLevel, opts);
+		await this.cache.put(summary, content);
+		return summary;
+	}
+	async expand(summary, targetLevel, opts) {
+		const original = await this.cache.getOriginal(summary.originalHash);
+		if (original !== null) return original;
+		return this.inner.expand(summary, targetLevel, opts);
+	}
+};
+
+//#endregion
+//#region packages/factory/dist/context/summary-metrics.js
+/**
+* Compute the compression ratio of a summary.
+* Returns summaryTokenCount / originalTokenCount in [0, 1].
+* Returns -1 as a sentinel when token counts are absent or originalTokenCount is zero.
+*/
+function computeCompressionRatio(summary) {
+	if (summary.originalTokenCount === void 0 || summary.originalTokenCount === 0 || summary.summaryTokenCount === void 0) return -1;
+	return summary.summaryTokenCount / summary.originalTokenCount;
+}
+/**
+* Extract key facts from content:
+* - Fenced code blocks (triple-backtick)
+* - File-path tokens matching known extensions
+* - Error-type names
+*/
+function extractKeyFacts(content) {
+	const facts = new Set();
+	const codeBlockRegex = /```[\s\S]*?```/g;
+	let match$1;
+	while ((match$1 = codeBlockRegex.exec(content)) !== null) facts.add(match$1[0].trim());
+	const filePathRegex = /[\w./]+(\.ts|\.js|\.json|\.md|\.go|\.py|\.yaml|\.yml)\b/g;
+	while ((match$1 = filePathRegex.exec(content)) !== null) facts.add(match$1[0]);
+	const errorTypeRegex = /\b(Error|Exception|ENOENT|ETIMEDOUT|TypeError|SyntaxError)\b/g;
+	while ((match$1 = errorTypeRegex.exec(content)) !== null) facts.add(match$1[0]);
+	return facts;
+}
+/**
+* Compute the key-fact retention rate between original and summarized content.
+* Returns the fraction of original key facts that appear in the summarized content.
+* Returns 1.0 when the original has no key facts.
+*/
+function computeKeyFactRetentionRate(original, summarized) {
+	const originalFacts = extractKeyFacts(original);
+	const summarizedFacts = extractKeyFacts(summarized);
+	if (originalFacts.size === 0) return 1;
+	const preserved = [...originalFacts].filter((f$1) => summarizedFacts.has(f$1)).length;
+	return preserved / originalFacts.size;
+}
+
+//#endregion
+//#region packages/factory/dist/context/cli-command.js
+/** Build a CLIJsonOutput envelope. */
+function buildJsonOutput(command, data, version) {
+	return {
+		timestamp: new Date().toISOString(),
+		version,
+		command,
+		data
+	};
+}
+/** Minimal stub SummaryEngine used when no engineFactory is provided. */
+var StubSummaryEngine = class {
+	name = "stub";
+	async summarize(content, targetLevel) {
+		const originalHash = createHash("sha256").update(content).digest("hex");
+		return {
+			level: targetLevel,
+			content,
+			originalHash,
+			createdAt: new Date().toISOString()
+		};
+	}
+	async expand(summary) {
+		return summary.content;
+	}
+};
+/**
+* Scan all `*.json` summary files in summariesDir to find the most recently
+* stored summary matching the given iteration number.
+*
+* Matches on `record.summary.iterationIndex === iteration`.
+* Returns null if no match is found.
+*/
+async function findSummaryForIteration(summariesDir, iteration) {
+	let allFiles;
+	try {
+		allFiles = await readdir$1(summariesDir);
+	} catch {
+		return null;
+	}
+	const jsonFiles = allFiles.filter((f$1) => f$1.endsWith(".json"));
+	const matches = [];
+	for (const file of jsonFiles) try {
+		const raw = await readFile$1(join$1(summariesDir, file), "utf-8");
+		const record = JSON.parse(raw);
+		if (record.summary.iterationIndex === iteration) matches.push({
+			hash: record.summary.originalHash,
+			record,
+			cachedAt: new Date(record.cachedAt).getTime()
+		});
+	} catch {}
+	if (matches.length === 0) return null;
+	matches.sort((a, b) => b.cachedAt - a.cachedAt);
+	const best = matches[0];
+	return {
+		hash: best.hash,
+		record: best.record
+	};
+}
+/**
+* Core logic for `factory context summarize`.
+*
+* Loads the original content, runs it through CachingSummaryEngine, stores the
+* result, and prints compression statistics.
+*
+* @returns Exit code: 0 on success, 1 on error.
+*/
+async function summarizeAction(opts, deps, output = {
+	stdout: process.stdout,
+	stderr: process.stderr
+}) {
+	const { stdout, stderr } = output;
+	if (!/^\d+$/.test(opts.iteration)) {
+		stderr.write(`Error: --iteration must be a non-negative integer, got: ${opts.iteration}\n`);
+		return 1;
+	}
+	const iteration = parseInt(opts.iteration, 10);
+	const validLevels = [
+		"full",
+		"high",
+		"medium",
+		"low"
+	];
+	if (!validLevels.includes(opts.level)) {
+		stderr.write(`Error: --level must be one of: full, high, medium, low. Got: ${opts.level}\n`);
+		return 1;
+	}
+	const level = opts.level;
+	const summariesDir = join$1(deps.storageDir, "runs", opts.run, "summaries");
+	try {
+		await stat$1(summariesDir);
+	} catch {
+		stderr.write(`Error: Run directory not found: ${summariesDir}\n`);
+		return 1;
+	}
+	const found = await findSummaryForIteration(summariesDir, iteration);
+	if (!found) {
+		stderr.write(`Error: No summary found for iteration ${iteration} in run ${opts.run}\n`);
+		return 1;
+	}
+	const cache = new SummaryCache({
+		runId: opts.run,
+		storageDir: join$1(deps.storageDir, "runs")
+	});
+	const originalContent = await cache.getOriginal(found.hash);
+	if (originalContent === null) {
+		stderr.write(`Error: Original content (.orig) not found for hash ${found.hash.slice(0, 8)} in run ${opts.run}\n`);
+		return 1;
+	}
+	const innerEngine = deps.engineFactory ? deps.engineFactory() : new StubSummaryEngine();
+	const engine = new CachingSummaryEngine(innerEngine, cache);
+	const summary = await engine.summarize(originalContent, level);
+	await cache.put(summary, originalContent);
+	const compressionRatio = computeCompressionRatio(summary);
+	if (opts.outputFormat === "json") {
+		const data = {
+			hash: summary.originalHash,
+			level: summary.level,
+			compressionRatio,
+			summaryTokenCount: summary.summaryTokenCount,
+			originalTokenCount: summary.originalTokenCount
+		};
+		stdout.write(JSON.stringify(buildJsonOutput("factory context summarize", data, deps.version)) + "\n");
+	} else {
+		const ratioStr = compressionRatio >= 0 ? compressionRatio.toFixed(2) : "n/a";
+		stdout.write(`Summarized iteration ${iteration} → level ${level} | hash: ${summary.originalHash.slice(0, 8)} | compression: ${ratioStr}\n`);
+	}
+	return 0;
+}
+/**
+* Core logic for `factory context expand`.
+*
+* Finds the stored summary for the given iteration, then expands it back
+* toward full content (lossless if .orig exists, LLM fallback otherwise).
+*
+* @returns Exit code: 0 on success, 1 on error.
+*/
+async function expandAction(opts, deps, output = {
+	stdout: process.stdout,
+	stderr: process.stderr
+}) {
+	const { stdout, stderr } = output;
+	if (!/^\d+$/.test(opts.iteration)) {
+		stderr.write(`Error: --iteration must be a non-negative integer, got: ${opts.iteration}\n`);
+		return 1;
+	}
+	const iteration = parseInt(opts.iteration, 10);
+	const summariesDir = join$1(deps.storageDir, "runs", opts.run, "summaries");
+	try {
+		await stat$1(summariesDir);
+	} catch {
+		stderr.write(`Error: Run directory not found: ${summariesDir}\n`);
+		return 1;
+	}
+	const found = await findSummaryForIteration(summariesDir, iteration);
+	if (!found) {
+		stderr.write(`Error: No summary found for iteration ${iteration} in run ${opts.run}\n`);
+		return 1;
+	}
+	const cache = new SummaryCache({
+		runId: opts.run,
+		storageDir: join$1(deps.storageDir, "runs")
+	});
+	const innerEngine = deps.engineFactory ? deps.engineFactory() : new StubSummaryEngine();
+	const engine = new CachingSummaryEngine(innerEngine, cache);
+	const expandedContent = await engine.expand(found.record.summary, "full");
+	if (opts.outputFormat === "json") {
+		const data = {
+			hash: found.record.summary.originalHash,
+			level: found.record.summary.level,
+			expandedLength: expandedContent.length,
+			content: expandedContent
+		};
+		stdout.write(JSON.stringify(buildJsonOutput("factory context expand", data, deps.version)) + "\n");
+	} else stdout.write(expandedContent + "\n");
+	return 0;
+}
+/**
+* Core logic for `factory context stats`.
+*
+* Reads all stored summary records for a run, computes compression metrics,
+* and prints a formatted table (or JSON array).
+*
+* @returns Exit code: 0 on success, 1 on error.
+*/
+async function statsAction(opts, deps, output = {
+	stdout: process.stdout,
+	stderr: process.stderr
+}) {
+	const { stdout, stderr } = output;
+	const summariesDir = join$1(deps.storageDir, "runs", opts.run, "summaries");
+	try {
+		await stat$1(summariesDir);
+	} catch {
+		stderr.write(`Error: Run directory not found: ${summariesDir}\n`);
+		return 1;
+	}
+	let allFiles;
+	try {
+		allFiles = await readdir$1(summariesDir);
+	} catch {
+		stderr.write(`Error: Could not read summaries directory: ${summariesDir}\n`);
+		return 1;
+	}
+	const jsonFiles = allFiles.filter((f$1) => f$1.endsWith(".json"));
+	const rows = [];
+	for (const file of jsonFiles) try {
+		const raw = await readFile$1(join$1(summariesDir, file), "utf-8");
+		const record = JSON.parse(raw);
+		const compressionRatio = computeCompressionRatio(record.summary);
+		let keyFactRetentionRate = -1;
+		try {
+			const origPath = join$1(summariesDir, `${record.summary.originalHash}.orig`);
+			const originalContent = await readFile$1(origPath, "utf-8");
+			keyFactRetentionRate = computeKeyFactRetentionRate(originalContent, record.summary.content);
+		} catch {}
+		rows.push({
+			hash: record.summary.originalHash,
+			level: record.summary.level,
+			compressionRatio,
+			keyFactRetentionRate,
+			cachedAt: record.cachedAt
+		});
+	} catch {}
+	rows.sort((a, b) => new Date(a.cachedAt).getTime() - new Date(b.cachedAt).getTime());
+	if (opts.outputFormat === "json") {
+		stdout.write(JSON.stringify(buildJsonOutput("factory context stats", rows, deps.version)) + "\n");
+		return 0;
+	}
+	if (rows.length === 0) {
+		stdout.write("No summaries found.\n");
+		return 0;
+	}
+	const headers = [
+		"Hash",
+		"Level",
+		"CompRatio",
+		"KeyRetention",
+		"CachedAt"
+	];
+	const tableRows = rows.map((row) => ({
+		Hash: row.hash.slice(0, 8),
+		Level: row.level,
+		CompRatio: row.compressionRatio >= 0 ? row.compressionRatio.toFixed(4) : "n/a",
+		KeyRetention: row.keyFactRetentionRate >= 0 ? row.keyFactRetentionRate.toFixed(4) : "n/a",
+		CachedAt: row.cachedAt
+	}));
+	const widths = headers.map((h) => {
+		const dataMax = tableRows.reduce((max, row) => {
+			const val = row[h] ?? "";
+			return Math.max(max, val.length);
+		}, 0);
+		return Math.max(h.length, dataMax);
+	});
+	const headerLine = headers.map((h, i) => h.padEnd(widths[i])).join(" | ");
+	const separator = widths.map((w) => "-".repeat(w)).join("-+-");
+	stdout.write(headerLine + "\n");
+	stdout.write(separator + "\n");
+	for (const row of tableRows) {
+		const line = headers.map((h, i) => (row[h] ?? "").padEnd(widths[i])).join(" | ");
+		stdout.write(line + "\n");
+	}
+	return 0;
+}
+/**
+* Register the `context` subcommand group on the provided factory command.
+*
+* Subcommands registered:
+*   factory context summarize --run <id> --iteration <n> --level <level>
+*   factory context expand    --run <id> --iteration <n>
+*   factory context stats     --run <id>
+*
+* @param factoryCmd    - The factory Commander command to attach to
+* @param version       - CLI version string for JSON output (e.g. "1.2.3")
+* @param storageDir    - Base storage directory (defaults to `{cwd}/.substrate`)
+* @param engineFactory - Optional SummaryEngine factory for testing injection
+*/
+function registerContextCommand(factoryCmd, version, storageDir, engineFactory) {
+	const resolvedStorageDir = storageDir ?? join$1(process.cwd(), ".substrate");
+	const contextCmd = factoryCmd.command("context").description("Inspect and manage pyramid summaries for factory runs");
+	contextCmd.command("summarize").description("Compress and store a run iteration to the target summary level").requiredOption("--run <id>", "Run ID").requiredOption("--iteration <n>", "Iteration number").requiredOption("--level <level>", "Summary level: high | medium | low").option("--output-format <format>", "Output format: text | json", "text").action(async (opts) => {
+		const code = await summarizeAction(opts, {
+			storageDir: resolvedStorageDir,
+			version,
+			...engineFactory !== void 0 ? { engineFactory } : {}
+		});
+		if (code !== 0) process.exit(code);
+	});
+	contextCmd.command("expand").description("Expand a stored summary for a run iteration back to full content").requiredOption("--run <id>", "Run ID").requiredOption("--iteration <n>", "Iteration number").option("--output-format <format>", "Output format: text | json", "text").action(async (opts) => {
+		const code = await expandAction(opts, {
+			storageDir: resolvedStorageDir,
+			version,
+			...engineFactory !== void 0 ? { engineFactory } : {}
+		});
+		if (code !== 0) process.exit(code);
+	});
+	contextCmd.command("stats").description("Report per-run compression statistics for all stored summaries").requiredOption("--run <id>", "Run ID").option("--output-format <format>", "Output format: text | json", "text").action(async (opts) => {
+		const code = await statsAction(opts, {
+			storageDir: resolvedStorageDir,
+			version
+		});
+		if (code !== 0) process.exit(code);
+	});
+}
+
 //#endregion
 //#region packages/factory/dist/twins/schema.js
 /**
@@ -37119,6 +37621,7 @@ function registerFactoryCommand(program, options) {
 		else process.stdout.write(`✗ ${passedCount}/${TOTAL_RULE_COUNT} rules passed, ${errors.length} ${errLabel}, ${warnings.length} ${warnLabel}\n`);
 		if (errors.length > 0) process.exit(1);
 	});
+	registerContextCommand(factoryCmd, "0.0.0");
 	const twinsCmd = factoryCmd.command("twins").description("Digital twin template management");
 	twinsCmd.command("templates").description("List available built-in twin templates").action(() => {
 		const templates = listTwinTemplates();
@@ -37757,9 +38260,8 @@ async function runRunAction(options) {
 		}
 		const staleRuns = await getRunningPipelineRuns(adapter) ?? [];
 		if (staleRuns.length > 0) {
-			const processInfo = inspectProcessTree({ projectRoot });
 			let swept = 0;
-			for (const stale of staleRuns) if (processInfo.orchestrator_pid === null) {
+			for (const stale of staleRuns) {
 				await updatePipelineRun(adapter, stale.id, { status: "failed" });
 				swept++;
 			}
@@ -38439,6 +38941,8 @@ async function runFullPipeline(options) {
 						input_tokens: result.tokenUsage.input,
 						output_tokens: result.tokenUsage.output,
 						cost_usd: costUsd
+					}).catch((err) => {
+						logger.warn({ err }, "Failed to record analysis token usage (non-fatal)");
 					});
 				}
 				if (result.result === "failed") {
@@ -38462,6 +38966,8 @@ async function runFullPipeline(options) {
 						input_tokens: result.tokenUsage.input,
 						output_tokens: result.tokenUsage.output,
 						cost_usd: costUsd
+					}).catch((err) => {
+						logger.warn({ err }, "Failed to record planning token usage (non-fatal)");
 					});
 				}
 				if (result.result === "failed") {
@@ -38488,6 +38994,8 @@ async function runFullPipeline(options) {
 						input_tokens: result.tokenUsage.input,
 						output_tokens: result.tokenUsage.output,
 						cost_usd: costUsd
+					}).catch((err) => {
+						logger.warn({ err }, "Failed to record research token usage (non-fatal)");
 					});
 				}
 				if (result.result === "failed") {
@@ -38511,6 +39019,8 @@ async function runFullPipeline(options) {
 						input_tokens: result.tokenUsage.input,
 						output_tokens: result.tokenUsage.output,
 						cost_usd: costUsd
+					}).catch((err) => {
+						logger.warn({ err }, "Failed to record ux-design token usage (non-fatal)");
 					});
 				}
 				if (result.result === "failed") {
@@ -38534,6 +39044,8 @@ async function runFullPipeline(options) {
 						input_tokens: result.tokenUsage.input,
 						output_tokens: result.tokenUsage.output,
 						cost_usd: costUsd
+					}).catch((err) => {
+						logger.warn({ err }, "Failed to record solutioning token usage (non-fatal)");
 					});
 				}
 				if (result.result === "failed") {
@@ -38752,4 +39264,4 @@ function registerRunCommand(program, _version = "0.0.0", projectRoot = process.c
 
 //#endregion
 export { AdapterTelemetryPersistence, AppError, DoltRepoMapMetaRepository, DoltSymbolRepository, ERR_REPO_MAP_STORAGE_WRITE, GitClient, GrammarLoader, RepoMapInjector, RepoMapModule, RepoMapQueryEngine, RepoMapStorage, SymbolParser, createContextCompiler, createDispatcher, createEventEmitter, createImplementationOrchestrator, createPackLoader, createPhaseOrchestrator, createStopAfterGate, createTelemetryAdvisor, formatPhaseCompletionSummary, getFactoryRunSummaries, getScenarioResultsForRun, getTwinRunsForRun, listGraphRuns, normalizeGraphSummaryToStatus, registerFactoryCommand, registerRunCommand, registerScenariosCommand, resolveStoryKeys, runAnalysisPhase, runPlanningPhase, runRunAction, runSolutioningPhase, validateStopAfterFromConflict };
-//# sourceMappingURL=run-Bku8fmY3.js.map
+//# sourceMappingURL=run-gXtnH8lO.js.map

package/dist/{run-N5rHJu-Y.js → run-m7RCkpmx.js}

@@ -1,8 +1,8 @@
-import "./health-DswaC1q5.js";
+import "./health-Cx2ZhRNT.js";
 import "./logger-KeHncl-f.js";
 import "./helpers-CElYrONe.js";
-import "./dist-CLvAwmT7.js";
-import { normalizeGraphSummaryToStatus, registerRunCommand, runRunAction } from "./run-Bku8fmY3.js";
+import "./dist-Bm0qSZer.js";
+import { normalizeGraphSummaryToStatus, registerRunCommand, runRunAction } from "./run-gXtnH8lO.js";
 import "./routing-CcBOCuC9.js";
 import "./decisions-C0pz9Clx.js";
 

package/dist/{upgrade-DT0I_-1E.js → upgrade-BcL4ZV3o.js}

@@ -1,4 +1,4 @@
-import { createVersionManager } from "./dist-CLvAwmT7.js";
+import { createVersionManager } from "./dist-Bm0qSZer.js";
 import { execSync, spawn } from "child_process";
 import * as readline from "readline";
 
@@ -123,4 +123,4 @@ function registerUpgradeCommand(program) {
 
 //#endregion
 export { isGlobalInstall, registerUpgradeCommand, runUpgradeCommand };
-//# sourceMappingURL=upgrade-DT0I_-1E.js.map
+//# sourceMappingURL=upgrade-BcL4ZV3o.js.map

package/dist/{upgrade-DPdh5w4p.js → upgrade-CbwnF2hv.js}

@@ -1,5 +1,5 @@
-import "./dist-CLvAwmT7.js";
+import "./dist-Bm0qSZer.js";
 import "./version-manager-impl-BmOWu8ml.js";
-import { isGlobalInstall, registerUpgradeCommand, runUpgradeCommand } from "./upgrade-DT0I_-1E.js";
+import { isGlobalInstall, registerUpgradeCommand, runUpgradeCommand } from "./upgrade-BcL4ZV3o.js";
 
 export { isGlobalInstall, registerUpgradeCommand, runUpgradeCommand };

package/dist/{version-manager-impl-BHnUB2tl.js → version-manager-impl-DBx3ovp9.js}

@@ -1,4 +1,4 @@
-import { VersionManagerImpl, createVersionManager } from "./dist-CLvAwmT7.js";
+import { VersionManagerImpl, createVersionManager } from "./dist-Bm0qSZer.js";
 import "./version-manager-impl-BmOWu8ml.js";
 
 export { createVersionManager };

package/package.json

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

package/dist/adapter-registry-DbLuI3IA.js

@@ -1,4 +0,0 @@
-import { AdapterRegistry } from "./dist-CLvAwmT7.js";
-import "./adapter-registry-DXLMTmfD.js";
-
-export { AdapterRegistry };