@vforsh/argus 0.1.16 → 0.1.19

package/dist/cli/register/pageCommands.js

@@ -0,0 +1,188 @@
+import { runChromeTargets, runChromeOpen, runChromeActivate, runChromeClose } from '../../commands/chrome.js';
+import { runPageReload } from '../../commands/page.js';
+import { runPageEmulationSet, runPageEmulationClear, runPageEmulationStatus } from '../../commands/pageEmulation.js';
+import { runPageShow, runPageHide } from '../../commands/pageVisibility.js';
+import { listPresetNames } from '../../emulation/devices.js';
+import { collectParam } from '../validation.js';
+const cdpTargetOptions = [
+    { flags: '--cdp <host:port>', description: 'CDP host:port' },
+    { flags: '--id <watcherId>', description: 'Use chrome config from a registered watcher' },
+    { flags: '--json', description: 'Output JSON for automation' },
+];
+const presetList = listPresetNames().join(', ');
+const emulationCommand = {
+    name: 'emulation',
+    alias: 'emu',
+    description: 'Device emulation controls (viewport, touch, user-agent)',
+    subcommands: [
+        {
+            name: 'set',
+            description: 'Set device emulation on the watcher-attached page',
+            arguments: [{ flags: '[id]', description: 'Watcher ID' }],
+            options: [
+                { flags: '--device <name>', description: `Device preset (${presetList})` },
+                { flags: '--width <n>', description: 'Viewport width (px)' },
+                { flags: '--height <n>', description: 'Viewport height (px)' },
+                { flags: '--dpr <n>', description: 'Device pixel ratio' },
+                { flags: '--mobile', description: 'Enable mobile emulation' },
+                { flags: '--no-mobile', description: 'Disable mobile emulation' },
+                { flags: '--touch', description: 'Enable touch emulation' },
+                { flags: '--no-touch', description: 'Disable touch emulation' },
+                { flags: '--ua <string>', description: 'Override user-agent string' },
+                { flags: '--json', description: 'Output JSON for automation' },
+            ],
+            configure: (command) => {
+                command.addHelpText('after', `\nExamples:\n  $ argus page emulation set app --device iphone-14\n  $ argus page emulation set app --width 1600 --height 900\n  $ argus page emulation set app --device pixel-7 --width 500\n  $ argus page emu set app --device desktop-1440\n\nAvailable devices: ${presetList}\n`);
+            },
+            action: async (id, options) => {
+                await runPageEmulationSet(id, options);
+            },
+        },
+        {
+            name: 'clear',
+            description: 'Clear device emulation (restore defaults)',
+            arguments: [{ flags: '[id]', description: 'Watcher ID' }],
+            options: [{ flags: '--json', description: 'Output JSON for automation' }],
+            examples: ['argus page emulation clear app', 'argus page emu clear app --json'],
+            action: async (id, options) => {
+                await runPageEmulationClear(id, options);
+            },
+        },
+        {
+            name: 'status',
+            description: 'Show current emulation state',
+            arguments: [{ flags: '[id]', description: 'Watcher ID' }],
+            options: [{ flags: '--json', description: 'Output JSON for automation' }],
+            examples: ['argus page emulation status app', 'argus page emu status app --json'],
+            action: async (id, options) => {
+                await runPageEmulationStatus(id, options);
+            },
+        },
+    ],
+};
+export const pageCommands = [
+    {
+        name: 'page',
+        alias: 'tab',
+        description: 'Page/tab management commands',
+        subcommands: [
+            {
+                name: 'ls',
+                aliases: ['targets', 'list'],
+                description: 'List Chrome targets (tabs, extensions, etc.)',
+                options: [
+                    { flags: '--type <type>', description: 'Filter by target type (e.g. page, worker, iframe)' },
+                    { flags: '--tree', description: 'Show targets as a tree with parent-child relationships' },
+                    ...cdpTargetOptions,
+                ],
+                examples: [
+                    'argus page ls',
+                    'argus page ls --type page',
+                    'argus page ls --type iframe',
+                    'argus page ls --tree',
+                    'argus page ls --json',
+                    'argus page ls --id app',
+                ],
+                action: async (options) => {
+                    await runChromeTargets(options);
+                },
+            },
+            {
+                name: 'open',
+                alias: 'new',
+                description: 'Open a new tab in Chrome',
+                options: [{ flags: '--url <url>', description: 'URL to open', required: true }, ...cdpTargetOptions],
+                examples: [
+                    'argus page open --url http://localhost:3000',
+                    'argus page open --url localhost:3000',
+                    'argus page open --url http://example.com --json',
+                ],
+                action: async (options) => {
+                    await runChromeOpen(options);
+                },
+            },
+            {
+                name: 'activate',
+                description: 'Activate (focus) a Chrome target',
+                arguments: [{ flags: '[targetId]', description: 'Target ID to activate' }],
+                options: [
+                    { flags: '--title <substring>', description: 'Case-insensitive substring match against target title' },
+                    { flags: '--url <substring>', description: 'Case-insensitive substring match against target URL' },
+                    { flags: '--match <substring>', description: 'Case-insensitive substring match against title + URL' },
+                    ...cdpTargetOptions,
+                ],
+                examples: [
+                    'argus page activate ABCD1234',
+                    'argus page activate --title "Docs"',
+                    'argus page activate --url localhost:3000',
+                    'argus page activate --match "Argus" --json',
+                ],
+                action: async (targetId, options) => {
+                    await runChromeActivate({ ...options, targetId });
+                },
+            },
+            {
+                name: 'close',
+                description: 'Close a Chrome target',
+                arguments: [{ flags: '<targetId>', description: 'Target ID to close' }],
+                options: cdpTargetOptions,
+                examples: ['argus page close ABCD1234', 'argus page close ABCD1234 --json'],
+                action: async (targetId, options) => {
+                    await runChromeClose({ ...options, targetId });
+                },
+            },
+            {
+                name: 'show',
+                description: 'Lock the attached page as shown+focused (unthrottles rAF/timers when window is covered)',
+                arguments: [{ flags: '[id]', description: 'Watcher ID' }],
+                options: [{ flags: '--json', description: 'Output JSON for automation' }],
+                configure: (command) => {
+                    command.addHelpText('after', '\nExamples:\n  $ argus page show app\n  $ argus page show app --json\n\nForces focus emulation on the attached page so boot/preview flows keep\nmaking progress even if the Chrome window is backgrounded or covered.\nLock persists until `argus page hide <id>`; survives watcher reattach.\n');
+                },
+                action: async (id, options) => {
+                    await runPageShow(id, options);
+                },
+            },
+            {
+                name: 'hide',
+                description: 'Release the visibility lock (restore default Chrome throttling behavior)',
+                arguments: [{ flags: '[id]', description: 'Watcher ID' }],
+                options: [{ flags: '--json', description: 'Output JSON for automation' }],
+                examples: ['argus page hide app', 'argus page hide app --json'],
+                action: async (id, options) => {
+                    await runPageHide(id, options);
+                },
+            },
+            {
+                name: 'reload',
+                description: 'Reload a Chrome target',
+                arguments: [{ flags: '[targetId]', description: 'Target ID to reload (omit with --id to reload the attached page)' }],
+                options: [
+                    { flags: '--cdp <host:port>', description: 'CDP host:port' },
+                    { flags: '--id <watcherId>', description: 'Use chrome config from a registered watcher' },
+                    {
+                        flags: '--param <key=value>',
+                        description: 'Update query param (repeatable, overwrite semantics)',
+                        parser: collectParam,
+                        defaultValue: [],
+                    },
+                    { flags: '--params <a=b&c=d>', description: 'Update query params from string (overwrite semantics)' },
+                    { flags: '--json', description: 'Output JSON for automation' },
+                ],
+                examples: [
+                    'argus page reload ABCD1234',
+                    'argus page reload --id app',
+                    'argus page reload ABCD1234 --json',
+                    'argus page reload ABCD1234 --param foo=bar',
+                    'argus page reload ABCD1234 --param foo=bar --param baz=qux',
+                    'argus page reload ABCD1234 --params "a=1&b=2"',
+                ],
+                action: async (targetId, options) => {
+                    await runPageReload({ ...options, targetId });
+                },
+            },
+            emulationCommand,
+        ],
+    },
+];
+//# sourceMappingURL=pageCommands.js.map

