salesprompter-cli 0.1.20 → 0.1.23

package/dist/cli.js

@@ -1,7 +1,8 @@
 #!/usr/bin/env node
 import { spawn } from "node:child_process";
-import { access, appendFile, mkdir } from "node:fs/promises";
+import { access, appendFile, mkdir, readFile, writeFile } from "node:fs/promises";
 import { createRequire } from "node:module";
+import os from "node:os";
 import path from "node:path";
 import { emitKeypressEvents } from "node:readline";
 import { createInterface } from "node:readline/promises";
@@ -13,12 +14,15 @@ import { clearAuthSession, loginWithBrowserConnect, loginWithDeviceFlow, loginWi
 import { buildBigQueryLeadLookupSql, executeBigQuerySql, normalizeBigQueryLeadRows, runBigQueryQuery, runBigQueryRows } from "./bigquery.js";
 import { AccountProfileSchema, EnrichedLeadSchema, IcpSchema, LeadSchema, ScoredLeadSchema, SyncTargetSchema } from "./domain.js";
 import { auditDomainDecisions, buildDomainfinderBacklogQueries, buildDomainfinderCandidatesSql, buildDomainfinderInputSql, buildDomainfinderWritebackSql, buildExistingDomainRepairSql, buildExistingDomainAuditQueries, compareDomainSelectionStrategies, selectBestDomains } from "./domainfinder.js";
+import { buildDeelSalesNavCsvHeader, buildDeelSalesNavCsvLines, isDeelRelevantSalesNavTitle, normalizeDeelSalesNavRow } from "./deel-salesnav.js";
+import { buildDeelOutreachExportSql, buildDeelOutreachPack, normalizeDeelOutreachRows } from "./deel-outreach.js";
 import { buildDirectPathLeadExportSql, normalizeDirectPathRows, segmentDirectPathRows } from "./direct-path.js";
 import { AccountLeadProvider, DryRunSyncProvider, HeuristicCompanyProvider, HeuristicEnrichmentProvider, HeuristicPeopleSearchProvider, HeuristicScoringProvider, RoutedSyncProvider } from "./engine.js";
 import { analyzeHistoricalQueries } from "./historical-queries.js";
 import { buildHistoricalVendorIcp, buildVendorIcp } from "./icp-templates.js";
 import { InstantlySyncProvider } from "./instantly.js";
 import { crawlLinkedInProductCategory } from "./linkedin-products.js";
+import { claimValidatedSalesNavigatorSessionCookieForCli } from "./linkedin-session.js";
 import { buildLeadlistsFunnelQueries } from "./leadlists-funnel.js";
 import { readJsonFile, splitCsv, writeJsonFile, writeTextFile } from "./io.js";
 import { buildSalesNavigatorCrawlPreview, createSalesNavigatorCrawlSeed, DEFAULT_SALES_NAVIGATOR_CRAWL_DIMENSIONS, buildSalesNavigatorPeopleSlice, deriveSalesNavigatorTitleQuerySeeds, expandSalesNavigatorCrawlAttempt, SalesNavigatorSliceTooBroadError } from "./sales-navigator.js";
@@ -357,6 +361,24 @@ function slugify(value) {
         .replace(/^-+|-+$/g, "")
         .replace(/-{2,}/g, "-");
 }
+function resolveSalesNavigatorSupabaseConfig(env = process.env) {
+    const supabaseUrl = env.SALESPROMPTER_SUPABASE_URL?.trim() || env.NEXT_PUBLIC_SUPABASE_URL?.trim() || "";
+    const supabaseServiceRoleKey = env.SUPABASE_SERVICE_ROLE_KEY?.trim() || "";
+    const missing = [];
+    if (supabaseUrl.length === 0) {
+        missing.push("SALESPROMPTER_SUPABASE_URL or NEXT_PUBLIC_SUPABASE_URL");
+    }
+    if (supabaseServiceRoleKey.length === 0) {
+        missing.push("SUPABASE_SERVICE_ROLE_KEY");
+    }
+    if (missing.length > 0) {
+        throw new Error(`Missing required environment variables for Sales Navigator Supabase export: ${missing.join(", ")}`);
+    }
+    return {
+        supabaseUrl,
+        supabaseServiceRoleKey
+    };
+}
 function normalizeDomainInput(value) {
     return value
         .trim()
@@ -439,6 +461,26 @@ function parseCompanyReference(value) {
         })
     };
 }
