@vforsh/argus 0.1.2 → 0.1.3

package/dist/commands/watcherNativeHost.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watcherNativeHost.d.ts","sourceRoot":"","sources":["../../src/commands/watcherNativeHost.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,MAAM,MAAM,iBAAiB,GAAG;IAC/B,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,IAAI,CAAC,EAAE,OAAO,CAAA;CACd,CAAA;AAED,eAAO,MAAM,oBAAoB,GAAU,SAAS,iBAAiB,KAAG,OAAO,CAAC,IAAI,CAuCnF,CAAA"}

package/dist/commands/watcherNativeHost.js

@@ -0,0 +1,45 @@
+/**
+ * Native Messaging host command for Chrome extension.
+ *
+ * This command is invoked by Chrome when the extension connects via
+ * chrome.runtime.connectNative(). It communicates over stdin/stdout
+ * using Chrome's Native Messaging protocol (length-prefixed JSON).
+ */
+import { startWatcher } from '@vforsh/argus-watcher';
+export const runWatcherNativeHost = async (options) => {
+    const watcherId = options.id?.trim() || 'extension';
+    let handle;
+    try {
+        handle = await startWatcher({
+            id: watcherId,
+            source: 'extension',
+            host: '127.0.0.1',
+            port: 0,
+            pageIndicator: { enabled: false },
+        });
+    }
+    catch (error) {
+        // Write error to stderr (Native Messaging reads stdout only)
+        console.error(`Failed to start watcher: ${error instanceof Error ? error.message : error}`);
+        process.exit(1);
+    }
+    // Log to stderr for debugging (stdout is reserved for Native Messaging)
+    console.error(`[NativeHost] Watcher started: id=${handle.watcher.id} port=${handle.watcher.port}`);
+    const cleanup = async () => {
+        try {
+            await handle.close();
+        }
+        catch {
+            // Ignore
+        }
+    };
+    process.on('SIGINT', () => {
+        void cleanup().then(() => process.exit(0));
+    });
+    process.on('SIGTERM', () => {
+        void cleanup().then(() => process.exit(0));
+    });
+    // Keep process running - Native Messaging will handle stdin/stdout
+    await new Promise(() => { });
+};
+//# sourceMappingURL=watcherNativeHost.js.map

package/dist/commands/watcherNativeHost.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watcherNativeHost.js","sourceRoot":"","sources":["../../src/commands/watcherNativeHost.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,YAAY,EAAsB,MAAM,uBAAuB,CAAA;AAOxE,MAAM,CAAC,MAAM,oBAAoB,GAAG,KAAK,EAAE,OAA0B,EAAiB,EAAE;IACvF,MAAM,SAAS,GAAG,OAAO,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,WAAW,CAAA;IAEnD,IAAI,MAAqB,CAAA;IACzB,IAAI,CAAC;QACJ,MAAM,GAAG,MAAM,YAAY,CAAC;YAC3B,EAAE,EAAE,SAAS;YACb,MAAM,EAAE,WAAW;YACnB,IAAI,EAAE,WAAW;YACjB,IAAI,EAAE,CAAC;YACP,aAAa,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE;SACjC,CAAC,CAAA;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,6DAA6D;QAC7D,OAAO,CAAC,KAAK,CAAC,4BAA4B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAA;QAC3F,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IAChB,CAAC;IAED,wEAAwE;IACxE,OAAO,CAAC,KAAK,CAAC,oCAAoC,MAAM,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAA;IAElG,MAAM,OAAO,GAAG,KAAK,IAAmB,EAAE;QACzC,IAAI,CAAC;YACJ,MAAM,MAAM,CAAC,KAAK,EAAE,CAAA;QACrB,CAAC;QAAC,MAAM,CAAC;YACR,SAAS;QACV,CAAC;IACF,CAAC,CAAA;IAED,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;QACzB,KAAK,OAAO,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAA;IAC3C,CAAC,CAAC,CAAA;IAEF,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE;QAC1B,KAAK,OAAO,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAA;IAC3C,CAAC,CAAC,CAAA;IAEF,mEAAmE;IACnE,MAAM,IAAI,OAAO,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;AAC5B,CAAC,CAAA"}

