@reticlehq/server 2.0.0

package/dist/init/plan.js

@@ -0,0 +1,280 @@
+/**
+ * Pure assembly of the `reticle init` action plan. Given the detection result and the relevant file
+ * contents, produce an ordered list of steps — each marked apply / manual / already / skip. The
+ * runner performs the `write` side-effects; this module decides *what* should happen.
+ */
+import { Framework, installCommand, installCommandParts } from './detect.js';
+import { claudeAddCommand, mcpManual } from './mcp.js';
+import { mergeCursorConfig, CursorMergeStatus, cursorServerEntry } from './cursor.js';
+import { patchViteConfig, VitePatchKind } from './vite-config.js';
+import { viteManual, htmlManual, NEXT_LAYOUT_MANUAL, nextReticleDevFile, NEXT_RETICLE_DEV_PATH, nextConfigManual, reticleConfigContent, svelteKitHooksFile, SVELTEKIT_HOOKS_PATH, } from './snippets.js';
+// An app dev installs exactly the audience-scoped browser-side dependencies — never the retired
+// `@reticlehq/core` umbrella (which dragged the Node MCP server + ws into every app). The kit is the
+// framework adapter (it re-exports the browser sensor), paired with that framework's dev-only build
+// plugin for source mapping + connect() injection.
+const RETICLE_REACT_KIT = '@reticlehq/react';
+const RETICLE_VITE_PLUGIN = '@reticlehq/vite-plugin';
+const RETICLE_NEXT_PLUGIN = '@reticlehq/next';
+/** The dev-dependencies `reticle init` installs for a given framework — kit first, build plugin next. */
+export function frameworkPackages(framework) {
+    switch (framework) {
+        case Framework.NEXT:
+            return [RETICLE_REACT_KIT, RETICLE_NEXT_PLUGIN];
+        case Framework.VITE:
+        case Framework.SVELTEKIT:
+            // SvelteKit builds on Vite; until a dedicated Svelte kit exists it uses the Vite build plugin.
+            return [RETICLE_REACT_KIT, RETICLE_VITE_PLUGIN];
+        case Framework.HTML:
+            // No bundler plugin to install — just the kit; connect() is wired by hand (see htmlManual).
+            return [RETICLE_REACT_KIT];
+    }
+}
+const MCP_TARGET = 'global (claude user scope)';
+const RETICLE_CONFIG_FILE = '.reticle.json';
+export const StepStatus = {
+    APPLY: 'apply',
+    MANUAL: 'manual',
+    ALREADY: 'already',
+    SKIP: 'skip',
+};
+const CLAUDE_MCP_TITLE = 'MCP server (Claude, global)';
+const CURSOR_MCP_TITLE = 'MCP server (Cursor, global)';
+function claudeMcpStep(input) {
+    if (!input.claudeCli)
+        return null;
+    if (input.mcpExists) {
+        return {
+            title: CLAUDE_MCP_TITLE,
+            target: MCP_TARGET,
+            status: StepStatus.ALREADY,
+            detail: 'reticle already registered (install once, used by every project)',
+        };
+    }
+    const cmd = claudeAddCommand();
+    return {
+        title: CLAUDE_MCP_TITLE,
+        target: MCP_TARGET,
+        status: StepStatus.APPLY,
+        detail: 'register reticle globally for all projects',
+        exec: { command: cmd.command, args: cmd.args, fallback: cmd.display },
+    };
+}
+function cursorMcpStep(input) {
+    if (!input.cursorPresent)
+        return null;
+    const r = mergeCursorConfig(input.cursorConfig);
+    if (r.status === CursorMergeStatus.ALREADY) {
+        return {
+            title: CURSOR_MCP_TITLE,
+            target: input.cursorConfigPath,
+            status: StepStatus.ALREADY,
+            detail: 'reticle already in Cursor global config',
+        };
+    }
+    if (r.status === CursorMergeStatus.MANUAL) {
+        return {
+            title: CURSOR_MCP_TITLE,
+            target: input.cursorConfigPath,
+            status: StepStatus.MANUAL,
+            detail: `couldn't parse ${input.cursorConfigPath} — add this server by hand:\n  "reticle": ${JSON.stringify(cursorServerEntry())}`,
+        };
+    }
+    return {
+        title: CURSOR_MCP_TITLE,
+        target: input.cursorConfigPath,
+        status: StepStatus.APPLY,
+        detail: 'register reticle in Cursor global config',
+        write: { path: input.cursorConfigPath, content: r.content },
+    };
+}
+/** One global registration per detected agent (Claude + Cursor). Falls back to a manual note. */
+function mcpSteps(input) {
+    if (!input.options.mcp) {
+        return [
+            {
+                title: 'MCP server (global)',
+                target: MCP_TARGET,
+                status: StepStatus.SKIP,
+                detail: '--no-mcp',
+            },
+        ];
+    }
+    const steps = [claudeMcpStep(input), cursorMcpStep(input)].filter((s) => s !== null);
+    if (steps.length > 0)
+        return steps;
+    // No supported agent detected — print the one-time global instructions.
+    return [
+        {
+            title: 'MCP server (global)',
+            target: MCP_TARGET,
+            status: StepStatus.MANUAL,
+            detail: mcpManual(),
+        },
+    ];
+}
+function installStep(input) {
+    const pm = input.detection.packageManager;
+    const packages = frameworkPackages(input.detection.framework);
+    const command = installCommand(pm, packages);
+    if (!input.options.install) {
+        return {
+            title: 'Install dependencies',
+            target: 'package.json',
+            status: StepStatus.MANUAL,
+            detail: command,
+        };
+    }
+    const parts = installCommandParts(pm, packages);
+    return {
+        title: 'Install dependencies',
+        target: 'package.json',
+        status: StepStatus.APPLY,
+        detail: command,
+        exec: { command: parts.command, args: parts.args, fallback: command },
+    };
+}
+function viteSteps(input) {
+    const cfg = input.viteConfig;
+    const port = input.options.port;
+    if (cfg === null) {
+        return [
+            {
+                title: 'Vite plugin',
+                target: 'vite.config',
+                status: StepStatus.MANUAL,
+                detail: viteManual(port),
+            },
+        ];
+    }
+    const patch = patchViteConfig(cfg.source, port);
+    if (patch.kind === VitePatchKind.ALREADY) {
+        return [
+            {
+                title: 'Vite plugin',
+                target: cfg.path,
+                status: StepStatus.ALREADY,
+                detail: 'reticle() already in plugins',
+            },
+        ];
+    }
+    if (patch.kind === VitePatchKind.MANUAL) {
+        return [
+            {
+                title: 'Vite plugin',
+                target: cfg.path,
+                status: StepStatus.MANUAL,
+                detail: `${patch.reason}\n\n${viteManual(port)}`,
+            },
+        ];
+    }
+    return [
+        {
+            title: 'Vite plugin',
+            target: cfg.path,
+            status: StepStatus.APPLY,
+            detail: 'add reticle() to plugins (also injects connect())',
+            write: { path: cfg.path, content: patch.code },
+        },
+    ];
+}
+function nextSteps(input) {
+    const configFile = input.nextConfigFile ?? 'next.config.mjs';
+    const devFile = input.nextReticleDevExists
+        ? {
+            title: 'ReticleDev component',
+            target: NEXT_RETICLE_DEV_PATH,
+            status: StepStatus.ALREADY,
+            detail: 'file exists',
+        }
+        : {
+            title: 'ReticleDev component',
+            target: NEXT_RETICLE_DEV_PATH,
+            status: StepStatus.APPLY,
+            detail: 'create dev-only connect component',
+            write: {
+                path: NEXT_RETICLE_DEV_PATH,
+                content: nextReticleDevFile(input.options.port, input.options.projectId),
+            },
+        };
+    return [
+        devFile,
+        {
+            title: 'Next config (withReticle)',
+            target: configFile,
+            status: StepStatus.MANUAL,
+            detail: nextConfigManual(configFile),
+        },
+        {
+            title: 'Mount ReticleDev',
+            target: 'app/layout.tsx',
+            status: StepStatus.MANUAL,
+            detail: NEXT_LAYOUT_MANUAL,
+        },
+    ];
+}
+function svelteKitSteps(input) {
+    // SvelteKit can't use the Vite-plugin injection (renders via app.html) — wire a client hook that
+    // SvelteKit runs on startup. This is verified to register a session where the plugin does not.
+    if (input.svelteKitHooksExists === true) {
+        return [
+            {
+                title: 'Reticle client hook',
+                target: SVELTEKIT_HOOKS_PATH,
+                status: StepStatus.ALREADY,
+                detail: 'file exists',
+            },
+        ];
+    }
+    return [
+        {
+            title: 'Reticle client hook',
+            target: SVELTEKIT_HOOKS_PATH,
+            status: StepStatus.APPLY,
+            detail: 'create dev-only client connect (SvelteKit renders via app.html)',
+            write: {
+                path: SVELTEKIT_HOOKS_PATH,
+                content: svelteKitHooksFile(input.options.port, input.options.projectId),
+            },
+        },
+    ];
+}
+function reticleConfigStep(input) {
+    if (input.reticleConfigExists === true) {
+        return {
+            title: 'Reticle config',
+            target: RETICLE_CONFIG_FILE,
+            status: StepStatus.ALREADY,
+            detail: '.reticle.json already exists',
+        };
+    }
+    const content = reticleConfigContent(input.detection.framework, input.options.port, input.options.projectId);
+    return {
+        title: 'Reticle config',
+        target: RETICLE_CONFIG_FILE,
+        status: StepStatus.APPLY,
+        detail: 'write project config (framework + port)',
+        write: { path: RETICLE_CONFIG_FILE, content },
+    };
+}
+export function buildPlan(input) {
+    const steps = [...mcpSteps(input), installStep(input), reticleConfigStep(input)];
+    if (input.detection.framework === Framework.VITE) {
+        steps.push(...viteSteps(input));
+    }
+    else if (input.detection.framework === Framework.NEXT) {
+        steps.push(...nextSteps(input));
+    }
+    else if (input.detection.framework === Framework.SVELTEKIT) {
+        steps.push(...svelteKitSteps(input));
+    }
+    else {
+        steps.push({
+            title: 'Connect snippet',
+            target: 'index.html',
+            status: StepStatus.MANUAL,
+            detail: htmlManual(input.options.port, input.options.projectId),
+        });
+    }
+    return { framework: input.detection.framework, steps };
+}
+//# sourceMappingURL=plan.js.map

