@runa-ai/runa-cli 0.5.26

package/dist/cli/contract-mode.d.ts

@@ -0,0 +1,2 @@
+export declare function enableContractModeIO(): void;
+//# sourceMappingURL=contract-mode.d.ts.map

package/dist/cli/contract-mode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract-mode.d.ts","sourceRoot":"","sources":["../../src/cli/contract-mode.ts"],"names":[],"mappings":"AAiBA,wBAAgB,oBAAoB,IAAI,IAAI,CAgC3C"}

package/dist/cli/contract-output.d.ts

@@ -0,0 +1,4 @@
+import type { Command } from 'commander';
+export declare function markJsonEmitted(): void;
+export declare function emitDefaultSuccessIfNeeded(cmd: Command): void;
+//# sourceMappingURL=contract-output.d.ts.map

package/dist/cli/contract-output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract-output.d.ts","sourceRoot":"","sources":["../../src/cli/contract-output.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAkBzC,wBAAgB,eAAe,IAAI,IAAI,CAEtC;AAED,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAmB7D"}

package/dist/cli/early-flags.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Apply global contract-mode flags before commander parses argv.
+ *
+ * Why:
+ * - Commander treats "global" options as global only when they appear before the subcommand.
+ * - In CI/scripts it's common to run: `runa <cmd> --json` (flag after the command).
+ * - If parsing fails before preAction hooks, we still must emit a JSON error envelope in contract mode.
+ */
+export declare function applyEarlyGlobalFlags(argv: readonly string[]): void;
+//# sourceMappingURL=early-flags.d.ts.map

package/dist/cli/early-flags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"early-flags.d.ts","sourceRoot":"","sources":["../../src/cli/early-flags.ts"],"names":[],"mappings":"AA2DA;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAoBnE"}

package/dist/cli/error-handler.d.ts

@@ -0,0 +1,28 @@
+/**
+ * AI HINT: Global error handler
+ *
+ * Purpose: Unified error handling and formatting for CLI
+ * Catches all unhandled errors and formats them consistently
+ *
+ * Features:
+ * - Error Catalog integration for consistent error codes
+ * - POSIX-aligned exit codes (0-10)
+ * - Intelligent error diagnosis for common pj-repo issues
+ * - Contextual suggestions based on error type
+ * - JSON contract mode for CI/automation
+ *
+ * Error System:
+ * - Exit codes defined in: ../errors/exit-codes.ts
+ * - Error catalog in: ../errors/catalog.ts
+ * - Use createError() for consistent error creation
+ */
+/**
+ * Handle CLI errors with formatted output.
+ *
+ * Error resolution priority:
+ * 1. Error Catalog (if error code matches ERR_RUNA_*)
+ * 2. Pattern-based diagnosis (for external tool errors)
+ * 3. Generic suggestions
+ */
+export declare function handleCLIError(error: unknown): never;
+//# sourceMappingURL=error-handler.d.ts.map

package/dist/cli/error-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handler.d.ts","sourceRoot":"","sources":["../../src/cli/error-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAklBH;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,CAwBpD"}

package/dist/cli/exec.d.ts

@@ -0,0 +1,15 @@
+import { type Options as ExecaOptions } from 'execa';
+type StdioOption = 'inherit' | 'pipe' | 'ignore';
+type NormalizedOptions = ExecaOptions & {
+    stdio?: 'inherit' | readonly [StdioOption, StdioOption, StdioOption];
+};
+/**
+ * Run a child process in a contract-safe way.
+ *
+ * Contract rule:
+ * - When output format is JSON, stdout must be reserved for the final JSON payload.
+ * - Therefore, child process output is always routed to stderr in JSON mode.
+ */
+export declare function runExeca(file: string, args: readonly string[], options?: NormalizedOptions): Promise<void>;
+export {};
+//# sourceMappingURL=exec.d.ts.map

