@ztothez/design-engineering 2.0.0

package/dist/cli/validate-trust.js

@@ -0,0 +1,53 @@
+#!/usr/bin/env node
+import { resolve } from "node:path";
+import { loadInterfaceTrustContract } from "../src/interface-trust/loader.js";
+import { formatInterfaceTrustReport } from "../src/interface-trust/report.js";
+import { validateInterfaceTrustContract } from "../src/interface-trust/validator.js";
+function usage() {
+    return [
+        "Usage: npm run validate-trust -- --contract PATH [--json]",
+        "",
+        "Validates a version 1.0 interface-trust contract for state provenance, claim sources, pre-action disclosure, fallback and stale behavior, history and export preservation, and credential-like values.",
+        "The result does not prove rendered disclosure, backend availability, or human comprehension.",
+    ].join("\n");
+}
+function parseArguments(argumentsList) {
+    let contract = "";
+    let json = false;
+    for (let index = 0; index < argumentsList.length; index += 1) {
+        const argument = argumentsList[index];
+        const next = argumentsList[index + 1];
+        if (argument === "--contract" && next) {
+            contract = resolve(next);
+            index += 1;
+        }
+        else if (argument === "--json") {
+            json = true;
+        }
+        else {
+            throw new Error(`Unknown or incomplete argument: ${argument}`);
+        }
+    }
+    if (!contract)
+        throw new Error("--contract is required");
+    return { contract, json };
+}
+async function main() {
+    const argumentsList = process.argv.slice(2);
+    if (argumentsList.includes("--help") || argumentsList.includes("-h")) {
+        process.stdout.write(`${usage()}\n`);
+        return;
+    }
+    const options = parseArguments(argumentsList);
+    const contract = await loadInterfaceTrustContract(options.contract);
+    const report = validateInterfaceTrustContract(contract, options.contract);
+    process.stdout.write(`${options.json ? JSON.stringify(report, null, 2) : formatInterfaceTrustReport(report)}\n`);
+    if (!report.passed)
+        process.exitCode = 1;
+}
+main().catch((error) => {
+    const message = error instanceof Error ? error.stack ?? error.message : String(error);
+    process.stderr.write(`Interface trust validation failed: ${message}\n\n${usage()}\n`);
+    process.exitCode = 1;
+});
+//# sourceMappingURL=validate-trust.js.map

package/dist/cli/validate-trust.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-trust.js","sourceRoot":"","sources":["../../cli/validate-trust.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,0BAA0B,EAAE,MAAM,kCAAkC,CAAC;AAC9E,OAAO,EAAE,0BAA0B,EAAE,MAAM,kCAAkC,CAAC;AAC9E,OAAO,EAAE,8BAA8B,EAAE,MAAM,qCAAqC,CAAC;AAOrF,SAAS,KAAK;IACZ,OAAO;QACL,2DAA2D;QAC3D,EAAE;QACF,wMAAwM;QACxM,8FAA8F;KAC/F,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,SAAS,cAAc,CAAC,aAAuB;IAC7C,IAAI,QAAQ,GAAG,EAAE,CAAC;IAClB,IAAI,IAAI,GAAG,KAAK,CAAC;IACjB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,aAAa,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QAC7D,MAAM,QAAQ,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;QACtC,MAAM,IAAI,GAAG,aAAa,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;QACtC,IAAI,QAAQ,KAAK,YAAY,IAAI,IAAI,EAAE,CAAC;YACtC,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;YACzB,KAAK,IAAI,CAAC,CAAC;QACb,CAAC;aAAM,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;YACjC,IAAI,GAAG,IAAI,CAAC;QACd,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,KAAK,CAAC,mCAAmC,QAAQ,EAAE,CAAC,CAAC;QACjE,CAAC;IACH,CAAC;IACD,IAAI,CAAC,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;IACzD,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;AAC5B,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,MAAM,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC5C,IAAI,aAAa,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,aAAa,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACrE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,EAAE,IAAI,CAAC,CAAC;QACrC,OAAO;IACT,CAAC;IACD,MAAM,OAAO,GAAG,cAAc,CAAC,aAAa,CAAC,CAAC;IAC9C,MAAM,QAAQ,GAAG,MAAM,0BAA0B,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACpE,MAAM,MAAM,GAAG,8BAA8B,CAAC,QAAQ,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC1E,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,0BAA0B,CAAC,MAAM,CAAC,IAAI,CAC3F,CAAC;IACF,IAAI,CAAC,MAAM,CAAC,MAAM;QAAE,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AAC3C,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IAC9B,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACtF,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,sCAAsC,OAAO,OAAO,KAAK,EAAE,IAAI,CAAC,CAAC;IACtF,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC,CAAC,CAAC"}

