salesprompter-cli 0.1.13 → 0.1.15

package/dist/cli.js

@@ -1,6 +1,7 @@
 #!/usr/bin/env node
 import { spawn } from "node:child_process";
 import { createRequire } from "node:module";
+import { emitKeypressEvents } from "node:readline";
 import { createInterface } from "node:readline/promises";
 import { Command } from "commander";
 import { z } from "zod";
@@ -175,30 +176,151 @@ function deriveCompanyNameFromDomain(domain) {
 function writeWizardLine(message = "") {
     process.stdout.write(`${message}\n`);
 }
+function isOpaqueOrgId(value) {
+    return /^org_[A-Za-z0-9]+$/.test(value);
+}
 function getOrgLabel(session) {
-    return session.user.orgName ?? session.user.orgSlug ?? session.user.orgId ?? null;
+    const label = session.user.orgName ?? session.user.orgSlug ?? session.user.orgId ?? null;
+    if (label && isOpaqueOrgId(label)) {
+        return null;
+    }
+    return label;
 }
 function writeSessionSummary(session) {
+    const identity = session.user.name?.trim()
+        ? `${session.user.name} (${session.user.email})`
+        : session.user.email;
+    writeWizardLine(`Signed in as ${identity}.`);
     const orgLabel = getOrgLabel(session);
     if (orgLabel) {
-        writeWizardLine(`Signed in as ${session.user.email} for ${orgLabel}.`);
-        return;
+        writeWizardLine(`Workspace: ${orgLabel}`);
     }
-    writeWizardLine(`Signed in as ${session.user.email}.`);
-    writeWizardLine("No organization is attached to this CLI session.");
+}
+function normalizeChoiceText(value) {
+    return value.trim().toLowerCase().replace(/[^a-z0-9]+/g, " ").replace(/\s+/g, " ").trim();
+}
+function supportsInteractiveChoice() {
+    return Boolean(process.stdin.isTTY && process.stdout.isTTY && typeof process.stdin.setRawMode === "function");
+}
+function renderInteractiveChoiceLines(prompt, options, activeIndex) {
+    const lines = [prompt];
+    for (const [index, option] of options.entries()) {
+        const description = option.description ? ` - ${option.description}` : "";
+        const text = `${index + 1}. ${option.label}${description}`;
+        if (index === activeIndex) {
+            lines.push(`\x1b[7m> ${text}\x1b[0m`);
+        }
+        else {
+            lines.push(`  ${text}`);
+        }
+    }
+    lines.push("\x1b[2mUse Up/Down or number keys. Press Enter to continue.\x1b[0m");
+    return lines;
+}
+function redrawInteractiveChoice(lines, previousLineCount) {
+    if (previousLineCount > 0) {
+        for (let index = 0; index < previousLineCount; index += 1) {
+            process.stdout.write("\x1b[1A\x1b[2K\r");
+        }
+    }
+    for (const line of lines) {
+        process.stdout.write(`${line}\n`);
+    }
+}
+async function promptChoiceInteractive(prompt, options, defaultIndex) {
+    const stdin = process.stdin;
+    let activeIndex = defaultIndex;
+    let renderedLineCount = 0;
+    const render = () => {
+        const lines = renderInteractiveChoiceLines(prompt, options, activeIndex);
+        redrawInteractiveChoice(lines, renderedLineCount);
+        renderedLineCount = lines.length;
+    };
+    const cleanup = () => {
+        stdin.removeListener("keypress", onKeypress);
+        process.removeListener("SIGINT", onSigint);
+        if (stdin.isTTY) {
+            stdin.setRawMode(false);
+        }
+        stdin.pause();
+    };
+    const finalize = (index, resolve) => {
+        const selected = options[index];
+        if (!selected) {
+            throw new Error("wizard selection invariant violated");
+        }
+        const summary = `${prompt} ${selected.label}`;
+        redrawInteractiveChoice([summary], renderedLineCount);
+        renderedLineCount = 1;
+        process.stdout.write("\n");
+        cleanup();
+        resolve(selected.value);
+    };
+    const cancel = (reject) => {
+        cleanup();
+        process.stdout.write("\n");
+        reject(new Error("prompt cancelled"));
+    };
+    const onSigint = () => {
+        cancel(rejectPromise);
+    };
+    const onKeypress = (_character, key) => {
+        if (key.ctrl && key.name === "c") {
+            return cancel(rejectPromise);
+        }
+        if (key.name === "up") {
+            activeIndex = activeIndex === 0 ? options.length - 1 : activeIndex - 1;
+            render();
+            return;
+        }
+        if (key.name === "down") {
+            activeIndex = activeIndex === options.length - 1 ? 0 : activeIndex + 1;
+            render();
+            return;
+        }
+        if (key.name === "return" || key.name === "enter") {
+            finalize(activeIndex, resolvePromise);
+            return;
+        }
+        const digit = Number(key.sequence ?? "");
+        if (Number.isInteger(digit) && digit >= 1 && digit <= options.length) {
+            finalize(digit - 1, resolvePromise);
+        }
+    };
+    let resolvePromise;
+    let rejectPromise;
+    return await new Promise((resolve, reject) => {
+        resolvePromise = resolve;
+        rejectPromise = reject;
+        emitKeypressEvents(stdin);
+        stdin.setRawMode(true);
+        stdin.resume();
+        stdin.on("keypress", onKeypress);
+        process.on("SIGINT", onSigint);
+        render();
+    });
 }
 async function promptChoice(rl, prompt, options, defaultValue) {
     const defaultIndex = options.findIndex((option) => option.value === defaultValue);
     if (defaultIndex === -1) {
         throw new Error(`wizard default option is invalid for ${prompt}`);
     }
+    if (supportsInteractiveChoice()) {
+        rl.pause?.();
+        try {
+            return await promptChoiceInteractive(prompt, options, defaultIndex);
+        }
+        finally {
+            rl.resume?.();
+        }
+    }
     while (true) {
         writeWizardLine(prompt);
         for (const [index, option] of options.entries()) {
             const description = option.description ? ` - ${option.description}` : "";
             writeWizardLine(`  ${index + 1}. ${option.label}${description}`);
         }
-        const answer = (await rl.question(`Choose [1-${options.length}] (default ${defaultIndex + 1}): `)).trim();
+        const answer = (await rl.question(`Select an option (press Enter for ${defaultIndex + 1}): `)).trim();
         if (answer.length === 0) {
             return defaultValue;
         }
@@ -210,11 +332,25 @@ async function promptChoice(rl, prompt, options, defaultValue) {
             }
             return selected.value;
         }
-        const matched = options.find((option) => option.value.toLowerCase() === answer.toLowerCase());
+        const normalizedAnswer = normalizeChoiceText(answer);
+        const matched = options.find((option) => {
+            if (normalizeChoiceText(option.value) === normalizedAnswer) {
+                return true;
+            }
+            if (normalizeChoiceText(option.label) === normalizedAnswer) {
+                return true;
+            }
+            return (option.aliases ?? []).some((alias) => normalizeChoiceText(alias) === normalizedAnswer);
+        });
         if (matched) {
             return matched.value;
         }
-        writeWizardLine("Please choose one of the numbered options.");
+        if (/^(npx|salesprompter)\b/i.test(answer)) {
+            writeWizardLine("You are already in the wizard. Pick an option here, or press Ctrl-C to exit.");
+        }
+        else {
+            writeWizardLine("Please choose one of the options above.");
+        }
         writeWizardLine();
     }
 }
