salesprompter-cli 0.1.76 → 0.1.78

package/README.md

@@ -42,6 +42,12 @@ 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.
 
+The checkpoint, shortlist and review exports refresh after every completed search, so long runs expose saved progress immediately. Company labels with punctuation, such as `(TKMS)`, are escaped safely in search queries.
+
+Use `--report-only` to refresh saved reports without contacting LinkedIn. The workspace-bound checkpoint is still checked. `progress` separates unique shortlisted people, review rows, review people, review-only people, pending searches, partial/unknown coverage and unresolved companies. `collectionComplete` is false while any coverage gap remains; `nextActions` explains what is left. Unrestricted geography is labeled explicitly.
+
+For a manually verified legal-name alias, add `verifiedEmployerAliases: [{ "name": "Exact source employer name", "evidenceUrl": "https://official.example/legal" }]` to that company. The CLI records the evidence link but does not independently verify its contents. Aliases never bypass the numeric current-company ID check and are never inferred from similar names. Changing the brief requires a new output directory; no existing review rows are silently promoted.
+
 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.

package/dist/cli.js

@@ -15141,6 +15141,7 @@ program
     .requiredOption("--brief <path>", "JSON company list with verified company IDs and optional role criteria")
     .option("--out-dir <path>", "Private output directory and resume checkpoint", "./company-leads")
     .option("--max-searches <number>", "Maximum company/function searches this invocation", "12")
+    .option("--report-only", "Refresh saved research reports without contacting LinkedIn", false)
     .option("--browser-relay-port <number>", "Use the signed-in Codex browser through a loopback relay")
     .option("--dry-run", "Preview targeting and unresolved companies without network calls", false)
     .action(async (options) => {
@@ -15155,6 +15156,11 @@ program
     const orgId = session.user.orgId;
     if (!orgId)
         throw new Error("Choose a Salesprompter workspace before company research.");
+    if (options.reportOnly) {
+        const report = await runCompanyResearch({ brief, outDir: path.resolve(options.outDir), scope: `${session.apiBaseUrl}:${orgId}`, maxSearches: 0, search: async () => { throw new Error("Report-only cannot collect leads."); } });
+        printOutput({ status: "ok", reportOnly: true, progress: report.progress, nextActions: report.nextActions, output: report.output, outreachStarted: false, emailEnrichmentStarted: false });
+        return;
+    }
     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();
@@ -15187,7 +15193,7 @@ program
                 });
             },
         });
-        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 });
+        printOutput({ status: report.status, selected: report.selected.length, reviewRequired: report.review.length, progress: report.progress, nextActions: report.nextActions, 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

@@ -14,6 +14,7 @@ export const defaultDepartments = [
 const companySchema = z.object({
     name: z.string().trim().min(1),
     companyId: z.string().regex(/^[1-9]\d*$/).optional(),
+    verifiedEmployerAliases: z.array(z.object({ name: z.string().trim().min(1), evidenceUrl: z.url() }).strict()).optional(),
     maxContacts: z.number().int().min(1).max(100).default(20),
 }).strict();
 export const CompanyBriefSchema = z.object({
@@ -115,8 +116,9 @@ export function shortlistCompanyLeads(brief, results) {
                     continue;
                 }
                 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 ?? "" };
+                const alias = company.verifiedEmployerAliases?.find(a => words(a.name) === words(String(sourceCompanyName)));
+                const employerNameDiffers = Boolean(sourceCompanyName) && words(String(sourceCompanyName)) !== words(company.name) && !alias;
+                const row = { profileUrl: profile, fullName: p.fullName ?? "", title, companyId: company.companyId, companyName: company.name, sourceCompanyName, employerAliasEvidence: alias?.evidenceUrl ?? "", 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)) {
@@ -151,10 +153,32 @@ export function shortlistCompanyLeads(brief, results) {
             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, review, rejected, coverage, outreachStarted: false, emailEnrichmentStarted: false };
+    const jobs = planCompanySearches(brief);
+    const completed = jobs.filter(j => results[j.key]);
+    const incomplete = completed.filter(j => results[j.key].totalResults != null && results[j.key].people.length < results[j.key].totalResults);
+    const unknown = completed.filter(j => results[j.key].totalResults == null);
+    const selectedIds = new Set(selected.map(p => String(p.profileUrl)));
+    const reviewIds = new Set(review.map(p => String(p.profileUrl)));
+    const unresolved = brief.companies.filter(c => !c.companyId);
+    const progress = {
+        selectedPeople: selectedIds.size, reviewRows: review.length, reviewPeople: reviewIds.size,
+        reviewOnlyPeople: [...reviewIds].filter(id => !selectedIds.has(id)).length,
+        candidateRows: completed.reduce((n, j) => n + results[j.key].people.length, 0),
+        completedSearches: completed.length, totalSearches: jobs.length, remainingSearches: jobs.length - completed.length,
+        partialSearches: incomplete.length, unknownCoverageSearches: unknown.length, unresolvedCompanies: unresolved.length,
+        collectionComplete: completed.length === jobs.length && !unresolved.length && !incomplete.length && !unknown.length,
+        geography: brief.regionIds.length ? "explicit_regions" : "unrestricted",
+    };
+    const nextActions = [
+        ...(progress.remainingSearches ? ["Resume the unchanged brief and output directory to collect pending searches."] : []),
+        ...(unresolved.length ? ["Verify unresolved company identities; use a new output directory after changing the brief."] : []),
+        ...(incomplete.length || unknown.length ? ["Review partial or unknown search coverage before claiming exhaustive collection."] : []),
+        ...(review.length ? ["Review roles and employer names separately. Add only evidence-backed verifiedEmployerAliases; exact company ID checks still apply."] : []),
+    ];
+    return { selected, review, rejected, coverage, progress, nextActions, outreachStarted: false, emailEnrichmentStarted: false };
 }
 export function companyLeadCsv(rows) {
-    const columns = ["companyName", "companyId", "fullName", "title", "department", "profileUrl", "location", "sourceQueryUrl", "observedAt", "sourceCompanyName", "reason"];
+    const columns = ["companyName", "companyId", "fullName", "title", "department", "profileUrl", "location", "sourceQueryUrl", "observedAt", "sourceCompanyName", "reason", "employerAliasEvidence"];
     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";
@@ -204,6 +228,7 @@ async function runCompanyResearchLocked(input) {
             state.results[job.key] = await input.search(job);
             performed++;
             await save(checkpoint, JSON.stringify(state));
+            await publish();
         }
     }
     catch (e) {

package/dist/sales-navigator.js

@@ -423,7 +423,8 @@ function buildFilterBlock(filter) {
         if (typeof value.id === "string" && value.id.trim().length > 0) {
             segments.push(`id:${value.id}`);
         }
-        segments.push(`text:${encodeURIComponent(value.text)}`);
+        // Parentheses are Rest.li delimiters but encodeURIComponent leaves them raw.
+        segments.push(`text:${encodeURIComponent(value.text).replace(/[!'()*]/g, char => `%${char.charCodeAt(0).toString(16).toUpperCase()}`)}`);
         segments.push(`selectionType:${selectionType}`);
         return `(${segments.join(",")})`;
     })

package/package.json

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