package/dist/init/plan.js.map

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

package/dist/init/project-id.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Project-identity derivation for `reticle init` — the Next/HTML/.reticle.json side of the same scheme the
+ * Vite plugin uses at build time. Kept algorithmically identical (slug of package.json name + 8-char
+ * hash of the absolute root) so a Vite app's plugin-stamped projectId matches what init records.
+ */
+/** `@acme/web` → `acme-web`; non-alphanumerics collapse to single dashes; edges trimmed. */
+export declare function slugifyPackageName(name: string): string;
+/** Short, stable hex fingerprint of the absolute project root. */
+export declare function shortHash(input: string): string;
+/**
+ * Derive the stable projectId from the package name (may be undefined) and the absolute root path.
+ * Falls back to the root folder name, then "app". Pure.
+ */
+export declare function deriveProjectId(pkgName: string | undefined, rootPath: string): string;
+/** Pull a string `name` out of an already-parsed package.json object, or undefined. */
+export declare function packageName(pkg: unknown): string | undefined;
+//# sourceMappingURL=project-id.d.ts.map

package/dist/init/project-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-id.d.ts","sourceRoot":"","sources":["../../src/init/project-id.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,4FAA4F;AAC5F,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMvD;AAED,kEAAkE;AAClE,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAIrF;AAED,uFAAuF;AACvF,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAM5D"}

