@vforsh/argus 0.1.2 → 0.1.3

package/dist/bin.js

@@ -3,6 +3,59 @@ import { Command } from 'commander';
 import { runList } from './commands/list.js';
 import { runLogs } from './commands/logs.js';
 import { runTail } from './commands/tail.js';
+import { runNet } from './commands/net.js';
+import { runNetTail } from './commands/netTail.js';
+import { runEval } from './commands/eval.js';
+import { runIframeHelper } from './commands/iframeHelper.js';
+import { runTrace, runTraceStart, runTraceStop } from './commands/trace.js';
+import { runScreenshot } from './commands/screenshot.js';
+import { runReload } from './commands/reload.js';
+import { runDomTree } from './commands/domTree.js';
+import { runDomInfo } from './commands/domInfo.js';
+import { runDomHover } from './commands/domHover.js';
+import { runDomClick } from './commands/domClick.js';
+import { runDomAdd } from './commands/domAdd.js';
+import { runDomRemove } from './commands/domRemove.js';
+import { runDomModifyAttr, runDomModifyClass, runDomModifyStyle, runDomModifyText, runDomModifyHtml } from './commands/domModify.js';
+import { runChromeStart } from './commands/chromeStart.js';
+import { runChromeVersion, runChromeStatus, runChromeTargets, runChromeOpen, runChromeActivate, runChromeClose, runChromeStop, } from './commands/chrome.js';
+import { runPageReload } from './commands/page.js';
+import { runDoctor } from './commands/doctor.js';
+import { runWatcherStart } from './commands/watcherStart.js';
+import { runWatcherStatus } from './commands/watcherStatus.js';
+import { runWatcherStop } from './commands/watcherStop.js';
+import { runWatcherPrune } from './commands/watcherPrune.js';
+import { runWatcherNativeHost } from './commands/watcherNativeHost.js';
+import { runStorageLocalGet, runStorageLocalSet, runStorageLocalRemove, runStorageLocalList, runStorageLocalClear } from './commands/storageLocal.js';
+import { runConfigInit } from './commands/configInit.js';
+import { runExtensionSetup } from './commands/extension/setup.js';
+import { runExtensionRemove } from './commands/extension/remove.js';
+import { runExtensionStatus } from './commands/extension/status.js';
+import { runExtensionInfo } from './commands/extension/info.js';
+import { loadArgusConfig, mergeChromeStartOptionsWithConfig, mergeWatcherStartOptionsWithConfig, resolveArgusConfigPath, } from './config/argusConfig.js';
+import { PluginRegistry } from './plugins/registry.js';
+const collectMatch = (value, previous) => [...previous, value];
+const validateCaseFlags = (options) => {
+    if (options.ignoreCase && options.caseSensitive) {
+        console.error('Cannot combine --ignore-case with --case-sensitive.');
+        process.exitCode = 2;
+        return false;
+    }
+    return true;
+};
+const validateMatchOptions = (options) => {
+    if (!options.match || options.match.length === 0) {
+        return true;
+    }
+    const invalid = options.match.find((value) => value.trim().length === 0);
+    if (invalid != null) {
+        console.error('Invalid --match value: empty pattern.');
+        process.exitCode = 2;
+        return false;
+    }
+    options.match = options.match.map((value) => value.trim());
+    return true;
+};
 const program = new Command();
 program
     .name('argus')
@@ -21,6 +74,7 @@ program
 });
 program
     .command('list')
+    .alias('ls')
     .description('List registered watchers')
     .option('--json', 'Output JSON for automation')
     .option('--by-cwd <substring>', 'Filter watchers by working directory substring')
@@ -28,33 +82,682 @@ program
     .action(async (options) => {
     await runList(options);
 });
+program
+    .command('doctor')
+    .description('Run environment diagnostics for Argus')
+    .option('--json', 'Output JSON for automation')
+    .addHelpText('after', '\nExamples:\n  $ argus doctor\n  $ argus doctor --json\n')
+    .action(async (options) => {
+    await runDoctor(options);
+});
+const config = program.command('config').description('Manage Argus config files');
+config
+    .command('init')
+    .description('Create an Argus config file')
+    .option('--path <file>', 'Path to write the config file (default: .argus/config.json)')
+    .option('--force', 'Overwrite existing config file')
+    .addHelpText('after', '\nExamples:\n  $ argus config init\n  $ argus config init --path argus.config.json\n')
+    .action(async (options) => {
+    await runConfigInit(options);
+});
 program
     .command('logs')
-    .argument('<id>', 'Watcher id to query')
+    .alias('log')
+    .argument('[id]', 'Watcher id to query')
     .description('Fetch recent logs from a watcher')
     .option('--levels <levels>', 'Comma-separated log levels')
-    .option('--grep <text>', 'Filter by substring')
+    .option('--match <regex>', 'Filter by regex (repeatable)', collectMatch, [])
+    .option('--ignore-case', 'Use case-insensitive regex matching')
+    .option('--case-sensitive', 'Use case-sensitive regex matching')
+    .option('--source <pattern>', 'Filter by source substring')
     .option('--since <duration>', 'Filter by time window (e.g. 10m, 2h, 30s)')
     .option('--after <id>', 'Only return events after this id')
     .option('--limit <count>', 'Maximum number of events')