package/dist/cli/exec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec.d.ts","sourceRoot":"","sources":["../../src/cli/exec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,IAAI,YAAY,EAAS,MAAM,OAAO,CAAC;AAG5D,KAAK,WAAW,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEjD,KAAK,iBAAiB,GAAG,YAAY,GAAG;IACtC,KAAK,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC,WAAW,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC;CACtE,CAAC;AAkBF;;;;;;GAMG;AACH,wBAAsB,QAAQ,CAC5B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,IAAI,CAAC,CAiBf"}

package/dist/cli/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * AI HINT: CLI Framework setup
+ *
+ * Purpose: Command registration and program configuration
+ * Separated from main entry point for better organization
+ */
+import { Command } from 'commander';
+/**
+ * Create and configure CLI program
+ */
+export declare function createProgram(): Promise<Command>;
+/**
+ * Execute CLI program
+ */
+export declare function executeProgram(program: Command): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAsHpC;;GAEG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,OAAO,CAAC,CAiJtD;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAiCpE"}

package/dist/cli/json-output.d.ts

@@ -0,0 +1,4 @@
+import type { Command } from 'commander';
+import type { z } from 'zod';
+export declare function emitJsonSuccess<TData>(cmd: Command, dataSchema: z.ZodType<TData>, data: TData): void;
+//# sourceMappingURL=json-output.d.ts.map

package/dist/cli/json-output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-output.d.ts","sourceRoot":"","sources":["../../src/cli/json-output.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAgB7B,wBAAgB,eAAe,CAAC,KAAK,EACnC,GAAG,EAAE,OAAO,EACZ,UAAU,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,EAC5B,IAAI,EAAE,KAAK,GACV,IAAI,CAmBN"}

package/dist/cli/non-interactive.d.ts

@@ -0,0 +1,4 @@
+export declare function isNonInteractiveEnabled(): boolean;
+export declare function enableNonInteractiveMode(): void;
+export declare function assertTtyRequired(featureName: string): void;
+//# sourceMappingURL=non-interactive.d.ts.map

package/dist/cli/non-interactive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"non-interactive.d.ts","sourceRoot":"","sources":["../../src/cli/non-interactive.ts"],"names":[],"mappings":"AAMA,wBAAgB,uBAAuB,IAAI,OAAO,CAKjD;AAED,wBAAgB,wBAAwB,IAAI,IAAI,CAE/C;AAED,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAY3D"}

package/dist/cli/output-format.d.ts

@@ -0,0 +1,5 @@
+export type OutputFormat = 'text' | 'json';
+export declare function getOutputFormatFromEnv(): OutputFormat;
+export declare function setOutputFormat(format: OutputFormat): void;
+export declare function parseOutputFormat(input: unknown): OutputFormat;
+//# sourceMappingURL=output-format.d.ts.map

package/dist/cli/output-format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-format.d.ts","sourceRoot":"","sources":["../../src/cli/output-format.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,CAAC;AAM3C,wBAAgB,sBAAsB,IAAI,YAAY,CAKrD;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAM1D;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,YAAY,CAS9D"}

package/dist/cli/signal-handler.d.ts

@@ -0,0 +1,32 @@
+/**
+ * AI HINT: Signal handling for graceful shutdown
+ *
+ * Purpose: Unified signal handling for CLI
+ * - SIGINT (Ctrl+C): Graceful shutdown with double-press safety
+ * - SIGTERM: Graceful shutdown for containers (K8s/Docker)
+ *
+ * Exit codes:
+ * - 130: SIGINT (128 + 2)
+ * - 143: SIGTERM (128 + 15)
+ */
+type CleanupFn = () => Promise<void> | void;
+/**
+ * Register a cleanup function to run on shutdown
+ */
+export declare function registerCleanup(fn: CleanupFn): void;
+/**
+ * Unregister a cleanup function
+ */
+export declare function unregisterCleanup(fn: CleanupFn): void;
+/**
+ * Setup signal handlers
+ *
+ * Call this once at CLI startup
+ */
+export declare function setupSignalHandlers(): void;
+/**
+ * Check if shutdown is in progress
+ */
+export declare function isShuttingDown(): boolean;
+export {};
+//# sourceMappingURL=signal-handler.d.ts.map

