substrate-ai 0.2.3 → 0.2.5

package/dist/decisions-DKXc-jnv.js

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

package/dist/{decisions-BBLMsN_c.js → decisions-DNYByk0U.js}

@@ -213,6 +213,28 @@ function createRequirement(db, input) {
 	return row;
 }
 /**
+* List requirements with optional filtering by type, priority, and status.
+*/
+function listRequirements(db, filters) {
+	const conditions = [];
+	const values = [];
+	if (filters?.type !== void 0) {
+		conditions.push("type = ?");
+		values.push(filters.type);
+	}
+	if (filters?.priority !== void 0) {
+		conditions.push("priority = ?");
+		values.push(filters.priority);
+	}
+	if (filters?.status !== void 0) {
+		conditions.push("status = ?");
+		values.push(filters.status);
+	}
+	const where = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
+	const stmt = db.prepare(`SELECT * FROM requirements ${where} ORDER BY created_at ASC`);
+	return stmt.all(...values);
+}
+/**
 * Register a new artifact record.
 */
 function registerArtifact(db, input) {
@@ -332,5 +354,5 @@ function getTokenUsageSummary(db, runId) {
 }
 
 //#endregion
-export { addTokenUsage, createDecision, createPipelineRun, createRequirement, getArtifactByTypeForRun, getArtifactsByRun, getDecisionsByPhase, getDecisionsByPhaseForRun, getLatestRun, getPipelineRunById, getTokenUsageSummary, registerArtifact, updateDecision, updatePipelineRun, updatePipelineRunConfig, upsertDecision };
-//# sourceMappingURL=decisions-BBLMsN_c.js.map
+export { addTokenUsage, createDecision, createPipelineRun, createRequirement, getArtifactByTypeForRun, getArtifactsByRun, getDecisionsByPhase, getDecisionsByPhaseForRun, getLatestRun, getPipelineRunById, getTokenUsageSummary, listRequirements, registerArtifact, updateDecision, updatePipelineRun, updatePipelineRunConfig, upsertDecision };
+//# sourceMappingURL=decisions-DNYByk0U.js.map

package/dist/index.d.ts

@@ -231,6 +231,45 @@ interface StoryStallEvent {
   /** Milliseconds since the last progress event */
   elapsed_ms: number;
 }
+/**
+ * Emitted after each `getHealth()` call in the supervisor poll loop.
+ * Allows agents to observe health state, story progress, and token costs
+ * on every cycle without needing a separate health query.
+ */
+interface SupervisorPollEvent {
+  type: 'supervisor:poll';
+  /** ISO-8601 timestamp generated at emit time */
+  ts: string;
+  /** Current pipeline run ID, or null if no run is active */
+  run_id: string | null;
+  /** Health verdict from the most recent getHealth() call */
+  verdict: 'HEALTHY' | 'STALLED' | 'NO_PIPELINE_RUNNING';
+  /** Seconds since the last pipeline activity */
+  staleness_seconds: number;
+  /** Story counts from the health snapshot */
+  stories: {
+    active: number;
+    completed: number;
+    escalated: number;
+  };
+  /** Per-story phase and review cycle details */
+  story_details: Record<string, {
+    phase: string;
+    review_cycles: number;
+  }>;
+  /** Cumulative token/cost snapshot for the current run */
+  tokens: {
+    input: number;
+    output: number;
+    cost_usd: number;
+  };
+  /** Process health from the health snapshot */
+  process: {
+    orchestrator_pid: number | null;
+    child_count: number;
+    zombie_count: number;
+  };
+}
 /**
  * Emitted when the supervisor kills a stalled pipeline process tree.
  */
@@ -389,7 +428,7 @@ interface SupervisorExperimentErrorEvent {
  * }
  * ```
  */
-type PipelineEvent = PipelineStartEvent | PipelineCompleteEvent | StoryPhaseEvent | StoryDoneEvent | StoryEscalationEvent | StoryWarnEvent | StoryLogEvent | PipelineHeartbeatEvent | StoryStallEvent | SupervisorKillEvent | SupervisorRestartEvent | SupervisorAbortEvent | SupervisorSummaryEvent | SupervisorAnalysisCompleteEvent | SupervisorAnalysisErrorEvent | SupervisorExperimentStartEvent | SupervisorExperimentSkipEvent | SupervisorExperimentRecommendationsEvent | SupervisorExperimentCompleteEvent | SupervisorExperimentErrorEvent; //#endregion
+type PipelineEvent = PipelineStartEvent | PipelineCompleteEvent | StoryPhaseEvent | StoryDoneEvent | StoryEscalationEvent | StoryWarnEvent | StoryLogEvent | PipelineHeartbeatEvent | StoryStallEvent | SupervisorPollEvent | SupervisorKillEvent | SupervisorRestartEvent | SupervisorAbortEvent | SupervisorSummaryEvent | SupervisorAnalysisCompleteEvent | SupervisorAnalysisErrorEvent | SupervisorExperimentStartEvent | SupervisorExperimentSkipEvent | SupervisorExperimentRecommendationsEvent | SupervisorExperimentCompleteEvent | SupervisorExperimentErrorEvent; //#endregion
 //#region src/core/errors.d.ts
 
 /**

package/dist/{run-DlOWhkIF.js → run-CDYE1PT3.js}

@@ -1,6 +1,6 @@
 import { createLogger } from "./logger-C6n1g8uP.js";
 import { AdapterRegistry, createEventBus, createTuiApp, isTuiCapable, printNonTtyWarning } from "./event-bus-J-bw-pkp.js";
-import { addTokenUsage, createDecision, createPipelineRun, createRequirement, getArtifactByTypeForRun, getArtifactsByRun, getDecisionsByPhase, getDecisionsByPhaseForRun, getPipelineRunById, getTokenUsageSummary, registerArtifact, updatePipelineRun, updatePipelineRunConfig, upsertDecision } from "./decisions-BBLMsN_c.js";
+import { addTokenUsage, createDecision, createPipelineRun, createRequirement, getArtifactByTypeForRun, getArtifactsByRun, getDecisionsByPhase, getDecisionsByPhaseForRun, getPipelineRunById, getTokenUsageSummary, registerArtifact, updatePipelineRun, updatePipelineRunConfig, upsertDecision } from "./decisions-DNYByk0U.js";
 import { aggregateTokenUsageForRun, aggregateTokenUsageForStory, getStoryMetricsForRun, writeRunMetrics, writeStoryMetrics } from "./metrics-BSg8VIHd.js";
 import { dirname, join } from "path";
 import { access, readFile, readdir, stat } from "fs/promises";
@@ -1024,6 +1024,21 @@ function validateStopAfterFromConflict(stopAfter, from) {
 
 //#endregion
 //#region src/cli/commands/pipeline-shared.ts
+/**
+* Parse a DB timestamp string to a Date, correctly treating it as UTC.
+*
+* SQLite stores timestamps as "YYYY-MM-DD HH:MM:SS" without a timezone suffix.
+* JavaScript's Date constructor parses strings without a timezone suffix as
+* *local time*, which causes staleness/duration to be calculated incorrectly
+* on machines not in UTC.
+*
+* Fix: append 'Z' if the string has no timezone marker so it is always
+* parsed as UTC.
+*/
+function parseDbTimestampAsUtc(ts) {
+	if (ts.endsWith("Z") || /[+-]\d{2}:\d{2}$/.test(ts)) return new Date(ts);
+	return new Date(ts.replace(" ", "T") + "Z");
+}
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 /**
@@ -1197,7 +1212,7 @@ function buildPipelineStatusOutput(run, tokenSummary, decisionsCount, storiesCou
 		decisions_count: decisionsCount,
 		stories_count: storiesCount,
 		last_activity: run.updated_at,
-		staleness_seconds: Math.round((Date.now() - new Date(run.updated_at).getTime()) / 1e3)
+		staleness_seconds: Math.round((Date.now() - parseDbTimestampAsUtc(run.updated_at).getTime()) / 1e3)
 	};
 }
 /**
@@ -1817,6 +1832,53 @@ const PIPELINE_EVENT_METADATA = [
 			}
 		]
 	},
+	{
+		type: "supervisor:poll",
+		description: "Heartbeat each poll (JSON only).",
+		when: "Per cycle.",
+		fields: [
+			{
+				name: "ts",
+				type: "string",
+				description: "Timestamp."
+			},
+			{
+				name: "run_id",
+				type: "string|null",
+				description: "Run ID."
+			},
+			{
+				name: "verdict",
+				type: "HEALTHY|STALLED|NO_PIPELINE_RUNNING",
+				description: "Verdict."
+			},
+			{
+				name: "staleness_seconds",
+				type: "number",
+				description: "Seconds stale."
+			},
+			{
+				name: "stories",
+				type: "object",
+				description: "active/completed/escalated."
+			},
+			{
+				name: "story_details",
+				type: "object",
+				description: "phase+cycles per story."
+			},
+			{
+				name: "tokens",
+				type: "object",
+				description: "input/output/cost_usd."
+			},
+			{
+				name: "process",
+				type: "object",
+				description: "pid/child/zombie counts."
+			}
+		]
+	},
 	{
 		type: "supervisor:kill",
 		description: "Supervisor killed stalled pipeline process tree.",
@@ -2238,42 +2300,34 @@ function generateInteractionPatternsSection() {
 Use this decision flowchart when handling events from \`substrate run --events\`:
 
 ### On \`story:done\` with \`result: success\`
-- Report successful completion to the user.
-- Note the story key and number of review_cycles for telemetry.
+- Report success to the user.
 
 ### On \`story:done\` with \`result: failed\`
-- Report failure to the user with the story key.
-- Suggest checking logs or running \`substrate status\` for details.
+- Report failure with the story key.
 
 ### On \`story:escalation\`
-- Read the \`issues\` array. Each issue has \`severity\`, \`file\` (path:line), and \`desc\`.
-- Present the issues to the user grouped by severity.
-- Offer to fix the issues or explain them.
-- Ask the user whether to retry or abandon the story.
+- Read \`issues\`: each has \`severity\`, \`file\`, \`desc\`.
+- Present grouped by severity; ask user to retry or abandon.
 
 ### On \`story:phase\` with \`verdict: NEEDS_MINOR_FIXES\`
-- The story passed code review but has minor suggestions.
-- Offer to apply the fixes or skip.
-- This is non-blocking — pipeline continues unless you intervene.
+- Non-blocking minor suggestions. Offer to apply or skip.
 
 ### On \`story:warn\`
-- Inform the user of the warning message but do NOT treat it as an error.
-- Common warnings: token ceiling truncation, partial batch failures.
-- Pipeline continues normally after a warn event.
+- Non-blocking warning; pipeline continues normally.
 
 ### On \`story:log\`
-- These are informational only.
-- Display if verbose mode is active; otherwise buffer or discard.
+- Informational only. Display in verbose mode.
 
 ### On \`pipeline:complete\`
-- Summarize results: report \`succeeded.length\` successes.
-- List any \`failed\` or \`escalated\` stories with reasons if available.
-- This is always the last event emitted.
+- Summarize \`succeeded\`, \`failed\`, \`escalated\` counts.
 
 ## Supervisor Interaction Patterns
 
 Patterns for \`substrate supervisor --output-format json\` events:
 
+### On \`supervisor:poll\`
+- Track \`verdict\` and \`tokens.cost_usd\` each cycle. JSON only.
+
 ### On \`supervisor:summary\`
 - Summarize \`succeeded\`, \`failed\`, \`escalated\` counts and \`restarts\`.
 - Offer analysis: \`substrate metrics --analysis <run_id> --output-format json\`.
@@ -10318,7 +10372,7 @@ async function runRunAction(options) {
 		else failedKeys.push(key);
 		try {
 			const runEndMs = Date.now();
-			const runStartMs = new Date(pipelineRun.created_at).getTime();
+			const runStartMs = parseDbTimestampAsUtc(pipelineRun.created_at).getTime();
 			const tokenAgg = aggregateTokenUsageForRun(db, pipelineRun.id);
 			const storyMetrics = getStoryMetricsForRun(db, pipelineRun.id);
 			const totalReviewCycles = storyMetrics.reduce((sum, m) => sum + (m.review_cycles ?? 0), 0);
@@ -10721,5 +10775,5 @@ function registerRunCommand(program, _version = "0.0.0", projectRoot = process.c
 }
 
 //#endregion
-export { DatabaseWrapper, SUBSTRATE_OWNED_SETTINGS_KEYS, VALID_PHASES, buildPipelineStatusOutput, createContextCompiler, createDispatcher, createImplementationOrchestrator, createPackLoader, createPhaseOrchestrator, createStopAfterGate, findPackageRoot, formatOutput, formatPhaseCompletionSummary, formatPipelineStatusHuman, formatPipelineSummary, formatTokenTelemetry, getSubstrateDefaultSettings, registerRunCommand, resolveBmadMethodSrcPath, resolveBmadMethodVersion, resolveMainRepoRoot, runAnalysisPhase, runMigrations, runPlanningPhase, runRunAction, runSolutioningPhase, validateStopAfterFromConflict };
-//# sourceMappingURL=run-DlOWhkIF.js.map
+export { DatabaseWrapper, SUBSTRATE_OWNED_SETTINGS_KEYS, VALID_PHASES, buildPipelineStatusOutput, createContextCompiler, createDispatcher, createImplementationOrchestrator, createPackLoader, createPhaseOrchestrator, createStopAfterGate, findPackageRoot, formatOutput, formatPhaseCompletionSummary, formatPipelineStatusHuman, formatPipelineSummary, formatTokenTelemetry, getSubstrateDefaultSettings, parseDbTimestampAsUtc, registerRunCommand, resolveBmadMethodSrcPath, resolveBmadMethodVersion, resolveMainRepoRoot, runAnalysisPhase, runMigrations, runPlanningPhase, runRunAction, runSolutioningPhase, validateStopAfterFromConflict };
+//# sourceMappingURL=run-CDYE1PT3.js.map

package/dist/run-XkrV99HV.js

@@ -0,0 +1,7 @@
+import "./logger-C6n1g8uP.js";
+import "./event-bus-J-bw-pkp.js";
+import { registerRunCommand, runRunAction } from "./run-CDYE1PT3.js";
+import "./decisions-DNYByk0U.js";
+import "./metrics-BSg8VIHd.js";
+
+export { runRunAction };

package/package.json

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

package/dist/decisions-WIsicZiG.js

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

package/dist/run-CRmhkcwN.js

@@ -1,7 +0,0 @@
-import "./logger-C6n1g8uP.js";
-import "./event-bus-J-bw-pkp.js";
-import { registerRunCommand, runRunAction } from "./run-DlOWhkIF.js";
-import "./decisions-BBLMsN_c.js";
-import "./metrics-BSg8VIHd.js";
-
-export { runRunAction };