package/dist/cli/register/pageCommands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pageCommands.js","sourceRoot":"","sources":["../../../src/cli/register/pageCommands.ts"],"names":[],"mappings":"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"}

package/dist/cli/register/pluginCommands.d.ts

@@ -0,0 +1,3 @@
+import type { ArgusCommandDefinition } from '../defineCommand.js';
+export declare const pluginCommands: readonly ArgusCommandDefinition[];
+//# sourceMappingURL=pluginCommands.d.ts.map

package/dist/cli/register/pluginCommands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pluginCommands.d.ts","sourceRoot":"","sources":["../../../src/cli/register/pluginCommands.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAA;AAUjE,eAAO,MAAM,cAAc,EAAE,SAAS,sBAAsB,EA0C3D,CAAA"}

package/dist/cli/register/pluginCommands.js

@@ -0,0 +1,51 @@
+import { runPluginList } from '../../commands/pluginList.js';
+import { runPluginAdd, runPluginRemove } from '../../commands/pluginConfig.js';
+const configFileOptions = [
+    { flags: '--path <file>', description: 'Config file to update (default: discovered config or .argus/config.json)' },
+    { flags: '--global', description: 'Update the per-user Argus config at ARGUS_HOME/config.json' },
+    { flags: '--json', description: 'Output JSON for automation' },
+];
+export const pluginCommands = [
+    {
+        name: 'plugin',
+        alias: 'plugins',
+        description: 'Manage Argus CLI plugins',
+        subcommands: [
+            {
+                name: 'list',
+                alias: 'ls',
+                description: 'List plugins discovered for this invocation',
+                options: [{ flags: '--json', description: 'Output JSON for automation' }],
+                examples: ['argus plugin list', 'argus --plugin ./plugins/foo.js plugin list --json'],
+                action: (options) => {
+                    runPluginList(options);
+                },
+            },
+            {
+                name: 'add <specifier>',
+                description: 'Add a plugin specifier or alias to the Argus config',
+                options: configFileOptions,
+                examples: [
+                    'argus plugin add gsheets',
+                    'argus plugin add --global clogs=~/dev/argus-clogs-plugin/dist/index.js',
+                    'argus plugin add gs=@vforsh/argus-plugin-google-sheets',
+                    'argus plugin add ./plugins/foo.js',
+                ],
+                action: async (specifier, options) => {
+                    await runPluginAdd(specifier, options);
+                },
+            },
+            {
+                name: 'remove <specifierOrName>',
+                alias: 'rm',
+                description: 'Remove a plugin from the Argus config',
+                options: configFileOptions,
+                examples: ['argus plugin remove @vforsh/argus-plugin-google-sheets', 'argus plugin remove google-sheets'],
+                action: async (specifierOrName, options) => {
+                    await runPluginRemove(specifierOrName, options);
+                },
+            },
+        ],
+    },
+];
+//# sourceMappingURL=pluginCommands.js.map

