extension 4.1.34 → 4.1.35

package/dist/cli.cjs

@@ -508,7 +508,8 @@ var __webpack_modules__ = {
         var _helpers_messaging__rspack_import_9 = __webpack_require__("./helpers/messaging.ts");
         var _run_firefox_firefox_launch_librewolf_overrides__rspack_import_10 = __webpack_require__("./browsers/run-firefox/firefox-launch/librewolf-overrides.ts");
         var _browser_family__rspack_import_11 = __webpack_require__("./browsers/browsers-lib/browser-family.ts");
-        var _output_binaries_resolver__rspack_import_12 = __webpack_require__("./browsers/browsers-lib/output-binaries-resolver.ts");
+        var _official_chrome__rspack_import_12 = __webpack_require__("./browsers/browsers-lib/official-chrome.ts");
+        var _output_binaries_resolver__rspack_import_13 = __webpack_require__("./browsers/browsers-lib/output-binaries-resolver.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);
@@ -592,7 +593,7 @@ var __webpack_modules__ = {
             if (opts?.pinned) return '';
             const managedKey = 'chromium' === browser || 'chromium-based' === browser ? 'chromium' : 'chrome' === browser || 'edge' === browser || 'firefox' === browser ? browser : void 0;
             if (managedKey) try {
-                const managed = (0, _output_binaries_resolver__rspack_import_12.kI)({}, managedKey);
+                const managed = (0, _output_binaries_resolver__rspack_import_13.kI)({}, managedKey);
                 if (managed && node_fs__rspack_import_0.existsSync(managed)) {
                     if ('chromium' === managedKey) return (0, chromium_location__rspack_import_5.getChromiumVersion)(managed) || 'Chromium';
                     if ('chrome' === managedKey) return (0, chrome_location2__rspack_import_4.getChromeVersion)(managed) || 'Chrome';
@@ -603,22 +604,23 @@ var __webpack_modules__ = {
             try {
                 if ('chromium' === browser || 'chromium-based' === browser) {
                     const p = chromium_location__rspack_import_5_default()(true, {
-                        env: (0, _output_binaries_resolver__rspack_import_12.Gg)('chromium')
+                        env: (0, _output_binaries_resolver__rspack_import_13.Gg)('chromium')
                     });
                     if (p && 'string' == typeof p && node_fs__rspack_import_0.existsSync(p)) return (0, chromium_location__rspack_import_5.getChromiumVersion)(p) || 'Chromium';
                 } else if ('chrome' === browser) {
                     const p = chrome_location2__rspack_import_4_default()(true, {
-                        env: (0, _output_binaries_resolver__rspack_import_12.Gg)('chrome')
+                        env: (0, _output_binaries_resolver__rspack_import_13.Gg)('chrome')
                     });
+                    if (p && 'string' == typeof p && (0, _official_chrome__rspack_import_12.g)(p)) return '';
                     if (p && 'string' == typeof p && node_fs__rspack_import_0.existsSync(p)) return (0, chrome_location2__rspack_import_4.getChromeVersion)(p) || 'Chrome';
                 } else if ('edge' === browser) {
                     const p = edge_location__rspack_import_6_default()(true, {
-                        env: (0, _output_binaries_resolver__rspack_import_12.Gg)('edge')
+                        env: (0, _output_binaries_resolver__rspack_import_13.Gg)('edge')
                     });
                     if (p && 'string' == typeof p && node_fs__rspack_import_0.existsSync(p)) return (0, edge_location__rspack_import_6.getEdgeVersion)(p) || 'Microsoft Edge';
                 } else if ('firefox' === browser) {
                     const p = firefox_location2__rspack_import_7_default()(true, {
-                        env: (0, _output_binaries_resolver__rspack_import_12.Gg)('firefox')
+                        env: (0, _output_binaries_resolver__rspack_import_13.Gg)('firefox')
                     });
                     if (p && 'string' == typeof p && node_fs__rspack_import_0.existsSync(p)) return (0, firefox_location2__rspack_import_7.getFirefoxVersion)(p) || 'Firefox';
                 }
@@ -1340,6 +1342,24 @@ var __webpack_modules__ = {
             c: ()=>manifestDeclaresNewtabOverride
         });
     },
+    "./browsers/browsers-lib/official-chrome.ts" (__unused_rspack_module, __webpack_exports__, __webpack_require__) {
+        var _wsl_support__rspack_import_0 = __webpack_require__("./browsers/browsers-lib/wsl-support.ts");
+        function looksOfficialChromeBinaryPath(bin) {
+            const p = String(bin || '');
+            if (!p) return false;
+            if (/\/Applications\/Google Chrome(?: (?:Beta|Dev|Canary))?\.app\/Contents\/MacOS\/Google Chrome/i.test(p)) return true;
+            if (/\\Google\\Chrome\\Application\\chrome\.exe$/i.test(p)) return true;
+            if (/\/opt\/google\/chrome\//i.test(p)) return true;
+            if (/\/google-chrome(?:-stable)?$/i.test(p)) return true;
+            return false;
+        }
+        function isRefusedOfficialChrome(bin) {
+            return looksOfficialChromeBinaryPath(bin) && !(0, _wsl_support__rspack_import_0.EV)();
+        }
+        __webpack_require__.d(__webpack_exports__, {
+            g: ()=>isRefusedOfficialChrome
+        });
+    },
     "./browsers/browsers-lib/output-binaries-resolver.ts" (__unused_rspack_module, __webpack_exports__, __webpack_require__) {
         var node_fs__rspack_import_0 = __webpack_require__("node:fs");
         var node_path__rspack_import_1 = __webpack_require__("node:path");
@@ -1796,11 +1816,12 @@ var __webpack_modules__ = {
         var external_node_fs_ = __webpack_require__("node:fs");
         var external_node_path_ = __webpack_require__("node:path");
         var messaging = __webpack_require__("./helpers/messaging.ts");
+        var rename_with_retry = __webpack_require__("./browsers/browsers-lib/rename-with-retry.ts");
         function writeJsonAtomic(filePath, value) {
             const tmpPath = `${filePath}.tmp-${process.pid}`;
             try {
                 external_node_fs_.writeFileSync(tmpPath, JSON.stringify(value, null, 2), 'utf-8');
-                external_node_fs_.renameSync(tmpPath, filePath);
+                (0, rename_with_retry.O)(tmpPath, filePath);
                 return true;
             } catch  {
                 try {
@@ -1892,7 +1913,10 @@ var __webpack_modules__ = {
                 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;
+                if (extensionId && 'browser' !== ready.extensionIdSource) {
+                    ready.extensionId = extensionId;
+                    ready.extensionIdSource = 'derived';
+                }
                 const binary = String(details?.binary || '').trim();
                 if (binary) ready.binary = binary;
                 const provenance = String(details?.binaryProvenance || '').trim();
@@ -1954,8 +1978,9 @@ var __webpack_modules__ = {
                 const readyPath = readyPathFor(extensionOutputPath);
                 if (!external_node_fs_.existsSync(readyPath)) return;
                 const ready = JSON.parse(external_node_fs_.readFileSync(readyPath, 'utf-8'));
-                if (ready.extensionId === id) return;
+                if (ready.extensionId === id && 'browser' === ready.extensionIdSource) return;
                 ready.extensionId = id;
+                ready.extensionIdSource = 'browser';
                 writeJsonAtomic(readyPath, ready);
             } catch  {}
         }
@@ -2014,6 +2039,42 @@ var __webpack_modules__ = {
             } catch  {}
         }
     },
+    "./browsers/browsers-lib/rename-with-retry.ts" (__unused_rspack_module, __webpack_exports__, __webpack_require__) {
+        var node_fs__rspack_import_0 = __webpack_require__("node:fs");
+        const RETRYABLE_RENAME_CODES = new Set([
+            'EPERM',
+            'EACCES',
+            'EBUSY'
+        ]);
+        const RENAME_RETRY_DELAYS_MS = [
+            10,
+            20,
+            40,
+            80,
+            160,
+            320
+        ];
+        function sleepSync(ms) {
+            Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, ms);
+        }
+        function renameSyncWithRetry(from, to, options = {}) {
+            const platform = options.platform ?? process.platform;
+            const rename = options.rename ?? node_fs__rspack_import_0.renameSync;
+            const sleep = options.sleep ?? sleepSync;
+            for(let attempt = 0;; attempt++)try {
+                rename(from, to);
+                return;
+            } catch (error) {
+                const code = error?.code;
+                const delay = RENAME_RETRY_DELAYS_MS[attempt];
+                if ('win32' !== platform || !code || !RETRYABLE_RENAME_CODES.has(code) || void 0 === delay) throw error;
+                sleep(delay);
+            }
+        }
+        __webpack_require__.d(__webpack_exports__, {
+            O: ()=>renameSyncWithRetry
+        });
+    },
     "./browsers/browsers-lib/resolve-live-pid.ts" (__unused_rspack_module, __webpack_exports__, __webpack_require__) {
         var node_child_process__rspack_import_0 = __webpack_require__("node:child_process");
         var node_fs__rspack_import_1 = __webpack_require__("node:fs");
@@ -2467,22 +2528,33 @@ var __webpack_modules__ = {
         }
         function mergeChromiumFeatureSwitches(flags) {
             const merged = [];
+            const prefixes = [
+                '--enable-features=',
+                '--disable-features='
+            ];
             const featureValues = {
                 '--enable-features=': [],
                 '--disable-features=': []
             };
+            const featureName = (value)=>value.split(/[<:]/)[0].trim();
             for (const flag of flags){
-                const prefix = Object.keys(featureValues).find((p)=>flag.startsWith(p));
+                const prefix = prefixes.find((p)=>flag.startsWith(p));
                 if (!prefix) {
                     merged.push(flag);
                     continue;
                 }
                 for (const value of flag.slice(prefix.length).split(',')){
                     const trimmed = value.trim();
-                    if (trimmed && !featureValues[prefix].includes(trimmed)) featureValues[prefix].push(trimmed);
+                    if (!trimmed) continue;
+                    const name = featureName(trimmed);
+                    for (const other of prefixes)featureValues[other] = featureValues[other].filter((existing)=>featureName(existing) !== name);
+                    featureValues[prefix].push(trimmed);
                 }
             }
-            for (const [prefix, values] of Object.entries(featureValues))if (values.length) merged.push(`${prefix}${values.join(',')}`);
+            for (const prefix of prefixes){
+                const values = featureValues[prefix];
+                if (values.length) merged.push(`${prefix}${values.join(',')}`);
+            }
             return merged;
         }
         async function findAvailablePortNear(startPort, maxAttempts = 20, host = '127.0.0.1') {
@@ -3267,8 +3339,8 @@ var __webpack_modules__ = {
         var messaging = __webpack_require__("./helpers/messaging.ts");
         var banner = __webpack_require__("./browsers/browsers-lib/banner.ts");
         var browser_family = __webpack_require__("./browsers/browsers-lib/browser-family.ts");
-        const external_node_readline_namespaceObject = require("node:readline");
-        var external_node_readline_default = /*#__PURE__*/ __webpack_require__.n(external_node_readline_namespaceObject);
+        var external_node_readline_ = __webpack_require__("node:readline");
+        var external_node_readline_default = /*#__PURE__*/ __webpack_require__.n(external_node_readline_);
         var browser_install_outcome = __webpack_require__("./helpers/browser-install-outcome.ts");
         var messages = __webpack_require__("./browsers/browsers-lib/messages.ts");
         var output_binaries_resolver = __webpack_require__("./browsers/browsers-lib/output-binaries-resolver.ts");
@@ -3547,6 +3619,7 @@ var __webpack_modules__ = {
                 return false;
             }
         }
+        var official_chrome = __webpack_require__("./browsers/browsers-lib/official-chrome.ts");
         var pinned_binary = __webpack_require__("./browsers/browsers-lib/pinned-binary.ts");
         var process_teardown = __webpack_require__("./browsers/browsers-lib/process-teardown.ts");
         var ready_message = __webpack_require__("./browsers/browsers-lib/ready-message.ts");
@@ -4280,15 +4353,6 @@ var __webpack_modules__ = {
                 }
                 if (!binaryPinnedByFlag) browserBinaryLocation = preferRealChromeBinary(browserBinaryLocation);
                 const getBrowserVersionLine = (bin)=>(0, version_probe.yO)(bin, String(browser || ''));
-                const looksOfficialChromeBinaryPath = (bin)=>{
-                    const p = String(bin || '');
-                    if (!p) return false;
-                    if (/\/Applications\/Google Chrome(?: (?:Beta|Dev|Canary))?\.app\/Contents\/MacOS\/Google Chrome/i.test(p)) return true;
-                    if (/\\Google\\Chrome\\Application\\chrome\.exe$/i.test(p)) return true;
-                    if (/\/opt\/google\/chrome\//i.test(p)) return true;
-                    if (/\/google-chrome(?:-stable)?$/i.test(p)) return true;
-                    return false;
-                };
                 const managedCacheRoot = output_binaries_resolver.LB(compilation);
                 const managedEnvFor = (b)=>(0, locator_env.i)(process.env, output_binaries_resolver.$4(String(managedCacheRoot), b));
                 const isAuthorMode = (0, messaging._o)();
@@ -4302,7 +4366,7 @@ var __webpack_modules__ = {
                             if (!located) throw new Error(getInstallGuidanceText('chrome'));
                             const normalized = normalizePath(located || null);
                             if (isUsableBinary(normalized)) {
-                                if (looksOfficialChromeBinaryPath(normalized) && !(0, wsl_support.EV)()) {
+                                if ((0, official_chrome.g)(normalized)) {
                                     printInstallGuidance(getInstallGuidanceText('chrome'), browser);
                                     return null;
                                 }
@@ -4316,7 +4380,7 @@ var __webpack_modules__ = {
                             }) || null;
                             const normalized = normalizePath(candidate || null);
                             if (normalized) {
-                                if (looksOfficialChromeBinaryPath(normalized) && !(0, wsl_support.EV)()) {
+                                if ((0, official_chrome.g)(normalized)) {
                                     printInstallGuidance(getInstallGuidanceText('chrome'), browser);
                                     candidate = null;
                                 }
@@ -5883,7 +5947,10 @@ var __webpack_modules__ = {
                         await client.connect(port);
                         this.client = client;
                         this.invalidateConnectionScopedCaches();
-                        client.on('reconnected', ()=>this.invalidateConnectionScopedCaches());
+                        client.on('reconnected', ()=>{
+                            this.invalidateConnectionScopedCaches();
+                            if (this.loggingAttached) attachConsoleListeners(client);
+                        });
                         return client;
                     } catch (error) {
                         if (isErrorWithCode('ECONNREFUSED', error)) {
@@ -6836,6 +6903,7 @@ var __webpack_modules__ = {
         var node_fs__rspack_import_0 = __webpack_require__("node:fs");
         var node_path__rspack_import_1 = __webpack_require__("node:path");
         var _browsers_lib_output_binaries_resolver__rspack_import_2 = __webpack_require__("./browsers/browsers-lib/output-binaries-resolver.ts");
+        var _browsers_lib_rename_with_retry__rspack_import_3 = __webpack_require__("./browsers/browsers-lib/rename-with-retry.ts");
         const MANAGED_GECKO_POLICIES = {
             DisableAppUpdate: true
         };
@@ -6916,7 +6984,9 @@ var __webpack_modules__ = {
                     recursive: true
                 });
                 fs.writeFileSync(tempPath, `${JSON.stringify(next, null, 2)}\n`, 'utf8');
-                fs.renameSync(tempPath, policyPath);
+                (0, _browsers_lib_rename_with_retry__rspack_import_3.O)(tempPath, policyPath, {
+                    rename: (from, to)=>fs.renameSync(from, to)
+                });
                 return {
                     status: 'written',
                     policyPath
@@ -10163,6 +10233,7 @@ function describeButton(b) {
             E_POLYFILL_NOT_FOUND: 'E_POLYFILL_NOT_FOUND',
             E_LOCALES_LAYOUT: 'E_LOCALES_LAYOUT',
             E_WAR_INVALID: 'E_WAR_INVALID',
+            E_DEV_SESSION_DIST_SHARED: 'E_DEV_SESSION_DIST_SHARED',
             E_BACKGROUND_REQUIRED: 'E_BACKGROUND_REQUIRED',
             E_CONTENT_SCRIPT_SYNTAX: 'E_CONTENT_SCRIPT_SYNTAX',
             E_NO_ENTRYPOINTS: 'E_NO_ENTRYPOINTS',
@@ -10379,113 +10450,8 @@ function describeButton(b) {
     "./index.ts" (__unused_rspack_module, __unused_rspack___webpack_exports__, __webpack_require__) {
         var external_node_fs_ = __webpack_require__("node:fs");
         var external_node_fs_default = /*#__PURE__*/ __webpack_require__.n(external_node_fs_);
-        const MIN_NODE_MAJOR = 22;
-        const MIN_NODE_MINOR = 12;
-        const MIN_DENO_MAJOR = 2;
-        const MIN_DENO_MINOR = 5;
-        const MIN_BUN_MAJOR = 1;
-        const MIN_BUN_MINOR = 2;
-        const BLOCKED_DENO_VERSIONS = [
-            '2.8.0'
-        ];
-        function meetsFloor(version, major, minor) {
-            const [actualMajor, actualMinor] = version.split('.').map((part)=>parseInt(part, 10));
-            if (!Number.isFinite(actualMajor)) return true;
-            if (actualMajor !== major) return actualMajor > major;
-            return (Number.isFinite(actualMinor) ? actualMinor : 0) >= minor;
-        }
-        function isSupportedNodeVersion(version) {
-            return meetsFloor(version, MIN_NODE_MAJOR, MIN_NODE_MINOR);
-        }
-        function isSupportedDenoVersion(version) {
-            if (BLOCKED_DENO_VERSIONS.includes(version)) return false;
-            return meetsFloor(version, MIN_DENO_MAJOR, MIN_DENO_MINOR);
-        }
-        function isSupportedBunVersion(version) {
-            return meetsFloor(version, MIN_BUN_MAJOR, MIN_BUN_MINOR);
-        }
-        function detectBunVersion(versions = process.versions) {
-            const bunVersion = versions.bun;
-            return 'string' == typeof bunVersion && bunVersion.length > 0 ? bunVersion : void 0;
-        }
-        function detectDenoVersion(versions = process.versions) {
-            const denoVersion = versions.deno;
-            return 'string' == typeof denoVersion && denoVersion.length > 0 ? denoVersion : void 0;
-        }
-        function unsupportedDenoVersionMessage(version) {
-            if (BLOCKED_DENO_VERSIONS.includes(version)) return `[Extension.js] Deno ${version} cannot load node:querystring inside the bundler, so every build fails on it. Deno fixed that in 2.8.1. Run deno upgrade to build the extension on Deno.`;
-            return `[Extension.js] Requires Deno >= ${MIN_DENO_MAJOR}.${MIN_DENO_MINOR} (you are on ${version}). Run deno upgrade, or run the extension CLI on Node.js >= ${MIN_NODE_MAJOR}.${MIN_NODE_MINOR} instead.`;
-        }
-        function unsupportedBunVersionMessage(version) {
-            return `[Extension.js] Requires Bun >= ${MIN_BUN_MAJOR}.${MIN_BUN_MINOR} (you are on ${version}). Run bun upgrade, or run the extension CLI on Node.js >= ${MIN_NODE_MAJOR}.${MIN_NODE_MINOR} instead.`;
-        }
-        function unsupportedNodeVersionMessage(version) {
-            return `[Extension.js] Requires Node.js >= ${MIN_NODE_MAJOR}.${MIN_NODE_MINOR} (you are on ${version}). Upgrade Node.js to run the extension CLI.`;
-        }
-        function wantsJsonOutput(argv) {
-            const inline = argv.find((arg)=>arg.startsWith('--output='));
-            const index = argv.indexOf('--output');
-            const spaced = index >= 0 ? argv[index + 1] : void 0;
-            const value = inline ? inline.slice(9) : spaced;
-            return 'json' === String(value || '').trim().toLowerCase();
-        }
-        function commandFromArgv(argv) {
-            for(let index = 2; index < argv.length; index += 1)if ('--output' === argv[index]) index += 1;
-            else if (!argv[index].startsWith('-')) return argv[index];
-            return 'extension';
-        }
-        function unsupportedNodeVersionFrame(version, argv) {
-            if (!wantsJsonOutput(argv)) return;
-            return {
-                schema: 1,
-                ok: false,
-                command: commandFromArgv(argv),
-                status: 'usage',
-                value: null,
-                error: {
-                    code: 'E_NODE_VERSION',
-                    message: unsupportedNodeVersionMessage(version).replace('[Extension.js] ', ''),
-                    name: 'CliError'
-                },
-                warnings: []
-            };
-        }
-        function writeFrame(frame) {
-            try {
-                external_node_fs_default().writeSync(1, `${JSON.stringify(frame)}\n`);
-            } catch  {
-                console.log(JSON.stringify(frame));
-            }
-        }
-        function enforceSupportedNodeVersion(version = process.versions.node, bunVersion = detectBunVersion(), denoVersion = detectDenoVersion(), argv = process.argv) {
-            if (denoVersion) {
-                if (isSupportedDenoVersion(denoVersion)) return;
-                console.error(unsupportedDenoVersionMessage(denoVersion));
-                process.exit(1);
-                return;
-            }
-            if (bunVersion) {
-                if (isSupportedBunVersion(bunVersion)) return;
-                console.error(unsupportedBunVersionMessage(bunVersion));
-                process.exit(1);
-                return;
-            }
-            if (isSupportedNodeVersion(version)) return;
-            console.error(unsupportedNodeVersionMessage(version));
-            const frame = unsupportedNodeVersionFrame(version, argv);
-            if (frame) writeFrame(frame);
-            process.exit(1);
-        }
-        enforceSupportedNodeVersion();
-        const external_commander_namespaceObject = require("commander");
         var external_node_path_ = __webpack_require__("node:path");
         var external_node_path_default = /*#__PURE__*/ __webpack_require__.n(external_node_path_);
-        var browser_family = __webpack_require__("./browsers/browsers-lib/browser-family.ts");
-        var evaluate_extension_document = __webpack_require__("./browsers/run-firefox/rdp/evaluate-extension-document.ts");
-        var emulator_session = __webpack_require__("./helpers/emulator-session.ts");
-        var external_pintor_ = __webpack_require__("pintor");
-        var external_pintor_default = /*#__PURE__*/ __webpack_require__.n(external_pintor_);
-        var browser_install_outcome = __webpack_require__("./helpers/browser-install-outcome.ts");
         let cachedPackageJson = null;
         function getCliPackageJson() {
             if (cachedPackageJson) return cachedPackageJson;
@@ -10501,7 +10467,27 @@ function describeButton(b) {
             }
             throw new Error('Extension.js CLI package.json not found.');
         }
-        var messaging = __webpack_require__("./helpers/messaging.ts");
+        const KNOWN_COMMANDS = new Set([
+            'build',
+            'capabilities',
+            'create',
+            'dev',
+            'doctor',
+            'eval',
+            'inspect',
+            'install',
+            'logs',
+            'navigate',
+            'open',
+            'preview',
+            'publish',
+            'reload',
+            'start',
+            'storage',
+            'telemetry',
+            'uninstall',
+            'unknown'
+        ]);
         var external_node_child_process_ = __webpack_require__("node:child_process");
         var external_node_crypto_ = __webpack_require__("node:crypto");
         var external_node_crypto_default = /*#__PURE__*/ __webpack_require__.n(external_node_crypto_);
@@ -10523,6 +10509,31 @@ function describeButton(b) {
             if ('string' != typeof value) return;
             return CATALOG_CODE.test(value) ? value : void 0;
         }
+        const BROWSER_INSTALL_OUTCOMES = new Set([
+            'offered',
+            'accepted',
+            'declined',
+            'failed'
+        ]);
+        const INSTALLABLE_BROWSERS = new Set([
+            'chrome',
+            'chromium',
+            'edge',
+            'firefox'
+        ]);
+        const DEPS_INSTALL_OUTCOMES = new Set([
+            'skipped',
+            'installed',
+            'failed'
+        ]);
+        const MAX_INSTALL_SECONDS = 86400;
+        function fixedWord(value, allowed) {
+            return 'string' == typeof value && allowed.has(value) ? value : void 0;
+        }
+        function wholeSeconds(value) {
+            if ('number' != typeof value || !Number.isInteger(value)) return;
+            return value >= 0 && value <= MAX_INSTALL_SECONDS ? value : void 0;
+        }
         function smallExitCode(value) {
             if ('number' != typeof value || !Number.isInteger(value)) return;
             return value >= 0 && value <= 255 ? value : void 0;
@@ -10773,6 +10784,16 @@ function describeButton(b) {
                     if (code) enforcedProps.code = code;
                     const exitCode = smallExitCode(props.exit_code);
                     if (void 0 !== exitCode) enforcedProps.exit_code = exitCode;
+                    const browserInstall = fixedWord(props.browser_install, BROWSER_INSTALL_OUTCOMES);
+                    if (browserInstall) enforcedProps.browser_install = browserInstall;
+                    const installBrowser = fixedWord(props.browser_install_browser, INSTALLABLE_BROWSERS);
+                    if (installBrowser) enforcedProps.browser_install_browser = installBrowser;
+                    const browserSeconds = wholeSeconds(props.browser_install_seconds);
+                    if (void 0 !== browserSeconds) enforcedProps.browser_install_seconds = browserSeconds;
+                    const depsInstall = fixedWord(props.deps_install, DEPS_INSTALL_OUTCOMES);
+                    if (depsInstall) enforcedProps.deps_install = depsInstall;
+                    const depsSeconds = wholeSeconds(props.deps_install_seconds);
+                    if (void 0 !== depsSeconds) enforcedProps.deps_install_seconds = depsSeconds;
                     const payload = {
                         event,
                         properties: {
@@ -10929,8 +10950,223 @@ function describeButton(b) {
             if (!Number.isFinite(n)) return min;
             return Math.min(Math.max(n, min), max);
         }
+        const MIN_NODE_MAJOR = 22;
+        const MIN_NODE_MINOR = 12;
+        const MIN_DENO_MAJOR = 2;
+        const MIN_DENO_MINOR = 5;
+        const MIN_BUN_MAJOR = 1;
+        const MIN_BUN_MINOR = 2;
+        const BLOCKED_DENO_VERSIONS = [
+            '2.8.0'
+        ];
+        function meetsFloor(version, major, minor) {
+            const [actualMajor, actualMinor] = version.split('.').map((part)=>parseInt(part, 10));
+            if (!Number.isFinite(actualMajor)) return true;
+            if (actualMajor !== major) return actualMajor > major;
+            return (Number.isFinite(actualMinor) ? actualMinor : 0) >= minor;
+        }
+        function isSupportedNodeVersion(version) {
+            return meetsFloor(version, MIN_NODE_MAJOR, MIN_NODE_MINOR);
+        }
+        function isSupportedDenoVersion(version) {
+            if (BLOCKED_DENO_VERSIONS.includes(version)) return false;
+            return meetsFloor(version, MIN_DENO_MAJOR, MIN_DENO_MINOR);
+        }
+        function isSupportedBunVersion(version) {
+            return meetsFloor(version, MIN_BUN_MAJOR, MIN_BUN_MINOR);
+        }
+        function detectBunVersion(versions = process.versions) {
+            const bunVersion = versions.bun;
+            return 'string' == typeof bunVersion && bunVersion.length > 0 ? bunVersion : void 0;
+        }
+        function detectDenoVersion(versions = process.versions) {
+            const denoVersion = versions.deno;
+            return 'string' == typeof denoVersion && denoVersion.length > 0 ? denoVersion : void 0;
+        }
+        function unsupportedDenoVersionMessage(version) {
+            if (BLOCKED_DENO_VERSIONS.includes(version)) return `[Extension.js] Deno ${version} cannot load node:querystring inside the bundler, so every build fails on it. Deno fixed that in 2.8.1. Run deno upgrade to build the extension on Deno.`;
+            return `[Extension.js] Requires Deno >= ${MIN_DENO_MAJOR}.${MIN_DENO_MINOR} (you are on ${version}). Run deno upgrade, or run the extension CLI on Node.js >= ${MIN_NODE_MAJOR}.${MIN_NODE_MINOR} instead.`;
+        }
+        function unsupportedBunVersionMessage(version) {
+            return `[Extension.js] Requires Bun >= ${MIN_BUN_MAJOR}.${MIN_BUN_MINOR} (you are on ${version}). Run bun upgrade, or run the extension CLI on Node.js >= ${MIN_NODE_MAJOR}.${MIN_NODE_MINOR} instead.`;
+        }
+        function unsupportedNodeVersionMessage(version) {
+            return `[Extension.js] Requires Node.js >= ${MIN_NODE_MAJOR}.${MIN_NODE_MINOR} (you are on ${version}). Upgrade Node.js to run the extension CLI.`;
+        }
+        function wantsJsonOutput(argv) {
+            const inline = argv.find((arg)=>arg.startsWith('--output='));
+            const index = argv.indexOf('--output');
+            const spaced = index >= 0 ? argv[index + 1] : void 0;
+            const value = inline ? inline.slice(9) : spaced;
+            return 'json' === String(value || '').trim().toLowerCase();
+        }
+        function commandFromArgv(argv) {
+            for(let index = 2; index < argv.length; index += 1)if ('--output' === argv[index]) index += 1;
+            else if (!argv[index].startsWith('-')) return argv[index];
+            return 'extension';
+        }
+        function unsupportedNodeVersionFrame(version, argv) {
+            if (!wantsJsonOutput(argv)) return;
+            return {
+                schema: 1,
+                ok: false,
+                command: commandFromArgv(argv),
+                status: 'usage',
+                value: null,
+                error: {
+                    code: 'E_NODE_VERSION',
+                    message: unsupportedNodeVersionMessage(version).replace('[Extension.js] ', ''),
+                    name: 'CliError'
+                },
+                warnings: []
+            };
+        }
+        const UNSUPPORTED_RUNTIME_FLUSH_MS = 1500;
+        function reportUnsupportedRuntime(argv = process.argv) {
+            try {
+                const consent = resolveTelemetryConsent(argv);
+                if (!consent.enabled || 'default' === consent.source) return;
+                const verb = commandFromArgv(argv);
+                const command = KNOWN_COMMANDS.has(verb) ? verb : 'unknown';
+                const version = String(getCliPackageJson().version || '0.0.0');
+                const telemetry = new Telemetry({
+                    app: 'extension',
+                    version
+                });
+                telemetry.track('command_failed', {
+                    command,
+                    success: false,
+                    version,
+                    code: 'E_NODE_VERSION',
+                    exit_code: 1
+                });
+                telemetry.flushSync(UNSUPPORTED_RUNTIME_FLUSH_MS);
+            } catch  {}
+        }
+        function writeFrame(frame) {
+            try {
+                external_node_fs_default().writeSync(1, `${JSON.stringify(frame)}\n`);
+            } catch  {
+                console.log(JSON.stringify(frame));
+            }
+        }
+        function enforceSupportedNodeVersion(version = process.versions.node, bunVersion = detectBunVersion(), denoVersion = detectDenoVersion(), argv = process.argv) {
+            if (denoVersion) {
+                if (isSupportedDenoVersion(denoVersion)) return;
+                console.error(unsupportedDenoVersionMessage(denoVersion));
+                reportUnsupportedRuntime(argv);
+                process.exit(1);
+                return;
+            }
+            if (bunVersion) {
+                if (isSupportedBunVersion(bunVersion)) return;
+                console.error(unsupportedBunVersionMessage(bunVersion));
+                reportUnsupportedRuntime(argv);
+                process.exit(1);
+                return;
+            }
+            if (isSupportedNodeVersion(version)) return;
+            console.error(unsupportedNodeVersionMessage(version));
+            const frame = unsupportedNodeVersionFrame(version, argv);
+            if (frame) writeFrame(frame);
+            reportUnsupportedRuntime(argv);
+            process.exit(1);
+        }
+        enforceSupportedNodeVersion();
+        const external_commander_namespaceObject = require("commander");
+        var browser_family = __webpack_require__("./browsers/browsers-lib/browser-family.ts");
+        var evaluate_extension_document = __webpack_require__("./browsers/run-firefox/rdp/evaluate-extension-document.ts");
+        var emulator_session = __webpack_require__("./helpers/emulator-session.ts");
+        var external_pintor_ = __webpack_require__("pintor");
+        var external_pintor_default = /*#__PURE__*/ __webpack_require__.n(external_pintor_);
+        var browser_install_outcome = __webpack_require__("./helpers/browser-install-outcome.ts");
+        function scanArgvValue(argv, flag) {
+            const equalArg = argv.find((arg)=>arg.startsWith(`${flag}=`));
+            if (equalArg) return equalArg.slice(flag.length + 1);
+            const flagIndex = argv.indexOf(flag);
+            if (flagIndex >= 0) return argv[flagIndex + 1] || '';
+        }
+        function collectValuedLongFlags(program) {
+            const flags = new Set();
+            const visit = (command)=>{
+                for (const option of command.options)if (option.long && (option.required || option.optional)) flags.add(option.long);
+                for (const sub of command.commands)visit(sub);
+            };
+            visit(program);
+            return flags;
+        }
+        function resolveCommandIndex(argv, valuedFlags) {
+            for(let i = 2; i < argv.length; i += 1){
+                const arg = argv[i];
+                if (arg.startsWith('-')) {
+                    if (valuedFlags.has(arg)) i += 1;
+                    continue;
+                }
+                return i;
+            }
+            return -1;
+        }
+        function resolveCommandFromArgv(argv, valuedFlags = new Set()) {
+            const index = resolveCommandIndex(argv, valuedFlags);
+            return index < 0 ? void 0 : argv[index];
+        }
+        function movePreCommandOutputArgv(argv, valuedFlags = new Set()) {
+            const commandIndex = resolveCommandIndex(argv, valuedFlags);
+            if (commandIndex < 0) return argv;
+            const index = argv.findIndex((arg, i)=>i >= 2 && i < commandIndex && ('--output' === arg || arg.startsWith('--output=')));
+            if (index < 0) return argv;
+            const next = [
+                ...argv
+            ];
+            const value = next[index + 1];
+            const takesValue = '--output' === next[index] && void 0 !== value && !value.startsWith('-') && index + 1 < commandIndex;
+            const tokens = next.splice(index, takesValue ? 2 : 1);
+            next.splice(commandIndex - tokens.length + 1, 0, ...tokens);
+            return next;
+        }
+        function rewriteOutputAliasArgv(argv, valuedFlags = new Set()) {
+            const index = argv.findIndex((arg)=>'--format' === arg || arg.startsWith('--format='));
+            if (index < 0) return {
+                argv,
+                rewritten: false
+            };
+            const next = [
+                ...argv
+            ];
+            const tokens = [];
+            if (next[index].startsWith('--format=')) {
+                tokens.push(`--output=${next[index].slice(9)}`);
+                next.splice(index, 1);
+            } else {
+                tokens.push('--output');
+                const value = next[index + 1];
+                next.splice(index, void 0 === value || value.startsWith('-') ? 1 : 2);
+                if (void 0 !== value && !value.startsWith('-')) tokens.push(value);
+            }
+            const command = resolveCommandFromArgv(next, valuedFlags);
+            const commandIndex = command ? next.indexOf(command, 2) : -1;
+            if (commandIndex >= index) next.splice(commandIndex + 1, 0, ...tokens);
+            else next.splice(index, 0, ...tokens);
+            return {
+                argv: next,
+                rewritten: true
+            };
+        }
+        let dependency_install_outcome_record = null;
+        function recordDependencyInstall(outcome, seconds) {
+            dependency_install_outcome_record = {
+                outcome,
+                ...'number' == typeof seconds && Number.isFinite(seconds) && seconds >= 0 ? {
+                    seconds: Math.round(seconds)
+                } : {}
+            };
+        }
+        function readDependencyInstall() {
+            return dependency_install_outcome_record;
+        }
+        var messaging = __webpack_require__("./helpers/messaging.ts");
         const TEMPLATE_CORPUS_REPO = 'extension-js/examples';
-        const TEMPLATE_CORPUS_REF = '1f964a2d9fb820a1ec4730590caa357d8717744f';
+        const TEMPLATE_CORPUS_REF = '4753cbd121dac8784f4cb5c515b773f87ebff3b4';
         const TEMPLATE_CORPUS_SLUGS = [
             'action',
             'action-locales',
@@ -11214,36 +11450,9 @@ function describeButton(b) {
                 ''
             ].join('\n');
         }
-        const KNOWN_COMMANDS = new Set([
-            'build',
-            'capabilities',
-            'create',
-            'dev',
-            'doctor',
-            'eval',
-            'inspect',
-            'install',
-            'logs',
-            'navigate',
-            'open',
-            'preview',
-            'publish',
-            'reload',
-            'start',
-            'storage',
-            'telemetry',
-            'uninstall',
-            'unknown'
-        ]);
-        function detectInvokedCommand(argv) {
-            for(let i = 2; i < argv.length; i += 1){
-                const arg = argv[i];
-                if (!(!arg || arg.startsWith('-'))) {
-                    if (KNOWN_COMMANDS.has(arg)) return arg;
-                    break;
-                }
-            }
-            return 'unknown';
+        function detectInvokedCommand(argv, valuedFlags = new Set()) {
+            const arg = resolveCommandFromArgv(argv, valuedFlags);
+            return arg && KNOWN_COMMANDS.has(arg) ? arg : 'unknown';
         }
         function readArgValue(argv, names) {
             for(let i = 2; i < argv.length; i += 1){
@@ -11282,6 +11491,7 @@ function describeButton(b) {
                 }
             } : {};
             if ('create' !== command) return installContext;
+            const deps = readDependencyInstall();
             return {
                 ...installContext,
                 template: advertisedTemplateName(readArgValue(argv, [
@@ -11290,26 +11500,35 @@ function describeButton(b) {
                 ])),
                 source: createSourceTag(readArgValue(argv, [
                     '--source'
-                ]))
+                ])),
+                ...deps ? {
+                    deps_install: deps.outcome
+                } : {},
+                ...deps?.seconds === void 0 ? {} : {
+                    deps_install_seconds: deps.seconds
+                }
             };
         }
-        const consent = resolveTelemetryConsent(process.argv);
-        const invoked = detectInvokedCommand(process.argv);
+        const telemetry_cli_consent = resolveTelemetryConsent(process.argv);
+        let invoked = detectInvokedCommand(process.argv);
         const telemetry_cli_version = String(getCliPackageJson().version || '0.0.0');
-        const telemetry = new Telemetry({
+        const telemetry_cli_telemetry = new Telemetry({
             app: 'extension',
             version: telemetry_cli_version,
-            disabled: !consent.enabled
+            disabled: !telemetry_cli_consent.enabled
         });
         function getTelemetryConsent() {
-            return consent;
+            return telemetry_cli_consent;
         }
         function invokedCommand() {
             return invoked;
         }
+        function resolveInvokedCommand(argv, valuedFlags) {
+            invoked = detectInvokedCommand(argv, valuedFlags);
+        }
         function setTelemetryConsent(value) {
             const ok = writeConsent(value);
-            if ('disabled' === value) telemetry.disable();
+            if ('disabled' === value) telemetry_cli_telemetry.disable();
             const storage = resolveTelemetryStorage();
             return {
                 ok,
@@ -11327,14 +11546,14 @@ function describeButton(b) {
         function markCommandSessionStart(command = invoked) {
             if (tracked || sessionStarted) return;
             sessionStarted = true;
-            telemetry.track('command_executed', {
+            telemetry_cli_telemetry.track('command_executed', {
                 command,
                 success: true,
                 version: telemetry_cli_version,
                 session: 'started',
                 ...telemetryCommandContext(command)
             });
-            telemetry.flush();
+            telemetry_cli_telemetry.flush();
         }
         function hasTrackedSessionStart() {
             return sessionStarted;
@@ -11342,7 +11561,7 @@ function describeButton(b) {
         function markCommandSuccess(command = invoked) {
             if (sessionStarted) return;
             if (!markTracked()) return;
-            telemetry.track('command_executed', {
+            telemetry_cli_telemetry.track('command_executed', {
                 command,
                 success: true,
                 version: telemetry_cli_version,
@@ -11362,7 +11581,7 @@ function describeButton(b) {
             if (!markTracked()) return;
             const code = telemetryFailureCode(details.code);
             const exitCode = telemetryExitCode(details.exitCode);
-            telemetry.track('command_failed', {
+            telemetry_cli_telemetry.track('command_failed', {
                 command,
                 success: false,
                 version: telemetry_cli_version,
@@ -11375,22 +11594,26 @@ function describeButton(b) {
                 ...telemetryCommandContext(command)
             });
         }
+        function reportCommandFailureNow(details = {}) {
+            markCommandFailure(void 0, details);
+            telemetry_cli_telemetry.flushSync(CRASH_FLUSH_TIMEOUT_MS);
+        }
         function printOptOutNoticeIfFirstRun() {
-            if (!consent.enabled || 'default' !== consent.source) return;
+            if (!telemetry_cli_consent.enabled || 'default' !== telemetry_cli_consent.source) return;
             if (!claimFirstRunNotice()) return;
             console.error(`${external_pintor_default().gray('⏵⏵⏵')} Extension.js collects anonymous, opt-out telemetry (two events: ${external_pintor_default().cyan('command_executed')} + ${external_pintor_default().cyan('command_failed')}). Disable with ${external_pintor_default().cyan('extension telemetry disable')}, ${external_pintor_default().cyan('EXTENSION_TELEMETRY=0')}, or ${external_pintor_default().cyan('--no-telemetry')}. See docs/TELEMETRY.md.`);
         }
-        if (consent.enabled) {
+        if (telemetry_cli_consent.enabled) {
             printOptOutNoticeIfFirstRun();
             process.on('beforeExit', async ()=>{
                 if (!tracked) if ((process.exitCode ?? 0) === 0) markCommandSuccess();
                 else markCommandFailure();
-                await telemetry.flush();
+                await telemetry_cli_telemetry.flush();
             });
             process.on('uncaughtExceptionMonitor', ()=>{
                 markCommandFailure();
-                if (process.listenerCount('uncaughtException') > 0) return void telemetry.flush();
-                telemetry.flushSync(CRASH_FLUSH_TIMEOUT_MS);
+                if (process.listenerCount('uncaughtException') > 0) return void telemetry_cli_telemetry.flush();
+                telemetry_cli_telemetry.flushSync(CRASH_FLUSH_TIMEOUT_MS);
             });
         }
         const TELEMETRY_FLUSH_TIMEOUT_MS = 500;
@@ -11403,11 +11626,20 @@ function describeButton(b) {
                 });
             } catch  {}
         }
+        function exitWithFailure(code, exitCode = 1) {
+            try {
+                reportCommandFailureNow({
+                    code,
+                    exitCode
+                });
+            } catch  {}
+            process.exit(exitCode);
+        }
         async function exitAfterDrain(code) {
             markOutcomeForExit(code);
             try {
                 await Promise.race([
-                    telemetry.flush(),
+                    telemetry_cli_telemetry.flush(),
                     new Promise((resolve)=>setTimeout(resolve, TELEMETRY_FLUSH_TIMEOUT_MS).unref?.())
                 ]);
             } catch  {}
@@ -11569,7 +11801,7 @@ function describeButton(b) {
                 positionals: [
                     {
                         name: 'project-name|project-path',
-                        required: true
+                        required: false
                     }
                 ],
                 description: 'Create a new extension from a template (React, TypeScript, Vue, Svelte, etc.)',
@@ -11882,6 +12114,12 @@ function describeButton(b) {
                 message
             };
         }
+        function createNeedsProjectName(command) {
+            return `${getLoggingPrefix('error')} A project name is required.\nRun ${messages_code(command)} to start one.`;
+        }
+        function createProjectNameQuestion(defaultName) {
+            return `Project name ${messages_arg(`(${defaultName})`)}: `;
+        }
         function programUserHelp() {
             return `\n${getLoggingPrefix('info')} ${external_pintor_default().underline('Help center for the Extension.js program')}
 
@@ -11922,6 +12160,7 @@ Build options
 - ${messages_code('--zip')} ${messages_arg('[boolean]')}                 Create ZIP archive of built extension
 - ${messages_code('--zip-source')} ${messages_arg('[boolean]')}          Include source files in ZIP
 - ${messages_code('--zip-filename')} ${messages_arg('<name>')}           Custom ZIP filename
+- ${messages_code('--out-dir')} ${messages_arg('<path>')}                Write the build to <path>/<browser> instead of dist/<browser>
 - ${messages_code('--no-addon-lint')}                          Skip the addons.mozilla.org lint of Firefox builds (runs when addons-linter is installed)
 - ${messages_code('--no-minify')}                              Ship readable first-party code (the default for ${messages_code('--browser=opera')}, whose store rejects minified code)
 
@@ -12620,75 +12859,39 @@ Cross-browser compatibility
         function isLogEventLike(value) {
             return Boolean(value) && 'object' == typeof value && !Array.isArray(value);
         }
-        const LEVEL_ORDER = [
+        const LEVEL_FILTERS = [
+            'off',
             'error',
             'warn',
             'info',
             'debug',
-            'trace'
-        ];
-        const LEVEL_FILTERS = [
-            'off',
-            ...LEVEL_ORDER,
+            'trace',
             'all'
         ];
+        function logRuleFrom(bridge) {
+            return bridge;
+        }
         function knownContextsFrom(bridge) {
             const published = bridge?.LOG_CONTEXTS;
             return Array.isArray(published) ? published.map(String) : [
                 ...LOG_CONTEXTS
             ];
         }
-        function levelRank(level) {
-            const l = 'log' === level ? 'info' : level;
-            const i = LEVEL_ORDER.indexOf(l);
-            return -1 === i ? LEVEL_ORDER.length : i;
-        }
-        function levelFilterFrom(value) {
-            const text = String(value || 'all').trim().toLowerCase();
-            const level = 'log' === text ? 'info' : text;
-            return LEVEL_FILTERS.includes(level) ? level : void 0;
-        }
         function contextNamesFrom(value) {
             return String(value || '').split(',').map((name)=>name.trim()).filter(Boolean);
         }
-        function contextFilterFrom(names) {
-            if (0 === names.length) return null;
-            if (names.some((name)=>'all' === name.toLowerCase())) return null;
-            return new Set(names);
-        }
-        function makeUrlMatcher(pattern) {
-            const hasGlob = pattern.includes('*');
-            let re = null;
-            if (hasGlob) {
-                const escaped = pattern.replace(/[.+?^${}()|[\]\\]/g, '\\$&').replace(/\*/g, '.*');
-                re = new RegExp(escaped);
-            }
-            return (event)=>{
-                const candidates = [
-                    event.url,
-                    event.hostname
-                ].filter((v)=>'string' == typeof v);
-                if (0 === candidates.length) return false;
-                return candidates.some((c)=>re ? re.test(c) : c.includes(pattern));
+        function makeFilter(opts, since, tabId, helpers, rule) {
+            const query = {
+                context: opts.context,
+                level: opts.level,
+                signalsOnly: opts.signalsOnly,
+                url: opts.url,
+                tab: tabId
             };
-        }
-        function makeFilter(opts, since, tabId, helpers) {
-            const minLevel = levelFilterFrom(opts.level) ?? 'all';
-            const contexts = contextFilterFrom(contextNamesFrom(opts.context));
-            const urlMatches = opts.url ? makeUrlMatcher(opts.url) : null;
             return (event)=>{
                 if (!event || 'object' != typeof event) return false;
-                if ('header' === event.type) return false;
-                if ('off' === minLevel) return false;
-                if (opts.signalsOnly && 'dx.signal' !== event.eventType) return false;
-                if (contexts && !contexts.has(String(event.context))) return false;
-                if ('all' !== minLevel) {
-                    if (levelRank(String(event.level || '')) > levelRank(minLevel)) return false;
-                }
                 if (since && !helpers.isAfterSince(event, since)) return false;
-                if (urlMatches && !urlMatches(event)) return false;
-                if (void 0 !== tabId && event.tabId !== tabId) return false;
-                return true;
+                return rule.matchesLogQuery(event, query);
             };
         }
         function resolveFormat(opts) {
@@ -12739,6 +12942,7 @@ Cross-browser compatibility
                 const browser = options.browser || 'chromium';
                 const format = resolveFormat(options);
                 const helpers = sinceHelpersFrom(bridge);
+                const rule = logRuleFrom(bridge);
                 const since = helpers.parseLogSince(options.since);
                 const tab = parsePositiveInt('--tab', options.tab);
                 if (!tab.ok) {
@@ -12748,13 +12952,13 @@ Cross-browser compatibility
                         message: tab.message,
                         name: 'CliError'
                     }));
-                    process.exit(1);
+                    exitWithFailure(messaging.Lp.E_FLAG_VALUE_INVALID);
                 }
                 if (null != options.since && '' !== options.since && void 0 === since) refuseUsage(format, `extension logs --since expects a sequence number or an ISO timestamp, got: ${options.since}`);
                 const knownContexts = knownContextsFrom(bridge);
                 const unknownContexts = contextNamesFrom(options.context).filter((name)=>'all' !== name.toLowerCase() && !knownContexts.includes(name));
                 if (unknownContexts.length > 0) refuseUsage(format, `extension logs --context expects a comma-separated list of ${knownContexts.join(', ')} or all, got: ${unknownContexts.join(', ')}`);
-                if (void 0 === levelFilterFrom(options.level)) refuseUsage(format, `extension logs --level expects one of ${LEVEL_FILTERS.join(', ')}, got: ${options.level}`);
+                if (void 0 === rule.parseLogLevelFilter(options.level)) refuseUsage(format, `extension logs --level expects one of ${rule.LOG_LEVEL_FILTERS.join(', ')}, got: ${options.level}`);
                 const emulatorRefusal = (0, emulator_session.MC)(bridge, projectPath, browser, 'logs');
                 if (emulatorRefusal) {
                     console.error(emulatorRefusal);
@@ -12763,9 +12967,9 @@ Cross-browser compatibility
                         message: emulatorRefusal,
                         name: 'CliError'
                     }));
-                    process.exit(1);
+                    exitWithFailure(messaging.Lp.E_COMMAND_UNSUPPORTED_FOR_TARGET);
                 }
-                const matches = makeFilter(options, since ?? null, tab.value, helpers);
+                const matches = makeFilter(options, since ?? null, tab.value, helpers, rule);
                 if (options.signalsOnly) console.error("extension logs --signals-only: no signals emitter ships in this build, so dev sessions record no dx.signal events and this filter will print nothing.");
                 if (options.follow) return void await followLogs(projectPath, browser, format, matches);
                 const file = sessionLogsPath(bridge, projectPath, browser);
@@ -12778,10 +12982,10 @@ Cross-browser compatibility
                         message,
                         name: 'CliError'
                     }));
-                    process.exit(1);
+                    exitWithFailure(messaging.Lp.E_LOGS_NOT_FOUND);
                 }
                 const lines = external_node_fs_default().readFileSync(file, 'utf-8').split('\n').filter(Boolean);
-                const noticeGaps = 'off' !== levelFilterFrom(options.level);
+                const noticeGaps = 'off' !== rule.parseLogLevelFilter(options.level);
                 for (const line of lines){
                     const event = parseLogLine(line);
                     if (event) {
@@ -12805,7 +13009,7 @@ Cross-browser compatibility
                 message,
                 name: 'CliError'
             }));
-            process.exit(1);
+            exitWithFailure(messaging.Lp.E_INVALID_OPTION);
         }
         async function followLogs(projectPath, browser, format, matches) {
             const bridge = await loadExtensionDevelopBridgeModule();
@@ -12819,7 +13023,7 @@ Cross-browser compatibility
                     message,
                     name: 'CliError'
                 }));
-                process.exit(1);
+                exitWithFailure(messaging.Lp.E_SESSION_NOT_FOUND);
             }
             let settle = ()=>{};
             const settled = new Promise((resolve)=>{
@@ -13022,7 +13226,7 @@ Cross-browser compatibility
                     hint: frame.hint
                 } : {}
             }));
-            process.exit(1);
+            exitWithFailure(frame?.code);
         }
         function positiveIntFlag(flag, raw, frame) {
             const parsed = parsePositiveInt(flag, raw);
@@ -13131,7 +13335,9 @@ Cross-browser compatibility
                 name: 'Error',
                 message: 'command failed'
             };
+            const { error } = buildActEnvelope(command, result);
             console.error(`${err.name}: ${err.message}${err.engine ? ` (engine: ${err.engine})` : ''}`);
+            if (error?.hint) console.error(error.hint);
         }
         function bridgeErrorCode(result) {
             const raw = result?.error || {};
@@ -13301,6 +13507,13 @@ Cross-browser compatibility
                 Object.assign(result, input.augment(projectPath, browser, result));
             } catch  {}
             printResult(result, input.opts.output, input.command, input.pretty);
+            if (!result.ok) {
+                const { error } = buildActEnvelope(input.command, result);
+                markCommandFailure(void 0, {
+                    code: error?.code,
+                    exitCode: 1
+                });
+            }
             await exitAfterDrain(result.ok ? 0 : 1);
         }
         function targetFrom(opts, command, fallback = 'background') {
@@ -13506,59 +13719,6 @@ Cross-browser compatibility
         var safari_launch = __webpack_require__("./browsers/run-safari/safari-launch/index.ts");
         var safari_config = __webpack_require__("./browsers/run-safari/safari-launch/safari-config.ts");
         var safari_packager = __webpack_require__("./browsers/run-safari/safari-packager.ts");
-        function scanArgvValue(argv, flag) {
-            const equalArg = argv.find((arg)=>arg.startsWith(`${flag}=`));
-            if (equalArg) return equalArg.slice(flag.length + 1);
-            const flagIndex = argv.indexOf(flag);
-            if (flagIndex >= 0) return argv[flagIndex + 1] || '';
-        }
-        function collectValuedLongFlags(program) {
-            const flags = new Set();
-            const visit = (command)=>{
-                for (const option of command.options)if (option.long && (option.required || option.optional)) flags.add(option.long);
-                for (const sub of command.commands)visit(sub);
-            };
-            visit(program);
-            return flags;
-        }
-        function resolveCommandFromArgv(argv, valuedFlags = new Set()) {
-            for(let i = 2; i < argv.length; i += 1){
-                const arg = argv[i];
-                if (arg.startsWith('-')) {
-                    if (valuedFlags.has(arg)) i += 1;
-                    continue;
-                }
-                return arg;
-            }
-        }
-        function rewriteOutputAliasArgv(argv, valuedFlags = new Set()) {
-            const index = argv.findIndex((arg)=>'--format' === arg || arg.startsWith('--format='));
-            if (index < 0) return {
-                argv,
-                rewritten: false
-            };
-            const next = [
-                ...argv
-            ];
-            const tokens = [];
-            if (next[index].startsWith('--format=')) {
-                tokens.push(`--output=${next[index].slice(9)}`);
-                next.splice(index, 1);
-            } else {
-                tokens.push('--output');
-                const value = next[index + 1];
-                next.splice(index, void 0 === value || value.startsWith('-') ? 1 : 2);
-                if (void 0 !== value && !value.startsWith('-')) tokens.push(value);
-            }
-            const command = resolveCommandFromArgv(next, valuedFlags);
-            const commandIndex = command ? next.indexOf(command, 2) : -1;
-            if (commandIndex >= index) next.splice(commandIndex + 1, 0, ...tokens);
-            else next.splice(index, 0, ...tokens);
-            return {
-                argv: next,
-                rewritten: true
-            };
-        }
         const FRAMED_FLAG = 'extensionEnvelopePrinted';
         function markErrorFramed(err) {
             if (err && 'object' == typeof err) try {
@@ -13622,6 +13782,10 @@ Cross-browser compatibility
             return messaging.Pr.fail(command, 'usage', error);
         }
         const SUGGESTION_PATTERN = /\(Did you mean (one of )?(.+)\?\)/;
+        const PROJECT_START_VERBS = new Set([
+            'init',
+            'new'
+        ]);
         function sentenceCase(input) {
             const trimmed = input.trim();
             const capitalized = trimmed.charAt(0).toUpperCase() + trimmed.slice(1);
@@ -13641,7 +13805,8 @@ Cross-browser compatibility
             if (!label) label = sentenceCase(message.split('\n')[0]);
             const helpTarget = 'options' === noun && command && 'extension' !== command ? `extension ${command}` : 'extension';
             const suggestion = SUGGESTION_PATTERN.exec(message);
-            const remedy = suggestion ? `Did you mean ${suggestion[1] || ''}${external_pintor_default().blue(suggestion[2])}?` : `Run ${external_pintor_default().blue(`${helpTarget} --help`)} to see the ${noun}.`;
+            const startsAProject = 'commander.unknownCommand' === commanderCode && PROJECT_START_VERBS.has(String(refs?.command));
+            const remedy = startsAProject ? `Run ${external_pintor_default().blue('extension create my-extension')} to start a new extension.` : suggestion ? `Did you mean ${suggestion[1] || ''}${external_pintor_default().blue(suggestion[2])}?` : `Run ${external_pintor_default().blue(`${helpTarget} --help`)} to see the ${noun}.`;
             return `${(0, messaging.Pl)('error')} ${label}\n${remedy}`;
         }
         function isUsageCode(code) {
@@ -13788,10 +13953,10 @@ Cross-browser compatibility
         }
         function failAndExit(asJson, status, error) {
             if (asJson) console.log(JSON.stringify(messaging.Pr.fail('build', status, error)));
-            process.exit(1);
+            exitWithFailure(error.code);
         }
         function registerBuildCommand(program) {
-            program.command('build').arguments('[project-name]').usage('[path-to-remote-extension] [options]').description(commandDescriptions.build).option(`--browser <${vendors.I9}>`, '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` (`dev` and `start` default to `true`)', vendors.sJ).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`', vendors.sJ).option('--zip-source [boolean]', 'whether or not to include the source files in the ZIP file. Defaults to `false`', vendors.sJ).option('--zip-filename <string>', 'specify the name of the ZIP file, the browser name is appended. Defaults to the extension name and version').option('--silent [boolean]', 'suppress the build summary output. Defaults to `false`', vendors.sJ).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`', vendors.sJ).option('--no-addon-lint', 'skip the addons.mozilla.org lint of Firefox builds').option('--minify [boolean]', 'minify first-party code in production builds. Defaults to `true`, and to `false` for `opera`, whose store rejects minified code', vendors.sJ).option('--no-minify', 'ship readable first-party code, the Opera Add-ons review requirement').option('--install [boolean]', '[internal] install project dependencies when missing', vendors.sJ).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`', vendors.sJ).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`', vendors.sJ).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 })=>{
+            program.command('build').arguments('[project-name]').usage('[path-to-remote-extension] [options]').description(commandDescriptions.build).option(`--browser <${vendors.I9}>`, '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` (`dev` and `start` default to `true`)', vendors.sJ).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`', vendors.sJ).option('--zip-source [boolean]', 'whether or not to include the source files in the ZIP file. Defaults to `false`', vendors.sJ).option('--zip-filename <string>', 'specify the name of the ZIP file, the browser name is appended. Defaults to the extension name and version').option('--out-dir <path>', 'write the build to `<path>/<browser>` instead of `dist/<browser>`, relative to the project root, so it can run beside a dev session that serves `dist`').option('--silent [boolean]', 'suppress the build summary output. Defaults to `false`', vendors.sJ).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`', vendors.sJ).option('--no-addon-lint', 'skip the addons.mozilla.org lint of Firefox builds').option('--minify [boolean]', 'minify first-party code in production builds. Defaults to `true`, and to `false` for `opera`, whose store rejects minified code', vendors.sJ).option('--no-minify', 'ship readable first-party code, the Opera Add-ons review requirement').option('--install [boolean]', '[internal] install project dependencies when missing', vendors.sJ).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`', vendors.sJ).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`', vendors.sJ).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';
                 if (buildOptions.debug || buildOptions.author || buildOptions.authorMode) {
                     process.env.EXTENSION_DEBUG = '1';
@@ -13890,6 +14055,7 @@ Cross-browser compatibility
                         zip: buildOptions.zip,
                         zipSource: buildOptions.zipSource,
                         zipFilename: buildOptions.zipFilename,
+                        outDir: buildOptions.outDir,
                         silent: buildOptions.silent,
                         addonLint: buildOptions.addonLint,
                         minify: buildOptions.minify,
@@ -13921,7 +14087,7 @@ Cross-browser compatibility
                         hint: "Fix the error above and run build again.",
                         truncated: true === truncated
                     })));
-                    process.exit(1);
+                    exitWithFailure(declaredErrorCode(error) ?? messaging.Lp.E_COMPILE);
                 }
                 if (asJson) console.log(JSON.stringify(messaging.Pr.ok('build', 'built', {
                     projectPath: pathOrRemoteUrl,
@@ -13998,6 +14164,45 @@ Cross-browser compatibility
                 await exitAfterDrain(0);
             });
         }
+        var external_node_readline_ = __webpack_require__("node:readline");
+        var external_node_readline_default = /*#__PURE__*/ __webpack_require__.n(external_node_readline_);
+        const DEFAULT_PROJECT_NAME = 'my-extension';
+        function project_name_prompt_isCI() {
+            const v = process.env;
+            return Boolean(v.CI || v.GITHUB_ACTIONS || v.GITLAB_CI || v.BUILDKITE || v.CIRCLECI || v.TRAVIS);
+        }
+        function canPromptForProjectName() {
+            if (process.env.VITEST || process.env.VITEST_WORKER_ID) return false;
+            if (project_name_prompt_isCI()) return false;
+            return Boolean(process.stdin.isTTY && process.stdout.isTTY);
+        }
+        function askProjectName(question) {
+            return new Promise((resolve)=>{
+                const rl = external_node_readline_default().createInterface({
+                    input: process.stdin,
+                    output: process.stdout
+                });
+                let settled = false;
+                const finish = (answer)=>{
+                    if (settled) return;
+                    settled = true;
+                    try {
+                        rl.close();
+                    } catch  {}
+                    resolve(answer);
+                };
+                rl.question(question, (answer)=>{
+                    const name = String(answer || '').trim();
+                    finish(name || DEFAULT_PROJECT_NAME);
+                });
+                rl.on('SIGINT', ()=>finish(null));
+                rl.on('close', ()=>finish(null));
+            });
+        }
+        function createCommandFor(template) {
+            const name = String(template || '').trim() || 'react';
+            return `npx extension@latest create ${DEFAULT_PROJECT_NAME} --template=${name}`;
+        }
         const create_require = (0, external_node_module_.createRequire)(__rslib_import_meta_url__);
         const CREATE_ERROR_NEEDLES = {
             E_DESTINATION_NOT_EMPTY: [
@@ -14033,11 +14238,37 @@ Cross-browser compatibility
             for (const [code, needles] of Object.entries(CREATE_ERROR_NEEDLES))if (needles.some((needle)=>message.includes(needle))) return code;
             return messaging.Lp.E_INTERNAL;
         }
+        async function resolveProjectName(template, asJson) {
+            if (!asJson && canPromptForProjectName()) {
+                const answer = await askProjectName(createProjectNameQuestion(DEFAULT_PROJECT_NAME));
+                if (answer) return answer;
+                markCommandFailure(void 0, {
+                    code: messaging.Lp.E_INTERRUPTED,
+                    exitCode: 130
+                });
+                await exitAfterDrain(130);
+                return;
+            }
+            const command = createCommandFor(template);
+            markCommandFailure(void 0, {
+                code: messaging.Lp.E_ARGS,
+                exitCode: 1
+            });
+            console.error(createNeedsProjectName(command));
+            if (asJson) console.log(JSON.stringify(messaging.Pr.fail('create', 'usage', {
+                code: messaging.Lp.E_ARGS,
+                message: `A project name is required. Run ${command} to start one.`,
+                name: 'CliError'
+            })));
+            await exitAfterDrain(1);
+        }
         function registerCreateCommand(program) {
-            program.command('create').arguments('<project-name|project-path>').usage('<project-name|project-path> [options]').description(commandDescriptions.create).option('-t, --template <template-name>', `catalog name, GitHub URL, or ZIP URL to scaffold from; every catalog name is listed below (default: ${DEFAULT_TEMPLATE})`).option('--install [boolean]', 'whether or not to install the dependencies after creating the project (disabled by default, pass --install to opt in)', vendors.sJ, false).option('--source <source>', 'attribution tag for where this create was initiated (e.g. cli, templates); recorded in anonymous telemetry only').option('--output <pretty|json>', 'result format. Use json for a schema-1 envelope on stdout').addHelpText('after', renderCreateTemplateHelp()).action(async (pathOrRemoteUrl, { template, install, output })=>{
+            program.command('create').arguments('[project-name|project-path]').usage('<project-name|project-path> [options]').description(commandDescriptions.create).option('-t, --template <template-name>', `catalog name, GitHub URL, or ZIP URL to scaffold from; every catalog name is listed below (default: ${DEFAULT_TEMPLATE})`).option('--install [boolean]', 'whether or not to install the dependencies after creating the project (disabled by default, pass --install to opt in)', vendors.sJ, false).option('--source <source>', 'attribution tag for where this create was initiated (e.g. cli, templates); recorded in anonymous telemetry only').option('--output <pretty|json>', 'result format. Use json for a schema-1 envelope on stdout').addHelpText('after', renderCreateTemplateHelp()).action(async (projectInput, { template, install, output })=>{
                 const asJson = isJsonOutput({
                     output
                 });
+                const pathOrRemoteUrl = projectInput || await resolveProjectName(template, asJson);
+                if (!pathOrRemoteUrl) return;
                 if (!process.env.EXTENSION_CREATE_DEVELOP_ROOT) try {
                     process.env.EXTENSION_CREATE_DEVELOP_ROOT = resolveExtensionDevelopRoot();
                 } catch  {
@@ -14065,6 +14296,7 @@ Cross-browser compatibility
                         cliVersion: getCliPackageJson().version
                     });
                 } catch (error) {
+                    if (createErrorCode(error) === messaging.Lp.E_DEPENDENCY_INSTALL) recordDependencyInstall('failed');
                     markCommandFailure(void 0, {
                         code: createErrorCode(error),
                         exitCode: 1
@@ -14077,6 +14309,7 @@ Cross-browser compatibility
                     await exitAfterDrain(1);
                     return;
                 }
+                recordDependencyInstall(result?.depsInstalled ? 'installed' : 'skipped', result?.installSeconds);
                 if (asJson) console.log(JSON.stringify(messaging.Pr.ok('create', 'created', {
                     projectPath: result?.projectPath ?? pathOrRemoteUrl,
                     projectName: result?.projectName,
@@ -14398,7 +14631,7 @@ Cross-browser compatibility
             if (asJson) printFrame(messaging.Pr.fail('dev', status, error, hint ? {
                 hint
             } : {}));
-            process.exit(1);
+            exitWithFailure(error.code);
         }
         function resolveRequestedPort(value) {
             const parsed = 'number' == typeof value ? value : Number.parseInt(String(value ?? ''), 10);
@@ -14599,7 +14832,7 @@ Cross-browser compatibility
                         }, {
                             hint: 'Fix the error above and run dev again.'
                         }));
-                        process.exit(1);
+                        exitWithFailure(code);
                     }
                 }
             });
@@ -15817,7 +16050,7 @@ Cross-browser compatibility
                     hint
                 } : {}
             }));
-            process.exit(1);
+            exitWithFailure(code);
         }
         function accessibilityHint(host) {
             return `Open System Settings ▸ Privacy & Security ▸ Accessibility, add ${host}, and run again.`;
@@ -15990,7 +16223,7 @@ Cross-browser compatibility
             if (asJson) start_printFrame(messaging.Pr.fail('start', status, error, hint ? {
                 hint
             } : {}));
-            process.exit(1);
+            exitWithFailure(error.code);
         }
         function registerStartCommand(program) {
             program.command('start').arguments('[project-path|remote-url]').usage('[project-path|remote-url] [options]').description(commandDescriptions.start).addHelpText('after', "\nAdditional options:\n  --no-browser    stop the browser launch, the build still runs\n  --wait          wait for ready contract and exit, pair with --output json for machine output\n" + BROWSER_LAUNCH_HELP_FOOTER).option('--profile <path-to-file | boolean>', 'what path to use for the browser profile. A boolean value of false sets the profile to the default user profile. Defaults to a fresh profile').option(`--browser <${vendors.DB}>`, 'specify a browser/engine to run. Defaults to `chromium`').option('--polyfill [boolean]', 'whether or not to apply the cross-browser polyfill. Defaults to `true` (`build` defaults to `false`)', vendors.sJ).option('--no-polyfill', 'disable the cross-browser polyfill').option('--no-open', NO_OPEN_FLAG_DESCRIPTION).option('--enable-extension', 'turn the extension on in Safari Settings through macOS Accessibility (safari targets only, and start has no Safari path yet)').option('--chromium-binary <path-to-binary>', 'specify a path to the Chromium binary. This option overrides the --browser setting. Defaults to the system default').addOption(geckoBinaryOption()).addOption(firefoxBinaryAliasOption()).option('--starting-url <url>', 'specify the starting URL for the browser. Defaults to `undefined`').option('--port <port>', 'specify the port to use for the development server. Defaults to `8080`').option('--host <host>', 'specify the host to bind the dev server to. Use 0.0.0.0 for Docker/devcontainers. Defaults to `127.0.0.1`').option('--public-host <host>', 'accepted for parity with `dev`. `start` serves nothing, so this has no effect').option('--log-context <list>', `[experimental] comma-separated contexts to include (${LOG_CONTEXTS.join(',')}). Use \`all\` to include all contexts (default)`).option('--logs <off|error|warn|info|debug|trace|all>', '[experimental] minimum centralized logger level to display in terminal (default: off)').option('--log-format <pretty|json|ndjson>', '[experimental] output format for logger events. Defaults to `pretty`').option('--no-log-timestamps', 'disable ISO timestamps in pretty output').option('--no-log-color', 'disable color in pretty output').option('--log-url <pattern>', '[experimental] only show logs where event.url matches this substring or regex (/re/i)').option('--log-tab <id>', 'only show logs for a specific tabId (number)').option('--extensions <list>', 'comma-separated list of companion extensions or store URLs to load').option('--allow-control', 'open the agent-bridge control channel on the production run for bounded act (storage/reload/open). The browser loads a copy of the build with the control producer added; dist/ is unchanged').option('--allow-eval', 'additionally enable `extension eval` on the production run (implies --allow-control, runs arbitrary code in a context, writes a 0600 session token)').option('--install [boolean]', '[internal] install project dependencies when missing', vendors.sJ).option('--wait [boolean]', 'wait for dist/extension-js/<browser>/ready.json and exit', vendors.sJ).option('--wait-timeout <ms>', 'timeout in milliseconds when using --wait (default: 60000)').option('--output <pretty|json>', 'result format. Use json for a schema-1 envelope on stdout').addOption(new external_commander_namespaceObject.Option('--wait-format <pretty|json>').hideHelp()).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, options, command)=>{
@@ -16097,7 +16330,7 @@ Cross-browser compatibility
                         }, {
                             hint: 'Fix the error above and run start again.'
                         }));
-                        process.exit(1);
+                        exitWithFailure(declaredErrorCode(error) ?? messaging.Lp.E_COMPILE);
                     }
                     if (noBrowser) continue;
                     const { extensionPreview } = await loadExtensionDevelopPreviewModule();
@@ -16230,7 +16463,7 @@ Cross-browser compatibility
         async function flushTelemetryWithin(ms) {
             try {
                 await Promise.race([
-                    telemetry.flush(),
+                    telemetry_cli_telemetry.flush(),
                     new Promise((resolve)=>setTimeout(resolve, ms).unref?.())
                 ]);
             } catch  {}
@@ -16293,13 +16526,13 @@ Cross-browser compatibility
             if (cli_failure_wantsJsonOutput(argv)) writeStdoutFrame(earlyExitEnvelope(index_resolveCommandFromArgv(argv) || 'extension', code, plainMessage, {
                 flag
             }));
-            process.exit(1);
+            exitWithFailure(code);
         }
         function applyOutputAliasArgvShim(argv) {
             if (argv.includes('--ai-help')) return argv;
             const { argv: next, rewritten } = rewriteOutputAliasArgv(argv, valuedLongFlags);
             if (rewritten) warnDeprecatedOutputAlias('--format');
-            return next;
+            return movePreCommandOutputArgv(next, valuedLongFlags);
         }
         function applyNoBrowserArgvShim(argv) {
             const hasNoRunner = argv.includes('--no-runner');
@@ -16346,6 +16579,7 @@ Cross-browser compatibility
         registerDoctorCommand(extensionJs);
         registerCapabilitiesCommand(extensionJs);
         valuedLongFlags = collectValuedLongFlags(extensionJs);
+        resolveInvokedCommand(process.argv, valuedLongFlags);
         function runAIHelp() {
             const format = resolveAIHelpFormatFromArgv(process.argv).trim().toLowerCase();
             if ('json' === format) {
@@ -16379,7 +16613,7 @@ Cross-browser compatibility
                         const exitCode = commanderExitCode(err);
                         if (0 === exitCode) process.exit(0);
                         markCommandFailure(void 0, {
-                            code: messaging.Lp.E_ARGS,
+                            code: codeForCommanderError(String(err.code)),
                             exitCode
                         });
                         console.error(commanderHumanError(err, commandName));
@@ -16434,6 +16668,9 @@ Cross-browser compatibility
     "node:path" (module) {
         module.exports = require("node:path");
     },
+    "node:readline" (module) {
+        module.exports = require("node:readline");
+    },
     pintor (module) {
         module.exports = require("pintor");
     },