@reticlehq/server 2.0.0

package/dist/cli-parse.js

@@ -0,0 +1,321 @@
+/**
+ * Pure CLI argument parsing — the command/flag grammar, the CliResult union, and parseCliArgs.
+ * Split out of cli.ts (which keeps the side-effecting handlers + dispatch) to stay under the
+ * file-size cap and keep the parser pure + unit-testable. Re-exported from cli.ts so existing
+ * imports are unchanged.
+ */
+export const CLI_USAGE = `usage:
+  reticle init  [--yes] [--dry-run] [--port N] [--no-mcp] [--no-install]  (wire Reticle into the project in this directory)
+  reticle serve [--port N] [--drive <url>] [--headed] [--http] [--http-port N] [--http-token T]
+  reticle stop  [--port N] [--quiet]
+  reticle status [--port N]
+  reticle open  [url] [--port N]                        (show the app: reuse the connected tab, else open one)
+  reticle verify <url> [--headed] [--timeout N] [--storage-state <file>]  (one-shot: drive the URL, verify saved flows, exit 0=pass)
+  reticle drive <url> [--headed]                       (foreground mode — for debugging)
+  reticle mcp   [--port N] [--drive <url>] [--headed]  (MCP stdio proxy — auto-starts daemon if needed)
+  reticle license                                      (show enterprise license status: active | eval | missing)`;
+const INIT_COMMAND = 'init';
+const SERVE_COMMAND = 'serve';
+const STOP_COMMAND = 'stop';
+const STATUS_COMMAND = 'status';
+const OPEN_COMMAND = 'open';
+const DRIVE_COMMAND = 'drive';
+const VERIFY_COMMAND = 'verify';
+const MCP_COMMAND = 'mcp';
+const LICENSE_COMMAND = 'license';
+const VERSION_COMMAND = 'version';
+export const DAEMON_INNER_COMMAND = '_daemon';
+export const HEADED_FLAG = '--headed';
+export const PORT_FLAG = '--port';
+export const DRIVE_FLAG = '--drive';
+const QUIET_FLAG = '--quiet';
+const DRY_RUN_FLAG = '--dry-run';
+const YES_FLAG = '--yes';
+const NO_MCP_FLAG = '--no-mcp';
+const NO_INSTALL_FLAG = '--no-install';
+export const HTTP_FLAG = '--http';
+export const HTTP_PORT_FLAG = '--http-port';
+export const HTTP_TOKEN_FLAG = '--http-token';
+const TIMEOUT_FLAG = '--timeout';
+const STORAGE_STATE_FLAG = '--storage-state';
+function parseServeFlags(args, defaultPort) {
+    let port = defaultPort;
+    let driveUrl;
+    let headless = true;
+    let http = false;
+    let httpPort;
+    let httpToken;
+    let i = 0;
+    while (i < args.length) {
+        const arg = args[i];
+        if (arg === PORT_FLAG) {
+            i++;
+            const n = args[i];
+            if (n === undefined)
+                return { kind: 'error', message: CLI_USAGE };
+            const parsed = parseInt(n, 10);
+            if (isNaN(parsed))
+                return { kind: 'error', message: CLI_USAGE };
+            port = parsed;
+        }
+        else if (arg === DRIVE_FLAG) {
+            i++;
+            driveUrl = args[i];
+            if (driveUrl === undefined)
+                return { kind: 'error', message: CLI_USAGE };
+        }
+        else if (arg === HEADED_FLAG) {
+            headless = false;
+        }
+        else if (arg === HTTP_FLAG) {
+            http = true;
+        }
+        else if (arg === HTTP_PORT_FLAG) {
+            i++;
+            const n = args[i];
+            if (n === undefined)
+                return { kind: 'error', message: CLI_USAGE };
+            const parsed = parseInt(n, 10);
+            if (isNaN(parsed))
+                return { kind: 'error', message: CLI_USAGE };
+            httpPort = parsed;
+        }
+        else if (arg === HTTP_TOKEN_FLAG) {
+            i++;
+            httpToken = args[i];
+            if (httpToken === undefined)
+                return { kind: 'error', message: CLI_USAGE };
+        }
+        else {
+            return { kind: 'error', message: CLI_USAGE };
+        }
+        i++;
+    }
+    return {
+        kind: 'ok',
+        port,
+        headless,
+        http,
+        ...(driveUrl !== undefined ? { driveUrl } : {}),
+        ...(httpPort !== undefined ? { httpPort } : {}),
+        ...(httpToken !== undefined ? { httpToken } : {}),
+    };
+}
+function parsePortFlag(args, defaultPort) {
+    const idx = args.indexOf(PORT_FLAG);
+    if (idx === -1)
+        return defaultPort;
+    const n = args[idx + 1];
+    if (n === undefined)
+        return defaultPort;
+    const parsed = parseInt(n, 10);
+    return isNaN(parsed) ? defaultPort : parsed;
+}
+function parseDriveSuffix(args, port) {
+    let headless = true;
+    let driveUrl;
+    for (const arg of args) {
+        if (arg === HEADED_FLAG) {
+            headless = false;
+        }
+        else if (arg.startsWith('--')) {
+            return { kind: 'error', message: CLI_USAGE };
+        }
+        else if (driveUrl === undefined) {
+            driveUrl = arg;
+        }
+        else {
+            return { kind: 'error', message: CLI_USAGE };
+        }
+    }
+    if (driveUrl === undefined)
+        return { kind: 'error', message: CLI_USAGE };
+    return { kind: 'ok', port, driveUrl, headless };
+}
+/**
+ * Parse `verify <url> [--headed] [--timeout N] [--storage-state <file>]`. The first non-flag token is
+ * the preview URL.
+ */
+function parseVerifySuffix(args) {
+    let headless = true;
+    let url;
+    let timeoutMs;
+    let storageState;
+    let i = 0;
+    while (i < args.length) {
+        const arg = args[i];
+        if (arg === undefined)
+            break;
+        if (arg === HEADED_FLAG) {
+            headless = false;
+        }
+        else if (arg === TIMEOUT_FLAG) {
+            i++;
+            const n = args[i];
+            if (n === undefined)
+                return { kind: 'error', message: CLI_USAGE };
+            const parsed = parseInt(n, 10);
+            if (isNaN(parsed))
+                return { kind: 'error', message: CLI_USAGE };
+            timeoutMs = parsed;
+        }
+        else if (arg === STORAGE_STATE_FLAG) {
+            i++;
+            const v = args[i];
+            if (v === undefined)
+                return { kind: 'error', message: CLI_USAGE };
+            storageState = v;
+        }
+        else if (arg.startsWith('--')) {
+            return { kind: 'error', message: CLI_USAGE };
+        }
+        else if (url === undefined) {
+            url = arg;
+        }
+        else {
+            return { kind: 'error', message: CLI_USAGE };
+        }
+        i++;
+    }
+    if (url === undefined)
+        return { kind: 'error', message: CLI_USAGE };
+    return {
+        kind: 'ok',
+        url,
+        headless,
+        ...(timeoutMs !== undefined ? { timeoutMs } : {}),
+        ...(storageState !== undefined ? { storageState } : {}),
+    };
+}
+function parseInitFlags(args) {
+    let port;
+    let mcp = true;
+    let dryRun = false;
+    let install = true;
+    let i = 0;
+    while (i < args.length) {
+        const arg = args[i];
+        if (arg === PORT_FLAG) {
+            i++;
+            const n = args[i];
+            if (n === undefined)
+                return { kind: 'error', message: CLI_USAGE };
+            const parsed = parseInt(n, 10);
+            if (isNaN(parsed))
+                return { kind: 'error', message: CLI_USAGE };
+            port = parsed;
+        }
+        else if (arg === NO_MCP_FLAG) {
+            mcp = false;
+        }
+        else if (arg === NO_INSTALL_FLAG) {
+            install = false;
+        }
+        else if (arg === DRY_RUN_FLAG) {
+            dryRun = true;
+        }
+        else if (arg === YES_FLAG) {
+            // Accepted for scripting/CI; init has no interactive prompts today.
+        }
+        else {
+            return { kind: 'error', message: CLI_USAGE };
+        }
+        i++;
+    }
+    return { kind: 'ok', port, mcp, dryRun, install };
+}
+/** Pure CLI arg parser — exported for unit tests. argv = process.argv.slice(2). */
+export function parseCliArgs(argv, defaultPort) {
+    if (argv.length === 0)
+        return { kind: 'serve', port: defaultPort, headless: true, http: false };
+    const [cmd, ...rest] = argv;
+    // `version` (or the conventional -v/--version flags) prints the running version — the diagnostic the
+    // troubleshooting docs lean on to confirm which npx-resolved build is actually executing.
+    if (cmd === VERSION_COMMAND || cmd === '--version' || cmd === '-v')
+        return { kind: 'version' };
+    switch (cmd) {
+        case INIT_COMMAND: {
+            const r = parseInitFlags(rest);
+            if (r.kind === 'error')
+                return r;
+            return { kind: 'init', port: r.port, mcp: r.mcp, dryRun: r.dryRun, install: r.install };
+        }
+        case SERVE_COMMAND: {
+            const r = parseServeFlags(rest, defaultPort);
+            if (r.kind === 'error')
+                return r;
+            return {
+                kind: 'serve',
+                port: r.port,
+                headless: r.headless,
+                http: r.http,
+                ...(r.driveUrl !== undefined ? { driveUrl: r.driveUrl } : {}),
+                ...(r.httpPort !== undefined ? { httpPort: r.httpPort } : {}),
+                ...(r.httpToken !== undefined ? { httpToken: r.httpToken } : {}),
+            };
+        }
+        case STOP_COMMAND: {
+            const port = parsePortFlag(rest, defaultPort);
+            const quiet = rest.includes(QUIET_FLAG);
+            return { kind: 'stop', port, quiet };
+        }
+        case STATUS_COMMAND: {
+            const port = parsePortFlag(rest, defaultPort);
+            return { kind: 'status', port };
+        }
+        case LICENSE_COMMAND:
+            return { kind: 'license' };
+        case OPEN_COMMAND: {
+            const port = parsePortFlag(rest, defaultPort);
+            // The first non-flag arg is the url (optional — omitting reuses a connected tab).
+            const url = rest.find((a) => !a.startsWith('--') && a !== String(port));
+            return url !== undefined ? { kind: 'open', port, url } : { kind: 'open', port };
+        }
+        case DRIVE_COMMAND: {
+            const r = parseDriveSuffix(rest, defaultPort);
+            if (r.kind === 'error')
+                return r;
+            return { kind: 'drive', port: r.port, driveUrl: r.driveUrl, headless: r.headless };
+        }
+        case DAEMON_INNER_COMMAND: {
+            const r = parseServeFlags(rest, defaultPort);
+            if (r.kind === 'error')
+                return r;
+            return {
+                kind: '_daemon',
+                port: r.port,
+                headless: r.headless,
+                http: r.http,
+                ...(r.driveUrl !== undefined ? { driveUrl: r.driveUrl } : {}),
+                ...(r.httpPort !== undefined ? { httpPort: r.httpPort } : {}),
+                ...(r.httpToken !== undefined ? { httpToken: r.httpToken } : {}),
+            };
+        }
+        case VERIFY_COMMAND: {
+            const r = parseVerifySuffix(rest);
+            if (r.kind === 'error')
+                return r;
+            return {
+                kind: 'verify',
+                url: r.url,
+                headless: r.headless,
+                ...(r.timeoutMs !== undefined ? { timeoutMs: r.timeoutMs } : {}),
+                ...(r.storageState !== undefined ? { storageState: r.storageState } : {}),
+            };
+        }
+        case MCP_COMMAND: {
+            const r = parseServeFlags(rest, defaultPort);
+            if (r.kind === 'error')
+                return r;
+            return {
+                kind: 'mcp',
+                port: r.port,
+                headless: r.headless,
+                ...(r.driveUrl !== undefined ? { driveUrl: r.driveUrl } : {}),
+            };
+        }
+        default:
+            return { kind: 'error', message: CLI_USAGE };
+    }
+}
+//# sourceMappingURL=cli-parse.js.map

