@neonwatty/limner 0.1.0 → 0.1.2

package/dist/core/agent-comparison-pack.d.ts

@@ -0,0 +1,30 @@
+import type { AgentComparisonProfileName } from './agent-comparison-profiles.js';
+export type AgentComparisonPackResult = {
+    promptPath: string;
+    codexPromptPath: string;
+    claudePromptPath: string;
+    schemaPath: string;
+    examplePath: string;
+    responsePath: string;
+    status: 'awaiting-agent' | 'validated' | 'invalid';
+    validationErrors?: string[];
+    imageComparisonPath?: string;
+    structureComparisonPath?: string;
+    summaryPath?: string;
+    scoreHighlights?: string[];
+};
+export declare function writeAgentComparisonPack(input: {
+    workspaceRoot: string;
+    captureDir: string;
+    mode: 'image-reference' | 'reference-implementation';
+    profile: AgentComparisonProfileName;
+    imageInputs: {
+        expectedImagePath: string;
+        actualImagePath: string;
+    };
+    structureInputs?: {
+        expectedStructurePath: string;
+        actualStructurePath: string;
+        structureKind: 'visual-spec' | 'dom-metrics' | 'html' | 'json-description';
+    };
+}): Promise<AgentComparisonPackResult>;

package/dist/core/agent-comparison-pack.js

