@ztothez/design-engineering 2.0.0

package/dist/src/generation/schema.js

@@ -0,0 +1,50 @@
+import { z } from "zod";
+const relativePathSchema = z
+    .string()
+    .min(1)
+    .max(1_024)
+    .refine((value) => !value.includes("\0") &&
+    !value.startsWith("/") &&
+    !/^[A-Za-z]:[\\/]/.test(value) &&
+    !value.split(/[\\/]/).includes(".."), "Generated paths must remain relative and cannot contain parent traversal.");
+export const generatedFileSchema = z
+    .object({
+    path: relativePathSchema,
+    digest: z.string().regex(/^[a-f0-9]{64}$/),
+    bytes: z.number().int().nonnegative(),
+})
+    .strict();
+export const generationManifestSchema = z
+    .object({
+    version: z.literal("1.0"),
+    adapter: z.literal("react-typescript-vite"),
+    adapterVersion: z.string().regex(/^\d+\.\d+\.\d+$/),
+    plan: z
+        .object({
+        id: z.string().min(1).max(256),
+        sourceDigest: z.string().regex(/^[a-f0-9]{64}$/),
+        compilerVersion: z.string().regex(/^\d+\.\d+\.\d+$/),
+    })
+        .strict(),
+    outputMode: z.literal("new-independent-fixture"),
+    files: z.array(generatedFileSchema).min(1),
+    guarantees: z.array(z.string().min(1).max(1_024)).min(1),
+    limitations: z.array(z.string().min(1).max(1_024)).min(1),
+})
+    .strict();
+export const generationReportSchema = z
+    .object({
+    version: z.literal("1.0"),
+    adapter: z.literal("react-typescript-vite"),
+    adapterVersion: z.string().regex(/^\d+\.\d+\.\d+$/),
+    status: z.literal("generated"),
+    product: z.string().min(1).max(2_048),
+    planId: z.string().min(1).max(256),
+    target: relativePathSchema,
+    manifest: relativePathSchema,
+    files: z.array(generatedFileSchema).min(1),
+    capabilities: z.array(z.string().min(1).max(1_024)).min(1),
+    limitations: z.array(z.string().min(1).max(1_024)).min(1),
+})
+    .strict();
+//# sourceMappingURL=schema.js.map

package/dist/src/generation/schema.js.map

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

package/dist/src/generation/templates/tokens.d.ts

@@ -0,0 +1 @@
+export declare const tokenStyles = ":root {\n  color-scheme: light;\n  --font-sans: Inter, ui-sans-serif, system-ui, sans-serif;\n  --color-canvas: #f5f7f9;\n  --color-surface: #ffffff;\n  --color-surface-raised: #eef2f5;\n  --color-text: #172029;\n  --color-text-muted: #52606d;\n  --color-border: #cad3dc;\n  --color-action: #075985;\n  --color-action-hover: #0c4a6e;\n  --color-action-text: #ffffff;\n  --color-focus: #b45309;\n  --color-positive: #166534;\n  --color-negative: #991b1b;\n  --color-warning: #854d0e;\n  --space-1: 0.25rem;\n  --space-2: 0.5rem;\n  --space-3: 0.75rem;\n  --space-4: 1rem;\n  --space-5: 1.5rem;\n  --space-6: 2rem;\n  --space-7: 3rem;\n  --radius-control: 0.25rem;\n  --radius-panel: 0.5rem;\n  --border-width: 0.0625rem;\n  --focus-width: 0.1875rem;\n  --duration-fast: 120ms;\n  --font-size-page-title: 2rem;\n  --font-size-section-title: 1.25rem;\n  --font-size-item-title: 1.05rem;\n  --font-size-label: 0.8rem;\n  --measure-copy: 64ch;\n  --measure-workspace: 76rem;\n  --measure-aside: 18rem;\n  --size-step: 2rem;\n  --size-message: 4.5rem;\n}\n\n@media (prefers-color-scheme: dark) {\n  :root {\n    color-scheme: dark;\n    --color-canvas: #11161c;\n    --color-surface: #18212a;\n    --color-surface-raised: #202b35;\n    --color-text: #f4f7f9;\n    --color-text-muted: #c3ced7;\n    --color-border: #526170;\n    --color-action: #38bdf8;\n    --color-action-hover: #7dd3fc;\n    --color-action-text: #082f49;\n    --color-focus: #fbbf24;\n    --color-positive: #86efac;\n    --color-negative: #fca5a5;\n    --color-warning: #fde047;\n  }\n}\n";