package/dist/cli/register/pluginCommands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pluginCommands.js","sourceRoot":"","sources":["../../../src/cli/register/pluginCommands.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAA;AAC5D,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAA;AAE9E,MAAM,iBAAiB,GAAG;IACzB,EAAE,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,0EAA0E,EAAE;IACnH,EAAE,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,4DAA4D,EAAE;IAChG,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,4BAA4B,EAAE;CACrD,CAAA;AAEV,MAAM,CAAC,MAAM,cAAc,GAAsC;IAChE;QACC,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,SAAS;QAChB,WAAW,EAAE,0BAA0B;QACvC,WAAW,EAAE;YACZ;gBACC,IAAI,EAAE,MAAM;gBACZ,KAAK,EAAE,IAAI;gBACX,WAAW,EAAE,6CAA6C;gBAC1D,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,4BAA4B,EAAE,CAAC;gBACzE,QAAQ,EAAE,CAAC,mBAAmB,EAAE,oDAAoD,CAAC;gBACrF,MAAM,EAAE,CAAC,OAAO,EAAE,EAAE;oBACnB,aAAa,CAAC,OAAO,CAAC,CAAA;gBACvB,CAAC;aACD;YACD;gBACC,IAAI,EAAE,iBAAiB;gBACvB,WAAW,EAAE,qDAAqD;gBAClE,OAAO,EAAE,iBAAiB;gBAC1B,QAAQ,EAAE;oBACT,0BAA0B;oBAC1B,wEAAwE;oBACxE,wDAAwD;oBACxD,mCAAmC;iBACnC;gBACD,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE;oBACpC,MAAM,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,CAAA;gBACvC,CAAC;aACD;YACD;gBACC,IAAI,EAAE,0BAA0B;gBAChC,KAAK,EAAE,IAAI;gBACX,WAAW,EAAE,uCAAuC;gBACpD,OAAO,EAAE,iBAAiB;gBAC1B,QAAQ,EAAE,CAAC,wDAAwD,EAAE,mCAAmC,CAAC;gBACzG,MAAM,EAAE,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,EAAE;oBAC1C,MAAM,eAAe,CAAC,eAAe,EAAE,OAAO,CAAC,CAAA;gBAChD,CAAC;aACD;SACD;KACD;CACD,CAAA"}