package/dist/cli-parse.js.map

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

package/dist/cli-port.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Port resolution for the reticle CLI. Split out so it can be unit-tested independently.
+ *
+ * Priority (highest → lowest):
+ *   1. --port flag  (parsed by parseCliArgs, already overrides defaultPort)
+ *   2. RETICLE_PORT env var
+ *   3. .reticle.json "port" field in the cwd  ← per-project isolation
+ *   4. RETICLE_DEFAULT_PORT (4400)
+ */
+/**
+ * Read the port stored in the project's .reticle.json (written by `reticle init`).
+ * Returns undefined if the file is absent, unreadable, or has no valid numeric port.
+ */
+export declare function readProjectPort(cwd: string): number | undefined;
+/**
+ * Read the stable projectId stored in the project's .reticle.json (written by `reticle init`). The daemon
+ * uses it as the default resolve scope so auto-selection stays within the active app. Returns
+ * undefined if the file is absent/unreadable or has no non-empty string projectId.
+ */
+export declare function readProjectId(cwd: string): string | undefined;
+/**
+ * Resolve the daemon port from all available sources in priority order.
+ * Pass `portFlag` when the user explicitly supplied --port; pass `undefined` to fall through.
+ */
+export declare function resolvePort(portFlag: number | undefined, envPort: number | undefined, projectPort: number | undefined, defaultPort: number): number;
+//# sourceMappingURL=cli-port.d.ts.map