@@ -265,7 +401,7 @@ async function ensureWizardSession(options) {
             throw error;
         }
     }
-    writeWizardLine("No active Salesprompter session found. Starting login...");
+    writeWizardLine("First, sign in to Salesprompter.");
     writeWizardLine();
     const result = await performLogin({
         apiUrl: options?.apiUrl,
@@ -276,6 +412,90 @@ async function ensureWizardSession(options) {
     return result.session;
 }
 async function runVendorIcpWizard(rl) {
+    const startPoint = await promptChoice(rl, "How do you want to start?", [
+        {
+            value: "custom",
+            label: "Create a custom profile",
+            description: "Answer a few questions about who you want to sell to",
+            aliases: ["custom", "from scratch", "new profile"]
+        },
+        {
+            value: "template",
+            label: "Use the Deel template",
+            description: "Quick start from the current built-in template",
+            aliases: ["template", "deel", "use template"]
+        }
+    ], "custom");
+    writeWizardLine();
+    if (startPoint === "custom") {
+        const productName = await promptText(rl, "What are you selling?", { required: true });
+        const description = await promptText(rl, "Who is this for? (optional)");
+        const industries = await promptText(rl, "Target industries (optional, comma-separated)");
+        const companySizes = await promptText(rl, "Target company sizes (optional, comma-separated)");
+        const regions = await promptText(rl, "Target regions (optional, comma-separated)");
+        const countries = await promptText(rl, "Target countries (optional, comma-separated)");
+        const titles = await promptText(rl, "Target job titles (optional, comma-separated)");
+        const keywords = await promptText(rl, "Keywords or buying signals (optional, comma-separated)");
+        writeWizardLine();
+        const slug = slugify(productName) || "icp";
+        const outPath = await promptText(rl, "Where should I save the ICP JSON?", {
+            defaultValue: `./data/${slug}-icp.json`,
+            required: true
+        });
+        writeWizardLine();
+        const icp = IcpSchema.parse({
+            name: `${productName} ICP`,
+            description,
+            industries: splitCsv(industries),
+            companySizes: splitCsv(companySizes),
+            regions: splitCsv(regions),
+            countries: splitCsv(countries),
+            titles: splitCsv(titles),
+            keywords: splitCsv(keywords)
+        });
+        await writeJsonFile(outPath, icp);
+        writeWizardLine(`Created ${icp.name}.`);
+        writeWizardLine(`Saved ICP to ${outPath}.`);
+        writeWizardLine();
+        writeWizardLine("Equivalent raw command:");
+        const defineArgs = ["salesprompter", "icp:define", "--name", icp.name];
+        if (description.trim().length > 0) {
+            defineArgs.push("--description", description);
+        }
+        if (industries.trim().length > 0) {
+            defineArgs.push("--industries", industries);
+        }
+        if (companySizes.trim().length > 0) {
+            defineArgs.push("--company-sizes", companySizes);
+        }
+        if (regions.trim().length > 0) {
+            defineArgs.push("--regions", regions);
+        }
+        if (countries.trim().length > 0) {
+            defineArgs.push("--countries", countries);
+        }
+        if (titles.trim().length > 0) {
+            defineArgs.push("--titles", titles);
+        }
+        if (keywords.trim().length > 0) {
+            defineArgs.push("--keywords", keywords);
+        }
+        defineArgs.push("--out", outPath);
+        writeWizardLine(`  ${buildCommandLine(defineArgs)}`);
+        writeWizardLine();
+        writeWizardLine("Next suggested command:");
+        writeWizardLine(`  ${buildCommandLine([
+            "salesprompter",
+            "leads:generate",
+            "--icp",
+            outPath,
+            "--count",
+            "5",
+            "--out",
+            `./data/${slug}-leads.json`
+        ])}`);
+        return;
+    }
     const vendor = "deel";
     writeWizardLine("Using the built-in Deel ICP template.");
     writeWizardLine();
@@ -374,13 +594,15 @@ async function runLeadGenerationWizard(rl) {
     const source = await promptChoice(rl, "How do you want to generate leads?", [
         {
             value: "target-account",
-            label: "At a specific company",
-            description: "Example: find people at deel.com"
+            label: "At one company",
+            description: "Example: find people at acme.com",
+            aliases: ["company", "one company", "specific company", "account"]
         },
         {
             value: "vendor-lookup",
-            label: "From BigQuery",
-            description: "Use an ICP to search lead data you already have in BigQuery"
+            label: "From my BigQuery data",
+            description: "Use a saved profile to search the lead data you already have",
+            aliases: ["bigquery", "warehouse", "my data", "from bigquery"]
         }
     ], "target-account");
     writeWizardLine();
@@ -391,41 +613,32 @@ async function runLeadGenerationWizard(rl) {
     await runVendorLookupWizard(rl);
 }
 async function runVendorLookupWizard(rl) {
-    const vendor = "deel";
-    writeWizardLine("Using the built-in Deel ICP template.");
-    writeWizardLine();
-    const market = await promptChoice(rl, "Which market should the BigQuery lookup target?", [
-        { value: "dach", label: "DACH", description: "Germany, Austria, Switzerland" },
-        { value: "europe", label: "Europe" },
-        { value: "global", label: "Global" }
-    ], "dach");
-    const limit = z.coerce.number().int().min(1).max(5000).parse(await promptText(rl, "How many rows should the lookup return?", { defaultValue: "100", required: true }));
-    const execute = await promptYesNo(rl, "Execute the BigQuery lookup now?", false);
-    writeWizardLine();
-    const slug = slugify(vendor);
-    const icpPath = await promptText(rl, "Where should I save the ICP JSON?", {
-        defaultValue: `./data/${slug}-icp-${market}.json`,
+    const icpPath = await promptText(rl, "Where is your ICP JSON file?", {
+        defaultValue: "./data/icp.json",
         required: true
     });
+    const limit = z.coerce.number().int().min(1).max(5000).parse(await promptText(rl, "How many leads should I look up?", { defaultValue: "100", required: true }));
+    const execute = await promptYesNo(rl, "Execute the BigQuery lookup now?", false);
+    writeWizardLine();
+    const icp = await readJsonFile(icpPath, IcpSchema);
+    const slug = slugify(icp.name) || "icp";
     const sqlPath = await promptText(rl, "Where should I save the generated SQL?", {
-        defaultValue: `./data/${slug}-lookup-${market}.sql`,
+        defaultValue: `./data/${slug}-lookup.sql`,
         required: true
     });
     const rawPath = execute
         ? await promptText(rl, "Where should I save raw BigQuery rows?", {
-            defaultValue: `./data/${slug}-leads-raw-${market}.json`,
+            defaultValue: `./data/${slug}-leads-raw.json`,
             required: true
         })
         : "";
     const leadPath = execute
         ? await promptText(rl, "Where should I save normalized leads?", {
-            defaultValue: `./data/${slug}-leads-${market}.json`,
+            defaultValue: `./data/${slug}-leads.json`,
             required: true
         })
         : "";
     writeWizardLine();
-    const icp = buildVendorIcp(vendor, market);
-    await writeJsonFile(icpPath, icp);
     const sql = buildBigQueryLeadLookupSql(icp, {
         table: "icpidentifier.SalesGPT.leadPool_new",
         companyField: "companyName",
@@ -453,15 +666,14 @@ async function runVendorLookupWizard(rl) {
         await writeJsonFile(leadPath, normalizedLeads);
         executedRowCount = parsedRows.length;
     }
-    writeWizardLine(`Saved vendor ICP to ${icpPath}.`);
+    writeWizardLine(`Using ICP from ${icpPath}.`);
     writeWizardLine(`Saved lookup SQL to ${sqlPath}.`);
     if (execute) {
         writeWizardLine(`Saved ${executedRowCount ?? 0} raw rows to ${rawPath}.`);
         writeWizardLine(`Saved normalized leads to ${leadPath}.`);
     }
     writeWizardLine();
-    writeWizardLine("Equivalent raw commands:");
-    writeWizardLine(`  ${buildCommandLine(["salesprompter", "icp:vendor", "--vendor", vendor, "--market", market, "--out", icpPath])}`);
+    writeWizardLine("Equivalent raw command:");
     const lookupArgs = ["salesprompter", "leads:lookup:bq", "--icp", icpPath, "--limit", String(limit), "--sql-out", sqlPath];
     if (execute) {
         lookupArgs.push("--execute", "--out", rawPath, "--lead-out", leadPath);
@@ -469,13 +681,8 @@ async function runVendorLookupWizard(rl) {
     writeWizardLine(`  ${buildCommandLine(lookupArgs)}`);
 }
 async function runOutreachSyncWizard(rl) {
-    const target = await promptChoice(rl, "Which outreach tool do you want to use?", [
-        {
-            value: "instantly",
-            label: "Instantly",
-            description: "Create campaign leads from a scored leads JSON file"
-        }
-    ], "instantly");
+    const target = "instantly";
+    writeWizardLine("Using Instantly.");
     writeWizardLine();
     if (!process.env.INSTANTLY_API_KEY || process.env.INSTANTLY_API_KEY.trim().length === 0) {
         throw new Error("INSTANTLY_API_KEY is required for the Instantly sync flow.");
@@ -530,8 +737,8 @@ async function runWizard(options) {
     if (runtimeOutputOptions.json || runtimeOutputOptions.quiet) {
         throw new Error("wizard does not support --json or --quiet.");
     }
-    writeWizardLine("Salesprompter Wizard");
-    writeWizardLine("Choose the outcome you want. I will ask a few questions and run the matching CLI workflow.");
+    writeWizardLine("Salesprompter");
+    writeWizardLine("Tell me what you want to do, and I will guide you through it.");
     writeWizardLine();
     await ensureWizardSession(options);
     const rl = createInterface({
@@ -542,18 +749,21 @@ async function runWizard(options) {
         const flow = await promptChoice(rl, "What do you want help with?", [
             {
                 value: "vendor-icp",
-                label: "Define my ICP",
-                description: "Build the kind of company profile your product sells to"
+                label: "Figure out who to target",
+                description: "Create an ideal customer profile for your product",
+                aliases: ["icp", "ideal customer", "who to target", "targeting", "profile"]
             },
             {
                 value: "lead-generation",
                 label: "Generate leads",
-                description: "Find people at a target company or from your BigQuery data"
+                description: "Find people at one company or from your BigQuery data",
+                aliases: ["leads", "find leads", "lead generation", "find people"]
             },
             {
                 value: "outreach-sync",
-                label: "Send leads to outreach",
-                description: "Push scored leads into Instantly"
+                label: "Add leads to Instantly",
+                description: "Send a scored leads file to an Instantly campaign",
+                aliases: ["instantly", "outreach", "send leads", "campaign"]
             }
         ], "vendor-icp");
         writeWizardLine();
@@ -1452,6 +1662,11 @@ async function main() {
     await program.parseAsync(process.argv);
 }
 main().catch((error) => {
+    if (error instanceof Error &&
+        (error.message === "prompt cancelled" || error.message === "readline was closed")) {
+        process.exitCode = 130;
+        return;
+    }
     const cliError = buildCliError(error);
     const space = runtimeOutputOptions.json ? undefined : 2;
     if (runtimeOutputOptions.json) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "salesprompter-cli",
-  "version": "0.1.13",
+  "version": "0.1.15",
   "description": "JSON-first sales prospecting CLI for ICP definition, lead generation, enrichment, scoring, and CRM/outreach sync.",
   "type": "module",
   "bin": {