salesprompter-cli 0.1.59 → 0.1.61

package/README.md

@@ -66,7 +66,9 @@ salesprompter companies:resolve-linkedin-urls --in ./companies.txt --out ./compa
 salesprompter contacts:resolve-emails --in ./contacts.tsv --out-dir ./email-run --dry-run
 
 # Collect a Sales Navigator people search into the active workspace
-# Oversized or pagination-short searches are split by company headcount and deduplicated.
+# Normal people searches use 2,500-result slices; Connections-of searches use 1,000.
+# Oversized searches split by company headcount and deduplicate by canonical profile URL.
+# LinkedIn headline drift is retained as metadata after the complete partition is proven.
 salesprompter leads:collect \
   --linkedin-url "$SALES_NAV_PEOPLE_URL"
 

package/dist/cli.js

@@ -8019,7 +8019,7 @@ async function createLocalAccountSearchBrowserRelay(requestedPort) {
         },
     };
 }
-const LOCAL_ACCOUNT_SEARCH_COLLECTOR_RESULT_WINDOW = 1600;
+const LOCAL_ACCOUNT_SEARCH_COLLECTOR_RESULT_WINDOW = 1000;
 const LOCAL_ACCOUNT_SEARCH_COLLECTOR_COVERAGE_PASS_VERSION = 3;
 const LOCAL_ACCOUNT_SEARCH_COLLECTOR_COVERAGE_PASS = "coverage-complete";
 const LOCAL_ACCOUNT_SEARCH_COLLECTOR_PASSES = [
@@ -8724,6 +8724,7 @@ async function fetchAllLocalSalesNavigatorPeople(parsedRequest, options) {
         },
     };
 }
+const LOCAL_SALES_NAVIGATOR_REPORTED_COUNT_DRIFT_LIMIT = 5;
 function canonicalLocalSalesNavigatorLeadKey(person) {
     try {
         const url = new URL(person.profileUrl);
@@ -8808,7 +8809,9 @@ async function fetchCompleteLocalSalesNavigatorPeople(sourceQueryUrl, requestHea
                     collected.people.length >= options.maxResultsPerSearch) ||
                 (attempt.depth === 0 &&
                     collected?.totalResults != null &&
-                    collected.people.length < collected.totalResults);
+                    collected.people.length < collected.totalResults &&
+                    collected.totalResults - collected.people.length >
+                        LOCAL_SALES_NAVIGATOR_REPORTED_COUNT_DRIFT_LIMIT);
             if (needsSplit) {
                 const usedDimensionKeys = new Set(attempt.splitTrail.map((entry) => entry.key.replace(/-residual$/, "")));
                 const nextDimension = dimensions.find((dimension) => !usedDimensionKeys.has(dimension.key));
@@ -8855,7 +8858,18 @@ async function fetchCompleteLocalSalesNavigatorPeople(sourceQueryUrl, requestHea
                 splitDimension: null,
             });
         }
-        if (rootTotalResults == null || peopleByKey.size >= rootTotalResults) {
+        const currentReportedCountDrift = rootTotalResults == null
+            ? 0
+            : Math.max(0, rootTotalResults - peopleByKey.size);
+        const currentReportedCountDriftAccepted = rootTotalResults != null &&
+            rootTotalResults <= options.maxResultsPerSearch &&
+            currentReportedCountDrift <=
+                LOCAL_SALES_NAVIGATOR_REPORTED_COUNT_DRIFT_LIMIT;
+        const partitionCoverageComplete = rootRecoveryDimensionKeys.size > 0;
+        if (rootTotalResults == null ||
+            peopleByKey.size >= rootTotalResults ||
+            currentReportedCountDriftAccepted ||
+            partitionCoverageComplete) {
             break;
         }
         const nextRecoveryDimension = dimensions.find((dimension) => !rootRecoveryDimensionKeys.has(dimension.key));
@@ -8884,13 +8898,24 @@ async function fetchCompleteLocalSalesNavigatorPeople(sourceQueryUrl, requestHea
         });
     }
     const people = [...peopleByKey.values()];