package/dist/cli/verify-ui.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli/verify-ui.js

@@ -0,0 +1,181 @@
+#!/usr/bin/env node
+import { resolve } from "node:path";
+import { loadRuntimeJourneySelection } from "../src/contracts/journeys.js";
+import { formatRuntimeReport } from "../src/runtime/report.js";
+import { verifyUiRuntime } from "../src/runtime/verifier.js";
+function usage() {
+    return [
+        "Usage: npm run verify-ui -- --url URL [options]",
+        "",
+        "Options:",
+        "  --output PATH                 Evidence directory",
+        "  --journeys PATH               JSON file containing declarative journeys",
+        "  --profile ID                  Profile ID when --journeys contains a journey suite",
+        "  --viewports 375x812,768x1024  Override default viewport matrix",
+        "  --color-schemes light,dark      Verify one or both rendered themes",
+        "  --settle-ms NUMBER             Wait after navigation before inspection",
+        "  --chromium PATH                Chromium executable",
+        "  --dynamic-selector SELECTOR    Mask one dynamic region; repeat as needed",
+        "  --screenshot-baseline PATH     Compare screenshots with a versioned JSON baseline",
+        "  --update-screenshot-baseline   Write the baseline instead of comparing",
+        "  --json                         Print JSON instead of Markdown",
+        "  --fail-on error|warning|none   Exit policy, default error",
+    ].join("\n");
+}
+function parseViewports(value) {
+    return value.split(",").map((entry) => {
+        const match = /^(\d+)x(\d+)$/.exec(entry.trim());
+        if (!match)
+            throw new Error(`Invalid viewport: ${entry}`);
+        const width = Number(match[1]);
+        const height = Number(match[2]);
+        return { name: `custom-${width}x${height}`, width, height };
+    });
+}
+function parseArguments(argumentsList) {
+    let url = "";
+    let outputDirectory = resolve(".ztothez-design-runtime", new Date().toISOString().replace(/[:.]/g, "-"));
+    let journeysFile;
+    let journeyProfile;
+    let viewports;
+    let colorSchemes;
+    let settleMs;
+    let chromiumPath;
+    const dynamicSelectors = [];
+    let screenshotBaselinePath;
+    let updateScreenshotBaseline = false;
+    let json = false;
+    let failOn = "error";
+    for (let index = 0; index < argumentsList.length; index += 1) {
+        const argument = argumentsList[index];
+        const next = argumentsList[index + 1];
+        if (argument === "--url" && next) {
+            url = next;
+            index += 1;
+        }
+        else if (argument === "--output" && next) {
+            outputDirectory = resolve(next);
+            index += 1;
+        }
+        else if (argument === "--journeys" && next) {
+            journeysFile = resolve(next);
+            index += 1;
+        }
+        else if (argument === "--profile" && next) {
+            journeyProfile = next;
+            index += 1;
+        }
+        else if (argument === "--viewports" && next) {
+            viewports = parseViewports(next);
+            index += 1;
+        }
+        else if (argument === "--color-schemes" && next) {
+            const entries = next.split(",").map((entry) => entry.trim());
+            if (entries.length === 0 || entries.some((entry) => entry !== "light" && entry !== "dark")) {
+                throw new Error("--color-schemes must contain light, dark, or light,dark");
+            }
+            colorSchemes = entries;
+            index += 1;
+        }
+        else if (argument === "--settle-ms" && next) {
+            settleMs = Number(next);
+            if (!Number.isInteger(settleMs) || settleMs < 0 || settleMs > 30_000) {
+                throw new Error("--settle-ms must be an integer between 0 and 30000");
+            }
+            index += 1;
+        }
+        else if (argument === "--chromium" && next) {
+            chromiumPath = resolve(next);
+            index += 1;
+        }
+        else if (argument === "--dynamic-selector" && next) {
+            dynamicSelectors.push(next);
+            index += 1;
+        }
+        else if (argument === "--screenshot-baseline" && next) {
+            screenshotBaselinePath = resolve(next);
+            index += 1;
+        }
+        else if (argument === "--update-screenshot-baseline") {
+            updateScreenshotBaseline = true;
+        }
+        else if (argument === "--json") {
+            json = true;
+        }
+        else if (argument === "--fail-on" && next) {
+            if (next !== "error" && next !== "warning" && next !== "none") {
+                throw new Error("--fail-on must be error, warning, or none");
+            }
+            failOn = next;
+            index += 1;
+        }
+        else if (argument === "--help" || argument === "-h") {
+            process.stdout.write(`${usage()}\n`);
+            process.exit(0);
+        }
+        else {
+            throw new Error(`Unknown or incomplete argument: ${argument}`);
+        }
+    }
+    if (!url)
+        throw new Error("--url is required");
+    if (journeyProfile && !journeysFile) {
+        throw new Error("--profile requires --journeys");
+    }
+    if (updateScreenshotBaseline && !screenshotBaselinePath) {
+        throw new Error("--update-screenshot-baseline requires --screenshot-baseline");
+    }
+    return {
+        url,
+        outputDirectory,
+        ...(journeysFile ? { journeysFile } : {}),
+        ...(journeyProfile ? { journeyProfile } : {}),
+        ...(viewports ? { viewports } : {}),
+        ...(colorSchemes ? { colorSchemes } : {}),
+        ...(settleMs === undefined ? {} : { settleMs }),
+        ...(chromiumPath ? { chromiumPath } : {}),
+        dynamicSelectors,
+        ...(screenshotBaselinePath ? { screenshotBaselinePath } : {}),
+        updateScreenshotBaseline,
+        json,
+        failOn,
+    };
+}
+function shouldFail(options, errors, warnings) {
+    if (options.failOn === "none")
+        return false;
+    if (options.failOn === "warning")
+        return errors + warnings > 0;
+    return errors > 0;
+}
+async function main() {
+    const options = parseArguments(process.argv.slice(2));
+    const selection = options.journeysFile
+        ? await loadRuntimeJourneySelection(options.journeysFile, options.journeyProfile)
+        : { journeys: [], expectedNetwork: [] };
+    const report = await verifyUiRuntime({
+        url: options.url,
+        outputDirectory: options.outputDirectory,
+        journeys: selection.journeys,
+        expectedNetwork: selection.expectedNetwork,
+        ...(options.viewports ? { viewports: options.viewports } : {}),
+        ...(options.colorSchemes ? { colorSchemes: options.colorSchemes } : {}),
+        ...(options.settleMs === undefined ? {} : { settleMs: options.settleMs }),
+        ...(options.chromiumPath ? { chromiumPath: options.chromiumPath } : {}),
+        dynamicSelectors: options.dynamicSelectors,
+        ...(options.screenshotBaselinePath
+            ? { screenshotBaselinePath: options.screenshotBaselinePath }
+            : {}),
+        updateScreenshotBaseline: options.updateScreenshotBaseline,
+    });
+    process.stdout.write(`${options.json ? JSON.stringify(report, null, 2) : formatRuntimeReport(report)}\n`);
+    if (shouldFail(options, report.summary.errors, report.summary.warnings)) {
+        process.exitCode = 1;
+    }
+}
+main().catch((error) => {
+    const message = error instanceof Error ? error.stack ?? error.message : String(error);
+    process.stderr.write(`Runtime verification failed: ${message}\n\n${usage()}\n`);
+    process.exitCode = 1;
+});
+//# sourceMappingURL=verify-ui.js.map

