@reticlehq/server 2.0.0

package/dist/init/detect.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Pure framework + toolchain detection for `reticle init`. No filesystem access — callers pass in
+ * the parsed package.json and the set of config/lock filenames present in the project root.
+ */
+export declare const Framework: {
+    readonly NEXT: "next";
+    readonly VITE: "vite";
+    readonly SVELTEKIT: "sveltekit";
+    readonly HTML: "html";
+};
+export type Framework = (typeof Framework)[keyof typeof Framework];
+export declare const PackageManager: {
+    readonly PNPM: "pnpm";
+    readonly YARN: "yarn";
+    readonly BUN: "bun";
+    readonly NPM: "npm";
+};
+export type PackageManager = (typeof PackageManager)[keyof typeof PackageManager];
+interface PackageJsonLike {
+    dependencies?: Record<string, string>;
+    devDependencies?: Record<string, string>;
+    peerDependencies?: Record<string, string>;
+}
+export interface DetectInput {
+    pkg: PackageJsonLike;
+    /** Basenames of config files present in the project root (e.g. 'next.config.mjs'). */
+    configFiles: ReadonlySet<string>;
+    /** Lockfile basenames present in the project root. */
+    lockfiles: ReadonlySet<string>;
+}
+export interface Detection {
+    framework: Framework;
+    reactMajor: number | undefined;
+    /** React 19 dropped _debugSource, so it needs the build-time source-map stamp. */
+    needsSourceMapping: boolean;
+    packageManager: PackageManager;
+}
+/** Extract the leading major version from a semver range like "^19.0.0" or "19.1.1". */
+export declare function parseMajor(range: string | undefined): number | undefined;
+export declare function detect(input: DetectInput): Detection;
+interface InstallCommand {
+    command: string;
+    args: string[];
+}
+/** Build a dev-dependency install command for one or more packages (e.g. the kit + its build plugin). */
+export declare function installCommandParts(pm: PackageManager, pkgs: string | readonly string[]): InstallCommand;
+export declare function installCommand(pm: PackageManager, pkgs: string | readonly string[]): string;
+export {};
+//# sourceMappingURL=detect.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"detect.d.ts","sourceRoot":"","sources":["../../src/init/detect.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,eAAO,MAAM,SAAS;;;;;CAKZ,CAAC;AACX,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,OAAO,SAAS,CAAC,CAAC;AAEnE,eAAO,MAAM,cAAc;;;;;CAKjB,CAAC;AACX,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,OAAO,cAAc,CAAC,CAAC;AAElF,UAAU,eAAe;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC3C;AAED,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,eAAe,CAAC;IACrB,sFAAsF;IACtF,WAAW,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACjC,sDAAsD;IACtD,SAAS,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,SAAS,CAAC;IACrB,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,kFAAkF;IAClF,kBAAkB,EAAE,OAAO,CAAC;IAC5B,cAAc,EAAE,cAAc,CAAC;CAChC;AAcD,wFAAwF;AACxF,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAMxE;AAyBD,wBAAgB,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,SAAS,CAQpD;AASD,UAAU,cAAc;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,yGAAyG;AACzG,wBAAgB,mBAAmB,CACjC,EAAE,EAAE,cAAc,EAClB,IAAI,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,GAC/B,cAAc,CAGhB;AAED,wBAAgB,cAAc,CAAC,EAAE,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,GAAG,MAAM,CAG3F"}

package/dist/init/detect.js