package/dist/init/project-id.js

@@ -0,0 +1,38 @@
+/**
+ * Project-identity derivation for `reticle init` — the Next/HTML/.reticle.json side of the same scheme the
+ * Vite plugin uses at build time. Kept algorithmically identical (slug of package.json name + 8-char
+ * hash of the absolute root) so a Vite app's plugin-stamped projectId matches what init records.
+ */
+import { createHash } from 'node:crypto';
+import { basename } from 'node:path';
+/** `@acme/web` → `acme-web`; non-alphanumerics collapse to single dashes; edges trimmed. */
+export function slugifyPackageName(name) {
+    return name
+        .toLowerCase()
+        .replace(/^@/, '')
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '');
+}
+/** Short, stable hex fingerprint of the absolute project root. */
+export function shortHash(input) {
+    return createHash('sha1').update(input).digest('hex').slice(0, 8);
+}
+/**
+ * Derive the stable projectId from the package name (may be undefined) and the absolute root path.
+ * Falls back to the root folder name, then "app". Pure.
+ */
+export function deriveProjectId(pkgName, rootPath) {
+    const fromName = pkgName !== undefined ? slugifyPackageName(pkgName) : '';
+    const base = fromName.length > 0 ? fromName : slugifyPackageName(basename(rootPath)) || 'app';
+    return `${base}-${shortHash(rootPath)}`;
+}
+/** Pull a string `name` out of an already-parsed package.json object, or undefined. */
+export function packageName(pkg) {
+    if (typeof pkg === 'object' && pkg !== null) {
+        const name = pkg['name'];
+        if (typeof name === 'string' && name.length > 0)
+            return name;
+    }
+    return undefined;
+}
+//# sourceMappingURL=project-id.js.map

