substrate-ai 0.19.10 → 0.19.12

package/dist/cli/index.js

@@ -4,7 +4,7 @@ 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, 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, listRunMetrics, loadParentRunDecisions, supersedeDecision, tagRunAsBaseline, updatePipelineRun } from "../dist-adzGUKPc.js";
 import "../adapter-registry-DXLMTmfD.js";
-import { AdapterTelemetryPersistence, AppError, DoltRepoMapMetaRepository, DoltSymbolRepository, ERR_REPO_MAP_STORAGE_WRITE, EpicIngester, GitClient, GrammarLoader, RepoMapInjector, RepoMapModule, RepoMapQueryEngine, RepoMapStorage, SymbolParser, createContextCompiler, createDispatcher, createEventEmitter, createImplementationOrchestrator, createPackLoader, createPhaseOrchestrator, createStopAfterGate, createTelemetryAdvisor, formatPhaseCompletionSummary, getFactoryRunSummaries, getScenarioResultsForRun, getTwinRunsForRun, listGraphRuns, registerExportCommand, registerFactoryCommand, registerRunCommand, registerScenariosCommand, resolveStoryKeys, runAnalysisPhase, runPlanningPhase, runSolutioningPhase, validateStopAfterFromConflict } from "../run-NJQHRIYt.js";
+import { AdapterTelemetryPersistence, AppError, DoltRepoMapMetaRepository, DoltSymbolRepository, ERR_REPO_MAP_STORAGE_WRITE, EpicIngester, GitClient, GrammarLoader, RepoMapInjector, RepoMapModule, RepoMapQueryEngine, RepoMapStorage, SymbolParser, createContextCompiler, createDispatcher, createEventEmitter, createImplementationOrchestrator, createPackLoader, createPhaseOrchestrator, createStopAfterGate, createTelemetryAdvisor, formatPhaseCompletionSummary, getFactoryRunSummaries, getScenarioResultsForRun, getTwinRunsForRun, listGraphRuns, registerExportCommand, registerFactoryCommand, registerRunCommand, registerScenariosCommand, resolveStoryKeys, runAnalysisPhase, runPlanningPhase, runSolutioningPhase, validateStopAfterFromConflict } from "../run-1Ywys7Fy.js";
 import "../errors-CZdr5Wqb.js";
 import "../routing-CcBOCuC9.js";
 import "../decisions-C0pz9Clx.js";
