@neonwatty/limner 0.1.0

package/dist/core/report-writer.d.ts

@@ -0,0 +1,43 @@
+import type { RegionMetrics } from './dom-metrics.js';
+import type { TargetPaths } from './workspace.js';
+export declare function writeImageReferenceReport(input: {
+    target: TargetPaths;
+    idealPath: string;
+    referencePath: string;
+    sideBySidePath: string;
+    specPaths?: {
+        idealSpecPath: string;
+        referenceSpecPath: string;
+        diffPath: string;
+    };
+    specHighlights?: string[];
+    agentSpec?: {
+        promptPath: string;
+        codexPromptPath: string;
+        claudePromptPath: string;
+        factsPath: string;
+        examplePath: string;
+        schemaPath: string;
+        instructionsPath: string;
+        responsePath: string;
+        status: 'awaiting-agent' | 'validated' | 'invalid';
+        validationErrors?: string[];
+    };
+}): Promise<string>;
+export declare function writeReferenceAppReport(input: {
+    target: TargetPaths;
+    referencePath: string;
+    appPath: string;
+    sideBySidePath: string;
+    referenceMetrics: RegionMetrics[];
+    appMetrics: RegionMetrics[];
+    appUrl: string;
+}): Promise<string>;
+export declare function writeImageAppReport(input: {
+    target: TargetPaths;
+    idealPath: string;
+    appPath: string;
+    sideBySidePath: string;
+    appUrl: string;
+}): Promise<string>;
+export declare function writeTargetSummary(target: TargetPaths): Promise<string>;

package/dist/core/report-writer.js

