@runa-ai/runa-cli 0.5.26

package/dist/commands/db/constants.d.ts

@@ -0,0 +1,97 @@
+/**
+ * AI HINT: Constants and configuration for runa db command
+ *
+ * Purpose: Environment-based database configuration with sensible defaults
+ * Design: Supabase must be running - ports are detected from `supabase status`
+ *
+ * Port Detection:
+ * - `supabase status --output json` returns actual running ports
+ * - If Supabase is not running, throws an error (no fallback)
+ * - This ensures the correct ports are always used
+ */
+import type { ScriptLocation } from './types.js';
+interface SupabasePorts {
+    api: number;
+    db: number;
+    studio: number;
+}
+/**
+ * Detect Supabase ports from running instance via `supabase status`.
+ *
+ * Design: Supabase MUST be running for any DB operation.
+ * - No fallback to config files or hash-based calculation
+ * - Throws error if Supabase is not running
+ * - This ensures the correct ports are always used
+ *
+ * @param projectRoot - Project root directory (defaults to process.cwd())
+ * @returns Detected ports from running Supabase instance
+ * @throws Error if Supabase is not running
+ */
+export declare function detectSupabasePorts(projectRoot?: string): SupabasePorts;
+/**
+ * Database connection defaults
+ *
+ * AI HINT: Environment variables take priority over hardcoded defaults
+ * Production requires DATABASE_URL to be explicitly set
+ * Local development requires Supabase to be running (ports detected via `supabase status`)
+ */
+export declare const DATABASE_DEFAULTS: {
+    readonly SUPABASE_LOCAL: {
+        readonly HOST: "127.0.0.1";
+        readonly PORT: number;
+        readonly USER: "postgres";
+        readonly PASSWORD: "postgres";
+        readonly DATABASE: "postgres";
+    };
+    readonly POSTGRES: {
+        readonly HOST: "127.0.0.1";
+        readonly PORT: 5432;
+        readonly USER: "postgres";
+        readonly PASSWORD: "";
+        readonly DATABASE: "postgres";
+    };
+    readonly CONNECTION_TIMEOUT_MS: 5000;
+    readonly SCRIPT_TIMEOUT_MS: 300000;
+    readonly defaultUrl: string;
+};
+/**
+ * Seed data defaults
+ *
+ * Note: helpers/ directory was removed - UUIDs are now generated inline
+ * by generate-auth-seeds.ts using Node.js crypto (UUID v5)
+ */
+export declare const SEED_DEFAULTS: {
+    readonly REQUIRED_FILES: readonly ["ci.sql"];
+    readonly DEFAULT_PATHS: readonly ["./seeds/[0-9]*.sql", "./seeds/ci.sql"];
+    readonly CONFIG_SECTION: "[db.seed]";
+};
+/**
+ * Supabase script locations
+ */
+export declare const SCRIPT_LOCATIONS: Record<string, ScriptLocation>;
+/**
+ * Error messages
+ */
+export declare const ERROR_MESSAGES: {
+    readonly SCRIPT_NOT_FOUND: (scriptName: string, expectedPath: string) => string;
+    readonly SEED_DIR_NOT_FOUND: "Seed directory not found\n\nRun: runa db seed init";
+    readonly CONFIG_PARSE_FAILED: "Failed to parse config.toml, using default seed paths";
+    readonly VALIDATION_FAILED: "Schema validation failed";
+    readonly RISK_DETECTION_FAILED: "Risk detection failed";
+    readonly SEED_VALIDATION_FAILED: "Seed validation failed";
+    readonly TYPE_GENERATION_FAILED: "Type generation failed";
+};
+/**
+ * Get Supabase access points from running instance.
+ *
+ * @param projectRoot - Project root directory (defaults to process.cwd())
+ * @returns Access point URLs
+ * @throws Error if Supabase is not running
+ */
+export declare function getSupabaseAccessPoints(projectRoot?: string): {
+    studio: string;
+    api: string;
+    db: string;
+};
+export {};
+//# sourceMappingURL=constants.d.ts.map