package/dist/commands/watcherPrune.d.ts

@@ -0,0 +1,9 @@
+/** Options for the watcher prune command. */
+export type WatcherPruneOptions = {
+    byCwd?: string;
+    dryRun?: boolean;
+    json?: boolean;
+};
+/** Execute the watcher prune command. */
+export declare const runWatcherPrune: (options: WatcherPruneOptions) => Promise<void>;
+//# sourceMappingURL=watcherPrune.d.ts.map

package/dist/commands/watcherPrune.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watcherPrune.d.ts","sourceRoot":"","sources":["../../src/commands/watcherPrune.ts"],"names":[],"mappings":"AAKA,6CAA6C;AAC7C,MAAM,MAAM,mBAAmB,GAAG;IACjC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,IAAI,CAAC,EAAE,OAAO,CAAA;CACd,CAAA;AASD,yCAAyC;AACzC,eAAO,MAAM,eAAe,GAAU,SAAS,mBAAmB,KAAG,OAAO,CAAC,IAAI,CAwEhF,CAAA"}

package/dist/commands/watcherPrune.js

@@ -0,0 +1,83 @@
+import { loadRegistry, pruneRegistry, removeWatchersAndPersist } from '../registry.js';
+import { fetchJson } from '../httpClient.js';
+import { createOutput } from '../output/io.js';
+/** Execute the watcher prune command. */
+export const runWatcherPrune = async (options) => {
+    const output = createOutput(options);
+    // Validate --by-cwd is not empty/whitespace
+    if (options.byCwd !== undefined && options.byCwd.trim().length === 0) {
+        output.writeWarn('Invalid --by-cwd value: empty or whitespace.');
+        process.exitCode = 2;
+        return;
+    }
+    let registry = await loadRegistry();
+    registry = await pruneRegistry(registry);
+    let watchers = Object.values(registry.watchers);
+    // Filter by cwd if specified
+    if (options.byCwd) {
+        const substring = options.byCwd.trim();
+        watchers = watchers.filter((watcher) => watcher.cwd && watcher.cwd.includes(substring));
+    }
+    // Guard: no watchers after filtering
+    if (watchers.length === 0) {
+        if (options.json) {
+            output.writeJson({ keptIds: [], removedIds: [], dryRun: options.dryRun === true });
+        }
+        else {
+            output.writeHuman('No watchers to check.');
+        }
+        return;
+    }
+    const keptIds = [];
+    const removedIds = [];
+    // Check each watcher for reachability
+    for (const watcher of watchers) {
+        const reachable = await checkWatcherReachable(watcher);
+        if (reachable) {
+            keptIds.push(watcher.id);
+        }
+        else {
+            removedIds.push(watcher.id);
+            output.writeWarn(`${watcher.id}: unreachable`);
+        }
+    }
+    // Guard: nothing to remove
+    if (removedIds.length === 0) {
+        if (options.json) {
+            output.writeJson({ keptIds, removedIds, dryRun: options.dryRun === true });
+        }
+        else {
+            output.writeHuman('All watchers are reachable. Nothing to prune.');
+        }
+        return;
+    }
+    // Persist changes unless dry-run
+    if (options.dryRun) {
+        if (options.json) {
+            output.writeJson({ keptIds, removedIds, dryRun: true });
+        }
+        else {
+            output.writeHuman(`Would remove ${removedIds.length} watcher(s): ${removedIds.join(', ')}`);
+        }
+        return;
+    }
+    await removeWatchersAndPersist(registry, removedIds);
+    if (options.json) {
+        output.writeJson({ keptIds, removedIds, dryRun: false });
+    }
+    else {
+        output.writeHuman(`Removed ${removedIds.length} watcher(s): ${removedIds.join(', ')}`);
+    }
+};
+/** Check if a watcher is reachable via /status endpoint. */
+const checkWatcherReachable = async (watcher) => {
+    const url = `http://${watcher.host}:${watcher.port}/status`;
+    try {
+        await fetchJson(url, { timeoutMs: 2_000 });
+        return true;
+    }
+    catch {
+        return false;
+    }
+};
+//# sourceMappingURL=watcherPrune.js.map