package/dist/cli/signal-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signal-handler.d.ts","sourceRoot":"","sources":["../../src/cli/signal-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH,KAAK,SAAS,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAc5C;;GAEG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,SAAS,GAAG,IAAI,CAEnD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,SAAS,GAAG,IAAI,CAKrD;AAkCD;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAoB1C;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,OAAO,CAExC"}

package/dist/commands/build/actors/build.d.ts

@@ -0,0 +1,32 @@
+/**
+ * AI HINT: Build Actor
+ *
+ * Purpose: Run turbo build with optional E2E mode
+ * Pattern: Fine-grained actor for build step
+ *
+ * E2E Mode:
+ * - Sets NEXT_PUBLIC_E2E_TEST=true (enables xstate-test-plugin)
+ * - Sets TURBO_FORCE=true (clears turbo cache)
+ */
+export interface BuildInput {
+    repoRoot: string;
+    tmpDir: string;
+    hasTurbo: boolean;
+    e2e: boolean;
+    env?: NodeJS.ProcessEnv;
+}
+export interface BuildOutput {
+    passed: boolean;
+    durationMs: number;
+    error?: string;
+}
+/**
+ * Build the application.
+ *
+ * Handles:
+ * - Turbo-enabled monorepos
+ * - Standard pnpm build
+ * - E2E mode (test attribute injection)
+ */
+export declare const buildActor: import("xstate").PromiseActorLogic<BuildOutput, BuildInput, import("xstate").EventObject>;
+//# sourceMappingURL=build.d.ts.map

package/dist/commands/build/actors/build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../../../src/commands/build/actors/build.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAQH,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;IAClB,GAAG,EAAE,OAAO,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACzB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,UAAU,2FAyDtB,CAAC"}

package/dist/commands/build/actors/clean.d.ts

@@ -0,0 +1,36 @@
+/**
+ * AI HINT: Clean Actors
+ *
+ * Purpose: Clean build caches and optionally reinstall dependencies
+ * Pattern: Fine-grained actors for pre-build cleanup
+ *
+ * Actors:
+ * - cleanActor: Delete .next, .turbo, .runa/manifests
+ * - freshActor: Also delete node_modules + reinstall
+ */
+export interface CleanInput {
+    repoRoot: string;
+    tmpDir: string;
+    verbose?: boolean;
+}
+export interface CleanOutput {
+    passed: boolean;
+    deletedPaths: string[];
+    error?: string;
+}
+/**
+ * Clean build caches.
+ * Deletes: .next, .turbo, .runa/manifests, dist
+ */
+export declare const cleanActor: import("xstate").PromiseActorLogic<CleanOutput, CleanInput, import("xstate").EventObject>;
+/**
+ * Fresh install: clean + delete node_modules + reinstall.
+ *
+ * Note: If dependencies break after fresh install, it usually means:
+ * 1. Some packages are not explicitly declared in package.json (relying on hoisting)
+ * 2. pnpm lockfile is out of sync with package.json
+ *
+ * Solution: Add missing dependencies to package.json explicitly.
+ */
+export declare const freshActor: import("xstate").PromiseActorLogic<CleanOutput, CleanInput, import("xstate").EventObject>;
+//# sourceMappingURL=clean.d.ts.map

package/dist/commands/build/actors/clean.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clean.d.ts","sourceRoot":"","sources":["../../../../src/commands/build/actors/clean.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAQH,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,OAAO,CAAC;IAChB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AA8ED;;;GAGG;AACH,eAAO,MAAM,UAAU,2FA0BtB,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,UAAU,2FAoFtB,CAAC"}

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

