dorkos 0.27.0 → 0.29.0

package/dist/bin/cli.js

@@ -14364,7 +14364,7 @@ var init_config_schema = __esm({
       "tunnel.passcodeHash",
       "tunnel.passcodeSalt"
     ];
-    ONBOARDING_STEPS = ["meet-dorkbot", "discovery", "pulse", "adapters"];
+    ONBOARDING_STEPS = ["meet-dorkbot", "discovery", "tasks", "adapters"];
     OnboardingStepSchema = external_exports.enum(ONBOARDING_STEPS);
     OnboardingStateSchema = external_exports.object({
       completedSteps: external_exports.array(OnboardingStepSchema).default(() => []),
@@ -14382,8 +14382,9 @@ var init_config_schema = __esm({
       server: external_exports.object({
         port: external_exports.number().int().min(1024).max(65535).default(4242),
         cwd: external_exports.string().nullable().default(null),
-        boundary: external_exports.string().nullable().default(null)
-      }).default(() => ({ port: 4242, cwd: null, boundary: null })),
+        boundary: external_exports.string().nullable().default(null),
+        open: external_exports.boolean().default(true)
+      }).default(() => ({ port: 4242, cwd: null, boundary: null, open: true })),
       tunnel: external_exports.object({
         enabled: external_exports.boolean().default(false),
         domain: external_exports.string().nullable().default(null),
@@ -14438,8 +14439,8 @@ var init_config_schema = __esm({
         relayTools: external_exports.boolean().default(true),
         meshTools: external_exports.boolean().default(true),
         adapterTools: external_exports.boolean().default(true),
-        pulseTools: external_exports.boolean().default(true)
-      }).default(() => ({ relayTools: true, meshTools: true, adapterTools: true, pulseTools: true })),
+        tasksTools: external_exports.boolean().default(true)
+      }).default(() => ({ relayTools: true, meshTools: true, adapterTools: true, tasksTools: true })),
       uploads: external_exports.object({
         maxFileSize: external_exports.number().int().positive().default(10 * 1024 * 1024),
         // 10MB
@@ -18780,7 +18781,7 @@ var require_main = __commonJS({
 
 // src/cli.ts
 import { parseArgs } from "node:util";
-import os, { networkInterfaces } from "os";
+import os2, { networkInterfaces } from "os";
 import path4 from "path";
 import { fileURLToPath } from "url";
 import fs4 from "fs";
@@ -18877,7 +18878,165 @@ var cliEnvSchema = external_exports.object({
 });
 var env = cliEnvSchema.parse(process.env);
 
+// src/startup-diagnostics.ts
+import os from "os";
+var MIN_NODE_MAJOR = 20;
+function checkNodeVersion() {
+  const major = parseInt(process.versions.node.split(".")[0], 10);
+  if (major < MIN_NODE_MAJOR) {
+    return {
+      category: "node-version",
+      headline: `Node.js ${process.versions.node} is not supported`,
+      detail: `DorkOS requires Node.js ${MIN_NODE_MAJOR} or later. You are running ${process.versions.node}.`,
+      fix: [
+        `Upgrade Node.js to v${MIN_NODE_MAJOR}+ (LTS recommended):`,
+        `  nvm install --lts   # if using nvm`,
+        `  brew install node    # if using Homebrew`,
+        `  https://nodejs.org   # manual download`
+      ].join("\n")
+    };
+  }
+  return null;
+}
+function diagnoseStartupError(err) {
+  const msg = err instanceof Error ? err.message : String(err);
+  const code = err?.code;
+  if (msg.includes("does not provide an export named") || msg.includes("is not a function") || msg.includes("Cannot find module") && msg.includes("claude-agent-sdk")) {
+    const missingExport = msg.match(/export named '(\w+)'/)?.[1];
+    return {
+      category: "sdk-mismatch",
+      headline: "Claude Agent SDK version mismatch",
+      detail: missingExport ? `This version of DorkOS requires a newer Claude Agent SDK (missing export: ${missingExport}).` : `The installed Claude Agent SDK is incompatible with this version of DorkOS.`,
+      fix: [
+        "Update DorkOS and the SDK together:",
+        "  npm install -g dorkos@latest",
+        "",
+        "If you installed from source:",
+        "  pnpm install   # updates all workspace dependencies"
+      ].join("\n")
+    };
+  }
+  if (code === "MODULE_NOT_FOUND" || msg.includes("Cannot find module")) {
+    const modMatch = msg.match(/Cannot find module '([^']+)'/);
+    const modName = modMatch?.[1] ?? "unknown";
+    return {
+      category: "module-not-found",
+      headline: `Missing dependency: ${modName}`,
+      detail: `A required module could not be found. This usually means a partial install or corrupted node_modules.`,
+      fix: [
+        "Reinstall DorkOS:",
+        "  npm install -g dorkos@latest",
+        "",
+        "Or clear the cache and retry:",
+        "  npm cache clean --force && npm install -g dorkos"
+      ].join("\n")
+    };
+  }
+  if (code === "EADDRINUSE") {
+    const portMatch = msg.match(/(?:port\s+)?(\d{4,5})/i);
+    const port2 = portMatch?.[1] ?? process.env.DORKOS_PORT ?? "4242";
+    return {
+      category: "port-conflict",
+      headline: `Port ${port2} is already in use`,
+      detail: `Another process is listening on port ${port2}. This could be another DorkOS instance or a different application.`,
+      fix: [
+        "Find what is using the port:",
+        `  lsof -i :${port2}`,
+        "",
+        "Kill it if safe:",
+        `  kill $(lsof -ti :${port2})`,
+        "",
+        "Or start DorkOS on a different port:",
+        `  dorkos --port ${parseInt(port2) + 1}`
+      ].join("\n")
+    };
+  }
+  if (code === "EACCES" || code === "EPERM") {
+    const pathMatch = msg.match(/'([^']+)'/);
+    const filePath = pathMatch?.[1] ?? "~/.dork";
+    return {
+      category: "permission-denied",
+      headline: "Permission denied",
+      detail: `Cannot access ${filePath}. The data directory may be owned by a different user or have restricted permissions.`,
+      fix: [
+        "Fix ownership of the DorkOS data directory:",
+        `  sudo chown -R $(whoami) ~/.dork`,
+        "",
+        "Or check if another user is running DorkOS:",
+        `  ls -la ~/.dork`
+      ].join("\n")
+    };
+  }
+  if (msg.includes("SQLITE") || msg.includes("database") || msg.includes("migration") || msg.includes("drizzle")) {
+    return {
+      category: "db-error",
+      headline: "Database error",
+      detail: `The DorkOS database at ~/.dork/dork.db may be corrupted or incompatible: ${msg}`,
+      fix: [
+        "Back up and recreate the database:",
+        "  mv ~/.dork/dork.db ~/.dork/dork.db.bak",
+        "  dorkos   # will create a fresh database",
+        "",
+        "Your agents and config are stored separately and will not be lost."
+      ].join("\n")
+    };
+  }
+  if (msg.includes("config") && (msg.includes("JSON") || msg.includes("parse") || msg.includes("schema"))) {
+    return {
+      category: "config-error",
+      headline: "Invalid configuration",
+      detail: `The config file at ~/.dork/config.json could not be parsed: ${msg}`,
+      fix: [
+        "Validate the config:",
+        "  dorkos config validate",
+        "",
+        "Or reset to defaults:",
+        "  dorkos config reset",
+        "",
+        "A backup of your previous config may be at ~/.dork/config.json.bak"
+      ].join("\n")
+    };
+  }
+  return {
+    category: "unknown",
+    headline: "Startup failed",
+    detail: msg,
+    fix: [
+      "Check the logs for details:",
+      `  cat ~/.dork/logs/dorkos-${(/* @__PURE__ */ new Date()).toISOString().slice(0, 10)}.ndjson | tail -20`,
+      "",
+      "If this persists, please report the issue:",
+      "  https://github.com/doriancollier/dorkos/issues"
+    ].join("\n")
+  };
+}
+function formatDiagnostic(diag) {
+  const red = "\x1B[31m";
+  const yellow = "\x1B[33m";
+  const dim = "\x1B[2m";
+  const bold = "\x1B[1m";
+  const reset = "\x1B[0m";
+  const lines = [
+    "",
+    `${red}${bold}\u2716 ${diag.headline}${reset}`,
+    "",
+    `${dim}${diag.detail}${reset}`,
+    "",
+    `${yellow}${bold}How to fix:${reset}`,
+    diag.fix,
+    "",
+    `${dim}Platform: ${os.platform()} ${os.arch()} | Node: ${process.versions.node}${reset}`,
+    ""
+  ];
+  return lines.join("\n");
+}
+
 // src/cli.ts
+var nodeVersionIssue = checkNodeVersion();
+if (nodeVersionIssue) {
+  console.error(formatDiagnostic(nodeVersionIssue));
+  process.exit(1);
+}
 var __dirname = path4.dirname(fileURLToPath(import.meta.url));
 var values;
 var positionals;
@@ -18888,14 +19047,16 @@ try {
       tunnel: { type: "boolean", short: "t", default: false },
       dir: { type: "string", short: "d" },
       boundary: { type: "string", short: "b" },
-      pulse: { type: "boolean" },
+      tasks: { type: "boolean" },
+      open: { type: "boolean" },
       "log-level": { type: "string", short: "l" },
       help: { type: "boolean", short: "h" },
       version: { type: "boolean", short: "v" },
       "post-install-check": { type: "boolean", default: false },
       yes: { type: "boolean", short: "y", default: false }
     },
-    allowPositionals: true
+    allowPositionals: true,
+    allowNegative: true
   }));
 } catch (err) {
   if (err instanceof TypeError && err.code === "ERR_PARSE_ARGS_UNKNOWN_OPTION") {
@@ -18931,8 +19092,9 @@ Options:
   -t, --tunnel           Enable ngrok tunnel
   -d, --dir <path>       Working directory (default: current directory)
   -b, --boundary <path>  Directory boundary (default: home directory)
-      --pulse              Enable Pulse scheduler
-      --no-pulse           Disable Pulse scheduler
+      --tasks              Enable Tasks scheduler
+      --no-tasks           Disable Tasks scheduler
+      --no-open            Don't open browser on startup
   -l, --log-level <level>  Log level (fatal|error|warn|info|debug|trace)
       --post-install-check  Verify installation and exit
   -h, --help             Show this help message
@@ -18955,16 +19117,16 @@ Examples:
   process.exit(0);
 }
 if (values.version) {
-  console.log("0.27.0");
+  console.log("0.29.0");
   process.exit(0);
 }
 if (values["post-install-check"]) {
   checkClaude();
-  console.log(`dorkos ${"0.27.0"}`);
+  console.log(`dorkos ${"0.29.0"}`);
   console.log("Installation verified.");
   process.exit(0);
 }
-var DORK_HOME = env.DORK_HOME || path4.join(os.homedir(), ".dork");
+var DORK_HOME = env.DORK_HOME || path4.join(os2.homedir(), ".dork");
 var subcommand = positionals[0];
 if (subcommand === "cleanup") {
   const { runCleanup: runCleanup2 } = await Promise.resolve().then(() => (init_cleanup_command(), cleanup_command_exports));
@@ -19020,10 +19182,21 @@ var tunnelDomain = cfgMgr.getDot("tunnel.domain");
 if (tunnelDomain && !process.env.TUNNEL_DOMAIN) {
   process.env.TUNNEL_DOMAIN = tunnelDomain;
 }
-if (values.pulse !== void 0) {
-  process.env.DORKOS_PULSE_ENABLED = values.pulse ? "true" : "false";
-} else if (!process.env.DORKOS_PULSE_ENABLED && cfgMgr.getDot("scheduler.enabled")) {
-  process.env.DORKOS_PULSE_ENABLED = "true";
+if (values.tasks !== void 0) {
+  process.env.DORKOS_TASKS_ENABLED = values.tasks ? "true" : "false";
+} else if (!process.env.DORKOS_TASKS_ENABLED && cfgMgr.getDot("scheduler.enabled")) {
+  process.env.DORKOS_TASKS_ENABLED = "true";
+}
+var shouldOpenBrowser = true;
+if (values.open !== void 0) {
+  shouldOpenBrowser = Boolean(values.open);
+} else if (process.env.DORKOS_OPEN !== void 0) {
+  shouldOpenBrowser = process.env.DORKOS_OPEN !== "false" && process.env.DORKOS_OPEN !== "0";
+} else {
+  const configOpen = cfgMgr.getDot("server.open");
+  if (configOpen !== void 0 && configOpen !== null) {
+    shouldOpenBrowser = Boolean(configOpen);
+  }
 }
 if (!process.env.DORKOS_RELAY_ENABLED && cfgMgr.getDot("relay.enabled")) {
   process.env.DORKOS_RELAY_ENABLED = "true";
@@ -19045,7 +19218,7 @@ if (cliBoundary) {
   }
 }
 var boundaryVal = process.env.DORKOS_BOUNDARY;
-var home = os.homedir();
+var home = os2.homedir();
 if (boundaryVal && !boundaryVal.startsWith(home + path4.sep) && boundaryVal !== home) {
   console.warn(
     `[Warning] Directory boundary "${boundaryVal}" is above home directory "${home}". This grants access to system directories.`
@@ -19066,11 +19239,17 @@ if (fs4.existsSync(envPath)) {
   const dotenv = await import("dotenv");
   dotenv.config({ path: envPath, override: false });
 }
-await import("../server/index.js");
+try {
+  await import("../server/index.js");
+} catch (err) {
+  const diag = diagnoseStartupError(err);
+  console.error(formatDiagnostic(diag));
+  process.exit(1);
+}
 var port = process.env.DORKOS_PORT || String(DEFAULT_PORT);
 var localUrl = `http://localhost:${port}`;
 console.log("");
-console.log(`  DorkOS v${"0.27.0"}`);
+console.log(`  DorkOS v${"0.29.0"}`);
 console.log(`  Local:   ${link(localUrl, localUrl)}`);
 var nets = networkInterfaces();
 var networkUrl = null;
@@ -19105,20 +19284,10 @@ if (process.env.TUNNEL_ENABLED) {
   }
 }
 console.log("");
-if (process.stdin.isTTY) {
-  const { confirm: confirm3 } = await import("@inquirer/prompts");
-  try {
-    const shouldOpen = await confirm3({
-      message: "Open DorkOS in your browser?",
-      default: true
-    });
-    if (shouldOpen) {
-      const { exec } = await import("node:child_process");
-      const openCmd = process.platform === "darwin" ? "open" : process.platform === "win32" ? "start" : "xdg-open";
-      exec(`${openCmd} ${localUrl}`);
-    }
-  } catch {
-  }
+if (shouldOpenBrowser && process.stdin.isTTY) {
+  const { exec } = await import("node:child_process");
+  const openCmd = process.platform === "darwin" ? "open" : process.platform === "win32" ? "start" : "xdg-open";
+  exec(`${openCmd} ${localUrl}`);
 }
 {
   const { tunnelManager: tunnelManager2 } = await Promise.resolve().then(() => (init_tunnel_manager(), tunnel_manager_exports));
@@ -19141,9 +19310,9 @@ if (process.stdin.isTTY) {
     }
   });
 }
-checkForUpdate("0.27.0").then((latestVersion) => {
+checkForUpdate("0.29.0").then((latestVersion) => {
   if (latestVersion) {
-    const msg = `Update available: ${"0.27.0"} \u2192 ${latestVersion}`;
+    const msg = `Update available: ${"0.29.0"} \u2192 ${latestVersion}`;
     const cmd = "Run npm install -g dorkos@latest to update";
     const width = Math.max(msg.length, cmd.length) + 6;
     const pad = (s2) => `\u2502   ${s2}${" ".repeat(width - s2.length - 6)}   \u2502`;