salesprompter-cli 0.1.52 → 0.1.54

package/README.md

@@ -72,7 +72,8 @@ salesprompter leads:collect \
 
 # Enrich one or more stored imports: Sales Navigator company -> official domain -> Hunter email
 # This updates workspace data only. It does not create or start outreach.
-# Stale imported company ids fall back to exact-name Account Search automatically.
+# Stale ids and raw legal-name misses use conservative exact-name recovery.
+# Hunter prefers official domains and can fall back to the exact company name.
 salesprompter leads:enrich-import \
   --run-id "$CLI_IMPORT_RUN_ID"
 

package/dist/cli.js

@@ -284,6 +284,8 @@ const CliImportHunterBatchResponseSchema = z.object({
     found: z.number().int().nonnegative(),
     notFound: z.number().int().nonnegative(),
     failed: z.number().int().nonnegative(),
+    domainLookups: z.number().int().nonnegative().default(0),
+    companyLookups: z.number().int().nonnegative().default(0),
     halted: z.boolean(),
     error: z.string().nullable()
 });
@@ -6756,7 +6758,11 @@ async function runCliImportEnrichmentAction(session, body, schema) {
     return value;
 }
 async function getCliImportCompanyCandidatesViaApp(session, input) {
-    return runCliImportEnrichmentAction(session, { action: "company-candidates", ...input }, CliImportCompanyCandidatesResponseSchema);
+    return runCliImportEnrichmentAction(session, {
+        action: "company-candidates",
+        ...input,
+        retry: input.retryMode === "all",
+    }, CliImportCompanyCandidatesResponseSchema);
 }
 async function saveCliImportCompanyProfilesViaApp(session, profiles) {
     return runCliImportEnrichmentAction(session, { action: "save-companies", profiles }, CliImportCompanySaveResponseSchema);
@@ -13446,6 +13452,7 @@ function normalizeCompanyWebsite(value) {
     }
 }
 const CLI_IMPORT_COMPANY_DECORATION = "(entityUrn,name,employeeCount,employeeDisplayCount,employeeCountRange,account(saved,noteCount,listCount,crmStatus,starred),pictureInfo,companyPictureDisplayImage,companyBackgroundCoverImage,description,industry,location,headquarters,website,revenueRange,crmOpportunities,flagshipCompanyUrl,employeeGrowthPercentages,employees*~fs_salesProfile(entityUrn,firstName,lastName,fullName,pictureInfo,profilePictureDisplayImage),specialties,type,yearFounded)";