package/dist/cli/register/quickAccessCommands.d.ts

@@ -0,0 +1,3 @@
+import type { ArgusCommandDefinition } from '../defineCommand.js';
+export declare const quickAccessCommands: readonly ArgusCommandDefinition[];
+//# sourceMappingURL=quickAccessCommands.d.ts.map

package/dist/cli/register/quickAccessCommands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quickAccessCommands.d.ts","sourceRoot":"","sources":["../../../src/cli/register/quickAccessCommands.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAA;AAQjE,eAAO,MAAM,mBAAmB,EAAE,SAAS,sBAAsB,EA4GhE,CAAA"}

package/dist/cli/register/quickAccessCommands.js

@@ -0,0 +1,138 @@
+import { runList } from '../../commands/list.js';
+import { runStart } from '../../commands/start.js';
+import { runDoctor } from '../../commands/doctor.js';
+import { runReload } from '../../commands/reload.js';
+import { loadArgusConfig, resolveArgusConfigPath } from '../../config/loadConfig.js';
+import { mergeChromeStartOptionsWithConfig, mergeWatcherStartOptionsWithConfig } from '../../config/mergeConfig.js';
+export const quickAccessCommands = [
+    {
+        name: 'list',
+        alias: 'ls',
+        description: 'List watchers and Chrome instances',
+        options: [
+            { flags: '--json', description: 'Output JSON for automation' },
+            { flags: '--by-cwd <substring>', description: 'Filter watchers by working directory substring' },
+        ],
+        examples: ['argus list', 'argus ls', 'argus list --json', 'argus list --by-cwd my-project'],
+        action: async (options) => {
+            await runList(options);
+        },
+    },
+    {
+        name: 'start',
+        description: 'Launch Chrome and attach a watcher in one command',
+        options: [
+            { flags: '--id <watcherId>', description: 'Watcher id', required: true },
+            { flags: '--url <url>', description: 'URL to open in Chrome and match for the watcher' },
+            {
+                flags: '--auth-from <watcherId>',
+                description: 'Clone auth state from another watcher into a fresh temp Chrome session before attaching',
+            },
+            {
+                flags: '--profile <type>',
+                description: 'Chrome profile mode: temp, default-full, default-medium, or default-lite (default: default-lite)',
+            },
+            { flags: '--dev-tools', description: 'Open DevTools for new tabs' },
+            { flags: '--headless', description: 'Run Chrome in headless mode' },
+            { flags: '--type <type>', description: 'Filter by target type (e.g., page, iframe, worker)' },
+            { flags: '--origin <origin>', description: 'Match against URL origin only (protocol + host + port)' },
+            { flags: '--target <targetId>', description: 'Connect to a specific target by its Chrome target ID' },
+            { flags: '--parent <pattern>', description: 'Filter by parent target URL pattern' },
+            { flags: '--no-page-indicator', description: 'Disable the in-page watcher indicator' },
+            { flags: '--inject <path>', description: 'Path to JavaScript file to inject on watcher attach' },
+            { flags: '--artifacts <dir>', description: 'Artifacts base directory' },
+            { flags: '--config <path>', description: 'Path to Argus config file' },
+            { flags: '--json', description: 'Output JSON for automation' },
+        ],
+        examples: [
+            'argus start --id app --url localhost:3000',
+            'argus start --id app --auth-from extension-2',
+            'argus start --id app --auth-from extension-2 --url https://target.app/',
+            'argus start --id app --url localhost:3000 --dev-tools',
+            'argus start --id app --url localhost:3000 --profile temp',
+            'argus start --id app --type page --headless',
+            'argus start --id app --url localhost:3000 --inject ./debug.js',
+            'argus start --id app --url localhost:3000 --json',
+        ],
+        action: async (options, command) => {
+            const { config: configPath, inject, ...rest } = options;
+            const cliOptions = {
+                ...rest,
+                inject: inject ? { file: inject } : undefined,
+            };
+            if (!normalizeStartAuthOptions(command, cliOptions)) {
+                return;
+            }
+            const resolvedPath = resolveArgusConfigPath({ cliPath: configPath, cwd: process.cwd() });
+            if (!resolvedPath) {
+                if (configPath) {
+                    return;
+                }
+                await runStart(applyStartAuthOverrides(command, cliOptions));
+                return;
+            }
+            const configResult = loadArgusConfig(resolvedPath);
+            if (!configResult) {
+                return;
+            }
+            const mergedChrome = mergeChromeStartOptionsWithConfig(cliOptions, command, configResult);
+            if (!mergedChrome) {
+                return;
+            }
+            const mergedWatcher = mergeWatcherStartOptionsWithConfig(mergedChrome, command, configResult);
+            if (!mergedWatcher) {
+                return;
+            }
+            await runStart(applyStartAuthOverrides(command, mergedWatcher));
+        },
+    },
+    {
+        name: 'doctor',
+        description: 'Run environment diagnostics for Argus',
+        options: [{ flags: '--json', description: 'Output JSON for automation' }],
+        examples: ['argus doctor', 'argus doctor --json'],
+        action: async (options) => {
+            await runDoctor(options);
+        },
+    },
+    {
+        name: 'reload',
+        description: 'Reload the page attached to a watcher',
+        arguments: [{ flags: '[id]', description: 'Watcher id to reload' }],
+        options: [
+            { flags: '--ignore-cache', description: 'Bypass browser cache' },
+            { flags: '--json', description: 'Output JSON for automation' },
+        ],
+        examples: ['argus reload app', 'argus reload app --ignore-cache', 'argus reload app --json'],
+        action: async (id, options) => {
+            await runReload(id, options);
+        },
+    },
+];
+const normalizeStartAuthOptions = (command, options) => {
+    if (!options.authFrom) {
+        return true;
+    }
+    if (getOptionValueSource(command, 'profile') === 'cli') {
+        if (options.profile && options.profile !== 'temp') {
+            console.error('Cannot combine --auth-from with a copied Chrome profile. Use --profile temp or omit --profile.');
+            process.exitCode = 2;
+            return false;
+        }
+        return true;
+    }
+    options.profile = undefined;
+    return true;
+};
+const applyStartAuthOverrides = (command, options) => {
+    if (!options.authFrom) {
+        return options;
+    }
+    options.profile = 'temp';
+    if (getOptionValueSource(command, 'url') !== 'cli') {
+        options.url = undefined;
+    }
+    return options;
+};
+const getOptionValueSource = (command, key) => command.getOptionValueSource(key) ?? '';
+//# sourceMappingURL=quickAccessCommands.js.map

