extension 3.14.0-next.0 → 3.14.0

package/dist/cli.cjs

@@ -5152,7 +5152,8 @@ var __webpack_exports__ = {};
         preview: 'Previews the extension in production mode without building',
         build: 'Builds the extension for packaging/distribution',
         install: 'Installs a managed browser binary into Extension.js cache',
-        uninstall: 'Removes managed browser binaries from Extension.js cache'
+        uninstall: 'Removes managed browser binaries from Extension.js cache',
+        telemetry: 'Manage anonymous telemetry consent (enable, disable, or show status)'
     };
     function unhandledError(err) {
         const message = err instanceof Error ? err.stack || err.message : 'string' == typeof err ? err : fmt.truncate(err);
@@ -5212,11 +5213,14 @@ Available Commands
 - ${code('extension uninstall --where')}
   Prints the managed browser cache root (or browser install path(s) when --browser/--all is provided)
 
+- ${code('extension telemetry ' + messages_arg('<enable|disable|status>'))}
+  ${commandDescriptions.telemetry}
+
 Common Options
 - ${code('--browser')} ${messages_arg('<chrome|edge|firefox|chromium|chromium-based|gecko-based|firefox-based>')} Target browser/engine (default: chromium)
 - ${code('--profile')} ${messages_arg('<path|boolean>')}        Browser profile configuration
 - ${code('--polyfill')} ${messages_arg('[boolean]')}            Enable/disable cross-browser polyfill
-- ${code('--no-telemetry')}                            Disable anonymous telemetry for this run
+- ${code('--no-telemetry')}                            Disable anonymous telemetry for this run (persistent toggle: ${code('extension telemetry disable')}, or ${code('EXTENSION_TELEMETRY=0')})
 - ${code('--ai-help')}                                 Show AI-assistant oriented help and tips
 - ${code('--format')} ${messages_arg('<pretty|json>')}          Output format for ${code('--ai-help')} (default: pretty)
 - ${code('--help')}                                    Show help output
@@ -5485,6 +5489,11 @@ Cross-Browser Compatibility
                     name: 'uninstall',
                     summary: commandDescriptions.uninstall,
                     supportsSourceInspection: false
+                },
+                {
+                    name: 'telemetry',
+                    summary: commandDescriptions.telemetry,
+                    supportsSourceInspection: false
                 }
             ],
             globalOptions: [
@@ -5503,7 +5512,7 @@ Cross-Browser Compatibility
                 },
                 {
                     name: '--no-telemetry',
-                    description: 'Disable anonymous telemetry for this run'
+                    description: 'Disable anonymous telemetry for this run. Persistent toggle: `extension telemetry disable`. Hard override: `EXTENSION_TELEMETRY=0`.'
                 },
                 {
                     name: '--browser',
@@ -5783,6 +5792,12 @@ Cross-Browser Compatibility
         else obj[key] = value;
         return obj;
     }
+    const DEFAULT_SAMPLE_RATE = Number(process.env.EXTENSION_TELEMETRY_SAMPLE_RATE || 0.2);
+    const DEFAULT_MAX_EVENTS = Number(process.env.EXTENSION_TELEMETRY_MAX_EVENTS || 3);
+    const DEFAULT_DEBOUNCE_MS = Number(process.env.EXTENSION_TELEMETRY_DEBOUNCE_MS || 60000);
+    const DEFAULT_TIMEOUT_MS = Number(process.env.EXTENSION_TELEMETRY_TIMEOUT_MS || 300);
+    const DEFAULT_POSTHOG_KEY = process.env.POSTHOG_KEY || '';
+    const DEFAULT_POSTHOG_HOST = process.env.POSTHOG_HOST || 'https://us.i.posthog.com';
     function isCI() {
         const v = process.env;
         return Boolean(v.CI || v.GITHUB_ACTIONS || v.GITLAB_CI || v.BUILDKITE || v.CIRCLECI || v.TRAVIS);
@@ -5826,16 +5841,6 @@ Cross-Browser Compatibility
             return false;
         }
     }
-    function loadOrCreateId(file) {
-        try {
-            if (external_node_fs_default().existsSync(file)) return external_node_fs_default().readFileSync(file, 'utf8').trim();
-        } catch  {}
-        const id = external_node_crypto_default().randomUUID();
-        if (ensureDir(external_node_path_default().dirname(file))) try {
-            external_node_fs_default().writeFileSync(file, id, 'utf8');
-        } catch  {}
-        return id;
-    }
     function telemetryCandidates() {
         const candidates = [
             configDir(),
@@ -5857,44 +5862,107 @@ Cross-Browser Compatibility
         }
         return null;
     }
