@runa-ai/runa-cli 0.5.72 → 0.7.0

package/dist/env-files-2UIUYLLR.js

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+import { createRequire } from 'module';
+export { loadEnvFiles } from './chunk-644FVGIQ.js';
+import './chunk-DRSUEMAK.js';
+import './chunk-JMJP4A47.js';
+import './chunk-VRXHCR5K.js';
+
+createRequire(import.meta.url);

package/dist/error-handler-HEXBRNVV.js

@@ -0,0 +1,460 @@
+#!/usr/bin/env node
+import { createRequire } from 'module';
+import './chunk-ZZOXM6Q4.js';
+import { ERROR_CATALOG } from './chunk-JQXOVCOP.js';
+import { ErrorEnvelopeSchema, CLI_CONTRACT_VERSION, writeJsonEnvelope } from './chunk-WJXC4MVY.js';
+import { getOutputFormatFromEnv } from './chunk-HKUWEGUX.js';
+import { init_esm_shims } from './chunk-VRXHCR5K.js';
+import { formatCLIError, CLIError, createCLILogger } from '@runa-ai/runa/cli-runtime';
+
+createRequire(import.meta.url);
+
+// src/cli/error-handler.ts
+init_esm_shims();
+function getCommandPathFromArgv(argv) {
+  const parts = [];
+  for (const token of argv) {
+    if (token.startsWith("-")) break;
+    parts.push(token);
+  }
+  return parts.length > 0 ? `runa ${parts.join(" ")}` : "runa";
+}
+function findCatalogEntry(errorCode) {
+  if (!errorCode) return void 0;
+  for (const key of Object.keys(ERROR_CATALOG)) {
+    const entry = ERROR_CATALOG[key];
+    if (entry.code === errorCode) {
+      return entry;
+    }
+  }
+  return void 0;
+}
+function getDocUrlFromCatalog(errorCode) {
+  const entry = findCatalogEntry(errorCode);
+  if (!entry) return void 0;
+  return "docUrl" in entry ? entry.docUrl : void 0;
+}
+var diagnosisRules = [
+  // Package resolution issues (@runa-ai/*)
+  {
+    name: "runa-package-resolution",
+    matches: (msg) => msg.includes("Cannot find module '@runa-ai/runa-"),
+    getSuggestions: () => [
+      "\u{1F527} This error indicates a package resolution issue.",
+      "",
+      "If you are in a pj-repo (not runa monorepo):",
+      "  1. Reinstall packages:",
+      "     rm -rf node_modules pnpm-lock.yaml",
+      "     pnpm install",
+      "",
+      "  2. If the issue persists, update to the latest SDK:",
+      "     pnpm add -D @runa-ai/runa@latest @runa-ai/runa-cli@latest"
+    ]
+  },
+  // GitHub Packages authentication
+  {
+    name: "github-packages-auth",
+    matches: (msg) => msg.includes("401") || msg.includes("403") || msg.includes("UNAUTHORIZED") || msg.includes("npm.pkg.github.com"),
+    getSuggestions: () => [
+      "\u{1F510} GitHub Packages authentication required.",
+      "",
+      "Setup steps:",
+      "  1. Create a GitHub Personal Access Token with `read:packages` scope:",
+      "     https://github.com/settings/tokens/new?scopes=read:packages",
+      "",
+      "  2. Configure npm authentication:",
+      "     npm login --registry=https://npm.pkg.github.com",
+      "     # Username: your GitHub username",
+      "     # Password: your Personal Access Token",
+      "",
+      "  3. Or set the token in your environment:",
+      "     export NODE_AUTH_TOKEN=ghp_your_token_here"
+    ]
+  },
+  // Lint/format errors
+  {
+    name: "lint-format-errors",
+    matches: (msg) => msg.includes("biome check") || msg.includes("lint") && msg.includes("error") || msg.includes("noAssignInExpressions") || msg.includes("noDuplicateTestHooks"),
+    getSuggestions: () => [
+      "\u{1F527} Lint/format errors detected.",
+      "",
+      "Auto-fix safe issues:",
+      "  pnpm biome check --write --unsafe .",
+      "",
+      "Or fix manually and re-run:",
+      "  runa build"
+    ]
+  },
+  // Type errors
+  {
+    name: "type-errors",
+    matches: (msg) => msg.includes("type-check") || msg.includes("TypeScript") || msg.includes("TS2"),
+    getSuggestions: () => [
+      "\u{1F4DD} Type errors detected.",
+      "",
+      "Check type errors:",
+      "  pnpm turbo run type-check",
+      "",
+      "Fix the errors and re-run:",
+      "  runa build"
+    ]
+  },
+  // Database connection issues
+  {
+    name: "database-connection",
+    matches: (msg) => msg.includes("ECONNREFUSED") || msg.includes("connection refused") || msg.includes("DATABASE_URL") || msg.includes("PostgreSQL") || msg.includes("database") && msg.includes("connect"),
+    getSuggestions: () => [
+      "\u{1F5C4}\uFE0F Database connection issue detected.",
+      "",
+      "For local development:",
+      "  1. Start local Supabase:",
+      "     runa db start",
+      "",
+      "  2. Check environment:",
+      "     runa check",
+      "",
+      "  3. Verify your DATABASE_URL in .env.development.local"
+    ]
+  },
+  // Supabase CLI not found
+  {
+    name: "supabase-cli-not-found",
+    matches: (msg) => msg.includes("supabase") && msg.includes("not found"),
+    getSuggestions: () => [
+      "\u{1F4E6} Supabase CLI not found.",
+      "",
+      "Install Supabase CLI:",
+      "  # macOS",
+      "  brew install supabase/tap/supabase",
+      "",
+      "  # npm (alternative)",
+      "  npm install -g supabase",
+      "",
+      "Then run: runa check"
+    ]
+  },
+  // Docker not running
+  {
+    name: "docker-not-running",
+    matches: (msg) => msg.includes("Cannot connect to the Docker daemon") || msg.includes("docker daemon is not running") || msg.includes("Is the docker daemon running") || msg.includes("connect ENOENT /var/run/docker.sock"),
+    getSuggestions: () => [
+      "\u{1F433} Docker is not running.",
+      "",
+      "Start Docker:",
+      "  # macOS",
+      "  open -a Docker",
+      "",
+      "  # Linux",
+      "  sudo systemctl start docker",
+      "",
+      "Then run: runa check"
+    ]
+  },
+  // Port already in use
+  {
+    name: "port-in-use",
+    matches: (msg) => msg.includes("EADDRINUSE") || msg.includes("address already in use") || msg.includes("port is already allocated"),
+    getSuggestions: (msg) => {
+      const portMatch = msg.match(/:(\d{4,5})/);
+      const port = portMatch ? portMatch[1] : "3000";
+      const nextPort = Number.parseInt(port, 10) + 1;
+      return [
+        `\u{1F50C} Port ${port} is already in use.`,
+        "",
+        "Find and stop the process:",
+        `  lsof -i :${port}`,
+        "  kill -9 <PID>",
+        "",
+        "Or use a different port:",
+        `  runa dev --port ${nextPort}`
+      ];
+    }
+  },
+  // Missing environment files
+  {
+    name: "missing-env-files",
+    matches: (msg) => msg.includes(".env") && (msg.includes("not found") || msg.includes("ENOENT") || msg.includes("missing")),
+    getSuggestions: () => [
+      "\u{1F4C4} Environment file missing.",
+      "",
+      "Setup environment:",
+      "  runa prepare",
+      "",
+      "Or pull from Vercel (if configured):",
+      "  runa env pull"
+    ]
+  },
+  // Missing node_modules / general module not found
+  {
+    name: "missing-dependencies",
+    matches: (msg) => msg.includes("Cannot find module") && !msg.includes("@runa-ai/runa-"),
+    getSuggestions: () => [
+      "\u{1F4E6} Dependencies may be missing.",
+      "",
+      "Install dependencies:",
+      "  pnpm install",
+      "",
+      "If issue persists, try fresh install:",
+      "  rm -rf node_modules pnpm-lock.yaml",
+      "  pnpm install"
+    ]
+  },
+  // Schema out of sync
+  {
+    name: "schema-out-of-sync",
+    matches: (msg) => msg.includes("relation") && (msg.includes("does not exist") || msg.includes("already exists")),
+    getSuggestions: () => [
+      "\u{1F5C4}\uFE0F Database schema may be out of sync.",
+      "",
+      "Sync database schema:",
+      "  runa db sync",
+      "",
+      "Preview changes first:",
+      "  runa db sync --check"
+    ]
+  },
+  // Permission denied
+  {
+    name: "permission-denied",
+    matches: (msg) => msg.includes("EACCES") || msg.includes("permission denied"),
+    getSuggestions: () => [
+      "\u{1F512} Permission denied.",
+      "",
+      "Check file permissions or run with appropriate access.",
+      "Avoid using sudo with npm/pnpm commands."
+    ]
+  },
+  // Network errors
+  {
+    name: "network-errors",
+    matches: (msg) => msg.includes("ETIMEDOUT") || msg.includes("ENETUNREACH") || msg.includes("getaddrinfo ENOTFOUND"),
+    getSuggestions: () => [
+      "\u{1F310} Network connection issue.",
+      "",
+      "Check your internet connection and try again.",
+      "If behind a proxy, ensure proxy settings are configured."
+    ]
+  },
+  // Vercel CLI issues
+  {
+    name: "vercel-cli-issues",
+    matches: (msg) => msg.includes("Failed to list Vercel projects") || msg.includes("Failed to link Vercel project") || msg.includes("vercel") && msg.includes("not found") || msg.includes("VERCEL_TOKEN"),
+    getSuggestions: () => [
+      "\u{1F53A} Vercel CLI issue detected.",
+      "",
+      "Setup steps:",
+      "  1. Install Vercel CLI:",
+      "     pnpm add -g vercel",
+      "",
+      "  2. Login to Vercel:",
+      "     vercel login",
+      "",
+      "  3. Or set VERCEL_TOKEN environment variable:",
+      "     export VERCEL_TOKEN=your_token",
+      "",
+      "Then run: runa env setup"
+    ]
+  },
+  // Supabase authentication issues
+  {
+    name: "supabase-auth-issues",
+    matches: (msg) => msg.includes("supabase login") || msg.includes("Failed to fetch API keys") || msg.includes("supabase") && msg.includes("authentication") || msg.includes("Supabase") && msg.includes("not found"),
+    getSuggestions: () => [
+      "\u{1F5C4}\uFE0F Supabase authentication issue.",
+      "",
+      "Setup steps:",
+      "  1. Login to Supabase:",
+      "     supabase login",
+      "",
+      "  2. Verify access:",
+      "     supabase projects list",
+      "",
+      "  3. If project not found, check project-ref:",
+      "     supabase projects list | grep <your-project>"
+    ]
+  },
+  // pg-schema-diff issues
+  {
+    name: "pg-schema-diff-issues",
+    matches: (msg) => msg.includes("pg-schema-diff binary not found") || msg.includes("pg-schema-diff spawn failed") || msg.includes("pg-schema-diff") && msg.includes("PATH"),
+    getSuggestions: () => [
+      "\u{1F527} pg-schema-diff not available.",
+      "",
+      "This tool is required for database migrations.",
+      "",
+      "Install pg-schema-diff:",
+      "  # Using Go",
+      "  go install github.com/stripe/pg-schema-diff/cmd/pg-schema-diff@latest",
+      "",
+      "  # Ensure it's in PATH",
+      "  export PATH=$PATH:$(go env GOPATH)/bin",
+      "",
+      "Or use CI where it's pre-installed."
+    ]
+  },
+  // Seed application failures
+  {
+    name: "seed-failures",
+    matches: (msg) => msg.includes("Seed application failed") || msg.includes("seed") && msg.includes("failed") || msg.includes("ci.sql"),
+    getSuggestions: () => [
+      "\u{1F331} Seed application failed.",
+      "",
+      "Common causes:",
+      "  1. Schema not synced - run: runa db sync",
+      "  2. Foreign key violations - check seed order",
+      "  3. Duplicate data - reset DB: runa db reset",
+      "",
+      "Debug with:",
+      "  runa db sync --verbose"
+    ]
+  },
+  // Script not found
+  {
+    name: "script-not-found",
+    matches: (msg) => msg.includes("Script not found") || msg.includes("script") && msg.includes("ENOENT"),
+    getSuggestions: () => [
+      "\u{1F4DC} Script file not found.",
+      "",
+      "Ensure the script exists and is executable:",
+      "  ls -la packages/database/scripts/",
+      "",
+      "Common scripts:",
+      "  \u2022 generate-seeds.ts - Auto-generate seed data",
+      "  \u2022 db-sync.ts - Schema synchronization"
+    ]
+  },
+  // Git working tree issues
+  {
+    name: "git-working-tree",
+    matches: (msg) => msg.includes("uncommitted changes") || msg.includes("working tree") || msg.includes("dirty working"),
+    getSuggestions: () => [
+      "\u{1F4DD} Git working tree has uncommitted changes.",
+      "",
+      "Options:",
+      "  1. Commit your changes:",
+      '     git add . && git commit -m "WIP"',
+      "",
+      "  2. Stash changes temporarily:",
+      "     git stash",
+      "",
+      "  3. Discard changes (careful!):",
+      "     git checkout ."
+    ]
+  },
+  // Database authentication failures
+  {
+    name: "database-auth-failures",
+    matches: (msg) => msg.includes("authentication") && msg.includes("failed") || msg.includes("password") && msg.includes("authentication") || msg.includes("role") && msg.includes("does not exist"),
+    getSuggestions: () => [
+      "\u{1F510} Database authentication failed.",
+      "",
+      "Check your DATABASE_URL credentials:",
+      "  1. Verify password is correct",
+      "  2. Check user role exists",
+      "",
+      "For local development:",
+      "  DATABASE_URL=postgresql://postgres:postgres@127.0.0.1:54322/postgres",
+      "",
+      "For production, use runa db derive-urls"
+    ]
+  },
+  // Turbo cache issues
+  {
+    name: "turbo-cache-issues",
+    matches: (msg) => msg.includes("turbo") && msg.includes("cache") || msg.includes("turbo") && msg.includes("daemon"),
+    getSuggestions: () => [
+      "\u26A1 Turbo cache issue detected.",
+      "",
+      "Clear turbo cache:",
+      "  runa cache clear",
+      "",
+      "Or manually:",
+      "  rm -rf .turbo node_modules/.cache"
+    ]
+  }
+];
+function diagnosePjRepoIssues(errorMessage) {
+  for (const rule of diagnosisRules) {
+    if (rule.matches(errorMessage)) {
+      return rule.getSuggestions(errorMessage);
+    }
+  }
+  return [];
+}
+function outputJsonError(formatted, allSuggestions) {
+  const argv = process.argv.slice(2);
+  const command = getCommandPathFromArgv(argv);
+  const payload = {
+    version: CLI_CONTRACT_VERSION,
+    ok: false,
+    command,
+    error: {
+      title: formatted.code ?? "CLI_ERROR",
+      message: formatted.message,
+      code: formatted.code,
+      suggestions: allSuggestions.filter((s) => s.length > 0)
+    }
+  };
+  const parsed = ErrorEnvelopeSchema.parse(payload);
+  process.env.RUNA_JSON_EMITTING = "true";
+  try {
+    writeJsonEnvelope(`${JSON.stringify(parsed)}
+`);
+  } finally {
+    process.env.RUNA_JSON_EMITTING = "false";
+  }
+  process.exit(formatted.exitCode);
+}
+function outputDiagnostics(logger, diagnostics) {
+  if (diagnostics.length === 0) return;
+  logger.info("\n\u{1F50D} Diagnosis:");
+  for (const diagnostic of diagnostics) {
+    logger.info(diagnostic.startsWith("  ") ? diagnostic : `${diagnostic}`);
+  }
+}
+function outputSuggestions(logger, suggestions) {
+  if (suggestions.length === 0) return;
+  logger.info("\n\u{1F4A1} Suggestions:");
+  for (const suggestion of suggestions) {
+    logger.info(`  \u2022 ${suggestion}`);
+  }
+}
+function outputHumanReadableError(formatted, pjRepoDiagnostics) {
+  const logger = createCLILogger("runa");
+  logger.error(formatted.message);
+  if (formatted.code) {
+    logger.info(`Error Code: ${formatted.code}`);
+  }
+  outputDiagnostics(logger, pjRepoDiagnostics);
+  outputSuggestions(logger, formatted.suggestions);
+  logger.info("\n\u{1F4D6} For more help:");
+  if (pjRepoDiagnostics.length === 0 && formatted.suggestions.length === 0) {
+    logger.info("  \u2022 First-time setup: runa prepare");
+    logger.info("  \u2022 Diagnose issues: runa check");
+  } else {
+    logger.info("  \u2022 Diagnose issues: runa check");
+  }
+  logger.info("  \u2022 Docs: https://github.com/r06-dev/runa");
+  if (process.env.DEBUG === "true" && formatted.debug) {
+    logger.debug("\nStack Trace:");
+    logger.debug(formatted.debug);
+  }
+  process.exit(formatted.exitCode);
+}
+function handleCLIError(error) {
+  const formatted = formatCLIError(error, { debug: process.env.DEBUG === "true" });
+  const errorCode = error instanceof CLIError ? error.code : formatted.code;
+  const catalogDocUrl = getDocUrlFromCatalog(errorCode);
+  const pjRepoDiagnostics = diagnosePjRepoIssues(formatted.message);
+  const allSuggestions = [...formatted.suggestions, ...pjRepoDiagnostics];
+  if (catalogDocUrl && !allSuggestions.some((s) => s.includes(catalogDocUrl))) {
+    allSuggestions.push(`Docs: ${catalogDocUrl}`);
+  }
+  const outputFormat = getOutputFormatFromEnv();
+  if (outputFormat === "json") {
+    return outputJsonError(formatted, allSuggestions);
+  }
+  return outputHumanReadableError(formatted, pjRepoDiagnostics);
+}
+
+export { handleCLIError };