@runa-ai/runa-cli 0.5.26

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

@@ -0,0 +1,393 @@
+/**
+ * AI HINT: Unified CI Machine Contract
+ *
+ * Purpose: Zod schemas for unified CI machine I/O validation
+ * Pattern: Contract-first design - all inputs/outputs strictly typed
+ *
+ * Two execution modes:
+ * - ci-local: Standalone local simulation (runa ci local)
+ * - ci-pr-local: PR CI with local Supabase (runa ci pr)
+ *
+ * Workflow (unified):
+ * 1. Setup → Resolve mode, paths, config
+ * 2. DB Setup → Reset/sync schema
+ * 3. Seeds → Apply seed data
+ * 4. Roles → Setup database roles (ci-pr mode only)
+ * 5. Static Checks → Type-check, lint (ci-pr mode only)
+ * 6. App Build → Build Next.js app (ci-pr mode only)
+ * 7. App Start → Start app server (ci-pr mode only)
+ * 8. Capabilities → Detect test capabilities (ci-pr mode only)
+ * 9. Tests → Run layer tests
+ * 10. Finalize → Write summary, post comments (ci-pr mode only)
+ */
+import { z } from 'zod';
+export declare const CiModeSchema: z.ZodEnum<{
+    "ci-local": "ci-local";
+    "ci-pr-local": "ci-pr-local";
+}>;
+export type CiMode = z.infer<typeof CiModeSchema>;
+export declare const CiExecutionEnvSchema: z.ZodEnum<{
+    local: "local";
+    "github-actions": "github-actions";
+}>;
+export type CiExecutionEnv = z.infer<typeof CiExecutionEnvSchema>;
+export declare const CiPhaseSchema: z.ZodEnum<{
+    all: "all";
+    test: "test";
+}>;
+export type CiPhase = z.infer<typeof CiPhaseSchema>;
+export declare const CiDbModeSchema: z.ZodEnum<{
+    local: "local";
+    auto: "auto";
+}>;
+export type CiDbMode = z.infer<typeof CiDbModeSchema>;
+export declare const RepoKindSchema: z.ZodEnum<{
+    unknown: "unknown";
+    monorepo: "monorepo";
+    "pj-repo": "pj-repo";
+}>;
+export type RepoKind = z.infer<typeof RepoKindSchema>;
+export declare const StepStatusSchema: z.ZodEnum<{
+    timeout: "timeout";
+    passed: "passed";
+    failed: "failed";
+    skipped: "skipped";
+}>;
+export type StepStatus = z.infer<typeof StepStatusSchema>;
+export declare const LayerStatusSchema: z.ZodEnum<{
+    timeout: "timeout";
+    passed: "passed";
+    failed: "failed";
+    skipped: "skipped";
+}>;
+export type LayerStatus = z.infer<typeof LayerStatusSchema>;
+/**
+ * Unified CLI input for ci commands.
+ * Supports both ci local and ci pr commands.
+ *
+ * Environment Capture Pattern:
+ * - Environment variables are captured at the entry point (ci-local.ts, ci-pr.ts)
+ * - Machine/guards read from this input, NOT from process.env directly
+ * - This makes the machine testable and environment-independent
+ */
+export declare const CiInputSchema: z.ZodObject<{
+    command: z.ZodDefault<z.ZodEnum<{
+        local: "local";
+        pr: "pr";
+    }>>;
+    targetDir: z.ZodOptional<z.ZodString>;
+    verbose: z.ZodOptional<z.ZodBoolean>;
+    productionDatabaseUrl: z.ZodOptional<z.ZodString>;
+    databaseUrl: z.ZodOptional<z.ZodString>;
+    githubRef: z.ZodOptional<z.ZodString>;
+    githubEventAction: z.ZodOptional<z.ZodString>;
+    githubSha: z.ZodOptional<z.ZodString>;
+    githubBaseRef: z.ZodOptional<z.ZodString>;
+    githubHeadRef: z.ZodOptional<z.ZodString>;
+    githubServerUrl: z.ZodOptional<z.ZodString>;
+    githubRepository: z.ZodOptional<z.ZodString>;
+    githubRunId: z.ZodOptional<z.ZodString>;
+    isGitHubActions: z.ZodOptional<z.ZodBoolean>;
+    isCI: z.ZodOptional<z.ZodBoolean>;
+    supabaseProjectRef: z.ZodOptional<z.ZodString>;
+    supabaseAccessToken: z.ZodOptional<z.ZodString>;
+    layer: z.ZodOptional<z.ZodString>;
+    check: z.ZodOptional<z.ZodBoolean>;
+    keepDb: z.ZodOptional<z.ZodBoolean>;
+    executionMode: z.ZodOptional<z.ZodEnum<{
+        local: "local";
+        "github-actions": "github-actions";
+    }>>;
+    output: z.ZodOptional<z.ZodEnum<{
+        json: "json";
+        human: "human";
+    }>>;
+    config: z.ZodOptional<z.ZodString>;
+    phase: z.ZodOptional<z.ZodEnum<{
+        all: "all";
+        test: "test";
+    }>>;
+    dbMode: z.ZodOptional<z.ZodEnum<{
+        local: "local";
+        auto: "auto";
+    }>>;
+    branchName: z.ZodOptional<z.ZodString>;
+    skipStaticChecks: z.ZodOptional<z.ZodBoolean>;
+    skipBuild: z.ZodOptional<z.ZodBoolean>;
+    skipDbCodegen: z.ZodOptional<z.ZodBoolean>;
+    failFast: z.ZodOptional<z.ZodString>;
+    maxWaitSeconds: z.ZodOptional<z.ZodString>;
+    progressIntervalSeconds: z.ZodOptional<z.ZodString>;
+    playwrightWorkers: z.ZodOptional<z.ZodString>;
+    skipGithubComment: z.ZodOptional<z.ZodBoolean>;
+    layers: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+}, z.core.$loose>;
+export type CiInput = z.infer<typeof CiInputSchema>;
+/**
+ * Setup step result.
+ */
+export declare const SetupResultSchema: z.ZodObject<{
+    passed: z.ZodBoolean;
+    repoRoot: z.ZodString;
+    tmpDir: z.ZodString;
+    mode: z.ZodEnum<{
+        "ci-local": "ci-local";
+        "ci-pr-local": "ci-pr-local";
+    }>;
+    executionEnv: z.ZodEnum<{
+        local: "local";
+        "github-actions": "github-actions";
+    }>;
+    phase: z.ZodEnum<{
+        all: "all";
+        test: "test";
+    }>;
+    repoKind: z.ZodEnum<{
+        unknown: "unknown";
+        monorepo: "monorepo";
+        "pj-repo": "pj-repo";
+    }>;
+    branchName: z.ZodOptional<z.ZodString>;
+    error: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type SetupResult = z.infer<typeof SetupResultSchema>;
+/**
+ * DB setup step result.
+ */
+export declare const DbSetupResultSchema: z.ZodObject<{
+    passed: z.ZodBoolean;
+    reset: z.ZodOptional<z.ZodBoolean>;
+    productionPulled: z.ZodOptional<z.ZodBoolean>;
+    schemaApplied: z.ZodOptional<z.ZodBoolean>;
+    seedsApplied: z.ZodOptional<z.ZodBoolean>;
+    databaseUrl: z.ZodOptional<z.ZodString>;
+    supabaseUrl: z.ZodOptional<z.ZodString>;
+    anonKey: z.ZodOptional<z.ZodString>;
+    error: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type DbSetupResult = z.infer<typeof DbSetupResultSchema>;
+/**
+ * Roles setup step result.
+ */
+export declare const RolesSetupResultSchema: z.ZodObject<{
+    passed: z.ZodBoolean;
+    appDatabaseUrl: z.ZodOptional<z.ZodString>;
+    error: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type RolesSetupResult = z.infer<typeof RolesSetupResultSchema>;
+/**
+ * Static checks step result.
+ */
+export declare const StaticChecksResultSchema: z.ZodObject<{
+    passed: z.ZodBoolean;
+    typeCheckPassed: z.ZodOptional<z.ZodBoolean>;
+    lintPassed: z.ZodOptional<z.ZodBoolean>;
+    error: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type StaticChecksResult = z.infer<typeof StaticChecksResultSchema>;
+/**
+ * App build step result.
+ */
+export declare const AppBuildResultSchema: z.ZodObject<{
+    passed: z.ZodBoolean;
+    error: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type AppBuildResult = z.infer<typeof AppBuildResultSchema>;
+/**
+ * App start step result.
+ */
+export declare const AppStartResultSchema: z.ZodObject<{
+    passed: z.ZodBoolean;
+    baseUrl: z.ZodOptional<z.ZodString>;
+    appPid: z.ZodOptional<z.ZodNumber>;
+    error: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type AppStartResult = z.infer<typeof AppStartResultSchema>;
+/**
+ * Capability detection result.
+ */
+export declare const CapabilityResultSchema: z.ZodObject<{
+    capabilities: z.ZodArray<z.ZodString>;
+    selectedLayers: z.ZodArray<z.ZodNumber>;
+    diagnostics: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$strip>;
+export type CapabilityResult = z.infer<typeof CapabilityResultSchema>;
+/**
+ * Layer test result.
+ */
+export declare const LayerResultSchema: z.ZodObject<{
+    layer: z.ZodNumber;
+    status: z.ZodEnum<{
+        timeout: "timeout";
+        passed: "passed";
+        failed: "failed";
+        skipped: "skipped";
+    }>;
+    exitCode: z.ZodNumber;
+    passed: z.ZodOptional<z.ZodNumber>;
+    total: z.ZodOptional<z.ZodNumber>;
+    logPath: z.ZodOptional<z.ZodString>;
+    error: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type LayerResult = z.infer<typeof LayerResultSchema>;
+/**
+ * Test run result.
+ */
+export declare const TestRunResultSchema: z.ZodObject<{
+    passed: z.ZodBoolean;
+    layerResults: z.ZodRecord<z.ZodCoercedNumber<unknown>, z.ZodEnum<{
+        timeout: "timeout";
+        passed: "passed";
+        failed: "failed";
+        skipped: "skipped";
+    }>>;
+    passedCount: z.ZodNumber;
+    failedCount: z.ZodNumber;
+    error: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type TestRunResult = z.infer<typeof TestRunResultSchema>;
+/**
+ * Finalize step result.
+ */
+export declare const FinalizeResultSchema: z.ZodObject<{
+    summaryPath: z.ZodString;
+    exitCode: z.ZodUnion<readonly [z.ZodLiteral<0>, z.ZodLiteral<1>, z.ZodLiteral<2>]>;
+    commentPosted: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type FinalizeResult = z.infer<typeof FinalizeResultSchema>;
+/**
+ * Step summary entry.
+ */
+export declare const StepSummarySchema: z.ZodObject<{
+    status: z.ZodEnum<{
+        timeout: "timeout";
+        passed: "passed";
+        failed: "failed";
+        skipped: "skipped";
+    }>;
+    exitCode: z.ZodOptional<z.ZodNumber>;
+    logPath: z.ZodOptional<z.ZodString>;
+    error: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type StepSummary = z.infer<typeof StepSummarySchema>;
+/**
+ * Layer summary entry.
+ */
+export declare const LayerSummarySchema: z.ZodObject<{
+    status: z.ZodEnum<{
+        timeout: "timeout";
+        passed: "passed";
+        failed: "failed";
+        skipped: "skipped";
+    }>;
+    exitCode: z.ZodNumber;
+    passed: z.ZodOptional<z.ZodNumber>;
+    total: z.ZodOptional<z.ZodNumber>;
+    logPath: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    level: z.ZodOptional<z.ZodEnum<{
+        blocking: "blocking";
+        warning: "warning";
+        reportOnly: "reportOnly";
+    }>>;
+}, z.core.$strip>;
+export type LayerSummary = z.infer<typeof LayerSummarySchema>;
+/**
+ * Unified CI output.
+ */
+export declare const CiOutputSchema: z.ZodObject<{
+    mode: z.ZodEnum<{
+        "ci-local": "ci-local";
+        "ci-pr-local": "ci-pr-local";
+    }>;
+    status: z.ZodEnum<{
+        timeout: "timeout";
+        success: "success";
+        failure: "failure";
+        cancelled: "cancelled";
+    }>;
+    repoKind: z.ZodEnum<{
+        unknown: "unknown";
+        monorepo: "monorepo";
+        "pj-repo": "pj-repo";
+    }>;
+    steps: z.ZodRecord<z.ZodString, z.ZodObject<{
+        status: z.ZodEnum<{
+            timeout: "timeout";
+            passed: "passed";
+            failed: "failed";
+            skipped: "skipped";
+        }>;
+        exitCode: z.ZodOptional<z.ZodNumber>;
+        logPath: z.ZodOptional<z.ZodString>;
+        error: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    layers: z.ZodRecord<z.ZodCoercedNumber<unknown>, z.ZodObject<{
+        status: z.ZodEnum<{
+            timeout: "timeout";
+            passed: "passed";
+            failed: "failed";
+            skipped: "skipped";
+        }>;
+        exitCode: z.ZodNumber;
+        passed: z.ZodOptional<z.ZodNumber>;
+        total: z.ZodOptional<z.ZodNumber>;
+        logPath: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        level: z.ZodOptional<z.ZodEnum<{
+            blocking: "blocking";
+            warning: "warning";
+            reportOnly: "reportOnly";
+        }>>;
+    }, z.core.$strip>>;
+    durationMs: z.ZodNumber;
+    summaryPath: z.ZodOptional<z.ZodString>;
+    exitCode: z.ZodUnion<readonly [z.ZodLiteral<0>, z.ZodLiteral<1>, z.ZodLiteral<2>]>;
+    error: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type CiOutput = z.infer<typeof CiOutputSchema>;
+/**
+ * Supabase connection details.
+ */
+export declare const SupabaseConnectionSchema: z.ZodObject<{
+    supabaseUrl: z.ZodString;
+    anonKey: z.ZodString;
+    databaseUrlRaw: z.ZodString;
+    appDatabaseUrl: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type SupabaseConnection = z.infer<typeof SupabaseConnectionSchema>;
+/**
+ * GitHub PR context.
+ */
+export declare const PrContextSchema: z.ZodObject<{
+    prNumber: z.ZodNullable<z.ZodNumber>;
+    action: z.ZodNullable<z.ZodString>;
+    sha: z.ZodNullable<z.ZodString>;
+    baseBranch: z.ZodNullable<z.ZodString>;
+    headBranch: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type PrContext = z.infer<typeof PrContextSchema>;
+/**
+ * CI PR policy.
+ */
+export declare const CiPrPolicySchema: z.ZodObject<{
+    allowLocalFallback: z.ZodBoolean;
+    allowPartialPhases: z.ZodBoolean;
+    source: z.ZodEnum<{
+        default: "default";
+        config: "config";
+    }>;
+}, z.core.$strip>;
+export type CiPrPolicy = z.infer<typeof CiPrPolicySchema>;
+/**
+ * Detected app configuration.
+ *
+ * Note: The CI system uses `pnpm -C {appDir}` instead of `pnpm --filter`.
+ * This provides more reliable behavior across different monorepo structures.
+ */
+export declare const DetectedAppSchema: z.ZodObject<{
+    appDir: z.ZodString;
+    port: z.ZodNumber;
+}, z.core.$strip>;
+export type DetectedApp = z.infer<typeof DetectedAppSchema>;
+//# sourceMappingURL=contract.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../../../src/commands/ci/machine/contract.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,87 @@
+/**
+ * AI HINT: GitHub Comment Type Definitions
+ *
+ * Purpose: Shared types for GitHub PR comment generation
+ * Extracted from: github-comment.ts for better code organization
+ */
+import type { 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';
+/**
+ * Step status for progress display.
+ */
+export type StepStatus = 'pending' | 'running' | 'passed' | 'failed' | 'skipped';
+/**
+ * Step info for progress comment.
+ */
+export interface StepInfo {
+    step: CiStep;
+    status: StepStatus;
+    label: string;
+}
+/**
+ * Step timing information (duration in milliseconds).
+ */
+export type StepTimings = Partial<Record<CiStep, number>>;
+export interface CommentInput {
+    exitCode: 0 | 1 | 2;
+    branchName: string | null;
+    prContext: PrContext | null;
+    supabase: SupabaseConnection | null;
+    schemaDrift: SchemaDriftSnapshot | null;
+    layerResults: Record<number, LayerResult>;
+    productionPreview: ProductionPreview | null;
+    schemaStats: SchemaStatsSnapshot | null;
+    /** If true, this is an intermediate comment (e.g., core tests passed, E2E running) */
+    isIntermediate?: boolean;
+    /** Message to show for intermediate comments */
+    intermediateMessage?: string;
+    /** Skip reasons for layers without content (layer number → reason) */
+    layerSkipReasons?: Record<number, string>;
+    /** Originally selected layers (before filtering by content) */
+    originalSelectedLayers?: number[];
+}
+/**
+ * Input for progress comment generation.
+ */
+export interface ProgressCommentInput {
+    currentStep: CiStep;
+    completedSteps: CiStep[];
+    failedStep: CiStep | null;
+    branchName: string | null;
+    prContext: PrContext | null;
+    supabase: SupabaseConnection | null;
+    schemaDrift: SchemaDriftSnapshot | null;
+    layerResults: Record<number, LayerResult>;
+    productionPreview: ProductionPreview | null;
+    error: string | null;
+    /** Optional step timings (duration in ms) */
+    stepTimings?: StepTimings;
+    /** Deploy status from previous deploy workflow */
+    deployStatus?: {
+        deployed: boolean;
+        commit?: string;
+        deployedBy?: string;
+        deployedAt?: string;
+    };
+}
+export interface GitHubEnv {
+    repository: string;
+    serverUrl: string;
+    runId: string;
+}
+/**
+ * All CI steps with their display labels and descriptions.
+ */
+export declare const CI_STEPS: Array<{
+    step: CiStep;
+    label: string;
+    detail?: string;
+}>;
+/**
+ * Blocking layers for DB deploy (0-3).
+ */
+export declare const BLOCKING_LAYERS: number[];
+//# sourceMappingURL=github-comment-types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"github-comment-types.d.ts","sourceRoot":"","sources":["../../../../../src/commands/ci/machine/formatters/github-comment-types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,SAAS,EACT,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EACnB,MAAM,aAAa,CAAC;AAMrB;;GAEG;AACH,MAAM,MAAM,MAAM,GACd,OAAO,GACP,YAAY,GACZ,YAAY,GACZ,cAAc,GACd,OAAO,GACP,UAAU,GACV,UAAU,CAAC;AAEf;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEjF;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,UAAU,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AAM1D,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACpB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,EAAE,SAAS,GAAG,IAAI,CAAC;IAC5B,QAAQ,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACpC,WAAW,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACxC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAC1C,iBAAiB,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAC5C,WAAW,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACxC,sFAAsF;IACtF,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,gDAAgD;IAChD,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,sEAAsE;IACtE,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,+DAA+D;IAC/D,sBAAsB,CAAC,EAAE,MAAM,EAAE,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,EAAE,SAAS,GAAG,IAAI,CAAC;IAC5B,QAAQ,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACpC,WAAW,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACxC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAC1C,iBAAiB,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAC5C,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,6CAA6C;IAC7C,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,kDAAkD;IAClD,YAAY,CAAC,EAAE;QACb,QAAQ,EAAE,OAAO,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;CACH;AAED,MAAM,WAAW,SAAS;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACf;AAMD;;GAEG;AACH,eAAO,MAAM,QAAQ,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAQ5E,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe,UAAe,CAAC"}

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

@@ -0,0 +1,44 @@
+/**
+ * AI HINT: GitHub PR Comment Formatter
+ *
+ * Purpose: Generate formatted markdown for CI PR comments
+ * Pattern: Facade - delegates to section modules
+ *
+ * Structure:
+ * - sections/format-helpers.ts: Shared formatting utilities
+ * - sections/schema-matrix.ts: Schema statistics matrix
+ * - sections/progress-comment.ts: Step-by-step progress updates
+ * - sections/final-comment.ts: Final CI results
+ *
+ * Usage:
+ * - Called by upsertComment actor during CI execution
+ * - Generates structured CI results for GitHub PR comments
+ * - Supports progress updates (step-by-step) and final results
+ */
+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';
+/**
+ * Options for intermediate comment generation.
+ */
+interface IntermediateCommentOptions {
+    /** If true, this is an intermediate comment (e.g., core tests passed, E2E running) */
+    isIntermediate: true;
+    /** Message to show for intermediate comments */
+    intermediateMessage: string;
+}
+/**
+ * Create comment input from CI context.
+ * Use this in machine.ts to generate the comment body.
+ *
+ * @param context - CI context
+ * @param options - Optional settings for intermediate comments
+ */
+export declare function createCommentInput(context: CiContext, options?: IntermediateCommentOptions): CommentInput;
+/**
+ * Create progress comment input from CI context.
+ * Use this in machine.ts to generate progress updates.
+ */
+export declare function createProgressCommentInput(context: CiContext, currentStep: CiStep, completedSteps: CiStep[], failedStep?: CiStep | null, stepTimings?: StepTimings): ProgressCommentInput;
+//# sourceMappingURL=github-comment.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"github-comment.d.ts","sourceRoot":"","sources":["../../../../../src/commands/ci/machine/formatters/github-comment.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EACV,MAAM,EACN,YAAY,EACZ,oBAAoB,EACpB,WAAW,EACZ,MAAM,2BAA2B,CAAC;AAGnC,YAAY,EACV,MAAM,EACN,oBAAoB,EACpB,QAAQ,EACR,UAAU,EACV,WAAW,GACZ,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EACL,mBAAmB,EACnB,2BAA2B,EAC3B,YAAY,GACb,MAAM,qBAAqB,CAAC;AAM7B;;GAEG;AACH,UAAU,0BAA0B;IAClC,sFAAsF;IACtF,cAAc,EAAE,IAAI,CAAC;IACrB,gDAAgD;IAChD,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,SAAS,EAClB,OAAO,CAAC,EAAE,0BAA0B,GACnC,YAAY,CAqBd;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,SAAS,EAClB,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,EAAE,EACxB,UAAU,GAAE,MAAM,GAAG,IAAW,EAChC,WAAW,CAAC,EAAE,WAAW,GACxB,oBAAoB,CActB"}

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

@@ -0,0 +1,13 @@
+/**
+ * AI HINT: CI Formatters Barrel Export
+ *
+ * Purpose: Re-export all formatter functions for CI machine
+ * Pattern: Barrel pattern - single import point for all formatters
+ *
+ * Formatters:
+ * - github-comment: GitHub PR comment generation
+ * - summary: CI summary artifact generation
+ */
+export { createCommentInput, generateCommentBody, getGitHubEnv } from './github-comment.js';
+export { createSummaryInput, type WriteSummaryInput } from './summary.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/commands/ci/machine/formatters/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAC5F,OAAO,EAAE,kBAAkB,EAAE,KAAK,iBAAiB,EAAE,MAAM,cAAc,CAAC"}

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

@@ -0,0 +1,18 @@
+/**
+ * AI HINT: Final Comment Section Generator
+ *
+ * Purpose: Generate final CI results for GitHub PR comments
+ * Pattern: Pure function - takes CI context, returns markdown string
+ *
+ * Usage: Called by upsertComment actor at CI completion
+ */
+import type { CommentInput, GitHubEnv } from '../github-comment-types.js';
+/**
+ * Get GitHub environment from process.env.
+ */
+export declare function getGitHubEnv(): GitHubEnv;
+/**
+ * Generate GitHub PR comment body from CI context (final result or intermediate).
+ */
+export declare function generateCommentBody(input: CommentInput): string;
+//# sourceMappingURL=final-comment.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"final-comment.d.ts","sourceRoot":"","sources":["../../../../../../src/commands/ci/machine/formatters/sections/final-comment.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAmQ1E;;GAEG;AACH,wBAAgB,YAAY,IAAI,SAAS,CAMxC;AAiDD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CA0C/D"}

package/dist/commands/ci/machine/formatters/sections/format-helpers.d.ts

@@ -0,0 +1,63 @@
+/**
+ * AI HINT: GitHub Comment Format Helpers
+ *
+ * Purpose: Shared formatting utilities for GitHub PR comments
+ * Pattern: Pure functions - input → formatted string
+ */
+import type { LayerResult } from '../../types.js';
+import { BLOCKING_LAYERS } from '../github-comment-types.js';
+/**
+ * Format duration in human-readable format.
+ */
+export declare function formatDuration(ms: number): string;
+/**
+ * Get icon for test/layer status.
+ */
+export declare function getStatusIcon(status: string | undefined): string;
+/**
+ * Layer names for display.
+ * L0: Static (type-check, lint, build)
+ * L1: Unit (XState machine tests)
+ * L2: DB (pgTAP schema tests)
+ * L3: API (Hono integration tests)
+ * L4: E2E (Playwright browser tests)
+ */
+export declare const LAYER_NAMES: Record<number, string>;
+/**
+ * Format a single layer result line.
+ */
+export declare function formatSingleLayer(layer: number, result: LayerResult | undefined): string;
+/**
+ * Format layer results with blocking/non-blocking separation.
+ *
+ * Blocking (L0-L3): Must pass for DB deploy
+ * Non-blocking (L4): E2E tests, can fail without blocking deploy
+ */
+export declare function formatLayerResults(layerResults: Record<number, LayerResult>): string[];
+/**
+ * Format SQL details in collapsible section.
+ */
+export declare function formatSqlDetails(title: string, sql: string): string[];
+/**
+ * Format git diff summary for PR comment.
+ */
+export declare function formatGitDiffDetails(gitDiff: {
+    filesChanged: string[];
+    linesAdded: number;
+    linesDeleted: number;
+    diffSummary?: string;
+}): string[];
+export { BLOCKING_LAYERS };
+/**
+ * Check if all blocking layers have passed.
+ * Returns true if layers 0-3 are all 'passed' or 'skipped'.
+ */
+export declare function checkBlockingLayersPassed(layerResults: Record<number, LayerResult>): boolean;
+/**
+ * Format skipped layers section for PR comment.
+ *
+ * Shows which layers were skipped due to no content detected,
+ * along with instructions on how to enable them.
+ */
+export declare function formatSkippedLayers(layerSkipReasons: Record<number, string>, originalSelectedLayers: number[]): string[];
+//# sourceMappingURL=format-helpers.d.ts.map

package/dist/commands/ci/machine/formatters/sections/format-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-helpers.d.ts","sourceRoot":"","sources":["../../../../../../src/commands/ci/machine/formatters/sections/format-helpers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAM7D;;GAEG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAOjD;AAMD;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAWhE;AAMD;;;;;;;GAOG;AACH,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAM9C,CAAC;AAEF;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,SAAS,GAAG,MAAM,CAQxF;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,GAAG,MAAM,EAAE,CA8BtF;AAMD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAgBrE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE;IAC5C,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,GAAG,MAAM,EAAE,CAkCX;AAOD,OAAO,EAAE,eAAe,EAAE,CAAC;AAE3B;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,GAAG,OAAO,CAS5F;AAMD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACxC,sBAAsB,EAAE,MAAM,EAAE,GAC/B,MAAM,EAAE,CA6BV"}

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

@@ -0,0 +1,10 @@
+/**
+ * AI HINT: GitHub Comment Sections Barrel Export
+ *
+ * Purpose: Export all section generators for GitHub PR comments
+ */
+export { generateCommentBody, getGitHubEnv } from './final-comment.js';
+export { BLOCKING_LAYERS, checkBlockingLayersPassed, formatDuration, formatGitDiffDetails, formatLayerResults, formatSingleLayer, formatSqlDetails, getStatusIcon, } from './format-helpers.js';
+export { generateProgressCommentBody } from './progress-comment.js';
+export { formatSchemaMatrix } from './schema-matrix.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/commands/ci/machine/formatters/sections/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvE,OAAO,EACL,eAAe,EACf,yBAAyB,EACzB,cAAc,EACd,oBAAoB,EACpB,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,GACd,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAAE,2BAA2B,EAAE,MAAM,uBAAuB,CAAC;AAEpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC"}