+function chunkArray(values, size) {
+    const chunks = [];
+    for (let index = 0; index < values.length; index += size) {
+        chunks.push(values.slice(index, index + size));
+    }
+    return chunks;
+}
+function extractSalesNavContactId(url) {
+    if (!url) {
+        return null;
+    }
+    try {
+        const parsed = new URL(url);
+        const segments = parsed.pathname.split("/").filter((segment) => segment.length > 0);
+        return segments.length > 0 ? segments[segments.length - 1] : null;
+    }
+    catch {
+        return null;
+    }
+}
 function writeWizardLine(message = "") {
     process.stdout.write(`${message}\n`);
 }
@@ -783,29 +825,10 @@ function summarizeSalesNavigatorQuery(url, appliedFilters) {
         appliedFilters
     };
 }
-function extractSalesNavigatorFilterTypes(url, appliedFilters) {
-    const filterTypes = new Set(appliedFilters.map((filter) => filter.type));
-    const decodedQuery = decodeSalesNavigatorQueryParam(url) ?? "";
-    for (const match of decodedQuery.matchAll(/type:([A-Z_]+)/g)) {
-        const value = match[1]?.trim();
-        if (value) {
-            filterTypes.add(value);
-        }
-    }
-    return [...filterTypes];
-}
 function shouldPreSplitSalesNavigatorRootSlice(slice, maxSplitDepth) {
-    if (slice.depth !== 0 || slice.splitTrail.length > 0) {
-        return false;
-    }
-    if (!nextSalesNavigatorSplitDimension(slice, maxSplitDepth)) {
-        return false;
-    }
-    const filterTypes = new Set(extractSalesNavigatorFilterTypes(slice.slicedQueryUrl, slice.appliedFilters));
-    if (!filterTypes.has("CURRENT_TITLE")) {
-        return false;
-    }
-    return !DEFAULT_SALES_NAVIGATOR_CRAWL_DIMENSIONS.some((dimension) => filterTypes.has(dimension.filterType));
+    void slice;
+    void maxSplitDepth;
+    return false;
 }
 function buildTraceHeaders(traceId) {
     return traceId ? { "X-Salesprompter-Trace-Id": traceId } : {};
@@ -1632,6 +1655,10 @@ async function runSalesNavigatorCrawlAttempt(session, attempt, options, context)
     if (totalResults === null || totalResults > attempt.maxResultsPerSearch) {
         return probeResult;
     }
+    const splitTriggerResults = Math.min(attempt.maxResultsPerSearch, SALES_NAVIGATOR_SPLIT_TRIGGER_RESULTS);
+    if (totalResults > splitTriggerResults) {
+        throw new SalesNavigatorSliceTooBroadError(`Sales Navigator slice produced ${totalResults} results, exceeding the split trigger of ${splitTriggerResults}.`, { totalResults });
+    }
     return await runSalesNavigatorExportWithAgentWait(session, {
         sourceQueryUrl: attempt.sourceQueryUrl,
         slicedQueryUrl: attempt.slicedQueryUrl,
@@ -1731,10 +1758,112 @@ function nextSalesNavigatorSplitDimension(slice, maxSplitDepth) {
     if (slice.depth >= maxSplitDepth) {
         return null;
     }
-    return DEFAULT_SALES_NAVIGATOR_CRAWL_DIMENSIONS[slice.depth] ?? null;
+    const usedDimensionKeys = new Set(slice.splitTrail.map((entry) => entry.key));
+    const orderedDimensions = getLearnedSalesNavigatorDimensionOrder();
+    return orderedDimensions.find((dimension) => !usedDimensionKeys.has(dimension.key)) ?? null;
 }
 const SALES_NAVIGATOR_COOKIE_RETRY_LIMIT = 8;
 const SALES_NAVIGATOR_RESULT_RETRY_LIMIT = 3;
+const SALES_NAVIGATOR_SPLIT_TRIGGER_RESULTS = 1500;
+const SALES_NAVIGATOR_FILTER_IMPACT_MIN_OBSERVATIONS = 3;
+let salesNavigatorFilterImpactModel = null;
+let salesNavigatorFilterImpactLoaded = false;
+function getSalesprompterConfigDir() {
+    const override = process.env.SALESPROMPTER_CONFIG_DIR?.trim();
+    if (override !== undefined && override.length > 0) {
+        return override;
+    }
+    return path.join(os.homedir(), ".config", "salesprompter");
+}
+function getSalesNavigatorFilterImpactPath() {
+    return path.join(getSalesprompterConfigDir(), "salesnav-filter-impact.json");
+}
+async function loadSalesNavigatorFilterImpactModel() {
+    if (salesNavigatorFilterImpactLoaded) {
+        return salesNavigatorFilterImpactModel;
+    }
+    salesNavigatorFilterImpactLoaded = true;
+    const filePath = getSalesNavigatorFilterImpactPath();
+    try {
+        const content = await readFile(filePath, "utf8");
+        const parsed = JSON.parse(content);
+        if (parsed && parsed.version === 1 && parsed.dimensions && typeof parsed.dimensions === "object") {
+            salesNavigatorFilterImpactModel = parsed;
+        }
+    }
+    catch {
+        salesNavigatorFilterImpactModel = null;
+    }
+    return salesNavigatorFilterImpactModel;
+}
+async function persistSalesNavigatorFilterImpactModel() {
+    if (!salesNavigatorFilterImpactModel) {
+        return;
+    }
+    const filePath = getSalesNavigatorFilterImpactPath();
+    await mkdir(path.dirname(filePath), { recursive: true });
+    await writeFile(filePath, `${JSON.stringify(salesNavigatorFilterImpactModel, null, 2)}\n`, "utf8");
+}
+function getLearnedSalesNavigatorDimensionOrder() {
+    const model = salesNavigatorFilterImpactModel;
+    if (!model) {
+        return DEFAULT_SALES_NAVIGATOR_CRAWL_DIMENSIONS;
+    }
+    const defaultIndex = new Map(DEFAULT_SALES_NAVIGATOR_CRAWL_DIMENSIONS.map((dimension, index) => [dimension.key, index]));
+    return [...DEFAULT_SALES_NAVIGATOR_CRAWL_DIMENSIONS].sort((left, right) => {
+        const leftStats = model.dimensions[left.key];
+        const rightStats = model.dimensions[right.key];
+        const leftReliable = (leftStats?.observations ?? 0) >= SALES_NAVIGATOR_FILTER_IMPACT_MIN_OBSERVATIONS;
+        const rightReliable = (rightStats?.observations ?? 0) >= SALES_NAVIGATOR_FILTER_IMPACT_MIN_OBSERVATIONS;
+        if (leftReliable && rightReliable) {
+            const delta = (leftStats?.avgResults ?? Number.POSITIVE_INFINITY) -
+                (rightStats?.avgResults ?? Number.POSITIVE_INFINITY);
+            if (delta !== 0) {
+                return delta;
+            }
+        }
+        else if (leftReliable !== rightReliable) {
+            return leftReliable ? -1 : 1;
+        }
+        return (defaultIndex.get(left.key) ?? 0) - (defaultIndex.get(right.key) ?? 0);
+    });
+}
+async function recordSalesNavigatorFilterImpactObservation(slice, totalResults, options) {
+    if (totalResults === null || totalResults === undefined || !Number.isFinite(totalResults)) {
+        return;
+    }
+    const learnedDimension = slice.splitTrail.at(-1)?.key ?? null;
+    if (!learnedDimension) {
+        return;
+    }
+    await loadSalesNavigatorFilterImpactModel();
+    if (!salesNavigatorFilterImpactModel) {
+        salesNavigatorFilterImpactModel = {
+            version: 1,
+            updatedAt: new Date().toISOString(),
+            dimensions: {}
+        };
+    }
+    const previous = salesNavigatorFilterImpactModel.dimensions[learnedDimension];
+    const observations = (previous?.observations ?? 0) + 1;
+    const sumResults = (previous?.sumResults ?? 0) + totalResults;
+    const avgResults = sumResults / observations;
+    salesNavigatorFilterImpactModel.dimensions[learnedDimension] = {
+        observations,
+        sumResults,
+        avgResults,
+        lastObservedAt: new Date().toISOString()
+    };
+    salesNavigatorFilterImpactModel.updatedAt = new Date().toISOString();
+    await persistSalesNavigatorFilterImpactModel();
+    await options?.logger?.log("salesnav.filter_impact.updated", {
+        dimensionKey: learnedDimension,
+        observations,
+        avgResults,
+        totalResults,
+        outcome: options?.outcome ?? null
+    });
+}
 function buildSalesNavigatorSplitChildren(slice, dimension) {
     const attempt = buildSalesNavigatorCrawlAttemptFromClaimedSlice(slice);
     return expandSalesNavigatorCrawlAttempt(attempt, dimension).map((child) => ({
@@ -1812,6 +1941,42 @@ function buildSalesNavigatorSliceFailureReport(slice, error, options) {
 function formatSalesNavigatorSplitTrail(splitTrail) {
     return splitTrail.map((entry) => `${entry.key}:${entry.value.text}`);
 }
+async function ensureSalesNavigatorSessionPoolReady(queryUrl, options) {
+    try {
+        await options.logger?.log("salesnav.session_pool.preflight.started", {
+            source: options.source,
+            queryUrl
+        });
+        const claimed = await claimValidatedSalesNavigatorSessionCookieForCli({
+            queryUrl,
+            source: options.source,
+            env: process.env
+        });
+        await options.logger?.log("salesnav.session_pool.preflight.completed", {
+            source: options.source,
+            queryUrl,
+            status: claimed ? "ok" : "skipped",
+            selectedSessionUserEmail: claimed?.userEmail ?? null,
+            selectedSessionUserHandle: claimed?.userHandle ?? null,
+            selectedSessionCookieSha256: claimed?.sessionCookieSha256 ?? null
+        });
+        return {
+            ready: true
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        await options.logger?.log("salesnav.session_pool.preflight.failed", {
+            source: options.source,
+            queryUrl,
+            error: message
+        });
+        return {
+            ready: false,
+            error: message
+        };
+    }
+}
 async function processSalesNavigatorClaimedCrawlSlice(session, jobId, slice, options) {
     let currentSession = session;
     await options.logger?.log("salesnav.crawl.slice.claimed", {
@@ -1869,7 +2034,8 @@ async function processSalesNavigatorClaimedCrawlSlice(session, jobId, slice, opt
                     error: `Pre-split by ${nextDimension.key}`,
                     errorCode: "presplit_root_title_query",
                     totalResults: null
-                }
+                },
+                forceSessionPoolRecheck: false
             };
         }
     }
@@ -1909,6 +2075,10 @@ async function processSalesNavigatorClaimedCrawlSlice(session, jobId, slice, opt
             })
         }, options.traceId);
         currentSession = reported.session;
+        await recordSalesNavigatorFilterImpactObservation(slice, result.totalResults ?? null, {
+            logger: options.logger,
+            outcome: "exported"
+        });
         await options.logger?.log("salesnav.crawl.slice.exported", {
             jobId,
             sliceId: slice.id,
@@ -1927,7 +2097,8 @@ async function processSalesNavigatorClaimedCrawlSlice(session, jobId, slice, opt
                 outcome: "exported",
                 runId: result.runId,
                 totalResults: result.totalResults ?? null
-            }
+            },
+            forceSessionPoolRecheck: false
         };
     }
     catch (error) {
@@ -1956,6 +2127,10 @@ async function processSalesNavigatorClaimedCrawlSlice(session, jobId, slice, opt
         });
         const reported = await reportSalesNavigatorCrawlSlice(currentSession, jobId, payload, options.traceId);
         currentSession = reported.session;
+        await recordSalesNavigatorFilterImpactObservation(slice, payload.totalResults ?? null, {
+            logger: options.logger,
+            outcome: payload.outcome
+        });
         await options.logger?.log("salesnav.crawl.slice.reported", {
             jobId,
             sliceId: slice.id,
@@ -1976,11 +2151,13 @@ async function processSalesNavigatorClaimedCrawlSlice(session, jobId, slice, opt
                 error: payload.error,
                 errorCode: payload.errorCode,
                 totalResults: payload.totalResults
-            }
+            },
+            forceSessionPoolRecheck: payload.errorCode === "invalid_session"
         };
     }
 }
 async function executeSalesNavigatorCrawlJob(session, jobId, options) {
+    await loadSalesNavigatorFilterImpactModel();
     let currentSession = session;
     let claimedSlices = 0;
     const seenSliceIds = new Set();
@@ -1992,11 +2169,56 @@ async function executeSalesNavigatorCrawlJob(session, jobId, options) {
     const inFlight = new Map();
     let nextSlot = 0;
     let noMoreClaimableWork = false;
+    let sessionPoolFailures = 0;
+    let nextSessionPoolRetryAt = 0;
+    let lastSessionPoolReadyAt = 0;
+    const sessionPoolReadinessCooldownMs = 120_000;
     while (true) {
         while (!noMoreClaimableWork && inFlight.size < parallelExports) {
             if (claimedSlices >= options.maxSlices) {
                 break;
             }
+            if (inFlight.size === 0) {
+                const now = Date.now();
+                if (now < nextSessionPoolRetryAt) {
+                    await delay(Math.max(0, nextSessionPoolRetryAt - now));
+                    continue;
+                }
+                if (now - lastSessionPoolReadyAt >= sessionPoolReadinessCooldownMs) {
+                    const readiness = await ensureSalesNavigatorSessionPoolReady(job?.sourceQueryUrl ?? "https://www.linkedin.com/sales/search/people", {
+                        logger: options.logger,
+                        source: "cli_salesnav_crawl_preflight"
+                    });
+                    if (!readiness.ready) {
+                        sessionPoolFailures += 1;
+                        idlePollCount += 1;
+                        const waitSeconds = Math.min(120, 10 * Math.max(1, sessionPoolFailures));
+                        nextSessionPoolRetryAt = Date.now() + waitSeconds * 1000;
+                        await options.logger?.log("salesnav.crawl.session_pool.waiting", {
+                            jobId,
+                            idlePollCount,
+                            idleMaxPolls: options.idleMaxPolls,
+                            sessionPoolFailures,
+                            waitSeconds,
+                            error: readiness.error
+                        });
+                        if (idlePollCount >= options.idleMaxPolls) {
+                            lastOutcome = {
+                                outcome: "terminal_failed",
+                                error: readiness.error ??
+                                    `Sales Navigator session pool stayed unavailable for ${options.idleMaxPolls} checks.`,
+                                errorCode: "blocked_no_valid_salesnav_session"
+                            };
+                            noMoreClaimableWork = true;
+                            break;
+                        }
+                        continue;
+                    }
+                    sessionPoolFailures = 0;
+                    nextSessionPoolRetryAt = 0;
+                    lastSessionPoolReadyAt = Date.now();
+                }
+            }
             const claimed = await claimNextSalesNavigatorCrawlSlice(currentSession, jobId, options.traceId);
             currentSession = claimed.session;
             job = claimed.value.job;
@@ -2089,6 +2311,10 @@ async function executeSalesNavigatorCrawlJob(session, jobId, options) {
         job = completed.value.job;
         activeSlice = completed.value.activeSlice;
         lastOutcome = completed.value.lastOutcome;
+        if (completed.value.forceSessionPoolRecheck) {
+            lastSessionPoolReadyAt = 0;
+            nextSessionPoolRetryAt = 0;
+        }
     }
     if (!job) {
         const status = await getSalesNavigatorCrawlStatus(currentSession, jobId, options.traceId);
@@ -3078,6 +3304,257 @@ program
     }
     printOutput(payload);
 });
+program
+    .command("salesnav:deel-locale-export")
+    .description("Export the Supabase Sales Navigator Deel corpus into German-vs-English outreach backlog files.")
+    .option("--org-id <id>", "Workspace org id. Defaults to the active CLI org.")
+    .option("--limit <number>", "Maximum number of Supabase rows to process", "250000")
+    .option("--page-size <number>", "Supabase page size per request", "1000")
+    .option("--title-filter <mode>", "deel-hr|all", "deel-hr")
+    .requiredOption("--out-dir <path>", "Output directory for summary and locale CSV files")
+    .action(async (options) => {
+    const limit = z.coerce.number().int().min(1).max(500000).parse(options.limit);
+    const pageSize = z.coerce.number().int().min(1).max(1000).parse(options.pageSize);
+    const titleFilter = z.enum(["deel-hr", "all"]).parse(options.titleFilter);
+    let sessionOrgId = null;
+    if (!shouldBypassAuth()) {
+        const session = await requireAuthSession();
+        sessionOrgId = session.user.orgId ?? null;
+    }
+    const orgId = resolveSalesNavigatorHistoricalBackfillOrgId({
+        explicitOrgId: options.orgId,
+        env: process.env,
+        sessionOrgId
+    });
+    const config = resolveSalesNavigatorSupabaseConfig(process.env);
+    const supabase = createClient(config.supabaseUrl, config.supabaseServiceRoleKey, {
+        auth: { persistSession: false }
+    });
+    const countResponse = await supabase
+        .from("linkedin_sales_nav_people")
+        .select("id", { count: "exact", head: true })
+        .eq("org_id", orgId);
+    if (countResponse.error) {
+        throw new Error(`Failed to count linkedin_sales_nav_people rows: ${countResponse.error.message}`);
+    }
+    const totalInOrg = countResponse.count ?? 0;
+    const totalToProcess = Math.min(totalInOrg, limit);
+    const baseSlug = `deel-salesnav-${slugify(orgId) || "workspace"}`;
+    const deCsvPath = path.join(options.outDir, `${baseSlug}-de.csv`);
+    const enCsvPath = path.join(options.outDir, `${baseSlug}-en.csv`);
+    const summaryPath = path.join(options.outDir, `${baseSlug}-summary.json`);
+    const samplesPath = path.join(options.outDir, `${baseSlug}-samples.json`);
+    await mkdir(options.outDir, { recursive: true });
+    await writeFile(deCsvPath, `${buildDeelSalesNavCsvHeader()}\n`, "utf8");
+    await writeFile(enCsvPath, `${buildDeelSalesNavCsvHeader()}\n`, "utf8");
+    const localeCounts = { de: 0, en: 0 };
+    let titleMatchedCount = 0;
+    let titleFilteredOutCount = 0;
+    const fieldCounts = {
+        firstName: 0,
+        lastName: 0,
+        fullName: 0,
+        companyName: 0,
+        companyNameCleaned: 0,
+        preferredProfileUrl: 0,
+        linkedinProfileUrl: 0,
+        companyLinkedInHandle: 0,
+        location: 0,
+        companyLocation: 0,
+        searchQuery: 0
+    };
+    const signalFieldCounts = {
+        location: 0,
+        companyLocation: 0,
+        searchQuery: 0,
+        none: 0
+    };
+    const titleCounts = new Map();
+    const samples = {
+        de: [],
+        en: []
+    };
+    const selectFields = [
+        "id",
+        "org_id",
+        "run_id",
+        "sales_nav_profile_url",
+        "linkedin_profile_url",
+        "default_profile_url",
+        "full_name",
+        "first_name",
+        "last_name",
+        "company_name",
+        "company_url",
+        "regular_company_url",
+        "title",
+        "industry",
+        "location",
+        "company_location",
+        "search_query",
+        "scraped_at"
+    ].join(", ");
+    let processed = 0;
+    let lastSeenId = null;
+    while (processed < totalToProcess) {
+        let query = supabase
+            .from("linkedin_sales_nav_people")
+            .select(selectFields)
+            .eq("org_id", orgId)
+            .order("id", { ascending: true })
+            .limit(Math.min(pageSize, totalToProcess - processed));
+        if (lastSeenId) {
+            query = query.gt("id", lastSeenId);
+        }
+        const response = await query;
+        if (response.error) {
+            throw new Error(`Failed to read linkedin_sales_nav_people rows after ${lastSeenId ?? "start"}: ${response.error.message}`);
+        }
+        const pageRows = (response.data ?? []);
+        if (pageRows.length === 0) {
+            break;
+        }
+        const relevantRows = pageRows.filter((row) => {
+            if (titleFilter === "all") {
+                titleMatchedCount += 1;
+                return true;
+            }
+            const matches = isDeelRelevantSalesNavTitle(row.title);
+            if (matches) {
+                titleMatchedCount += 1;
+                return true;
+            }
+            titleFilteredOutCount += 1;
+            return false;
+        });
+        const preparedRows = relevantRows.map((row) => normalizeDeelSalesNavRow(row));
+        const deRows = preparedRows.filter((row) => row.language === "de");
+        const enRows = preparedRows.filter((row) => row.language === "en");
+        if (deRows.length > 0) {
+            await appendFile(deCsvPath, `${buildDeelSalesNavCsvLines(deRows)}\n`, "utf8");
+        }
+        if (enRows.length > 0) {
+            await appendFile(enCsvPath, `${buildDeelSalesNavCsvLines(enRows)}\n`, "utf8");
+        }
+        for (const row of preparedRows) {
+            localeCounts[row.language] += 1;
+            if (row.signalFields.length === 0) {
+                signalFieldCounts.none += 1;
+            }
+            else {
+                for (const field of row.signalFields) {
+                    if (field === "location") {
+                        signalFieldCounts.location += 1;
+                    }
+                    else if (field === "companyLocation") {
+                        signalFieldCounts.companyLocation += 1;
+                    }
+                    else if (field === "searchQuery") {
+                        signalFieldCounts.searchQuery += 1;
+                    }
+                }
+            }
+            if (row.firstName)
+                fieldCounts.firstName += 1;
+            if (row.lastName)
+                fieldCounts.lastName += 1;
+            if (row.fullName)
+                fieldCounts.fullName += 1;
+            if (row.companyName)
+                fieldCounts.companyName += 1;
+            if (row.companyNameCleaned)
+                fieldCounts.companyNameCleaned += 1;
+            if (row.preferredProfileUrl)
+                fieldCounts.preferredProfileUrl += 1;
+            if (row.linkedinProfileUrl)
+                fieldCounts.linkedinProfileUrl += 1;
+            if (row.companyLinkedInHandle)
+                fieldCounts.companyLinkedInHandle += 1;
+            if (row.location)
+                fieldCounts.location += 1;
+            if (row.companyLocation)
+                fieldCounts.companyLocation += 1;
+            if (row.searchQuery)
+                fieldCounts.searchQuery += 1;
+            if (row.title) {
+                titleCounts.set(row.title, (titleCounts.get(row.title) ?? 0) + 1);
+            }
+            if (samples[row.language].length < 25) {
+                samples[row.language].push(row);
+            }
+        }
+        processed += pageRows.length;
+        lastSeenId = pageRows[pageRows.length - 1]?.id ?? lastSeenId;
+        const completedPages = Math.ceil(processed / pageSize);
+        if (completedPages === 1 || processed === totalToProcess || completedPages % 10 === 0) {
+            writeProgress(`Processed ${processed}/${totalToProcess} Deel Sales Navigator rows for org ${orgId}; kept ${titleMatchedCount} after ${titleFilter} title filtering.`);
+        }
+    }
+    const keptTotal = localeCounts.de + localeCounts.en;
+    const percentage = (count, base = keptTotal) => base > 0 ? Number(((count / base) * 100).toFixed(2)) : 0;
+    const payload = {
+        status: "ok",
+        vendor: "deel",
+        source: "salesnav-supabase",
+        recommendedRouting: "separate-campaigns-by-language",
+        orgId,
+        totalInOrg,
+        scanned: processed,
+        titleFilter,
+        keptAfterTitleFilter: keptTotal,
+        titleMatchedCount,
+        titleFilteredOutCount,
+        truncatedByLimit: totalInOrg > processed,
+        localeCounts,
+        localePercentages: {
+            de: percentage(localeCounts.de),
+            en: percentage(localeCounts.en)
+        },
+        fieldCoverage: {
+            firstName: { count: fieldCounts.firstName, percentage: percentage(fieldCounts.firstName) },
+            lastName: { count: fieldCounts.lastName, percentage: percentage(fieldCounts.lastName) },
+            fullName: { count: fieldCounts.fullName, percentage: percentage(fieldCounts.fullName) },
+            companyName: { count: fieldCounts.companyName, percentage: percentage(fieldCounts.companyName) },
+            companyNameCleaned: {
+                count: fieldCounts.companyNameCleaned,
+                percentage: percentage(fieldCounts.companyNameCleaned)
+            },
+            preferredProfileUrl: {
+                count: fieldCounts.preferredProfileUrl,
+                percentage: percentage(fieldCounts.preferredProfileUrl)
+            },
+            linkedinProfileUrl: {
+                count: fieldCounts.linkedinProfileUrl,
+                percentage: percentage(fieldCounts.linkedinProfileUrl)
+            },
+            companyLinkedInHandle: {
+                count: fieldCounts.companyLinkedInHandle,
+                percentage: percentage(fieldCounts.companyLinkedInHandle)
+            },
+            location: { count: fieldCounts.location, percentage: percentage(fieldCounts.location) },
+            companyLocation: {
+                count: fieldCounts.companyLocation,
+                percentage: percentage(fieldCounts.companyLocation)
+            },
+            searchQuery: { count: fieldCounts.searchQuery, percentage: percentage(fieldCounts.searchQuery) }
+        },
+        signalFieldCounts,
+        topTitles: [...titleCounts.entries()].sort((a, b) => b[1] - a[1]).slice(0, 20),
+        campaignRecommendation: {
+            de: "Only rows with clear DACH signals should enter the German Deel campaign.",
+            en: "Route everything else to a separate English Deel campaign. English is the safer fallback for ambiguous locales."
+        },
+        files: {
+            deCsv: deCsvPath,
+            enCsv: enCsvPath,
+            summary: summaryPath,
+            samples: samplesPath
+        }
+    };
+    await writeJsonFile(summaryPath, payload);
+    await writeJsonFile(samplesPath, samples);
+    printOutput(payload);
+});
 program
     .command("salesnav:crawl")
     .description("Adaptively split broad LinkedIn Sales Navigator people searches into exportable slices and store every finished slice through Salesprompter.")
@@ -3547,6 +4024,94 @@ program
         sqlOut: options.sqlOut ?? null
     });
 });