@@ -0,0 +1,84 @@
+/**
+ * Pure framework + toolchain detection for `reticle init`. No filesystem access — callers pass in
+ * the parsed package.json and the set of config/lock filenames present in the project root.
+ */
+export const Framework = {
+    NEXT: 'next',
+    VITE: 'vite',
+    SVELTEKIT: 'sveltekit',
+    HTML: 'html',
+};
+export const PackageManager = {
+    PNPM: 'pnpm',
+    YARN: 'yarn',
+    BUN: 'bun',
+    NPM: 'npm',
+};
+const NEXT_CONFIGS = ['next.config.js', 'next.config.mjs', 'next.config.ts', 'next.config.cjs'];
+const VITE_CONFIGS = ['vite.config.js', 'vite.config.ts', 'vite.config.mjs', 'vite.config.mts'];
+const SVELTE_CONFIGS = ['svelte.config.js', 'svelte.config.ts', 'svelte.config.mjs'];
+function depVersion(pkg, name) {
+    return pkg.dependencies?.[name] ?? pkg.devDependencies?.[name] ?? pkg.peerDependencies?.[name];
+}
+function hasAnyConfig(files, candidates) {
+    return candidates.some((c) => files.has(c));
+}
+/** Extract the leading major version from a semver range like "^19.0.0" or "19.1.1". */
+export function parseMajor(range) {
+    if (range === undefined)
+        return undefined;
+    const match = range.match(/(\d+)/);
+    if (match === null || match[1] === undefined)
+        return undefined;
+    const major = parseInt(match[1], 10);
+    return isNaN(major) ? undefined : major;
+}
+function detectPackageManager(lockfiles) {
+    if (lockfiles.has('pnpm-lock.yaml'))
+        return PackageManager.PNPM;
+    if (lockfiles.has('yarn.lock'))
+        return PackageManager.YARN;
+    if (lockfiles.has('bun.lockb') || lockfiles.has('bun.lock'))
+        return PackageManager.BUN;
+    return PackageManager.NPM;
+}
+function detectFramework(input) {
+    const { pkg, configFiles } = input;
+    if (depVersion(pkg, 'next') !== undefined || hasAnyConfig(configFiles, NEXT_CONFIGS)) {
+        return Framework.NEXT;
+    }
+    // SvelteKit is Vite-based but renders through app.html, so the Vite plugin's index.html injection
+    // never fires (verified) — it needs a manual client connect. Check BEFORE the generic Vite branch.
+    if (depVersion(pkg, '@sveltejs/kit') !== undefined || hasAnyConfig(configFiles, SVELTE_CONFIGS)) {
+        return Framework.SVELTEKIT;
+    }
+    if (depVersion(pkg, 'vite') !== undefined || hasAnyConfig(configFiles, VITE_CONFIGS)) {
+        return Framework.VITE;
+    }
+    return Framework.HTML;
+}
+export function detect(input) {
+    const reactMajor = parseMajor(depVersion(input.pkg, 'react'));
+    return {
+        framework: detectFramework(input),
+        reactMajor,
+        needsSourceMapping: reactMajor !== undefined && reactMajor >= 19,
+        packageManager: detectPackageManager(input.lockfiles),
+    };
+}
+const INSTALL_ARGS = {
+    [PackageManager.PNPM]: ['add', '-D'],
+    [PackageManager.YARN]: ['add', '-D'],
+    [PackageManager.BUN]: ['add', '-d'],
+    [PackageManager.NPM]: ['i', '-D'],
+};
+/** Build a dev-dependency install command for one or more packages (e.g. the kit + its build plugin). */
+export function installCommandParts(pm, pkgs) {
+    const list = typeof pkgs === 'string' ? [pkgs] : pkgs;
+    return { command: pm, args: [...INSTALL_ARGS[pm], ...list] };
+}
+export function installCommand(pm, pkgs) {
+    const { command, args } = installCommandParts(pm, pkgs);
+    return `${command} ${args.join(' ')}`;
+}
+//# sourceMappingURL=detect.js.map

package/dist/init/detect.js.map

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