@@ -0,0 +1,148 @@
+import { mkdir, readFile, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import { agentComparisonBundleSchema, createAgentComparisonBundleExample, createAgentComparisonJsonSchema, } from '../schemas/comparison.js';
+import { clearAgentComparisonOutputs, createInputFingerprint } from './agent-comparison-fingerprint.js';
+import { buildAgentComparisonPrompt, buildClaudeAgentComparisonPrompt, buildCodexAgentComparisonPrompt, } from './agent-comparison-prompts.js';
+import { validateFixTargets } from './agent-comparison-validation.js';
+export async function writeAgentComparisonPack(input) {
+    const packDir = path.join(input.captureDir, 'agent-comparison');
+    const promptPath = path.join(packDir, 'agent-prompt.md');
+    const codexPromptPath = path.join(packDir, 'agent-prompt.codex.md');
+    const claudePromptPath = path.join(packDir, 'agent-prompt.claude.md');
+    const schemaPath = path.join(packDir, 'agent-response.schema.json');
+    const examplePath = path.join(packDir, 'agent-response.example.json');
+    const responsePath = path.join(packDir, 'agent-response.json');
+    const inputFingerprint = await createInputFingerprint(input);
+    const promptInput = { ...input, schemaPath, responsePath, inputFingerprint };
+    await mkdir(packDir, { recursive: true });
+    await clearAgentComparisonOutputs(input.captureDir);
+    await Promise.all([
+        writeJson(schemaPath, createAgentComparisonJsonSchema(input.structureInputs ? 'image-and-structure' : 'image-only')),
+        writeJson(examplePath, createExample(input, inputFingerprint)),
+        writeFile(promptPath, buildAgentComparisonPrompt(promptInput)),
+        writeFile(codexPromptPath, buildCodexAgentComparisonPrompt(promptInput)),
+        writeFile(claudePromptPath, buildClaudeAgentComparisonPrompt(promptInput)),
+    ]);
+    const response = await readBundle(responsePath);
+    const base = { promptPath, codexPromptPath, claudePromptPath, schemaPath, examplePath, responsePath };
+    if (response.status === 'missing') {
+        return { ...base, status: 'awaiting-agent' };
+    }
+    if (response.status === 'invalid-json') {
+        return { ...base, status: 'invalid', validationErrors: ['agent-response.json: Invalid JSON.'] };
+    }
+    const parsed = agentComparisonBundleSchema.safeParse(response.value);
+    if (!parsed.success) {
+        return { ...base, status: 'invalid', validationErrors: parsed.error.issues.map((issue) => `${issue.path.join('.')}: ${issue.message}`) };
+    }
+    const activeErrors = validateActiveComparison({ ...input, inputFingerprint }, parsed.data);
+    if (activeErrors.length > 0) {
+        return { ...base, status: 'invalid', validationErrors: activeErrors };
+    }
+    const imageComparisonPath = path.join(input.captureDir, 'image-comparison.json');
+    const structureComparisonPath = parsed.data.structureComparison ? path.join(input.captureDir, 'structure-comparison.json') : undefined;
+    const summaryPath = path.join(input.captureDir, 'comparison-summary.json');
+    await writeJson(imageComparisonPath, parsed.data.imageComparison);
+    if (parsed.data.structureComparison && structureComparisonPath) {
+        await writeJson(structureComparisonPath, parsed.data.structureComparison);
+    }
+    await writeJson(summaryPath, parsed.data);
+    return {
+        ...base,
+        status: 'validated',
+        imageComparisonPath,
+        structureComparisonPath,
+        summaryPath,
+        scoreHighlights: [
+            `Agent image score: ${parsed.data.imageComparison.score.overall}`,
+            ...(parsed.data.structureComparison ? [`Agent structure score: ${parsed.data.structureComparison.score.overall}`] : []),
+        ],
+    };
+}
+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' };
+        }
+    }
+}
+function createExample(input, inputFingerprint) {
+    const example = createAgentComparisonBundleExample(input.structureInputs ? 'image-and-structure' : 'image-only', inputFingerprint);
+    example.profile = input.profile;
+    example.imageComparison.inputs = {
+        expectedImagePath: relative(input.workspaceRoot, input.imageInputs.expectedImagePath),
+        actualImagePath: relative(input.workspaceRoot, input.imageInputs.actualImagePath),
+    };
+    if (input.structureInputs && example.structureComparison) {
+        example.structureComparison.inputs = {
+            expectedStructurePath: relative(input.workspaceRoot, input.structureInputs.expectedStructurePath),
+            actualStructurePath: relative(input.workspaceRoot, input.structureInputs.actualStructurePath),
+            structureKind: input.structureInputs.structureKind,
+        };
+    }
+    return example;
+}
+function validateActiveComparison(input, bundle) {
+    const errors = [];
+    if (bundle.profile !== input.profile)
+        errors.push(`profile: Expected ${input.profile}.`);
+    const expectedSurface = input.profile === 'ideal-to-mockup' ? 'mockup' : 'implementation';
+    if (!matchesPath(input.workspaceRoot, input.imageInputs.expectedImagePath, bundle.imageComparison.inputs.expectedImagePath)) {
+        errors.push('imageComparison.inputs.expectedImagePath: Does not match the active expected image.');
+    }
+    if (!matchesPath(input.workspaceRoot, input.imageInputs.actualImagePath, bundle.imageComparison.inputs.actualImagePath)) {
+        errors.push('imageComparison.inputs.actualImagePath: Does not match the active actual image.');
+    }
+    if (bundle.inputFingerprint.expectedImageSha256 !== input.inputFingerprint.expectedImageSha256) {
+        errors.push('inputFingerprint.expectedImageSha256: Does not match the active expected image.');
+    }
+    if (bundle.inputFingerprint.actualImageSha256 !== input.inputFingerprint.actualImageSha256) {
+        errors.push('inputFingerprint.actualImageSha256: Does not match the active actual image.');
+    }
+    validateFixTargets(errors, 'imageComparison', bundle.imageComparison.majorDiffAreas, expectedSurface);
+    if (!input.structureInputs && bundle.structureComparison) {
+        errors.push('structureComparison: Not expected for this comparison.');
+    }
+    if (!input.structureInputs && (bundle.inputFingerprint.expectedStructureSha256 || bundle.inputFingerprint.actualStructureSha256)) {
+        errors.push('inputFingerprint: Structure hashes are not expected for this comparison.');
+    }
+    if (input.structureInputs && !bundle.structureComparison) {
+        errors.push('structureComparison: Required for this comparison.');
+    }
+    if (input.structureInputs && bundle.structureComparison) {
+        validateFixTargets(errors, 'structureComparison', bundle.structureComparison.majorDiffAreas, expectedSurface);
+        if (bundle.inputFingerprint.expectedStructureSha256 !== input.inputFingerprint.expectedStructureSha256) {
+            errors.push('inputFingerprint.expectedStructureSha256: Does not match the active expected structure.');
+        }
+        if (bundle.inputFingerprint.actualStructureSha256 !== input.inputFingerprint.actualStructureSha256) {
+            errors.push('inputFingerprint.actualStructureSha256: Does not match the active actual structure.');
+        }
+        if (!matchesPath(input.workspaceRoot, input.structureInputs.expectedStructurePath, bundle.structureComparison.inputs.expectedStructurePath)) {
+            errors.push('structureComparison.inputs.expectedStructurePath: Does not match the active expected structure.');
+        }
+        if (!matchesPath(input.workspaceRoot, input.structureInputs.actualStructurePath, bundle.structureComparison.inputs.actualStructurePath)) {
+            errors.push('structureComparison.inputs.actualStructurePath: Does not match the active actual structure.');
+        }
+        if (bundle.structureComparison.inputs.structureKind !== input.structureInputs.structureKind) {
+            errors.push(`structureComparison.inputs.structureKind: Expected ${input.structureInputs.structureKind}.`);
+        }
+    }
+    return errors;
+}
+function matchesPath(root, expectedAbsolute, actual) {
+    return actual === expectedAbsolute || actual === relative(root, expectedAbsolute);
+}
+function relative(root, filePath) {
+    return path.relative(root, filePath);
+}
+async function writeJson(filePath, value) {
+    await writeFile(filePath, JSON.stringify(value, null, 2) + '\n');
+}
+//# sourceMappingURL=agent-comparison-pack.js.map