+const CLI_IMPORT_COMPANY_RESOLUTION_VERSION = "cleaned-search-v1";
 class CliImportCompanySessionError extends Error {
     constructor(message) {
         super(message);
@@ -13591,24 +13598,39 @@ async function resolveCliImportCompanyIdentity(candidate, config, timeoutMs, bro
     let account = null;
     if (!resolvedCompanyId && candidate.companyName) {
         accountSearchUsed = true;
-        const queryUrl = buildCliImportAccountSearchUrl(candidate.companyName);
-        const response = await fetchCliImportSalesNavigatorJson({
-            url: queryUrl,
-            config,
-            browserRelay,
-            timeoutMs,
-            label: `Sales Navigator Account Search for ${candidate.companyName}`,
+        const seenSearchNames = new Set();
+        const searchNames = [
+            candidate.companyName,
+            aggressivelyCleanLookupCompanyName(candidate.companyName),
+        ].filter((value) => {
+            const key = normalizeLookupWhitespace(value).toLowerCase();
+            if (!key || seenSearchNames.has(key))
+                return false;
+            seenSearchNames.add(key);
+            return true;
         });
-        if (response.status < 200 || response.status >= 300) {
-            throw new Error(`Sales Navigator Account Search for ${candidate.companyName} returned ${response.status}.`);
-        }
-        if (response.status >= 200 && response.status < 300 && response.body) {
-            const accounts = extractLocalSalesNavigatorElements(response.body)
-                .map((element) => typeof element === "object" && element !== null && !Array.isArray(element)
-                ? normalizeLocalSalesNavigatorAccount(element, queryUrl)
-                : null)
-                .filter((value) => value !== null);
-            account = exactCliImportAccountMatch(candidate, accounts);
+        for (const searchName of searchNames) {
+            const queryUrl = buildCliImportAccountSearchUrl(searchName);
+            const response = await fetchCliImportSalesNavigatorJson({
+                url: queryUrl,
+                config,
+                browserRelay,
+                timeoutMs,
+                label: `Sales Navigator Account Search for ${searchName}`,
+            });
+            if (response.status < 200 || response.status >= 300) {
+                throw new Error(`Sales Navigator Account Search for ${searchName} returned ${response.status}.`);
+            }
+            if (response.body) {
+                const accounts = extractLocalSalesNavigatorElements(response.body)
+                    .map((element) => typeof element === "object" && element !== null && !Array.isArray(element)
+                    ? normalizeLocalSalesNavigatorAccount(element, queryUrl)
+                    : null)
+                    .filter((value) => value !== null);
+                account = exactCliImportAccountMatch(candidate, accounts);
+            }
+            if (account)
+                break;
         }
         salesNavCompanyUrl =
             (typeof account?.salesNavCompanyUrl === "string"
@@ -13708,6 +13730,7 @@ function buildCliImportCompanyProfile(resolution, detail, input) {
             error: input.error ??
                 `Sales Navigator company detail returned ${input.status || "no result"}`,
             rawPayload: {
+                resolutionVersion: CLI_IMPORT_COMPANY_RESOLUTION_VERSION,
                 accountSearchUsed: resolution.accountSearchUsed,
                 httpStatus: input.status,
             },
@@ -13780,6 +13803,7 @@ function buildCliImportCompanyProfile(resolution, detail, input) {
         status: "enriched",
         error: null,
         rawPayload: {
+            resolutionVersion: CLI_IMPORT_COMPANY_RESOLUTION_VERSION,
             accountSearchUsed: resolution.accountSearchUsed,
             httpStatus: input.status,
             detail,
@@ -13791,6 +13815,12 @@ async function runSalesNavigatorImportEnrichmentCommand(options) {
     if (options.companiesOnly && options.hunterOnly) {
         throw new Error("Use either --companies-only or --hunter-only, not both.");
     }
+    if (options.retryCompanies && options.retryNotFoundCompanies) {
+        throw new Error("Use either --retry-companies or --retry-not-found-companies, not both.");
+    }
+    if (options.retryEmails && options.retryFailedEmails) {
+        throw new Error("Use either --retry-emails or --retry-failed-emails, not both.");
+    }
     const runIds = Array.from(new Set(options.runId.map((runId) => z.string().uuid().parse(runId))));
     const companyTimeoutMs = z.coerce.number().int().min(1000).max(120000).parse(options.companyTimeoutMs);
     const companyDelayMinMs = z.coerce.number().int().min(0).parse(options.companyDelayMinMs);
@@ -13805,13 +13835,24 @@ async function runSalesNavigatorImportEnrichmentCommand(options) {
     const session = await requireAuthSession();
     const startedAt = new Date().toISOString();
     const initialStatus = await getCliImportEnrichmentStatusViaApp(session, runIds);
+    const companyRetryMode = options.retryCompanies
+        ? "all"
+        : options.retryNotFoundCompanies
+            ? "not_found"
+            : "default";
+    const retryStatuses = options.retryEmails
+        ? ["not_found", "failed"]
+        : options.retryFailedEmails
+            ? ["failed"]
+            : [];
     if (options.dryRun) {
         const companyCandidates = options.hunterOnly
             ? []
             : (await getCliImportCompanyCandidatesViaApp(session, {
                 runIds,
                 limit: 1000,
-                retry: options.retryCompanies
+                retryMode: companyRetryMode,
+                resolutionVersion: CLI_IMPORT_COMPANY_RESOLUTION_VERSION,
             })).companies.slice(0, maxCompanies || undefined);
         return {
             status: "ok",
@@ -13819,6 +13860,9 @@ async function runSalesNavigatorImportEnrichmentCommand(options) {
             runIds,
             initial: initialStatus,
             companyCandidates: companyCandidates.length,
+            companyRetryMode,
+            hunterCompanyFallback: options.hunterCompanyFallback,
+            retryEmailStatuses: retryStatuses,
             next: options.companiesOnly
                 ? "company enrichment only"
                 : options.hunterOnly
@@ -13838,7 +13882,8 @@ async function runSalesNavigatorImportEnrichmentCommand(options) {
         const companyCandidates = (await getCliImportCompanyCandidatesViaApp(session, {
             runIds,
             limit: 1000,
-            retry: options.retryCompanies
+            retryMode: companyRetryMode,
+            resolutionVersion: CLI_IMPORT_COMPANY_RESOLUTION_VERSION,
         })).companies.slice(0, maxCompanies || undefined);
         companies.selected = companyCandidates.length;
         if (companyCandidates.length > 0) {
@@ -13887,12 +13932,18 @@ async function runSalesNavigatorImportEnrichmentCommand(options) {
                             for (const companyId of ids) {
                                 const detail = cliImportCompanyRecord(results[companyId]);
                                 const statusValue = statuses[companyId];
+                                const errorValue = errors[companyId];
+                                const errorRecord = cliImportCompanyRecord(errorValue);
+                                const errorStatusValue = errorRecord?.status ?? errorRecord?.code;
                                 const status = typeof statusValue === "number"
                                     ? statusValue
                                     : typeof statusValue === "string" && /^\d+$/.test(statusValue)
                                         ? Number(statusValue)
-                                        : response.status;
-                                const errorValue = errors[companyId];
+                                        : typeof errorStatusValue === "number"
+                                            ? errorStatusValue
+                                            : typeof errorStatusValue === "string" && /^\d+$/.test(errorStatusValue)
+                                                ? Number(errorStatusValue)
+                                                : response.status;
                                 detailCache.set(companyId, {
                                     detail,
                                     status,
@@ -14082,15 +14133,21 @@ async function runSalesNavigatorImportEnrichmentCommand(options) {
         processed: 0,
         found: 0,
         notFound: 0,
-        failed: 0
+        failed: 0,
+        domainLookups: 0,
+        companyLookups: 0,
     };
     if (!options.companiesOnly) {
-        const retryBefore = options.retryEmails ? startedAt : null;
+        const retryBefore = options.retryEmails || options.retryFailedEmails
+            ? startedAt
+            : null;
         while (maxHunterBatches === 0 || hunter.batches < maxHunterBatches) {
             const batch = await runCliImportHunterBatchViaApp(session, {
                 runIds,
                 limit: hunterBatchSize,
-                retryBefore
+                retryBefore,
+                allowCompanyFallback: options.hunterCompanyFallback,
+                retryStatuses,
             });
             if (batch.selected === 0)
                 break;
@@ -14100,7 +14157,9 @@ async function runSalesNavigatorImportEnrichmentCommand(options) {
                 processed: hunter.processed + batch.processed,
                 found: hunter.found + batch.found,
                 notFound: hunter.notFound + batch.notFound,
-                failed: hunter.failed + batch.failed
+                failed: hunter.failed + batch.failed,
+                domainLookups: hunter.domainLookups + batch.domainLookups,
+                companyLookups: hunter.companyLookups + batch.companyLookups,
             };
             writeProgress(`Hunter enrichment: ${hunter.processed} checked, ${hunter.found} emails found.`);
             if (batch.halted) {
@@ -14239,9 +14298,12 @@ program
     .option("--hunter-batch-size <number>", "Hunter contacts checked per request", "100")
     .option("--max-hunter-batches <number>", "Maximum Hunter batches; 0 continues until no eligible people remain", "0")
     .option("--companies-only", "Stop after company profiles and domains", false)
-    .option("--hunter-only", "Skip company lookup and use already stored domains", false)
-    .option("--retry-companies", "Retry previously saved company failures", false)
-    .option("--retry-emails", "Retry previously checked unresolved emails once", false)
+    .option("--hunter-only", "Skip company lookup and use stored domains or company-name fallback", false)
+    .option("--retry-companies", "Refresh every previously saved company profile", false)
+    .option("--retry-not-found-companies", "Retry only previous exact company misses with the current resolver", false)
+    .option("--retry-emails", "Retry previous Hunter misses and failures once", false)
+    .option("--retry-failed-emails", "Retry only previous Hunter failures once", false)
+    .option("--no-hunter-company-fallback", "Require a verified domain and skip Hunter company-name fallback")
     .option("--dry-run", "Show scope without LinkedIn or Hunter requests", false)
     .option("--out <path>", "Optional JSON result path")
     .action(async (options) => {

package/package.json

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