@jevitate/cli 0.16.1 → 0.18.0

package/dist/journey-bundle.d.ts

@@ -0,0 +1,83 @@
+import type { Journey, JourneyReview } from "@jevitate/journey";
+import { loadCatalog } from "./catalog-api.js";
+import type { Catalog } from "./catalog.js";
+import { reviewJourneyById } from "./journey-review-api.js";
+import { runJourneyReadiness, type ReadinessReceipt, type ReadinessVerdict } from "./journey-readiness.js";
+/**
+ * #584 — `jevitate journey bundle <id> [--with <toId>] --out <dir>` and
+ * `jevitate journey bundle --check <dir>` (docs/contracts/readiness-and-bundle.md §4). The bundle is
+ * local and never uploaded: it writes `<dir>/bundle.md` and `<dir>/manifest.json` from a `report`-mode
+ * readiness (a browser never opens). `bundle.md` is what a reviewer reads — the verdict, blockers and
+ * any inconclusive/stale proof first, then each Journey's intent, links, contracts, boundary, side
+ * effects, hashes, step objectives and readiness checks — and the human-only commands to run next.
+ * `manifest.json` records every hash it was built from; `--check` re-derives them and fails closed
+ * (`E_BUNDLE_STALE`) when any moved. It only prints commands a person runs: it never approves,
+ * promotes or uploads.
+ */
+/** #584: a local bundle build's request. `out` is created (recursively) if missing; nothing outside it is written. */
+export interface JourneyBundleOptions {
+    readonly id: string;
+    readonly with?: string;
+    readonly out: string;
+    readonly journeysDir: string;
+    readonly catalogDir?: string | null;
+    readonly targetsFile?: string;
+    /** The project root an upload fixture resolves against, as `journey run` (optional). */
+    readonly projectDir?: string;
+}
+export interface JourneyBundleCheckOptions {
+    readonly journeysDir: string;
+    readonly catalogDir?: string | null;
+    readonly targetsFile?: string;
+}
+/** #584: test seams. `readiness`/`review`/`loadCatalog` default to the real modules. */
+export interface JourneyBundleDeps {
+    readonly readiness?: typeof runJourneyReadiness;
+    readonly review?: typeof reviewJourneyById;
+    readonly loadCatalog?: typeof loadCatalog;
+    /** Whether a Journey has a pending annotation draft (default: the sidecar file exists). */
+    readonly annotationDraft?: (journeysDir: string, id: string) => boolean;
+    readonly cwd?: () => string;
+}
+export interface JourneyBundleResult {
+    readonly out: string;
+    readonly files: readonly string[];
+    readonly verdict: ReadinessVerdict;
+}
+export interface JourneyBundleCheckResult {
+    readonly stale: false;
+}
+/** One hash the bundle was built from, so `--check` can re-derive it. */
+export interface JourneyBundleManifest {
+    readonly bundleVersion: 1;
+    readonly journeys: ReadonlyArray<{
+        readonly id: string;
+        readonly contentHash: string;
+        readonly reviewHash: string;
+    }>;
+    readonly catalog: ReadonlyArray<{
+        readonly kind: "persona" | "job";
+        readonly id: string;
+        readonly hash: string;
+    }>;
+    readonly verdict: ReadinessVerdict;
+    readonly generatedAt: string;
+}
+/** #584: a stale manifest — `--check` re-derived a different hash (exit 1). */
+export declare class BundleStaleError extends Error {
+    readonly changed: readonly string[];
+    readonly code = "E_BUNDLE_STALE";
+    constructor(changed: readonly string[]);
+}
+interface JourneyEntry {
+    readonly id: string;
+    readonly journey: Journey;
+    readonly review: JourneyReview;
+}
+/** §4: the bundle's Markdown. The verdict, blockers and any inconclusive/stale proof come first. */
+export declare function renderJourneyBundle(receipt: ReadinessReceipt, entries: readonly JourneyEntry[], catalog: Catalog, drafts: ReadonlySet<string>): string;
+/** #584: build the local bundle from a `report`-mode readiness and the review sheet of each Journey. */
+export declare function buildJourneyBundle(opts: JourneyBundleOptions, deps?: JourneyBundleDeps): Promise<JourneyBundleResult>;
+/** #584: re-derive every hash the bundle recorded; a moved hash throws `BundleStaleError` (exit 1). */
+export declare function checkJourneyBundle(dir: string, opts: JourneyBundleCheckOptions, deps?: JourneyBundleDeps): Promise<JourneyBundleCheckResult>;
+export {};

package/dist/journey-bundle.js