package/dist/commands/watcherPrune.js.map

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

package/dist/commands/watcherStart.d.ts

@@ -0,0 +1,23 @@
+import { type PageConsoleLogging, type WatcherSourceMode } from '@vforsh/argus-watcher';
+export type WatcherStartOptions = {
+    id?: string;
+    /** Source mode for CDP connection: 'cdp' (default) or 'extension'. */
+    source?: WatcherSourceMode;
+    url?: string;
+    json?: boolean;
+    chromeHost?: string;
+    chromePort?: string | number;
+    pageIndicator?: boolean;
+    artifacts?: string;
+    pageConsoleLogging?: PageConsoleLogging;
+    /** Filter by target type (e.g., 'page', 'iframe'). */
+    type?: string;
+    /** Match against URL origin only (protocol + host + port). */
+    origin?: string;
+    /** Connect to a specific target by its Chrome target ID. */
+    target?: string;
+    /** Filter by parent target URL pattern. */
+    parent?: string;
+};
+export declare const runWatcherStart: (options: WatcherStartOptions) => Promise<void>;
+//# sourceMappingURL=watcherStart.d.ts.map

package/dist/commands/watcherStart.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watcherStart.d.ts","sourceRoot":"","sources":["../../src/commands/watcherStart.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoC,KAAK,kBAAkB,EAAE,KAAK,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AAIzH,MAAM,MAAM,mBAAmB,GAAG;IACjC,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,sEAAsE;IACtE,MAAM,CAAC,EAAE,iBAAiB,CAAA;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IAC5B,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,kBAAkB,CAAC,EAAE,kBAAkB,CAAA;IACvC,sDAAsD;IACtD,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,8DAA8D;IAC9D,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,4DAA4D;IAC5D,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,2CAA2C;IAC3C,MAAM,CAAC,EAAE,MAAM,CAAA;CACf,CAAA;AAyBD,eAAO,MAAM,eAAe,GAAU,SAAS,mBAAmB,KAAG,OAAO,CAAC,IAAI,CA0LhF,CAAA"}

package/dist/commands/watcherStart.js

