substrate-ai 0.3.4 → 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,7 +1,7 @@
 #!/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-8ygA8hgY.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 { 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";
@@ -2284,7 +2284,7 @@ function defaultSupervisorDeps() {
 				if (cached === null) {
 					const { AdapterRegistry: AR } = await import(
 						/* @vite-ignore */
-						"../adapter-registry-eyyVr21J.js"
+						"../adapter-registry-BBn0Rmqj.js"
 );
 					cached = new AR();
 					await cached.discoverAndRegister();
@@ -2681,7 +2681,7 @@ async function runSupervisorAction(options, deps = {}) {
 								const expDb = expDbWrapper.db;
 								const { runRunAction: runPipeline } = await import(
 									/* @vite-ignore */
-									"../run-Dul2DU3D.js"
+									"../run-D3rMGI6c.js"
 );
 								const runStoryFn = async (opts) => {
 									const exitCode = await runPipeline({

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,5 +1,5 @@
 import { childLogger, createLogger, logger } from "./logger-D2fS2ccL.js";
-import { AdapterRegistry, ClaudeCodeAdapter, CodexCLIAdapter, GeminiCLIAdapter } from "./adapter-registry-DHl0W-YB.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/{run-Dul2DU3D.js → run-D3rMGI6c.js}

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

package/dist/{run-8ygA8hgY.js → run-DzzmgEOd.js}

@@ -2966,6 +2966,38 @@ const PIPELINE_EVENT_METADATA = [
 				description: "Mismatch details (missing file, type error)."
 			}
 		]
+	},
+	{
+		type: "pipeline:contract-verification-summary",
+		description: "Contract verification summary. Consolidates pass/fail into a single event.",
+		when: "After all stories complete, before pipeline:complete. Emitted once per verification pass.",
+		fields: [
+			{
+				name: "ts",
+				type: "string",
+				description: "Timestamp."
+			},
+			{
+				name: "verified",
+				type: "number",
+				description: "Declarations verified (current sprint)."
+			},
+			{
+				name: "stalePruned",
+				type: "number",
+				description: "Stale declarations pruned (previous epics)."
+			},
+			{
+				name: "mismatches",
+				type: "number",
+				description: "Real mismatches found."
+			},
+			{
+				name: "verdict",
+				type: "pass|fail",
+				description: "Overall verification result."
+			}
+		]
 	}
 ];
 /**
@@ -3920,7 +3952,7 @@ var DispatcherImpl = class {
 		logger$22.info("Dispatcher shutdown complete");
 	}
 	async _startDispatch(id, request, resolve$2) {
-		const { prompt, agent, taskType, timeout, outputSchema, workingDirectory, model, maxTurns, otlpEndpoint } = request;
+		const { prompt, agent, taskType, timeout, outputSchema, workingDirectory, model, maxTurns, otlpEndpoint, storyKey } = request;
 		const adapter = this._adapterRegistry.get(agent);
 		if (adapter === void 0) {
 			logger$22.warn({
@@ -3951,7 +3983,8 @@ var DispatcherImpl = class {
 			billingMode: "subscription",
 			...model !== void 0 ? { model } : {},
 			...resolvedMaxTurns !== void 0 ? { maxTurns: resolvedMaxTurns } : {},
-			...otlpEndpoint !== void 0 ? { otlpEndpoint } : {}
+			...otlpEndpoint !== void 0 ? { otlpEndpoint } : {},
+			...storyKey !== void 0 ? { storyKey } : {}
 		});
 		const timeoutMs = timeout ?? this._config.defaultTimeouts[taskType] ?? DEFAULT_TIMEOUTS[taskType] ?? 3e5;
 		const env = { ...process.env };
@@ -4946,7 +4979,8 @@ async function runCreateStory(deps, params) {
 		taskType: "create-story",
 		outputSchema: CreateStoryResultSchema,
 		...deps.projectRoot !== void 0 ? { workingDirectory: deps.projectRoot } : {},
-		...deps.otlpEndpoint !== void 0 ? { otlpEndpoint: deps.otlpEndpoint } : {}
+		...deps.otlpEndpoint !== void 0 ? { otlpEndpoint: deps.otlpEndpoint } : {},
+		storyKey
 	});
 	let dispatchResult;
 	try {
@@ -5837,7 +5871,8 @@ async function runDevStory(deps, params) {
 			outputSchema: DevStoryResultSchema,
 			maxTurns: resolvedMaxTurns,
 			...deps.projectRoot !== void 0 ? { workingDirectory: deps.projectRoot } : {},
-			...deps.otlpEndpoint !== void 0 ? { otlpEndpoint: deps.otlpEndpoint } : {}
+			...deps.otlpEndpoint !== void 0 ? { otlpEndpoint: deps.otlpEndpoint } : {},
+			storyKey
 		});
 		dispatchResult = await handle.result;
 	} catch (err) {
@@ -6241,7 +6276,8 @@ async function runCodeReview(deps, params) {
 		taskType: "code-review",
 		outputSchema: CodeReviewResultSchema,
 		workingDirectory: deps.projectRoot,
-		...deps.otlpEndpoint !== void 0 ? { otlpEndpoint: deps.otlpEndpoint } : {}
+		...deps.otlpEndpoint !== void 0 ? { otlpEndpoint: deps.otlpEndpoint } : {},
+		storyKey
 	});
 	let dispatchResult;
 	try {
@@ -6430,7 +6466,8 @@ async function runTestPlan(deps, params) {
 			timeout: DEFAULT_TIMEOUT_MS,
 			outputSchema: TestPlanResultSchema,
 			...deps.projectRoot !== void 0 ? { workingDirectory: deps.projectRoot } : {},
-			...deps.otlpEndpoint !== void 0 ? { otlpEndpoint: deps.otlpEndpoint } : {}
+			...deps.otlpEndpoint !== void 0 ? { otlpEndpoint: deps.otlpEndpoint } : {},
+			storyKey
 		});
 		dispatchResult = await handle.result;
 	} catch (err) {
@@ -6677,7 +6714,8 @@ async function runTestExpansion(deps, params) {
 		taskType: "test-expansion",
 		outputSchema: TestExpansionResultSchema,
 		workingDirectory: deps.projectRoot,
-		...deps.otlpEndpoint !== void 0 ? { otlpEndpoint: deps.otlpEndpoint } : {}
+		...deps.otlpEndpoint !== void 0 ? { otlpEndpoint: deps.otlpEndpoint } : {},
+		storyKey
 	});
 	let dispatchResult;
 	try {
@@ -12842,7 +12880,8 @@ function createImplementationOrchestrator(deps) {
 						taskType: "minor-fixes",
 						workingDirectory: projectRoot,
 						...autoApproveMaxTurns !== void 0 ? { maxTurns: autoApproveMaxTurns } : {},
-						..._otlpEndpoint !== void 0 ? { otlpEndpoint: _otlpEndpoint } : {}
+						..._otlpEndpoint !== void 0 ? { otlpEndpoint: _otlpEndpoint } : {},
+						storyKey
 					});
 					const fixResult = await handle.result;
 					eventBus.emit("orchestrator:story-phase-complete", {
@@ -13285,7 +13324,15 @@ function createImplementationOrchestrator(deps) {
 			_state = "COMPLETE";
 			_completedAt = new Date().toISOString();
 			if (projectRoot !== void 0 && contractDeclarations.length > 0) try {
-				const mismatches = verifyContracts(contractDeclarations, projectRoot);
+				const totalDeclarations = contractDeclarations.length;
+				const currentSprintDeclarations = contractDeclarations.filter((d) => storyKeys.includes(d.storyKey));
+				const stalePruned = totalDeclarations - currentSprintDeclarations.length;
+				if (stalePruned > 0) logger$27.info({
+					stalePruned,
+					remaining: currentSprintDeclarations.length
+				}, "Pruned stale contract declarations from previous epics");
+				let mismatches = [];
+				if (currentSprintDeclarations.length > 0) mismatches = verifyContracts(currentSprintDeclarations, projectRoot);
 				if (mismatches.length > 0) {
 					_contractMismatches = mismatches;
 					for (const mismatch of mismatches) eventBus.emit("pipeline:contract-mismatch", {
@@ -13298,12 +13345,18 @@ function createImplementationOrchestrator(deps) {
 						mismatchCount: mismatches.length,
 						mismatches
 					}, "Post-sprint contract verification found mismatches — manual review required");
-				} else logger$27.info("Post-sprint contract verification passed — all declared contracts satisfied");
+				} else if (currentSprintDeclarations.length > 0) logger$27.info("Post-sprint contract verification passed — all declared contracts satisfied");
+				eventBus.emit("pipeline:contract-verification-summary", {
+					verified: currentSprintDeclarations.length,
+					stalePruned,
+					mismatches: mismatches.length,
+					verdict: mismatches.length === 0 ? "pass" : "fail"
+				});
 				if (stateStore !== void 0) try {
-					const allContractsForVerification = await stateStore.queryContracts();
+					const currentSprintContracts = (await stateStore.queryContracts()).filter((cr) => storyKeys.includes(cr.storyKey));
 					const verifiedAt = new Date().toISOString();
 					const contractsByStory = new Map();
-					for (const cr of allContractsForVerification) {
+					for (const cr of currentSprintContracts) {
 						const existing = contractsByStory.get(cr.storyKey) ?? [];
 						existing.push(cr);
 						contractsByStory.set(cr.storyKey, existing);
@@ -18120,6 +18173,16 @@ async function runRunAction(options) {
 					mismatchDescription: payload.mismatchDescription
 				});
 			});
+			eventBus.on("pipeline:contract-verification-summary", (payload) => {
+				ndjsonEmitter.emit({
+					type: "pipeline:contract-verification-summary",
+					ts: new Date().toISOString(),
+					verified: payload.verified,
+					stalePruned: payload.stalePruned,
+					mismatches: payload.mismatches,
+					verdict: payload.verdict
+				});
+			});
 		}
 		const ingestionServer = telemetryEnabled ? new IngestionServer({ port: telemetryPort }) : void 0;
 		const telemetryPersistence = telemetryEnabled ? new TelemetryPersistence(db) : void 0;
@@ -18587,4 +18650,4 @@ function registerRunCommand(program, _version = "0.0.0", projectRoot = process.c
 
 //#endregion
 export { 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, runRunAction, runSolutioningPhase, validateStopAfterFromConflict };
-//# sourceMappingURL=run-8ygA8hgY.js.map
+//# sourceMappingURL=run-DzzmgEOd.js.map

package/package.json

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

package/dist/adapter-registry-eyyVr21J.js

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