package/dist/init/mcp.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Global (user-scope) MCP registration for `reticle init`. The bridge + MCP server is a single
+ * process that serves every project, so it is registered ONCE at user scope — not per-project via
+ * a checked-in `.mcp.json`. We shell out to the official `claude mcp add -s user` CLI rather than
+ * hand-editing `~/.claude.json` (a large stateful file). When the `claude` CLI is absent we print a
+ * manual instruction instead.
+ *
+ * The registration is intentionally PORTLESS — `npx @reticlehq/server mcp`, never `--port N`. A single
+ * global entry serves every project, so baking a port into it would pin every project to one port
+ * and defeat per-project isolation. Instead `reticle mcp` resolves the port at runtime from the
+ * project's `.reticle.json` in its CWD (see cli-port.ts). The port belongs to the project, not the
+ * global agent config.
+ */
+export declare const MCP_SERVER_NAME = "reticle";
+export declare const NPX = "npx";
+/** Args after `npx` that launch the bridge: `@reticlehq/server mcp`. Portless — the port comes from
+ * the project's `.reticle.json` at runtime, so one global entry works for every project. */
+export declare function npxServerArgs(): string[];
+interface ClaudeAddCommand {
+    command: string;
+    args: string[];
+    /** Human-readable form of the same command, for reports and manual fallback. */
+    display: string;
+}
+/** `claude mcp add reticle -s user -- npx @reticlehq/server mcp` — registers globally for all projects (portless). */
+export declare function claudeAddCommand(): ClaudeAddCommand;
+/** Probe args that tell us whether an `reticle` server already exists in any scope (exit 0 = exists). */
+export declare function claudeExistsProbe(): {
+    command: string;
+    args: string[];
+};
+/** Probe args for whether the `claude` CLI is installed at all. */
+export declare function claudeAvailableProbe(): {
+    command: string;
+    args: string[];
+};
+/** Printed when the `claude` CLI isn't available — register Reticle globally once, by hand. */
+export declare function mcpManual(): string;
+export {};
+//# sourceMappingURL=mcp.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../src/init/mcp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,eAAO,MAAM,eAAe,YAAY,CAAC;AACzC,eAAO,MAAM,GAAG,QAAQ,CAAC;AAOzB;4FAC4F;AAC5F,wBAAgB,aAAa,IAAI,MAAM,EAAE,CAExC;AAOD,UAAU,gBAAgB;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,gFAAgF;IAChF,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,sHAAsH;AACtH,wBAAgB,gBAAgB,IAAI,gBAAgB,CAInD;AAED,yGAAyG;AACzG,wBAAgB,iBAAiB,IAAI;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAEvE;AAED,mEAAmE;AACnE,wBAAgB,oBAAoB,IAAI;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAE1E;AAED,+FAA+F;AAC/F,wBAAgB,SAAS,IAAI,MAAM,CASlC"}

package/dist/init/mcp.js

@@ -0,0 +1,55 @@
+/**
+ * Global (user-scope) MCP registration for `reticle init`. The bridge + MCP server is a single
+ * process that serves every project, so it is registered ONCE at user scope — not per-project via
+ * a checked-in `.mcp.json`. We shell out to the official `claude mcp add -s user` CLI rather than
+ * hand-editing `~/.claude.json` (a large stateful file). When the `claude` CLI is absent we print a
+ * manual instruction instead.
+ *
+ * The registration is intentionally PORTLESS — `npx @reticlehq/server mcp`, never `--port N`. A single
+ * global entry serves every project, so baking a port into it would pin every project to one port
+ * and defeat per-project isolation. Instead `reticle mcp` resolves the port at runtime from the
+ * project's `.reticle.json` in its CWD (see cli-port.ts). The port belongs to the project, not the
+ * global agent config.
+ */
+export const MCP_SERVER_NAME = 'reticle';
+export const NPX = 'npx';
+// The `reticle` bin lives in @reticlehq/server, so `npx @reticlehq/server mcp` runs the bridge
+// without the retired `core` umbrella. `npx @reticlehq/server` resolves its sole bin (`reticle`).
+const RETICLE_PACKAGE = '@reticlehq/server';
+const MCP_SUBCOMMAND = 'mcp';
+const CLAUDE_CLI = 'claude';
+/** Args after `npx` that launch the bridge: `@reticlehq/server mcp`. Portless — the port comes from
+ * the project's `.reticle.json` at runtime, so one global entry works for every project. */
+export function npxServerArgs() {
+    return [RETICLE_PACKAGE, MCP_SUBCOMMAND];
+}
+/** The full `npx …` invocation — the tail after `claude mcp add … --`. */
+function serverInvocation() {
+    return [NPX, ...npxServerArgs()];
+}
+/** `claude mcp add reticle -s user -- npx @reticlehq/server mcp` — registers globally for all projects (portless). */
+export function claudeAddCommand() {
+    const tail = serverInvocation();
+    const args = [MCP_SUBCOMMAND, 'add', MCP_SERVER_NAME, '-s', 'user', '--', ...tail];
+    return { command: CLAUDE_CLI, args, display: `${CLAUDE_CLI} ${args.join(' ')}` };
+}
+/** Probe args that tell us whether an `reticle` server already exists in any scope (exit 0 = exists). */
+export function claudeExistsProbe() {
+    return { command: CLAUDE_CLI, args: [MCP_SUBCOMMAND, 'get', MCP_SERVER_NAME] };
+}
+/** Probe args for whether the `claude` CLI is installed at all. */
+export function claudeAvailableProbe() {
+    return { command: CLAUDE_CLI, args: ['--version'] };
+}
+/** Printed when the `claude` CLI isn't available — register Reticle globally once, by hand. */
+export function mcpManual() {
+    const tail = serverInvocation().join(' ');
+    return `Register the Reticle MCP server ONCE, globally (so every project gets it):
+
+  ${CLAUDE_CLI} ${MCP_SUBCOMMAND} add ${MCP_SERVER_NAME} -s user -- ${tail}
+
+Or, for another agent, add this to its global MCP config (e.g. Cursor's ~/.cursor/mcp.json):
+
+  "${MCP_SERVER_NAME}": { "command": "${NPX}", "args": ${JSON.stringify(serverInvocation().slice(1))} }`;
+}
+//# sourceMappingURL=mcp.js.map