@@ -0,0 +1,30 @@
+/**
+ * AI HINT: DB Sync Actor
+ *
+ * Purpose: Run runa db sync to sync database schema and generate types
+ * Pattern: Fine-grained actor for database sync step
+ *
+ * What it does:
+ * - Applies SQL schema changes (pg-schema-diff)
+ * - Generates Drizzle types (drizzle-kit introspect)
+ * - Generates Zod schemas (drizzle-zod)
+ */
+export interface DbSyncInput {
+    repoRoot: string;
+    tmpDir: string;
+    env?: NodeJS.ProcessEnv;
+}
+export interface DbSyncOutput {
+    passed: boolean;
+    durationMs: number;
+    error?: string;
+    warning?: string;
+}
+/**
+ * Run database sync.
+ *
+ * Note: This is non-blocking - build should succeed even if db sync fails.
+ * This allows development without a running database.
+ */
+export declare const dbSyncActor: import("xstate").PromiseActorLogic<DbSyncOutput, DbSyncInput, import("xstate").EventObject>;
+//# sourceMappingURL=db-sync.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"db-sync.d.ts","sourceRoot":"","sources":["../../../../src/commands/build/actors/db-sync.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAOH,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACzB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;GAKG;AACH,eAAO,MAAM,WAAW,6FAqEvB,CAAC"}

package/dist/commands/build/actors/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * AI HINT: Build Actors Barrel Export
+ *
+ * Purpose: Export all build actors for machine registration
+ */
+export type { BuildInput, BuildOutput } from './build.js';
+export { buildActor } from './build.js';
+export type { CleanInput, CleanOutput } from './clean.js';
+export { cleanActor, freshActor } from './clean.js';
+export type { DbSyncInput, DbSyncOutput } from './db-sync.js';
+export { dbSyncActor } from './db-sync.js';
+export type { ManifestInput, ManifestOutput } from './manifest.js';
+export { manifestActor } from './manifest.js';
+export type { DepsInstallOutput, EnvCheckOutput, SetupInput, SupabaseStartOutput, } from './setup.js';
+export { checkEnvFiles, checkSupabaseStatus, depsInstallActor, envCheckActor, needsDepsInstall, supabaseStartActor, } from './setup.js';
+export type { StaticChecksInput, StaticChecksOutput } from './static-checks.js';
+export { staticChecksActor } from './static-checks.js';
+export type { ValidateInput, ValidateOutput } from './validate.js';
+export { validateActor } from './validate.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/commands/build/actors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/commands/build/actors/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE1D,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE1D,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACpD,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE9D,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEnE,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,YAAY,EACV,iBAAiB,EACjB,cAAc,EACd,UAAU,EACV,mBAAmB,GACpB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,gBAAgB,EAChB,aAAa,EACb,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAEhF,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEnE,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC"}

package/dist/commands/build/actors/manifest.d.ts

@@ -0,0 +1,34 @@
+/**
+ * AI HINT: Manifest Generation Actor
+ *
+ * Purpose: Generate manifests for E2E test generation
+ * Pattern: Fine-grained actor for manifest generation step
+ *
+ * Generates:
+ * - machines.json: XState machine metadata
+ * - routes.json: Next.js routes (deprecated, manifest.json preferred)
+ * - manifest.json: E2E test manifest (machines + routes)
+ */
+export interface ManifestInput {
+    repoRoot: string;
+    tmpDir: string;
+    env?: NodeJS.ProcessEnv;
+}
+export interface ManifestOutput {
+    passed: boolean;
+    durationMs: number;
+    error?: string;
+    warning?: string;
+}
+/**
+ * Generate manifests for E2E test generation.
+ *
+ * Manifest generation is required for Layer 4 E2E tests.
+ * Without manifest.json, E2E tests will fail to find data-machine-id attributes.
+ *
+ * NOTE: Always uses `runa manifest` directly instead of turbo.
+ * Turbo's --filter=// doesn't reliably find root workspace scripts,
+ * and manifest generation needs to scan the entire monorepo anyway.
+ */
+export declare const manifestActor: import("xstate").PromiseActorLogic<ManifestOutput, ManifestInput, import("xstate").EventObject>;
+//# sourceMappingURL=manifest.d.ts.map

package/dist/commands/build/actors/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../../../src/commands/build/actors/manifest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAOH,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACzB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,aAAa,iGAqCzB,CAAC"}