package/dist/cli/verify-ui.js.map

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

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

@@ -0,0 +1,13 @@
+import type { ContractValidationReport, JourneySuite, ProductContract } from "../contracts/schema.js";
+import type { RuntimeReport } from "../runtime/types.js";
+import type { AcceptanceAttestationFile, AcceptanceReport } from "./types.js";
+type EvaluationInput = {
+    contract: ProductContract;
+    suite: JourneySuite;
+    profile: string;
+    contractReport: ContractValidationReport;
+    runtimeReport: RuntimeReport;
+    attestations?: AcceptanceAttestationFile;
+};
+export declare function evaluateAcceptance(input: EvaluationInput): AcceptanceReport;
+export {};

package/dist/src/acceptance/evaluator.js

@@ -0,0 +1,201 @@
+const ACCEPTANCE_REPORT_VERSION = "1.0.0";
+function combineStatus(results) {
+    if (results.some((result) => result.status === "fail"))
+        return "fail";
+    if (results.some((result) => result.status === "unverified"))
+        return "unverified";
+    return "pass";
+}
+function findingsFor(report, checkIds) {
+    return report.findings.filter((finding) => finding.severity === "error" && checkIds.includes(finding.checkId));
+}
+function failedFindingEvidence(findings) {
+    return findings.map((finding) => `${finding.checkId}${finding.viewport ? ` ${finding.viewport}` : ""}${finding.journey ? ` ${finding.journey}` : ""}: ${finding.message}`);
+}
+function journeyEvidence(journeyNames, journeyResults) {
+    const results = journeyNames.map((name) => journeyResults.find((journey) => journey.name === name));
+    const missing = journeyNames.filter((_, index) => !results[index]);
+    if (missing.length > 0) {
+        return {
+            type: "runtime",
+            status: "unverified",
+            message: "Bound journeys did not produce runtime results.",
+            evidence: missing.map((name) => `Missing journey result: ${name}`),
+        };
+    }
+    const failed = results.filter((result) => result && !result.passed);
+    return {
+        type: "runtime",
+        status: failed.length > 0 ? "fail" : "pass",
+        message: failed.length > 0
+            ? "One or more bound product journeys failed."
+            : "All bound product journeys passed.",
+        evidence: results.map((result) => `${result.name}: ${result.stepsCompleted}/${result.totalSteps} steps completed`),
+    };
+}
+function evaluateEvidence(type, journeyNames, input, criterionId) {
+    if (type === "contract") {
+        return {
+            type,
+            status: input.contractReport.passed ? "pass" : "fail",
+            message: input.contractReport.passed
+                ? "Product contract and cross-references are valid."
+                : "Product contract validation failed.",
+            evidence: input.contractReport.issues.map((entry) => `${entry.code} ${entry.path}: ${entry.message}`),
+        };
+    }
+    if (type === "runtime") {
+        const journeys = journeyEvidence(journeyNames, input.runtimeReport.journeys);
+        const infrastructureFailures = findingsFor(input.runtimeReport, ["ZTDE-RUNTIME-001", "ZTDE-RUNTIME-008"]);
+        if (infrastructureFailures.length > 0) {
+            return {
+                type,
+                status: "fail",
+                message: "Runtime navigation or journey execution failed.",
+                evidence: failedFindingEvidence(infrastructureFailures),
+            };
+        }
+        return journeys;
+    }
+    const checkIds = type === "screenshot"
+        ? ["ZTDE-RUNTIME-004", "ZTDE-RUNTIME-007", "ZTDE-RUNTIME-010", "ZTDE-RUNTIME-015"]
+        : type === "network"
+            ? ["ZTDE-RUNTIME-003", "ZTDE-RUNTIME-009"]
+            : type === "accessibility"
+                ? [
+                    "ZTDE-RUNTIME-005",
+                    "ZTDE-RUNTIME-006",
+                    "ZTDE-RUNTIME-011",
+                    "ZTDE-RUNTIME-012",
+                    "ZTDE-RUNTIME-013",
+                    "ZTDE-RUNTIME-014",
+                    "ZTDE-RUNTIME-015",
+                    "ZTDE-RUNTIME-016",
+                ]
+                : [];
+    if (checkIds.length > 0) {
+        const failures = findingsFor(input.runtimeReport, checkIds);
+        if (type === "network") {
+            const responses = input.runtimeReport.journeys
+                .filter((journey) => journeyNames.includes(journey.name))
+                .flatMap((journey) => (journey.evidence ?? []).filter((entry) => entry.kind === "response"));
+            if (failures.length === 0 && responses.length === 0) {
+                return {
+                    type,
+                    status: "unverified",
+                    message: "No bound journey captured a verified network response.",
+                    evidence: [],
+                };
+            }
+            if (failures.length === 0) {
+                return {
+                    type,
+                    status: "pass",
+                    message: "Bound journeys captured network evidence without blocker failures.",
+                    evidence: responses.map((response) => response.description),
+                };
+            }
+        }
+        if (type === "screenshot") {
+            const expected = new Set(input.contract.verification.viewports.map((viewport) => viewport.name));
+            const captured = new Set(input.runtimeReport.screenshots.map((screenshot) => screenshot.name));
+            const missing = [...expected].filter((name) => !captured.has(name));
+            if (failures.length === 0 && missing.length > 0) {
+                return {
+                    type,
+                    status: "unverified",
+                    message: "Required viewport screenshots are missing.",
+                    evidence: missing.map((name) => `Missing screenshot: ${name}`),
+                };
+            }
+        }
+        const evidence = type === "screenshot"
+            ? input.runtimeReport.screenshots.map((screenshot) => `${screenshot.name}: ${screenshot.path}`)
+            : [];
+        return {
+            type,
+            status: failures.length > 0 ? "fail" : "pass",
+            message: failures.length > 0
+                ? `${type} verification reported blocker findings.`
+                : `${type} verification produced no blocker findings.`,
+            evidence: [...failedFindingEvidence(failures), ...evidence],
+        };
+    }
+    if (type === "export") {
+        const downloads = input.runtimeReport.journeys
+            .filter((journey) => journeyNames.includes(journey.name))
+            .flatMap((journey) => (journey.evidence ?? []).filter((entry) => entry.kind === "download"));
+        return {
+            type,
+            status: downloads.length > 0 ? "pass" : "unverified",
+            message: downloads.length > 0
+                ? "A bound journey captured download evidence."
+                : "No bound journey captured a verified download.",
+            evidence: downloads.map((download) => download.description),
+        };
+    }
+    const attestation = input.attestations?.attestations.find((entry) => entry.criterion === criterionId);
+    if (!attestation) {
+        return {
+            type: "manual-review",
+            status: "unverified",
+            message: "No manual-review attestation was supplied.",
+            evidence: [],
+        };
+    }
+    return {
+        type: "manual-review",
+        status: attestation.status,
+        message: `${attestation.reviewer} reviewed this criterion at ${attestation.reviewedAt}: ${attestation.notes}`,
+        evidence: attestation.evidence,
+    };
+}
+export function evaluateAcceptance(input) {
+    if (input.attestations && input.attestations.contract !== input.contract.id) {
+        throw new Error(`Attestation file targets ${input.attestations.contract}, expected ${input.contract.id}`);
+    }
+    const profile = input.suite.profiles.find((candidate) => candidate.id === input.profile);
+    if (!profile)
+        throw new Error(`Unknown acceptance profile: ${input.profile}`);
+    const journeyNamesById = new Map(profile.journeys.map((journey) => [journey.id, journey.name]));
+    const bindings = input.contract.verification.bindings.filter((binding) => binding.profile === input.profile);
+    const criterionIds = new Set(bindings.flatMap((binding) => binding.acceptanceCriteria));
+    const criteria = input.contract.acceptanceCriteria
+        .filter((criterion) => criterionIds.has(criterion.id))
+        .map((criterion) => {
+        const journeys = [
+            ...new Set(bindings
+                .filter((binding) => binding.acceptanceCriteria.includes(criterion.id))
+                .map((binding) => journeyNamesById.get(binding.journey))
+                .filter((name) => Boolean(name))),
+        ];
+        const evidence = criterion.evidence.map((type) => evaluateEvidence(type, journeys, input, criterion.id));
+        return {
+            id: criterion.id,
+            title: criterion.title,
+            severity: criterion.severity,
+            status: combineStatus(evidence),
+            journeys,
+            evidence,
+        };
+    });
+    const summary = {
+        passed: criteria.filter((criterion) => criterion.status === "pass").length,
+        failed: criteria.filter((criterion) => criterion.status === "fail").length,
+        unverified: criteria.filter((criterion) => criterion.status === "unverified").length,
+        blockerFailures: criteria.filter((criterion) => criterion.severity === "blocker" && criterion.status === "fail").length,
+        blockerUnverified: criteria.filter((criterion) => criterion.severity === "blocker" && criterion.status === "unverified").length,
+        warningFailures: criteria.filter((criterion) => criterion.severity === "warning" && criterion.status === "fail").length,
+        warningUnverified: criteria.filter((criterion) => criterion.severity === "warning" && criterion.status === "unverified").length,
+    };
+    return {
+        version: ACCEPTANCE_REPORT_VERSION,
+        generatedAt: new Date().toISOString(),
+        contractId: input.contract.id,
+        profile: input.profile,
+        criteria,
+        summary,
+        passed: summary.blockerFailures === 0 && summary.blockerUnverified === 0,
+    };
+}
+//# sourceMappingURL=evaluator.js.map

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

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

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

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