package/dist/cli-port.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-port.d.ts","sourceRoot":"","sources":["../src/cli-port.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH;;;GAGG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAY/D;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAY7D;AAED;;;GAGG;AACH,wBAAgB,WAAW,CACzB,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,WAAW,EAAE,MAAM,GAClB,MAAM,CAER"}

package/dist/cli-port.js

@@ -0,0 +1,57 @@
+/**
+ * Port resolution for the reticle CLI. Split out so it can be unit-tested independently.
+ *
+ * Priority (highest → lowest):
+ *   1. --port flag  (parsed by parseCliArgs, already overrides defaultPort)
+ *   2. RETICLE_PORT env var
+ *   3. .reticle.json "port" field in the cwd  ← per-project isolation
+ *   4. RETICLE_DEFAULT_PORT (4400)
+ */
+import { readFileSync } from 'node:fs';
+/**
+ * Read the port stored in the project's .reticle.json (written by `reticle init`).
+ * Returns undefined if the file is absent, unreadable, or has no valid numeric port.
+ */
+export function readProjectPort(cwd) {
+    try {
+        const raw = readFileSync(`${cwd}/.reticle.json`, 'utf8');
+        const config = JSON.parse(raw);
+        if (typeof config === 'object' && config !== null) {
+            const p = config['port'];
+            if (typeof p === 'number' && Number.isInteger(p) && p > 0 && p < 65536)
+                return p;
+        }
+    }
+    catch {
+        // .reticle.json absent or unreadable — fall through to default
+    }
+    return undefined;
+}
+/**
+ * Read the stable projectId stored in the project's .reticle.json (written by `reticle init`). The daemon
+ * uses it as the default resolve scope so auto-selection stays within the active app. Returns
+ * undefined if the file is absent/unreadable or has no non-empty string projectId.
+ */
+export function readProjectId(cwd) {
+    try {
+        const raw = readFileSync(`${cwd}/.reticle.json`, 'utf8');
+        const config = JSON.parse(raw);
+        if (typeof config === 'object' && config !== null) {
+            const id = config['projectId'];
+            if (typeof id === 'string' && id.length > 0)
+                return id;
+        }
+    }
+    catch {
+        // .reticle.json absent or unreadable — no default scope
+    }
+    return undefined;
+}
+/**
+ * Resolve the daemon port from all available sources in priority order.
+ * Pass `portFlag` when the user explicitly supplied --port; pass `undefined` to fall through.
+ */
+export function resolvePort(portFlag, envPort, projectPort, defaultPort) {
+    return portFlag ?? envPort ?? projectPort ?? defaultPort;
+}
+//# sourceMappingURL=cli-port.js.map

