@reticlehq/init 3.4.0 → 3.5.0

package/dist/diagnose/init-failure.d.ts

@@ -13,6 +13,13 @@ export declare const InitFailure: {
     readonly DEPENDENCY_INSTALL: "dependency_install";
     /** The `claude mcp add` step failed — the CLI is missing or refused. Reticle installs but is unreachable. */
     readonly MCP_REGISTRATION: "mcp_registration";
+    /** The checkout or required tooling failed preflight. */
+    readonly PREFLIGHT: "preflight";
+    /** Runtime continuation could not start the app or connect its SDK. */
+    readonly DEV_SERVER: "dev_server";
+    readonly APP_CONNECTION: "app_connection";
+    readonly BRIDGE_OCCUPIED: "bridge_occupied";
+    readonly RUNTIME_ERROR: "runtime_error";
     readonly OTHER: "other";
 };
 export type InitFailure = (typeof InitFailure)[keyof typeof InitFailure];

package/dist/diagnose/init-failure.js

@@ -13,5 +13,12 @@ export const InitFailure = {
     DEPENDENCY_INSTALL: 'dependency_install',
     /** The `claude mcp add` step failed — the CLI is missing or refused. Reticle installs but is unreachable. */
     MCP_REGISTRATION: 'mcp_registration',
+    /** The checkout or required tooling failed preflight. */
+    PREFLIGHT: 'preflight',
+    /** Runtime continuation could not start the app or connect its SDK. */
+    DEV_SERVER: 'dev_server',
+    APP_CONNECTION: 'app_connection',
+    BRIDGE_OCCUPIED: 'bridge_occupied',
+    RUNTIME_ERROR: 'runtime_error',
     OTHER: 'other',
 };

package/dist/no-package-json.js