@@ -0,0 +1,182 @@
+import { startWatcher } from '@vforsh/argus-watcher';
+import path from 'node:path';
+import { createOutput } from '../output/io.js';
+const isValidPort = (port) => Number.isFinite(port) && port >= 1 && port <= 65535;
+const parsePort = (value) => {
+    const port = typeof value === 'string' ? parseInt(value, 10) : value;
+    return isValidPort(port) ? port : null;
+};
+export const runWatcherStart = async (options) => {
+    const output = createOutput(options);
+    if (!options.id || options.id.trim() === '') {
+        output.writeWarn('--id is required.');
+        process.exitCode = 2;
+        return;
+    }
+    // Validate source option
+    const sourceMode = options.source ?? 'cdp';
+    if (sourceMode !== 'cdp' && sourceMode !== 'extension') {
+        output.writeWarn(`Invalid --source: ${options.source}. Must be 'cdp' or 'extension'.`);
+        process.exitCode = 2;
+        return;
+    }
+    // For extension mode, validate that CDP targeting options are not used
+    // (chrome-host/chrome-port are ignored but allowed for config file compatibility)
+    if (sourceMode === 'extension') {
+        const cdpTargetingOptions = [];
+        if (options.url?.trim())
+            cdpTargetingOptions.push('--url');
+        if (options.target?.trim())
+            cdpTargetingOptions.push('--target');
+        if (options.origin?.trim())
+            cdpTargetingOptions.push('--origin');
+        if (options.type?.trim())
+            cdpTargetingOptions.push('--type');
+        if (options.parent?.trim())
+            cdpTargetingOptions.push('--parent');
+        if (cdpTargetingOptions.length > 0) {
+            output.writeWarn(`CDP targeting options cannot be used with --source extension: ${cdpTargetingOptions.join(', ')}`);
+            process.exitCode = 2;
+            return;
+        }
+    }
+    // For CDP mode, at least one targeting option is required
+    if (sourceMode === 'cdp') {
+        const hasTargeting = options.url?.trim() || options.target?.trim() || options.origin?.trim() || options.type?.trim();
+        if (!hasTargeting) {
+            output.writeWarn('At least one targeting option is required for CDP mode: --url, --target, --origin, or --type.');
+            process.exitCode = 2;
+            return;
+        }
+    }
+    let chromeHost;
+    let chromePort;
+    if (sourceMode === 'cdp') {
+        chromeHost = options.chromeHost?.trim() || '127.0.0.1';
+        chromePort = 9222;
+        if (options.chromePort != null) {
+            const parsed = parsePort(options.chromePort);
+            if (parsed === null) {
+                output.writeWarn(`Invalid --chrome-port: ${options.chromePort}. Must be an integer 1-65535.`);
+                process.exitCode = 2;
+                return;
+            }
+            chromePort = parsed;
+        }
+    }
+    const watcherId = options.id.trim();
+    const matchUrl = options.url?.trim();
+    let artifactsBaseDir;
+    if (options.artifacts != null) {
+        const trimmed = options.artifacts.trim();
+        if (trimmed === '') {
+            output.writeWarn('--artifacts must be a non-empty path when provided.');
+            process.exitCode = 2;
+            return;
+        }
+        artifactsBaseDir = path.resolve(process.cwd(), trimmed);
+    }
+    // Build the match object from various filter options
+    const match = {};
+    if (matchUrl) {
+        match.url = matchUrl;
+    }
+    if (options.type?.trim()) {
+        match.type = options.type.trim();
+    }
+    if (options.origin?.trim()) {
+        match.origin = options.origin.trim();
+    }
+    if (options.target?.trim()) {
+        match.targetId = options.target.trim();
+    }
+    if (options.parent?.trim()) {
+        match.parent = options.parent.trim();
+    }
+    let handle;
+    try {
+        handle = await startWatcher({
+            id: watcherId,
+            source: sourceMode,
+            match: sourceMode === 'cdp' && Object.keys(match).length > 0 ? match : undefined,
+            chrome: sourceMode === 'cdp' ? { host: chromeHost, port: chromePort } : undefined,
+            host: '127.0.0.1',
+            port: 0,
+            pageIndicator: sourceMode === 'cdp' ? (options.pageIndicator === false ? { enabled: false } : { enabled: true }) : { enabled: false },
+            artifacts: artifactsBaseDir ? { base: artifactsBaseDir } : undefined,
+            pageConsoleLogging: options.pageConsoleLogging,
+        });
+    }
+    catch (error) {
+        output.writeWarn(`Failed to start watcher: ${error instanceof Error ? error.message : error}`);
+        process.exitCode = 1;
+        return;
+    }
+    const result = {
+        id: handle.watcher.id,
+        host: handle.watcher.host,
+        port: handle.watcher.port,
+        pid: handle.watcher.pid,
+        source: sourceMode,
+        matchUrl: match.url,
+        matchType: match.type,
+        matchOrigin: match.origin,
+        matchTarget: match.targetId,
+        matchParent: match.parent,
+        chromeHost,
+        chromePort,
+        artifactsBaseDir,
+    };
+    const cleanup = async () => {
+        try {
+            await handle.close();
+        }
+        catch { }
+    };
+    process.on('SIGINT', () => {
+        void cleanup().then(() => process.exit(0));
+    });
+    process.on('SIGTERM', () => {
+        void cleanup().then(() => process.exit(0));
+    });
+    handle.events.on('cdpAttached', ({ target }) => {
+        const typeInfo = target?.type ? ` (type: ${target.type})` : '';
+        output.writeHuman(`[${handle.watcher.id}] CDP attached: ${target?.title} (${target?.url})${typeInfo}`);
+    });
+    handle.events.on('cdpDetached', ({ reason, target }) => {
+        output.writeHuman(`[${handle.watcher.id}] CDP detached: ${reason} (last target: ${target?.title})`);
+    });
+    if (options.json) {
+        output.writeJson(result);
+    }
+    else {
+        output.writeHuman(`Watcher started:`);
+        output.writeHuman(`  id=${result.id}`);
+        output.writeHuman(`  source=${result.source}`);
+        output.writeHuman(`  host=${result.host}`);
+        output.writeHuman(`  port=${result.port}`);
+        if (result.matchUrl) {
+            output.writeHuman(`  matchUrl=${result.matchUrl}`);
+        }
+        if (result.matchType) {
+            output.writeHuman(`  matchType=${result.matchType}`);
+        }
+        if (result.matchOrigin) {
+            output.writeHuman(`  matchOrigin=${result.matchOrigin}`);
+        }
+        if (result.matchTarget) {
+            output.writeHuman(`  matchTarget=${result.matchTarget}`);
+        }
+        if (result.matchParent) {
+            output.writeHuman(`  matchParent=${result.matchParent}`);
+        }
+        if (result.chromeHost && result.chromePort) {
+            output.writeHuman(`  chrome=${result.chromeHost}:${result.chromePort}`);
+        }
+        if (result.artifactsBaseDir) {
+            output.writeHuman(`  artifacts=${result.artifactsBaseDir}`);
+        }
+    }
+    await new Promise(() => { });
+};
+//# sourceMappingURL=watcherStart.js.map

