multiclone 0.0.0-stage → 0.2.0

package/dist/contracts/tools/capture.js

@@ -0,0 +1,87 @@
+import { z } from 'zod';
+import { capture } from '../../capture/capture.js';
+import { ok } from '../../domain/result.js';
+import { RunFolder } from '../../store/run.js';
+import { renderSummary, runSummary } from '../../store/summary.js';
+import { parseViewports, wantsAutoViewports } from '../../domain/viewports.js';
+import { defineTool } from '../types.js';
+import { positionsField, settleField, viewportsField } from '../fields.js';
+export const captureTool = defineTool({
+    name: 'capture',
+    title: 'Capture a website',
+    description: 'Record a live page with Chrome: network, every frame, scripts and source maps, styled DOM snapshot, runtime animation data (GSAP/ScrollTrigger, WAAPI, WebGL shaders), intro filmstrip, scroll motion, hover/click states and fonts, then split it into per-section bundles. depth=quick (1–2 min) records what a first draft needs; depth=full (default, 3–8 min) adds motion, hovers, clicks, coverage and source maps. Prefer `start`, which does quick + draft + live link + deep pass for you. Returns a short summary; page through details with `inspect`.',
+    input: z.object({
+        url: z.url().describe('Page to clone.'),
+        out: z.string().optional().describe('Output folder; default multiclone-captures/<site>.'),
+        viewports: viewportsField,
+        positions: positionsField,
+        depth: z
+            .enum(['quick', 'full'])
+            .default('full')
+            .describe('quick: draft essentials in 1–2 min. full: everything.'),
+        shots: z
+            .number()
+            .int()
+            .min(1)
+            .max(40)
+            .optional()
+            .describe('Evenly spaced screenshots (default 4 quick, 8 full).'),
+        settleMs: settleField,
+        motion: z.boolean().optional().describe('Sample scroll-linked motion (default: full only).'),
+        parallel: z
+            .boolean()
+            .optional()
+            .describe('Capture extra viewports in a second browser at the same time (default: quick).'),
+        headed: z.boolean().default(false).describe('Show the browser window (helps with bot checks).'),
+        skip: z
+            .array(z.string())
+            .optional()
+            .describe('Collectors to skip: intro, consent, coverage, interactions, listeners, sourcemaps, runtime, animations, snapshot, a11y, fonts, storage, motion.'),
+        deep: z
+            .array(z.string())
+            .optional()
+            .describe('Viewports that get coverage, listener and interaction passes. Default the first.'),
+        analyze: z
+            .boolean()
+            .default(true)
+            .describe('Build section bundles, tokens, code and REPORT.md after capture.'),
+        profile: z
+            .string()
+            .optional()
+            .describe('Persistent Chrome profile folder: log in or pass a bot check once, then reuse.'),
+    }),
+    cli: { command: 'capture', positionals: ['url'] },
+    readOnly: false,
+    openWorld: true,
+    run: async (input, context) => {
+        const result = await capture({
+            url: input.url,
+            ...(input.out === undefined ? {} : { out: input.out }),
+            viewports: parseViewports(input.viewports),
+            autoViewports: wantsAutoViewports(input.viewports),
+            positions: input.positions ?? null,
+            depth: input.depth,
+            ...(input.shots === undefined ? {} : { shots: input.shots }),
+            ...(input.settleMs === undefined ? {} : { settleMs: input.settleMs }),
+            ...(input.motion === undefined ? {} : { motion: input.motion }),
+            ...(input.parallel === undefined ? {} : { parallel: input.parallel }),
+            headless: !input.headed,
+            ...(input.profile === undefined ? {} : { profile: input.profile }),
+            signal: context.signal,
+            ...(input.skip === undefined ? {} : { skip: input.skip }),
+            ...(input.deep === undefined ? {} : { deepViewports: input.deep }),
+            analyze: input.analyze,
+        });
+        const opened = await RunFolder.open(result.dir);
+        if (!opened.ok)
+            return opened;
+        const summary = await runSummary(opened.value);
+        const analysis = result.analysis;
+        const warnings = analysis && !analysis.ok
+            ? [...summary.warnings, `analysis: ${analysis.error.message}`]
+            : summary.warnings;
+        const data = { ...summary, warnings };
+        return ok({ data, text: renderSummary(data) });
+    },
+});
+//# sourceMappingURL=capture.js.map

package/dist/contracts/tools/capture.js.map

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

package/dist/contracts/tools/compare.js

