@reticlehq/server 3.7.0 → 3.8.1

package/dist/command/cli/cli-parse.d.ts

@@ -6,9 +6,12 @@
 import { type ParsedFeedback } from './cli-parse-feedback.js';
 import { HEADED_FLAG, PORT_FLAG } from './cli-parse-grammar.js';
 export { HEADED_FLAG, PORT_FLAG };
-export { AGENT_FLAG, BUG_FLAG, FEEDBACK_KINDS, KIND_FLAG, RATING_FLAG, } from './cli-parse-feedback.js';
+export { DRIVE_FLAG, HEADLESS_FLAG, HTTP_FLAG, HTTP_PORT_FLAG, HTTP_TOKEN_FLAG, } from './cli-parse-serve.js';
+export { AGENT_FLAG, BUG_FLAG, CONTACT_FLAG, FEEDBACK_KINDS, KIND_FLAG, RATING_FLAG, } from './cli-parse-feedback.js';
 import { CLI_USAGE } from './cli-usage.js';
 export { CLI_USAGE };
+/** `reticle hook`: the agent prompt hook. `cli.ts` runs it before this parser, and before telemetry. */
+export declare const HOOK_COMMAND = "hook";
 /** The `reticle telemetry` sub-actions. Bare `reticle telemetry` means `status`. */
 export declare const TelemetryAction: {
     readonly STATUS: "status";
@@ -27,20 +30,15 @@ export declare const DAEMON_INNER_COMMAND = "_daemon";
  * defined; a second list somewhere else would drift the first time a command is added.
  */
 export declare const UNKNOWN_COMMAND = "unknown";
+/**
+ * Commands that only ask about the CLI. An agent often runs one before anything else, so the first
+ * run on a machine is not the install until a real command follows.
+ */
+export declare const PROBE_COMMANDS: ReadonlySet<string>;
 /** Every command the typed parser below routes. The parser refuses any word not in this list. */
 export declare const LOCAL_COMMANDS: readonly string[];
 /** The subcommand name if we recognize it, else `unknown`. Bare `reticle` reports `help`. */
 export declare function knownCommand(arg: string | undefined): string;
-/**
- * Force a hidden browser. The default is now HEADED: a run nobody can see is a run nobody trusts,
- * and every "did it actually do anything?" question cost a round-trip. CI passes this (or just sets
- * CI, which flips the default) because there is no display there to be headed on.
- */
-export declare const HEADLESS_FLAG = "--headless";
-export declare const DRIVE_FLAG = "--drive";
-export declare const HTTP_FLAG = "--http";
-export declare const HTTP_PORT_FLAG = "--http-port";
-export declare const HTTP_TOKEN_FLAG = "--http-token";
 /**
  * A predicate for a flow-free, one-shot verdict against the daemon that is already running.
  *
@@ -60,6 +58,7 @@ export type CliResult = {
     filesOnly: boolean;
     captureBodies: boolean;
     hooks: boolean;
+    promptCapture: boolean;
     json: boolean;
     relaunch: boolean;
     open: boolean;
@@ -68,6 +67,7 @@ export type CliResult = {
     url: string | undefined;
     timeoutSeconds: number | undefined;
     licenseKey: string | undefined;
+    newId: boolean;
 } | {
     kind: 'serve';
     port: number;
@@ -121,6 +121,7 @@ export type CliResult = {
     kind: 'open';
     port: number;
     url?: string;
+    navigate: boolean;
 } | {
     kind: '_daemon';
     port: number;

package/dist/command/cli/cli-parse.js

@@ -4,14 +4,16 @@
  * and re-exports this surface.
  */
 import { parseFeedbackArgs } from './cli-parse-feedback.js';
+import { HEADLESS_FLAG, parseServeFlags } from './cli-parse-serve.js';
 import { parseVerifySuffix } from './cli-parse-verify.js';
 import { HEADED_FLAG, PORT_FLAG, VERIFY_COMMAND, missingOperand, missingValue, notANumber, retiredFlag, unknownArgument, CLOUD_COMMANDS, REMOVED_COMMANDS, removedNote, } from './cli-parse-grammar.js';
 // Re-exported because the daemon's own argv builder reaches for these through this module, which is
 // where the grammar has always lived as far as every caller is concerned.
 export { HEADED_FLAG, PORT_FLAG };
+export { DRIVE_FLAG, HEADLESS_FLAG, HTTP_FLAG, HTTP_PORT_FLAG, HTTP_TOKEN_FLAG, } from './cli-parse-serve.js';
 import { FORCE_FLAG } from './cli-kill.js';
 // Re-exported so every existing importer of these flags is unaffected by the file split.
-export { AGENT_FLAG, BUG_FLAG, FEEDBACK_KINDS, KIND_FLAG, RATING_FLAG, } from './cli-parse-feedback.js';
+export { AGENT_FLAG, BUG_FLAG, CONTACT_FLAG, FEEDBACK_KINDS, KIND_FLAG, RATING_FLAG, } from './cli-parse-feedback.js';
 // The help text lives on its own page; re-exported so every importer of it is unaffected.
 import { CLI_USAGE } from './cli-usage.js';
 export { CLI_USAGE };
@@ -42,6 +44,8 @@ const TELEMETRY_COMMAND = 'telemetry';
 const FEEDBACK_COMMAND = 'feedback';
 const DOCTOR_COMMAND = 'doctor';
 const SETUP_COMMAND = 'setup';
+/** `reticle hook`: the agent prompt hook. `cli.ts` runs it before this parser, and before telemetry. */
+export const HOOK_COMMAND = 'hook';
 /** The `reticle telemetry` sub-actions. Bare `reticle telemetry` means `status`. */
 export const TelemetryAction = {
     STATUS: 'status',
@@ -61,6 +65,15 @@ export const DAEMON_INNER_COMMAND = '_daemon';
 export const UNKNOWN_COMMAND = 'unknown';
 const HELP_COMMAND = 'help';
 const HELP_FLAGS = new Set(['--help', '-h']);
+/**
+ * Commands that only ask about the CLI. An agent often runs one before anything else, so the first
+ * run on a machine is not the install until a real command follows.
+ */
+export const PROBE_COMMANDS = new Set([
+    VERSION_COMMAND,
+    HELP_COMMAND,
+    TELEMETRY_COMMAND,
+]);
 /** Every command the typed parser below routes. The parser refuses any word not in this list. */
 export const LOCAL_COMMANDS = [
     INIT_COMMAND,
@@ -86,6 +99,7 @@ export const LOCAL_COMMANDS = [
     DAEMON_INNER_COMMAND,
     DOCTOR_COMMAND,
     SETUP_COMMAND,
+    HOOK_COMMAND,
 ];
 const LOCAL_COMMAND_SET = new Set(LOCAL_COMMANDS);
 const KNOWN_COMMANDS = new Set([
@@ -110,24 +124,19 @@ const COMMAND_FLAG_ALIASES = new Map([
  */
 function numberFlag(args, name) {
     const at = args.indexOf(name);
-    if (at < 0)
+    if (at < 0) {
         return 0;
+    }
     const raw = Number(args[at + 1]);
     return Number.isFinite(raw) && raw >= 0 ? Math.floor(raw) : 0;
 }
 /** The subcommand name if we recognize it, else `unknown`. Bare `reticle` reports `help`. */
 export function knownCommand(arg) {
-    if (arg === undefined || '' === arg)
+    if (arg === undefined || '' === arg) {
         return HELP_COMMAND;
+    }
     return KNOWN_COMMANDS.has(arg) ? arg : (COMMAND_FLAG_ALIASES.get(arg) ?? UNKNOWN_COMMAND);
 }
-/**
- * Force a hidden browser. The default is now HEADED: a run nobody can see is a run nobody trusts,
- * and every "did it actually do anything?" question cost a round-trip. CI passes this (or just sets
- * CI, which flips the default) because there is no display there to be headed on.
- */
-export const HEADLESS_FLAG = '--headless';
-export const DRIVE_FLAG = '--drive';
 const QUIET_FLAG = '--quiet';
 const DRY_RUN_FLAG = '--dry-run';
 const YES_FLAG = '--yes';
@@ -159,6 +168,8 @@ const START_FLAG = '--start';
 const CAPTURE_BODIES_FLAG = '--capture-bodies';
 /** `--hooks`: also install the print-only Claude Code Stop hook (`reticle report --hook`). */
 const HOOKS_FLAG = '--hooks';
+/** `--no-prompt-capture`: install no prompt-capture hook for the agents found. */
+const NO_PROMPT_CAPTURE_FLAG = '--no-prompt-capture';
 /**
  * The rest of the runtime surface.
  *
@@ -169,6 +180,8 @@ const HOOKS_FLAG = '--hooks';
 const JSON_FLAG = '--json';
 const NO_DRIVE_FLAG = '--no-drive';
 const NO_OPEN_FLAG = '--no-open';
+/** `reticle open <url> --navigate`: move a tab already on the origin to the url (#1140). */
+const NAVIGATE_FLAG = '--navigate';
 /** Connect and stop: no coverage summary and no prompt at the end. */
 const NO_FIRST_RUN_FLAG = '--no-first-run';
 const NO_AGENTS_FLAG = '--no-agents';
@@ -193,9 +206,8 @@ const DRIVE_MODEL_FLAG = '--drive-model';
  */
 const LICENSE_FLAG = '--license';
 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';
+/** Give this checkout a project id of its own: a copied repository keeps the original's. */
+const NEW_ID_FLAG = '--new-id';
 /**
  * A usage error names the thing that was wrong.
  *
@@ -208,98 +220,19 @@ export const HTTP_TOKEN_FLAG = '--http-token';
  * The help text is still shown — cli.ts renders it as readable text underneath. It is just not the
  * message any more.
  */
-const requiresHttp = (flag) => ({
-    kind: 'error',
-    message: `${flag} requires ${HTTP_FLAG} — it configures the verify endpoint ${HTTP_FLAG} starts`,
-});
 const unknownCommand = (command) => ({
     kind: 'error',
     message: `unknown command '${command}'`,
 });
-function parseServeFlags(args, defaultPort, defaultHeadless) {
-    let port = defaultPort;
-    let driveUrl;
-    let headless = defaultHeadless;
-    let http = false;
-    let httpPort;
-    let httpToken;
-    let i = 0;
-    while (i < args.length) {
-        const arg = args[i];
-        // `i < args.length` already guarantees this, but the index signature does not say so and the
-        // unknown-argument error needs a real string to name.
-        if (arg === undefined)
-            break;
-        if (arg === PORT_FLAG) {
-            i++;
-            const n = args[i];
-            if (n === undefined)
-                return missingValue(PORT_FLAG);
-            const parsed = parseInt(n, 10);
-            if (isNaN(parsed))
-                return notANumber(PORT_FLAG, n);
-            port = parsed;
-        }
-        else if (arg === DRIVE_FLAG) {
-            i++;
-            driveUrl = args[i];
-            if (driveUrl === undefined)
-                return missingValue(DRIVE_FLAG);
-        }
-        else if (arg === HEADED_FLAG) {
-            headless = false;
-        }
-        else if (arg === HEADLESS_FLAG) {
-            headless = true;
-        }
-        else if (arg === HTTP_FLAG) {
-            http = true;
-        }
-        else if (arg === HTTP_PORT_FLAG) {
-            i++;
-            const n = args[i];
-            if (n === undefined)
-                return missingValue(HTTP_PORT_FLAG);
-            const parsed = parseInt(n, 10);
-            if (isNaN(parsed))
-                return notANumber(HTTP_PORT_FLAG, n);
-            httpPort = parsed;
-        }
-        else if (arg === HTTP_TOKEN_FLAG) {
-            i++;
-            httpToken = args[i];
-            if (httpToken === undefined)
-                return missingValue(HTTP_TOKEN_FLAG);
-        }
-        else {
-            return unknownArgument(arg);
-        }
-        i++;
-    }
-    // Without `--http` these flags configure an endpoint nothing starts, and they were accepted and
-    // silently ignored — worse than being rejected, because the whole reason to pass them is to be
-    // honoured (#687).
-    if (!http && httpPort !== undefined)
-        return requiresHttp(HTTP_PORT_FLAG);
-    if (!http && httpToken !== undefined)
-        return requiresHttp(HTTP_TOKEN_FLAG);
-    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 (-1 === idx)
+    if (-1 === idx) {
         return defaultPort;
+    }
     const n = args[idx + 1];
-    if (n === undefined)
+    if (n === undefined) {
         return defaultPort;
+    }
     const parsed = parseInt(n, 10);
     return isNaN(parsed) ? defaultPort : parsed;
 }
@@ -323,8 +256,9 @@ function parseDriveSuffix(args, port, defaultHeadless) {
             return unknownArgument(arg);
         }
     }
-    if (driveUrl === undefined)
+    if (driveUrl === undefined) {
         return missingOperand(DRIVE_COMMAND, 'a url');
+    }
     return { kind: 'ok', port, driveUrl, headless };
 }
 function parseInitFlags(args) {
@@ -339,6 +273,7 @@ function parseInitFlags(args) {
     let start = false;
     let captureBodies = false;
     let hooks = false;
+    let promptCapture = true;
     let json = false;
     let open = true;
     let firstRun = true;
@@ -347,28 +282,33 @@ function parseInitFlags(args) {
     let url;
     let timeoutSeconds;
     let licenseKey;
+    let newId = false;
     let i = 0;
     while (i < args.length) {
         const arg = args[i];
         // `i < args.length` already guarantees this, but the index signature does not say so and the
         // unknown-argument error needs a real string to name.
-        if (arg === undefined)
+        if (arg === undefined) {
             break;
+        }
         if (arg === PORT_FLAG) {
             i++;
             const n = args[i];
-            if (n === undefined)
+            if (n === undefined) {
                 return missingValue(PORT_FLAG);
+            }
             const parsed = parseInt(n, 10);
-            if (isNaN(parsed))
+            if (isNaN(parsed)) {
                 return notANumber(PORT_FLAG, n);
+            }
             port = parsed;
         }
         else if (arg === APP_FLAG) {
             i++;
             const value = args[i];
-            if (value === undefined)
+            if (value === undefined) {
                 return missingValue(APP_FLAG);
+            }
             app = value;
         }
         else if (arg === FLOW_FLAG || arg === NO_DRIVE_FLAG || arg === DRIVE_MODEL_FLAG) {
@@ -377,8 +317,9 @@ function parseInitFlags(args) {
         else if (arg === ENV_FLAG) {
             i++;
             const value = args[i];
-            if (value === undefined)
+            if (value === undefined) {
                 return missingValue(ENV_FLAG);
+            }
             env.push(value);
         }
         else if (arg === FILES_ONLY_FLAG) {
@@ -393,6 +334,9 @@ function parseInitFlags(args) {
         else if (arg === HOOKS_FLAG) {
             hooks = true;
         }
+        else if (arg === NO_PROMPT_CAPTURE_FLAG) {
+            promptCapture = false;
+        }
         else if (arg === JSON_FLAG) {
             json = true;
         }
@@ -411,25 +355,29 @@ function parseInitFlags(args) {
         else if (arg === URL_FLAG) {
             i++;
             const value = args[i];
-            if (value === undefined)
+            if (value === undefined) {
                 return missingValue(URL_FLAG);
+            }
             url = value;
         }
         else if (arg === LICENSE_FLAG) {
             i++;
             const value = args[i];
-            if (value === undefined)
+            if (value === undefined) {
                 return missingValue(LICENSE_FLAG);
+            }
             licenseKey = value;
         }
         else if (arg === TIMEOUT_FLAG_INIT) {
             i++;
             const value = args[i];
-            if (value === undefined)
+            if (value === undefined) {
                 return missingValue(TIMEOUT_FLAG_INIT);
+            }
             const seconds = parseInt(value, 10);
-            if (isNaN(seconds))
+            if (isNaN(seconds)) {
                 return notANumber(TIMEOUT_FLAG_INIT, value);
+            }
             timeoutSeconds = seconds;
         }
         else if (arg === NO_MCP_FLAG) {
@@ -438,6 +386,9 @@ function parseInitFlags(args) {
         else if (arg === NO_INSTALL_FLAG) {
             install = false;
         }
+        else if (arg === NEW_ID_FLAG) {
+            newId = true;
+        }
         else if (arg === DRY_RUN_FLAG) {
             dryRun = true;
         }
@@ -462,6 +413,7 @@ function parseInitFlags(args) {
         filesOnly: filesOnly || (app !== undefined && !start),
         captureBodies,
         hooks,
+        promptCapture,
         json,
         open,
         firstRun,
@@ -470,6 +422,7 @@ function parseInitFlags(args) {
         url,
         timeoutSeconds,
         licenseKey,
+        newId,
     };
 }
 /** Pure CLI arg parser — exported for unit tests. argv = process.argv.slice(2). */
@@ -499,8 +452,9 @@ function parseTargetArgs(rest) {
             i += 1;
             continue;
         }
-        if (arg !== undefined && !arg.startsWith('-'))
+        if (arg !== undefined && !arg.startsWith('-')) {
             files.push(arg);
+        }
     }
     return since === undefined ? { files } : { files, since };
 }
@@ -510,8 +464,9 @@ function parseTargetArgs(rest) {
  * workspace itself, and a tutorial only dials one when asked to run.
  */
 export function dialsTheDaemon(parsed) {
-    if ('init' === parsed.kind)
+    if ('init' === parsed.kind) {
         return false;
+    }
     return 'port' in parsed;
 }
 /**
@@ -522,16 +477,19 @@ export function dialsTheDaemon(parsed) {
  */
 export function parseCliArgs(argv, defaultPort, defaultHeadless = false) {
     // Bare `reticle` is `serve`.
-    if (0 === argv.length)
+    if (0 === argv.length) {
         return { kind: 'serve', port: defaultPort, headless: defaultHeadless, http: false };
+    }
     const [cmd, ...rest] = argv;
     // Guaranteed by the bare-argv check above; restated so the unknown-command error can name it.
-    if (cmd === undefined)
+    if (cmd === undefined) {
         return { kind: 'error', message: CLI_USAGE };
+    }
     // `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 || '--version' === cmd || '-v' === cmd)
+    if (cmd === VERSION_COMMAND || '--version' === cmd || '-v' === cmd) {
         return { kind: 'version' };
+    }
     // `help` (and the conventional -h/--help) print usage to stdout and exit 0 — the universal first move
     // for a new user, which otherwise fell through to a JSON error with exit 1.
     //
@@ -545,23 +503,27 @@ export function parseCliArgs(argv, defaultPort, defaultHeadless = false) {
     // Removed commands answer before help does: `reticle hunt --help` should say it is gone, not
     // describe something that no longer runs.
     const removed = REMOVED_COMMANDS.get(cmd);
-    if (removed !== undefined)
+    if (removed !== undefined) {
         return { kind: 'removed', message: removedNote(cmd, removed) };
+    }
     if (HELP_COMMAND === cmd || HELP_FLAGS.has(cmd)) {
         // `reticle help all`, `reticle --help all`, `reticle help init`.
         const topic = rest.find((arg) => !HELP_FLAGS.has(arg));
         return topic === undefined ? { kind: 'help' } : { kind: 'help', topic };
     }
-    if (argv.some((arg) => HELP_FLAGS.has(arg)))
+    if (argv.some((arg) => HELP_FLAGS.has(arg))) {
         return { kind: 'help', topic: cmd };
+    }
     // The list is the gate, so a command cannot be routed without also being named in telemetry.
-    if (!LOCAL_COMMAND_SET.has(cmd))
+    if (!LOCAL_COMMAND_SET.has(cmd)) {
         return unknownCommand(cmd);
+    }
     switch (cmd) {
         case INIT_COMMAND: {
             const r = parseInitFlags(rest);
-            if ('error' === r.kind)
+            if ('error' === r.kind) {
                 return r;
+            }
             return {
                 kind: 'init',
                 port: r.port,
@@ -573,6 +535,7 @@ export function parseCliArgs(argv, defaultPort, defaultHeadless = false) {
                 filesOnly: r.filesOnly,
                 captureBodies: r.captureBodies,
                 hooks: r.hooks,
+                promptCapture: r.promptCapture,
                 json: r.json,
                 open: r.open,
                 firstRun: r.firstRun,
@@ -581,12 +544,14 @@ export function parseCliArgs(argv, defaultPort, defaultHeadless = false) {
                 url: r.url,
                 timeoutSeconds: r.timeoutSeconds,
                 licenseKey: r.licenseKey,
+                newId: r.newId,
             };
         }
         case SERVE_COMMAND: {
             const r = parseServeFlags(rest, defaultPort, defaultHeadless);
-            if ('error' === r.kind)
+            if ('error' === r.kind) {
                 return r;
+            }
             return {
                 kind: 'serve',
                 port: r.port,
@@ -601,8 +566,9 @@ export function parseCliArgs(argv, defaultPort, defaultHeadless = false) {
             const port = parsePortFlag(rest, defaultPort);
             // `stop --force` is what `kill` was: free the port by its listener, which must still be a
             // Reticle daemon. Overriding that refusal stays on `restart --force` and the old `kill --force`.
-            if (rest.includes(FORCE_FLAG))
+            if (rest.includes(FORCE_FLAG)) {
                 return { kind: 'kill', port, force: false };
+            }
             const quiet = rest.includes(QUIET_FLAG);
             return { kind: 'stop', port, quiet };
         }
@@ -657,8 +623,9 @@ export function parseCliArgs(argv, defaultPort, defaultHeadless = false) {
             }
             // Only `mcp` today. A bare `reticle setup` falls to help rather than guessing, because the
             // next subcommand here will not be a synonym for this one.
-            if (what !== 'mcp')
+            if (what !== 'mcp') {
                 return { kind: 'help', topic: SETUP_COMMAND };
+            }
             return { kind: 'setup-mcp' };
         }
         case LICENSE_COMMAND:
@@ -678,18 +645,23 @@ export function parseCliArgs(argv, defaultPort, defaultHeadless = false) {
             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 };
+            const navigate = rest.includes(NAVIGATE_FLAG);
+            return url !== undefined
+                ? { kind: 'open', port, url, navigate }
+                : { kind: 'open', port, navigate };
         }
         case DRIVE_COMMAND: {
             const r = parseDriveSuffix(rest, defaultPort, defaultHeadless);
-            if ('error' === r.kind)
+            if ('error' === r.kind) {
                 return r;
+            }
             return { kind: 'drive', port: r.port, driveUrl: r.driveUrl, headless: r.headless };
         }
         case DAEMON_INNER_COMMAND: {
             const r = parseServeFlags(rest, defaultPort, defaultHeadless);
-            if ('error' === r.kind)
+            if ('error' === r.kind) {
                 return r;
+            }
             return {
                 kind: '_daemon',
                 port: r.port,
@@ -702,8 +674,9 @@ export function parseCliArgs(argv, defaultPort, defaultHeadless = false) {
         }
         case VERIFY_COMMAND: {
             const r = parseVerifySuffix(rest, defaultPort);
-            if ('error' === r.kind)
+            if ('error' === r.kind) {
                 return r;
+            }
             return {
                 kind: 'verify',
                 url: r.url,
@@ -749,6 +722,9 @@ export function parseCliArgs(argv, defaultPort, defaultHeadless = false) {
                 ...(session === undefined ? {} : { session }),
             };
         }
+        // `cli.ts` runs `hook` before this parser. Reached only without that dispatch: say what it does.
+        case HOOK_COMMAND:
+            return { kind: 'help', topic: HOOK_COMMAND };
         case CONTEXT_COMMAND: {
             // `--compact` is the only form; accepted so the hook line reads as what it does.
             const at = rest.indexOf(SESSION_FLAG);
@@ -761,8 +737,9 @@ export function parseCliArgs(argv, defaultPort, defaultHeadless = false) {
             return { kind: 'rollback' };
         case MCP_COMMAND: {
             const r = parseServeFlags(rest, defaultPort, defaultHeadless);
-            if ('error' === r.kind)
+            if ('error' === r.kind) {
                 return r;
+            }
             return {
                 kind: 'mcp',
                 port: r.port,

package/dist/command/cli/cli-usage.d.ts

@@ -1,14 +1,3 @@
-/**
- * The `reticle` help text.
- *
- * `reticle --help` is short: the commands a person needs, one line each, in four groups. Every other
- * command is still there and still works; `reticle help all` lists it, and `reticle <command> --help`
- * carries the detail that used to sit in the one long page.
- *
- * The lines say `reticle <command>`, which is the bin this package installs. Copied into `npx` it is
- * not: `npx reticle` resolves the PACKAGE named `reticle`, which belongs to somebody else, and npx
- * will happily fetch and run it. So the npx spelling leads every page.
- */
 export declare const HelpGroup: {
     readonly START: "Get started";
     readonly CHECK: "Check your app";