substrate-ai 0.2.25 → 0.2.27

package/dist/cli/index.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { DatabaseWrapper, SUBSTRATE_OWNED_SETTINGS_KEYS, VALID_PHASES, buildPipelineStatusOutput, createContextCompiler, createDispatcher, createImplementationOrchestrator, createPackLoader, createPhaseOrchestrator, createStopAfterGate, findPackageRoot, formatOutput, formatPhaseCompletionSummary, formatPipelineStatusHuman, formatPipelineSummary, formatTokenTelemetry, getAllDescendantPids, getAutoHealthData, getSubstrateDefaultSettings, registerHealthCommand, registerRunCommand, resolveBmadMethodSrcPath, resolveBmadMethodVersion, resolveMainRepoRoot, runAnalysisPhase, runMigrations, runPlanningPhase, runSolutioningPhase, validateStopAfterFromConflict } from "../run-CKvf6LgL.js";
+import { DatabaseWrapper, SUBSTRATE_OWNED_SETTINGS_KEYS, VALID_PHASES, buildPipelineStatusOutput, 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-DG5j6vJI.js";
 import { createLogger, deepMask } from "../logger-D2fS2ccL.js";
 import { AdapterRegistry, ConfigError, ConfigIncompatibleFormatError } from "../errors-CswS7Mzg.js";
 import { CURRENT_CONFIG_FORMAT_VERSION, CURRENT_TASK_GRAPH_VERSION, PartialSubstrateConfigSchema, SUPPORTED_CONFIG_FORMAT_VERSIONS, SubstrateConfigSchema, defaultConfigMigrator } from "../version-manager-impl-CZ6KF1Ds.js";
@@ -1615,7 +1615,53 @@ async function runStatusAction(options) {
 		const storiesCount = db.prepare(`SELECT COUNT(*) as cnt FROM requirements WHERE pipeline_run_id = ? AND source = 'solutioning-phase'`).get(run.id)?.cnt ?? 0;
 		if (outputFormat === "json") {
 			const statusOutput = buildPipelineStatusOutput(run, tokenSummary, decisionsCount, storiesCount);
-			process.stdout.write(formatOutput(statusOutput, "json", true) + "\n");
+			const storyMetricsRows = getStoryMetricsForRun(db, run.id);
+			const storyMetricsV2 = storyMetricsRows.map((row) => {
+				const phaseBreakdown = {};
+				try {
+					if (row.phase_durations_json) {
+						const parsed = JSON.parse(row.phase_durations_json);
+						for (const [phase, secs] of Object.entries(parsed)) phaseBreakdown[phase] = Math.round(secs * 1e3);
+					}
+				} catch {}
+				return {
+					story_key: row.story_key,
+					result: row.result,
+					wall_clock_ms: Math.round((row.wall_clock_seconds ?? 0) * 1e3),
+					phase_breakdown: phaseBreakdown,
+					tokens: {
+						input: row.input_tokens ?? 0,
+						output: row.output_tokens ?? 0
+					},
+					review_cycles: row.review_cycles ?? 0,
+					dispatches: row.dispatches ?? 0
+				};
+			});
+			let pipelineWallClockMs = 0;
+			try {
+				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);
+			const totalInputTokens = storyMetricsRows.reduce((sum, r) => sum + (r.input_tokens ?? 0), 0);
+			const totalOutputTokens = storyMetricsRows.reduce((sum, r) => sum + (r.output_tokens ?? 0), 0);
+			const completedCount = storyMetricsRows.filter((r) => r.result === "success").length;
+			const storiesPerHour = pipelineWallClockMs > 0 ? Math.round(completedCount / (pipelineWallClockMs / 36e5) * 100) / 100 : 0;
+			const totalCostUsd = storyMetricsRows.reduce((sum, r) => sum + (r.cost_usd ?? 0), 0);
+			const enhancedOutput = {
+				...statusOutput,
+				story_metrics: storyMetricsV2,
+				pipeline_metrics: {
+					total_wall_clock_ms: pipelineWallClockMs,
+					total_review_cycles: totalReviewCycles,
+					total_input_tokens: totalInputTokens,
+					total_output_tokens: totalOutputTokens,
+					stories_per_hour: storiesPerHour,
+					cost_usd: totalCostUsd
+				}
+			};
+			process.stdout.write(formatOutput(enhancedOutput, "json", true) + "\n");
 		} else {
 			let hasPhaseHistory = false;
 			try {
@@ -2842,7 +2888,7 @@ async function runSupervisorAction(options, deps = {}) {
 								const expDb = expDbWrapper.db;
 								const { runRunAction: runPipeline } = await import(
 									/* @vite-ignore */
-									"../run-bigUnNya.js"
+									"../run-jLeEo8FW.js"
 );
 								const runStoryFn = async (opts) => {
 									const exitCode = await runPipeline({

package/dist/index.d.ts

@@ -172,6 +172,87 @@ interface StoryEscalationEvent {
   /** Issues list from the final review (may be empty) */
   issues: EscalationIssue[];
 }
+/**
+ * Emitted when a dev-story agent reported COMPLETE but git diff shows no
+ * file changes in the working tree (phantom completion — Story 24-1).
+ */
+interface StoryZeroDiffEscalationEvent {
+  type: 'story:zero-diff-escalation';
+  /** ISO-8601 timestamp generated at emit time */
+  ts: string;
+  /** Story key (e.g., "10-1") */
+  storyKey: string;
+  /** Always "zero-diff-on-complete" */
+  reason: string;
+}
+/**
+ * Emitted when the build verification command exits with a non-zero code
+ * or times out, before code-review is dispatched (Story 24-2).
+ */
+interface StoryBuildVerificationFailedEvent {
+  type: 'story:build-verification-failed';
+  /** ISO-8601 timestamp generated at emit time */
+  ts: string;
+  /** Story key (e.g., "24-2") */
+  storyKey: 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 code 0 (Story 24-2).
+ */
+interface StoryBuildVerificationPassedEvent {
+  type: 'story:build-verification-passed';
+  /** ISO-8601 timestamp generated at emit time */
+  ts: string;
+  /** Story key (e.g., "24-2") */
+  storyKey: string;
+}
+/**
+ * Emitted (non-blocking) when a dev-story modifies .ts files that export
+ * shared TypeScript interfaces or types, and those names are referenced by
+ * test files outside the same module.
+ *
+ * Signals potential stale-mock risk. The story still proceeds to code-review.
+ * (Story 24-3)
+ */
+interface StoryInterfaceChangeWarningEvent {
+  type: 'story:interface-change-warning';
+  /** ISO-8601 timestamp generated at emit time */
+  ts: string;
+  /** Story key (e.g., "24-3") */
+  storyKey: string;
+  /** Exported interface/type names found in modified files */
+  modifiedInterfaces: string[];
+  /** Test file paths (relative to project root) that reference the modified interface names */
+  potentiallyAffectedTests: string[];
+}
+/**
+ * Emitted when a story reaches a terminal state (COMPLETE, ESCALATED, or
+ * max retries), providing a metrics snapshot for observability (Story 24-4).
+ */
+interface StoryMetricsEvent {
+  type: 'story:metrics';
+  /** ISO-8601 timestamp generated at emit time */
+  ts: string;
+  /** Story key (e.g., "24-4") */
+  storyKey: string;
+  /** Total wall-clock duration in milliseconds */
+  wallClockMs: number;
+  /** Per-phase duration in milliseconds: phase name → ms */
+  phaseBreakdown: Record<string, number>;
+  /** Token counts from the adapter (accumulated across all dispatches) */
+  tokens: {
+    input: number;
+    output: number;
+  };
+  /** Number of code-review cycles completed */
+  reviewCycles: number;
+  /** Total number of agent dispatches for this story */
+  dispatches: number;
+}
 /**
  * Emitted for non-fatal warnings during pipeline execution
  * (e.g., token ceiling truncation, partial batch failures).
@@ -432,7 +513,7 @@ interface SupervisorExperimentErrorEvent {
  * }
  * ```
  */
-type PipelineEvent = PipelineStartEvent | PipelineCompleteEvent | StoryPhaseEvent | StoryDoneEvent | StoryEscalationEvent | StoryWarnEvent | StoryLogEvent | PipelineHeartbeatEvent | StoryStallEvent | SupervisorPollEvent | SupervisorKillEvent | SupervisorRestartEvent | SupervisorAbortEvent | SupervisorSummaryEvent | SupervisorAnalysisCompleteEvent | SupervisorAnalysisErrorEvent | SupervisorExperimentStartEvent | SupervisorExperimentSkipEvent | SupervisorExperimentRecommendationsEvent | SupervisorExperimentCompleteEvent | SupervisorExperimentErrorEvent; //#endregion
+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
 //#region src/core/errors.d.ts
 
 /**
@@ -1018,6 +1099,11 @@ interface OrchestratorEvents {
     storyKey: string;
     msg: string;
   };
+  /** Zero-diff detection gate: dev-story reported COMPLETE but git diff is empty (Story 24-1) */
+  'orchestrator:zero-diff-escalation': {
+    storyKey: string;
+    reason: string;
+  };
   /** Implementation orchestrator has finished all stories */
   'orchestrator:complete': {
     totalStories: number;
@@ -1067,6 +1153,35 @@ interface OrchestratorEvents {
       affected_items: string[];
     }>;
   };
+  /** Build verification command failed with non-zero exit or timeout */
+  'story:build-verification-failed': {
+    storyKey: string;
+    exitCode: number;
+    /** Build output (stdout+stderr), truncated to 2000 chars */
+    output: string;
+  };
+  /** Build verification command exited with code 0 */
+  'story:build-verification-passed': {
+    storyKey: string;
+  };
+  /** Non-blocking warning: modified .ts files export shared interfaces referenced by cross-module tests */
+  'story:interface-change-warning': {
+    storyKey: string;
+    modifiedInterfaces: string[];
+    potentiallyAffectedTests: string[];
+  };
+  /** Per-story metrics snapshot emitted when a story reaches a terminal state (Story 24-4) */
+  'story:metrics': {
+    storyKey: string;
+    wallClockMs: number;
+    phaseBreakdown: Record<string, number>;
+    tokens: {
+      input: number;
+      output: number;
+    };
+    reviewCycles: number;
+    dispatches: number;
+  };
 }
 
 //#endregion