package/dist/init/mcp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../../src/init/mcp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,CAAC,MAAM,eAAe,GAAG,SAAS,CAAC;AACzC,MAAM,CAAC,MAAM,GAAG,GAAG,KAAK,CAAC;AACzB,+FAA+F;AAC/F,kGAAkG;AAClG,MAAM,eAAe,GAAG,mBAAmB,CAAC;AAC5C,MAAM,cAAc,GAAG,KAAK,CAAC;AAC7B,MAAM,UAAU,GAAG,QAAQ,CAAC;AAE5B;4FAC4F;AAC5F,MAAM,UAAU,aAAa;IAC3B,OAAO,CAAC,eAAe,EAAE,cAAc,CAAC,CAAC;AAC3C,CAAC;AAED,0EAA0E;AAC1E,SAAS,gBAAgB;IACvB,OAAO,CAAC,GAAG,EAAE,GAAG,aAAa,EAAE,CAAC,CAAC;AACnC,CAAC;AASD,sHAAsH;AACtH,MAAM,UAAU,gBAAgB;IAC9B,MAAM,IAAI,GAAG,gBAAgB,EAAE,CAAC;IAChC,MAAM,IAAI,GAAG,CAAC,cAAc,EAAE,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,CAAC;IACnF,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,UAAU,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;AACnF,CAAC;AAED,yGAAyG;AACzG,MAAM,UAAU,iBAAiB;IAC/B,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,cAAc,EAAE,KAAK,EAAE,eAAe,CAAC,EAAE,CAAC;AACjF,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,oBAAoB;IAClC,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,WAAW,CAAC,EAAE,CAAC;AACtD,CAAC;AAED,+FAA+F;AAC/F,MAAM,UAAU,SAAS;IACvB,MAAM,IAAI,GAAG,gBAAgB,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC1C,OAAO;;IAEL,UAAU,IAAI,cAAc,QAAQ,eAAe,eAAe,IAAI;;;;KAIrE,eAAe,oBAAoB,GAAG,cAAc,IAAI,CAAC,SAAS,CAAC,gBAAgB,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACzG,CAAC"}

package/dist/init/node-io.d.ts

@@ -0,0 +1,8 @@
+/**
+ * The real (Node filesystem) implementation of `InitIo`. Kept separate from the pure runner so
+ * `runInit` stays testable with an in-memory IO. Prints to stdout — `init` is a one-shot CLI
+ * command, not the MCP stdio transport.
+ */
+import type { InitIo } from './run.js';
+export declare function buildNodeIo(cwd: string): InitIo;
+//# sourceMappingURL=node-io.d.ts.map

package/dist/init/node-io.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-io.d.ts","sourceRoot":"","sources":["../../src/init/node-io.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAEvC,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CA4C/C"}

package/dist/init/node-io.js

