substrate-ai 0.5.5 → 0.5.7

package/dist/{adapter-registry-CDNPbixE.js → adapter-registry-D2zdMwVu.js}

@@ -93,7 +93,11 @@ var ClaudeCodeAdapter = class {
 			envEntries.OTEL_LOG_TOOL_DETAILS = "1";
 			envEntries.OTEL_METRIC_EXPORT_INTERVAL = "10000";
 			envEntries.OTEL_EXPORTER_OTLP_TIMEOUT = "5000";
-			if (options.storyKey !== void 0) envEntries.OTEL_RESOURCE_ATTRIBUTES = `substrate.story_key=${options.storyKey}`;
+			const resourceAttrs = [];
+			if (options.storyKey !== void 0) resourceAttrs.push(`substrate.story_key=${options.storyKey}`);
+			if (options.taskType !== void 0) resourceAttrs.push(`substrate.task_type=${options.taskType}`);
+			if (options.dispatchId !== void 0) resourceAttrs.push(`substrate.dispatch_id=${options.dispatchId}`);
+			if (resourceAttrs.length > 0) envEntries.OTEL_RESOURCE_ATTRIBUTES = resourceAttrs.join(",");
 		}
 		return {
 			binary: "claude",
@@ -833,4 +837,4 @@ var AdapterRegistry = class {
 
 //#endregion
 export { AdapterRegistry, ClaudeCodeAdapter, CodexCLIAdapter, GeminiCLIAdapter };
-//# sourceMappingURL=adapter-registry-CDNPbixE.js.map
+//# sourceMappingURL=adapter-registry-D2zdMwVu.js.map

package/dist/adapter-registry-WAyFydN5.js

@@ -0,0 +1,4 @@
+import "./logger-D2fS2ccL.js";
+import { AdapterRegistry } from "./adapter-registry-D2zdMwVu.js";
+
+export { AdapterRegistry };

package/dist/cli/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
-import { AdapterTelemetryPersistence, AppError, DEFAULT_CONFIG, DEFAULT_ROUTING_POLICY, DoltClient, DoltNotInstalled, DoltRepoMapMetaRepository, DoltSymbolRepository, ERR_REPO_MAP_STORAGE_WRITE, FileStateStore, GitClient, GrammarLoader, IngestionServer, RepoMapInjector, RepoMapModule, RepoMapQueryEngine, RepoMapStorage, SUBSTRATE_OWNED_SETTINGS_KEYS, SymbolParser, VALID_PHASES, WorkGraphRepository, buildPipelineStatusOutput, checkDoltInstalled, createConfigSystem, createContextCompiler, createDatabaseAdapter, createDispatcher, createDoltClient, createEventEmitter, createImplementationOrchestrator, createPackLoader, createPhaseOrchestrator, createStateStore, createStopAfterGate, createTelemetryAdvisor, detectCycles, findPackageRoot, formatOutput, formatPhaseCompletionSummary, formatPipelineStatusHuman, formatPipelineSummary, formatTokenTelemetry, getAllDescendantPids, getAutoHealthData, getSubstrateDefaultSettings, initSchema, initializeDolt, isSyncAdapter, parseDbTimestampAsUtc, registerHealthCommand, registerRunCommand, resolveBmadMethodSrcPath, resolveBmadMethodVersion, resolveMainRepoRoot, resolveStoryKeys, runAnalysisPhase, runPlanningPhase, runSolutioningPhase, validateStopAfterFromConflict } from "../run-D9Jk9BnR.js";
+import { AdapterTelemetryPersistence, AppError, DEFAULT_CONFIG, DEFAULT_ROUTING_POLICY, DoltClient, DoltNotInstalled, DoltRepoMapMetaRepository, DoltSymbolRepository, ERR_REPO_MAP_STORAGE_WRITE, FileStateStore, GitClient, GrammarLoader, IngestionServer, RepoMapInjector, RepoMapModule, RepoMapQueryEngine, RepoMapStorage, SUBSTRATE_OWNED_SETTINGS_KEYS, SymbolParser, VALID_PHASES, WorkGraphRepository, buildPipelineStatusOutput, checkDoltInstalled, createConfigSystem, createContextCompiler, createDatabaseAdapter, createDispatcher, createDoltClient, createEventEmitter, createImplementationOrchestrator, createPackLoader, createPhaseOrchestrator, createStateStore, createStopAfterGate, createTelemetryAdvisor, detectCycles, findPackageRoot, formatOutput, formatPhaseCompletionSummary, formatPipelineStatusHuman, formatPipelineSummary, formatTokenTelemetry, getAllDescendantPids, getAutoHealthData, getSubstrateDefaultSettings, initSchema, initializeDolt, isSyncAdapter, parseDbTimestampAsUtc, registerHealthCommand, registerRunCommand, resolveBmadMethodSrcPath, resolveBmadMethodVersion, resolveMainRepoRoot, resolveStoryKeys, runAnalysisPhase, runPlanningPhase, runSolutioningPhase, validateStopAfterFromConflict } from "../run-DwoihdAI.js";
 import { createLogger } from "../logger-D2fS2ccL.js";
-import { AdapterRegistry } from "../adapter-registry-CDNPbixE.js";
+import { AdapterRegistry } from "../adapter-registry-D2zdMwVu.js";
 import { CURRENT_CONFIG_FORMAT_VERSION, CURRENT_TASK_GRAPH_VERSION, PartialSubstrateConfigSchema } from "../config-migrator-DtZW1maj.js";
 import { ConfigError, createEventBus } from "../helpers-BihqWgVe.js";
 import { RoutingRecommender } from "../routing-BUE9pIxW.js";
@@ -2525,7 +2525,7 @@ function defaultSupervisorDeps() {
 				if (cached === null) {
 					const { AdapterRegistry: AR } = await import(
 						/* @vite-ignore */
-						"../adapter-registry-B0XmM7pb.js"
+						"../adapter-registry-WAyFydN5.js"
 );
 					cached = new AR();
 					await cached.discoverAndRegister();
@@ -2969,7 +2969,7 @@ async function runSupervisorAction(options, deps = {}) {
 								await initSchema(expAdapter);
 								const { runRunAction: runPipeline } = await import(
 									/* @vite-ignore */
-									"../run-iTDh1vqV.js"
+									"../run-H1Xn6_C4.js"
 );
 								const runStoryFn = async (opts) => {
 									const exitCode = await runPipeline({

package/dist/cli/templates/claude-md-substrate-section.md

@@ -18,6 +18,8 @@ substrate run --events --stories 1-1,1-2,1-3
 
 If substrate needs input it can't auto-detect (e.g., a project concept for analysis), it will exit with a clear error message telling you what to provide.
 
+**Scope warning:** Without `--stories`, substrate auto-discovers ALL pending stories across ALL epics and may dispatch 30+ stories at once. For controlled runs, always specify story keys explicitly with `--stories`.
+
 **CRITICAL execution rules:**
 - Pipeline runs take **5–40 minutes**. You MUST use `run_in_background: true` or `timeout: 600000` (10 min) when invoking via Bash tool. Default 2-minute timeout WILL kill the pipeline.
 - **NEVER pipe substrate output** to `head`, `tail`, `grep`, or any command that may close the pipe early — this causes EPIPE stalls that hang the process.
@@ -41,6 +43,8 @@ For long-running pipelines, attach the **supervisor** for automatic stall detect
 substrate supervisor --output-format json
 ```
 
+**CRITICAL: Only attach a supervisor to runs you started in the same session.** Attaching a supervisor to another session's run risks killing healthy dispatches and restarting with incorrect scope. The supervisor inherits story keys from the health snapshot on restart, but cross-session interference can cause unexpected behavior.
+
 **Interpreting silence:** No output for 5 minutes = normal (agent is working). No output for 15+ minutes = likely stalled. Use `substrate health` to confirm, then consider killing and resuming.
 
 ### After Pipeline Completes

package/dist/index.d.ts

@@ -1527,6 +1527,10 @@ interface AdapterOptions {
    * Generated by TelemetryAdvisor.formatOptimizationDirectives().
    */
   optimizationDirectives?: string;
+  /** Dispatch context: task type (create-story, dev-story, code-review, etc.) for OTLP attribution */
+  taskType?: string;
+  /** Dispatch context: unique dispatch ID for per-dispatch telemetry correlation */
+  dispatchId?: string;
 }
 /**
  * Capabilities reported by an adapter for this CLI agent.

package/dist/index.js

@@ -1,5 +1,5 @@
 import { childLogger, createLogger, logger } from "./logger-D2fS2ccL.js";
-import { AdapterRegistry, ClaudeCodeAdapter, CodexCLIAdapter, GeminiCLIAdapter } from "./adapter-registry-CDNPbixE.js";
+import { AdapterRegistry, ClaudeCodeAdapter, CodexCLIAdapter, GeminiCLIAdapter } from "./adapter-registry-D2zdMwVu.js";
 import { AdtError, BudgetExceededError, ConfigError, ConfigIncompatibleFormatError, GitError, RecoveryError, TaskConfigError, TaskGraphCycleError, TaskGraphError, TaskGraphIncompatibleFormatError, WorkerError, WorkerNotFoundError, assertDefined, createEventBus, createTuiApp, deepClone, formatDuration, generateId, isPlainObject, isTuiCapable, printNonTtyWarning, sleep, withRetry } from "./helpers-BihqWgVe.js";
 
 //#region src/core/di.ts

package/dist/{run-D9Jk9BnR.js → run-DwoihdAI.js}

@@ -6776,7 +6776,9 @@ var DispatcherImpl = class {
 			...maxContextTokens !== void 0 ? { maxContextTokens } : {},
 			...otlpEndpoint !== void 0 ? { otlpEndpoint } : {},
 			...storyKey !== void 0 ? { storyKey } : {},
-			...optimizationDirectives !== void 0 ? { optimizationDirectives } : {}
+			...optimizationDirectives !== void 0 ? { optimizationDirectives } : {},
+			taskType,
+			dispatchId: id
 		});
 		const timeoutMs = timeout ?? this._config.defaultTimeouts[taskType] ?? DEFAULT_TIMEOUTS[taskType] ?? 3e5;
 		const env = { ...process.env };
@@ -13182,16 +13184,23 @@ var EfficiencyScorer = class {
 		return this._clamp(avg * 100, 0, 100);
 	}
 	/**
-	* I/O ratio sub-score: lower ratio = better = higher score.
-	* Formula: clamp(100 - (avgIoRatio - 1) × 20, 0, 100)
+	* I/O ratio sub-score: measures output productivity.
 	*
-	* At avgIoRatio=1: score=80 (equal input/output tokens)
-	* At avgIoRatio=5: score=20
-	* At avgIoRatio≥6: clamped to 0
+	* For code generation workloads, high context-to-output ratio is normal and
+	* desirable (agent reads large cached context, produces substantial code).
+	* The old formula penalized this. New formula uses output-to-fresh-input ratio:
+	*   - outputTokens / max(freshInputTokens, 1) per turn
+	*   - Ratio > 1 means productive (more output than fresh input) → score 100
+	*   - Ratio < 1 → scaled linearly: ratio * 100
+	*   - Averaged across turns
 	*/
 	_computeIoRatioSubScore(turns) {
-		const avg = this._computeAvgIoRatio(turns);
-		return this._clamp(100 - (avg - 1) * 20, 0, 100);
+		if (turns.length === 0) return 0;
+		const avg = turns.reduce((acc, t) => {
+			const freshInput = Math.max(t.inputTokens, 1);
+			return acc + t.outputTokens / freshInput;
+		}, 0) / turns.length;
+		return this._clamp(avg >= 1 ? 100 : avg * 100, 0, 100);
 	}
 	/**
 	* Context management sub-score: penalizes context spike frequency.
@@ -13287,10 +13296,10 @@ var EfficiencyScorer = class {
 	_computeIoRatioSubScoreForGroup(turns) {
 		if (turns.length === 0) return 0;
 		const avg = turns.reduce((acc, t) => {
-			const totalInput = t.inputTokens + (t.cacheReadTokens ?? 0);
-			return acc + totalInput / Math.max(t.outputTokens, 1);
+			const freshInput = Math.max(t.inputTokens, 1);
+			return acc + t.outputTokens / freshInput;
 		}, 0) / turns.length;
-		return this._clamp(100 - (avg - 1) * 20, 0, 100);
+		return this._clamp(avg >= 1 ? 100 : avg * 100, 0, 100);
 	}
 	_computeContextManagementSubScoreForGroup(turns) {
 		if (turns.length === 0) return 0;
@@ -15166,7 +15175,15 @@ var TelemetryAdvisor = class {
 	*/
 	formatOptimizationDirectives(recommendations) {
 		const MAX_CHARS$1 = 2e3;
-		const actionable = recommendations.filter((r) => r.severity === "critical" || r.severity === "warning");
+		const AGENT_ACTIONABLE_RULES = new Set([
+			"large_file_reads",
+			"expensive_bash",
+			"repeated_tool_calls",
+			"context_growth_spike",
+			"growing_categories",
+			"cache_delta_regression"
+		]);
+		const actionable = recommendations.filter((r) => (r.severity === "critical" || r.severity === "warning") && AGENT_ACTIONABLE_RULES.has(r.ruleId));
 		if (actionable.length === 0) return "";
 		const lines = actionable.map((r) => `OPTIMIZATION (${r.severity}): ${r.title}. ${r.description}`);
 		const full = lines.join("\n");
@@ -22625,4 +22642,4 @@ function registerRunCommand(program, _version = "0.0.0", projectRoot = process.c
 
 //#endregion
 export { AdapterTelemetryPersistence, AppError, DEFAULT_CONFIG, DEFAULT_ROUTING_POLICY, DoltClient, DoltNotInstalled, DoltRepoMapMetaRepository, DoltSymbolRepository, ERR_REPO_MAP_STORAGE_WRITE, FileStateStore, GitClient, GrammarLoader, IngestionServer, RepoMapInjector, RepoMapModule, RepoMapQueryEngine, RepoMapStorage, SUBSTRATE_OWNED_SETTINGS_KEYS, SymbolParser, VALID_PHASES, WorkGraphRepository, buildPipelineStatusOutput, checkDoltInstalled, createConfigSystem, createContextCompiler, createDatabaseAdapter, createDispatcher, createDoltClient, createEventEmitter, createImplementationOrchestrator, createPackLoader, createPhaseOrchestrator, createStateStore, createStopAfterGate, createTelemetryAdvisor, detectCycles, findPackageRoot, formatOutput, formatPhaseCompletionSummary, formatPipelineStatusHuman, formatPipelineSummary, formatTokenTelemetry, getAllDescendantPids, getAutoHealthData, getSubstrateDefaultSettings, initSchema, initializeDolt, isSyncAdapter, parseDbTimestampAsUtc, registerHealthCommand, registerRunCommand, resolveBmadMethodSrcPath, resolveBmadMethodVersion, resolveMainRepoRoot, resolveStoryKeys, runAnalysisPhase, runPlanningPhase, runRunAction, runSolutioningPhase, validateStopAfterFromConflict };
-//# sourceMappingURL=run-D9Jk9BnR.js.map
+//# sourceMappingURL=run-DwoihdAI.js.map

package/dist/{run-iTDh1vqV.js → run-H1Xn6_C4.js}

@@ -1,4 +1,4 @@
-import { registerRunCommand, runRunAction } from "./run-D9Jk9BnR.js";
+import { registerRunCommand, runRunAction } from "./run-DwoihdAI.js";
 import "./logger-D2fS2ccL.js";
 import "./config-migrator-DtZW1maj.js";
 import "./helpers-BihqWgVe.js";

package/package.json

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

package/dist/adapter-registry-B0XmM7pb.js

@@ -1,4 +0,0 @@
-import "./logger-D2fS2ccL.js";
-import { AdapterRegistry } from "./adapter-registry-CDNPbixE.js";
-
-export { AdapterRegistry };