@lead-routing/cli 0.6.1 → 0.6.2

package/dist/index.js

@@ -491,6 +491,8 @@ function writeConfig(dir, config2) {
 function findInstallDir(startDir = process.cwd()) {
   const candidate = join(startDir, "lead-routing.json");
   if (existsSync2(candidate)) return startDir;
+  const dev = join(startDir, "lead-routing-dev", "lead-routing.json");
+  if (existsSync2(dev)) return join(startDir, "lead-routing-dev");
   const nested = join(startDir, "lead-routing", "lead-routing.json");
   if (existsSync2(nested)) return join(startDir, "lead-routing");
   return null;
@@ -1589,8 +1591,10 @@ function runConfigShow() {
 }
 
 // src/commands/sfdc.ts
-import { intro as intro5, outro as outro5, text as text3, log as log15 } from "@clack/prompts";
-import chalk7 from "chalk";
+import { intro as intro5, outro as outro5, text as text3, note as note4, confirm as confirm2, log as log14, isCancel as isCancel4, cancel as cancel4 } from "@clack/prompts";
+import chalk6 from "chalk";
+import { exec as exec2 } from "child_process";
+import { platform as platform2 } from "os";
 
 // src/steps/sfdc-deploy-inline.ts
 import { readFileSync as readFileSync7, writeFileSync as writeFileSync7, existsSync as existsSync5, cpSync, rmSync } from "fs";
@@ -1719,9 +1723,9 @@ Content-Type: application/zip\r
       body
     });
     if (!res.ok) {
-      const text6 = await res.text();
+      const text7 = await res.text();
       throw new Error(
-        `Metadata deploy request failed (${res.status}): ${text6}`
+        `Metadata deploy request failed (${res.status}): ${text7}`
       );
     }
     const result = await res.json();
@@ -1738,9 +1742,9 @@ Content-Type: application/zip\r
       const url = `${this.baseUrl}/metadata/deployRequest/${deployId}?includeDetails=true`;
       const res = await fetch(url, { headers: this.headers() });
       if (!res.ok) {
-        const text6 = await res.text();
+        const text7 = await res.text();
         throw new Error(
-          `Deploy status check failed (${res.status}): ${text6}`
+          `Deploy status check failed (${res.status}): ${text7}`
         );
       }
       const data = await res.json();
