@neonwatty/limner 0.1.0 → 0.1.2

package/dist/schemas/comparison.js

@@ -0,0 +1,211 @@
+import { z } from 'zod';
+const score01Schema = z.number().min(0).max(1);
+const comparisonScoreSchema = z.object({
+    overall: score01Schema,
+    layout: score01Schema.optional(),
+    hierarchy: score01Schema.optional(),
+    typography: score01Schema.optional(),
+    color: score01Schema.optional(),
+    spacing: score01Schema.optional(),
+    structure: score01Schema.optional(),
+    semantics: score01Schema.optional(),
+});
+const hashSchema = z.string().regex(/^[a-f0-9]{64}$/);
+const inputFingerprintSchema = z.object({
+    expectedImageSha256: hashSchema,
+    actualImageSha256: hashSchema,
+    expectedStructureSha256: hashSchema.optional(),
+    actualStructureSha256: hashSchema.optional(),
+});
+const evidenceSchema = z.object({
+    source: z.string().min(1),
+    observation: z.string().min(1),
+});
+const fixTargetSchema = z.object({
+    surface: z.enum(['mockup', 'implementation', 'unknown']),
+    region: z.string().min(1).optional(),
+    likelyFiles: z.array(z.string()).default([]),
+    selectors: z.array(z.string()).default([]),
+});
+const diffAreaSchema = z.object({
+    id: z.string().min(1),
+    title: z.string().min(1),
+    category: z.enum(['layout', 'hierarchy', 'typography', 'color', 'spacing', 'component-anatomy', 'copy-state', 'attention-flow', 'other']),
+    severity: z.enum(['high', 'medium', 'low']),
+    priority: z.number().int().positive(),
+    expected: z.string().min(1),
+    actual: z.string().min(1),
+    impact: z.string().min(1),
+    evidence: z.array(evidenceSchema).min(1),
+    fixTarget: fixTargetSchema.optional(),
+    recommendedChange: z.string().min(1),
+});
+const nextIterationSchema = z.object({
+    focus: z.string().min(1),
+    steps: z.array(z.string()),
+    avoidForNow: z.array(z.string()).default([]),
+    expectedImprovement: z.string().min(1).optional(),
+});
+const remarksSchema = z.object({
+    matches: z.array(z.string()),
+    uncertainties: z.array(z.string()).default([]),
+    possibleIntentionalDeviations: z.array(z.string()).default([]),
+});
+const systemFeedbackSchema = z.object({
+    inputQuality: z.array(z.string()),
+    missingContext: z.array(z.string()).default([]),
+    suggestedLimnerImprovements: z.array(z.string()).default([]),
+});
+const baseComparisonSchema = z.object({
+    summary: z.string().min(1),
+    score: comparisonScoreSchema,
+    confidence: score01Schema,
+    majorDiffAreas: z.array(diffAreaSchema),
+    matches: z.array(z.string()),
+    remarks: remarksSchema,
+    systemFeedback: systemFeedbackSchema,
+    nextIteration: nextIterationSchema,
+    rationale: z.string().min(1),
+});
+export const imageComparisonSchema = baseComparisonSchema.extend({
+    kind: z.literal('image-vs-image'),
+    inputs: z.object({
+        expectedImagePath: z.string().min(1),
+        actualImagePath: z.string().min(1),
+    }),
+});
+export const structureComparisonSchema = baseComparisonSchema.extend({
+    kind: z.literal('structure-vs-structure'),
+    inputs: z.object({
+        expectedStructurePath: z.string().min(1),
+        actualStructurePath: z.string().min(1),
+        structureKind: z.enum(['visual-spec', 'dom-metrics', 'html', 'json-description']),
+    }),
+});
+export const agentComparisonBundleSchema = z.object({
+    version: z.literal(1),
+    generatedBy: z.literal('agent'),
+    profile: z.enum(['ideal-to-mockup', 'mockup-to-implementation']),
+    inputFingerprint: inputFingerprintSchema,
+    imageComparison: imageComparisonSchema,
+    structureComparison: structureComparisonSchema.optional(),
+    recommendation: z.object({
+        topFix: z.string().min(1).optional(),
+        why: z.string().min(1).optional(),
+        expectedScoreLift: score01Schema.optional(),
+    }).default({}),
+});
+export function createAgentComparisonBundleExample(mode, inputFingerprint = exampleFingerprint(mode)) {
+    const imageComparison = {
+        kind: 'image-vs-image',
+        inputs: {
+            expectedImagePath: 'targets/demo/source/ideal.png',
+            actualImagePath: 'targets/demo/captures/image-reference/reference.png',
+        },
+        summary: 'The screens preserve the same overall layout, with hierarchy and typography drift.',
+        score: { overall: 0.82, layout: 0.9, hierarchy: 0.74, typography: 0.76, color: 0.85, spacing: 0.8 },
+        confidence: 0.78,
+        majorDiffAreas: [exampleDiff('hero-heading', 'Hero heading lacks visual dominance', 'mockup')],
+        matches: ['Primary content appears in the same broad region.'],
+        remarks: {
+            matches: ['Overall single-column composition is similar.'],
+            uncertainties: ['Exact font family cannot be determined from screenshots alone.'],
+            possibleIntentionalDeviations: [],
+        },
+        systemFeedback: {
+            inputQuality: ['Both screenshots are readable and appear to use the same viewport.'],
+            missingContext: [],
+            suggestedLimnerImprovements: ['Include computed font metrics for the hero region when available.'],
+        },
+        nextIteration: {
+            focus: 'Tune the hero heading size, weight, and contrast.',
+            steps: ['Increase heading font size by one scale step.', 'Use a heavier font weight.'],
+            avoidForNow: ['Do not spend the next iteration on tiny border-radius differences.'],
+            expectedImprovement: 'This should improve hierarchy more than small spacing changes.',
+        },
+        rationale: 'The composition is close, but visual priority differs enough to warrant another iteration.',
+    };
+    if (mode === 'image-only') {
+        return { version: 1, generatedBy: 'agent', profile: 'ideal-to-mockup', inputFingerprint, imageComparison, recommendation: {} };
+    }
+    imageComparison.inputs = {
+        expectedImagePath: 'targets/demo/captures/reference-implementation/reference.png',
+        actualImagePath: 'targets/demo/captures/reference-implementation/implementation.png',
+    };
+    imageComparison.summary = 'The implementation preserves the mockup layout, with hierarchy and typography drift.';
+    imageComparison.majorDiffAreas = [exampleDiff('hero-heading', 'Hero heading lacks visual dominance', 'implementation')];
+    imageComparison.nextIteration = {
+        focus: 'Tune the implementation hero heading size, weight, and contrast.',
+        steps: ['Increase implementation heading font size by one scale step.', 'Use a heavier font weight.'],
+        avoidForNow: ['Do not spend the next iteration on tiny border-radius differences.'],
+        expectedImprovement: 'This should improve implementation hierarchy more than small spacing changes.',
+    };
+    return {
+        version: 1,
+        generatedBy: 'agent',
+        profile: 'mockup-to-implementation',
+        inputFingerprint,
+        imageComparison,
+        structureComparison: {
+            kind: 'structure-vs-structure',
+            inputs: {
+                expectedStructurePath: 'targets/demo/captures/reference-implementation/reference.png.metrics.json',
+                actualStructurePath: 'targets/demo/captures/reference-implementation/implementation.png.metrics.json',
+                structureKind: 'dom-metrics',
+            },
+            summary: 'The region structure is mostly preserved, but the heading style differs.',
+            score: { overall: 0.86, structure: 0.92, typography: 0.72, color: 0.84, semantics: 0.9 },
+            confidence: 0.82,
+            majorDiffAreas: [exampleDiff('heading-weight', 'Heading weight differs in computed metrics', 'implementation')],
+            matches: ['Both structures include the main content and CTA regions.'],
+            remarks: { matches: ['Major regions are present.'], uncertainties: [], possibleIntentionalDeviations: [] },
+            systemFeedback: { inputQuality: ['DOM metrics were available for both sides.'], missingContext: [], suggestedLimnerImprovements: [] },
+            nextIteration: { focus: 'Align implementation heading typography.', steps: ['Increase implementation heading font weight.'], avoidForNow: [] },
+            rationale: 'The structure matches well, but computed typography still diverges.',
+        },
+        recommendation: {
+            topFix: 'Tune the hero heading typography.',
+            why: 'Both visual and structural comparisons identify this as the highest-impact mismatch.',
+            expectedScoreLift: 0.06,
+        },
+    };
+}
+export function createAgentComparisonJsonSchema(mode = 'any') {
+    const schema = z.toJSONSchema(agentComparisonBundleSchema);
+    if (mode === 'image-and-structure') {
+        schema.required = [...new Set([...(schema.required ?? []), 'structureComparison'])];
+    }
+    if (mode === 'image-only') {
+        schema.not = { required: ['structureComparison'] };
+    }
+    return schema;
+}
+function exampleDiff(id, title, surface) {
+    return {
+        id,
+        title,
+        category: 'typography',
+        severity: 'medium',
+        priority: 1,
+        expected: 'Large, bold, visually dominant heading.',
+        actual: 'Slightly smaller heading with weaker emphasis.',
+        impact: 'The primary hierarchy is less forceful.',
+        evidence: [{ source: 'expected-image', observation: 'Heading is the strongest element in the upper content region.' }],
+        fixTarget: { surface, region: 'hero', likelyFiles: [], selectors: [] },
+        recommendedChange: 'Increase heading size and weight, then compare again.',
+    };
+}
+function exampleFingerprint(mode) {
+    const image = {
+        expectedImageSha256: '0'.repeat(64),
+        actualImageSha256: '1'.repeat(64),
+    };
+    if (mode === 'image-only')
+        return image;
+    return {
+        ...image,
+        expectedStructureSha256: '2'.repeat(64),
+        actualStructureSha256: '3'.repeat(64),
+    };
+}
+//# sourceMappingURL=comparison.js.map