@@ -0,0 +1,252 @@
+import { existsSync } from "node:fs";
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { join, resolve } from "node:path";
+import { clock } from "@jevitate/domain";
+import { loadCatalog } from "./catalog-api.js";
+import { annotationDraftPath, journeyContentHash } from "./journey-annotate-api.js";
+import { reviewJourneyById } from "./journey-review-api.js";
+import { runJourneyReadiness } from "./journey-readiness.js";
+/** #584: a stale manifest — `--check` re-derived a different hash (exit 1). */
+export class BundleStaleError extends Error {
+    changed;
+    code = "E_BUNDLE_STALE";
+    constructor(changed) {
+        super(`the bundle is stale: ${changed.join("; ")}`);
+        this.changed = changed;
+        this.name = "BundleStaleError";
+    }
+}
+/** The label every approval state carries (§4): technical readiness, draft, prior approval, stale approval, current authorization. */
+function catalogApprovalLabel(status) {
+    switch (status) {
+        case "approved":
+            return "current authorization";
+        case "stale":
+            return "stale approval";
+        case "draft":
+            return "draft";
+        default:
+            return "unknown";
+    }
+}
+/** How a Journey's own promotion reads: not promoted is `draft`, an approval that no longer binds is `stale approval`. */
+function journeyApprovalLabel(entry) {
+    const approval = entry.journey.metadata.approval;
+    const change = entry.review.changeSinceApproval;
+    const stale = (change.kind === "diff" || change.kind === "snapshot-missing") && change.changed;
+    if (entry.journey.metadata.promoted && approval !== undefined && !stale)
+        return "current authorization";
+    if (stale)
+        return "stale approval";
+    if (approval !== undefined)
+        return "prior approval";
+    return "draft";
+}
+function handoffFieldLines(fields, indent) {
+    return Object.entries(fields).map(([name, decl]) => `${indent}${name}: ${decl.type}${decl.required === false ? " (optional)" : ""}`);
+}
+/** §4: the #582 contracts, by field name and type only (never a value). */
+function contractLines(entry) {
+    const outputs = entry.journey.metadata.outputs;
+    const inputs = entry.journey.metadata.inputs;
+    if (outputs === undefined && inputs === undefined)
+        return ["contracts: none declared"];
+    const lines = ["contracts:"];
+    if (outputs !== undefined)
+        lines.push(...outputsLines(outputs));
+    if (inputs !== undefined)
+        lines.push(...inputsLines(inputs));
+    return lines;
+}
+function outputsLines(outputs) {
+    const lines = [`  outputs: ${outputs.contract}`];
+    lines.push(...handoffFieldLines(outputs.fields, "    "));
+    if (outputs.collection !== undefined)
+        lines.push(`    collection: ${outputs.collection}`);
+    return lines;
+}
+function inputsLines(inputs) {
+    const lines = [`  inputs: accepts ${inputs.accepts}`, ...handoffFieldLines(inputs.request.fields, "    request ")];
+    for (const [param, binding] of Object.entries(inputs.bindings)) {
+        const source = "record" in binding ? `record.${binding.record}` : "request" in binding ? `request.${binding.request}` : "const" in binding ? `const.${binding.const}` : `secret.${binding.secret}`;
+        lines.push(`    binding ${param} <- ${source}`);
+    }
+    return lines;
+}
+/** §4: a person runs these, in order (persona approve, job approve, annotations approve, journey promote). */
+function humanCommands(entry, catalog, draft, ready) {
+    const commands = [];
+    const personaId = entry.review.catalog?.persona?.id;
+    const jobId = entry.review.catalog?.job?.id;
+    if (personaId !== undefined) {
+        const hash = catalog.personas.find((p) => p.id === personaId)?.contentHash;
+        commands.push(`jevitate persona approve ${personaId}${hash === undefined ? "" : ` --reviewed-hash ${hash}`}`);
+    }
+    if (jobId !== undefined) {
+        const hash = catalog.jobs.find((j) => j.id === jobId)?.contentHash;
+        commands.push(`jevitate job approve ${jobId}${hash === undefined ? "" : ` --reviewed-hash ${hash}`}`);
+    }
+    if (draft)
+        commands.push(`jevitate journey annotate ${entry.id} --approve`);
+    // §4: while any technical blocker remains, promote moves under "After the blockers are fixed" without a hash.
+    if (ready)
+        commands.push(`jevitate journey promote ${entry.id} --reviewed-hash ${entry.review.contentHash}`);
+    return commands;
+}
+function journeySection(entry, receipt) {
+    const m = entry.journey.metadata;
+    const lines = [`## Journey: ${entry.id}`, ""];
+    lines.push(`goal: ${m.goal ?? "(none)"}`);
+    const links = entry.review.catalog;
+    if (links?.persona !== undefined)
+        lines.push(`persona: ${links.persona.id} (${catalogApprovalLabel(links.persona.status)})`);
+    if (links?.job !== undefined)
+        lines.push(`job: ${links.job.id} (${catalogApprovalLabel(links.job.status)})`);
+    lines.push(...contractLines(entry));
+    const boundary = m.boundary;
+    lines.push(boundary === undefined ? "boundary: none declared" : `boundary: ${boundary.kind}; stop before "${boundary.stopBefore.label}"; next step: ${boundary.nextStep}`);
+    lines.push("side effects:");
+    if (entry.review.sideEffects.writeRequests.length === 0)
+        lines.push("  none");
+    for (const w of entry.review.sideEffects.writeRequests)
+        lines.push(`  ${w.method} ${w.endpoint} (${w.source}${w.step === undefined ? "" : `, step ${w.step}`})`);
+    lines.push(`content hash: ${journeyContentHash(entry.journey)}`);
+    lines.push(`review hash: ${entry.review.contentHash}`);
+    lines.push(`approval: ${journeyApprovalLabel(entry)}`);
+    lines.push("steps:");
+    for (const step of entry.review.steps)
+        lines.push(`  ${step.number}. ${step.action} — objective: ${step.objective ?? "(pending)"}`);
+    if (entry.review.summary.missingIntent.length > 0) {
+        lines.push("pending annotations:");
+        for (const item of entry.review.summary.missingIntent)
+            lines.push(`  - ${item}`);
+    }
+    lines.push("readiness:");
+    for (const check of receipt.checks.filter((c) => c.journey === entry.id))
+        lines.push(checkLine(check));
+    return lines;
+}
+function checkLine(check) {
+    return `  ${check.check}: ${check.state} — ${check.detail}${check.evidence === undefined ? "" : ` (evidence: ${check.evidence})`}`;
+}
+/** §4: the bundle's Markdown. The verdict, blockers and any inconclusive/stale proof come first. */
+export function renderJourneyBundle(receipt, entries, catalog, drafts) {
+    const lines = [`# Journey readiness bundle`, "", `verdict: ${receipt.verdict}`, ""];
+    const blockers = receipt.blockers;
+    if (blockers.length > 0) {
+        lines.push("## Blockers", "");
+        for (const b of blockers)
+            lines.push(`- ${b.journey} ${b.check}: ${b.why} — next: ${b.next}`);
+        lines.push("");
+    }
+    const flagged = receipt.checks.filter((c) => c.state === "inconclusive" || c.state === "stale");
+    if (flagged.length > 0) {
+        lines.push("## Inconclusive or stale evidence", "");
+        for (const c of flagged)
+            lines.push(`- ${c.journey} ${c.check}: ${c.state} — ${c.detail}`);
+        lines.push("");
+    }
+    for (const entry of entries) {
+        lines.push(...journeySection(entry, receipt), "");
+    }
+    const ready = receipt.verdict === "technically-ready";
+    lines.push("## Human-only commands", "");
+    for (const entry of entries) {
+        for (const command of humanCommands(entry, catalog, drafts.has(entry.id), ready))
+            lines.push(`- ${command}`);
+    }
+    if (!ready) {
+        lines.push("");
+        lines.push("## After the blockers are fixed", "");
+        for (const entry of entries)
+            lines.push(`- jevitate journey promote ${entry.id}`);
+    }
+    lines.push("");
+    return `${lines.join("\n")}\n`;
+}
+function catalogEntries(entries, catalog) {
+    const wanted = new Map();
+    const add = (kind, id, hash) => {
+        if (id === undefined || hash === undefined)
+            return;
+        wanted.set(`${kind}\u0000${id}`, { kind, id, hash });
+    };
+    for (const entry of entries) {
+        const links = entry.review.catalog;
+        add("persona", links?.persona?.id, catalog.personas.find((p) => p.id === links?.persona?.id)?.contentHash);
+        add("job", links?.job?.id, catalog.jobs.find((j) => j.id === links?.job?.id)?.contentHash);
+    }
+    return [...wanted.values()].sort((a, b) => (a.kind === b.kind ? a.id.localeCompare(b.id) : a.kind.localeCompare(b.kind)));
+}
+function defaultAnnotationDraft(journeysDir, id) {
+    return existsSync(annotationDraftPath(journeysDir, id));
+}
+/** #584: build the local bundle from a `report`-mode readiness and the review sheet of each Journey. */
+export async function buildJourneyBundle(opts, deps = {}) {
+    const readiness = deps.readiness ?? runJourneyReadiness;
+    const review = deps.review ?? reviewJourneyById;
+    const catalogOf = deps.loadCatalog ?? loadCatalog;
+    const draftExists = deps.annotationDraft ?? defaultAnnotationDraft;
+    const readinessOpts = {
+        id: opts.id,
+        ...(opts.with === undefined ? {} : { with: opts.with }),
+        mode: "report",
+        journeysDir: opts.journeysDir,
+        ...(opts.catalogDir === undefined ? {} : { catalogDir: opts.catalogDir }),
+        ...(opts.targetsFile === undefined ? {} : { targetsFile: opts.targetsFile }),
+        ...(opts.projectDir === undefined ? {} : { projectDir: opts.projectDir }),
+    };
+    const receiptDeps = deps.cwd === undefined ? {} : { cwd: deps.cwd };
+    const receipt = await readiness(readinessOpts, receiptDeps);
+    const ids = [opts.id, ...(opts.with === undefined ? [] : [opts.with])];
+    const reviewOpts = { strict: true, ...(opts.catalogDir === undefined ? {} : { catalogDir: opts.catalogDir }), ...(opts.targetsFile === undefined ? {} : { targetsFile: opts.targetsFile }) };
+    const entries = [];
+    for (const id of ids) {
+        const loaded = await review(opts.journeysDir, id, reviewOpts);
+        entries.push({ id, journey: loaded.journey, review: loaded.review });
+    }
+    const catalog = await catalogOf(opts.catalogDir === undefined ? null : opts.catalogDir, opts.journeysDir);
+    const drafts = new Set(ids.filter((id) => draftExists(opts.journeysDir, id)));
+    const out = resolve(opts.out);
+    const bundlePath = join(out, "bundle.md");
+    const manifestPath = join(out, "manifest.json");
+    const manifest = {
+        bundleVersion: 1,
+        journeys: entries.map((e) => ({ id: e.id, contentHash: journeyContentHash(e.journey), reviewHash: e.review.contentHash })),
+        catalog: catalogEntries(entries, catalog),
+        verdict: receipt.verdict,
+        generatedAt: clock.nowIso(),
+    };
+    await mkdir(out, { recursive: true });
+    await writeFile(bundlePath, renderJourneyBundle(receipt, entries, catalog, drafts), "utf8");
+    await writeFile(manifestPath, `${JSON.stringify(manifest, null, 2)}\n`, "utf8");
+    return { out, files: [bundlePath, manifestPath], verdict: receipt.verdict };
+}
+/** #584: re-derive every hash the bundle recorded; a moved hash throws `BundleStaleError` (exit 1). */
+export async function checkJourneyBundle(dir, opts, deps = {}) {
+    const review = deps.review ?? reviewJourneyById;
+    const catalogOf = deps.loadCatalog ?? loadCatalog;
+    const manifestPath = join(resolve(dir), "manifest.json");
+    const manifest = JSON.parse(await readFile(manifestPath, "utf8"));
+    const reviewOpts = { strict: true, ...(opts.catalogDir === undefined ? {} : { catalogDir: opts.catalogDir }), ...(opts.targetsFile === undefined ? {} : { targetsFile: opts.targetsFile }) };
+    const changed = [];
+    for (const recorded of manifest.journeys) {
+        const loaded = await review(opts.journeysDir, recorded.id, reviewOpts);
+        if (journeyContentHash(loaded.journey) !== recorded.contentHash)
+            changed.push(`journey ${recorded.id} contentHash`);
+        if (loaded.review.contentHash !== recorded.reviewHash)
+            changed.push(`journey ${recorded.id} reviewHash`);
+    }
+    if (manifest.catalog.length > 0) {
+        const catalog = await catalogOf(opts.catalogDir === undefined ? null : opts.catalogDir, opts.journeysDir);
+        for (const recorded of manifest.catalog) {
+            const current = recorded.kind === "persona" ? catalog.personas.find((p) => p.id === recorded.id)?.contentHash : catalog.jobs.find((j) => j.id === recorded.id)?.contentHash;
+            if (current !== recorded.hash)
+                changed.push(`${recorded.kind} ${recorded.id} hash`);
+        }
+    }
+    if (changed.length > 0)
+        throw new BundleStaleError(changed);
+    return { stale: false };
+}
+//# sourceMappingURL=journey-bundle.js.map

