@jevitate/cli 0.8.0 → 0.10.0

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

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

package/dist/catalog-bundle-findings.d.ts

@@ -0,0 +1,54 @@
+import { type RunRecord } from "@jevitate/findings";
+import { type CatalogBundleFinding } from "./catalog-bundle.js";
+import type { RunIndexDeps } from "./run-index.js";
+/**
+ * #464 (d464c) — the machine findings a Journeeze catalog bundle carries (journeeze-saas
+ * `docs/contract/catalog-bundle-v1.md` §4.4 @ 61f8c92): UX claims, defects and hangs, one per
+ * fingerprint (the latest sighting wins). It only READS what the runners persisted (every result
+ * was redacted before it was written), from the same places `jevitate report` reads — this
+ * project's logs and its indexed runs — plus offline `ux-<stamp>.json` reviews and the committed
+ * finding ledger.
+ *
+ *  - Defects and hangs: `jevitate report`'s deduped list (`consolidate`), with jevitate's own
+ *    fingerprint. A declared invariant is a defect. Advisory flags, Journey assertions, goal checks
+ *    and approvals have no fingerprint and are not bundle finding kinds: they stay out. The tflowId
+ *    is the acting step's (`identity.tflowId`, #468).
+ *  - UX: each shown finding of a usability or `ux` report (never the heuristic appendix), with the
+ *    contract's derived fingerprint (`uxFindingFingerprint`) over the EXPORTED claim, route and
+ *    element — the reader recomputes it. A claim type the contract does not know (a rubric or signal
+ *    finding) goes as `other` + `producerClaim`. On-screen `quotes` are never exported.
+ *  - Routes are templates (`contractRouteTemplate`: no host, query, fragment or record id).
+ *  - Privacy: each finding passes the builder's own guard (`findingIssues`: no personal data, URL
+ *    or record id in any text). A finding that cannot is LEFT OUT with a warning naming only its
+ *    fingerprint and why — never rewritten into something it did not say, and never allowed to
+ *    refuse the whole export. A defect whose own title cannot travel is described by its signal and
+ *    route instead (producer-written text).
+ *  - No media in 0.10 (no `screenshot`/`box`).
+ */
+export interface UxReportSource {
+    /** The `UxReport` (a usability report file, a usability result's `result.report`, or an offline `ux` review). */
+    readonly report: unknown;
+    /** The run it came from: when, which build, which Journey step it branched from. */
+    readonly run: RunRecord;
+}
+export interface FindingSources {
+    readonly runs: readonly RunRecord[];
+    readonly uxReports: readonly UxReportSource[];
+}
+export interface BundleFindings {
+    readonly findings: readonly CatalogBundleFinding[];
+    /** Findings left out or degraded, each with why. */
+    readonly warnings: readonly string[];
+}
+/** The bundle's findings from what the runs persisted (pure): one per fingerprint, latest sighting first-class. */
+export declare function bundleFindings(src: FindingSources): BundleFindings;
+export interface CollectBundleFindingsOptions {
+    /** The project root (where its `.jevitate/` is). */
+    readonly root: string;
+    /** The project data dir (`--dir`, else `<root>/.jevitate`); null outside a project. */
+    readonly dataDir: string | null;
+    /** Test seam: the run index. */
+    readonly index?: RunIndexDeps;
+}
+/** Reads the project's runs, UX reports and ledger, and returns the bundle's findings. */
+export declare function collectBundleFindings(opts: CollectBundleFindingsOptions): Promise<BundleFindings>;

package/dist/catalog-bundle-findings.js

@@ -0,0 +1,252 @@
+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 { 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 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(`finding ${m.finding.fingerprint} (${m.finding.kind}): ${issues.map((i) => i.replace(/^finding [0-9a-f]+: /u, "").replace(/ "[^"]*"/gu, "")).join("; ")} — left out of the bundle`);
+            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 };
+}
+// ── 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,192 @@
+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: NONE in 0.10 — a demo must carry the jz-mask-v1 + synthetic-data attestation,
+ *    which jevitate cannot make yet, and the contract says a producer that cannot meet it exports no
+ *    media. So no `demos`, no `files`.
+ *  - `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. A 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 (contract 61f8c92). */
+export declare const BUNDLE_MINOR: 0;
+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;
+    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;
+}
+/**
+ * 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;
+    readonly citation?: {
+        readonly source: string;
+        readonly ref: string;
+    };
+}
+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[];
+    };
+    readonly checks: readonly BundleCheck[];
+    readonly findings: readonly CatalogBundleFinding[];
+}
+/** 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[];
+}
+export interface CatalogBundleBuild {
+    readonly bundle: CatalogBundleV1;
+    /** 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[]);
+}
+/** 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 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;