@@ -0,0 +1,57 @@
+/**
+ * The real (Node filesystem) implementation of `InitIo`. Kept separate from the pure runner so
+ * `runInit` stays testable with an in-memory IO. Prints to stdout — `init` is a one-shot CLI
+ * command, not the MCP stdio transport.
+ */
+import { readFileSync, writeFileSync, existsSync, mkdirSync, readdirSync, statSync } from 'node:fs';
+import { join, dirname, isAbsolute } from 'node:path';
+import { homedir } from 'node:os';
+import { spawnSync } from 'node:child_process';
+export function buildNodeIo(cwd) {
+    // Project-relative by default; absolute paths (e.g. ~/.cursor/mcp.json) pass through unchanged.
+    const abs = (rel) => (isAbsolute(rel) ? rel : join(cwd, rel));
+    return {
+        readFile(rel) {
+            const path = abs(rel);
+            if (!existsSync(path))
+                return null;
+            return readFileSync(path, 'utf8');
+        },
+        writeFile(rel, content) {
+            const path = abs(rel);
+            mkdirSync(dirname(path), { recursive: true });
+            writeFileSync(path, content, 'utf8');
+        },
+        exists(rel) {
+            return existsSync(abs(rel));
+        },
+        homeDir() {
+            return homedir();
+        },
+        rootFiles() {
+            return readdirSync(cwd).filter((name) => {
+                try {
+                    return statSync(join(cwd, name)).isFile();
+                }
+                catch {
+                    return false;
+                }
+            });
+        },
+        exec(command, args) {
+            // `shell: true` lets package-manager shims (pnpm.cmd, etc.) resolve on Windows; inherit
+            // stdio so the install's own progress is visible to the user.
+            const result = spawnSync(command, [...args], { cwd, stdio: 'inherit', shell: true });
+            return result.status === 0;
+        },
+        probe(command, args) {
+            // Quiet yes/no check (CLI availability, existing registration). Never throws.
+            const result = spawnSync(command, [...args], { cwd, stdio: 'ignore', shell: true });
+            return result.status === 0;
+        },
+        print(line) {
+            process.stdout.write(`${line}\n`);
+        },
+    };
+}
+//# sourceMappingURL=node-io.js.map

package/dist/init/node-io.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-io.js","sourceRoot":"","sources":["../../src/init/node-io.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACpG,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACtD,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAG/C,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,gGAAgG;IAChG,MAAM,GAAG,GAAG,CAAC,GAAW,EAAU,EAAE,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;IAC9E,OAAO;QACL,QAAQ,CAAC,GAAG;YACV,MAAM,IAAI,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;YACtB,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;gBAAE,OAAO,IAAI,CAAC;YACnC,OAAO,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACpC,CAAC;QACD,SAAS,CAAC,GAAG,EAAE,OAAO;YACpB,MAAM,IAAI,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;YACtB,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC9C,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QACvC,CAAC;QACD,MAAM,CAAC,GAAG;YACR,OAAO,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;QAC9B,CAAC;QACD,OAAO;YACL,OAAO,OAAO,EAAE,CAAC;QACnB,CAAC;QACD,SAAS;YACP,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE;gBACtC,IAAI,CAAC;oBACH,OAAO,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;gBAC5C,CAAC;gBAAC,MAAM,CAAC;oBACP,OAAO,KAAK,CAAC;gBACf,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC;QACD,IAAI,CAAC,OAAO,EAAE,IAAI;YAChB,wFAAwF;YACxF,8DAA8D;YAC9D,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,EAAE,CAAC,GAAG,IAAI,CAAC,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YACrF,OAAO,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC;QAC7B,CAAC;QACD,KAAK,CAAC,OAAO,EAAE,IAAI;YACjB,8EAA8E;YAC9E,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,EAAE,CAAC,GAAG,IAAI,CAAC,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YACpF,OAAO,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC;QAC7B,CAAC;QACD,KAAK,CAAC,IAAI;YACR,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC;QACpC,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/init/plan.d.ts

