multiclone 0.0.0-stage → 0.2.0

package/README.md

@@ -1,3 +1,79 @@
-# Temporary Holding Version
+# multiclone
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Clone any website from a link. multiclone captures the page, plays it back offline, rebuilds it as a clean React + Vite + TypeScript project with the same design and animations, and scores how close the rebuild is.
+
+It runs on your own machine: your Chrome, your CPU and your Claude Code. Nothing is uploaded anywhere.
+
+## Quick start
+
+You need Node 22.12 or newer and Google Chrome (Chromium, Edge or Brave also work).
+
+1. Install the CLI once: `npm i -g multiclone` (or download `install.sh` from this repo, read it, and run `sh install.sh`; it also checks Chrome).
+2. In the folder where you want the clone: `multiclone setup`. It teaches your agent the method (Claude Code skill and `/multiclone` command, a Cursor rule, and a block in `AGENTS.md` for every other agent). Add `--mcp` if you also want the MCP server; the CLI works without it.
+3. Ask your agent: "clone https://example.com". Or run it yourself: `multiclone start https://example.com`.
+
+No global install? Put `npx` in front of every command.
+
+## Use it
+
+1. The agent asks one question: the landing page only, specific pages, or the whole site.
+2. `multiclone start <url> --scope …` returns in seconds with a **progress link** (for example `http://127.0.0.1:4300/`). Open it: it shows each step live, then the clone itself.
+3. In about 2–3 minutes the first draft is live: a quick capture (desktop and mobile at the same time), a React project with the real fonts, colours and media, and one component per section with the real text, links, images and video. The clone runs on localhost next to an offline copy of the original.
+4. While the agent polishes the draft, multiclone captures the other pages and a deep pass (scroll motion, hovers, clicks, the code that animates) in the background. `multiclone status` shows where it is.
+5. The agent compares the clone with the original per section, motion track and hover, fixes the worst first, and finishes with a localhost link and a score.
+
+Run `start` again after a crash or restart: finished captures are reused and drafted pages are never overwritten. `multiclone stop` ends the servers; the files stay.
+
+## What's inside
+
+- **Capture:** your Chrome (headless or headed, with an optional persistent profile) scrolls the page with real wheel events, so Lenis and GSAP sites move. It dismisses consent banners and records:
+  - every response, redirect and WebSocket, plus every script and its source maps;
+  - a computed-style DOM snapshot, the hydrated DOM, screenshots and an intro filmstrip per viewport;
+  - fonts, storage, CSS breakpoints and hydration data (Next, Remix, Nuxt and others);
+  - the scroll motion map (transform, opacity, clip, filter, colours, size, text) with exact curves;
+  - live animation state: GSAP tweens and ScrollTriggers, Lenis, WAAPI, IntersectionObservers, WebGL shaders, Lottie and Rive;
+  - event listeners, the code that runs while things move, and hover, focus and click states.
+- **Analyze:** in an isolated worker it splits the page into section bundles, extracts design tokens, prettifies and splits the code into app and vendor, finds every animation call with file and line, and writes `REPORT.md`.
+- **Inspect:** pages through any part of a capture so big captures never flood the chat.
+- **Mirror:** an offline copy on localhost. `live` mode runs the original scripts with storage seeded; captured API calls become a mock API.
+- **Scaffold:** a strict React 19 + Vite + TypeScript starter (ESLint strictTypeChecked, Prettier, `@` alias, Lenis provider, hooks, `check` script). From a capture it also brings the fonts, `tokens.css`, the media and a dev proxy to the mock API.
+- **Shoot:** screenshots at exact scroll offsets, plus a JavaScript probe for measuring.
+- **Compare:** scores frames, sections (aligned by `data-mc-section`), structure, scroll motion (`data-mc-track`), hover states (`data-mc-hover`) and the intro, with an HTML report and the worst sections to fix next. The score stays below 100 while anything could not be compared.
+- **The skill and agent:** the method Claude follows, recipes for each stack, a fidelity playbook, the capture format, and a `section-builder` agent that rebuilds one section from its bundle.
+
+## CLI
+
+`multiclone <command>` (or `npx multiclone <command>`). Flags are the tool fields in kebab case; `multiclone <command> --help` lists them.
+
+| Command                                                                                        | What it does                               |
+| ---------------------------------------------------------------------------------------------- | ------------------------------------------ |
+| `multiclone start <url> [--scope landing\|pages\|site] [--pages /a,/b] [--dir folder]`         | Capture, draft and serve in the background |
+| `multiclone status [dir] [--wait draft\|pages\|deep]`                                          | Where the session is, with its links       |
+| `multiclone stop [dir]`                                                                        | Stop the session's servers                 |
+| `multiclone setup [dir] [--agents claude,cursor,agents] [--mcp]`                               | Teach your agent the method                |
+| `multiclone guide [topic]`                                                                     | Print the method                           |
+| `multiclone capture <url> [--depth quick\|full] [--viewports desktop,mobile\|auto] [--headed]` | Record and analyse the page                |
+| `multiclone draft <capture-dir> <project-dir> [--route /pricing]`                              | Write section components from a capture    |
+| `multiclone analyze <capture-dir>`                                                             | Rebuild the derived files                  |
+| `multiclone inspect <capture-dir> section [03-pricing]`                                        | Page through a capture                     |
+| `multiclone serve <capture-dir> [--port 4400] [--mode live\|snapshot]`                         | Offline mirror and mock API                |
+| `multiclone scaffold <dir> [--capture capture-dir] [--port 5180]`                              | New React project                          |
+| `multiclone assets <capture-dir> <project-dir>`                                                | Copy media in                              |
+| `multiclone shoot <url> [--positions 0,900] [--probe js]`                                      | Screenshots and measurements               |
+| `multiclone compare <capture-dir\|url> <clone-url> [--intro] [--positions]`                    | Score the clone                            |
+| `multiclone doctor`                                                                            | Check the setup                            |
+| `multiclone mcp`                                                                               | Optional MCP server with the same tools    |
+
+Add `--json` for machine-readable output. Set `MULTICLONE_CHROME` to use a specific browser.
+
+## Known limits
+
+- Server features (logins, search, carts, live data) are rebuilt as static visuals; the mock API only replays what was recorded.
+- WebGL and heavy canvas work need the most iteration. Shaders are captured, but matching them takes rounds of comparing.
+- Some sites block automated browsers. Use `--headed` with `--profile` and pass the check once.
+- Video, random and time-based effects never match pixel for pixel, so judge those frames by eye.
+
+## Development
+
+- `npm run check`: typecheck, lint, format check, unit tests and build
+- `npm run e2e`: fixture-site capture → mirror → compare