package/dist/core/agent-comparison-pack.js.map

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

package/dist/core/agent-comparison-profiles.d.ts

@@ -0,0 +1,9 @@
+export type AgentComparisonProfileName = 'ideal-to-mockup' | 'mockup-to-implementation';
+export type AgentComparisonProfile = {
+    name: AgentComparisonProfileName;
+    expectedRole: string;
+    actualRole: string;
+    editableSurface: 'mockup' | 'implementation';
+    instruction: string;
+};
+export declare function getAgentComparisonProfile(name: AgentComparisonProfileName): AgentComparisonProfile;

package/dist/core/agent-comparison-profiles.js

@@ -0,0 +1,19 @@
+export function getAgentComparisonProfile(name) {
+    if (name === 'ideal-to-mockup') {
+        return {
+            name,
+            expectedRole: 'ideal image',
+            actualRole: 'HTML mockup screenshot',
+            editableSurface: 'mockup',
+            instruction: 'Focus on changes to the HTML/CSS mockup that will make the next screenshot closer to the ideal.',
+        };
+    }
+    return {
+        name,
+        expectedRole: 'approved HTML mockup screenshot',
+        actualRole: 'implementation screenshot',
+        editableSurface: 'implementation',
+        instruction: 'Treat the mockup as canonical and focus on implementation changes that will match it.',
+    };
+}
+//# sourceMappingURL=agent-comparison-profiles.js.map

package/dist/core/agent-comparison-profiles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-comparison-profiles.js","sourceRoot":"","sources":["../../src/core/agent-comparison-profiles.ts"],"names":[],"mappings":"AAUA,MAAM,UAAU,yBAAyB,CAAC,IAAgC;IACxE,IAAI,IAAI,KAAK,iBAAiB,EAAE,CAAC;QAC/B,OAAO;YACL,IAAI;YACJ,YAAY,EAAE,aAAa;YAC3B,UAAU,EAAE,wBAAwB;YACpC,eAAe,EAAE,QAAQ;YACzB,WAAW,EAAE,iGAAiG;SAC/G,CAAC;IACJ,CAAC;IACD,OAAO;QACL,IAAI;QACJ,YAAY,EAAE,iCAAiC;QAC/C,UAAU,EAAE,2BAA2B;QACvC,eAAe,EAAE,gBAAgB;QACjC,WAAW,EAAE,uFAAuF;KACrG,CAAC;AACJ,CAAC"}

package/dist/core/agent-comparison-prompts.d.ts

