@runa-ai/runa-cli 0.5.26

package/dist/schemas/ci.config.schema.json

@@ -0,0 +1,206 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.runa.dev/ci.config.schema.json",
+  "title": "runa CI Config",
+  "type": "object",
+  "additionalProperties": true,
+  "properties": {
+    "ci": {
+      "type": "object",
+      "additionalProperties": true,
+      "properties": {
+        "contractVersion": {
+          "type": "integer",
+          "minimum": 1,
+          "default": 1,
+          "description": "Config contract version. Unknown keys must be ignored for forward compatibility."
+        },
+        "pr": {
+          "type": "object",
+          "additionalProperties": true,
+          "properties": {
+            "profile": {
+              "type": "string",
+              "enum": ["pj-stable", "runa-strict"],
+              "description": "Preferred over many knobs. Defaults depend on repo kind."
+            },
+            "requireBranchDb": {
+              "type": "boolean",
+              "description": "If true, PR CI requires Branch DB inputs. If false, PR CI may run without Branch DB (pj-repo friendly)."
+            },
+            "allowLocalFallback": {
+              "type": "boolean",
+              "description": "If true and Branch inputs are missing/unavailable, PR CI can fall back to local DB mode."
+            },
+            "allowPartialPhases": {
+              "type": "boolean",
+              "description": "Advanced. If false, CI forbids --phase branch-db|test and requires --phase all."
+            },
+            "layers": {
+              "type": "object",
+              "additionalProperties": true,
+              "properties": {
+                "strategy": {
+                  "type": "string",
+                  "enum": ["all", "changed-files"],
+                  "description": "Layer selection strategy. Local defaults to all; CI defaults to changed-files."
+                },
+                "force": {
+                  "type": ["array", "null"],
+                  "items": { "type": "integer", "minimum": 1, "maximum": 5 },
+                  "description": "Force specific layers, e.g. [1,2,3,4,5]. Null means not forcing."
+                },
+                "skip": {
+                  "type": "array",
+                  "items": { "type": "integer", "minimum": 1, "maximum": 5 },
+                  "default": [],
+                  "description": "Explicit skip list (advanced)."
+                }
+              }
+            },
+            "seed": {
+              "type": "object",
+              "additionalProperties": true,
+              "properties": {
+                "strategy": {
+                  "type": "string",
+                  "enum": ["verify-only", "apply-if-needed", "none"],
+                  "description": "Seed strategy for preview/local DB preparation."
+                },
+                "verify": {
+                  "type": "object",
+                  "additionalProperties": true,
+                  "properties": {
+                    "minNonEmptyTables": {
+                      "type": "integer",
+                      "minimum": 0,
+                      "default": 1
+                    },
+                    "maxTablesToCheck": {
+                      "type": "integer",
+                      "minimum": 1,
+                      "default": 5
+                    }
+                  }
+                }
+              }
+            },
+            "remediation": {
+              "type": "object",
+              "additionalProperties": true,
+              "properties": {
+                "db": {
+                  "type": "object",
+                  "additionalProperties": true,
+                  "properties": {
+                    "ensurePgTap": {
+                      "type": "boolean",
+                      "default": false,
+                      "description": "Opt-in. Allow CI to attempt installing pgTAP extension (DDL) when available."
+                    },
+                    "alignRlsRoles": {
+                      "type": "boolean",
+                      "default": false,
+                      "description": "Opt-in. Allow CI to attempt aligning app role membership for policies written as TO authenticated (GRANT)."
+                    }
+                  }
+                }
+              }
+            },
+            "gates": {
+              "type": "object",
+              "additionalProperties": true,
+              "properties": {
+                "enabled": {
+                  "type": "boolean",
+                  "default": true,
+                  "description": "Enable capability-based gates (read-only, no DML probes)."
+                },
+                "layer3": {
+                  "type": "object",
+                  "additionalProperties": true,
+                  "properties": {
+                    "requireCapabilities": {
+                      "type": "array",
+                      "items": { "type": "string" },
+                      "description": "Capabilities required before running Layer3."
+                    },
+                    "forbidAdminExecution": {
+                      "type": "boolean",
+                      "description": "If true, Layer3 must not silently fall back to admin execution."
+                    }
+                  }
+                },
+                "layer4": {
+                  "type": "object",
+                  "additionalProperties": true,
+                  "properties": {
+                    "requireCapabilities": {
+                      "type": "array",
+                      "items": { "type": "string" },
+                      "description": "Capabilities required before running Layer4."
+                    }
+                  }
+                }
+              }
+            },
+            "layer4": {
+              "type": "object",
+              "additionalProperties": true,
+              "properties": {
+                "uiContract": {
+                  "type": "object",
+                  "additionalProperties": true,
+                  "properties": {
+                    "mode": {
+                      "type": "string",
+                      "enum": ["strict", "skip-if-missing"],
+                      "description": "UI contract mode for generated E2E (Layer4)."
+                    }
+                  }
+                },
+                "scenario": {
+                  "type": "object",
+                  "additionalProperties": true,
+                  "properties": {
+                    "onUnknown": {
+                      "type": "string",
+                      "enum": ["skip", "fail"],
+                      "description": "How to treat generated unknown scenarios (contract mismatch)."
+                    }
+                  }
+                },
+                "generated": {
+                  "type": "object",
+                  "additionalProperties": true,
+                  "description": "Settings for auto-generated E2E tests (.runa/tests/layer4/).",
+                  "properties": {
+                    "onFailure": {
+                      "type": "string",
+                      "enum": ["fail", "warn", "skip"],
+                      "default": "warn",
+                      "description": "How to treat failures in generated tests. 'warn' logs failure but CI passes. 'fail' blocks CI. 'skip' skips generated tests entirely."
+                    }
+                  }
+                },
+                "core": {
+                  "type": "object",
+                  "additionalProperties": true,
+                  "description": "Settings for core/manual E2E tests (always required to pass).",
+                  "properties": {
+                    "patterns": {
+                      "type": "array",
+                      "items": { "type": "string" },
+                      "default": ["tests/e2e/**/*.spec.ts", "apps/*/tests/e2e/**/*.spec.ts"],
+                      "description": "Glob patterns for core E2E tests. Failures in these tests will always fail CI."
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+}

package/dist/ui/components/db-panel.d.ts

@@ -0,0 +1,12 @@
+/**
+ * AI HINT: Database operations panel for TUI dashboard
+ *
+ * Purpose: Display database status and operations
+ * Features: Schema status, migration history, connection info
+ */
+export interface DbPanelProps {
+    isActive: boolean;
+    lastUpdate: Date;
+}
+export declare function DbPanel({ isActive, lastUpdate }: DbPanelProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=db-panel.d.ts.map

package/dist/ui/components/db-panel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"db-panel.d.ts","sourceRoot":"","sources":["../../../src/ui/components/db-panel.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,IAAI,CAAC;CAClB;AAUD,wBAAgB,OAAO,CAAC,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,YAAY,2CA0G7D"}

package/dist/ui/components/status-bar.d.ts

@@ -0,0 +1,6 @@
+export interface StatusBarProps {
+    activePanel: 'test' | 'db';
+    lastUpdate: Date;
+}
+export declare function StatusBar({ activePanel, lastUpdate }: StatusBarProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=status-bar.d.ts.map

package/dist/ui/components/status-bar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-bar.d.ts","sourceRoot":"","sources":["../../../src/ui/components/status-bar.tsx"],"names":[],"mappings":"AAEA,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,UAAU,EAAE,IAAI,CAAC;CAClB;AAED,wBAAgB,SAAS,CAAC,EAAE,WAAW,EAAE,UAAU,EAAE,EAAE,cAAc,2CA+BpE"}

package/dist/ui/components/test-panel.d.ts

@@ -0,0 +1,12 @@
+/**
+ * AI HINT: Test execution panel for TUI dashboard
+ *
+ * Purpose: Display real-time test execution status
+ * Features: Test results, progress tracking, layer breakdown
+ */
+export interface TestPanelProps {
+    isActive: boolean;
+    lastUpdate: Date;
+}
+export declare function TestPanel({ isActive, lastUpdate }: TestPanelProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=test-panel.d.ts.map

package/dist/ui/components/test-panel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-panel.d.ts","sourceRoot":"","sources":["../../../src/ui/components/test-panel.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,IAAI,CAAC;CAClB;AAYD,wBAAgB,SAAS,CAAC,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,cAAc,2CAgHjE"}

package/dist/ui/dashboard.d.ts

@@ -0,0 +1,20 @@
+/**
+ * AI HINT: TUI Dashboard component
+ *
+ * Purpose: Interactive terminal UI for CLI operations
+ * Features: Real-time updates, multiple panels, keyboard navigation
+ */
+export interface DashboardProps {
+    mode?: 'test' | 'db' | 'all';
+    autoRefresh?: boolean;
+    refreshInterval?: number;
+}
+export declare function Dashboard({ mode, autoRefresh, refreshInterval, }: DashboardProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Render dashboard to terminal
+ */
+export declare function renderDashboard(props?: DashboardProps): {
+    clear: () => void;
+    unmount: (error?: Error | number | null) => void;
+};
+//# sourceMappingURL=dashboard.d.ts.map

package/dist/ui/dashboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard.d.ts","sourceRoot":"","sources":["../../src/ui/dashboard.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,KAAK,CAAC;IAC7B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAgB,SAAS,CAAC,EACxB,IAAY,EACZ,WAAkB,EAClB,eAAsB,GACvB,EAAE,cAAc,2CA6DhB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,GAAE,cAAmB;;;EAWzD"}

package/dist/ui/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * AI HINT: CLI UI utilities
+ *
+ * Purpose: Export UI libraries for CLI commands
+ */
+export { Box, render, Text } from 'ink';
+export { default as Spinner } from 'ink-spinner';
+import si from 'systeminformation';
+export declare function getSystemInfo(): Promise<{
+    cpu: si.Systeminformation.CpuData;
+    mem: si.Systeminformation.MemData;
+    osInfo: si.Systeminformation.OsData;
+    system: si.Systeminformation.SystemData;
+}>;
+export { si };
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ui/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,CAAC;AACxC,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,aAAa,CAAC;AAGjD,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAEnC,wBAAsB,aAAa;;;;;GAOlC;AAED,OAAO,EAAE,EAAE,EAAE,CAAC"}

package/dist/utils/config-loader.d.ts

@@ -0,0 +1,92 @@
+/**
+ * AI HINT: runa.config.ts Loader
+ *
+ * Purpose: Load and validate runa configuration
+ * Design: Type-safe config loading with sensible defaults
+ *
+ * Key Features:
+ * - Dynamic path resolution (no hardcoded "packages/database")
+ * - Works in both runa-repo (workspace) and pj-repo (npm installed)
+ * - Config-first with smart fallbacks
+ */
+import type { RunaConfig } from '@runa-ai/runa';
+/**
+ * Load runa.config.ts from project root (synchronous)
+ */
+export declare function loadRunaConfig(cwd?: string): RunaConfig;
+/**
+ * Get database configuration with defaults
+ *
+ * Note: 'type' is the database PLATFORM (supabase/none), not the ORM.
+ * Drizzle is always the ORM when using Supabase.
+ */
+export declare function getDatabaseConfig(config: RunaConfig): {
+    type: 'supabase' | 'none';
+    schemaPath: string;
+    outputPath: string;
+};
+/**
+ * Get application configuration with defaults
+ */
+export declare function getAppConfig(config: RunaConfig): {
+    directory: string;
+    framework: 'next' | 'vite' | 'remix';
+};
+/**
+ * Get deployment configuration with defaults
+ */
+export declare function getDeployConfig(config: RunaConfig): {
+    provider: 'vercel' | 'cloudflare' | 'amplify' | 'none';
+    environments: {
+        preview: string;
+        production: string;
+    };
+};
+/**
+ * Check if project is monorepo
+ */
+export declare function isMonorepo(config: RunaConfig): boolean;
+/**
+ * Validate RunaConfig and provide helpful error messages
+ */
+export declare function validateRunaConfig(config: RunaConfig): {
+    valid: boolean;
+    errors: string[];
+};
+/**
+ * Get database package path with smart detection
+ *
+ * Resolution priority:
+ * 1. runa.config.ts: Check monorepo flag and database config
+ * 2. Package detection: findPackage('database')
+ * 3. Conventions: packages/db, db, . (with drizzle.config.ts or supabase/schemas)
+ *
+ * @param cwd - Starting directory (defaults to process.cwd())
+ * @returns Database package path
+ * @throws Error if database package not found
+ */
+export declare function getDatabasePackagePath(cwd?: string): Promise<string>;
+/**
+ * Get SDK scripts directory with smart detection
+ *
+ * Resolution priority:
+ * 1. Workspace package: findPackage('sdk') + '/scripts'
+ * 2. Installed package: node_modules/@runa-ai/runa/scripts
+ * 3. CLI bundled resources (fallback)
+ *
+ * @param cwd - Starting directory (defaults to process.cwd())
+ * @returns SDK scripts directory path
+ * @throws Error if SDK scripts not found
+ */
+export declare function getSDKScriptsPath(cwd?: string): Promise<string>;
+/**
+ * Get SDK templates directory with smart detection
+ *
+ * Used by init command to copy template files
+ *
+ * @param cwd - Starting directory (defaults to process.cwd())
+ * @returns SDK templates directory path
+ * @throws Error if templates not found
+ */
+export declare function getSDKTemplatesPath(cwd?: string): Promise<string>;
+//# sourceMappingURL=config-loader.d.ts.map

package/dist/utils/config-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-loader.d.ts","sourceRoot":"","sources":["../../src/utils/config-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AA0BhD;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,GAAE,MAAsB,GAAG,UAAU,CAGtE;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,UAAU,GAAG;IACrD,IAAI,EAAE,UAAU,GAAG,MAAM,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB,CA6BA;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,UAAU,GAAG;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;CACtC,CAKA;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,UAAU,GAAG;IACnD,QAAQ,EAAE,QAAQ,GAAG,YAAY,GAAG,SAAS,GAAG,MAAM,CAAC;IACvD,YAAY,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;CACvD,CAWA;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAEtD;AAiFD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,UAAU,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAc3F;AAuED;;;;;;;;;;;GAWG;AACH,wBAAsB,sBAAsB,CAAC,GAAG,GAAE,MAAsB,GAAG,OAAO,CAAC,MAAM,CAAC,CA2CzF;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,iBAAiB,CAAC,GAAG,GAAE,MAAsB,GAAG,OAAO,CAAC,MAAM,CAAC,CAiCpF;AAED;;;;;;;;GAQG;AACH,wBAAsB,mBAAmB,CAAC,GAAG,GAAE,MAAsB,GAAG,OAAO,CAAC,MAAM,CAAC,CA6BtF"}

package/dist/utils/config-updater.d.ts

@@ -0,0 +1,44 @@
+/**
+ * AI HINT: runa.config.ts Updater
+ *
+ * Purpose: Update runa.config.ts with detected values (e.g., Vercel root directory)
+ * Design: Uses regex replacement to preserve existing config structure
+ *
+ * Usage:
+ *   await updateRunaConfigAppDirectory('apps/dashboard');
+ */
+/**
+ * Update app.directory in runa.config.ts
+ *
+ * @param appDirectory - The app directory to set (e.g., 'apps/dashboard')
+ * @param targetDir - Project root directory (defaults to cwd)
+ * @returns true if updated, false if not needed or failed
+ */
+export declare function updateRunaConfigAppDirectory(appDirectory: string, targetDir?: string): {
+    updated: boolean;
+    reason: string;
+};
+/**
+ * Sync runa.config.ts with Vercel project settings
+ *
+ * @param targetDir - Project root directory
+ * @param vercelRootDirectory - Root directory from Vercel project
+ * @returns Update result
+ */
+export declare function syncRunaConfigWithVercel(targetDir: string, vercelRootDirectory: string | null): {
+    updated: boolean;
+    field: string;
+    reason: string;
+} | null;
+/**
+ * Update sdkVersion in runa.config.ts
+ *
+ * @param version - The SDK version to set (e.g., '0.2.0')
+ * @param targetDir - Project root directory (defaults to cwd)
+ * @returns true if updated, false if not needed or failed
+ */
+export declare function updateRunaConfigSdkVersion(version: string, targetDir?: string): {
+    updated: boolean;
+    reason: string;
+};
+//# sourceMappingURL=config-updater.d.ts.map

package/dist/utils/config-updater.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-updater.d.ts","sourceRoot":"","sources":["../../src/utils/config-updater.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAC1C,YAAY,EAAE,MAAM,EACpB,SAAS,GAAE,MAAsB,GAChC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAsCtC;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,MAAM,EACjB,mBAAmB,EAAE,MAAM,GAAG,IAAI,GACjC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAW5D;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,MAAM,EACf,SAAS,GAAE,MAAsB,GAChC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAgDtC"}

package/dist/utils/diagnostics.d.ts

@@ -0,0 +1,44 @@
+/**
+ * AI HINT: Diagnostic utilities for error recovery
+ * Purpose: Provide intelligent error diagnosis and recovery suggestions
+ * Features: Port checks, Docker status, environment validation
+ */
+export interface DiagnosticResult {
+    severity: 'error' | 'warning' | 'info';
+    message: string;
+    fixInstructions?: string[];
+    autoFix?: () => Promise<boolean>;
+}
+/**
+ * Check if Docker is running
+ */
+export declare function checkDocker(): Promise<DiagnosticResult>;
+/**
+ * Check if a port is in use
+ */
+export declare function checkPort(port: number): Promise<DiagnosticResult>;
+/**
+ * Check Supabase ports (dynamically detected from config.toml)
+ */
+export declare function checkSupabasePorts(): Promise<DiagnosticResult[]>;
+/**
+ * Check if required environment variables are set
+ */
+export declare function checkEnvironmentVariables(required: string[]): DiagnosticResult[];
+/**
+ * Check if required files exist
+ */
+export declare function checkRequiredFiles(files: string[]): DiagnosticResult[];
+/**
+ * Diagnose Supabase start failure
+ */
+export declare function diagnoseSupabaseStart(): Promise<DiagnosticResult[]>;
+/**
+ * Diagnose database connection failure
+ */
+export declare function diagnoseDatabaseConnection(): Promise<DiagnosticResult[]>;
+/**
+ * Diagnose init command failure
+ */
+export declare function diagnoseInitFailure(errorMessage: string): DiagnosticResult[];
+//# sourceMappingURL=diagnostics.d.ts.map

package/dist/utils/diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../../src/utils/diagnostics.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;CAClC;AAED;;GAEG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAmB7D;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA8BvE;AA0CD;;GAEG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAYtE;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,gBAAgB,EAAE,CAiBhF;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,gBAAgB,EAAE,CActE;AAED;;GAEG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAkBzE;AAED;;GAEG;AACH,wBAAsB,0BAA0B,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAoB9E;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,gBAAgB,EAAE,CA2B5E"}

package/dist/utils/dotenvx.d.ts

@@ -0,0 +1,33 @@
+/**
+ * AI HINT: dotenvx CLI helper
+ *
+ * Purpose: Execute dotenvx commands using bundled dependency
+ * Design: No global install required - uses node_modules version
+ *
+ * Why: The CLI package includes @dotenvx/dotenvx as a dependency,
+ * but execa('dotenvx', ...) looks for global install.
+ * We resolve the CLI path from node_modules and execute with Node.
+ */
+import { type Options as ExecaOptions } from 'execa';
+/**
+ * Execute dotenvx CLI command using bundled dependency
+ *
+ * @param args - Arguments to pass to dotenvx
+ * @param options - execa options (cwd, stdio, etc.)
+ * @returns execa result
+ *
+ * @example
+ * // Check version
+ * await execDotenvx(['--version'], { stdio: 'pipe' });
+ *
+ * // Encrypt file
+ * await execDotenvx(['encrypt', '-f', '.env.development'], { cwd: workDir });
+ */
+export declare function execDotenvx(args: string[], options?: ExecaOptions): Promise<import("execa").Result<ExecaOptions>>;
+/**
+ * Check if dotenvx is available (bundled version)
+ *
+ * @returns true if dotenvx can be executed
+ */
+export declare function isDotenvxAvailable(): Promise<boolean>;
+//# sourceMappingURL=dotenvx.d.ts.map

package/dist/utils/dotenvx.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dotenvx.d.ts","sourceRoot":"","sources":["../../src/utils/dotenvx.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,EAAS,KAAK,OAAO,IAAI,YAAY,EAAE,MAAM,OAAO,CAAC;AAmB5D;;;;;;;;;;;;;GAaG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,YAAY,iDAGvE;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,OAAO,CAAC,CAO3D"}

package/dist/utils/execution-plan.d.ts

@@ -0,0 +1,43 @@
+/**
+ * AI HINT: Execution plan generator for database operations
+ * Purpose: Generate detailed execution plans with impact analysis
+ * Features: Change detection, risk assessment, time estimation
+ * Dynamic: Uses getDatabasePackagePath() for pj-repo compatibility
+ */
+export interface ExecutionStep {
+    description: string;
+    duration?: string;
+    command?: string;
+}
+export interface ImpactAnalysis {
+    tablesAffected: number;
+    estimatedRows?: string;
+    estimatedTime: string;
+    requiresDowntime: boolean;
+}
+export interface Risk {
+    severity: 'low' | 'medium' | 'high';
+    description: string;
+    mitigation?: string;
+}
+export interface SchemaChange {
+    type: 'create' | 'alter' | 'drop' | 'index' | 'function' | 'trigger';
+    description: string;
+    table?: string;
+    risk?: Risk;
+}
+export interface ExecutionPlan {
+    changes: SchemaChange[];
+    steps: ExecutionStep[];
+    impact: ImpactAnalysis;
+    risks: Risk[];
+}
+/**
+ * Get change icon for display
+ */
+export declare function getChangeIcon(type: SchemaChange['type']): string;
+/**
+ * Generate execution plan for database sync
+ */
+export declare function generateExecutionPlan(): Promise<ExecutionPlan>;
+//# sourceMappingURL=execution-plan.d.ts.map

package/dist/utils/execution-plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-plan.d.ts","sourceRoot":"","sources":["../../src/utils/execution-plan.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,IAAI;IACnB,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,UAAU,GAAG,SAAS,CAAC;IACrE,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,IAAI,CAAC;CACb;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,MAAM,EAAE,cAAc,CAAC;IACvB,KAAK,EAAE,IAAI,EAAE,CAAC;CACf;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,YAAY,CAAC,MAAM,CAAC,GAAG,MAAM,CAUhE;AA+ND;;GAEG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,aAAa,CAAC,CAYpE"}

package/dist/utils/help-system.d.ts

@@ -0,0 +1,34 @@
+/**
+ * AI HINT: Contextual help system for error recovery
+ * Purpose: Provide context-aware help based on error patterns
+ * Features: Error pattern matching, documentation links, step-by-step guides
+ */
+export interface ContextualHelp {
+    command: string;
+    errorPattern: RegExp;
+    helpText: string;
+    learnMoreUrl?: string;
+    relatedCommands?: string[];
+}
+/**
+ * Find contextual help for a command and error
+ *
+ * @param command - The command that failed
+ * @param errorMessage - The error message
+ * @returns Contextual help if found, null otherwise
+ */
+export declare function findContextualHelp(command: string, errorMessage: string): ContextualHelp | null;
+/**
+ * Get generic help for a command
+ *
+ * @param command - The command name
+ * @returns Generic help text
+ */
+export declare function getGenericHelp(command: string): string;
+/**
+ * Format and display contextual help
+ *
+ * @param help - Contextual help to display
+ */
+export declare function displayHelp(help: ContextualHelp): void;
+//# sourceMappingURL=help-system.d.ts.map

package/dist/utils/help-system.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"help-system.d.ts","sourceRoot":"","sources":["../../src/utils/help-system.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AA+JD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAI/F;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAgEtD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,CAgBtD"}

package/dist/utils/license/admin-auth.d.ts

@@ -0,0 +1,39 @@
+/**
+ * AI HINT: Admin Authentication & Authorization
+ *
+ * Purpose: Verify admin privileges for allowlist operations
+ * Pattern: Two-layer verification (auth + authz)
+ *
+ * Security model:
+ * 1. Authentication: GitHub CLI logged in
+ * 2. Authorization: Must be member of r06-dev organization
+ *
+ * Why org membership check?
+ * - Anyone can authenticate with GitHub CLI
+ * - Admin operations (allowlist add/remove) must be restricted to org members
+ * - Prevents unauthorized modification of production allowlist
+ */
+/**
+ * Get current GitHub user email for approved_by field
+ *
+ * @returns Email address or undefined if not available
+ */
+export declare function getGitHubUserEmail(): Promise<string | undefined>;
+/**
+ * Verify admin authentication and authorization
+ *
+ * Two-layer verification:
+ * 1. GitHub CLI is authenticated
+ * 2. User is member of r06-dev organization
+ *
+ * @returns Authenticated username
+ * @throws CLIError if not authenticated or not authorized
+ */
+export declare function verifyAdminAuth(): Promise<string>;
+/**
+ * Clear admin verification cache
+ *
+ * @internal For testing purposes
+ */
+export declare function clearAdminAuthCache(): void;
+//# sourceMappingURL=admin-auth.d.ts.map

package/dist/utils/license/admin-auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin-auth.d.ts","sourceRoot":"","sources":["../../../src/utils/license/admin-auth.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAoEH;;;;GAIG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAyBtE;AAED;;;;;;;;;GASG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC,CAoDvD;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C"}