@@ -0,0 +1,181 @@
+import { mkdir, readdir, stat, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+export async function writeImageReferenceReport(input) {
+    const reportPath = path.join(input.target.reportsDir, 'image-reference.md');
+    await mkdir(path.dirname(reportPath), { recursive: true });
+    await writeFile(reportPath, `# Image To Reference Report
+
+Target: \`${input.target.name}\`
+
+## Artifacts
+
+- Ideal image: \`${relative(input.target.workspace.root, input.idealPath)}\`
+- Reference screenshot: \`${relative(input.target.workspace.root, input.referencePath)}\`
+- Side-by-side: \`${relative(input.target.workspace.root, input.sideBySidePath)}\`
+${formatSpecArtifacts(input.target.workspace.root, input.specPaths, input.agentSpec)}
+
+## Agent Critique
+
+- Hierarchy:
+- Density:
+- Typography:
+- Color and tokens:
+- Component anatomy:
+- Intentional deviations:
+
+## Next Fix
+
+- Record the highest-value scoped fix here.
+${formatAgentSpecStatus(input.agentSpec)}
+${formatSpecHighlights(input.specHighlights)}
+`);
+    return reportPath;
+}
+export async function writeReferenceAppReport(input) {
+    const reportPath = path.join(input.target.reportsDir, 'reference-app.md');
+    await mkdir(path.dirname(reportPath), { recursive: true });
+    await writeFile(reportPath, `# Reference To App Report
+
+Target: \`${input.target.name}\`
+
+App URL: ${input.appUrl}
+
+## Artifacts
+
+- Reference screenshot: \`${relative(input.target.workspace.root, input.referencePath)}\`
+- App screenshot: \`${relative(input.target.workspace.root, input.appPath)}\`
+- Side-by-side: \`${relative(input.target.workspace.root, input.sideBySidePath)}\`
+
+## Region Metrics
+
+${formatMetrics(input.referenceMetrics, input.appMetrics)}
+
+## Agent Findings
+
+- Highest mismatch:
+- Evidence:
+- Suggested app fix:
+- Intentional deviations:
+`);
+    return reportPath;
+}
+export async function writeImageAppReport(input) {
+    const reportPath = path.join(input.target.reportsDir, 'image-app.md');
+    await mkdir(path.dirname(reportPath), { recursive: true });
+    await writeFile(reportPath, `# Image To App Report
+
+Target: \`${input.target.name}\`
+
+App URL: ${input.appUrl}
+
+## Artifacts
+
+- Ideal image: \`${relative(input.target.workspace.root, input.idealPath)}\`
+- App screenshot: \`${relative(input.target.workspace.root, input.appPath)}\`
+- Side-by-side: \`${relative(input.target.workspace.root, input.sideBySidePath)}\`
+
+## Agent Findings
+
+- Highest visual mismatch:
+- Evidence:
+- Suggested app fix:
+- Intentional deviations:
+`);
+    return reportPath;
+}
+export async function writeTargetSummary(target) {
+    const lines = [`# Limner Target Summary`, '', `Target: \`${target.name}\``, ''];
+    for (const dir of ['captures/image-reference', 'captures/reference-app', 'captures/image-app', 'reports']) {
+        const absoluteDir = path.join(target.root, dir);
+        lines.push(`## ${dir}`, '');
+        try {
+            const entries = await readdir(absoluteDir);
+            for (const entry of entries) {
+                const entryPath = path.join(absoluteDir, entry);
+                const entryStat = await stat(entryPath);
+                lines.push(`- \`${dir}/${entry}\` (${entryStat.size} bytes)`);
+            }
+        }
+        catch {
+            lines.push('- No artifacts yet.');
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+function formatMetrics(referenceMetrics, appMetrics) {
+    const appById = new Map(appMetrics.map((metric) => [metric.id, metric]));
+    const rows = referenceMetrics.map((reference) => {
+        const app = appById.get(reference.id);
+        const referenceBounds = reference.bounds ? `${reference.bounds.width}x${reference.bounds.height}` : 'missing';
+        const appBounds = app?.bounds ? `${app.bounds.width}x${app.bounds.height}` : 'missing';
+        return `| ${reference.id} | ${reference.found ? 'yes' : 'no'} | ${app?.found ? 'yes' : 'no'} | ${referenceBounds} | ${appBounds} |`;
+    });
+    return [
+        '| Region | Reference Found | App Found | Reference Bounds | App Bounds |',
+        '| --- | --- | --- | --- | --- |',
+        ...rows,
+    ].join('\n');
+}
+function relative(root, filePath) {
+    return path.relative(root, filePath);
+}
+function formatSpecArtifacts(root, specPaths, agentSpec) {
+    const lines = [];
+    if (agentSpec) {
+        lines.push(`- Shared agent prompt: \`${relative(root, agentSpec.promptPath)}\``);
+        lines.push(`- Codex prompt: \`${relative(root, agentSpec.codexPromptPath)}\``);
+        lines.push(`- Claude prompt: \`${relative(root, agentSpec.claudePromptPath)}\``);
+        lines.push(`- Reference DOM facts: \`${relative(root, agentSpec.factsPath)}\``);
+        lines.push(`- Agent response example: \`${relative(root, agentSpec.examplePath)}\``);
+        lines.push(`- Agent response schema: \`${relative(root, agentSpec.schemaPath)}\``);
+        lines.push(`- Custom instructions: \`${relative(root, agentSpec.instructionsPath)}\``);
+        lines.push(`- Agent response target: \`${relative(root, agentSpec.responsePath)}\``);
+    }
+    if (specPaths) {
+        lines.push(`- Ideal visual spec: \`${relative(root, specPaths.idealSpecPath)}\``);
+        lines.push(`- Reference visual spec: \`${relative(root, specPaths.referenceSpecPath)}\``);
+        lines.push(`- Visual spec diff: \`${relative(root, specPaths.diffPath)}\``);
+    }
+    return lines.length > 0 ? `\n${lines.join('\n')}` : '';
+}
+function formatAgentSpecStatus(agentSpec) {
+    if (!agentSpec) {
+        return '';
+    }
+    if (agentSpec.status === 'awaiting-agent') {
+        return `
+
+## Visual Spec Status
+
+- Agent-required spec pack generated.
+- Next step: have an agent inspect the ideal image and reference artifacts, then write \`captures/image-reference/spec/agent-response.json\`.
+- Rerun \`limn compare image-reference --target <target> --spec\` after the response file exists.`;
+    }
+    if (agentSpec.status === 'invalid') {
+        const errors = agentSpec.validationErrors?.map((error) => `- ${error}`).join('\n') ?? '- Unknown validation error.';
+        return `
+
+## Visual Spec Status
+
+- Agent response was found but did not match the required structure.
+
+${errors}`;
+    }
+    return `
+
+## Visual Spec Status
+
+- Agent response validated and split into standalone spec artifacts.`;
+}
+function formatSpecHighlights(highlights) {
+    if (!highlights || highlights.length === 0) {
+        return '';
+    }
+    return `
+
+## Visual Spec Highlights
+
+${highlights.map((highlight) => `- ${highlight}`).join('\n')}`;
+}
+//# sourceMappingURL=report-writer.js.map

package/dist/core/report-writer.js.map

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

package/dist/core/run-logger.d.ts

@@ -0,0 +1,22 @@
+import type { LimnerRunEvent } from '../schemas/events.js';
+import type { WorkspacePaths } from './workspace.js';
+export type RunLogger = {
+    runId: string;
+    runDir: string;
+    manifestPath: string;
+    eventsPath: string;
+    notesPath: string;
+    event(event: Omit<LimnerRunEvent, 'ts'>): Promise<void>;
+    artifact(filePath: string, kind: string): Promise<void>;
+    complete(status?: 'ok' | 'failed', message?: string): Promise<void>;
+};
+export declare function createRunLogger(workspace: WorkspacePaths, input: {
+    command: string;
+    target?: string;
+    mode?: string;
+    viewport?: {
+        width: number;
+        height: number;
+    };
+}): Promise<RunLogger>;
+export declare function createRunId(date?: Date): string;

package/dist/core/run-logger.js

@@ -0,0 +1,67 @@
+import { appendFile, mkdir, readFile, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+export async function createRunLogger(workspace, input) {
+    const runId = createRunId();
+    const runDir = path.join(workspace.runsDir, runId);
+    const manifestPath = path.join(runDir, 'manifest.json');
+    const eventsPath = path.join(runDir, 'events.jsonl');
+    const notesPath = path.join(runDir, 'agent-notes.md');
+    const manifest = {
+        runId,
+        command: input.command,
+        target: input.target,
+        mode: input.mode,
+        startedAt: new Date().toISOString(),
+        status: 'running',
+        artifacts: [],
+        viewport: input.viewport,
+    };
+    await mkdir(runDir, { recursive: true });
+    await writeFile(manifestPath, JSON.stringify(manifest, null, 2) + '\n');
+    await writeFile(eventsPath, '');
+    await writeFile(notesPath, `# Limner Run Notes\n\nRun: ${runId}\n\n`);
+    const writeManifest = async (next) => {
+        await writeFile(manifestPath, JSON.stringify(next, null, 2) + '\n');
+    };
+    const readManifest = async () => JSON.parse(await readFile(manifestPath, 'utf8'));
+    const logEvent = async (event) => {
+        const completeEvent = {
+            ...event,
+            command: event.command ?? input.command,
+            target: event.target ?? input.target,
+            mode: event.mode ?? input.mode,
+            ts: new Date().toISOString(),
+        };
+        await appendFile(eventsPath, JSON.stringify(completeEvent) + '\n');
+    };
+    return {
+        runId,
+        runDir,
+        manifestPath,
+        eventsPath,
+        notesPath,
+        event: logEvent,
+        async artifact(filePath, kind) {
+            const manifest = await readManifest();
+            const relativePath = path.relative(workspace.root, filePath);
+            if (!manifest.artifacts.includes(relativePath)) {
+                manifest.artifacts.push(relativePath);
+                await writeManifest(manifest);
+            }
+            await logEvent({ type: 'artifact.written', path: relativePath, kind });
+        },
+        async complete(status = 'ok', message) {
+            const manifest = await readManifest();
+            manifest.status = status;
+            manifest.completedAt = new Date().toISOString();
+            await writeManifest(manifest);
+            await logEvent({ type: 'command.completed', status, message });
+        },
+    };
+}
+export function createRunId(date = new Date()) {
+    const stamp = date.toISOString().replace(/[:.]/g, '').replace('Z', 'Z');
+    const random = Math.random().toString(36).slice(2, 8);
+    return `${stamp}-${random}`;
+}
+//# sourceMappingURL=run-logger.js.map

package/dist/core/run-logger.js.map

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

package/dist/core/side-by-side.d.ts

@@ -0,0 +1,8 @@
+export declare function createSideBySideImage(input: {
+    leftPath: string;
+    rightPath: string;
+    outputPath: string;
+    height?: number;
+    gap?: number;
+    background?: string;
+}): Promise<string>;

package/dist/core/side-by-side.js

@@ -0,0 +1,33 @@
+import { mkdir } from 'node:fs/promises';
+import path from 'node:path';
+import sharp from 'sharp';
+export async function createSideBySideImage(input) {
+    const height = input.height ?? 900;
+    const gap = input.gap ?? 16;
+    const background = input.background ?? '#f8fafc';
+    const left = await resizeToHeight(input.leftPath, height);
+    const right = await resizeToHeight(input.rightPath, height);
+    const width = left.info.width + right.info.width + gap;
+    await mkdir(path.dirname(input.outputPath), { recursive: true });
+    await sharp({
+        create: {
+            width,
+            height,
+            channels: 4,
+            background,
+        },
+    })
+        .composite([
+        { input: left.buffer, left: 0, top: 0 },
+        { input: right.buffer, left: left.info.width + gap, top: 0 },
+    ])
+        .png()
+        .toFile(input.outputPath);
+    return input.outputPath;
+}
+async function resizeToHeight(filePath, height) {
+    const image = sharp(filePath).resize({ height, fit: 'inside', withoutEnlargement: false }).png();
+    const { data, info } = await image.toBuffer({ resolveWithObject: true });
+    return { buffer: data, info: { width: info.width, height: info.height } };
+}
+//# sourceMappingURL=side-by-side.js.map

package/dist/core/side-by-side.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"side-by-side.js","sourceRoot":"","sources":["../../src/core/side-by-side.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,KAO3C;IACC,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,GAAG,CAAC;IACnC,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,IAAI,EAAE,CAAC;IAC5B,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU,IAAI,SAAS,CAAC;IACjD,MAAM,IAAI,GAAG,MAAM,cAAc,CAAC,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC1D,MAAM,KAAK,GAAG,MAAM,cAAc,CAAC,KAAK,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IAC5D,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,GAAG,GAAG,CAAC;IAEvD,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACjE,MAAM,KAAK,CAAC;QACV,MAAM,EAAE;YACN,KAAK;YACL,MAAM;YACN,QAAQ,EAAE,CAAC;YACX,UAAU;SACX;KACF,CAAC;SACC,SAAS,CAAC;QACT,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE;QACvC,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,GAAG,EAAE,GAAG,EAAE,CAAC,EAAE;KAC7D,CAAC;SACD,GAAG,EAAE;SACL,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IAE5B,OAAO,KAAK,CAAC,UAAU,CAAC;AAC1B,CAAC;AAED,KAAK,UAAU,cAAc,CAAC,QAAgB,EAAE,MAAc;IAC5D,MAAM,KAAK,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,kBAAkB,EAAE,KAAK,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC;IACjG,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,MAAM,KAAK,CAAC,QAAQ,CAAC,EAAE,iBAAiB,EAAE,IAAI,EAAE,CAAC,CAAC;IACzE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;AAC5E,CAAC"}

package/dist/core/static-server.d.ts

@@ -0,0 +1,6 @@
+export type StaticServer = {
+    url: string;
+    port: number;
+    close(): Promise<void>;
+};
+export declare function startStaticServer(rootDir: string, preferredPort?: number): Promise<StaticServer>;

package/dist/core/static-server.js

@@ -0,0 +1,73 @@
+import { createReadStream } from 'node:fs';
+import { stat } from 'node:fs/promises';
+import { createServer } from 'node:http';
+import path from 'node:path';
+export async function startStaticServer(rootDir, preferredPort = 0) {
+    const root = path.resolve(rootDir);
+    const server = createServer(async (request, response) => {
+        try {
+            const requestUrl = new URL(request.url ?? '/', 'http://127.0.0.1');
+            const pathname = decodeURIComponent(requestUrl.pathname === '/' ? '/index.html' : requestUrl.pathname);
+            const filePath = path.resolve(root, `.${pathname}`);
+            if (!filePath.startsWith(root)) {
+                response.writeHead(403);
+                response.end('Forbidden');
+                return;
+            }
+            const fileStat = await stat(filePath);
+            if (!fileStat.isFile()) {
+                response.writeHead(404);
+                response.end('Not found');
+                return;
+            }
+            response.writeHead(200, { 'content-type': contentType(filePath) });
+            createReadStream(filePath).pipe(response);
+        }
+        catch {
+            response.writeHead(404);
+            response.end('Not found');
+        }
+    });
+    await new Promise((resolve, reject) => {
+        server.once('error', reject);
+        server.listen(preferredPort, '127.0.0.1', () => resolve());
+    });
+    const address = server.address();
+    if (typeof address !== 'object' || !address) {
+        throw new Error('Unable to determine static server port.');
+    }
+    return {
+        url: `http://127.0.0.1:${address.port}`,
+        port: address.port,
+        close: () => closeServer(server),
+    };
+}
+function closeServer(server) {
+    return new Promise((resolve, reject) => {
+        server.close((error) => {
+            if (error)
+                reject(error);
+            else
+                resolve();
+        });
+    });
+}
+function contentType(filePath) {
+    const extension = path.extname(filePath).toLowerCase();
+    if (extension === '.html')
+        return 'text/html; charset=utf-8';
+    if (extension === '.css')
+        return 'text/css; charset=utf-8';
+    if (extension === '.js')
+        return 'text/javascript; charset=utf-8';
+    if (extension === '.json')
+        return 'application/json; charset=utf-8';
+    if (extension === '.png')
+        return 'image/png';
+    if (extension === '.jpg' || extension === '.jpeg')
+        return 'image/jpeg';
+    if (extension === '.svg')
+        return 'image/svg+xml';
+    return 'application/octet-stream';
+}
+//# sourceMappingURL=static-server.js.map

package/dist/core/static-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"static-server.js","sourceRoot":"","sources":["../../src/core/static-server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACxC,OAAO,EAAE,YAAY,EAAe,MAAM,WAAW,CAAC;AACtD,OAAO,IAAI,MAAM,WAAW,CAAC;AAQ7B,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,OAAe,EAAE,aAAa,GAAG,CAAC;IACxE,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACnC,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE;QACtD,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,IAAI,GAAG,EAAE,kBAAkB,CAAC,CAAC;YACnE,MAAM,QAAQ,GAAG,kBAAkB,CAAC,UAAU,CAAC,QAAQ,KAAK,GAAG,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;YACvG,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,QAAQ,EAAE,CAAC,CAAC;YAEpD,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC/B,QAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;gBACxB,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;gBAC1B,OAAO;YACT,CAAC;YAED,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC;YACtC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;gBACvB,QAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;gBACxB,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;gBAC1B,OAAO;YACT,CAAC;YAED,QAAQ,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,WAAW,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;YACnE,gBAAgB,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC5C,CAAC;QAAC,MAAM,CAAC;YACP,QAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;YACxB,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAC1C,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC7B,MAAM,CAAC,MAAM,CAAC,aAAa,EAAE,WAAW,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;IAEH,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC;IACjC,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,CAAC,OAAO,EAAE,CAAC;QAC5C,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;IAC7D,CAAC;IAED,OAAO;QACL,GAAG,EAAE,oBAAoB,OAAO,CAAC,IAAI,EAAE;QACvC,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,KAAK,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC,MAAM,CAAC;KACjC,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAAC,MAAc;IACjC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;YACrB,IAAI,KAAK;gBAAE,MAAM,CAAC,KAAK,CAAC,CAAC;;gBACpB,OAAO,EAAE,CAAC;QACjB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,WAAW,CAAC,QAAgB;IACnC,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;IACvD,IAAI,SAAS,KAAK,OAAO;QAAE,OAAO,0BAA0B,CAAC;IAC7D,IAAI,SAAS,KAAK,MAAM;QAAE,OAAO,yBAAyB,CAAC;IAC3D,IAAI,SAAS,KAAK,KAAK;QAAE,OAAO,gCAAgC,CAAC;IACjE,IAAI,SAAS,KAAK,OAAO;QAAE,OAAO,iCAAiC,CAAC;IACpE,IAAI,SAAS,KAAK,MAAM;QAAE,OAAO,WAAW,CAAC;IAC7C,IAAI,SAAS,KAAK,MAAM,IAAI,SAAS,KAAK,OAAO;QAAE,OAAO,YAAY,CAAC;IACvE,IAAI,SAAS,KAAK,MAAM;QAAE,OAAO,eAAe,CAAC;IACjD,OAAO,0BAA0B,CAAC;AACpC,CAAC"}

package/dist/core/visual-spec-agent-pack.d.ts

@@ -0,0 +1,27 @@
+import type { TargetPaths } from './workspace.js';
+export declare function writeImageReferenceSpecPack(input: {
+    target: TargetPaths;
+    captureDir: string;
+    referenceUrl: string;
+    referencePath: string;
+    sideBySidePath: string;
+    headed?: boolean;
+    instructionsPath?: string;
+}): Promise<{
+    promptPath: string;
+    codexPromptPath: string;
+    claudePromptPath: string;
+    factsPath: string;
+    examplePath: string;
+    schemaPath: string;
+    instructionsPath: string;
+    responsePath: string;
+    status: 'awaiting-agent' | 'validated' | 'invalid';
+    validationErrors?: string[];
+    specPaths?: {
+        idealSpecPath: string;
+        referenceSpecPath: string;
+        diffPath: string;
+    };
+    diffHighlights?: string[];
+}>;

package/dist/core/visual-spec-agent-pack.js

@@ -0,0 +1,143 @@
+import { mkdir, readFile, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import { visualSpecBundleSchema, createVisualSpecBundleExample, createVisualSpecJsonSchema, } from '../schemas/visual-spec.js';
+import { buildClaudePrompt, buildCodexPrompt, buildSharedPrompt } from './visual-spec-prompts.js';
+import { writeIfMissing } from './workspace.js';
+import { collectReferenceDomFacts } from './reference-dom-facts.js';
+export async function writeImageReferenceSpecPack(input) {
+    const specDir = path.join(input.captureDir, 'spec');
+    const promptPath = path.join(specDir, 'agent-prompt.md');
+    const codexPromptPath = path.join(specDir, 'agent-prompt.codex.md');
+    const claudePromptPath = path.join(specDir, 'agent-prompt.claude.md');
+    const factsPath = path.join(specDir, 'reference-dom-facts.json');
+    const examplePath = path.join(specDir, 'agent-response.example.json');
+    const schemaPath = path.join(specDir, 'agent-response.schema.json');
+    const responsePath = path.join(specDir, 'agent-response.json');
+    const instructionsPath = input.instructionsPath ?? path.join(input.target.contractDir, 'visual-spec-instructions.md');
+    const facts = await collectReferenceDomFacts(input.referenceUrl, input.headed);
+    await writeIfMissing(instructionsPath, defaultInstructions());
+    const customInstructions = await readFile(instructionsPath, 'utf8');
+    await mkdir(specDir, { recursive: true });
+    await Promise.all([
+        writeJson(factsPath, facts),
+        writeJson(schemaPath, createVisualSpecJsonSchema()),
+        writeIfMissing(examplePath, JSON.stringify(createVisualSpecBundleExample(), null, 2) + '\n'),
+        writeFile(promptPath, buildSharedPrompt({
+            target: input.target,
+            referencePath: input.referencePath,
+            sideBySidePath: input.sideBySidePath,
+            factsPath,
+            examplePath,
+            schemaPath,
+            responsePath,
+            instructionsPath,
+            customInstructions,
+        })),
+        writeFile(codexPromptPath, buildCodexPrompt({
+            target: input.target,
+            promptPath,
+            referencePath: input.referencePath,
+            sideBySidePath: input.sideBySidePath,
+            factsPath,
+            schemaPath,
+            responsePath,
+            instructionsPath,
+        })),
+        writeFile(claudePromptPath, buildClaudePrompt({
+            target: input.target,
+            promptPath,
+            referencePath: input.referencePath,
+            sideBySidePath: input.sideBySidePath,
+            factsPath,
+            schemaPath,
+            responsePath,
+            instructionsPath,
+        })),
+    ]);
+    const response = await readBundle(responsePath);
+    if (response.status === 'missing') {
+        return { promptPath, codexPromptPath, claudePromptPath, factsPath, examplePath, schemaPath, instructionsPath, responsePath, status: 'awaiting-agent' };
+    }
+    if (response.status === 'invalid-json') {
+        return {
+            promptPath,
+            codexPromptPath,
+            claudePromptPath,
+            factsPath,
+            examplePath,
+            schemaPath,
+            instructionsPath,
+            responsePath,
+            status: 'invalid',
+            validationErrors: ['agent-response.json: Invalid JSON.'],
+        };
+    }
+    const parsed = visualSpecBundleSchema.safeParse(response.value);
+    if (!parsed.success) {
+        return {
+            promptPath,
+            codexPromptPath,
+            claudePromptPath,
+            factsPath,
+            examplePath,
+            schemaPath,
+            instructionsPath,
+            responsePath,
+            status: 'invalid',
+            validationErrors: parsed.error.issues.map((issue) => `${issue.path.join('.')}: ${issue.message}`),
+        };
+    }
+    const specPaths = {
+        idealSpecPath: path.join(input.captureDir, 'ideal-visual-spec.json'),
+        referenceSpecPath: path.join(input.captureDir, 'reference-visual-spec.json'),
+        diffPath: path.join(input.captureDir, 'visual-spec-diff.json'),
+    };
+    await Promise.all([
+        writeJson(specPaths.idealSpecPath, parsed.data.idealSpec),
+        writeJson(specPaths.referenceSpecPath, parsed.data.referenceSpec),
+        writeJson(specPaths.diffPath, parsed.data.diff),
+    ]);
+    return {
+        promptPath,
+        codexPromptPath,
+        claudePromptPath,
+        factsPath,
+        examplePath,
+        schemaPath,
+        instructionsPath,
+        responsePath,
+        status: 'validated',
+        specPaths,
+        diffHighlights: parsed.data.diff.mismatches.slice(0, 4).map((finding) => `${finding.area}: ${finding.impact}`),
+    };
+}
+async function readBundle(filePath) {
+    try {
+        return { status: 'ok', value: JSON.parse(await readFile(filePath, 'utf8')) };
+    }
+    catch {
+        try {
+            await readFile(filePath, 'utf8');
+            return { status: 'invalid-json' };
+        }
+        catch {
+            return { status: 'missing' };
+        }
+    }
+}
+async function writeJson(filePath, value) {
+    await writeFile(filePath, JSON.stringify(value, null, 2) + '\n');
+}
+function defaultInstructions() {
+    return `# Visual Spec Instructions
+
+Add target-specific guidance for Codex or Claude here.
+
+Examples:
+
+- Preserve the product stance around side-by-side screenshots as visual ground truth.
+- Treat copy, disabled state semantics, and mobile behavior as first-class evidence.
+- Call out uncertainty instead of inventing exact measurements from the images.
+`;
+}
+//# sourceMappingURL=visual-spec-agent-pack.js.map

package/dist/core/visual-spec-agent-pack.js.map

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