-    .option('--json', 'Output JSON for automation')
-    .addHelpText('after', '\nExamples:\n  $ argus logs app\n  $ argus logs app --since 10m --levels error,warning\n  $ argus logs app --json\n')
+    .option('--json', 'Output bounded JSON preview for automation')
+    .option('--json-full', 'Output full JSON (can be very large)')
+    .addHelpText('after', '\nExamples:\n  $ argus logs app\n  $ argus logs app --since 10m --levels error,warning\n  $ argus logs app --json\n  $ argus logs app --json-full\n')
     .action(async (id, options) => {
+    if (options.json && options.jsonFull) {
+        console.error('Cannot combine --json with --json-full.');
+        process.exitCode = 2;
+        return;
+    }
+    if (!validateCaseFlags(options)) {
+        return;
+    }
+    if (!validateMatchOptions(options)) {
+        return;
+    }
     await runLogs(id, options);
 });
 program
     .command('tail')
-    .argument('<id>', 'Watcher id to follow')
+    .argument('[id]', 'Watcher id to follow')
     .description('Tail logs from a watcher via long-polling')
     .option('--levels <levels>', 'Comma-separated log levels')
-    .option('--grep <text>', 'Filter by substring')
+    .option('--match <regex>', 'Filter by regex (repeatable)', collectMatch, [])
+    .option('--ignore-case', 'Use case-insensitive regex matching')
+    .option('--case-sensitive', 'Use case-sensitive regex matching')
+    .option('--source <pattern>', 'Filter by source substring')
     .option('--after <id>', 'Start after this event id')
     .option('--limit <count>', 'Maximum number of events per poll')
     .option('--timeout <ms>', 'Long-poll timeout in milliseconds')
-    .option('--json', 'Output newline-delimited JSON events')
-    .addHelpText('after', '\nExamples:\n  $ argus tail app\n  $ argus tail app --levels error\n  $ argus tail app --json\n')
+    .option('--json', 'Output bounded newline-delimited JSON events')
+    .option('--json-full', 'Output full newline-delimited JSON events (can be very large)')
+    .addHelpText('after', '\nExamples:\n  $ argus tail app\n  $ argus tail app --levels error\n  $ argus tail app --json\n  $ argus tail app --json-full\n')
     .action(async (id, options) => {
+    if (options.json && options.jsonFull) {
+        console.error('Cannot combine --json with --json-full.');
+        process.exitCode = 2;
+        return;
+    }
+    if (!validateCaseFlags(options)) {
+        return;
+    }
+    if (!validateMatchOptions(options)) {
+        return;
+    }
     await runTail(id, options);
 });
