@jevitate/cli 0.9.0 → 0.11.0

package/dist/catalog-bundle-findings.js

@@ -0,0 +1,326 @@
+import { createHash } from "node:crypto";
+import { existsSync, readdirSync, readFileSync, statSync } from "node:fs";
+import { join, resolve } from "node:path";
+import { consolidate, runFromMissionResult, runFromUxReport } from "@jevitate/findings";
+import { contractRouteTemplate, uxFindingFingerprint } from "@jevitate/ux";
+import { findingIssues, isRouteTemplate } from "./catalog-bundle.js";
+import { dedupeSuggestions } from "./locator-health.js";
+import { journeyLocatorHealth } from "./locator-health-api.js";
+import { defaultReportSources, loadRunFile, scanRuns } from "./report-api.js";
+const KNOWN_CLAIMS = new Set(["next-step-unclear", "no-feedback", "blocked-action", "error-unrecoverable", "destructive-unguarded", "fact-conflict"]);
+const PRODUCER_CLAIM_RE = /^[a-z][a-z0-9-]{0,63}$/u;
+const FINGERPRINT_RE = /^[0-9a-f]{16}$/u;
+const TFLOW_ID_RE = /^[a-z0-9._:-]{1,96}$/u;
+const COMMIT_RE = /^[0-9a-f]{7,40}$/u;
+const TARGET_ID_RE = /^[A-Za-z0-9_.-]{1,64}$/u;
+const JOURNEY_ID_RE = /^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$/u;
+const DATE_TIME_RE = /^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}(\.[0-9]{1,9})?(Z|[+-][0-9]{2}:[0-9]{2})$/u;
+const CITATION_SOURCE_RE = /^[a-z0-9][a-z0-9._-]{0,63}$/u;
+const CITATION_REF_RE = /^[A-Za-z0-9][A-Za-z0-9._:-]{0,63}$/u;
+const SEVERITIES = new Set(["info", "minor", "major"]);
+const RESERVED_ANCHORS = new Set(["job_start", "job_end"]);
+const MAX_CONTROLS = 10;
+const MAX_FINDINGS = 5000;
+function isRecord(v) {
+    return v !== null && typeof v === "object" && !Array.isArray(v);
+}
+const str = (v) => (typeof v === "string" && v !== "" ? v : undefined);
+const strings = (v) => (Array.isArray(v) ? v.filter((x) => typeof x === "string" && x !== "") : []);
+/** Would this text pass the builder's guard as a finding's `observation` (≤600) / a control (≤120)? */
+function safeText(text, as) {
+    if (text === undefined)
+        return false;
+    const probe = as === "observation"
+        ? { fingerprint: "0000000000000000", kind: "defect", severity: "major", at: "2000-01-01T00:00:00Z", observation: text }
+        : { fingerprint: "0000000000000000", kind: "defect", severity: "major", at: "2000-01-01T00:00:00Z", observation: "probe", controls: [text] };
+    return findingIssues(probe).length === 0;
+}
+/** A route as the contract's template, or undefined when it cannot be one. */
+function bundleRoute(raw) {
+    if (raw === undefined)
+        return undefined;
+    const route = contractRouteTemplate(raw);
+    return isRouteTemplate(route) ? route : undefined;
+}
+/** Where it was seen: the Journey step a journey-anchored run branched from. */
+function seenAt(branch) {
+    if (branch === undefined || !JOURNEY_ID_RE.test(branch.journeyId))
+        return {};
+    const step = Number.isInteger(branch.step) && branch.step >= 1 && branch.step <= 200 ? branch.step : undefined;
+    const anchor = branch.anchor !== undefined && JOURNEY_ID_RE.test(branch.anchor) && !RESERVED_ANCHORS.has(branch.anchor) ? branch.anchor : undefined;
+    return { journey: branch.journeyId, ...(step === undefined ? {} : { step }), ...(anchor === undefined ? {} : { anchor }) };
+}
+function runStamp(run) {
+    return {
+        ...(run.targetBuild !== undefined && COMMIT_RE.test(run.targetBuild) ? { commit: run.targetBuild } : {}),
+        ...(run.targetName !== undefined && TARGET_ID_RE.test(run.targetName) ? { target: run.targetName } : {}),
+    };
+}
+/** One defect/hang of the consolidated report as a bundle finding. */
+function defectFinding(d, runs) {
+    if (d.category !== "defect" && d.category !== "invariant" && d.category !== "hang")
+        return null;
+    const fingerprint = d.identity.fingerprint;
+    if (fingerprint === undefined || !FINGERPRINT_RE.test(fingerprint))
+        return { drop: `${d.category} ${d.key}: its fingerprint is not 16 hex characters` };
+    if (d.lastSeen === undefined || !DATE_TIME_RE.test(d.lastSeen))
+        return { drop: `finding ${fingerprint}: no run names when it was seen` };
+    const latest = d.modes
+        .flatMap((m) => m.runs)
+        .sort((a, b) => (a.startedAt ?? "").localeCompare(b.startedAt ?? ""))
+        .at(-1);
+    const run = latest === undefined ? undefined : runs.get(latest.path);
+    const route = bundleRoute(d.identity.route);
+    const control = d.identity.control;
+    const tflowId = d.identity.tflowId;
+    const described = `${d.category === "hang" ? "Hang" : "Defect"} (${d.identity.signal}) on ${route ?? "an unknown route"}`;
+    return {
+        finding: {
+            fingerprint,
+            kind: d.category === "hang" ? "hang" : "defect",
+            severity: "major",
+            ...(run === undefined ? {} : runStamp(run)),
+            at: d.lastSeen,
+            ...seenAt(d.branches?.[0]),
+            ...(route === undefined ? {} : { route }),
+            ...(tflowId !== undefined && TFLOW_ID_RE.test(tflowId) ? { tflowId } : {}),
+            ...(safeText(control, "control") ? { controls: [control] } : {}),
+            observation: safeText(d.title, "observation") ? d.title : described,
+        },
+    };
+}
+/** One shown finding of a UX report as a bundle finding (the contract's derived fingerprint). */
+function uxFinding(f, run) {
+    const rubric = str(f.rubricItemId) ?? "unknown";
+    const route = bundleRoute(str(f.route));
+    if (route === undefined)
+        return { drop: `UX finding (${rubric}): its route is not a route template` };
+    const type = isRecord(f.claim) ? str(f.claim.type) : undefined;
+    const known = type !== undefined && KNOWN_CLAIMS.has(type);
+    const producerClaim = known ? undefined : (type ?? rubric);
+    if (producerClaim !== undefined && !PRODUCER_CLAIM_RE.test(producerClaim))
+        return { drop: `UX finding on ${route}: its claim type is not a producer claim name` };
+    const claim = (known ? type : "other");
+    const severity = str(f.severity);
+    const confidence = f.confidence;
+    if (severity === undefined || !SEVERITIES.has(severity))
+        return { drop: `UX finding (${claim}) on ${route}: no contract severity` };
+    if (typeof confidence !== "number" || !(confidence >= 0 && confidence <= 1))
+        return { drop: `UX finding (${claim}) on ${route}: no confidence in [0, 1]` };
+    if (run.startedAt === undefined || !DATE_TIME_RE.test(run.startedAt))
+        return { drop: `UX finding (${claim}) on ${route}: its run names no start time` };
+    const observation = str(f.observation);
+    if (observation === undefined)
+        return { drop: `UX finding (${claim}) on ${route}: no observation` };
+    const tflowRaw = str(f.tflowId);
+    const tflowId = tflowRaw !== undefined && TFLOW_ID_RE.test(tflowRaw) ? tflowRaw : undefined;
+    const controls = strings(f.controls).slice(0, MAX_CONTROLS);
+    const fingerprint = uxFindingFingerprint({ claim, ...(producerClaim === undefined ? {} : { producerClaim }), route, ...(tflowId === undefined ? {} : { tflowId }), controls });
+    const citation = isRecord(f.citation) ? { source: str(f.citation.source), ref: str(f.citation.ref) } : undefined;
+    const userImpact = str(f.userImpact);
+    const recommendation = str(f.recommendation);
+    return {
+        finding: {
+            fingerprint,
+            kind: "ux",
+            claim,
+            ...(producerClaim === undefined ? {} : { producerClaim }),
+            severity: severity,
+            confidence,
+            ...runStamp(run),
+            at: run.startedAt,
+            ...seenAt(run.branch),
+            route,
+            ...(tflowId === undefined ? {} : { tflowId }),
+            ...(controls.length === 0 ? {} : { controls }),
+            observation,
+            ...(userImpact === undefined ? {} : { userImpact }),
+            ...(recommendation === undefined ? {} : { recommendation }),
+            ...(citation?.source !== undefined && citation.ref !== undefined && CITATION_SOURCE_RE.test(citation.source) && CITATION_REF_RE.test(citation.ref)
+                ? { citation: { source: citation.source, ref: citation.ref } }
+                : {}),
+        },
+    };
+}
+/** The warning for a finding the builder's guard drops: the fingerprint and rule, never the offending text. */
+function findingDropWarning(fingerprint, kind, issues) {
+    return `finding ${fingerprint} (${kind}): ${issues.map((i) => i.replace(/^finding [0-9a-f]+: /u, "").replace(/ "[^"]*"/gu, "")).join("; ")} — left out of the bundle`;
+}
+/** The bundle's findings from what the runs persisted (pure): one per fingerprint, latest sighting first-class. */
+export function bundleFindings(src) {
+    const warnings = [];
+    const latest = new Map();
+    const keep = (m) => {
+        if (m === null)
+            return;
+        if ("drop" in m) {
+            warnings.push(`${m.drop} — left out of the bundle`);
+            return;
+        }
+        const issues = findingIssues(m.finding);
+        if (issues.length > 0) {
+            // Name the fingerprint and the rule only: the offending text never reaches a warning.
+            warnings.push(findingDropWarning(m.finding.fingerprint, m.finding.kind, issues));
+            return;
+        }
+        const prev = latest.get(m.finding.fingerprint);
+        if (prev === undefined || prev.at <= m.finding.at)
+            latest.set(m.finding.fingerprint, m.finding);
+    };
+    const byPath = new Map(src.runs.map((r) => [r.path, r]));
+    for (const d of consolidate(src.runs))
+        keep(defectFinding(d, byPath));
+    for (const { report, run } of src.uxReports) {
+        if (!isRecord(report) || !Array.isArray(report.findings))
+            continue;
+        for (const f of report.findings)
+            if (isRecord(f))
+                keep(uxFinding(f, run));
+    }
+    let findings = [...latest.values()].sort((a, b) => a.at.localeCompare(b.at) || a.fingerprint.localeCompare(b.fingerprint));
+    if (findings.length > MAX_FINDINGS) {
+        warnings.push(`${findings.length} findings: only the latest ${MAX_FINDINGS} are exported`);
+        findings = findings.slice(-MAX_FINDINGS);
+    }
+    return { findings, warnings };
+}
+/**
+ * #479 (minor 1) — the locator findings: one per brittle ELEMENT (§4.4, spec bundle-minor1 §1). Each
+ * promoted Journey's locator health (`journeyLocatorHealth`) becomes suggestions, de-duplicated by
+ * element across Journeys; each suggestion is a `kind: "ux"` / claim `other` / producerClaim
+ * `locator-brittle` finding, dated at the latest approval of the Journeys it occurs in. A suggestion
+ * whose route cannot be a template, that has no approval time, or that fails the builder's privacy
+ * guard is LEFT OUT with a warning. Pure: no clock, no I/O.
+ */
+export function locatorFindings(journeys, testIdAttributes) {
+    const warnings = [];
+    const suggestions = dedupeSuggestions(journeys.map((cj) => journeyLocatorHealth(cj.journey, testIdAttributes).suggestions));
+    const approvalAt = new Map();
+    for (const cj of journeys) {
+        const at = cj.approval?.at;
+        if (at !== undefined && DATE_TIME_RE.test(at))
+            approvalAt.set(cj.id, at);
+    }
+    const findings = [];
+    for (const s of suggestions) {
+        const route = bundleRoute(s.route);
+        if (route === undefined) {
+            // Journeeze requires a route template on every UX finding (catalog bundle v1 §4.4).
+            warnings.push(`locator ${s.key}: ${s.route === undefined ? "its page has no route" : "its route is not a route template"} — left out of the bundle`);
+            continue;
+        }
+        const first = s.occurrences[0];
+        if (first === undefined)
+            continue;
+        const at = s.occurrences
+            .map((o) => (o.journeyId === undefined ? undefined : approvalAt.get(o.journeyId)))
+            .filter((v) => v !== undefined)
+            .sort()
+            .at(-1);
+        if (at === undefined) {
+            warnings.push(`locator ${s.key}: no approval time to date it — left out of the bundle`);
+            continue;
+        }
+        const key = s.key.slice(s.key.indexOf("|") + 1);
+        const fingerprint = createHash("sha256").update(`ux\nlocator-brittle\n${route ?? ""}\n${key}`, "utf8").digest("hex").slice(0, 16);
+        const step = first.index + 1;
+        // The fix names the page by its raw path; the bundle only ever carries the route template.
+        const fix = s.route !== undefined && route !== undefined && s.route !== route ? s.fix.split(s.route).join(route) : s.fix;
+        const finding = {
+            fingerprint,
+            kind: "ux",
+            claim: "other",
+            producerClaim: "locator-brittle",
+            severity: "minor",
+            // Static classification of the recorded locator, not a model judgement: certain.
+            confidence: 1,
+            at,
+            ...(first.journeyId === undefined ? {} : { journey: first.journeyId }),
+            ...(step < 1 || step > 200 ? {} : { step }),
+            route,
+            observation: `${s.element} on ${route} is found by a brittle locator (${s.reasons.join(", ")})`,
+            recommendation: fix,
+            locator: { element: s.element, attribute: s.attribute, testId: s.testId, fix, steps: s.occurrences.length },
+        };
+        const issues = findingIssues(finding);
+        if (issues.length > 0) {
+            warnings.push(findingDropWarning(fingerprint, finding.kind, issues));
+            continue;
+        }
+        findings.push(finding);
+    }
+    return { findings, warnings };
+}
+// ── I/O: where the project's findings live ──────────────────────────────────────────────────
+const OFFLINE_UX_REPORT = /^ux-\d{4}-\d{2}-\d{2}T\d{2}-\d{2}-\d{2}-\d{3}Z\.json$/u;
+function readJsonOrNull(path) {
+    try {
+        return JSON.parse(readFileSync(path, "utf8"));
+    }
+    catch {
+        return null; // unreadable/partial: not a source (never a fabricated one)
+    }
+}
+/** The ledger's entries as runs: each is a redacted mission result holding one defect or hang. */
+function ledgerRuns(dataDir) {
+    if (dataDir === null)
+        return [];
+    const dir = join(dataDir, "regressions", "ledger");
+    if (!existsSync(dir))
+        return [];
+    const out = [];
+    for (const f of readdirSync(dir).sort()) {
+        if (!/^[0-9a-f]{16}\.json$/u.test(f))
+            continue;
+        const entry = readJsonOrNull(join(dir, f));
+        if (!isRecord(entry) || !isRecord(entry.ledger) || !isRecord(entry.result))
+            continue;
+        const meta = entry.ledger;
+        const source = isRecord(meta.source) ? meta.source : {};
+        const run = runFromMissionResult(join(dir, f), {
+            missionOutcome: str(source.missionOutcome) ?? "defects-found",
+            result: { ...(str(meta.addedAt) === undefined ? {} : { startedAt: str(meta.addedAt) }), ...entry.result },
+        });
+        if (run !== null)
+            out.push(run);
+    }
+    return out;
+}
+/** Reads the project's runs, UX reports and ledger, and returns the bundle's findings. */
+export async function collectBundleFindings(opts) {
+    const sources = defaultReportSources(false, { cwd: () => opts.root, ...opts.index });
+    const runs = scanRuns(sources.dirs);
+    const seen = new Set(runs.map((r) => resolve(r.path)));
+    for (const f of sources.files) {
+        if (seen.has(resolve(f)))
+            continue;
+        seen.add(resolve(f));
+        const run = loadRunFile(f);
+        if (run !== null)
+            runs.push(run);
+    }
+    const uxReports = [];
+    for (const run of runs) {
+        if (run.mode !== "usability")
+            continue;
+        const raw = readJsonOrNull(run.path);
+        const report = isRecord(raw) && Array.isArray(raw.findings) ? raw : isRecord(raw) && isRecord(raw.result) ? raw.result.report : undefined;
+        if (report !== undefined)
+            uxReports.push({ report, run });
+    }
+    for (const dir of sources.dirs) {
+        if (!existsSync(dir) || !statSync(dir).isDirectory())
+            continue;
+        for (const f of readdirSync(dir).sort()) {
+            if (!OFFLINE_UX_REPORT.test(f))
+                continue;
+            const path = join(dir, f);
+            const raw = readJsonOrNull(path);
+            const run = runFromUxReport(path, raw);
+            if (run !== null)
+                uxReports.push({ report: raw, run });
+        }
+    }
+    return bundleFindings({ runs: [...runs, ...ledgerRuns(opts.dataDir)], uxReports });
+}
+//# sourceMappingURL=catalog-bundle-findings.js.map