package/dist/src/generation/templates/tokens.js

@@ -0,0 +1,59 @@
+export const tokenStyles = `:root {
+  color-scheme: light;
+  --font-sans: Inter, ui-sans-serif, system-ui, sans-serif;
+  --color-canvas: #f5f7f9;
+  --color-surface: #ffffff;
+  --color-surface-raised: #eef2f5;
+  --color-text: #172029;
+  --color-text-muted: #52606d;
+  --color-border: #cad3dc;
+  --color-action: #075985;
+  --color-action-hover: #0c4a6e;
+  --color-action-text: #ffffff;
+  --color-focus: #b45309;
+  --color-positive: #166534;
+  --color-negative: #991b1b;
+  --color-warning: #854d0e;
+  --space-1: 0.25rem;
+  --space-2: 0.5rem;
+  --space-3: 0.75rem;
+  --space-4: 1rem;
+  --space-5: 1.5rem;
+  --space-6: 2rem;
+  --space-7: 3rem;
+  --radius-control: 0.25rem;
+  --radius-panel: 0.5rem;
+  --border-width: 0.0625rem;
+  --focus-width: 0.1875rem;
+  --duration-fast: 120ms;
+  --font-size-page-title: 2rem;
+  --font-size-section-title: 1.25rem;
+  --font-size-item-title: 1.05rem;
+  --font-size-label: 0.8rem;
+  --measure-copy: 64ch;
+  --measure-workspace: 76rem;
+  --measure-aside: 18rem;
+  --size-step: 2rem;
+  --size-message: 4.5rem;
+}
+
+@media (prefers-color-scheme: dark) {
+  :root {
+    color-scheme: dark;
+    --color-canvas: #11161c;
+    --color-surface: #18212a;
+    --color-surface-raised: #202b35;
+    --color-text: #f4f7f9;
+    --color-text-muted: #c3ced7;
+    --color-border: #526170;
+    --color-action: #38bdf8;
+    --color-action-hover: #7dd3fc;
+    --color-action-text: #082f49;
+    --color-focus: #fbbf24;
+    --color-positive: #86efac;
+    --color-negative: #fca5a5;
+    --color-warning: #fde047;
+  }
+}
+`;
+//# sourceMappingURL=tokens.js.map

package/dist/src/generation/templates/tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.js","sourceRoot":"","sources":["../../../../src/generation/templates/tokens.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,WAAW,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyD1B,CAAC"}

package/dist/src/heuristics/evaluator.d.ts

@@ -0,0 +1,2 @@
+import type { HeuristicReview, HeuristicReviewReport } from "./schema.js";
+export declare function evaluateHeuristicReview(review: HeuristicReview, sourcePath: string): HeuristicReviewReport;

package/dist/src/heuristics/evaluator.js

@@ -0,0 +1,65 @@
+import { resolve } from "node:path";
+const REPORT_VERSION = "1.0.0";
+function evidenceForValidation(method) {
+    if (method === "runtime")
+        return ["runtime"];
+    if (method === "accessibility")
+        return ["accessibility"];
+    if (method === "screenshot-review")
+        return ["screenshot", "manual-review"];
+    return ["manual-review"];
+}
+function criterionId(findingId) {
+    return `heuristic-${findingId}`.slice(0, 64).replace(/-+$/g, "");
+}
+function acceptanceCandidate(finding, review) {
+    const task = review.tasks.find((candidate) => candidate.id === finding.task);
+    if (!task)
+        throw new Error(`Finding ${finding.id} references unavailable task ${finding.task}`);
+    const requirement = [
+        finding.remediation,
+        `Validation: ${finding.validation.procedure}`,
+    ].join(" ");
+    return {
+        sourceFinding: finding.id,
+        id: criterionId(finding.id),
+        title: finding.title,
+        severity: "blocker",
+        requirement: requirement.slice(0, 2_048),
+        evidence: evidenceForValidation(finding.validation.method),
+        appliesToModes: task.modes,
+    };
+}
+export function evaluateHeuristicReview(review, sourcePath) {
+    const open = review.findings.filter((finding) => finding.status === "open");
+    const acceptanceCandidates = open
+        .filter((finding) => finding.severity >= 3)
+        .map((finding) => acceptanceCandidate(finding, review));
+    const evidence = review.findings.flatMap((finding) => finding.evidence);
+    return {
+        version: REPORT_VERSION,
+        generatedAt: new Date().toISOString(),
+        sourcePath: resolve(sourcePath),
+        reviewId: review.id,
+        product: review.product,
+        findings: review.findings,
+        acceptanceCandidates,
+        evidenceLevels: {
+            automated: evidence.filter((entry) => entry.level === "automated").length,
+            aiAssistedExpert: evidence.filter((entry) => entry.level === "ai-assisted-expert").length,
+            humanExpert: evidence.filter((entry) => entry.level === "human-expert").length,
+            representativeUser: evidence.filter((entry) => entry.level === "representative-user").length,
+        },
+        summary: {
+            total: review.findings.length,
+            open: open.length,
+            resolved: review.findings.filter((finding) => finding.status === "resolved").length,
+            acceptedRisk: review.findings.filter((finding) => finding.status === "accepted-risk").length,
+            severity3: review.findings.filter((finding) => finding.severity === 3).length,
+            severity4: review.findings.filter((finding) => finding.severity === 4).length,
+            acceptanceCandidates: acceptanceCandidates.length,
+        },
+        requiresAcceptanceWork: acceptanceCandidates.length > 0,
+    };
+}
+//# sourceMappingURL=evaluator.js.map

