substrate-ai 0.3.3 → 0.3.6

package/dist/adapter-registry-BBn0Rmqj.js

@@ -0,0 +1,3 @@
+import { AdapterRegistry } from "./adapter-registry-a2WX0qo_.js";
+
+export { AdapterRegistry };

package/dist/{adapter-registry-DHl0W-YB.js → adapter-registry-a2WX0qo_.js}

@@ -82,6 +82,9 @@ var ClaudeCodeAdapter = class {
 			envEntries.OTEL_METRICS_EXPORTER = "otlp";
 			envEntries.OTEL_EXPORTER_OTLP_PROTOCOL = "http/json";
 			envEntries.OTEL_EXPORTER_OTLP_ENDPOINT = options.otlpEndpoint;
+			envEntries.OTEL_LOG_TOOL_DETAILS = "1";
+			envEntries.OTEL_METRIC_EXPORT_INTERVAL = "10000";
+			if (options.storyKey !== void 0) envEntries.OTEL_RESOURCE_ATTRIBUTES = `substrate.story_key=${options.storyKey}`;
 		}
 		return {
 			binary: "claude",
@@ -822,4 +825,4 @@ var AdapterRegistry = class {
 
 //#endregion
 export { AdapterRegistry, ClaudeCodeAdapter, CodexCLIAdapter, GeminiCLIAdapter };
-//# sourceMappingURL=adapter-registry-DHl0W-YB.js.map
+//# sourceMappingURL=adapter-registry-a2WX0qo_.js.map

package/dist/cli/index.js

@@ -1,14 +1,14 @@
 #!/usr/bin/env node
-import { DEFAULT_CONFIG, DEFAULT_ROUTING_POLICY, DatabaseWrapper, DoltNotInstalled, FileStateStore, SUBSTRATE_OWNED_SETTINGS_KEYS, TelemetryPersistence, VALID_PHASES, buildPipelineStatusOutput, checkDoltInstalled, createConfigSystem, createContextCompiler, createDispatcher, createDoltClient, createImplementationOrchestrator, createPackLoader, createPhaseOrchestrator, createStateStore, createStopAfterGate, findPackageRoot, formatOutput, formatPhaseCompletionSummary, formatPipelineStatusHuman, formatPipelineSummary, formatTokenTelemetry, getAllDescendantPids, getAutoHealthData, getSubstrateDefaultSettings, initializeDolt, parseDbTimestampAsUtc, registerHealthCommand, registerRunCommand, resolveBmadMethodSrcPath, resolveBmadMethodVersion, resolveMainRepoRoot, resolveStoryKeys, runAnalysisPhase, runMigrations, runPlanningPhase, runSolutioningPhase, validateStopAfterFromConflict } from "../run-DI9s014E.js";
+import { DEFAULT_CONFIG, DEFAULT_ROUTING_POLICY, DatabaseWrapper, DoltNotInstalled, FileStateStore, SUBSTRATE_OWNED_SETTINGS_KEYS, TelemetryPersistence, VALID_PHASES, buildPipelineStatusOutput, checkDoltInstalled, createConfigSystem, createContextCompiler, createDispatcher, createDoltClient, createImplementationOrchestrator, createPackLoader, createPhaseOrchestrator, createStateStore, createStopAfterGate, findPackageRoot, formatOutput, formatPhaseCompletionSummary, formatPipelineStatusHuman, formatPipelineSummary, formatTokenTelemetry, getAllDescendantPids, getAutoHealthData, getSubstrateDefaultSettings, initializeDolt, parseDbTimestampAsUtc, registerHealthCommand, registerRunCommand, resolveBmadMethodSrcPath, resolveBmadMethodVersion, resolveMainRepoRoot, resolveStoryKeys, runAnalysisPhase, runMigrations, runPlanningPhase, runSolutioningPhase, validateStopAfterFromConflict } from "../run-DzzmgEOd.js";
 import { createLogger } from "../logger-D2fS2ccL.js";
-import { AdapterRegistry } from "../adapter-registry-DHl0W-YB.js";
-import { CURRENT_CONFIG_FORMAT_VERSION, CURRENT_TASK_GRAPH_VERSION, PartialSubstrateConfigSchema } from "../config-migrator-CQmBdKeG.js";
-import { ConfigError, createEventBus } from "../helpers-RL22dYtn.js";
-import { addTokenUsage, createDecision, createPipelineRun, getDecisionsByCategory, getDecisionsByPhaseForRun, getLatestRun, getTokenUsageSummary, listRequirements, updatePipelineRun } from "../decisions-Dq4cAA2L.js";
-import { ESCALATION_DIAGNOSIS, EXPERIMENT_RESULT, OPERATIONAL_FINDING, STORY_METRICS, aggregateTokenUsageForRun, compareRunMetrics, getBaselineRunMetrics, getRunMetrics, getStoryMetricsForRun, incrementRunRestarts, listRunMetrics, tagRunAsBaseline } from "../operational-Bovj4fS-.js";
-import { abortMerge, createWorktree, getConflictingFiles, getMergedFiles, getOrphanedWorktrees, performMerge, removeBranch, removeWorktree, simulateMerge, verifyGitVersion } from "../git-utils-CtmrZrHS.js";
-import "../version-manager-impl-33JYXsqa.js";
-import { registerUpgradeCommand } from "../upgrade-DO307rFf.js";
+import { AdapterRegistry } from "../adapter-registry-a2WX0qo_.js";
+import { CURRENT_CONFIG_FORMAT_VERSION, CURRENT_TASK_GRAPH_VERSION, PartialSubstrateConfigSchema } from "../config-migrator-DtZW1maj.js";
+import { ConfigError, createEventBus } from "../helpers-BihqWgVe.js";
+import { addTokenUsage, createDecision, createPipelineRun, getDecisionsByCategory, getDecisionsByPhaseForRun, getLatestRun, getTokenUsageSummary, listRequirements, updatePipelineRun } from "../decisions-CdpiJIm5.js";
+import { ESCALATION_DIAGNOSIS, EXPERIMENT_RESULT, OPERATIONAL_FINDING, STORY_METRICS, aggregateTokenUsageForRun, compareRunMetrics, getBaselineRunMetrics, getRunMetrics, getStoryMetricsForRun, incrementRunRestarts, listRunMetrics, tagRunAsBaseline } from "../operational-DisxqtjC.js";
+import { abortMerge, createWorktree, getConflictingFiles, getMergedFiles, getOrphanedWorktrees, performMerge, removeBranch, removeWorktree, simulateMerge, verifyGitVersion } from "../git-utils-UbKLSGsD.js";
+import "../version-manager-impl-zsJjBhak.js";
+import { registerUpgradeCommand } from "../upgrade-DTzeenA-.js";
 import { Command } from "commander";
 import { fileURLToPath } from "url";
 import { dirname, join, resolve } from "path";
@@ -2278,6 +2278,20 @@ function defaultSupervisorDeps() {
 			}
 		},
 		getAllDescendants: (rootPids) => getAllDescendantPids(rootPids),
+		getRegistry: (() => {
+			let cached = null;
+			return async () => {
+				if (cached === null) {
+					const { AdapterRegistry: AR } = await import(
+						/* @vite-ignore */
+						"../adapter-registry-BBn0Rmqj.js"
+);
+					cached = new AR();
+					await cached.discoverAndRegister();
+				}
+				return cached;
+			};
+		})(),
 		writeStallFindings: async (opts) => {
 			try {
 				const dbRoot = await resolveMainRepoRoot(opts.projectRoot);
@@ -2422,7 +2436,7 @@ function buildTerminalSummary(storyDetails) {
 */
 async function handleStallRecovery(health, state, config, deps, io) {
 	const { stallThreshold, maxRestarts, pack, outputFormat } = config;
-	const { killPid, resumePipeline, sleep, incrementRestarts, getAllDescendants, writeStallFindings } = deps;
+	const { killPid, resumePipeline, sleep, incrementRestarts, getAllDescendants, writeStallFindings, getRegistry } = deps;
 	const { emitEvent, log } = io;
 	const { projectRoot } = state;
 	if (health.staleness_seconds < stallThreshold) return null;
@@ -2491,12 +2505,14 @@ async function handleStallRecovery(health, state, config, deps, io) {
 	});
 	log(`Supervisor: Restarting pipeline (attempt ${newRestartCount}/${maxRestarts})`);
 	try {
+		const registry = await getRegistry();
 		await resumePipeline({
 			runId: health.run_id ?? void 0,
 			outputFormat,
 			projectRoot,
 			concurrency: 3,
-			pack
+			pack,
+			registry
 		});
 		if (writeStallFindings) await writeStallFindings({
 			runId: health.run_id,
@@ -2651,11 +2667,11 @@ async function runSupervisorAction(options, deps = {}) {
 						try {
 							const { createExperimenter } = await import(
 								/* @vite-ignore */
-								"../experimenter-Br1-vzYv.js"
+								"../experimenter-jto3orYl.js"
 );
 							const { getLatestRun: getLatest } = await import(
 								/* @vite-ignore */
-								"../decisions-DxgMpQpz.js"
+								"../decisions-CbysnTi5.js"
 );
 							const dbPath = join(projectRoot, ".substrate", "substrate.db");
 							const expDbWrapper = new DatabaseWrapper(dbPath);
@@ -2665,7 +2681,7 @@ async function runSupervisorAction(options, deps = {}) {
 								const expDb = expDbWrapper.db;
 								const { runRunAction: runPipeline } = await import(
 									/* @vite-ignore */
-									"../run-33J0SBp1.js"
+									"../run-D3rMGI6c.js"
 );
 								const runStoryFn = async (opts) => {
 									const exitCode = await runPipeline({
@@ -2742,7 +2758,8 @@ async function runSupervisorAction(options, deps = {}) {
 			sleep: resolvedDeps.sleep,
 			incrementRestarts: resolvedDeps.incrementRestarts,
 			getAllDescendants: resolvedDeps.getAllDescendants,
-			writeStallFindings: resolvedDeps.writeStallFindings
+			writeStallFindings: resolvedDeps.writeStallFindings,
+			getRegistry: resolvedDeps.getRegistry
 		}, {
 			emitEvent,
 			log
@@ -3029,7 +3046,6 @@ async function runMetricsAction(options) {
 		}
 		try {
 			const telemetryPersistence = new TelemetryPersistence(sqliteDb);
-			telemetryPersistence.initSchema();
 			if (efficiency === true) {
 				const scores = await telemetryPersistence.getEfficiencyScores(20);
 				if (outputFormat === "json") process.stdout.write(formatOutput({ efficiency: rowsToEfficiencyScore(scores) }, "json", true) + "\n");
@@ -7456,8 +7472,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-Ex1ukwsm.js").then(async () => {
-		const { createVersionManager } = await import("../version-manager-impl-Dk3S31y6.js");
+	import("../upgrade-BlJKjr6I.js").then(async () => {
+		const { createVersionManager } = await import("../version-manager-impl-BsHqAeGT.js");
 		const vm = createVersionManager();
 		const result = await vm.checkForUpdates();
 		if (result.updateAvailable) {

package/dist/{config-migrator-CQmBdKeG.js → config-migrator-DtZW1maj.js}

@@ -247,4 +247,4 @@ const defaultConfigMigrator = new ConfigMigrator();
 
 //#endregion
 export { CURRENT_CONFIG_FORMAT_VERSION, CURRENT_TASK_GRAPH_VERSION, PartialSubstrateConfigSchema, SUPPORTED_CONFIG_FORMAT_VERSIONS, SUPPORTED_TASK_GRAPH_VERSIONS, SubstrateConfigSchema, defaultConfigMigrator };
-//# sourceMappingURL=config-migrator-CQmBdKeG.js.map
+//# sourceMappingURL=config-migrator-DtZW1maj.js.map

package/dist/{decisions-DxgMpQpz.js → decisions-CbysnTi5.js}

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

package/dist/{decisions-Dq4cAA2L.js → decisions-CdpiJIm5.js}

@@ -369,4 +369,4 @@ function getTokenUsageSummary(db, runId) {
 
 //#endregion
 export { addTokenUsage, createDecision, createPipelineRun, createRequirement, getArtifactByTypeForRun, getArtifactsByRun, getDecisionsByCategory, getDecisionsByPhase, getDecisionsByPhaseForRun, getLatestRun, getPipelineRunById, getRunningPipelineRuns, getTokenUsageSummary, listRequirements, registerArtifact, updateDecision, updatePipelineRun, updatePipelineRunConfig, upsertDecision };
-//# sourceMappingURL=decisions-Dq4cAA2L.js.map
+//# sourceMappingURL=decisions-CdpiJIm5.js.map

package/dist/{experimenter-Br1-vzYv.js → experimenter-jto3orYl.js}

@@ -1,7 +1,7 @@
 import "./logger-D2fS2ccL.js";
-import { createDecision } from "./decisions-Dq4cAA2L.js";
-import { EXPERIMENT_RESULT, getRunMetrics, getStoryMetricsForRun } from "./operational-Bovj4fS-.js";
-import { spawnGit } from "./git-utils-CtmrZrHS.js";
+import { createDecision } from "./decisions-CdpiJIm5.js";
+import { EXPERIMENT_RESULT, getRunMetrics, getStoryMetricsForRun } from "./operational-DisxqtjC.js";
+import { spawnGit } from "./git-utils-UbKLSGsD.js";
 import { spawn } from "node:child_process";
 import { join } from "node:path";
 import { mkdir, readFile, writeFile } from "node:fs/promises";
@@ -500,4 +500,4 @@ function createExperimenter(config, deps) {
 
 //#endregion
 export { createExperimenter };
-//# sourceMappingURL=experimenter-Br1-vzYv.js.map
+//# sourceMappingURL=experimenter-jto3orYl.js.map

package/dist/{git-utils-CtmrZrHS.js → git-utils-UbKLSGsD.js}

@@ -362,4 +362,4 @@ async function getMergedFiles(cwd) {
 
 //#endregion
 export { abortMerge, createWorktree, getConflictingFiles, getMergedFiles, getOrphanedWorktrees, performMerge, removeBranch, removeWorktree, simulateMerge, spawnGit, verifyGitVersion };
-//# sourceMappingURL=git-utils-CtmrZrHS.js.map
+//# sourceMappingURL=git-utils-UbKLSGsD.js.map

package/dist/{helpers-RL22dYtn.js → helpers-BihqWgVe.js}

@@ -917,4 +917,4 @@ async function withRetry(fn, maxRetries = 3, baseDelayMs = 100) {
 
 //#endregion
 export { AdtError, BudgetExceededError, ConfigError, ConfigIncompatibleFormatError, GitError, RecoveryError, TaskConfigError, TaskGraphCycleError, TaskGraphError, TaskGraphIncompatibleFormatError, WorkerError, WorkerNotFoundError, assertDefined, createEventBus, createTuiApp, deepClone, formatDuration, generateId, isPlainObject, isTuiCapable, printNonTtyWarning, sleep, withRetry };
-//# sourceMappingURL=helpers-RL22dYtn.js.map
+//# sourceMappingURL=helpers-BihqWgVe.js.map

package/dist/index.d.ts

@@ -534,6 +534,23 @@ interface PipelineContractMismatchEvent {
   /** Human-readable description of the mismatch (e.g., missing file, type error) */
   mismatchDescription: string;
 }
+/**
+ * Emitted once after post-sprint contract verification completes.
+ * Consolidates results into a single event instead of per-mismatch noise.
+ */
+interface PipelineContractVerificationSummaryEvent {
+  type: 'pipeline:contract-verification-summary';
+  /** ISO-8601 timestamp generated at emit time */
+  ts: string;
+  /** Number of contract declarations verified (current sprint only) */
+  verified: number;
+  /** Number of stale declarations pruned (from previous epics) */
+  stalePruned: number;
+  /** Number of real mismatches found */
+  mismatches: number;
+  /** 'pass' if zero mismatches, 'fail' otherwise */
+  verdict: 'pass' | 'fail';
+}
 /**
  * Discriminated union of all pipeline event types.
  *
@@ -546,7 +563,7 @@ interface PipelineContractMismatchEvent {
  * }
  * ```
  */
-type PipelineEvent = PipelineStartEvent | PipelineCompleteEvent | PipelinePreFlightFailureEvent | PipelineContractMismatchEvent | StoryPhaseEvent | StoryDoneEvent | StoryEscalationEvent | StoryWarnEvent | StoryLogEvent | PipelineHeartbeatEvent | StoryStallEvent | StoryZeroDiffEscalationEvent | StoryBuildVerificationFailedEvent | StoryBuildVerificationPassedEvent | StoryInterfaceChangeWarningEvent | StoryMetricsEvent | SupervisorPollEvent | SupervisorKillEvent | SupervisorRestartEvent | SupervisorAbortEvent | SupervisorSummaryEvent | SupervisorAnalysisCompleteEvent | SupervisorAnalysisErrorEvent | SupervisorExperimentStartEvent | SupervisorExperimentSkipEvent | SupervisorExperimentRecommendationsEvent | SupervisorExperimentCompleteEvent | SupervisorExperimentErrorEvent; //#endregion
+type PipelineEvent = PipelineStartEvent | PipelineCompleteEvent | PipelinePreFlightFailureEvent | PipelineContractMismatchEvent | PipelineContractVerificationSummaryEvent | StoryPhaseEvent | StoryDoneEvent | StoryEscalationEvent | StoryWarnEvent | StoryLogEvent | PipelineHeartbeatEvent | StoryStallEvent | StoryZeroDiffEscalationEvent | StoryBuildVerificationFailedEvent | StoryBuildVerificationPassedEvent | StoryInterfaceChangeWarningEvent | StoryMetricsEvent | SupervisorPollEvent | SupervisorKillEvent | SupervisorRestartEvent | SupervisorAbortEvent | SupervisorSummaryEvent | SupervisorAnalysisCompleteEvent | SupervisorAnalysisErrorEvent | SupervisorExperimentStartEvent | SupervisorExperimentSkipEvent | SupervisorExperimentRecommendationsEvent | SupervisorExperimentCompleteEvent | SupervisorExperimentErrorEvent; //#endregion
 //#region src/core/errors.d.ts
 
 /**
@@ -1214,6 +1231,17 @@ interface OrchestratorEvents {
     /** Human-readable description of the mismatch */
     mismatchDescription: string;
   };
+  /** Consolidated contract verification summary (emitted once per verification pass) */
+  'pipeline:contract-verification-summary': {
+    /** Number of contract declarations verified (current sprint only) */
+    verified: number;
+    /** Number of stale declarations pruned (from previous epics) */
+    stalePruned: number;
+    /** Number of real mismatches found */
+    mismatches: number;
+    /** 'pass' if zero mismatches, 'fail' otherwise */
+    verdict: 'pass' | 'fail';
+  };
   /** Build verification command failed with non-zero exit or timeout */
   'story:build-verification-failed': {
     storyKey: string;
@@ -1418,11 +1446,17 @@ interface AdapterOptions {
   maxTurns?: number;
   /**
    * Optional OTLP endpoint URL for telemetry export (Story 27-9).
-   * When set, injects the 5 OTLP env vars into the spawned process so that
+   * When set, injects OTLP env vars into the spawned process so that
    * Claude Code exports telemetry to the local IngestionServer.
    * Example: "http://localhost:4318"
    */
   otlpEndpoint?: string;
+  /**
+   * Optional story key for OTEL resource attribute tagging.
+   * Injected as `substrate.story_key` via OTEL_RESOURCE_ATTRIBUTES
+   * so the telemetry pipeline can group spans/events per story.
+   */
+  storyKey?: string;
 }
 /**
  * Capabilities reported by an adapter for this CLI agent.

package/dist/index.js

@@ -1,6 +1,6 @@
 import { childLogger, createLogger, logger } from "./logger-D2fS2ccL.js";
-import { AdapterRegistry, ClaudeCodeAdapter, CodexCLIAdapter, GeminiCLIAdapter } from "./adapter-registry-DHl0W-YB.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-RL22dYtn.js";
+import { AdapterRegistry, ClaudeCodeAdapter, CodexCLIAdapter, GeminiCLIAdapter } from "./adapter-registry-a2WX0qo_.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/{operational-Bovj4fS-.js → operational-DisxqtjC.js}

@@ -356,4 +356,4 @@ const ADVISORY_NOTES = "advisory-notes";
 
 //#endregion
 export { ADVISORY_NOTES, ESCALATION_DIAGNOSIS, EXPERIMENT_RESULT, OPERATIONAL_FINDING, STORY_METRICS, STORY_OUTCOME, TEST_EXPANSION_FINDING, TEST_PLAN, aggregateTokenUsageForRun, aggregateTokenUsageForStory, compareRunMetrics, getBaselineRunMetrics, getRunMetrics, getStoryMetricsForRun, incrementRunRestarts, listRunMetrics, tagRunAsBaseline, writeRunMetrics, writeStoryMetrics };
-//# sourceMappingURL=operational-Bovj4fS-.js.map
+//# sourceMappingURL=operational-DisxqtjC.js.map

package/dist/run-D3rMGI6c.js

@@ -0,0 +1,8 @@
+import { registerRunCommand, runRunAction } from "./run-DzzmgEOd.js";
+import "./logger-D2fS2ccL.js";
+import "./config-migrator-DtZW1maj.js";
+import "./helpers-BihqWgVe.js";
+import "./decisions-CdpiJIm5.js";
+import "./operational-DisxqtjC.js";
+
+export { runRunAction };