package/dist/commands/db/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/commands/db/constants.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAMjD,UAAU,aAAa;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,aAAa,CA6DvE;AAED;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB;;;uBAKd,MAAM;;;;;;;;;;;;;;yBAuBF,MAAM;CA+ChB,CAAC;AAEX;;;;;GAKG;AACH,eAAO,MAAM,aAAa;;;;CAYhB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CA0BlD,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,cAAc;4CACM,MAAM,gBAAgB,MAAM;;;;;;;CAQnD,CAAC;AAEX;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG;IAC7D,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,EAAE,MAAM,CAAC;CACZ,CAOA"}

package/dist/commands/db/extension-registry.d.ts

@@ -0,0 +1,81 @@
+/**
+ * AI HINT: PostgreSQL Extension Registry
+ *
+ * Purpose: Central registry of supported PostgreSQL extensions with metadata
+ * Usage: Import EXTENSION_REGISTRY to get extension definitions
+ *
+ * Supported extensions:
+ * - pgvector: Vector similarity search (AI/embeddings)
+ * - postgis: Geographic/spatial data
+ * - pg_trgm: Fuzzy text search
+ * - pg_stat_statements: Query monitoring
+ */
+export type ExtensionCategory = 'vector' | 'spatial' | 'search' | 'monitoring' | 'api' | 'utility' | 'testing';
+export type SupabaseSupport = 'builtin' | 'available' | 'manual';
+export interface DrizzleTypeMapping {
+    /** Type name to import */
+    typeName: string;
+    /** Import path (relative to database package, e.g., './extensions/pgvector') */
+    importPath: string;
+}
+export interface ZodSchemaMapping {
+    /** PostgreSQL type name (or pattern to match) */
+    typeName: string;
+    /** Zod schema definition string */
+    schema: string;
+}
+export interface ExtensionDefinition {
+    /** Extension name (as used in CREATE EXTENSION) */
+    name: string;
+    /** Display name for UI */
+    displayName: string;
+    /** Short description */
+    description: string;
+    /** Category for grouping */
+    category: ExtensionCategory;
+    /** Supabase availability status */
+    supabaseSupport: SupabaseSupport;
+    /** Required npm packages */
+    npmPackages?: string[];
+    /** Optional prerequisite extensions */
+    prerequisites?: string[];
+    /** SQL to enable the extension */
+    enableSQL: string;
+    /** SQL to disable the extension */
+    disableSQL: string;
+    /** SQL to check if extension is enabled */
+    checkSQL: string;
+    /** Drizzle custom type definitions available */
+    drizzleTypes?: DrizzleTypeMapping[];
+    /** Zod schema mappings for type generation */
+    zodSchemas?: ZodSchemaMapping[];
+    /** Documentation URL */
+    docsUrl: string;
+    /** Template file name in sdk/templates/db/extensions/ */
+    templateFile?: string;
+    /** Additional setup notes */
+    notes?: string;
+}
+export declare const EXTENSION_REGISTRY: Record<string, ExtensionDefinition>;
+/**
+ * Get extension definition by name
+ * Supports both common names (pgvector) and PostgreSQL names (vector)
+ */
+export declare function getExtension(name: string): ExtensionDefinition | undefined;
+/**
+ * Get all extensions in a category
+ */
+export declare function getExtensionsByCategory(category: ExtensionCategory): ExtensionDefinition[];
+/**
+ * Get all Zod schema mappings from enabled extensions
+ */
+export declare function getAllZodSchemaMappings(): ZodSchemaMapping[];
+/**
+ * Check if a PostgreSQL type name matches an extension type
+ */
+export declare function matchExtensionType(pgType: string): ZodSchemaMapping | undefined;
+/**
+ * Get category display name
+ */
+export declare function getCategoryDisplayName(category: ExtensionCategory): string;
+//# sourceMappingURL=extension-registry.d.ts.map

