salesprompter-cli 0.1.0

package/.codex/environments/environment.toml

@@ -0,0 +1,19 @@
+# THIS IS AUTOGENERATED. DO NOT EDIT MANUALLY
+version = 1
+name = "salesprompter-cli"
+
+[setup]
+script = ""
+
+[[actions]]
+name = "Run"
+icon = "run"
+command = '''
+npm login
+npm publish --access public
+'''
+
+[[actions]]
+name = "npm publish --access public"
+icon = "tool"
+command = "npm publish --access public"

package/README.md

@@ -0,0 +1,54 @@
+# salesprompter-cli
+
+`salesprompter-cli` is a JSON-first command line interface for running a practical sales workflow:
+
+- Define an ideal customer profile
+- Generate seed leads
+- Enrich leads
+- Score leads
+- Sync leads into CRM and outreach systems
+
+The first version is intentionally local-first. It uses deterministic heuristics and dry-run sync providers so the command surface and data contracts are stable before real APIs are attached.
+
+When you pass `--company-domain`, the CLI generates modeled contacts for that target account. These are synthetic leads for workflow testing, not verified real contacts.
+
+## Why this shape works for humans and LLMs
+
+- Every command reads and writes plain JSON.
+- Output is machine-readable and composable.
+- Domain contracts are explicit and validated with `zod`.
+- External integrations are behind narrow provider interfaces.
+
+## Commands
+
+```bash
+salesprompter icp:define --name "EU SaaS RevOps" \
+  --industries "Software,Financial Services" \
+  --company-sizes "50-199,200-499" \
+  --regions "Europe" \
+  --titles "Head of Revenue Operations,VP Sales" \
+  --required-signals "recent funding,growing outbound team" \
+  --out ./data/icp.json
+
+salesprompter leads:generate --icp ./data/icp.json --count 5 --out ./data/leads.json
+salesprompter leads:generate --icp ./data/icp.json --count 5 --company-domain deel.com --company-name Deel --out ./data/deel-leads.json
+salesprompter leads:enrich --in ./data/leads.json --out ./data/enriched.json
+salesprompter leads:score --icp ./data/icp.json --in ./data/enriched.json --out ./data/scored.json
+salesprompter sync:crm --target hubspot --in ./data/scored.json
+salesprompter sync:outreach --target instantly --in ./data/scored.json
+```
+
+## Development
+
+```bash
+npm install
+npm run build
+node ./dist/cli.js --help
+```
+
+## Next integrations
+
+- Replace `HeuristicLeadProvider` with Apollo, Clay, LinkedIn, or custom data providers.
+- Replace `HeuristicEnrichmentProvider` with enrichment APIs such as Clearbit, FullEnrich, or custom LLM workflows.
+- Replace `DryRunSyncProvider` with real HubSpot, Salesforce, Pipedrive, Instantly, Apollo, or Outreach clients.
+- Add prompt-oriented commands so an LLM can ask for ICP refinement or lead prioritization directly through the CLI.

package/data/deel-icp.json

@@ -0,0 +1,17 @@
+{
+  "name": "Global HR Tech",
+  "industries": [
+    "Software"
+  ],
+  "companySizes": [],
+  "regions": [
+    "Global"
+  ],
+  "titles": [
+    "VP Sales",
+    "Head of Revenue Operations"
+  ],
+  "pains": [],
+  "requiredSignals": [],
+  "excludedSignals": []
+}

package/data/deel-leads.json

