salesprompter-cli 0.1.26 → 0.1.27

package/README.md

@@ -5,7 +5,7 @@ Salesprompter CLI helps you go from company or product input to qualified leads
 ## Install
 
 ```bash
-npm i -g salesprompter-cli
+curl -fsSL https://docs.salesprompter.ai/install.sh | bash
 ```
 
 or run directly:
@@ -17,6 +17,12 @@ npx -y salesprompter-cli@latest
 ## Quickstart
 
 ```bash
+# Run first-time setup
+salesprompter setup
+
+# Run a local health check
+salesprompter doctor
+
 # Sign in from the CLI
 salesprompter auth:login
 
@@ -32,7 +38,7 @@ For headless or automation use, generate a CLI token in the app and run `salespr
 
 ```bash
 # Start the guided workflow
-salesprompter
+salesprompter wizard
 
 # Show machine-readable output
 salesprompter --json auth:whoami
@@ -44,6 +50,9 @@ salesprompter contacts:find-linkedin-urls --in ./contacts.tsv --out ./contacts.e
 # When authenticated, Salesprompter first enriches company domains in the app, then the CLI builds the email batch.
 salesprompter contacts:resolve-emails --in ./contacts.tsv --out-dir ./email-run --dry-run
 
+# See included capability packs
+salesprompter packs:list
+
 # Explore the full command surface
 salesprompter --help
 ```

package/dist/cli.js

@@ -248,6 +248,36 @@ const SalesNavigatorCrawlReportResponseSchema = z.object({
     status: z.literal("ok"),
     job: SalesNavigatorCrawlJobSummarySchema
 });