package/dist/commands/watcherStart.js.map

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

package/dist/commands/watcherStatus.d.ts

@@ -0,0 +1,7 @@
+/** Options for the watcher status command. */
+export type WatcherStatusOptions = {
+    json?: boolean;
+};
+/** Execute the watcher status command. */
+export declare const runWatcherStatus: (id: string | undefined, options: WatcherStatusOptions) => Promise<void>;
+//# sourceMappingURL=watcherStatus.d.ts.map

package/dist/commands/watcherStatus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watcherStatus.d.ts","sourceRoot":"","sources":["../../src/commands/watcherStatus.ts"],"names":[],"mappings":"AAMA,8CAA8C;AAC9C,MAAM,MAAM,oBAAoB,GAAG;IAClC,IAAI,CAAC,EAAE,OAAO,CAAA;CACd,CAAA;AAED,0CAA0C;AAC1C,eAAO,MAAM,gBAAgB,GAAU,IAAI,MAAM,GAAG,SAAS,EAAE,SAAS,oBAAoB,KAAG,OAAO,CAAC,IAAI,CA+B1G,CAAA"}

package/dist/commands/watcherStatus.js

@@ -0,0 +1,44 @@
+import { fetchJson } from '../httpClient.js';
+import { createOutput } from '../output/io.js';
+import { writeWatcherCandidates } from '../watchers/candidates.js';
+import { resolveWatcher } from '../watchers/resolveWatcher.js';
+/** Execute the watcher status command. */
+export const runWatcherStatus = async (id, options) => {
+    const output = createOutput(options);
+    const resolved = await resolveWatcher({ id });
+    if (!resolved.ok) {
+        output.writeWarn(resolved.error);
+        if (resolved.candidates && resolved.candidates.length > 0) {
+            writeWatcherCandidates(resolved.candidates, output);
+            output.writeWarn('Hint: run `argus list` to see all watchers.');
+        }
+        process.exitCode = resolved.exitCode;
+        return;
+    }
+    const { watcher } = resolved;
+    const url = `http://${watcher.host}:${watcher.port}/status`;
+    let status;
+    try {
+        status = await fetchJson(url, { timeoutMs: 2_000 });
+    }
+    catch (error) {
+        output.writeWarn(`unreachable ${watcher.id} ${watcher.host}:${watcher.port} (${formatError(error)})`);
+        process.exitCode = 1;
+        return;
+    }
+    if (options.json) {
+        output.writeJson(status);
+        return;
+    }
+    output.writeHuman(`ok ${watcher.id} ${watcher.host}:${watcher.port} pid=${status.pid} attached=${status.attached}`);
+};
+const formatError = (error) => {
+    if (!error) {
+        return 'unknown error';
+    }
+    if (error instanceof Error) {
+        return error.message;
+    }
+    return String(error);
+};
+//# sourceMappingURL=watcherStatus.js.map