@@ -0,0 +1,142 @@
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { z } from 'zod';
+import { compare } from '../../compare/compare.js';
+import { shoot } from '../../compare/shoot.js';
+import { ok } from '../../domain/result.js';
+import { parseViewports } from '../../domain/viewports.js';
+import { defineTool } from '../types.js';
+import { positionsField, settleField, viewportsField } from '../fields.js';
+export const shootTool = defineTool({
+    name: 'shoot',
+    title: 'Screenshot at scroll offsets',
+    description: 'Screenshot a URL at fixed scroll offsets with real wheel scrolling (works with Lenis/GSAP). Optional `probe` JS expression runs after each scroll, e.g. to read element positions or CSS variables.',
+    input: z.object({
+        url: z.string(),
+        out: z.string().default('multiclone-shots'),
+        viewports: viewportsField,
+        positions: positionsField,
+        count: z.number().int().min(1).max(30).default(6),
+        settleMs: settleField,
+        probe: z.string().optional().describe('JS expression evaluated after each scroll.'),
+        inline: z.boolean().default(false).describe('Also return up to 4 screenshots inline (MCP).'),
+    }),
+    cli: { command: 'shoot', positionals: ['url'] },
+    readOnly: false,
+    openWorld: true,
+    run: async (input) => {
+        const sets = await shoot({
+            url: input.url,
+            viewports: parseViewports(input.viewports ?? 'desktop'),
+            positions: input.positions ?? null,
+            count: input.count,
+            settleMs: input.settleMs ?? 5000,
+            out: input.out,
+            ...(input.probe === undefined ? {} : { probe: input.probe }),
+        });
+        const summary = sets.map((set) => ({
+            viewport: set.viewport.name,
+            pageHeight: set.pageHeight,
+            shots: set.shots.map((shot) => ({
+                y: shot.y,
+                actualY: shot.actualY,
+                file: join(input.out, `shot-${set.viewport.name}-${String(shot.y)}.png`),
+            })),
+            probes: set.probes,
+        }));
+        const images = input.inline
+            ? sets
+                .flatMap((set) => set.shots)
+                .slice(0, 4)
+                .map((shot) => ({ data: shot.png, mimeType: 'image/png' }))
+            : [];
+        return ok({ data: summary, text: JSON.stringify(summary, null, 2), images });
+    },
+});
+export const compareTool = defineTool({
+    name: 'compare',
+    title: 'Compare original and clone',
+    description: 'Compare the clone with the original per viewport: viewport frames, sections aligned by `data-mc-section`, page structure, scroll motion (`data-mc-track`), hover states (`data-mc-hover`) and optionally the intro. `original` is a URL or a capture folder (a capture adds its sections, motion and hovers). Writes an HTML report and compare.json and scores out of 100; the score stays below 100 while anything could not be compared. Returns the worst sections and frames to fix first.',
+    input: z.object({
+        original: z.string().describe('Original URL, or a capture folder.'),
+        clone: z.string(),
+        out: z.string().optional(),
+        viewports: viewportsField,
+        positions: positionsField,
+        relative: z.boolean().default(false).describe('Compare at the same share of scroll.'),
+        count: z.number().int().min(1).max(30).default(6),
+        settleMs: settleField,
+        threshold: z.number().min(0).max(1).default(0.1),
+        intro: z.boolean().default(false).describe('Record and diff the first 4 s after load.'),
+        interactions: z.boolean().default(true).describe('Diff hover states (capture original).'),
+        inlineWorst: z.boolean().default(false).describe('Return the worst frame inline (MCP).'),
+    }),
+    cli: { command: 'compare', positionals: ['original', 'clone'] },
+    readOnly: false,
+    openWorld: true,
+    run: async (input, context) => {
+        const result = await compare({
+            original: input.original,
+            clone: input.clone,
+            ...(input.out === undefined ? {} : { out: input.out }),
+            viewports: parseViewports(input.viewports),
+            positions: input.positions ?? null,
+            relative: input.relative,
+            count: input.count,
+            settleMs: input.settleMs ?? 5000,
+            threshold: input.threshold,
+            intro: input.intro,
+            interactions: input.interactions,
+            signal: context.signal,
+        });
+        const worst = result.worst.map((frame) => ({ ...frame, file: join(result.dir, frame.file) }));
+        const worstSections = result.worstSections.map((section) => ({
+            ...section,
+            file: section.file === null ? null : join(result.dir, section.file),
+        }));
+        const images = [];
+        const first = worstSections.find((section) => section.file !== null)?.file ?? worst[0]?.file;
+        if (input.inlineWorst && first) {
+            images.push({ data: await readFile(first), mimeType: 'image/png' });
+        }
+        const pct = (value) => value === null ? 'n/a' : `${(value * 100).toFixed(1)}%`;
+        const parts = Object.entries(result.parts)
+            .map(([name, value]) => `${name} ${pct(value)}`)
+            .join(' · ');
+        const sectionLines = worstSections
+            .map((section) => `  ${section.viewport} ${section.label || section.key}: ${section.status === 'missing' ? 'missing' : `${String(section.score)}/100`}${section.file ? `  ${section.file}` : ''}`)
+            .join('\n');
+        const frameLines = worst
+            .map((frame) => `  ${frame.viewport} @ ${String(frame.y)}px: ${pct(1 - frame.mismatch)}  ${frame.file}`)
+            .join('\n');
+        const untagged = result.motion.filter((track) => track.missing).length;
+        const c = result.completeness;
+        return ok({
+            data: {
+                score: result.score,
+                parts: result.parts,
+                completeness: result.completeness,
+                heights: result.heights,
+                worstSections,
+                worst,
+                untaggedTracks: untagged,
+                report: result.report,
+                json: join(result.dir, 'compare.json'),
+            },
+            text: [
+                `Score ${String(result.score)}/100  (${parts})`,
+                `Sections: ${String(c.sectionsPaired)} paired, ${String(c.sectionsMissing)} missing, ${String(c.sectionsExtra)} extra`,
+                untagged
+                    ? `${String(untagged)} motion tracks have no data-mc-track element in the clone.`
+                    : '',
+                `Worst sections:\n${sectionLines || '  none'}`,
+                `Worst frames:\n${frameLines || '  none'}`,
+                `Report: ${result.report}`,
+            ]
+                .filter(Boolean)
+                .join('\n'),
+            images,
+        });
+    },
+});
+//# sourceMappingURL=compare.js.map