-    const DEFAULT_FLUSH_AT = Number(process.env.EXTENSION_TELEMETRY_FLUSH_AT || 10);
-    const DEFAULT_FLUSH_INTERVAL = Number(process.env.EXTENSION_TELEMETRY_FLUSH_INTERVAL || 2000);
-    const DEFAULT_TIMEOUT_MS = Number(process.env.EXTENSION_TELEMETRY_TIMEOUT_MS || 200);
-    const DEFAULT_POSTHOG_KEY = process.env.POSTHOG_KEY || 'phc_Np5x3Jg3h2V7kTFtNch2uz6QBaWDycQpIidzX5PetaN';
-    const DEFAULT_POSTHOG_HOST = process.env.POSTHOG_HOST || 'https://us.i.posthog.com';
-    class Telemetry {
-        track(event, props = {}) {
-            if (this.disabled || !this.storage) return;
-            const payload = {
-                event,
-                properties: {
-                    ...this.common,
-                    ...props,
-                    $ip: null
-                },
-                distinct_id: this.anonId
+    function loadOrCreateId(file) {
+        try {
+            if (external_node_fs_default().existsSync(file)) return external_node_fs_default().readFileSync(file, 'utf8').trim();
+        } catch  {}
+        const id = external_node_crypto_default().randomUUID();
+        if (ensureDir(external_node_path_default().dirname(file))) try {
+            external_node_fs_default().writeFileSync(file, id, 'utf8');
+        } catch  {}
+        return id;
+    }
+    function readConsentFile(file) {
+        try {
+            const raw = external_node_fs_default().readFileSync(file, 'utf8').trim().toLowerCase();
+            if ('enabled' === raw || 'ok' === raw || 'on' === raw || '1' === raw) return 'enabled';
+            if ('disabled' === raw || 'off' === raw || '0' === raw || 'no' === raw) return 'disabled';
+        } catch  {}
+        return null;
+    }
+    function envDisables() {
+        const disabled = String(process.env.EXTENSION_TELEMETRY_DISABLED ?? '').trim().toLowerCase();
+        if ('1' === disabled || 'true' === disabled || 'on' === disabled || 'yes' === disabled) return true;
+        const raw = String(process.env.EXTENSION_TELEMETRY ?? '').trim().toLowerCase();
+        if (!raw) return false;
+        return '0' === raw || 'false' === raw || 'off' === raw || 'no' === raw;
+    }
+    function resolveTelemetryConsent(argv = process.argv) {
+        if (envDisables()) return {
+            enabled: false,
+            source: 'env'
+        };
+        if (argv.includes('--no-telemetry')) return {
+            enabled: false,
+            source: 'flag'
+        };
+        const storage = resolveTelemetryStorage();
+        if (storage) {
+            const stored = readConsentFile(storage.consentFile);
+            if ('enabled' === stored) return {
+                enabled: true,
+                source: 'config'
+            };
+            if ('disabled' === stored) return {
+                enabled: false,
+                source: 'config'
             };
+        }
+        return {
+            enabled: true,
+            source: 'default'
+        };
+    }
+    function writeConsent(value) {
+        const storage = resolveTelemetryStorage();
+        if (!storage) return false;
+        try {
+            external_node_fs_default().writeFileSync(storage.consentFile, value, 'utf8');
+            return true;
+        } catch  {
+            return false;
+        }
+    }
+    class Telemetry {
+        get isEnabled() {
+            return !this.disabled;
+        }
+        track(event, props) {
             try {
-                external_node_fs_default().appendFileSync(this.storage.auditFile, JSON.stringify(payload) + '\n');
-            } catch  {
-                this.disabled = true;
-                return;
-            }
-            if (this.debug) console.error('[telemetry]', JSON.stringify(payload));
-            if (!this.apiKey || !this.host) return;
-            if ('cli_shutdown' === event) return void this.buffer.push(payload);
-            this.buffer.push(payload);
-            if (this.buffer.length >= DEFAULT_FLUSH_AT) return void this.flush();
-            if (!this.timer) this.timer = setTimeout(()=>{
-                this.timer = null;
-                this.flush();
-            }, DEFAULT_FLUSH_INTERVAL);
+                if (this.disabled) return;
+                if (this.sent >= this.maxEventsPerRun) return;
+                const key = `${event}|${props.command}|${props.success}`;
+                const now = Date.now();
+                const last = this.recent.get(key);
+                if (null != last && now - last < this.debounceMs) return;
+                this.recent.set(key, now);
+                const enforcedProps = {
+                    command: String(props.command ?? 'unknown').slice(0, 32),
+                    success: Boolean(props.success),
+                    version: String(props.version ?? this.version).slice(0, 32)
+                };
+                const payload = {
+                    event,
+                    properties: {
+                        ...enforcedProps,
+                        ...this.common,
+                        app: this.app,
+                        $ip: null
+                    },
+                    distinct_id: this.anonId
+                };
+                this.writeAudit(payload);
+                if ('command_executed' === event && Math.random() > this.sampleRate) return;
+                if (!this.apiKey || !this.host) return;
+                this.buffer.push(payload);
+                this.sent += 1;
+            } catch  {}
         }
         async flush() {
-            if (this.disabled || !this.apiKey || !this.host) return;
-            if (0 === this.buffer.length) return;
-            const batch = this.buffer.splice(0, this.buffer.length);
             try {
+                if (this.disabled || !this.apiKey || !this.host) return;
+                if (0 === this.buffer.length) return;
+                const batch = this.buffer.splice(0, this.buffer.length);
                 const ac = new AbortController();
                 const t = setTimeout(()=>ac.abort(), DEFAULT_TIMEOUT_MS);
                 const url = new URL('/capture/', this.host);
@@ -5918,299 +5986,140 @@ Cross-Browser Compatibility
             } catch  {}
         }
         shutdown() {}
+        writeAudit(payload) {
+            if (!this.storage) return;
+            try {
+                external_node_fs_default().appendFileSync(this.storage.auditFile, JSON.stringify(payload) + '\n');
+            } catch  {
+                this.disabled = true;
+            }
+            if (this.debug) console.error('[telemetry]', JSON.stringify(payload));
+        }
         constructor(init){
-            _define_property(this, "anonId", void 0);
-            _define_property(this, "common", void 0);
-            _define_property(this, "debug", void 0);
             _define_property(this, "disabled", void 0);
+            _define_property(this, "version", void 0);
+            _define_property(this, "app", void 0);
             _define_property(this, "apiKey", void 0);
             _define_property(this, "host", void 0);
+            _define_property(this, "anonId", 'disabled');
             _define_property(this, "storage", null);
+            _define_property(this, "sent", 0);
+            _define_property(this, "sampleRate", void 0);
+            _define_property(this, "maxEventsPerRun", void 0);
+            _define_property(this, "debounceMs", void 0);
+            _define_property(this, "debug", void 0);
+            _define_property(this, "common", void 0);
+            _define_property(this, "recent", new Map());
             _define_property(this, "buffer", []);
-            _define_property(this, "timer", null);
             this.debug = '1' === process.env.EXTENSION_TELEMETRY_DEBUG;
             this.disabled = Boolean(init.disabled);
-            this.anonId = 'disabled';
-            if (!this.disabled) {
-                this.storage = resolveTelemetryStorage();
-                if (this.storage) this.anonId = loadOrCreateId(this.storage.idFile);
-                else this.disabled = true;
-            }
+            this.app = init.app;
+            this.version = init.version;
+            this.apiKey = init.apiKey ?? DEFAULT_POSTHOG_KEY;
+            this.host = init.host ?? DEFAULT_POSTHOG_HOST;
+            this.sampleRate = clamp(init.sampleRate ?? DEFAULT_SAMPLE_RATE, 0, 1);
+            this.maxEventsPerRun = Math.max(0, init.maxEventsPerRun ?? DEFAULT_MAX_EVENTS);
+            this.debounceMs = Math.max(0, init.debounceMs ?? DEFAULT_DEBOUNCE_MS);
             this.common = {
-                app: init.app,
-                version: init.version,
                 os: process.platform,
                 arch: process.arch,
-                node: process.versions.node,
-                is_ci: isCI(),
-                schema_version: 2
+                node_major: Number(String(process.versions.node).split('.')[0]) || 0,
+                is_ci: isCI()
             };
-            this.apiKey = init.apiKey || DEFAULT_POSTHOG_KEY;
-            this.host = init.host || DEFAULT_POSTHOG_HOST;
-            if (!this.disabled && this.storage) {
-                const consentPath = this.storage.consentFile;
-                try {
-                    if (!external_node_fs_default().existsSync(consentPath)) {
-                        external_node_fs_default().writeFileSync(consentPath, 'ok', 'utf8');
-                        this.track('cli_telemetry_consent', {
-                            value: 'implicit_opt_in'
-                        });
-                        console.log(`${external_pintor_default().gray('⏵⏵⏵')} Telemetry is enabled for Extension.js. To opt out, run with --no-telemetry. Learn more in TELEMETRY.md.`);
-                    }
-                } catch  {}
+            if (!this.disabled) {
+                this.storage = resolveTelemetryStorage();
+                if (this.storage) this.anonId = loadOrCreateId(this.storage.idFile);
             }
         }
     }
-    function summarizeManifest(manifest) {
-        const mv = manifest?.manifest_version === 2 ? 2 : 3;
-        const permissions = Array.isArray(manifest?.permissions) ? manifest.permissions : [];
-        const optionalPermissions = Array.isArray(manifest?.optional_permissions) ? manifest.optional_permissions : [];
-        const hostPermissions = Array.isArray(manifest?.host_permissions) ? manifest.host_permissions : [];
-        const usesAllUrls = [
-            ...permissions,
-            ...hostPermissions
-        ].includes('<all_urls>');
-        const usesDeclarativeNetRequest = permissions.includes('declarativeNetRequest') || permissions.includes('declarativeNetRequestWithHostAccess');
-        const background = manifest?.background;
-        let backgroundType = 'none';
-        if (3 === mv && background?.service_worker) backgroundType = 'service_worker';
-        else if (2 === mv && (Array.isArray(background?.scripts) && background.scripts.length > 0 || background?.page)) backgroundType = 'event_page';
-        const contentScriptsCount = Array.isArray(manifest?.content_scripts) ? manifest.content_scripts.length : 0;
-        const hasDevtoolsPage = Boolean(manifest?.devtools_page);
-        const hasActionPopup = Boolean(manifest?.action?.default_popup);
-        return {
-            mv,
-            permissions_count: permissions.length,
-            optional_permissions_count: optionalPermissions.length,
-            host_permissions_count: hostPermissions.length,
-            uses_all_urls: usesAllUrls,
-            uses_declarative_net_request: usesDeclarativeNetRequest,
-            background_type: backgroundType,
-            content_scripts_count: contentScriptsCount,
-            has_devtools_page: hasDevtoolsPage,
-            has_action_popup: hasActionPopup
-        };
-    }
-    function safeReadJson(filePath) {
-        try {
-            if (!external_node_fs_default().existsSync(filePath)) return null;
-            return JSON.parse(external_node_fs_default().readFileSync(filePath, 'utf8'));
-        } catch  {
-            return null;
-        }
+    function clamp(n, min, max) {
+        if (!Number.isFinite(n)) return min;
+        return Math.min(Math.max(n, min), max);
     }
-    function findNearestPackageJson(startPath) {
-        let current = external_node_path_default().resolve(startPath);
-        for(let i = 0; i < 6; i += 1){
-            const candidate = external_node_path_default().join(current, 'package.json');
-            if (external_node_fs_default().existsSync(candidate)) return candidate;
-            const parent = external_node_path_default().dirname(current);
-            if (parent === current) break;
-            current = parent;
+    const KNOWN_COMMANDS = new Set([
+        'create',
+        'dev',
+        'start',
+        'preview',
+        'build',
+        'install',
+        'uninstall',
+        'telemetry',
+        'unknown'
+    ]);
+    function detectInvokedCommand(argv) {
+        for(let i = 2; i < argv.length; i += 1){
+            const arg = argv[i];
+            if (!(!arg || arg.startsWith('-'))) {
+                if (KNOWN_COMMANDS.has(arg)) return arg;
+                break;
+            }
         }
-        return null;
-    }
-    function getDependencies(pkg) {
-        return {
-            ...pkg.dependencies || {},
-            ...pkg.devDependencies || {},
-            ...pkg.peerDependencies || {}
-        };
-    }
-    function hasDependency(pkg, dependencyId) {
-        const deps = getDependencies(pkg);
-        return Boolean(deps[dependencyId]);
-    }
-    function detectPackageManager(projectRoot, pkg) {
-        const declared = String(pkg.packageManager || '').trim().toLowerCase();
-        if (declared.startsWith('pnpm@')) return 'pnpm';
-        if (declared.startsWith('yarn@')) return 'yarn';
-        if (declared.startsWith('npm@')) return 'npm';
-        if (declared.startsWith('bun@')) return 'bun';
-        if (external_node_fs_default().existsSync(external_node_path_default().join(projectRoot, 'pnpm-lock.yaml'))) return 'pnpm';
-        if (external_node_fs_default().existsSync(external_node_path_default().join(projectRoot, 'yarn.lock'))) return 'yarn';
-        if (external_node_fs_default().existsSync(external_node_path_default().join(projectRoot, 'package-lock.json'))) return 'npm';
-        if (external_node_fs_default().existsSync(external_node_path_default().join(projectRoot, 'bun.lockb'))) return 'bun';
-        if (external_node_fs_default().existsSync(external_node_path_default().join(projectRoot, 'bun.lock'))) return 'bun';
-        const userAgent = String(process.env.npm_config_user_agent || '').toLowerCase();
-        if (userAgent.includes('pnpm')) return 'pnpm';
-        if (userAgent.includes('yarn')) return 'yarn';
-        if (userAgent.includes('bun')) return 'bun';
-        if (userAgent.includes('npm')) return 'npm';
-        return 'unknown';
-    }
-    function detectFrameworkPrimary(pkg) {
-        if (hasDependency(pkg, 'preact')) return 'preact';
-        if (hasDependency(pkg, 'react')) return 'react';
-        if (hasDependency(pkg, 'vue')) return 'vue';
-        if (hasDependency(pkg, 'svelte')) return 'svelte';
-        if (hasDependency(pkg, 'solid-js')) return 'solid';
-        if (hasDependency(pkg, '@angular/core')) return 'angular';
         return 'unknown';
     }
-    function detectMonorepo(projectRoot, pkg) {
-        return Boolean(pkg.workspaces || external_node_fs_default().existsSync(external_node_path_default().join(projectRoot, 'pnpm-workspace.yaml')) || external_node_fs_default().existsSync(external_node_path_default().join(projectRoot, 'turbo.json')));
-    }
-    function toPermissionBucket(count) {
-        if (count <= 0) return '0';
-        if (count <= 3) return '1_3';
-        if (count <= 10) return '4_10';
-        return '11_plus';
-    }
-    function toManifestSurface(summary) {
-        if (!summary) return 'unknown';
-        const surfaces = [
-            summary.has_action_popup,
-            summary.has_devtools_page,
-            summary.content_scripts_count > 0,
-            'none' !== summary.background_type
-        ].filter(Boolean).length;
-        if (surfaces > 1) return 'multi_surface';
-        if (summary.has_action_popup) return 'action_popup';
-        if (summary.has_devtools_page) return 'devtools';
-        if (summary.content_scripts_count > 0) return "content_scripts";
-        if ('none' !== summary.background_type) return 'background_only';
-        return 'other';
+    const consent = resolveTelemetryConsent(process.argv);
+    const invoked = detectInvokedCommand(process.argv);
+    const telemetry_cli_version = getCliPackageJson().version;
+    const telemetry = new Telemetry({
+        app: 'extension',
+        version: telemetry_cli_version,
+        disabled: !consent.enabled
+    });
+    function getTelemetryConsent() {
+        return consent;
     }
-    function collectProjectProfile(projectRoot, summary) {
-        const packageJsonPath = findNearestPackageJson(projectRoot);
-        const pkg = (packageJsonPath ? safeReadJson(packageJsonPath) : null) || {
-            dependencies: {},
-            devDependencies: {},
-            peerDependencies: {}
-        };
-        const resolvedRoot = packageJsonPath ? external_node_path_default().dirname(packageJsonPath) : projectRoot;
-        const hasPackageSignals = Boolean(packageJsonPath);
-        const hasManifestSignals = Boolean(summary);
-        if (!hasPackageSignals && !hasManifestSignals) return null;
+    function setTelemetryConsent(value) {
+        const ok = writeConsent(value);
+        const storage = resolveTelemetryStorage();
         return {
-            package_manager: detectPackageManager(resolvedRoot, pkg),
-            framework_primary: detectFrameworkPrimary(pkg),
-            has_typescript: hasDependency(pkg, "typescript") || external_node_fs_default().existsSync(external_node_path_default().join(resolvedRoot, 'tsconfig.json')),
-            is_monorepo: detectMonorepo(resolvedRoot, pkg),
-            has_next_dependency: hasDependency(pkg, 'next'),
-            has_turbo_dependency: hasDependency(pkg, 'turbo') || external_node_fs_default().existsSync(external_node_path_default().join(resolvedRoot, 'turbo.json')),
-            manifest_surface: toManifestSurface(summary),
-            permissions_bucket: toPermissionBucket(summary?.permissions_count || 0),
-            host_permissions_bucket: toPermissionBucket(summary?.host_permissions_count || 0)
+            ok,
+            path: storage?.consentFile ?? null
         };
     }
-    function isTelemetryDisabledFromArgs(argv) {
-        return argv.includes('--no-telemetry');
-    }
-    const telemetryDisabled = isTelemetryDisabledFromArgs(process.argv);
-    function findManifestJson(projectRoot) {
-        const stack = [
-            projectRoot
-        ];
-        while(stack.length > 0){
-            const dir = stack.pop();
-            if (!dir) continue;
-            let entries;
-            try {
-                entries = external_fs_default().readdirSync(dir, {
-                    withFileTypes: true
-                });
-            } catch  {
-                continue;
-            }
-            for (const entry of entries){
-                if (entry.isFile() && 'manifest.json' === entry.name) return external_path_default().join(dir, entry.name);
-                if (entry.isDirectory() && !entry.name.startsWith('.') && 'node_modules' !== entry.name && 'dist' !== entry.name) stack.push(external_path_default().join(dir, entry.name));
-            }
-        }
-        return null;
+    let tracked = false;
+    function markTracked() {
+        if (tracked) return false;
+        tracked = true;
+        return true;
     }
-    const telemetry_cli_telemetry = new Telemetry({
-        app: 'extension',
-        version: getCliPackageJson().version,
-        disabled: telemetryDisabled
-    });
-    function detectInvokedCommand(argv) {
-        const known = new Set([
-            'create',
-            'dev',
-            'start',
-            'preview',
-            'build',
-            'install',
-            'uninstall',
-            'cleanup',
-            'unknown'
-        ]);
-        return argv.slice(2).find((a)=>known.has(a)) || 'unknown';
+    function markCommandSuccess(command = invoked) {
+        if (!markTracked()) return;
+        telemetry.track('command_executed', {
+            command,
+            success: true,
+            version: telemetry_cli_version
+        });
     }
-    if (!telemetryDisabled) {
-        const startedAt = Date.now();
-        let shutdownTracked = false;
-        const invoked = detectInvokedCommand(process.argv);
-        telemetry_cli_telemetry.track('cli_boot', {
-            command_guess: invoked
+    function markCommandFailure(command = invoked) {
+        if (!markTracked()) return;
+        telemetry.track('command_failed', {
+            command,
+            success: false,
+            version: telemetry_cli_version
         });
-        const manifestPath = findManifestJson(process.cwd());
-        let manifestSummary = null;
-        if (manifestPath) try {
-            const raw = external_fs_default().readFileSync(manifestPath, 'utf8');
-            const json = JSON.parse(raw);
-            manifestSummary = summarizeManifest(json);
-            telemetry_cli_telemetry.track('manifest_summary', manifestSummary);
-        } catch  {}
-        const projectProfile = collectProjectProfile(process.cwd(), manifestSummary);
-        if (projectProfile) telemetry_cli_telemetry.track('project_profile', projectProfile);
+    }
+    function printOptOutNoticeIfFirstRun() {
+        if (!consent.enabled || 'default' !== consent.source) return;
+        const storage = resolveTelemetryStorage();
+        if (!storage) return;
+        const written = writeConsent('enabled');
+        if (!written) return;
+        console.log(`${external_pintor_default().gray('⏵⏵⏵')} Extension.js collects anonymous, opt-out telemetry (two events: ${external_pintor_default().cyan('command_executed')} + ${external_pintor_default().cyan('command_failed')}). Disable with ${external_pintor_default().cyan('extension telemetry disable')}, ${external_pintor_default().cyan('EXTENSION_TELEMETRY=0')}, or ${external_pintor_default().cyan('--no-telemetry')}. See TELEMETRY.md.`);
+    }
+    if (consent.enabled) {
+        printOptOutNoticeIfFirstRun();
         process.on('beforeExit', async function() {
-            if (shutdownTracked) return;
-            shutdownTracked = true;
-            telemetry_cli_telemetry.track('cli_shutdown', {
-                command_guess: invoked,
-                duration_ms: Date.now() - startedAt,
-                exit_code: process.exitCode ?? 0
-            });
-            await telemetry_cli_telemetry.flush();
+            if (!tracked) if ((process.exitCode ?? 0) === 0) markCommandSuccess();
+            else markCommandFailure();
+            await telemetry.flush();
         });
-        process.on('uncaughtException', function(err) {
-            telemetry_cli_telemetry.track('cli_error', {
-                command_guess: invoked,
-                error_name: String(err?.name || 'Error').slice(0, 64)
-            });
+        process.on('uncaughtException', function() {
+            markCommandFailure();
         });
-        process.on('unhandledRejection', function(reason) {
-            telemetry_cli_telemetry.track('cli_error', {
-                command_guess: invoked,
-                error_name: String(reason?.name || 'PromiseRejection').slice(0, 64)
-            });
+        process.on('unhandledRejection', function() {
+            markCommandFailure();
         });
     }
-    function primaryReason(automationReasons, shippingReasons) {
-        if (automationReasons.length > 0) return automationReasons[0];
-        if (shippingReasons.length > 0) return shippingReasons[0];
-        return 'none';
-    }
-    function collectWorkflowProfile(context) {
-        const shippingReasons = [];
-        const automationReasons = [];
-        if ('build' === context.command || 'start' === context.command || 'preview' === context.command) shippingReasons.push('production_command');
-        if (context.isMultiBrowser) shippingReasons.push('multi_browser');
-        if ('zip' === context.artifactKind || 'source_zip' === context.artifactKind || 'zip_and_source' === context.artifactKind) shippingReasons.push('artifact_output');
-        if (context.companionExtensionsProvided) shippingReasons.push('companion_extensions');
-        if (context.isWaitMode || context.isNoBrowserMode) automationReasons.push('headless_sync');
-        if (context.usesMachineReadableOutput) automationReasons.push('machine_readable_output');
-        if (context.sourceInspectionRequested) automationReasons.push('source_inspection');
-        if (context.whereMode) automationReasons.push('where_mode');
-        const hasAutomationIntent = automationReasons.length > 0;
-        const hasShippingIntent = shippingReasons.length > 0;
-        return {
-            workflow_cohort: hasAutomationIntent ? 'automation_heavy' : hasShippingIntent ? 'shipping' : 'local_only',
-            has_shipping_intent: hasShippingIntent,
-            has_automation_intent: hasAutomationIntent,
-            shipping_signal_count: shippingReasons.length,
-            automation_signal_count: automationReasons.length,
-            primary_workflow_signal: primaryReason(automationReasons, shippingReasons),
-            package_manager: context.packageManager,
-            framework_primary: context.frameworkPrimary,
-            has_next_dependency: context.hasNextDependency,
-            has_turbo_dependency: context.hasTurboDependency
-        };
-    }
     function parseOptionalBoolean(value) {
         if (void 0 === value) return true;
         const normalized = String(value).trim().toLowerCase();
@@ -6245,63 +6154,27 @@ Cross-Browser Compatibility
         }
     }
     const create_require = (0, external_module_.createRequire)(__rslib_import_meta_url__);
-    function registerCreateCommand(program, telemetry) {
-        program.command('create').arguments('<project-name|project-path>').usage('create <project-name|project-path> [options]').description(commandDescriptions.create).option('-t, --template <template-name>', 'specify a template for the created project').option('--install [boolean]', 'whether or not to install the dependencies after creating the project (enabled by default)', parseOptionalBoolean, true).action(async function(pathOrRemoteUrl, { template, install }) {
-            const startedAt = Date.now();
-            const templateValue = String(template ?? "javascript");
-            const isRemoteTemplate = /^https?:/i.test(templateValue);
-            const workflowProfile = collectWorkflowProfile({
-                command: 'create',
-                isRemoteInput: isRemoteTemplate
-            });
-            telemetry.track('workflow_profile', {
-                command: 'create',
-                ...workflowProfile
-            });
-            telemetry.track('cli_command_start', {
-                command: 'create',
-                template: templateValue,
-                template_source: isRemoteTemplate ? 'remote' : 'built_in',
-                install: Boolean(install),
-                ...workflowProfile
-            });
-            try {
-                if (!process.env.EXTENSION_CREATE_DEVELOP_ROOT) try {
-                    process.env.EXTENSION_CREATE_DEVELOP_ROOT = resolveExtensionDevelopRoot();
+    function registerCreateCommand(program) {
+        program.command('create').arguments('<project-name|project-path>').usage('create <project-name|project-path> [options]').description(commandDescriptions.create).option('-t, --template <template-name>', 'specify a template for the created project').option('--install [boolean]', 'whether or not to install the dependencies after creating the project (disabled by default — pass --install to opt in)', parseOptionalBoolean, false).action(async function(pathOrRemoteUrl, { template, install }) {
+            if (!process.env.EXTENSION_CREATE_DEVELOP_ROOT) try {
+                process.env.EXTENSION_CREATE_DEVELOP_ROOT = resolveExtensionDevelopRoot();
+            } catch  {
+                try {
+                    const developPkg = create_require.resolve('extension-develop/package.json');
+                    process.env.EXTENSION_CREATE_DEVELOP_ROOT = external_path_.dirname(developPkg);
                 } catch  {
                     try {
-                        const developPkg = create_require.resolve('extension-develop/package.json');
-                        process.env.EXTENSION_CREATE_DEVELOP_ROOT = external_path_.dirname(developPkg);
-                    } catch  {
-                        try {
-                            const developEntry = create_require.resolve('extension-develop');
-                            process.env.EXTENSION_CREATE_DEVELOP_ROOT = external_path_.dirname(external_path_.dirname(developEntry));
-                        } catch  {}
-                    }
+                        const developEntry = create_require.resolve('extension-develop');
+                        process.env.EXTENSION_CREATE_DEVELOP_ROOT = external_path_.dirname(external_path_.dirname(developEntry));
+                    } catch  {}
                 }
-                const { extensionCreate } = await import("extension-create");
-                await extensionCreate(pathOrRemoteUrl, {
-                    template,
-                    install,
-                    cliVersion: getCliPackageJson().version
-                });
-                telemetry.track('cli_command_finish', {
-                    command: 'create',
-                    duration_ms: Date.now() - startedAt,
-                    success: true,
-                    exit_code: 0,
-                    ...workflowProfile
-                });
-            } catch (err) {
-                telemetry.track('cli_command_finish', {
-                    command: 'create',
-                    duration_ms: Date.now() - startedAt,
-                    success: false,
-                    exit_code: 1,
-                    ...workflowProfile
-                });
-                throw err;
             }
+            const { extensionCreate } = await import("extension-create");
+            await extensionCreate(pathOrRemoteUrl, {
+                template,
+                install,
+                cliVersion: getCliPackageJson().version
+            });
         });
     }
     function isHttpUrl(value) {
@@ -6514,50 +6387,13 @@ Cross-Browser Compatibility
         const values = String(raw).split(',').map((value)=>value.trim()).filter((value)=>value.length > 0);
         return values.length > 0 ? values : void 0;
     }
-    function registerDevCommand(program, telemetry) {
+    function registerDevCommand(program) {
         program.command('dev').arguments('[project-path|remote-url]').usage('dev [project-path|remote-url] [options]').description(commandDescriptions.dev).addHelpText('after', '\nAdditional options:\n  --no-browser    do not launch the browser (dev server still starts)\n  --wait          wait for ready contract and exit\n  --wait-format   pretty|json output for wait mode\n').option('--profile <path-to-file | boolean>', 'what path to use for the browser profile. A boolean value of false sets the profile to the default user profile. Defaults to a fresh profile').option('-b, --browser <chrome | chromium | edge | firefox | chromium-based | gecko-based | firefox-based>', 'specify a browser/engine to run. Defaults to `chromium`').option('--chromium-binary <path-to-binary>', 'specify a path to the Chromium binary. This option overrides the --browser setting. Defaults to the system default').option('--gecko-binary, --firefox-binary <path-to-binary>', 'specify a path to the Gecko binary. This option overrides the --browser setting. Defaults to the system default').option('--polyfill [boolean]', 'whether or not to apply the cross-browser polyfill. Defaults to `false`').option('--no-open', 'do not open the browser automatically (default: open)').option('--starting-url <url>', 'specify the starting URL for the browser. Defaults to `undefined`').option('--port <port>', 'specify the port to use for the development server. Defaults to `8080`').option('--host <host>', 'specify the host to bind the dev server to. Use 0.0.0.0 for Docker/devcontainers. Defaults to `127.0.0.1`').option('--log-context <list>', '[experimental] comma-separated contexts to include (background,content,page,sidebar,popup,options,devtools). Use `all` to include all contexts (default)').option('--logs <off|error|warn|info|debug|trace|all>', '[experimental] minimum centralized logger level to display in terminal (default: off)').option('--log-format <pretty|json|ndjson>', '[experimental] output format for logger events. Defaults to `pretty`').option('--no-log-timestamps', 'disable ISO timestamps in pretty output').option('--no-log-color', 'disable color in pretty output').option('--log-url <pattern>', '[experimental] only show logs where event.url matches this substring or regex (/re/i)').option('--log-tab <id>', 'only show logs for a specific tabId (number)').option('--source [url]', "[experimental] opens the provided URL in Chrome and prints the full, live HTML of the page after content scripts are injected").option('--watch-source [boolean]', '[experimental] re-print HTML on rebuilds or file changes (defaults to true when --source is present)', parseOptionalBoolean).option('--source-format <pretty|json|ndjson>', '[experimental] output format for source HTML (defaults to --log-format when present, otherwise JSON when --source is used)').option('--source-summary [boolean]', '[experimental] output a compact summary instead of full HTML', parseOptionalBoolean).option('--source-meta [boolean]', '[experimental] output page metadata (readyState, viewport, frames)', parseOptionalBoolean).option('--source-probe <selectors>', '[experimental] comma-separated CSS selectors to probe').option('--source-tree <off|root-only>', '[experimental] output a compact extension root tree').option('--source-console [boolean]', '[experimental] output console summary (best-effort)', parseOptionalBoolean).option('--source-dom [boolean]', '[experimental] output DOM snapshots and diffs (default: true when watch is enabled)', parseOptionalBoolean).option('--source-max-bytes <bytes>', '[experimental] limit HTML output size in bytes (0 disables truncation)').option('--source-redact <off|safe|strict>', '[experimental] redact sensitive content in HTML output (default: safe for JSON/NDJSON)').option('--source-include-shadow <off|open-only|all>', '[experimental] control Shadow DOM inclusion in HTML output (default: open-only)').option('--source-diff [boolean]', '[experimental] include diff metadata on watch updates (default: true when watch is enabled)', parseOptionalBoolean).option('--extensions <list>', 'comma-separated list of companion extensions or store URLs to load').option('--install [boolean]', '[internal] install project dependencies when missing', parseOptionalBoolean).option('--wait [boolean]', 'wait for dist/extension-js/<browser>/ready.json and exit', parseOptionalBoolean).option('--wait-timeout <ms>', 'timeout in milliseconds when using --wait (default: 60000)').option('--wait-format <pretty|json>', 'output format for --wait results (default: pretty)').option('--author, --author-mode', '[internal] enable maintainer diagnostics (does not affect user runtime logs)').action(async function(pathOrRemoteUrl, { browser = 'chromium', ...devOptions }) {
             if (devOptions.author || devOptions['authorMode']) {
                 process.env.EXTENSION_AUTHOR_MODE = 'true';
                 if (!process.env.EXTENSION_VERBOSE) process.env.EXTENSION_VERBOSE = '1';
             }
-            const cmdStart = Date.now();
             const list = vendors(browser);
-            const isRemoteInput = 'string' == typeof pathOrRemoteUrl && /^https?:/i.test(pathOrRemoteUrl);
-            const projectProfile = collectProjectProfile(!isRemoteInput && pathOrRemoteUrl ? pathOrRemoteUrl : process.cwd());
-            const workflowProfile = collectWorkflowProfile({
-                command: 'dev',
-                isMultiBrowser: list.length > 1,
-                isRemoteInput: isRemoteInput,
-                isWaitMode: Boolean(devOptions.wait),
-                isNoBrowserMode: '1' === process.env.EXTENSION_CLI_NO_BROWSER,
-                usesMachineReadableOutput: 'json' === devOptions.waitFormat || 'json' === devOptions.logFormat || 'ndjson' === devOptions.logFormat || 'json' === devOptions.sourceFormat || 'ndjson' === devOptions.sourceFormat,
-                sourceInspectionRequested: Boolean(devOptions.source || devOptions.watchSource),
-                companionExtensionsProvided: Boolean(devOptions.extensions),
-                packageManager: projectProfile?.package_manager,
-                frameworkPrimary: projectProfile?.framework_primary,
-                hasNextDependency: projectProfile?.has_next_dependency,
-                hasTurboDependency: projectProfile?.has_turbo_dependency
-            });
-            telemetry.track('workflow_profile', {
-                command: 'dev',
-                ...workflowProfile
-            });
-            telemetry.track('cli_command_start', {
-                command: 'dev',
-                vendors: list,
-                browser_count: list.length,
-                is_multi_browser: list.length > 1,
-                is_remote_input: isRemoteInput,
-                is_wait_mode: Boolean(devOptions.wait),
-                is_no_browser_mode: '1' === process.env.EXTENSION_CLI_NO_BROWSER,
-                polyfill_used: devOptions.polyfill?.toString() !== 'false',
-                source_inspection_requested: Boolean(devOptions.source || devOptions.watchSource),
-                companion_extensions_provided: Boolean(devOptions.extensions),
-                log_level: devOptions.logLevel || 'off',
-                log_format: devOptions.logFormat || 'pretty',
-                custom_binary_used: Boolean(devOptions.chromiumBinary || devOptions.geckoBinary),
-                ...workflowProfile
-            });
             validateVendorsOrExit(list, (invalid, supported)=>{
                 console.error(unsupportedBrowserFlag(invalid, supported));
             });
@@ -6576,13 +6412,6 @@ Cross-Browser Compatibility
                     browsers: waitResult.browsers,
                     results: waitResult.results
                 }));
-                telemetry.track('cli_command_finish', {
-                    command: 'dev',
-                    duration_ms: Date.now() - cmdStart,
-                    success: true,
-                    exit_code: 0,
-                    ...workflowProfile
-                });
                 return;
             }
             const normalizedSource = normalizeSourceOption(devOptions.source, devOptions.startingUrl);
@@ -6610,11 +6439,6 @@ Cross-Browser Compatibility
             const { extensionDev } = loadExtensionDevelopModule();
             const noBrowser = '1' === process.env.EXTENSION_CLI_NO_BROWSER;
             for (const vendor of list){
-                const vendorStart = Date.now();
-                telemetry.track('cli_vendor_start', {
-                    command: 'dev',
-                    vendor
-                });
                 const logsOption = devOptions.logs;
                 const logContextOption = devOptions.logContext;
                 const logContexts = parseLogContexts(logContextOption);
@@ -6654,61 +6478,17 @@ Cross-Browser Compatibility
                     launcher: noBrowser ? void 0 : browsers.launchBrowser
                 };
                 await extensionDev(pathOrRemoteUrl, devArgs);
-                telemetry.track('cli_vendor_finish', {
-                    command: 'dev',
-                    vendor,
-                    duration_ms: Date.now() - vendorStart
-                });
             }
-            telemetry.track('cli_command_finish', {
-                command: 'dev',
-                duration_ms: Date.now() - cmdStart,
-                success: 0 === process.exitCode || null == process.exitCode,
-                exit_code: process.exitCode ?? 0,
-                ...workflowProfile
-            });
         });
     }
     var run_only = __webpack_require__("./browsers/run-only.ts");
-    function registerStartCommand(program, telemetry) {
+    function registerStartCommand(program) {
         program.command('start').arguments('[project-path|remote-url]').usage('start [project-path|remote-url] [options]').description(commandDescriptions.start).addHelpText('after', '\nAdditional options:\n  --no-browser    do not launch the browser (build still runs)\n  --wait          wait for ready contract and exit\n  --wait-format   pretty|json output for wait mode\n').option('--profile <path-to-file | boolean>', 'what path to use for the browser profile. A boolean value of false sets the profile to the default user profile. Defaults to a fresh profile').option('--browser <chrome | chromium | edge | firefox | chromium-based | gecko-based | firefox-based>', 'specify a browser/engine to run. Defaults to `chromium`').option('--polyfill [boolean]', 'whether or not to apply the cross-browser polyfill. Defaults to `true`').option('--chromium-binary <path-to-binary>', 'specify a path to the Chromium binary. This option overrides the --browser setting. Defaults to the system default').option('--gecko-binary, --firefox-binary <path-to-binary>', 'specify a path to the Gecko binary. This option overrides the --browser setting. Defaults to the system default').option('--starting-url <url>', 'specify the starting URL for the browser. Defaults to `undefined`').option('--port <port>', 'specify the port to use for the development server. Defaults to `8080`').option('--host <host>', 'specify the host to bind the dev server to. Use 0.0.0.0 for Docker/devcontainers. Defaults to `127.0.0.1`').option('--log-context <list>', '[experimental] comma-separated contexts to include (background,content,page,sidebar,popup,options,devtools). Use `all` to include all contexts (default)').option('--logs <off|error|warn|info|debug|trace|all>', '[experimental] minimum centralized logger level to display in terminal (default: off)').option('--log-format <pretty|json|ndjson>', '[experimental] output format for logger events. Defaults to `pretty`').option('--no-log-timestamps', 'disable ISO timestamps in pretty output').option('--no-log-color', 'disable color in pretty output').option('--log-url <pattern>', '[experimental] only show logs where event.url matches this substring or regex (/re/i)').option('--log-tab <id>', 'only show logs for a specific tabId (number)').option('--extensions <list>', 'comma-separated list of companion extensions or store URLs to load').option('--install [boolean]', '[experimental] install project dependencies when missing', parseOptionalBoolean).option('--wait [boolean]', 'wait for dist/extension-js/<browser>/ready.json and exit', parseOptionalBoolean).option('--wait-timeout <ms>', 'timeout in milliseconds when using --wait (default: 60000)').option('--wait-format <pretty|json>', 'output format for --wait results (default: pretty)').option('--author, --author-mode', '[experimental] enable maintainer diagnostics (does not affect user runtime logs)').action(async function(pathOrRemoteUrl, { browser = 'chromium', ...startOptions }) {
             if (startOptions.author || startOptions.authorMode) {
                 process.env.EXTENSION_AUTHOR_MODE = 'true';
                 if (!process.env.EXTENSION_VERBOSE) process.env.EXTENSION_VERBOSE = '1';
             }
-            const cmdStart = Date.now();
             const list = vendors(browser);
-            const isRemoteInput = 'string' == typeof pathOrRemoteUrl && /^https?:/i.test(pathOrRemoteUrl);
-            const projectProfile = collectProjectProfile(!isRemoteInput && pathOrRemoteUrl ? pathOrRemoteUrl : process.cwd());
-            const workflowProfile = collectWorkflowProfile({
-                command: 'start',
-                isMultiBrowser: list.length > 1,
-                isRemoteInput: isRemoteInput,
-                isWaitMode: Boolean(startOptions.wait),
-                isNoBrowserMode: '1' === process.env.EXTENSION_CLI_NO_BROWSER,
-                usesMachineReadableOutput: 'json' === startOptions.waitFormat || 'json' === startOptions.logFormat || 'ndjson' === startOptions.logFormat,
-                companionExtensionsProvided: Boolean(startOptions.extensions),
-                packageManager: projectProfile?.package_manager,
-                frameworkPrimary: projectProfile?.framework_primary,
-                hasNextDependency: projectProfile?.has_next_dependency,
-                hasTurboDependency: projectProfile?.has_turbo_dependency
-            });
-            telemetry.track('workflow_profile', {
-                command: 'start',
-                ...workflowProfile
-            });
-            telemetry.track('cli_command_start', {
-                command: 'start',
-                vendors: list,
-                browser_count: list.length,
-                is_multi_browser: list.length > 1,
-                is_remote_input: isRemoteInput,
-                is_wait_mode: Boolean(startOptions.wait),
-                is_no_browser_mode: '1' === process.env.EXTENSION_CLI_NO_BROWSER,
-                companion_extensions_provided: Boolean(startOptions.extensions),
-                polyfill_used: startOptions.polyfill?.toString() !== 'false',
-                ...workflowProfile
-            });
             validateVendorsOrExit(list, (invalid, supported)=>{
                 console.error(unsupportedBrowserFlag(invalid, supported));
             });
@@ -6727,22 +6507,10 @@ Cross-Browser Compatibility
                     browsers: waitResult.browsers,
                     results: waitResult.results
                 }));
-                telemetry.track('cli_command_finish', {
-                    command: 'start',
-                    duration_ms: Date.now() - cmdStart,
-                    success: true,
-                    exit_code: 0,
-                    ...workflowProfile
-                });
                 return;
             }
             const { extensionBuild } = loadExtensionDevelopModule();
             for (const vendor of list){
-                const vendorStart = Date.now();
-                telemetry.track('cli_vendor_start', {
-                    command: 'start',
-                    vendor
-                });
                 const logsOption = startOptions.logs;
                 const logContextOption = startOptions.logContext;
                 const logContexts = parseLogContexts(logContextOption);
@@ -6755,14 +6523,7 @@ Cross-Browser Compatibility
                     silent: true
                 });
                 const noBrowser = '1' === process.env.EXTENSION_CLI_NO_BROWSER;
-                if (noBrowser) {
-                    telemetry.track('cli_vendor_finish', {
-                        command: 'start',
-                        vendor,
-                        duration_ms: Date.now() - vendorStart
-                    });
-                    continue;
-                }
+                if (noBrowser) continue;
                 const { extensionPreview } = loadExtensionDevelopPreviewModule();
                 await extensionPreview(pathOrRemoteUrl, {
                     mode: 'production',
@@ -6783,57 +6544,16 @@ Cross-Browser Compatibility
                     logUrl: startOptions.logUrl,
                     logTab: startOptions.logTab
                 }, (opts)=>(0, run_only.E)(opts));
-                telemetry.track('cli_vendor_finish', {
-                    command: 'start',
-                    vendor,
-                    duration_ms: Date.now() - vendorStart
-                });
             }
-            telemetry.track('cli_command_finish', {
-                command: 'start',
-                duration_ms: Date.now() - cmdStart,
-                success: 0 === process.exitCode || null == process.exitCode,
-                exit_code: process.exitCode ?? 0,
-                ...workflowProfile
-            });
         });
     }
-    function registerPreviewCommand(program, telemetry) {
+    function registerPreviewCommand(program) {
         program.command('preview').arguments('[project-name]').usage('preview [path-to-remote-extension] [options]').description(commandDescriptions.preview).addHelpText('after', '\nAdditional option:\n  --no-browser    do not launch the browser\n').option('--profile <path-to-file | boolean>', 'what path to use for the browser profile. A boolean value of false sets the profile to the default user profile. Defaults to a fresh profile').option('--browser <chrome | chromium | edge | firefox | chromium-based | gecko-based | firefox-based>', 'specify a browser/engine to run. Defaults to `chromium`').option('--chromium-binary <path-to-binary>', 'specify a path to the Chromium binary. This option overrides the --browser setting. Defaults to the system default').option('--gecko-binary, --firefox-binary <path-to-binary>', 'specify a path to the Gecko binary. This option overrides the --browser setting. Defaults to the system default').option('--starting-url <url>', 'specify the starting URL for the browser. Defaults to `undefined`').option('--port <port>', 'specify the port to use for the development server. Defaults to `8080`').option('--host <host>', 'specify the host to bind the dev server to. Use 0.0.0.0 for Docker/devcontainers. Defaults to `127.0.0.1`').option('--log-context <list>', '[experimental] comma-separated contexts to include (background,content,page,sidebar,popup,options,devtools). Use `all` to include all contexts (default)').option('--logs <off|error|warn|info|debug|trace|all>', '[experimental] minimum centralized logger level to display in terminal (default: off)').option('--log-format <pretty|json|ndjson>', '[experimental] output format for logger events. Defaults to `pretty`').option('--no-log-timestamps', 'disable ISO timestamps in pretty output').option('--no-log-color', 'disable color in pretty output').option('--log-url <pattern>', '[experimental] only show logs where event.url matches this substring or regex (/re/i)').option('--log-tab <id>', 'only show logs for a specific tabId (number)').option('--extensions <list>', 'comma-separated list of companion extensions or store URLs to load').option('--author, --author-mode', '[internal] enable maintainer diagnostics (does not affect user runtime logs)').action(async function(pathOrRemoteUrl, { browser = 'chromium', ...previewOptions }) {
             if (previewOptions.author || previewOptions['authorMode']) {
                 process.env.EXTENSION_AUTHOR_MODE = 'true';
                 if (!process.env.EXTENSION_VERBOSE) process.env.EXTENSION_VERBOSE = '1';
             }
-            const cmdStart = Date.now();
             const list = vendors(browser);
-            const isRemoteInput = 'string' == typeof pathOrRemoteUrl && /^https?:/i.test(pathOrRemoteUrl);
-            const projectProfile = collectProjectProfile(!isRemoteInput && pathOrRemoteUrl ? pathOrRemoteUrl : process.cwd());
-            const workflowProfile = collectWorkflowProfile({
-                command: 'preview',
-                isMultiBrowser: list.length > 1,
-                isRemoteInput: isRemoteInput,
-                isNoBrowserMode: '1' === process.env.EXTENSION_CLI_NO_BROWSER,
-                usesMachineReadableOutput: 'json' === previewOptions.logFormat || 'ndjson' === previewOptions.logFormat,
-                companionExtensionsProvided: Boolean(previewOptions.extensions),
-                packageManager: projectProfile?.package_manager,
-                frameworkPrimary: projectProfile?.framework_primary,
-                hasNextDependency: projectProfile?.has_next_dependency,
-                hasTurboDependency: projectProfile?.has_turbo_dependency
-            });
-            telemetry.track('workflow_profile', {
-                command: 'preview',
-                ...workflowProfile
-            });
-            telemetry.track('cli_command_start', {
-                command: 'preview',
-                vendors: list,
-                browser_count: list.length,
-                is_multi_browser: list.length > 1,
-                is_remote_input: isRemoteInput,
-                is_no_browser_mode: '1' === process.env.EXTENSION_CLI_NO_BROWSER,
-                companion_extensions_provided: Boolean(previewOptions.extensions),
-                ...workflowProfile
-            });
             validateVendorsOrExit(list, (invalid, supported)=>{
                 console.error(unsupportedBrowserFlag(invalid, supported));
             });
@@ -6843,11 +6563,6 @@ Cross-Browser Compatibility
             }
             const { extensionPreview } = loadExtensionDevelopPreviewModule();
             for (const vendor of list){
-                const vendorStart = Date.now();
-                telemetry.track('cli_vendor_start', {
-                    command: 'preview',
-                    vendor
-                });
                 const logsOption = previewOptions.logs;
                 const logContextOption = previewOptions.logContext;
                 const logContexts = parseLogContexts(logContextOption);
@@ -6869,99 +6584,29 @@ Cross-Browser Compatibility
                     logUrl: previewOptions.logUrl,
                     logTab: previewOptions.logTab
                 }, (opts)=>(0, run_only.E)(opts));
-                telemetry.track('cli_vendor_finish', {
-                    command: 'preview',
-                    vendor,
-                    duration_ms: Date.now() - vendorStart
-                });
             }
-            telemetry.track('cli_command_finish', {
-                command: 'preview',
-                duration_ms: Date.now() - cmdStart,
-                success: 0 === process.exitCode || null == process.exitCode,
-                exit_code: process.exitCode ?? 0,
-                ...workflowProfile
-            });
         });
     }
-    function registerBuildCommand(program, telemetry) {
+    function registerBuildCommand(program) {
         program.command('build').arguments('[project-name]').usage('build [path-to-remote-extension] [options]').description(commandDescriptions.build).option('--browser <chrome | chromium | edge | firefox | chromium-based | gecko-based | firefox-based>', 'specify a browser/engine to run. Defaults to `chromium`').option('--polyfill [boolean]', 'whether or not to apply the cross-browser polyfill. Defaults to `false`').option('--zip [boolean]', 'whether or not to compress the extension into a ZIP file. Defaults to `false`').option('--zip-source [boolean]', 'whether or not to include the source files in the ZIP file. Defaults to `false`').option('--zip-filename <string>', 'specify the name of the ZIP file. Defaults to the extension name and version').option('--silent [boolean]', 'whether or not to open the browser automatically. Defaults to `false`').option('--install [boolean]', '[internal] install project dependencies when missing', parseOptionalBoolean).option('--extensions <list>', 'comma-separated list of companion extensions or store URLs to load').option('--author, --author-mode', '[internal] enable maintainer diagnostics (does not affect user runtime logs)').action(async function(pathOrRemoteUrl, { browser = 'chromium', ...buildOptions }) {
             if (buildOptions.author || buildOptions['authorMode']) {
                 process.env.EXTENSION_AUTHOR_MODE = 'true';
                 if (!process.env.EXTENSION_VERBOSE) process.env.EXTENSION_VERBOSE = '1';
             }
-            const cmdStart = Date.now();
             const list = vendors(browser);
-            const isRemoteInput = 'string' == typeof pathOrRemoteUrl && /^https?:/i.test(pathOrRemoteUrl);
-            const artifactKind = buildOptions.zipSource ? buildOptions.zip ? 'zip_and_source' : 'source_zip' : buildOptions.zip ? 'zip' : 'directory';
-            const projectProfile = collectProjectProfile(!isRemoteInput && pathOrRemoteUrl ? pathOrRemoteUrl : process.cwd());
-            const workflowProfile = collectWorkflowProfile({
-                command: 'build',
-                isMultiBrowser: list.length > 1,
-                isRemoteInput: isRemoteInput,
-                companionExtensionsProvided: Boolean(buildOptions.extensions),
-                artifactKind,
-                packageManager: projectProfile?.package_manager,
-                frameworkPrimary: projectProfile?.framework_primary,
-                hasNextDependency: projectProfile?.has_next_dependency,
-                hasTurboDependency: projectProfile?.has_turbo_dependency
-            });
-            telemetry.track('workflow_profile', {
-                command: 'build',
-                ...workflowProfile
-            });
-            telemetry.track('cli_command_start', {
-                command: 'build',
-                vendors: list,
-                browser_count: list.length,
-                is_multi_browser: list.length > 1,
-                is_remote_input: isRemoteInput,
-                polyfill_used: buildOptions.polyfill || false,
-                zip: buildOptions.zip || false,
-                zip_source: buildOptions.zipSource || false,
-                artifact_kind: artifactKind,
-                ...workflowProfile
-            });
             validateVendorsOrExit(list, (invalid, supported)=>{
                 console.error(unsupportedBrowserFlag(invalid, supported));
             });
             const { extensionBuild } = loadExtensionDevelopModule();
-            for (const vendor of list){
-                const vendorStart = Date.now();
-                telemetry.track('cli_vendor_start', {
-                    command: 'build',
-                    vendor
-                });
-                const buildSummary = await extensionBuild(pathOrRemoteUrl, {
-                    browser: vendor,
-                    polyfill: buildOptions.polyfill,
-                    zip: buildOptions.zip,
-                    zipSource: buildOptions.zipSource,
-                    zipFilename: buildOptions.zipFilename,
-                    silent: buildOptions.silent,
-                    install: buildOptions.install,
-                    extensions: parseExtensionsList(buildOptions.extensions)
-                });
-                telemetry.track('cli_build_summary', {
-                    ...buildSummary,
-                    browser_count: list.length,
-                    is_multi_browser: list.length > 1,
-                    is_remote_input: isRemoteInput,
-                    artifact_kind: artifactKind,
-                    ...workflowProfile
-                });
-                telemetry.track('cli_vendor_finish', {
-                    command: 'build',
-                    vendor,
-                    duration_ms: Date.now() - vendorStart
-                });
-            }
-            telemetry.track('cli_command_finish', {
-                command: 'build',
-                duration_ms: Date.now() - cmdStart,
-                success: 0 === process.exitCode || null == process.exitCode,
-                exit_code: process.exitCode ?? 0,
-                ...workflowProfile
+            for (const vendor of list)await extensionBuild(pathOrRemoteUrl, {
+                browser: vendor,
+                polyfill: buildOptions.polyfill,
+                zip: buildOptions.zip,
+                zipSource: buildOptions.zipSource,
+                zipFilename: buildOptions.zipFilename,
+                silent: buildOptions.silent,
+                install: buildOptions.install,
+                extensions: parseExtensionsList(buildOptions.extensions)
             });
         });
     }
@@ -6995,118 +6640,79 @@ Cross-Browser Compatibility
         if ('chrome' === value || 'chromium' === value || 'edge' === value || 'firefox' === value) return value;
         return 'chromium';
     }
-    function registerInstallCommand(program, telemetry) {
+    function registerInstallCommand(program) {
         program.command('install').arguments('[browser-name]').usage('[browser-name] [options]').description(commandDescriptions.install).option('--browser <chrome | chromium | edge | firefox | chromium-based | gecko-based | firefox-based | all>', 'override the positional browser name. Supports comma-separated values and `all`.').option('--where', 'print the resolved managed browser cache root').action(async function(browserArg, options) {
-            const startedAt = Date.now();
             const selectedBrowser = options.browser || browserArg || 'chromium';
             const browserList = vendors(selectedBrowser);
-            const workflowProfile = collectWorkflowProfile({
-                command: 'install',
-                isMultiBrowser: browserList.length > 1,
-                whereMode: Boolean(options.where)
-            });
             validateVendorsOrExit(browserList, (invalid, supported)=>{
                 console.error(unsupportedBrowserFlag(invalid, supported));
             });
-            telemetry.track('workflow_profile', {
-                command: 'install',
-                ...workflowProfile
-            });
-            telemetry.track('cli_command_start', {
-                command: 'install',
-                vendors: browserList,
-                browser_count: browserList.length,
-                is_multi_browser: browserList.length > 1,
-                where: Boolean(options.where),
-                ...workflowProfile
-            });
-            try {
-                if (options.where) {
-                    const root = resolveManagedBrowsersCacheRoot();
-                    if (options.browser || browserArg) for (const browser of browserList)console.log(external_node_path_default().join(root, normalizeInstallVendor(browser)));
-                    else console.log(root);
-                } else {
-                    const { extensionInstall } = await import("extension-install");
-                    for (const browser of browserList)await extensionInstall({
-                        browser
-                    });
-                }
-                telemetry.track('cli_command_finish', {
-                    command: 'install',
-                    duration_ms: Date.now() - startedAt,
-                    success: true,
-                    exit_code: 0,
-                    ...workflowProfile
-                });
-            } catch (err) {
-                telemetry.track('cli_command_finish', {
-                    command: 'install',
-                    duration_ms: Date.now() - startedAt,
-                    success: false,
-                    exit_code: 1,
-                    ...workflowProfile
-                });
-                throw err;
+            if (options.where) {
+                const root = resolveManagedBrowsersCacheRoot();
+                if (options.browser || browserArg) for (const browser of browserList)console.log(external_node_path_default().join(root, normalizeInstallVendor(browser)));
+                else console.log(root);
+                return;
             }
+            const { extensionInstall } = await import("extension-install");
+            for (const browser of browserList)await extensionInstall({
+                browser
+            });
         });
         program.command('uninstall').usage('uninstall <browser-name> | uninstall --all | uninstall --where').description(commandDescriptions.uninstall).option('--browser <browser-name>', 'browser to uninstall').option('--all', 'remove all managed browser binaries').option('--where', 'print the resolved managed browser cache root').argument('[browser-name]').action(async function(browserArg, { browser, all, where }) {
-            const startedAt = Date.now();
             const target = browserArg || browser;
-            const workflowProfile = collectWorkflowProfile({
-                command: 'uninstall',
-                whereMode: Boolean(where)
-            });
-            telemetry.track('workflow_profile', {
-                command: 'uninstall',
-                ...workflowProfile
-            });
-            telemetry.track('cli_command_start', {
-                command: 'uninstall',
+            if (where) {
+                const root = resolveManagedBrowsersCacheRoot();
+                if (all) for (const browser of [
+                    'chrome',
+                    'chromium',
+                    'edge',
+                    'firefox'
+                ])console.log(external_node_path_default().join(root, browser));
+                else if (target) {
+                    const list = vendors(target);
+                    validateVendorsOrExit(list, (invalid, supported)=>{
+                        console.error(unsupportedBrowserFlag(invalid, supported));
+                    });
+                    for (const browser of list)console.log(external_node_path_default().join(root, normalizeInstallVendor(browser)));
+                } else console.log(root);
+                return;
+            }
+            const { extensionUninstall } = await import("extension-install");
+            await extensionUninstall({
                 browser: target,
-                all: Boolean(all),
-                where: Boolean(where),
-                ...workflowProfile
+                all
             });
-            try {
-                if (where) {
-                    const root = resolveManagedBrowsersCacheRoot();
-                    if (all) for (const browser of [
-                        'chrome',
-                        'chromium',
-                        'edge',
-                        'firefox'
-                    ])console.log(external_node_path_default().join(root, browser));
-                    else if (target) {
-                        const list = vendors(target);
-                        validateVendorsOrExit(list, (invalid, supported)=>{
-                            console.error(unsupportedBrowserFlag(invalid, supported));
-                        });
-                        for (const browser of list)console.log(external_node_path_default().join(root, normalizeInstallVendor(browser)));
-                    } else console.log(root);
-                } else {
-                    const { extensionUninstall } = await import("extension-install");
-                    await extensionUninstall({
-                        browser: target,
-                        all
-                    });
+        });
+    }
+    function registerTelemetryCommand(program) {
+        program.command('telemetry').argument('[action]', 'enable | disable | status (default: status)').description('Manage anonymous telemetry consent (enable, disable, or show status)').action((action)=>{
+            const normalized = String(action || 'status').trim().toLowerCase();
+            if ('enable' === normalized) {
+                const { ok, path } = setTelemetryConsent('enabled');
+                if (ok) {
+                    console.log(`${external_pintor_default().green('✓')} Telemetry enabled${path ? ` (${path})` : ''}.`);
+                    process.exit(0);
                 }
-                telemetry.track('cli_command_finish', {
-                    command: 'uninstall',
-                    duration_ms: Date.now() - startedAt,
-                    success: true,
-                    exit_code: 0,
-                    ...workflowProfile
-                });
-            } catch (err) {
-                telemetry.track('cli_command_finish', {
-                    command: 'uninstall',
-                    duration_ms: Date.now() - startedAt,
-                    success: false,
-                    exit_code: 1,
-                    ...workflowProfile
-                });
-                throw err;
+                console.error(`${external_pintor_default().red('✗')} Could not write telemetry consent file.`);
+                process.exit(1);
             }
+            if ('disable' === normalized) {
+                const { ok, path } = setTelemetryConsent('disabled');
+                if (ok) {
+                    console.log(`${external_pintor_default().green('✓')} Telemetry disabled${path ? ` (${path})` : ''}.`);
+                    process.exit(0);
+                }
+                console.error(`${external_pintor_default().red('✗')} Could not write telemetry consent file.`);
+                process.exit(1);
+            }
+            if ('status' === normalized) {
+                const { enabled, source } = getTelemetryConsent();
+                const label = enabled ? external_pintor_default().green('enabled') : external_pintor_default().red('disabled');
+                console.log(`Telemetry: ${label} (source: ${source})`);
+                process.exit(0);
+            }
+            console.error(`Unknown telemetry action: ${action}. Expected: enable | disable | status.`);
+            process.exit(1);
         });
     }
     const cliPackageJson = getCliPackageJson();
@@ -7201,12 +6807,13 @@ Cross-Browser Compatibility
     });
     const extensionJs = external_commander_namespaceObject.program;
     extensionJs.name(cliPackageJson.name).description(cliPackageJson.description).version(cliPackageJson.version).option('--no-telemetry', 'disable anonymous telemetry for this run').option('--ai-help', 'show AI-assistant oriented help and tips').option('--format <pretty|json>', 'output format for --ai-help', 'pretty').addHelpText('after', programUserHelp()).showHelpAfterError(true).showSuggestionAfterError(true);
-    registerCreateCommand(extensionJs, telemetry_cli_telemetry);
-    registerDevCommand(extensionJs, telemetry_cli_telemetry);
-    registerStartCommand(extensionJs, telemetry_cli_telemetry);
-    registerPreviewCommand(extensionJs, telemetry_cli_telemetry);
-    registerBuildCommand(extensionJs, telemetry_cli_telemetry);
-    registerInstallCommand(extensionJs, telemetry_cli_telemetry);
+    registerCreateCommand(extensionJs);
+    registerDevCommand(extensionJs);
+    registerStartCommand(extensionJs);
+    registerPreviewCommand(extensionJs);
+    registerBuildCommand(extensionJs);
+    registerInstallCommand(extensionJs);
+    registerTelemetryCommand(extensionJs);
     extensionJs.on('option:ai-help', function() {
         const format = resolveAIHelpFormatFromArgv(process.argv).trim().toLowerCase();
         if ('json' === format) {
@@ -7227,7 +6834,10 @@ Cross-Browser Compatibility
     const index_argv = applyNoBrowserArgvShim(process.argv);
     guardSourceInspectionFlags(index_argv);
     guardSourceWithWaitOrNoBrowser(index_argv);
-    extensionJs.parseAsync(index_argv).catch((err)=>{
+    extensionJs.parseAsync(index_argv).then(()=>{
+        markCommandSuccess();
+    }).catch((err)=>{
+        markCommandFailure();
         console.error(unhandledError(err));
         process.exit(1);
     });