package/dist/src/acceptance/loader.js

@@ -0,0 +1,18 @@
+import { readFile, stat } from "node:fs/promises";
+import { resolve } from "node:path";
+import { parse } from "yaml";
+import { acceptanceAttestationFileSchema } from "./schema.js";
+const MAX_ATTESTATION_BYTES = 1024 * 1024;
+export async function loadAcceptanceAttestations(path) {
+    const resolvedPath = resolve(path);
+    const fileStats = await stat(resolvedPath);
+    if (!fileStats.isFile())
+        throw new Error("Attestation path is not a regular file");
+    if (fileStats.size > MAX_ATTESTATION_BYTES) {
+        throw new Error(`Attestation file exceeds ${MAX_ATTESTATION_BYTES} bytes`);
+    }
+    const text = await readFile(resolvedPath, "utf8");
+    const content = resolvedPath.endsWith(".json") ? JSON.parse(text) : parse(text);
+    return acceptanceAttestationFileSchema.parse(content);
+}
+//# sourceMappingURL=loader.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../../src/acceptance/loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,KAAK,EAAE,MAAM,MAAM,CAAC;AAE7B,OAAO,EAAE,+BAA+B,EAAE,MAAM,aAAa,CAAC;AAG9D,MAAM,qBAAqB,GAAG,IAAI,GAAG,IAAI,CAAC;AAE1C,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAAC,IAAY;IAC3D,MAAM,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,CAAC;IAC3C,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;IACnF,IAAI,SAAS,CAAC,IAAI,GAAG,qBAAqB,EAAE,CAAC;QAC3C,MAAM,IAAI,KAAK,CAAC,4BAA4B,qBAAqB,QAAQ,CAAC,CAAC;IAC7E,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,+BAA+B,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;AACxD,CAAC"}

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