package/dist/contracts/tools/compare.js.map

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

package/dist/contracts/tools/doctor.js

@@ -0,0 +1,23 @@
+import { z } from 'zod';
+import { doctor } from '../../doctor.js';
+import { ok } from '../../domain/result.js';
+import { defineTool } from '../types.js';
+export const doctorTool = defineTool({
+    name: 'doctor',
+    title: 'Check the environment',
+    description: 'Check Node, Chrome and headless WebGL.',
+    input: z.object({}),
+    cli: { command: 'doctor', positionals: [] },
+    readOnly: true,
+    openWorld: false,
+    run: async () => {
+        const checks = await doctor();
+        return ok({
+            data: checks,
+            text: checks
+                .map((check) => `${check.ok ? '✔' : '✘'} ${check.name}: ${check.detail}`)
+                .join('\n'),
+        });
+    },
+});
+//# sourceMappingURL=doctor.js.map

package/dist/contracts/tools/doctor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.js","sourceRoot":"","sources":["../../../src/contracts/tools/doctor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,OAAO,EAAE,EAAE,EAAE,MAAM,wBAAwB,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,CAAC,MAAM,UAAU,GAAG,UAAU,CAAC;IACnC,IAAI,EAAE,QAAQ;IACd,KAAK,EAAE,uBAAuB;IAC9B,WAAW,EAAE,wCAAwC;IACrD,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;IACnB,GAAG,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,EAAE,EAAE;IAC3C,QAAQ,EAAE,IAAI;IACd,SAAS,EAAE,KAAK;IAChB,GAAG,EAAE,KAAK,IAAI,EAAE;QACd,MAAM,MAAM,GAAG,MAAM,MAAM,EAAE,CAAC;QAC9B,OAAO,EAAE,CAAC;YACR,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,MAAM;iBACT,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,MAAM,EAAE,CAAC;iBACxE,IAAI,CAAC,IAAI,CAAC;SACd,CAAC,CAAC;IACL,CAAC;CACF,CAAC,CAAC"}

package/dist/contracts/tools/inspect.js