package/dist/commands/db/extension-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-registry.d.ts","sourceRoot":"","sources":["../../../src/commands/db/extension-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,MAAM,MAAM,iBAAiB,GACzB,QAAQ,GACR,SAAS,GACT,QAAQ,GACR,YAAY,GACZ,KAAK,GACL,SAAS,GACT,SAAS,CAAC;AAEd,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;AAEjE,MAAM,WAAW,kBAAkB;IACjC,0BAA0B;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,gFAAgF;IAChF,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,iDAAiD;IACjD,QAAQ,EAAE,MAAM,CAAC;IACjB,mCAAmC;IACnC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAC;IAEb,0BAA0B;IAC1B,WAAW,EAAE,MAAM,CAAC;IAEpB,wBAAwB;IACxB,WAAW,EAAE,MAAM,CAAC;IAEpB,4BAA4B;IAC5B,QAAQ,EAAE,iBAAiB,CAAC;IAE5B,mCAAmC;IACnC,eAAe,EAAE,eAAe,CAAC;IAEjC,4BAA4B;IAC5B,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IAEvB,uCAAuC;IACvC,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IAEzB,kCAAkC;IAClC,SAAS,EAAE,MAAM,CAAC;IAElB,mCAAmC;IACnC,UAAU,EAAE,MAAM,CAAC;IAEnB,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,CAAC;IAEjB,gDAAgD;IAChD,YAAY,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAEpC,8CAA8C;IAC9C,UAAU,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAEhC,wBAAwB;IACxB,OAAO,EAAE,MAAM,CAAC;IAEhB,yDAAyD;IACzD,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,6BAA6B;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAMD,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAwNlE,CAAC;AAMF;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS,CAQ1E;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,mBAAmB,EAAE,CAE1F;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,gBAAgB,EAAE,CAE5D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAY/E;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,MAAM,CAW1E"}

package/dist/commands/db/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * AI HINT: Public API for runa db command
+ *
+ * Purpose: Export all db commands and useful utilities
+ * Design: Clean barrel export pattern with programmatic API
+ */
+import { Command } from 'commander';
+export declare const dbCommand: Command;
+export { DATABASE_DEFAULTS, SCRIPT_LOCATIONS, SEED_DEFAULTS, } from './constants.js';
+export type { DatabaseConfig, DbCommandOptions, ExecaError, RiskLevel, RiskResult, SchemaValidationResult, ScriptExecutionOptions, ScriptLocation, SeedConfig, SeedValidationResult, } from './types.js';
+export { type RunaDbEnv, resolveDatabaseUrl, tryResolveDatabaseUrl, } from './utils/db-target.js';
+export { buildConnectionString, getLocalDbUrl, parseDatabaseUrl, } from './utils/db-url-builder.js';
+export { formatDatabaseError, handleRiskError, handleSeedError, handleValidationError, } from './utils/error-handlers.js';
+export { type PreflightCheckResult, runPreflightChecks } from './utils/preflight-check.js';
+export { findScriptPath, handleScriptError, runSupabaseScript } from './utils/script-runner.js';
+export { applySeedFile, applySeeds, parseSeedPaths, validateSqlContent, } from './utils/seed-manager.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/commands/db/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/db/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAsCpC,eAAO,MAAM,SAAS,SAA6E,CAAC;AA0FpG,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,GACd,MAAM,gBAAgB,CAAC;AAExB,YAAY,EACV,cAAc,EACd,gBAAgB,EAChB,UAAU,EACV,SAAS,EACT,UAAU,EACV,sBAAsB,EACtB,sBAAsB,EACtB,cAAc,EACd,UAAU,EACV,oBAAoB,GACrB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,KAAK,SAAS,EACd,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,qBAAqB,EACrB,aAAa,EACb,gBAAgB,GACjB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,eAAe,EACf,qBAAqB,GACtB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,KAAK,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAC3F,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAChG,OAAO,EACL,aAAa,EACb,UAAU,EACV,cAAc,EACd,kBAAkB,GACnB,MAAM,yBAAyB,CAAC"}

