@neonwatty/limner 0.1.0

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

@@ -0,0 +1,410 @@
+import { z } from 'zod';
+export declare const visualSpecSchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    source: z.ZodEnum<{
+        "ideal-image": "ideal-image";
+        "reference-html": "reference-html";
+    }>;
+    summary: z.ZodString;
+    viewport: z.ZodObject<{
+        kind: z.ZodEnum<{
+            desktop: "desktop";
+            mobile: "mobile";
+        }>;
+        widthHint: z.ZodOptional<z.ZodNumber>;
+        heightHint: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>;
+    layout: z.ZodObject<{
+        flow: z.ZodEnum<{
+            unknown: "unknown";
+            split: "split";
+            "single-column": "single-column";
+            "multi-column": "multi-column";
+            stacked: "stacked";
+        }>;
+        alignment: z.ZodEnum<{
+            unknown: "unknown";
+            left: "left";
+            centered: "centered";
+            mixed: "mixed";
+        }>;
+        density: z.ZodEnum<{
+            unknown: "unknown";
+            airy: "airy";
+            balanced: "balanced";
+            dense: "dense";
+        }>;
+        regions: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            label: z.ZodString;
+            role: z.ZodEnum<{
+                unknown: "unknown";
+                status: "status";
+                header: "header";
+                hero: "hero";
+                content: "content";
+                panel: "panel";
+                footer: "footer";
+                control: "control";
+            }>;
+            description: z.ZodString;
+            relativeBounds: z.ZodOptional<z.ZodObject<{
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+                width: z.ZodNumber;
+                height: z.ZodNumber;
+            }, z.core.$strip>>;
+            evidence: z.ZodArray<z.ZodString>;
+        }, z.core.$strip>>;
+        navigation: z.ZodObject<{
+            header: z.ZodBoolean;
+            footer: z.ZodBoolean;
+            progressIndicator: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+    }, z.core.$strip>;
+    typography: z.ZodObject<{
+        families: z.ZodArray<z.ZodString>;
+        scales: z.ZodArray<z.ZodObject<{
+            label: z.ZodEnum<{
+                body: "body";
+                eyebrow: "eyebrow";
+                heading: "heading";
+                subheading: "subheading";
+                caption: "caption";
+                cta: "cta";
+                meta: "meta";
+            }>;
+            size: z.ZodEnum<{
+                xs: "xs";
+                sm: "sm";
+                md: "md";
+                lg: "lg";
+                xl: "xl";
+                xxl: "xxl";
+            }>;
+            weight: z.ZodEnum<{
+                bold: "bold";
+                regular: "regular";
+                medium: "medium";
+                semibold: "semibold";
+            }>;
+            usage: z.ZodString;
+        }, z.core.$strip>>;
+        hierarchyNotes: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>;
+    color: z.ZodObject<{
+        tone: z.ZodEnum<{
+            unknown: "unknown";
+            mixed: "mixed";
+            dark: "dark";
+            light: "light";
+        }>;
+        tokens: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            value: z.ZodString;
+            usage: z.ZodString;
+        }, z.core.$strip>>;
+        accents: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>;
+    hierarchy: z.ZodObject<{
+        primaryFocus: z.ZodString;
+        primaryActions: z.ZodArray<z.ZodString>;
+        secondaryActions: z.ZodArray<z.ZodString>;
+        warningStates: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>;
+    semantics: z.ZodObject<{
+        states: z.ZodArray<z.ZodObject<{
+            element: z.ZodString;
+            state: z.ZodString;
+            evidence: z.ZodString;
+        }, z.core.$strip>>;
+        mobileBehavior: z.ZodArray<z.ZodString>;
+        risks: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>;
+    evidence: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export declare const visualSpecDiffSchema: z.ZodObject<{
+    summary: z.ZodString;
+    matches: z.ZodArray<z.ZodString>;
+    mismatches: z.ZodArray<z.ZodObject<{
+        area: z.ZodString;
+        ideal: z.ZodString;
+        reference: z.ZodString;
+        impact: z.ZodString;
+        severity: z.ZodEnum<{
+            medium: "medium";
+            high: "high";
+            low: "low";
+        }>;
+    }, z.core.$strip>>;
+    openQuestions: z.ZodArray<z.ZodString>;
+    nextFixes: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export declare const visualSpecBundleSchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    generatedBy: z.ZodLiteral<"agent">;
+    idealSpec: z.ZodObject<{
+        version: z.ZodLiteral<1>;
+        summary: z.ZodString;
+        viewport: z.ZodObject<{
+            kind: z.ZodEnum<{
+                desktop: "desktop";
+                mobile: "mobile";
+            }>;
+            widthHint: z.ZodOptional<z.ZodNumber>;
+            heightHint: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>;
+        layout: z.ZodObject<{
+            flow: z.ZodEnum<{
+                unknown: "unknown";
+                split: "split";
+                "single-column": "single-column";
+                "multi-column": "multi-column";
+                stacked: "stacked";
+            }>;
+            alignment: z.ZodEnum<{
+                unknown: "unknown";
+                left: "left";
+                centered: "centered";
+                mixed: "mixed";
+            }>;
+            density: z.ZodEnum<{
+                unknown: "unknown";
+                airy: "airy";
+                balanced: "balanced";
+                dense: "dense";
+            }>;
+            regions: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                label: z.ZodString;
+                role: z.ZodEnum<{
+                    unknown: "unknown";
+                    status: "status";
+                    header: "header";
+                    hero: "hero";
+                    content: "content";
+                    panel: "panel";
+                    footer: "footer";
+                    control: "control";
+                }>;
+                description: z.ZodString;
+                relativeBounds: z.ZodOptional<z.ZodObject<{
+                    x: z.ZodNumber;
+                    y: z.ZodNumber;
+                    width: z.ZodNumber;
+                    height: z.ZodNumber;
+                }, z.core.$strip>>;
+                evidence: z.ZodArray<z.ZodString>;
+            }, z.core.$strip>>;
+            navigation: z.ZodObject<{
+                header: z.ZodBoolean;
+                footer: z.ZodBoolean;
+                progressIndicator: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>;
+        }, z.core.$strip>;
+        typography: z.ZodObject<{
+            families: z.ZodArray<z.ZodString>;
+            scales: z.ZodArray<z.ZodObject<{
+                label: z.ZodEnum<{
+                    body: "body";
+                    eyebrow: "eyebrow";
+                    heading: "heading";
+                    subheading: "subheading";
+                    caption: "caption";
+                    cta: "cta";
+                    meta: "meta";
+                }>;
+                size: z.ZodEnum<{
+                    xs: "xs";
+                    sm: "sm";
+                    md: "md";
+                    lg: "lg";
+                    xl: "xl";
+                    xxl: "xxl";
+                }>;
+                weight: z.ZodEnum<{
+                    bold: "bold";
+                    regular: "regular";
+                    medium: "medium";
+                    semibold: "semibold";
+                }>;
+                usage: z.ZodString;
+            }, z.core.$strip>>;
+            hierarchyNotes: z.ZodArray<z.ZodString>;
+        }, z.core.$strip>;
+        color: z.ZodObject<{
+            tone: z.ZodEnum<{
+                unknown: "unknown";
+                mixed: "mixed";
+                dark: "dark";
+                light: "light";
+            }>;
+            tokens: z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                value: z.ZodString;
+                usage: z.ZodString;
+            }, z.core.$strip>>;
+            accents: z.ZodArray<z.ZodString>;
+        }, z.core.$strip>;
+        hierarchy: z.ZodObject<{
+            primaryFocus: z.ZodString;
+            primaryActions: z.ZodArray<z.ZodString>;
+            secondaryActions: z.ZodArray<z.ZodString>;
+            warningStates: z.ZodArray<z.ZodString>;
+        }, z.core.$strip>;
+        semantics: z.ZodObject<{
+            states: z.ZodArray<z.ZodObject<{
+                element: z.ZodString;
+                state: z.ZodString;
+                evidence: z.ZodString;
+            }, z.core.$strip>>;
+            mobileBehavior: z.ZodArray<z.ZodString>;
+            risks: z.ZodArray<z.ZodString>;
+        }, z.core.$strip>;
+        evidence: z.ZodArray<z.ZodString>;
+        source: z.ZodLiteral<"ideal-image">;
+    }, z.core.$strip>;
+    referenceSpec: z.ZodObject<{
+        version: z.ZodLiteral<1>;
+        summary: z.ZodString;
+        viewport: z.ZodObject<{
+            kind: z.ZodEnum<{
+                desktop: "desktop";
+                mobile: "mobile";
+            }>;
+            widthHint: z.ZodOptional<z.ZodNumber>;
+            heightHint: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>;
+        layout: z.ZodObject<{
+            flow: z.ZodEnum<{
+                unknown: "unknown";
+                split: "split";
+                "single-column": "single-column";
+                "multi-column": "multi-column";
+                stacked: "stacked";
+            }>;
+            alignment: z.ZodEnum<{
+                unknown: "unknown";
+                left: "left";
+                centered: "centered";
+                mixed: "mixed";
+            }>;
+            density: z.ZodEnum<{
+                unknown: "unknown";
+                airy: "airy";
+                balanced: "balanced";
+                dense: "dense";
+            }>;
+            regions: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                label: z.ZodString;
+                role: z.ZodEnum<{
+                    unknown: "unknown";
+                    status: "status";
+                    header: "header";
+                    hero: "hero";
+                    content: "content";
+                    panel: "panel";
+                    footer: "footer";
+                    control: "control";
+                }>;
+                description: z.ZodString;
+                relativeBounds: z.ZodOptional<z.ZodObject<{
+                    x: z.ZodNumber;
+                    y: z.ZodNumber;
+                    width: z.ZodNumber;
+                    height: z.ZodNumber;
+                }, z.core.$strip>>;
+                evidence: z.ZodArray<z.ZodString>;
+            }, z.core.$strip>>;
+            navigation: z.ZodObject<{
+                header: z.ZodBoolean;
+                footer: z.ZodBoolean;
+                progressIndicator: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>;
+        }, z.core.$strip>;
+        typography: z.ZodObject<{
+            families: z.ZodArray<z.ZodString>;
+            scales: z.ZodArray<z.ZodObject<{
+                label: z.ZodEnum<{
+                    body: "body";
+                    eyebrow: "eyebrow";
+                    heading: "heading";
+                    subheading: "subheading";
+                    caption: "caption";
+                    cta: "cta";
+                    meta: "meta";
+                }>;
+                size: z.ZodEnum<{
+                    xs: "xs";
+                    sm: "sm";
+                    md: "md";
+                    lg: "lg";
+                    xl: "xl";
+                    xxl: "xxl";
+                }>;
+                weight: z.ZodEnum<{
+                    bold: "bold";
+                    regular: "regular";
+                    medium: "medium";
+                    semibold: "semibold";
+                }>;
+                usage: z.ZodString;
+            }, z.core.$strip>>;
+            hierarchyNotes: z.ZodArray<z.ZodString>;
+        }, z.core.$strip>;
+        color: z.ZodObject<{
+            tone: z.ZodEnum<{
+                unknown: "unknown";
+                mixed: "mixed";
+                dark: "dark";
+                light: "light";
+            }>;
+            tokens: z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                value: z.ZodString;
+                usage: z.ZodString;
+            }, z.core.$strip>>;
+            accents: z.ZodArray<z.ZodString>;
+        }, z.core.$strip>;
+        hierarchy: z.ZodObject<{
+            primaryFocus: z.ZodString;
+            primaryActions: z.ZodArray<z.ZodString>;
+            secondaryActions: z.ZodArray<z.ZodString>;
+            warningStates: z.ZodArray<z.ZodString>;
+        }, z.core.$strip>;
+        semantics: z.ZodObject<{
+            states: z.ZodArray<z.ZodObject<{
+                element: z.ZodString;
+                state: z.ZodString;
+                evidence: z.ZodString;
+            }, z.core.$strip>>;
+            mobileBehavior: z.ZodArray<z.ZodString>;
+            risks: z.ZodArray<z.ZodString>;
+        }, z.core.$strip>;
+        evidence: z.ZodArray<z.ZodString>;
+        source: z.ZodLiteral<"reference-html">;
+    }, z.core.$strip>;
+    diff: z.ZodObject<{
+        summary: z.ZodString;
+        matches: z.ZodArray<z.ZodString>;
+        mismatches: z.ZodArray<z.ZodObject<{
+            area: z.ZodString;
+            ideal: z.ZodString;
+            reference: z.ZodString;
+            impact: z.ZodString;
+            severity: z.ZodEnum<{
+                medium: "medium";
+                high: "high";
+                low: "low";
+            }>;
+        }, z.core.$strip>>;
+        openQuestions: z.ZodArray<z.ZodString>;
+        nextFixes: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type VisualSpec = z.infer<typeof visualSpecSchema>;
+export type VisualSpecDiff = z.infer<typeof visualSpecDiffSchema>;
+export type VisualSpecBundle = z.infer<typeof visualSpecBundleSchema>;
+export declare function createVisualSpecJsonSchema(): unknown;
+export declare function createVisualSpecBundleExample(): VisualSpecBundle;

package/dist/schemas/visual-spec.js

@@ -0,0 +1,201 @@
+import { z } from 'zod';
+const relativeBoundsSchema = z.object({
+    x: z.number().min(0).max(1),
+    y: z.number().min(0).max(1),
+    width: z.number().min(0).max(1),
+    height: z.number().min(0).max(1),
+});
+const regionSchema = z.object({
+    id: z.string().min(1),
+    label: z.string().min(1),
+    role: z.enum(['header', 'hero', 'content', 'panel', 'footer', 'control', 'status', 'unknown']),
+    description: z.string().min(1),
+    relativeBounds: relativeBoundsSchema.optional(),
+    evidence: z.array(z.string()).min(1),
+});
+const scaleSchema = z.object({
+    label: z.enum(['eyebrow', 'heading', 'subheading', 'body', 'caption', 'cta', 'meta']),
+    size: z.enum(['xs', 'sm', 'md', 'lg', 'xl', 'xxl']),
+    weight: z.enum(['regular', 'medium', 'semibold', 'bold']),
+    usage: z.string().min(1),
+});
+const colorTokenSchema = z.object({
+    name: z.string().min(1),
+    value: z.string().min(1),
+    usage: z.string().min(1),
+});
+const stateSchema = z.object({
+    element: z.string().min(1),
+    state: z.string().min(1),
+    evidence: z.string().min(1),
+});
+export const visualSpecSchema = z.object({
+    version: z.literal(1),
+    source: z.enum(['ideal-image', 'reference-html']),
+    summary: z.string().min(1),
+    viewport: z.object({
+        kind: z.enum(['desktop', 'mobile']),
+        widthHint: z.number().int().positive().optional(),
+        heightHint: z.number().int().positive().optional(),
+    }),
+    layout: z.object({
+        flow: z.enum(['single-column', 'multi-column', 'split', 'stacked', 'unknown']),
+        alignment: z.enum(['left', 'centered', 'mixed', 'unknown']),
+        density: z.enum(['airy', 'balanced', 'dense', 'unknown']),
+        regions: z.array(regionSchema).min(1),
+        navigation: z.object({
+            header: z.boolean(),
+            footer: z.boolean(),
+            progressIndicator: z.string().optional(),
+        }),
+    }),
+    typography: z.object({
+        families: z.array(z.string()).min(1),
+        scales: z.array(scaleSchema).min(1),
+        hierarchyNotes: z.array(z.string()).min(1),
+    }),
+    color: z.object({
+        tone: z.enum(['dark', 'light', 'mixed', 'unknown']),
+        tokens: z.array(colorTokenSchema).min(1),
+        accents: z.array(z.string()).min(1),
+    }),
+    hierarchy: z.object({
+        primaryFocus: z.string().min(1),
+        primaryActions: z.array(z.string()),
+        secondaryActions: z.array(z.string()),
+        warningStates: z.array(z.string()),
+    }),
+    semantics: z.object({
+        states: z.array(stateSchema),
+        mobileBehavior: z.array(z.string()),
+        risks: z.array(z.string()).min(1),
+    }),
+    evidence: z.array(z.string()).min(1),
+});
+export const visualSpecDiffSchema = z.object({
+    summary: z.string().min(1),
+    matches: z.array(z.string()),
+    mismatches: z.array(z.object({
+        area: z.string().min(1),
+        ideal: z.string().min(1),
+        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),
+});
+export const visualSpecBundleSchema = z.object({
+    version: z.literal(1),
+    generatedBy: z.literal('agent'),
+    idealSpec: visualSpecSchema.extend({ source: z.literal('ideal-image') }),
+    referenceSpec: visualSpecSchema.extend({ source: z.literal('reference-html') }),
+    diff: visualSpecDiffSchema,
+});
+export function createVisualSpecJsonSchema() {
+    return z.toJSONSchema(visualSpecBundleSchema);
+}
+export function createVisualSpecBundleExample() {
+    return {
+        version: 1,
+        generatedBy: 'agent',
+        idealSpec: {
+            version: 1,
+            source: 'ideal-image',
+            summary: 'Replace with a concise summary of the ideal image.',
+            viewport: { kind: 'desktop', widthHint: 1440, heightHint: 900 },
+            layout: {
+                flow: 'single-column',
+                alignment: 'centered',
+                density: 'balanced',
+                regions: [{
+                        id: 'hero',
+                        label: 'Hero section',
+                        role: 'hero',
+                        description: 'Primary heading and explanatory copy.',
+                        relativeBounds: { x: 0.2, y: 0.15, width: 0.6, height: 0.18 },
+                        evidence: ['Large centered heading near the top of the screen.'],
+                    }],
+                navigation: { header: true, footer: true, progressIndicator: 'Three-step progress header.' },
+            },
+            typography: {
+                families: ['Serif display for the main heading', 'Sans-serif for body and controls'],
+                scales: [{ label: 'heading', size: 'xxl', weight: 'bold', usage: 'Main page title' }],
+                hierarchyNotes: ['Heading is clearly dominant over surrounding body copy.'],
+            },
+            color: {
+                tone: 'dark',
+                tokens: [{ name: 'accent', value: 'warm gold', usage: 'Primary CTA and status emphasis' }],
+                accents: ['warm gold', 'orange warning'],
+            },
+            hierarchy: {
+                primaryFocus: 'Readiness-blocking seat warning and the add-seats CTA.',
+                primaryActions: ['Add 5 tables of 8 seats'],
+                secondaryActions: ['Back to previous step'],
+                warningStates: ['Need 40 more seats before readiness'],
+            },
+            semantics: {
+                states: [{ element: 'Continue action', state: 'disabled', evidence: 'Copy indicates seats must be added first.' }],
+                mobileBehavior: [],
+                risks: ['Heading, warning, and CTA ordering must remain intact.'],
+            },
+            evidence: ['Observed in ideal image.', 'Cross-checked against side-by-side capture.'],
+        },
+        referenceSpec: {
+            version: 1,
+            source: 'reference-html',
+            summary: 'Replace with a concise summary of the rendered reference.',
+            viewport: { kind: 'desktop', widthHint: 1440, heightHint: 900 },
+            layout: {
+                flow: 'single-column',
+                alignment: 'centered',
+                density: 'balanced',
+                regions: [{
+                        id: 'hero',
+                        label: 'Hero section',
+                        role: 'hero',
+                        description: 'Primary heading and explanatory copy.',
+                        relativeBounds: { x: 0.2, y: 0.15, width: 0.6, height: 0.18 },
+                        evidence: ['Seen in rendered reference screenshot.', 'Supported by reference DOM facts.'],
+                    }],
+                navigation: { header: true, footer: true, progressIndicator: 'Three-step progress header.' },
+            },
+            typography: {
+                families: ['Serif display for the main heading', 'Sans-serif for body and controls'],
+                scales: [{ label: 'heading', size: 'xl', weight: 'medium', usage: 'Main page title in rendered reference' }],
+                hierarchyNotes: ['Heading is slightly lighter than the ideal.'],
+            },
+            color: {
+                tone: 'dark',
+                tokens: [{ name: 'accent', value: '#f2bd6d', usage: 'Primary CTA and status emphasis' }],
+                accents: ['#f2bd6d', '#ff784f'],
+            },
+            hierarchy: {
+                primaryFocus: 'Readiness warning and CTA remain the main focus.',
+                primaryActions: ['Add 5 tables of 8 seats', 'Add one table'],
+                secondaryActions: ['Back to previous step'],
+                warningStates: ['Need 40 more seats before readiness'],
+            },
+            semantics: {
+                states: [{ element: 'Continue action', state: 'disabled', evidence: 'Rendered disabled button copy is present.' }],
+                mobileBehavior: [],
+                risks: ['Heading weight may be too soft compared with the ideal.'],
+            },
+            evidence: ['Observed in rendered reference screenshot.', 'Cross-checked with DOM facts.'],
+        },
+        diff: {
+            summary: 'Replace with the highest-signal summary of the differences.',
+            matches: ['Dark tonal palette matches.', 'Primary warning plus CTA structure is preserved.'],
+            mismatches: [{
+                    area: 'Heading weight',
+                    ideal: 'Heavy, high-contrast serif heading.',
+                    reference: 'Softer serif heading with less visual pull.',
+                    impact: 'The hero loses urgency and visual authority.',
+                    severity: 'medium',
+                }],
+            openQuestions: ['Is the softer heading weight intentional or an implementation drift?'],
+            nextFixes: ['Increase hero heading weight and contrast before tuning smaller controls.'],
+        },
+    };
+}
+//# sourceMappingURL=visual-spec.js.map

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

@@ -0,0 +1 @@
+{"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,CAAC,GAAG,CAAC,CAAC,CAAC;IACV,aAAa,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAClC,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;CACtC,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

@@ -0,0 +1,45 @@
+# Agent Workflow
+
+Limner is designed for agent-in-the-loop visual fidelity work.
+
+## Phase 1: Image To Reference
+
+1. Run `limn 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.
+
+## 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.