package/dist/commands/build/actors/setup.d.ts

@@ -0,0 +1,74 @@
+/**
+ * AI HINT: Setup Phase Actors
+ *
+ * Purpose: Auto-detect and fix missing environment prerequisites
+ * Pattern: Smart self-healing - detect what's missing, fix it automatically
+ *
+ * Actors:
+ * - depsInstall: Install dependencies if node_modules missing/outdated
+ * - envCheck: Verify environment variables are configured
+ * - supabaseStart: Start Supabase if configured but not running
+ */
+export interface SetupInput {
+    repoRoot: string;
+    verbose: boolean;
+}
+export interface DepsInstallOutput {
+    needed: boolean;
+    installed: boolean;
+    durationMs: number;
+    error?: string;
+}
+export interface EnvCheckOutput {
+    configured: boolean;
+    missingFiles: string[];
+    warning?: string;
+}
+export interface SupabaseStartOutput {
+    needed: boolean;
+    started: boolean;
+    alreadyRunning: boolean;
+    warning?: string;
+}
+/**
+ * Check if node_modules exists and is not stale.
+ * Stale = package.json is newer than node_modules.
+ */
+declare function needsDepsInstall(repoRoot: string): boolean;
+/**
+ * Check if Supabase is configured and running.
+ * Returns detailed status including port conflict detection.
+ *
+ * Port Detection:
+ * - Each project has its own ports defined in supabase/config.toml
+ * - Ports are calculated from project path hash during `runa init`
+ * - This function checks the project's ACTUAL port, not the default 54322
+ */
+declare function checkSupabaseStatus(repoRoot: string): {
+    configured: boolean;
+    running: boolean;
+    portInUse: boolean;
+    conflictingProject?: string;
+    actualPort?: number;
+};
+/**
+ * Check which .env files are missing.
+ */
+declare function checkEnvFiles(repoRoot: string): string[];
+/**
+ * Install dependencies if needed.
+ */
+export declare const depsInstallActor: import("xstate").PromiseActorLogic<DepsInstallOutput, SetupInput, import("xstate").EventObject>;
+/**
+ * Check environment variables configuration.
+ * Non-blocking - just warns if missing.
+ */
+export declare const envCheckActor: import("xstate").PromiseActorLogic<EnvCheckOutput, SetupInput, import("xstate").EventObject>;
+/**
+ * Start Supabase if configured but not running.
+ * Handles port conflicts gracefully by detecting other Supabase instances.
+ * Non-blocking - just warns if can't start.
+ */
+export declare const supabaseStartActor: import("xstate").PromiseActorLogic<SupabaseStartOutput, SetupInput, import("xstate").EventObject>;
+export { needsDepsInstall, checkSupabaseStatus, checkEnvFiles };
+//# sourceMappingURL=setup.d.ts.map

package/dist/commands/build/actors/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../../../src/commands/build/actors/setup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAYH,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,OAAO,CAAC;IACpB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,EAAE,OAAO,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAMD;;;GAGG;AACH,iBAAS,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAyBnD;AAED;;;;;;;;GAQG;AACH,iBAAS,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG;IAC9C,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;IACnB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CA4DA;AAED;;GAEG;AACH,iBAAS,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAWjD;AAMD;;GAEG;AACH,eAAO,MAAM,gBAAgB,iGAmD5B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,aAAa,8FAiCzB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,mGA8E9B,CAAC;AAGF,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,aAAa,EAAE,CAAC"}

package/dist/commands/build/actors/static-checks.d.ts

