substrate-ai 0.2.30 → 0.2.33

package/dist/cli/index.js

@@ -1,11 +1,11 @@
 #!/usr/bin/env node
-import { DEFAULT_CONFIG, DEFAULT_ROUTING_POLICY, DatabaseWrapper, SUBSTRATE_OWNED_SETTINGS_KEYS, VALID_PHASES, buildPipelineStatusOutput, createConfigSystem, createContextCompiler, createDispatcher, createImplementationOrchestrator, createPackLoader, createPhaseOrchestrator, createStopAfterGate, findPackageRoot, formatOutput, formatPhaseCompletionSummary, formatPipelineStatusHuman, formatPipelineSummary, formatTokenTelemetry, getAllDescendantPids, getAutoHealthData, getSubstrateDefaultSettings, parseDbTimestampAsUtc, registerHealthCommand, registerRunCommand, resolveBmadMethodSrcPath, resolveBmadMethodVersion, resolveMainRepoRoot, runAnalysisPhase, runMigrations, runPlanningPhase, runSolutioningPhase, validateStopAfterFromConflict } from "../run-Ajt187oE.js";
+import { DEFAULT_CONFIG, DEFAULT_ROUTING_POLICY, DatabaseWrapper, SUBSTRATE_OWNED_SETTINGS_KEYS, VALID_PHASES, buildPipelineStatusOutput, createConfigSystem, createContextCompiler, createDispatcher, createImplementationOrchestrator, createPackLoader, createPhaseOrchestrator, createStopAfterGate, findPackageRoot, formatOutput, formatPhaseCompletionSummary, formatPipelineStatusHuman, formatPipelineSummary, formatTokenTelemetry, getAllDescendantPids, getAutoHealthData, getSubstrateDefaultSettings, parseDbTimestampAsUtc, registerHealthCommand, registerRunCommand, resolveBmadMethodSrcPath, resolveBmadMethodVersion, resolveMainRepoRoot, runAnalysisPhase, runMigrations, runPlanningPhase, runSolutioningPhase, validateStopAfterFromConflict } from "../run-XNRFAHEx.js";
 import { createLogger } from "../logger-D2fS2ccL.js";
 import { AdapterRegistry } from "../adapter-registry-PsWhP_1Q.js";
 import { CURRENT_CONFIG_FORMAT_VERSION, CURRENT_TASK_GRAPH_VERSION, PartialSubstrateConfigSchema } from "../config-migrator-DSi8KhQC.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-CnMlvWqc.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-CizNmmLT.js";
 import { registerUpgradeCommand } from "../upgrade-Cvwtnwl4.js";
@@ -1336,8 +1336,8 @@ async function runStatusAction(options) {
 			});
 			let pipelineWallClockMs = 0;
 			try {
-				const createdAt = parseDbTimestampAsUtc(run.created_at);
-				const endTimestamp = run.status === "running" ? new Date() : parseDbTimestampAsUtc(run.updated_at);
+				const createdAt = parseDbTimestampAsUtc(run.created_at ?? "");
+				const endTimestamp = run.status === "running" ? new Date() : parseDbTimestampAsUtc(run.updated_at ?? "");
 				pipelineWallClockMs = Math.max(0, endTimestamp.getTime() - createdAt.getTime());
 			} catch {}
 			const totalReviewCycles = storyMetricsRows.reduce((sum, r) => sum + (r.review_cycles ?? 0), 0);
@@ -2158,7 +2158,7 @@ function defaultSupervisorDeps() {
 						const dbPath = join(dbRoot, ".substrate", "substrate.db");
 						cachedDbWrapper = new DatabaseWrapper(dbPath);
 					}