-program.parseAsync(process.argv);
+const net = program
+    .command('net')
+    .alias('network')
+    .argument('[id]', 'Watcher id to query')
+    .description('Fetch recent network request summaries from a watcher')
+    .option('--after <id>', 'Only return requests after this id')
+    .option('--limit <count>', 'Maximum number of requests')
+    .option('--since <duration>', 'Filter by time window (e.g. 10m, 2h, 30s)')
+    .option('--grep <substring>', 'Substring match over redacted URLs')
+    .option('--json', 'Output JSON for automation')
+    .addHelpText('after', '\nExamples:\n  $ argus net app --since 5m\n  $ argus net app --grep api\n  $ argus net app --json\n')
+    .action(async (id, options) => {
+    await runNet(id, options);
+});
+net.command('tail')
+    .argument('[id]', 'Watcher id to follow')
+    .description('Tail network request summaries via long-polling')
+    .option('--after <id>', 'Start after this request id')
+    .option('--limit <count>', 'Maximum number of requests per poll')
+    .option('--timeout <ms>', 'Long-poll timeout in milliseconds')
+    .option('--since <duration>', 'Filter by time window (e.g. 10m, 2h, 30s)')
+    .option('--grep <substring>', 'Substring match over redacted URLs')
+    .option('--json', 'Output newline-delimited JSON requests')
+    .addHelpText('after', '\nExamples:\n  $ argus net tail app\n  $ argus net tail app --grep api\n  $ argus net tail app --json\n')
+    .action(async (id, options) => {
+    await runNetTail(id, options);
+});
+program
+    .command('eval')
+    .argument('[id]', 'Watcher id to query')
+    .argument('<expression>', 'JS expression to evaluate')
+    .description('Evaluate a JS expression in the connected page')
+    .option('--no-await', 'Do not await promises')
+    .option('--timeout <ms>', 'Eval timeout in milliseconds')
+    .option('--json', 'Output JSON for automation')
+    .option('--no-return-by-value', 'Disable returnByValue (use preview)')
+    .option('--no-fail-on-exception', 'Do not exit with code 1 when the evaluation throws')
+    .option('--retry <n>', 'Retry failed evaluations up to N times')
+    .option('-q, --silent', 'Suppress success output; only emit output on error')
+    .option('--interval <ms|duration>', 'Re-evaluate every interval (e.g. 500, 3s)')
+    .option('--count <n>', 'Stop after N iterations (requires --interval)')
+    .option('--until <condition>', 'Stop when local condition becomes truthy (requires --interval)')
+    .option('--iframe <selector>', 'Eval in iframe via postMessage (requires helper script)')
+    .option('--iframe-namespace <name>', 'Message type prefix for iframe eval (default: argus)')
+    .option('--iframe-timeout <ms>', 'Timeout for iframe postMessage response (default: 5000)')
+    .addHelpText('after', `
+Examples:
+  $ argus eval app "location.href"
+  $ argus eval app "await fetch('/ping').then(r => r.status)"
+  $ argus eval app "document.title" --no-fail-on-exception
+  $ argus eval app "1+1" --retry 3
+  $ argus eval app "1+1" --silent
+  $ argus eval app "Date.now()" --interval 500 --count 10
+  $ argus eval app "document.title" --interval 250 --until 'result === "ready"'
+  $ argus eval app "window.gameState" --iframe "iframe#game"
+  $ argus eval app "document.title" --iframe "iframe" --iframe-timeout 10000
+`)
+    .action(async (id, expression, options) => {
+    await runEval(id, expression, {
+        json: options.json,
+        await: options.await,
+        timeout: options.timeout,
+        returnByValue: options.returnByValue,
+        failOnException: options.failOnException,
+        retry: options.retry,
+        silent: options.silent,
+        interval: options.interval,
+        count: options.count,
+        until: options.until,
+        iframe: options.iframe,
+        iframeNamespace: options.iframeNamespace,
+        iframeTimeout: options.iframeTimeout,
+    });
+});
+program
+    .command('iframe-helper')
+    .description('Output helper script for cross-origin iframe eval via postMessage')
+    .option('--out <file>', 'Write script to file instead of stdout')
+    .option('--no-log', 'Omit console.log confirmation')
+    .option('--iife', 'Wrap in IIFE to avoid global scope')
+    .option('--namespace <name>', 'Message type prefix (default: argus)')
+    .addHelpText('after', `
+Examples:
+  $ argus iframe-helper > helper.js
+  $ argus iframe-helper --out src/argus.js
+  $ argus iframe-helper --iife --no-log
+  $ argus iframe-helper --namespace myapp
+`)
+    .action(async (options) => {
+    await runIframeHelper(options);
+});
+const trace = program
+    .command('trace')
+    .argument('[id]', 'Watcher id to query')
+    .description('Capture a Chrome trace to disk on the watcher')
+    .option('--duration <duration>', 'Capture for duration (e.g. 3s, 500ms)')
+    .option('--out <file>', 'Output trace file path (relative to artifacts base directory)')
+    .option('--categories <categories>', 'Comma-separated tracing categories')
+    .option('--options <options>', 'Tracing options string')
+    .option('--json', 'Output JSON for automation')
+    .addHelpText('after', '\nExamples:\n  $ argus trace app --duration 3s --out trace.json\n')
+    .action(async (id, options) => {
+    await runTrace(id, options);
+});
+trace
+    .command('start')
+    .argument('[id]', 'Watcher id to query')
+    .description('Start Chrome tracing')
+    .option('--out <file>', 'Output trace file path (relative to artifacts base directory)')
+    .option('--categories <categories>', 'Comma-separated tracing categories')
+    .option('--options <options>', 'Tracing options string')
+    .option('--json', 'Output JSON for automation')
+    .addHelpText('after', '\nExamples:\n  $ argus trace start app --out trace.json\n')
+    .action(async (id, options) => {
+    await runTraceStart(id, options);
+});
+trace
+    .command('stop')
+    .argument('[id]', 'Watcher id to query')
+    .description('Stop Chrome tracing')
+    .option('--trace-id <id>', 'Trace id returned from start')
+    .option('--json', 'Output JSON for automation')
+    .addHelpText('after', '\nExamples:\n  $ argus trace stop app\n')
+    .action(async (id, options) => {
+    await runTraceStop(id, options);
+});
+program
+    .command('screenshot')
+    .argument('[id]', 'Watcher id to query')
+    .description('Capture a screenshot to disk on the watcher')
+    .option('--out <file>', 'Output screenshot file path (relative to artifacts base directory)')
+    .option('--selector <selector>', 'Optional CSS selector for element-only capture')
+    .option('--json', 'Output JSON for automation')
+    .addHelpText('after', '\nExamples:\n  $ argus screenshot app --out shot.png\n  $ argus screenshot app --selector "body" --out body.png\n')
+    .action(async (id, options) => {
+    await runScreenshot(id, options);
+});
+program
+    .command('reload')
+    .argument('[id]', 'Watcher id to reload')
+    .description('Reload the page attached to a watcher')
+    .option('--ignore-cache', 'Bypass browser cache')
+    .option('--json', 'Output JSON for automation')
+    .addHelpText('after', '\nExamples:\n  $ argus reload app\n  $ argus reload app --ignore-cache\n  $ argus reload app --json\n')
+    .action(async (id, options) => {
+    await runReload(id, options);
+});
+const dom = program.command('dom').alias('html').description('Inspect DOM elements in the connected page');
+dom.command('tree')
+    .argument('[id]', 'Watcher id to query')
+    .description('Fetch a DOM subtree rooted at element(s) matching a CSS selector')
+    .requiredOption('--selector <css>', 'CSS selector to match element(s)')
+    .option('--depth <n>', 'Max depth to traverse (default: 2)')
+    .option('--max-nodes <n>', 'Max total nodes to return (default: 5000)')
+    .option('--all', 'Allow multiple matches (default: error if >1 match)')
+    .option('--json', 'Output JSON for automation')
+    .addHelpText('after', '\nExamples:\n  $ argus dom tree app --selector "body"\n  $ argus dom tree app --selector "div" --all --depth 3\n  $ argus dom tree app --selector "#root" --json\n')
+    .action(async (id, options) => {
+    await runDomTree(id, options);
+});
+dom.command('info')
+    .argument('[id]', 'Watcher id to query')
+    .description('Fetch detailed info for element(s) matching a CSS selector')
+    .requiredOption('--selector <css>', 'CSS selector to match element(s)')
+    .option('--all', 'Allow multiple matches (default: error if >1 match)')
+    .option('--outer-html-max <n>', 'Max characters for outerHTML (default: 50000)')
+    .option('--json', 'Output JSON for automation')
+    .addHelpText('after', '\nExamples:\n  $ argus dom info app --selector "body"\n  $ argus dom info app --selector "div" --all\n  $ argus dom info app --selector "#root" --json\n')
+    .action(async (id, options) => {
+    await runDomInfo(id, options);
+});
+dom.command('hover')
+    .argument('[id]', 'Watcher id to query')
+    .description('Hover over element(s) matching a CSS selector')
+    .requiredOption('--selector <css>', 'CSS selector to match element(s)')
+    .option('--all', 'Allow multiple matches (default: error if >1 match)')
+    .option('--json', 'Output JSON for automation')
+    .addHelpText('after', '\nExamples:\n  $ argus dom hover app --selector "#btn"\n  $ argus dom hover app --selector ".item" --all\n  $ argus dom hover app --selector "#btn" --json\n')
+    .action(async (id, options) => {
+    await runDomHover(id, options);
+});
+dom.command('click')
+    .argument('[id]', 'Watcher id to query')
+    .description('Click element(s) matching a CSS selector')
+    .requiredOption('--selector <css>', 'CSS selector to match element(s)')
+    .option('--all', 'Allow multiple matches (default: error if >1 match)')
+    .option('--json', 'Output JSON for automation')
+    .addHelpText('after', '\nExamples:\n  $ argus dom click app --selector "#btn"\n  $ argus dom click app --selector ".item" --all\n  $ argus dom click app --selector "#btn" --json\n')
+    .action(async (id, options) => {
+    await runDomClick(id, options);
+});
+dom.command('add')
+    .argument('[id]', 'Watcher id to query')
+    .description('Insert HTML into the page relative to matched element(s)')
+    .requiredOption('--selector <css>', 'CSS selector for target element(s)')
+    .option('--html <string>', 'HTML to insert (use "-" for stdin)')
+    .option('--html-file <path>', 'Read HTML to insert from a file')
+    .option('--html-stdin', 'Read HTML to insert from stdin (same as --html -)')
+    .option('--position <pos>', 'Insert position: beforebegin, afterbegin, beforeend, afterend (aliases: before, after, prepend, append)', 'beforeend')
+    .option('--nth <index>', 'Insert at the zero-based match index')
+    .option('--first', 'Insert at the first match (same as --nth 0)')
+    .option('--expect <n>', 'Expect N matches before inserting')
+    .option('--text', 'Insert text content (uses insertAdjacentText)')
+    .option('--all', 'Insert at all matches (default: error if >1 match)')
+    .option('--json', 'Output JSON for automation')
+    .addHelpText('after', '\nExamples:\n  $ argus dom add app --selector "#container" --html "<div>Hello</div>"\n  $ argus dom add app --selector "body" --position append --html "<script src=\'debug.js\'></script>"\n  $ argus dom add app --selector ".item" --all --position afterend --html "<hr>"\n  $ argus dom add app --selector "#root" --html-file ./snippet.html\n  $ cat snippet.html | argus dom add app --selector "#root" --html -\n  $ argus dom add app --selector ".item" --nth 2 --html "<hr>"\n  $ argus dom add app --selector "#banner" --text --html "Preview mode"\n')
+    .action(async (id, options) => {
+    await runDomAdd(id, options);
+});
+dom.command('remove')
+    .argument('[id]', 'Watcher id to query')
+    .description('Remove elements from the page')
+    .requiredOption('--selector <css>', 'CSS selector for elements to remove')
+    .option('--all', 'Remove all matches (default: error if >1 match)')
+    .option('--json', 'Output JSON for automation')
+    .addHelpText('after', '\nExamples:\n  $ argus dom remove app --selector ".debug-overlay"\n  $ argus dom remove app --selector "[data-testid=\'temp\']" --all\n')
+    .action(async (id, options) => {
+    await runDomRemove(id, options);
+});
+const domModify = dom.command('modify').description('Modify DOM element properties');
+domModify
+    .command('attr')
+    .argument('[id]', 'Watcher id to query')
+    .argument('[attrs...]', 'Attributes: name (boolean) or name=value')
+    .requiredOption('--selector <css>', 'CSS selector for target element(s)')
+    .option('--remove <attrs...>', 'Attributes to remove')
+    .option('--all', 'Apply to all matches (default: error if >1 match)')
+    .option('--json', 'Output JSON for automation')
+    .addHelpText('after', '\nExamples:\n  $ argus dom modify attr app --selector "#btn" disabled\n  $ argus dom modify attr app --selector "#btn" data-loading=true aria-label="Submit"\n  $ argus dom modify attr app --selector "#btn" --remove disabled data-temp\n')
+    .action(async (id, attrs, options) => {
+    await runDomModifyAttr(id, attrs, options);
+});
+domModify
+    .command('class')
+    .argument('[id]', 'Watcher id to query')
+    .argument('[classes...]', 'Shorthand: +add, -remove, ~toggle (or plain name to add)')
+    .requiredOption('--selector <css>', 'CSS selector for target element(s)')
+    .option('--add <classes...>', 'Classes to add')
+    .option('--remove <classes...>', 'Classes to remove')
+    .option('--toggle <classes...>', 'Classes to toggle')
+    .option('--all', 'Apply to all matches (default: error if >1 match)')
+    .option('--json', 'Output JSON for automation')
+    .addHelpText('after', '\nExamples:\n  $ argus dom modify class app --selector "#btn" --add active highlighted\n  $ argus dom modify class app --selector "#btn" --remove hidden disabled\n  $ argus dom modify class app --selector "#btn" --toggle loading\n  $ argus dom modify class app --selector "#btn" +active +primary -hidden ~loading\n')
+    .action(async (id, classes, options) => {
+    await runDomModifyClass(id, classes, options);
+});
+domModify
+    .command('style')
+    .argument('[id]', 'Watcher id to query')
+    .argument('[styles...]', 'Styles: property=value')
+    .requiredOption('--selector <css>', 'CSS selector for target element(s)')
+    .option('--remove <props...>', 'Style properties to remove')
+    .option('--all', 'Apply to all matches (default: error if >1 match)')
+    .option('--json', 'Output JSON for automation')
+    .addHelpText('after', '\nExamples:\n  $ argus dom modify style app --selector "#btn" color=red font-size=14px\n  $ argus dom modify style app --selector "#btn" --remove color font-size\n')
+    .action(async (id, styles, options) => {
+    await runDomModifyStyle(id, styles, options);
+});
+domModify
+    .command('text')
+    .argument('[id]', 'Watcher id to query')
+    .argument('<text>', 'Text content to set')
+    .requiredOption('--selector <css>', 'CSS selector for target element(s)')
+    .option('--all', 'Apply to all matches (default: error if >1 match)')
+    .option('--json', 'Output JSON for automation')
+    .addHelpText('after', '\nExamples:\n  $ argus dom modify text app --selector "#msg" "Hello World"\n  $ argus dom modify text app --selector ".counter" --all "0"\n')
+    .action(async (id, text, options) => {
+    await runDomModifyText(id, text, options);
+});
+domModify
+    .command('html')
+    .argument('[id]', 'Watcher id to query')
+    .argument('<html>', 'HTML content to set')
+    .requiredOption('--selector <css>', 'CSS selector for target element(s)')
+    .option('--all', 'Apply to all matches (default: error if >1 match)')
+    .option('--json', 'Output JSON for automation')
+    .addHelpText('after', '\nExamples:\n  $ argus dom modify html app --selector "#container" "<p>New <strong>content</strong></p>"\n')
+    .action(async (id, html, options) => {
+    await runDomModifyHtml(id, html, options);
+});
+const chrome = program.command('chrome').alias('browser').description('Chrome/Chromium management commands');
+chrome
+    .command('start')
+    .description('Launch Chrome with CDP enabled')
+    .option('--url <url>', 'URL to open in Chrome')
+    .option('--from-watcher <watcherId>', 'Use match.url from a registered watcher')
+    .option('--profile <type>', 'Profile mode: temp, default-full, default-medium, or default-lite (default: default-lite)')
+    .option('--dev-tools', 'Open DevTools for new tabs')
+    .option('--config <path>', 'Path to Argus config file')
+    .option('--json', 'Output JSON for automation')
+    .addHelpText('after', '\nExamples:\n  $ argus chrome start\n  $ argus chrome start --url http://localhost:3000\n  $ argus chrome start --from-watcher app\n  $ argus chrome start --profile default-full\n  $ argus chrome start --profile default-medium\n  $ argus chrome start --profile default-lite\n  $ argus chrome start --profile temp\n  $ argus chrome start --dev-tools\n  $ argus chrome start --json\n')
+    .action(async (options, command) => {
+    const { config: configPath, ...cliOptions } = options;
+    const resolvedPath = resolveArgusConfigPath({ cliPath: configPath, cwd: process.cwd() });
+    if (!resolvedPath) {
+        if (configPath) {
+            return;
+        }
+        await runChromeStart(cliOptions);
+        return;
+    }
+    const configResult = loadArgusConfig(resolvedPath);
+    if (!configResult) {
+        return;
+    }
+    const merged = mergeChromeStartOptionsWithConfig(cliOptions, command, configResult);
+    if (!merged) {
+        return;
+    }
+    await runChromeStart(merged);
+});
+chrome
+    .command('version')
+    .description('Show Chrome version info from CDP endpoint')
+    .option('--cdp <host:port>', 'CDP host:port')
+    .option('--id <watcherId>', 'Use chrome config from a registered watcher')
+    .option('--json', 'Output JSON for automation')
+    .addHelpText('after', '\nExamples:\n  $ argus chrome version\n  $ argus chrome version --cdp 127.0.0.1:9222\n  $ argus chrome version --id app\n  $ argus chrome version --json\n')
+    .action(async (options) => {
+    await runChromeVersion(options);
+});
+chrome
+    .command('status')
+    .description('Check if Chrome CDP endpoint is reachable')
+    .option('--cdp <host:port>', 'CDP host:port')
+    .option('--id <watcherId>', 'Use chrome config from a registered watcher')
+    .option('--json', 'Output JSON for automation')
+    .addHelpText('after', '\nExamples:\n  $ argus chrome status\n  $ argus chrome status --cdp 127.0.0.1:9222\n  $ argus chrome status --id app\n')
+    .action(async (options) => {
+    await runChromeStatus(options);
+});
+chrome
+    .command('stop')
+    .alias('quit')
+    .description('Close the Chrome instance via CDP')
+    .option('--cdp <host:port>', 'CDP host:port')
+    .option('--id <watcherId>', 'Use chrome config from a registered watcher')
+    .option('--json', 'Output JSON for automation')
+    .addHelpText('after', '\nExamples:\n  $ argus chrome stop\n  $ argus chrome stop --id app\n  $ argus chrome stop --json\n')
+    .action(async (options) => {
+    await runChromeStop(options);
+});
+const collectParam = (value, previous) => [...previous, value];
+const page = program.command('page').alias('tab').description('Page/tab management commands');
+page.command('targets')
+    .aliases(['list', 'ls'])
+    .description('List Chrome targets (tabs, extensions, etc.)')
+    .option('--type <type>', 'Filter by target type (e.g. page, worker, iframe)')
+    .option('--tree', 'Show targets as a tree with parent-child relationships')
+    .option('--cdp <host:port>', 'CDP host:port')
+    .option('--id <watcherId>', 'Use chrome config from a registered watcher')
+    .option('--json', 'Output JSON for automation')
+    .addHelpText('after', '\nExamples:\n  $ argus page targets\n  $ argus page targets --type page\n  $ argus page targets --type iframe\n  $ argus page targets --tree\n  $ argus page targets --json\n  $ argus page targets --id app\n')
+    .action(async (options) => {
+    await runChromeTargets(options);
+});
+page.command('open')
+    .alias('new')
+    .description('Open a new tab in Chrome')
+    .requiredOption('--url <url>', 'URL to open')
+    .option('--cdp <host:port>', 'CDP host:port')
+    .option('--id <watcherId>', 'Use chrome config from a registered watcher')
+    .option('--json', 'Output JSON for automation')
+    .addHelpText('after', '\nExamples:\n  $ argus page open --url http://localhost:3000\n  $ argus page open --url localhost:3000\n  $ argus page open --url http://example.com --json\n')
+    .action(async (options) => {
+    await runChromeOpen(options);
+});
+page.command('activate')
+    .description('Activate (focus) a Chrome target')
+    .argument('[targetId]', 'Target ID to activate')
+    .option('--title <substring>', 'Case-insensitive substring match against target title')
+    .option('--url <substring>', 'Case-insensitive substring match against target URL')
+    .option('--match <substring>', 'Case-insensitive substring match against title + URL')
+    .option('--cdp <host:port>', 'CDP host:port')
+    .option('--id <watcherId>', 'Use chrome config from a registered watcher')
+    .option('--json', 'Output JSON for automation')
+    .addHelpText('after', '\nExamples:\n  $ argus page activate ABCD1234\n  $ argus page activate --title "Docs"\n  $ argus page activate --url localhost:3000\n  $ argus page activate --match "Argus" --json\n')
+    .action(async (targetId, options) => {
+    await runChromeActivate({ ...options, targetId });
+});
+page.command('close')
+    .description('Close a Chrome target')
+    .argument('<targetId>', 'Target ID to close')
+    .option('--cdp <host:port>', 'CDP host:port')
+    .option('--id <watcherId>', 'Use chrome config from a registered watcher')
+    .option('--json', 'Output JSON for automation')
+    .addHelpText('after', '\nExamples:\n  $ argus page close ABCD1234\n  $ argus page close ABCD1234 --json\n')
+    .action(async (targetId, options) => {
+    await runChromeClose({ ...options, targetId });
+});
+page.command('reload')
+    .description('Reload a Chrome target')
+    .argument('[targetId]', 'Target ID to reload')
+    .option('--attached', 'Reload the attached page for a watcher (requires --id)')
+    .option('--cdp <host:port>', 'CDP host:port')
+    .option('--id <watcherId>', 'Use chrome config from a registered watcher')
+    .option('--param <key=value>', 'Update query param (repeatable, overwrite semantics)', collectParam, [])
+    .option('--params <a=b&c=d>', 'Update query params from string (overwrite semantics)')
+    .option('--json', 'Output JSON for automation')
+    .addHelpText('after', '\nExamples:\n  $ argus page reload ABCD1234\n  $ argus page reload --attached --id app\n  $ argus page reload ABCD1234 --json\n  $ argus page reload ABCD1234 --param foo=bar\n  $ argus page reload ABCD1234 --param foo=bar --param baz=qux\n  $ argus page reload ABCD1234 --params "a=1&b=2"\n')
+    .action(async (targetId, options) => {
+    await runPageReload({ ...options, targetId });
+});
+const watcher = program.command('watcher').alias('watchers').description('Watcher management commands');
+watcher
+    .command('list')
+    .alias('ls')
+    .description('List registered watchers')
+    .option('--json', 'Output JSON for automation')
+    .option('--by-cwd <substring>', 'Filter watchers by working directory substring')
+    .addHelpText('after', '\nExamples:\n  $ argus watcher list\n  $ argus watcher list --json\n  $ argus watcher list --by-cwd my-project\n')
+    .action(async (options) => {
+    await runList(options);
+});
+watcher
+    .command('status')
+    .alias('ping')
+    .argument('[id]', 'Watcher id to query')
+    .description('Check watcher status')
+    .option('--json', 'Output JSON for automation')
+    .addHelpText('after', '\nExamples:\n  $ argus watcher status app\n  $ argus watcher status app --json\n')
+    .action(async (id, options) => {
+    await runWatcherStatus(id, options);
+});
+watcher
+    .command('stop')
+    .alias('kill')
+    .argument('[id]', 'Watcher id to stop')
+    .description('Stop a watcher')
+    .addHelpText('after', '\nExamples:\n  $ argus watcher stop app\n  $ argus watcher kill app\n')
+    .action(async (id, options) => {
+    await runWatcherStop(id, options);
+});
+watcher
+    .command('start')
+    .description('Start an Argus watcher process')
+    .option('--id <watcherId>', 'Watcher id to announce in the registry')
+    .option('--source <mode>', 'Source mode: cdp (default) or extension')
+    .option('--url <url>', 'URL pattern to match for capturing logs (CDP mode only)')
+    .option('--type <type>', 'Filter by target type (e.g., page, iframe, worker) (CDP mode only)')
+    .option('--origin <origin>', 'Match against URL origin only (protocol + host + port) (CDP mode only)')
+    .option('--target <targetId>', 'Connect to a specific target by its Chrome target ID (CDP mode only)')
+    .option('--parent <pattern>', 'Filter by parent target URL pattern (CDP mode only)')
+    .option('--chrome-host <host>', 'Chrome CDP host (default: 127.0.0.1) (CDP mode only)')
+    .option('--chrome-port <port>', 'Chrome CDP port (default: 9222) (CDP mode only)')
+    .option('--artifacts <dir>', 'Artifacts base directory (default: <cwd>/argus-artifacts)')
+    .option('--no-page-indicator', 'Disable the in-page watcher indicator (CDP mode only)')
+    .option('--config <path>', 'Path to Argus config file')
+    .option('--json', 'Output JSON for automation')
+    .addHelpText('after', '\nExamples:\n  $ argus watcher start --id app --url localhost:3000\n  $ argus watcher start --id app --source extension\n  $ argus watcher start --id game --type iframe --url localhost:3007\n  $ argus watcher start --id game --origin https://localhost:3007\n  $ argus watcher start --id game --target CC1135709D9AC3B9CC0446F8B58CC344\n  $ argus watcher start --id game --type iframe --parent yandex.ru\n  $ argus watcher start --id app --url localhost:3000 --no-page-indicator\n  $ argus watcher start --id app --url localhost:3000 --json\n')
+    .action(async (options, command) => {
+    const { config: configPath, ...cliOptions } = options;
+    const resolvedPath = resolveArgusConfigPath({ cliPath: configPath, cwd: process.cwd() });
+    if (!resolvedPath) {
+        if (configPath) {
+            return;
+        }
+        await runWatcherStart(cliOptions);
+        return;
+    }
+    const configResult = loadArgusConfig(resolvedPath);
+    if (!configResult) {
+        return;
+    }
+    const merged = mergeWatcherStartOptionsWithConfig(cliOptions, command, configResult);
+    if (!merged) {
+        return;
+    }
+    await runWatcherStart(merged);
+});
+watcher
+    .command('prune')
+    .alias('clean')
+    .description('Remove unreachable watchers from the registry')
+    .option('--by-cwd <substring>', 'Filter watchers by working directory substring')
+    .option('--dry-run', 'Preview what would be removed without changing the registry')
+    .option('--json', 'Output JSON for automation')
+    .addHelpText('after', '\nExamples:\n  $ argus watcher prune\n  $ argus watcher prune --by-cwd my-project\n  $ argus watcher prune --dry-run\n  $ argus watcher prune --dry-run --json\n')
+    .action(async (options) => {
+    await runWatcherPrune(options);
+});
+watcher
+    .command('native-host')
+    .description('Start a watcher as a Native Messaging host (used by Chrome extension)')
+    .option('--id <watcherId>', 'Watcher id (default: extension)')
+    .option('--json', 'Output JSON for automation')
+    .action(async (options) => {
+    await runWatcherNativeHost(options);
+});
+const storage = program.command('storage').description('Interact with browser storage APIs');
+const storageLocal = storage.command('local').description('Manage localStorage for the attached page');
+storageLocal
+    .command('get')
+    .argument('[id]', 'Watcher id')
+    .argument('<key>', 'localStorage key to retrieve')
+    .option('--origin <origin>', 'Validate page origin matches this value')
+    .option('--json', 'Output JSON for automation')
+    .addHelpText('after', '\nExamples:\n  $ argus storage local get app myKey\n  $ argus storage local get app myKey --json\n')
+    .action(async (id, key, options) => {
+    await runStorageLocalGet(id, key, options);
+});
+storageLocal
+    .command('set')
+    .argument('[id]', 'Watcher id')
+    .argument('<key>', 'localStorage key to set')
+    .argument('<value>', 'Value to store')
+    .option('--origin <origin>', 'Validate page origin matches this value')
+    .option('--json', 'Output JSON for automation')
+    .addHelpText('after', '\nExamples:\n  $ argus storage local set app myKey "myValue"\n  $ argus storage local set app config \'{"debug":true}\'\n')
+    .action(async (id, key, value, options) => {
+    await runStorageLocalSet(id, key, value, options);
+});
+storageLocal
+    .command('remove')
+    .argument('[id]', 'Watcher id')
+    .argument('<key>', 'localStorage key to remove')
+    .option('--origin <origin>', 'Validate page origin matches this value')
+    .option('--json', 'Output JSON for automation')
+    .addHelpText('after', '\nExamples:\n  $ argus storage local remove app myKey\n')
+    .action(async (id, key, options) => {
+    await runStorageLocalRemove(id, key, options);
+});
+storageLocal
+    .command('list')
+    .argument('[id]', 'Watcher id')
+    .option('--origin <origin>', 'Validate page origin matches this value')
+    .option('--json', 'Output JSON for automation')
+    .addHelpText('after', '\nExamples:\n  $ argus storage local list app\n  $ argus storage local list app --json\n')
+    .action(async (id, options) => {
+    await runStorageLocalList(id, options);
+});
+storageLocal
+    .command('clear')
+    .argument('[id]', 'Watcher id')
+    .option('--origin <origin>', 'Validate page origin matches this value')
+    .option('--json', 'Output JSON for automation')
+    .addHelpText('after', '\nExamples:\n  $ argus storage local clear app\n')
+    .action(async (id, options) => {
+    await runStorageLocalClear(id, options);
+});
+const extension = program.command('extension').alias('ext').description('Browser extension management');
+extension
+    .command('setup <extensionId>')
+    .description('Install native messaging host for the browser extension')
+    .option('--json', 'Output JSON for automation')
+    .addHelpText('after', '\nTo get your extension ID:\n  1. Open chrome://extensions\n  2. Enable Developer mode\n  3. Load argus-extension as unpacked\n  4. Copy the ID from the extension card\n')
+    .action(async (extensionId, options) => {
+    await runExtensionSetup({ extensionId, ...options });
+});
+extension
+    .command('remove')
+    .description('Uninstall native messaging host')
+    .option('--json', 'Output JSON for automation')
+    .action(async (options) => {
+    await runExtensionRemove(options);
+});
+extension
+    .command('status')
+    .description('Check native messaging host configuration')
+    .option('--json', 'Output JSON for automation')
+    .action(async (options) => {
+    await runExtensionStatus(options);
+});
+extension
+    .command('info')
+    .description('Show native messaging host paths and configuration')
+    .option('--json', 'Output JSON for automation')
+    .action(async (options) => {
+    await runExtensionInfo(options);
+});
+async function main() {
+    const cwd = process.cwd();
+    const configPath = resolveArgusConfigPath({ cwd });
+    const configResult = configPath ? loadArgusConfig(configPath) : null;
+    const config = configResult?.config ?? {};
+    const configDir = configResult?.configDir ?? cwd;
+    const registry = new PluginRegistry();
+    try {
+        await registry.loadFromConfig(config, {
+            cwd,
+            configDir,
+            argusConfig: config,
+        });
+        registry.registerWith(program);
+    }
+    catch (error) {
+        console.error('Plugin loading failed:', error);
+        process.exit(1);
+    }
+    const cleanup = async () => {
+        await registry.cleanup();
+    };
+    process.on('exit', () => void cleanup());
+    process.on('SIGINT', () => void cleanup());
+    process.on('SIGTERM', () => void cleanup());
+    await program.parseAsync(process.argv);
+}
+main().catch((error) => {
+    console.error(error);
+    process.exit(1);
+});
 //# sourceMappingURL=bin.js.map