package/dist/cli/register/quickAccessCommands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quickAccessCommands.js","sourceRoot":"","sources":["../../../src/cli/register/quickAccessCommands.ts"],"names":[],"mappings":"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"}

package/dist/cli/register/recordCommands.d.ts

@@ -0,0 +1,3 @@
+import type { ArgusCommandDefinition } from '../defineCommand.js';
+export declare const recordCommands: readonly ArgusCommandDefinition[];
+//# sourceMappingURL=recordCommands.d.ts.map

package/dist/cli/register/recordCommands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recordCommands.d.ts","sourceRoot":"","sources":["../../../src/cli/register/recordCommands.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAA;AAKjE,eAAO,MAAM,cAAc,EAAE,SAAS,sBAAsB,EA+D3D,CAAA"}

package/dist/cli/register/recordCommands.js

@@ -0,0 +1,90 @@
+import { resolveTestId } from '../../commands/resolveTestId.js';
+import { runRecord, runRecordStart, runRecordStop } from '../../commands/record.js';
+export const recordCommands = [
+    {
+        name: 'record',
+        description: 'Capture a silent video recording to disk on the watcher',
+        arguments: [{ flags: '[id]', description: 'Watcher id to query' }],
+        options: [
+            { flags: '--duration <duration>', description: 'Capture for duration (e.g. 3s, 500ms)' },
+            { flags: '--out <file>', description: 'Output .mp4 or .webm path (absolute or relative to artifacts directory)' },
+            { flags: '--selector <selector>', description: 'Optional CSS selector for element-only recording' },
+            { flags: '--clip <x,y,width,height>', description: 'Viewport-relative rectangle crop in CSS pixels' },
+            { flags: '--testid <id>', description: 'Shorthand for --selector "[data-testid=\'<id>\']"' },
+            { flags: '--fps <n>', description: 'Output frames per second (1-60, default 30)' },
+            { flags: '--format <format>', description: 'Output format: mp4 or webm (default mp4, inferred from --out extension)' },
+            { flags: '--json', description: 'Output JSON for automation' },
+        ],
+        examples: [
+            'argus record app --duration 5s --out demo.mp4',
+            'argus record app --duration 3s --selector "canvas" --out canvas.mp4',
+            'argus record app --duration 3s --clip 100,80,640,360 --out crop.mp4',
+            'argus record app --duration 3s --format webm --out canvas.webm',
+        ],
+        action: async (id, options, command) => {
+            const resolved = resolveActionOptions(options, command);
+            if (!resolveTestId(resolved))
+                return;
+            await runRecord(id, resolved);
+        },
+        subcommands: [
+            {
+                name: 'start',
+                description: 'Start a silent video recording',
+                arguments: [{ flags: '[id]', description: 'Watcher id to query' }],
+                options: [
+                    { flags: '--out <file>', description: 'Output .mp4 or .webm path (absolute or relative to artifacts directory)' },
+                    { flags: '--selector <selector>', description: 'Optional CSS selector for element-only recording' },
+                    { flags: '--clip <x,y,width,height>', description: 'Viewport-relative rectangle crop in CSS pixels' },
+                    { flags: '--testid <id>', description: 'Shorthand for --selector "[data-testid=\'<id>\']"' },
+                    { flags: '--fps <n>', description: 'Output frames per second (1-60, default 30)' },
+                    { flags: '--format <format>', description: 'Output format: mp4 or webm (default mp4, inferred from --out extension)' },
+                    { flags: '--json', description: 'Output JSON for automation' },
+                ],
+                examples: ['argus record start app --selector "canvas" --out canvas.mp4'],
+                action: async (id, options, command) => {
+                    const resolved = resolveActionOptions(options, command);
+                    if (!resolveTestId(resolved))
+                        return;
+                    await runRecordStart(id, resolved);
+                },
+            },
+            {
+                name: 'stop',
+                description: 'Stop the active video recording',
+                arguments: [{ flags: '[id]', description: 'Watcher id to query' }],
+                options: [
+                    { flags: '--record-id <id>', description: 'Record id returned from start' },
+                    { flags: '--out <file>', description: 'Move the saved recording to this .mp4 or .webm path before returning' },
+                    { flags: '--json', description: 'Output JSON for automation' },
+                ],
+                examples: ['argus record stop app', 'argus record stop app --out demo.mp4 --json'],
+                action: async (id, options, command) => {
+                    await runRecordStop(id, resolveActionOptions(options, command));
+                },
+            },
+        ],
+    },
+];
+/**
+ * `record` is both a command and a subcommand parent, so Commander may pass
+ * either (options, command) or just the command. Merge parent + own opts.
+ */
+function resolveActionOptions(options, command) {
+    const maybeCommand = options;
+    if (typeof maybeCommand?.opts === 'function') {
+        return {
+            ...(typeof maybeCommand.parent?.opts === 'function' ? maybeCommand.parent.opts() : {}),
+            ...maybeCommand.opts(),
+        };
+    }
+    if (typeof command?.opts === 'function') {
+        return {
+            ...(typeof command.parent?.opts === 'function' ? command.parent.opts() : {}),
+            ...command.opts(),
+            ...options,
+        };
+    }
+    return options;
+}
+//# sourceMappingURL=recordCommands.js.map