package/dist/cli-port.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-port.js","sourceRoot":"","sources":["../src/cli-port.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,GAAG,GAAG,gBAAgB,EAAE,MAAM,CAAC,CAAC;QACzD,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACxC,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;YAClD,MAAM,CAAC,GAAI,MAAkC,CAAC,MAAM,CAAC,CAAC;YACtD,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,KAAK;gBAAE,OAAO,CAAC,CAAC;QACnF,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,+DAA+D;IACjE,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,GAAG,GAAG,gBAAgB,EAAE,MAAM,CAAC,CAAC;QACzD,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACxC,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;YAClD,MAAM,EAAE,GAAI,MAAkC,CAAC,WAAW,CAAC,CAAC;YAC5D,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC;gBAAE,OAAO,EAAE,CAAC;QACzD,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,wDAAwD;IAC1D,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CACzB,QAA4B,EAC5B,OAA2B,EAC3B,WAA+B,EAC/B,WAAmB;IAEnB,OAAO,QAAQ,IAAI,OAAO,IAAI,WAAW,IAAI,WAAW,CAAC;AAC3D,CAAC"}

package/dist/cli-verify.d.ts

@@ -0,0 +1,46 @@
+/**
+ * `reticle verify <url>` — one-shot, non-MCP verification. It boots the engine in drive mode (Reticle owns
+ * a browser pointed at the preview URL), waits for the in-page SDK to dial back, replays every saved
+ * flow, renders the verdict, and exits 0 on pass / 1 otherwise. The same ReticleRunner + verdict the MCP
+ * and HTTP paths use — so a platform/CI agent that can only run a shell command (Lovable, Emergent,
+ * GitHub Actions) gets a byte-identical artifact without speaking MCP.
+ *
+ * The orchestration (runVerify) is split from the live wiring (openLiveConnection) behind VerifyPorts,
+ * so the decision logic — including the two honesty guards (no session, no flows ⇒ never a green pass)
+ * — is unit-tested without launching a real browser.
+ */
+import { type ReticleVerificationRun } from '@reticlehq/core';
+/** The live capabilities runVerify needs — faked in tests so the logic runs without a browser. */
+export interface VerifyConnection {
+    /** Resolve true once a browser session has connected, or false at timeout. */
+    sessionReady(timeoutMs: number): Promise<boolean>;
+    listFlows(): Promise<string[]>;
+    verify(): Promise<ReticleVerificationRun>;
+    close(): Promise<void>;
+}
+export interface VerifyPorts {
+    connect: () => Promise<VerifyConnection>;
+    out: (line: string) => void;
+    fail: (line: string) => void;
+    exit: (code: number) => void;
+}
+interface VerifyArgs {
+    url: string;
+    timeoutMs: number;
+}
+/** Orchestration: boot → wait for a session → replay flows → verdict → exit code. Browser-free. */
+export declare function runVerify(args: VerifyArgs, ports: VerifyPorts): Promise<void>;
+/** Split a drive URL into its origin + whether it's loopback — decides token/injection pairing. */
+export declare function urlParts(url: string): {
+    origin?: string;
+    loopback: boolean;
+};
+/** CLI entry — wires the live ports and runs the one-shot verification. Exits the process itself. */
+export declare function handleVerify(parsed: {
+    url: string;
+    headless: boolean;
+    timeoutMs?: number;
+    storageState?: string;
+}): void;
+export {};
+//# sourceMappingURL=cli-verify.d.ts.map