package/dist/src/heuristics/evaluator.js.map

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

package/dist/src/heuristics/loader.d.ts

@@ -0,0 +1,2 @@
+import { type HeuristicReview } from "./schema.js";
+export declare function loadHeuristicReview(path: string): Promise<HeuristicReview>;

package/dist/src/heuristics/loader.js

@@ -0,0 +1,21 @@
+import { readFile, stat } from "node:fs/promises";
+import { extname, resolve } from "node:path";
+import { parse } from "yaml";
+import { heuristicReviewSchema } from "./schema.js";
+const MAX_REVIEW_BYTES = 1024 * 1024;
+export async function loadHeuristicReview(path) {
+    const resolvedPath = resolve(path);
+    if (!/^\.(?:json|ya?ml)$/i.test(extname(resolvedPath))) {
+        throw new Error("Heuristic reviews must end in .json, .yaml, or .yml");
+    }
+    const fileStats = await stat(resolvedPath);
+    if (!fileStats.isFile())
+        throw new Error("Heuristic review path is not a regular file");
+    if (fileStats.size > MAX_REVIEW_BYTES) {
+        throw new Error(`Heuristic review exceeds ${MAX_REVIEW_BYTES} bytes`);
+    }
+    const text = await readFile(resolvedPath, "utf8");
+    const content = resolvedPath.endsWith(".json") ? JSON.parse(text) : parse(text);
+    return heuristicReviewSchema.parse(content);
+}
+//# sourceMappingURL=loader.js.map

package/dist/src/heuristics/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../../src/heuristics/loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAE7C,OAAO,EAAE,KAAK,EAAE,MAAM,MAAM,CAAC;AAE7B,OAAO,EAAE,qBAAqB,EAAwB,MAAM,aAAa,CAAC;AAE1E,MAAM,gBAAgB,GAAG,IAAI,GAAG,IAAI,CAAC;AAErC,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,IAAY;IACpD,MAAM,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC;QACvD,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACzE,CAAC;IACD,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,CAAC;IAC3C,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;IACxF,IAAI,SAAS,CAAC,IAAI,GAAG,gBAAgB,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CAAC,4BAA4B,gBAAgB,QAAQ,CAAC,CAAC;IACxE,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IAClD,MAAM,OAAO,GAAY,YAAY,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACzF,OAAO,qBAAqB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;AAC9C,CAAC"}

package/dist/src/heuristics/report.d.ts

@@ -0,0 +1,3 @@
+import type { HeuristicAcceptanceCandidate, HeuristicReviewReport } from "./schema.js";
+export declare function formatAcceptanceCandidates(candidates: HeuristicAcceptanceCandidate[]): string;
+export declare function formatHeuristicReviewReport(report: HeuristicReviewReport): string;

package/dist/src/heuristics/report.js