@@ -0,0 +1,22 @@
+import type { AgentComparisonInputFingerprint } from '../schemas/comparison.js';
+import { type AgentComparisonProfileName } from './agent-comparison-profiles.js';
+type PromptInput = {
+    workspaceRoot: string;
+    profile: AgentComparisonProfileName;
+    responsePath: string;
+    schemaPath: string;
+    inputFingerprint: AgentComparisonInputFingerprint;
+    imageInputs: {
+        expectedImagePath: string;
+        actualImagePath: string;
+    };
+    structureInputs?: {
+        expectedStructurePath: string;
+        actualStructurePath: string;
+        structureKind: 'visual-spec' | 'dom-metrics' | 'html' | 'json-description';
+    };
+};
+export declare function buildAgentComparisonPrompt(input: PromptInput): string;
+export declare function buildCodexAgentComparisonPrompt(input: PromptInput): string;
+export declare function buildClaudeAgentComparisonPrompt(input: PromptInput): string;
+export {};

package/dist/core/agent-comparison-prompts.js

@@ -0,0 +1,84 @@
+import path from 'node:path';
+import { getAgentComparisonProfile } from './agent-comparison-profiles.js';
+export function buildAgentComparisonPrompt(input) {
+    const profile = getAgentComparisonProfile(input.profile);
+    return `# Limner Agent UX Comparison
+
+Profile: \`${profile.name}\`
+Expected role: ${profile.expectedRole}
+Actual role: ${profile.actualRole}
+Editable surface: ${profile.editableSurface}
+
+${profile.instruction}
+
+## Image Inputs
+
+- Expected image: \`${rel(input, input.imageInputs.expectedImagePath)}\`
+- Actual image: \`${rel(input, input.imageInputs.actualImagePath)}\`
+
+## Input Fingerprint
+
+Copy these values exactly into \`inputFingerprint\`. Limner uses them to reject stale responses after screenshots or structure files change.
+
+- \`expectedImageSha256\`: \`${input.inputFingerprint.expectedImageSha256}\`
+- \`actualImageSha256\`: \`${input.inputFingerprint.actualImageSha256}\`
+${formatStructureFingerprint(input.inputFingerprint)}
+
+Inspect the expected and actual images separately before using side-by-side context.
+Focus on the next implementation iteration, not exhaustive critique.
+Name only high-signal UX diffs: layout, hierarchy, typography, color, spacing, component anatomy, copy/state, and attention flow.
+${formatStructureSection(input)}
+Use this JSON schema:
+
+- \`${rel(input, input.schemaPath)}\`
+
+Write valid JSON only to:
+
+- \`${rel(input, input.responsePath)}\`
+
+Rules:
+
+- Scores are 0..1 estimates, not pass/fail judgments.
+- Do not invent diffs when the artifacts match; empty \`majorDiffAreas\` and empty next steps are valid.
+- Every diff must include evidence, impact, and a recommended change for the editable surface.
+- Use \`systemFeedback\` only for issues with Limner inputs, missing context, or prompt/tooling quality.
+`;
+}
+export function buildCodexAgentComparisonPrompt(input) {
+    return `${buildAgentComparisonPrompt(input)}
+## Codex Instructions
+
+Read the local files directly. Create or overwrite \`${rel(input, input.responsePath)}\` with JSON matching the schema.
+`;
+}
+export function buildClaudeAgentComparisonPrompt(input) {
+    return `${buildAgentComparisonPrompt(input)}
+## Claude Instructions
+
+Attach the referenced images, inspect them separately, and return JSON matching the schema. Copy that JSON into \`${rel(input, input.responsePath)}\`.
+`;
+}
+function formatStructureFingerprint(fingerprint) {
+    if (!fingerprint.expectedStructureSha256 || !fingerprint.actualStructureSha256)
+        return '';
+    return `- \`expectedStructureSha256\`: \`${fingerprint.expectedStructureSha256}\`
+- \`actualStructureSha256\`: \`${fingerprint.actualStructureSha256}\``;
+}
+function formatStructureSection(input) {
+    if (!input.structureInputs) {
+        return '';
+    }
+    return `
+## Structure Inputs
+
+- Expected structure: \`${rel(input, input.structureInputs.expectedStructurePath)}\`
+- Actual structure: \`${rel(input, input.structureInputs.actualStructurePath)}\`
+- Structure kind: \`${input.structureInputs.structureKind}\`
+
+Use structure evidence to support image findings and to produce a structure-vs-structure comparison.
+`;
+}
+function rel(input, filePath) {
+    return path.relative(input.workspaceRoot, filePath);
+}
+//# sourceMappingURL=agent-comparison-prompts.js.map