package/dist/catalog-bundle-findings.js.map

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

package/dist/catalog-bundle.d.ts

@@ -0,0 +1,296 @@
+import { JOURNEY_RUN_OUTCOMES, type MissionOutcome } from "@jevitate/domain";
+import { CatalogInputError, type Catalog } from "./catalog.js";
+/**
+ * #464 (d464a) — the PURE builder of a Journeeze catalog bundle, version 1.0 (journeeze-saas
+ * `docs/contract/catalog-bundle-v1.md` at 61f8c92, schema `catalog-bundle.v1.json`). No I/O, no
+ * clock: catalog-bundle-api.ts loads the catalog, the raw persona entries, the `check.json` records
+ * and the producer identity, and writes what this returns.
+ *
+ * What goes out, and how (each rule is the contract's):
+ *  - personas: `{id, description, role, otherFields, approval}` — every descriptive key, so §8's
+ *    persona hash (`{id, …description, role and otherFields}`) recomputes to jevitate's
+ *    `personaContentHash`. Session keys (`storageState`, `login`) never leave.
+ *  - jobs: the `jobs.json` entry as loaded (every jtbd and campaign field — the hash input), with its
+ *    approval reduced to the contract's `{contentHash, at, channel}` (approval is outside the hash).
+ *  - journeys: PROMOTED Journeys only, the file as jevitate reads it (the review-hash input), with
+ *    approval provenance reduced to `{channel, agentSignals}` (no OS user, no reason, no PR reviewer —
+ *    bookkeeping outside the hash), and `link {job, persona, anchors, serves}` from its metadata.
+ *  - checks: one per check item that ran, keyed (target.id, commit, runId); a baseline only from a
+ *    clean run whose `journeyHash` is the exported Journey's approved hash.
+ *  - findings: whatever the d464c source hands in (`CatalogBundleFinding`), guarded; none by default.
+ *  - demos and media (#471): one `demos[]` entry per exported, APPROVED Journey that has an
+ *    approved-demo record (approved-demo.ts: written by `demo approve` only on a `synthetic: true`
+ *    environment, from a jz-mask-v1 render), whose `renderedFrom` is the Journey's current approved
+ *    hash. Its `privacy` is the record's attestation. Media is only what the record proved masked
+ *    and the API re-verified (present, same sha256, the right file type): `media/<id>/step-NN.png`,
+ *    `media/<id>/demo.webm` and `demo.vtt` (subtitles only with the video), each listed in `files[]`.
+ *    Over a §10 limit (2 MiB / 50 MiB / 256 KiB per file, 512 MiB and 4,000 files per bundle), a
+ *    file is left out with a warning, never sent. A demo whose caption breaks §7's text rules is
+ *    left out whole (its subtitles carry the same text). A draft demo has no record: never exported.
+ *  - `generatedAt` is left out on purpose: the same catalog gives the same bytes, so the upload's
+ *    `Idempotency-Key` (sha256 of bundle.json) dedupes a re-publish.
+ *
+ * Failure policy: personal data or a credential typed in clear anywhere, or a job the bundle cannot
+ * carry (a structural reference problem, text that is not one line), REFUSES the export
+ * (`CatalogBundleInputError`, exit 64) — nothing is guessed or silently rewritten. So does a
+ * PROMOTED Journey the bundle cannot carry (#478: never a silent omission). A draft Journey, or a
+ * check the bundle cannot carry, is LEFT OUT with a warning (nothing else references it in a way the
+ * reader would refuse). A persona key the bundle cannot carry drops that key and the persona's
+ * approval (its hash could not recompute) with a warning.
+ */
+export declare const BUNDLE_KIND: "journeeze.catalog-bundle";
+export declare const BUNDLE_VERSION: 1;
+/** The schema minor this producer is built against (minor 1, journeeze-saas #173: optional `finding.locator` and `check.appVersion`). */
+export declare const BUNDLE_MINOR: 1;
+export interface BundleApproval {
+    readonly contentHash: string;
+    readonly at: string;
+    readonly channel?: string;
+}
+export interface BundlePersona {
+    readonly id: string;
+    readonly description?: string;
+    readonly role?: string;
+    readonly otherFields?: Readonly<Record<string, string | number | boolean>>;
+    readonly approval?: BundleApproval;
+}
+/** A `jobs.json` entry as loaded, with its approval in the contract's shape. */
+export type BundleJob = Readonly<Record<string, unknown>> & {
+    readonly id: string;
+    readonly approval?: BundleApproval;
+};
+export interface BundleAnchor {
+    readonly name: string;
+    /** 1-based step of the Journey's flat step list. */
+    readonly step: number;
+    readonly jobStep?: string;
+    readonly boundary?: "start" | "end";
+}
+export interface BundleLink {
+    readonly job: string;
+    readonly persona?: string;
+    readonly anchors?: readonly BundleAnchor[];
+    readonly serves?: readonly string[];
+}
+export interface BundleJourneyEntry {
+    /** The Journey file (opaque to the reader beyond a few metadata fields). */
+    readonly journey: Readonly<Record<string, unknown>>;
+    readonly link?: BundleLink;
+}
+export declare const CHECK_TARGET_KINDS: readonly ["journey", "goal", "mission", "invariant", "verify_fix", "regression"];
+export type BundleCheckTargetKind = (typeof CHECK_TARGET_KINDS)[number];
+export interface BundleBaselinePoint {
+    /** An anchor name, or the reserved `job_start` / `job_end`. */
+    readonly anchor: string;
+    readonly step: number;
+    /** Milliseconds from the first step's start to this step's completion. */
+    readonly atMs: number;
+}
+export interface BundleBaseline {
+    readonly steps: number;
+    readonly totalMs: number;
+    readonly anchors: readonly BundleBaselinePoint[];
+}
+export interface BundleCheck {
+    readonly target: {
+        readonly id: string;
+        readonly kind?: BundleCheckTargetKind;
+    };
+    readonly commit: string;
+    /** #479 (spec minor 1 §2): the app's release/version label the check ran against; `commit` stays the build identity. */
+    readonly appVersion?: string;
+    readonly at: string;
+    readonly runId?: string;
+    readonly journey?: string;
+    readonly journeyHash?: string;
+    readonly outcome: MissionOutcome;
+    readonly exitCode: number;
+    readonly journeyOutcome?: (typeof JOURNEY_RUN_OUTCOMES)[number];
+    readonly failureKind?: string;
+    readonly durationMs?: number;
+    readonly baseline?: BundleBaseline;
+}
+export interface BundleLocator {
+    /** The element in words, e.g. `the "Save" button`. One printable line, 1-200, no URL or personal data. */
+    readonly element: string;
+    /** The attribute the fix adds (the convention's first). */
+    readonly attribute: string;
+    /** The suggested test id. */
+    readonly testId: string;
+    /** The fix, e.g. `add data-testid="save-contact" to the "Save" button on /contacts/new`. One line, 1-300. */
+    readonly fix: string;
+    /** The steps (across Journeys) that use the element. */
+    readonly steps: number;
+}
+/**
+ * d464c HOOK: one machine finding as the contract's `findings[]` carries it (§4.4) — UX claims with
+ * the derived fingerprint, defects and hangs with jevitate's. 0.10 exports no media, so no
+ * `screenshot`/`box`. The d464c deliverable produces these (fingerprint + PII scan) and passes them in
+ * through `CatalogBundleInput.findings`; until then the bundle carries `findings: []`.
+ */
+export interface CatalogBundleFinding {
+    readonly fingerprint: string;
+    readonly kind: "ux" | "defect" | "hang";
+    readonly claim?: "next-step-unclear" | "no-feedback" | "blocked-action" | "error-unrecoverable" | "destructive-unguarded" | "fact-conflict" | "other";
+    readonly producerClaim?: string;
+    readonly severity: "info" | "minor" | "major";
+    readonly confidence?: number;
+    readonly commit?: string;
+    readonly at: string;
+    readonly target?: string;
+    readonly journey?: string;
+    readonly step?: number;
+    readonly anchor?: string;
+    /** A route TEMPLATE: no query, fragment, host or record id. */
+    readonly route?: string;
+    readonly tflowId?: string;
+    readonly controls?: readonly string[];
+    readonly observation: string;
+    readonly userImpact?: string;
+    readonly recommendation?: string;
+    /** Minor 1 (§1): the brittle-element fix; only on kind `ux` + claim `other` + producerClaim `locator-brittle`, required there. */
+    readonly locator?: BundleLocator;
+    readonly citation?: {
+        readonly source: string;
+        readonly ref: string;
+    };
+}
+/** #471: one guide step of a demo (contract §4.2). */
+export interface BundleDemoStep {
+    readonly number: number;
+    readonly caption: string;
+    readonly expected?: string;
+    /** `media/<journey>/step-NN.png`. */
+    readonly screenshot?: string;
+}
+/** #471: the jz-mask-v1 + synthetic-data attestation every demo carries (contract §7). */
+export interface BundlePrivacy {
+    readonly mask: "jz-mask-v1";
+    readonly data: "synthetic";
+    readonly method: "dom-before-capture" | "pixels-after-capture";
+    readonly regions: number;
+}
+/** #471: one approved demo's media manifest (contract §4.2). */
+export interface BundleDemo {
+    readonly journey: string;
+    readonly renderedFrom: string;
+    readonly status: "approved";
+    readonly title?: string;
+    readonly steps: readonly BundleDemoStep[];
+    readonly video?: string;
+    readonly subtitles?: string;
+    readonly privacy: BundlePrivacy;
+}
+export type BundleFileType = "image/png" | "image/webp" | "video/webm" | "text/vtt";
+/** #471: one media file of the bundle (contract §2): listed ⇔ present ⇔ referenced. */
+export interface BundleFile {
+    readonly path: string;
+    readonly sha256: string;
+    readonly bytes: number;
+    readonly type: BundleFileType;
+}
+export interface CatalogBundleV1 {
+    readonly kind: typeof BUNDLE_KIND;
+    readonly version: typeof BUNDLE_VERSION;
+    readonly minor: typeof BUNDLE_MINOR;
+    readonly producer: {
+        readonly tool: "jevitate";
+        readonly version: string;
+        readonly commit?: string;
+    };
+    readonly product: {
+        readonly name: string;
+    };
+    readonly catalog: {
+        readonly personas: readonly BundlePersona[];
+        readonly jobs: readonly BundleJob[];
+        readonly journeys: readonly BundleJourneyEntry[];
+    };
+    /** #471: present (with `files`) only when at least one approved demo is exported. */
+    readonly demos?: readonly BundleDemo[];
+    readonly checks: readonly BundleCheck[];
+    readonly findings: readonly CatalogBundleFinding[];
+    readonly files?: readonly BundleFile[];
+}
+/**
+ * #471: an approved demo as the API hands it in: the record's manifest, and the media files the API
+ * re-verified on disk (present, sha256 and size as recorded, the right file type), by record name.
+ */
+export interface CatalogBundleDemoInput {
+    readonly journey: string;
+    readonly renderedFrom: string;
+    readonly title?: string;
+    readonly steps: ReadonlyArray<{
+        readonly number: number;
+        readonly caption: string;
+        readonly expected?: string;
+        readonly screenshot?: string;
+    }>;
+    readonly video?: string;
+    readonly subtitles?: string;
+    readonly privacy: BundlePrivacy;
+    /** Verified media by record file name (`step-01.png`, `demo.webm`, `demo.vtt`): `source` is the file on disk. */
+    readonly media: Readonly<Record<string, {
+        readonly source: string;
+        readonly sha256: string;
+        readonly bytes: number;
+    }>>;
+}
+/** #471: a media file to place in the bundle: `source` on disk → `path` under the bundle root. */
+export interface BundleMediaCopy {
+    readonly path: string;
+    readonly source: string;
+}
+/** One `jevitate check` record (`check.json`'s `data`, or the bare result) and where it came from. */
+export interface CheckRecordInput {
+    readonly source: string;
+    readonly record: unknown;
+}
+export interface CatalogBundleInput {
+    /** `producer.version` (semver) and `producer.commit` (the product repo's HEAD, when known). */
+    readonly producer: {
+        readonly version: string;
+        readonly commit?: string;
+    };
+    readonly productName: string;
+    readonly catalog: Catalog;
+    /** Each persona's raw `personas.json` keys (all but its `name`/`id`) — the persona hash input. */
+    readonly personaFields: ReadonlyMap<string, Readonly<Record<string, unknown>>>;
+    readonly checks: readonly CheckRecordInput[];
+    /** d464c: the machine findings to export (default none). */
+    readonly findings?: readonly CatalogBundleFinding[];
+    /** #471: approved demos with their verified media (default none). */
+    readonly demos?: readonly CatalogBundleDemoInput[];
+}
+export interface CatalogBundleBuild {
+    readonly bundle: CatalogBundleV1;
+    /** #471: the media files to place beside bundle.json (exactly `bundle.files`, with their sources). */
+    readonly media: readonly BundleMediaCopy[];
+    /** Items left out or degraded, each with why. */
+    readonly warnings: readonly string[];
+}
+/** The catalog cannot be exported as it is (personal data, a credential typed in clear, a job the bundle cannot carry) — exit 64. */
+export declare class CatalogBundleInputError extends CatalogInputError {
+    readonly issues: readonly string[];
+    readonly code: string;
+    constructor(issues: readonly string[]);
+}
+/** #471: contract §10's media limits. */
+export declare const MEDIA_LIMITS: {
+    readonly screenshotBytes: number;
+    readonly videoBytes: number;
+    readonly subtitlesBytes: number;
+    readonly totalBytes: number;
+    readonly files: 4000;
+    readonly demoSteps: 200;
+};
+/** Looks like personal data (an email, or 9+ digits) — the contract's `noPersonalData`. */
+export declare function looksPersonal(s: string): boolean;
+/** The contract's `routeTemplate`: a path template — no query string, fragment, host or record id. */
+export declare function isRouteTemplate(route: string): boolean;
+/** Why a subtitles file's text breaks §7 (a cue line that is not machine text, a DRAFT note), or null. */
+export declare function subtitlesTextProblem(vtt: string): string | null;
+/** Why a finding handed in by the d464c source breaks the contract's privacy rules (§7), or []. */
+export declare function findingIssues(f: CatalogBundleFinding): string[];
+/** Builds the bundle (pure). Throws `CatalogBundleInputError` when the catalog cannot be exported. */
+export declare function buildCatalogBundle(input: CatalogBundleInput): CatalogBundleBuild;