+program
+    .command("leadlists:deel-outreach:bq")
+    .description("Build Instantly-ready Deel outreach batches from leadPool_new with lead-list provenance, split into German vs English.")
+    .option("--market <market>", "global|europe|dach", "global")
+    .option("--limit <number>", "Max rows to export", "200000")
+    .option("--min-email-score <number>", "Minimum email score to keep", "70")
+    .requiredOption("--out-dir <path>", "Output directory for raw rows, packs, and locale batches")
+    .option("--sql-out <path>", "Optional file path for the generated SQL")
+    .option("--campaign-id <id>", "Fallback Instantly campaign id for all locales")
+    .option("--campaign-id-de <id>", "Instantly campaign id for German/DACH leads")
+    .option("--campaign-id-en <id>", "Instantly campaign id for English/non-DACH leads")
+    .option("--apply", "Create leads in Instantly instead of export-only mode", false)
+    .option("--allow-duplicates", "Do not skip emails already present in the Instantly campaign", false)
+    .action(async (options) => {
+    const market = z.enum(["global", "europe", "dach"]).parse(options.market);
+    const limit = z.coerce.number().int().min(1).max(500000).parse(options.limit);
+    const minEmailScore = z.coerce.number().int().min(0).max(100).parse(options.minEmailScore);
+    const sql = buildDeelOutreachExportSql({ market, limit, minEmailScore });
+    if (options.sqlOut) {
+        await writeTextFile(options.sqlOut, `${sql}\n`);
+    }
+    const rows = await runBigQueryRows(sql, { maxRows: limit });
+    const normalizedRows = normalizeDeelOutreachRows(rows);
+    const pack = buildDeelOutreachPack(market, normalizedRows);
+    const baseSlug = `deel-outreach-${market}`;
+    const rawPath = path.join(options.outDir, `${baseSlug}-raw.json`);
+    const packPath = path.join(options.outDir, `${baseSlug}-pack.json`);
+    const allPath = path.join(options.outDir, `${baseSlug}-all.json`);
+    const dePath = path.join(options.outDir, `${baseSlug}-de.json`);
+    const enPath = path.join(options.outDir, `${baseSlug}-en.json`);
+    await writeJsonFile(rawPath, normalizedRows);
+    await writeJsonFile(packPath, pack);
+    await writeJsonFile(allPath, [...pack.locales.de, ...pack.locales.en]);
+    await writeJsonFile(dePath, pack.locales.de);
+    await writeJsonFile(enPath, pack.locales.en);
+    const syncResults = [];
+    const routes = [
+        {
+            locale: "de",
+            campaignId: options.campaignIdDe ?? options.campaignId,
+            leads: pack.locales.de
+        },
+        {
+            locale: "en",
+            campaignId: options.campaignIdEn ?? options.campaignId,
+            leads: pack.locales.en
+        }
+    ];
+    for (const route of routes) {
+        if (!route.campaignId || route.leads.length === 0) {
+            continue;
+        }
+        const result = await syncProvider.sync("instantly", route.leads, {
+            apply: Boolean(options.apply),
+            instantlyCampaignId: route.campaignId,
+            allowDuplicates: Boolean(options.allowDuplicates)
+        });
+        syncResults.push({
+            locale: route.locale,
+            campaignId: route.campaignId,
+            synced: result.synced,
+            skipped: result.skipped ?? 0,
+            dryRun: result.dryRun,
+            provider: result.provider ?? "instantly"
+        });
+    }
+    printOutput({
+        status: "ok",
+        vendor: "deel",
+        market,
+        limit,
+        minEmailScore,
+        rowCount: normalizedRows.length,
+        hitLimit: normalizedRows.length === limit,
+        localeCounts: pack.summary.localeCounts,
+        segmentCounts: pack.summary.segmentCounts,
+        averageEmailScoreByLocale: pack.summary.averageEmailScoreByLocale,
+        recommendedRouting: "separate-campaigns-by-language",
+        outDir: options.outDir,
+        raw: rawPath,
+        pack: packPath,
+        all: allPath,
+        german: dePath,
+        english: enPath,
+        syncResults,
+        sqlOut: options.sqlOut ?? null
+    });
+});
 program
     .command("leadlists:funnel:bq")
     .description("Build an upstream lead-list funnel report for a vendor/market.")