@lead-routing/cli 0.6.0 → 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/20260316100000_add_bulk_search_runs/migration.sql

@@ -0,0 +1,36 @@
+-- AlterTable
+ALTER TABLE "routing_rules" ADD COLUMN "searchMaxRecords" INTEGER,
+ADD COLUMN "searchBatchSize" INTEGER;
+
+-- CreateTable
+CREATE TABLE "bulk_search_runs" (
+    "id" TEXT NOT NULL,
+    "orgId" TEXT NOT NULL,
+    "ruleId" TEXT NOT NULL,
+    "status" TEXT NOT NULL DEFAULT 'RUNNING',
+    "recordsFound" INTEGER NOT NULL DEFAULT 0,
+    "recordsProcessed" INTEGER NOT NULL DEFAULT 0,
+    "recordsRouted" INTEGER NOT NULL DEFAULT 0,
+    "recordsFailed" INTEGER NOT NULL DEFAULT 0,
+    "recordsSkipped" INTEGER NOT NULL DEFAULT 0,
+    "error" TEXT,
+    "startedAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "completedAt" TIMESTAMP(3),
+    "durationMs" INTEGER,
+    "maxRecords" INTEGER,
+    "batchSize" INTEGER,
+
+    CONSTRAINT "bulk_search_runs_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateIndex
+CREATE INDEX "bulk_search_runs_orgId_ruleId_idx" ON "bulk_search_runs"("orgId", "ruleId");
+
+-- CreateIndex
+CREATE INDEX "bulk_search_runs_ruleId_status_idx" ON "bulk_search_runs"("ruleId", "status");
+
+-- AddForeignKey
+ALTER TABLE "bulk_search_runs" ADD CONSTRAINT "bulk_search_runs_orgId_fkey" FOREIGN KEY ("orgId") REFERENCES "organizations"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "bulk_search_runs" ADD CONSTRAINT "bulk_search_runs_ruleId_fkey" FOREIGN KEY ("ruleId") REFERENCES "routing_rules"("id") ON DELETE CASCADE ON UPDATE CASCADE;

package/dist/prisma/migrations/20260316203552_add_ai_agent_models/migration.sql

@@ -0,0 +1,97 @@
+-- AlterTable
+ALTER TABLE "route_match_configs" ALTER COLUMN "updatedAt" DROP DEFAULT;
+
+-- AlterTable
+ALTER TABLE "routing_branches" ALTER COLUMN "updatedAt" DROP DEFAULT;
+
+-- CreateTable
+CREATE TABLE "ai_custom_prompts" (
+    "id" TEXT NOT NULL,
+    "orgId" TEXT NOT NULL,
+    "type" TEXT NOT NULL,
+    "name" TEXT NOT NULL,
+    "content" TEXT NOT NULL,
+    "context" TEXT,
+    "isActive" BOOLEAN NOT NULL DEFAULT true,
+    "sortOrder" INTEGER NOT NULL DEFAULT 0,
+    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updatedAt" TIMESTAMP(3) NOT NULL,
+
+    CONSTRAINT "ai_custom_prompts_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "ai_agent_logs" (
+    "id" TEXT NOT NULL,
+    "orgId" TEXT NOT NULL,
+    "context" TEXT NOT NULL,
+    "toolName" TEXT NOT NULL,
+    "action" TEXT NOT NULL,
+    "entityType" TEXT NOT NULL,
+    "entityId" TEXT,
+    "entityName" TEXT,
+    "input" JSONB NOT NULL,
+    "output" JSONB,
+    "status" TEXT NOT NULL,
+    "error" TEXT,
+    "actorId" TEXT NOT NULL,
+    "actorName" TEXT NOT NULL,
+    "durationMs" INTEGER,
+    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+
+    CONSTRAINT "ai_agent_logs_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "ai_chat_feedback" (
+    "id" TEXT NOT NULL,
+    "orgId" TEXT NOT NULL,
+    "rating" TEXT NOT NULL,
+    "userMessage" TEXT NOT NULL,
+    "aiResponse" TEXT NOT NULL,
+    "toolsUsed" JSONB,
+    "context" TEXT,
+    "feedback" TEXT,
+    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+
+    CONSTRAINT "ai_chat_feedback_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateIndex
+CREATE INDEX "ai_custom_prompts_orgId_type_isActive_idx" ON "ai_custom_prompts"("orgId", "type", "isActive");
+
+-- CreateIndex
+CREATE INDEX "ai_agent_logs_orgId_createdAt_idx" ON "ai_agent_logs"("orgId", "createdAt");
+
+-- CreateIndex
+CREATE INDEX "ai_agent_logs_orgId_context_idx" ON "ai_agent_logs"("orgId", "context");
+
+-- CreateIndex
+CREATE INDEX "ai_chat_feedback_orgId_rating_idx" ON "ai_chat_feedback"("orgId", "rating");
+
+-- AddForeignKey
+ALTER TABLE "routing_rules" ADD CONSTRAINT "routing_rules_defaultOwnerUserId_fkey" FOREIGN KEY ("defaultOwnerUserId") REFERENCES "users"("id") ON DELETE SET NULL ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "routing_rules" ADD CONSTRAINT "routing_rules_defaultOwnerTeamId_fkey" FOREIGN KEY ("defaultOwnerTeamId") REFERENCES "round_robin_teams"("id") ON DELETE SET NULL ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "routing_rules" ADD CONSTRAINT "routing_rules_defaultOwnerQueueId_fkey" FOREIGN KEY ("defaultOwnerQueueId") REFERENCES "sfdc_queues"("id") ON DELETE SET NULL ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "routing_branches" ADD CONSTRAINT "routing_branches_assigneeUserId_fkey" FOREIGN KEY ("assigneeUserId") REFERENCES "users"("id") ON DELETE SET NULL ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "routing_branches" ADD CONSTRAINT "routing_branches_assigneeTeamId_fkey" FOREIGN KEY ("assigneeTeamId") REFERENCES "round_robin_teams"("id") ON DELETE SET NULL ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "routing_branches" ADD CONSTRAINT "routing_branches_assigneeQueueId_fkey" FOREIGN KEY ("assigneeQueueId") REFERENCES "sfdc_queues"("id") ON DELETE SET NULL ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "ai_custom_prompts" ADD CONSTRAINT "ai_custom_prompts_orgId_fkey" FOREIGN KEY ("orgId") REFERENCES "organizations"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "ai_agent_logs" ADD CONSTRAINT "ai_agent_logs_orgId_fkey" FOREIGN KEY ("orgId") REFERENCES "organizations"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "ai_chat_feedback" ADD CONSTRAINT "ai_chat_feedback_orgId_fkey" FOREIGN KEY ("orgId") REFERENCES "organizations"("id") ON DELETE CASCADE ON UPDATE CASCADE;

package/dist/prisma/migrations/20260317000000_add_routing_flows/migration.sql

@@ -0,0 +1,76 @@
+-- CreateEnum
+CREATE TYPE "FlowStatus" AS ENUM ('DRAFT', 'ACTIVE', 'INACTIVE');
+
+-- CreateEnum
+CREATE TYPE "FlowNodeType" AS ENUM ('ENTRY', 'DECISION', 'BRANCH_DECISION', 'MATCH', 'ASSIGNMENT', 'UPDATE_FIELD', 'CREATE_TASK', 'FILTER', 'DEFAULT');
+
+-- AlterTable
+ALTER TABLE "organizations" ADD COLUMN "routingMode" JSONB;
+
+-- AlterTable
+ALTER TABLE "routing_logs" ADD COLUMN "flowId" TEXT,
+ADD COLUMN "flowNodePath" JSONB;
+
+-- CreateTable
+CREATE TABLE "routing_flows" (
+    "id" TEXT NOT NULL,
+    "orgId" TEXT NOT NULL,
+    "objectType" "SfdcObjectType" NOT NULL,
+    "name" TEXT NOT NULL DEFAULT 'Untitled Flow',
+    "status" "FlowStatus" NOT NULL DEFAULT 'DRAFT',
+    "triggerEvent" "TriggerEvent" NOT NULL DEFAULT 'BOTH',
+    "isDryRun" BOOLEAN NOT NULL DEFAULT false,
+    "version" INTEGER NOT NULL DEFAULT 1,
+    "publishedAt" TIMESTAMP(3),
+    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updatedAt" TIMESTAMP(3) NOT NULL,
+
+    CONSTRAINT "routing_flows_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "flow_nodes" (
+    "id" TEXT NOT NULL,
+    "flowId" TEXT NOT NULL,
+    "type" "FlowNodeType" NOT NULL,
+    "label" TEXT,
+    "positionX" DOUBLE PRECISION NOT NULL DEFAULT 0,
+    "positionY" DOUBLE PRECISION NOT NULL DEFAULT 0,
+    "config" JSONB,
+    "sortOrder" INTEGER NOT NULL DEFAULT 0,
+    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updatedAt" TIMESTAMP(3) NOT NULL,
+
+    CONSTRAINT "flow_nodes_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "flow_edges" (
+    "id" TEXT NOT NULL,
+    "flowId" TEXT NOT NULL,
+    "fromId" TEXT NOT NULL,
+    "toId" TEXT NOT NULL,
+    "label" TEXT,
+    "sortOrder" INTEGER NOT NULL DEFAULT 0,
+    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+
+    CONSTRAINT "flow_edges_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateIndex
+CREATE UNIQUE INDEX "routing_flows_orgId_objectType_key" ON "routing_flows"("orgId", "objectType");
+
+-- AddForeignKey
+ALTER TABLE "routing_flows" ADD CONSTRAINT "routing_flows_orgId_fkey" FOREIGN KEY ("orgId") REFERENCES "organizations"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "flow_nodes" ADD CONSTRAINT "flow_nodes_flowId_fkey" FOREIGN KEY ("flowId") REFERENCES "routing_flows"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "flow_edges" ADD CONSTRAINT "flow_edges_flowId_fkey" FOREIGN KEY ("flowId") REFERENCES "routing_flows"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "flow_edges" ADD CONSTRAINT "flow_edges_fromId_fkey" FOREIGN KEY ("fromId") REFERENCES "flow_nodes"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "flow_edges" ADD CONSTRAINT "flow_edges_toId_fkey" FOREIGN KEY ("toId") REFERENCES "flow_nodes"("id") ON DELETE CASCADE ON UPDATE CASCADE;

package/dist/prisma/migrations/20260318000000_add_flow_edge_handles/migration.sql

@@ -0,0 +1,3 @@
+-- AlterTable
+ALTER TABLE "flow_edges" ADD COLUMN "sourceHandle" TEXT;
+ALTER TABLE "flow_edges" ADD COLUMN "targetHandle" TEXT;

package/dist/prisma/migrations/20260318100000_add_branch_steps/migration.sql

@@ -0,0 +1,2 @@
+-- AlterTable
+ALTER TABLE "routing_branches" ADD COLUMN "steps" JSONB;

package/dist/prisma/migrations/20260318200000_add_api_tokens/migration.sql

@@ -0,0 +1,24 @@
+-- CreateTable
+CREATE TABLE "api_tokens" (
+    "id" TEXT NOT NULL,
+    "orgId" TEXT NOT NULL,
+    "name" TEXT NOT NULL,
+    "tokenHash" TEXT NOT NULL,
+    "prefix" TEXT NOT NULL,
+    "scopes" TEXT[] DEFAULT ARRAY['read', 'route']::TEXT[],
+    "lastUsedAt" TIMESTAMP(3),
+    "expiresAt" TIMESTAMP(3),
+    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "revokedAt" TIMESTAMP(3),
+
+    CONSTRAINT "api_tokens_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateIndex
+CREATE UNIQUE INDEX "api_tokens_tokenHash_key" ON "api_tokens"("tokenHash");
+
+-- CreateIndex
+CREATE INDEX "api_tokens_orgId_idx" ON "api_tokens"("orgId");
+
+-- AddForeignKey
+ALTER TABLE "api_tokens" ADD CONSTRAINT "api_tokens_orgId_fkey" FOREIGN KEY ("orgId") REFERENCES "organizations"("id") ON DELETE CASCADE ON UPDATE CASCADE;

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/migrations/migration_lock.toml

@@ -1,3 +1,3 @@
 # Please do not edit this file manually
-# It should be added in your version-control system (i.e. Git)
-provider = "postgresql"
+# It should be added in your version-control system (e.g., Git)
+provider = "postgresql"

package/dist/prisma/schema.prisma

@@ -14,6 +14,7 @@ enum SfdcObjectType {
   LEAD
   CONTACT
   ACCOUNT
+  USER
 }
 
 enum TriggerEvent {
@@ -77,6 +78,24 @@ enum Plan {
   PAID
 }
 
+enum FlowStatus {
+  DRAFT
+  ACTIVE
+  INACTIVE
+}
+
+enum FlowNodeType {
+  ENTRY
+  DECISION
+  BRANCH_DECISION
+  MATCH
+  ASSIGNMENT
+  UPDATE_FIELD
+  CREATE_TASK
+  FILTER
+  DEFAULT
+}
+
 // ─── Models ───────────────────────────────────────────────────────────────────
 
 model Organization {
@@ -128,6 +147,13 @@ model Organization {
   routingDailyAggregates  RoutingDailyAggregate[]
   conversionTracking      ConversionTracking[]
   companyAliases          CompanyAlias[]
+  bulkSearchRuns          BulkSearchRun[]
+  aiCustomPrompts         AiCustomPrompt[]
+  aiAgentLogs             AiAgentLog[]
+  aiChatFeedback          AiChatFeedback[]
+  routingMode             Json?
+  routingFlows            RoutingFlow[]
+  apiTokens               ApiToken[]
 
   @@map("organizations")
 }
@@ -255,6 +281,9 @@ model RoutingRule {
   lastRunDurationMs Int?
   totalRuns         Int             @default(0)
   totalRecordsRouted Int            @default(0)
+  // Bulk search configuration
+  searchMaxRecords  Int?            // user-configurable max records per run
+  searchBatchSize   Int?            // micro-batch size (default 500)
   // Default owner: absolute catch-all for new Route Builder routes
   defaultOwnerType     AssignmentType?
   defaultOwnerUserId   String?
@@ -273,6 +302,7 @@ model RoutingRule {
   branches   RoutingBranch[]  // new Route Builder paths
   matchConfig RouteMatchConfig?
   triggerConditions TriggerCondition[]
+  bulkSearchRuns BulkSearchRun[]
 
   @@map("routing_rules")
 }
@@ -290,6 +320,7 @@ model RoutingBranch {
   assigneeTeam    RoundRobinTeam?  @relation("BranchAssigneeTeam", fields: [assigneeTeamId], references: [id])
   assigneeQueueId String?
   assigneeQueue   SfdcQueue?       @relation("BranchAssigneeQueue", fields: [assigneeQueueId], references: [id])
+  steps           Json?
   createdAt       DateTime       @default(now())
   updatedAt       DateTime       @updatedAt
 
@@ -410,6 +441,8 @@ model RoutingLog {
   branchId           String?           // FK → RoutingBranch for path-level analytics
   createdAt          DateTime        @default(now())
 
+  flowId             String?
+  flowNodePath       Json?
   org                Organization    @relation(fields: [orgId], references: [id], onDelete: Cascade)
   branch             RoutingBranch?  @relation(fields: [branchId], references: [id])
   conversionTracking ConversionTracking?
@@ -440,6 +473,64 @@ model AuditLog {
   @@map("audit_logs")
 }
 
+model RoutingFlow {
+  id           String         @id @default(cuid())
+  orgId        String
+  objectType   SfdcObjectType
+  name         String         @default("Untitled Flow")
+  status       FlowStatus     @default(DRAFT)
+  triggerEvent TriggerEvent   @default(BOTH)
+  isDryRun     Boolean        @default(false)
+  version      Int            @default(1)
+  publishedAt  DateTime?
+  createdAt    DateTime       @default(now())
+  updatedAt    DateTime       @updatedAt
+
+  org   Organization @relation(fields: [orgId], references: [id], onDelete: Cascade)
+  nodes FlowNode[]
+  edges FlowEdge[]
+
+  @@unique([orgId, objectType])
+  @@map("routing_flows")
+}
+
+model FlowNode {
+  id        String       @id @default(cuid())
+  flowId    String
+  type      FlowNodeType
+  label     String?
+  positionX Float        @default(0)
+  positionY Float        @default(0)
+  config    Json?
+  sortOrder Int          @default(0)
+  createdAt DateTime     @default(now())
+  updatedAt DateTime     @updatedAt
+
+  flow     RoutingFlow @relation(fields: [flowId], references: [id], onDelete: Cascade)
+  outEdges FlowEdge[]  @relation("FromNode")
+  inEdges  FlowEdge[]  @relation("ToNode")
+
+  @@map("flow_nodes")
+}
+
+model FlowEdge {
+  id           String   @id @default(cuid())
+  flowId       String
+  fromId       String
+  toId         String
+  label        String?
+  sourceHandle String?
+  targetHandle String?
+  sortOrder    Int      @default(0)
+  createdAt    DateTime @default(now())
+
+  flow RoutingFlow @relation(fields: [flowId], references: [id], onDelete: Cascade)
+  from FlowNode   @relation("FromNode", fields: [fromId], references: [id], onDelete: Cascade)
+  to   FlowNode   @relation("ToNode", fields: [toId], references: [id], onDelete: Cascade)
+
+  @@map("flow_edges")
+}
+
 model SfdcQueue {
   id          String   @id @default(cuid())
   orgId       String
@@ -581,3 +672,103 @@ model CompanyAlias {
   @@index([orgId, nameB])
   @@map("company_aliases")
 }
+
+model BulkSearchRun {
+  id               String    @id @default(cuid())
+  orgId            String
+  ruleId           String
+  status           String    @default("RUNNING") // RUNNING | COMPLETE | FAILED | CANCELLED
+  recordsFound     Int       @default(0)
+  recordsProcessed Int       @default(0)
+  recordsRouted    Int       @default(0)
+  recordsFailed    Int       @default(0)
+  recordsSkipped   Int       @default(0)
+  error            String?
+  startedAt        DateTime  @default(now())
+  completedAt      DateTime?
+  durationMs       Int?
+  maxRecords       Int?
+  batchSize        Int?
+
+  org              Organization @relation(fields: [orgId], references: [id], onDelete: Cascade)
+  rule             RoutingRule  @relation(fields: [ruleId], references: [id], onDelete: Cascade)
+
+  @@index([orgId, ruleId])
+  @@index([ruleId, status])
+  @@map("bulk_search_runs")
+}
+
+model ApiToken {
+  id         String    @id @default(cuid())
+  orgId      String
+  name       String
+  tokenHash  String    @unique
+  prefix     String
+  scopes     String[]  @default(["read", "route"])
+  lastUsedAt DateTime?
+  expiresAt  DateTime?
+  createdAt  DateTime  @default(now())
+  revokedAt  DateTime?
+
+  org Organization @relation(fields: [orgId], references: [id], onDelete: Cascade)
+
+  @@index([orgId])
+  @@map("api_tokens")
+}
+
+model AiCustomPrompt {
+  id        String   @id @default(cuid())
+  orgId     String
+  org       Organization @relation(fields: [orgId], references: [id], onDelete: Cascade)
+  type      String   // "instruction" | "template" | "alias" | "memory"
+  name      String
+  content   String
+  context   String?  // null = global, "license-users" | "teams" | "routing-rules"
+  isActive  Boolean  @default(true)
+  sortOrder Int      @default(0)
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+
+  @@index([orgId, type, isActive])
+  @@map("ai_custom_prompts")
+}
+
+model AiAgentLog {
+  id          String   @id @default(cuid())
+  orgId       String
+  org         Organization @relation(fields: [orgId], references: [id], onDelete: Cascade)
+  context     String
+  toolName    String
+  action      String
+  entityType  String
+  entityId    String?
+  entityName  String?
+  input       Json
+  output      Json?
+  status      String
+  error       String?
+  actorId     String
+  actorName   String
+  durationMs  Int?
+  createdAt   DateTime @default(now())
+
+  @@index([orgId, createdAt])
+  @@index([orgId, context])
+  @@map("ai_agent_logs")
+}
+
+model AiChatFeedback {
+  id           String   @id @default(cuid())
+  orgId        String
+  org          Organization @relation(fields: [orgId], references: [id], onDelete: Cascade)
+  rating       String
+  userMessage  String
+  aiResponse   String
+  toolsUsed    Json?
+  context      String?
+  feedback     String?
+  createdAt    DateTime @default(now())
+
+  @@index([orgId, rating])
+  @@map("ai_chat_feedback")
+}

package/package.json

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