@@ -0,0 +1,41 @@
+import { z } from 'zod';
+import { ok } from '../../domain/result.js';
+import { FACETS, inspect } from '../../store/inspect.js';
+import { RunFolder } from '../../store/run.js';
+import { defineTool } from '../types.js';
+export const inspectTool = defineTool({
+    name: 'inspect',
+    title: 'Read part of a capture',
+    description: 'Page through one facet of a capture: summary, section (bundle brief + files), dom, styles, network, motion, animations, runtime, interactions, code, fonts, tokens. `selector` narrows it (section id like 03-pricing, element path prefix, runtime bucket, or a file to read for facet=code). Returns at most `limit` items and a nextOffset.',
+    input: z.object({
+        run: z.string().describe('Capture folder (the run id from capture).'),
+        facet: z.enum(FACETS),
+        selector: z.string().optional(),
+        viewport: z.string().optional(),
+        query: z.string().optional().describe('Case-insensitive text filter on rows.'),
+        offset: z.number().int().min(0).default(0),
+        limit: z.number().int().min(1).max(500).default(40),
+    }),
+    cli: { command: 'inspect', positionals: ['run', 'facet', 'selector'] },
+    readOnly: true,
+    openWorld: false,
+    run: async (input) => {
+        const opened = await RunFolder.open(input.run);
+        if (!opened.ok)
+            return opened;
+        const result = await inspect(opened.value, {
+            facet: input.facet,
+            offset: input.offset,
+            limit: input.limit,
+            ...(input.selector === undefined ? {} : { selector: input.selector }),
+            ...(input.viewport === undefined ? {} : { viewport: input.viewport }),
+            ...(input.query === undefined ? {} : { query: input.query }),
+        });
+        if (!result.ok)
+            return result;
+        const value = result.value;
+        const header = `${value.facet}: items ${String(value.offset)}–${String(value.offset + value.items.length)} of ${String(value.total)}${value.nextOffset === null ? '' : ` (next offset ${String(value.nextOffset)})`}${value.note ? `\n${value.note}` : ''}`;
+        return ok({ data: value, text: `${header}\n${JSON.stringify(value.items, null, 1)}` });
+    },
+});
+//# sourceMappingURL=inspect.js.map

package/dist/contracts/tools/inspect.js.map

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

package/dist/contracts/tools/method.js

@@ -0,0 +1,60 @@
+import { z } from 'zod';
+import { ok } from '../../domain/result.js';
+import { AGENTS, MCP_ENTRY, readGuide, setupProject, TOPICS } from '../../project/method.js';
+import { defineTool } from '../types.js';
+export const guideTool = defineTool({
+    name: 'guide',
+    title: 'Read the cloning method',
+    description: 'Read how to clone a website with multiclone. Call it with topic "method" before starting a clone and follow it step by step. Other topics: stacks (rebuild recipes per technology), fidelity (the compare-and-fix playbook), quality (project standards), capture-format (every file in a capture folder), section-builder (brief for rebuilding one section).',
+    input: z.object({
+        topic: z.enum(TOPICS).default('method'),
+    }),
+    cli: { command: 'guide', positionals: ['topic'] },
+    readOnly: true,
+    openWorld: false,
+    run: async (input) => {
+        const text = await readGuide(input.topic);
+        return ok({ data: { topic: input.topic, text }, text });
+    },
+});
+export const setupTool = defineTool({
+    name: 'setup',
+    title: 'Install multiclone into a project',
+    description: 'Install the cloning method into a project folder so the agent knows how to use the multiclone CLI: claude (.claude/skills, agents and the /multiclone command), cursor (.cursor/rules) and agents (.multiclone/GUIDE.md plus a block in AGENTS.md). With mcp it also registers the MCP server (.mcp.json, .cursor/mcp.json); the CLI works without it. Method files are refreshed on every run; existing MCP configs are merged.',
+    input: z.object({
+        dir: z.string().default('.').describe('Project folder (default: the current folder).'),
+        agents: z
+            .array(z.enum(AGENTS))
+            .default([...AGENTS])
+            .describe('Which agents to set up: claude, cursor, agents (default all).'),
+        mcp: z.boolean().default(false).describe('Also register the MCP server (optional).'),
+    }),
+    cli: { command: 'setup', positionals: ['dir'] },
+    readOnly: false,
+    openWorld: false,
+    run: async (input) => {
+        const result = await setupProject({ dir: input.dir, agents: input.agents, mcp: input.mcp });
+        if (!result.ok)
+            return result;
+        const { dir, agents, written, skipped } = result.value;
+        const entry = JSON.stringify({ mcpServers: { multiclone: MCP_ENTRY } });
+        const lines = [
+            `Set up multiclone in ${dir} for ${agents.join(', ')} (${String(written.length)} files).`,
+            ...skipped.map((file) => `Left ${file} alone: it is not valid JSON. Add this by hand: ${entry}`),
+            '',
+            'Next:',
+            '  multiclone doctor   check Chrome and WebGL',
+        ];
+        if (agents.includes('claude'))
+            lines.push('  Claude Code: start `claude` here and run /multiclone <url>.');
+        if (agents.includes('cursor'))
+            lines.push('  Cursor: open this folder and ask the agent to clone <url>.');
+        if (agents.includes('agents'))
+            lines.push('  Other agents: ask the agent to clone <url> (it reads AGENTS.md).');
+        lines.push(input.mcp
+            ? '  MCP server registered; agents can use the CLI or the MCP tools.'
+            : '  Agents drive the `multiclone` CLI. Add --mcp to also register the MCP server.');
+        return ok({ data: result.value, text: lines.join('\n') });
+    },
+});
+//# sourceMappingURL=method.js.map