@@ -0,0 +1,72 @@
+/**
+ * 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, type Detection } from './detect.js';
+/** The dev-dependencies `reticle init` installs for a given framework — kit first, build plugin next. */
+export declare function frameworkPackages(framework: Framework): readonly string[];
+export declare const StepStatus: {
+    readonly APPLY: "apply";
+    readonly MANUAL: "manual";
+    readonly ALREADY: "already";
+    readonly SKIP: "skip";
+};
+export type StepStatus = (typeof StepStatus)[keyof typeof StepStatus];
+interface Step {
+    title: string;
+    target: string;
+    status: StepStatus;
+    detail: string;
+    /** Present only when status is APPLY and a file must be written. */
+    write?: {
+        path: string;
+        content: string;
+    };
+    /** Present only when status is APPLY and a subprocess must run (the dependency install). */
+    exec?: {
+        command: string;
+        args: string[];
+        fallback: string;
+    };
+}
+export interface Plan {
+    framework: Framework;
+    steps: Step[];
+}
+export interface PlanInput {
+    detection: Detection;
+    /** Whether the `claude` CLI is installed (so we can register the MCP server globally). */
+    claudeCli: boolean;
+    /** Whether an `reticle` MCP server is already registered with Claude (any scope) — idempotency. */
+    mcpExists: boolean;
+    /** Whether Cursor is installed for this user (its global config dir exists). */
+    cursorPresent: boolean;
+    /** Current ~/.cursor/mcp.json content, or null if absent. */
+    cursorConfig: string | null;
+    /** Absolute path of ~/.cursor/mcp.json (the write target). */
+    cursorConfigPath: string;
+    /** Discovered Vite config: its path + source, or null if none found. */
+    viteConfig: {
+        path: string;
+        source: string;
+    } | null;
+    /** Discovered Next config filename (e.g. 'next.config.mjs'), or null. */
+    nextConfigFile: string | null;
+    /** Whether app/reticle-dev.tsx already exists. */
+    nextReticleDevExists: boolean;
+    /** Whether src/hooks.client.ts already exists (SvelteKit idempotency). */
+    svelteKitHooksExists?: boolean;
+    /** Whether .reticle.json already exists in the project root (idempotency). */
+    reticleConfigExists?: boolean;
+    options: {
+        port: number | undefined;
+        mcp: boolean;
+        install: boolean;
+        /** Stable project identity derived at init (package.json name + root). Baked into snippets/.reticle.json. */
+        projectId?: string;
+    };
+}
+export declare function buildPlan(input: PlanInput): Plan;
+export {};
+//# sourceMappingURL=plan.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../src/init/plan.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,SAAS,EAAuC,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAwB7F,yGAAyG;AACzG,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,SAAS,GAAG,SAAS,MAAM,EAAE,CAYzE;AAKD,eAAO,MAAM,UAAU;;;;;CAKb,CAAC;AACX,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,OAAO,UAAU,CAAC,CAAC;AAEtE,UAAU,IAAI;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,UAAU,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,oEAAoE;IACpE,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1C,4FAA4F;IAC5F,IAAI,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;CAC9D;AAED,MAAM,WAAW,IAAI;IACnB,SAAS,EAAE,SAAS,CAAC;IACrB,KAAK,EAAE,IAAI,EAAE,CAAC;CACf;AAED,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,SAAS,CAAC;IACrB,0FAA0F;IAC1F,SAAS,EAAE,OAAO,CAAC;IACnB,mGAAmG;IACnG,SAAS,EAAE,OAAO,CAAC;IACnB,gFAAgF;IAChF,aAAa,EAAE,OAAO,CAAC;IACvB,6DAA6D;IAC7D,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,8DAA8D;IAC9D,gBAAgB,EAAE,MAAM,CAAC;IACzB,wEAAwE;IACxE,UAAU,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACpD,yEAAyE;IACzE,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,kDAAkD;IAClD,oBAAoB,EAAE,OAAO,CAAC;IAC9B,0EAA0E;IAC1E,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,8EAA8E;IAC9E,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,OAAO,EAAE;QACP,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;QACzB,GAAG,EAAE,OAAO,CAAC;QACb,OAAO,EAAE,OAAO,CAAC;QACjB,6GAA6G;QAC7G,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;CACH;AAuOD,wBAAgB,SAAS,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,CAiBhD"}