package/dist/init/project-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-id.js","sourceRoot":"","sources":["../../src/init/project-id.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAErC,4FAA4F;AAC5F,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,OAAO,IAAI;SACR,WAAW,EAAE;SACb,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;SACjB,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;AAC7B,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,SAAS,CAAC,KAAa;IACrC,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AACpE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,OAA2B,EAAE,QAAgB;IAC3E,MAAM,QAAQ,GAAG,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC1E,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,kBAAkB,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,IAAI,KAAK,CAAC;IAC9F,OAAO,GAAG,IAAI,IAAI,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC;AAC1C,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,WAAW,CAAC,GAAY;IACtC,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QAC5C,MAAM,IAAI,GAAI,GAA+B,CAAC,MAAM,CAAC,CAAC;QACtD,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC;IAC/D,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/init/run.d.ts

@@ -0,0 +1,42 @@
+/**
+ * The impure shell for `reticle init`: gather project files via an injected IO surface, build the
+ * plan (pure), optionally write the apply-steps, and print a human-readable report. All filesystem
+ * access goes through `InitIo` so the orchestration is unit-testable with an in-memory IO.
+ */
+/**
+ * Resolve the lockfiles set used to pick the package manager. A lockfile in the project root wins;
+ * otherwise we walk UP the directory tree (monorepos keep the lockfile at the workspace root, not in
+ * each package) so `reticle init` in a sub-package suggests `pnpm add` instead of defaulting to `npm i`.
+ */
+export declare function resolveLockfiles(rootFiles: ReadonlySet<string>, cwd: string, io: Pick<InitIo, 'exists'>): Set<string>;
+export interface InitOptions {
+    cwd: string;
+    port: number | undefined;
+    mcp: boolean;
+    dryRun: boolean;
+    install: boolean;
+}
+export interface InitIo {
+    /** Returns file content or null if it does not exist. Path is project-relative or absolute. */
+    readFile(relPath: string): string | null;
+    /** Writes content, creating parent directories. Path is project-relative or absolute. */
+    writeFile(relPath: string, content: string): void;
+    exists(relPath: string): boolean;
+    /** The user's home directory (for global agent config like ~/.cursor/mcp.json). */
+    homeDir(): string;
+    /** Basenames present in the project root. */
+    rootFiles(): readonly string[];
+    /** Runs a subprocess to completion (inherits stdio); returns true on exit code 0. */
+    exec(command: string, args: readonly string[]): boolean;
+    /** Runs a subprocess quietly (no stdio) for a yes/no check; returns true on exit code 0. */
+    probe(command: string, args: readonly string[]): boolean;
+    print(line: string): void;
+}
+interface InitResult {
+    ok: boolean;
+    applied: number;
+    manual: number;
+}
+export declare function runInit(options: InitOptions, io: InitIo): InitResult;
+export {};
+//# sourceMappingURL=run.d.ts.map