package/dist/contracts/tools/method.js.map

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

package/dist/contracts/tools/mirror.js

@@ -0,0 +1,53 @@
+import { z } from 'zod';
+import { ok } from '../../domain/result.js';
+import { startMirror } from '../../mirror/server.js';
+import { defineTool } from '../types.js';
+export const serveMirrorTool = defineTool({
+    name: 'serve_mirror',
+    title: 'Serve an offline mirror',
+    description: 'Serve a capture folder as a working local copy of the page. mode=live replays the original scripts (animations run) with captured storage seeded and service workers blocked; mode=snapshot serves the frozen hydrated DOM without scripts. Captured API calls are also served as a mock grouped into route templates, so other param values get the closest recorded response.',
+    input: z.object({
+        dir: z.string().describe('Capture folder.'),
+        port: z.number().int().min(0).max(65535).default(4400),
+        mode: z.enum(['live', 'snapshot']).default('live'),
+        seedStorage: z
+            .boolean()
+            .default(true)
+            .describe('Seed captured localStorage, sessionStorage and cookies before page scripts.'),
+    }),
+    cli: { command: 'serve', positionals: ['dir'], longRunning: true },
+    readOnly: true,
+    openWorld: false,
+    run: async (input, context) => {
+        const mirror = await startMirror({
+            dir: input.dir,
+            port: input.port,
+            mode: input.mode,
+            seedStorage: input.seedStorage,
+        });
+        context.mirrors.add(mirror);
+        return ok({
+            data: {
+                url: mirror.url,
+                misses: `${mirror.url}__mc/misses`,
+                api: `${mirror.url}__mc/api`,
+                apiRoutes: mirror.routes.length,
+            },
+            text: `Mirror running at ${mirror.url}\n  misses: ${mirror.url}__mc/misses\n  mock API: ${String(mirror.routes.length)} route templates (${mirror.url}__mc/api)`,
+        });
+    },
+});
+export const stopMirrorTool = defineTool({
+    name: 'stop_mirror',
+    title: 'Stop mirrors',
+    description: 'Stop one mirror by URL, or every mirror started by this server.',
+    input: z.object({ url: z.string().optional() }),
+    cli: null,
+    readOnly: false,
+    openWorld: false,
+    run: async (input, context) => {
+        const stopped = await context.mirrors.stop(input.url);
+        return ok({ data: { stopped }, text: `Stopped ${String(stopped.length)} mirror(s).` });
+    },
+});
+//# sourceMappingURL=mirror.js.map