package/agents/section-builder.md

@@ -0,0 +1,37 @@
+---
+name: section-builder
+description: Rebuilds one section of a multiclone capture as a React component in an existing clone project. Give it the capture folder, the section id and the project folder. Use for pages with many independent sections after the shell (fonts, tokens, header, footer, smooth scroll) is in place.
+tools: Read, Write, Edit, Glob, Grep, Bash
+---
+
+You rebuild exactly one section of a captured website inside an existing React + Vite + TypeScript clone project. You get three things: the capture folder, the section id (for example `03-pricing`) and the project folder.
+
+## Read first
+
+1. `<capture>/sections/<id>/section.md`: the brief. Follow it.
+2. The crops `<capture>/sections/<id>/<viewport>.png` for every viewport. Look at them.
+3. `dom-<viewport>.txt` and `styles-<viewport>.json` for structure, boxes and exact CSS values; `tokens-<viewport>.json` for local values.
+4. When present: `motion.json` (scroll curves with track ids), `animations.json` and `animations-code.json` (keyframes, library calls with file and line), `interactions.json` (hover, focus and click states with ids), `assets.json` (media used), `hot-code.json` (code that ran while it moved).
+5. `<project>/src/styles/tokens.css`, `src/lib/mc.ts` and existing components, so you reuse what the shell already has.
+
+Use the multiclone `inspect` tool (`facet: "section"`, `selector: "<id>"`) for anything too big to read whole.
+
+## Build
+
+- One component in `<project>/src/components/sections/<Name>.tsx`, plus typed content in `src/content/` when the section has copy or lists. Copy text from the capture; never retype or invent it.
+- Root element: `<section {...mcSection('<id>')}>`.
+- Every element in `motion.json` gets `{...mcTrack(id)}`; every element in `interactions.json` gets `{...mcHover(id)}`.
+- Match the captured values: sizes, spacing, colours, fonts, radii, shadows and the motion curves (start, end, easing). Prefer the existing tokens when a value matches one.
+- Media paths come from `src/content/asset-map.json`.
+- Semantic, accessible markup; respect `prefers-reduced-motion`. Heavy parts load lazily and clean up on unmount.
+- Strict TypeScript: no `any`, no non-null `!`, named exports.
+
+## Do not
+
+- Touch other sections, the shell, global styles or config, except to add your component to the page when asked.
+- Install packages. If the section needs one that is missing, say so in your report.
+- Run compare or the dev server unless asked.
+
+## Finish
+
+Run `npm run typecheck` and `npm run lint` in the project and fix what you introduced. Report in a few plain lines: the files you wrote, the tracks and hovers you tagged, and anything approximated.

