salesprompter-cli 0.1.74 → 0.1.76

package/README.md

@@ -42,6 +42,8 @@ For headless or automation use, generate a CLI token in the app and run `salespr
 
 `leads:at-companies` researches Director, Head-of, VP and C-level contacts across functions. It exports a shortlist for review without starting email enrichment or outreach.
 
+If LinkedIn rejects the saved session, the command tries a different local extension-synced session once and keeps completed searches. If none works, reconnect the extension or use `--browser-relay-port` with a signed-in browser worker. Rate limits stop the run without switching sessions.
+
 Create a JSON brief with verified numeric LinkedIn company IDs. Use each subsidiary's own ID; names alone are not an employer match. Missing IDs stay in the coverage report as unresolved.
 
 ```json
@@ -65,7 +67,13 @@ The default six functions are Digital Marketing & CRM, Digital Product & UX, Sof
 
 Contacts must match the current company ID, a senior title and the requested function. Selection alternates between functions, deduplicates profile URLs and never pads a company to its ceiling. The default ceiling is 20; each company can override it. Head-of roles classified as experienced managers are searched, but generic manager titles do not pass the final seniority check.
 
-Outputs are private local `contacts.csv`, `coverage.json` (including rejected/unresolved matches and per-function counts), and `checkpoint.json`. A completed search batch is not exhaustive coverage: each function collects at most `candidatesPerDepartment` candidates and the report records LinkedIn's reported total and any shortfall. Default `--max-searches 12` bounds each invocation. Increase it explicitly for larger batches. HTTP 429/999 stops the run and preserves completed searches; resume after cooldown. An interrupted individual search may be repeated.
+Default role matching includes talent acquisition, business intelligence, digital workplace and German department-head titles. Broad digital/transformation, communications and operational-technology matches go into `review.csv`, not the selected contacts. Mixed-role headlines cannot borrow seniority from an assistant or former role. Current-position evidence overrides a conflicting summary employer or headline.
+
+The export retains the source employer name. If LinkedIn returns the target ID with a different employer name, that candidate goes to review too: parent/subsidiary scope and legal-name aliases need an explicit human check.
+
+For custom functions, add `reviewTerms` (a subset of `terms`) for discovery terms that should require manual review: `{"name":"IT","terms":["it","digital"],"reviewTerms":["digital"]}`. A specific non-review term in the same senior-role clause can qualify a contact.
+
+Outputs are private local `contacts.csv`, `review.csv`, `coverage.json` (including review candidates, rejected/unresolved matches and per-function counts), and `checkpoint.json`. Review counts are candidate/function pairs, not additional unique leads. A completed search batch is not exhaustive coverage: each function collects at most `candidatesPerDepartment` candidates and the report records LinkedIn's reported total and any shortfall. Default `--max-searches 12` bounds each invocation. Increase it explicitly for larger batches. HTTP 429/999 stops the run and preserves completed searches; resume after cooldown. An interrupted individual search may be repeated.
 
 Live research requires Salesprompter workspace login and a LinkedIn session. `--browser-relay-port` uses the existing signed-in browser relay. Checkpoints are bound to both the brief and workspace; changed criteria require a new output directory. A concurrent run is refused; after a crash, remove only `.research-lock` after confirming the process stopped. This command does not import the shortlist into the workspace, find emails, or create campaigns. Review company identity, role fit and coverage before downstream use.
 

package/dist/cli.js

@@ -16,6 +16,7 @@ import { Command } from "commander";
 import { z } from "zod";
 import { AffiliateCopyReviewSchema, renderAffiliateCopyReview } from "./affiliate-copy.js";
 import { CompanyBriefSchema, planCompanySearches, runCompanyResearch } from "./company-leads.js";
+import { createSessionRecovery } from "./session-recovery.js";
 import { clearAuthSession, loginWithBrowserConnect, loginWithDeviceFlow, loginWithToken, readAuthSession, requireAuthSession, shouldBypassAuth, verifySession, writeAuthSession } from "./auth.js";
 import { buildBigQueryLeadLookupSql, executeBigQuerySql, normalizeBigQueryLeadRows, runBigQueryQuery, runBigQueryRows } from "./bigquery.js";
 import { AccountProfileSchema, EnrichedLeadSchema, IcpSchema, LeadSchema, ScoredLeadSchema, SyncTargetSchema } from "./domain.js";