@@ -21,6 +21,7 @@ const SNIPPET_WRITTEN = `Wrote the dev-only connect snippet into ${HTML_INDEX_PA
     'gitignored — keep it out of anything you publish, and let each teammate run `reticle init` ' +
     'for their own.';
 const SNIPPET_ALREADY = `${HTML_INDEX_PATH} already loads the Reticle SDK — nothing to change.`;
+const DRY_RUN_PAIRING_TOKEN = 'DRY_RUN_TOKEN_NOT_FOR_USE';
 /**
  * Write the snippet into `index.html`, and hand over to setup as a success.
  *
@@ -74,6 +75,10 @@ export function initWithoutPackageJson(options, io) {
     // Written only when absent. A config a user or an earlier run already placed here is theirs.
     const nonJsProjectId = deriveProjectId(undefined, io.cwd());
     const writeConfig = () => {
+        if (options.dryRun) {
+            io.print('Dry run: no files written; the snippet uses a placeholder pairing token.');
+            return;
+        }
         // Except its port. A re-run with a new `--port` starts the daemon there, and a config still
         // naming the old one sends the agent to a daemon that is no longer running.
         const existingConfig = io.readFile(RETICLE_CONFIG_FILE);
@@ -88,10 +93,14 @@ export function initWithoutPackageJson(options, io) {
         rememberProjectOnDisk(io, nonJsProjectId, io.cwd(), Date.now());
         io.print(`Wrote ${RETICLE_CONFIG_FILE} (project "${nonJsProjectId}").`);
     };
-    const connect = connectArgWithToken(options.port, nonJsProjectId, io.host.pairingToken());
+    const connect = connectArgWithToken(options.port, nonJsProjectId, options.dryRun ? DRY_RUN_PAIRING_TOKEN : io.host.pairingToken());
     // One page at the root is a page we can see whole. Several, or none, is a choice that is not ours.
     if (!streamlit && !django && io.exists(HTML_INDEX_PATH)) {
         writeConfig();
+        if (options.dryRun) {
+            io.print(staticPageSnippet(connect));
+            return { ok: true, applied: 0, manual: 0 };
+        }
         // Without the token: the page is the deployable artifact, so the token goes beside it instead.
         return wireStaticPage(options, io, connectArg(options.port, nonJsProjectId));
     }
@@ -116,6 +125,7 @@ export function initWithoutPackageJson(options, io) {
             : staticPageSnippet(connect));
     // The onboarding funnel had NO instrumentation, so a setup that died here was indistinguishable
     // from someone who never ran the command — the two failure modes with the most different fixes.
-    io.host.reportOutcome({ ok: false, reason: InitFailure.NO_PACKAGE_JSON });
+    if (!options.dryRun)
+        io.host.reportOutcome({ ok: false, reason: InitFailure.NO_PACKAGE_JSON });
     return { ok: false, applied: 0, manual: 0 };
 }

package/dist/node-io.d.ts

@@ -34,4 +34,6 @@ export declare const RUNNABLE_COMMANDS: readonly string[];
  * reason a second, broken copy existed.
  */
 export declare function probeCli(command: string, args: readonly string[]): boolean;
-export declare function buildNodeIo(cwd: string, host: InitHost): InitIo;
+export declare function buildNodeIo(cwd: string, host: InitHost, output?: {
+    stderr?: boolean;
+}): InitIo;

package/dist/node-io.js

@@ -102,7 +102,7 @@ export function probeCli(command, args) {
         return false;
     }
 }
-export function buildNodeIo(cwd, host) {
+export function buildNodeIo(cwd, host, output = {}) {
     // Project-relative by default; absolute paths (e.g. ~/.cursor/mcp.json) pass through unchanged.
     const abs = (rel) => (isAbsolute(rel) ? rel : join(cwd, rel));
     return {
@@ -161,11 +161,14 @@ export function buildNodeIo(cwd, host) {
         scoped(rel) {
             // The host travels with the re-rooted IO: a monorepo redirect re-enters `runInit` through
             // this, and an untraced, unreported inner run is the half of init that actually did the work.
-            return buildNodeIo(abs(rel), host);
+            return buildNodeIo(abs(rel), host, output);
         },
         exec(command, args) {
-            // Inherit stdio so the install's own progress is visible to the user.
-            const result = spawnAllowed(command, args, { cwd, stdio: 'inherit' });
+            // JSON callers reserve stdout for the result, including across package-manager subprocesses.
+            const result = spawnAllowed(command, args, {
+                cwd,
+                stdio: true === output.stderr ? ['inherit', 2, 2] : 'inherit',
+            });
             return 0 === result.status;
         },
         capture(command, args) {
@@ -189,7 +192,8 @@ export function buildNodeIo(cwd, host) {
             return 0 === result.status;
         },
         print(line) {
-            process.stdout.write(`${wrapForTerminal(line, terminalWidth())}\n`);
+            const stream = true === output.stderr ? process.stderr : process.stdout;
+            stream.write(`${wrapForTerminal(line, terminalWidth())}\n`);
         },
         host,
     };

package/dist/register/mcp-clients.js

@@ -162,9 +162,8 @@ export const MCP_CLIENTS = [
          * `~/.gemini/config/mcp_config.json`, and one file serves the 2.0 IDE, the CLI and the SDK. Same
          * `command`/`args` object Cursor, Windsurf and Gemini CLI already use.
          *
-         * It shares the `~/.gemini` tree with Gemini CLI, which is why the marker matters: registration is
-         * gated on the marker DIRECTORY, and these resolve to `.gemini/config` and `.gemini` respectively,
-         * so having one installed cannot make `init` write a config for the other.
+         * It shares the `~/.gemini` tree with Gemini CLI. Gemini detection requires its settings file:
+         * checking only the parent directory also matches an Antigravity-only installation.
          *
          * NOT verified against a running install. The path is documented, the merge is the shared JSON
          * path that every other client here uses, and an unparseable config still degrades to a printed
@@ -329,6 +328,9 @@ export function clientSnippet(spec) {
 export function clientMarkerRelPath(spec) {
     if (spec.scope === ConfigScope.CLI)
         return '';
+    // Antigravity also creates ~/.gemini. The shared parent is not evidence of Gemini CLI.
+    if (spec.id === McpClient.GEMINI)
+        return spec.relPath;
     const parts = spec.relPath.split('/');
     return parts.length > 1 ? parts.slice(0, -1).join('/') : spec.relPath;
 }

package/dist/run.js

@@ -32,6 +32,8 @@ import { tanstackStartConnectPath } from './patch/tanstack-start.js';
 import { installedViteMajor } from './patch/vite-owning-config.js';
 /** CRA's bundled entry, in the order create-react-app itself generates them. */
 const CRA_ENTRY_CANDIDATES = ['src/index.tsx', 'src/index.jsx', 'src/index.ts', 'src/index.js'];
+/** Preview snippets must not mint a real machine credential or imply this token is usable. */
+const DRY_RUN_PAIRING_TOKEN = 'DRY_RUN_TOKEN_NOT_FOR_USE';
 function craEntryOf(io) {
     for (const path of CRA_ENTRY_CANDIDATES) {
         const source = io.readFile(path);
@@ -395,7 +397,7 @@ function gatherPlanInput(options, io, pkg) {
             : {}),
         craEntry: craEntryOf(io),
         craEnv: io.readFile(CRA_ENV_PATH),
-        pairingToken: io.host.pairingToken(),
+        pairingToken: options.dryRun ? DRY_RUN_PAIRING_TOKEN : io.host.pairingToken(),
         installSource: io.host.installSource(),
         reticleConfigExists: io.exists(RETICLE_CONFIG_FILE),
         // The CONTENT, so a config that exists can be checked rather than trusted — a `"port"` set to
@@ -737,7 +739,8 @@ function runInitSteps(options, io) {
         io.print(`${PACKAGE_JSON} is not valid JSON (${manifest.error}). Fix it and re-run — init reads the ` +
             'framework, the dev script and the package manager from it, and will not guess at any of ' +
             'them from a file it cannot read.');
-        io.host.reportOutcome({ ok: false, reason: InitFailure.MALFORMED_PACKAGE_JSON });
+        if (!options.dryRun)
+            io.host.reportOutcome({ ok: false, reason: InitFailure.MALFORMED_PACKAGE_JSON });
         return { ok: false, applied: 0, manual: 0 };
     }
     const pkgRaw = manifest.pkg;
@@ -777,6 +780,8 @@ function runInitSteps(options, io) {
     });
     if (resolved.refusal !== undefined) {
         io.print(resolved.refusal);
+        if (!options.dryRun)
+            io.host.reportOutcome({ ok: false, reason: InitFailure.PREFLIGHT });
         return { ok: false, applied: 0, manual: 1 };
     }
     // The prefix that can actually run it on THIS machine — `pnpm`, or `corepack pnpm` where preflight

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reticlehq/init",
-  "version": "3.4.0",
+  "version": "3.5.0",
   "description": "Reticle project scaffolder — detects the framework, writes the config, patches the build and registers the MCP server. The build-time half of `reticle init`.",
   "type": "module",
   "main": "./dist/index.js",
@@ -13,7 +13,7 @@
     "./package.json": "./package.json"
   },
   "dependencies": {
-    "@reticlehq/core": "3.4.0"
+    "@reticlehq/core": "3.5.0"
   },
   "license": "FSL-1.1-ALv2",
   "author": "Reticle contributors",