substrate-ai 0.2.24 → 0.2.26

package/dist/cli/index.js

@@ -1,9 +1,9 @@
 #!/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-CT8B9gG9.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, registerHealthCommand, registerRunCommand, resolveBmadMethodSrcPath, resolveBmadMethodVersion, resolveMainRepoRoot, runAnalysisPhase, runMigrations, runPlanningPhase, runSolutioningPhase, validateStopAfterFromConflict } from "../run-CEtHPG4I.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";
-import { createEventBus } from "../event-bus-CAvDMst7.js";
+import { createEventBus } from "../helpers-DljGJnFF.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 { abortMerge, createWorktree, getConflictingFiles, getMergedFiles, getOrphanedWorktrees, performMerge, removeBranch, removeWorktree, simulateMerge, verifyGitVersion } from "../git-utils-CtmrZrHS.js";
@@ -2842,7 +2842,7 @@ async function runSupervisorAction(options, deps = {}) {
 								const expDb = expDbWrapper.db;
 								const { runRunAction: runPipeline } = await import(
 									/* @vite-ignore */
-									"../run-DoxsPIlD.js"
+									"../run-BXKRGSeL.js"
 );
 								const runStoryFn = async (opts) => {
 									const exitCode = await runPipeline({

package/dist/{event-bus-CAvDMst7.js → helpers-DljGJnFF.js}

@@ -1,5 +1,6 @@
 import * as readline from "node:readline";
 import { EventEmitter } from "node:events";
+import { randomUUID } from "crypto";
 
 //#region src/tui/ansi.ts
 /**
@@ -730,5 +731,81 @@ function createEventBus() {
 }
 
 //#endregion
-export { createEventBus, createTuiApp, isTuiCapable, printNonTtyWarning };
-//# sourceMappingURL=event-bus-CAvDMst7.js.map
+//#region src/utils/helpers.ts
+/**
+* Sleep for a given number of milliseconds
+* @param ms - Milliseconds to sleep
+*/
+function sleep(ms) {
+	return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+* Assert that a value is defined (not null or undefined)
+* @param value - Value to check
+* @param message - Error message if undefined
+*/
+function assertDefined(value, message) {
+	if (value === null || value === void 0) throw new Error(message);
+}
+/**
+* Format a duration in milliseconds to a human-readable string
+* @param ms - Duration in milliseconds
+*/
+function formatDuration(ms) {
+	if (ms < 1e3) return `${String(ms)}ms`;
+	if (ms < 6e4) return `${(ms / 1e3).toFixed(1)}s`;
+	if (ms < 36e5) {
+		const minutes$1 = Math.floor(ms / 6e4);
+		const seconds = Math.floor(ms % 6e4 / 1e3);
+		return `${String(minutes$1)}m ${String(seconds)}s`;
+	}
+	const hours = Math.floor(ms / 36e5);
+	const minutes = Math.floor(ms % 36e5 / 6e4);
+	return `${String(hours)}h ${String(minutes)}m`;
+}
+/**
+* Generate a unique identifier using crypto.randomUUID()
+* @param prefix - Optional prefix for the ID
+*/
+function generateId(prefix = "") {
+	const uuid = randomUUID();
+	return prefix ? `${prefix}-${uuid}` : uuid;
+}
+/**
+* Deep clone an object using structuredClone.
+* Supports most built-in types (Date, Map, Set, ArrayBuffer, etc.)
+* but does NOT support functions, DOM nodes, or symbols as keys.
+* @param obj - Object to clone
+*/
+function deepClone(obj) {
+	return structuredClone(obj);
+}
+/**
+* Check if a value is a plain object (not an array, Date, or other special object)
+* @param value - Value to check
+*/
+function isPlainObject(value) {
+	if (typeof value !== "object" || value === null || Array.isArray(value)) return false;
+	const proto = Object.getPrototypeOf(value);
+	return proto === Object.prototype || proto === null;
+}
+/**
+* Retry an async operation with exponential backoff
+* @param fn - Async function to retry
+* @param maxRetries - Maximum number of retries
+* @param baseDelayMs - Base delay in milliseconds (doubles each retry)
+*/
+async function withRetry(fn, maxRetries = 3, baseDelayMs = 100) {
+	let lastError;
+	for (let attempt = 0; attempt <= maxRetries; attempt++) try {
+		return await fn();
+	} catch (error) {
+		lastError = error instanceof Error ? error : new Error(String(error));
+		if (attempt < maxRetries) await sleep(baseDelayMs * Math.pow(2, attempt));
+	}
+	throw lastError ?? new Error("Operation failed after retries");
+}
+
+//#endregion
+export { assertDefined, createEventBus, createTuiApp, deepClone, formatDuration, generateId, isPlainObject, isTuiCapable, printNonTtyWarning, sleep, withRetry };
+//# sourceMappingURL=helpers-DljGJnFF.js.map

package/dist/index.d.ts

@@ -172,6 +172,44 @@ 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 for non-fatal warnings during pipeline execution
  * (e.g., token ceiling truncation, partial batch failures).
@@ -230,6 +268,10 @@ interface StoryStallEvent {
   phase: string;
   /** Milliseconds since the last progress event */
   elapsed_ms: number;
+  /** PIDs of child processes at time of stall detection */
+  child_pids: number[];
+  /** Whether any child process was actively running (not zombie) */
+  child_active: boolean;
 }
 /**
  * Emitted after each `getHealth()` call in the supervisor poll loop.
@@ -428,7 +470,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 | SupervisorPollEvent | SupervisorKillEvent | SupervisorRestartEvent | SupervisorAbortEvent | SupervisorSummaryEvent | SupervisorAnalysisCompleteEvent | SupervisorAnalysisErrorEvent | SupervisorExperimentStartEvent | SupervisorExperimentSkipEvent | SupervisorExperimentRecommendationsEvent | SupervisorExperimentCompleteEvent | SupervisorExperimentErrorEvent; //#endregion
 //#region src/core/errors.d.ts
 
 /**
@@ -1014,6 +1056,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;
@@ -1038,8 +1085,10 @@ interface OrchestratorEvents {
     storyKey: string;
     phase: string;
     elapsedMs: number;
-    /** PID of the stalled child process, or null if not tracked */
-    childPid: number | null;
+    /** PIDs of child processes at time of stall detection */
+    childPids: number[];
+    /** Whether any child process was actively running (not zombie) */
+    childActive: boolean;
   };
   /** Readiness check has completed — emitted for all verdicts (READY, NEEDS_WORK, NOT_READY) */
   'solutioning:readiness-check': {
@@ -1061,6 +1110,17 @@ 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;
+  };
 }
 
 //#endregion

package/dist/index.js

@@ -1,84 +1,7 @@
 import { childLogger, createLogger, logger } from "./logger-D2fS2ccL.js";
 import { AdapterRegistry, AdtError, BudgetExceededError, ClaudeCodeAdapter, CodexCLIAdapter, ConfigError, ConfigIncompatibleFormatError, GeminiCLIAdapter, GitError, RecoveryError, TaskConfigError, TaskGraphCycleError, TaskGraphError, TaskGraphIncompatibleFormatError, WorkerError, WorkerNotFoundError } from "./errors-CswS7Mzg.js";
-import { createEventBus, createTuiApp, isTuiCapable, printNonTtyWarning } from "./event-bus-CAvDMst7.js";
-import { randomUUID } from "crypto";
+import { assertDefined, createEventBus, createTuiApp, deepClone, formatDuration, generateId, isPlainObject, isTuiCapable, printNonTtyWarning, sleep, withRetry } from "./helpers-DljGJnFF.js";
 
-//#region src/utils/helpers.ts
-/**
-* Sleep for a given number of milliseconds
-* @param ms - Milliseconds to sleep
-*/
-function sleep(ms) {
-	return new Promise((resolve) => setTimeout(resolve, ms));
-}
-/**
-* Assert that a value is defined (not null or undefined)
-* @param value - Value to check
-* @param message - Error message if undefined
-*/
-function assertDefined(value, message) {
-	if (value === null || value === void 0) throw new Error(message);
-}
-/**
-* Format a duration in milliseconds to a human-readable string
-* @param ms - Duration in milliseconds
-*/
-function formatDuration(ms) {
-	if (ms < 1e3) return `${String(ms)}ms`;
-	if (ms < 6e4) return `${(ms / 1e3).toFixed(1)}s`;
-	if (ms < 36e5) {
-		const minutes$1 = Math.floor(ms / 6e4);
-		const seconds = Math.floor(ms % 6e4 / 1e3);
-		return `${String(minutes$1)}m ${String(seconds)}s`;
-	}
-	const hours = Math.floor(ms / 36e5);
-	const minutes = Math.floor(ms % 36e5 / 6e4);
-	return `${String(hours)}h ${String(minutes)}m`;
-}
-/**
-* Generate a unique identifier using crypto.randomUUID()
-* @param prefix - Optional prefix for the ID
-*/
-function generateId(prefix = "") {
-	const uuid = randomUUID();
-	return prefix ? `${prefix}-${uuid}` : uuid;
-}
-/**
-* Deep clone an object using structuredClone.
-* Supports most built-in types (Date, Map, Set, ArrayBuffer, etc.)
-* but does NOT support functions, DOM nodes, or symbols as keys.
-* @param obj - Object to clone
-*/
-function deepClone(obj) {
-	return structuredClone(obj);
-}
-/**
-* Check if a value is a plain object (not an array, Date, or other special object)
-* @param value - Value to check
-*/
-function isPlainObject(value) {
-	if (typeof value !== "object" || value === null || Array.isArray(value)) return false;
-	const proto = Object.getPrototypeOf(value);
-	return proto === Object.prototype || proto === null;
-}
-/**
-* Retry an async operation with exponential backoff
-* @param fn - Async function to retry
-* @param maxRetries - Maximum number of retries
-* @param baseDelayMs - Base delay in milliseconds (doubles each retry)
-*/
-async function withRetry(fn, maxRetries = 3, baseDelayMs = 100) {
-	let lastError;
-	for (let attempt = 0; attempt <= maxRetries; attempt++) try {
-		return await fn();
-	} catch (error) {
-		lastError = error instanceof Error ? error : new Error(String(error));
-		if (attempt < maxRetries) await sleep(baseDelayMs * Math.pow(2, attempt));
-	}
-	throw lastError ?? new Error("Operation failed after retries");
-}
-
-//#endregion
 //#region src/core/di.ts
 /**
 * Simple service registry — stores named service instances for DI resolution.

package/dist/run-BXKRGSeL.js

@@ -0,0 +1,7 @@
+import { registerRunCommand, runRunAction } from "./run-CEtHPG4I.js";
+import "./logger-D2fS2ccL.js";
+import "./helpers-DljGJnFF.js";
+import "./decisions-Dq4cAA2L.js";
+import "./operational-CnMlvWqc.js";
+
+export { runRunAction };