multiclone 0.0.0-stage → 0.1.0

package/README.md

@@ -1,3 +1,90 @@
-# 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). Nothing to clone or build: npm downloads it ready to run.
+
+In the folder where you want the clone:
+
+1. `npx multiclone setup` installs the cloning method and the MCP server for Claude Code, Cursor and any agent that reads `AGENTS.md`. Limit it with `--agents claude`, `--agents cursor` or `--agents agents`.
+2. `npx multiclone doctor` checks Chrome and WebGL.
+3. Open your agent in that folder and ask it: "clone https://example.com".
+
+### Claude Code
+
+- After `setup`, start `claude` in the folder and approve the multiclone server when asked. Then type `/multiclone https://example.com` or just ask for a clone.
+- To have it in every project instead: `claude mcp add --scope user multiclone -- npx -y multiclone mcp`. The server tells the agent how to use it, and the `guide` tool holds the full method.
+
+### Cursor
+
+- After `setup`, open the folder and turn on multiclone under Settings → MCP. The method lives in `.cursor/rules/multiclone.mdc`.
+- Or add it for every project in `~/.cursor/mcp.json`: `{ "mcpServers": { "multiclone": { "command": "npx", "args": ["-y", "multiclone", "mcp"] } } }`.
+
+### Any other agent (GG Coder, Codex, Windsurf, Cline and others)
+
+- Add an MCP server with the command `npx -y multiclone mcp` in the agent's settings.
+- `setup` also writes `.multiclone/GUIDE.md` and a short block in `AGENTS.md` so the agent finds the method.
+- No MCP support? The agent can run every tool from the terminal: `npx multiclone --help` lists them and `npx multiclone guide` prints the method.
+
+## Use it
+
+Ask your agent to clone a URL. It then:
+
+1. **Captures** the page on desktop and mobile and analyses it into one bundle per section.
+2. **Reads** `REPORT.md` and the section briefs: stack, tokens, fonts, motion, animation code, hover states.
+3. **Scaffolds** a React project with the captured fonts, design tokens, media and a mock API.
+4. **Rebuilds** it section by section (the `section-builder` agent can take independent sections).
+5. **Compares** the clone with the capture per section, motion track and hover, fixes the worst first, and finishes with a localhost link and a score.
+
+## 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
+
+Everything also works from the terminal (`npx multiclone <command>`, or `multiclone <command>` after `npm i -g multiclone`). Flags are the tool fields in kebab case; `multiclone <command> --help` lists them.
+
+| Command                                                                                              | What it does                     |
+| ---------------------------------------------------------------------------------------------------- | -------------------------------- |
+| `multiclone setup [dir] [--agents claude,cursor,agents]`                                             | Install the method and MCP entry |
+| `multiclone guide [topic]`                                                                           | Print the method                 |
+| `multiclone capture <url> [--out dir] [--viewports desktop,mobile\|auto] [--headed] [--profile dir]` | Record and analyse the page      |
+| `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                  |
+
+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,20 @@
+---
+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
+
+Follow the `multiclone` skill end to end:
+
+1. Capture (it analyses into section bundles too)
+2. Understand: `REPORT.md`, then each `sections/<id>/section.md`
+3. Scaffold from the capture (fonts, tokens, media, mock API)
+4. Rebuild section by section with the `data-mc-*` markers; use the `section-builder` agent for independent sections
+5. Compare against the capture folder and fix
+
+If no project folder is given, use `./<site-name>-clone` in the current directory, with the capture in `./<site-name>-capture`.
+
+If the multiclone MCP tools are not available, run the same tools from the terminal with `npx multiclone <command>` and tell the user to add the server with `claude mcp add multiclone -- npx -y multiclone mcp`, then restart.
+
+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,120 @@
+#!/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 setup, then ask your agent to clone a URL. 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 === '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":"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"}

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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"}