@crmy/cli 0.5.9 → 0.6.1

package/dist/index.js

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
 
 // src/index.ts
-import { Command as Command27 } from "commander";
+import { Command as Command29 } from "commander";
 import { createRequire as createRequire2 } from "module";
 import { fileURLToPath as fileURLToPath2 } from "url";
-import path5 from "path";
+import path6 from "path";
 
 // src/commands/init.ts
 import { Command } from "commander";
@@ -22,10 +22,10 @@ function createSpinner(initialMessage) {
         if (message) console.log(`  ...  ${message}`);
       },
       succeed(message) {
-        console.log(`  \u2713  ${message}`);
+        console.log(`  \x1B[32m\u2713\x1B[0m  ${message}`);
       },
       fail(message) {
-        console.log(`  \u2717  ${message}`);
+        console.log(`  \x1B[31m\u2717\x1B[0m  ${message}`);
       },
       stop() {
       }
@@ -135,10 +135,73 @@ function validateEmail(input) {
   return /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(input.trim()) ? true : "Please enter a valid email address (e.g. you@example.com)";
 }
 function validatePassword(input) {
-  return input.length >= 8 ? true : "Password must be at least 8 characters";
+  return input.length >= 12 ? true : "Password must be at least 12 characters";
+}
+async function ensureDatabaseExists(databaseUrl, interactive) {
+  let parsed;
+  try {
+    parsed = new URL(databaseUrl);
+  } catch {
+    return;
+  }
+  const dbName = parsed.pathname.replace(/^\//, "");
+  if (!dbName) return;
+  const isLocal = parsed.hostname === "localhost" || parsed.hostname === "127.0.0.1" || parsed.hostname === "::1";
+  if (!isLocal) return;
+  const maintUrl = new URL(databaseUrl);
+  maintUrl.pathname = "/postgres";
+  const pg = await import("pg");
+  const client = new pg.default.Client({ connectionString: maintUrl.toString() });
+  try {
+    await client.connect();
+  } catch {
+    return;
+  }
+  try {
+    const result = await client.query(
+      "SELECT 1 FROM pg_database WHERE datname = $1",
+      [dbName]
+    );
+    if (result.rows.length > 0) return;
+    if (interactive) {
+      const { default: inquirer } = await import("inquirer");
+      console.log(`
+  \x1B[33m\u26A0\x1B[0m  Database \x1B[1m${dbName}\x1B[0m does not exist.
+`);
+      const { create } = await inquirer.prompt([
+        {
+          type: "confirm",
+          name: "create",
+          message: `  Create database "${dbName}" now?`,
+          default: true
+        }
+      ]);
+      if (!create) {
+        console.log(`
+  Create it manually:  createdb ${dbName}
+`);
+        process.exit(1);
+      }
+    }
+    const spinner = createSpinner(`Creating database "${dbName}"\u2026`);
+    try {
+      await client.query(`CREATE DATABASE "${dbName}"`);
+      spinner.succeed(`Database "${dbName}" created`);
+    } catch (err) {
+      spinner.fail(`Failed to create database "${dbName}"`);
+      console.error(`
+  Error: ${err.message}`);
+      console.error(`  Create it manually:  createdb ${dbName}
+`);
+      process.exit(1);
+    }
+  } finally {
+    await client.end();
+  }
 }
 function initCommand() {
-  return new Command("init").description("Interactive setup wizard: database, migrations, admin account").action(async () => {
+  return new Command("init").description("Interactive setup wizard: database, migrations, admin account").option("-y, --yes", "Accept defaults non-interactively (requires CRMY_ADMIN_EMAIL + CRMY_ADMIN_PASSWORD env vars)").action(async (opts) => {
+    const yesMode = !!opts.yes;
     const { default: inquirer } = await import("inquirer");
     console.log("\n  \u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510");
     console.log("  \u2502         crmy.ai \u2014 Setup Wizard              \u2502");
@@ -149,39 +212,53 @@ function initCommand() {
     console.log("    Step 3 \u2014 Create your admin account\n");
     const localConfigPath = path2.join(process.cwd(), ".crmy.json");
     if (fs2.existsSync(localConfigPath)) {
-      console.log("  \x1B[33m\u26A0\x1B[0m  A .crmy.json already exists in this directory.\n");
-      const { overwrite } = await inquirer.prompt([
+      if (yesMode) {
+        console.log("  \x1B[33m\u26A0\x1B[0m  Overwriting existing .crmy.json (--yes mode)\n");
+      } else {
+        console.log("  \x1B[33m\u26A0\x1B[0m  A .crmy.json already exists in this directory.\n");
+        const { overwrite } = await inquirer.prompt([
+          {
+            type: "confirm",
+            name: "overwrite",
+            message: "  Overwrite it and run setup again?",
+            default: false
+          }
+        ]);
+        if (!overwrite) {
+          console.log("\n  Setup cancelled. Your existing config was not changed.\n");
+          process.exit(0);
+        }
+        console.log("");
+      }
+    }
+    console.log("  \u2500\u2500 Step 1 of 3: Database Connection \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n");
+    let databaseUrl;
+    if (yesMode) {
+      databaseUrl = process.env.DATABASE_URL ?? "postgresql://localhost:5432/crmy";
+      console.log(`  Using database URL: ${databaseUrl}
+`);
+    } else {
+      console.log("  Enter your PostgreSQL connection string.");
+      console.log("  Format: postgresql://user:password@host:5432/dbname\n");
+      console.log("  Options:");
+      console.log("    \u2022 Local install:  postgresql://localhost:5432/crmy");
+      console.log("    \u2022 Docker:         postgresql://postgres:postgres@localhost:5432/crmy");
+      console.log("    \u2022 Supabase:       Project Settings \u2192 Database \u2192 Connection String");
+      console.log("    \u2022 Neon:           Dashboard \u2192 Connection Details\n");
+      console.log("  \x1B[2mNote: the wizard will retry the connection up to 5 times.\x1B[0m\n");
+      const answers = await inquirer.prompt([
         {
-          type: "confirm",
-          name: "overwrite",
-          message: "  Overwrite it and run setup again?",
-          default: false
+          type: "input",
+          name: "databaseUrl",
+          message: "  PostgreSQL connection string:",
+          default: "postgresql://localhost:5432/crmy"
         }
       ]);
-      if (!overwrite) {
-        console.log("\n  Setup cancelled. Your existing config was not changed.\n");
-        process.exit(0);
-      }
-      console.log("");
+      databaseUrl = answers.databaseUrl;
     }
-    console.log("  \u2500\u2500 Step 1 of 3: Database Connection \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n");
-    console.log("  Enter your PostgreSQL connection string.");
-    console.log("  Format: postgresql://user:password@host:5432/dbname\n");
-    console.log("  Options:");
-    console.log("    \u2022 Local install:  postgresql://localhost:5432/crmy");
-    console.log("    \u2022 Docker:         postgresql://postgres:postgres@localhost:5432/crmy");
-    console.log("    \u2022 Supabase:       Project Settings \u2192 Database \u2192 Connection String");
-    console.log("    \u2022 Neon:           Dashboard \u2192 Connection Details\n");
-    console.log("  \x1B[2mNote: the wizard will retry the connection up to 5 times.\x1B[0m\n");
-    const { databaseUrl } = await inquirer.prompt([
-      {
-        type: "input",
-        name: "databaseUrl",
-        message: "  PostgreSQL connection string:",
-        default: "postgresql://localhost:5432/crmy"
-      }
-    ]);
-    console.log("\n  \u2500\u2500 Step 2 of 3: Database Setup \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n");
+    const isInteractive = process.stdin.isTTY !== false && !yesMode;
+    await ensureDatabaseExists(databaseUrl, isInteractive);
+    console.log("\n  \u2500\u2500 Step 2 of 3: Database Setup \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n");
     process.env.CRMY_IMPORTED = "1";
     const { initPool, closePool, runMigrations } = await import("@crmy/server");
     let spinner = createSpinner("Connecting to database\u2026");
@@ -208,7 +285,9 @@ function initCommand() {
     spinner = createSpinner("Running database migrations\u2026");
     let ran = [];
     try {
-      ran = await runMigrations(db);
+      ran = await runMigrations(db, (name2, index, total) => {
+        spinner.update(`Running migration ${index + 1}/${total}: ${name2}\u2026`);
+      });
       if (ran.length > 0) {
         spinner.succeed(`Migrations complete  \x1B[2m(${ran.length} applied)\x1B[0m`);
       } else {
@@ -230,6 +309,38 @@ function initCommand() {
       await closePool();
       process.exit(1);
     }
+    if (process.env.ENABLE_PGVECTOR !== "true" && !yesMode && isInteractive) {
+      console.log("");
+      const { enablePgvector } = await inquirer.prompt([
+        {
+          type: "confirm",
+          name: "enablePgvector",
+          message: "  Enable semantic search? (requires pgvector extension in PostgreSQL)",
+          default: false
+        }
+      ]);
+      if (enablePgvector) {
+        process.env.ENABLE_PGVECTOR = "true";
+        spinner = createSpinner("Running pgvector migration\u2026");
+        try {
+          const pgRan = await runMigrations(db);
+          if (pgRan.length > 0) {
+            spinner.succeed("Semantic search enabled  \x1B[2m(pgvector)\x1B[0m");
+          } else {
+            spinner.succeed("Semantic search  \x1B[2m(already enabled)\x1B[0m");
+          }
+        } catch (err) {
+          spinner.fail("pgvector migration failed");
+          console.log(
+            `
+  \x1B[33m\u26A0\x1B[0m  ${err.message}
+  This is non-fatal \u2014 CRMy works without semantic search.
+  You can enable it later by setting ENABLE_PGVECTOR=true and running: crmy migrate
+`
+          );
+        }
+      }
+    }
     spinner = createSpinner("Seeding default tenant\u2026");
     let tenantId;
     try {
@@ -248,34 +359,84 @@ function initCommand() {
       await closePool();
       process.exit(1);
     }
-    console.log("\n  \u2500\u2500 Step 3 of 3: Admin Account \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n");
-    console.log("  Create the first admin account for the CRMy web UI and CLI.\n");
-    console.log(
-      "  \x1B[33mNOTE:\x1B[0m These are your \x1B[1mCRMy login credentials\x1B[0m \u2014 NOT your database credentials.\n"
-    );
-    const { name, email, password } = await inquirer.prompt([
-      {
-        type: "input",
-        name: "name",
-        message: "  Your full name:"
-      },
-      {
-        type: "input",
-        name: "email",
-        message: "  Email address (used to log in):",
-        validate: validateEmail
-      },
-      {
-        type: "password",
-        name: "password",
-        message: "  Password (min 8 characters):",
-        mask: "*",
-        validate: validatePassword
+    console.log("\n  \u2500\u2500 Step 3 of 3: Admin Account \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n");
+    const envEmail = process.env.CRMY_ADMIN_EMAIL;
+    const envPassword = process.env.CRMY_ADMIN_PASSWORD;
+    const envName = process.env.CRMY_ADMIN_NAME;
+    const useEnvVars = yesMode || !isInteractive || !!envEmail;
+    let name;
+    let email;
+    let password;
+    if (!useEnvVars) {
+      console.log("  Create the first admin account for the CRMy web UI and CLI.\n");
+      console.log(
+        "  \x1B[33mNOTE:\x1B[0m These are your \x1B[1mCRMy login credentials\x1B[0m \u2014 NOT your database credentials.\n"
+      );
+      const answers = await inquirer.prompt([
+        {
+          type: "input",
+          name: "name",
+          message: "  Your full name:"
+        },
+        {
+          type: "input",
+          name: "email",
+          message: "  Admin email:",
+          validate: validateEmail
+        },
+        {
+          type: "password",
+          name: "password",
+          message: "  Admin password (min 12 chars):",
+          mask: "*",
+          validate: validatePassword
+        },
+        {
+          type: "password",
+          name: "confirmPassword",
+          message: "  Confirm password:",
+          mask: "*",
+          validate: (input, answers2) => input === answers2?.password ? true : "Passwords do not match"
+        }
+      ]);
+      name = answers.name;
+      email = answers.email;
+      password = answers.password;
+    } else {
+      if (!envEmail || !envPassword) {
+        console.error(
+          "\n  Error: Non-interactive environment detected.\n\n  Set CRMY_ADMIN_EMAIL and CRMY_ADMIN_PASSWORD environment variables\n  to create the admin account without interactive prompts.\n  (Also required when using --yes flag)\n"
+        );
+        await closePool();
+        process.exit(1);
       }
-    ]);
+      const emailValid = validateEmail(envEmail);
+      if (emailValid !== true) {
+        console.error(`
+  Error: CRMY_ADMIN_EMAIL is invalid \u2014 ${emailValid}
+`);
+        await closePool();
+        process.exit(1);
+      }
+      const pwValid = validatePassword(envPassword);
+      if (pwValid !== true) {
+        console.error(`
+  Error: CRMY_ADMIN_PASSWORD is invalid \u2014 ${pwValid}
+`);
+        await closePool();
+        process.exit(1);
+      }
+      name = envName ?? "Admin";
+      email = envEmail;
+      password = envPassword;
+      console.log("  Creating admin account from environment variables\u2026\n");
+    }
     spinner = createSpinner("Creating admin account\u2026");
+    let rawKey = "";
     try {
-      const passwordHash = crypto.createHash("sha256").update(password).digest("hex");
+      const salt = crypto.randomBytes(16);
+      const hash = crypto.scryptSync(password, salt, 64, { N: 16384, r: 8, p: 1 });
+      const passwordHash = `scrypt:${salt.toString("hex")}:${hash.toString("hex")}`;
       const userResult = await db.query(
         `INSERT INTO users (tenant_id, email, name, role, password_hash)
            VALUES ($1, $2, $3, 'owner', $4)
@@ -284,7 +445,7 @@ function initCommand() {
         [tenantId, email.trim(), name, passwordHash]
       );
       const userId = userResult.rows[0].id;
-      const rawKey = "crmy_" + crypto.randomBytes(32).toString("hex");
+      rawKey = "crmy_" + crypto.randomBytes(32).toString("hex");
       const keyHash = crypto.createHash("sha256").update(rawKey).digest("hex");
       await db.query(
         `INSERT INTO api_keys (tenant_id, user_id, key_hash, label, scopes)
@@ -318,11 +479,73 @@ function initCommand() {
       await closePool();
       process.exit(1);
     }
+    let seedDemo = yesMode;
+    if (!yesMode && isInteractive) {
+      const { loadDemo } = await inquirer.prompt([
+        {
+          type: "confirm",
+          name: "loadDemo",
+          message: "  Load demo data to explore CRMy?",
+          default: true
+        }
+      ]);
+      seedDemo = loadDemo;
+    }
+    if (seedDemo) {
+      console.log("");
+      spinner = createSpinner("Seeding demo data\u2026");
+      try {
+        const serverModule = await import("@crmy/server");
+        const IDS = {
+          ACTOR_CODY: "d0000000-0000-4000-a000-000000000001",
+          ACTOR_SARAH_R: "d0000000-0000-4000-a000-000000000002",
+          ACTOR_OUTREACH: "d0000000-0000-4000-a000-000000000003",
+          ACTOR_RESEARCH: "d0000000-0000-4000-a000-000000000004",
+          ACCT_ACME: "d0000000-0000-4000-b000-000000000001",
+          ACCT_BRIGHTSIDE: "d0000000-0000-4000-b000-000000000002",
+          ACCT_VERTEX: "d0000000-0000-4000-b000-000000000003",
+          CT_SARAH_CHEN: "d0000000-0000-4000-c000-000000000001",
+          CT_MARCUS_WEBB: "d0000000-0000-4000-c000-000000000002",
+          CT_PRIYA_NAIR: "d0000000-0000-4000-c000-000000000003",
+          CT_JORDAN_LIU: "d0000000-0000-4000-c000-000000000004",
+          CT_TOMAS_RIVERA: "d0000000-0000-4000-c000-000000000005",
+          CT_KEIKO_YAMAMOTO: "d0000000-0000-4000-c000-000000000006",
+          OPP_ACME: "d0000000-0000-4000-d000-000000000001",
+          OPP_BRIGHTSIDE: "d0000000-0000-4000-d000-000000000002",
+          OPP_VERTEX: "d0000000-0000-4000-d000-000000000003"
+        };
+        const check = await db.query("SELECT id FROM actors WHERE id = $1", [IDS.ACTOR_CODY]);
+        if (check.rows.length === 0) {
+          await db.query(`INSERT INTO actors (id, tenant_id, actor_type, display_name, email) VALUES ($1, $2, 'human', 'Cody Harris', 'cody@crmy.ai') ON CONFLICT (id) DO NOTHING`, [IDS.ACTOR_CODY, tenantId]);
+          await db.query(`INSERT INTO actors (id, tenant_id, actor_type, display_name, email) VALUES ($1, $2, 'human', 'Sarah Reeves', 'sarah@crmy.ai') ON CONFLICT (id) DO NOTHING`, [IDS.ACTOR_SARAH_R, tenantId]);
+          await db.query(`INSERT INTO actors (id, tenant_id, actor_type, display_name, email, agent_identifier, agent_model) VALUES ($1, $2, 'agent', 'Outreach Agent', NULL, 'outreach-v1', 'claude-sonnet-4-20250514') ON CONFLICT (id) DO NOTHING`, [IDS.ACTOR_OUTREACH, tenantId]);
+          await db.query(`INSERT INTO actors (id, tenant_id, actor_type, display_name, email, agent_identifier, agent_model) VALUES ($1, $2, 'agent', 'Research Agent', NULL, 'research-v1', 'claude-sonnet-4-20250514') ON CONFLICT (id) DO NOTHING`, [IDS.ACTOR_RESEARCH, tenantId]);
+          await db.query(`INSERT INTO accounts (id, tenant_id, name, industry, health_score, annual_revenue, domain, website) VALUES ($1, $2, 'Acme Corp', 'SaaS', 72, 180000, 'acme.com', 'https://acme.com') ON CONFLICT (id) DO NOTHING`, [IDS.ACCT_ACME, tenantId]);
+          await db.query(`INSERT INTO accounts (id, tenant_id, name, industry, health_score, annual_revenue, domain, website) VALUES ($1, $2, 'Brightside Health', 'Healthcare', 45, 96000, 'brightsidehealth.com', 'https://brightsidehealth.com') ON CONFLICT (id) DO NOTHING`, [IDS.ACCT_BRIGHTSIDE, tenantId]);
+          await db.query(`INSERT INTO accounts (id, tenant_id, name, industry, health_score, annual_revenue, domain, website) VALUES ($1, $2, 'Vertex Logistics', 'Logistics', 88, 240000, 'vertex.io', 'https://vertex.io') ON CONFLICT (id) DO NOTHING`, [IDS.ACCT_VERTEX, tenantId]);
+          await db.query(`INSERT INTO contacts (id, tenant_id, first_name, last_name, email, title, account_id, lifecycle_stage) VALUES ($1, $2, 'Sarah', 'Chen', 'sarah.chen@acme.com', 'VP Engineering', $3, 'prospect') ON CONFLICT (id) DO NOTHING`, [IDS.CT_SARAH_CHEN, tenantId, IDS.ACCT_ACME]);
+          await db.query(`INSERT INTO contacts (id, tenant_id, first_name, last_name, email, title, account_id, lifecycle_stage) VALUES ($1, $2, 'Marcus', 'Webb', 'marcus.webb@acme.com', 'CFO', $3, 'prospect') ON CONFLICT (id) DO NOTHING`, [IDS.CT_MARCUS_WEBB, tenantId, IDS.ACCT_ACME]);
+          await db.query(`INSERT INTO contacts (id, tenant_id, first_name, last_name, email, title, account_id, lifecycle_stage) VALUES ($1, $2, 'Priya', 'Nair', 'p.nair@brightsidehealth.com', 'CTO', $3, 'active') ON CONFLICT (id) DO NOTHING`, [IDS.CT_PRIYA_NAIR, tenantId, IDS.ACCT_BRIGHTSIDE]);
+          await db.query(`INSERT INTO contacts (id, tenant_id, first_name, last_name, email, title, account_id, lifecycle_stage) VALUES ($1, $2, 'Jordan', 'Liu', 'j.liu@brightsidehealth.com', 'RevOps Lead', $3, 'active') ON CONFLICT (id) DO NOTHING`, [IDS.CT_JORDAN_LIU, tenantId, IDS.ACCT_BRIGHTSIDE]);
+          await db.query(`INSERT INTO contacts (id, tenant_id, first_name, last_name, email, title, account_id, lifecycle_stage) VALUES ($1, $2, 'Tom\xE1s', 'Rivera', 't.rivera@vertex.io', 'Head of Sales Ops', $3, 'champion') ON CONFLICT (id) DO NOTHING`, [IDS.CT_TOMAS_RIVERA, tenantId, IDS.ACCT_VERTEX]);
+          await db.query(`INSERT INTO contacts (id, tenant_id, first_name, last_name, email, title, account_id, lifecycle_stage) VALUES ($1, $2, 'Keiko', 'Yamamoto', 'k.yamamoto@vertex.io', 'CEO', $3, 'champion') ON CONFLICT (id) DO NOTHING`, [IDS.CT_KEIKO_YAMAMOTO, tenantId, IDS.ACCT_VERTEX]);
+          await db.query(`INSERT INTO opportunities (id, tenant_id, name, account_id, stage, amount, close_date) VALUES ($1, $2, 'Acme Corp Enterprise Deal', $3, 'Discovery', 180000, '2026-06-30') ON CONFLICT (id) DO NOTHING`, [IDS.OPP_ACME, tenantId, IDS.ACCT_ACME]);
+          await db.query(`INSERT INTO opportunities (id, tenant_id, name, account_id, stage, amount, close_date) VALUES ($1, $2, 'Brightside Health Platform Deal', $3, 'PoC', 96000, '2026-05-15') ON CONFLICT (id) DO NOTHING`, [IDS.OPP_BRIGHTSIDE, tenantId, IDS.ACCT_BRIGHTSIDE]);
+          await db.query(`INSERT INTO opportunities (id, tenant_id, name, account_id, stage, amount, close_date) VALUES ($1, $2, 'Vertex Logistics Expansion', $3, 'Negotiation', 240000, '2026-04-30') ON CONFLICT (id) DO NOTHING`, [IDS.OPP_VERTEX, tenantId, IDS.ACCT_VERTEX]);
+        }
+        spinner.succeed("Demo data seeded  \x1B[2m(3 accounts, 6 contacts, 3 opportunities)\x1B[0m");
+      } catch {
+        spinner.fail("Demo data seeding failed");
+        console.log("  \x1B[33m\u26A0\x1B[0m  You can run it later with: crmy seed-demo\n");
+      }
+    }
     await closePool();
+    const keyPreview = rawKey.substring(0, 16) + "\u2026";
     console.log("\n  \u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510");
     console.log("  \u2502   \x1B[32m\u2713\x1B[0m  CRMy is ready!                              \u2502");
     console.log("  \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n");
     console.log(`  Admin account:  ${email.trim()}`);
+    console.log(`  API key:        ${keyPreview}  \x1B[2m(full key in .crmy.json)\x1B[0m`);
     console.log("  Config saved:   .crmy.json  \x1B[2m(added to .gitignore)\x1B[0m\n");
     console.log("  Next steps:\n");
     console.log("    Start the server:");
@@ -421,7 +644,7 @@ function getCLIVersion() {
     );
     return pkg.version;
   } catch {
-    return "0.5.5";
+    return "unknown";
   }
 }
 function printReadyBox(port) {
@@ -490,6 +713,10 @@ function serverCommand() {
         spinner.fail(`${stepLabels[step] ?? step} failed`);
       }
     };
+    serverConfig.onMigration = (name, index, total) => {
+      spinner.update(`Running migration ${index + 1}/${total}: ${name}\u2026`);
+      logToFile(`[MIGRATION] ${index + 1}/${total}: ${name}`);
+    };
     let hitlInterval;
     try {
       const result = await createApp(serverConfig);
@@ -760,8 +987,8 @@ function createHttpClient(serverUrl, token) {
       if (!mapping) {
         throw new Error(`Unknown tool: ${toolName} (no REST mapping)`);
       }
-      const { method, path: path6 } = mapping;
-      const url = `${serverUrl.replace(/\/$/, "")}${path6(input)}`;
+      const { method, path: path7 } = mapping;
+      const url = `${serverUrl.replace(/\/$/, "")}${path7(input)}`;
       const headers = {
         "Authorization": `Bearer ${token}`,
         "Content-Type": "application/json"
@@ -2408,19 +2635,360 @@ function helpCommand() {
   });
 }
 
+// src/commands/seed-demo.ts
+import { Command as Command27 } from "commander";
+function seedDemoCommand() {
+  return new Command27("seed-demo").description("Seed rich demo data for exploring CRMy (idempotent)").option("--reset", "Drop and re-seed demo data (dev only)").action(async (opts) => {
+    const config = loadConfigFile();
+    const databaseUrl = config.database?.url ?? process.env.DATABASE_URL;
+    if (!databaseUrl) {
+      console.error(
+        "\n  Error: No database URL found.\n\n  Either run `crmy init` first or set DATABASE_URL in your environment.\n"
+      );
+      process.exit(1);
+    }
+    const spinner = createSpinner("Seeding demo data\u2026");
+    try {
+      let daysAgo2 = function(n) {
+        const d = /* @__PURE__ */ new Date();
+        d.setDate(d.getDate() - n);
+        return d.toISOString();
+      }, daysFromNow2 = function(n) {
+        const d = /* @__PURE__ */ new Date();
+        d.setDate(d.getDate() + n);
+        return d.toISOString().slice(0, 10);
+      };
+      var daysAgo = daysAgo2, daysFromNow = daysFromNow2;
+      const pgMod = await import("pg");
+      const { Pool } = pgMod.default ?? pgMod;
+      const pool = new Pool({ connectionString: databaseUrl });
+      const tenantRes = await pool.query(`SELECT id FROM tenants LIMIT 1`);
+      if (tenantRes.rows.length === 0) {
+        spinner.fail("No tenant found");
+        console.error("\n  Run `crmy init` first to create the database schema.\n");
+        await pool.end();
+        process.exit(1);
+      }
+      const tenantId = tenantRes.rows[0].id;
+      const IDS = {
+        ACTOR_CODY: "d0000000-0000-4000-a000-000000000001",
+        ACTOR_SARAH_R: "d0000000-0000-4000-a000-000000000002",
+        ACTOR_OUTREACH: "d0000000-0000-4000-a000-000000000003",
+        ACTOR_RESEARCH: "d0000000-0000-4000-a000-000000000004",
+        ACCT_ACME: "d0000000-0000-4000-b000-000000000001",
+        ACCT_BRIGHTSIDE: "d0000000-0000-4000-b000-000000000002",
+        ACCT_VERTEX: "d0000000-0000-4000-b000-000000000003",
+        CT_SARAH_CHEN: "d0000000-0000-4000-c000-000000000001",
+        CT_MARCUS_WEBB: "d0000000-0000-4000-c000-000000000002",
+        CT_PRIYA_NAIR: "d0000000-0000-4000-c000-000000000003",
+        CT_JORDAN_LIU: "d0000000-0000-4000-c000-000000000004",
+        CT_TOMAS_RIVERA: "d0000000-0000-4000-c000-000000000005",
+        CT_KEIKO_YAMAMOTO: "d0000000-0000-4000-c000-000000000006",
+        OPP_ACME: "d0000000-0000-4000-d000-000000000001",
+        OPP_BRIGHTSIDE: "d0000000-0000-4000-d000-000000000002",
+        OPP_VERTEX: "d0000000-0000-4000-d000-000000000003",
+        ACT_1: "d0000000-0000-4000-e000-000000000001",
+        ACT_2: "d0000000-0000-4000-e000-000000000002",
+        ACT_3: "d0000000-0000-4000-e000-000000000003",
+        ACT_4: "d0000000-0000-4000-e000-000000000004",
+        ACT_5: "d0000000-0000-4000-e000-000000000005",
+        ACT_6: "d0000000-0000-4000-e000-000000000006",
+        ACT_7: "d0000000-0000-4000-e000-000000000007",
+        ACT_8: "d0000000-0000-4000-e000-000000000008",
+        ACT_9: "d0000000-0000-4000-e000-000000000009",
+        ACT_10: "d0000000-0000-4000-e000-000000000010",
+        CTX_1: "d0000000-0000-4000-f000-000000000001",
+        CTX_2: "d0000000-0000-4000-f000-000000000002",
+        CTX_3: "d0000000-0000-4000-f000-000000000003",
+        CTX_4: "d0000000-0000-4000-f000-000000000004",
+        CTX_5: "d0000000-0000-4000-f000-000000000005",
+        CTX_6: "d0000000-0000-4000-f000-000000000006",
+        CTX_7: "d0000000-0000-4000-f000-000000000007",
+        CTX_8: "d0000000-0000-4000-f000-000000000008",
+        CTX_9: "d0000000-0000-4000-f000-000000000009",
+        CTX_10: "d0000000-0000-4000-f000-000000000010",
+        CTX_11: "d0000000-0000-4000-f000-000000000011",
+        CTX_12: "d0000000-0000-4000-f000-000000000012",
+        ASSIGN_1: "d0000000-0000-4000-f100-000000000001",
+        ASSIGN_2: "d0000000-0000-4000-f100-000000000002",
+        ASSIGN_3: "d0000000-0000-4000-f100-000000000003"
+      };
+      if (opts.reset) {
+        const demoIds = Object.values(IDS);
+        await pool.query(`DELETE FROM assignments WHERE id = ANY($1::uuid[])`, [demoIds]);
+        await pool.query(`DELETE FROM context_entries WHERE id = ANY($1::uuid[])`, [demoIds]);
+        await pool.query(`DELETE FROM activities WHERE id = ANY($1::uuid[])`, [demoIds]);
+        await pool.query(`DELETE FROM opportunities WHERE id = ANY($1::uuid[])`, [demoIds]);
+        await pool.query(`DELETE FROM contacts WHERE id = ANY($1::uuid[])`, [demoIds]);
+        await pool.query(`DELETE FROM accounts WHERE id = ANY($1::uuid[])`, [demoIds]);
+        await pool.query(`DELETE FROM actors WHERE id = ANY($1::uuid[])`, [demoIds]);
+      }
+      await pool.query(
+        `INSERT INTO actors (id, tenant_id, actor_type, display_name, email) VALUES ($1, $2, 'human', 'Cody Harris', 'cody@crmy.ai') ON CONFLICT (id) DO NOTHING`,
+        [IDS.ACTOR_CODY, tenantId]
+      );
+      await pool.query(
+        `INSERT INTO actors (id, tenant_id, actor_type, display_name, email) VALUES ($1, $2, 'human', 'Sarah Reeves', 'sarah@crmy.ai') ON CONFLICT (id) DO NOTHING`,
+        [IDS.ACTOR_SARAH_R, tenantId]
+      );
+      await pool.query(
+        `INSERT INTO actors (id, tenant_id, actor_type, display_name, email, agent_identifier, agent_model) VALUES ($1, $2, 'agent', 'Outreach Agent', NULL, 'outreach-v1', 'claude-sonnet-4-20250514') ON CONFLICT (id) DO NOTHING`,
+        [IDS.ACTOR_OUTREACH, tenantId]
+      );
+      await pool.query(
+        `INSERT INTO actors (id, tenant_id, actor_type, display_name, email, agent_identifier, agent_model) VALUES ($1, $2, 'agent', 'Research Agent', NULL, 'research-v1', 'claude-sonnet-4-20250514') ON CONFLICT (id) DO NOTHING`,
+        [IDS.ACTOR_RESEARCH, tenantId]
+      );
+      await pool.query(
+        `INSERT INTO accounts (id, tenant_id, name, industry, health_score, annual_revenue, domain, website) VALUES ($1, $2, 'Acme Corp', 'SaaS', 72, 180000, 'acme.com', 'https://acme.com') ON CONFLICT (id) DO NOTHING`,
+        [IDS.ACCT_ACME, tenantId]
+      );
+      await pool.query(
+        `INSERT INTO accounts (id, tenant_id, name, industry, health_score, annual_revenue, domain, website) VALUES ($1, $2, 'Brightside Health', 'Healthcare', 45, 96000, 'brightsidehealth.com', 'https://brightsidehealth.com') ON CONFLICT (id) DO NOTHING`,
+        [IDS.ACCT_BRIGHTSIDE, tenantId]
+      );
+      await pool.query(
+        `INSERT INTO accounts (id, tenant_id, name, industry, health_score, annual_revenue, domain, website) VALUES ($1, $2, 'Vertex Logistics', 'Logistics', 88, 240000, 'vertex.io', 'https://vertex.io') ON CONFLICT (id) DO NOTHING`,
+        [IDS.ACCT_VERTEX, tenantId]
+      );
+      await pool.query(`INSERT INTO contacts (id, tenant_id, first_name, last_name, email, title, account_id, lifecycle_stage) VALUES ($1, $2, 'Sarah', 'Chen', 'sarah.chen@acme.com', 'VP Engineering', $3, 'prospect') ON CONFLICT (id) DO NOTHING`, [IDS.CT_SARAH_CHEN, tenantId, IDS.ACCT_ACME]);
+      await pool.query(`INSERT INTO contacts (id, tenant_id, first_name, last_name, email, title, account_id, lifecycle_stage) VALUES ($1, $2, 'Marcus', 'Webb', 'marcus.webb@acme.com', 'CFO', $3, 'prospect') ON CONFLICT (id) DO NOTHING`, [IDS.CT_MARCUS_WEBB, tenantId, IDS.ACCT_ACME]);
+      await pool.query(`INSERT INTO contacts (id, tenant_id, first_name, last_name, email, title, account_id, lifecycle_stage) VALUES ($1, $2, 'Priya', 'Nair', 'p.nair@brightsidehealth.com', 'CTO', $3, 'active') ON CONFLICT (id) DO NOTHING`, [IDS.CT_PRIYA_NAIR, tenantId, IDS.ACCT_BRIGHTSIDE]);
+      await pool.query(`INSERT INTO contacts (id, tenant_id, first_name, last_name, email, title, account_id, lifecycle_stage) VALUES ($1, $2, 'Jordan', 'Liu', 'j.liu@brightsidehealth.com', 'RevOps Lead', $3, 'active') ON CONFLICT (id) DO NOTHING`, [IDS.CT_JORDAN_LIU, tenantId, IDS.ACCT_BRIGHTSIDE]);
+      await pool.query(`INSERT INTO contacts (id, tenant_id, first_name, last_name, email, title, account_id, lifecycle_stage) VALUES ($1, $2, 'Tom\xE1s', 'Rivera', 't.rivera@vertex.io', 'Head of Sales Ops', $3, 'champion') ON CONFLICT (id) DO NOTHING`, [IDS.CT_TOMAS_RIVERA, tenantId, IDS.ACCT_VERTEX]);
+      await pool.query(`INSERT INTO contacts (id, tenant_id, first_name, last_name, email, title, account_id, lifecycle_stage) VALUES ($1, $2, 'Keiko', 'Yamamoto', 'k.yamamoto@vertex.io', 'CEO', $3, 'champion') ON CONFLICT (id) DO NOTHING`, [IDS.CT_KEIKO_YAMAMOTO, tenantId, IDS.ACCT_VERTEX]);
+      await pool.query(`INSERT INTO opportunities (id, tenant_id, name, account_id, stage, amount, close_date) VALUES ($1, $2, 'Acme Corp Enterprise Deal', $3, 'Discovery', 180000, '2026-06-30') ON CONFLICT (id) DO NOTHING`, [IDS.OPP_ACME, tenantId, IDS.ACCT_ACME]);
+      await pool.query(`INSERT INTO opportunities (id, tenant_id, name, account_id, stage, amount, close_date) VALUES ($1, $2, 'Brightside Health Platform Deal', $3, 'PoC', 96000, '2026-05-15') ON CONFLICT (id) DO NOTHING`, [IDS.OPP_BRIGHTSIDE, tenantId, IDS.ACCT_BRIGHTSIDE]);
+      await pool.query(`INSERT INTO opportunities (id, tenant_id, name, account_id, stage, amount, close_date) VALUES ($1, $2, 'Vertex Logistics Expansion', $3, 'Negotiation', 240000, '2026-04-30') ON CONFLICT (id) DO NOTHING`, [IDS.OPP_VERTEX, tenantId, IDS.ACCT_VERTEX]);
+      await pool.query(`INSERT INTO activities (id, tenant_id, type, subject, body, performed_by, subject_type, subject_id, occurred_at, outcome, detail) VALUES ($1, $2, 'outreach_email', 'Initial outreach to Sarah Chen', 'Personalized email introducing CRMy platform capabilities and requesting a discovery call.', $3, 'contact', $4, $5, 'replied', $6) ON CONFLICT (id) DO NOTHING`, [IDS.ACT_1, tenantId, IDS.ACTOR_OUTREACH, IDS.CT_SARAH_CHEN, daysAgo2(14), JSON.stringify({ to: "sarah.chen@acme.com", subject: "Scaling your sales ops after Series B", channel: "email" })]);
+      await pool.query(`INSERT INTO activities (id, tenant_id, type, subject, body, performed_by, subject_type, subject_id, related_type, related_id, occurred_at, outcome, detail) VALUES ($1, $2, 'meeting_held', 'Discovery call \u2014 Acme Corp', 'Discussed current pain points with Salesforce. Sarah is the champion. Marcus asked pointed questions about 6-month ROI.', $3, 'opportunity', $4, 'account', $5, $6, 'completed', $7) ON CONFLICT (id) DO NOTHING`, [IDS.ACT_2, tenantId, IDS.ACTOR_CODY, IDS.OPP_ACME, IDS.ACCT_ACME, daysAgo2(10), JSON.stringify({ duration_minutes: 45, attendees: ["sarah.chen@acme.com", "marcus.webb@acme.com", "cody@crmy.ai"] })]);
+      await pool.query(`INSERT INTO activities (id, tenant_id, type, subject, body, performed_by, subject_type, subject_id, occurred_at, outcome, detail) VALUES ($1, $2, 'proposal_drafted', 'Draft proposal for Acme Corp Enterprise Deal', 'Generated initial proposal with three tiers. Included ROI projections and the Vertex case study.', $3, 'opportunity', $4, $5, 'completed', $6) ON CONFLICT (id) DO NOTHING`, [IDS.ACT_3, tenantId, IDS.ACTOR_OUTREACH, IDS.OPP_ACME, daysAgo2(7), JSON.stringify({ document_type: "proposal", version: "v1-draft" })]);
+      await pool.query(`INSERT INTO activities (id, tenant_id, type, subject, body, performed_by, subject_type, subject_id, occurred_at, outcome, detail) VALUES ($1, $2, 'research_completed', 'Deep research on Brightside Health', 'Compiled competitive landscape, org chart, recent funding, and technology stack analysis.', $3, 'account', $4, $5, 'completed', $6) ON CONFLICT (id) DO NOTHING`, [IDS.ACT_4, tenantId, IDS.ACTOR_RESEARCH, IDS.ACCT_BRIGHTSIDE, daysAgo2(5), JSON.stringify({ sources: ["crunchbase", "linkedin", "company_blog"], findings_count: 8 })]);
+      await pool.query(`INSERT INTO activities (id, tenant_id, type, subject, body, performed_by, subject_type, subject_id, occurred_at, outcome, detail) VALUES ($1, $2, 'outreach_call', 'Follow-up call to Dr. Priya Nair', 'Attempted direct call. Went to voicemail. Left message highlighting open-source model and self-hosting.', $3, 'contact', $4, $5, 'voicemail', $6) ON CONFLICT (id) DO NOTHING`, [IDS.ACT_5, tenantId, IDS.ACTOR_CODY, IDS.CT_PRIYA_NAIR, daysAgo2(3), JSON.stringify({ duration_minutes: 2, phone: "+1-555-0147", voicemail_left: true })]);
+      await pool.query(`INSERT INTO activities (id, tenant_id, type, subject, body, performed_by, subject_type, subject_id, occurred_at, outcome, detail) VALUES ($1, $2, 'meeting_scheduled', 'Executive alignment call \u2014 Vertex Logistics', 'Scheduled 30-minute call with Keiko Yamamoto and Tom\xE1s Rivera for next week.', $3, 'opportunity', $4, $5, 'scheduled', $6) ON CONFLICT (id) DO NOTHING`, [IDS.ACT_6, tenantId, IDS.ACTOR_OUTREACH, IDS.OPP_VERTEX, daysAgo2(2), JSON.stringify({ meeting_date: daysFromNow2(5), duration_minutes: 30 })]);
+      await pool.query(`INSERT INTO activities (id, tenant_id, type, subject, body, performed_by, subject_type, subject_id, occurred_at, outcome, detail) VALUES ($1, $2, 'stage_change', 'Vertex Logistics \u2192 Negotiation', 'Advanced deal from Qualification to Negotiation after PoC exceeded throughput targets by 22%.', $3, 'opportunity', $4, $5, 'completed', $6) ON CONFLICT (id) DO NOTHING`, [IDS.ACT_7, tenantId, IDS.ACTOR_CODY, IDS.OPP_VERTEX, daysAgo2(1), JSON.stringify({ from_stage: "Qualification", to_stage: "Negotiation" })]);
+      await pool.query(`INSERT INTO activities (id, tenant_id, type, subject, body, performed_by, subject_type, subject_id, occurred_at, outcome, detail) VALUES ($1, $2, 'outreach_email', 'Technical deep-dive request to Jordan Liu', 'Follow-up with API docs and sandbox link. Positioned around their pipeline update pain point.', $3, 'contact', $4, $5, 'opened', $6) ON CONFLICT (id) DO NOTHING`, [IDS.ACT_8, tenantId, IDS.ACTOR_OUTREACH, IDS.CT_JORDAN_LIU, daysAgo2(4), JSON.stringify({ to: "j.liu@brightsidehealth.com", subject: "CRMy sandbox access + MCP integration docs", channel: "email" })]);
+      await pool.query(`INSERT INTO activities (id, tenant_id, type, subject, body, performed_by, subject_type, subject_id, occurred_at, outcome, detail) VALUES ($1, $2, 'review', 'Internal review of Acme Corp proposal', 'Reviewed draft with Sarah Reeves. Identified three areas for revision.', $3, 'opportunity', $4, $5, 'completed', $6) ON CONFLICT (id) DO NOTHING`, [IDS.ACT_9, tenantId, IDS.ACTOR_SARAH_R, IDS.OPP_ACME, daysAgo2(6), JSON.stringify({ reviewers: ["sarah@crmy.ai", "cody@crmy.ai"], revision_items: 3 })]);
+      await pool.query(`INSERT INTO activities (id, tenant_id, type, subject, body, performed_by, subject_type, subject_id, occurred_at, outcome, detail) VALUES ($1, $2, 'research_completed', 'Competitive analysis \u2014 Vertex Logistics', 'Vertex using custom Airtable CRM with Zapier. 20 hrs/week manual updates. Attio lacks MCP.', $3, 'account', $4, $5, 'completed', $6) ON CONFLICT (id) DO NOTHING`, [IDS.ACT_10, tenantId, IDS.ACTOR_RESEARCH, IDS.ACCT_VERTEX, daysAgo2(8), JSON.stringify({ sources: ["linkedin", "company_website", "glassdoor"], findings_count: 5 })]);
+      await pool.query(`INSERT INTO context_entries (id, tenant_id, subject_type, subject_id, context_type, authored_by, title, body, confidence, source, valid_until, tags) VALUES ($1, $2, 'account', $3, 'objection', $4, 'CFO skeptical of ROI timeline', 'CFO Marcus Webb is skeptical about 6-month ROI claims \u2014 referenced a failed Salesforce implementation in 2023 that took 14 months to break even instead of the promised 6. He explicitly said "I will not sign off on anything that leads with theoretical projections." Approach with concrete case studies from similar-sized SaaS companies, not projections. The Vertex case study (40% ramp reduction in 90 days) is the strongest proof point we have.', 0.95, 'discovery_call', $5, $6) ON CONFLICT (id) DO NOTHING`, [IDS.CTX_1, tenantId, IDS.ACCT_ACME, IDS.ACTOR_CODY, daysFromNow2(60), JSON.stringify(["roi", "cfo", "salesforce-migration"])]);
+      await pool.query(`INSERT INTO context_entries (id, tenant_id, subject_type, subject_id, context_type, authored_by, title, body, confidence, source, valid_until, tags) VALUES ($1, $2, 'account', $3, 'objection', $4, 'Concern about vendor lock-in with proprietary MCP', 'Dr. Nair raised concerns about MCP being a proprietary protocol controlled by Anthropic. She asked specifically whether CRMy would work with non-Anthropic models and whether the MCP specification is truly open. This objection can likely be addressed by showing the open-source MCP spec and demonstrating multi-model support, but we have not had the opportunity to do so yet.', 0.7, 'research', $5, $6) ON CONFLICT (id) DO NOTHING`, [IDS.CTX_2, tenantId, IDS.ACCT_BRIGHTSIDE, IDS.ACTOR_RESEARCH, daysFromNow2(30), JSON.stringify(["lock-in", "open-source", "mcp"])]);
+      await pool.query(`INSERT INTO context_entries (id, tenant_id, subject_type, subject_id, context_type, authored_by, title, body, confidence, source, valid_until, tags) VALUES ($1, $2, 'account', $3, 'competitive_intel', $4, 'Brightside evaluating HubSpot and Attio', 'Brightside Health is actively evaluating HubSpot (Enterprise tier, $3,600/mo) and Attio (Growth plan, $1,200/mo) alongside CRMy. Neither has MCP support. Our differentiator is the open-source, self-hosted model with native MCP.', 0.85, 'linkedin_research', $5, $6) ON CONFLICT (id) DO NOTHING`, [IDS.CTX_3, tenantId, IDS.ACCT_BRIGHTSIDE, IDS.ACTOR_RESEARCH, daysFromNow2(45), JSON.stringify(["hubspot", "attio", "competitive"])]);
+      await pool.query(`INSERT INTO context_entries (id, tenant_id, subject_type, subject_id, context_type, authored_by, title, body, confidence, source, valid_until, tags) VALUES ($1, $2, 'account', $3, 'competitive_intel', $4, 'Vertex considering Attio as alternative', 'Vertex Logistics was evaluating Attio as a potential CRM replacement. This intelligence is from initial conversations and may be outdated \u2014 Tom\xE1s has since expressed strong preference for CRMy after the PoC results.', 0.6, 'initial_call', $5, $6) ON CONFLICT (id) DO NOTHING`, [IDS.CTX_4, tenantId, IDS.ACCT_VERTEX, IDS.ACTOR_CODY, daysAgo2(10).slice(0, 10), JSON.stringify(["attio", "competitive", "airtable"])]);
+      await pool.query(`INSERT INTO context_entries (id, tenant_id, subject_type, subject_id, context_type, authored_by, title, body, confidence, source, tags) VALUES ($1, $2, 'contact', $3, 'preference', $4, 'Sarah Chen communication preferences', 'Sarah Chen prefers async communication (Slack or email) over calls. She responds fastest to technical content \u2014 architecture diagrams, API documentation, and code examples. Avoid scheduling calls before 10am PT. She is the internal champion at Acme.', 0.9, 'observation', $5) ON CONFLICT (id) DO NOTHING`, [IDS.CTX_5, tenantId, IDS.CT_SARAH_CHEN, IDS.ACTOR_OUTREACH, JSON.stringify(["communication", "async", "technical"])]);
+      await pool.query(`INSERT INTO context_entries (id, tenant_id, subject_type, subject_id, context_type, authored_by, title, body, confidence, source, tags) VALUES ($1, $2, 'contact', $3, 'preference', $4, 'Marcus Webb decision-making style', 'Marcus Webb makes decisions based on quantitative data and peer references, not product demos. He explicitly asked for "three CFOs I can call who switched from Salesforce to CRMy." Lead every communication with a specific number or case study result.', 0.85, 'discovery_call', $5) ON CONFLICT (id) DO NOTHING`, [IDS.CTX_6, tenantId, IDS.CT_MARCUS_WEBB, IDS.ACTOR_CODY, JSON.stringify(["decision-maker", "data-driven", "brevity"])]);
+      await pool.query(`INSERT INTO context_entries (id, tenant_id, subject_type, subject_id, context_type, authored_by, title, body, confidence, source, tags) VALUES ($1, $2, 'account', $3, 'relationship_map', $4, 'Acme Corp internal dynamics', 'Sarah Chen (VP Engineering) is the champion. Marcus Webb (CFO) is the economic buyer and final decision maker. There is a third stakeholder \u2014 their VP Sales (name unknown) who would be the primary end user.', 0.8, 'discovery_call', $5) ON CONFLICT (id) DO NOTHING`, [IDS.CTX_7, tenantId, IDS.ACCT_ACME, IDS.ACTOR_CODY, JSON.stringify(["champion", "buyer", "stakeholder-map"])]);
+      await pool.query(`INSERT INTO context_entries (id, tenant_id, subject_type, subject_id, context_type, authored_by, title, body, confidence, source, tags) VALUES ($1, $2, 'account', $3, 'relationship_map', $4, 'Vertex Logistics buying committee', 'Tom\xE1s Rivera is the champion and day-to-day contact. Keiko Yamamoto (CEO) has final sign-off authority on all annual contracts over $100K. Tom\xE1s warned: "Don''t oversell to Keiko \u2014 she values directness."', 0.9, 'partner_feedback', $5) ON CONFLICT (id) DO NOTHING`, [IDS.CTX_8, tenantId, IDS.ACCT_VERTEX, IDS.ACTOR_OUTREACH, JSON.stringify(["champion", "ceo", "buying-committee"])]);
+      await pool.query(`INSERT INTO context_entries (id, tenant_id, subject_type, subject_id, context_type, authored_by, title, body, confidence, source, valid_until, tags) VALUES ($1, $2, 'account', $3, 'research', $4, 'Brightside Health org chart and tech stack', 'Brightside Health uses microservices on AWS (EKS). CTO Dr. Priya Nair reports to CEO. Engineering team of ~40, with 6 dedicated to internal tools. New CTO hire rumored for Q1 2026.', 0.65, 'web_research', $5, $6) ON CONFLICT (id) DO NOTHING`, [IDS.CTX_9, tenantId, IDS.ACCT_BRIGHTSIDE, IDS.ACTOR_RESEARCH, daysAgo2(45).slice(0, 10), JSON.stringify(["org-chart", "tech-stack", "aws"])]);
+      await pool.query(`INSERT INTO context_entries (id, tenant_id, subject_type, subject_id, context_type, authored_by, title, body, confidence, source, tags) VALUES ($1, $2, 'account', $3, 'summary', $4, 'Vertex Logistics account summary', 'Vertex Logistics is our highest-probability deal ($240K ARR, Negotiation stage). The PoC exceeded throughput targets by 22%. Remaining gate: CEO Keiko Yamamoto sign-off. Next action: executive alignment call scheduled.', 0.9, 'agent_synthesis', $5) ON CONFLICT (id) DO NOTHING`, [IDS.CTX_10, tenantId, IDS.ACCT_VERTEX, IDS.ACTOR_RESEARCH, JSON.stringify(["deal-summary", "high-priority"])]);
+      await pool.query(`INSERT INTO context_entries (id, tenant_id, subject_type, subject_id, context_type, authored_by, title, body, confidence, source, tags) VALUES ($1, $2, 'opportunity', $3, 'agent_reasoning', $4, 'Outreach strategy decision for Acme proposal revision', 'Decision: Lead revised Acme proposal with Vertex case study (40% ramp reduction in 90 days) rather than original ROI projections. Marcus Webb explicitly rejected theoretical projections. Sarah Chen confirmed concrete examples carry more weight.', 0.85, 'agent_analysis', $5) ON CONFLICT (id) DO NOTHING`, [IDS.CTX_11, tenantId, IDS.OPP_ACME, IDS.ACTOR_OUTREACH, JSON.stringify(["strategy", "proposal", "reasoning"])]);
+      await pool.query(`INSERT INTO context_entries (id, tenant_id, subject_type, subject_id, context_type, authored_by, title, body, confidence, source, source_activity_id, tags) VALUES ($1, $2, 'opportunity', $3, 'meeting_notes', $4, 'Acme Corp discovery call notes \u2014 2026-03-16', E'Attendees: Cody Harris, Sarah Chen, Marcus Webb. Duration: 45 min.
+
+Key points: (1) Acme spending 15 hrs/week on manual CRM data entry. (2) Failed Salesforce impl in 2023. (3) Sarah wants API-first CRM for AI agents. (4) Marcus wants reference customers, not projections. (5) Sarah offered 2-week pilot.', 1.0, 'meeting_transcript', $5, $6) ON CONFLICT (id) DO NOTHING`, [IDS.CTX_12, tenantId, IDS.OPP_ACME, IDS.ACTOR_CODY, IDS.ACT_2, JSON.stringify(["discovery", "meeting", "acme"])]);
+      await pool.query(`INSERT INTO assignments (id, tenant_id, title, description, assignment_type, assigned_by, assigned_to, subject_type, subject_id, status, priority, context) VALUES ($1, $2, 'Send revised proposal to Acme Corp \u2014 address Marcus Webb''s ROI concern', 'Review and send the revised proposal that leads with the Vertex case study.', 'send', $3, $4, 'opportunity', $5, 'pending', 'high', 'Marcus pushed back on the 6-month ROI claim in the last call. I''ve drafted a revised proposal in section 3 that leads with the Vertex case study (40% ramp reduction in 90 days). Sarah Chen is the champion \u2014 copy her on send. Do not cc Marcus directly.') ON CONFLICT (id) DO NOTHING`, [IDS.ASSIGN_1, tenantId, IDS.ACTOR_OUTREACH, IDS.ACTOR_CODY, IDS.OPP_ACME]);
+      await pool.query(`INSERT INTO assignments (id, tenant_id, title, description, assignment_type, assigned_by, assigned_to, subject_type, subject_id, status, priority, context) VALUES ($1, $2, 'Review stale research on Brightside Health before next call', 'The research entry from January is past its valid_until date and needs verification.', 'review', $3, $4, 'account', $5, 'pending', 'normal', 'The research entry from January is past its valid_until date. Dr. Nair mentioned a new CTO hire at their last board meeting \u2014 the org chart context entry may be wrong.') ON CONFLICT (id) DO NOTHING`, [IDS.ASSIGN_2, tenantId, IDS.ACTOR_RESEARCH, IDS.ACTOR_SARAH_R, IDS.ACCT_BRIGHTSIDE]);
+      await pool.query(`INSERT INTO assignments (id, tenant_id, title, description, assignment_type, assigned_by, assigned_to, subject_type, subject_id, status, priority, context) VALUES ($1, $2, 'Schedule executive alignment call with Keiko Yamamoto at Vertex', 'Coordinate schedules for a 15-minute executive alignment call.', 'call', $3, $4, 'opportunity', $5, 'accepted', 'urgent', 'Tomas has given us the green light but Keiko needs to sign off. Use the Calendly link in my preferences. Propose Tues/Thurs mornings PT.') ON CONFLICT (id) DO NOTHING`, [IDS.ASSIGN_3, tenantId, IDS.ACTOR_CODY, IDS.ACTOR_OUTREACH, IDS.OPP_VERTEX]);
+      spinner.succeed("Demo data seeded successfully");
+      await pool.end();
+    } catch (err) {
+      spinner.fail("Failed to seed demo data");
+      console.error(`
+  Error: ${err.message}
+`);
+      process.exit(1);
+    }
+    console.log("  4 actors (2 humans, 2 agents)");
+    console.log("  3 accounts \xB7 6 contacts \xB7 3 opportunities");
+    console.log("  10 activities \xB7 12 context entries \xB7 3 assignments");
+    console.log("");
+    console.log("Try it:");
+    console.log("  crmy briefing contact:d0000000-0000-4000-c000-000000000001");
+    console.log("  crmy briefing account:d0000000-0000-4000-b000-000000000001");
+    console.log("  crmy briefing opportunity:d0000000-0000-4000-d000-000000000001");
+    console.log("");
+  });
+}
+
+// src/commands/doctor.ts
+import { Command as Command28 } from "commander";
+import fs4 from "fs";
+import path5 from "path";
+import net from "net";
+var KNOWN_BAD_SECRETS = ["change-me-in-production", "dev-secret", "secret", ""];
+function pass(msg) {
+  console.log(`  \x1B[32m\u2713\x1B[0m  ${msg}`);
+}
+function fail(msg, fix) {
+  console.log(`  \x1B[31m\u2717\x1B[0m  ${msg}`);
+  if (fix) console.log(`     \x1B[2m\u2192 ${fix}\x1B[0m`);
+}
+function info(msg) {
+  console.log(`  \x1B[36m\u2139\x1B[0m  ${msg}`);
+}
+async function checkPort(port) {
+  return new Promise((resolve) => {
+    const server = net.createServer();
+    server.once("error", () => resolve(false));
+    server.once("listening", () => {
+      server.close(() => resolve(true));
+    });
+    server.listen(port);
+  });
+}
+function doctorCommand() {
+  return new Command28("doctor").description("Check your CRMy setup for common issues").option("--port <port>", "Port to check availability for", "3000").action(async (opts) => {
+    console.log("\n  CRMy Doctor\n  \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n");
+    let passed = 0;
+    let failed = 0;
+    const [major] = process.versions.node.split(".").map(Number);
+    if (major >= 20) {
+      pass(`Node.js ${process.version}`);
+      passed++;
+    } else {
+      fail(`Node.js ${process.version} \u2014 CRMy requires >= 20.0.0`, "Install from https://nodejs.org");
+      failed++;
+    }
+    const localPath = path5.join(process.cwd(), ".crmy.json");
+    const hasLocal = fs4.existsSync(localPath);
+    const hasGlobal = fs4.existsSync(GLOBAL_CONFIG);
+    let config = {};
+    if (hasLocal || hasGlobal) {
+      try {
+        config = loadConfigFile();
+        const source = hasLocal ? ".crmy.json (local)" : "~/.crmy/config.json (global)";
+        pass(`Config found: ${source}`);
+        passed++;
+      } catch {
+        fail("Config file exists but is not valid JSON", "Run: crmy init");
+        failed++;
+      }
+    } else {
+      fail("No config file found", "Run: crmy init");
+      failed++;
+    }
+    const dbUrl = config.database?.url ?? process.env.DATABASE_URL;
+    if (dbUrl) {
+      try {
+        process.env.CRMY_IMPORTED = "1";
+        const { initPool, closePool } = await import("@crmy/server");
+        const db = await initPool(dbUrl, 2);
+        await db.query("SELECT 1");
+        pass("PostgreSQL reachable");
+        passed++;
+        try {
+          const { getMigrationStatus } = await import("@crmy/server/db/migrate");
+          const status = await getMigrationStatus(db);
+          if (status.pending.length === 0) {
+            pass(`Migrations up to date (${status.applied.length} applied)`);
+            passed++;
+          } else {
+            const realPending = status.pending.filter(
+              (f) => f !== "022_pgvector.sql" || process.env.ENABLE_PGVECTOR === "true"
+            );
+            if (realPending.length === 0) {
+              pass(`Migrations up to date (${status.applied.length} applied, pgvector optional)`);
+              passed++;
+            } else {
+              fail(`${realPending.length} pending migration(s)`, "Run: crmy migrate");
+              failed++;
+            }
+          }
+        } catch {
+          try {
+            const applied = await db.query("SELECT name FROM _migrations ORDER BY name");
+            pass(`Migrations table exists (${applied.rows.length} applied)`);
+            passed++;
+          } catch {
+            fail("Migrations table not found", "Run: crmy init");
+            failed++;
+          }
+        }
+        try {
+          const users = await db.query("SELECT id FROM users LIMIT 1");
+          if (users.rows.length > 0) {
+            pass("Admin user exists");
+            passed++;
+          } else {
+            fail("No users found", "Run: crmy init  (or POST /auth/register)");
+            failed++;
+          }
+        } catch {
+          fail("Could not check users table", "Run: crmy init");
+          failed++;
+        }
+        try {
+          const pgv = await db.query("SELECT 1 FROM pg_extension WHERE extname = 'vector'");
+          if (pgv.rows.length > 0) {
+            pass("pgvector extension installed (semantic search available)");
+            passed++;
+          } else {
+            info("pgvector not installed (semantic search disabled \u2014 this is optional)");
+          }
+        } catch {
+          info("Could not check pgvector status");
+        }
+        await closePool();
+      } catch (err) {
+        fail(`PostgreSQL unreachable: ${err.message}`, "Check that PostgreSQL is running and DATABASE_URL is correct");
+        failed++;
+      }
+    } else {
+      fail("No DATABASE_URL configured", "Run: crmy init");
+      failed++;
+    }
+    const port = parseInt(opts.port, 10);
+    const portAvailable = await checkPort(port);
+    if (portAvailable) {
+      pass(`Port ${port} is available`);
+      passed++;
+    } else {
+      fail(`Port ${port} is in use`, `Try: crmy server --port ${port + 1}`);
+      failed++;
+    }
+    const jwt = config.jwtSecret ?? process.env.JWT_SECRET;
+    if (jwt && !KNOWN_BAD_SECRETS.includes(jwt)) {
+      pass("JWT_SECRET is set and not a known default");
+      passed++;
+    } else if (jwt && KNOWN_BAD_SECRETS.includes(jwt)) {
+      fail("JWT_SECRET is a known default value", "Generate a new one: openssl rand -hex 32");
+      failed++;
+    } else {
+      fail("JWT_SECRET not configured", "Run: crmy init");
+      failed++;
+    }
+    console.log("\n  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500");
+    if (failed === 0) {
+      console.log(`  \x1B[32m${passed} checks passed\x1B[0m \u2014 everything looks good!
+`);
+    } else {
+      console.log(`  ${passed} passed, \x1B[31m${failed} issue(s) found\x1B[0m
+`);
+    }
+  });
+}
+
 // src/index.ts
+var [_nodeMajor] = process.versions.node.split(".").map(Number);
+if (_nodeMajor < 20) {
+  console.error(
+    `
+  CRMy requires Node.js >= 20.0.0 (you have ${process.version})
+  Install the latest LTS: https://nodejs.org
+`
+  );
+  process.exit(1);
+}
 var _require2 = createRequire2(import.meta.url);
 function getCLIVersion2() {
   try {
     const pkg = _require2(
-      path5.resolve(path5.dirname(fileURLToPath2(import.meta.url)), "../package.json")
+      path6.resolve(path6.dirname(fileURLToPath2(import.meta.url)), "../package.json")
     );
     return pkg.version;
   } catch {
-    return "0.5.5";
+    return "unknown";
   }
 }
-var program = new Command27();
+var program = new Command29();
 program.name("crmy").description("CRMy \u2014 The agent-first open source CRM").version(getCLIVersion2());
 program.addCommand(authCommand());
 program.addCommand(initCommand());
@@ -2447,6 +3015,8 @@ program.addCommand(contextCommand());
 program.addCommand(activityTypesCommand());
 program.addCommand(contextTypesCommand());
 program.addCommand(briefingCommand());
+program.addCommand(seedDemoCommand());
+program.addCommand(doctorCommand());
 program.addCommand(helpCommand());
 program.command("login").description("Sign in to a CRMy server (shortcut for `crmy auth login`)").option("-e, --email <email>", "Email address").option("-p, --password <password>", "Password").action(async (opts) => {
   const args = ["auth", "login"];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crmy/cli",
-  "version": "0.5.9",
+  "version": "0.6.1",
   "description": "CRMy CLI — Local CLI + stdio MCP server",
   "type": "module",
   "files": [