@@ -0,0 +1,31 @@
+import { stringify } from "yaml";
+export function formatAcceptanceCandidates(candidates) {
+    return stringify({
+        acceptanceCriteria: candidates.map(({ sourceFinding: _sourceFinding, ...criterion }) => criterion),
+    }).trimEnd();
+}
+export function formatHeuristicReviewReport(report) {
+    const lines = [
+        "# ZtotheZ Design Engineering Heuristic Review",
+        "",
+        `- Review: \`${report.reviewId}\``,
+        `- Product: ${report.product}`,
+        `- Source: \`${report.sourcePath}\``,
+        `- Findings: ${report.summary.total} total, ${report.summary.open} open, ${report.summary.resolved} resolved, ${report.summary.acceptedRisk} accepted risk`,
+        `- Major and catastrophic findings: ${report.summary.severity3} severity 3, ${report.summary.severity4} severity 4`,
+        `- Acceptance candidates: ${report.summary.acceptanceCandidates}`,
+        `- Result: ${report.requiresAcceptanceWork ? "ACCEPTANCE WORK REQUIRED" : "NO OPEN SEVERITY 3-4 FINDINGS"}`,
+        "",
+        "Evidence levels remain distinct. This report is expert-review input, not a human acceptance attestation or representative-user usability-test result.",
+    ];
+    if (report.findings.length > 0)
+        lines.push("", "## Findings");
+    for (const finding of report.findings) {
+        lines.push("", `### Severity ${finding.severity}: ${finding.title}`, "", `- ID: \`${finding.id}\``, `- Task: \`${finding.task}\``, `- Heuristic: ${finding.heuristic.name} (\`${finding.heuristic.id}\`)`, `- Status: ${finding.status}`, `- Confidence: ${finding.confidence}`, `- Location: ${finding.location}`, `- Observation: ${finding.observation}`, `- Impact: ${finding.impact}`, `- Remediation: ${finding.remediation}`, `- Validation: ${finding.validation.method}: ${finding.validation.procedure}`, ...finding.evidence.map((entry) => `- Evidence (${entry.level}): ${entry.source}: ${entry.detail}`));
+    }
+    if (report.acceptanceCandidates.length > 0) {
+        lines.push("", "## Acceptance-Criterion Candidates", "", "Review and merge these proposals into the applicable product contract. They are not attestations and are not applied automatically.", "", "```yaml", formatAcceptanceCandidates(report.acceptanceCandidates), "```", "", ...report.acceptanceCandidates.map((candidate) => `- \`${candidate.id}\` originates from finding \`${candidate.sourceFinding}\`.`));
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=report.js.map

package/dist/src/heuristics/report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.js","sourceRoot":"","sources":["../../../src/heuristics/report.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,MAAM,CAAC;AAIjC,MAAM,UAAU,0BAA0B,CACxC,UAA0C;IAE1C,OAAO,SAAS,CAAC;QACf,kBAAkB,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,EAAE,aAAa,EAAE,cAAc,EAAE,GAAG,SAAS,EAAE,EAAE,EAAE,CACrF,SAAS,CACV;KACF,CAAC,CAAC,OAAO,EAAE,CAAC;AACf,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,MAA6B;IACvE,MAAM,KAAK,GAAG;QACZ,+CAA+C;QAC/C,EAAE;QACF,eAAe,MAAM,CAAC,QAAQ,IAAI;QAClC,cAAc,MAAM,CAAC,OAAO,EAAE;QAC9B,eAAe,MAAM,CAAC,UAAU,IAAI;QACpC,eAAe,MAAM,CAAC,OAAO,CAAC,KAAK,WAAW,MAAM,CAAC,OAAO,CAAC,IAAI,UAAU,MAAM,CAAC,OAAO,CAAC,QAAQ,cAAc,MAAM,CAAC,OAAO,CAAC,YAAY,gBAAgB;QAC3J,sCAAsC,MAAM,CAAC,OAAO,CAAC,SAAS,gBAAgB,MAAM,CAAC,OAAO,CAAC,SAAS,aAAa;QACnH,4BAA4B,MAAM,CAAC,OAAO,CAAC,oBAAoB,EAAE;QACjE,aAAa,MAAM,CAAC,sBAAsB,CAAC,CAAC,CAAC,0BAA0B,CAAC,CAAC,CAAC,+BAA+B,EAAE;QAC3G,EAAE;QACF,uJAAuJ;KACxJ,CAAC;IAEF,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,aAAa,CAAC,CAAC;IAC9D,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACtC,KAAK,CAAC,IAAI,CACR,EAAE,EACF,gBAAgB,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,KAAK,EAAE,EACpD,EAAE,EACF,WAAW,OAAO,CAAC,EAAE,IAAI,EACzB,aAAa,OAAO,CAAC,IAAI,IAAI,EAC7B,gBAAgB,OAAO,CAAC,SAAS,CAAC,IAAI,OAAO,OAAO,CAAC,SAAS,CAAC,EAAE,KAAK,EACtE,aAAa,OAAO,CAAC,MAAM,EAAE,EAC7B,iBAAiB,OAAO,CAAC,UAAU,EAAE,EACrC,eAAe,OAAO,CAAC,QAAQ,EAAE,EACjC,kBAAkB,OAAO,CAAC,WAAW,EAAE,EACvC,aAAa,OAAO,CAAC,MAAM,EAAE,EAC7B,kBAAkB,OAAO,CAAC,WAAW,EAAE,EACvC,iBAAiB,OAAO,CAAC,UAAU,CAAC,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,SAAS,EAAE,EAC7E,GAAG,OAAO,CAAC,QAAQ,CAAC,GAAG,CACrB,CAAC,KAAK,EAAE,EAAE,CAAC,eAAe,KAAK,CAAC,KAAK,MAAM,KAAK,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM,EAAE,CAC3E,CACF,CAAC;IACJ,CAAC;IAED,IAAI,MAAM,CAAC,oBAAoB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3C,KAAK,CAAC,IAAI,CACR,EAAE,EACF,oCAAoC,EACpC,EAAE,EACF,qIAAqI,EACrI,EAAE,EACF,SAAS,EACT,0BAA0B,CAAC,MAAM,CAAC,oBAAoB,CAAC,EACvD,KAAK,EACL,EAAE,EACF,GAAG,MAAM,CAAC,oBAAoB,CAAC,GAAG,CAChC,CAAC,SAAS,EAAE,EAAE,CAAC,OAAO,SAAS,CAAC,EAAE,gCAAgC,SAAS,CAAC,aAAa,KAAK,CAC/F,CACF,CAAC;IACJ,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/src/heuristics/schema.d.ts

@@ -0,0 +1,198 @@
+import { z } from "zod";
+export declare const heuristicEvidenceLevelSchema: z.ZodEnum<{
+    automated: "automated";
+    "ai-assisted-expert": "ai-assisted-expert";
+    "human-expert": "human-expert";
+    "representative-user": "representative-user";
+}>;
+export declare const heuristicReviewSchema: z.ZodObject<{
+    version: z.ZodLiteral<"1.0">;
+    id: z.ZodString;
+    product: z.ZodString;
+    target: z.ZodString;
+    preparedAt: z.ZodString;
+    preparedBy: z.ZodObject<{
+        type: z.ZodEnum<{
+            agent: "agent";
+            human: "human";
+            mixed: "mixed";
+        }>;
+        name: z.ZodString;
+    }, z.core.$strict>;
+    tasks: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        actor: z.ZodString;
+        scenario: z.ZodString;
+        successCriteria: z.ZodArray<z.ZodString>;
+        modes: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>>;
+    findings: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        task: z.ZodString;
+        heuristic: z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+        }, z.core.$strict>;
+        location: z.ZodString;
+        trigger: z.ZodString;
+        observation: z.ZodString;
+        impact: z.ZodString;
+        evidence: z.ZodArray<z.ZodObject<{
+            level: z.ZodEnum<{
+                automated: "automated";
+                "ai-assisted-expert": "ai-assisted-expert";
+                "human-expert": "human-expert";
+                "representative-user": "representative-user";
+            }>;
+            source: z.ZodString;
+            detail: z.ZodString;
+            contributor: z.ZodOptional<z.ZodString>;
+            recordedAt: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        severity: z.ZodNumber;
+        confidence: z.ZodEnum<{
+            high: "high";
+            medium: "medium";
+            low: "low";
+        }>;
+        status: z.ZodEnum<{
+            resolved: "resolved";
+            open: "open";
+            "accepted-risk": "accepted-risk";
+        }>;
+        remediation: z.ZodString;
+        validation: z.ZodObject<{
+            method: z.ZodEnum<{
+                runtime: "runtime";
+                accessibility: "accessibility";
+                "screenshot-review": "screenshot-review";
+                "expert-review": "expert-review";
+                "representative-user-test": "representative-user-test";
+                analytics: "analytics";
+            }>;
+            procedure: z.ZodString;
+        }, z.core.$strict>;
+        resolution: z.ZodOptional<z.ZodObject<{
+            rationale: z.ZodString;
+            decidedBy: z.ZodString;
+            decidedAt: z.ZodString;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+declare const acceptanceCandidateSchema: z.ZodObject<{
+    sourceFinding: z.ZodString;
+    id: z.ZodString;
+    title: z.ZodString;
+    severity: z.ZodLiteral<"blocker">;
+    requirement: z.ZodString;
+    evidence: z.ZodArray<z.ZodEnum<{
+        export: "export";
+        screenshot: "screenshot";
+        contract: "contract";
+        runtime: "runtime";
+        network: "network";
+        accessibility: "accessibility";
+        "manual-review": "manual-review";
+    }>>;
+    appliesToModes: z.ZodArray<z.ZodString>;
+}, z.core.$strict>;
+export declare const heuristicReviewReportSchema: z.ZodObject<{
+    version: z.ZodString;
+    generatedAt: z.ZodString;
+    sourcePath: z.ZodString;
+    reviewId: z.ZodString;
+    product: z.ZodString;
+    findings: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        task: z.ZodString;
+        heuristic: z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+        }, z.core.$strict>;
+        location: z.ZodString;
+        trigger: z.ZodString;
+        observation: z.ZodString;
+        impact: z.ZodString;
+        evidence: z.ZodArray<z.ZodObject<{
+            level: z.ZodEnum<{
+                automated: "automated";
+                "ai-assisted-expert": "ai-assisted-expert";
+                "human-expert": "human-expert";
+                "representative-user": "representative-user";
+            }>;
+            source: z.ZodString;
+            detail: z.ZodString;
+            contributor: z.ZodOptional<z.ZodString>;
+            recordedAt: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        severity: z.ZodNumber;
+        confidence: z.ZodEnum<{
+            high: "high";
+            medium: "medium";
+            low: "low";
+        }>;
+        status: z.ZodEnum<{
+            resolved: "resolved";
+            open: "open";
+            "accepted-risk": "accepted-risk";
+        }>;
+        remediation: z.ZodString;
+        validation: z.ZodObject<{
+            method: z.ZodEnum<{
+                runtime: "runtime";
+                accessibility: "accessibility";
+                "screenshot-review": "screenshot-review";
+                "expert-review": "expert-review";
+                "representative-user-test": "representative-user-test";
+                analytics: "analytics";
+            }>;
+            procedure: z.ZodString;
+        }, z.core.$strict>;
+        resolution: z.ZodOptional<z.ZodObject<{
+            rationale: z.ZodString;
+            decidedBy: z.ZodString;
+            decidedAt: z.ZodString;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    acceptanceCandidates: z.ZodArray<z.ZodObject<{
+        sourceFinding: z.ZodString;
+        id: z.ZodString;
+        title: z.ZodString;
+        severity: z.ZodLiteral<"blocker">;
+        requirement: z.ZodString;
+        evidence: z.ZodArray<z.ZodEnum<{
+            export: "export";
+            screenshot: "screenshot";
+            contract: "contract";
+            runtime: "runtime";
+            network: "network";
+            accessibility: "accessibility";
+            "manual-review": "manual-review";
+        }>>;
+        appliesToModes: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>>;
+    evidenceLevels: z.ZodObject<{
+        automated: z.ZodNumber;
+        aiAssistedExpert: z.ZodNumber;
+        humanExpert: z.ZodNumber;
+        representativeUser: z.ZodNumber;
+    }, z.core.$strip>;
+    summary: z.ZodObject<{
+        total: z.ZodNumber;
+        open: z.ZodNumber;
+        resolved: z.ZodNumber;
+        acceptedRisk: z.ZodNumber;
+        severity3: z.ZodNumber;
+        severity4: z.ZodNumber;
+        acceptanceCandidates: z.ZodNumber;
+    }, z.core.$strip>;
+    requiresAcceptanceWork: z.ZodBoolean;
+}, z.core.$strict>;
+export type HeuristicReview = z.infer<typeof heuristicReviewSchema>;
+export type HeuristicFinding = HeuristicReview["findings"][number];
+export type HeuristicEvidenceLevel = z.infer<typeof heuristicEvidenceLevelSchema>;
+export type HeuristicAcceptanceCandidate = z.infer<typeof acceptanceCandidateSchema>;
+export type HeuristicReviewReport = z.infer<typeof heuristicReviewReportSchema>;
+export {};