@@ -15157,6 +15158,16 @@ program
     const port = options.browserRelayPort == null ? null : z.coerce.number().int().min(1).max(65535).parse(options.browserRelayPort);
     const relay = port == null ? null : await createLocalAccountSearchBrowserRelay(port);
     const config = relay ? null : await readLinkedInDirectLookupConfig();
+    const recoverSession = createSessionRecovery({
+        initial: config,
+        isAuthError: error => error instanceof LocalSalesNavigatorHttpError && (error.status === 401 || error.status === 403),
+        refresh: async () => relay || shouldDisableLinkedInDirectLookupAutodiscovery() ? null : readLocalLinkedInExtensionDirectLookupConfig(),
+        sameSession: (a, b) => a?.cookie === b?.cookie && a?.csrfToken === b?.csrfToken,
+        beforeRetry: async () => {
+            writeProgress("Saved LinkedIn session was rejected; trying the latest extension-synced session once.");
+            await delay(randomIntegerBetween(5000, 8000));
+        },
+    });
     let startedSearches = 0;
     try {
         const report = await runCompanyResearch({ brief, outDir: path.resolve(options.outDir), scope: `${session.apiBaseUrl}:${orgId}`, maxSearches,
@@ -15164,17 +15175,19 @@ program
                 if (startedSearches++ > 0)
                     await delay(randomIntegerBetween(5000, 8000));
                 process.stderr.write(`Researching ${job.company.name} — ${job.department.name}\n`);
-                const request = relay
-                    ? { url: buildSalesNavigatorLeadApiUrlFromSearchUrl(job.queryUrl, 100), headers: {} }
-                    : buildSalesNavigatorApiRequestFromSearchUrl(job.queryUrl, config, 100);
-                return fetchAllLocalSalesNavigatorPeople(request, {
-                    requestedProfiles: brief.candidatesPerDepartment, pageSize: 100, pageDelayMinMs: 5000, pageDelayMaxMs: 8000,
-                    retry: { maxRetries: 2, retryBaseDelayMs: 2000, retryMaxDelayMs: 10000 },
-                    executeRequest: relay ? request => relay.request(request) : undefined,
+                return recoverSession(async (activeConfig) => {
+                    const request = relay
+                        ? { url: buildSalesNavigatorLeadApiUrlFromSearchUrl(job.queryUrl, 100), headers: {} }
+                        : buildSalesNavigatorApiRequestFromSearchUrl(job.queryUrl, activeConfig, 100);
+                    return fetchAllLocalSalesNavigatorPeople(request, {
+                        requestedProfiles: brief.candidatesPerDepartment, pageSize: 100, pageDelayMinMs: 5000, pageDelayMaxMs: 8000,
+                        retry: { maxRetries: 2, retryBaseDelayMs: 2000, retryMaxDelayMs: 10000 },
+                        executeRequest: relay ? request => relay.request(request) : undefined,
+                    });
                 });
             },
         });
-        printOutput({ status: report.status, selected: report.selected.length, completedSearches: report.completedSearches, totalSearches: report.totalSearches, coverage: report.coverage, output: report.output, resumable: true, outreachStarted: false, emailEnrichmentStarted: false });
+        printOutput({ status: report.status, selected: report.selected.length, reviewRequired: report.review.length, completedSearches: report.completedSearches, totalSearches: report.totalSearches, coverage: report.coverage, output: report.output, resumable: true, outreachStarted: false, emailEnrichmentStarted: false });
     }
     finally {
         await relay?.close();

package/dist/company-leads.js

@@ -4,12 +4,12 @@ import path from "node:path";
 import { z } from "zod";
 import { buildSalesNavigatorPeopleSearchUrl } from "./sales-navigator.js";
 export const defaultDepartments = [
-    { name: "Digital Marketing & CRM", terms: ["marketing", "crm", "growth"] },
-    { name: "Digital Product & UX", terms: ["product", "ux", "design"] },
-    { name: "Software Development", terms: ["software", "engineering", "development", "cto"] },
-    { name: "IT", terms: ["it", "information technology", "cio"] },
-    { name: "Data & AI", terms: ["data", "ai", "artificial intelligence", "analytics"] },
-    { name: "HR", terms: ["hr", "human resources", "people", "personal", "chro"] },
+    { name: "Digital Marketing & CRM", terms: ["marketing", "crm", "growth", "communication"], reviewTerms: ["communication"] },
+    { name: "Digital Product & UX", terms: ["product", "ux", "design"], reviewTerms: [] },
+    { name: "Software Development", terms: ["software", "engineering", "development", "cto", "operational technology"], reviewTerms: ["operational technology"] },
+    { name: "IT", terms: ["it", "information technology", "cio", "digital workplace", "chief digital officer", "cdo", "digital", "transformation"], reviewTerms: ["digital", "transformation"] },
+    { name: "Data & AI", terms: ["data", "ai", "artificial intelligence", "analytics", "business intelligence"], reviewTerms: [] },
+    { name: "HR", terms: ["hr", "human resources", "people", "personal", "chro", "talent"], reviewTerms: [] },
 ];
 const companySchema = z.object({
     name: z.string().trim().min(1),
@@ -18,7 +18,7 @@ const companySchema = z.object({
 }).strict();
 export const CompanyBriefSchema = z.object({
     companies: z.array(companySchema).min(1),
-    departments: z.array(z.object({ name: z.string().trim().min(1), terms: z.array(z.string().trim().min(1)).min(1) }).strict()).min(1).default(defaultDepartments),
+    departments: z.array(z.object({ name: z.string().trim().min(1), terms: z.array(z.string().trim().min(1)).min(1), reviewTerms: z.array(z.string().trim().min(1)).default([]) }).strict()).min(1).default(defaultDepartments),
     regionIds: z.array(z.string().regex(/^[1-9]\d*$/)).default([]),
     candidatesPerDepartment: z.number().int().min(1).max(100).default(50),
 }).strict().superRefine((brief, ctx) => {
@@ -28,6 +28,10 @@ export const CompanyBriefSchema = z.object({
     const names = brief.departments.map(d => d.name.toLowerCase());
     if (new Set(names).size !== names.length)
         ctx.addIssue({ code: "custom", message: "Department names must be unique." });
+    for (const department of brief.departments) {
+        if (department.reviewTerms.some(term => !department.terms.some(t => words(t) === words(term))))
+            ctx.addIssue({ code: "custom", message: "Review terms must also be included in department search terms." });
+    }
 });
 export function planCompanySearches(brief) {
     return brief.companies.filter(c => c.companyId).flatMap(company => brief.departments.map((department, index) => ({
@@ -40,12 +44,33 @@ export function planCompanySearches(brief) {
         ]),
     })));
 }
-function words(text) { return text.toLowerCase().normalize("NFKC").replace(/[^\p{L}\p{N}]+/gu, " ").trim(); }
+function words(text) {
+    return text.toLowerCase().normalize("NFKC")
+        .replace(/\b(marketing|personal|entwicklungs|it)leiter(in)?\b/g, (_, functionName, suffix) => `${functionName === "personal" ? "hr" : functionName === "entwicklungs" ? "development" : functionName} leiter${suffix ?? ""}`)
+        .replace(/[^\p{L}\p{N}]+/gu, " ").trim();
+}
 function hasTerm(title, term) { return ` ${words(title)} `.includes(` ${words(term)} `); }
 function senior(title) {
-    return /\b(director|head|chief|ceo|cto|cio|cdo|cmo|chro|cpo|vp|vice president|vorstand|geschäftsführ\w*|leiter\w*|leitung)\b/i.test(title)
+    title = words(title);
+    return /\b(director|head|chief|ceo|cto|cio|cdo|cmo|chro|cpo|vp|vice president|vorstand|geschäftsführ\w*|(?:fachbereichs|bereichs|abteilungs|ressort|hauptabteilungs)?leiter(?:in)?|(?:fachbereichs|bereichs|abteilungs)?leitung)\b/i.test(title)
         && !/\b(assistant|assistent\w*|assistenz|deputy|stellvertret\w*|former|ehemalig\w*)\b/i.test(title);
 }
+// A senior role in one clause must not promote an assistant/former role in another.
+export function classifyCompanyRole(title, department) {
+    const clauses = title.split(/\s*[|;\n]\s*|,\s*(?=(?:sr\.?\s+|senior\s+)?(?:director|head|chief|deputy|assistant|former|vp|vice president|leiter|fachbereichsleiter)\b)/i);
+    const relevant = clauses.filter(clause => senior(clause));
+    if (!relevant.length)
+        return "seniority_not_verified";
+    const reviewTerms = new Set(department.reviewTerms.map(words));
+    if (relevant.some(clause => department.terms.some(term => !reviewTerms.has(words(term)) && hasTerm(clause, term))))
+        return "match";
+    if (relevant.some(clause => department.terms.some(term => hasTerm(clause, term))))
+        return "review";
+    // Mixed-role headlines need a human decision, never borrow seniority across clauses.
+    if (clauses.length > 1 && department.terms.some(term => hasTerm(title, term)))
+        return "review";
+    return "function_not_verified";
+}
 function seniorRank(title) {
     if (/\b(chief|ceo|cto|cio|cdo|cmo|chro|cpo|vorstand|geschäftsführ\w*)\b/i.test(title))
         return 0;
@@ -67,6 +92,8 @@ export function canonicalProfile(value) {
 export function shortlistCompanyLeads(brief, results) {
     const selected = [];
     const rejected = [];
+    const review = [];
+    const reviewSeen = new Set();
     const coverage = [];
     const seen = new Set();
     for (const company of brief.companies) {
@@ -77,15 +104,28 @@ export function shortlistCompanyLeads(brief, results) {
                 const profile = canonicalProfile(p.profileUrl);
                 // Prefer the actual current job over a free-form profile headline.
                 const raw = p.rawLocalSalesNavigatorResult;
-                const position = raw?.currentPositions?.find(x => String(x.companyId ?? x.companyUrn?.split(":").pop() ?? "") === company.companyId);
-                const title = String(position?.title ?? p.title ?? "");
-                const exactCompany = String(p.companyId ?? "") === company.companyId || Boolean(position);
-                const reason = !profile ? "invalid_profile" : !exactCompany ? "company_not_verified" : !senior(title) ? "seniority_not_verified" : !job.department.terms.some(term => hasTerm(title, term)) ? "function_not_verified" : null;
+                const positions = raw?.currentPositions?.filter(x => String(x.companyId ?? x.companyUrn?.split(":").pop() ?? "") === company.companyId);
+                const titles = positions?.length ? positions.map(x => String(x.title ?? "")) : [String(p.title ?? "")];
+                const title = titles.find(t => classifyCompanyRole(t, job.department) === "match") ?? titles.find(t => classifyCompanyRole(t, job.department) === "review") ?? titles[0];
+                const exactCompany = raw?.currentPositions?.length ? Boolean(positions?.length) : String(p.companyId ?? "") === company.companyId;
+                const role = classifyCompanyRole(title, job.department);
+                const reason = !profile ? "invalid_profile" : !exactCompany ? "company_not_verified" : role !== "match" && role !== "review" ? role : null;
                 if (reason) {
                     rejected.push({ companyId: company.companyId, profileUrl: p.profileUrl, reason });
                     continue;
                 }
-                rows.push({ profileUrl: profile, fullName: p.fullName ?? "", title, companyId: company.companyId, companyName: company.name, department: job.department.name, location: p.location ?? "", sourceQueryUrl: job.queryUrl, observedAt: p.timestamp ?? "" });
+                const sourceCompanyName = positions?.find(p => p.title === title)?.companyName ?? p.companyName ?? "";
+                const employerNameDiffers = Boolean(sourceCompanyName) && words(String(sourceCompanyName)) !== words(company.name);
+                const row = { profileUrl: profile, fullName: p.fullName ?? "", title, companyId: company.companyId, companyName: company.name, sourceCompanyName, department: job.department.name, location: p.location ?? "", sourceQueryUrl: job.queryUrl, observedAt: p.timestamp ?? "" };
+                if (role === "review" || employerNameDiffers) {
+                    const key = `${company.companyId}:${job.department.name}:${profile}`;
+                    if (!reviewSeen.has(key)) {
+                        reviewSeen.add(key);
+                        review.push({ ...row, reason: employerNameDiffers ? "employer_name_differs" : "ambiguous_role" });
+                    }
+                    continue;
+                }
+                rows.push(row);
             }
             return rows.sort((a, b) => seniorRank(String(a.title)) - seniorRank(String(b.title)) || String(a.profileUrl).localeCompare(String(b.profileUrl)));
         });
@@ -107,14 +147,14 @@ export function shortlistCompanyLeads(brief, results) {
             }
         }
         selected.push(...local);
-        coverage.push({ companyName: company.name, companyId: company.companyId ?? null, selected: local.length, ceiling: company.maxContacts,
+        coverage.push({ companyName: company.name, companyId: company.companyId ?? null, selected: local.length, reviewRequired: review.filter(p => p.companyId === company.companyId).length, ceiling: company.maxContacts,
             status: !company.companyId ? "unresolved_company" : jobs.some(j => !results[j.key]) ? "pending" : local.length ? "review_ready" : "no_verified_matches",
             departments: jobs.map(j => ({ name: j.department.name, selected: local.filter(p => p.department === j.department.name).length, collected: results[j.key]?.people.length ?? null, reported: results[j.key]?.totalResults ?? null, searchComplete: results[j.key]?.totalResults != null ? results[j.key].people.length >= results[j.key].totalResults : null })) });
     }
-    return { selected, rejected, coverage, outreachStarted: false, emailEnrichmentStarted: false };
+    return { selected, review, rejected, coverage, outreachStarted: false, emailEnrichmentStarted: false };
 }
 export function companyLeadCsv(rows) {
-    const columns = ["companyName", "companyId", "fullName", "title", "department", "profileUrl", "location", "sourceQueryUrl", "observedAt"];
+    const columns = ["companyName", "companyId", "fullName", "title", "department", "profileUrl", "location", "sourceQueryUrl", "observedAt", "sourceCompanyName", "reason"];
     const escape = (value) => { let s = String(value ?? ""); if (/^[=+@\-\t\r]/.test(s))
         s = "'" + s; return `"${s.replace(/"/g, '""')}"`; };
     return [columns.join(","), ...rows.map(r => columns.map(c => escape(r[c])).join(","))].join("\n") + "\n";
@@ -153,7 +193,7 @@ async function runCompanyResearchLocked(input) {
             throw e;
     }
     const save = async (file, value) => { await writeFile(file + ".tmp", value, { mode: 0o600 }); await chmod(file + ".tmp", 0o600); await rename(file + ".tmp", file); };
-    const publish = async () => { const report = shortlistCompanyLeads(brief, state.results); await save(path.join(outDir, "contacts.csv"), companyLeadCsv(report.selected)); await save(path.join(outDir, "coverage.json"), JSON.stringify(report, null, 2)); return report; };
+    const publish = async () => { const report = shortlistCompanyLeads(brief, state.results); await save(path.join(outDir, "contacts.csv"), companyLeadCsv(report.selected)); await save(path.join(outDir, "review.csv"), companyLeadCsv(report.review)); await save(path.join(outDir, "coverage.json"), JSON.stringify(report, null, 2)); return report; };
     let performed = 0;
     try {
         for (const job of planCompanySearches(brief)) {

package/dist/session-recovery.js

@@ -0,0 +1,31 @@
+/** One credential refresh per run; never rotate on rate limits or other failures. */
+export function createSessionRecovery(options) {
+    let current = options.initial;
+    let attempted = false;
+    const unavailable = () => new Error("Sales Navigator rejected the available LinkedIn session. Completed company searches are preserved. Reconnect the Salesprompter extension, or rerun with --browser-relay-port and a signed-in browser worker. Signing into Salesprompter alone does not refresh LinkedIn.");
+    return async function run(collect) {
+        try {
+            return await collect(current);
+        }
+        catch (error) {
+            if (!options.isAuthError(error))
+                throw error;
+            if (attempted)
+                throw unavailable();
+            attempted = true;
+            const next = await options.refresh();
+            if (!next || options.sameSession(current, next))
+                throw unavailable();
+            current = next;
+            await options.beforeRetry();
+            try {
+                return await collect(current);
+            }
+            catch (retryError) {
+                if (options.isAuthError(retryError))
+                    throw unavailable();
+                throw retryError;
+            }
+        }
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "salesprompter-cli",
-  "version": "0.1.74",
+  "version": "0.1.76",
   "description": "Sales workflow CLI for guided lead generation, enrichment, scoring, and sync.",
   "author": "Daniel Sinewe <hello@danielsinewe.com>",
   "type": "module",