extension 4.0.21 → 4.0.22

package/dist/cli.cjs

@@ -150,7 +150,9 @@ var __webpack_modules__ = {
             const updateSuffix = readUpdateSuffixOnce();
             console.log(_messages__rspack_import_5.io());
             console.log(_messages__rspack_import_5.e_(manifest, opts.browser, message, opts.browserVersionLine, updateSuffix || void 0, {
-                profilePath: opts.profilePath
+                profilePath: opts.profilePath,
+                binaryPath: opts.binaryPath,
+                binaryProvenance: opts.binaryProvenance
             }));
             console.log(_messages__rspack_import_5.io());
             markCardPrinted(k, opts.browser, opts.outPath);
@@ -191,7 +193,9 @@ var __webpack_modules__ = {
                     console.log(_messages__rspack_import_5.e_(manifest, opts.browser, message, browserLabel, updateSuffix || void 0, {
                         includeExtensionId: opts.includeExtensionId,
                         runLabel,
-                        profilePath: opts.profilePath
+                        profilePath: opts.profilePath,
+                        binaryPath: opts.binaryPath,
+                        binaryProvenance: opts.binaryProvenance
                     }));
                     console.log(_messages__rspack_import_5.io());
                 } else {
@@ -209,25 +213,32 @@ var __webpack_modules__ = {
                     console.log(_messages__rspack_import_5.e_(manifest, opts.browser, message, browserLabel, updateSuffix || void 0, {
                         includeExtensionId: opts.includeExtensionId,
                         runLabel,
-                        profilePath: opts.profilePath
+                        profilePath: opts.profilePath,
+                        binaryPath: opts.binaryPath,
+                        binaryProvenance: opts.binaryProvenance
                     }));
                     console.log(_messages__rspack_import_5.io());
                 }
             } catch  {
+                const provenanceNote = _messages__rspack_import_5.xX(opts.binaryProvenance);
                 console.log(_messages__rspack_import_5.io());
                 console.log((0, _helpers_messaging__rspack_import_3.Nr)({
                     rows: [
                         {
                             label: 'Browser',
-                            value: browserLabel
+                            value: provenanceNote ? `${browserLabel} ${provenanceNote}` : browserLabel
+                        },
+                        {
+                            label: 'Binary',
+                            value: provenanceNote ? _messages__rspack_import_5.Yy(opts.binaryPath || '') : ''
                         },
                         {
                             label: 'Output',
-                            value: opts.outPath
+                            value: _messages__rspack_import_5.Yy(opts.outPath)
                         },
                         {
                             label: 'Profile',
-                            value: opts.profilePath || ''
+                            value: _messages__rspack_import_5.Yy(opts.profilePath || '')
                         }
                     ]
                 }));
@@ -469,59 +480,55 @@ var __webpack_modules__ = {
             return `${getLoggingPrefix('debug')} browser  banner=failed reason="${message}"`;
         }
         function skippingBrowserLaunchDueToCompileErrors() {
-            return `${getLoggingPrefix('warn')} Skip the browser launch due to compile errors.`;
+            return `${getLoggingPrefix('warn')} Skipping the browser launch, the build has compile errors.`;
         }
         function browserNotInstalledError(browser, browserBinaryLocation) {
-            const isUnreachable = 'null' === browserBinaryLocation ? `Browser ${capitalizedBrowserName(browser)} is not installed.\n` : `Can't find the path for browser ${capitalizedBrowserName(browser)}.\n`;
+            const isUnreachable = 'null' === browserBinaryLocation ? `${capitalizedBrowserName(browser)} isn't installed.\n` : `Can't find the ${capitalizedBrowserName(browser)} binary.\n`;
             const wslHint = (()=>{
                 if (!isWsl()) return '';
                 const example = '/mnt/c/Program Files/Google/Chrome/Application/chrome.exe';
-                return `\n\n${getLoggingPrefix('info')} WSL detected\n- Install a Linux browser in WSL, or\n- Provide a Windows binary path via ${pintor__rspack_import_8_default().blue('--chromium-binary')} ${pintor__rspack_import_8_default().gray(`"${example}"`)}\n  (Tip: a shell alias like ${pintor__rspack_import_8_default().gray('google-chrome=...')} won't be used by Extension.js; use a real path or wrapper script.)`;
+                return `\n\nWSL detected:\n- Install a Linux browser in WSL, or\n- Provide a Windows binary path via ${pintor__rspack_import_8_default().blue('--chromium-binary')} ${pintor__rspack_import_8_default().gray(`"${example}"`)}\n  (Tip: a shell alias like ${pintor__rspack_import_8_default().gray('google-chrome=...')} won't be used by Extension.js, use a real path or wrapper script.)`;
             })();
-            return `${getLoggingPrefix('error')} ${isUnreachable}Either install the missing browser or choose a different one via ${pintor__rspack_import_8_default().blue('--browser')} ${pintor__rspack_import_8_default().gray('<chrome|edge|firefox>')}.\n\n${pintor__rspack_import_8_default().red('NOT FOUND')} ${pintor__rspack_import_8_default().underline(browserBinaryLocation || `${capitalizedBrowserName(browser)}BROWSER`)}` + wslHint;
+            return `${getLoggingPrefix('error')} ${isUnreachable}${pintor__rspack_import_8_default().gray('NOT FOUND')} ${pintor__rspack_import_8_default().underline(browserBinaryLocation || `${capitalizedBrowserName(browser)}BROWSER`)}\nInstall the missing browser, or choose another one with ${pintor__rspack_import_8_default().blue('--browser')} ${pintor__rspack_import_8_default().gray('<chrome|edge|firefox>')}.` + wslHint;
         }
         function usingManagedChromiumFamilyFallback(requestedBrowser, fallbackBrowser, binaryPath) {
-            return `${getLoggingPrefix('info')} ${managedBrowserDisplayName(requestedBrowser)} is not installed, so the managed ${managedBrowserDisplayName(fallbackBrowser)} runs instead.\n${pintor__rspack_import_8_default().gray('PATH')} ${pintor__rspack_import_8_default().underline(binaryPath)}\nRun ${pintor__rspack_import_8_default().blue(`npx extension install ${requestedBrowser}`)} to use ${managedBrowserDisplayName(requestedBrowser)} itself.`;
-        }
-        function resolvedBrowserBinary(browser, binaryPath, versionLine) {
-            const version = versionLine && versionLine.trim().length > 0 ? versionLine.trim() : capitalizedBrowserName(browser);
-            return `${getLoggingPrefix('info')} Browser: ${version} ${pintor__rspack_import_8_default().gray('at')} ${pintor__rspack_import_8_default().underline(binaryPath)}.`;
+            return `${getLoggingPrefix('info')} ${managedBrowserDisplayName(requestedBrowser)} isn't installed, so the managed ${managedBrowserDisplayName(fallbackBrowser)} runs instead.\n${pintor__rspack_import_8_default().gray('PATH')} ${pintor__rspack_import_8_default().underline(binaryPath)}\nRun ${pintor__rspack_import_8_default().blue(`npx extension install ${requestedBrowser}`)} to use ${managedBrowserDisplayName(requestedBrowser)} itself.`;
         }
         function preferringSystemBrowserOverSnapshot(systemBinary, snapshotBinary) {
-            return `${getLoggingPrefix('info')} Use the installed browser instead of the cached Chromium snapshot (a dev-channel build).\n${pintor__rspack_import_8_default().gray('USING')} ${pintor__rspack_import_8_default().underline(systemBinary)}\n${pintor__rspack_import_8_default().gray('CACHED')} ${pintor__rspack_import_8_default().underline(snapshotBinary)}\nSet ${pintor__rspack_import_8_default().blue('EXTENSION_PREFER_CHROMIUM_SNAPSHOT=true')} to use the cached snapshot.`;
+            return `${getLoggingPrefix('info')} Using the installed browser instead of the cached Chromium snapshot (a dev-channel build).\n${pintor__rspack_import_8_default().gray('USING')} ${pintor__rspack_import_8_default().underline(systemBinary)}\n${pintor__rspack_import_8_default().gray('CACHED')} ${pintor__rspack_import_8_default().underline(snapshotBinary)}\nSet ${pintor__rspack_import_8_default().blue('EXTENSION_PREFER_CHROMIUM_SNAPSHOT=true')} to use the cached snapshot.`;
         }
         function mv2NotSupportedByChromium(extensionPath) {
-            return `${getLoggingPrefix('warn')} ${pintor__rspack_import_8_default().brightYellow('This extension declares Manifest V2, which modern Chromium refuses to load.')}\n${pintor__rspack_import_8_default().gray('PATH')} ${pintor__rspack_import_8_default().underline(extensionPath)}\nThe browser will reject it at launch (a native dialog, not a console error), so the dev session cannot attach.\nRun it on an MV2-capable browser (${pintor__rspack_import_8_default().blue('--browser firefox')}) or migrate the manifest to MV3.`;
+            return `${getLoggingPrefix('warn')} ${pintor__rspack_import_8_default().brightYellow('This extension declares Manifest V2, which modern Chromium refuses to load.')}\n${pintor__rspack_import_8_default().gray('PATH')} ${pintor__rspack_import_8_default().underline(extensionPath)}\nThe browser will reject it at launch (a native dialog, not a console error), so the dev session can't attach.\nRun it on an MV2-capable browser (${pintor__rspack_import_8_default().blue('--browser firefox')}) or migrate the manifest to MV3.`;
         }
         function mv3BackgroundScriptsNotSupportedByChromium(extensionPath) {
-            return `${getLoggingPrefix('warn')} ${pintor__rspack_import_8_default().brightYellow("This MV3 extension declares Firefox-style background.scripts with no service_worker, Chromium refuses to load it.")}\n${pintor__rspack_import_8_default().gray('PATH')} ${pintor__rspack_import_8_default().underline(extensionPath)}\nThe browser rejects it at launch with no console error, so the dev session cannot attach.\nRun it on the browser it targets (${pintor__rspack_import_8_default().blue('--browser firefox')}) or declare ${pintor__rspack_import_8_default().blue('background.service_worker')} for Chromium.`;
+            return `${getLoggingPrefix('warn')} ${pintor__rspack_import_8_default().brightYellow("This MV3 extension declares Firefox-style background.scripts with no service_worker, Chromium refuses to load it.")}\n${pintor__rspack_import_8_default().gray('PATH')} ${pintor__rspack_import_8_default().underline(extensionPath)}\nThe browser rejects it at launch with no console error, so the dev session can't attach.\nRun it on the browser it targets (${pintor__rspack_import_8_default().blue('--browser firefox')}) or declare ${pintor__rspack_import_8_default().blue('background.service_worker')} for Chromium.`;
         }
         function unsupportedManifestVersionOnChromium(extensionPath, declared) {
             const value = void 0 === declared ? 'no manifest_version' : `manifest_version ${JSON.stringify(declared)}`;
-            return `${getLoggingPrefix('warn')} ${pintor__rspack_import_8_default().brightYellow(`This extension declares ${value}, which Chromium refuses as an unsupported manifest version.`)}\n${pintor__rspack_import_8_default().gray('PATH')} ${pintor__rspack_import_8_default().underline(extensionPath)}\nThe browser rejects it at launch (a native dialog, not a console error), so the dev session cannot attach.\nDeclare ${pintor__rspack_import_8_default().blue('"manifest_version": 3')} in the source manifest.`;
+            return `${getLoggingPrefix('warn')} ${pintor__rspack_import_8_default().brightYellow(`This extension declares ${value}, which Chromium refuses as an unsupported manifest version.`)}\n${pintor__rspack_import_8_default().gray('PATH')} ${pintor__rspack_import_8_default().underline(extensionPath)}\nThe browser rejects it at launch (a native dialog, not a console error), so the dev session can't attach.\nDeclare ${pintor__rspack_import_8_default().blue('"manifest_version": 3')} in the source manifest.`;
         }
         function chromiumInvalidMatchPatterns(extensionPath, patterns) {
             const shown = patterns.slice(0, 6);
             const more = patterns.length - shown.length;
-            return `${getLoggingPrefix('warn')} ${pintor__rspack_import_8_default().brightYellow('This extension declares match patterns Chrome refuses, the whole extension will not load.')}\n${pintor__rspack_import_8_default().gray('PATH')} ${pintor__rspack_import_8_default().underline(extensionPath)}\n` + shown.map((pattern)=>`${pintor__rspack_import_8_default().gray('PATTERN')} ${pintor__rspack_import_8_default().red(pattern)}\n`).join('') + (more > 0 ? `${pintor__rspack_import_8_default().gray(`…and ${more} more`)}\n` : '') + `A match pattern's host wildcard must be ${pintor__rspack_import_8_default().blue('*')} or ${pintor__rspack_import_8_default().blue('*.domain.tld')}, ` + `a wildcard anywhere else in the host is invalid.\n` + `Replace the host with ${pintor__rspack_import_8_default().blue('*')} or ${pintor__rspack_import_8_default().blue('*.domain.tld')} in the source manifest.`;
+            return `${getLoggingPrefix('warn')} ${pintor__rspack_import_8_default().brightYellow("This extension declares match patterns Chrome refuses, the whole extension won't load.")}\n${pintor__rspack_import_8_default().gray('PATH')} ${pintor__rspack_import_8_default().underline(extensionPath)}\n` + shown.map((pattern)=>`${pintor__rspack_import_8_default().gray('PATTERN')} ${pintor__rspack_import_8_default().red(pattern)}\n`).join('') + (more > 0 ? `${pintor__rspack_import_8_default().gray(`…and ${more} more`)}\n` : '') + `A match pattern's host wildcard must be ${pintor__rspack_import_8_default().blue('*')} or ${pintor__rspack_import_8_default().blue('*.domain.tld')}, ` + `Chrome refuses a wildcard anywhere else in the host.\n` + `Replace the host with ${pintor__rspack_import_8_default().blue('*')} or ${pintor__rspack_import_8_default().blue('*.domain.tld')} in the source manifest.`;
         }
         function chromiumManifestLoadBlockers(extensionPath, blockers) {
-            return `${getLoggingPrefix('warn')} ${pintor__rspack_import_8_default().brightYellow('This manifest declares shapes Chrome refuses, the whole extension will not load.')}\n${pintor__rspack_import_8_default().gray('PATH')} ${pintor__rspack_import_8_default().underline(extensionPath)}\n` + blockers.map((blocker)=>`${pintor__rspack_import_8_default().gray('REASON')} ${pintor__rspack_import_8_default().red(blocker)}\n`).join('') + `Chrome rejects the extension at load, so no service worker or content script ever runs.\n` + "Fix these in the source manifest.";
+            return `${getLoggingPrefix('warn')} ${pintor__rspack_import_8_default().brightYellow("This manifest declares shapes Chrome refuses, the whole extension won't load.")}\n${pintor__rspack_import_8_default().gray('PATH')} ${pintor__rspack_import_8_default().underline(extensionPath)}\n` + blockers.map((blocker)=>`${pintor__rspack_import_8_default().gray('REASON')} ${pintor__rspack_import_8_default().red(blocker)}\n`).join('') + `Chrome rejects the extension at load, so no service worker or content script ever runs.\n` + "Fix these in the source manifest.";
         }
         function chromiumExtensionLoadRefused(extensionPath, reason) {
-            return `${getLoggingPrefix('error')} ${pintor__rspack_import_8_default().red('The browser refused to load this extension, so it is NOT running.')}\n${pintor__rspack_import_8_default().gray('PATH')} ${pintor__rspack_import_8_default().underline(extensionPath)}\n` + (reason ? `${pintor__rspack_import_8_default().gray('REASON')} ${pintor__rspack_import_8_default().red(reason)}\n` : '') + `No service worker, content script, or page from this extension will run, and no Extension ID was assigned.\n` + `Fix the reason above and save.\n` + "If the browser does not pick it up, restart the dev session.";
+            return `${getLoggingPrefix('error')} ${pintor__rspack_import_8_default().red("The browser refused to load this extension, so it isn't running.")}\n${pintor__rspack_import_8_default().gray('PATH')} ${pintor__rspack_import_8_default().underline(extensionPath)}\n` + (reason ? `${pintor__rspack_import_8_default().gray('REASON')} ${pintor__rspack_import_8_default().red(reason)}\n` : '') + `No service worker, content script, or page from this extension will run, and no Extension ID was assigned.\n` + `Fix the reason above and save.\n` + "If the browser doesn't pick it up, restart the dev session.";
         }
         function chromiumExtensionLoadUnconfirmed(extensionPath) {
-            return `${getLoggingPrefix('warn')} Extension.js could not confirm that the browser loaded this extension.\n${pintor__rspack_import_8_default().gray('PATH')} ${pintor__rspack_import_8_default().underline(extensionPath)}\nThis browser rejected the debugging call that loads and verifies it, so the extension may be missing.\nChrome ignores the --load-extension switch unless the DisableLoadExtensionCommandLineSwitch policy is disabled.\nOpen chrome://extensions to check whether the extension is there, and report this if it is not.`;
+            return `${getLoggingPrefix('warn')} Extension.js couldn't confirm that the browser loaded this extension.\n${pintor__rspack_import_8_default().gray('PATH')} ${pintor__rspack_import_8_default().underline(extensionPath)}\nThis browser rejected the debugging call that loads and verifies it, so the extension may be missing.\nChrome ignores the --load-extension switch unless the DisableLoadExtensionCommandLineSwitch policy is disabled.\nOpen chrome://extensions to check whether the extension is there, and report this if it isn't.`;
         }
         function geckoAddonLoadRefused(addonPath, reason) {
-            return `${getLoggingPrefix('error')} ${pintor__rspack_import_8_default().red('The browser refused to load this add-on, so it is NOT running.')}\n${pintor__rspack_import_8_default().gray('PATH')} ${pintor__rspack_import_8_default().underline(addonPath)}\n` + (reason ? `${pintor__rspack_import_8_default().gray('REASON')} ${pintor__rspack_import_8_default().red(reason)}\n` : '') + `No background script, content script, or page from this add-on will run, and no Extension ID was assigned.\n` + `Fix the reason above and save.\n` + "If the browser does not pick it up, restart the dev session.";
+            return `${getLoggingPrefix('error')} ${pintor__rspack_import_8_default().red("The browser refused to load this add-on, so it isn't running.")}\n${pintor__rspack_import_8_default().gray('PATH')} ${pintor__rspack_import_8_default().underline(addonPath)}\n` + (reason ? `${pintor__rspack_import_8_default().gray('REASON')} ${pintor__rspack_import_8_default().red(reason)}\n` : '') + `No background script, content script, or page from this add-on will run, and no Extension ID was assigned.\n` + `Fix the reason above and save.\n` + "If the browser doesn't pick it up, restart the dev session.";
         }
         function devChannelSnapshotInUse(binaryPath) {
             return `${getLoggingPrefix('warn')} ${pintor__rspack_import_8_default().brightYellow('This is a Chromium tip-of-tree snapshot (dev channel, not a stable release).')}\n${pintor__rspack_import_8_default().gray('PATH')} ${pintor__rspack_import_8_default().underline(binaryPath)}\nBehavior may differ from stable Chrome.\nInstall a stable browser or remove the snapshot to stop using it.`;
         }
         function browserLaunchError(browser, error) {
-            return `${getLoggingPrefix('error')} Error launching ${capitalizedBrowserName(browser)}:\n${pintor__rspack_import_8_default().red(errorDetail(error))}`;
+            return `${getLoggingPrefix('error')} Can't launch ${capitalizedBrowserName(browser)}.\n${pintor__rspack_import_8_default().red(errorDetail(error))}`;
         }
         function enhancedProcessManagementCleanup(browser) {
             return `${getLoggingPrefix('debug')} proc     cleanup browser=${browser}`;
@@ -530,53 +537,53 @@ var __webpack_modules__ = {
             return `${getLoggingPrefix('debug')} proc     terminate browser=${browser} mode=graceful`;
         }
         function enhancedProcessManagementForceKill(browser) {
-            return `${getLoggingPrefix('warn')} ${capitalizedBrowserName(browser)} did not exit gracefully, forcing the process to close.\nThis is a normal cleanup step and does not affect your build output.`;
+            return `${getLoggingPrefix('warn')} ${capitalizedBrowserName(browser)} didn't exit gracefully, forcing the process to close.\nThis is a normal cleanup step and doesn't affect your build output.`;
         }
         function enhancedProcessManagementCleanupError(browser, error) {
-            return `${getLoggingPrefix('error')} Error during ${capitalizedBrowserName(browser)} cleanup:\n${pintor__rspack_import_8_default().red(errorDetail(error))}`;
+            return `${getLoggingPrefix('error')} ${capitalizedBrowserName(browser)} cleanup failed.\n${pintor__rspack_import_8_default().red(errorDetail(error))}`;
         }
         function enhancedProcessManagementUncaughtException(browser, error) {
-            return `${getLoggingPrefix('error')} Uncaught exception in ${capitalizedBrowserName(browser)} process:\n${pintor__rspack_import_8_default().red(errorDetail(error))}`;
+            return `${getLoggingPrefix('error')} Uncaught exception in the ${capitalizedBrowserName(browser)} process.\n${pintor__rspack_import_8_default().red(errorDetail(error))}`;
         }
         function enhancedProcessManagementUnhandledRejection(browser, reason) {
-            return `${getLoggingPrefix('error')} Unhandled rejection in ${capitalizedBrowserName(browser)} process:\n${pintor__rspack_import_8_default().red(errorDetail(reason))}`;
+            return `${getLoggingPrefix('error')} Unhandled rejection in the ${capitalizedBrowserName(browser)} process.\n${pintor__rspack_import_8_default().red(errorDetail(reason))}`;
         }
         function generalBrowserError(browser, error) {
-            return `${getLoggingPrefix('error')} General error in ${capitalizedBrowserName(browser)}:\n${pintor__rspack_import_8_default().red(errorDetail(error))}`;
+            return `${getLoggingPrefix('error')} ${capitalizedBrowserName(browser)} hit an unexpected error.\n${pintor__rspack_import_8_default().red(errorDetail(error))}`;
         }
         function errorConnectingToBrowser(browser, port) {
             const where = 'number' == typeof port ? ` on port ${port}` : '';
-            return `${getLoggingPrefix('error')} Unable to connect to ${capitalizedBrowserName(browser)}${where} after several retries.\nAnother browser instance is usually still holding that debugging port, often one left over from an earlier dev session.\nClose ${capitalizedBrowserName(browser)} windows opened by Extension.js and run the command again, or pass ${pintor__rspack_import_8_default().blue('--profile')} ${pintor__rspack_import_8_default().gray('<path>')} to launch against a separate profile.`;
+            return `${getLoggingPrefix('error')} Can't connect to ${capitalizedBrowserName(browser)}${where} after several retries.\nAnother browser instance is usually still holding that debugging port, often one left over from an earlier dev session.\nClose ${capitalizedBrowserName(browser)} windows opened by Extension.js and run the command again, or pass ${pintor__rspack_import_8_default().blue('--profile')} ${pintor__rspack_import_8_default().gray('<path>')} to launch against a separate profile.`;
         }
         function waitingForBrowserDebugger(browser, port, attempt, maxRetries) {
-            return `${getLoggingPrefix('info')} Wait for the ${capitalizedBrowserName(browser)} debugger server on port ${port} (attempt ${attempt}/${maxRetries}).`;
+            return `${getLoggingPrefix('debug')} browser  debugger=wait target=${browser} port=${port} attempt=${attempt}/${maxRetries}`;
         }
         function addonInstallError(browser, message) {
-            return `${getLoggingPrefix('error')} Can't install add-on into ${capitalizedBrowserName(browser)}:\n${pintor__rspack_import_8_default().red(message)}`;
+            return `${getLoggingPrefix('error')} Can't install the add-on into ${capitalizedBrowserName(browser)}.\n${pintor__rspack_import_8_default().red(message)}`;
         }
         function messagingClientClosedError(browser) {
             return `${getLoggingPrefix('error')} The ${capitalizedBrowserName(browser)} messaging channel closed unexpectedly.\nThe browser exited, or its debugging connection was dropped while the dev session was still running.\nCheck whether the browser window was closed by hand, then run the command again.`;
         }
         function connectionClosedError(browser) {
-            return `${getLoggingPrefix('error')} The debugging connection to ${capitalizedBrowserName(browser)} closed unexpectedly.\nReload and HMR need that connection, so the dev session cannot keep the extension up to date.\nRestart the dev session.\nIf it keeps happening, launch with ${pintor__rspack_import_8_default().blue('--profile')} ${pintor__rspack_import_8_default().gray('<path>')} to rule out a corrupted browser profile.`;
+            return `${getLoggingPrefix('error')} The debugging connection to ${capitalizedBrowserName(browser)} closed unexpectedly.\nReload and HMR need that connection, so the dev session can't keep the extension up to date.\nRestart the dev session.\nIf it keeps happening, launch with ${pintor__rspack_import_8_default().blue('--profile')} ${pintor__rspack_import_8_default().gray('<path>')} to rule out a corrupted browser profile.`;
         }
         function targetActorHasActiveRequestError(browser, targetActor) {
             return `${getLoggingPrefix('error')} Target actor ${pintor__rspack_import_8_default().gray(targetActor)} has an active request for ${capitalizedBrowserName(browser)}.`;
         }
         function parsingPacketError(browser, error) {
-            return `${getLoggingPrefix('error')} Failed to parse packet from ${capitalizedBrowserName(browser)}:\n${pintor__rspack_import_8_default().red(errorDetail(error))}`;
+            return `${getLoggingPrefix('error')} Can't parse a message from ${capitalizedBrowserName(browser)}.\n${pintor__rspack_import_8_default().red(errorDetail(error))}`;
         }
         function messageWithoutSenderError(browser, message) {
-            return `${getLoggingPrefix('error')} Message without sender from ${capitalizedBrowserName(browser)}:\n${pintor__rspack_import_8_default().red(JSON.stringify(message))}`;
+            return `${getLoggingPrefix('error')} Received a message without a sender from ${capitalizedBrowserName(browser)}.\n${pintor__rspack_import_8_default().red(JSON.stringify(message))}`;
         }
         function chromeProcessExited(code) {
             return `${getLoggingPrefix('debug')} proc     exit browser=chrome code=${code}`;
         }
         function chromeProcessError(error) {
-            return `${getLoggingPrefix('error')} Chrome process error:\n${pintor__rspack_import_8_default().red(errorDetail(error))}`;
+            return `${getLoggingPrefix('error')} The Chrome process reported an error.\n${pintor__rspack_import_8_default().red(errorDetail(error))}`;
         }
         function chromeFailedToSpawn(error) {
-            return `${getLoggingPrefix('error')} Failed to spawn Chrome:\n${pintor__rspack_import_8_default().red(errorDetail(error))}`;
+            return `${getLoggingPrefix('error')} Can't start the Chrome process.\n${pintor__rspack_import_8_default().red(errorDetail(error))}`;
         }
         function chromeInitializingEnhancedReload() {
             return `${getLoggingPrefix('debug')} proc     enhancedReload=init spawn=direct browser=chrome`;
@@ -585,16 +592,16 @@ var __webpack_modules__ = {
             return `${getLoggingPrefix('debug')} browser  locate browser=${browser}`;
         }
         function devChromeProfilePath(path) {
-            return `${getLoggingPrefix('info')} Chrome profile: ${pintor__rspack_import_8_default().underline(path)}`;
+            return `${getLoggingPrefix('debug')} browser  profile=chrome path=${path}`;
         }
         function chromiumDryRunNotLaunching() {
-            return `${getLoggingPrefix('info')} Dry run: skip the browser launch.`;
+            return `${getLoggingPrefix('info')} Dry run: skipping the browser launch.`;
         }
         function chromiumDryRunBinary(path) {
-            return `${getLoggingPrefix('info')} Binary: ${pintor__rspack_import_8_default().underline(path)}.`;
+            return `${getLoggingPrefix('info')} ${pintor__rspack_import_8_default().gray('PATH')} ${pintor__rspack_import_8_default().underline(path)}`;
         }
         function chromiumDryRunFlags(flags) {
-            return `${getLoggingPrefix('info')} Flags: ${pintor__rspack_import_8_default().gray(flags)}.`;
+            return `${getLoggingPrefix('info')} ${pintor__rspack_import_8_default().gray('FLAGS')} ${pintor__rspack_import_8_default().gray(flags)}`;
         }
         function prettyPuppeteerInstallGuidance(browser, rawGuidance, cacheDir) {
             const dim = pintor__rspack_import_8_default().gray;
@@ -606,9 +613,7 @@ var __webpack_modules__ = {
             const finalCachePath = browserNorm && cacheDir ? node_path__rspack_import_3.join(cacheDir, browserNorm) : cacheDir;
             const installCommand = preferredManagedInstallCommand(browserNorm);
             const browserDisplay = managedBrowserDisplayName(browserNorm);
-            body.push(`${getLoggingPrefix('warn')} Browser setup required`);
-            body.push('');
-            body.push(`${browserDisplay} is not available in the managed browser cache.`);
+            body.push(`${getLoggingPrefix('warn')} ${browserDisplay} isn't available in the managed browser cache.`);
             body.push('');
             body.push(pintor__rspack_import_8_default().gray(`Install ${browserDisplay} into the managed browser cache:`));
             body.push('');
@@ -621,9 +626,9 @@ var __webpack_modules__ = {
             }
             if (finalCachePath) {
                 body.push('');
-                body.push(`${dim('INSTALL PATH')} ${pintor__rspack_import_8_default().underline(finalCachePath)}`);
+                body.push(`${dim('PATH')} ${pintor__rspack_import_8_default().underline(finalCachePath)}`);
             }
-            body.push(`${dim('NEXT')} Re-run your command after the install finishes.`);
+            body.push("Run your command again after the install finishes.");
             return `${body.join('\n')}\n`;
         }
         function firefoxLaunchCalled() {
@@ -636,16 +641,16 @@ var __webpack_modules__ = {
             return `${getLoggingPrefix('debug')} browser  args=none`;
         }
         function firefoxFailedToStart(error) {
-            return `${getLoggingPrefix('error')} Firefox failed to start:\n${pintor__rspack_import_8_default().red(errorDetail(error))}`;
+            return `${getLoggingPrefix('error')} Firefox failed to start.\n${pintor__rspack_import_8_default().red(errorDetail(error))}`;
         }
         function firefoxDryRunNotLaunching() {
-            return `${getLoggingPrefix('info')} Dry run: skip the browser launch.`;
+            return `${getLoggingPrefix('info')} Dry run: skipping the browser launch.`;
         }
         function firefoxDryRunBinary(path) {
-            return `${getLoggingPrefix('info')} Binary (detected): ${pintor__rspack_import_8_default().underline(path)}.`;
+            return `${getLoggingPrefix('info')} ${pintor__rspack_import_8_default().gray('PATH')} ${pintor__rspack_import_8_default().underline(path)}`;
         }
         function firefoxDryRunConfig(cfg) {
-            return `${getLoggingPrefix('info')} Config: ${pintor__rspack_import_8_default().gray(cfg)}.`;
+            return `${getLoggingPrefix('info')} ${pintor__rspack_import_8_default().gray('CONFIG')} ${pintor__rspack_import_8_default().gray(cfg)}`;
         }
         function safariBuildCalled() {
             return `${getLoggingPrefix('debug')} browser  build browser=safari`;
@@ -659,29 +664,29 @@ var __webpack_modules__ = {
             return `${getLoggingPrefix('warn')} Safari extensions can only be built on macOS.\nDetected ${pintor__rspack_import_8_default().gray(prettyPlatform(platform))}.\nTarget another browser via ${pintor__rspack_import_8_default().blue('--browser')} ${pintor__rspack_import_8_default().gray('<chrome|edge|firefox>')}, or run this command on a Mac with Xcode.`;
         }
         function safariPackagingSkippedNonMac(platform) {
-            return `${getLoggingPrefix('warn')} Safari packaging needs macOS with Xcode, detected ${pintor__rspack_import_8_default().gray(prettyPlatform(platform))}, so the Xcode packaging step is skipped.\nThe web-extension build in ${pintor__rspack_import_8_default().yellow('dist/safari')} is still complete and can be packaged later on a Mac with ${pintor__rspack_import_8_default().blue('extension build --browser=safari')}.`;
+            return `${getLoggingPrefix('warn')} Safari packaging needs macOS with Xcode, detected ${pintor__rspack_import_8_default().gray(prettyPlatform(platform))}, so the Xcode packaging step is skipped.\nThe web-extension build in ${pintor__rspack_import_8_default().underline('dist/safari')} is still complete and can be packaged later on a Mac with ${pintor__rspack_import_8_default().blue('extension build --browser=safari')}.`;
         }
         function safariXcodeRequired(developerDir) {
             const current = developerDir ? `${pintor__rspack_import_8_default().gray('Active toolchain:')} ${pintor__rspack_import_8_default().underline(developerDir)}` : `${pintor__rspack_import_8_default().gray('No active developer directory was found.')}`;
             return `${getLoggingPrefix('error')} Safari packaging needs the full Xcode app (not just the Command Line Tools).\n${pintor__rspack_import_8_default().red('NOT FOUND')} ${pintor__rspack_import_8_default().underline('safari-web-extension-converter')}\n${current}\n\nTo enable Safari builds:\n- Install ${pintor__rspack_import_8_default().yellow('Xcode')} from the Mac App Store, then\n- Point the toolchain at it: ${pintor__rspack_import_8_default().blue('sudo xcode-select --switch')} ${pintor__rspack_import_8_default().gray('/Applications/Xcode.app')}\n- Finish setup once: ${pintor__rspack_import_8_default().blue('xcodebuild -runFirstLaunch')}\n\nPrefer to keep building now?\nTarget another browser via ${pintor__rspack_import_8_default().blue('--browser')} ${pintor__rspack_import_8_default().gray('<chrome|edge|firefox>')}.`;
         }
         function safariToolchainMissing(tool) {
-            return `${getLoggingPrefix('error')} Safari packaging tool not found: ${pintor__rspack_import_8_default().underline(tool)}\nYour Xcode install looks incomplete.\nTry ${pintor__rspack_import_8_default().blue('xcodebuild -runFirstLaunch')}, or reinstall Xcode from the Mac App Store.`;
+            return `${getLoggingPrefix('error')} Can't find the Safari packaging tool.\n${pintor__rspack_import_8_default().gray('NOT FOUND')} ${pintor__rspack_import_8_default().underline(tool)}\nYour Xcode install looks incomplete.\nRun ${pintor__rspack_import_8_default().blue('xcodebuild -runFirstLaunch')}, or reinstall Xcode from the Mac App Store.`;
         }
         function safariConverting(extensionDir) {
-            return `${getLoggingPrefix('info')} Convert the web extension into a Safari app project from ${pintor__rspack_import_8_default().underline(extensionDir)}.`;
+            return `${getLoggingPrefix('info')} Converting the web extension into a Safari app project…\n${pintor__rspack_import_8_default().gray('PATH')} ${pintor__rspack_import_8_default().underline(extensionDir)}`;
         }
         function safariConverted(projectDir) {
-            return `${getLoggingPrefix('success')} Generated the Safari Xcode project at ${pintor__rspack_import_8_default().underline(projectDir)}.`;
+            return `${getLoggingPrefix('success')} Generated the Safari Xcode project.\n${pintor__rspack_import_8_default().gray('PATH')} ${pintor__rspack_import_8_default().underline(projectDir)}`;
         }
         function safariBuilding(scheme) {
-            return `${getLoggingPrefix('info')} Build the Safari app with xcodebuild (scheme: ${pintor__rspack_import_8_default().gray(scheme)}).`;
+            return `${getLoggingPrefix('info')} Building the Safari app with xcodebuild (scheme ${pintor__rspack_import_8_default().gray(scheme)})…`;
         }
         function safariBuilt(appPath) {
-            return `${getLoggingPrefix('success')} Built the Safari app at ${pintor__rspack_import_8_default().underline(appPath)}.`;
+            return `${getLoggingPrefix('success')} Built the Safari app.\n${pintor__rspack_import_8_default().gray('PATH')} ${pintor__rspack_import_8_default().underline(appPath)}`;
         }
         function safariOpening(target) {
-            return `${getLoggingPrefix('info')} Open ${pintor__rspack_import_8_default().underline(target)}.`;
+            return `${getLoggingPrefix('info')} Opening ${pintor__rspack_import_8_default().underline(target)}`;
         }
         function safariToolFailed(tool, exitCode, outputTail) {
             const code = null === exitCode ? 'no exit code' : `exit ${exitCode}`;
@@ -689,13 +694,13 @@ var __webpack_modules__ = {
             return `${getLoggingPrefix('error')} Safari packaging tool ${pintor__rspack_import_8_default().underline(tool)} failed (${pintor__rspack_import_8_default().red(code)}).${tail}`;
         }
         function safariConverterWarnings(warnings) {
-            return `${getLoggingPrefix('warn')} safari-web-extension-converter reported ${pintor__rspack_import_8_default().yellow(String(warnings.length))} warning(s), some manifest keys/APIs may not be supported by Safari:\n` + warnings.map((line)=>`  ${pintor__rspack_import_8_default().gray('•')} ${line}`).join('\n');
+            return `${getLoggingPrefix('warn')} safari-web-extension-converter reported ${pintor__rspack_import_8_default().yellow(String(warnings.length))} ${1 === warnings.length ? 'warning' : 'warnings'}, some manifest keys/APIs may not be supported by Safari:\n` + warnings.map((line)=>`  ${pintor__rspack_import_8_default().gray('•')} ${line}`).join('\n');
         }
         function safariDefaultBundleIdNote(bundleId) {
-            return `${getLoggingPrefix('info')} Use the generated bundle id ${pintor__rspack_import_8_default().gray(bundleId)}.\nFor an app you plan to distribute, set your own with ${pintor__rspack_import_8_default().blue('--bundle-id')} now.\nChanging it later makes Safari treat the extension as a new identity.`;
+            return `${getLoggingPrefix('info')} Using the generated bundle id ${pintor__rspack_import_8_default().gray(bundleId)}.\nFor an app you plan to distribute, set your own with ${pintor__rspack_import_8_default().blue('--bundle-id')} now.\nChanging it later makes Safari treat the extension as a new identity.`;
         }
         function safariOpenHint(appPath, appName) {
-            return `${getLoggingPrefix('info')} Launch it once to register with Safari: ${pintor__rspack_import_8_default().blue('open')} ${pintor__rspack_import_8_default().underline(`"${appPath}"`)}\nThen enable ${pintor__rspack_import_8_default().brightBlue(appName)} via Safari ▸ Develop ▸ ${pintor__rspack_import_8_default().yellow('Allow Unsigned Extensions')} and Safari ▸ Settings ▸ Extensions.`;
+            return `${getLoggingPrefix('info')} Launch it once to register with Safari: ${pintor__rspack_import_8_default().blue('open')} ${pintor__rspack_import_8_default().underline(`"${appPath}"`)}\nThen enable ${pintor__rspack_import_8_default().yellow(appName)} via Safari ▸ Develop ▸ ${pintor__rspack_import_8_default().yellow('Allow Unsigned Extensions')} and Safari ▸ Settings ▸ Extensions.`;
         }
         function safariDryRunNotBuilding() {
             return `${getLoggingPrefix('info')} Dry run: skip the Safari app build.`;
@@ -707,22 +712,22 @@ var __webpack_modules__ = {
             return `${getLoggingPrefix('info')} xcodebuild: ${pintor__rspack_import_8_default().gray(cmd)}.`;
         }
         function safariNextSteps(appName) {
-            return `${getLoggingPrefix('info')} One-time setup to load ${pintor__rspack_import_8_default().brightBlue(appName)} in Safari:\n  ${pintor__rspack_import_8_default().gray('1.')} Safari ▸ Settings ▸ Advanced ▸ check ${pintor__rspack_import_8_default().yellow('“Show features for web developers”')}\n  ${pintor__rspack_import_8_default().gray('2.')} Safari ▸ Develop ▸ ${pintor__rspack_import_8_default().yellow('Allow Unsigned Extensions')} ${pintor__rspack_import_8_default().gray('(resets each launch)')}\n  ${pintor__rspack_import_8_default().gray('3.')} Safari ▸ Settings ▸ Extensions ▸ turn on ${pintor__rspack_import_8_default().yellow(appName)}\n  ${pintor__rspack_import_8_default().gray('→')} The app window that just opened can also take you there.`;
+            return `${getLoggingPrefix('info')} One-time setup to load ${pintor__rspack_import_8_default().yellow(appName)} in Safari:\n  ${pintor__rspack_import_8_default().gray('1.')} Safari ▸ Settings ▸ Advanced ▸ check ${pintor__rspack_import_8_default().yellow('“Show features for web developers”')}\n  ${pintor__rspack_import_8_default().gray('2.')} Safari ▸ Develop ▸ ${pintor__rspack_import_8_default().yellow('Allow Unsigned Extensions')} ${pintor__rspack_import_8_default().gray('(resets each launch)')}\n  ${pintor__rspack_import_8_default().gray('3.')} Safari ▸ Settings ▸ Extensions ▸ turn on ${pintor__rspack_import_8_default().yellow(appName)}\n  ${pintor__rspack_import_8_default().gray('→')} The app window that just opened can also take you there.`;
         }
         function safariRegistered(appName) {
-            return `${getLoggingPrefix('success')} Safari recognizes ${pintor__rspack_import_8_default().brightBlue(appName)}, finish enabling it with the steps above.`;
+            return `${getLoggingPrefix('success')} Safari recognizes ${pintor__rspack_import_8_default().yellow(appName)}, finish enabling it with the steps above.`;
         }
         function safariNotYetRegistered(appName) {
-            return `${getLoggingPrefix('warn')} Safari hasn't picked up ${pintor__rspack_import_8_default().brightBlue(appName)} yet.\nOpen the app once, then check Safari ▸ Settings ▸ Extensions.`;
+            return `${getLoggingPrefix('warn')} Safari hasn't picked up ${pintor__rspack_import_8_default().yellow(appName)} yet.\nOpen the app once, then check Safari ▸ Settings ▸ Extensions.`;
         }
         function safariRebuilt(appName) {
-            return `${getLoggingPrefix('success')} Rebuilt ${pintor__rspack_import_8_default().brightBlue(appName)}, reload the page (or toggle the extension) in Safari to see changes.`;
+            return `${getLoggingPrefix('success')} Rebuilt ${pintor__rspack_import_8_default().yellow(appName)}, reload the page (or toggle the extension) in Safari to see changes.`;
         }
         function safariProjectStale() {
-            return `${getLoggingPrefix('info')} Regenerate the Xcode project, manifest.json or identity options changed since it was generated.`;
+            return `${getLoggingPrefix('info')} Regenerating the Xcode project, manifest.json or identity options changed since it was generated.`;
         }
         function safariForcedRegeneration() {
-            return `${getLoggingPrefix('info')} Regenerate the Xcode project, --force-regenerate is set.`;
+            return `${getLoggingPrefix('info')} Regenerating the Xcode project, ${pintor__rspack_import_8_default().blue('--force-regenerate')} is set.`;
         }
         function safariRegenerationDiscards(preservedKeys) {
             return `${getLoggingPrefix('warn')} Regenerating replaces the Xcode project: customizations made in Xcode (entitlements, capabilities, added files/targets) are ${pintor__rspack_import_8_default().red('discarded')}.\nPreserved automatically: ${pintor__rspack_import_8_default().yellow(preservedKeys.join(', '))}.\nIf you customized the project, back it up before continuing.`;
@@ -731,7 +736,7 @@ var __webpack_modules__ = {
             return `${getLoggingPrefix('info')} Preserved Xcode build settings across regeneration: ${pintor__rspack_import_8_default().yellow(keys.join(', '))}.\nIf any other project-level tweaks were lost, reconfigure them in Xcode.`;
         }
         function safariSkippingConversion() {
-            return `${getLoggingPrefix('info')} Skip the conversion, the Xcode project is up to date with manifest.json.`;
+            return `${getLoggingPrefix('info')} Skipping the conversion, the Xcode project is up to date with manifest.json.`;
         }
         function cdpClientFoundTargets(count) {
             return `${getLoggingPrefix('debug')} cdp      targets=${count}`;
@@ -743,7 +748,7 @@ var __webpack_modules__ = {
             return `${getLoggingPrefix('debug')} cdp      connected host=${host} port=${port}`;
         }
         function cdpClientConnectionError(error) {
-            return `${getLoggingPrefix('error')} Chrome CDP Client connection error: ${pintor__rspack_import_8_default().red(error)}`;
+            return `${getLoggingPrefix('error')} The Chrome debugging connection failed.\n${pintor__rspack_import_8_default().red(error)}`;
         }
         function cdpClientBrowserConnectionEstablished() {
             return `${getLoggingPrefix('debug')} cdp      browserConnection=established`;
@@ -752,11 +757,26 @@ var __webpack_modules__ = {
             return `${getLoggingPrefix('debug')} cdp      connection=closed`;
         }
         function cdpClientExtensionInfoFailed(extensionId, error) {
-            return `${getLoggingPrefix('error')} Chrome CDP Client: Failed to get extension info for ${pintor__rspack_import_8_default().gray(extensionId)}: ${pintor__rspack_import_8_default().red(error)}`;
+            return `${getLoggingPrefix('error')} Chrome couldn't read extension info for ${pintor__rspack_import_8_default().gray(extensionId)}.\n${pintor__rspack_import_8_default().red(error)}`;
         }
         function firefoxRdpClientConnected(host, port) {
             return `${getLoggingPrefix('debug')} rdp      connected host=${host} port=${port}`;
         }
+        function collapseHomeDirInCardValue(value) {
+            const raw = String(value || '');
+            const home = node_os__rspack_import_2.homedir();
+            if (!home || !raw.startsWith(home)) return raw;
+            const rest = raw.slice(home.length);
+            if ('' === rest) return '~';
+            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)';
+            if ('system' === provenance) return '(system, not the managed default)';
+            if ('snapshot' === provenance) return '(cached snapshot)';
+            return '';
+        }
         function runningInDevelopment(manifest, browser, message, browserVersionLine, updateSuffix, opts) {
             const capitalize = (str)=>str.charAt(0).toUpperCase() + str.slice(1);
             const manifestName = manifest.name || 'Extension.js';
@@ -775,10 +795,10 @@ var __webpack_modules__ = {
                 default:
                     browserDevToolsUrl = '';
             }
-            if (!message.data) return `${getLoggingPrefix('error')} No Client Data Received for ${manifestName}\n\n${pintor__rspack_import_8_default().red("This error happens when the program can't get the data from your extension.")}\n${pintor__rspack_import_8_default().red('There are many reasons this might happen.')}\n${pintor__rspack_import_8_default().red('To fix, ensure that:')}\n\n- Your extension is set as enabled in ${pintor__rspack_import_8_default().underline(browserDevToolsUrl)}\n- No previous ${capitalize(browser)} browser instance is open\n\nIf that is not the case, restart both the ${pintor__rspack_import_8_default().yellow(manifest.name || '')} and the\n${pintor__rspack_import_8_default().yellow('Manager Extension')} in ${pintor__rspack_import_8_default().underline(browserDevToolsUrl)} and try again.\nIf the issue still persists, please report a bug:\n` + pintor__rspack_import_8_default().underline("https://github.com/extension-js/extension.js/issues");
+            if (!message.data) return `${getLoggingPrefix('error')} No client data received for ${manifestName}.\n\n${pintor__rspack_import_8_default().red("Extension.js can't read data from your extension.")}\n${pintor__rspack_import_8_default().red('To fix, ensure that:')}\n\n- Your extension is enabled in ${pintor__rspack_import_8_default().underline(browserDevToolsUrl)}\n- No previous ${capitalize(browser)} browser instance is open\n\nIf both hold, restart the ${pintor__rspack_import_8_default().yellow(manifest.name || '')} and the\n${pintor__rspack_import_8_default().yellow('Manager Extension')} in ${pintor__rspack_import_8_default().underline(browserDevToolsUrl)} and try again.\nIf the issue persists, report a bug:\n` + pintor__rspack_import_8_default().underline("https://github.com/extension-js/extension.js/issues");
             const { id = '', management } = message.data;
             if (!management) {
-                if ((0, _helpers_messaging__rspack_import_9._o)()) return `${getLoggingPrefix('error')} No management API info received from the client for ${manifestName}.\nThe extension may not have finished loading, or the in-browser companion did not attach.`;
+                if ((0, _helpers_messaging__rspack_import_9._o)()) return `${getLoggingPrefix('error')} No management API info received from the client for ${manifestName}.\nThe extension may not have finished loading, or the in-browser companion didn't attach.`;
             }
             const { version = '' } = management;
             const extensionVersion = process.env.EXTENSION_DEVELOP_VERSION || process.env.EXTENSION_CLI_VERSION || (()=>{
@@ -788,7 +808,10 @@ var __webpack_modules__ = {
                     return 'unknown';
                 }
             })();
-            const browserLabel = (0, _helpers_messaging__rspack_import_9.A6)(String(browser || 'unknown'), resolveBrowserVersionLine(browser, browserVersionLine));
+            const baseBrowserLabel = (0, _helpers_messaging__rspack_import_9.A6)(String(browser || 'unknown'), resolveBrowserVersionLine(browser, browserVersionLine));
+            const provenanceNote = binaryProvenanceNote(opts?.binaryProvenance);
+            const browserLabel = provenanceNote ? `${baseBrowserLabel} ${provenanceNote}` : baseBrowserLabel;
+            const binaryRowValue = provenanceNote ? collapseHomeDirInCardValue(String(opts?.binaryPath || '').trim()) : '';
             const cleanId = String(id || '').trim();
             const includeExtensionId = opts?.includeExtensionId !== false;
             const updateNotice = updateSuffix ? ` ${updateSuffix}` : '';
@@ -802,6 +825,10 @@ var __webpack_modules__ = {
                         label: 'Browser',
                         value: browserLabel
                     },
+                    {
+                        label: 'Binary',
+                        value: binaryRowValue
+                    },
                     {
                         label: 'Extension',
                         value: displayVersion ? `${displayName} ${displayVersion}` : displayName
@@ -812,7 +839,7 @@ var __webpack_modules__ = {
                     },
                     {
                         label: 'Profile',
-                        value: String(opts?.profilePath || '').trim()
+                        value: collapseHomeDirInCardValue(String(opts?.profilePath || '').trim())
                     },
                     {
                         label: 'Run ID',
@@ -825,13 +852,13 @@ var __webpack_modules__ = {
             return ' ';
         }
         function devChromiumDebugPort(finalPort, requestedPort) {
-            return `${getLoggingPrefix('info')} Chromium debug port: ${pintor__rspack_import_8_default().gray(finalPort.toString())} (requested ${pintor__rspack_import_8_default().gray(requestedPort.toString())})`;
+            return `${getLoggingPrefix('debug')} browser  cdpPort=${finalPort} requested=${requestedPort}`;
         }
         function devFirefoxDebugPort(finalPort, requestedPort) {
-            return `${getLoggingPrefix('info')} Firefox debug port: ${pintor__rspack_import_8_default().gray(finalPort.toString())} (requested ${pintor__rspack_import_8_default().gray(requestedPort.toString())})`;
+            return `${getLoggingPrefix('debug')} browser  rdpPort=${finalPort} requested=${requestedPort}`;
         }
         function devFirefoxProfilePath(profilePath) {
-            return `${getLoggingPrefix('info')} Firefox profile: ${pintor__rspack_import_8_default().underline(profilePath)}`;
+            return `${getLoggingPrefix('debug')} browser  profile=firefox path=${profilePath}`;
         }
         function cdpUnifiedExtensionLog(ts, payload) {
             const data = (()=>{
@@ -844,22 +871,22 @@ var __webpack_modules__ = {
             return `[extension-log ${ts}] ${data}`;
         }
         function browserRunnerError(body) {
-            return `${getLoggingPrefix('error')} ${pintor__rspack_import_8_default().brightBlue('Browser runner error')}\n${body}`;
+            return `${getLoggingPrefix('error')} ${body}`;
         }
         function requireChromiumBinaryForChromiumBased() {
-            const body = `Configuration required\nProvide ${pintor__rspack_import_8_default().blue('--chromium-binary')} ${pintor__rspack_import_8_default().gray('<abs-path>')} when using ${pintor__rspack_import_8_default().yellow('chromium-based')}.\n`;
+            const body = `The ${pintor__rspack_import_8_default().yellow('chromium-based')} target needs a Chromium binary.\nPass ${pintor__rspack_import_8_default().blue('--chromium-binary')} ${pintor__rspack_import_8_default().gray('<abs-path>')} to choose one.\n`;
             return browserRunnerError(body);
         }
         function requireGeckoBinaryForGeckoBased() {
-            const body = `Configuration required\nProvide ${pintor__rspack_import_8_default().blue('--gecko-binary')} ${pintor__rspack_import_8_default().gray('<abs-path>')} when using ${pintor__rspack_import_8_default().yellow('gecko-based')} or ${pintor__rspack_import_8_default().yellow('firefox-based')}.\n`;
+            const body = `The ${pintor__rspack_import_8_default().yellow('gecko-based')} and ${pintor__rspack_import_8_default().yellow('firefox-based')} targets need a Firefox or Gecko binary.\nPass ${pintor__rspack_import_8_default().blue('--gecko-binary')} ${pintor__rspack_import_8_default().gray('<abs-path>')} to choose one.\n`;
             return browserRunnerError(body);
         }
         function invalidChromiumBinaryPath(p) {
-            const body = `Invalid binary path\nChromium binary not found at ${pintor__rspack_import_8_default().underline(p)}.\nProvide a working path via ${pintor__rspack_import_8_default().blue('--chromium-binary')} ${pintor__rspack_import_8_default().gray('<abs-path>')}.`;
+            const body = `Can't find a Chromium binary at the given path.\n${pintor__rspack_import_8_default().gray('NOT FOUND')} ${pintor__rspack_import_8_default().underline(p)}\nPass ${pintor__rspack_import_8_default().blue('--chromium-binary')} ${pintor__rspack_import_8_default().gray('<abs-path>')} with a working path.`;
             return browserRunnerError(body);
         }
         function invalidGeckoBinaryPath(p) {
-            const body = `Invalid binary path\nFirefox/Gecko binary not found at ${pintor__rspack_import_8_default().underline(p)}.\nProvide a working path via ${pintor__rspack_import_8_default().blue('--gecko-binary')} ${pintor__rspack_import_8_default().gray('<abs-path>')}.`;
+            const body = `Can't find a Firefox or Gecko binary at the given path.\n${pintor__rspack_import_8_default().gray('NOT FOUND')} ${pintor__rspack_import_8_default().underline(p)}\nPass ${pintor__rspack_import_8_default().blue('--gecko-binary')} ${pintor__rspack_import_8_default().gray('<abs-path>')} with a working path.`;
             return browserRunnerError(body);
         }
         function rdpInvalidRequestPayload() {
@@ -917,6 +944,7 @@ var __webpack_modules__ = {
             WV: ()=>addonInstallError,
             XH: ()=>enhancedProcessManagementTerminating,
             Xi: ()=>safariXcodeRequired,
+            Yy: ()=>collapseHomeDirInCardValue,
             Z5: ()=>cdpClientExtensionInfoFailed,
             _D: ()=>browserLaunchError,
             aI: ()=>devChromeProfilePath,
@@ -934,7 +962,6 @@ var __webpack_modules__ = {
             fd: ()=>safariRegistered,
             fw: ()=>safariOpening,
             hE: ()=>cdpClientConnectionClosed,
-            iL: ()=>resolvedBrowserBinary,
             io: ()=>emptyLine,
             iv: ()=>firefoxBinaryArgsExtracted,
             jP: ()=>rdpInvalidRequestPayload,
@@ -959,6 +986,7 @@ var __webpack_modules__ = {
             sY: ()=>creatingUserProfile,
             uK: ()=>safariConverting,
             wk: ()=>chromeFailedToSpawn,
+            xX: ()=>binaryProvenanceNote,
             xy: ()=>chromeInitializingEnhancedReload,
             y1: ()=>safariConverterWarnings,
             y7: ()=>skippingBrowserLaunchDueToCompileErrors,
@@ -1242,11 +1270,10 @@ var __webpack_modules__ = {
         var pintor__rspack_import_0_default = /*#__PURE__*/ __webpack_require__.n(pintor__rspack_import_0);
         var _helpers_messaging__rspack_import_1 = __webpack_require__("./helpers/messaging.ts");
         function ready(mode, browser) {
-            const key = String(browser || '').toLowerCase();
-            const extensionOutput = (0, _helpers_messaging__rspack_import_1.T_)(key);
-            const cap = 'firefox' === key || 'gecko-based' === key || 'firefox-based' === key ? 'Firefox' : String(browser || '').charAt(0).toUpperCase() + String(browser || '').slice(1);
-            const pretty = pintor__rspack_import_0_default().green(`ready for ${mode}`);
-            return `${(0, _helpers_messaging__rspack_import_1.Pl)('info')} ${cap} ${extensionOutput} ${pretty}.`;
+            const noun = (0, _helpers_messaging__rspack_import_1.T_)(browser);
+            const state = pintor__rspack_import_0_default().green(`ready for ${mode}`);
+            const watching = 'development' === mode ? ' Watching for file changes.' : '';
+            return `${(0, _helpers_messaging__rspack_import_1.Pl)('success')} ${noun} ${state}.${watching}`;
         }
         __webpack_require__.d(__webpack_exports__, {
             G: ()=>ready
@@ -1534,6 +1561,16 @@ var __webpack_modules__ = {
                 swappedToSystem: false
             };
         }
+        function classifyBinaryProvenance(opts) {
+            if (opts.pinnedByFlag) return 'pinned';
+            if (opts.usedManagedSnapshot) return 'snapshot';
+            const root = node_path__rspack_import_3.resolve(String(opts.managedCacheRoot || '').trim());
+            const binary = node_path__rspack_import_3.resolve(String(opts.binaryPath || '').trim());
+            if (!root || !binary) return 'system';
+            const relative = node_path__rspack_import_3.relative(root, binary);
+            const underManagedRoot = relative.length > 0 && !relative.startsWith('..') && !node_path__rspack_import_3.isAbsolute(relative);
+            return underManagedRoot ? 'managed' : 'system';
+        }
         function parseEnvBrowserFlags(raw) {
             return String(raw || '').split(/\s+/).map((flag)=>flag.trim()).filter(Boolean);
         }
@@ -1709,6 +1746,7 @@ var __webpack_modules__ = {
             J1: ()=>prepareChromiumProfileForLaunch,
             Py: ()=>mergeChromiumFeatureSwitches,
             RE: ()=>markManagedEphemeralProfile,
+            RU: ()=>classifyBinaryProvenance,
             W0: ()=>parseEnvBrowserFlags,
             ZO: ()=>isHeadlessGuardRequested,
             aY: ()=>findAvailablePortNear,
@@ -2660,7 +2698,9 @@ var __webpack_modules__ = {
                 browser: args.browser,
                 outPath: extensionOutputPath,
                 browserVersionLine: args.browserVersionLine,
-                profilePath
+                profilePath,
+                binaryPath: args.binaryPath,
+                binaryProvenance: args.binaryProvenance
             });
             if ('development' !== mode) return;
             const ready = await (0, manifest_readiness.fR)(extensionOutputPath, {
@@ -2674,7 +2714,9 @@ var __webpack_modules__ = {
                 hostPort: args.hostPort,
                 getInfo: async ()=>null,
                 browserVersionLine: args.browserVersionLine,
-                profilePath
+                profilePath,
+                binaryPath: args.binaryPath,
+                binaryProvenance: args.binaryProvenance
             });
         }
         class ChromiumLaunchPlugin {
@@ -2724,6 +2766,8 @@ var __webpack_modules__ = {
                 const browser = this.options?.browser;
                 let browserBinaryLocation = null;
                 let printedGuidance = false;
+                let binaryPinnedByFlag = false;
+                let usedManagedSnapshot = false;
                 const normalizePath = (p)=>{
                     if (!p) return null;
                     const normalized = (0, wsl_support.f7)(p);
@@ -2799,7 +2843,10 @@ var __webpack_modules__ = {
                     if (choice.swappedToSystem && choice.binary) {
                         console.log(messages.kK(choice.binary, browserBinaryLocation));
                         browserBinaryLocation = choice.binary;
-                    } else if (choice.usedManagedSnapshot) console.log(messages.JB(browserBinaryLocation));
+                    } else if (choice.usedManagedSnapshot) {
+                        usedManagedSnapshot = true;
+                        console.log(messages.JB(browserBinaryLocation));
+                    }
                 }
                 let skipDetection = Boolean(browserBinaryLocation);
                 if (!browserBinaryLocation && (0, wsl_support.EV)()) {
@@ -2908,6 +2955,7 @@ var __webpack_modules__ = {
                                 process.exit(1);
                             }
                             browserBinaryLocation = normalized;
+                            binaryPinnedByFlag = true;
                         }
                         if (!browserBinaryLocation && !skipDetection) try {
                             const env = managedEnvFor('chromium');
@@ -2970,6 +3018,7 @@ var __webpack_modules__ = {
                                 process.exit(1);
                             }
                             browserBinaryLocation = normalized;
+                            binaryPinnedByFlag = true;
                         } else {
                             console.error(messages.ne());
                             process.exit(1);
@@ -3013,7 +3062,12 @@ var __webpack_modules__ = {
                     const vLine = getBrowserVersionLine(browserBinaryLocation);
                     if (vLine && vLine.trim().length > 0) browserVersionLine = vLine.trim();
                 } catch  {}
-                console.log(messages.iL(browser, browserBinaryLocation, browserVersionLine));
+                const binaryProvenance = shared_utils.RU({
+                    binaryPath: browserBinaryLocation,
+                    managedCacheRoot: String(managedCacheRoot || ''),
+                    pinnedByFlag: binaryPinnedByFlag,
+                    usedManagedSnapshot
+                });
                 const extensionsToLoad = (0, runtime_options.fT)(this.options.extension);
                 const resolvedBrowserVersion = /(\d+(?:\.\d+){0,3})/.exec(browserVersionLine || '')?.[1];
                 for (const extPath of extensionsToLoad)try {
@@ -3067,6 +3121,8 @@ var __webpack_modules__ = {
                             port: selectedPort
                         },
                         browserVersionLine,
+                        binaryPath: browserBinaryLocation,
+                        binaryProvenance,
                         enableCdp
                     });
                 } catch  {}
@@ -3111,7 +3167,9 @@ var __webpack_modules__ = {
                         logSink: this.options.logSink,
                         bannerPrintedOnce: false,
                         cdpController: void 0,
-                        browserVersionLine
+                        browserVersionLine,
+                        binaryPath: browserBinaryLocation,
+                        binaryProvenance
                     };
                     if (enableCdp) {
                         const mod = await __webpack_require__.e(49).then(__webpack_require__.bind(__webpack_require__, "./browsers/run-chromium/chromium-launch/setup-cdp-after-launch.ts"));
@@ -4410,7 +4468,7 @@ var __webpack_modules__ = {
                 } catch (error) {
                     if (isErrorWithCode('ECONNREFUSED', error)) {
                         lastError = error;
-                        if (attempt % RETRY_LOG_EVERY_N_ATTEMPTS === 0) console.log(messages.GB(this.options.browser, port, attempt, MAX_RETRIES));
+                        if ((0, messaging._o)() && attempt % RETRY_LOG_EVERY_N_ATTEMPTS === 0) console.log(messages.GB(this.options.browser, port, attempt, MAX_RETRIES));
                         await new Promise((resolve)=>setTimeout(resolve, RETRY_INTERVAL));
                     } else {
                         const err = error;
@@ -6256,7 +6314,7 @@ var __webpack_modules__ = {
                         required: false
                     }
                 ],
-                description: 'Inspect a page or content DOM through the agent bridge (CDP-free; requires --allow-control)',
+                description: 'Inspect a page or content DOM through the agent bridge (CDP-free, requires --allow-control)',
                 supportsSourceInspection: true
             },
             {
@@ -6378,8 +6436,8 @@ var __webpack_modules__ = {
         function checkUpdates(packageJson, update) {
             const latest = String(update.latest);
             const releaseNotesUrl = `https://github.com/extension-js/extension.js/releases/tag/v${latest}`;
-            const suffix = external_pintor_default().gray(`(version ${latest} is available!)`);
-            const message = `${getLoggingPrefix('info')} 🧩 An ${external_pintor_default().blue('Extension.js')} update is available.\n\nYou are on version ${external_pintor_default().red(String(packageJson.version))}.\nThe latest stable is ${external_pintor_default().green(latest)}.\nSee what's new: ${external_pintor_default().underline(releaseNotesUrl)}\nUpdate to the latest stable to get fixes and new features.`;
+            const suffix = external_pintor_default().gray(`(version ${latest} is available)`);
+            const message = `${getLoggingPrefix('info')} An ${external_pintor_default().blue('Extension.js')} update is available.\n\nYou're on version ${external_pintor_default().red(String(packageJson.version))}.\nThe latest stable is ${external_pintor_default().green(latest)}.\nSee what's new: ${external_pintor_default().underline(releaseNotesUrl)}\nUpdate to the latest stable to get fixes and new features.`;
             return {
                 suffix,
                 message
@@ -6392,15 +6450,15 @@ Usage: extension [command] [options]
 
 Notes
 - All high-level commands offer their own \`--help\` with usage and flag lists.
-- Telemetry is anonymous and privacy-safe by default; see ${messages_code('docs/TELEMETRY.md')} for the full contract.
+- Telemetry is anonymous and privacy-safe by default, see ${messages_code('docs/TELEMETRY.md')} for the full contract.
 
 Example
 - ${messages_code('extension create --help')} outputs information about the "create" command.
 
-Available Commands
+Available commands
 ${availableCommandsBlock()}
 
-Common Options
+Common options
 - ${messages_code('--browser')} ${messages_arg('<chrome|edge|firefox|chromium|chromium-based|gecko-based|firefox-based>')} Target browser/engine (default: chromium)
 - ${messages_code('--profile')} ${messages_arg('<path|boolean>')}        Browser profile configuration
 - ${messages_code('--polyfill')} ${messages_arg('[boolean]')}            Enable/disable cross-browser polyfill
@@ -6409,23 +6467,23 @@ Common Options
 - ${messages_code('--output')} ${messages_arg('<pretty|json>')}          Result format for ${messages_code('--ai-help')} and machine-readable command results (default: pretty)
   ${messages_code('--format')} and ${messages_code('--wait-format')} still work as deprecated aliases of ${messages_code('--output')}
 - ${messages_code('--help')}                                    Show help output
-- ${messages_code('--port')} ${messages_arg('<number>')}                 Development server port (default: 8080; use 0 for OS-assigned)
-- ${messages_code('--host')} ${messages_arg('<address>')}               Dev server host (default: 127.0.0.1; use 0.0.0.0 for Docker/devcontainers)
-- ${messages_code('--public-host')} ${messages_arg('<address>')}        Connectable host the browser dials for HMR + reload bridge when it differs from ${messages_code('--host')} (remote/devcontainer; default: the bind host, or 127.0.0.1 when bound to 0.0.0.0)
+- ${messages_code('--port')} ${messages_arg('<number>')}                 Development server port (default: 8080, use 0 for OS-assigned)
+- ${messages_code('--host')} ${messages_arg('<address>')}               Dev server host (default: 127.0.0.1, use 0.0.0.0 for Docker/devcontainers)
+- ${messages_code('--public-host')} ${messages_arg('<address>')}        Connectable host the browser dials for HMR + reload bridge when it differs from ${messages_code('--host')} (remote/devcontainer, default: the bind host, or 127.0.0.1 when bound to 0.0.0.0)
 - ${messages_code('--starting-url')} ${messages_arg('<url>')}            Initial URL to load in browser
 - ${messages_code('--silent')} ${messages_arg('[boolean]')}              Suppress console output during build
 
-Browser-Specific Options
+Browser-specific options
 - ${messages_code('--chromium-binary')} ${messages_arg('<path>')}        Custom Chromium binary path
 - ${messages_code('--gecko-binary')}/${messages_code('--firefox-binary')} ${messages_arg('<path>')}           Custom Firefox/Gecko binary path
   Use ${messages_code('flatpak:org.mozilla.firefox')} as the path to launch a Flatpak-installed Firefox
 
-Build Options
+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
 
-${external_pintor_default().underline('Centralized Logger (terminal output)')}
+${external_pintor_default().underline('Centralized logger (terminal output)')}
 - The manager extension embeds a centralized logger that streams events to the CLI.
 - Enable and filter logs directly via ${messages_code('extension dev')} flags:
   - ${messages_code('--logs')} ${messages_arg('<off|error|warn|info|debug|trace>')}    Minimum level (default: off)
@@ -6440,17 +6498,17 @@ ${external_pintor_default().underline('Centralized Logger (terminal output)')}
 ${messages_code('extension --help')}
 This command outputs a help file with key command options.
 
-${external_pintor_default().underline('Path Resolution (important)')}
+${external_pintor_default().underline('Path resolution (important)')}
 - Leading ${messages_code('/')} in manifest/HTML means extension root (the directory containing ${messages_code('manifest.json')}).
 - Relative paths resolve from the ${messages_code('manifest.json')} directory.
 - Absolute OS paths are used as-is.
 
-AI Assistants
+AI assistants
 - For AI-oriented guidance and deeper tips, run ${messages_code('extension --ai-help')}
 - For machine-readable AI guidance, run ${messages_code('extension --ai-help --output json')}
 
  Report issues
- - ${external_pintor_default().underline('https://github.com/cezaraugusto/extension/issues/new')}`;
+ - ${external_pintor_default().underline('https://github.com/extension-js/extension.js/issues/new')}`;
         }
         function unsupportedBrowserFlag(value, supported) {
             return `${getLoggingPrefix('error')} Unsupported --browser value: ${value}.\n${external_pintor_default().red('Choose one of:')} ${supported.join(', ')}${external_pintor_default().red('.')}`;
@@ -6459,7 +6517,7 @@ AI Assistants
             return `${getLoggingPrefix('error')} ${flags.map(messages_code).join(', ')} only appl${1 === flags.length ? 'ies' : 'y'} to Safari targets.\nAdd ${messages_code('--browser safari')} (or ${messages_code('webkit-based')}).`;
         }
         function safariInvalidBundleId(bundleId) {
-            return `${getLoggingPrefix('error')} Invalid bundle identifier: ${messages_code(bundleId)}.\nUse reverse-DNS form: dot-separated segments of letters, digits and hyphens, each starting with a letter (e.g. ${messages_code('com.example.my-extension')}).`;
+            return `${getLoggingPrefix('error')} Can't use ${messages_code(bundleId)} as a bundle identifier.\nUse reverse-DNS form: dot-separated segments of letters, digits and hyphens, each starting with a letter (e.g. ${messages_code('com.example.my-extension')}).`;
         }
         function safariCommandNotSupported(command) {
             return `${getLoggingPrefix('error')} ${messages_code(command)} can't load an extension into Safari automatically.\nSafari extensions ship inside a signed app and are enabled by hand, so there's no live browser session to load into, unlike Chromium and Firefox.\nBuild the Safari app instead: ${messages_code('extension build --browser safari')}\nThen open the generated app and enable it in Safari → Settings → Extensions.`;
@@ -6467,30 +6525,30 @@ AI Assistants
         function programAIHelp() {
             return `\n${getLoggingPrefix('info')} ${external_pintor_default().gray('Development tips for extension developers and AI assistants')}
 
-Browser-Specific Configuration
+Browser-specific configuration
 - Use browser prefixes in manifest.json for browser-specific fields:
   ${messages_code('{"firefox:manifest": 2, "chrome:manifest": 3}')}
   This applies manifest v2 to Firefox only, v3 to Chrome/Edge.
 
-Centralized Logger (for AI & CI)
+Centralized logger (for AI & CI)
 - Logs from all contexts are centralized by the manager extension and streamed to the CLI.
 - Prefer these flags to control terminal logs during ${messages_code('extension dev')}:
   - ${messages_code('--logs')} ${messages_arg('<off|error|warn|info|debug|trace>')}    Minimum level
   - ${messages_code('--log-context')} ${messages_arg('<list|all>')}                     Contexts to include
-  - ${messages_code('--log-format')} ${messages_arg('<pretty|json|ndjson>')}            Pretty for humans; JSON for machines/NDJSON pipelines
+  - ${messages_code('--log-format')} ${messages_arg('<pretty|json|ndjson>')}            Pretty for humans, JSON for machines/NDJSON pipelines
   - ${messages_code('--no-log-timestamps')} ${messages_arg(' ')}                        Disable timestamps (pretty)
   - ${messages_code('--no-log-color')} ${messages_arg(' ')}                             Disable ANSI colors (pretty)
   - ${messages_code('--log-url')} ${messages_arg('<substring|/regex/>')}                Filter by URL
   - ${messages_code('--log-tab')} ${messages_arg('<id>')}                               Filter by tabId
 - Good CI pattern: ${messages_code('EXTENSION_DEBUG=1 EXTENSION_AUTO_EXIT_MS=6000 extension dev ./ext --logs=info --log-format=json')}
 
-Special Folders for Entrypoints
+Special folders for entrypoints
 - Use special folders to handle entrypoints and assets not declared in manifest.json:
 - ${external_pintor_default().underline(messages_code('public/'))}  - Static assets automatically copied to build (resolves to output root)
 - ${external_pintor_default().underline(messages_code('pages/'))}   - HTML files not declared in manifest (e.g., welcome pages)
 - ${external_pintor_default().underline(messages_code("scripts/"))} - JavaScript files not declared in manifest (e.g., executable scripts)
 
-Predictable Output Paths
+Predictable output paths
 - Core HTML destinations are standardized across browsers so you can reference them safely in code/tests:
   - ${messages_code('devtools_page')} → ${messages_code('devtools/index.html')}
   - ${messages_code('sidebar_action.default_panel')} (MV2) and ${messages_code('side_panel.default_path')} (MV3) → ${messages_code('sidebar/index.html')}
@@ -6504,31 +6562,31 @@ Predictable Output Paths
   - ${messages_code("user_scripts.api_script")} → ${messages_code("user_scripts/api_script.js")}
   - ${messages_code('icons/*')} → ${messages_code('icons/')} (feature-specific icon folders preserved where applicable)
 
-Public & Special Folders (Output Behavior)
+Public & special folders (output behavior)
 - ${external_pintor_default().underline(messages_code('public/'))} is the web root in output. Authors can use ${messages_code('/foo')}, ${messages_code('/public/foo')}, ${messages_code('public/foo')}, or ${messages_code('./public/foo')} and they all emit as ${messages_code('dist/<browser>/foo')}.
-- ${external_pintor_default().underline(messages_code('pages/'))} files emit as ${messages_code('pages/<name>.html')}. Relative assets referenced inside page HTML are emitted under ${messages_code('assets/')} preserving relative structure; public-root URLs are preserved.
+- ${external_pintor_default().underline(messages_code('pages/'))} files emit as ${messages_code('pages/<name>.html')}. Relative assets referenced inside page HTML are emitted under ${messages_code('assets/')} preserving relative structure, public-root URLs are preserved.
 - ${external_pintor_default().underline(messages_code("scripts/"))} files emit as ${messages_code("scripts/<name>.js")} with extracted CSS when applicable.
 
-Shadow DOM for Content Scripts
+Shadow DOM for content scripts
 - Add ${messages_code('use shadow-dom')} directive to content scripts for style isolation
 - Automatically creates ${messages_code('#extension-root')} element with shadow DOM
 - All CSS imports are automatically injected into shadow DOM
 - Prevents style conflicts with host page
 
-Environment Variables
+Environment variables
 - Use ${messages_code(messages_arg('EXTENSION_PUBLIC_*'))} prefix for variables accessible in extension code
 - Supported in both ${messages_code('process.env')} and ${messages_code('import.meta.env')}
 - Environment file priority: ${external_pintor_default().underline(messages_code(messages_arg('.env.{browser}.{mode}')))} > ${external_pintor_default().underline(messages_code(messages_arg('.env.{browser}')))} > ${external_pintor_default().underline(messages_code(messages_arg('.env.{mode}')))} > ${external_pintor_default().underline(messages_code(messages_arg('.env')))}
 - Example: ${messages_code(messages_arg('EXTENSION_PUBLIC_API_KEY=your_key'))}
 
-Available Templates
+Available templates
 - ${external_pintor_default().green('Frameworks')}: ${messages_code(messages_arg('react'))}, ${messages_code(messages_arg('preact'))}, ${messages_code(messages_arg('vue'))}, ${messages_code(messages_arg('svelte'))}
 - ${external_pintor_default().green('Languages')}: ${messages_code(messages_arg("javascript"))}, ${messages_code(messages_arg("typescript"))}
 - ${external_pintor_default().green('Contexts')}: ${messages_code(messages_arg('content'))} (content scripts), ${messages_code(messages_arg('new'))} (new tab), ${messages_code(messages_arg('action'))} (popup)
 - ${external_pintor_default().green('Styling')}: ${messages_code(messages_arg('tailwind'))}, ${messages_code(messages_arg('sass'))}, ${messages_code(messages_arg('less'))}
 - ${external_pintor_default().green('Configs')}: ${messages_code(messages_arg('eslint'))}, ${messages_code(messages_arg('prettier'))}, ${messages_code(messages_arg('stylelint'))}
 
-Webpack/Rspack Configuration
+Webpack/Rspack configuration
 - Create ${external_pintor_default().underline(messages_code(messages_arg('extension.config.js')))} for custom webpack configuration
 - Function receives base config, return modified config
 - Supports all webpack/rspack loaders and plugins
@@ -6540,14 +6598,14 @@ Webpack/Rspack Configuration
   ${messages_code('  }')}
   ${messages_code('}')}
 
-Managed Dependencies (Important)
+Managed dependencies (important)
 - ${external_pintor_default().green('Do not add')} packages that ${external_pintor_default().blue('Extension.js')} already ships in its own toolchain.
 - The guard only triggers when a managed package is declared in your ${messages_code('package.json')} ${external_pintor_default().gray('and')} is imported (as a module specifier) in your ${external_pintor_default().underline(messages_code('extension.config.js'))}.
 - In that case, the program will ${external_pintor_default().red('print an error and abort')} to avoid version conflicts.
 - Remove the duplicate from your project ${messages_code('package.json')} or avoid referencing it in ${external_pintor_default().underline(messages_code('extension.config.js'))} and rely on the built-in version instead.
 - If you truly need a different version, open an issue so we can evaluate a safe upgrade.
 
-Framework-Specific Configuration
+Framework-specific configuration
 - Create ${external_pintor_default().underline(messages_code(messages_arg('vue.loader.js')))} for Vue-specific loader configuration
 - Create ${external_pintor_default().underline(messages_code(messages_arg('svelte.loader.js')))} for Svelte-specific loader configuration
 - Automatically detected and used by Extension.js
@@ -6561,26 +6619,26 @@ Framework-Specific Configuration
 Hot Module Replacement (HMR)
 - Automatically enabled in development mode
 - CSS changes trigger automatic style updates
-- React components fast-refresh; Svelte components hot-update
+- React components fast-refresh, Svelte components hot-update
 - Preact and Vue rebuild with a live reload (component state resets)
 - Content scripts automatically re-inject on changes
 - Service workers, _locales and manifest changes reload the extension
 
-Non-Destructive Testing in CI
+Non-destructive testing in CI
 - Prefer ${messages_code('EXTENSION_DEBUG=1')} to copy local templates and avoid network.
 - Reuse Playwright's Chromium via ${messages_code('--chromium-binary')} path when available.
 - Set ${messages_code(messages_arg('EXTENSION_AUTO_EXIT_MS'))} and ${messages_code(messages_arg('EXTENSION_FORCE_KILL_MS'))} for non-interactive dev sessions.
 
-File Watching & HMR Examples
-- Content script JS/TS changes trigger reinjection; CSS changes update styles live.
+File watching & HMR examples
+- Content script JS/TS changes trigger reinjection, CSS changes update styles live.
 - For watch-source HTML prints, update a visible string in ${messages_code("content/scripts.*")} and assert it appears in stdout.
 
 Troubleshooting
-- Use ${messages_code('--silent true')} during builds to reduce noise; logs still surface errors.
+- Use ${messages_code('--silent true')} during builds to reduce noise, logs still surface errors.
 - When ports conflict, pass ${messages_code('--port 0')} to auto-select an available port.
 - In Docker/devcontainers, pass ${messages_code('--host 0.0.0.0')} so the dev server is reachable from the host.
 
-Non-Interactive / Auto Mode (CI)
+Non-interactive / auto mode (CI)
 - Set ${messages_code(messages_arg('EXTENSION_AUTO_EXIT_MS'))} to enable self-termination after N milliseconds.
   Useful when ${messages_code('pnpm extension dev')} would otherwise hang under Rspack watch.
   Example: ${messages_code(messages_arg('EXTENSION_AUTO_EXIT_MS=6000'))} pnpm extension dev ./templates/react --browser chrome --starting-url ${messages_arg('https://example.com')}
@@ -6597,7 +6655,7 @@ Flatpak Firefox
 - Use ${messages_code('--gecko-binary flatpak:org.mozilla.firefox')} (or ${messages_code('--firefox-binary')}) to launch a Flatpak-installed Firefox.
 - Extension.js rewrites the binary path to ${messages_code('flatpak run')} with the correct filesystem grants automatically.
 
-Cross-Browser Compatibility
+Cross-browser compatibility
 - Use ${messages_code('--polyfill')} flag to enable webextension-polyfill
 - Automatically handles browser API differences
 - Supports Chrome, Edge, Firefox with single codebase`;
@@ -6687,7 +6745,7 @@ Cross-Browser Compatibility
                     readyContract: {
                         readyPath: 'dist/extension-js/<browser>/ready.json',
                         eventsPath: 'dist/extension-js/<browser>/events.ndjson',
-                        waitFlag: '--wait blocks until ready.json reports ready (or error) then exits; pair with --output json for machine output (--wait-format is a deprecated alias)',
+                        waitFlag: '--wait blocks until ready.json reports ready (or error) then exits, pair with --output json for machine output (--wait-format is a deprecated alias)',
                         statuses: [
                             'starting',
                             'ready',
@@ -6752,7 +6810,7 @@ Cross-Browser Compatibility
             };
         }
         function invalidAIHelpFormat(value) {
-            return `${getLoggingPrefix('error')} Invalid value for ${messages_code('--output')}: ${external_pintor_default().red(String(value))}.\n${external_pintor_default().red('Pass')} ${messages_arg('pretty')} ${external_pintor_default().red('or')} ${messages_arg('json')}${external_pintor_default().red(', for example')} ${messages_code('extension --ai-help --output json')}${external_pintor_default().red('.')}`;
+            return `${getLoggingPrefix('error')} Can't use ${external_pintor_default().red(String(value))} as a value for ${messages_code('--output')}.\n${external_pintor_default().red('Pass')} ${messages_arg('pretty')} ${external_pintor_default().red('or')} ${messages_arg('json')}${external_pintor_default().red(', for example')} ${messages_code('extension --ai-help --output json')}${external_pintor_default().red('.')}`;
         }
         function removedNoRunnerFlag() {
             return `${getLoggingPrefix('error')} ${messages_code('--no-runner')} was removed.\nUse ${messages_code('--no-browser')} instead.`;
@@ -6761,7 +6819,7 @@ Cross-Browser Compatibility
             return `${getLoggingPrefix('warn')} ${messages_code(flag)} is deprecated and maps to ${messages_code('--output')}.\nPass ${messages_code('--output')} ${messages_arg('<pretty|json>')} instead.`;
         }
         function noBrowserNotSupportedForCommand(command) {
-            return `${getLoggingPrefix('error')} ${messages_code('--no-browser')} is only supported for ${messages_code('dev')}, ${messages_code('start')}, and ${messages_code('preview')}.\nReceived command: ${messages_code(command || '(none)')}`;
+            return `${getLoggingPrefix('error')} ${messages_code('--no-browser')} is only supported for ${messages_code('dev')}, ${messages_code('start')}, and ${messages_code('preview')}.\n${messaging.Sc.label('GOT')} ${messages_code(command || '(none)')}`;
         }
         function readRecentConsole(projectPath, browser, target, limit) {
             const file = external_node_path_default().resolve(projectPath, 'dist', 'extension-js', browser, 'logs.ndjson');
@@ -7440,6 +7498,29 @@ Cross-Browser Compatibility
             if (refs) error.refs = refs;
             return messaging.Pr.fail(command, 'usage', error);
         }
+        const SUGGESTION_PATTERN = /\(Did you mean (one of )?(.+)\?\)/;
+        function sentenceCase(input) {
+            const trimmed = input.trim();
+            const capitalized = trimmed.charAt(0).toUpperCase() + trimmed.slice(1);
+            return /[.!?]$/.test(capitalized) ? capitalized : `${capitalized}.`;
+        }
+        function commanderHumanError(err, command) {
+            const commanderCode = String(err.code);
+            const message = String(err.message || 'the command line could not be parsed').replace(/^error:\s*/i, '').trim();
+            const refs = refsFromMessage(commanderCode, message);
+            let label;
+            let noun = 'options';
+            if ('commander.unknownOption' === commanderCode && refs?.flag) label = `Unknown option ${refs.flag}.`;
+            else if ('commander.unknownCommand' === commanderCode && refs?.command) {
+                label = `Unknown command ${refs.command}.`;
+                noun = 'commands';
+            } else if ('commander.optionMissingArgument' === commanderCode && refs?.flag) label = `Missing value for ${refs.flag}.`;
+            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}.`;
+            return `${(0, messaging.Pl)('error')} ${label}\n${remedy}`;
+        }
         function internalErrorEnvelope(err, command) {
             return messaging.Pr.fail(command, 'failed', {
                 code: messaging.Lp.E_INTERNAL,
@@ -9217,7 +9298,9 @@ Cross-Browser Compatibility
             process.env.EXTENSION_CLI_UPDATE_SUFFIX = updateMessage.suffix;
         });
         const extensionJs = external_commander_namespaceObject.program;
-        extensionJs.name(String(index_cliPackageJson.name)).description(String(index_cliPackageJson.description)).version(String(index_cliPackageJson.version)).option('--no-telemetry', 'disable anonymous telemetry for this run').option('--ai-help', 'show AI-assistant oriented help and tips').addOption(new external_commander_namespaceObject.Option('--format <pretty|json>').hideHelp()).addHelpText('after', programUserHelp()).showHelpAfterError(true).showSuggestionAfterError(true).exitOverride();
+        extensionJs.name(String(index_cliPackageJson.name)).description(String(index_cliPackageJson.description)).version(String(index_cliPackageJson.version)).option('--no-telemetry', 'disable anonymous telemetry for this run').option('--ai-help', 'show AI-assistant oriented help and tips').addOption(new external_commander_namespaceObject.Option('--format <pretty|json>').hideHelp()).addHelpText('after', programUserHelp()).configureOutput({
+            outputError: ()=>{}
+        }).showSuggestionAfterError(true).exitOverride();
         registerCreateCommand(extensionJs);
         registerDevCommand(extensionJs);
         registerStartCommand(extensionJs);
@@ -9263,6 +9346,7 @@ Cross-Browser Compatibility
                         const exitCode = commanderExitCode(err);
                         if (0 === exitCode) process.exit(0);
                         markCommandFailure();
+                        console.error(commanderHumanError(err, commandName));
                         if (asJson) writeStdoutFrame(commanderErrorEnvelope(err, commandName));
                         process.exit(exitCode);
                     }