package/dist/cli-verify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-verify.d.ts","sourceRoot":"","sources":["../src/cli-verify.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,EAUL,KAAK,sBAAsB,EAC5B,MAAM,iBAAiB,CAAC;AA8BzB,kGAAkG;AAClG,MAAM,WAAW,gBAAgB;IAC/B,8EAA8E;IAC9E,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAClD,SAAS,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC/B,MAAM,IAAI,OAAO,CAAC,sBAAsB,CAAC,CAAC;IAC1C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACzC,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5B,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9B;AAED,UAAU,UAAU;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;CACnB;AAgBD,mGAAmG;AACnG,wBAAsB,SAAS,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAyBnF;AA8CD,mGAAmG;AACnG,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAO5E;AA6CD,qGAAqG;AACrG,wBAAgB,YAAY,CAAC,MAAM,EAAE;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GAAG,IAAI,CAsBP"}

package/dist/cli-verify.js

@@ -0,0 +1,181 @@
+/**
+ * `reticle verify <url>` — one-shot, non-MCP verification. It boots the engine in drive mode (Reticle owns
+ * a browser pointed at the preview URL), waits for the in-page SDK to dial back, replays every saved
+ * flow, renders the verdict, and exits 0 on pass / 1 otherwise. The same ReticleRunner + verdict the MCP
+ * and HTTP paths use — so a platform/CI agent that can only run a shell command (Lovable, Emergent,
+ * GitHub Actions) gets a byte-identical artifact without speaking MCP.
+ *
+ * The orchestration (runVerify) is split from the live wiring (openLiveConnection) behind VerifyPorts,
+ * so the decision logic — including the two honesty guards (no session, no flows ⇒ never a green pass)
+ * — is unit-tested without launching a real browser.
+ */
+import { join, basename } from 'node:path';
+import { randomUUID } from 'node:crypto';
+import { RETICLE_DEFAULT_PORT, RETICLE_WS_PATH, isLoopbackHostname, ReticleDir, RunAgentKind, RunFramework, RunProfile, RunTrigger, VerdictStatus, } from '@reticlehq/core';
+import { start } from './index.js';
+import { ReticleRunner } from './runs/reticle-runner.js';
+import { createRunnerPort } from './runs/runner-port.js';
+import { renderRunReport } from './runs/render-report.js';
+import { BaselineStore } from './project/baselines.js';
+import { RecordingStore } from './flows/recordings.js';
+import { FlowStore } from './flows/flows.js';
+import { ProjectStore } from './project/project-store.js';
+import { AnnotationStore } from './flows/annotation-store.js';
+import { createNodeFileSystem } from './project/fs-port.js';
+const EXIT_PASS = 0;
+const EXIT_FAIL = 1;
+const DEFAULT_SESSION_TIMEOUT_MS = 15_000;
+const SESSION_POLL_MS = 250;
+const DEFAULT_PROJECT_NAME = 'app';
+const VERIFY_AGENT_ID = 'reticle-cli';
+const MSG_NO_SESSION = 'No app connected — Reticle drove the URL but no @reticlehq/browser session dialed back.\n' +
+    '  Make sure the SDK is in the build and reticle.connect() runs on the preview page' +
+    ' (for a non-localhost preview: allowNonLocalhost + a pairing token).';
+const MSG_NO_FLOWS = 'No saved flows to verify (.reticle/flows is empty) — refusing to report a pass for verifying nothing.\n' +
+    '  Record a flow first (reticle_record_start → act → reticle_flow_save), then re-run verify.';
+const MSG_VERIFY_PREFIX = 'verify failed: ';
+function errMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+async function openConnection(ports) {
+    try {
+        return await ports.connect();
+    }
+    catch (error) {
+        ports.fail(MSG_VERIFY_PREFIX + errMessage(error));
+        ports.exit(EXIT_FAIL);
+        return undefined;
+    }
+}
+/** Orchestration: boot → wait for a session → replay flows → verdict → exit code. Browser-free. */
+export async function runVerify(args, ports) {
+    const conn = await openConnection(ports);
+    if (conn === undefined)
+        return;
+    try {
+        const ready = await conn.sessionReady(args.timeoutMs);
+        if (!ready) {
+            ports.fail(MSG_NO_SESSION);
+            ports.exit(EXIT_FAIL);
+            return;
+        }
+        const names = await conn.listFlows();
+        if (names.length === 0) {
+            ports.fail(MSG_NO_FLOWS);
+            ports.exit(EXIT_FAIL);
+            return;
+        }
+        const run = await conn.verify();
+        ports.out(renderRunReport(run));
+        ports.exit(run.verdict.status === VerdictStatus.PASS ? EXIT_PASS : EXIT_FAIL);
+    }
+    catch (error) {
+        ports.fail(MSG_VERIFY_PREFIX + errMessage(error));
+        ports.exit(EXIT_FAIL);
+    }
+    finally {
+        await conn.close().catch(() => undefined);
+    }
+}
+function delay(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+async function waitForSession(sessions, timeoutMs, now) {
+    const deadline = now() + timeoutMs;
+    while (now() < deadline) {
+        if (sessions.count() > 0)
+            return true;
+        await delay(SESSION_POLL_MS);
+    }
+    return sessions.count() > 0;
+}
+/** Reconstruct the disk-backed ToolDeps over the live bridge + driven browser the daemon owns. */
+function buildVerifyDeps(running, reticleRoot, now) {
+    const fs = createNodeFileSystem();
+    const deps = {
+        sessions: running.bridge.sessions,
+        baselines: new BaselineStore(),
+        recordings: new RecordingStore(),
+        flows: new FlowStore(fs, reticleRoot, { now }),
+        annotations: new AnnotationStore(),
+        project: new ProjectStore(fs, reticleRoot, { now }),
+        fs,
+        reticleRoot,
+        now,
+    };
+    if (running.realInput !== undefined)
+        deps.realInput = running.realInput;
+    return deps;
+}
+/** Split a drive URL into its origin + whether it's loopback — decides token/injection pairing. */
+export function urlParts(url) {
+    try {
+        const u = new URL(url);
+        return { origin: u.origin, loopback: isLoopbackHostname(u.hostname) };
+    }
+    catch {
+        return { loopback: false };
+    }
+}
+async function openLiveConnection(opts) {
+    // A localhost preview connects natively (the app's own reticle.connect() is allowed on loopback), so the
+    // bridge stays token-free. A HOSTED (non-localhost) preview is blocked by the SDK's connection policy
+    // and rejected as a foreign origin — so there we pair via a one-shot token both the bridge and the
+    // injected reticle.connect() share, plus the preview's origin on the allow-list. That split is what makes
+    // both "verify my dev server" and "verify a live Lovable URL" work from the same command.
+    const { origin, loopback } = urlParts(opts.url);
+    const pairing = loopback
+        ? {}
+        : (() => {
+            const token = randomUUID();
+            const bridgeUrl = `ws://localhost:${String(RETICLE_DEFAULT_PORT)}${RETICLE_WS_PATH}`;
+            return {
+                token,
+                injectConnect: { token, url: bridgeUrl },
+                ...(origin !== undefined ? { allowedOrigins: [origin] } : {}),
+            };
+        })();
+    const running = await start({
+        driveUrl: opts.url,
+        headless: opts.headless,
+        mcp: false,
+        reticleRoot: opts.reticleRoot,
+        now: opts.now,
+        ...pairing,
+        ...(opts.storageState !== undefined ? { storageState: opts.storageState } : {}),
+    });
+    const deps = buildVerifyDeps(running, opts.reticleRoot, opts.now);
+    const runner = new ReticleRunner(createRunnerPort(deps));
+    return {
+        sessionReady: (timeoutMs) => waitForSession(deps.sessions, timeoutMs, opts.now),
+        listFlows: () => deps.flows.list(),
+        verify: () => runner.verify({
+            project: { name: opts.projectName, framework: RunFramework.OTHER, previewUrl: opts.url },
+            agent: { id: VERIFY_AGENT_ID, kind: RunAgentKind.OEM_PIPELINE },
+            trigger: { kind: RunTrigger.OEM },
+            profile: RunProfile.PROD_PREVIEW,
+        }),
+        close: () => running.close(),
+    };
+}
+/** CLI entry — wires the live ports and runs the one-shot verification. Exits the process itself. */
+export function handleVerify(parsed) {
+    const now = () => Date.now();
+    const reticleRoot = join(process.cwd(), ReticleDir.ROOT);
+    const projectName = basename(process.cwd()) || DEFAULT_PROJECT_NAME;
+    const ports = {
+        connect: () => openLiveConnection({
+            url: parsed.url,
+            headless: parsed.headless,
+            reticleRoot,
+            projectName,
+            now,
+            ...(parsed.storageState !== undefined ? { storageState: parsed.storageState } : {}),
+        }),
+        out: (line) => process.stdout.write(`${line}\n`),
+        fail: (line) => process.stderr.write(`${line}\n`),
+        exit: (code) => process.exit(code),
+    };
+    void runVerify({ url: parsed.url, timeoutMs: parsed.timeoutMs ?? DEFAULT_SESSION_TIMEOUT_MS }, ports);
+}
+//# sourceMappingURL=cli-verify.js.map