package/dist/journey-bundle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"journey-bundle.js","sourceRoot":"","sources":["../src/journey-bundle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAEzC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AACpF,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAmG,MAAM,wBAAwB,CAAC;AA6D9J,+EAA+E;AAC/E,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IAEpB;IADZ,IAAI,GAAG,gBAAgB,CAAC;IACjC,YAAqB,OAA0B;QAC7C,KAAK,CAAC,wBAAwB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QADjC,YAAO,GAAP,OAAO,CAAmB;QAE7C,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AAQD,sIAAsI;AACtI,SAAS,oBAAoB,CAAC,MAAkD;IAC9E,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,UAAU;YACb,OAAO,uBAAuB,CAAC;QACjC,KAAK,OAAO;YACV,OAAO,gBAAgB,CAAC;QAC1B,KAAK,OAAO;YACV,OAAO,OAAO,CAAC;QACjB;YACE,OAAO,SAAS,CAAC;IACrB,CAAC;AACH,CAAC;AAED,0HAA0H;AAC1H,SAAS,oBAAoB,CAAC,KAAmB;IAC/C,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC;IACjD,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,mBAAmB,CAAC;IAChD,MAAM,KAAK,GAAG,CAAC,MAAM,CAAC,IAAI,KAAK,MAAM,IAAI,MAAM,CAAC,IAAI,KAAK,kBAAkB,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC;IAC/F,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,IAAI,QAAQ,KAAK,SAAS,IAAI,CAAC,KAAK;QAAE,OAAO,uBAAuB,CAAC;IACxG,IAAI,KAAK;QAAE,OAAO,gBAAgB,CAAC;IACnC,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,gBAAgB,CAAC;IACpD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,iBAAiB,CAAC,MAAqB,EAAE,MAAc;IAC9D,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,GAAG,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,QAAQ,KAAK,KAAK,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACvI,CAAC;AAED,2EAA2E;AAC3E,SAAS,aAAa,CAAC,KAAmB;IACxC,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;IAC/C,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;IAC7C,IAAI,OAAO,KAAK,SAAS,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,CAAC,0BAA0B,CAAC,CAAC;IACvF,MAAM,KAAK,GAAG,CAAC,YAAY,CAAC,CAAC;IAC7B,IAAI,OAAO,KAAK,SAAS;QAAE,KAAK,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;IAChE,IAAI,MAAM,KAAK,SAAS;QAAE,KAAK,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC;IAC7D,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,YAAY,CAAC,OAA2B;IAC/C,MAAM,KAAK,GAAG,CAAC,cAAc,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IACjD,KAAK,CAAC,IAAI,CAAC,GAAG,iBAAiB,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACzD,IAAI,OAAO,CAAC,UAAU,KAAK,SAAS;QAAE,KAAK,CAAC,IAAI,CAAC,mBAAmB,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IAC1F,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,WAAW,CAAC,MAAyB;IAC5C,MAAM,KAAK,GAAG,CAAC,qBAAqB,MAAM,CAAC,OAAO,EAAE,EAAE,GAAG,iBAAiB,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC;IACnH,KAAK,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC/D,MAAM,MAAM,GAAG,QAAQ,IAAI,OAAO,CAAC,CAAC,CAAC,UAAU,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,SAAS,IAAI,OAAO,CAAC,CAAC,CAAC,WAAW,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,OAAO,IAAI,OAAO,CAAC,CAAC,CAAC,SAAS,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,UAAU,OAAO,CAAC,MAAM,EAAE,CAAC;QACnM,KAAK,CAAC,IAAI,CAAC,eAAe,KAAK,OAAO,MAAM,EAAE,CAAC,CAAC;IAClD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,8GAA8G;AAC9G,SAAS,aAAa,CAAC,KAAmB,EAAE,OAAgB,EAAE,KAAc,EAAE,KAAc;IAC1F,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,CAAC;IACpD,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,GAAG,EAAE,EAAE,CAAC;IAC5C,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,SAAS,CAAC,EAAE,WAAW,CAAC;QAC3E,QAAQ,CAAC,IAAI,CAAC,4BAA4B,SAAS,GAAG,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,oBAAoB,IAAI,EAAE,EAAE,CAAC,CAAC;IAChH,CAAC;IACD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,KAAK,CAAC,EAAE,WAAW,CAAC;QACnE,QAAQ,CAAC,IAAI,CAAC,wBAAwB,KAAK,GAAG,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,oBAAoB,IAAI,EAAE,EAAE,CAAC,CAAC;IACxG,CAAC;IACD,IAAI,KAAK;QAAE,QAAQ,CAAC,IAAI,CAAC,6BAA6B,KAAK,CAAC,EAAE,YAAY,CAAC,CAAC;IAC5E,8GAA8G;IAC9G,IAAI,KAAK;QAAE,QAAQ,CAAC,IAAI,CAAC,4BAA4B,KAAK,CAAC,EAAE,oBAAoB,KAAK,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;IAC7G,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,cAAc,CAAC,KAAmB,EAAE,OAAyB;IACpE,MAAM,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC;IACjC,MAAM,KAAK,GAAa,CAAC,eAAe,KAAK,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;IACxD,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,IAAI,IAAI,QAAQ,EAAE,CAAC,CAAC;IAC1C,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC;IACnC,IAAI,KAAK,EAAE,OAAO,KAAK,SAAS;QAAE,KAAK,CAAC,IAAI,CAAC,YAAY,KAAK,CAAC,OAAO,CAAC,EAAE,KAAK,oBAAoB,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC7H,IAAI,KAAK,EAAE,GAAG,KAAK,SAAS;QAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,KAAK,CAAC,GAAG,CAAC,EAAE,KAAK,oBAAoB,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC7G,KAAK,CAAC,IAAI,CAAC,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC;IACpC,MAAM,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC;IAC5B,KAAK,CAAC,IAAI,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,yBAAyB,CAAC,CAAC,CAAC,aAAa,QAAQ,CAAC,IAAI,kBAAkB,QAAQ,CAAC,UAAU,CAAC,KAAK,iBAAiB,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC3K,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAC5B,IAAI,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,aAAa,CAAC,MAAM,KAAK,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC9E,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,aAAa;QAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACjK,KAAK,CAAC,IAAI,CAAC,iBAAiB,kBAAkB,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACjE,KAAK,CAAC,IAAI,CAAC,gBAAgB,KAAK,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;IACvD,KAAK,CAAC,IAAI,CAAC,aAAa,oBAAoB,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACvD,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACrB,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK;QAAE,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM,iBAAiB,IAAI,CAAC,SAAS,IAAI,WAAW,EAAE,CAAC,CAAC;IACpI,IAAI,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClD,KAAK,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;QACnC,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,aAAa;YAAE,KAAK,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;IACnF,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACzB,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,KAAK,CAAC,EAAE,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;IACvG,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,SAAS,CAAC,KAAqB;IACtC,OAAO,KAAK,KAAK,CAAC,KAAK,KAAK,KAAK,CAAC,KAAK,MAAM,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,eAAe,KAAK,CAAC,QAAQ,GAAG,EAAE,CAAC;AACrI,CAAC;AAED,oGAAoG;AACpG,MAAM,UAAU,mBAAmB,CAAC,OAAyB,EAAE,OAAgC,EAAE,OAAgB,EAAE,MAA2B;IAC5I,MAAM,KAAK,GAAa,CAAC,4BAA4B,EAAE,EAAE,EAAE,YAAY,OAAO,CAAC,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;IAC9F,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IAClC,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,KAAK,CAAC,IAAI,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC;QAC9B,KAAK,MAAM,CAAC,IAAI,QAAQ;YAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QAC9F,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IACD,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,cAAc,IAAI,CAAC,CAAC,KAAK,KAAK,OAAO,CAAC,CAAC;IAChG,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,mCAAmC,EAAE,EAAE,CAAC,CAAC;QACpD,KAAK,MAAM,CAAC,IAAI,OAAO;YAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;QAC3F,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IACD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,KAAK,CAAC,IAAI,CAAC,GAAG,cAAc,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC;IACpD,CAAC;IACD,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,KAAK,mBAAmB,CAAC;IACtD,KAAK,CAAC,IAAI,CAAC,wBAAwB,EAAE,EAAE,CAAC,CAAC;IACzC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,KAAK,MAAM,OAAO,IAAI,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC;YAAE,KAAK,CAAC,IAAI,CAAC,KAAK,OAAO,EAAE,CAAC,CAAC;IAC/G,CAAC;IACD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,iCAAiC,EAAE,EAAE,CAAC,CAAC;QAClD,KAAK,MAAM,KAAK,IAAI,OAAO;YAAE,KAAK,CAAC,IAAI,CAAC,8BAA8B,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;IACpF,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;AACjC,CAAC;AAED,SAAS,cAAc,CAAC,OAAgC,EAAE,OAAgB;IACxE,MAAM,MAAM,GAAG,IAAI,GAAG,EAAiE,CAAC;IACxF,MAAM,GAAG,GAAG,CAAC,IAAuB,EAAE,EAAsB,EAAE,IAAwB,EAAQ,EAAE;QAC9F,IAAI,EAAE,KAAK,SAAS,IAAI,IAAI,KAAK,SAAS;YAAE,OAAO;QACnD,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,SAAS,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;IACvD,CAAC,CAAC;IACF,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC;QACnC,GAAG,CAAC,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC,EAAE,WAAW,CAAC,CAAC;QAC3G,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,EAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,EAAE,WAAW,CAAC,CAAC;IAC7F,CAAC;IACD,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAC5H,CAAC;AAED,SAAS,sBAAsB,CAAC,WAAmB,EAAE,EAAU;IAC7D,OAAO,UAAU,CAAC,mBAAmB,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,CAAC;AAC1D,CAAC;AAED,wGAAwG;AACxG,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,IAA0B,EAAE,OAA0B,EAAE;IAC/F,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,mBAAmB,CAAC;IACxD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,iBAAiB,CAAC;IAChD,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,IAAI,WAAW,CAAC;IAClD,MAAM,WAAW,GAAG,IAAI,CAAC,eAAe,IAAI,sBAAsB,CAAC;IAEnE,MAAM,aAAa,GAA4B;QAC7C,EAAE,EAAE,IAAI,CAAC,EAAE;QACX,GAAG,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;QACvD,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,GAAG,CAAC,IAAI,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC;QACzE,GAAG,CAAC,IAAI,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC;QAC5E,GAAG,CAAC,IAAI,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC;KAC1E,CAAC;IACF,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC;IACpE,MAAM,OAAO,GAAG,MAAM,SAAS,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC;IAE5D,MAAM,GAAG,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,GAAG,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACvE,MAAM,UAAU,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,EAAE,GAAG,CAAC,IAAI,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,EAAW,CAAC;IACtM,MAAM,OAAO,GAAmB,EAAE,CAAC;IACnC,KAAK,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC;QACrB,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,EAAE,UAAU,CAAC,CAAC;QAC9D,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IACvE,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IAC1G,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;IAE9E,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC9B,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;IAC1C,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC;IAChD,MAAM,QAAQ,GAA0B;QACtC,aAAa,EAAE,CAAC;QAChB,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,WAAW,EAAE,kBAAkB,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;QAC1H,OAAO,EAAE,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC;QACzC,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,WAAW,EAAE,KAAK,CAAC,MAAM,EAAE;KAC5B,CAAC;IACF,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtC,MAAM,SAAS,CAAC,UAAU,EAAE,mBAAmB,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC;IAC5F,MAAM,SAAS,CAAC,YAAY,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAChF,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,UAAU,EAAE,YAAY,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC;AAC9E,CAAC;AAED,uGAAuG;AACvG,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,GAAW,EAAE,IAA+B,EAAE,OAA0B,EAAE;IACjH,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,iBAAiB,CAAC;IAChD,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,IAAI,WAAW,CAAC;IAClD,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,eAAe,CAAC,CAAC;IACzD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,CAA0B,CAAC;IAC3F,MAAM,UAAU,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,EAAE,GAAG,CAAC,IAAI,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,EAAW,CAAC;IACtM,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,MAAM,QAAQ,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;QACzC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;QACvE,IAAI,kBAAkB,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,WAAW;YAAE,OAAO,CAAC,IAAI,CAAC,WAAW,QAAQ,CAAC,EAAE,cAAc,CAAC,CAAC;QACpH,IAAI,MAAM,CAAC,MAAM,CAAC,WAAW,KAAK,QAAQ,CAAC,UAAU;YAAE,OAAO,CAAC,IAAI,CAAC,WAAW,QAAQ,CAAC,EAAE,aAAa,CAAC,CAAC;IAC3G,CAAC;IACD,IAAI,QAAQ,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChC,MAAM,OAAO,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;QAC1G,KAAK,MAAM,QAAQ,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;YACxC,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,QAAQ,CAAC,EAAE,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,QAAQ,CAAC,EAAE,CAAC,EAAE,WAAW,CAAC;YAC5K,IAAI,OAAO,KAAK,QAAQ,CAAC,IAAI;gBAAE,OAAO,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,IAAI,IAAI,QAAQ,CAAC,EAAE,OAAO,CAAC,CAAC;QACtF,CAAC;IACH,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;QAAE,MAAM,IAAI,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAC5D,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;AAC1B,CAAC"}