@@ -0,0 +1,77 @@
+[
+  {
+    "companyName": "Deel",
+    "domain": "deel.com",
+    "industry": "Software",
+    "region": "Global",
+    "employeeCount": 180,
+    "contactName": "Jordan Patel",
+    "title": "VP Sales",
+    "email": "jordan.patel@deel.com",
+    "source": "heuristic-target-account",
+    "signals": [
+      "hiring sales reps",
+      "expanding into new regions"
+    ]
+  },
+  {
+    "companyName": "Deel",
+    "domain": "deel.com",
+    "industry": "Software",
+    "region": "Global",
+    "employeeCount": 320,
+    "contactName": "Taylor Morgan",
+    "title": "Head of Revenue Operations",
+    "email": "taylor.morgan@deel.com",
+    "source": "heuristic-target-account",
+    "signals": [
+      "recent funding",
+      "using fragmented sales tooling"
+    ]
+  },
+  {
+    "companyName": "Deel",
+    "domain": "deel.com",
+    "industry": "Software",
+    "region": "Global",
+    "employeeCount": 85,
+    "contactName": "Morgan Diaz",
+    "title": "VP Sales",
+    "email": "morgan.diaz@deel.com",
+    "source": "heuristic-target-account",
+    "signals": [
+      "expanding into new regions",
+      "growing outbound team"
+    ]
+  },
+  {
+    "companyName": "Deel",
+    "domain": "deel.com",
+    "industry": "Software",
+    "region": "Global",
+    "employeeCount": 540,
+    "contactName": "Cameron Lee",
+    "title": "Head of Revenue Operations",
+    "email": "cameron.lee@deel.com",
+    "source": "heuristic-target-account",
+    "signals": [
+      "using fragmented sales tooling",
+      "launching new product line"
+    ]
+  },
+  {
+    "companyName": "Deel",
+    "domain": "deel.com",
+    "industry": "Software",
+    "region": "Global",
+    "employeeCount": 260,
+    "contactName": "Riley Brooks",
+    "title": "VP Sales",
+    "email": "riley.brooks@deel.com",
+    "source": "heuristic-target-account",
+    "signals": [
+      "growing outbound team",
+      "hiring sales reps"
+    ]
+  }
+]

package/data/enriched.json

@@ -0,0 +1,106 @@
+[
+  {
+    "companyName": "Northstar Freight",
+    "domain": "northstarfreight.com",
+    "industry": "Software",
+    "region": "Europe",
+    "employeeCount": 180,
+    "contactName": "Jordan Patel",
+    "title": "Head of Revenue Operations",
+    "email": "jordan.patel@northstarfreight.com",
+    "source": "heuristic-seed",
+    "signals": [
+      "hiring sales reps",
+      "expanding into new regions"
+    ],
+    "techStack": [
+      "HubSpot",
+      "Instantly"
+    ],
+    "crmFit": "medium",
+    "outreachFit": "medium",
+    "buyingStage": "solution-aware",
+    "notes": [
+      "Northstar Freight matches the Software segment.",
+      "Jordan Patel is likely close to revenue tooling decisions."
+    ]
+  },
+  {
+    "companyName": "Brightpath Health",
+    "domain": "brightpathhealth.io",
+    "industry": "Financial Services",
+    "region": "Europe",
+    "employeeCount": 320,
+    "contactName": "Taylor Morgan",
+    "title": "VP Sales",
+    "email": "taylor.morgan@brightpathhealth.io",
+    "source": "heuristic-seed",
+    "signals": [
+      "recent funding",
+      "using fragmented sales tooling"
+    ],
+    "techStack": [
+      "Salesforce",
+      "Outreach"
+    ],
+    "crmFit": "high",
+    "outreachFit": "medium",
+    "buyingStage": "active-evaluation",
+    "notes": [
+      "Brightpath Health matches the Financial Services segment.",
+      "Taylor Morgan is likely close to revenue tooling decisions."
+    ]
+  },
+  {
+    "companyName": "ForgeOps Cloud",
+    "domain": "forgeopscloud.dev",
+    "industry": "Software",
+    "region": "Europe",
+    "employeeCount": 85,
+    "contactName": "Morgan Diaz",
+    "title": "Head of Revenue Operations",
+    "email": "morgan.diaz@forgeopscloud.dev",
+    "source": "heuristic-seed",
+    "signals": [
+      "expanding into new regions",
+      "growing outbound team"
+    ],
+    "techStack": [
+      "Apollo",
+      "Clay"
+    ],
+    "crmFit": "low",
+    "outreachFit": "high",
+    "buyingStage": "solution-aware",
+    "notes": [
+      "ForgeOps Cloud matches the Software segment.",
+      "Morgan Diaz is likely close to revenue tooling decisions."
+    ]
+  },
+  {
+    "companyName": "Summit Retail Group",
+    "domain": "summitretailgroup.com",
+    "industry": "Financial Services",
+    "region": "Europe",
+    "employeeCount": 540,
+    "contactName": "Cameron Lee",
+    "title": "VP Sales",
+    "email": "cameron.lee@summitretailgroup.com",
+    "source": "heuristic-seed",
+    "signals": [
+      "using fragmented sales tooling",
+      "launching new product line"
+    ],
+    "techStack": [
+      "Instantly",
+      "Segment"
+    ],
+    "crmFit": "high",
+    "outreachFit": "medium",
+    "buyingStage": "solution-aware",
+    "notes": [
+      "Summit Retail Group matches the Financial Services segment.",
+      "Cameron Lee is likely close to revenue tooling decisions."
+    ]
+  }
+]

