@runa-ai/runa-cli 0.7.1 → 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/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,25 @@ 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.
@@ -123,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

@@ -47,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>;
@@ -116,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>;
@@ -172,16 +168,16 @@ export declare const ciMachine: import("xstate").StateMachine<CiContext, CiEvent
 }, 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";
             };
         };
-        observability: "done" | "productionPreview" | "collectSchemaStats";
     };
 } | {
     e2ePhase: {
@@ -219,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;
@@ -231,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";

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

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

@@ -53,6 +53,36 @@ export declare const CiSummarySchema: z.ZodObject<{
         "pj-repo": "pj-repo";
     }>;
     detected: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    diagnostics: z.ZodDefault<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>>;
     steps: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
         status: z.ZodEnum<{
             killed: "killed";
@@ -63,6 +93,23 @@ export declare const CiSummarySchema: 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.$strict>>>;
     layers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
         status: z.ZodEnum<{
@@ -89,6 +136,77 @@ export declare const CiSummarySchema: z.ZodObject<{
         step: z.ZodString;
         details: z.ZodOptional<z.ZodString>;
     }, z.core.$strict>>>;
+    dbOutcome: z.ZodOptional<z.ZodObject<{
+        command: z.ZodString;
+        exitMode: z.ZodEnum<{
+            success: "success";
+            success_with_warnings: "success_with_warnings";
+            failed: "failed";
+            timeout: "timeout";
+            cancelled: "cancelled";
+        }>;
+        startedAt: z.ZodString;
+        endedAt: z.ZodString;
+        durationMs: z.ZodNumber;
+        phases: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            label: z.ZodString;
+            status: z.ZodEnum<{
+                failed: "failed";
+                timeout: "timeout";
+                cancelled: "cancelled";
+                pending: "pending";
+                running: "running";
+                passed: "passed";
+                warning: "warning";
+                skipped: "skipped";
+            }>;
+            startedAt: z.ZodOptional<z.ZodString>;
+            endedAt: z.ZodOptional<z.ZodString>;
+            durationMs: z.ZodOptional<z.ZodNumber>;
+            timeoutMs: z.ZodOptional<z.ZodNumber>;
+            warningCount: z.ZodOptional<z.ZodNumber>;
+            error: z.ZodOptional<z.ZodObject<{
+                code: z.ZodString;
+                message: z.ZodString;
+                statusCode: z.ZodOptional<z.ZodNumber>;
+                retryable: z.ZodBoolean;
+                retryAfterMs: z.ZodOptional<z.ZodNumber>;
+                phase: z.ZodOptional<z.ZodString>;
+                details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            }, z.core.$strict>>;
+            warnings: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                code: z.ZodString;
+                message: z.ZodString;
+                phase: z.ZodString;
+                details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            }, z.core.$strict>>>;
+            metrics: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+        }, z.core.$strict>>;
+        warnings: z.ZodArray<z.ZodObject<{
+            code: z.ZodString;
+            message: z.ZodString;
+            phase: z.ZodString;
+            details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strict>>;
+        errors: z.ZodArray<z.ZodObject<{
+            code: z.ZodString;
+            message: z.ZodString;
+            statusCode: z.ZodOptional<z.ZodNumber>;
+            retryable: z.ZodBoolean;
+            retryAfterMs: z.ZodOptional<z.ZodNumber>;
+            phase: z.ZodOptional<z.ZodString>;
+            details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strict>>;
+        summary: z.ZodObject<{
+            passed: z.ZodNumber;
+            warnings: z.ZodNumber;
+            failed: z.ZodNumber;
+            skipped: z.ZodNumber;
+            timedOut: z.ZodNumber;
+        }, z.core.$strict>;
+        nextActions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>>;
     blockingPolicy: z.ZodOptional<z.ZodObject<{
         profile: z.ZodOptional<z.ZodEnum<{
             "runa-strict": "runa-strict";