package/dist/cli/register/recordCommands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recordCommands.js","sourceRoot":"","sources":["../../../src/cli/register/recordCommands.ts"],"names":[],"mappings":"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"}

package/dist/cli/register/scrollToCommand.d.ts

@@ -0,0 +1,3 @@
+import type { ArgusCommandDefinition } from '../defineCommand.js';
+export declare const scrollToCommand: ArgusCommandDefinition;
+//# sourceMappingURL=scrollToCommand.d.ts.map

package/dist/cli/register/scrollToCommand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scrollToCommand.d.ts","sourceRoot":"","sources":["../../../src/cli/register/scrollToCommand.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAA;AAIjE,eAAO,MAAM,eAAe,EAAE,sBAyB7B,CAAA"}

package/dist/cli/register/scrollToCommand.js

@@ -0,0 +1,30 @@
+import { runDomScrollTo } from '../../commands/domScrollTo.js';
+import { resolveTestId } from '../../commands/resolveTestId.js';
+export const scrollToCommand = {
+    name: 'scroll-to',
+    description: 'Scroll the viewport or elements into view / to a position',
+    arguments: [{ flags: '[id]', description: 'Watcher id to query' }],
+    options: [
+        { flags: '--selector <css>', description: 'CSS selector to match element(s)' },
+        { flags: '--testid <id>', description: 'Shorthand for --selector "[data-testid=\'<id>\']"' },
+        { flags: '--to <x,y>', description: 'Scroll to absolute position (viewport or element)' },
+        { flags: '--by <x,y>', description: 'Scroll by delta (viewport or element)' },
+        { flags: '--all', description: 'Allow multiple matches (default: error if >1 match)' },
+        { flags: '--text <string>', description: 'Filter by textContent (trimmed). Supports /regex/flags syntax' },
+        { flags: '--json', description: 'Output JSON for automation' },
+    ],
+    examples: [
+        'argus scroll-to app --selector "#footer"',
+        'argus scroll-to app --testid "footer"',
+        'argus scroll-to app --to 0,1000',
+        'argus scroll-to app --by 0,500',
+        'argus scroll-to app --selector ".panel" --to 0,1000',
+        'argus scroll-to app --selector ".panel" --by 0,500',
+    ],
+    action: async (id, options) => {
+        if (!resolveTestId(options))
+            return;
+        await runDomScrollTo(id, options);
+    },
+};
+//# sourceMappingURL=scrollToCommand.js.map