package/commands/multiclone.md

@@ -0,0 +1,15 @@
+---
+description: Clone a website from a link into a React + Vite + TypeScript project with the same design and animations
+argument-hint: <url> [project folder]
+---
+
+Clone this website with the multiclone method: $ARGUMENTS
+
+1. Ask the user one short question first: clone just the landing page, specific pages (which ones), or the whole site?
+2. Run `multiclone start <url> --scope <answer>` (add `--pages /a,/b` for specific pages, `--dir <folder>` if a project folder was given). Give the user the progress link it prints right away.
+3. Run `multiclone status --wait draft`. When the first draft is live, give the user the clone link.
+4. Follow the `multiclone` skill (or `multiclone guide`) to polish the draft section by section, then compare and fix.
+
+If `multiclone` isn't on the PATH, use `npx multiclone` instead.
+
+Keep progress updates short and in plain words. Finish with the localhost link, the final compare score, and an honest list of what is approximated.

package/dist/adapters/cli.js

@@ -0,0 +1,129 @@
+#!/usr/bin/env node
+import { parseArgs } from 'node:util';
+import { CATALOG } from '../contracts/catalog.js';
+import { MirrorRegistry } from '../contracts/context.js';
+import { setQuiet } from '../core/log.js';
+import { toMcError } from '../domain/result.js';
+import { VERSION } from '../version.js';
+import { coerce, toolFields } from './cliArgs.js';
+const GLOBAL_HELP = `  --json        Print the result as JSON
+  --quiet       No progress output
+  -h, --help    Help for a command`;
+function fieldHelp(field) {
+    const value = field.kind === 'boolean'
+        ? ''
+        : field.kind === 'enum'
+            ? ` <${field.options.join('|')}>`
+            : field.kind.endsWith('list')
+                ? ' <a,b,c>'
+                : ` <${field.kind}>`;
+    const fallback = field.defaultValue === undefined || field.kind === 'boolean'
+        ? ''
+        : ` (default ${JSON.stringify(field.defaultValue)})`;
+    const negate = field.kind === 'boolean' && field.defaultValue === true ? `  [--no-${field.flag}]` : '';
+    return `      --${field.flag}${value}${negate}  ${field.description}${fallback}`;
+}
+function usage(tool) {
+    const binding = tool.cli;
+    if (!binding)
+        return '';
+    const positionals = binding.positionals.map((key) => `<${key}>`).join(' ');
+    const options = toolFields(tool)
+        .filter((field) => !binding.positionals.includes(field.key))
+        .map(fieldHelp)
+        .join('\n');
+    return `  multiclone ${binding.command} ${positionals}\n      ${tool.title}\n${options}`;
+}
+function help() {
+    const tools = CATALOG.filter((tool) => tool.cli !== null).map(usage);
+    return `multiclone ${VERSION} — clone any website from a link\n\nStart: multiclone start <url> --scope landing|pages|site (prints a live progress link), then multiclone status --wait draft. Read the method: multiclone guide.\n\nUsage\n${tools.join('\n')}\n  multiclone mcp\n      Run the MCP server (for Claude Code, Cursor or any MCP agent)\n\nGlobal\n${GLOBAL_HELP}\n`;
+}
+function fail(message) {
+    process.stderr.write(`multiclone: ${message}\n`);
+    process.exit(2);
+}
+async function runTool(tool, argv) {
+    const binding = tool.cli;
+    if (!binding)
+        fail(`${tool.name} has no CLI command`);
+    const fields = toolFields(tool);
+    const options = {
+        json: { type: 'boolean' },
+        quiet: { type: 'boolean' },
+        help: { type: 'boolean', short: 'h' },
+    };
+    for (const field of fields) {
+        options[field.flag] = { type: field.kind === 'boolean' ? 'boolean' : 'string' };
+        if (field.kind === 'boolean')
+            options[`no-${field.flag}`] = { type: 'boolean' };
+    }
+    const { values, positionals } = parseArgs({ args: argv, options, allowPositionals: true });
+    if (values.help === true)
+        return void process.stdout.write(`${usage(tool)}\n`);
+    if (values.quiet === true)
+        setQuiet(true);
+    const input = {};
+    binding.positionals.forEach((key, index) => {
+        const value = positionals[index];
+        if (value !== undefined)
+            input[key] = value;
+    });
+    for (const field of fields) {
+        const raw = values[field.flag];
+        if (typeof raw === 'string' || typeof raw === 'boolean')
+            input[field.key] = coerce(field, raw);
+        if (field.kind === 'boolean' && values[`no-${field.flag}`] === true)
+            input[field.key] = false;
+    }
+    const mirrors = new MirrorRegistry();
+    const controller = new AbortController();
+    const stop = () => {
+        controller.abort();
+        void mirrors.stop().then(() => process.exit(130));
+    };
+    process.on('SIGINT', stop);
+    process.on('SIGTERM', stop);
+    const context = { mirrors, signal: controller.signal, surface: 'cli' };
+    const result = await tool.run(input, context);
+    if (!result.ok) {
+        const hint = result.error.hint === undefined ? '' : `\nHint: ${result.error.hint}`;
+        fail(`[${result.error.tag}] ${result.error.message}${hint}`);
+    }
+    const output = result.value;
+    process.stdout.write(values.json === true ? `${JSON.stringify(output.data, null, 2)}\n` : `${output.text}\n`);
+    if (binding.longRunning)
+        process.stderr.write('Running. Ctrl+C to stop.\n');
+}
+async function main() {
+    const [command, ...rest] = process.argv.slice(2);
+    if (command === '--version' || command === '-v')
+        return void process.stdout.write(`${VERSION}\n`);
+    if (command === undefined || command === 'help' || command === '--help' || command === '-h') {
+        return void process.stdout.write(help());
+    }
+    if (command === '__session') {
+        // Background process behind `multiclone start`; not a public command.
+        const { runSessionDaemon } = await import('../session/session.js');
+        const workspace = rest[0];
+        if (workspace === undefined)
+            fail('__session needs a workspace');
+        await runSessionDaemon(workspace);
+        return;
+    }
+    if (command === 'mcp') {
+        setQuiet(true);
+        const { runMcpServer } = await import('./mcp.js');
+        await runMcpServer();
+        return;
+    }
+    const tool = CATALOG.find((entry) => entry.cli?.command === command);
+    if (!tool)
+        fail(`unknown command "${command}"\n\n${help()}`);
+    await runTool(tool, rest);
+}
+main().catch((error) => {
+    const mapped = toMcError(error);
+    process.stderr.write(`multiclone: [${mapped.tag}] ${mapped.message}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/adapters/cli.js.map

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

package/dist/adapters/cliArgs.js

@@ -0,0 +1,63 @@
+import { readFileSync } from 'node:fs';
+export const kebab = (key) => key.replace(/[A-Z]/g, (c) => `-${c.toLowerCase()}`);
+/** Reads one zod field down to its base type, keeping the outer description and default. */
+export function describeField(key, schema) {
+    let current = schema;
+    let description = schema.description ?? '';
+    let defaultValue = undefined;
+    for (;;) {
+        const def = current.def;
+        if (def.type === 'optional' || def.type === 'nullable') {
+            current = current.unwrap();
+        }
+        else if (def.type === 'default') {
+            const wrapped = current;
+            defaultValue = wrapped.def.defaultValue;
+            current = wrapped.unwrap();
+        }
+        else
+            break;
+        description ||= current.description ?? '';
+    }
+    const base = current.def.type;
+    let kind = 'string';
+    let options = [];
+    if (base === 'number')
+        kind = 'number';
+    else if (base === 'boolean')
+        kind = 'boolean';
+    else if (base === 'enum') {
+        kind = 'enum';
+        options = current.options.map(String);
+    }
+    else if (base === 'array') {
+        const element = current.element.def.type;
+        kind = element === 'number' ? 'number-list' : 'string-list';
+    }
+    return { key, flag: kebab(key), kind, description, options, defaultValue };
+}
+export function toolFields(tool) {
+    return Object.entries(tool.input.shape).map(([key, schema]) => describeField(key, schema));
+}
+/** Converts parsed CLI strings to the shapes the tool schema expects; zod validates the rest. */
+export function coerce(field, raw) {
+    if (field.kind === 'boolean')
+        return raw;
+    const text = String(raw);
+    if (field.kind === 'number')
+        return Number(text);
+    if (field.kind === 'number-list')
+        return text.split(',').filter(Boolean).map(Number);
+    if (field.kind === 'string-list')
+        return text.split(',').filter(Boolean);
+    if (field.key === 'probe' && text.length < 400 && !text.includes('(')) {
+        try {
+            return readFileSync(text, 'utf8');
+        }
+        catch {
+            return text;
+        }
+    }
+    return text;
+}
+//# sourceMappingURL=cliArgs.js.map

package/dist/adapters/cliArgs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cliArgs.js","sourceRoot":"","sources":["../../src/adapters/cliArgs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAevC,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,GAAW,EAAU,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;AAElG,4FAA4F;AAC5F,MAAM,UAAU,aAAa,CAAC,GAAW,EAAE,MAAiB;IAC1D,IAAI,OAAO,GAAc,MAAM,CAAC;IAChC,IAAI,WAAW,GAAG,MAAM,CAAC,WAAW,IAAI,EAAE,CAAC;IAC3C,IAAI,YAAY,GAAY,SAAS,CAAC;IACtC,SAAS,CAAC;QACR,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;QACxB,IAAI,GAAG,CAAC,IAAI,KAAK,UAAU,IAAI,GAAG,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;YACvD,OAAO,GAAI,OAAyB,CAAC,MAAM,EAAe,CAAC;QAC7D,CAAC;aAAM,IAAI,GAAG,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAClC,MAAM,OAAO,GAAG,OAAuB,CAAC;YACxC,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC;YACxC,OAAO,GAAG,OAAO,CAAC,MAAM,EAAe,CAAC;QAC1C,CAAC;;YAAM,MAAM;QACb,WAAW,KAAK,OAAO,CAAC,WAAW,IAAI,EAAE,CAAC;IAC5C,CAAC;IACD,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;IAC9B,IAAI,IAAI,GAAc,QAAQ,CAAC;IAC/B,IAAI,OAAO,GAAsB,EAAE,CAAC;IACpC,IAAI,IAAI,KAAK,QAAQ;QAAE,IAAI,GAAG,QAAQ,CAAC;SAClC,IAAI,IAAI,KAAK,SAAS;QAAE,IAAI,GAAG,SAAS,CAAC;SACzC,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;QACzB,IAAI,GAAG,MAAM,CAAC;QACd,OAAO,GAAI,OAAqB,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACvD,CAAC;SAAM,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;QAC5B,MAAM,OAAO,GAAI,OAAiC,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;QACpE,IAAI,GAAG,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,aAAa,CAAC;IAC9D,CAAC;IACD,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC;AAC7E,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAiB;IAC1C,OAAO,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,MAAM,CAAC,EAAE,EAAE,CAC5D,aAAa,CAAC,GAAG,EAAE,MAAmB,CAAC,CACxC,CAAC;AACJ,CAAC;AAED,iGAAiG;AACjG,MAAM,UAAU,MAAM,CAAC,KAAe,EAAE,GAAqB;IAC3D,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS;QAAE,OAAO,GAAG,CAAC;IACzC,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IACzB,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC;IACjD,IAAI,KAAK,CAAC,IAAI,KAAK,aAAa;QAAE,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACrF,IAAI,KAAK,CAAC,IAAI,KAAK,aAAa;QAAE,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACzE,IAAI,KAAK,CAAC,GAAG,KAAK,OAAO,IAAI,IAAI,CAAC,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACtE,IAAI,CAAC;YACH,OAAO,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACpC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/adapters/mcp.js

@@ -0,0 +1,83 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CATALOG } from '../contracts/catalog.js';
+import { MirrorRegistry } from '../contracts/context.js';
+import { toMcError } from '../domain/result.js';
+import { readGuide, TOPICS } from '../project/method.js';
+import { z } from 'zod';
+import { VERSION } from '../version.js';
+const render = (output) => ({
+    content: [
+        { type: 'text', text: output.text },
+        ...(output.images ?? []).map((image) => ({
+            type: 'image',
+            data: image.data.toString('base64'),
+            mimeType: image.mimeType,
+        })),
+    ],
+});
+const failure = (message) => ({
+    content: [{ type: 'text', text: message }],
+    isError: true,
+});
+const INSTRUCTIONS = [
+    'multiclone clones a website from a link into a React + Vite + TypeScript project with the same design, animations and interactions.',
+    'Before a clone, call the `guide` tool (topic "method") and follow it step by step.',
+    'Flow: doctor, capture (also analyses into section bundles), read REPORT.md and sections/<id>/section.md, inspect for anything big, scaffold with capture, rebuild section by section with data-mc-section / data-mc-track / data-mc-hover markers, then serve_mirror and compare against the capture folder until the worst sections are fixed.',
+].join(' ');
+/** MCP server generated from the tool catalog. */
+export async function runMcpServer() {
+    const server = new McpServer({ name: 'multiclone', version: VERSION }, { instructions: INSTRUCTIONS });
+    const mirrors = new MirrorRegistry();
+    for (const tool of CATALOG) {
+        server.registerTool(tool.name, {
+            title: tool.title,
+            description: tool.description,
+            inputSchema: tool.input,
+            annotations: { readOnlyHint: tool.readOnly, openWorldHint: tool.openWorld },
+        }, async (args, extra) => {
+            const context = { mirrors, signal: extra.signal, surface: 'mcp' };
+            try {
+                const result = await tool.run(args, context);
+                if (result.ok)
+                    return render(result.value);
+                const hint = result.error.hint === undefined ? '' : `\nHint: ${result.error.hint}`;
+                return failure(`[${result.error.tag}] ${result.error.message}${hint}`);
+            }
+            catch (error) {
+                const mapped = toMcError(error);
+                return failure(`[${mapped.tag}] ${mapped.message}`);
+            }
+        });
+    }
+    for (const topic of TOPICS) {
+        server.registerResource(`guide-${topic}`, `multiclone://guide/${topic}`, { title: `multiclone guide: ${topic}`, mimeType: 'text/markdown' }, async (uri) => ({
+            contents: [{ uri: uri.href, mimeType: 'text/markdown', text: await readGuide(topic) }],
+        }));
+    }
+    server.registerPrompt('clone', {
+        title: 'Clone a website',
+        description: 'Clone a website from a link with the multiclone method.',
+        argsSchema: {
+            url: z.string().describe('Page to clone.'),
+            dir: z.string().optional().describe('Project folder for the rebuild.'),
+        },
+    }, async ({ url, dir }) => ({
+        messages: [
+            {
+                role: 'user',
+                content: {
+                    type: 'text',
+                    text: `Clone ${url} with multiclone${dir === undefined ? '' : ` into ${dir}`}. Follow this method step by step; read the other guides with the \`guide\` tool when it points to them.\n\n${await readGuide('method')}`,
+                },
+            },
+        ],
+    }));
+    const close = async () => {
+        await mirrors.stop();
+    };
+    process.on('SIGINT', () => void close().then(() => process.exit(0)));
+    process.on('SIGTERM', () => void close().then(() => process.exit(0)));
+    await server.connect(new StdioServerTransport());
+}
+//# sourceMappingURL=mcp.js.map