package/dist/init/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/init/run.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAkBH;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,WAAW,CAAC,MAAM,CAAC,EAC9B,GAAG,EAAE,MAAM,EACX,EAAE,EAAE,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,GACzB,GAAG,CAAC,MAAM,CAAC,CAgBb;AAkBD,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,GAAG,EAAE,OAAO,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,MAAM;IACrB,+FAA+F;IAC/F,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IACzC,yFAAyF;IACzF,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAClD,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;IACjC,mFAAmF;IACnF,OAAO,IAAI,MAAM,CAAC;IAClB,6CAA6C;IAC7C,SAAS,IAAI,SAAS,MAAM,EAAE,CAAC;IAC/B,qFAAqF;IACrF,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC;IACxD,4FAA4F;IAC5F,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC;IACzD,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,UAAU,UAAU;IAClB,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AA4GD,wBAAgB,OAAO,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE,MAAM,GAAG,UAAU,CAUpE"}

package/dist/init/run.js

@@ -0,0 +1,171 @@
+/**
+ * The impure shell for `reticle init`: gather project files via an injected IO surface, build the
+ * plan (pure), optionally write the apply-steps, and print a human-readable report. All filesystem
+ * access goes through `InitIo` so the orchestration is unit-testable with an in-memory IO.
+ */
+import { dirname, join } from 'node:path';
+import { detect, Framework } from './detect.js';
+import { buildPlan, StepStatus } from './plan.js';
+import { claudeAvailableProbe, claudeExistsProbe } from './mcp.js';
+import { CURSOR_DIR_RELPATH, CURSOR_MCP_RELPATH } from './cursor.js';
+import { deriveProjectId, packageName } from './project-id.js';
+/** Lockfile basenames, in package-manager preference order (mirrors detect.ts). */
+const LOCKFILE_NAMES = [
+    'pnpm-lock.yaml',
+    'yarn.lock',
+    'bun.lockb',
+    'bun.lock',
+    'package-lock.json',
+];
+/**
+ * Resolve the lockfiles set used to pick the package manager. A lockfile in the project root wins;
+ * otherwise we walk UP the directory tree (monorepos keep the lockfile at the workspace root, not in
+ * each package) so `reticle init` in a sub-package suggests `pnpm add` instead of defaulting to `npm i`.
+ */
+export function resolveLockfiles(rootFiles, cwd, io) {
+    const set = new Set(rootFiles);
+    if (LOCKFILE_NAMES.some((name) => set.has(name)))
+        return set; // local lockfile is authoritative
+    let dir = cwd;
+    for (let depth = 0; depth < 50; depth++) {
+        for (const name of LOCKFILE_NAMES) {
+            if (io.exists(join(dir, name))) {
+                set.add(name);
+                return set;
+            }
+        }
+        const parent = dirname(dir);
+        if (parent === dir)
+            break; // filesystem root
+        dir = parent;
+    }
+    return set;
+}
+const PACKAGE_JSON = 'package.json';
+const NEXT_RETICLE_DEV = 'app/reticle-dev.tsx';
+const SVELTEKIT_HOOKS = 'src/hooks.client.ts';
+const VITE_CONFIG_CANDIDATES = [
+    'vite.config.ts',
+    'vite.config.js',
+    'vite.config.mjs',
+    'vite.config.mts',
+];
+const NEXT_CONFIG_CANDIDATES = [
+    'next.config.mjs',
+    'next.config.js',
+    'next.config.ts',
+    'next.config.cjs',
+];
+const STATUS_SYMBOL = {
+    [StepStatus.APPLY]: '✓',
+    [StepStatus.MANUAL]: '⚠',
+    [StepStatus.ALREADY]: '·',
+    [StepStatus.SKIP]: '–',
+};
+function firstPresent(files, candidates) {
+    for (const c of candidates)
+        if (files.has(c))
+            return c;
+    return null;
+}
+function gatherPlanInput(options, io, pkgRaw) {
+    const pkg = JSON.parse(pkgRaw);
+    // Stable identity derived from the app's package.json name + root, so it survives port changes.
+    const projectId = deriveProjectId(packageName(pkg), options.cwd);
+    const rootFiles = new Set(io.rootFiles());
+    const detectInput = {
+        pkg: typeof pkg === 'object' && pkg !== null ? pkg : {},
+        configFiles: rootFiles,
+        // Walk up for the lockfile so a monorepo sub-package picks the workspace's package manager.
+        lockfiles: resolveLockfiles(rootFiles, options.cwd, io),
+    };
+    const detection = detect(detectInput);
+    const vitePath = firstPresent(rootFiles, VITE_CONFIG_CANDIDATES);
+    const viteSource = vitePath === null ? null : io.readFile(vitePath);
+    const viteConfig = vitePath !== null && viteSource !== null ? { path: vitePath, source: viteSource } : null;
+    // Global MCP registration targets each agent that's present: Claude via its CLI, Cursor via its
+    // global config file. Only probe when the MCP step is in play.
+    const availableProbe = claudeAvailableProbe();
+    const claudeCli = options.mcp ? io.probe(availableProbe.command, availableProbe.args) : false;
+    const existsProbe = claudeExistsProbe();
+    const mcpExists = claudeCli ? io.probe(existsProbe.command, existsProbe.args) : false;
+    const cursorDir = `${io.homeDir()}/${CURSOR_DIR_RELPATH}`;
+    const cursorConfigPath = `${io.homeDir()}/${CURSOR_MCP_RELPATH}`;
+    const cursorPresent = options.mcp && io.exists(cursorDir);
+    const cursorConfig = cursorPresent ? io.readFile(cursorConfigPath) : null;
+    return {
+        detection,
+        claudeCli,
+        mcpExists,
+        cursorPresent,
+        cursorConfig,
+        cursorConfigPath,
+        viteConfig,
+        nextConfigFile: firstPresent(rootFiles, NEXT_CONFIG_CANDIDATES),
+        nextReticleDevExists: io.exists(NEXT_RETICLE_DEV),
+        svelteKitHooksExists: io.exists(SVELTEKIT_HOOKS),
+        reticleConfigExists: io.exists('.reticle.json'),
+        options: { port: options.port, mcp: options.mcp, install: options.install, projectId },
+    };
+}
+function restartHint(framework) {
+    if (framework === Framework.NEXT)
+        return 'Restart `next dev`, then ask your agent: "List Reticle sessions".';
+    if (framework === Framework.VITE)
+        return 'Restart `vite`, then ask your agent: "List Reticle sessions".';
+    if (framework === Framework.SVELTEKIT)
+        return 'Restart your dev server (`npm run dev`), then ask your agent: "List Reticle sessions".';
+    return 'Reload your app on localhost, then ask your agent: "List Reticle sessions".';
+}
+function report(plan, dryRun, failed, io) {
+    io.print(dryRun ? 'reticle init (dry run — no files written)' : 'reticle init');
+    io.print('');
+    let applied = 0;
+    let manual = 0;
+    for (const s of plan.steps) {
+        // A side effect that failed to apply is reported as a manual step with its fallback command.
+        const downgraded = failed.has(s.target);
+        const status = downgraded ? StepStatus.MANUAL : s.status;
+        const detail = downgraded && s.exec !== undefined
+            ? `step failed — run manually: ${s.exec.fallback}`
+            : s.detail;
+        io.print(`  [${STATUS_SYMBOL[status]}] ${s.title} → ${s.target}`);
+        if (status === StepStatus.APPLY)
+            applied++;
+        if (status === StepStatus.MANUAL) {
+            manual++;
+            for (const line of detail.split('\n'))
+                io.print(`      ${line}`);
+        }
+        else if (detail.length > 0) {
+            io.print(`      ${detail}`);
+        }
+    }
+    io.print('');
+    io.print(restartHint(plan.framework));
+    return { ok: true, applied, manual };
+}
+/** Perform the apply-step side effects; return the targets whose side effect failed. */
+function applyEffects(plan, io) {
+    const failed = new Set();
+    for (const s of plan.steps) {
+        if (s.status !== StepStatus.APPLY)
+            continue;
+        if (s.write !== undefined)
+            io.writeFile(s.write.path, s.write.content);
+        if (s.exec !== undefined && !io.exec(s.exec.command, s.exec.args))
+            failed.add(s.target);
+    }
+    return failed;
+}
+export function runInit(options, io) {
+    const pkgRaw = io.readFile(PACKAGE_JSON);
+    if (pkgRaw === null) {
+        io.print('No package.json found. Run `reticle init` from your project root.');
+        return { ok: false, applied: 0, manual: 0 };
+    }
+    const plan = buildPlan(gatherPlanInput(options, io, pkgRaw));
+    const failed = options.dryRun ? new Set() : applyEffects(plan, io);
+    return report(plan, options.dryRun, failed, io);
+}
+//# sourceMappingURL=run.js.map

