@jevitate/cli 0.9.0 → 0.11.0

package/dist/catalog-bundle-api.js

@@ -0,0 +1,309 @@
+import { createHash, randomBytes } from "node:crypto";
+import { existsSync } from "node:fs";
+import { copyFile, lstat, mkdir, open, readdir, readFile, rename, rm, writeFile } from "node:fs/promises";
+import { basename, dirname, join, resolve, sep } from "node:path";
+import { CatalogInputError, CatalogLoader, PERSONAS_FILE } from "./catalog.js";
+import { buildCatalogBundle, BUNDLE_KIND, looksPersonal, subtitlesTextProblem } from "./catalog-bundle.js";
+import { currentDigest, readApprovedDemo } from "./approved-demo.js";
+import { collectBundleFindings, locatorFindings } from "./catalog-bundle-findings.js";
+import { execGitReadOnly } from "./change-context.js";
+import { testIdAttributesOrDefault } from "./locator-health-api.js";
+import { readCliVersion } from "./version.js";
+/**
+ * #464 — `jevitate catalog export --format journeeze-bundle --out <dir>` / MCP
+ * `export_catalog_bundle`: write the project's catalog (personas, jobs, promoted Journeys with their
+ * approvals and links, check results with machine baselines) as a Journeeze catalog bundle v1.0
+ * (journeeze-saas `docs/contract/catalog-bundle-v1.md` @ 61f8c92). The bundle itself is built by the
+ * pure `buildCatalogBundle` (catalog-bundle.ts — what goes out and what never does is documented
+ * there); this module does the I/O around it.
+ *
+ * It writes `bundle.json` under `outDir` (atomically: a temp file renamed into place; over MCP
+ * `outDir` is a confined path inside the project) and, #471, the approved demos' media under
+ * `outDir/media/<journey id>/` (contract §2), refuses an `outDir` holding anything but a previous
+ * bundle, never uploads (that is `publish journeeze`) and never approves anything.
+ *
+ * #471 media: a Journey's approved-demo record (approved-demo.ts, `<journeys>/.demos/<id>/`) is
+ * read only for a promoted Journey; every file it lists is re-verified here — present, the sha256
+ * and size recorded when it was proven masked, and the right kind of file (PNG / WebM signature,
+ * WebVTT whose every cue is §7 machine text) — or it is left out with a warning. The pure builder
+ * then applies the contract's text rules and limits.
+ *
+ * Inputs it reads: `<catalogDir>/personas.json` + `jobs.json`, the Journeys dir, and the
+ * `jevitate check` records — `req.checkFiles`, else `<project>/jevitate-check/check.json` (the
+ * `check --out` default) when it exists. The product repo's HEAD (`git rev-parse HEAD`) is
+ * `producer.commit`; a check's commit is its `--target-build`.
+ */
+export const CATALOG_EXPORT_FORMATS = ["journeeze-bundle"];
+/** `--out` would overwrite something that is not a bundle (or is not a directory) — exit 64. */
+export class CatalogExportOutError extends CatalogInputError {
+    code = "E_CATALOG_EXPORT_ARGS";
+}
+/** The contract's `bundle.json` cap (§10). */
+export const MAX_BUNDLE_BYTES = 16 * 1024 * 1024;
+export const BUNDLE_FILE = "bundle.json";
+/** #471: the bundle's media folder (contract §2). */
+export const MEDIA_DIR = "media";
+export const DEFAULT_CHECK_FILE = join("jevitate-check", "check.json");
+function isRecord(v) {
+    return v !== null && typeof v === "object" && !Array.isArray(v);
+}
+async function readJson(path, what) {
+    const raw = await readFile(path, "utf8");
+    try {
+        return JSON.parse(raw);
+    }
+    catch (err) {
+        throw new CatalogInputError(`${what} ${path} is not valid JSON: ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+/** Each persona's raw keys (all but `name`/`id`), in both personas.json forms — the persona hash input. */
+async function rawPersonaFields(catalogDir) {
+    const out = new Map();
+    if (catalogDir === null)
+        return out;
+    const path = join(catalogDir, PERSONAS_FILE);
+    if (!existsSync(path))
+        return out;
+    const raw = await readJson(path, "personas file");
+    const list = Array.isArray(raw) ? raw : isRecord(raw) && Array.isArray(raw.personas) ? raw.personas : null;
+    if (list !== null) {
+        for (const e of list) {
+            if (!isRecord(e))
+                continue;
+            const { name, id, ...fields } = e;
+            const key = name ?? id;
+            if (typeof key === "string")
+                out.set(key, fields);
+        }
+    }
+    else if (isRecord(raw)) {
+        for (const [id, v] of Object.entries(raw))
+            out.set(id, typeof v === "string" ? { storageState: v } : isRecord(v) ? { ...v } : {});
+    }
+    return out;
+}
+async function gitOut(git, cwd, args) {
+    try {
+        return (await git(args, { cwd, env: process.env })).stdout.trim();
+    }
+    catch {
+        return null;
+    }
+}
+/** `product.name`: the request's, else the project's package.json name, else its folder name — whichever is one plain line. */
+export function isPlainProductName(s) {
+    return typeof s === "string" && s.trim() !== "" && s.length <= 200 && !/[\u0000-\u001f\u007f]/u.test(s) && !looksPersonal(s);
+}
+async function productNameOf(req, root) {
+    const ok = isPlainProductName;
+    if (req.productName !== undefined) {
+        if (!ok(req.productName))
+            throw new CatalogExportOutError("productName must be one plain line of 1-200 characters (no control characters or personal data)");
+        return req.productName;
+    }
+    const pkg = join(root, "package.json");
+    if (existsSync(pkg)) {
+        try {
+            const name = JSON.parse(await readFile(pkg, "utf8")).name;
+            if (ok(name))
+                return name;
+        }
+        catch {
+            // not a readable package.json: fall back to the folder name
+        }
+    }
+    const folder = basename(root);
+    return ok(folder) ? folder : "jevitate-project";
+}
+/** Refuses an `outDir` that is not a directory, or that holds anything but a previous `bundle.json`. */
+async function assertBundleDir(outDir) {
+    let st;
+    try {
+        st = await lstat(outDir);
+    }
+    catch {
+        return; // missing: created
+    }
+    if (!st.isDirectory())
+        throw new CatalogExportOutError(`--out ${outDir} exists and is not a directory`);
+    const entries = await readdir(outDir);
+    // A previous bundle's media folder is replaced with the bundle (never without its bundle.json).
+    const other = entries.filter((e) => e !== BUNDLE_FILE && !(e === MEDIA_DIR && entries.includes(BUNDLE_FILE)));
+    if (other.length > 0) {
+        throw new CatalogExportOutError(`--out ${outDir} holds other content (${other.slice(0, 5).join(", ")}${other.length > 5 ? ", …" : ""}) — export into an empty directory or a previous bundle's`);
+    }
+    if (entries.includes(BUNDLE_FILE)) {
+        const file = join(outDir, BUNDLE_FILE);
+        const fst = await lstat(file);
+        let kind;
+        try {
+            kind = fst.isFile() ? JSON.parse(await readFile(file, "utf8")).kind : undefined;
+        }
+        catch {
+            kind = undefined;
+        }
+        if (kind !== BUNDLE_KIND)
+            throw new CatalogExportOutError(`--out ${outDir}: ${BUNDLE_FILE} there is not a Journeeze catalog bundle — not overwritten`);
+    }
+    if (entries.includes(MEDIA_DIR) && !(await lstat(join(outDir, MEDIA_DIR))).isDirectory())
+        throw new CatalogExportOutError(`--out ${outDir}: ${MEDIA_DIR} there is not a directory — not overwritten`);
+}
+const PNG_MAGIC = Buffer.from([0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a]);
+const WEBM_MAGIC = Buffer.from([0x1a, 0x45, 0xdf, 0xa3]);
+async function head(path, n) {
+    const fh = await open(path, "r");
+    try {
+        const buf = Buffer.alloc(n);
+        const { bytesRead } = await fh.read(buf, 0, n, 0);
+        return buf.subarray(0, bytesRead);
+    }
+    finally {
+        await fh.close();
+    }
+}
+/**
+ * #471: the approved demos of the catalog's promoted Journeys, with each media file re-verified on
+ * disk (else left out with a warning). A Journey without a record has no exportable demo (a draft,
+ * or one approved on an environment that does not declare synthetic data): nothing is said.
+ */
+async function approvedDemos(journeysDir, ids, warnings) {
+    const out = [];
+    for (const id of ids) {
+        let found;
+        try {
+            found = await readApprovedDemo(journeysDir, id);
+        }
+        catch (err) {
+            warnings.push(`demo ${id}: its approved-demo record is unreadable (${err instanceof Error ? err.message : String(err)}) — the demo is left out`);
+            continue;
+        }
+        if (found === null)
+            continue;
+        const { record, dir } = found;
+        const media = {};
+        for (const [name, want] of Object.entries(record.files)) {
+            const source = join(dir, name);
+            const got = await currentDigest(source);
+            if (got === null) {
+                warnings.push(`demo ${id}: ${name} is missing — left out`);
+                continue;
+            }
+            if (got.sha256 !== want.sha256 || got.bytes !== want.bytes) {
+                warnings.push(`demo ${id}: ${name} changed since it was proven masked — left out`);
+                continue;
+            }
+            let kindProblem = null;
+            if (name.endsWith(".png"))
+                kindProblem = (await head(source, 8)).equals(PNG_MAGIC) ? null : "is not a PNG";
+            else if (name.endsWith(".webm"))
+                kindProblem = (await head(source, 4)).equals(WEBM_MAGIC) ? null : "is not a WebM";
+            else if (name.endsWith(".vtt")) {
+                const p = subtitlesTextProblem(await readFile(source, "utf8"));
+                kindProblem = p === null ? null : `breaks the text rules (${p})`;
+            }
+            else
+                kindProblem = "is not a demo media file";
+            if (kindProblem !== null) {
+                warnings.push(`demo ${id}: ${name} ${kindProblem} — left out`);
+                continue;
+            }
+            media[name] = { source, ...got };
+        }
+        out.push({
+            journey: record.journey,
+            renderedFrom: record.renderedFrom,
+            ...(record.title === undefined ? {} : { title: record.title }),
+            steps: record.steps,
+            ...(record.video === undefined ? {} : { video: record.video }),
+            ...(record.subtitles === undefined ? {} : { subtitles: record.subtitles }),
+            privacy: record.privacy,
+            media,
+        });
+    }
+    return out;
+}
+export async function exportCatalogBundle(req, deps = {}) {
+    const git = deps.git ?? execGitReadOnly;
+    const outDir = resolve(req.outDir);
+    await assertBundleDir(outDir);
+    const root = req.catalogDir === null ? process.cwd() : dirname(resolve(req.catalogDir));
+    const catalog = await new CatalogLoader({ catalogDir: req.catalogDir, journeysDir: req.journeysDir }).load();
+    const personaFields = await rawPersonaFields(req.catalogDir);
+    const checkFiles = req.checkFiles ?? [join(root, DEFAULT_CHECK_FILE)].filter((p) => existsSync(p));
+    const checks = [];
+    for (const f of checkFiles)
+        checks.push({ source: f, record: await readJson(f, "check record") });
+    const warnings = [];
+    const head = await gitOut(git, root, ["rev-parse", "--verify", "--quiet", "HEAD"]);
+    if (head === null || head === "")
+        warnings.push(`${root} is not a git checkout with a commit — the bundle names no producer commit`);
+    else {
+        for (const dir of [req.catalogDir, req.journeysDir]) {
+            if (dir === null || !existsSync(dir))
+                continue;
+            const dirty = await gitOut(git, root, ["status", "--porcelain", "--", resolve(dir)]);
+            if (dirty !== null && dirty !== "")
+                warnings.push(`${dir} has uncommitted changes — the bundle is the working tree, but its producer commit is HEAD (${head.slice(0, 12)})`);
+        }
+    }
+    const found = deps.findings === undefined ? await collectBundleFindings({ root, dataDir: req.catalogDir }) : { findings: await deps.findings(), warnings: [] };
+    const demoWarnings = [];
+    const demos = await approvedDemos(req.journeysDir, catalog.journeys.filter((j) => j.promoted).map((j) => j.id), demoWarnings);
+    const locators = locatorFindings(catalog.journeys.filter((j) => j.promoted), testIdAttributesOrDefault(req.catalogDir));
+    const collected = new Set(found.findings.map((f) => f.fingerprint));
+    const { bundle, media, warnings: buildWarnings } = buildCatalogBundle({
+        producer: { version: (deps.version ?? readCliVersion)(), ...(head === null || head === "" ? {} : { commit: head }) },
+        productName: await productNameOf(req, root),
+        catalog,
+        personaFields,
+        checks,
+        findings: [...found.findings, ...locators.findings.filter((f) => !collected.has(f.fingerprint))],
+        demos,
+    });
+    const text = `${JSON.stringify(bundle, null, 2)}\n`;
+    const bytes = Buffer.byteLength(text, "utf8");
+    if (bytes > MAX_BUNDLE_BYTES)
+        throw new CatalogInputError(`the bundle is ${bytes} bytes; the contract's limit is ${MAX_BUNDLE_BYTES} (16 MiB)`);
+    await mkdir(outDir, { recursive: true });
+    // #471: the media first (a fresh folder), then bundle.json — a bundle never names a file it lacks.
+    const mediaDir = join(outDir, MEDIA_DIR);
+    await rm(mediaDir, { recursive: true, force: true });
+    for (const m of media) {
+        const to = join(outDir, ...m.path.split("/"));
+        if (!resolve(to).startsWith(`${mediaDir}${sep}`))
+            throw new CatalogInputError(`media path ${m.path} leaves the bundle's media folder`);
+        await mkdir(dirname(to), { recursive: true });
+        await copyFile(m.source, to);
+    }
+    const bundlePath = join(outDir, BUNDLE_FILE);
+    const tmp = join(outDir, `.${BUNDLE_FILE}.${randomBytes(6).toString("hex")}.tmp`);
+    try {
+        await writeFile(tmp, text, { encoding: "utf8", flag: "wx" });
+        await rename(tmp, bundlePath);
+    }
+    catch (err) {
+        await rm(tmp, { force: true });
+        throw err;
+    }
+    return {
+        format: req.format,
+        bundlePath,
+        digest: `sha256-${createHash("sha256").update(text, "utf8").digest("hex")}`,
+        counts: {
+            personas: bundle.catalog.personas.length,
+            jobs: bundle.catalog.jobs.length,
+            journeys: bundle.catalog.journeys.length,
+            checks: bundle.checks.length,
+            findings: bundle.findings.length,
+            demos: bundle.demos?.length ?? 0,
+            media: bundle.files?.length ?? 0,
+        },
+        warnings: [...warnings, ...found.warnings, ...locators.warnings, ...demoWarnings, ...buildWarnings],
+    };
+}
+/** The human rendering (no `--json`). */
+export function renderCatalogExport(r) {
+    const c = r.counts;
+    return `wrote ${r.bundlePath} (${r.digest}): ${c.personas} persona(s), ${c.jobs} job(s), ${c.journeys} Journey(s), ${c.demos} demo(s) with ${c.media} media file(s), ${c.checks} check(s), ${c.findings} finding(s)\n${r.warnings.map((w) => `warning: ${w}\n`).join("")}`;
+}
+//# sourceMappingURL=catalog-bundle-api.js.map

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,64 @@
+import { type RunRecord } from "@jevitate/findings";
+import { type CatalogBundleFinding } from "./catalog-bundle.js";
+import type { CatalogJourney } from "./catalog.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;
+/**
+ * #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 declare function locatorFindings(journeys: readonly CatalogJourney[], testIdAttributes: readonly string[]): 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>;