package/dist/schemas/comparison.js.map

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

package/dist/schemas/visual-spec.d.ts

@@ -40,8 +40,8 @@ export declare const visualSpecSchema: z.ZodObject<{
             role: z.ZodEnum<{
                 unknown: "unknown";
                 status: "status";
-                header: "header";
                 hero: "hero";
+                header: "header";
                 content: "content";
                 panel: "panel";
                 footer: "footer";
@@ -84,8 +84,8 @@ export declare const visualSpecSchema: z.ZodObject<{
             }>;
             weight: z.ZodEnum<{
                 bold: "bold";
-                regular: "regular";
                 medium: "medium";
+                regular: "regular";
                 semibold: "semibold";
             }>;
             usage: z.ZodString;
@@ -132,8 +132,8 @@ export declare const visualSpecDiffSchema: z.ZodObject<{
         reference: z.ZodString;
         impact: z.ZodString;
         severity: z.ZodEnum<{
-            medium: "medium";
             high: "high";
+            medium: "medium";
             low: "low";
         }>;
     }, z.core.$strip>>;
@@ -180,8 +180,8 @@ export declare const visualSpecBundleSchema: z.ZodObject<{
                 role: z.ZodEnum<{
                     unknown: "unknown";
                     status: "status";
-                    header: "header";
                     hero: "hero";
+                    header: "header";
                     content: "content";
                     panel: "panel";
                     footer: "footer";
@@ -224,8 +224,8 @@ export declare const visualSpecBundleSchema: z.ZodObject<{
                 }>;
                 weight: z.ZodEnum<{
                     bold: "bold";
-                    regular: "regular";
                     medium: "medium";
+                    regular: "regular";
                     semibold: "semibold";
                 }>;
                 usage: z.ZodString;
@@ -301,8 +301,8 @@ export declare const visualSpecBundleSchema: z.ZodObject<{
                 role: z.ZodEnum<{
                     unknown: "unknown";
                     status: "status";
-                    header: "header";
                     hero: "hero";
+                    header: "header";
                     content: "content";
                     panel: "panel";
                     footer: "footer";
@@ -345,8 +345,8 @@ export declare const visualSpecBundleSchema: z.ZodObject<{
                 }>;
                 weight: z.ZodEnum<{
                     bold: "bold";
-                    regular: "regular";
                     medium: "medium";
+                    regular: "regular";
                     semibold: "semibold";
                 }>;
                 usage: z.ZodString;
@@ -394,8 +394,8 @@ export declare const visualSpecBundleSchema: z.ZodObject<{
             reference: z.ZodString;
             impact: z.ZodString;
             severity: z.ZodEnum<{
-                medium: "medium";
                 high: "high";
+                medium: "medium";
                 low: "low";
             }>;
         }, z.core.$strip>>;

package/dist/schemas/visual-spec.js

@@ -81,9 +81,9 @@ export const visualSpecDiffSchema = z.object({
         reference: z.string().min(1),
         impact: z.string().min(1),
         severity: z.enum(['high', 'medium', 'low']),
-    })).min(1),
+    })),
     openQuestions: z.array(z.string()),
-    nextFixes: z.array(z.string()).min(1),
+    nextFixes: z.array(z.string()),
 });
 export const visualSpecBundleSchema = z.object({
     version: z.literal(1),

package/dist/schemas/visual-spec.js.map

@@ -1 +1 @@
-{"version":3,"file":"visual-spec.js","sourceRoot":"","sources":["../../src/schemas/visual-spec.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"visual-spec.js","sourceRoot":"","sources":["../../src/schemas/visual-spec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3B,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;CACjC,CAAC,CAAC;AAEH,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5B,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACrB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACxB,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;IAC9F,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9B,cAAc,EAAE,oBAAoB,CAAC,QAAQ,EAAE;IAC/C,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;CACrC,CAAC,CAAC;AAEH,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3B,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;IACrF,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;IACnD,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;IACzD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CACzB,CAAC,CAAC;AAEH,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACxB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CACzB,CAAC,CAAC;AAEH,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACxB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CAC5B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IACrB,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,aAAa,EAAE,gBAAgB,CAAC,CAAC;IACjD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1B,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC;QACjB,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QACnC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;QACjD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;KACnD,CAAC;IACF,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,eAAe,EAAE,cAAc,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;QAC9E,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;QAC3D,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;QACzD,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QACrC,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC;YACnB,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE;YACnB,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE;YACnB,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SACzC,CAAC;KACH,CAAC;IACF,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC;QACnB,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QACpC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QACnC,cAAc,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;KAC3C,CAAC;IACF,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACd,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;QACnD,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QACxC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;KACpC,CAAC;IACF,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC;QAClB,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QAC/B,cAAc,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QACnC,gBAAgB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QACrC,aAAa,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;KACnC,CAAC;IACF,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC;QAClB,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC;QAC5B,cAAc,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QACnC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;KAClC,CAAC;IACF,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;CACrC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1B,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC5B,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;QAC3B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QACvB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QACxB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QAC5B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QACzB,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;KAC5C,CAAC,CAAC;IACH,aAAa,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAClC,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;CAC/B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IACrB,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC;IAC/B,SAAS,EAAE,gBAAgB,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC;IACxE,aAAa,EAAE,gBAAgB,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC,EAAE,CAAC;IAC/E,IAAI,EAAE,oBAAoB;CAC3B,CAAC,CAAC;AAMH,MAAM,UAAU,0BAA0B;IACxC,OAAO,CAAC,CAAC,YAAY,CAAC,sBAAsB,CAAC,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,6BAA6B;IAC3C,OAAO;QACL,OAAO,EAAE,CAAC;QACV,WAAW,EAAE,OAAO;QACpB,SAAS,EAAE;YACT,OAAO,EAAE,CAAC;YACV,MAAM,EAAE,aAAa;YACrB,OAAO,EAAE,oDAAoD;YAC7D,QAAQ,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE;YAC/D,MAAM,EAAE;gBACN,IAAI,EAAE,eAAe;gBACrB,SAAS,EAAE,UAAU;gBACrB,OAAO,EAAE,UAAU;gBACnB,OAAO,EAAE,CAAC;wBACR,EAAE,EAAE,MAAM;wBACV,KAAK,EAAE,cAAc;wBACrB,IAAI,EAAE,MAAM;wBACZ,WAAW,EAAE,uCAAuC;wBACpD,cAAc,EAAE,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE;wBAC7D,QAAQ,EAAE,CAAC,oDAAoD,CAAC;qBACjE,CAAC;gBACF,UAAU,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,EAAE,6BAA6B,EAAE;aAC7F;YACD,UAAU,EAAE;gBACV,QAAQ,EAAE,CAAC,oCAAoC,EAAE,kCAAkC,CAAC;gBACpF,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB,EAAE,CAAC;gBACrF,cAAc,EAAE,CAAC,yDAAyD,CAAC;aAC5E;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,MAAM;gBACZ,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,iCAAiC,EAAE,CAAC;gBAC1F,OAAO,EAAE,CAAC,WAAW,EAAE,gBAAgB,CAAC;aACzC;YACD,SAAS,EAAE;gBACT,YAAY,EAAE,wDAAwD;gBACtE,cAAc,EAAE,CAAC,yBAAyB,CAAC;gBAC3C,gBAAgB,EAAE,CAAC,uBAAuB,CAAC;gBAC3C,aAAa,EAAE,CAAC,qCAAqC,CAAC;aACvD;YACD,SAAS,EAAE;gBACT,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,iBAAiB,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,2CAA2C,EAAE,CAAC;gBAClH,cAAc,EAAE,EAAE;gBAClB,KAAK,EAAE,CAAC,wDAAwD,CAAC;aAClE;YACD,QAAQ,EAAE,CAAC,0BAA0B,EAAE,6CAA6C,CAAC;SACtF;QACD,aAAa,EAAE;YACb,OAAO,EAAE,CAAC;YACV,MAAM,EAAE,gBAAgB;YACxB,OAAO,EAAE,2DAA2D;YACpE,QAAQ,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE;YAC/D,MAAM,EAAE;gBACN,IAAI,EAAE,eAAe;gBACrB,SAAS,EAAE,UAAU;gBACrB,OAAO,EAAE,UAAU;gBACnB,OAAO,EAAE,CAAC;wBACR,EAAE,EAAE,MAAM;wBACV,KAAK,EAAE,cAAc;wBACrB,IAAI,EAAE,MAAM;wBACZ,WAAW,EAAE,uCAAuC;wBACpD,cAAc,EAAE,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE;wBAC7D,QAAQ,EAAE,CAAC,wCAAwC,EAAE,mCAAmC,CAAC;qBAC1F,CAAC;gBACF,UAAU,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,EAAE,6BAA6B,EAAE;aAC7F;YACD,UAAU,EAAE;gBACV,QAAQ,EAAE,CAAC,oCAAoC,EAAE,kCAAkC,CAAC;gBACpF,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,uCAAuC,EAAE,CAAC;gBAC5G,cAAc,EAAE,CAAC,6CAA6C,CAAC;aAChE;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,MAAM;gBACZ,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,iCAAiC,EAAE,CAAC;gBACxF,OAAO,EAAE,CAAC,SAAS,EAAE,SAAS,CAAC;aAChC;YACD,SAAS,EAAE;gBACT,YAAY,EAAE,kDAAkD;gBAChE,cAAc,EAAE,CAAC,yBAAyB,EAAE,eAAe,CAAC;gBAC5D,gBAAgB,EAAE,CAAC,uBAAuB,CAAC;gBAC3C,aAAa,EAAE,CAAC,qCAAqC,CAAC;aACvD;YACD,SAAS,EAAE;gBACT,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,iBAAiB,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,2CAA2C,EAAE,CAAC;gBAClH,cAAc,EAAE,EAAE;gBAClB,KAAK,EAAE,CAAC,yDAAyD,CAAC;aACnE;YACD,QAAQ,EAAE,CAAC,4CAA4C,EAAE,+BAA+B,CAAC;SAC1F;QACD,IAAI,EAAE;YACJ,OAAO,EAAE,6DAA6D;YACtE,OAAO,EAAE,CAAC,6BAA6B,EAAE,kDAAkD,CAAC;YAC5F,UAAU,EAAE,CAAC;oBACX,IAAI,EAAE,gBAAgB;oBACtB,KAAK,EAAE,qCAAqC;oBAC5C,SAAS,EAAE,6CAA6C;oBACxD,MAAM,EAAE,8CAA8C;oBACtD,QAAQ,EAAE,QAAQ;iBACnB,CAAC;YACF,aAAa,EAAE,CAAC,sEAAsE,CAAC;YACvF,SAAS,EAAE,CAAC,2EAA2E,CAAC;SACzF;KACF,CAAC;AACJ,CAAC"}

package/docs/agent-workflow.md

@@ -2,44 +2,31 @@
 
 Limner is designed for agent-in-the-loop visual fidelity work.
 
+Prompt profiles: `ideal-to-mockup` for Phase 1, and `mockup-to-implementation` for Phase 2.
+
 ## Phase 1: Image To Reference
 
-1. Run `limn init <image> --target <name>`.
+1. Run `limner init <image> --target <name>`.
 2. Inspect `targets/<name>/source/`.
 3. Edit `contract/regions.json`, `contract/tokens.json`, and `contract/acceptance.md`.
 4. Rebuild `reference/index.html` and `reference/styles.css` as a faithful HTML facsimile.
-5. Run `limn compare image-reference --target <name>`.
-6. Optional: run `limn compare image-reference --target <name> --spec` to generate an agent-required visual spec prompt pack.
-7. Edit `contract/visual-spec-instructions.md` for target-specific prompt guidance, or pass `--spec-instructions <path>` for a shared prompt policy.
-8. If using Codex, start from `captures/image-reference/spec/agent-prompt.codex.md`.
-9. If using Claude, start from `captures/image-reference/spec/agent-prompt.claude.md` and attach the images it references.
-10. Have the agent write `captures/image-reference/spec/agent-response.json`, then rerun the command to validate and split the structured output.
-11. Instruct the agent to inspect the ideal image and reference screenshot separately; use the side-by-side only as comparison context.
-12. Open `captures/image-reference/side-by-side.png`.
-13. Record concrete mismatches in `reports/image-reference.md`.
-14. Iterate until the reference is approved.
-
-## Phase 2: Reference To App
-
-1. Add app selectors to `contract/regions.json`.
-2. Run `limn compare reference-app --target <name> --url <app-url>`.
-3. Open `captures/reference-app/side-by-side.png`.
-4. Inspect `captures/reference-app/dom-metrics.json`.
-5. Record app repair steps in `reports/reference-app.md`.
-6. Fix the app and rerun until the app matches the approved reference.
-
-## Optional Grounding: Image To App
-
-Use this when you need to confirm that the app URL, authentication state, and viewport are correct before building the HTML reference.
-
-```bash
-limn compare image-app --target <name> --url <app-url> --storage-state ./e2e/.auth/user.json
-```
-
-This is not a replacement for Phase 1. For design reconstruction work, first recreate the generated image in `reference/index.html` and compare with `image-reference`.
-
-Capture defaults to viewport-only. Add `--full-page` only when the generated image is meant to represent the full scrollable page.
+5. Run `limner compare image-reference --target <name>`.
+6. Read `captures/image-reference/agent-comparison/agent-prompt.codex.md`.
+7. Write `captures/image-reference/agent-comparison/agent-response.json`.
+8. Rerun the same command to validate `image-comparison.json` and `comparison-summary.json`.
+9. Optional: run `limner compare image-reference --target <name> --spec` to generate a visual spec prompt pack.
+10. Edit `contract/visual-spec-instructions.md` for target-specific prompt guidance, or pass `--spec-instructions <path>` for a shared prompt policy.
+11. Iterate on one scoped mockup fix at a time until the reference is approved.
+
+## Phase 2: Reference To Implementation
+
+1. Add implementation selectors to `contract/regions.json` using `appSelector`.
+2. Run `limner compare reference-implementation --target <name> --url <implementation-url>`.
+3. Read `captures/reference-implementation/agent-comparison/agent-prompt.codex.md`.
+4. Write `captures/reference-implementation/agent-comparison/agent-response.json`.
+5. Rerun the same command to validate `image-comparison.json`, `structure-comparison.json`, and `comparison-summary.json`.
+6. Fix the implementation and rerun until it matches the approved reference.
 
 ## Agent Rule
 
-Do not treat side-by-side generation as success. It is evidence. The agent still needs to compare regions, name mismatches, and decide the next scoped fix.
+Do not treat side-by-side generation as success. It is evidence. The agent must write the structured comparison response and use its next-iteration guidance for one scoped fix.

package/docs/superpowers/plans/2026-06-12-agent-comparison-scores.md

@@ -0,0 +1,209 @@
+# Agent Comparison Scores Implementation Plan
+
+> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
+
+**Goal:** Replace Limner's current comparison behavior with agent-authored UX screenshot comparisons that drive the next implementation iteration for the two primary visual fidelity loops.
+
+**Architecture:** Comparison commands still capture screenshots and write reports, but their core output becomes validated agent comparison artifacts rather than artifact-only side-by-sides. New schemas model image comparisons, structure comparisons, scores, confidence, evidence, matches, diffs, remarks, system feedback, and next iteration guidance. Prompt profiles tell the agent which side is canonical and which surface should change.
+
+**Tech Stack:** TypeScript, Commander, Zod, Playwright, Vitest.
+
+---
+
+## Decisions
+
+- Agent comparison is the only scoring path in this plan.
+- This is a major overhaul of the existing compare modes, not an additive scoring feature.
+- The implementation comparison naming should be `reference-implementation`.
+- Current reports should be reshaped around agent comparison status, scores, diffs, and next iteration guidance.
+- Limner stays model-agnostic: it prepares prompt/schema/evidence files; an external agent writes `agent-response.json`.
+- The prompt is tailored for UX screenshot comparison, not generic image comparison.
+- Perfect matches are valid: `diffs`, `mismatches`, and `nextFixes` may be empty.
+- Scores are `0..1` estimates with rationale/evidence, not final pass/fail judgments.
+- The schema prioritizes the next implementation iteration over progress tracking.
+
+## Prompt Profiles
+
+- `ideal-to-mockup`: expected is the ideal image, actual is the HTML mockup screenshot, editable surface is the mockup. Used by `compare image-reference`.
+- `mockup-to-implementation`: expected is the approved HTML mockup screenshot, actual is the implementation screenshot, editable surface is the implementation. Used by `compare reference-implementation`.
+
+## CLI Semantics
+
+- `limner compare image-reference --target <name>` creates or validates an `ideal-to-mockup` agent pack and emits `image-comparison.json` after validation.
+- `limner compare reference-implementation --target <name> --url <url>` creates or validates a `mockup-to-implementation` agent pack and emits image plus DOM-metrics structure comparisons after validation.
+- `--no-agent-comparison` skips the default agent comparison pack for quick artifact-only runs.
+
+## Replacement Scope
+
+- Replace the current artifact-only comparison reports with agent-comparison-centered reports.
+- Rename the implementation comparison command to `compare reference-implementation`.
+- Rename implementation comparison capture/report folders to reference-implementation equivalents.
+- Keep backwards compatibility only if implementation chooses to add a deprecated alias; the new docs and agent workflow should use `reference-implementation`.
+
+## Artifacts
+
+```text
+targets/<target>/captures/<mode>/
+  agent-comparison/
+    agent-prompt.md
+    agent-prompt.codex.md
+    agent-prompt.claude.md
+    agent-response.schema.json
+    agent-response.example.json
+    agent-response.json
+  image-comparison.json
+  structure-comparison.json
+  comparison-summary.json
+```
+
+## File Map
+
+- Create `src/schemas/comparison.ts` and `src/schemas/comparison.test.ts`.
+- Create `src/core/agent-comparison-profiles.ts`, `src/core/agent-comparison-prompts.ts`, `src/core/agent-comparison-pack.ts`, and `src/core/agent-comparison-pack.test.ts`.
+- Modify `src/commands/compare-image-reference.ts`, `src/commands/compare.ts`, and `src/commands/compare.test.ts`.
+- Modify `src/core/report-writer.ts`, `src/schemas/visual-spec.ts`, and `src/index.ts`.
+- Modify `templates/target/AGENT_GUIDE.md`, `skills/limner/SKILL.md`, `docs/agent-workflow.md`, and `README.md`.
+
+---
+
+### Task 1: Shared Comparison Schemas
+
+**Files:** create `src/schemas/comparison.ts`, create `src/schemas/comparison.test.ts`, modify `src/index.ts`.
+
+- [ ] Write failing tests for image-only bundles, image-plus-structure bundles, perfect matches with empty `diffs`/`nextFixes`, and score bounds.
+
+Use assertions shaped like:
+
+```ts
+expect(agentComparisonBundleSchema.parse(createAgentComparisonBundleExample('image-only')).imageComparison.kind).toBe('image-vs-image');
+expect(agentComparisonBundleSchema.parse(createAgentComparisonBundleExample('image-and-structure')).structureComparison?.kind).toBe('structure-vs-structure');
+example.imageComparison.diffs = [];
+example.imageComparison.nextIteration.steps = [];
+example.imageComparison.score.overall = 1;
+expect(agentComparisonBundleSchema.parse(example).imageComparison.diffs).toEqual([]);
+example.imageComparison.score.overall = 1.2;
+expect(() => agentComparisonBundleSchema.parse(example)).toThrow();
+```
+
+- [ ] Run `npm test -- src/schemas/comparison.test.ts`; expect failure because the schema module is missing.
+- [ ] Implement `score01Schema`, `imageComparisonSchema`, `structureComparisonSchema`, `agentComparisonBundleSchema`, exported types, `createAgentComparisonBundleExample(mode)`, and `createAgentComparisonJsonSchema()`.
+- [ ] Include these top-level comparison fields: `summary`, `score`, `confidence`, `majorDiffAreas`, `matches`, `remarks`, `systemFeedback`, `nextIteration`, and `rationale`.
+- [ ] Each diff should include `id`, `title`, `category`, `severity`, `priority`, `expected`, `actual`, `impact`, `evidence`, optional `fixTarget`, and `recommendedChange`.
+- [ ] `fixTarget.surface` should be `mockup`, `implementation`, or `unknown`.
+- [ ] Export schemas, helpers, and types from `src/index.ts`.
+- [ ] Run `npm test -- src/schemas/comparison.test.ts && npm run typecheck`; expect pass.
+
+---
+
+### Task 2: Allow Perfect Visual Spec Diffs
+
+**Files:** modify `src/schemas/visual-spec.ts`, modify `src/commands/compare.test.ts`.
+
+- [ ] In the existing `compareImageReference` spec validation test, set `response.diff.mismatches = []` and `response.diff.nextFixes = []`.
+- [ ] Assert `expect(diff.mismatches).toEqual([])`.
+- [ ] Run `npm test -- src/commands/compare.test.ts`; expect failure because current schema requires one mismatch and one next fix.
+- [ ] Remove `.min(1)` from `visualSpecDiffSchema.mismatches` and `visualSpecDiffSchema.nextFixes`.
+- [ ] Run `npm test -- src/commands/compare.test.ts`; expect pass.
+
+---
+
+### Task 3: Agent Comparison Pack
+
+**Files:** create `src/core/agent-comparison-profiles.ts`, create `src/core/agent-comparison-prompts.ts`, create `src/core/agent-comparison-pack.ts`, create `src/core/agent-comparison-pack.test.ts`.
+
+- [ ] Write tests covering missing response, prompt/schema/example creation, invalid JSON, schema-invalid JSON, valid image-only response, valid image-plus-structure response, and both prompt profiles.
+- [ ] Run `npm test -- src/core/agent-comparison-pack.test.ts`; expect failure because implementation is missing.
+- [ ] Implement profile metadata for `ideal-to-mockup` and `mockup-to-implementation`.
+- [ ] Implement prompt builders that include profile name, expected role, actual role, editable surface, expected/actual image paths, optional structure paths, schema path, response path, and UX-specific comparison guidance.
+- [ ] The prompt must tell the agent to prioritize the next implementation iteration over exhaustive critique.
+- [ ] The prompt must ask for high-signal UX diffs: layout, hierarchy, typography, color, spacing, component anatomy, copy/state, and attention flow.
+- [ ] Implement `writeAgentComparisonPack(input)` with this contract:
+
+```ts
+{
+  workspaceRoot: string;
+  captureDir: string;
+  mode: 'image-reference' | 'reference-implementation';
+  profile: 'ideal-to-mockup' | 'mockup-to-implementation';
+  imageInputs: { expectedImagePath: string; actualImagePath: string };
+  structureInputs?: {
+    expectedStructurePath: string;
+    actualStructurePath: string;
+    structureKind: 'visual-spec' | 'dom-metrics' | 'html' | 'json-description';
+  };
+}
+```
+
+- [ ] Return prompt paths, schema/example/response paths, status, validation errors, split artifact paths, and score highlights.
+- [ ] On valid responses, write `image-comparison.json`, optional `structure-comparison.json`, and `comparison-summary.json`.
+- [ ] Run `npm test -- src/core/agent-comparison-pack.test.ts && npm run typecheck`; expect pass.
+
+---
+
+### Task 4: Replace Current Primary Compare Modes
+
+**Files:** modify `src/commands/compare-image-reference.ts`, `src/commands/compare.ts`, and `src/commands/compare.test.ts`.
+
+- [ ] Extend compare tests so `image-reference` and `reference-implementation` return `agentComparison.status === 'awaiting-agent'` by default and each report mentions `agent-response.json`.
+- [ ] For `reference-implementation`, assert the prompt includes `Structure kind: \`dom-metrics\``.
+- [ ] Add coverage that `compare reference-implementation` is the documented command name.
+- [ ] If a deprecated alias is retained, assert it points to the same implementation and prints a deprecation warning.
+- [ ] Assert prompts include the expected profile names: `ideal-to-mockup` and `mockup-to-implementation`.
+- [ ] Run `npm test -- src/commands/compare.test.ts`; expect failure.
+- [ ] In `image-reference`, call `writeAgentComparisonPack` with profile `ideal-to-mockup`, ideal image as expected, and reference screenshot as actual.
+- [ ] In `reference-implementation`, call it with profile `mockup-to-implementation`, reference screenshot as expected, implementation screenshot as actual, and structure inputs pointing at `${referencePath}.metrics.json` and `${implementationPath}.metrics.json`.
+- [ ] Respect `options.agentComparison === false`.
+- [ ] Run `npm test -- src/commands/compare.test.ts && npm run typecheck`; expect pass.
+
+---
+
+### Task 5: CLI Flags And Reports
+
+**Files:** modify `src/commands/compare.ts`, modify `src/core/report-writer.ts`.
+
+- [ ] Add to `image-reference` and `reference-implementation`:
+
+```ts
+.option('--no-agent-comparison', 'skip the default agent comparison prompt pack')
+```
+
+- [ ] Pass `agentComparison` through to command functions.
+- [ ] Console output should include prompt paths, schema path, response target, validation status, and validated artifact paths.
+- [ ] Reports should include `## Agent Comparison`.
+- [ ] Awaiting reports should show prompt paths and the next step.
+- [ ] Invalid reports should show validation errors.
+- [ ] Validated reports should show agent image score, optional agent structure score, next iteration focus, and artifact paths.
+- [ ] Verify help: `image-reference` and `reference-implementation` show `--no-agent-comparison`.
+
+---
+
+### Task 6: Teach Agents The Default Workflow
+
+**Files:** modify `templates/target/AGENT_GUIDE.md`, `skills/limner/SKILL.md`, `docs/agent-workflow.md`, and `README.md`.
+
+- [ ] Document that `image-reference` and `reference-implementation` create an agent comparison pack by default.
+- [ ] Document prompt profiles: `ideal-to-mockup` and `mockup-to-implementation`.
+- [ ] Tell agents to read `captures/<mode>/agent-comparison/agent-prompt.codex.md`.
+- [ ] Tell agents to write `captures/<mode>/agent-comparison/agent-response.json`.
+- [ ] Tell agents to rerun the same compare command to validate output.
+- [ ] Update README’s product promise: Limner prepares model-agnostic agent-authored UX comparison scores, but does not make final pass/fail judgments.
+- [ ] Run `rg -n "agent comparison|agent-response.json|ideal-to-mockup|mockup-to-implementation" README.md docs/agent-workflow.md templates/target/AGENT_GUIDE.md skills/limner/SKILL.md`; expect all files to mention the workflow.
+
+---
+
+### Task 7: Full Quality Gate And Handoff
+
+**Files:** no edits.
+
+- [ ] Run `npm run check`; expect lint, typecheck, Vitest, build, Knip, and file-size guard pass.
+- [ ] Smoke `npm run dev -- compare image-reference --help`; expect `--no-agent-comparison`.
+- [ ] Smoke `npm run dev -- compare reference-implementation --help`; expect `--no-agent-comparison`.
+- [ ] PR handoff should include failure modes, commands run/results, generated artifacts, negative cases, and remaining risks.
+- [ ] Failure modes: agents may treat scores as pass/fail; awaiting-agent loop if response is not written; agent feedback may be too broad unless the prompt enforces a focused next iteration.
+- [ ] Negative cases: perfect match, invalid JSON, schema-invalid JSON, and `--no-agent-comparison`.
+
+## Self-Review
+
+- Spec coverage: Covers the comparison overhaul, `reference-implementation` naming, two prompt profiles, image-vs-image output, structure-vs-structure output, how agents know to use it, schemas, validation, docs, and tests.
+- Placeholder scan: No TBD/TODO language remains; each task names concrete files, behavior, commands, and expected outcomes.
+- Type consistency: `agentComparison`, `imageComparison`, `structureComparison`, `ideal-to-mockup`, and `mockup-to-implementation` are consistent across the plan.