@@ -0,0 +1,2 @@
+import type { AcceptanceReport } from "./types.js";
+export declare function formatAcceptanceReport(report: AcceptanceReport): string;

package/dist/src/acceptance/report.js

@@ -0,0 +1,18 @@
+export function formatAcceptanceReport(report) {
+    const lines = [
+        "# ZtotheZ Design Engineering Acceptance Evidence",
+        "",
+        `- Contract: \`${report.contractId}\``,
+        `- Profile: \`${report.profile}\``,
+        `- Result: ${report.passed ? "PASS" : "FAIL"}`,
+        `- Criteria: ${report.summary.passed} passed, ${report.summary.failed} failed, ${report.summary.unverified} unverified`,
+    ];
+    for (const criterion of report.criteria) {
+        lines.push("", `## ${criterion.status.toUpperCase()} ${criterion.id}`, "", `${criterion.title} (${criterion.severity}).`, `Journeys: ${criterion.journeys.join(", ") || "none"}.`);
+        for (const evidence of criterion.evidence) {
+            lines.push("", `- **${evidence.type}: ${evidence.status.toUpperCase()}** - ${evidence.message}`, ...evidence.evidence.map((entry) => `  - ${entry}`));
+        }
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=report.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"report.js","sourceRoot":"","sources":["../../../src/acceptance/report.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,sBAAsB,CAAC,MAAwB;IAC7D,MAAM,KAAK,GAAG;QACZ,kDAAkD;QAClD,EAAE;QACF,iBAAiB,MAAM,CAAC,UAAU,IAAI;QACtC,gBAAgB,MAAM,CAAC,OAAO,IAAI;QAClC,aAAa,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE;QAC9C,eAAe,MAAM,CAAC,OAAO,CAAC,MAAM,YAAY,MAAM,CAAC,OAAO,CAAC,MAAM,YAAY,MAAM,CAAC,OAAO,CAAC,UAAU,aAAa;KACxH,CAAC;IACF,KAAK,MAAM,SAAS,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACxC,KAAK,CAAC,IAAI,CACR,EAAE,EACF,MAAM,SAAS,CAAC,MAAM,CAAC,WAAW,EAAE,IAAI,SAAS,CAAC,EAAE,EAAE,EACtD,EAAE,EACF,GAAG,SAAS,CAAC,KAAK,KAAK,SAAS,CAAC,QAAQ,IAAI,EAC7C,aAAa,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,GAAG,CACxD,CAAC;QACF,KAAK,MAAM,QAAQ,IAAI,SAAS,CAAC,QAAQ,EAAE,CAAC;YAC1C,KAAK,CAAC,IAAI,CACR,EAAE,EACF,OAAO,QAAQ,CAAC,IAAI,KAAK,QAAQ,CAAC,MAAM,CAAC,WAAW,EAAE,QAAQ,QAAQ,CAAC,OAAO,EAAE,EAChF,GAAG,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,EAAE,CAAC,CACpD,CAAC;QACJ,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

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

@@ -0,0 +1,64 @@
+import { z } from "zod";
+export declare const acceptanceAttestationFileSchema: z.ZodObject<{
+    version: z.ZodLiteral<"1.0">;
+    contract: z.ZodString;
+    attestations: z.ZodArray<z.ZodObject<{
+        criterion: z.ZodString;
+        status: z.ZodEnum<{
+            pass: "pass";
+            fail: "fail";
+        }>;
+        reviewer: z.ZodString;
+        reviewedAt: z.ZodString;
+        notes: z.ZodString;
+        evidence: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export declare const acceptanceReportSchema: z.ZodObject<{
+    version: z.ZodString;
+    generatedAt: z.ZodString;
+    contractId: z.ZodString;
+    profile: z.ZodString;
+    criteria: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        severity: z.ZodEnum<{
+            warning: "warning";
+            blocker: "blocker";
+        }>;
+        status: z.ZodEnum<{
+            unverified: "unverified";
+            pass: "pass";
+            fail: "fail";
+        }>;
+        journeys: z.ZodArray<z.ZodString>;
+        evidence: z.ZodArray<z.ZodObject<{
+            type: z.ZodEnum<{
+                export: "export";
+                screenshot: "screenshot";
+                contract: "contract";
+                runtime: "runtime";
+                network: "network";
+                accessibility: "accessibility";
+                "manual-review": "manual-review";
+            }>;
+            status: z.ZodEnum<{
+                unverified: "unverified";
+                pass: "pass";
+                fail: "fail";
+            }>;
+            message: z.ZodString;
+            evidence: z.ZodArray<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    summary: z.ZodObject<{
+        passed: z.ZodNumber;
+        failed: z.ZodNumber;
+        unverified: z.ZodNumber;
+        blockerFailures: z.ZodNumber;
+        blockerUnverified: z.ZodNumber;
+        warningFailures: z.ZodNumber;
+        warningUnverified: z.ZodNumber;
+    }, z.core.$strip>;
+    passed: z.ZodBoolean;
+}, z.core.$strip>;