@runa-ai/runa-cli 0.7.0 → 0.7.2

package/dist/commands/ci/machine/contract.d.ts

@@ -48,6 +48,7 @@ export declare const RepoKindSchema: z.ZodEnum<{
 }>;
 export type RepoKind = z.infer<typeof RepoKindSchema>;
 export declare const StepStatusSchema: z.ZodEnum<{
+    killed: "killed";
     timeout: "timeout";
     skipped: "skipped";
     failed: "failed";
@@ -116,6 +117,9 @@ export declare const CiInputSchema: z.ZodObject<{
     branchName: z.ZodOptional<z.ZodString>;
     skipStaticChecks: z.ZodOptional<z.ZodBoolean>;
     skipBuild: z.ZodOptional<z.ZodBoolean>;
+    skipLocalDbStart: z.ZodOptional<z.ZodBoolean>;
+    assumeSupabaseReady: z.ZodOptional<z.ZodBoolean>;
+    skipPlaywrightInstall: z.ZodOptional<z.ZodBoolean>;
     skipDbCodegen: z.ZodOptional<z.ZodBoolean>;
     failFast: z.ZodOptional<z.ZodString>;
     maxWaitSeconds: z.ZodOptional<z.ZodString>;
@@ -173,6 +177,8 @@ export type DbSetupResult = z.infer<typeof DbSetupResultSchema>;
  */
 export declare const RolesSetupResultSchema: z.ZodObject<{
     passed: z.ZodBoolean;
+    skipped: z.ZodOptional<z.ZodBoolean>;
+    skipReason: z.ZodOptional<z.ZodString>;
     appDatabaseUrl: z.ZodOptional<z.ZodString>;
     error: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
@@ -266,6 +272,7 @@ export type FinalizeResult = z.infer<typeof FinalizeResultSchema>;
  */
 export declare const StepSummarySchema: z.ZodObject<{
     status: z.ZodEnum<{
+        killed: "killed";
         timeout: "timeout";
         skipped: "skipped";
         failed: "failed";
@@ -274,6 +281,22 @@ export declare const StepSummarySchema: z.ZodObject<{
     exitCode: z.ZodOptional<z.ZodNumber>;
     logPath: z.ZodOptional<z.ZodString>;
     error: z.ZodOptional<z.ZodString>;
+    reason: z.ZodOptional<z.ZodString>;
+    title: z.ZodOptional<z.ZodString>;
+    phase: z.ZodOptional<z.ZodEnum<{
+        db: "db";
+        test: "test";
+        build: "build";
+        setup: "setup";
+        github: "github";
+        observability: "observability";
+        finalize: "finalize";
+    }>>;
+    parentStep: z.ZodOptional<z.ZodString>;
+    optional: z.ZodOptional<z.ZodBoolean>;
+    startedAt: z.ZodOptional<z.ZodString>;
+    endedAt: z.ZodOptional<z.ZodString>;
+    durationMs: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 export type StepSummary = z.infer<typeof StepSummarySchema>;
 /**
@@ -322,6 +345,7 @@ export declare const CiOutputSchema: z.ZodObject<{
     }>;
     steps: z.ZodRecord<z.ZodString, z.ZodObject<{
         status: z.ZodEnum<{
+            killed: "killed";
             timeout: "timeout";
             skipped: "skipped";
             failed: "failed";
@@ -330,6 +354,22 @@ export declare const CiOutputSchema: z.ZodObject<{
         exitCode: z.ZodOptional<z.ZodNumber>;
         logPath: z.ZodOptional<z.ZodString>;
         error: z.ZodOptional<z.ZodString>;
+        reason: z.ZodOptional<z.ZodString>;
+        title: z.ZodOptional<z.ZodString>;
+        phase: z.ZodOptional<z.ZodEnum<{
+            db: "db";
+            test: "test";
+            build: "build";
+            setup: "setup";
+            github: "github";
+            observability: "observability";
+            finalize: "finalize";
+        }>>;
+        parentStep: z.ZodOptional<z.ZodString>;
+        optional: z.ZodOptional<z.ZodBoolean>;
+        startedAt: z.ZodOptional<z.ZodString>;
+        endedAt: z.ZodOptional<z.ZodString>;
+        durationMs: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>>;
     layers: z.ZodRecord<z.ZodCoercedNumber<unknown>, z.ZodObject<{
         status: z.ZodEnum<{

package/dist/commands/ci/machine/formatters/github-comment-types.d.ts

@@ -5,11 +5,11 @@
  * Extracted from: github-comment.ts for better code organization
  */
 import type { ExpectedDriftEntry } from '../actors/db/schema-stats.js';
-import type { LayerResult, PrContext, ProductionPreview, SchemaDriftSnapshot, SchemaStatsSnapshot, SupabaseConnection } from '../types.js';
+import type { CiPhase, LayerResult, PrContext, ProductionPreview, SchemaDriftSnapshot, SchemaStatsSnapshot, SupabaseConnection } from '../types.js';
 /**
  * CI step definition for progress tracking.
  */
-export type CiStep = 'setup' | 'syncSchema' | 'applySeeds' | 'staticChecks' | 'build' | 'runTests' | 'finalize';
+export type CiStep = 'setup' | 'syncSchema' | 'applySeeds' | 'postSeedChecks' | 'observability' | 'staticChecks' | 'build' | 'runTests' | 'finalize';
 /**
  * Step status for progress display.
  */
@@ -27,6 +27,7 @@ export interface StepInfo {
  */
 export type StepTimings = Partial<Record<CiStep, number>>;
 export interface CommentInput {
+    phase: CiPhase;
     exitCode: 0 | 1 | 2;
     branchName: string | null;
     prContext: PrContext | null;
@@ -50,9 +51,11 @@ export interface CommentInput {
  * Input for progress comment generation.
  */
 export interface ProgressCommentInput {
+    phase: CiPhase;
     currentStep: CiStep;
     completedSteps: CiStep[];
     failedStep: CiStep | null;
+    skippedSteps?: CiStep[];
     branchName: string | null;
     prContext: PrContext | null;
     supabase: SupabaseConnection | null;
@@ -87,4 +90,6 @@ export declare const CI_STEPS: Array<{
  * Blocking layers for DB deploy (0-3).
  */
 export declare const BLOCKING_LAYERS: number[];
+export declare const CI_OBSERVABILITY_SECTION_START_MARKER = "<!-- runa-ci-observability:start -->";
+export declare const CI_OBSERVABILITY_SECTION_END_MARKER = "<!-- runa-ci-observability:end -->";
 //# sourceMappingURL=github-comment-types.d.ts.map

package/dist/commands/ci/machine/formatters/github-comment.d.ts

@@ -18,7 +18,8 @@
 import type { CiContext } from '../types.js';
 import type { CiStep, CommentInput, ProgressCommentInput, StepTimings } from './github-comment-types.js';
 export type { CiStep, ProgressCommentInput, StepInfo, StepStatus, StepTimings, } from './github-comment-types.js';
-export { generateCommentBody, generateProgressCommentBody, getGitHubEnv, } from './sections/index.js';
+export { CI_OBSERVABILITY_SECTION_END_MARKER, CI_OBSERVABILITY_SECTION_START_MARKER, } from './github-comment-types.js';
+export { generateCommentBody, generateObservabilitySectionBody, generateProgressCommentBody, getGitHubEnv, } from './sections/index.js';
 /**
  * Options for intermediate comment generation.
  */

package/dist/commands/ci/machine/formatters/sections/final-comment.d.ts

@@ -6,7 +6,8 @@
  *
  * Usage: Called by upsertComment actor at CI completion
  */
-import type { CommentInput } from '../github-comment-types.js';
+import { type CommentInput } from '../github-comment-types.js';
+export declare function generateObservabilitySectionBody(input: CommentInput): string;
 /**
  * Generate GitHub PR comment body from CI context (final result or intermediate).
  */

package/dist/commands/ci/machine/formatters/sections/index.d.ts

@@ -3,7 +3,7 @@
  *
  * Purpose: Export all section generators for GitHub PR comments
  */
-export { generateCommentBody } from './final-comment.js';
+export { generateCommentBody, generateObservabilitySectionBody } from './final-comment.js';
 export { BLOCKING_LAYERS, checkBlockingLayersPassed, formatDuration, formatGitDiffDetails, formatLayerResults, formatSingleLayer, formatSqlDetails, getGitHubEnv, getStatusIcon, } from './format-helpers.js';
 export { generateProgressCommentBody } from './progress-comment.js';
 export { formatSchemaMatrix } from './schema-matrix.js';

package/dist/commands/ci/machine/formatters/sections/production-schema-status.d.ts

@@ -0,0 +1,30 @@
+import { type ExpectedDriftEntry, type IndexDiff, type SchemaStats, type SchemaStatsSnapshot } from '../../actors/db/schema-stats.js';
+import { type CanonicalSchemaDiff } from '../../actors/db/schema-canonical-diff.js';
+import type { ProductionPreview } from '../../types.js';
+export interface ProductionSchemaSignals {
+    previewHasChanges: boolean;
+    indexDiff: IndexDiff | null;
+    semanticDiff: CanonicalSchemaDiff | null;
+    countDiffs: CountDiffEntry[];
+    hasIndexChanges: boolean;
+    hasUnexpectedIndexChanges: boolean;
+    hasSemanticChanges: boolean;
+    hasCountChanges: boolean;
+    hasUnexpectedCountChanges: boolean;
+    hasKnownDriftOnly: boolean;
+    knownDriftReasons: string[];
+    requiresDeploy: boolean;
+    previewMissedChanges: boolean;
+    previewOnlyChanges: boolean;
+}
+export interface CountDiffEntry {
+    schema: string;
+    field: keyof SchemaStats;
+    value: number;
+    reference: number;
+    delta: number;
+    expected: boolean;
+    reason?: string;
+}
+export declare function getProductionSchemaSignals(productionPreview: ProductionPreview | null, schemaStats: SchemaStatsSnapshot | null, expectedDrift?: ExpectedDriftEntry[]): ProductionSchemaSignals;
+//# sourceMappingURL=production-schema-status.d.ts.map

package/dist/commands/ci/machine/formatters/summary.d.ts

@@ -5,15 +5,15 @@
  * Pattern: Pure function - takes context data, returns structured summary
  *
  * Usage:
- * - Called by writeSummary actor in finalize state
- * - Generates structured summary for CI result artifacts
+ * - Called by machine finalization to prepare CI result artifacts
+ * - Generates structured summary before runner-level persistence
  *
  * blockingPolicy:
  * - Computed from layer results + runa-strict classification
  * - dbDeployAllowed: true if all blocking layers (0-3) passed
  * - Used by /deploy-db workflow to gate production DB deploys
  */
-import type { CiSummary } from '../actors/finalize/summary.js';
+import type { CiSummary } from '../../utils/ci-summary.js';
 import type { CiContext } from '../types.js';
 export interface WriteSummaryInput {
     cwd: string;
@@ -21,7 +21,7 @@ export interface WriteSummaryInput {
 }
 /**
  * Create summary input from CI context.
- * Use this in machine.ts to generate the writeSummary actor input.
+ * Use this in machine.ts / runner completion to build the final summary payload.
  */
 export declare function createSummaryInput(context: CiContext): WriteSummaryInput;
 //# sourceMappingURL=summary.d.ts.map

package/dist/commands/ci/machine/guards.d.ts

@@ -91,6 +91,10 @@ export declare function shouldSetupRoles(context: CiContext): boolean;
  * Check if GitHub comment should be posted.
  */
 export declare function shouldPostGitHubComment(context: CiContext): boolean;
+/**
+ * Check if ci-pr is running in test-only phase.
+ */
+export declare function isTestPhase(context: CiContext): boolean;
 /**
  * Check if context has an error.
  */

package/dist/commands/ci/machine/helpers.d.ts

@@ -15,6 +15,11 @@ import type { CiContext } from './types.js';
 export declare const CORE_LAYERS: readonly [1, 2, 3];
 /** E2E layer (warning): 4 */
 export declare const E2E_LAYER = 4;
+export type ExecutionOwner = 'sdk' | 'external';
+type OwnershipContext = {
+    input: Pick<CiContext['input'], 'skipLocalDbStart' | 'assumeSupabaseReady' | 'skipPlaywrightInstall'>;
+    diagnostics: Pick<CiContext['diagnostics'], 'setup'>;
+};
 /**
  * Get layers to run in the core test phase.
  *
@@ -29,6 +34,33 @@ export declare function getLayersForCorePhase(selectedLayers: number[], mode: st
  * Check if E2E layer (4) is selected.
  */
 export declare function hasE2ELayer(selectedLayers: number[]): boolean;
+export declare function getRuntimeOwner(context: OwnershipContext): ExecutionOwner;
+export declare function shouldReusePreparedRuntime(context: OwnershipContext): boolean;
+export declare function getPlaywrightOwner(context: OwnershipContext): ExecutionOwner;
+export declare function shouldReusePreparedPlaywright(context: OwnershipContext): boolean;
+/**
+ * Check whether the current run includes schema file changes.
+ *
+ * This relies on syncSchema actor's git diff snapshot, which compares
+ * `supabase/schemas/**` against the PR base branch.
+ */
+export declare function hasSchemaGitChanges(context: CiContext): boolean;
+/**
+ * Skip the expensive post-apply check in GitHub Actions PR preview runs.
+ *
+ * Preview CI always starts from a fresh local Supabase instance on an ephemeral
+ * runner, so re-running `db apply --check` immediately after a successful apply
+ * does not add meaningful signal on the critical path.
+ */
+export declare function shouldSkipSchemaPostCheck(context: CiContext): boolean;
+/**
+ * Determine whether schema stats can safely reuse the synced CI database
+ * instead of rebuilding a temporary reference database.
+ *
+ * This optimization is only valid for PR CI runs where local-only overlays
+ * such as ci.custom.sql are never applied.
+ */
+export declare function shouldReuseCiReferenceStats(context: CiContext): boolean;
 /** Layer result status type */
 export type LayerStatus = 'passed' | 'failed' | 'skipped' | 'timeout' | 'killed';
 /**
@@ -115,4 +147,5 @@ export declare function computeExitCodeFromLayerResults(layerResults: Record<num
     status: string;
     exitCode: number;
 }>): 0 | 1 | 2;
+export {};
 //# sourceMappingURL=helpers.d.ts.map

package/dist/commands/ci/machine/machine-state-helpers.d.ts

@@ -1,7 +1,7 @@
 import type { LayerContentResult } from '../commands/ci-layer-content.js';
 import type { UpsertCommentInput } from './actors/finalize/github.js';
-import type { WriteSummaryInput } from './actors/finalize/summary.js';
 import type { RunLayersInput } from './actors/test/run-layers.js';
+import { type WriteSummaryInput } from './formatters/summary.js';
 import type { CiContext } from './types.js';
 export declare const CI_COMMENT_MARKER = "<!-- runa-ci-report -->";
 export declare function filterRunnableLayers(selectedLayers: number[], layerContent: LayerContentResult | null | undefined): number[];

package/dist/commands/ci/machine/machine.d.ts

@@ -8,9 +8,10 @@
  * 1. idle → START → setup (mode-aware: localSetup or prLocalSetup)
  * 2. [ci-local] setup → dbReset → pullProduction? → syncSchema → applySeeds
  *              → productionPreview → collectSchemaStats → installPgTap → runCoreTests → done
- * 3. [ci-pr] setup → initialComment → syncSchema → applySeeds → productionPreview
- *           → collectSchemaStats → setupRoles → staticChecks → buildAndPlaywright
- *           → appStart → capabilities → runCoreTests → e2ePhase → finalize → done
+ * 3. [ci-pr] setup → initialComment → syncSchema → applySeeds → postSeedPr
+ *           execution: setupRoles → staticChecks → buildAndPlaywright → appStart
+ *                    → capabilities → runCoreTests → e2ePhase → finalize → done
+ *           observability: productionPreview ∥ collectSchemaStats
  *
  * State Flow (detailed):
  *   idle → setup → initialComment? → dbReset? → pullProduction? → syncSchema → applySeeds
@@ -46,7 +47,7 @@
 import { type SnapshotFrom } from 'xstate';
 import type { CiContext, CiEvent } from './types.js';
 export declare const ciMachine: import("xstate").StateMachine<CiContext, CiEvent, {
-    [x: string]: import("xstate").ActorRefFromLogic<import("xstate").PromiseActorLogic<import("./index.js").StaticChecksOutput, import("./index.js").StaticChecksInput, import("xstate").EventObject>> | import("xstate").ActorRefFromLogic<import("xstate").PromiseActorLogic<import("./index.js").CapabilitiesOutput, import("./index.js").CapabilitiesInput, import("xstate").EventObject>> | import("xstate").ActorRefFromLogic<import("xstate").PromiseActorLogic<import("./index.js").AppStartOutput, import("./index.js").AppStartInput, import("xstate").EventObject>> | import("xstate").ActorRefFromLogic<import("xstate").PromiseActorLogic<import("./index.js").PlaywrightInstallOutput, import("./index.js").PlaywrightInstallInput, import("xstate").EventObject>> | import("xstate").ActorRefFromLogic<import("xstate").PromiseActorLogic<import("./index.js").SyncSchemaOutput, import("./index.js").SyncSchemaInput, import("xstate").EventObject>> | import("xstate").ActorRefFromLogic<import("xstate").PromiseActorLogic<import("./index.js").ApplySeedsOutput, import("./index.js").ApplySeedsInput, import("xstate").EventObject>> | import("xstate").ActorRefFromLogic<import("xstate").PromiseActorLogic<import("./index.js").ProductionPreviewOutput, import("./index.js").ProductionPreviewInput, import("xstate").EventObject>> | import("xstate").ActorRefFromLogic<import("xstate").PromiseActorLogic<import("./actors/setup/local.js").LocalSetupOutput, import("./actors/setup/local.js").LocalSetupInput, import("xstate").EventObject>> | import("xstate").ActorRefFromLogic<import("xstate").PromiseActorLogic<import("./actors/setup/pr-local.js").PrLocalSetupOutput, import("./actors/setup/pr-local.js").PrLocalSetupInput, import("xstate").EventObject>> | import("xstate").ActorRefFromLogic<import("xstate").PromiseActorLogic<import("./index.js").ResetDbOutput, import("./index.js").ResetDbInput, import("xstate").EventObject>> | import("xstate").ActorRefFromLogic<import("xstate").PromiseActorLogic<import("./index.js").PullProductionOutput, import("./index.js").PullProductionInput, import("xstate").EventObject>> | import("xstate").ActorRefFromLogic<import("xstate").PromiseActorLogic<import("./index.js").CollectSchemaStatsOutput, import("./index.js").CollectSchemaStatsInput, import("xstate").EventObject>> | import("xstate").ActorRefFromLogic<import("xstate").PromiseActorLogic<import("./index.js").SetupRolesOutput, import("./index.js").SetupRolesInput, import("xstate").EventObject>> | import("xstate").ActorRefFromLogic<import("xstate").PromiseActorLogic<import("./index.js").InstallPgTapOutput, import("./index.js").InstallPgTapInput, import("xstate").EventObject>> | import("xstate").ActorRefFromLogic<import("xstate").PromiseActorLogic<import("./index.js").AppBuildOutput, import("./index.js").AppBuildInput, import("xstate").EventObject>> | import("xstate").ActorRefFromLogic<import("xstate").PromiseActorLogic<import("./index.js").BuildAndPlaywrightOutput, import("./index.js").BuildAndPlaywrightInput, import("xstate").EventObject>> | import("xstate").ActorRefFromLogic<import("xstate").PromiseActorLogic<import("./index.js").RunLayersOutput, import("./index.js").RunLayersInput, import("xstate").EventObject>> | import("xstate").ActorRefFromLogic<import("xstate").PromiseActorLogic<import("./index.js").WriteSummaryOutput, import("./index.js").WriteSummaryInput, import("xstate").EventObject>> | import("xstate").ActorRefFromLogic<import("xstate").PromiseActorLogic<import("./index.js").UpsertCommentOutput, import("./index.js").UpsertCommentInput, import("xstate").EventObject>> | undefined;
+    [x: string]: import("xstate").ActorRefFromLogic<import("xstate").PromiseActorLogic<import("./index.js").StaticChecksOutput, import("./index.js").StaticChecksInput, import("xstate").EventObject>> | import("xstate").ActorRefFromLogic<import("xstate").PromiseActorLogic<import("./index.js").CapabilitiesOutput, import("./index.js").CapabilitiesInput, import("xstate").EventObject>> | import("xstate").ActorRefFromLogic<import("xstate").PromiseActorLogic<import("./index.js").AppStartOutput, import("./index.js").AppStartInput, import("xstate").EventObject>> | import("xstate").ActorRefFromLogic<import("xstate").PromiseActorLogic<import("./index.js").PlaywrightInstallOutput, import("./index.js").PlaywrightInstallInput, import("xstate").EventObject>> | import("xstate").ActorRefFromLogic<import("xstate").PromiseActorLogic<import("./index.js").SyncSchemaOutput, import("./index.js").SyncSchemaInput, import("xstate").EventObject>> | import("xstate").ActorRefFromLogic<import("xstate").PromiseActorLogic<import("./index.js").ApplySeedsOutput, import("./index.js").ApplySeedsInput, import("xstate").EventObject>> | import("xstate").ActorRefFromLogic<import("xstate").PromiseActorLogic<import("./index.js").ProductionPreviewOutput, import("./index.js").ProductionPreviewInput, import("xstate").EventObject>> | import("xstate").ActorRefFromLogic<import("xstate").PromiseActorLogic<import("./actors/setup/local.js").LocalSetupOutput, import("./actors/setup/local.js").LocalSetupInput, import("xstate").EventObject>> | import("xstate").ActorRefFromLogic<import("xstate").PromiseActorLogic<import("./actors/setup/pr-local.js").PrLocalSetupOutput, import("./actors/setup/pr-local.js").PrLocalSetupInput, import("xstate").EventObject>> | import("xstate").ActorRefFromLogic<import("xstate").PromiseActorLogic<import("./index.js").ResetDbOutput, import("./index.js").ResetDbInput, import("xstate").EventObject>> | import("xstate").ActorRefFromLogic<import("xstate").PromiseActorLogic<import("./index.js").PullProductionOutput, import("./index.js").PullProductionInput, import("xstate").EventObject>> | import("xstate").ActorRefFromLogic<import("xstate").PromiseActorLogic<import("./index.js").CollectSchemaStatsOutput, import("./index.js").CollectSchemaStatsInput, import("xstate").EventObject>> | import("xstate").ActorRefFromLogic<import("xstate").PromiseActorLogic<import("./index.js").SetupRolesOutput, import("./index.js").SetupRolesInput, import("xstate").EventObject>> | import("xstate").ActorRefFromLogic<import("xstate").PromiseActorLogic<import("./index.js").InstallPgTapOutput, import("./index.js").InstallPgTapInput, import("xstate").EventObject>> | import("xstate").ActorRefFromLogic<import("xstate").PromiseActorLogic<import("./index.js").AppBuildOutput, import("./index.js").AppBuildInput, import("xstate").EventObject>> | import("xstate").ActorRefFromLogic<import("xstate").PromiseActorLogic<import("./index.js").BuildAndPlaywrightOutput, import("./index.js").BuildAndPlaywrightInput, import("xstate").EventObject>> | import("xstate").ActorRefFromLogic<import("xstate").PromiseActorLogic<import("./index.js").RunLayersOutput, import("./index.js").RunLayersInput, import("xstate").EventObject>> | import("xstate").ActorRefFromLogic<import("xstate").PromiseActorLogic<import("./index.js").UpsertCommentOutput, import("./index.js").UpsertCommentInput, import("xstate").EventObject>> | undefined;
 }, {
     src: "staticChecks";
     logic: import("xstate").PromiseActorLogic<import("./index.js").StaticChecksOutput, import("./index.js").StaticChecksInput, import("xstate").EventObject>;
@@ -115,10 +116,6 @@ export declare const ciMachine: import("xstate").StateMachine<CiContext, CiEvent
     src: "runLayers";
     logic: import("xstate").PromiseActorLogic<import("./index.js").RunLayersOutput, import("./index.js").RunLayersInput, import("xstate").EventObject>;
     id: string | undefined;
-} | {
-    src: "writeSummary";
-    logic: import("xstate").PromiseActorLogic<import("./index.js").WriteSummaryOutput, import("./index.js").WriteSummaryInput, import("xstate").EventObject>;
-    id: string | undefined;
 } | {
     src: "upsertComment";
     logic: import("xstate").PromiseActorLogic<import("./index.js").UpsertCommentOutput, import("./index.js").UpsertCommentInput, import("xstate").EventObject>;
@@ -168,10 +165,20 @@ export declare const ciMachine: import("xstate").StateMachine<CiContext, CiEvent
 } | {
     type: "allTestsPassed";
     params: unknown;
-}, never, "done" | "failed" | "staticChecks" | "idle" | "capabilities" | "appStart" | "syncSchema" | "applySeeds" | "productionPreview" | "pullProduction" | "collectSchemaStats" | "setupRoles" | "installPgTap" | "buildAndPlaywright" | "initialComment" | "dbReset" | "decidePath" | "runCoreTests" | "coreTestsFailed" | "coreTestsComplete" | {
+}, never, "done" | "failed" | "staticChecks" | "idle" | "capabilities" | "appStart" | "syncSchema" | "applySeeds" | "productionPreview" | "pullProduction" | "collectSchemaStats" | "setupRoles" | "installPgTap" | "buildAndPlaywright" | "initialComment" | "dbReset" | "runCoreTests" | "coreTestsFailed" | "coreTestsComplete" | "decidePath" | {
     setup: "local" | "resolving" | "prLocal" | "complete";
 } | {
-    finalize: "writeSummary" | "complete" | "postComment";
+    finalize: "complete" | "writeSummary" | "postComment";
+} | {
+    postSeedPr: {
+        observability: "done" | "productionPreview" | "collectSchemaStats";
+        execution: "done" | "failed" | "staticChecks" | "capabilities" | "appStart" | "setupRoles" | "buildAndPlaywright" | "runCoreTests" | "coreTestsFailed" | "coreTestsComplete" | {
+            e2ePhase: {
+                intermediateComment: "done" | "checking" | "posting";
+                e2eTests: "done" | "running";
+            };
+        };
+    };
 } | {
     e2ePhase: {
         intermediateComment: "done" | "checking" | "posting";
@@ -208,6 +215,9 @@ export declare const ciMachine: import("xstate").StateMachine<CiContext, CiEvent
     branchName?: string | undefined;
     skipStaticChecks?: boolean | undefined;
     skipBuild?: boolean | undefined;
+    skipLocalDbStart?: boolean | undefined;
+    assumeSupabaseReady?: boolean | undefined;
+    skipPlaywrightInstall?: boolean | undefined;
     skipDbCodegen?: boolean | undefined;
     failFast?: string | undefined;
     maxWaitSeconds?: string | undefined;
@@ -220,10 +230,18 @@ export declare const ciMachine: import("xstate").StateMachine<CiContext, CiEvent
     status: "success" | "timeout" | "failure" | "cancelled";
     repoKind: "unknown" | "monorepo" | "pj-repo";
     steps: Record<string, {
-        status: "timeout" | "skipped" | "failed" | "passed";
+        status: "killed" | "timeout" | "skipped" | "failed" | "passed";
         exitCode?: number | undefined;
         logPath?: string | undefined;
         error?: string | undefined;
+        reason?: string | undefined;
+        title?: string | undefined;
+        phase?: "db" | "test" | "build" | "setup" | "github" | "observability" | "finalize" | undefined;
+        parentStep?: string | undefined;
+        optional?: boolean | undefined;
+        startedAt?: string | undefined;
+        endedAt?: string | undefined;
+        durationMs?: number | undefined;
     }>;
     layers: Record<number, {
         status: "killed" | "timeout" | "skipped" | "failed" | "passed";
@@ -257,6 +275,48 @@ export declare const ciMachine: import("xstate").StateMachine<CiContext, CiEvent
         readonly pullProduction: {};
         readonly syncSchema: {};
         readonly applySeeds: {};
+        readonly postSeedPr: {
+            states: {
+                readonly execution: {
+                    states: {
+                        readonly setupRoles: {};
+                        readonly staticChecks: {};
+                        readonly buildAndPlaywright: {};
+                        readonly appStart: {};
+                        readonly capabilities: {};
+                        readonly runCoreTests: {};
+                        readonly coreTestsComplete: {};
+                        readonly coreTestsFailed: {};
+                        readonly e2ePhase: {
+                            states: {
+                                readonly intermediateComment: {
+                                    states: {
+                                        readonly checking: {};
+                                        readonly posting: {};
+                                        readonly done: {};
+                                    };
+                                };
+                                readonly e2eTests: {
+                                    states: {
+                                        readonly running: {};
+                                        readonly done: {};
+                                    };
+                                };
+                            };
+                        };
+                        readonly failed: {};
+                        readonly done: {};
+                    };
+                };
+                readonly observability: {
+                    states: {
+                        readonly productionPreview: {};
+                        readonly collectSchemaStats: {};
+                        readonly done: {};
+                    };
+                };
+            };
+        };
         readonly productionPreview: {};
         readonly collectSchemaStats: {};
         readonly decidePath: {};

package/dist/commands/ci/machine/types.d.ts

@@ -13,6 +13,7 @@
  * - types.ts: Re-exports + machine-specific types (CiContext, CiEvent)
  */
 import type { CiSummary } from '../utils/ci-summary.js';
+import type { CiDiagnostics } from '../utils/ci-diagnostics.js';
 import type { ExpectedDriftEntry, SchemaStatsSnapshot } from './actors/db/schema-stats.js';
 import type { CiDbMode as _CiDbMode, CiExecutionEnv as _CiExecutionEnv, CiInput as _CiInput, CiMode as _CiMode, CiOutput as _CiOutput, CiPhase as _CiPhase, CiPrPolicy as _CiPrPolicy, DetectedApp as _DetectedApp, LayerSummary as _LayerResult, LayerStatus as _LayerStatus, PrContext as _PrContext, RepoKind as _RepoKind, StepSummary as _StepResult, StepStatus as _StepStatus, SupabaseConnection as _SupabaseConnection } from './contract.js';
 export type CiMode = _CiMode;
@@ -30,6 +31,10 @@ export type CiPrPolicy = _CiPrPolicy;
 export type SupabaseConnection = _SupabaseConnection;
 export type StepResult = _StepResult;
 export type LayerResult = _LayerResult;
+export interface StepOverride {
+    status?: StepStatus;
+    reason?: string;
+}
 export type { ExpectedDriftEntry, SchemaStatsSnapshot } from './actors/db/schema-stats.js';
 /**
  * Schema change statistics extracted from SQL diff.
@@ -185,8 +190,12 @@ export interface CiContext {
     testsRun: boolean;
     /** Skip reasons for layers without content (layer number → reason) */
     layerSkipReasons: Record<number, string>;
+    /** Summary-specific overrides for tracked steps (status/reason) */
+    stepOverrides: Record<string, StepOverride>;
     /** CI summary for reporting */
     summary: CiSummary | null;
+    /** Machine-readable diagnostics for setup/wait behavior */
+    diagnostics: CiDiagnostics;
     /** Summary file path */
     summaryPath: string | null;
     /** Schema drift snapshot (ci-pr modes only) */

package/dist/commands/ci/utils/ci-diagnostics.d.ts

@@ -0,0 +1,67 @@
+import { z } from 'zod';
+export declare const ExecutionOwnerSchema: z.ZodEnum<{
+    external: "external";
+    sdk: "sdk";
+}>;
+export type ExecutionOwner = z.output<typeof ExecutionOwnerSchema>;
+export declare const SupabaseResolutionStrategySchema: z.ZodEnum<{
+    "assume-ready": "assume-ready";
+    "status-polling": "status-polling";
+    "fallback-default": "fallback-default";
+}>;
+export declare const SupabaseResolutionSourceSchema: z.ZodEnum<{
+    "assumed-local-config": "assumed-local-config";
+    "status-json": "status-json";
+    "default-fallback": "default-fallback";
+}>;
+export declare const SupabaseResolutionDiagnosticsSchema: z.ZodObject<{
+    strategy: z.ZodEnum<{
+        "assume-ready": "assume-ready";
+        "status-polling": "status-polling";
+        "fallback-default": "fallback-default";
+    }>;
+    finalSource: z.ZodEnum<{
+        "assumed-local-config": "assumed-local-config";
+        "status-json": "status-json";
+        "default-fallback": "default-fallback";
+    }>;
+    attempts: z.ZodNumber;
+    maxAttempts: z.ZodNumber;
+    sleepSeconds: z.ZodNumber;
+    waitedMs: z.ZodNumber;
+    retriesExhausted: z.ZodOptional<z.ZodBoolean>;
+    lastError: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type SupabaseResolutionDiagnostics = z.output<typeof SupabaseResolutionDiagnosticsSchema>;
+export declare const CiDiagnosticsSchema: z.ZodObject<{
+    setup: z.ZodOptional<z.ZodObject<{
+        runtimeOwner: z.ZodOptional<z.ZodEnum<{
+            external: "external";
+            sdk: "sdk";
+        }>>;
+        playwrightOwner: z.ZodOptional<z.ZodEnum<{
+            external: "external";
+            sdk: "sdk";
+        }>>;
+        supabase: z.ZodOptional<z.ZodObject<{
+            strategy: z.ZodEnum<{
+                "assume-ready": "assume-ready";
+                "status-polling": "status-polling";
+                "fallback-default": "fallback-default";
+            }>;
+            finalSource: z.ZodEnum<{
+                "assumed-local-config": "assumed-local-config";
+                "status-json": "status-json";
+                "default-fallback": "default-fallback";
+            }>;
+            attempts: z.ZodNumber;
+            maxAttempts: z.ZodNumber;
+            sleepSeconds: z.ZodNumber;
+            waitedMs: z.ZodNumber;
+            retriesExhausted: z.ZodOptional<z.ZodBoolean>;
+            lastError: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type CiDiagnostics = z.output<typeof CiDiagnosticsSchema>;
+//# sourceMappingURL=ci-diagnostics.d.ts.map