package/dist/core/agent-comparison-prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-comparison-prompts.js","sourceRoot":"","sources":["../../src/core/agent-comparison-prompts.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,OAAO,EAAE,yBAAyB,EAAmC,MAAM,gCAAgC,CAAC;AAmB5G,MAAM,UAAU,0BAA0B,CAAC,KAAkB;IAC3D,MAAM,OAAO,GAAG,yBAAyB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACzD,OAAO;;aAEI,OAAO,CAAC,IAAI;iBACR,OAAO,CAAC,YAAY;eACtB,OAAO,CAAC,UAAU;oBACb,OAAO,CAAC,eAAe;;EAEzC,OAAO,CAAC,WAAW;;;;sBAIC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,WAAW,CAAC,iBAAiB,CAAC;oBACjD,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,WAAW,CAAC,eAAe,CAAC;;;;;;+BAMlC,KAAK,CAAC,gBAAgB,CAAC,mBAAmB;6BAC5C,KAAK,CAAC,gBAAgB,CAAC,iBAAiB;EACnE,0BAA0B,CAAC,KAAK,CAAC,gBAAgB,CAAC;;;;;EAKlD,sBAAsB,CAAC,KAAK,CAAC;;;MAGzB,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,UAAU,CAAC;;;;MAI5B,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,YAAY,CAAC;;;;;;;;CAQnC,CAAC;AACF,CAAC;AAED,MAAM,UAAU,+BAA+B,CAAC,KAAkB;IAChE,OAAO,GAAG,0BAA0B,CAAC,KAAK,CAAC;;;uDAGU,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,YAAY,CAAC;CACpF,CAAC;AACF,CAAC;AAED,MAAM,UAAU,gCAAgC,CAAC,KAAkB;IACjE,OAAO,GAAG,0BAA0B,CAAC,KAAK,CAAC;;;oHAGuE,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,YAAY,CAAC;CACjJ,CAAC;AACF,CAAC;AAED,SAAS,0BAA0B,CAAC,WAA4C;IAC9E,IAAI,CAAC,WAAW,CAAC,uBAAuB,IAAI,CAAC,WAAW,CAAC,qBAAqB;QAAE,OAAO,EAAE,CAAC;IAC1F,OAAO,oCAAoC,WAAW,CAAC,uBAAuB;iCAC/C,WAAW,CAAC,qBAAqB,IAAI,CAAC;AACvE,CAAC;AAED,SAAS,sBAAsB,CAAC,KAAkB;IAChD,IAAI,CAAC,KAAK,CAAC,eAAe,EAAE,CAAC;QAC3B,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO;;;0BAGiB,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,eAAe,CAAC,qBAAqB,CAAC;wBACzD,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,eAAe,CAAC,mBAAmB,CAAC;sBACvD,KAAK,CAAC,eAAe,CAAC,aAAa;;;CAGxD,CAAC;AACF,CAAC;AAED,SAAS,GAAG,CAAC,KAAkB,EAAE,QAAgB;IAC/C,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC;AACtD,CAAC"}

package/dist/core/agent-comparison-report.d.ts

@@ -0,0 +1,3 @@
+import type { AgentComparisonPackResult } from './agent-comparison-pack.js';
+export declare function formatAgentComparisonArtifacts(root: string, agentComparison?: AgentComparisonPackResult): string;
+export declare function formatAgentComparisonStatus(agentComparison?: AgentComparisonPackResult): string;

package/dist/core/agent-comparison-report.js