@@ -1155,7 +1155,8 @@ const SubstrateConfigSchema = z.object({
 	budget: BudgetConfigSchema.optional(),
 	token_ceilings: TokenCeilingsSchema.optional(),
 	dispatch_timeouts: DispatchTimeoutsSchema.optional(),
-	telemetry: TelemetryConfigSchema.optional()
+	telemetry: TelemetryConfigSchema.optional(),
+	default_agent: z.string().optional()
 }).strict();
 const PartialSubstrateConfigSchema = z.object({
 	config_format_version: z.enum(["1"]).optional(),
@@ -1170,7 +1171,8 @@ const PartialSubstrateConfigSchema = z.object({
 	budget: BudgetConfigSchema.partial().optional(),
 	token_ceilings: TokenCeilingsSchema.optional(),
 	dispatch_timeouts: DispatchTimeoutsSchema.optional(),
-	telemetry: TelemetryConfigSchema.partial().optional()
+	telemetry: TelemetryConfigSchema.partial().optional(),
+	default_agent: z.string().optional()
 }).strict();
 
 //#endregion
@@ -2676,7 +2678,7 @@ function mapInternalPhaseToEventPhase(internalPhase) {
 	}
 }
 async function runResumeAction(options) {
-	const { runId: specifiedRunId, stopAfter, outputFormat, projectRoot, concurrency, pack: packName, events: eventsFlag, registry, maxReviewCycles = 2 } = options;
+	const { runId: specifiedRunId, stopAfter, outputFormat, projectRoot, concurrency, pack: packName, events: eventsFlag, registry, maxReviewCycles = 2, agent: agentId } = options;
 	if (stopAfter !== void 0 && !VALID_PHASES.includes(stopAfter)) {
 		const errorMsg = `Invalid phase: "${stopAfter}". Valid phases: ${VALID_PHASES.join(", ")}`;
 		if (outputFormat === "json") process.stdout.write(formatOutput(null, "json", false, errorMsg) + "\n");
@@ -2760,7 +2762,8 @@ async function runResumeAction(options) {
 			existingRunId: runId,
 			projectRoot,
 			registry,
-			stories: options.stories ?? scopedStories
+			stories: options.stories ?? scopedStories,
+			agentId
 		});
 	} catch (err) {
 		const msg = err instanceof Error ? err.message : String(err);
@@ -2775,7 +2778,7 @@ async function runResumeAction(options) {
 	}
 }
 async function runFullPipelineFromPhase(options) {
-	const { packName, packPath, dbDir, dbPath, startPhase, stopAfter, concept, concurrency, outputFormat, events: eventsFlag, existingRunId, projectRoot, registry: injectedRegistry, stories: explicitStories, maxReviewCycles = 2 } = options;
+	const { packName, packPath, dbDir, dbPath, startPhase, stopAfter, concept, concurrency, outputFormat, events: eventsFlag, existingRunId, projectRoot, registry: injectedRegistry, stories: explicitStories, maxReviewCycles = 2, agentId } = options;
 	if (!existsSync$1(dbDir)) mkdirSync$1(dbDir, { recursive: true });
 	const adapter = createDatabaseAdapter({
 		backend: "auto",
@@ -2805,7 +2808,8 @@ async function runFullPipelineFromPhase(options) {
 			db: adapter,
 			pack,
 			contextCompiler,
-			dispatcher
+			dispatcher,
+			agentId
 		};
 		const phaseOrchestrator = createPhaseOrchestrator({
 			db: adapter,
@@ -2836,7 +2840,7 @@ async function runFullPipelineFromPhase(options) {
 					const costUsd = (result.tokenUsage.input * 3 + result.tokenUsage.output * 15) / 1e6;
 					await addTokenUsage(adapter, runId, {
 						phase: "analysis",
-						agent: "claude-code",
+						agent: agentId ?? "claude-code",
 						input_tokens: result.tokenUsage.input,
 						output_tokens: result.tokenUsage.output,
 						cost_usd: costUsd
@@ -2856,7 +2860,7 @@ async function runFullPipelineFromPhase(options) {
 					const costUsd = (result.tokenUsage.input * 3 + result.tokenUsage.output * 15) / 1e6;
 					await addTokenUsage(adapter, runId, {
 						phase: "planning",
-						agent: "claude-code",
+						agent: agentId ?? "claude-code",
 						input_tokens: result.tokenUsage.input,
 						output_tokens: result.tokenUsage.output,
 						cost_usd: costUsd
@@ -2876,7 +2880,7 @@ async function runFullPipelineFromPhase(options) {
 					const costUsd = (result.tokenUsage.input * 3 + result.tokenUsage.output * 15) / 1e6;
 					await addTokenUsage(adapter, runId, {
 						phase: "solutioning",
-						agent: "claude-code",
+						agent: agentId ?? "claude-code",
 						input_tokens: result.tokenUsage.input,
 						output_tokens: result.tokenUsage.output,
 						cost_usd: costUsd
@@ -2917,6 +2921,7 @@ async function runFullPipelineFromPhase(options) {
 						enableHeartbeat: eventsFlag === true
 					},
 					projectRoot,
+					agentId,
 					...ingestionServer !== void 0 ? { ingestionServer } : {},
 					...telemetryPersistence !== void 0 ? { telemetryPersistence } : {}
 				});
@@ -3005,7 +3010,7 @@ async function runFullPipelineFromPhase(options) {
 							const costUsd = (input * 3 + output * 15) / 1e6;
 							addTokenUsage(adapter, runId, {
 								phase: payload.phase,
-								agent: "claude-code",
+								agent: agentId ?? "claude-code",
 								input_tokens: input,
 								output_tokens: output,
 								cost_usd: costUsd
@@ -3092,7 +3097,7 @@ async function runFullPipelineFromPhase(options) {
 	}
 }
 function registerResumeCommand(program, _version = "0.0.0", projectRoot = process.cwd(), registry) {
-	program.command("resume").description("Resume a previously interrupted pipeline run").option("--run-id <id>", "Pipeline run ID to resume (defaults to latest)").option("--pack <name>", "Methodology pack name", "bmad").option("--stop-after <phase>", "Stop pipeline after this phase completes (overrides saved state)").option("--concurrency <n>", "Maximum parallel conflict groups", (v) => parseInt(v, 10), 3).option("--project-root <path>", "Project root directory", projectRoot).option("--output-format <format>", "Output format: human (default) or json", "human").option("--events", "Emit structured NDJSON events on stdout for programmatic consumption").option("--max-review-cycles <n>", "Maximum review cycles per story (default: 2)", (v) => parseInt(v, 10), 2).action(async (opts) => {
+	program.command("resume").description("Resume a previously interrupted pipeline run").option("--run-id <id>", "Pipeline run ID to resume (defaults to latest)").option("--pack <name>", "Methodology pack name", "bmad").option("--stop-after <phase>", "Stop pipeline after this phase completes (overrides saved state)").option("--concurrency <n>", "Maximum parallel conflict groups", (v) => parseInt(v, 10), 3).option("--project-root <path>", "Project root directory", projectRoot).option("--output-format <format>", "Output format: human (default) or json", "human").option("--events", "Emit structured NDJSON events on stdout for programmatic consumption").option("--max-review-cycles <n>", "Maximum review cycles per story (default: 2)", (v) => parseInt(v, 10), 2).option("--agent <id>", "Agent backend: claude-code (default), codex, or gemini").action(async (opts) => {
 		const outputFormat = opts.outputFormat === "json" ? "json" : "human";
 		const exitCode = await runResumeAction({
 			runId: opts.runId,
@@ -3103,6 +3108,7 @@ function registerResumeCommand(program, _version = "0.0.0", projectRoot = proces
 			pack: opts.pack,
 			events: opts.events,
 			maxReviewCycles: opts.maxReviewCycles,
+			agent: opts.agent,
 			registry
 		});
 		process.exitCode = exitCode;
@@ -3746,7 +3752,7 @@ async function runPostPhaseSupersessionDetection(adapter, amendmentRunId, curren
 	}
 }
 async function runAmendAction(options) {
-	const { concept: conceptArg, conceptFile, runId: specifiedRunId, stopAfter, from: startPhase, projectRoot, pack: packName, registry: injectedRegistry } = options;
+	const { concept: conceptArg, conceptFile, runId: specifiedRunId, stopAfter, from: startPhase, projectRoot, pack: packName, registry: injectedRegistry, agent: agentId } = options;
 	let concept;
 	if (conceptFile !== void 0 && conceptFile !== "") try {
 		concept = await readFile(conceptFile, "utf-8");
@@ -3844,7 +3850,8 @@ async function runAmendAction(options) {
 			db: adapter,
 			pack,
 			contextCompiler,
-			dispatcher
+			dispatcher,
+			agentId
 		};
 		const phaseOrder = [
 			"analysis",
@@ -3888,7 +3895,7 @@ async function runAmendAction(options) {
 					const costUsd = (result.tokenUsage.input * 3 + result.tokenUsage.output * 15) / 1e6;
 					await addTokenUsage(adapter, amendmentRunId, {
 						phase: "analysis",
-						agent: "claude-code",
+						agent: agentId ?? "claude-code",
 						input_tokens: result.tokenUsage.input,
 						output_tokens: result.tokenUsage.output,
 						cost_usd: costUsd
@@ -3910,7 +3917,7 @@ async function runAmendAction(options) {
 					const costUsd = (result.tokenUsage.input * 3 + result.tokenUsage.output * 15) / 1e6;
 					await addTokenUsage(adapter, amendmentRunId, {
 						phase: "planning",
-						agent: "claude-code",
+						agent: agentId ?? "claude-code",
 						input_tokens: result.tokenUsage.input,
 						output_tokens: result.tokenUsage.output,
 						cost_usd: costUsd
@@ -3932,7 +3939,7 @@ async function runAmendAction(options) {
 					const costUsd = (result.tokenUsage.input * 3 + result.tokenUsage.output * 15) / 1e6;
 					await addTokenUsage(adapter, amendmentRunId, {
 						phase: "solutioning",
-						agent: "claude-code",
+						agent: agentId ?? "claude-code",
 						input_tokens: result.tokenUsage.input,
 						output_tokens: result.tokenUsage.output,
 						cost_usd: costUsd
@@ -4003,7 +4010,7 @@ async function runAmendAction(options) {
 	}
 }
 function registerAmendCommand(program, _version = "0.0.0", projectRoot = process.cwd(), registry) {
-	program.command("amend").description("Run an amendment pipeline against a completed run and an existing run").option("--concept <text>", "Amendment concept description (inline)").option("--concept-file <path>", "Path to concept file").option("--run-id <id>", "Parent run ID (defaults to latest completed run)").option("--stop-after <phase>", "Stop pipeline after this phase completes").option("--from <phase>", "Start pipeline from this phase").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").action(async (opts) => {
+	program.command("amend").description("Run an amendment pipeline against a completed run and an existing run").option("--concept <text>", "Amendment concept description (inline)").option("--concept-file <path>", "Path to concept file").option("--run-id <id>", "Parent run ID (defaults to latest completed run)").option("--stop-after <phase>", "Stop pipeline after this phase completes").option("--from <phase>", "Start pipeline from this phase").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("--agent <id>", "Agent backend: claude-code (default), codex, or gemini").action(async (opts) => {
 		const exitCode = await runAmendAction({
 			concept: opts.concept,
 			conceptFile: opts.conceptFile,
@@ -4012,6 +4019,7 @@ function registerAmendCommand(program, _version = "0.0.0", projectRoot = process
 			from: opts.from,
 			projectRoot: opts.projectRoot,
 			pack: opts.pack,
+			agent: opts.agent,
 			registry
 		});
 		process.exitCode = exitCode;
@@ -4547,7 +4555,7 @@ async function runSupervisorAction(options, deps = {}) {
 								await initSchema(expAdapter);
 								const { runRunAction: runPipeline } = await import(
 									/* @vite-ignore */
-									"../run-CAMKyu0F.js"
+									"../run-zc3SEWY1.js"
 );
 								const runStoryFn = async (opts) => {
 									const exitCode = await runPipeline({
@@ -7159,7 +7167,7 @@ function registerBrainstormCommand(program, _version = "0.0.0", projectRoot = pr
 //#region src/cli/commands/retry-escalated.ts
 const logger$3 = createLogger("retry-escalated-cmd");
 async function runRetryEscalatedAction(options) {
-	const { runId, dryRun, force, outputFormat, projectRoot, concurrency, pack: packName, registry: injectedRegistry } = options;
+	const { runId, dryRun, force, outputFormat, projectRoot, concurrency, pack: packName, registry: injectedRegistry, agent: agentId } = options;
 	const dbRoot = await resolveMainRepoRoot(projectRoot);
 	const dbPath = join(dbRoot, ".substrate", "substrate.db");
 	const doltDir = join(dbRoot, ".substrate", "state", ".dolt");
@@ -7262,7 +7270,8 @@ async function runRetryEscalatedAction(options) {
 				pipelineRunId: pipelineRun.id,
 				...Object.keys(perStoryContextCeilings).length > 0 ? { perStoryContextCeilings } : {}
 			},
-			projectRoot
+			projectRoot,
+			agentId
 		});
 		eventBus.on("orchestrator:story-phase-complete", (payload) => {
 			try {
@@ -7272,7 +7281,7 @@ async function runRetryEscalatedAction(options) {
 					const costUsd = (input * 3 + output * 15) / 1e6;
 					addTokenUsage(adapter, pipelineRun.id, {
 						phase: payload.phase,
-						agent: "claude-code",
+						agent: agentId ?? "claude-code",
 						input_tokens: input,
 						output_tokens: output,
 						cost_usd: costUsd
@@ -7316,7 +7325,7 @@ function registerRetryEscalatedCommand(program, _version = "0.0.0", projectRoot
 		const n = parseInt(v, 10);
 		if (isNaN(n) || n < 1) throw new Error(`--concurrency must be a positive integer, got: ${v}`);
 		return n;
-	}, 3).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").action(async (opts) => {
+	}, 3).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("--agent <id>", "Agent backend: claude-code (default), codex, or gemini").action(async (opts) => {
 		const outputFormat = opts.outputFormat === "json" ? "json" : "human";
 		const exitCode = await runRetryEscalatedAction({
 			runId: opts.runId,
@@ -7326,6 +7335,7 @@ function registerRetryEscalatedCommand(program, _version = "0.0.0", projectRoot
 			projectRoot: opts.projectRoot,
 			concurrency: opts.concurrency,
 			pack: opts.pack,
+			agent: opts.agent,
 			registry
 		});
 		process.exitCode = exitCode;

package/dist/index.d.ts

@@ -1528,6 +1528,7 @@ declare const SubstrateConfigSchema: z.ZodObject<{
     enabled: z.ZodDefault<z.ZodBoolean>;
     port: z.ZodDefault<z.ZodNumber>;
   }, z.core.$strict>>;
+  default_agent: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>;
 type SubstrateConfig = z.infer<typeof SubstrateConfigSchema>;
 

package/dist/{run-NJQHRIYt.js → run-1Ywys7Fy.js}

@@ -5334,7 +5334,7 @@ async function runCreateStory(deps, params) {
 	}, "Prompt assembled for create-story");
 	const handle = deps.dispatcher.dispatch({
 		prompt,
-		agent: "claude-code",
+		agent: deps.agentId ?? "claude-code",
 		taskType: "create-story",
 		outputSchema: CreateStoryResultSchema,
 		maxTurns: 50,
@@ -6556,7 +6556,7 @@ async function runDevStory(deps, params) {
 	try {
 		const handle = deps.dispatcher.dispatch({
 			prompt,
-			agent: "claude-code",
+			agent: deps.agentId ?? "claude-code",
 			taskType: "dev-story",
 			timeout: DEFAULT_TIMEOUT_MS$1,
 			outputSchema: DevStoryResultSchema,
@@ -7025,7 +7025,7 @@ async function runCodeReview(deps, params) {
 	const { prompt } = assembleResult;
 	const handle = deps.dispatcher.dispatch({
 		prompt,
-		agent: "claude-code",
+		agent: deps.agentId ?? "claude-code",
 		taskType: "code-review",
 		outputSchema: CodeReviewResultSchema,
 		workingDirectory: deps.projectRoot,
@@ -7240,7 +7240,7 @@ async function runTestPlan(deps, params) {
 	try {
 		const handle = deps.dispatcher.dispatch({
 			prompt,
-			agent: "claude-code",
+			agent: deps.agentId ?? "claude-code",
 			taskType: "test-plan",
 			timeout: DEFAULT_TIMEOUT_MS,
 			outputSchema: TestPlanResultSchema,
@@ -7511,7 +7511,7 @@ async function runTestExpansion(deps, params) {
 	const { prompt } = assembleResult;
 	const handle = deps.dispatcher.dispatch({
 		prompt,
-		agent: "claude-code",
+		agent: deps.agentId ?? "claude-code",
 		taskType: "test-expansion",
 		outputSchema: TestExpansionResultSchema,
 		workingDirectory: deps.projectRoot,
@@ -10540,7 +10540,7 @@ function checkProfileStaleness(projectRoot) {
 * @returns A fully-configured ImplementationOrchestrator ready to call run()
 */
 function createImplementationOrchestrator(deps) {
-	const { db, pack, contextCompiler, dispatcher, eventBus, config, projectRoot, tokenCeilings, stateStore, telemetryPersistence, ingestionServer, repoMapInjector, maxRepoMapTokens } = deps;
+	const { db, pack, contextCompiler, dispatcher, eventBus, config, projectRoot, tokenCeilings, stateStore, telemetryPersistence, ingestionServer, repoMapInjector, maxRepoMapTokens, agentId } = deps;
 	const logger$22 = createLogger("implementation-orchestrator");
 	const telemetryAdvisor = db !== void 0 ? createTelemetryAdvisor({ db }) : void 0;
 	const wgRepo = new WorkGraphRepository(db);
@@ -11096,7 +11096,8 @@ function createImplementationOrchestrator(deps) {
 				dispatcher,
 				projectRoot,
 				tokenCeilings,
-				otlpEndpoint: _otlpEndpoint
+				otlpEndpoint: _otlpEndpoint,
+				agentId
 			}, {
 				epicId: storyKey.split("-")[0] ?? storyKey,
 				storyKey,
@@ -11274,7 +11275,8 @@ function createImplementationOrchestrator(deps) {
 				dispatcher,
 				projectRoot,
 				tokenCeilings,
-				otlpEndpoint: _otlpEndpoint
+				otlpEndpoint: _otlpEndpoint,
+				agentId
 			}, {
 				storyKey,
 				storyFilePath: storyFilePath ?? "",
@@ -11382,6 +11384,7 @@ function createImplementationOrchestrator(deps) {
 							otlpEndpoint: _otlpEndpoint,
 							repoMapInjector,
 							maxRepoMapTokens,
+							agentId,
 							...config.perStoryContextCeilings?.[storyKey] !== void 0 ? { maxContextTokens: config.perStoryContextCeilings[storyKey] } : {},
 							...storyOptions?.optimizationDirectives !== void 0 ? { optimizationDirectives: storyOptions.optimizationDirectives } : {}
 						}, {
@@ -11467,6 +11470,7 @@ function createImplementationOrchestrator(deps) {
 					otlpEndpoint: _otlpEndpoint,
 					repoMapInjector,
 					maxRepoMapTokens,
+					agentId,
 					...config.perStoryContextCeilings?.[storyKey] !== void 0 ? { maxContextTokens: config.perStoryContextCeilings[storyKey] } : {},
 					...storyOptions?.optimizationDirectives !== void 0 ? { optimizationDirectives: storyOptions.optimizationDirectives } : {}
 				}, {
@@ -11631,7 +11635,7 @@ function createImplementationOrchestrator(deps) {
 					startPhase(storyKey, "dev-story-retry");
 					const checkpointRetryHandle = dispatcher.dispatch({
 						prompt: checkpointRetryPrompt,
-						agent: "claude-code",
+						agent: deps.agentId ?? "claude-code",
 						taskType: "dev-story",
 						outputSchema: DevStoryResultSchema,
 						...checkpointRetryMaxTurns !== void 0 ? { maxTurns: checkpointRetryMaxTurns } : {},
@@ -11902,7 +11906,7 @@ function createImplementationOrchestrator(deps) {
 						incrementDispatches(storyKey);
 						const fixHandle = dispatcher.dispatch({
 							prompt: buildFixPrompt,
-							agent: "claude-code",
+							agent: deps.agentId ?? "claude-code",
 							taskType: "build-fix",
 							maxTurns: 15,
 							workingDirectory: projectRoot ?? process.cwd(),
@@ -12029,6 +12033,7 @@ function createImplementationOrchestrator(deps) {
 							otlpEndpoint: _otlpEndpoint,
 							repoMapInjector,
 							maxRepoMapTokens,
+							agentId,
 							...config.perStoryContextCeilings?.[storyKey] !== void 0 ? { maxContextTokens: config.perStoryContextCeilings[storyKey] } : {}
 						}, {
 							storyKey,
@@ -12073,6 +12078,7 @@ function createImplementationOrchestrator(deps) {
 						otlpEndpoint: _otlpEndpoint,
 						repoMapInjector,
 						maxRepoMapTokens,
+						agentId,
 						...config.perStoryContextCeilings?.[storyKey] !== void 0 ? { maxContextTokens: config.perStoryContextCeilings[storyKey] } : {}
 					}, {
 						storyKey,
@@ -12280,7 +12286,8 @@ function createImplementationOrchestrator(deps) {
 						dispatcher,
 						projectRoot,
 						tokenCeilings,
-						otlpEndpoint: _otlpEndpoint
+						otlpEndpoint: _otlpEndpoint,
+						agentId
 					}, {
 						storyKey,
 						storyFilePath: storyFilePath ?? "",
@@ -12392,7 +12399,7 @@ function createImplementationOrchestrator(deps) {
 					}
 					const handle = dispatcher.dispatch({
 						prompt: fixPrompt,
-						agent: "claude-code",
+						agent: deps.agentId ?? "claude-code",
 						taskType: "minor-fixes",
 						workingDirectory: projectRoot,
 						...autoApproveMaxTurns !== void 0 ? { maxTurns: autoApproveMaxTurns } : {},
@@ -12551,7 +12558,7 @@ function createImplementationOrchestrator(deps) {
 				incrementDispatches(storyKey);
 				const handle = isMajorRework ? dispatcher.dispatch({
 					prompt: fixPrompt,
-					agent: "claude-code",
+					agent: deps.agentId ?? "claude-code",
 					taskType,
 					...fixModel !== void 0 ? { model: fixModel } : {},
 					outputSchema: DevStoryResultSchema,
@@ -12561,7 +12568,7 @@ function createImplementationOrchestrator(deps) {
 					..._otlpEndpoint !== void 0 ? { otlpEndpoint: _otlpEndpoint } : {}
 				}) : dispatcher.dispatch({
 					prompt: fixPrompt,
-					agent: "claude-code",
+					agent: deps.agentId ?? "claude-code",
 					taskType,
 					...fixModel !== void 0 ? { model: fixModel } : {},
 					...fixMaxTurns !== void 0 ? { maxTurns: fixMaxTurns } : {},
@@ -13771,7 +13778,7 @@ async function runCritiqueLoop(artifact, phaseId, runId, phase, deps, options =
 		try {
 			const handle = deps.dispatcher.dispatch({
 				prompt: critiquePrompt,
-				agent: "claude-code",
+				agent: deps.agentId ?? "claude-code",
 				taskType: "critique",
 				outputSchema: CritiqueOutputSchema
 			});
@@ -13882,7 +13889,7 @@ async function runCritiqueLoop(artifact, phaseId, runId, phase, deps, options =
 			try {
 				const refineHandle = deps.dispatcher.dispatch({
 					prompt: refinePrompt,
-					agent: "claude-code",
+					agent: deps.agentId ?? "claude-code",
 					taskType: "critique",
 					outputSchema: void 0
 				});
@@ -14560,7 +14567,7 @@ async function runSteps(steps, deps, runId, phase, params) {
 		}
 		const handle = deps.dispatcher.dispatch({
 			prompt,
-			agent: "claude-code",
+			agent: deps.agentId ?? "claude-code",
 			taskType: step.taskType,
 			outputSchema: step.outputSchema
 		});
@@ -14739,7 +14746,7 @@ async function runSteps(steps, deps, runId, phase, params) {
 					const elicitPrompt = elicitationTemplate.replace(/\{\{method_name\}\}/g, method.name).replace(/\{\{method_description\}\}/g, method.description).replace(/\{\{output_pattern\}\}/g, method.output_pattern).replace(/\{\{artifact_content\}\}/g, artifactContent);
 					const elicitHandle = deps.dispatcher.dispatch({
 						prompt: elicitPrompt,
-						agent: "claude-code",
+						agent: deps.agentId ?? "claude-code",
 						taskType: "elicitation",
 						outputSchema: ElicitationOutputSchema
 					});
@@ -15083,7 +15090,7 @@ async function runAnalysisPhase(deps, params) {
 		};
 		const handle = dispatcher.dispatch({
 			prompt,
-			agent: "claude-code",
+			agent: deps.agentId ?? "claude-code",
 			taskType: "analysis",
 			outputSchema: AnalysisOutputSchema
 		});
@@ -15395,7 +15402,7 @@ async function runPlanningMultiStep(deps, params) {
 				correctedPrompt = correctionPrefix + correctedPrompt;
 				const retryHandle = deps.dispatcher.dispatch({
 					prompt: correctedPrompt,
-					agent: "claude-code",
+					agent: deps.agentId ?? "claude-code",
 					taskType: "planning-nfrs",
 					outputSchema: PlanningNFRsOutputSchema
 				});
@@ -15515,7 +15522,7 @@ async function runPlanningPhase(deps, params) {
 		};
 		const handle = dispatcher.dispatch({
 			prompt,
-			agent: "claude-code",
+			agent: deps.agentId ?? "claude-code",
 			taskType: "planning",
 			outputSchema: PlanningOutputSchema
 		});
@@ -15815,7 +15822,7 @@ async function runArchitectureGeneration(deps, params) {
 	};
 	const handle = dispatcher.dispatch({
 		prompt,
-		agent: "claude-code",
+		agent: deps.agentId ?? "claude-code",
 		taskType: "architecture",
 		outputSchema: ArchitectureOutputSchema
 	});
@@ -15917,7 +15924,7 @@ async function runStoryGeneration(deps, params, gapAnalysis) {
 	};
 	const handle = dispatcher.dispatch({
 		prompt,
-		agent: "claude-code",
+		agent: deps.agentId ?? "claude-code",
 		taskType: "story-generation",
 		outputSchema: StoryGenerationOutputSchema
 	});
@@ -16095,7 +16102,7 @@ async function runReadinessCheck(deps, runId) {
 	else prompt = prompt.replace(READINESS_UX_PLACEHOLDER, "");
 	const handle = dispatcher.dispatch({
 		prompt,
-		agent: "claude-code",
+		agent: deps.agentId ?? "claude-code",
 		taskType: "readiness-check",
 		outputSchema: ReadinessOutputSchema
 	});
@@ -40374,7 +40381,7 @@ function wireNdjsonEmitter(eventBus, ndjsonEmitter) {
 	});
 }
 async function runRunAction(options) {
-	const { pack: packName, from: startPhase, stopAfter, concept: conceptArg, conceptFile, stories: storiesArg, concurrency, outputFormat, projectRoot, events: eventsFlag, verbose: verboseFlag, tui: tuiFlag, skipUx, research: researchFlag, skipResearch: skipResearchFlag, skipPreflight, epic: epicNumber, dryRun, maxReviewCycles = 2, engine, registry: injectedRegistry } = options;
+	const { pack: packName, from: startPhase, stopAfter, concept: conceptArg, conceptFile, stories: storiesArg, concurrency, outputFormat, projectRoot, events: eventsFlag, verbose: verboseFlag, tui: tuiFlag, skipUx, research: researchFlag, skipResearch: skipResearchFlag, skipPreflight, epic: epicNumber, dryRun, maxReviewCycles = 2, engine, agent: agentId, registry: injectedRegistry } = options;
 	const resolvedEngine = engine ?? "linear";
 	if (!VALID_ENGINES.includes(resolvedEngine)) {
 		const errorMsg = `Invalid engine '${engine}'. Valid values: ${VALID_ENGINES.join(", ")}`;
@@ -40538,7 +40545,8 @@ async function runRunAction(options) {
 			telemetryEnabled: true,
 			telemetryPort
 		} : {},
-		maxReviewCycles
+		maxReviewCycles,
+		agentId
 	});
 	let storyKeys = [...parsedStoryKeys];
 	if (!existsSync$1(dbDir)) mkdirSync$1(dbDir, { recursive: true });
@@ -40756,7 +40764,7 @@ async function runRunAction(options) {
 					const costUsd = (input * 3 + output * 15) / 1e6;
 					addTokenUsage(adapter, pipelineRun.id, {
 						phase: payload.phase,
-						agent: "claude-code",
+						agent: agentId ?? "claude-code",
 						input_tokens: input,
 						output_tokens: output,
 						cost_usd: costUsd,
@@ -40970,7 +40978,8 @@ async function runRunAction(options) {
 				pack,
 				contextCompiler,
 				dispatcher,
-				projectRoot
+				projectRoot,
+				agentId
 			};
 			const sdlcEventBus = eventBus;
 			const handlerRegistry = buildSdlcHandlerRegistry({
@@ -40980,7 +40989,8 @@ async function runRunAction(options) {
 						db: adapter,
 						pack,
 						contextCompiler,
-						dispatcher
+						dispatcher,
+						agentId
 					},
 					phases: {
 						analysis: runAnalysisPhase,
@@ -41048,6 +41058,7 @@ async function runRunAction(options) {
 				},
 				projectRoot,
 				tokenCeilings,
+				agentId,
 				...ingestionServer !== void 0 ? { ingestionServer } : {},
 				...telemetryPersistence !== void 0 ? { telemetryPersistence } : {},
 				...repoMapInjector !== void 0 ? {
@@ -41161,7 +41172,7 @@ async function runRunAction(options) {
 	}
 }
 async function runFullPipeline(options) {
-	const { packName, packPath, dbDir, dbPath, startPhase, stopAfter, concept, concurrency, outputFormat, projectRoot, events: eventsFlag, skipUx, research: researchFlag, skipResearch: skipResearchFlag, skipPreflight, maxReviewCycles = 2, registry: injectedRegistry, tokenCeilings, stories: explicitStories, telemetryEnabled: fullTelemetryEnabled, telemetryPort: fullTelemetryPort } = options;
+	const { packName, packPath, dbDir, dbPath, startPhase, stopAfter, concept, concurrency, outputFormat, projectRoot, events: eventsFlag, skipUx, research: researchFlag, skipResearch: skipResearchFlag, skipPreflight, maxReviewCycles = 2, registry: injectedRegistry, tokenCeilings, stories: explicitStories, telemetryEnabled: fullTelemetryEnabled, telemetryPort: fullTelemetryPort, agentId } = options;
 	if (!existsSync$1(dbDir)) mkdirSync$1(dbDir, { recursive: true });
 	const adapter = createDatabaseAdapter({
 		backend: "auto",
@@ -41202,7 +41213,8 @@ async function runFullPipeline(options) {
 			db: adapter,
 			pack,
 			contextCompiler,
-			dispatcher
+			dispatcher,
+			agentId
 		};
 		let effectiveResearch = pack.manifest.research === true;
 		if (researchFlag === true) effectiveResearch = true;
@@ -41294,7 +41306,7 @@ async function runFullPipeline(options) {
 					const costUsd = (result.tokenUsage.input * 3 + result.tokenUsage.output * 15) / 1e6;
 					await addTokenUsage(adapter, runId, {
 						phase: "analysis",
-						agent: "claude-code",
+						agent: agentId ?? "claude-code",
 						input_tokens: result.tokenUsage.input,
 						output_tokens: result.tokenUsage.output,
 						cost_usd: costUsd
@@ -41319,7 +41331,7 @@ async function runFullPipeline(options) {
 					const costUsd = (result.tokenUsage.input * 3 + result.tokenUsage.output * 15) / 1e6;
 					await addTokenUsage(adapter, runId, {
 						phase: "planning",
-						agent: "claude-code",
+						agent: agentId ?? "claude-code",
 						input_tokens: result.tokenUsage.input,
 						output_tokens: result.tokenUsage.output,
 						cost_usd: costUsd
@@ -41347,7 +41359,7 @@ async function runFullPipeline(options) {
 					const costUsd = (result.tokenUsage.input * 3 + result.tokenUsage.output * 15) / 1e6;
 					await addTokenUsage(adapter, runId, {
 						phase: "research",
-						agent: "claude-code",
+						agent: agentId ?? "claude-code",
 						input_tokens: result.tokenUsage.input,
 						output_tokens: result.tokenUsage.output,
 						cost_usd: costUsd
@@ -41372,7 +41384,7 @@ async function runFullPipeline(options) {
 					const costUsd = (result.tokenUsage.input * 3 + result.tokenUsage.output * 15) / 1e6;
 					await addTokenUsage(adapter, runId, {
 						phase: "ux-design",
-						agent: "claude-code",
+						agent: agentId ?? "claude-code",
 						input_tokens: result.tokenUsage.input,
 						output_tokens: result.tokenUsage.output,
 						cost_usd: costUsd
@@ -41397,7 +41409,7 @@ async function runFullPipeline(options) {
 					const costUsd = (result.tokenUsage.input * 3 + result.tokenUsage.output * 15) / 1e6;
 					await addTokenUsage(adapter, runId, {
 						phase: "solutioning",
-						agent: "claude-code",
+						agent: agentId ?? "claude-code",
 						input_tokens: result.tokenUsage.input,
 						output_tokens: result.tokenUsage.output,
 						cost_usd: costUsd
@@ -41456,6 +41468,7 @@ async function runFullPipeline(options) {
 					},
 					projectRoot,
 					tokenCeilings,
+					agentId,
 					...fpIngestionServer !== void 0 ? { ingestionServer: fpIngestionServer } : {},
 					...fpTelemetryPersistence !== void 0 ? { telemetryPersistence: fpTelemetryPersistence } : {}
 				});
@@ -41467,7 +41480,7 @@ async function runFullPipeline(options) {
 							const costUsd = (input * 3 + output * 15) / 1e6;
 							addTokenUsage(adapter, runId, {
 								phase: payload.phase,
-								agent: "claude-code",
+								agent: agentId ?? "claude-code",
 								input_tokens: input,
 								output_tokens: output,
 								cost_usd: costUsd
@@ -41588,7 +41601,7 @@ async function runFullPipeline(options) {
 	}
 }
 function registerRunCommand(program, _version = "0.0.0", projectRoot = process.cwd(), registry) {
-	program.command("run").description("Run the autonomous pipeline (use --from to start from a specific phase)").option("--pack <name>", "Methodology pack name", "bmad").option("--from <phase>", "Start from this phase: analysis, planning, solutioning, implementation").option("--stop-after <phase>", "Stop pipeline after this phase completes").option("--concept <text>", "Inline concept text (required when --from analysis)").option("--concept-file <path>", "Path to a file containing the concept text").option("--stories <keys>", "Comma-separated story keys (e.g., 10-1,10-2)").option("--epic <n>", "Scope story discovery to a single epic number (e.g., 27)", (v) => parseInt(v, 10)).option("--concurrency <n>", "Maximum parallel conflict groups", (v) => parseInt(v, 10), 3).option("--project-root <path>", "Project root directory", projectRoot).option("--output-format <format>", "Output format: human (default) or json", "human").option("--events", "Emit structured NDJSON events on stdout for programmatic consumption").option("--verbose", "Show detailed pino log output").option("--help-agent", "Print a machine-optimized prompt fragment for AI agents and exit").option("--tui", "Show TUI dashboard").option("--skip-ux", "Skip the UX design phase even if enabled in the pack manifest").option("--research", "Enable the research phase even if not set in the pack manifest").option("--skip-research", "Skip the research phase even if enabled in the pack manifest").option("--skip-preflight", "Skip the pre-flight build check (escape hatch for known-broken projects)").option("--max-review-cycles <n>", "Maximum review cycles per story (default: 2)", (v) => parseInt(v, 10), 2).option("--dry-run", "Preview routing and repo-map injection without dispatching (Story 28-9)").option("--engine <type>", "Execution engine: linear (default) or graph").action(async (opts) => {
+	program.command("run").description("Run the autonomous pipeline (use --from to start from a specific phase)").option("--pack <name>", "Methodology pack name", "bmad").option("--from <phase>", "Start from this phase: analysis, planning, solutioning, implementation").option("--stop-after <phase>", "Stop pipeline after this phase completes").option("--concept <text>", "Inline concept text (required when --from analysis)").option("--concept-file <path>", "Path to a file containing the concept text").option("--stories <keys>", "Comma-separated story keys (e.g., 10-1,10-2)").option("--epic <n>", "Scope story discovery to a single epic number (e.g., 27)", (v) => parseInt(v, 10)).option("--concurrency <n>", "Maximum parallel conflict groups", (v) => parseInt(v, 10), 3).option("--project-root <path>", "Project root directory", projectRoot).option("--output-format <format>", "Output format: human (default) or json", "human").option("--events", "Emit structured NDJSON events on stdout for programmatic consumption").option("--verbose", "Show detailed pino log output").option("--help-agent", "Print a machine-optimized prompt fragment for AI agents and exit").option("--tui", "Show TUI dashboard").option("--skip-ux", "Skip the UX design phase even if enabled in the pack manifest").option("--research", "Enable the research phase even if not set in the pack manifest").option("--skip-research", "Skip the research phase even if enabled in the pack manifest").option("--skip-preflight", "Skip the pre-flight build check (escape hatch for known-broken projects)").option("--max-review-cycles <n>", "Maximum review cycles per story (default: 2)", (v) => parseInt(v, 10), 2).option("--dry-run", "Preview routing and repo-map injection without dispatching (Story 28-9)").option("--engine <type>", "Execution engine: linear (default) or graph").option("--agent <id>", "Agent backend: claude-code (default), codex, or gemini").action(async (opts) => {
 		if (opts.helpAgent) {
 			process.exitCode = await runHelpAgent();
 			return;
@@ -41626,6 +41639,7 @@ function registerRunCommand(program, _version = "0.0.0", projectRoot = process.c
 			maxReviewCycles: opts.maxReviewCycles,
 			dryRun: opts.dryRun,
 			engine: opts.engine,
+			agent: opts.agent,
 			registry
 		});
 		process.exitCode = exitCode;
@@ -41634,4 +41648,4 @@ function registerRunCommand(program, _version = "0.0.0", projectRoot = process.c
 
 //#endregion
 export { AdapterTelemetryPersistence, AppError, DoltRepoMapMetaRepository, DoltSymbolRepository, ERR_REPO_MAP_STORAGE_WRITE, EpicIngester, GitClient, GrammarLoader, RepoMapInjector, RepoMapModule, RepoMapQueryEngine, RepoMapStorage, SymbolParser, createContextCompiler, createDispatcher, createEventEmitter, createImplementationOrchestrator, createPackLoader, createPhaseOrchestrator, createStopAfterGate, createTelemetryAdvisor, formatPhaseCompletionSummary, getFactoryRunSummaries, getScenarioResultsForRun, getTwinRunsForRun, listGraphRuns, normalizeGraphSummaryToStatus, registerExportCommand, registerFactoryCommand, registerRunCommand, registerScenariosCommand, resolveStoryKeys, runAnalysisPhase, runPlanningPhase, runRunAction, runSolutioningPhase, validateStopAfterFromConflict };
-//# sourceMappingURL=run-NJQHRIYt.js.map
+//# sourceMappingURL=run-1Ywys7Fy.js.map

package/dist/{run-CAMKyu0F.js → run-zc3SEWY1.js}

@@ -2,7 +2,7 @@ import "./health-DJgGZhW-.js";
 import "./logger-KeHncl-f.js";
 import "./helpers-CElYrONe.js";
 import "./dist-adzGUKPc.js";
-import { normalizeGraphSummaryToStatus, registerRunCommand, runRunAction } from "./run-NJQHRIYt.js";
+import { normalizeGraphSummaryToStatus, registerRunCommand, runRunAction } from "./run-1Ywys7Fy.js";
 import "./routing-CcBOCuC9.js";
 import "./decisions-C0pz9Clx.js";
 

package/package.json

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