-					incrementRunRestarts(cachedDbWrapper.getDb(), runId);
+					incrementRunRestarts(cachedDbWrapper.db, runId);
 				} catch {
 					try {
 						cachedDbWrapper?.close();
@@ -2571,7 +2571,7 @@ async function runSupervisorAction(options, deps = {}) {
 						try {
 							const { createExperimenter } = await import(
 								/* @vite-ignore */
-								"../experimenter-f_Y1rreV.js"
+								"../experimenter-Br1-vzYv.js"
 );
 							const { getLatestRun: getLatest } = await import(
 								/* @vite-ignore */
@@ -2585,7 +2585,7 @@ async function runSupervisorAction(options, deps = {}) {
 								const expDb = expDbWrapper.db;
 								const { runRunAction: runPipeline } = await import(
 									/* @vite-ignore */
-									"../run-KBcR3Jpi.js"
+									"../run-Cd7sfXzo.js"
 );
 								const runStoryFn = async (opts) => {
 									const exitCode = await runPipeline({
@@ -2596,7 +2596,7 @@ async function runSupervisorAction(options, deps = {}) {
 										projectRoot: opts.projectRoot
 									});
 									const latestRun = getLatest(expDb);
-									const newRunId = latestRun?.run_id ?? `experiment-${Date.now()}`;
+									const newRunId = latestRun?.id ?? `experiment-${Date.now()}`;
 									return {
 										runId: newRunId,
 										exitCode

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

@@ -1,6 +1,6 @@
 import "./logger-D2fS2ccL.js";
 import { createDecision } from "./decisions-Dq4cAA2L.js";
-import { EXPERIMENT_RESULT, getRunMetrics, getStoryMetricsForRun } from "./operational-CnMlvWqc.js";
+import { EXPERIMENT_RESULT, getRunMetrics, getStoryMetricsForRun } from "./operational-Bovj4fS-.js";
 import { spawnGit } from "./git-utils-CtmrZrHS.js";
 import { spawn } from "node:child_process";
 import { join } from "node:path";
@@ -500,4 +500,4 @@ function createExperimenter(config, deps) {
 
 //#endregion
 export { createExperimenter };
-//# sourceMappingURL=experimenter-f_Y1rreV.js.map
+//# sourceMappingURL=experimenter-Br1-vzYv.js.map

package/dist/index.d.ts

@@ -185,6 +185,19 @@ interface StoryZeroDiffEscalationEvent {
   /** Always "zero-diff-on-complete" */
   reason: string;
 }
+/**
+ * Emitted when the pre-flight build check fails before any story is dispatched (Story 25-2).
+ * Pipeline aborts immediately — no stories are processed.
+ */
+interface PipelinePreFlightFailureEvent {
+  type: 'pipeline:pre-flight-failure';
+  /** ISO-8601 timestamp generated at emit time */
+  ts: string;
+  /** Exit code from the build command (-1 for timeout) */
+  exitCode: number;
+  /** Combined stdout+stderr output, truncated to 2000 chars */
+  output: string;
+}
 /**
  * Emitted when the build verification command exits with a non-zero code
  * or times out, before code-review is dispatched (Story 24-2).
@@ -501,6 +514,26 @@ interface SupervisorExperimentErrorEvent {
   /** Error message describing why the experiment failed */
   error: string;
 }
+/**
+ * Emitted when post-sprint contract verification finds a mismatch between
+ * declared export/import contracts (Story 25-6).
+ *
+ * Failures are warnings only — stories already completed. The user should
+ * inspect the mismatch and fix manually.
+ */
+interface PipelineContractMismatchEvent {
+  type: 'pipeline:contract-mismatch';
+  /** ISO-8601 timestamp generated at emit time */
+  ts: string;
+  /** Story key that declared the export for this contract */
+  exporter: string;
+  /** Story key that declared the import for this contract (null if no importer found) */
+  importer: string | null;
+  /** TypeScript interface or Zod schema name (e.g., "JudgeResult") */
+  contractName: string;
+  /** Human-readable description of the mismatch (e.g., missing file, type error) */
+  mismatchDescription: string;
+}
 /**
  * Discriminated union of all pipeline event types.
  *
@@ -513,7 +546,7 @@ interface SupervisorExperimentErrorEvent {
  * }
  * ```
  */
-type PipelineEvent = PipelineStartEvent | PipelineCompleteEvent | 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 | 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
 
 /**
@@ -1160,6 +1193,23 @@ interface OrchestratorEvents {
       affected_items: string[];
     }>;
   };
+  /** Pre-flight build check failed before any stories were dispatched */
+  'pipeline:pre-flight-failure': {
+    exitCode: number;
+    /** Build output (stdout+stderr), truncated to 2000 chars */
+    output: string;
+  };
+  /** Contract verification found a mismatch between declared export/import contracts */
+  'pipeline:contract-mismatch': {
+    /** Story key that declared the export for this contract */
+    exporter: string;
+    /** Story key that declared the import for this contract (null if no importer found) */
+    importer: string | null;
+    /** TypeScript interface or Zod schema name (e.g., "JudgeResult") */
+    contractName: string;
+    /** Human-readable description of the mismatch */
+    mismatchDescription: string;
+  };
   /** Build verification command failed with non-zero exit or timeout */
   'story:build-verification-failed': {
     storyKey: string;

package/dist/{operational-CnMlvWqc.js → operational-Bovj4fS-.js}

@@ -339,7 +339,21 @@ const TEST_EXPANSION_FINDING = "test-expansion-finding";
 * ```
 */
 const TEST_PLAN = "test-plan";
+/**
+* Category for advisory notes persisted when a code review returns LGTM_WITH_NOTES.
+*
+* Key schema: "{storyKey}:{runId}"
+*
+* Value shape:
+* ```json
+* {
+*   "storyKey": "25-3",
+*   "notes": "Consider extracting the helper into a shared module for reuse."
+* }
+* ```
+*/
+const ADVISORY_NOTES = "advisory-notes";
 
 //#endregion
-export { 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-CnMlvWqc.js.map
+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

package/dist/{run-KBcR3Jpi.js → run-Cd7sfXzo.js}

@@ -1,8 +1,8 @@
-import { registerRunCommand, runRunAction } from "./run-Ajt187oE.js";
+import { registerRunCommand, runRunAction } from "./run-XNRFAHEx.js";
 import "./logger-D2fS2ccL.js";
 import "./config-migrator-DSi8KhQC.js";
 import "./helpers-RL22dYtn.js";
 import "./decisions-Dq4cAA2L.js";
-import "./operational-CnMlvWqc.js";
+import "./operational-Bovj4fS-.js";
 
 export { runRunAction };