@@ -0,0 +1,56 @@
+import path from 'node:path';
+export function formatAgentComparisonArtifacts(root, agentComparison) {
+    if (!agentComparison) {
+        return '';
+    }
+    const lines = [
+        `- Agent comparison prompt: \`${relative(root, agentComparison.promptPath)}\``,
+        `- Codex comparison prompt: \`${relative(root, agentComparison.codexPromptPath)}\``,
+        `- Claude comparison prompt: \`${relative(root, agentComparison.claudePromptPath)}\``,
+        `- Agent comparison schema: \`${relative(root, agentComparison.schemaPath)}\``,
+        `- Agent comparison response: \`${relative(root, agentComparison.responsePath)}\``,
+    ];
+    if (agentComparison.imageComparisonPath) {
+        lines.push(`- Image comparison: \`${relative(root, agentComparison.imageComparisonPath)}\``);
+    }
+    if (agentComparison.structureComparisonPath) {
+        lines.push(`- Structure comparison: \`${relative(root, agentComparison.structureComparisonPath)}\``);
+    }
+    if (agentComparison.summaryPath) {
+        lines.push(`- Comparison summary: \`${relative(root, agentComparison.summaryPath)}\``);
+    }
+    return `\n${lines.join('\n')}`;
+}
+export function formatAgentComparisonStatus(agentComparison) {
+    if (!agentComparison) {
+        return '';
+    }
+    if (agentComparison.status === 'awaiting-agent') {
+        return `
+
+## Agent Comparison
+
+- Status: awaiting agent response.
+- Next step: have an agent inspect the comparison prompt, write \`${path.basename(agentComparison.responsePath)}\`, then rerun this compare command.`;
+    }
+    if (agentComparison.status === 'invalid') {
+        const errors = agentComparison.validationErrors?.map((error) => `- ${error}`).join('\n') ?? '- Unknown validation error.';
+        return `
+
+## Agent Comparison
+
+- Status: invalid agent response.
+
+${errors}`;
+    }
+    return `
+
+## Agent Comparison
+
+- Status: validated.
+${agentComparison.scoreHighlights?.map((highlight) => `- ${highlight}`).join('\n') ?? '- Agent comparison artifacts validated.'}`;
+}
+function relative(root, filePath) {
+    return path.relative(root, filePath);
+}
+//# sourceMappingURL=agent-comparison-report.js.map

package/dist/core/agent-comparison-report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-comparison-report.js","sourceRoot":"","sources":["../../src/core/agent-comparison-report.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAI7B,MAAM,UAAU,8BAA8B,CAAC,IAAY,EAAE,eAA2C;IACtG,IAAI,CAAC,eAAe,EAAE,CAAC;QACrB,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,MAAM,KAAK,GAAG;QACZ,gCAAgC,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC,UAAU,CAAC,IAAI;QAC9E,gCAAgC,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC,eAAe,CAAC,IAAI;QACnF,iCAAiC,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC,gBAAgB,CAAC,IAAI;QACrF,gCAAgC,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC,UAAU,CAAC,IAAI;QAC9E,kCAAkC,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC,YAAY,CAAC,IAAI;KACnF,CAAC;IACF,IAAI,eAAe,CAAC,mBAAmB,EAAE,CAAC;QACxC,KAAK,CAAC,IAAI,CAAC,yBAAyB,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC;IAC/F,CAAC;IACD,IAAI,eAAe,CAAC,uBAAuB,EAAE,CAAC;QAC5C,KAAK,CAAC,IAAI,CAAC,6BAA6B,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC,uBAAuB,CAAC,IAAI,CAAC,CAAC;IACvG,CAAC;IACD,IAAI,eAAe,CAAC,WAAW,EAAE,CAAC;QAChC,KAAK,CAAC,IAAI,CAAC,2BAA2B,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IACzF,CAAC;IACD,OAAO,KAAK,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,eAA2C;IACrF,IAAI,CAAC,eAAe,EAAE,CAAC;QACrB,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,IAAI,eAAe,CAAC,MAAM,KAAK,gBAAgB,EAAE,CAAC;QAChD,OAAO;;;;;oEAKyD,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC,YAAY,CAAC,sCAAsC,CAAC;IACpJ,CAAC;IACD,IAAI,eAAe,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QACzC,MAAM,MAAM,GAAG,eAAe,CAAC,gBAAgB,EAAE,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,6BAA6B,CAAC;QAC1H,OAAO;;;;;;EAMT,MAAM,EAAE,CAAC;IACT,CAAC;IACD,OAAO;;;;;EAKP,eAAe,CAAC,eAAe,EAAE,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,KAAK,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,yCAAyC,EAAE,CAAC;AAClI,CAAC;AAED,SAAS,QAAQ,CAAC,IAAY,EAAE,QAAgB;IAC9C,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AACvC,CAAC"}