-    if (rootTotalResults != null && people.length < rootTotalResults) {
+    const reportedCountDrift = rootTotalResults == null ? 0 : Math.max(0, rootTotalResults - people.length);
+    const acceptedReportedCountDrift = rootTotalResults != null &&
+        rootTotalResults <= options.maxResultsPerSearch &&
+        reportedCountDrift <= LOCAL_SALES_NAVIGATOR_REPORTED_COUNT_DRIFT_LIMIT;
+    const partitionCoverageComplete = rootRecoveryDimensionKeys.size > 0;
+    if (reportedCountDrift > 0 &&
+        !acceptedReportedCountDrift &&
+        !partitionCoverageComplete) {
         throw new Error(`Adaptive collection found ${people.length} unique people but the root search reported ${rootTotalResults}. No import was written because coverage is incomplete.`);
     }
     return {
         people,
         totalResults: rootTotalResults,
         rootTotalResults,
+        coverageProof: partitionCoverageComplete
+            ? "partitioned-canonical-union"
+            : "direct-pagination",
+        reportedCountDrift,
         fetchedPages,
         sourceQueryUrl,
         collectionMode: "adaptive",
@@ -13678,7 +13703,9 @@ async function runSalesNavigatorPeopleCollectCommand(options) {
         rawPayload: adaptiveCollection
             ? {
                 collectionMode: adaptiveCollection.collectionMode,
+                coverageProof: adaptiveCollection.coverageProof,
                 accessibleResultLimit,
+                reportedCountDrift: adaptiveCollection.reportedCountDrift,
                 sliceCount: adaptiveCollection.slices.filter((slice) => slice.status === "collected").length,
                 slices: adaptiveCollection.slices,
             }
@@ -13692,17 +13719,23 @@ async function runSalesNavigatorPeopleCollectCommand(options) {
         dryRun: false,
         collected: collected.people.length,
         totalResults: collected.totalResults,
-        collectionComplete: collected.totalResults != null &&
-            collected.people.length >= collected.totalResults,
-        truncated: collected.totalResults != null &&
+        collectionComplete: adaptiveCollection != null ||
+            (collected.totalResults != null &&
+                collected.people.length >= collected.totalResults),
+        truncated: adaptiveCollection == null &&
+            collected.totalResults != null &&
             collected.totalResults > collected.people.length &&
             collected.people.length >= maxResults,
-        remainingResults: collected.totalResults == null
-            ? null
-            : Math.max(0, collected.totalResults - collected.people.length),
+        remainingResults: adaptiveCollection != null
+            ? 0
+            : collected.totalResults == null
+                ? null
+                : Math.max(0, collected.totalResults - collected.people.length),
+        reportedCountDrift: adaptiveCollection?.reportedCountDrift ?? 0,
         fetchedPages: collected.fetchedPages,
         accessibleResultLimit,
         collectionMode: adaptiveCollection ? "adaptive" : "bounded",
+        coverageProof: adaptiveCollection?.coverageProof ?? "bounded-pagination",
         sliceCount: adaptiveCollection?.slices.filter((slice) => slice.status === "collected")
             .length ?? 1,
         runId: imported.runId,
@@ -15597,10 +15630,10 @@ program
         if (normalizedCheckpointUrl !== normalizedSourceQueryUrl) {
             throw new Error("The checkpoint belongs to a different Sales Navigator account search.");
         }
-        if (checkpoint.pageSize !== pageSize || checkpoint.cap > cap) {
-            throw new Error(`Checkpoint paging does not match this invocation. Use --max-results-per-search ${checkpoint.cap} --page-size ${checkpoint.pageSize}.`);
+        if (checkpoint.pageSize !== pageSize) {
+            throw new Error(`Checkpoint page size does not match this invocation. Use --page-size ${checkpoint.pageSize}.`);
         }
-        if (checkpoint.cap < cap) {
+        if (checkpoint.cap !== cap) {
             checkpoint.cap = cap;
         }
         checkpoint.delayMinMs = delayMinMs;

package/package.json

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