@@ -2090,50 +2094,12 @@ Ensure the app is running and the URL is correct.`
   return { accessToken, instanceUrl };
 }
 
-// src/steps/app-launcher-guide.ts
-import { note as note4, confirm as confirm2, isCancel as isCancel4, log as log14 } from "@clack/prompts";
-import chalk6 from "chalk";
-async function guideAppLauncherSetup(appUrl) {
-  note4(
-    `Complete the following steps in Salesforce now:
-
-  ${chalk6.cyan("1.")} Open ${chalk6.bold("App Launcher")} (grid icon, top-left in Salesforce)
-  ${chalk6.cyan("2.")} Search for ${chalk6.white('"Lead Router Setup"')} and click it
-  ${chalk6.cyan("3.")} Click ${chalk6.white('"Connect to Lead Router"')}
-     \u2192 You will be redirected to ${chalk6.dim(appUrl)} and back
-     \u2192 Authorize the OAuth connection when prompted
-
-  ${chalk6.cyan("4.")} ${chalk6.bold("Step 1")} \u2014 wait for the ${chalk6.green('"Connected"')} checkmark (~5 sec)
-  ${chalk6.cyan("5.")} ${chalk6.bold("Step 2")} \u2014 click ${chalk6.white("Activate")} to enable Lead triggers
-  ${chalk6.cyan("6.")} ${chalk6.bold("Step 3")} \u2014 click ${chalk6.white("Sync Fields")} to index your Lead field schema
-  ${chalk6.cyan("7.")} ${chalk6.bold("Step 4")} \u2014 click ${chalk6.white("Send Test")} to fire a test routing event
-     \u2192 ${chalk6.dim('"Test successful"')} or ${chalk6.dim('"No matching rule"')} are both valid
-
-` + chalk6.dim("Keep this terminal open while you complete the wizard."),
-    "Complete Salesforce setup"
-  );
-  const done = await confirm2({
-    message: "Have you completed the App Launcher wizard?",
-    initialValue: false
-  });
-  if (isCancel4(done)) {
-    log14.warn(
-      "Wizard skipped. Run `lead-routing sfdc deploy` to retry the Salesforce setup."
-    );
-    return;
-  }
-  if (!done) {
-    log14.warn(
-      `No problem \u2014 complete it at your own pace.
-  Open App Launcher \u2192 Lead Router Setup \u2192 Connect to Lead Router
-  Dashboard: ${appUrl}`
-    );
-  } else {
-    log14.success("Salesforce setup complete");
-  }
-}
-
 // src/commands/sfdc.ts
+var MANAGED_PACKAGE_INSTALL_URL2 = "https://login.salesforce.com/packaging/installPackage.apexp?p0=04tgL000000CTnp";
+function openBrowser2(url) {
+  const cmd = platform2() === "darwin" ? "open" : "xdg-open";
+  exec2(`${cmd} ${JSON.stringify(url)}`);
+}
 async function runSfdcDeploy() {
   intro5("Lead Routing \u2014 Deploy Salesforce Package");
   let appUrl;
@@ -2143,9 +2109,9 @@ async function runSfdcDeploy() {
   if (config2?.appUrl && config2?.engineUrl) {
     appUrl = config2.appUrl;
     engineUrl = config2.engineUrl;
-    log15.info(`Using config from ${dir}/lead-routing.json`);
+    log14.info(`Using config from ${dir}/lead-routing.json`);
   } else {
-    log15.warn("No lead-routing.json found \u2014 enter the URLs from your installation.");
+    log14.warn("No lead-routing.json found \u2014 enter the URLs from your installation.");
     const rawApp = await text3({
       message: "App URL (e.g. https://leads.acme.com)",
       validate: (v) => !v ? "Required" : void 0
@@ -2159,6 +2125,29 @@ async function runSfdcDeploy() {
     if (typeof rawEngine === "symbol") process.exit(0);
     engineUrl = rawEngine.trim();
   }
+  note4(
+    `The Lead Router managed package installs the required Connected App,
+triggers, and custom objects in your Salesforce org.
+
+Install URL: ${chalk6.cyan(MANAGED_PACKAGE_INSTALL_URL2)}`,
+    "Salesforce Package"
+  );
+  log14.info("Opening install URL in your browser...");
+  openBrowser2(MANAGED_PACKAGE_INSTALL_URL2);
+  log14.info(chalk6.dim("If the browser didn't open, visit the URL above manually."));
+  const installed = await confirm2({
+    message: 'Have you installed the package? (Click "Install for All Users" in Salesforce)',
+    initialValue: false
+  });
+  if (isCancel4(installed)) {
+    cancel4("Setup cancelled.");
+    process.exit(0);
+  }
+  if (!installed) {
+    log14.warn("You can install the package later \u2014 routing will not work until it is installed.");
+  } else {
+    log14.success("Salesforce package installed");
+  }
   const alias = await text3({
     message: "Salesforce org alias (used to log in)",
     placeholder: "lead-routing",
@@ -2175,49 +2164,48 @@ async function runSfdcDeploy() {
       webhookSecret: config2?.engineWebhookSecret
     });
   } catch (err) {
-    log15.error(err instanceof Error ? err.message : String(err));
+    log14.error(err instanceof Error ? err.message : String(err));
     process.exit(1);
   }
-  await guideAppLauncherSetup(appUrl);
   outro5(
-    chalk7.green("\u2714  Salesforce package deployed!") + `
+    chalk6.green("\u2714  Salesforce package deployed!") + `
 
-  Your Lead Router dashboard: ${chalk7.cyan(appUrl)}`
+  Your Lead Router dashboard: ${chalk6.cyan(appUrl)}`
   );
 }
 
 // src/commands/uninstall.ts
 import { rmSync as rmSync2, existsSync as existsSync6 } from "fs";
-import { intro as intro6, outro as outro6, log as log16, confirm as confirm3, password as promptPassword3, isCancel as isCancel5 } from "@clack/prompts";
-import chalk8 from "chalk";
+import { intro as intro6, outro as outro6, log as log15, confirm as confirm3, password as promptPassword3, isCancel as isCancel5 } from "@clack/prompts";
+import chalk7 from "chalk";
 async function runUninstall() {
   console.log();
-  intro6(chalk8.bold.red("Lead Routing \u2014 Uninstall"));
+  intro6(chalk7.bold.red("Lead Routing \u2014 Uninstall"));
   const dir = findInstallDir();
   if (!dir) {
-    log16.error(
+    log15.error(
       "No lead-routing.json found. Run this command from your install directory."
     );
     process.exit(1);
   }
   const cfg = readConfig(dir);
   if (!cfg.ssh) {
-    log16.error(
+    log15.error(
       "This lead-routing.json was created with an older CLI version and has no SSH config. Please manually SSH into your server and run:\n\n  cd ~/lead-routing && docker compose down -v && cd ~ && rm -rf ~/lead-routing"
     );
     process.exit(1);
   }
-  log16.warn(chalk8.red("This will permanently destroy:"));
-  log16.warn(`  \u2022 Remote: ${cfg.ssh.username}@${cfg.ssh.host}:${cfg.remoteDir}`);
-  log16.warn("    \u2514\u2500 All containers, Postgres data, Redis data, config files");
-  log16.warn(`  \u2022 Local: ${dir}/`);
-  log16.warn("    \u2514\u2500 docker-compose.yml, .env.web, .env.engine, Caddyfile, lead-routing.json");
+  log15.warn(chalk7.red("This will permanently destroy:"));
+  log15.warn(`  \u2022 Remote: ${cfg.ssh.username}@${cfg.ssh.host}:${cfg.remoteDir}`);
+  log15.warn("    \u2514\u2500 All containers, Postgres data, Redis data, config files");
+  log15.warn(`  \u2022 Local: ${dir}/`);
+  log15.warn("    \u2514\u2500 docker-compose.yml, .env.web, .env.engine, Caddyfile, lead-routing.json");
   const confirmed = await confirm3({
-    message: chalk8.bold("Are you sure you want to uninstall? This cannot be undone."),
+    message: chalk7.bold("Are you sure you want to uninstall? This cannot be undone."),
     initialValue: false
   });
   if (isCancel5(confirmed) || !confirmed) {
-    log16.info("Uninstall cancelled.");
+    log15.info("Uninstall cancelled.");
     process.exit(0);
   }
   const ssh = new SshConnection();
@@ -2238,47 +2226,47 @@ async function runUninstall() {
       password: sshPassword,
       remoteDir: cfg.remoteDir
     });
-    log16.success(`Connected to ${cfg.ssh.host}`);
+    log15.success(`Connected to ${cfg.ssh.host}`);
   } catch (err) {
-    log16.error(`SSH connection failed: ${String(err)}`);
+    log15.error(`SSH connection failed: ${String(err)}`);
     process.exit(1);
   }
   try {
     const remoteDir = await ssh.resolveHome(cfg.remoteDir);
-    log16.step("Stopping containers and removing volumes");
+    log15.step("Stopping containers and removing volumes");
     const { code } = await ssh.execSilent("docker compose down -v", remoteDir);
     if (code !== 0) {
-      log16.warn("docker compose down reported an error \u2014 directory may already be partially removed");
+      log15.warn("docker compose down reported an error \u2014 directory may already be partially removed");
     } else {
-      log16.success("Containers and volumes removed");
+      log15.success("Containers and volumes removed");
     }
-    log16.step(`Removing remote directory ${remoteDir}`);
+    log15.step(`Removing remote directory ${remoteDir}`);
     await ssh.exec(`rm -rf ${remoteDir}`);
-    log16.success("Remote directory removed");
+    log15.success("Remote directory removed");
   } catch (err) {
     const message = err instanceof Error ? err.message : String(err);
-    log16.error(`Remote cleanup failed: ${message}`);
+    log15.error(`Remote cleanup failed: ${message}`);
     process.exit(1);
   } finally {
     await ssh.disconnect();
   }
-  log16.step("Removing local config directory");
+  log15.step("Removing local config directory");
   if (existsSync6(dir)) {
     rmSync2(dir, { recursive: true, force: true });
-    log16.success(`Removed ${dir}`);
+    log15.success(`Removed ${dir}`);
   }
   outro6(
-    chalk8.green("\u2714  Uninstall complete.") + `
+    chalk7.green("\u2714  Uninstall complete.") + `
 
-  Run ${chalk8.cyan("npx @lead-routing/cli init")} to start fresh.`
+  Run ${chalk7.cyan("npx @lead-routing/cli init")} to start fresh.`
   );
 }
 
 // src/commands/signup.ts
 import * as p from "@clack/prompts";
-import chalk9 from "chalk";
+import chalk8 from "chalk";
 async function runSignup() {
-  p.intro(chalk9.bgBlue.white(" lead-routing signup "));
+  p.intro(chalk8.bgBlue.white(" lead-routing signup "));
   const firstName = await p.text({ message: "First name", placeholder: "John", validate: (v) => v.trim() ? void 0 : "Required" });
   if (p.isCancel(firstName)) process.exit(0);
   const lastName = await p.text({ message: "Last name", placeholder: "Smith", validate: (v) => v.trim() ? void 0 : "Required" });
@@ -2287,10 +2275,10 @@ async function runSignup() {
   if (p.isCancel(email)) process.exit(0);
   const password5 = await p.password({ message: "Password (min 8 characters)", validate: (v) => v.length >= 8 ? void 0 : "Must be at least 8 characters" });
   if (p.isCancel(password5)) process.exit(0);
-  const confirm5 = await p.password({ message: "Confirm password", validate: (v) => v === password5 ? void 0 : "Passwords do not match" });
-  if (p.isCancel(confirm5)) process.exit(0);
-  const spinner8 = p.spinner();
-  spinner8.start("Creating account...");
+  const confirm6 = await p.password({ message: "Confirm password", validate: (v) => v === password5 ? void 0 : "Passwords do not match" });
+  if (p.isCancel(confirm6)) process.exit(0);
+  const spinner9 = p.spinner();
+  spinner9.start("Creating account...");
   try {
     const message = await apiSignup({
       firstName: firstName.trim(),
@@ -2298,20 +2286,20 @@ async function runSignup() {
       email: email.trim(),
       password: password5
     });
-    spinner8.stop("Account created!");
+    spinner9.stop("Account created!");
     p.note(
       `Check your email (${email.trim()}) for a verification link.
 
 After verifying, run:
 