package/dist/commands/watcherStatus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watcherStatus.js","sourceRoot":"","sources":["../../src/commands/watcherStatus.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAC9C,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAA;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAA;AAO9D,0CAA0C;AAC1C,MAAM,CAAC,MAAM,gBAAgB,GAAG,KAAK,EAAE,EAAsB,EAAE,OAA6B,EAAiB,EAAE;IAC9G,MAAM,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC,CAAA;IACpC,MAAM,QAAQ,GAAG,MAAM,cAAc,CAAC,EAAE,EAAE,EAAE,CAAC,CAAA;IAC7C,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QAClB,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;QAChC,IAAI,QAAQ,CAAC,UAAU,IAAI,QAAQ,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC3D,sBAAsB,CAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,CAAA;YACnD,MAAM,CAAC,SAAS,CAAC,6CAA6C,CAAC,CAAA;QAChE,CAAC;QACD,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAA;QACpC,OAAM;IACP,CAAC;IAED,MAAM,EAAE,OAAO,EAAE,GAAG,QAAQ,CAAA;IAE5B,MAAM,GAAG,GAAG,UAAU,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,SAAS,CAAA;IAC3D,IAAI,MAAsB,CAAA;IAC1B,IAAI,CAAC;QACJ,MAAM,GAAG,MAAM,SAAS,CAAiB,GAAG,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAA;IACpE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,MAAM,CAAC,SAAS,CAAC,eAAe,OAAO,CAAC,EAAE,IAAI,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,KAAK,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;QACrG,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAA;QACpB,OAAM;IACP,CAAC;IAED,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QAClB,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAA;QACxB,OAAM;IACP,CAAC;IAED,MAAM,CAAC,UAAU,CAAC,MAAM,OAAO,CAAC,EAAE,IAAI,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,QAAQ,MAAM,CAAC,GAAG,aAAa,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAA;AACpH,CAAC,CAAA;AAED,MAAM,WAAW,GAAG,CAAC,KAAc,EAAU,EAAE;IAC9C,IAAI,CAAC,KAAK,EAAE,CAAC;QACZ,OAAO,eAAe,CAAA;IACvB,CAAC;IACD,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC5B,OAAO,KAAK,CAAC,OAAO,CAAA;IACrB,CAAC;IACD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAA;AACrB,CAAC,CAAA"}

package/dist/commands/watcherStop.d.ts

@@ -0,0 +1,5 @@
+/** Options for the watcher stop command. */
+export type WatcherStopOptions = Record<string, never>;
+/** Execute the watcher stop command. */
+export declare const runWatcherStop: (id: string | undefined, _options: WatcherStopOptions) => Promise<void>;
+//# sourceMappingURL=watcherStop.d.ts.map

package/dist/commands/watcherStop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watcherStop.d.ts","sourceRoot":"","sources":["../../src/commands/watcherStop.ts"],"names":[],"mappings":"AAOA,4CAA4C;AAC5C,MAAM,MAAM,kBAAkB,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;AAEtD,wCAAwC;AACxC,eAAO,MAAM,cAAc,GAAU,IAAI,MAAM,GAAG,SAAS,EAAE,UAAU,kBAAkB,KAAG,OAAO,CAAC,IAAI,CAyDvG,CAAA"}

package/dist/commands/watcherStop.js