package/dist/adapters/mcp.js.map

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

package/dist/analyze/analyze.js

@@ -0,0 +1,85 @@
+import { spawn } from 'node:child_process';
+import { fileURLToPath } from 'node:url';
+import { dirname, join } from 'node:path';
+import { log } from '../core/log.js';
+import { err, mcError, ok } from '../domain/result.js';
+/**
+ * Runs the analysis in an isolated Node child process with heap and time limits, so a huge or
+ * hostile bundle can't take the capture/MCP process down. Messages flow back as NDJSON.
+ */
+export function analyze(options) {
+    const timeoutMs = options.timeoutMs ?? 300_000;
+    const heap = options.maxHeapMb ?? 2048;
+    const here = dirname(fileURLToPath(import.meta.url));
+    const worker = join(here, `worker${import.meta.url.endsWith('.ts') ? '.ts' : '.js'}`);
+    const execArgv = import.meta.url.endsWith('.ts') ? ['--import', 'tsx'] : [];
+    return new Promise((resolve) => {
+        const child = spawn(process.execPath, [
+            ...execArgv,
+            `--max-old-space-size=${String(heap)}`,
+            worker,
+            options.dir,
+            String(Date.now() + timeoutMs - 10_000),
+        ], {
+            stdio: ['ignore', 'pipe', 'pipe'],
+        });
+        let buffer = '';
+        let stderr = '';
+        let summary = null;
+        let failure = null;
+        const timer = setTimeout(() => {
+            failure = `analysis exceeded ${String(timeoutMs)}ms`;
+            child.kill('SIGKILL');
+        }, timeoutMs);
+        const onAbort = () => {
+            failure = 'analysis cancelled';
+            child.kill('SIGKILL');
+        };
+        options.signal?.addEventListener('abort', onAbort, { once: true });
+        child.stdout.setEncoding('utf8');
+        child.stdout.on('data', (chunk) => {
+            buffer += chunk;
+            let newline = buffer.indexOf('\n');
+            while (newline >= 0) {
+                const line = buffer.slice(0, newline).trim();
+                buffer = buffer.slice(newline + 1);
+                newline = buffer.indexOf('\n');
+                if (!line)
+                    continue;
+                let message;
+                try {
+                    message = JSON.parse(line);
+                }
+                catch {
+                    continue;
+                }
+                if (message.type === 'progress')
+                    log(`  analysis: ${message.step}`);
+                else if (message.type === 'warning')
+                    log(`  ! ${message.message}`);
+                else if (message.type === 'done')
+                    summary = message.summary;
+                else
+                    failure = message.message;
+            }
+        });
+        child.stderr.setEncoding('utf8');
+        child.stderr.on('data', (chunk) => {
+            stderr = (stderr + chunk).slice(-4000);
+        });
+        child.on('close', (code) => {
+            clearTimeout(timer);
+            options.signal?.removeEventListener('abort', onAbort);
+            if (summary) {
+                resolve(ok(summary));
+                return;
+            }
+            const reason = failure ??
+                (/heap out of memory/i.test(stderr)
+                    ? `analysis ran out of memory (${String(heap)} MiB)`
+                    : `analysis worker exited with code ${String(code)}: ${stderr.trim().slice(-400)}`);
+            resolve(err(mcError(failure?.includes('exceeded') ? 'timeout' : 'worker', reason)));
+        });
+    });
+}
+//# sourceMappingURL=analyze.js.map

package/dist/analyze/analyze.js.map

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