package/data/icp.json

@@ -0,0 +1,24 @@
+{
+  "name": "EU SaaS RevOps",
+  "industries": [
+    "Software",
+    "Financial Services"
+  ],
+  "companySizes": [
+    "50-199",
+    "200-499"
+  ],
+  "regions": [
+    "Europe"
+  ],
+  "titles": [
+    "Head of Revenue Operations",
+    "VP Sales"
+  ],
+  "pains": [],
+  "requiredSignals": [
+    "recent funding",
+    "growing outbound team"
+  ],
+  "excludedSignals": []
+}

package/data/leads.json

@@ -0,0 +1,62 @@
+[
+  {
+    "companyName": "Northstar Freight",
+    "domain": "northstarfreight.com",
+    "industry": "Software",
+    "region": "Europe",
+    "employeeCount": 180,
+    "contactName": "Jordan Patel",
+    "title": "Head of Revenue Operations",
+    "email": "jordan.patel@northstarfreight.com",
+    "source": "heuristic-seed",
+    "signals": [
+      "hiring sales reps",
+      "expanding into new regions"
+    ]
+  },
+  {
+    "companyName": "Brightpath Health",
+    "domain": "brightpathhealth.io",
+    "industry": "Financial Services",
+    "region": "Europe",
+    "employeeCount": 320,
+    "contactName": "Taylor Morgan",
+    "title": "VP Sales",
+    "email": "taylor.morgan@brightpathhealth.io",
+    "source": "heuristic-seed",
+    "signals": [
+      "recent funding",
+      "using fragmented sales tooling"
+    ]
+  },
+  {
+    "companyName": "ForgeOps Cloud",
+    "domain": "forgeopscloud.dev",
+    "industry": "Software",
+    "region": "Europe",
+    "employeeCount": 85,
+    "contactName": "Morgan Diaz",
+    "title": "Head of Revenue Operations",
+    "email": "morgan.diaz@forgeopscloud.dev",
+    "source": "heuristic-seed",
+    "signals": [
+      "expanding into new regions",
+      "growing outbound team"
+    ]
+  },
+  {
+    "companyName": "Summit Retail Group",
+    "domain": "summitretailgroup.com",
+    "industry": "Financial Services",
+    "region": "Europe",
+    "employeeCount": 540,
+    "contactName": "Cameron Lee",
+    "title": "VP Sales",
+    "email": "cameron.lee@summitretailgroup.com",
+    "source": "heuristic-seed",
+    "signals": [
+      "using fragmented sales tooling",
+      "launching new product line"
+    ]
+  }
+]

package/data/scored.json