@@ -0,0 +1,103 @@
+import { removeWatcherAndPersist } from '../registry.js';
+import { fetchJson } from '../httpClient.js';
+import { createOutput } from '../output/io.js';
+import { writeWatcherCandidates } from '../watchers/candidates.js';
+import { resolveWatcher } from '../watchers/resolveWatcher.js';
+/** Execute the watcher stop command. */
+export const runWatcherStop = async (id, _options) => {
+    const output = createOutput({ json: false });
+    const resolved = await resolveWatcher({ id });
+    if (!resolved.ok) {
+        output.writeWarn(resolved.error);
+        if (resolved.candidates && resolved.candidates.length > 0) {
+            writeWatcherCandidates(resolved.candidates, output);
+            output.writeWarn('Hint: run `argus list` to see all watchers.');
+        }
+        process.exitCode = resolved.exitCode;
+        return;
+    }
+    const { watcher } = resolved;
+    let registry = resolved.registry;
+    const shutdownUrl = `http://${watcher.host}:${watcher.port}/shutdown`;
+    try {
+        const response = await fetchJson(shutdownUrl, { method: 'POST', timeoutMs: 2_000 });
+        if (response.ok) {
+            output.writeHuman(`stopped ${watcher.id}`);
+            return;
+        }
+    }
+    catch (error) {
+        output.writeWarn(`warn: shutdown endpoint failed; falling back to SIGTERM (${formatError(error)})`);
+    }
+    if (watcher.pid == null) {
+        output.writeWarn(`warn: missing pid for watcher ${watcher.id}; registry entry preserved`);
+        process.exitCode = 1;
+        return;
+    }
+    const pid = watcher.pid;
+    try {
+        process.kill(pid, 'SIGTERM');
+    }
+    catch (error) {
+        if (isNoSuchProcessError(error)) {
+            registry = await removeWatcherAndPersist(registry, watcher.id);
+            output.writeHuman(`stopped ${watcher.id}`);
+            return;
+        }
+        output.writeWarn(`warn: failed to stop watcher ${watcher.id}; registry entry preserved (${formatError(error)})`);
+        process.exitCode = 1;
+        return;
+    }
+    const waitResult = await waitForProcessExit(pid, 2_000, 100);
+    if (waitResult.state === 'dead') {
+        registry = await removeWatcherAndPersist(registry, watcher.id);
+        output.writeHuman(`stopped ${watcher.id}`);
+        return;
+    }
+    const reason = waitResult.error ? ` (${waitResult.error})` : '';
+    output.writeWarn(`warn: failed to stop watcher ${watcher.id}; registry entry preserved${reason}`);
+    process.exitCode = 1;
+};
+const waitForProcessExit = async (pid, timeoutMs, intervalMs) => {
+    const deadline = Date.now() + timeoutMs;
+    while (Date.now() <= deadline) {
+        const check = checkProcessState(pid);
+        if (check.state === 'dead') {
+            return { state: 'dead' };
+        }
+        if (check.state === 'error') {
+            return { state: 'error', error: check.error };
+        }
+        await sleep(intervalMs);
+    }
+    return { state: 'timeout' };
+};
+const checkProcessState = (pid) => {
+    try {
+        process.kill(pid, 0);
+        return { state: 'alive' };
+    }
+    catch (error) {
+        if (isNoSuchProcessError(error)) {
+            return { state: 'dead' };
+        }
+        return { state: 'error', error: formatError(error) };
+    }
+};
+const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+const isNoSuchProcessError = (error) => {
+    return isErrnoError(error) && error.code === 'ESRCH';
+};
+const isErrnoError = (error) => {
+    return !!error && typeof error === 'object' && 'code' in error;
+};
+const formatError = (error) => {
+    if (!error) {
+        return 'unknown error';
+    }
+    if (error instanceof Error) {
+        return error.message;
+    }
+    return String(error);
+};
+//# sourceMappingURL=watcherStop.js.map

package/dist/commands/watcherStop.js.map

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

package/dist/config/argusConfig.d.ts