package/dist/cli/register/scrollToCommand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scrollToCommand.js","sourceRoot":"","sources":["../../../src/cli/register/scrollToCommand.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAA;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAA;AAE/D,MAAM,CAAC,MAAM,eAAe,GAA2B;IACtD,IAAI,EAAE,WAAW;IACjB,WAAW,EAAE,2DAA2D;IACxE,SAAS,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,qBAAqB,EAAE,CAAC;IAClE,OAAO,EAAE;QACR,EAAE,KAAK,EAAE,kBAAkB,EAAE,WAAW,EAAE,kCAAkC,EAAE;QAC9E,EAAE,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,mDAAmD,EAAE;QAC5F,EAAE,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,mDAAmD,EAAE;QACzF,EAAE,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,uCAAuC,EAAE;QAC7E,EAAE,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,qDAAqD,EAAE;QACtF,EAAE,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,+DAA+D,EAAE;QAC1G,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,4BAA4B,EAAE;KAC9D;IACD,QAAQ,EAAE;QACT,0CAA0C;QAC1C,uCAAuC;QACvC,iCAAiC;QACjC,gCAAgC;QAChC,qDAAqD;QACrD,oDAAoD;KACpD;IACD,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE;QAC7B,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC;YAAE,OAAM;QACnC,MAAM,cAAc,CAAC,EAAE,EAAE,OAAO,CAAC,CAAA;IAClC,CAAC;CACD,CAAA"}