@@ -0,0 +1,142 @@
+[
+  {
+    "companyName": "Northstar Freight",
+    "domain": "northstarfreight.com",
+    "industry": "Software",
+    "region": "Europe",
+    "employeeCount": 180,
+    "contactName": "Jordan Patel",
+    "title": "Head of Revenue Operations",
+    "email": "jordan.patel@northstarfreight.com",
+    "source": "heuristic-seed",
+    "signals": [
+      "hiring sales reps",
+      "expanding into new regions"
+    ],
+    "techStack": [
+      "HubSpot",
+      "Instantly"
+    ],
+    "crmFit": "medium",
+    "outreachFit": "medium",
+    "buyingStage": "solution-aware",
+    "notes": [
+      "Northstar Freight matches the Software segment.",
+      "Jordan Patel is likely close to revenue tooling decisions."
+    ],
+    "score": 90,
+    "grade": "A",
+    "rationale": [
+      "Industry matches ICP.",
+      "Region matches ICP.",
+      "Company size matches ICP.",
+      "Contact title matches ICP."
+    ]
+  },
+  {
+    "companyName": "Brightpath Health",
+    "domain": "brightpathhealth.io",
+    "industry": "Financial Services",
+    "region": "Europe",
+    "employeeCount": 320,
+    "contactName": "Taylor Morgan",
+    "title": "VP Sales",
+    "email": "taylor.morgan@brightpathhealth.io",
+    "source": "heuristic-seed",
+    "signals": [
+      "recent funding",
+      "using fragmented sales tooling"
+    ],
+    "techStack": [
+      "Salesforce",
+      "Outreach"
+    ],
+    "crmFit": "high",
+    "outreachFit": "medium",
+    "buyingStage": "active-evaluation",
+    "notes": [
+      "Brightpath Health matches the Financial Services segment.",
+      "Taylor Morgan is likely close to revenue tooling decisions."
+    ],
+    "score": 100,
+    "grade": "A",
+    "rationale": [
+      "Industry matches ICP.",
+      "Region matches ICP.",
+      "Company size matches ICP.",
+      "Contact title matches ICP.",
+      "Matched 1 required buying signals.",
+      "Strong CRM fit."
+    ]
+  },
+  {
+    "companyName": "ForgeOps Cloud",
+    "domain": "forgeopscloud.dev",
+    "industry": "Software",
+    "region": "Europe",
+    "employeeCount": 85,
+    "contactName": "Morgan Diaz",
+    "title": "Head of Revenue Operations",
+    "email": "morgan.diaz@forgeopscloud.dev",
+    "source": "heuristic-seed",
+    "signals": [
+      "expanding into new regions",
+      "growing outbound team"
+    ],
+    "techStack": [
+      "Apollo",
+      "Clay"
+    ],
+    "crmFit": "low",
+    "outreachFit": "high",
+    "buyingStage": "solution-aware",
+    "notes": [
+      "ForgeOps Cloud matches the Software segment.",
+      "Morgan Diaz is likely close to revenue tooling decisions."
+    ],
+    "score": 100,
+    "grade": "A",
+    "rationale": [
+      "Industry matches ICP.",
+      "Region matches ICP.",
+      "Company size matches ICP.",
+      "Contact title matches ICP.",
+      "Matched 1 required buying signals.",
+      "Strong outreach fit."
+    ]
+  },
+  {
+    "companyName": "Summit Retail Group",
+    "domain": "summitretailgroup.com",
+    "industry": "Financial Services",
+    "region": "Europe",
+    "employeeCount": 540,
+    "contactName": "Cameron Lee",
+    "title": "VP Sales",
+    "email": "cameron.lee@summitretailgroup.com",
+    "source": "heuristic-seed",
+    "signals": [
+      "using fragmented sales tooling",
+      "launching new product line"
+    ],
+    "techStack": [
+      "Instantly",
+      "Segment"
+    ],
+    "crmFit": "high",
+    "outreachFit": "medium",
+    "buyingStage": "solution-aware",
+    "notes": [
+      "Summit Retail Group matches the Financial Services segment.",
+      "Cameron Lee is likely close to revenue tooling decisions."
+    ],
+    "score": 85,
+    "grade": "A",
+    "rationale": [
+      "Industry matches ICP.",
+      "Region matches ICP.",
+      "Contact title matches ICP.",
+      "Strong CRM fit."
+    ]
+  }
+]