package/dist/contracts/tools/mirror.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mirror.js","sourceRoot":"","sources":["../../../src/contracts/tools/mirror.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,EAAE,EAAE,MAAM,wBAAwB,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,CAAC,MAAM,eAAe,GAAG,UAAU,CAAC;IACxC,IAAI,EAAE,cAAc;IACpB,KAAK,EAAE,yBAAyB;IAChC,WAAW,EACT,iXAAiX;IACnX,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACd,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iBAAiB,CAAC;QAC3C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;QACtD,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;QAClD,WAAW,EAAE,CAAC;aACX,OAAO,EAAE;aACT,OAAO,CAAC,IAAI,CAAC;aACb,QAAQ,CAAC,6EAA6E,CAAC;KAC3F,CAAC;IACF,GAAG,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,KAAK,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE;IAClE,QAAQ,EAAE,IAAI;IACd,SAAS,EAAE,KAAK;IAChB,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QAC5B,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC;YAC/B,GAAG,EAAE,KAAK,CAAC,GAAG;YACd,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,WAAW,EAAE,KAAK,CAAC,WAAW;SAC/B,CAAC,CAAC;QACH,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC5B,OAAO,EAAE,CAAC;YACR,IAAI,EAAE;gBACJ,GAAG,EAAE,MAAM,CAAC,GAAG;gBACf,MAAM,EAAE,GAAG,MAAM,CAAC,GAAG,aAAa;gBAClC,GAAG,EAAE,GAAG,MAAM,CAAC,GAAG,UAAU;gBAC5B,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM;aAChC;YACD,IAAI,EAAE,qBAAqB,MAAM,CAAC,GAAG,eAAe,MAAM,CAAC,GAAG,4BAA4B,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,qBAAqB,MAAM,CAAC,GAAG,WAAW;SACjK,CAAC,CAAC;IACL,CAAC;CACF,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,cAAc,GAAG,UAAU,CAAC;IACvC,IAAI,EAAE,aAAa;IACnB,KAAK,EAAE,cAAc;IACrB,WAAW,EAAE,iEAAiE;IAC9E,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC;IAC/C,GAAG,EAAE,IAAI;IACT,QAAQ,EAAE,KAAK;IACf,SAAS,EAAE,KAAK;IAChB,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QAC5B,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACtD,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,WAAW,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC,CAAC;IACzF,CAAC;CACF,CAAC,CAAC"}

package/dist/contracts/tools/project.js

@@ -0,0 +1,61 @@
+import { z } from 'zod';
+import { ok } from '../../domain/result.js';
+import { exportAssets } from '../../project/assets.js';
+import { scaffold } from '../../project/scaffold.js';
+import { defineTool } from '../types.js';
+export const scaffoldTool = defineTool({
+    name: 'scaffold',
+    title: 'Create the React rebuild project',
+    description: 'Create a strict React + Vite + TypeScript project (ESLint strictTypeChecked, Prettier, path aliases, Lenis provider, hooks, check script, data-mc compare helpers). With `capture` it also installs the captured fonts (@font-face in src/styles/fonts.css), the capture tokens.css, the media files, and a dev proxy that sends same-origin API calls to the mirror mock API.',
+    input: z.object({
+        dir: z.string(),
+        capture: z
+            .string()
+            .optional()
+            .describe('Capture folder to seed fonts, tokens, media and the API proxy from.'),
+        title: z.string().optional(),
+        name: z.string().optional(),
+        port: z.number().int().min(1024).max(65535).optional(),
+        mirrorPort: z
+            .number()
+            .int()
+            .min(1)
+            .max(65535)
+            .optional()
+            .describe('Port of `multiclone serve` (default 4400).'),
+    }),
+    cli: { command: 'scaffold', positionals: ['dir'] },
+    readOnly: false,
+    openWorld: false,
+    run: async (input) => {
+        const result = await scaffold({
+            dir: input.dir,
+            ...(input.title === undefined ? {} : { title: input.title }),
+            ...(input.name === undefined ? {} : { name: input.name }),
+            ...(input.port === undefined ? {} : { port: input.port }),
+            ...(input.capture === undefined ? {} : { capture: input.capture }),
+            ...(input.mirrorPort === undefined ? {} : { mirrorPort: input.mirrorPort }),
+        });
+        const seeded = input.capture
+            ? `\nFrom the capture: ${String(result.fonts)} font faces, ${result.tokens ? 'tokens.css' : 'no tokens.css (run analyze)'}, ${String(result.media)} media files${result.proxied.length ? `, API proxy for ${result.proxied.join(', ')} (run \`multiclone serve\` alongside dev)` : ''}.`
+            : '';
+        return ok({
+            data: result,
+            text: `Created ${result.dir}${seeded}\nNext: cd "${result.dir}" && npm install && npm run dev`,
+        });
+    },
+});
+export const assetsTool = defineTool({
+    name: 'assets',
+    title: 'Copy captured media into the project',
+    description: 'Copy captured images, fonts, video, Rive and Lottie files into <project>/public/media and write src/content/asset-map.json (original URL → local path).',
+    input: z.object({ captureDir: z.string(), projectDir: z.string() }),
+    cli: { command: 'assets', positionals: ['captureDir', 'projectDir'] },
+    readOnly: false,
+    openWorld: false,
+    run: async (input) => {
+        const result = await exportAssets(input.captureDir, input.projectDir);
+        return ok({ data: result, text: `Copied ${String(result.copied)} files. Map: ${result.map}` });
+    },
+});
+//# sourceMappingURL=project.js.map

package/dist/contracts/tools/project.js.map

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