@@ -0,0 +1,36 @@
+/**
+ * AI HINT: Static Checks Actor
+ *
+ * Purpose: Run static analysis (type-check, lint) in parallel
+ * Pattern: Reuses pattern from CI machine
+ *
+ * Checks:
+ * - pnpm type-check (TypeScript compilation)
+ * - pnpm lint (Biome format + lint)
+ */
+export interface StaticChecksInput {
+    repoRoot: string;
+    tmpDir: string;
+    hasTurbo: boolean;
+    env?: NodeJS.ProcessEnv;
+    /** Skip type-check (--only doesn't include 'types') */
+    skipTypes?: boolean;
+    /** Skip lint (--only doesn't include 'lint') */
+    skipLint?: boolean;
+}
+export interface StaticChecksOutput {
+    passed: boolean;
+    typeCheckPassed?: boolean;
+    lintPassed?: boolean;
+    typeCheckDurationMs?: number;
+    lintDurationMs?: number;
+    error?: string;
+}
+/**
+ * Run static checks (type-check + lint) in parallel.
+ *
+ * Optimization: Running type-check and lint concurrently saves ~15-30s
+ * compared to sequential execution.
+ */
+export declare const staticChecksActor: import("xstate").PromiseActorLogic<StaticChecksOutput, StaticChecksInput, import("xstate").EventObject>;
+//# sourceMappingURL=static-checks.d.ts.map

package/dist/commands/build/actors/static-checks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"static-checks.d.ts","sourceRoot":"","sources":["../../../../src/commands/build/actors/static-checks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAQH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,uDAAuD;IACvD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,gDAAgD;IAChD,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,OAAO,CAAC;IAChB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AA0CD;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,yGA8E7B,CAAC"}

package/dist/commands/build/actors/validate.d.ts

@@ -0,0 +1,28 @@
+/**
+ * AI HINT: Validate Actor
+ *
+ * Purpose: Post-build validation to ensure outputs exist
+ * Pattern: Fine-grained actor for validation step
+ *
+ * Validates:
+ * - Build outputs exist (dist/, .next/)
+ * - Manifest files exist (if manifest was generated)
+ */
+export interface ValidateInput {
+    repoRoot: string;
+    skipManifest: boolean;
+}
+export interface ValidateOutput {
+    passed: boolean;
+    checks: {
+        buildOutputs: boolean;
+        manifests: boolean;
+    };
+    warnings: string[];
+    error?: string;
+}
+/**
+ * Validate build outputs.
+ */
+export declare const validateActor: import("xstate").PromiseActorLogic<ValidateOutput, ValidateInput, import("xstate").EventObject>;
+//# sourceMappingURL=validate.d.ts.map

package/dist/commands/build/actors/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../../../src/commands/build/actors/validate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE;QACN,YAAY,EAAE,OAAO,CAAC;QACtB,SAAS,EAAE,OAAO,CAAC;KACpB,CAAC;IACF,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,eAAO,MAAM,aAAa,iGAqDzB,CAAC"}

package/dist/commands/build/commands/build.d.ts

@@ -0,0 +1,25 @@
+/**
+ * AI HINT: `runa build` - Build Command Entry Point (like vercel build / next build)
+ *
+ * Purpose: Unified build command for complete dev environment setup
+ * Pattern: Smart self-healing build that auto-detects and fixes prerequisites
+ *
+ * Usage:
+ * - runa build                    # Smart build (auto-setup + type-check + lint + build + db sync + manifest)
+ * - runa build --e2e              # E2E mode (enables test attributes)
+ * - runa build --clean            # Clean build caches first
+ * - runa build --fresh            # Full fresh install + build
+ * - runa build --skip-db          # Skip database sync
+ * - runa build --skip-manifest    # Skip manifest generation
+ * - runa build --no-setup         # Skip auto-setup phase
+ * - runa build --check            # Dry-run (show what would be done)
+ * - runa build --only types       # Type-check only
+ * - runa build --only lint        # Lint only
+ * - runa build --only types,lint  # Type-check + lint only
+ * - runa build --only build       # Turbo build only
+ * - runa build --only db          # DB sync only
+ * - runa build --only manifest    # Manifest generation only
+ */
+import { Command } from 'commander';
+export declare const buildCommand: Command;
+//# sourceMappingURL=build.d.ts.map

package/dist/commands/build/commands/build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../../../src/commands/build/commands/build.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAIH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAyTpC,eAAO,MAAM,YAAY,SA2BrB,CAAC"}