package/dist/cli.js

@@ -0,0 +1,114 @@
+#!/usr/bin/env node
+import { Command } from "commander";
+import { z } from "zod";
+import { EnrichedLeadSchema, IcpSchema, LeadSchema, ScoredLeadSchema, SyncTargetSchema } from "./domain.js";
+import { DryRunSyncProvider, HeuristicEnrichmentProvider, HeuristicLeadProvider, HeuristicScoringProvider } from "./engine.js";
+import { readJsonFile, splitCsv, writeJsonFile } from "./io.js";
+const program = new Command();
+const leadProvider = new HeuristicLeadProvider();
+const enrichmentProvider = new HeuristicEnrichmentProvider();
+const scoringProvider = new HeuristicScoringProvider();
+const syncProvider = new DryRunSyncProvider();
+function printOutput(value) {
+    process.stdout.write(`${JSON.stringify(value, null, 2)}\n`);
+}
+program
+    .name("salesprompter")
+    .description("Sales workflow CLI for ICP definition, lead generation, enrichment, scoring, and sync.")
+    .version("0.1.0");
+program
+    .command("icp:define")
+    .description("Define an ideal customer profile and write it to a JSON file.")
+    .requiredOption("--name <name>", "Human-readable ICP name")
+    .option("--industries <items>", "Comma-separated industries", "")
+    .option("--company-sizes <items>", "Comma-separated buckets like 1-49,50-199,200-499,500+", "")
+    .option("--regions <items>", "Comma-separated regions", "")
+    .option("--titles <items>", "Comma-separated titles", "")
+    .option("--pains <items>", "Comma-separated pain points", "")
+    .option("--required-signals <items>", "Comma-separated required signals", "")
+    .option("--excluded-signals <items>", "Comma-separated excluded signals", "")
+    .requiredOption("--out <path>", "Output file path")
+    .action(async (options) => {
+    const icp = IcpSchema.parse({
+        name: options.name,
+        industries: splitCsv(options.industries),
+        companySizes: splitCsv(options.companySizes),
+        regions: splitCsv(options.regions),
+        titles: splitCsv(options.titles),
+        pains: splitCsv(options.pains),
+        requiredSignals: splitCsv(options.requiredSignals),
+        excludedSignals: splitCsv(options.excludedSignals)
+    });
+    await writeJsonFile(options.out, icp);
+    printOutput({ status: "ok", icp });
+});
+program
+    .command("leads:generate")
+    .description("Generate seed leads against an ICP.")
+    .requiredOption("--icp <path>", "Path to ICP JSON")
+    .option("--count <number>", "Number of leads to generate", "10")
+    .option("--company-domain <domain>", "Target a specific company domain like deel.com")
+    .option("--company-name <name>", "Optional company name override for a targeted domain")
+    .requiredOption("--out <path>", "Output file path")
+    .action(async (options) => {
+    const icp = await readJsonFile(options.icp, IcpSchema);
+    const count = z.coerce.number().int().min(1).max(1000).parse(options.count);
+    const target = {
+        companyDomain: options.companyDomain,
+        companyName: options.companyName
+    };
+    const leads = await leadProvider.generateLeads(icp, count, target);
+    await writeJsonFile(options.out, leads);
+    printOutput({ status: "ok", generated: leads.length, out: options.out, target: target.companyDomain ?? null });
+});
+program
+    .command("leads:enrich")
+    .description("Enrich leads with fit, buying stage, and tech stack data.")
+    .requiredOption("--in <path>", "Path to lead JSON array")
+    .requiredOption("--out <path>", "Output file path")
+    .action(async (options) => {
+    const leads = await readJsonFile(options.in, z.array(LeadSchema));
+    const enriched = await enrichmentProvider.enrichLeads(leads);
+    await writeJsonFile(options.out, enriched);
+    printOutput({ status: "ok", enriched: enriched.length, out: options.out });
+});
+program
+    .command("leads:score")
+    .description("Score enriched leads against an ICP.")
+    .requiredOption("--icp <path>", "Path to ICP JSON")
+    .requiredOption("--in <path>", "Path to enriched lead JSON array")
+    .requiredOption("--out <path>", "Output file path")
+    .action(async (options) => {
+    const icp = await readJsonFile(options.icp, IcpSchema);
+    const leads = await readJsonFile(options.in, z.array(EnrichedLeadSchema));
+    const scored = await scoringProvider.scoreLeads(icp, leads);
+    await writeJsonFile(options.out, scored);
+    printOutput({ status: "ok", scored: scored.length, out: options.out });
+});
+program
+    .command("sync:crm")
+    .description("Dry-run sync scored leads into a CRM target.")
+    .requiredOption("--target <target>", "hubspot|salesforce|pipedrive")
+    .requiredOption("--in <path>", "Path to scored lead JSON array")
+    .action(async (options) => {
+    const target = SyncTargetSchema.parse(options.target);
+    const leads = await readJsonFile(options.in, z.array(ScoredLeadSchema));
+    const result = await syncProvider.sync(target, leads);
+    printOutput({ status: "ok", ...result });
+});
+program
+    .command("sync:outreach")
+    .description("Dry-run sync scored leads into an outreach platform.")
+    .requiredOption("--target <target>", "apollo|instantly|outreach")
+    .requiredOption("--in <path>", "Path to scored lead JSON array")
+    .action(async (options) => {
+    const target = SyncTargetSchema.parse(options.target);
+    const leads = await readJsonFile(options.in, z.array(ScoredLeadSchema));
+    const result = await syncProvider.sync(target, leads);
+    printOutput({ status: "ok", ...result });
+});
+program.parseAsync(process.argv).catch((error) => {
+    const message = error instanceof Error ? error.message : "Unknown error";
+    process.stderr.write(`${message}\n`);
+    process.exitCode = 1;
+});

