salesprompter-cli 0.1.81 → 0.1.82

package/README.md

@@ -64,6 +64,8 @@ Research runs reuse that profile in background Chrome, execute the GET requests
 
 The default `--browser session` keeps the extension-credential route. Credentials load only for pending requests; on an auth failure it tries changed credentials for the same identity once. Add `--wait-for-session 300` for a bounded refresh wait. The optional Codex `--browser-relay-port` route still needs its external worker. Salesprompter workspace authentication applies in every mode.
 
+Ctrl+C, SIGTERM and terminal hangup stop Chrome research gracefully: completed searches stay saved, the owned browser closes, and the research lock is released before exit. Repeat the same command to resume only pending work. A forced kill or power loss cannot run cleanup; if a stale lock remains, confirm that its process stopped before removing only `.research-lock` as the CLI error explains.
+
 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.
 
 For a name-only list, the executable end-to-end research mode is:

package/dist/chrome-browser.js

@@ -12,6 +12,14 @@ export class ChromeResearchError extends Error {
         this.name = "ChromeResearchError";
     }
 }
+export class ChromeResearchInterruptedError extends Error {
+    signal;
+    constructor(signal) {
+        super("Research interrupted. Completed searches remain saved; rerun with the same --out-dir to resume.");
+        this.signal = signal;
+        this.name = "ChromeResearchInterruptedError";
+    }
+}
 export function validateChromeResearchUrl(value) {
     const url = new URL(value);
     if (url.origin !== ORIGIN || url.username || url.password || url.hash ||
@@ -48,6 +56,8 @@ export async function launchResearchChrome(visible = false) {
     try {
         return await puppeteer.launch({ channel: "chrome", userDataDir: profile, pipe: true, headless: !visible,
             timeout: 30000, protocolTimeout: 45000, defaultViewport: null,
+            // Let the command unwind its checkpoint/lock finally blocks before exiting.
+            handleSIGINT: false, handleSIGTERM: false, handleSIGHUP: false,
         });
     }
     catch {
@@ -79,13 +89,34 @@ export function createChromeResearchBrowser(options = {}, launch = launchResearc
     let initialization;
     let closed = false;
     let busy = false;
+    let browserClosing;
+    const signals = ["SIGINT", "SIGTERM", "SIGHUP"];
+    const signalHandlers = signals.map(signal => () => {
+        if (fatal instanceof ChromeResearchInterruptedError)
+            return;
+        fatal = new ChromeResearchInterruptedError(signal);
+        closed = true;
+        void closeOwnedBrowser().catch(() => { });
+    });
+    function closeOwnedBrowser() {
+        if (browser)
+            browserClosing ??= browser.close();
+        return browserClosing ?? Promise.resolve();
+    }
     const waitMs = options.loginWaitMs ?? 30000;
     if (!Number.isFinite(waitMs) || waitMs < 0 || waitMs > 3600000)
         throw new Error("Chrome login wait must be between 0 and 3600 seconds.");
     async function initialize() {
+        signals.forEach((signal, index) => process.on(signal, signalHandlers[index]));
         browser = await launch(options.visible);
+        if (closed) {
+            await closeOwnedBrowser();
+            throw fatal ?? new ChromeResearchError("Research Chrome connection was cancelled.");
+        }
         page = await browser.newPage();
         page.on("response", (response) => {
+            if (fatal)
+                return;
             const url = new URL(response.url());
             if (url.origin !== ORIGIN)
                 return;
@@ -114,6 +145,8 @@ export function createChromeResearchBrowser(options = {}, launch = launchResearc
             await page.goto(`${ORIGIN}/sales/search/people`, { waitUntil: "domcontentloaded", timeout: 30000 });
         }
         catch {
+            if (closed)
+                throw fatal ?? new ChromeResearchError("Research Chrome connection was cancelled.");
             if (!browser.connected)
                 throw new ChromeResearchError("Research Chrome closed before connecting.");
         }
@@ -121,7 +154,7 @@ export function createChromeResearchBrowser(options = {}, launch = launchResearc
         let noticeAt = Date.now() + 30000;
         while (!headers) {
             if (closed)
-                throw new ChromeResearchError("Research Chrome connection was cancelled.");
+                throw fatal ?? new ChromeResearchError("Research Chrome connection was cancelled.");
             if (fatal)
                 throw fatal;
             if (!browser.connected || page.isClosed())
@@ -142,7 +175,7 @@ export function createChromeResearchBrowser(options = {}, launch = launchResearc
     }
     async function ready() {
         if (closed)
-            throw new Error("Research Chrome is closed.");
+            throw fatal ?? new Error("Research Chrome is closed.");
         initialization ??= initialize();
         await initialization;
         if (fatal)
@@ -171,7 +204,7 @@ export function createChromeResearchBrowser(options = {}, launch = launchResearc
           const text = await response.text();
           if (text.length > 50 * 1024 * 1024) throw new Error('Research response exceeded 50 MB');
           return {status: response.status, text, redirected: response.redirected, retryAfter: response.headers.get('retry-after')};
-        })()`).catch(() => { throw new ChromeResearchError(`Chrome research request could not complete. ${LOGIN_HELP}`); });
+        })()`).catch(() => { throw fatal ?? new ChromeResearchError(`Chrome research request could not complete. ${LOGIN_HELP}`); });
                 const body = parseChromeResearchResult(result);
                 if (fatal)
                     throw fatal;
@@ -181,6 +214,18 @@ export function createChromeResearchBrowser(options = {}, launch = launchResearc
                 busy = false;
             }
         },
-        async close() { closed = true; await initialization?.catch(() => { }); await browser?.close(); headers = null; identity = undefined; },
+        async close() {
+            closed = true;
+            try {
+                await closeOwnedBrowser();
+                await initialization?.catch(() => { });
+                await closeOwnedBrowser();
+            }
+            finally {
+                signals.forEach((signal, index) => process.off(signal, signalHandlers[index]));
+                headers = null;
+                identity = undefined;
+            }
+        },
     };
 }

package/dist/cli.js

@@ -17,7 +17,7 @@ import { z } from "zod";
 import { AffiliateCopyReviewSchema, renderAffiliateCopyReview } from "./affiliate-copy.js";
 import { CompanyBriefSchema, planCompanySearches, runCompanyResearch } from "./company-leads.js";
 import { createLazySessionRecovery, waitForFreshSession, isFreshSessionForIdentity } from "./session-recovery.js";
-import { createChromeResearchBrowser } from "./chrome-browser.js";
+import { createChromeResearchBrowser, ChromeResearchInterruptedError } from "./chrome-browser.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";
@@ -19563,6 +19563,11 @@ async function closeGlobalHttpDispatcher() {
 }
 main()
     .catch((error) => {
+    if (error instanceof ChromeResearchInterruptedError) {
+        process.stderr.write(runtimeOutputOptions.json ? `${JSON.stringify({ status: "interrupted", message: error.message, signal: error.signal, resumable: true })}\n` : `${error.message}\n`);
+        process.exitCode = error.signal === "SIGINT" ? 130 : error.signal === "SIGTERM" ? 143 : 129;
+        return;
+    }
     if (error instanceof Error &&
         (error.message === "prompt cancelled" || error.message === "readline was closed")) {
         process.exitCode = 130;

package/package.json

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