extension 4.1.21 → 4.1.23

package/dist/cli.cjs

@@ -230,7 +230,7 @@ var __webpack_modules__ = {
                     (0, _helpers_messaging__rspack_import_3._w)(_messages__rspack_import_5.io());
                 }
             } catch  {
-                const provenanceNote = _messages__rspack_import_5.xX(opts.binaryProvenance);
+                const provenanceNote = _messages__rspack_import_5.xX(opts.binaryProvenance, opts.browser);
                 (0, _helpers_messaging__rspack_import_3._w)(_messages__rspack_import_5.io());
                 (0, _helpers_messaging__rspack_import_3._w)((0, _helpers_messaging__rspack_import_3.Nr)({
                     rows: [
@@ -421,6 +421,7 @@ var __webpack_modules__ = {
         var pintor__rspack_import_8 = __webpack_require__("pintor");
         var pintor__rspack_import_8_default = /*#__PURE__*/ __webpack_require__.n(pintor__rspack_import_8);
         var _helpers_messaging__rspack_import_9 = __webpack_require__("./helpers/messaging.ts");
+        var _browser_family__rspack_import_10 = __webpack_require__("./browsers/browsers-lib/browser-family.ts");
         const require1 = (0, node_module__rspack_import_1.createRequire)(__rslib_import_meta_url__);
         function getLoggingPrefix(type) {
             return (0, _helpers_messaging__rspack_import_9.Pl)(type);
@@ -829,9 +830,15 @@ var __webpack_modules__ = {
             if (rest.startsWith(node_path__rspack_import_3.sep) || rest.startsWith('/')) return `~${rest}`;
             return raw;
         }
-        function binaryProvenanceNote(provenance) {
-            if ('pinned' === provenance) return '(pinned with --chromium-binary)';
-            return '';
+        function binaryProvenanceNote(provenance, browser) {
+            if ('pinned' !== provenance) return '';
+            return `(pinned with ${pinnedBinaryFlag(browser)})`;
+        }
+        function pinnedBinaryFlag(browser) {
+            const name = String(browser || '');
+            if ((0, _browser_family__rspack_import_10.M_)(name)) return '--gecko-binary';
+            if ('safari' === name || 'webkit-based' === name) return '--safari-binary';
+            return '--chromium-binary';
         }
         function runningInDevelopment(manifest, browser, message, browserVersionLine, updateSuffix, opts) {
             const capitalize = (str)=>str.charAt(0).toUpperCase() + str.slice(1);
@@ -867,7 +874,7 @@ var __webpack_modules__ = {
             const baseBrowserLabel = (0, _helpers_messaging__rspack_import_9.A6)(String(browser || 'unknown'), resolveBrowserVersionLine(browser, browserVersionLine, {
                 pinned: opts?.binaryProvenance === 'pinned'
             }));
-            const provenanceNote = binaryProvenanceNote(opts?.binaryProvenance);
+            const provenanceNote = binaryProvenanceNote(opts?.binaryProvenance, browser);
             const browserLabel = provenanceNote ? `${baseBrowserLabel} ${provenanceNote}` : baseBrowserLabel;
             const cleanId = String(id || '').trim();
             const includeExtensionId = opts?.includeExtensionId !== false;
@@ -1326,17 +1333,21 @@ var __webpack_modules__ = {
         var _messages__rspack_import_2 = __webpack_require__("./browsers/browsers-lib/messages.ts");
         const FORCE_KILL_GRACE_MS = 5000;
         const terminatedByUs = new WeakSet();
+        const terminatedPids = new Set();
         function wasTerminatedByUs(child) {
             return !!child && terminatedByUs.has(child);
         }
+        function wasPidTerminatedByUs(pid) {
+            return 'number' == typeof pid && terminatedPids.has(pid);
+        }
         function authorLog(line) {
             if (line && (0, _helpers_messaging__rspack_import_1._o)()) (0, _helpers_messaging__rspack_import_1._w)(line);
         }
-        function killWindowsTree(child, sync) {
-            if ('win32' !== process.platform) return;
+        function killWindowsTree(pid, sync) {
+            if ('win32' !== process.platform || !pid) return;
             const args = [
                 '/PID',
-                String(child.pid),
+                String(pid),
                 '/T',
                 '/F'
             ];
@@ -1351,10 +1362,37 @@ var __webpack_modules__ = {
                 }).on('error', ()=>{});
             } catch  {}
         }
+        function signalPid(pid, signal) {
+            try {
+                process.kill(pid, signal);
+                return true;
+            } catch  {
+                return false;
+            }
+        }
+        function gracefulTerminatePid(pid, browser) {
+            if (!pid || terminatedPids.has(pid)) return;
+            terminatedPids.add(pid);
+            killWindowsTree(pid, false);
+            authorLog(_messages__rspack_import_2.XH(browser));
+            signalPid(pid, 'SIGTERM');
+            const killTimer = setTimeout(()=>{
+                authorLog(_messages__rspack_import_2.AG(browser));
+                signalPid(pid, 'SIGKILL');
+            }, FORCE_KILL_GRACE_MS);
+            killTimer.unref?.();
+        }
+        function forceKillPidOnExit(pid, browser) {
+            if (!pid) return;
+            terminatedPids.add(pid);
+            killWindowsTree(pid, true);
+            authorLog(_messages__rspack_import_2.AG(browser));
+            signalPid(pid, 'SIGKILL');
+        }
         function gracefulTerminateChild(child, browser) {
             if (!child || child.killed) return;
             terminatedByUs.add(child);
-            killWindowsTree(child, false);
+            killWindowsTree(child.pid, false);
             authorLog(_messages__rspack_import_2.XH(browser));
             child.kill('SIGTERM');
             const killTimer = setTimeout(()=>{
@@ -1368,7 +1406,7 @@ var __webpack_modules__ = {
         function forceKillChildOnExit(child, browser) {
             if (!child) return;
             terminatedByUs.add(child);
-            killWindowsTree(child, true);
+            killWindowsTree(child.pid, true);
             try {
                 authorLog(_messages__rspack_import_2.AG(browser));
                 child.kill('SIGKILL');
@@ -1389,7 +1427,10 @@ var __webpack_modules__ = {
             $Y: ()=>forceKillChildOnExit,
             Df: ()=>gracefulTerminateChild,
             FA: ()=>isBenignSocketTeardown,
-            Op: ()=>wasTerminatedByUs
+            Op: ()=>wasTerminatedByUs,
+            PU: ()=>wasPidTerminatedByUs,
+            Qx: ()=>forceKillPidOnExit,
+            _T: ()=>gracefulTerminatePid
         });
     },
     "./browsers/browsers-lib/ready-message.ts" (__unused_rspack_module, __webpack_exports__, __webpack_require__) {
@@ -1433,6 +1474,7 @@ var __webpack_modules__ = {
                 const profilePath = String(details?.profilePath || '').trim();
                 if (profilePath) ready.profilePath = profilePath;
                 if ('number' == typeof details?.browserPid && Number.isFinite(details.browserPid)) ready.browserPid = details.browserPid;
+                if ('number' == typeof details?.launcherPid && Number.isFinite(details.launcherPid)) ready.launcherPid = details.launcherPid;
                 const extensionId = String(details?.extensionId || '').trim();
                 if (extensionId) ready.extensionId = extensionId;
                 const binary = String(details?.binary || '').trim();
@@ -2686,6 +2728,7 @@ var __webpack_modules__ = {
             '--enable-features=SidePanelUpdates',
             '--disable-features=DisableLoadExtensionCommandLineSwitch',
             '--disable-features=ExtensionDisableUnsupportedDeveloper',
+            '--disable-features=SafetyHubExtensionsOffStoreTrigger',
             '--enable-unsafe-extension-debugging',
             '--silent-debugger-extension-api'
         ];
@@ -3514,7 +3557,7 @@ var __webpack_modules__ = {
                         binaryProvenance
                     };
                     if (enableCdp) {
-                        const mod = await __webpack_require__.e(84).then(__webpack_require__.bind(__webpack_require__, "./browsers/run-chromium/chromium-launch/setup-cdp-after-launch.ts"));
+                        const mod = await __webpack_require__.e(597).then(__webpack_require__.bind(__webpack_require__, "./browsers/run-chromium/chromium-launch/setup-cdp-after-launch.ts"));
                         const CDP_SETUP_TIMEOUT_MS = 45000;
                         await Promise.race([
                             mod.setupCdpAfterLaunch(compilation, cdpConfig, chromiumConfig, pipeStreams),
@@ -3805,6 +3848,150 @@ var __webpack_modules__ = {
         var process_teardown = __webpack_require__("./browsers/browsers-lib/process-teardown.ts");
         var ready_message = __webpack_require__("./browsers/browsers-lib/ready-message.ts");
         var ready_stamp = __webpack_require__("./browsers/browsers-lib/ready-stamp.ts");
+        var external_node_child_process_ = __webpack_require__("node:child_process");
+        const PS_ROW = /^\s*(\d+)\s+(\d+)\s+(.*)$/;
+        const HELPER_PROCESS = /plugin-container|(^|\s)-contentproc(\s|$)|(^|\s)-childID(\s|$)|--type=/;
+        function runQuiet(bin, args) {
+            try {
+                const result = (0, external_node_child_process_.spawnSync)(bin, args, {
+                    encoding: 'utf-8',
+                    stdio: [
+                        'ignore',
+                        'pipe',
+                        'ignore'
+                    ],
+                    windowsHide: true,
+                    maxBuffer: 67108864
+                });
+                if (result.error || 0 !== result.status) return null;
+                return String(result.stdout || '');
+            } catch  {
+                return null;
+            }
+        }
+        function parseProcessRows(output) {
+            const rows = [];
+            for (const line of String(output || '').split(/\r?\n/)){
+                const match = PS_ROW.exec(line.replace(/\r$/, ''));
+                if (!match) continue;
+                const pid = Number(match[1]);
+                const ppid = Number(match[2]);
+                if (Number.isFinite(pid) && Number.isFinite(ppid)) rows.push({
+                    pid,
+                    ppid,
+                    command: match[3].trim()
+                });
+            }
+            return rows;
+        }
+        function appendLinuxProfileEnv(rows) {
+            return rows.map((row)=>{
+                try {
+                    const environ = external_node_fs_.readFileSync(`/proc/${row.pid}/environ`, 'utf-8');
+                    const entry = environ.split('\0').find((pair)=>pair.startsWith('XRE_PROFILE_PATH='));
+                    return entry ? {
+                        ...row,
+                        command: `${row.command} ${entry}`
+                    } : row;
+                } catch  {
+                    return row;
+                }
+            });
+        }
+        function listProcesses(platform = process.platform) {
+            if ('win32' === platform) {
+                const script = 'Get-CimInstance Win32_Process | ForEach-Object { "$($_.ProcessId) $($_.ParentProcessId) $($_.CommandLine)" }';
+                const output = runQuiet('powershell.exe', [
+                    '-NoProfile',
+                    '-NonInteractive',
+                    '-Command',
+                    script
+                ]);
+                return output ? parseProcessRows(output) : [];
+            }
+            if ('darwin' === platform) {
+                const output = runQuiet('ps', [
+                    '-axEo',
+                    'pid=,ppid=,command='
+                ]);
+                return output ? parseProcessRows(output) : [];
+            }
+            const output = runQuiet('ps', [
+                '-axo',
+                'pid=,ppid=,command='
+            ]);
+            const rows = output ? parseProcessRows(output) : [];
+            return 'linux' === platform ? appendLinuxProfileEnv(rows) : rows;
+        }
+        function resolve_live_pid_normalizePath(value) {
+            return String(value || '').replace(/\\/g, '/').toLowerCase();
+        }
+        function carriesProfile(command, profilePath) {
+            const haystack = resolve_live_pid_normalizePath(command);
+            const needle = resolve_live_pid_normalizePath(profilePath);
+            let from = 0;
+            for(;;){
+                const at = haystack.indexOf(needle, from);
+                if (at < 0) return false;
+                const before = 0 === at ? ' ' : haystack[at - 1];
+                const after = haystack[at + needle.length] ?? ' ';
+                if (/[\s="']/.test(before) && /[\s"']/.test(after)) return true;
+                from = at + 1;
+            }
+        }
+        function executableOf(command) {
+            const trimmed = resolve_live_pid_normalizePath(command).trim();
+            if (trimmed.startsWith('"')) {
+                const end = trimmed.indexOf('"', 1);
+                return end > 0 ? trimmed.slice(1, end) : trimmed;
+            }
+            const cut = trimmed.search(/\s(-|[a-z_][a-z0-9_]*=)/);
+            return cut > 0 ? trimmed.slice(0, cut) : trimmed;
+        }
+        function findLiveBrowserPid(input) {
+            const profilePath = String(input.profilePath || '').trim();
+            const binary = resolve_live_pid_normalizePath(input.binary).trim();
+            if (!profilePath || !binary) return null;
+            const candidates = input.rows.filter((row)=>executableOf(row.command) === binary && carriesProfile(row.command, profilePath) && !HELPER_PROCESS.test(row.command));
+            if (0 === candidates.length) return null;
+            const launcher = input.launcherPid ? candidates.find((row)=>row.pid === input.launcherPid) : void 0;
+            if (launcher) {
+                const twin = candidates.find((row)=>row.pid !== launcher.pid);
+                return twin ? twin.pid : launcher.pid;
+            }
+            const pids = new Set(candidates.map((row)=>row.pid));
+            const roots = candidates.filter((row)=>!pids.has(row.ppid));
+            return (roots[0] || candidates[0]).pid;
+        }
+        function isPidAlive(pid) {
+            if (!pid || !Number.isFinite(pid)) return false;
+            try {
+                process.kill(pid, 0);
+                return true;
+            } catch (error) {
+                return error?.code === 'EPERM';
+            }
+        }
+        async function resolveLiveBrowserPid(input) {
+            const list = input.list || listProcesses;
+            const attempts = Math.max(1, input.attempts ?? 6);
+            const intervalMs = input.intervalMs ?? 500;
+            const sleep = input.sleep || ((ms)=>new Promise((r)=>{
+                    setTimeout(r, ms).unref?.();
+                }));
+            let last = null;
+            for(let attempt = 0; attempt < attempts; attempt += 1){
+                last = findLiveBrowserPid({
+                    profilePath: input.profilePath,
+                    binary: input.binary,
+                    launcherPid: input.launcherPid,
+                    rows: list()
+                });
+                if (last && last !== input.launcherPid) break;
+                if (attempt < attempts - 1) await sleep(intervalMs);
+            }
+            return last;
+        }
         var runtime_options = __webpack_require__("./browsers/browsers-lib/runtime-options.ts");
         var shared_utils = __webpack_require__("./browsers/browsers-lib/shared-utils.ts");
         function parseFlatpakBinary(binary) {
@@ -4082,7 +4269,12 @@ var __webpack_modules__ = {
             for (const instance of activeInstances)attemptCleanup(instance);
         }
         function forceKillAllOnExit() {
-            for (const instance of activeInstances)(0, process_teardown.$Y)(instance.childRef(), instance.browser);
+            for (const instance of activeInstances){
+                const child = instance.childRef();
+                const livePid = instance.livePidRef();
+                (0, process_teardown.$Y)(child, instance.browser);
+                if (livePid && livePid !== child?.pid) (0, process_teardown.Qx)(livePid, instance.browser);
+            }
         }
         function firstBrowserLabel() {
             for (const instance of activeInstances)return instance.browser;
@@ -4114,10 +4306,11 @@ var __webpack_modules__ = {
                 process.exit(1);
             });
         }
-        function setupFirefoxProcessHandlers(browser, childRef, cleanupInstance) {
+        function setupFirefoxProcessHandlers(browser, childRef, cleanupInstance, livePidRef = ()=>null) {
             const instance = {
                 browser,
                 childRef,
+                livePidRef,
                 cleanupInstance,
                 isCleaningUp: false
             };
@@ -5203,7 +5396,6 @@ var __webpack_modules__ = {
             } catch  {}
             return controller;
         }
-        var external_node_child_process_ = __webpack_require__("node:child_process");
         var wsl_support = __webpack_require__("./browsers/browsers-lib/wsl-support.ts");
         const LINUX_FIREFOX_PATHS = [
             '/usr/bin/firefox',
@@ -5473,13 +5665,12 @@ var __webpack_modules__ = {
                         browserPid: this.child?.pid,
                         extensionId: this.extensionOutputPath ? (0, banner.MT)(this.extensionOutputPath) : void 0
                     });
-                    this.child.on('close', ()=>{
-                        (0, shared_utils.sW)(profilePath);
-                    });
                     this.wireChildLifecycle();
+                    this.trackLiveBrowserPid();
                     let ctrl;
                     try {
                         ctrl = await setupRdpAfterLaunch(this.host, compilation, debugPort);
+                        this.trackLiveBrowserPid(1);
                     } catch (error) {
                         const reason = error?.extensionLoadRefusedReason;
                         if (!reason) {
@@ -5574,24 +5765,89 @@ var __webpack_modules__ = {
                     if (process.env.VITEST || process.env.VITEST_WORKER_ID) throw new Error('Firefox startup timed out');
                     process.exit(1);
                 });
-                let disposeProcessHandlers;
                 child.on('close', (code)=>{
-                    if (this.watchTimeout) {
-                        clearTimeout(this.watchTimeout);
-                        this.watchTimeout = void 0;
-                    }
-                    if ((0, messaging._o)()) this.ctx.logger?.info?.(messages.Th(this.host.browser));
-                    if (!(0, process_teardown.Op)(child)) {
-                        this.ctx.logger?.error?.(`[browser] ${this.host.browser} exited (code ${code ?? 'unknown'}) without being asked to. The add-on may have been rejected or the browser crashed; the session cannot be driven.`);
-                        (0, ready_stamp.Wi)(this.extensionOutputPath, code);
-                    }
-                    this.cleanupInstance().catch((err)=>{
-                        if ((0, messaging._o)()) this.ctx.logger?.error?.(`[browser] Cleanup error on child close: ${err?.message || err}`);
-                    });
-                    disposeProcessHandlers?.();
+                    const expected = (0, process_teardown.Op)(child);
+                    if (!expected && this.adoptHandedOffBrowser()) return;
+                    this.onBrowserGone(code, expected);
                 });
                 this.pipeChildOutput(child);
-                disposeProcessHandlers = setupFirefoxProcessHandlers(this.host.browser, ()=>this.child, ()=>this.cleanupInstance());
+                this.disposeProcessHandlers = setupFirefoxProcessHandlers(this.host.browser, ()=>this.child, ()=>this.cleanupInstance(), ()=>this.livePid);
+            }
+            onBrowserGone(code, expected) {
+                if (this.browserGone) return;
+                this.browserGone = true;
+                if (this.watchTimeout) {
+                    clearTimeout(this.watchTimeout);
+                    this.watchTimeout = void 0;
+                }
+                if (this.liveExitWatcher) {
+                    clearInterval(this.liveExitWatcher);
+                    this.liveExitWatcher = void 0;
+                }
+                if (this.host.launchProfilePath) (0, shared_utils.sW)(this.host.launchProfilePath);
+                if ((0, messaging._o)()) this.ctx.logger?.info?.(messages.Th(this.host.browser));
+                if (!expected) {
+                    this.ctx.logger?.error?.(`[browser] ${this.host.browser} exited (code ${code ?? 'unknown'}) without being asked to. The add-on may have been rejected or the browser crashed; the session cannot be driven.`);
+                    (0, ready_stamp.Wi)(this.extensionOutputPath, code);
+                }
+                this.cleanupInstance().catch((err)=>{
+                    if ((0, messaging._o)()) this.ctx.logger?.error?.(`[browser] Cleanup error on child close: ${err?.message || err}`);
+                });
+                this.disposeProcessHandlers?.();
+                this.disposeProcessHandlers = void 0;
+            }
+            async trackLiveBrowserPid(attempts) {
+                const child = this.child;
+                const profilePath = this.host.launchProfilePath;
+                if (!child?.pid || !profilePath || this.browserGone) return;
+                try {
+                    const pid = await resolveLiveBrowserPid({
+                        profilePath,
+                        binary: child.spawnfile,
+                        launcherPid: child.pid,
+                        attempts
+                    });
+                    if (pid && pid !== child.pid && this.child === child) this.adoptLivePid(pid);
+                } catch  {}
+            }
+            adoptHandedOffBrowser() {
+                const profilePath = this.host.launchProfilePath;
+                const child = this.child;
+                if (!profilePath || !child || this.browserGone) return false;
+                try {
+                    const pid = this.livePid || findLiveBrowserPid({
+                        profilePath,
+                        binary: child.spawnfile,
+                        launcherPid: child.pid,
+                        rows: listProcesses()
+                    });
+                    if (!pid || pid === this.child?.pid || !isPidAlive(pid)) return false;
+                    this.adoptLivePid(pid);
+                    return true;
+                } catch  {
+                    return false;
+                }
+            }
+            adoptLivePid(pid) {
+                if (this.livePid === pid) return;
+                this.livePid = pid;
+                (0, ready_stamp.M)(this.extensionOutputPath, {
+                    browserPid: pid,
+                    launcherPid: this.child?.pid
+                });
+                if ((0, messaging._o)()) this.ctx.logger?.info?.(`[browser] ${this.host.browser} handed the session to pid ${pid} (launcher pid ${this.child?.pid}).`);
+                this.watchLivePidExit();
+            }
+            watchLivePidExit() {
+                if (this.liveExitWatcher) clearInterval(this.liveExitWatcher);
+                this.liveExitWatcher = setInterval(()=>{
+                    const pid = this.livePid;
+                    if (!pid || isPidAlive(pid)) return;
+                    clearInterval(this.liveExitWatcher);
+                    this.liveExitWatcher = void 0;
+                    this.onBrowserGone(null, (0, process_teardown.PU)(pid));
+                }, 1000);
+                this.liveExitWatcher.unref?.();
             }
             async retryAddonInstall(compilation, debugPort) {
                 try {
@@ -5626,6 +5882,7 @@ var __webpack_modules__ = {
             }
             async cleanupInstance() {
                 (0, process_teardown.Df)(this.child, this.host.browser);
+                if (this.livePid && this.livePid !== this.child?.pid) (0, process_teardown._T)(this.livePid, this.host.browser);
             }
             scheduleWatchTimeout() {
                 if (this.watchTimeout) return;
@@ -5660,6 +5917,10 @@ var __webpack_modules__ = {
                 firefox_launch_define_property(this, "child", null);
                 firefox_launch_define_property(this, "watchTimeout", void 0);
                 firefox_launch_define_property(this, "extensionOutputPath", void 0);
+                firefox_launch_define_property(this, "livePid", null);
+                firefox_launch_define_property(this, "liveExitWatcher", void 0);
+                firefox_launch_define_property(this, "browserGone", false);
+                firefox_launch_define_property(this, "disposeProcessHandlers", void 0);
                 this.host = host;
                 this.ctx = ctx;
             }
@@ -6474,6 +6735,10 @@ var __webpack_modules__ = {
             if ('debug' === type) return pintor__rspack_import_0_default().dim(pintor__rspack_import_0_default().gray(DEBUG_GLYPH));
             return pintor__rspack_import_0_default().gray(GLYPH);
         }
+        const ANSI_PATTERN = /\[[0-9;]*m/g;
+        function hasChannelPrefix(text) {
+            return String(text || '').replace(ANSI_PATTERN, '').trimStart().startsWith(GLYPH);
+        }
         const MACHINE_OUTPUT_VALUES = new Set([
             'json',
             'ndjson'
@@ -6506,7 +6771,8 @@ var __webpack_modules__ = {
             truncate (input, max = 800) {
                 const s = (()=>{
                     try {
-                        return 'string' == typeof input ? input : JSON.stringify(input);
+                        if ('string' == typeof input) return input;
+                        return JSON.stringify(input) ?? String(input);
                     } catch  {
                         return String(input);
                     }
@@ -6732,6 +6998,7 @@ var __webpack_modules__ = {
             Gg: ()=>humanError,
             Nr: ()=>card,
             Pl: ()=>prefix,
+            Qi: ()=>hasChannelPrefix,
             T_: ()=>artifactNoun,
             VR: ()=>isCardKeyClaimed,
             _o: ()=>isDebug,
@@ -7198,7 +7465,7 @@ var __webpack_modules__ = {
             return Math.min(Math.max(n, min), max);
         }
         const TEMPLATE_CORPUS_REPO = 'extension-js/examples';
-        const TEMPLATE_CORPUS_REF = '06d33e35894516a460409dca06d1614e291e6252';
+        const TEMPLATE_CORPUS_REF = 'f8087f012cf195cba9aa2e3c32fd5a6729da33f0';
         const TEMPLATE_CORPUS_SLUGS = [
             'action',
             'action-locales',
@@ -8077,8 +8344,13 @@ var __webpack_modules__ = {
         function availableCommandsBlock() {
             return COMMANDS.map(commandHelpEntry).join('\n\n');
         }
+        function projectCliVersionMismatch(running, declared, range, installCommand) {
+            return `${getLoggingPrefix('warn')} Running ${messages_code(`extension ${running}`)}, this project declares ${messages_code(`${declared}@${range}`)}.\nRun ${messages_code(installCommand)} so the project's own version runs.`;
+        }
         function unhandledError(err) {
-            const message = err instanceof Error ? err.stack || err.message : 'string' == typeof err ? err : messaging.Sc.truncate(err);
+            const rendered = err instanceof Error ? err.message : '';
+            if ((0, messaging.Qi)(rendered)) return rendered;
+            const message = err instanceof Error ? err.stack || err.message : 'string' == typeof err ? err : null == err ? '' : messaging.Sc.truncate(err);
             return `${getLoggingPrefix('error')} ${external_pintor_default().red(String(message || 'Unknown error'))}`;
         }
         function updateFailed(err) {
@@ -9404,6 +9676,102 @@ Cross-browser compatibility
             const values = String(raw).split(',').map((value)=>value.trim()).filter((value)=>value.length > 0);
             return values.length > 0 ? values : void 0;
         }
+        const external_semver_namespaceObject = require("semver");
+        var external_semver_default = /*#__PURE__*/ __webpack_require__.n(external_semver_namespaceObject);
+        const CLI_PACKAGES = [
+            'extension',
+            'extension-develop'
+        ];
+        const LOCKFILE_COMMANDS = [
+            [
+                'pnpm-lock.yaml',
+                'pnpm install'
+            ],
+            [
+                'yarn.lock',
+                'yarn install'
+            ],
+            [
+                'bun.lock',
+                'bun install'
+            ],
+            [
+                'bun.lockb',
+                'bun install'
+            ],
+            [
+                'deno.lock',
+                'deno install'
+            ],
+            [
+                'package-lock.json',
+                'npm install'
+            ]
+        ];
+        function installCommandFor(files) {
+            for (const [lockfile, command] of LOCKFILE_COMMANDS)if (files.includes(lockfile)) return command;
+            return 'npm install';
+        }
+        function declaredCliDependency(manifest) {
+            for (const field of [
+                manifest?.dependencies,
+                manifest?.devDependencies
+            ])for (const name of CLI_PACKAGES){
+                const range = field?.[name];
+                if ('string' == typeof range && range.length > 0) return {
+                    name,
+                    range
+                };
+            }
+            return null;
+        }
+        function isComparableRange(range) {
+            const trimmed = range.trim();
+            if (!trimmed || '*' === trimmed || 'latest' === trimmed) return false;
+            if (/^(workspace|file|link|git|github|npm):/i.test(trimmed)) return false;
+            if (/^[./]/.test(trimmed)) return false;
+            return null !== external_semver_default().validRange(trimmed);
+        }
+        function versionMismatch(input) {
+            const declared = declaredCliDependency(input.manifest);
+            if (!declared) return null;
+            if (!isComparableRange(declared.range)) return null;
+            if (!external_semver_default().valid(input.running)) return null;
+            const comparable = external_semver_default().prerelease(input.running) ? external_semver_default().coerce(input.running)?.version ?? input.running : input.running;
+            if (external_semver_default().satisfies(comparable, declared.range, {
+                includePrerelease: true
+            })) return null;
+            return {
+                declared: declared.name,
+                range: declared.range,
+                running: input.running
+            };
+        }
+        function readProjectManifest(projectPath) {
+            try {
+                return JSON.parse(external_node_fs_.readFileSync(external_node_path_.join(projectPath, 'package.json'), 'utf-8'));
+            } catch  {
+                return null;
+            }
+        }
+        function checkProjectCliVersion(projectPath, running) {
+            let files = [];
+            try {
+                files = external_node_fs_.readdirSync(projectPath);
+            } catch  {
+                return null;
+            }
+            if (!files.includes('package.json')) return null;
+            const mismatch = versionMismatch({
+                manifest: readProjectManifest(projectPath),
+                running
+            });
+            if (!mismatch) return null;
+            return {
+                ...mismatch,
+                command: installCommandFor(files)
+            };
+        }
         function registerBuildCommand(program) {
             program.command('build').arguments('[project-name]').usage('[path-to-remote-extension] [options]').description(commandDescriptions.build).option(`--browser <${BROWSER_TARGETS_HELP}>`, 'specify a browser/engine to run. Defaults to `chromium`. `safari` builds a Safari app via Xcode (macOS only)').option('--polyfill [boolean]', 'whether or not to apply the cross-browser polyfill. Defaults to `false`', parseOptionalBoolean).option('--no-polyfill', 'disable the cross-browser polyfill').option('--zip [boolean]', 'whether or not to compress the extension into a ZIP file. Defaults to `false`', parseOptionalBoolean).option('--zip-source [boolean]', 'whether or not to include the source files in the ZIP file. Defaults to `false`', parseOptionalBoolean).option('--zip-filename <string>', 'specify the name of the ZIP file. Defaults to the extension name and version').option('--silent [boolean]', 'suppress the build summary output. Defaults to `false`', parseOptionalBoolean).option('--addon-lint [boolean]', 'check Firefox builds against addons.mozilla.org rules with addons-linter when it is installed. Findings print as warnings. Defaults to `true`', parseOptionalBoolean).option('--no-addon-lint', 'skip the addons.mozilla.org lint of Firefox builds').option('--install [boolean]', '[internal] install project dependencies when missing', parseOptionalBoolean).option('--extensions <list>', 'comma-separated list of companion extensions or store URLs to load').option('--mode <development|production|none>', 'bundler mode override (also sets NODE_ENV). Defaults to `production`').option('--open [boolean]', 'open the built Safari app after packaging (safari targets only). Defaults to `false`', parseOptionalBoolean).option('--app-name <name>', 'override the Safari app name (safari targets only). Defaults to the manifest `name`').option('--bundle-id <reverse.dns>', 'set a user-owned Safari bundle identifier (safari targets only). Defaults to a generated dev.extensionjs.* id shared by every build of the same source, so set your own before the first submission').option('--development-team <id>', 'sign the Safari app with an Apple Developer team id (safari targets only). Without it the build is ad-hoc signed, which Safari loads locally with no per-launch toggle. Use a team id for a stable identity you can distribute').option('--macos-only [boolean]', 'generate a macOS-only Safari Xcode project (safari targets only). Pass `false` for a universal macOS + iOS project. Defaults to `true`', parseOptionalBoolean).option('--force-regenerate', 'regenerate the Safari Xcode project even when up to date (safari targets only)').option('--output <pretty|json>', 'result format. Use json for a schema-1 envelope on stdout').addOption(new external_commander_namespaceObject.Option('--debug', 'print maintainer diagnostics alongside normal output')).addOption(new external_commander_namespaceObject.Option('--author, --author-mode', 'deprecated alias for --debug').hideHelp()).action(async (pathOrRemoteUrl, { browser: cliBrowser, ...buildOptions })=>{
                 const browser = cliBrowser ?? await resolveConfigBrowser(pathOrRemoteUrl || process.cwd(), 'build') ?? 'chromium';
@@ -9471,6 +9839,8 @@ Cross-browser compatibility
                 }
                 const { extensionBuild } = await loadExtensionDevelopModule();
                 const asJson = isJsonOutput(buildOptions);
+                const cliVersion = checkProjectCliVersion(external_node_path_.resolve(pathOrRemoteUrl || process.cwd()), getCliPackageJson().version);
+                if (cliVersion) console.warn(projectCliVersionMismatch(cliVersion.running, cliVersion.declared, cliVersion.range, cliVersion.command));
                 if (asJson) process.env.EXTENSION_OUTPUT = 'json';
                 const built = [];
                 const summaries = [];
@@ -10058,6 +10428,8 @@ Cross-browser compatibility
                     if (!process.env.EXTENSION_VERBOSE) process.env.EXTENSION_VERBOSE = '1';
                 }
                 const asJson = 'json' === resolveOutputFormat(devOptions);
+                const cliVersion = checkProjectCliVersion(external_node_path_.resolve(pathOrRemoteUrl || process.cwd()), getCliPackageJson().version);
+                if (cliVersion) console.warn(projectCliVersionMismatch(cliVersion.running, cliVersion.declared, cliVersion.range, cliVersion.command));
                 if (void 0 !== devOptions.parentPid) {
                     const parentPid = parseParentPid(devOptions.parentPid);
                     if (void 0 === parentPid) {
@@ -10998,6 +11370,8 @@ Cross-browser compatibility
                     if (!process.env.EXTENSION_VERBOSE) process.env.EXTENSION_VERBOSE = '1';
                 }
                 const asJson = 'json' === resolveOutputFormat(startOptions);
+                const cliVersion = checkProjectCliVersion(external_node_path_.resolve(pathOrRemoteUrl || process.cwd()), getCliPackageJson().version);
+                if (cliVersion) console.warn(projectCliVersionMismatch(cliVersion.running, cliVersion.declared, cliVersion.range, cliVersion.command));
                 if (asJson) process.env.EXTENSION_OUTPUT = 'json';
                 const list = vendors(browser);
                 let unsupportedBrowser = '';
@@ -11171,7 +11545,6 @@ Cross-browser compatibility
                 await exitAfterDrain(1);
             });
         }
-        const external_semver_namespaceObject = require("semver");
         const external_update_check_namespaceObject = require("update-check");
         var external_update_check_default = /*#__PURE__*/ __webpack_require__.n(external_update_check_namespaceObject);
         function isStableVersion(version) {