+const cliPacks = [
+    {
+        slug: "contacts",
+        title: "Contacts",
+        summary: "Resolve profile URLs and work from pasted contact lists.",
+        commands: ["contacts:resolve-profiles", "contacts:resolve-emails"],
+        installStatus: "included"
+    },
+    {
+        slug: "research",
+        title: "Research",
+        summary: "Scrape markets and enrich companies before outreach.",
+        commands: ["market:scrape", "companies:enrich"],
+        installStatus: "included"
+    },
+    {
+        slug: "discovery",
+        title: "Discovery",
+        summary: "Find leads from product and market inputs.",
+        commands: ["leads:discover", "search:run", "search:status", "search:export", "search:count"],
+        installStatus: "included"
+    },
+    {
+        slug: "outreach",
+        title: "Outreach",
+        summary: "Prepare and sync qualified leads into downstream systems.",
+        commands: ["sync:outreach", "sync:crm"],
+        installStatus: "included"
+    }
+];
 const helpAliasByCommandName = new Map([
     ["contacts:find-linkedin-urls", "contacts:resolve-profiles"],
     ["contacts:process-emails", "contacts:resolve-emails"],
@@ -260,6 +290,11 @@ const helpAliasByCommandName = new Map([
     ["salesnav:count", "search:count"]
 ]);
 const helpVisibleCommandNames = new Set([
+    "setup",
+    "doctor",
+    "packs:list",
+    "packs:add",
+    "upgrade",
     "auth:login",
     "wizard",
     "auth:whoami",
@@ -4512,6 +4547,9 @@ program.configureHelp({
 });
 program.addHelpText("after", `
 LLM operator tips:
+  - Install with: curl -fsSL https://docs.salesprompter.ai/install.sh | bash
+  - First-run setup: salesprompter setup
+  - Run a quick health check: salesprompter doctor
   - New here? Create your account at https://salesprompter.ai/sign-up, then run: salesprompter auth:login
   - Prefer non-interactive auth: set SALESPROMPTER_TOKEN (+ optional SALESPROMPTER_API_BASE_URL).
   - Use machine output for tools: add --json.
@@ -4519,6 +4557,117 @@ LLM operator tips:
   - Preview contact enrichment first: contacts:resolve-profiles --in <contacts.tsv> --dry-run.
   - For bigger runs, start with a small sample before processing the full file.
 `);
+program
+    .command("setup")
+    .description("Run the fastest first-run setup path for the Salesprompter CLI.")
+    .option("--api-url <url>", "Salesprompter API base URL, defaults to SALESPROMPTER_API_BASE_URL or salesprompter.ai")
+    .option("--timeout-seconds <number>", "Auth login timeout in seconds when setup needs to sign in", "180")
+    .action(async (options) => {
+    const timeoutSeconds = z.coerce.number().int().min(30).max(1800).parse(options.timeoutSeconds);
+    printOutput({
+        status: "ok",
+        command: "setup",
+        next: [
+            "salesprompter auth:login",
+            "salesprompter auth:whoami --verify",
+            "salesprompter wizard"
+        ],
+        docs: "https://docs.salesprompter.ai/quickstart"
+    });
+    if (process.stdin.isTTY && process.stdout.isTTY && !runtimeOutputOptions.json && !runtimeOutputOptions.quiet) {
+        await runWizard({
+            apiUrl: options.apiUrl,
+            timeoutSeconds
+        });
+    }
+});
+program
+    .command("doctor")
+    .description("Check local CLI prerequisites, auth state, and optional enrichment setup.")
+    .action(async () => {
+    const nodeMajor = Number(process.versions.node.split(".")[0] ?? "0");
+    const readiness = await resolveLlmAuthReadiness();
+    const hasOpenAiKey = Boolean(process.env.OPENAI_API_KEY || process.env.SALESPROMPTER_OPENAI_API_KEY);
+    const hasLinkedInSession = Boolean(process.env.LINKEDIN_CSRF_TOKEN ||
+        process.env.SALESPROMPTER_LINKEDIN_CSRF_TOKEN ||
+        process.env.LINKEDIN_X_LI_IDENTITY ||
+        process.env.SALESPROMPTER_LINKEDIN_X_LI_IDENTITY ||
+        process.env.LINKEDIN_SALES_NAV_COOKIE ||
+        process.env.SALESPROMPTER_LINKEDIN_SALES_NAV_COOKIE);
+    printOutput({
+        status: "ok",
+        command: "doctor",
+        checks: {
+            node: {
+                ok: nodeMajor >= 20,
+                current: process.versions.node,
+                required: ">=20.0.0"
+            },
+            auth: {
+                ok: readiness.ready,
+                mode: readiness.mode,
+                apiBaseUrl: readiness.apiBaseUrl,
+                reason: readiness.reason ?? null
+            },
+            companyCleaningAi: {
+                ok: hasOpenAiKey,
+                envVarPresent: hasOpenAiKey
+            },
+            linkedInSession: {
+                ok: hasLinkedInSession,
+                envVarPresent: hasLinkedInSession
+            }
+        },
+        recommended: [
+            readiness.ready ? null : "salesprompter auth:login",
+            hasOpenAiKey ? null : "Set OPENAI_API_KEY to enable --company-cleaning ai",
+            hasLinkedInSession ? null : "Set LINKEDIN_CSRF_TOKEN, LINKEDIN_X_LI_IDENTITY, and LINKEDIN_SALES_NAV_COOKIE for direct LinkedIn lookup"
+        ].filter(Boolean)
+    });
+});
+program
+    .command("packs:list")
+    .description("Show the product capability packs included in the CLI.")
+    .action(() => {
+    printOutput({
+        status: "ok",
+        packs: cliPacks
+    });
+});
+program
+    .command("packs:add")
+    .description("Explain how to unlock a capability pack in the Salesprompter CLI.")
+    .argument("<pack>", "Pack slug, for example contacts, research, discovery, or outreach")
+    .action((pack) => {
+    const normalized = String(pack).trim().toLowerCase();
+    const match = cliPacks.find((entry) => entry.slug === normalized);
+    if (!match) {
+        throw new Error(`Unknown pack "${pack}". Run "salesprompter packs:list" to see the supported packs.`);
+    }
+    printOutput({
+        status: "ok",
+        pack: match.slug,
+        title: match.title,
+        available: true,
+        installStatus: match.installStatus,
+        commands: match.commands,
+        message: `The ${match.title} pack is already included. Start with: salesprompter ${match.commands[0]}`
+    });
+});
+program
+    .command("upgrade")
+    .description("Show the recommended upgrade command for the current installation.")
+    .action(() => {
+    printOutput({
+        status: "ok",
+        command: "upgrade",
+        recommended: {
+            npmGlobal: "npm i -g salesprompter-cli@latest",
+            npx: "npx -y salesprompter-cli@latest",
+            docs: "https://docs.salesprompter.ai/quickstart"
+        }
+    });
+});
 program
     .command("auth:login")
     .description("Authenticate CLI with a Salesprompter app token, or device flow if the app supports it.")
@@ -4734,10 +4883,18 @@ program
 program.hook("preAction", async (_thisCommand, actionCommand) => {
     applyGlobalOutputOptions(actionCommand);
     const commandName = actionCommand.name();
+    const parentCommandName = actionCommand.parent && typeof actionCommand.parent.name === "function"
+        ? actionCommand.parent.name()
+        : "";
     if (commandName.startsWith("auth:") ||
+        commandName === "setup" ||
+        commandName === "doctor" ||
+        commandName === "upgrade" ||
         commandName === "wizard" ||
         commandName === "llm:ready" ||
-        commandName === "contacts:find-linkedin-urls") {
+        commandName === "contacts:find-linkedin-urls" ||
+        commandName.startsWith("packs:") ||
+        ((commandName === "list" || commandName === "add") && parentCommandName === "packs")) {
         return;
     }
     const commandOptions = actionCommand.opts();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "salesprompter-cli",
-  "version": "0.1.26",
+  "version": "0.1.27",
   "description": "Sales workflow CLI for guided lead generation, enrichment, scoring, and sync.",
   "type": "module",
   "bin": {