package/dist/cli/register/skillCommands.d.ts

@@ -0,0 +1,3 @@
+import type { ArgusCommandDefinition } from '../defineCommand.js';
+export declare const skillCommands: readonly ArgusCommandDefinition[];
+//# sourceMappingURL=skillCommands.d.ts.map

package/dist/cli/register/skillCommands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skillCommands.d.ts","sourceRoot":"","sources":["../../../src/cli/register/skillCommands.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAA;AAGjE,eAAO,MAAM,aAAa,EAAE,SAAS,sBAAsB,EAU1D,CAAA"}

package/dist/cli/register/skillCommands.js

@@ -0,0 +1,13 @@
+import { runSkill } from '../../commands/skill.js';
+export const skillCommands = [
+    {
+        name: 'skill',
+        description: 'Print the absolute path to the packaged Argus skill file',
+        options: [{ flags: '--json', description: 'Output JSON for automation' }],
+        examples: ['argus skill', 'argus skill --json'],
+        action: (options) => {
+            runSkill(options);
+        },
+    },
+];
+//# sourceMappingURL=skillCommands.js.map

package/dist/cli/register/skillCommands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skillCommands.js","sourceRoot":"","sources":["../../../src/cli/register/skillCommands.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AAElD,MAAM,CAAC,MAAM,aAAa,GAAsC;IAC/D;QACC,IAAI,EAAE,OAAO;QACb,WAAW,EAAE,0DAA0D;QACvE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,4BAA4B,EAAE,CAAC;QACzE,QAAQ,EAAE,CAAC,aAAa,EAAE,oBAAoB,CAAC;QAC/C,MAAM,EAAE,CAAC,OAAO,EAAE,EAAE;YACnB,QAAQ,CAAC,OAAO,CAAC,CAAA;QAClB,CAAC;KACD;CACD,CAAA"}

package/dist/cli/register/snapshotCommands.d.ts

@@ -0,0 +1,3 @@
+import type { ArgusCommandDefinition } from '../defineCommand.js';
+export declare const snapshotCommands: readonly ArgusCommandDefinition[];
+//# sourceMappingURL=snapshotCommands.d.ts.map

package/dist/cli/register/snapshotCommands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshotCommands.d.ts","sourceRoot":"","sources":["../../../src/cli/register/snapshotCommands.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAA;AAKjE,eAAO,MAAM,gBAAgB,EAAE,SAAS,sBAAsB,EAkD7D,CAAA"}