package/dist/core/agent-comparison-validation.d.ts

@@ -0,0 +1,2 @@
+import type { AgentComparisonBundle } from '../schemas/comparison.js';
+export declare function validateFixTargets(errors: string[], comparisonPath: 'imageComparison' | 'structureComparison', diffAreas: AgentComparisonBundle['imageComparison']['majorDiffAreas'], expectedSurface: 'mockup' | 'implementation'): void;

package/dist/core/agent-comparison-validation.js

@@ -0,0 +1,8 @@
+export function validateFixTargets(errors, comparisonPath, diffAreas, expectedSurface) {
+    diffAreas.forEach((diff, index) => {
+        if (diff.fixTarget && diff.fixTarget.surface !== expectedSurface && diff.fixTarget.surface !== 'unknown') {
+            errors.push(`${comparisonPath}.majorDiffAreas.${index}.fixTarget.surface: Expected ${expectedSurface} or unknown.`);
+        }
+    });
+}
+//# sourceMappingURL=agent-comparison-validation.js.map

package/dist/core/agent-comparison-validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-comparison-validation.js","sourceRoot":"","sources":["../../src/core/agent-comparison-validation.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,kBAAkB,CAChC,MAAgB,EAChB,cAAyD,EACzD,SAAqE,EACrE,eAA4C;IAE5C,SAAS,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;QAChC,IAAI,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,SAAS,CAAC,OAAO,KAAK,eAAe,IAAI,IAAI,CAAC,SAAS,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YACzG,MAAM,CAAC,IAAI,CAAC,GAAG,cAAc,mBAAmB,KAAK,gCAAgC,eAAe,cAAc,CAAC,CAAC;QACtH,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/core/playwright-capture.js

@@ -34,7 +34,7 @@ export async function capturePage(options) {
             bodyText,
         };
         await writeFile(`${options.outputPath}.console.json`, JSON.stringify(consoleMessages, null, 2) + '\n');