package/dist/commands/db/preflight/actors.d.ts

@@ -0,0 +1,6 @@
+import type { DbPreflightInput, DbPreflightOutput } from './contract.js';
+/**
+ * Run all preflight checks
+ */
+export declare function runDataQualityChecks(input: DbPreflightInput, targetDir: string): Promise<DbPreflightOutput>;
+//# sourceMappingURL=actors.d.ts.map

package/dist/commands/db/preflight/actors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"actors.d.ts","sourceRoot":"","sources":["../../../../src/commands/db/preflight/actors.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAe,gBAAgB,EAAE,iBAAiB,EAAa,MAAM,eAAe,CAAC;AA2GjG;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,gBAAgB,EACvB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,iBAAiB,CAAC,CAuD5B"}

package/dist/commands/db/preflight/contract.d.ts

@@ -0,0 +1,53 @@
+/**
+ * AI HINT: db preflight Command Contract
+ *
+ * Purpose: Pre-flight data quality check for production deployments
+ * Used by: deploy-db.yml workflow before pg-schema-diff
+ * Design: Zod I/O schemas for type-safe CLI interface
+ */
+import { z } from 'zod';
+export declare const DbPreflightInputSchema: z.ZodObject<{
+    env: z.ZodDefault<z.ZodEnum<{
+        local: "local";
+        preview: "preview";
+        production: "production";
+    }>>;
+    databaseUrl: z.ZodOptional<z.ZodString>;
+    verbose: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+export type DbPreflightInput = z.infer<typeof DbPreflightInputSchema>;
+export declare const ViolationSchema: z.ZodObject<{
+    schema: z.ZodString;
+    table: z.ZodString;
+    count: z.ZodNumber;
+    checkName: z.ZodString;
+}, z.core.$strip>;
+export type Violation = z.infer<typeof ViolationSchema>;
+export declare const CheckResultSchema: z.ZodObject<{
+    name: z.ZodString;
+    passed: z.ZodBoolean;
+    violations: z.ZodArray<z.ZodObject<{
+        schema: z.ZodString;
+        table: z.ZodString;
+        count: z.ZodNumber;
+        checkName: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type CheckResult = z.infer<typeof CheckResultSchema>;
+export declare const DbPreflightOutputSchema: z.ZodObject<{
+    success: z.ZodBoolean;
+    schemas: z.ZodArray<z.ZodString>;
+    checks: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        passed: z.ZodBoolean;
+        violations: z.ZodArray<z.ZodObject<{
+            schema: z.ZodString;
+            table: z.ZodString;
+            count: z.ZodNumber;
+            checkName: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    error: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type DbPreflightOutput = z.infer<typeof DbPreflightOutputSchema>;
+//# sourceMappingURL=contract.d.ts.map

package/dist/commands/db/preflight/contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../../../src/commands/db/preflight/contract.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,eAAO,MAAM,sBAAsB;;;;;;;;iBAOjC,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAMtE,eAAO,MAAM,eAAe;;;;;iBAS1B,CAAC;AAEH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAMxD,eAAO,MAAM,iBAAiB;;;;;;;;;iBAO5B,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAM5D,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;iBASlC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC"}

package/dist/commands/db/preflight/index.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare const preflightCommand: Command;
+//# sourceMappingURL=index.d.ts.map

package/dist/commands/db/preflight/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/commands/db/preflight/index.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAqEpC,eAAO,MAAM,gBAAgB,SAgDzB,CAAC"}

package/dist/commands/db/sync/actors.d.ts

@@ -0,0 +1,93 @@
+/**
+ * AI HINT: DB Sync Actors (fromPromise wrappers)
+ *
+ * Purpose: Wrap step functions as XState actors
+ * Pattern: Each actor is a pure async function (input → output)
+ *
+ * Actors:
+ * - setupContext: Resolve database URL and paths
+ * - reconcile: Pre-push reconciliation (orphan cleanup)
+ * - preflight: Schema consistency checks
+ * - snapshot: Create auto-snapshot for rollback
+ * - syncSchema: Apply schema via SDK syncDatabase
+ * - report: Write step summary and export JSON
+ */
+import type { DbSyncMachineInput, StepContext } from './contract.js';
+export interface SetupInput {
+    input: DbSyncMachineInput;
+}
+export interface SetupOutput {
+    repoRoot: string;
+    tmpDir: string;
+    databaseUrl: string;
+    dbPackagePath: string;
+}
+/**
+ * Resolve database URL and package paths
+ */
+export declare const setupContext: import("xstate").PromiseActorLogic<SetupOutput, SetupInput, import("xstate").EventObject>;
+export interface ReconcileInput {
+    ctx: StepContext;
+    autoApprove: boolean;
+    force: boolean;
+}
+/**
+ * Pre-push reconciliation (orphan cleanup)
+ */
+export declare const reconcile: import("xstate").PromiseActorLogic<{
+    passed: boolean;
+    databaseUrl?: string | undefined;
+    dbPackagePath?: string | undefined;
+    error?: string | undefined;
+}, ReconcileInput, import("xstate").EventObject>;
+export interface PreflightInput {
+    ctx: StepContext;
+}
+/**
+ * Run preflight checks (schema consistency)
+ */
+export declare const preflight: import("xstate").PromiseActorLogic<{
+    passed: boolean;
+    warnings?: string[] | undefined;
+    error?: string | undefined;
+}, PreflightInput, import("xstate").EventObject>;
+export interface SnapshotInput {
+    ctx: StepContext;
+    autoSnapshot: boolean;
+}
+/**
+ * Create auto-snapshot for rollback safety
+ */
+export declare const snapshot: import("xstate").PromiseActorLogic<{
+    created: boolean;
+    path?: string | undefined;
+    skipped?: boolean | undefined;
+    reason?: string | undefined;
+}, SnapshotInput, import("xstate").EventObject>;
+export interface SyncInput {
+    ctx: StepContext;
+}
+/**
+ * Apply schema via SDK syncDatabase
+ */
+export declare const syncSchema: import("xstate").PromiseActorLogic<{
+    applied: boolean;
+    stepsCompleted: string[];
+    error?: string | undefined;
+}, SyncInput, import("xstate").EventObject>;
+export interface ReportInput {
+    ctx: StepContext;
+    startTime: number;
+    stepsCompleted: string[];
+    success: boolean;
+    error?: string;
+}
+export interface ReportOutput {
+    written: boolean;
+    reportJsonPath?: string;
+}
+/**
+ * Write step summary and export JSON report
+ */
+export declare const writeReport: import("xstate").PromiseActorLogic<ReportOutput, ReportInput, import("xstate").EventObject>;
+//# sourceMappingURL=actors.d.ts.map

package/dist/commands/db/sync/actors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"actors.d.ts","sourceRoot":"","sources":["../../../../src/commands/db/sync/actors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAuBH,OAAO,KAAK,EACV,kBAAkB,EAIlB,WAAW,EAEZ,MAAM,eAAe,CAAC;AAMvB,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,kBAAkB,CAAC;CAC3B;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;CACvB;AA+CD;;GAEG;AACH,eAAO,MAAM,YAAY,2FAuBxB,CAAC;AAMF,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,WAAW,CAAC;IACjB,WAAW,EAAE,OAAO,CAAC;IACrB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED;;GAEG;AACH,eAAO,MAAM,SAAS;;;;;gDAgErB,CAAC;AAMF,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,WAAW,CAAC;CAClB;AAED;;GAEG;AACH,eAAO,MAAM,SAAS;;;;gDA2BrB,CAAC;AAMF,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,WAAW,CAAC;IACjB,YAAY,EAAE,OAAO,CAAC;CACvB;AAED;;GAEG;AACH,eAAO,MAAM,QAAQ;;;;;+CAsCpB,CAAC;AAMF,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,WAAW,CAAC;CAClB;AAED;;GAEG;AACH,eAAO,MAAM,UAAU;;;;2CA8BtB,CAAC;AAMF,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,WAAW,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,eAAO,MAAM,WAAW,6FA0FvB,CAAC"}

package/dist/commands/db/sync/contract.d.ts

@@ -0,0 +1,155 @@
+/**
+ * AI HINT: DB Sync Command Contract
+ *
+ * Purpose: Zod schemas for db sync command I/O validation
+ * Pattern: Contract-first design - all inputs/outputs strictly typed
+ *
+ * Flow: reconcile → preflight → snapshot → sync → report → done
+ *
+ * CLI Entry Points:
+ * - runa db sync local        # Local development
+ * - runa db sync preview      # Preview/Branch DB
+ * - runa db sync production   # Production (requires --auto-approve in CI)
+ * - runa db sync --check      # Dry-run mode
+ */
+import { z } from 'zod';
+/**
+ * Environment type for db sync
+ */
+export declare const DbSyncEnvSchema: z.ZodEnum<{
+    local: "local";
+    preview: "preview";
+    production: "production";
+}>;
+export type DbSyncEnv = z.infer<typeof DbSyncEnvSchema>;
+/**
+ * CLI input for db sync command
+ */
+export declare const DbSyncInputSchema: z.ZodObject<{
+    env: z.ZodDefault<z.ZodEnum<{
+        local: "local";
+        preview: "preview";
+        production: "production";
+    }>>;
+    check: z.ZodDefault<z.ZodBoolean>;
+    force: z.ZodDefault<z.ZodBoolean>;
+    autoApprove: z.ZodDefault<z.ZodBoolean>;
+    verbose: z.ZodDefault<z.ZodBoolean>;
+    skipCodegen: z.ZodDefault<z.ZodBoolean>;
+    targetDir: z.ZodOptional<z.ZodString>;
+    fromProduction: z.ZodDefault<z.ZodBoolean>;
+    autoSnapshot: z.ZodDefault<z.ZodBoolean>;
+    reportJson: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type DbSyncInput = z.infer<typeof DbSyncInputSchema>;
+/**
+ * Step result type
+ */
+export declare const StepResultSchema: z.ZodEnum<{
+    passed: "passed";
+    failed: "failed";
+    skipped: "skipped";
+}>;
+export type StepResult = z.infer<typeof StepResultSchema>;
+/**
+ * Reconcile result (environment check)
+ */
+export declare const ReconcileResultSchema: z.ZodObject<{
+    passed: z.ZodBoolean;
+    databaseUrl: z.ZodOptional<z.ZodString>;
+    dbPackagePath: z.ZodOptional<z.ZodString>;
+    error: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ReconcileResult = z.infer<typeof ReconcileResultSchema>;
+/**
+ * Preflight result (environment validation)
+ */
+export declare const PreflightResultSchema: z.ZodObject<{
+    passed: z.ZodBoolean;
+    warnings: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    error: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type PreflightResult = z.infer<typeof PreflightResultSchema>;
+/**
+ * Snapshot result (auto-snapshot creation)
+ */
+export declare const SnapshotResultSchema: z.ZodObject<{
+    created: z.ZodBoolean;
+    path: z.ZodOptional<z.ZodString>;
+    skipped: z.ZodOptional<z.ZodBoolean>;
+    reason: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type SnapshotResult = z.infer<typeof SnapshotResultSchema>;
+/**
+ * Sync result (schema push)
+ */
+export declare const SyncResultSchema: z.ZodObject<{
+    applied: z.ZodBoolean;
+    stepsCompleted: z.ZodArray<z.ZodString>;
+    error: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type SyncResult = z.infer<typeof SyncResultSchema>;
+/**
+ * Step context (shared between steps)
+ */
+export declare const StepContextSchema: z.ZodObject<{
+    repoRoot: z.ZodString;
+    tmpDir: z.ZodString;
+    databaseUrl: z.ZodString;
+    dbPackagePath: z.ZodString;
+    env: z.ZodEnum<{
+        local: "local";
+        preview: "preview";
+        production: "production";
+    }>;
+    check: z.ZodBoolean;
+    force: z.ZodBoolean;
+    verbose: z.ZodBoolean;
+    skipCodegen: z.ZodBoolean;
+    fromProduction: z.ZodBoolean;
+    autoSnapshot: z.ZodBoolean;
+    reportJson: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type StepContext = z.infer<typeof StepContextSchema>;
+/**
+ * DB sync command result
+ */
+export declare const DbSyncOutputSchema: z.ZodObject<{
+    env: z.ZodEnum<{
+        local: "local";
+        preview: "preview";
+        production: "production";
+    }>;
+    check: z.ZodBoolean;
+    reconciled: z.ZodBoolean;
+    preflightPassed: z.ZodBoolean;
+    snapshotCreated: z.ZodBoolean;
+    applied: z.ZodBoolean;
+    stepsCompleted: z.ZodArray<z.ZodString>;
+    reportJsonPath: z.ZodOptional<z.ZodString>;
+    exitCode: z.ZodUnion<readonly [z.ZodLiteral<0>, z.ZodLiteral<1>]>;
+    error: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type DbSyncOutput = z.infer<typeof DbSyncOutputSchema>;
+/**
+ * Machine input (passed to createActor)
+ */
+export declare const DbSyncMachineInputSchema: z.ZodObject<{
+    env: z.ZodOptional<z.ZodEnum<{
+        local: "local";
+        preview: "preview";
+        production: "production";
+    }>>;
+    check: z.ZodOptional<z.ZodBoolean>;
+    force: z.ZodOptional<z.ZodBoolean>;
+    autoApprove: z.ZodOptional<z.ZodBoolean>;
+    verbose: z.ZodOptional<z.ZodBoolean>;
+    skipCodegen: z.ZodOptional<z.ZodBoolean>;
+    targetDir: z.ZodOptional<z.ZodString>;
+    fromProduction: z.ZodOptional<z.ZodBoolean>;
+    autoSnapshot: z.ZodOptional<z.ZodBoolean>;
+    reportJson: z.ZodOptional<z.ZodString>;
+    reconcile: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type DbSyncMachineInput = z.infer<typeof DbSyncMachineInputSchema>;
+//# sourceMappingURL=contract.d.ts.map

package/dist/commands/db/sync/contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../../../src/commands/db/sync/contract.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB;;GAEG;AACH,eAAO,MAAM,eAAe;;;;EAA6C,CAAC;AAE1E,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAExD;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;kBAuBnB,CAAC;AAEZ,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAM5D;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;EAA0C,CAAC;AAExE,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;iBAKhC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;iBAIhC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;iBAK/B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;iBAI3B,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;iBAa5B,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAM5D;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;kBAuBpB,CAAC;AAEZ,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAM9D;;GAEG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;iBAanC,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC"}

package/dist/commands/db/sync/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * AI HINT: DB Sync Module Exports
+ *
+ * Purpose: Barrel export for db sync XState machine implementation
+ * Pattern: Co-located machine, actors, contract, and tests
+ */
+export * from './actors.js';
+export * from './contract.js';
+export * from './machine.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/commands/db/sync/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/commands/db/sync/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC"}