@@ -0,0 +1,67 @@
+import type { PluginConfig } from '@vforsh/argus-core';
+export type ChromeStartConfig = {
+    url?: string;
+    watcherId?: string;
+    profile?: 'temp' | 'default-full' | 'default-medium' | 'default-lite';
+    devTools?: boolean;
+};
+export type PageConsoleLogging = 'none' | 'minimal' | 'full';
+export type WatcherStartConfig = {
+    id?: string;
+    url?: string;
+    chromeHost?: string;
+    chromePort?: number;
+    artifacts?: string;
+    pageIndicator?: boolean;
+    pageConsoleLogging?: PageConsoleLogging;
+};
+export type ArgusConfig = {
+    chrome?: {
+        start?: ChromeStartConfig;
+    };
+    watcher?: {
+        start?: WatcherStartConfig;
+    };
+    /**
+     * Plugin modules to load.
+     * Each entry can be:
+     * - npm package name: "gameX-argus-plugin"
+     * - relative path: "./plugins/gameX.js"
+     * - absolute path: "/path/to/plugin.js"
+     * - object with metadata: { name: "gameX", module: "./plugins/gameX.js" }
+     */
+    plugins?: PluginConfig[];
+};
+export type ArgusConfigLoadResult = {
+    config: ArgusConfig;
+    configDir: string;
+};
+type OptionSourceProvider = {
+    getOptionValueSource: (key: string) => string;
+};
+export declare const resolveArgusConfigPath: ({ cliPath, cwd }: {
+    cliPath?: string;
+    cwd: string;
+}) => string | null;
+export declare const loadArgusConfig: (resolvedPath: string) => ArgusConfigLoadResult | null;
+export declare const getConfigStartDefaults: (config: ArgusConfig) => {
+    chromeStart?: ChromeStartConfig;
+    watcherStart?: WatcherStartConfig;
+};
+export declare const mergeChromeStartOptionsWithConfig: <T extends {
+    url?: string;
+    fromWatcher?: string;
+    profile?: ChromeStartConfig["profile"];
+    devTools?: boolean;
+}>(options: T, command: OptionSourceProvider, configResult: ArgusConfigLoadResult | null) => T | null;
+export declare const mergeWatcherStartOptionsWithConfig: <T extends {
+    id?: string;
+    url?: string;
+    chromeHost?: string;
+    chromePort?: string | number;
+    pageIndicator?: boolean;
+    artifacts?: string;
+    pageConsoleLogging?: PageConsoleLogging;
+}>(options: T, command: OptionSourceProvider, configResult: ArgusConfigLoadResult | null) => T | null;
+export {};
+//# sourceMappingURL=argusConfig.d.ts.map

package/dist/config/argusConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"argusConfig.d.ts","sourceRoot":"","sources":["../../src/config/argusConfig.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEtD,MAAM,MAAM,iBAAiB,GAAG;IAC/B,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,GAAG,cAAc,GAAG,gBAAgB,GAAG,cAAc,CAAA;IACrE,QAAQ,CAAC,EAAE,OAAO,CAAA;CAClB,CAAA;AAED,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,CAAA;AAE5D,MAAM,MAAM,kBAAkB,GAAG;IAChC,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,kBAAkB,CAAC,EAAE,kBAAkB,CAAA;CACvC,CAAA;AAED,MAAM,MAAM,WAAW,GAAG;IACzB,MAAM,CAAC,EAAE;QACR,KAAK,CAAC,EAAE,iBAAiB,CAAA;KACzB,CAAA;IACD,OAAO,CAAC,EAAE;QACT,KAAK,CAAC,EAAE,kBAAkB,CAAA;KAC1B,CAAA;IACD;;;;;;;OAOG;IACH,OAAO,CAAC,EAAE,YAAY,EAAE,CAAA;CACxB,CAAA;AAED,MAAM,MAAM,qBAAqB,GAAG;IACnC,MAAM,EAAE,WAAW,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;CACjB,CAAA;AAED,KAAK,oBAAoB,GAAG;IAC3B,oBAAoB,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAA;CAC7C,CAAA;AA6RD,eAAO,MAAM,sBAAsB,GAAI,kBAAkB;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,KAAG,MAAM,GAAG,IAiBrG,CAAA;AAED,eAAO,MAAM,eAAe,GAAI,cAAc,MAAM,KAAG,qBAAqB,GAAG,IAqB9E,CAAA;AAED,eAAO,MAAM,sBAAsB,GAAI,QAAQ,WAAW,KAAG;IAAE,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAAC,YAAY,CAAC,EAAE,kBAAkB,CAAA;CAG/H,CAAA;AAcF,eAAO,MAAM,iCAAiC,GAC7C,CAAC,SAAS;IACT,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,EAAE,iBAAiB,CAAC,SAAS,CAAC,CAAA;IACtC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAClB,EAED,SAAS,CAAC,EACV,SAAS,oBAAoB,EAC7B,cAAc,qBAAqB,GAAG,IAAI,KACxC,CAAC,GAAG,IAuBN,CAAA;AAED,eAAO,MAAM,kCAAkC,GAC9C,CAAC,SAAS;IACT,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IAC5B,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,kBAAkB,CAAC,EAAE,kBAAkB,CAAA;CACvC,EAED,SAAS,CAAC,EACV,SAAS,oBAAoB,EAC7B,cAAc,qBAAqB,GAAG,IAAI,KACxC,CAAC,GAAG,IAsBN,CAAA"}