-        if (metrics.length > 0) {
+        if (options.contract) {
             await writeFile(`${options.outputPath}.metrics.json`, JSON.stringify(metrics, null, 2) + '\n');
         }
         return result;

package/dist/core/playwright-capture.js.map

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

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

@@ -1,3 +1,4 @@
+import type { AgentComparisonPackResult } from './agent-comparison-pack.js';
 import type { RegionMetrics } from './dom-metrics.js';
 import type { TargetPaths } from './workspace.js';
 export declare function writeImageReferenceReport(input: {
@@ -23,21 +24,16 @@ export declare function writeImageReferenceReport(input: {
         status: 'awaiting-agent' | 'validated' | 'invalid';
         validationErrors?: string[];
     };
+    agentComparison?: AgentComparisonPackResult;
 }): Promise<string>;
-export declare function writeReferenceAppReport(input: {
+export declare function writeReferenceImplementationReport(input: {
     target: TargetPaths;
     referencePath: string;
-    appPath: string;
+    implementationPath: 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;
+    implementationMetrics: RegionMetrics[];
+    implementationUrl: string;
+    agentComparison?: AgentComparisonPackResult;
 }): Promise<string>;
 export declare function writeTargetSummary(target: TargetPaths): Promise<string>;

package/dist/core/report-writer.js

@@ -1,5 +1,6 @@
 import { mkdir, readdir, stat, writeFile } from 'node:fs/promises';
 import path from 'node:path';
+import { formatAgentComparisonArtifacts, formatAgentComparisonStatus } from './agent-comparison-report.js';
 export async function writeImageReferenceReport(input) {
     const reportPath = path.join(input.target.reportsDir, 'image-reference.md');
     await mkdir(path.dirname(reportPath), { recursive: true });
@@ -13,6 +14,7 @@ Target: \`${input.target.name}\`
 - 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)}
+${formatAgentComparisonArtifacts(input.target.workspace.root, input.agentComparison)}
 
 ## Agent Critique
 
@@ -28,64 +30,40 @@ ${formatSpecArtifacts(input.target.workspace.root, input.specPaths, input.agentS
 - Record the highest-value scoped fix here.
 ${formatAgentSpecStatus(input.agentSpec)}
 ${formatSpecHighlights(input.specHighlights)}
+${formatAgentComparisonStatus(input.agentComparison)}
 `);
     return reportPath;
 }
-export async function writeReferenceAppReport(input) {
-    const reportPath = path.join(input.target.reportsDir, 'reference-app.md');
+export async function writeReferenceImplementationReport(input) {
+    const reportPath = path.join(input.target.reportsDir, 'reference-implementation.md');
     await mkdir(path.dirname(reportPath), { recursive: true });
-    await writeFile(reportPath, `# Reference To App Report
+    await writeFile(reportPath, `# Reference To Implementation Report
 
 Target: \`${input.target.name}\`
 
-App URL: ${input.appUrl}
+Implementation URL: ${input.implementationUrl}
 
 ## Artifacts
 
 - Reference screenshot: \`${relative(input.target.workspace.root, input.referencePath)}\`
-- App screenshot: \`${relative(input.target.workspace.root, input.appPath)}\`
+- Implementation screenshot: \`${relative(input.target.workspace.root, input.implementationPath)}\`
 - Side-by-side: \`${relative(input.target.workspace.root, input.sideBySidePath)}\`
+${formatAgentComparisonArtifacts(input.target.workspace.root, input.agentComparison)}
 
 ## Region Metrics
 
-${formatMetrics(input.referenceMetrics, input.appMetrics)}
+${formatMetrics(input.referenceMetrics, input.implementationMetrics)}
 
-## 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
+## Next Fix
 
-- Highest visual mismatch:
-- Evidence:
-- Suggested app fix:
-- Intentional deviations:
+- Use the validated agent comparison to choose the highest-value implementation fix.
+${formatAgentComparisonStatus(input.agentComparison)}
 `);
     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']) {
+    for (const dir of ['captures/image-reference', 'captures/reference-implementation', 'reports']) {
         const absoluteDir = path.join(target.root, dir);
         lines.push(`## ${dir}`, '');
         try {
@@ -103,16 +81,16 @@ export async function writeTargetSummary(target) {
     }
     return lines.join('\n');
 }
-function formatMetrics(referenceMetrics, appMetrics) {
-    const appById = new Map(appMetrics.map((metric) => [metric.id, metric]));
+function formatMetrics(referenceMetrics, implementationMetrics) {
+    const implementationById = new Map(implementationMetrics.map((metric) => [metric.id, metric]));
     const rows = referenceMetrics.map((reference) => {
-        const app = appById.get(reference.id);
+        const implementation = implementationById.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} |`;
+        const implementationBounds = implementation?.bounds ? `${implementation.bounds.width}x${implementation.bounds.height}` : 'missing';
+        return `| ${reference.id} | ${reference.found ? 'yes' : 'no'} | ${implementation?.found ? 'yes' : 'no'} | ${referenceBounds} | ${implementationBounds} |`;
     });
     return [
-        '| Region | Reference Found | App Found | Reference Bounds | App Bounds |',
+        '| Region | Reference Found | Implementation Found | Reference Bounds | Implementation Bounds |',
         '| --- | --- | --- | --- | --- |',
         ...rows,
     ].join('\n');
@@ -150,7 +128,7 @@ function formatAgentSpecStatus(agentSpec) {
 
 - 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.`;
+- Rerun \`limner 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.';