npm - @crvouga/atlas - Versions diffs - 1.21.0 → 1.22.0 - Mend

@crvouga/atlas 1.21.0 → 1.22.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (96) hide show

package/CHANGELOG.md +9 -1
package/dist/core/src/cli.d.ts +2 -2
package/dist/core/src/cli.js +4 -1
package/dist/critics/src/catalog-client.d.ts +91 -0
package/dist/critics/src/catalog-client.js +194 -0
package/dist/critics/src/cli-calibrate.d.ts +4 -0
package/dist/critics/src/cli-calibrate.js +211 -0
package/dist/critics/src/cli-common.d.ts +108 -0
package/dist/critics/src/cli-common.js +155 -0
package/dist/critics/src/cli-review.d.ts +4 -0
package/dist/critics/src/cli-review.js +174 -0
package/dist/critics/src/cli-watch.d.ts +4 -0
package/dist/critics/src/cli-watch.js +191 -0
package/dist/critics/src/cli.d.ts +13 -0
package/dist/critics/src/cli.js +490 -0
package/dist/critics/src/index.d.ts +3 -0
package/dist/critics/src/index.js +3 -0
package/dist/critics/src/judging.d.ts +8 -0
package/dist/critics/src/llm.d.ts +120 -0
package/dist/critics/src/llm.js +266 -0
package/dist/critics/src/marks.d.ts +74 -0
package/dist/critics/src/marks.js +76 -0
package/dist/critics/src/registry.d.ts +125 -0
package/dist/critics/src/registry.js +203 -0
package/dist/critics/src/spool.d.ts +32 -0
package/dist/critics/src/spool.js +129 -0
package/dist/critics/src/uiclip.d.ts +82 -0
package/dist/critics/src/uiclip.js +167 -0
package/dist/reports/src/critique-review.d.ts +111 -0
package/dist/reports/src/critique-review.js +123 -0
package/dist/reports/src/critique-row.d.ts +24 -0
package/dist/reports/src/critique-row.js +39 -0
package/dist/reports/src/evidence-types.d.ts +5 -0
package/dist/reports/src/layer-merge.js +5 -0
package/dist/reports/src/report-index.d.ts +6 -0
package/dist/reports/src/report-index.js +12 -0
package/dist/reports/src/ui-catalog-cli.d.ts +1 -1
package/dist/reports/src/ui-catalog-cli.js +3 -3
package/dist/reports/src/ui-catalog-entries.d.ts +147 -0
package/dist/reports/src/ui-catalog-entries.js +190 -0
package/dist/reports/src/ui-catalog-publish.js +2 -2
package/dist/reports/src/ui-catalog.d.ts +2 -0
package/dist/reports/src/ui-catalog.js +1 -1
package/dist/reports/src/ui-state.d.ts +2 -0
package/dist/reports/src/ui-state.js +2 -2
package/dist/schema/src/api.d.ts +653 -1
package/dist/schema/src/api.js +44 -0
package/dist/schema/src/cli-results.d.ts +674 -1
package/dist/schema/src/cli-results.js +177 -1
package/dist/schema/src/critique.d.ts +31 -0
package/dist/schema/src/critique.js +26 -0
package/dist/schema/src/server-config.d.ts +3 -3
package/dist/server/src/app.js +28 -1
package/dist/server/src/openapi.js +19 -2
package/docs/agents.md +11 -2
package/docs/critics.md +273 -9
package/docs/extending.md +1 -1
package/docs/reference/cli.md +73 -3
package/docs/reference/core.md +1 -1
package/docs/reference/critics.md +1131 -29
package/docs/reference/http-api.md +40 -0
package/docs/reference/reports.md +463 -0
package/docs/reference/schema.md +157 -1
package/docs/report-contract.md +2 -1
package/docs/server.md +2 -0
package/docs/ui-catalog.md +4 -1
package/docs/ui.md +63 -1
package/llms-full.txt +469 -18
package/llms.txt +1 -1
package/package.json +9 -1
package/packages/critics/README.md +1 -0
package/packages/schema/schemas/critic-calibrate-result.schema.json +274 -0
package/packages/schema/schemas/critic-doctor-result.schema.json +74 -0
package/packages/schema/schemas/critic-list-result.schema.json +90 -0
package/packages/schema/schemas/critic-review-result.schema.json +397 -0
package/packages/schema/schemas/critic-run-result.schema.json +249 -0
package/packages/schema/schemas/critic-setup-result.schema.json +34 -0
package/packages/schema/schemas/critic-watch-result.schema.json +211 -0
package/packages/schema/schemas/critique-mark.schema.json +81 -0
package/packages/schema/schemas/effective-delta.schema.json +337 -0
package/packages/schema/schemas/effective-evidence.schema.json +337 -0
package/packages/schema/schemas/layer-rows.schema.json +337 -0
package/packages/server/openapi.json +6755 -4738
package/packages/visualizer/src/app/AppShell.tsx +3 -1
package/packages/visualizer/src/app/router.tsx +20 -7
package/packages/visualizer/src/components/Header.tsx +16 -4
package/packages/visualizer/src/critiques/CritiquesPage.tsx +402 -0
package/packages/visualizer/src/critiques/FindingOverlay.tsx +50 -0
package/packages/visualizer/src/critiques/ranking.ts +54 -0
package/packages/visualizer/src/critiques/search.ts +41 -0
package/packages/visualizer/src/evidence/applicability-view.tsx +11 -7
package/packages/visualizer/src/evidence/behaviors-page.tsx +22 -15
package/packages/visualizer/src/explorer/Explorer.tsx +5 -0
package/packages/visualizer/src/explorer/TestDetail.tsx +4 -1
package/packages/visualizer/src/explorer/parts.tsx +19 -1
package/packages/visualizer/src/explorer/playlist.tsx +11 -7