package/dist/init/run.js.map

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

package/dist/init/snippets.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Generated file contents and copy-paste snippets for `reticle init`. Kept as named constants/builders
+ * so the runner never inlines free strings.
+ */
+/** The Vite-config snippet printed when we can't safely auto-patch the config. */
+export declare function viteManual(port: number | undefined): string;
+/** Next.js config wrap — always printed (we never auto-rewrite next.config). */
+export declare function nextConfigManual(configFile: string): string;
+/** The dev-only client component that connects Reticle after hydration. */
+export declare function nextReticleDevFile(port: number | undefined, projectId?: string): string;
+/** Mount instruction for the root layout. */
+export declare const NEXT_LAYOUT_MANUAL = "Mount <ReticleDev /> in your root layout (app/layout.tsx), dev-only:\n\n  import { ReticleDev } from './reticle-dev';\n  // inside <body>:\n  {process.env.NODE_ENV === 'development' ? <ReticleDev /> : null}";
+/**
+ * Manual connect guidance for projects without a Vite/Next plugin. Most such projects still use a
+ * BUNDLER (CRA, webpack, Parcel, Vue/Svelte CLIs) — for those, the connect goes in the entry MODULE,
+ * where a bare `@reticlehq/react` import resolves. A bare import in a plain index.html does NOT resolve in
+ * the browser, so we never tell a bundled app to do that (the old advice silently failed for CRA).
+ */
+export declare function htmlManual(port: number | undefined, projectId?: string): string;
+export declare const NEXT_RETICLE_DEV_PATH = "app/reticle-dev.tsx";
+export declare const SVELTEKIT_HOOKS_PATH = "src/hooks.client.ts";
+/**
+ * Dev-only client hook that connects Reticle in a SvelteKit app. SvelteKit renders through app.html and
+ * never triggers Vite's index.html injection (verified), so the standard plugin can't auto-connect —
+ * a client hook is the reliable path. SvelteKit runs src/hooks.client.ts on the client at startup.
+ */
+export declare function svelteKitHooksFile(port: number | undefined, projectId?: string): string;
+/**
+ * Root-level project config for Reticle. Written by `reticle init`; read by `reticle mcp` for the port
+ * and by tooling for the stable projectId (the app's identity across port changes).
+ */
+export declare function reticleConfigContent(framework: string, port: number | undefined, projectId?: string): string;
+//# sourceMappingURL=snippets.d.ts.map

package/dist/init/snippets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snippets.d.ts","sourceRoot":"","sources":["../../src/init/snippets.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAiBH,kFAAkF;AAClF,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAW3D;AAED,gFAAgF;AAChF,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAM3D;AAED,2EAA2E;AAC3E,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAgBvF;AAED,6CAA6C;AAC7C,eAAO,MAAM,kBAAkB,mNAIoC,CAAC;AAEpE;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAgB/E;AAED,eAAO,MAAM,qBAAqB,wBAAwB,CAAC;AAC3D,eAAO,MAAM,oBAAoB,wBAAwB,CAAC;AAE1D;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAUvF;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,SAAS,CAAC,EAAE,MAAM,GACjB,MAAM,CAKR"}