-  ${chalk9.cyan("lead-routing login")}`,
+  ${chalk8.cyan("lead-routing login")}`,
       "Next Steps"
     );
   } catch (err) {
     const msg = err instanceof Error ? err.message : "Signup failed";
-    spinner8.stop(msg);
+    spinner9.stop(msg);
     if (msg.includes("already")) {
-      p.log.info(`Try ${chalk9.cyan("lead-routing login")} instead.`);
+      p.log.info(`Try ${chalk8.cyan("lead-routing login")} instead.`);
     }
     process.exit(1);
   }
@@ -2320,19 +2308,19 @@ After verifying, run:
 
 // src/commands/login.ts
 import * as p2 from "@clack/prompts";
-import chalk10 from "chalk";
+import chalk9 from "chalk";
 async function runLogin() {
-  p2.intro(chalk10.bgBlue.white(" lead-routing login "));
+  p2.intro(chalk9.bgBlue.white(" lead-routing login "));
   const email = await p2.text({ message: "Email", placeholder: "john@acme.com" });
   if (p2.isCancel(email)) process.exit(0);
   const password5 = await p2.password({ message: "Password" });
   if (p2.isCancel(password5)) process.exit(0);
-  const spinner8 = p2.spinner();
-  spinner8.start("Authenticating...");
+  const spinner9 = p2.spinner();
+  spinner9.start("Authenticating...");
   try {
     const { token, customer } = await apiLogin(email.trim(), password5);
     if (!customer.emailVerified) {
-      spinner8.stop("Email not verified");
+      spinner9.stop("Email not verified");
       p2.log.warn(`Your email (${customer.email}) hasn't been verified yet.`);
       const resend = await p2.confirm({ message: "Resend verification email?" });
       if (resend && !p2.isCancel(resend)) {
@@ -2345,19 +2333,421 @@ async function runLogin() {
       }
       p2.note(`Verify your email, then run:
 
-  ${chalk10.cyan("lead-routing login")}`, "Next Steps");
+  ${chalk9.cyan("lead-routing login")}`, "Next Steps");
       process.exit(1);
     }
     saveCredentials({ token, customer, storedAt: (/* @__PURE__ */ new Date()).toISOString() });
-    spinner8.stop(`Logged in as ${customer.firstName} ${customer.lastName} \u2014 ${formatTierBadge(customer.tier)}`);
+    spinner9.stop(`Logged in as ${customer.firstName} ${customer.lastName} \u2014 ${formatTierBadge(customer.tier)}`);
     p2.note(`Credentials saved to ~/.lead-routing/credentials.json`, "Saved");
   } catch (err) {
-    spinner8.stop(err instanceof Error ? err.message : "Login failed");
+    spinner9.stop(err instanceof Error ? err.message : "Login failed");
     process.exit(1);
   }
   p2.outro("Done!");
 }
 
+// src/commands/dev.ts
+import {
+  intro as intro9,
+  outro as outro9,
+  spinner as spinner8,
+  text as text6,
+  password as promptPassword4,
+  note as note7,
+  log as log18,
+  isCancel as isCancel8,
+  cancel as cancel5,
+  confirm as confirm5
+} from "@clack/prompts";
+import { execa as execa4 } from "execa";
+import { mkdirSync as mkdirSync3, writeFileSync as writeFileSync8, readFileSync as readFileSync8, existsSync as existsSync7 } from "fs";
+import { join as join10 } from "path";
+function getDevDir() {
+  return join10(process.cwd(), "lead-routing-dev");
+}
+function renderDevDockerCompose(dbPassword, redisPassword) {
+  return `# Lead Routing \u2014 Local Dev Docker Compose
+# Generated by lead-routing dev \u2014 do not edit manually.
+
+services:
+
+  postgres:
+    image: postgres:16-alpine
+    restart: unless-stopped
+    ports:
+      - "127.0.0.1:5432:5432"
+    environment:
+      POSTGRES_DB: leadrouting
+      POSTGRES_USER: leadrouting
+      POSTGRES_PASSWORD: ${dbPassword}
+    volumes:
+      - postgres_data:/var/lib/postgresql/data
+    healthcheck:
+      test: ["CMD-SHELL", "pg_isready -U leadrouting"]
+      interval: 5s
+      timeout: 5s
+      retries: 10
+
+  redis:
+    image: redis:7-alpine
+    restart: unless-stopped
+    command: redis-server --requirepass ${redisPassword}
+    volumes:
+      - redis_data:/data
+    healthcheck:
+      test: ["CMD-SHELL", "redis-cli -a ${redisPassword} ping | grep PONG"]
+      interval: 5s
+      timeout: 3s
+      retries: 10
+
+  web:
+    image: ghcr.io/atgatzby/lead-routing-web:latest
+    restart: unless-stopped
+    ports:
+      - "127.0.0.1:3000:3000"
+    env_file: .env.web
+    healthcheck:
+      test: ["CMD-SHELL", "wget -qO- http://$(hostname -i):3000/api/health || exit 1"]
+      interval: 10s
+      timeout: 5s
+      retries: 6
+    depends_on:
+      postgres:
+        condition: service_healthy
+      redis:
+        condition: service_healthy
+
+  engine:
+    image: ghcr.io/atgatzby/lead-routing-engine:latest
+    restart: unless-stopped
+    ports:
+      - "127.0.0.1:3001:3001"
+    env_file: .env.engine
+    healthcheck:
+      test: ["CMD-SHELL", "wget -qO- http://$(hostname -i):3001/health || exit 1"]
+      interval: 10s
+      timeout: 5s
+      retries: 6
+    depends_on:
+      postgres:
+        condition: service_healthy
+      redis:
+        condition: service_healthy
+
+volumes:
+  postgres_data:
+  redis_data:
+`;
+}
+function bail3(value) {
+  if (isCancel8(value)) {
+    cancel5("Setup cancelled.");
+    process.exit(0);
+  }
+  throw new Error("Unexpected cancel");
+}
+async function pollHealth2(url, attempts = 30, intervalMs = 3e3) {
+  for (let i = 0; i < attempts; i++) {
+    try {
+      const res = await fetch(url);
+      if (res.ok) return true;
+    } catch {
+    }
+    await new Promise((r) => setTimeout(r, intervalMs));
+  }
+  return false;
+}
+async function runDev(opts = {}) {
+  if (opts.sfdc) {
+    const devDir2 = getDevDir();
+    const configFile2 = join10(devDir2, "dev.json");
+    if (!existsSync7(configFile2)) {
+      console.error("No dev environment found. Run `lead-routing dev` first.");
+      process.exit(1);
+    }
+    intro9("Lead Routing \u2014 Update Salesforce Credentials");
+    note7(
+      "You need a Salesforce Connected App with callback URL:\n  http://localhost:3000/api/auth/sfdc/callback",
+      "Before you begin"
+    );
+    const clientId = await text6({
+      message: "Consumer Key (Client ID)",
+      validate: (v) => !v ? "Required" : void 0
+    });
+    if (isCancel8(clientId)) {
+      cancel5("Cancelled.");
+      process.exit(0);
+    }
+    const clientSecret = await promptPassword4({ message: "Consumer Secret" });
+    if (isCancel8(clientSecret)) {
+      cancel5("Cancelled.");
+      process.exit(0);
+    }
+    const loginUrl = await text6({
+      message: "Login URL",
+      initialValue: "https://login.salesforce.com",
+      validate: (v) => !v ? "Required" : void 0
+    });
+    if (isCancel8(loginUrl)) {
+      cancel5("Cancelled.");
+      process.exit(0);
+    }
+    const envPath = join10(devDir2, ".env.web");
+    const lines = readFileSync8(envPath, "utf8").split("\n");
+    const updates = {
+      SFDC_CLIENT_ID: clientId.trim(),
+      SFDC_CLIENT_SECRET: clientSecret.trim(),
+      SFDC_LOGIN_URL: loginUrl.trim(),
+      SFDC_REDIRECT_URI: "http://localhost:3000/api/auth/sfdc/callback"
+    };
+    const updated = /* @__PURE__ */ new Set();
+    const result = lines.map((line) => {
+      const eq = line.indexOf("=");
+      if (eq === -1) return line;
+      const key = line.slice(0, eq);
+      if (key in updates) {
+        updated.add(key);
+        return `${key}=${updates[key]}`;
+      }
+      return line;
+    });
+    for (const [k, v] of Object.entries(updates)) {
+      if (!updated.has(k)) result.push(`${k}=${v}`);
+    }
+    writeFileSync8(envPath, result.join("\n"), "utf8");
+    const cfg2 = JSON.parse(readFileSync8(configFile2, "utf8"));
+    cfg2.sfdcClientId = clientId.trim();
+    cfg2.sfdcClientSecret = clientSecret.trim();
+    cfg2.sfdcLoginUrl = loginUrl.trim();
+    writeFileSync8(configFile2, JSON.stringify(cfg2, null, 2), "utf8");
+    log18.success("Credentials saved");
+    const s = spinner8();
+    s.start("Restarting web container...");
+    await execa4("docker", ["compose", "restart", "web"], { cwd: devDir2, stdio: "ignore" });
+    s.stop("Web container restarted");
+    outro9("Done! Connect Salesforce at http://localhost:3000/integrations/salesforce");
+    return;
+  }
+  if (opts.logs !== void 0) {
+    const service = opts.logs || "engine";
+    const devDir2 = getDevDir();
+    if (!existsSync7(join10(devDir2, "docker-compose.yml"))) {
+      console.error("No dev environment found. Run `lead-routing dev` first.");
+      process.exit(1);
+    }
+    const valid = ["web", "engine", "postgres", "redis"];
+    if (!valid.includes(service)) {
+      console.error(`Unknown service "${service}". Valid: ${valid.join(", ")}`);
+      process.exit(1);
+    }
+    await execa4("docker", ["compose", "logs", "-f", "--tail=100", service], {
+      cwd: devDir2,
+      stdio: "inherit"
+    });
+    return;
+  }
+  intro9("Lead Routing \u2014 Local Dev");
+  try {
+    await execa4("docker", ["info"], { stdio: "ignore" });
+  } catch {
+    log18.error("Docker is not running. Please start Docker Desktop and try again.");
+    process.exit(1);
+  }
+  const devDir = getDevDir();
+  const configFile = join10(devDir, "dev.json");
+  const isFirstRun = !existsSync7(configFile);
+  let cfg;
+  let adminPassword = "";
+  if (!isFirstRun && !opts.reset) {
+    cfg = JSON.parse(readFileSync8(configFile, "utf8"));
+    log18.info("Existing dev environment found \u2014 starting services...");
+  } else {
+    if (opts.reset && !isFirstRun) {
+      const ok = await confirm5({
+        message: "This will wipe all local dev data (database, redis). Continue?"
+      });
+      if (isCancel8(ok) || !ok) {
+        cancel5("Reset cancelled.");
+        process.exit(0);
+      }
+      const s = spinner8();
+      s.start("Stopping and removing volumes...");
+      try {
+        await execa4("docker", ["compose", "down", "-v"], { cwd: devDir, stdio: "ignore" });
+      } catch {
+      }
+      s.stop("Volumes removed");
+    }
+    note7(
+      "Sets up a full Lead Routing stack locally using Docker.\nNo SSH, no VPS, no manual steps.",
+      "First-time setup"
+    );
+    const adminEmail = await text6({
+      message: "Admin email",
+      placeholder: "you@company.com",
+      validate: (v) => {
+        if (!v) return "Required";
+        if (!v.includes("@")) return "Must be a valid email";
+      }
+    });
+    if (isCancel8(adminEmail)) bail3(adminEmail);
+    const pw = await promptPassword4({
+      message: "Admin password (min 8 characters)",
+      validate: (v) => {
+        if (!v) return "Required";
+        if (v.length < 8) return "Must be at least 8 characters";
+      }
+    });
+    if (isCancel8(pw)) bail3(pw);
+    adminPassword = pw;
+    note7(
+      "Optional \u2014 needed to connect Salesforce.\nPress Enter to skip; add credentials later via `lead-routing config sfdc`.",
+      "Salesforce Connected App"
+    );
+    const sfdcClientId = await text6({
+      message: "Consumer Key (Client ID)",
+      placeholder: "Leave blank to skip"
+    });
+    if (isCancel8(sfdcClientId)) bail3(sfdcClientId);
+    let sfdcClientSecret = "";
+    if (sfdcClientId?.trim()) {
+      const s = await promptPassword4({ message: "Consumer Secret" });
+      if (isCancel8(s)) bail3(s);
+      sfdcClientSecret = s.trim();
+    }
+    const tunnelUrl = await text6({
+      message: "Engine tunnel URL (for Salesforce webhooks)",
+      placeholder: "Leave blank \u2014 use `ssh -R 80:localhost:3001 localhost.run` to get one"
+    });
+    if (isCancel8(tunnelUrl)) bail3(tunnelUrl);
+    cfg = {
+      adminEmail: adminEmail.trim(),
+      dbPassword: generateSecret(16),
+      redisPassword: generateSecret(16),
+      sessionSecret: generateSecret(32),
+      engineWebhookSecret: generateSecret(32),
+      internalApiKey: generateSecret(32),
+      sfdcClientId: sfdcClientId?.trim() ?? "",
+      sfdcClientSecret,
+      sfdcLoginUrl: "https://login.salesforce.com",
+      engineTunnelUrl: tunnelUrl?.trim() ?? ""
+    };
+    mkdirSync3(devDir, { recursive: true });
+    const dbUrl = `postgresql://leadrouting:${cfg.dbPassword}@postgres:5432/leadrouting`;
+    const redisUrl = `redis://:${cfg.redisPassword}@redis:6379`;
+    const publicEngineUrl = cfg.engineTunnelUrl || "http://localhost:3001";
+    writeFileSync8(
+      join10(devDir, "docker-compose.yml"),
+      renderDevDockerCompose(cfg.dbPassword, cfg.redisPassword),
+      "utf8"
+    );
+    const envWebBase = renderEnvWeb({
+      appUrl: "http://localhost:3000",
+      engineUrl: "http://engine:3001",
+      publicEngineUrl,
+      databaseUrl: dbUrl,
+      redisUrl,
+      sessionSecret: cfg.sessionSecret,
+      engineWebhookSecret: cfg.engineWebhookSecret,
+      adminEmail: cfg.adminEmail,
+      adminPassword,
+      internalApiKey: cfg.internalApiKey,
+      licenseKey: void 0,
+      licenseTier: "pro"
+    });
+    writeFileSync8(
+      join10(devDir, ".env.web"),
+      envWebBase + `
+# Salesforce Connected App
+SFDC_CLIENT_ID=${cfg.sfdcClientId}
+SFDC_CLIENT_SECRET=${cfg.sfdcClientSecret}
+SFDC_REDIRECT_URI=http://localhost:3000/api/auth/sfdc/callback
+SFDC_LOGIN_URL=${cfg.sfdcLoginUrl}
+`,
+      "utf8"
+    );
+    writeFileSync8(
+      join10(devDir, ".env.engine"),
+      renderEnvEngine({
+        databaseUrl: dbUrl,
+        redisUrl,
+        engineWebhookSecret: cfg.engineWebhookSecret,
+        internalApiKey: cfg.internalApiKey,
+        licenseKey: void 0,
+        licenseTier: "pro"
+      }),
+      "utf8"
+    );
+    writeFileSync8(configFile, JSON.stringify(cfg, null, 2), "utf8");
+    writeConfig(devDir, {
+      appUrl: "http://localhost:3000",
+      engineUrl: publicEngineUrl,
+      installDir: devDir,
+      remoteDir: devDir,
+      ssh: { host: "localhost", port: 22, username: "local" },
+      dockerManaged: { db: true, redis: true },
+      engineWebhookSecret: cfg.engineWebhookSecret,
+      licenseTier: "pro",
+      installedAt: (/* @__PURE__ */ new Date()).toISOString(),
+      version: "0.0.0"
+    });
+    log18.success("Generated config files in ./lead-routing-dev/");
+  }
+  const pullS = spinner8();
+  pullS.start("Pulling latest images...");
+  try {
+    await execa4("docker", ["compose", "pull"], { cwd: devDir, stdio: "ignore" });
+    pullS.stop("Images up to date");
+  } catch {
+    pullS.stop("Using cached images");
+  }
+  const startS = spinner8();
+  startS.start("Starting services...");
+  try {
+    await execa4("docker", ["compose", "up", "-d", "--remove-orphans"], {
+      cwd: devDir,
+      stdio: "ignore"
+    });
+    startS.stop("Services started");
+  } catch (err) {
+    startS.stop("Failed to start services");
+    log18.error(err instanceof Error ? err.message : String(err));
+    process.exit(1);
+  }
+  const healthS = spinner8();
+  healthS.start("Waiting for web app...");
+  const webOk = await pollHealth2("http://localhost:3000/api/health");
+  if (!webOk) {
+    healthS.stop("Web app did not start in time");
+    log18.warn("Run `lead-routing dev logs web` to diagnose.");
+    process.exit(1);
+  }
+  healthS.stop("Web app ready");
+  const engineS = spinner8();
+  engineS.start("Waiting for engine...");
+  const engineOk = await pollHealth2("http://localhost:3001/health");
+  engineS.stop(engineOk ? "Engine ready" : "Engine slow to start (check: lead-routing dev logs engine)");
+  note7(
+    `  Web:    http://localhost:3000
+  Engine: http://localhost:3001
+
+  Login:  ${cfg.adminEmail}`,
+    "\u2713 Lead Routing running locally"
+  );
+  if (cfg.sfdcClientId) {
+    if (cfg.engineTunnelUrl) {
+      log18.info("Next: run `lead-routing sfdc deploy` to deploy the Salesforce package (same as prod)");
+    } else {
+      log18.warn(
+        "No engine tunnel URL set \u2014 Salesforce cannot reach localhost:3001.\nTo get a tunnel:  ssh -R 80:localhost:3001 localhost.run\nThen re-run:      lead-routing dev --reset  (to update the tunnel URL)\nThen deploy:      lead-routing sfdc deploy"
+      );
+    }
+  } else {
+    log18.info("No Salesforce creds set. Add via: lead-routing dev --sfdc");
+  }
+  outro9("Run `lead-routing dev logs` to stream logs  \u2022  `lead-routing dev --reset` to wipe and restart");
+}
+
 // src/index.ts
 var program = new Command();
 program.name("lead-routing").description("Self-hosted Lead Routing \u2014 scaffold, deploy, and manage your installation").version("0.1.13");
@@ -2381,6 +2771,7 @@ config.command("sfdc").description("Update Salesforce Connected App credentials
 var sfdc = program.command("sfdc").description("Manage the Salesforce package for this installation");
 sfdc.command("deploy").description("Deploy (or redeploy) the Lead Router Salesforce package to your Salesforce org").action(runSfdcDeploy);
 program.command("uninstall").description("Stop all containers, remove all data, and delete the remote installation").action(runUninstall);
+program.command("dev").description("Start a local dev environment (Docker-based, no SSH required)").option("--reset", "Wipe all local data and start fresh").option("--logs [service]", "Stream logs from a service (web, engine, postgres, redis)").option("--sfdc", "Update Salesforce Connected App credentials").action((opts) => runDev(opts));
 program.command("signup").description("Create a new Lead Routing account").action(runSignup);
 program.command("login").description("Log in to your Lead Routing account").action(runLogin);
 program.parseAsync(process.argv).catch((err) => {

package/dist/prisma/migrations/20260320000000_add_user_object_type/migration.sql

@@ -0,0 +1,2 @@
+-- AlterEnum
+ALTER TYPE "SfdcObjectType" ADD VALUE 'USER';

package/dist/prisma/schema.prisma

@@ -14,6 +14,7 @@ enum SfdcObjectType {
   LEAD
   CONTACT
   ACCOUNT
+  USER
 }
 
 enum TriggerEvent {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lead-routing/cli",
-  "version": "0.6.1",
+  "version": "0.6.2",
   "description": "Self-hosted deployment CLI for Lead Routing",
   "homepage": "https://github.com/lead-routing/lead-routing",
   "keywords": [