package/dist/schema/src/api.d.ts CHANGED Viewed

@@ -54,8 +54,8 @@ export declare const ServerInfoSchema: z.ZodObject<{
     name: z.ZodLiteral<"atlas">;
     version: z.ZodNullable<z.ZodString>;
     role: z.ZodEnum<{
-        read: "read";
         critic: "critic";
+        read: "read";
         publish: "publish";
         admin: "admin";
     }>;
@@ -343,6 +343,7 @@ export declare const LayerRowSchema: z.ZodObject<{
         fixture: z.ZodOptional<z.ZodString>;
         cohort: z.ZodOptional<z.ZodString>;
         area: z.ZodOptional<z.ZodString>;
+        kind: z.ZodOptional<z.ZodString>;
         flags: z.ZodOptional<z.ZodArray<z.ZodString>>;
         covers: z.ZodOptional<z.ZodArray<z.ZodString>>;
         inventory: z.ZodOptional<z.ZodBoolean>;
@@ -358,6 +359,78 @@ export declare const LayerRowSchema: z.ZodObject<{
             omitted: z.ZodOptional<z.ZodString>;
         }, z.core.$loose>>;
     }, z.core.$loose>>;
+    critique: z.ZodOptional<z.ZodObject<{
+        schema: z.ZodNumber;
+        subject: z.ZodObject<{
+            entryKey: z.ZodString;
+            imageSha256: z.ZodString;
+            state: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>;
+        critic: z.ZodObject<{
+            name: z.ZodString;
+            version: z.ZodString;
+            kind: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>;
+        model: z.ZodOptional<z.ZodObject<{
+            id: z.ZodString;
+            provider: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>>;
+        parameters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        verdict: z.ZodOptional<z.ZodObject<{
+            score: z.ZodOptional<z.ZodNumber>;
+            scale: z.ZodOptional<z.ZodString>;
+            label: z.ZodOptional<z.ZodString>;
+            confidence: z.ZodOptional<z.ZodNumber>;
+            relative: z.ZodOptional<z.ZodObject<{
+                stateKind: z.ZodString;
+                percentile: z.ZodOptional<z.ZodNumber>;
+                sampleSize: z.ZodOptional<z.ZodNumber>;
+                previousScore: z.ZodOptional<z.ZodNumber>;
+                delta: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$loose>>;
+        }, z.core.$loose>>;
+        findings: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodOptional<z.ZodString>;
+            category: z.ZodOptional<z.ZodString>;
+            severity: z.ZodOptional<z.ZodString>;
+            confidence: z.ZodOptional<z.ZodNumber>;
+            region: z.ZodOptional<z.ZodObject<{
+                unit: z.ZodString;
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+                w: z.ZodNumber;
+                h: z.ZodNumber;
+            }, z.core.$loose>>;
+            rationale: z.ZodOptional<z.ZodString>;
+            suggestion: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>>>;
+        failure: z.ZodOptional<z.ZodObject<{
+            reason: z.ZodString;
+            message: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>>;
+        usage: z.ZodOptional<z.ZodObject<{
+            inputTokens: z.ZodOptional<z.ZodNumber>;
+            outputTokens: z.ZodOptional<z.ZodNumber>;
+            latencyMs: z.ZodOptional<z.ZodNumber>;
+            costUsd: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$loose>>;
+    }, z.core.$loose>>;
+    critiqueMark: z.ZodOptional<z.ZodObject<{
+        schema: z.ZodNumber;
+        subject: z.ZodObject<{
+            entryKey: z.ZodString;
+            imageSha256: z.ZodString;
+        }, z.core.$loose>;
+        critic: z.ZodObject<{
+            name: z.ZodString;
+            version: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>;
+        finding: z.ZodOptional<z.ZodString>;
+        decision: z.ZodString;
+        reviewer: z.ZodOptional<z.ZodString>;
+        note: z.ZodOptional<z.ZodString>;
+        layer: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>;
     recording: z.ZodOptional<z.ZodObject<{
         state: z.ZodString;
         reason: z.ZodOptional<z.ZodString>;
@@ -451,6 +524,7 @@ export declare const LayerRowsSchema: z.ZodObject<{
             fixture: z.ZodOptional<z.ZodString>;
             cohort: z.ZodOptional<z.ZodString>;
             area: z.ZodOptional<z.ZodString>;
+            kind: z.ZodOptional<z.ZodString>;
             flags: z.ZodOptional<z.ZodArray<z.ZodString>>;
             covers: z.ZodOptional<z.ZodArray<z.ZodString>>;
             inventory: z.ZodOptional<z.ZodBoolean>;
@@ -466,6 +540,78 @@ export declare const LayerRowsSchema: z.ZodObject<{
                 omitted: z.ZodOptional<z.ZodString>;
             }, z.core.$loose>>;
         }, z.core.$loose>>;
+        critique: z.ZodOptional<z.ZodObject<{
+            schema: z.ZodNumber;
+            subject: z.ZodObject<{
+                entryKey: z.ZodString;
+                imageSha256: z.ZodString;
+                state: z.ZodOptional<z.ZodString>;
+            }, z.core.$loose>;
+            critic: z.ZodObject<{
+                name: z.ZodString;
+                version: z.ZodString;
+                kind: z.ZodOptional<z.ZodString>;
+            }, z.core.$loose>;
+            model: z.ZodOptional<z.ZodObject<{
+                id: z.ZodString;
+                provider: z.ZodOptional<z.ZodString>;
+            }, z.core.$loose>>;
+            parameters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            verdict: z.ZodOptional<z.ZodObject<{
+                score: z.ZodOptional<z.ZodNumber>;
+                scale: z.ZodOptional<z.ZodString>;
+                label: z.ZodOptional<z.ZodString>;
+                confidence: z.ZodOptional<z.ZodNumber>;
+                relative: z.ZodOptional<z.ZodObject<{
+                    stateKind: z.ZodString;
+                    percentile: z.ZodOptional<z.ZodNumber>;
+                    sampleSize: z.ZodOptional<z.ZodNumber>;
+                    previousScore: z.ZodOptional<z.ZodNumber>;
+                    delta: z.ZodOptional<z.ZodNumber>;
+                }, z.core.$loose>>;
+            }, z.core.$loose>>;
+            findings: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                id: z.ZodOptional<z.ZodString>;
+                category: z.ZodOptional<z.ZodString>;
+                severity: z.ZodOptional<z.ZodString>;
+                confidence: z.ZodOptional<z.ZodNumber>;
+                region: z.ZodOptional<z.ZodObject<{
+                    unit: z.ZodString;
+                    x: z.ZodNumber;
+                    y: z.ZodNumber;
+                    w: z.ZodNumber;
+                    h: z.ZodNumber;
+                }, z.core.$loose>>;
+                rationale: z.ZodOptional<z.ZodString>;
+                suggestion: z.ZodOptional<z.ZodString>;
+            }, z.core.$loose>>>;
+            failure: z.ZodOptional<z.ZodObject<{
+                reason: z.ZodString;
+                message: z.ZodOptional<z.ZodString>;
+            }, z.core.$loose>>;
+            usage: z.ZodOptional<z.ZodObject<{
+                inputTokens: z.ZodOptional<z.ZodNumber>;
+                outputTokens: z.ZodOptional<z.ZodNumber>;
+                latencyMs: z.ZodOptional<z.ZodNumber>;
+                costUsd: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$loose>>;
+        }, z.core.$loose>>;
+        critiqueMark: z.ZodOptional<z.ZodObject<{
+            schema: z.ZodNumber;
+            subject: z.ZodObject<{
+                entryKey: z.ZodString;
+                imageSha256: z.ZodString;
+            }, z.core.$loose>;
+            critic: z.ZodObject<{
+                name: z.ZodString;
+                version: z.ZodOptional<z.ZodString>;
+            }, z.core.$loose>;
+            finding: z.ZodOptional<z.ZodString>;
+            decision: z.ZodString;
+            reviewer: z.ZodOptional<z.ZodString>;
+            note: z.ZodOptional<z.ZodString>;
+            layer: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>>;
         recording: z.ZodOptional<z.ZodObject<{
             state: z.ZodString;
             reason: z.ZodOptional<z.ZodString>;
@@ -561,6 +707,7 @@ export declare const LayerEvidenceSchema: z.ZodObject<{
             fixture: z.ZodOptional<z.ZodString>;
             cohort: z.ZodOptional<z.ZodString>;
             area: z.ZodOptional<z.ZodString>;
+            kind: z.ZodOptional<z.ZodString>;
             flags: z.ZodOptional<z.ZodArray<z.ZodString>>;
             covers: z.ZodOptional<z.ZodArray<z.ZodString>>;
             inventory: z.ZodOptional<z.ZodBoolean>;
@@ -576,6 +723,78 @@ export declare const LayerEvidenceSchema: z.ZodObject<{
                 omitted: z.ZodOptional<z.ZodString>;
             }, z.core.$loose>>;
         }, z.core.$loose>>;
+        critique: z.ZodOptional<z.ZodObject<{
+            schema: z.ZodNumber;
+            subject: z.ZodObject<{
+                entryKey: z.ZodString;
+                imageSha256: z.ZodString;
+                state: z.ZodOptional<z.ZodString>;
+            }, z.core.$loose>;
+            critic: z.ZodObject<{
+                name: z.ZodString;
+                version: z.ZodString;
+                kind: z.ZodOptional<z.ZodString>;
+            }, z.core.$loose>;
+            model: z.ZodOptional<z.ZodObject<{
+                id: z.ZodString;
+                provider: z.ZodOptional<z.ZodString>;
+            }, z.core.$loose>>;
+            parameters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            verdict: z.ZodOptional<z.ZodObject<{
+                score: z.ZodOptional<z.ZodNumber>;
+                scale: z.ZodOptional<z.ZodString>;
+                label: z.ZodOptional<z.ZodString>;
+                confidence: z.ZodOptional<z.ZodNumber>;
+                relative: z.ZodOptional<z.ZodObject<{
+                    stateKind: z.ZodString;
+                    percentile: z.ZodOptional<z.ZodNumber>;
+                    sampleSize: z.ZodOptional<z.ZodNumber>;
+                    previousScore: z.ZodOptional<z.ZodNumber>;
+                    delta: z.ZodOptional<z.ZodNumber>;
+                }, z.core.$loose>>;
+            }, z.core.$loose>>;
+            findings: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                id: z.ZodOptional<z.ZodString>;
+                category: z.ZodOptional<z.ZodString>;
+                severity: z.ZodOptional<z.ZodString>;
+                confidence: z.ZodOptional<z.ZodNumber>;
+                region: z.ZodOptional<z.ZodObject<{
+                    unit: z.ZodString;
+                    x: z.ZodNumber;
+                    y: z.ZodNumber;
+                    w: z.ZodNumber;
+                    h: z.ZodNumber;
+                }, z.core.$loose>>;
+                rationale: z.ZodOptional<z.ZodString>;
+                suggestion: z.ZodOptional<z.ZodString>;
+            }, z.core.$loose>>>;
+            failure: z.ZodOptional<z.ZodObject<{
+                reason: z.ZodString;
+                message: z.ZodOptional<z.ZodString>;
+            }, z.core.$loose>>;
+            usage: z.ZodOptional<z.ZodObject<{
+                inputTokens: z.ZodOptional<z.ZodNumber>;
+                outputTokens: z.ZodOptional<z.ZodNumber>;
+                latencyMs: z.ZodOptional<z.ZodNumber>;
+                costUsd: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$loose>>;
+        }, z.core.$loose>>;
+        critiqueMark: z.ZodOptional<z.ZodObject<{
+            schema: z.ZodNumber;
+            subject: z.ZodObject<{
+                entryKey: z.ZodString;
+                imageSha256: z.ZodString;
+            }, z.core.$loose>;
+            critic: z.ZodObject<{
+                name: z.ZodString;
+                version: z.ZodOptional<z.ZodString>;
+            }, z.core.$loose>;
+            finding: z.ZodOptional<z.ZodString>;
+            decision: z.ZodString;
+            reviewer: z.ZodOptional<z.ZodString>;
+            note: z.ZodOptional<z.ZodString>;
+            layer: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>>;
         recording: z.ZodOptional<z.ZodObject<{
             state: z.ZodString;
             reason: z.ZodOptional<z.ZodString>;
@@ -764,6 +983,7 @@ export declare const EffectiveEvidenceSchema: z.ZodObject<{
                 fixture: z.ZodOptional<z.ZodString>;
                 cohort: z.ZodOptional<z.ZodString>;
                 area: z.ZodOptional<z.ZodString>;
+                kind: z.ZodOptional<z.ZodString>;
                 flags: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 covers: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 inventory: z.ZodOptional<z.ZodBoolean>;
@@ -779,6 +999,78 @@ export declare const EffectiveEvidenceSchema: z.ZodObject<{
                     omitted: z.ZodOptional<z.ZodString>;
                 }, z.core.$loose>>;
             }, z.core.$loose>>;
+            critique: z.ZodOptional<z.ZodObject<{
+                schema: z.ZodNumber;
+                subject: z.ZodObject<{
+                    entryKey: z.ZodString;
+                    imageSha256: z.ZodString;
+                    state: z.ZodOptional<z.ZodString>;
+                }, z.core.$loose>;
+                critic: z.ZodObject<{
+                    name: z.ZodString;
+                    version: z.ZodString;
+                    kind: z.ZodOptional<z.ZodString>;
+                }, z.core.$loose>;
+                model: z.ZodOptional<z.ZodObject<{
+                    id: z.ZodString;
+                    provider: z.ZodOptional<z.ZodString>;
+                }, z.core.$loose>>;
+                parameters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                verdict: z.ZodOptional<z.ZodObject<{
+                    score: z.ZodOptional<z.ZodNumber>;
+                    scale: z.ZodOptional<z.ZodString>;
+                    label: z.ZodOptional<z.ZodString>;
+                    confidence: z.ZodOptional<z.ZodNumber>;
+                    relative: z.ZodOptional<z.ZodObject<{
+                        stateKind: z.ZodString;
+                        percentile: z.ZodOptional<z.ZodNumber>;
+                        sampleSize: z.ZodOptional<z.ZodNumber>;
+                        previousScore: z.ZodOptional<z.ZodNumber>;
+                        delta: z.ZodOptional<z.ZodNumber>;
+                    }, z.core.$loose>>;
+                }, z.core.$loose>>;
+                findings: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    id: z.ZodOptional<z.ZodString>;
+                    category: z.ZodOptional<z.ZodString>;
+                    severity: z.ZodOptional<z.ZodString>;
+                    confidence: z.ZodOptional<z.ZodNumber>;
+                    region: z.ZodOptional<z.ZodObject<{
+                        unit: z.ZodString;
+                        x: z.ZodNumber;
+                        y: z.ZodNumber;
+                        w: z.ZodNumber;
+                        h: z.ZodNumber;
+                    }, z.core.$loose>>;
+                    rationale: z.ZodOptional<z.ZodString>;
+                    suggestion: z.ZodOptional<z.ZodString>;
+                }, z.core.$loose>>>;
+                failure: z.ZodOptional<z.ZodObject<{
+                    reason: z.ZodString;
+                    message: z.ZodOptional<z.ZodString>;
+                }, z.core.$loose>>;
+                usage: z.ZodOptional<z.ZodObject<{
+                    inputTokens: z.ZodOptional<z.ZodNumber>;
+                    outputTokens: z.ZodOptional<z.ZodNumber>;
+                    latencyMs: z.ZodOptional<z.ZodNumber>;
+                    costUsd: z.ZodOptional<z.ZodNumber>;
+                }, z.core.$loose>>;
+            }, z.core.$loose>>;
+            critiqueMark: z.ZodOptional<z.ZodObject<{
+                schema: z.ZodNumber;
+                subject: z.ZodObject<{
+                    entryKey: z.ZodString;
+                    imageSha256: z.ZodString;
+                }, z.core.$loose>;
+                critic: z.ZodObject<{
+                    name: z.ZodString;
+                    version: z.ZodOptional<z.ZodString>;
+                }, z.core.$loose>;
+                finding: z.ZodOptional<z.ZodString>;
+                decision: z.ZodString;
+                reviewer: z.ZodOptional<z.ZodString>;
+                note: z.ZodOptional<z.ZodString>;
+                layer: z.ZodOptional<z.ZodString>;
+            }, z.core.$loose>>;
             recording: z.ZodOptional<z.ZodObject<{
                 state: z.ZodString;
                 reason: z.ZodOptional<z.ZodString>;
@@ -988,6 +1280,7 @@ export declare const EffectiveDeltaSchema: z.ZodObject<{
                 fixture: z.ZodOptional<z.ZodString>;
                 cohort: z.ZodOptional<z.ZodString>;
                 area: z.ZodOptional<z.ZodString>;
+                kind: z.ZodOptional<z.ZodString>;
                 flags: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 covers: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 inventory: z.ZodOptional<z.ZodBoolean>;
@@ -1003,6 +1296,78 @@ export declare const EffectiveDeltaSchema: z.ZodObject<{
                     omitted: z.ZodOptional<z.ZodString>;
                 }, z.core.$loose>>;
             }, z.core.$loose>>;
+            critique: z.ZodOptional<z.ZodObject<{
+                schema: z.ZodNumber;
+                subject: z.ZodObject<{
+                    entryKey: z.ZodString;
+                    imageSha256: z.ZodString;
+                    state: z.ZodOptional<z.ZodString>;
+                }, z.core.$loose>;
+                critic: z.ZodObject<{
+                    name: z.ZodString;
+                    version: z.ZodString;
+                    kind: z.ZodOptional<z.ZodString>;
+                }, z.core.$loose>;
+                model: z.ZodOptional<z.ZodObject<{
+                    id: z.ZodString;
+                    provider: z.ZodOptional<z.ZodString>;
+                }, z.core.$loose>>;
+                parameters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                verdict: z.ZodOptional<z.ZodObject<{
+                    score: z.ZodOptional<z.ZodNumber>;
+                    scale: z.ZodOptional<z.ZodString>;
+                    label: z.ZodOptional<z.ZodString>;
+                    confidence: z.ZodOptional<z.ZodNumber>;
+                    relative: z.ZodOptional<z.ZodObject<{
+                        stateKind: z.ZodString;
+                        percentile: z.ZodOptional<z.ZodNumber>;
+                        sampleSize: z.ZodOptional<z.ZodNumber>;
+                        previousScore: z.ZodOptional<z.ZodNumber>;
+                        delta: z.ZodOptional<z.ZodNumber>;
+                    }, z.core.$loose>>;
+                }, z.core.$loose>>;
+                findings: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    id: z.ZodOptional<z.ZodString>;
+                    category: z.ZodOptional<z.ZodString>;
+                    severity: z.ZodOptional<z.ZodString>;
+                    confidence: z.ZodOptional<z.ZodNumber>;
+                    region: z.ZodOptional<z.ZodObject<{
+                        unit: z.ZodString;
+                        x: z.ZodNumber;
+                        y: z.ZodNumber;
+                        w: z.ZodNumber;
+                        h: z.ZodNumber;
+                    }, z.core.$loose>>;
+                    rationale: z.ZodOptional<z.ZodString>;
+                    suggestion: z.ZodOptional<z.ZodString>;
+                }, z.core.$loose>>>;
+                failure: z.ZodOptional<z.ZodObject<{
+                    reason: z.ZodString;
+                    message: z.ZodOptional<z.ZodString>;
+                }, z.core.$loose>>;
+                usage: z.ZodOptional<z.ZodObject<{
+                    inputTokens: z.ZodOptional<z.ZodNumber>;
+                    outputTokens: z.ZodOptional<z.ZodNumber>;
+                    latencyMs: z.ZodOptional<z.ZodNumber>;
+                    costUsd: z.ZodOptional<z.ZodNumber>;
+                }, z.core.$loose>>;
+            }, z.core.$loose>>;
+            critiqueMark: z.ZodOptional<z.ZodObject<{
+                schema: z.ZodNumber;
+                subject: z.ZodObject<{
+                    entryKey: z.ZodString;
+                    imageSha256: z.ZodString;
+                }, z.core.$loose>;
+                critic: z.ZodObject<{
+                    name: z.ZodString;
+                    version: z.ZodOptional<z.ZodString>;
+                }, z.core.$loose>;
+                finding: z.ZodOptional<z.ZodString>;
+                decision: z.ZodString;
+                reviewer: z.ZodOptional<z.ZodString>;
+                note: z.ZodOptional<z.ZodString>;
+                layer: z.ZodOptional<z.ZodString>;
+            }, z.core.$loose>>;
             recording: z.ZodOptional<z.ZodObject<{
                 state: z.ZodString;
                 reason: z.ZodOptional<z.ZodString>;
@@ -3986,6 +4351,7 @@ export declare const UiCatalogSchema: z.ZodObject<{
         fixture: z.ZodNullable<z.ZodString>;
         cohort: z.ZodNullable<z.ZodString>;
         area: z.ZodNullable<z.ZodString>;
+        kind: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         flags: z.ZodArray<z.ZodString>;
         covers: z.ZodArray<z.ZodString>;
         producers: z.ZodArray<z.ZodString>;
@@ -4118,3 +4484,289 @@ export declare const UiCatalogSchema: z.ZodObject<{
     offset: z.ZodOptional<z.ZodNumber>;
     limit: z.ZodOptional<z.ZodNumber>;
 }, z.core.$loose>;
+/** An entry of the catalog as a critic reads it: one captured state in one profile, with the hash of its stored picture and the critiques already made of it. */
+export declare const CatalogEntrySchema: z.ZodObject<{
+    key: z.ZodString;
+    stateId: z.ZodString;
+    title: z.ZodString;
+    route: z.ZodNullable<z.ZodString>;
+    area: z.ZodNullable<z.ZodString>;
+    state: z.ZodString;
+    profile: z.ZodObject<{
+        key: z.ZodString;
+        environment: z.ZodNullable<z.ZodString>;
+        parameters: z.ZodRecord<z.ZodString, z.ZodString>;
+        label: z.ZodString;
+    }, z.core.$loose>;
+    image: z.ZodObject<{
+        sha256: z.ZodString;
+        path: z.ZodString;
+        contentType: z.ZodOptional<z.ZodString>;
+        width: z.ZodOptional<z.ZodNumber>;
+        height: z.ZodOptional<z.ZodNumber>;
+        bytes: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$loose>;
+    origin: z.ZodObject<{
+        layer: z.ZodString;
+        backend: z.ZodString;
+        producer: z.ZodString;
+        recordedAtMs: z.ZodNumber;
+        sha: z.ZodNullable<z.ZodString>;
+        branch: z.ZodNullable<z.ZodString>;
+        runUrl: z.ZodNullable<z.ZodString>;
+        freshness: z.ZodOptional<z.ZodEnum<{
+            unknown: "unknown";
+            modified: "modified";
+        }>>;
+    }, z.core.$loose>;
+    critiques: z.ZodArray<z.ZodObject<{
+        layer: z.ZodString;
+        producer: z.ZodString;
+        recordedAtMs: z.ZodNumber;
+        status: z.ZodEnum<{
+            passed: "passed";
+            failed: "failed";
+            running: "running";
+            "not-run": "not-run";
+        }>;
+        currency: z.ZodEnum<{
+            current: "current";
+            "earlier-image": "earlier-image";
+        }>;
+        critique: z.ZodObject<{
+            schema: z.ZodNumber;
+            subject: z.ZodObject<{
+                entryKey: z.ZodString;
+                imageSha256: z.ZodString;
+                state: z.ZodOptional<z.ZodString>;
+            }, z.core.$loose>;
+            critic: z.ZodObject<{
+                name: z.ZodString;
+                version: z.ZodString;
+                kind: z.ZodOptional<z.ZodString>;
+            }, z.core.$loose>;
+            model: z.ZodOptional<z.ZodObject<{
+                id: z.ZodString;
+                provider: z.ZodOptional<z.ZodString>;
+            }, z.core.$loose>>;
+            parameters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            verdict: z.ZodOptional<z.ZodObject<{
+                score: z.ZodOptional<z.ZodNumber>;
+                scale: z.ZodOptional<z.ZodString>;
+                label: z.ZodOptional<z.ZodString>;
+                confidence: z.ZodOptional<z.ZodNumber>;
+                relative: z.ZodOptional<z.ZodObject<{
+                    stateKind: z.ZodString;
+                    percentile: z.ZodOptional<z.ZodNumber>;
+                    sampleSize: z.ZodOptional<z.ZodNumber>;
+                    previousScore: z.ZodOptional<z.ZodNumber>;
+                    delta: z.ZodOptional<z.ZodNumber>;
+                }, z.core.$loose>>;
+            }, z.core.$loose>>;
+            findings: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                id: z.ZodOptional<z.ZodString>;
+                category: z.ZodOptional<z.ZodString>;
+                severity: z.ZodOptional<z.ZodString>;
+                confidence: z.ZodOptional<z.ZodNumber>;
+                region: z.ZodOptional<z.ZodObject<{
+                    unit: z.ZodString;
+                    x: z.ZodNumber;
+                    y: z.ZodNumber;
+                    w: z.ZodNumber;
+                    h: z.ZodNumber;
+                }, z.core.$loose>>;
+                rationale: z.ZodOptional<z.ZodString>;
+                suggestion: z.ZodOptional<z.ZodString>;
+            }, z.core.$loose>>>;
+            failure: z.ZodOptional<z.ZodObject<{
+                reason: z.ZodString;
+                message: z.ZodOptional<z.ZodString>;
+            }, z.core.$loose>>;
+            usage: z.ZodOptional<z.ZodObject<{
+                inputTokens: z.ZodOptional<z.ZodNumber>;
+                outputTokens: z.ZodOptional<z.ZodNumber>;
+                latencyMs: z.ZodOptional<z.ZodNumber>;
+                costUsd: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$loose>>;
+        }, z.core.$loose>;
+    }, z.core.$loose>>;
+    marks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        layer: z.ZodString;
+        producer: z.ZodString;
+        recordedAtMs: z.ZodNumber;
+        currency: z.ZodEnum<{
+            current: "current";
+            "earlier-image": "earlier-image";
+        }>;
+        mark: z.ZodObject<{
+            schema: z.ZodNumber;
+            subject: z.ZodObject<{
+                entryKey: z.ZodString;
+                imageSha256: z.ZodString;
+            }, z.core.$loose>;
+            critic: z.ZodObject<{
+                name: z.ZodString;
+                version: z.ZodOptional<z.ZodString>;
+            }, z.core.$loose>;
+            finding: z.ZodOptional<z.ZodString>;
+            decision: z.ZodString;
+            reviewer: z.ZodOptional<z.ZodString>;
+            note: z.ZodOptional<z.ZodString>;
+            layer: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>;
+    }, z.core.$loose>>>;
+}, z.core.$loose>;
+/**
+ * `GET /api/reports/ui-catalog/entries`: the UI catalog as a flat, cursor-paged list of captured states for a critic.
+ */
+export declare const CatalogEntriesSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    version: z.ZodString;
+    entries: z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+        stateId: z.ZodString;
+        title: z.ZodString;
+        route: z.ZodNullable<z.ZodString>;
+        area: z.ZodNullable<z.ZodString>;
+        state: z.ZodString;
+        profile: z.ZodObject<{
+            key: z.ZodString;
+            environment: z.ZodNullable<z.ZodString>;
+            parameters: z.ZodRecord<z.ZodString, z.ZodString>;
+            label: z.ZodString;
+        }, z.core.$loose>;
+        image: z.ZodObject<{
+            sha256: z.ZodString;
+            path: z.ZodString;
+            contentType: z.ZodOptional<z.ZodString>;
+            width: z.ZodOptional<z.ZodNumber>;
+            height: z.ZodOptional<z.ZodNumber>;
+            bytes: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$loose>;
+        origin: z.ZodObject<{
+            layer: z.ZodString;
+            backend: z.ZodString;
+            producer: z.ZodString;
+            recordedAtMs: z.ZodNumber;
+            sha: z.ZodNullable<z.ZodString>;
+            branch: z.ZodNullable<z.ZodString>;
+            runUrl: z.ZodNullable<z.ZodString>;
+            freshness: z.ZodOptional<z.ZodEnum<{
+                unknown: "unknown";
+                modified: "modified";
+            }>>;
+        }, z.core.$loose>;
+        critiques: z.ZodArray<z.ZodObject<{
+            layer: z.ZodString;
+            producer: z.ZodString;
+            recordedAtMs: z.ZodNumber;
+            status: z.ZodEnum<{
+                passed: "passed";
+                failed: "failed";
+                running: "running";
+                "not-run": "not-run";
+            }>;
+            currency: z.ZodEnum<{
+                current: "current";
+                "earlier-image": "earlier-image";
+            }>;
+            critique: z.ZodObject<{
+                schema: z.ZodNumber;
+                subject: z.ZodObject<{
+                    entryKey: z.ZodString;
+                    imageSha256: z.ZodString;
+                    state: z.ZodOptional<z.ZodString>;
+                }, z.core.$loose>;
+                critic: z.ZodObject<{
+                    name: z.ZodString;
+                    version: z.ZodString;
+                    kind: z.ZodOptional<z.ZodString>;
+                }, z.core.$loose>;
+                model: z.ZodOptional<z.ZodObject<{
+                    id: z.ZodString;
+                    provider: z.ZodOptional<z.ZodString>;
+                }, z.core.$loose>>;
+                parameters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                verdict: z.ZodOptional<z.ZodObject<{
+                    score: z.ZodOptional<z.ZodNumber>;
+                    scale: z.ZodOptional<z.ZodString>;
+                    label: z.ZodOptional<z.ZodString>;
+                    confidence: z.ZodOptional<z.ZodNumber>;
+                    relative: z.ZodOptional<z.ZodObject<{
+                        stateKind: z.ZodString;
+                        percentile: z.ZodOptional<z.ZodNumber>;
+                        sampleSize: z.ZodOptional<z.ZodNumber>;
+                        previousScore: z.ZodOptional<z.ZodNumber>;
+                        delta: z.ZodOptional<z.ZodNumber>;
+                    }, z.core.$loose>>;
+                }, z.core.$loose>>;
+                findings: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    id: z.ZodOptional<z.ZodString>;
+                    category: z.ZodOptional<z.ZodString>;
+                    severity: z.ZodOptional<z.ZodString>;
+                    confidence: z.ZodOptional<z.ZodNumber>;
+                    region: z.ZodOptional<z.ZodObject<{
+                        unit: z.ZodString;
+                        x: z.ZodNumber;
+                        y: z.ZodNumber;
+                        w: z.ZodNumber;
+                        h: z.ZodNumber;
+                    }, z.core.$loose>>;
+                    rationale: z.ZodOptional<z.ZodString>;
+                    suggestion: z.ZodOptional<z.ZodString>;
+                }, z.core.$loose>>>;
+                failure: z.ZodOptional<z.ZodObject<{
+                    reason: z.ZodString;
+                    message: z.ZodOptional<z.ZodString>;
+                }, z.core.$loose>>;
+                usage: z.ZodOptional<z.ZodObject<{
+                    inputTokens: z.ZodOptional<z.ZodNumber>;
+                    outputTokens: z.ZodOptional<z.ZodNumber>;
+                    latencyMs: z.ZodOptional<z.ZodNumber>;
+                    costUsd: z.ZodOptional<z.ZodNumber>;
+                }, z.core.$loose>>;
+            }, z.core.$loose>;
+        }, z.core.$loose>>;
+        marks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            layer: z.ZodString;
+            producer: z.ZodString;
+            recordedAtMs: z.ZodNumber;
+            currency: z.ZodEnum<{
+                current: "current";
+                "earlier-image": "earlier-image";
+            }>;
+            mark: z.ZodObject<{
+                schema: z.ZodNumber;
+                subject: z.ZodObject<{
+                    entryKey: z.ZodString;
+                    imageSha256: z.ZodString;
+                }, z.core.$loose>;
+                critic: z.ZodObject<{
+                    name: z.ZodString;
+                    version: z.ZodOptional<z.ZodString>;
+                }, z.core.$loose>;
+                finding: z.ZodOptional<z.ZodString>;
+                decision: z.ZodString;
+                reviewer: z.ZodOptional<z.ZodString>;
+                note: z.ZodOptional<z.ZodString>;
+                layer: z.ZodOptional<z.ZodString>;
+            }, z.core.$loose>;
+        }, z.core.$loose>>>;
+    }, z.core.$loose>>;
+    total: z.ZodNumber;
+    nextCursor: z.ZodOptional<z.ZodString>;
+    since: z.ZodOptional<z.ZodObject<{
+        requested: z.ZodString;
+        honored: z.ZodBoolean;
+    }, z.core.$loose>>;
+    unjudgeable: z.ZodNumber;
+    sources: z.ZodObject<{
+        backends: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            label: z.ZodString;
+            live: z.ZodBoolean;
+            available: z.ZodBoolean;
+        }, z.core.$loose>>;
+        notices: z.ZodArray<z.ZodString>;
+    }, z.core.$loose>;
+}, z.core.$loose>;