package/dist/journey-chain.d.ts

@@ -0,0 +1,105 @@
+import { type HandoffRejection } from "@jevitate/journey";
+import type { JourneyRunResult, SiteGateDeps } from "@jevitate/runtime";
+import type { BrowserPort, EmulationSpec } from "@jevitate/playwright";
+import type { BrowserRunOptions } from "./browser-run-options.js";
+import type { ResolvedJourneyEnvironment } from "./environments.js";
+import { type RunJourneyProgrammaticallyOptions } from "./journey-api.js";
+/**
+ * #580 (docs/journey-chain-contract.md §5): `jevitate journey chain` runs a discover Journey once,
+ * then a prepare-only reply Journey once per approved request matched to a discovered record. This is
+ * the one programmatic surface the CLI and the (separately reviewed) MCP tool share.
+ *
+ * The result carries names and outcomes only — never a record field's value (e.g. `sourceText`) or a
+ * request's `replyText`.
+ *
+ * #582 (docs/contracts/journey-handoff.md §4-§5): when the reply Journey declares `metadata.inputs`,
+ * the discovered records and the requests are validated by the pure `@jevitate/journey` handoff
+ * validators and each request is matched on `inputs.request.key` and bound by `bindParams`.
+ */
+/** The runner `journey run` uses; a testing seam so the chain can be driven without a browser. */
+export type JourneyChainRunner = (options: RunJourneyProgrammaticallyOptions) => Promise<JourneyRunResult>;
+/** Injectable wiring for `runJourneyChain` (all optional; the real runner is the default). */
+export interface JourneyChainDeps {
+    /** Testing seam — defaults to `runJourneyProgrammatically`. */
+    readonly runJourney?: JourneyChainRunner;
+}
+export type JourneyChainErrorCode = "E_CHAIN_FROM_FAILED" | "E_CHAIN_EMPTY" | "E_CHAIN_REQUEST" | "E_CHAIN_NOT_PROMOTED" | "E_HANDOFF_INCOMPATIBLE";
+/** A chain-stopping failure (§5 steps 1, 2 and the §4 request contract). */
+export declare class JourneyChainError extends Error {
+    readonly code: JourneyChainErrorCode;
+    constructor(code: JourneyChainErrorCode, message: string);
+}
+/** §5 step 4: a matched record is missing a field the reply Journey needs — per request, never a guess. */
+export declare const E_CHAIN_FIELD = "E_CHAIN_FIELD";
+/** One approved, prepare-only request (§4). `commentId` + `account` are the identity; no other key exists. */
+export interface ChainRequest {
+    readonly commentId: string;
+    readonly account: string;
+    readonly replyText: string;
+}
+/** One matched request's run outcome (§5 result `runs[]`). */
+export interface ChainRunResult {
+    readonly commentId: string;
+    readonly account: string;
+    readonly outcome: string;
+    readonly reason?: string;
+    /** §5 (handoff): the accepted contract (`name@major`). */
+    readonly contract?: string;
+    /** §5 (handoff): `sha256:` of the record's declared fields. */
+    readonly fingerprint?: string;
+    /** §5 (handoff): when the producing run finished (ISO 8601 UTC, from the injectable clock). */
+    readonly capturedAt?: string;
+}
+/** One request with no discovered record (§5 result `unmatched[]`). */
+export interface ChainUnmatched {
+    readonly commentId: string;
+    readonly account: string;
+}
+/** The §5 result: the discover run's summary, one entry per matched request, the unmatched requests. */
+export interface JourneyChainResult {
+    readonly from: {
+        readonly journey: string;
+        readonly outcome: string;
+        readonly records: number;
+    };
+    readonly runs: readonly ChainRunResult[];
+    readonly unmatched: readonly ChainUnmatched[];
+    /** §4/§5 (handoff): records, ambiguous keys and requests a chain refused to run; absent in 0.17.0 mode. */
+    readonly rejected?: readonly HandoffRejection[];
+}
+/**
+ * §4: parse the JSON Lines file of prepare-only requests. `commentId`, `account` and `replyText` are
+ * exactly the keys; any other key, a missing key or a non-string value is refused (`E_CHAIN_REQUEST`).
+ * Blank lines are skipped; approval metadata stays in Bizops and is not read here.
+ */
+export declare function parseChainRequests(text: string): ChainRequest[];
+/** §5 step 5: the chain succeeded only when every request matched and every run was `ok`. */
+export declare function chainSucceeded(result: JourneyChainResult): boolean;
+/** The flags every run in the chain shares (environment, session, browser, allowlist, site policy). */
+export interface RunJourneyChainOptions {
+    readonly from: string;
+    readonly to: string;
+    /** The approved requests as raw JSON Lines (§4). */
+    readonly requests: string;
+    /** The journeys directory. */
+    readonly dir: string;
+    readonly environment?: ResolvedJourneyEnvironment;
+    readonly storageState?: string;
+    readonly browser?: BrowserRunOptions;
+    readonly emulation?: EmulationSpec;
+    readonly browserPortFactory?: () => BrowserPort;
+    readonly allow?: readonly string[];
+    readonly siteGate?: SiteGateDeps;
+    /**
+     * Refuse a `from` or `to` Journey that is not promoted (`E_CHAIN_NOT_PROMOTED`) before anything
+     * runs. The CLI sets it unless `--allow-draft`; MCP can never unset it (promoted-only, as run_journey).
+     */
+    readonly requirePromoted?: boolean;
+}
+/**
+ * §5: run `from` once, join each approved request to the record with the same `commentId` and
+ * `account`, and run `to` once per match with §3's params. Unmatched requests are listed and never
+ * run. A failed `from` stops the chain (`E_CHAIN_FROM_FAILED`); a missing/zero record count stops it
+ * (`E_CHAIN_EMPTY`); a malformed request refuses the whole file (`E_CHAIN_REQUEST`).
+ */
+export declare function runJourneyChain(opts: RunJourneyChainOptions, deps?: JourneyChainDeps): Promise<JourneyChainResult>;