package/dist/domain.js

@@ -0,0 +1,36 @@
+import { z } from "zod";
+export const IcpSchema = z.object({
+    name: z.string().min(1),
+    industries: z.array(z.string().min(1)).default([]),
+    companySizes: z.array(z.string().min(1)).default([]),
+    regions: z.array(z.string().min(1)).default([]),
+    titles: z.array(z.string().min(1)).default([]),
+    pains: z.array(z.string().min(1)).default([]),
+    requiredSignals: z.array(z.string().min(1)).default([]),
+    excludedSignals: z.array(z.string().min(1)).default([]),
+});
+export const LeadSchema = z.object({
+    companyName: z.string().min(1),
+    domain: z.string().min(1),
+    industry: z.string().min(1),
+    region: z.string().min(1),
+    employeeCount: z.number().int().nonnegative(),
+    contactName: z.string().min(1),
+    title: z.string().min(1),
+    email: z.string().email(),
+    source: z.string().min(1),
+    signals: z.array(z.string().min(1)).default([]),
+});
+export const EnrichedLeadSchema = LeadSchema.extend({
+    techStack: z.array(z.string().min(1)).default([]),
+    crmFit: z.enum(["high", "medium", "low"]),
+    outreachFit: z.enum(["high", "medium", "low"]),
+    buyingStage: z.enum(["problem-aware", "solution-aware", "active-evaluation"]),
+    notes: z.array(z.string().min(1)).default([]),
+});
+export const ScoredLeadSchema = EnrichedLeadSchema.extend({
+    score: z.number().int().min(0).max(100),
+    grade: z.enum(["A", "B", "C", "D"]),
+    rationale: z.array(z.string().min(1)).default([]),
+});
+export const SyncTargetSchema = z.enum(["hubspot", "salesforce", "pipedrive", "apollo", "instantly", "outreach"]);