@jevitate/cli 0.7.0 → 0.9.0

package/dist/catalog.js

@@ -0,0 +1,352 @@
+import { existsSync } from "node:fs";
+import { readFile, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { contentHash } from "@jevitate/domain";
+import { CATALOG_ID_RE, CatalogApprovalSchema, FsJourneyStore, JobSchema, renderJobStory, } from "@jevitate/journey";
+import { journeyReviewHash } from "./journey-review.js";
+/**
+ * #433 — the catalog: personas, jobs and Journeys, with their ids, content hashes and approval
+ * state, loaded in one place (`CatalogLoader`) for every approval path, every review sheet and
+ * `catalog status` — and for the readiness (#434) and catalog-analysis (#435) analyzers.
+ *
+ * Files (in the project's `.jevitate/`):
+ *  - `personas.json` — the #427 personas file, extended: an entry may carry `description`, `role`
+ *    and its `approval`, beside its session settings (`storageState`, `login`). A catalog-only
+ *    persona (no session yet) is allowed. The persona's id is its #427 `name` (`id` is accepted too).
+ *  - `jobs.json` — job stories (`JobSchema`); `.jevitate/campaign/jobs.json` (the test-campaign
+ *    skill's old place) is read when `jobs.json` does not exist.
+ *
+ * Content hashes leave the approval out, so approving does not change what was approved. A
+ * persona's hash covers what the persona IS (id, description, role, any other descriptive key),
+ * not its session settings: re-minting a session or moving a storage state is not a new persona.
+ * A missing file is an empty catalog — a project without personas/jobs works exactly as before;
+ * a file that exists but cannot be read as the catalog is refused (`CatalogInputError`), never skipped.
+ */
+export const PERSONAS_FILE = "personas.json";
+export const JOBS_FILE = "jobs.json";
+/** The test-campaign skill's jobs file before #433 — still read for compatibility. */
+export const LEGACY_JOBS_FILE = join("campaign", "jobs.json");
+/** A catalog file that exists but is not a valid catalog — refused (exit 64), never skipped. */
+export class CatalogInputError extends Error {
+    code = "E_CATALOG_INPUT";
+}
+/** `persona|job review|approve <id>`: no such item in the catalog. */
+export class UnknownCatalogItemError extends Error {
+    kind;
+    constructor(kind, message) {
+        super(message);
+        this.kind = kind;
+    }
+    get code() {
+        return this.kind === "persona" ? "E_UNKNOWN_PERSONA" : "E_UNKNOWN_JOB";
+    }
+}
+function statusOf(approval, hash) {
+    if (approval === undefined)
+        return "draft";
+    return approval.contentHash === hash ? "approved" : "stale";
+}
+function isRecord(v) {
+    return v !== null && typeof v === "object" && !Array.isArray(v);
+}
+async function readJsonFile(path) {
+    const raw = await readFile(path, "utf8");
+    try {
+        return JSON.parse(raw);
+    }
+    catch (err) {
+        throw new CatalogInputError(`${path} is not valid JSON: ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+async function writeJsonFile(path, value) {
+    await writeFile(path, `${JSON.stringify(value, null, 2)}\n`);
+}
+// ── personas.json ─────────────────────────────────────────────────────────────────────────────
+/** The session settings (#427): operational, not part of what a persona is (left out of its hash). */
+const SESSION_KEYS = new Set(["storageState", "login"]);
+function personaList(raw) {
+    if (Array.isArray(raw))
+        return raw;
+    if (isRecord(raw) && Array.isArray(raw.personas))
+        return raw.personas;
+    return null;
+}
+function rawPersonas(raw, path) {
+    const list = personaList(raw);
+    if (list !== null) {
+        return list.map((entry, index) => {
+            if (!isRecord(entry))
+                throw new CatalogInputError(`${path}: entry ${index} must be an object {"name": string, …}`);
+            const name = entry.name ?? entry.id;
+            if (typeof name !== "string")
+                throw new CatalogInputError(`${path}: entry ${index} needs a "name" (its persona id)`);
+            if (entry.name !== undefined && entry.id !== undefined && entry.name !== entry.id) {
+                throw new CatalogInputError(`${path}: entry ${index} has both "name" ${JSON.stringify(entry.name)} and "id" ${JSON.stringify(entry.id)} — one persona id`);
+            }
+            const { name: _n, id: _i, ...fields } = entry;
+            return { id: name, fields, slot: { form: "list", index } };
+        });
+    }
+    if (isRecord(raw)) {
+        return Object.entries(raw).map(([id, value]) => {
+            if (typeof value === "string")
+                return { id, fields: { storageState: value }, slot: { form: "map", key: id } };
+            if (!isRecord(value))
+                throw new CatalogInputError(`${path}: ${id} must map to a storage state path or an object`);
+            return { id, fields: { ...value }, slot: { form: "map", key: id } };
+        });
+    }
+    throw new CatalogInputError(`${path} must be an object or an array of personas`);
+}
+function catalogPersona(p, path) {
+    if (!CATALOG_ID_RE.test(p.id))
+        throw new CatalogInputError(`${path}: persona id ${JSON.stringify(p.id)} must be 1-64 of [A-Za-z0-9._-], starting alphanumeric`);
+    const { description, role, approval: rawApproval } = p.fields;
+    if (description !== undefined && (typeof description !== "string" || description.length > 2000)) {
+        throw new CatalogInputError(`${path}: persona ${p.id}: description must be text (at most 2000 characters)`);
+    }
+    if (role !== undefined && (typeof role !== "string" || role.length > 200))
+        throw new CatalogInputError(`${path}: persona ${p.id}: role must be text (at most 200 characters)`);
+    let approval;
+    if (rawApproval !== undefined) {
+        const parsed = CatalogApprovalSchema.safeParse(rawApproval);
+        if (!parsed.success)
+            throw new CatalogInputError(`${path}: persona ${p.id}: approval is not a valid approval record (${parsed.error.issues.map((i) => i.message).join("; ")})`);
+        approval = parsed.data;
+    }
+    const hash = personaContentHash(p.id, p.fields);
+    return {
+        id: p.id,
+        ...(typeof description === "string" ? { description } : {}),
+        ...(typeof role === "string" ? { role } : {}),
+        hasStorageState: typeof p.fields.storageState === "string",
+        hasLogin: p.fields.login !== undefined,
+        ...(approval === undefined ? {} : { approval }),
+        contentHash: hash,
+        status: statusOf(approval, hash),
+    };
+}
+/** #433: a persona's content hash — its id and descriptive keys, without its approval or session settings. */
+export function personaContentHash(id, fields) {
+    const described = { id };
+    for (const [k, v] of Object.entries(fields))
+        if (k !== "approval" && !SESSION_KEYS.has(k))
+            described[k] = v;
+    return contentHash(described);
+}
+// ── jobs.json ─────────────────────────────────────────────────────────────────────────────────
+function jobList(raw, path) {
+    if (Array.isArray(raw))
+        return raw;
+    if (isRecord(raw) && Array.isArray(raw.jobs))
+        return raw.jobs;
+    throw new CatalogInputError(`${path} must be an array of jobs (or {"jobs": [...]})`);
+}
+function catalogJob(entry, index, path) {
+    const where = isRecord(entry) && typeof entry.id === "string" ? `job ${JSON.stringify(entry.id)}` : `entry ${index}`;
+    const parsed = JobSchema.safeParse(entry);
+    if (!parsed.success) {
+        throw new CatalogInputError(`${path}: ${where}: ${parsed.error.issues.map((i) => (i.path.length === 0 ? i.message : `${i.path.join(".")}: ${i.message}`)).join("; ")}`);
+    }
+    const job = parsed.data;
+    const hash = jobContentHash(job);
+    return {
+        id: job.id,
+        job,
+        story: renderJobStory(job),
+        personas: [...new Set([...(job.personas ?? []), ...(job.persona === undefined ? [] : [job.persona])])],
+        ...(job.approval === undefined ? {} : { approval: job.approval }),
+        contentHash: hash,
+        status: statusOf(job.approval, hash),
+    };
+}
+/** #433: a job's content hash — the job without its approval. */
+export function jobContentHash(job) {
+    const { approval: _a, ...rest } = job;
+    return contentHash(rest);
+}
+// ── Journeys ──────────────────────────────────────────────────────────────────────────────────
+export function catalogJourney(journey) {
+    const m = journey.metadata;
+    const hash = journeyReviewHash(journey);
+    return {
+        id: m.id,
+        name: m.name,
+        promoted: m.promoted,
+        journey,
+        ...(m.job === undefined ? {} : { job: m.job }),
+        ...(m.persona === undefined ? {} : { personaText: m.persona }),
+        ...(m.approval === undefined ? {} : { approval: m.approval }),
+        contentHash: hash,
+        changedSinceApproval: m.promoted && m.approval !== undefined && m.approval.contentHash !== hash,
+    };
+}
+/**
+ * #433: loads personas + jobs + Journeys with their ids, content hashes and approval state. Shared
+ * by every approval path (`persona|job approve`, `journey promote`, `demo approve`), the review
+ * sheets and `catalog status` — and exported for the #434 / #435 analyzers.
+ */
+export class CatalogLoader {
+    opts;
+    constructor(opts) {
+        this.opts = opts;
+    }
+    /** The personas file path (whether or not it exists), or null without a catalog dir. */
+    personasPath() {
+        return this.opts.catalogDir === null ? null : join(this.opts.catalogDir, PERSONAS_FILE);
+    }
+    /** The jobs file in use: `jobs.json`, else the legacy `campaign/jobs.json`; null when neither exists. */
+    jobsPath() {
+        if (this.opts.catalogDir === null)
+            return null;
+        const main = join(this.opts.catalogDir, JOBS_FILE);
+        const legacy = join(this.opts.catalogDir, LEGACY_JOBS_FILE);
+        if (existsSync(main) && existsSync(legacy)) {
+            throw new CatalogInputError(`both ${main} and ${legacy} exist — merge the jobs into ${main} and remove ${legacy} (one jobs file, so nothing diverges silently)`);
+        }
+        if (existsSync(main))
+            return main;
+        return existsSync(legacy) ? legacy : null;
+    }
+    async loadPersonas() {
+        const path = this.personasPath();
+        if (path === null || !existsSync(path))
+            return { file: null, personas: [] };
+        const personas = rawPersonas(await readJsonFile(path), path).map((p) => catalogPersona(p, path));
+        const seen = new Set();
+        for (const p of personas) {
+            if (seen.has(p.id))
+                throw new CatalogInputError(`${path}: persona ${p.id} is declared twice`);
+            seen.add(p.id);
+        }
+        return { file: path, personas };
+    }
+    async loadJobs() {
+        const path = this.jobsPath();
+        if (path === null)
+            return { file: null, jobs: [] };
+        const jobs = jobList(await readJsonFile(path), path).map((e, i) => catalogJob(e, i, path));
+        const seen = new Set();
+        for (const j of jobs) {
+            if (seen.has(j.id))
+                throw new CatalogInputError(`${path}: job ${j.id} is declared twice`);
+            seen.add(j.id);
+        }
+        return { file: path, jobs };
+    }
+    async loadJourneys() {
+        const store = new FsJourneyStore(this.opts.journeysDir);
+        const out = [];
+        for (const meta of await store.list()) {
+            const journey = await store.get(meta.id);
+            if (journey !== null)
+                out.push(catalogJourney(journey));
+        }
+        return out.sort((a, b) => a.id.localeCompare(b.id));
+    }
+    async load() {
+        const [{ file: personasFile, personas }, { file: jobsFile, jobs }, journeys] = await Promise.all([this.loadPersonas(), this.loadJobs(), this.loadJourneys()]);
+        return { dir: this.opts.catalogDir, personasFile, jobsFile, personas, jobs, journeys, journeysDir: this.opts.journeysDir };
+    }
+}
+export function findPersona(catalog, id) {
+    return catalog.personas.find((p) => p.id === id);
+}
+export function findJob(catalog, id) {
+    return catalog.jobs.find((j) => j.id === id);
+}
+export function requirePersona(catalog, id) {
+    const p = findPersona(catalog, id);
+    if (p !== undefined)
+        return p;
+    const where = catalog.dir === null ? "no .jevitate/ project was found (run inside a project, or pass --dir)" : `${join(catalog.dir, PERSONAS_FILE)} declares ${catalog.personas.length === 0 ? "no personas" : `${catalog.personas.map((x) => x.id).join(", ")}`}`;
+    throw new UnknownCatalogItemError("persona", `unknown persona '${id}' — ${where}`);
+}
+export function requireJob(catalog, id) {
+    const j = findJob(catalog, id);
+    if (j !== undefined)
+        return j;
+    const where = catalog.dir === null ? "no .jevitate/ project was found (run inside a project, or pass --dir)" : catalog.jobsFile === null ? `there is no ${join(catalog.dir, JOBS_FILE)}` : `${catalog.jobsFile} declares ${catalog.jobs.map((x) => x.id).join(", ")}`;
+    throw new UnknownCatalogItemError("job", `unknown job '${id}' — ${where}`);
+}
+/** The Journeys whose catalog persona link is this persona. */
+export function journeysForPersona(catalog, personaId) {
+    return catalog.journeys.filter((j) => personaLinkId(catalog, j) === personaId);
+}
+export function journeysForJob(catalog, jobId) {
+    return catalog.journeys.filter((j) => j.job === jobId);
+}
+/**
+ * The persona id a Journey links: `metadata.persona` when it names a catalog persona; when the
+ * Journey links a job, its persona is ALWAYS read as an id (an unknown one is a dangling link).
+ * Otherwise `metadata.persona` is free text and links nothing.
+ */
+export function personaLinkId(catalog, j) {
+    const text = j.personaText?.trim();
+    if (text === undefined || text === "")
+        return undefined;
+    if (findPersona(catalog, text) !== undefined)
+        return text;
+    return j.job !== undefined ? text : undefined;
+}
+/** #433: a Journey's links, their approval state, what is unvetted and why it needs re-review. */
+export function journeyLinks(catalog, j) {
+    const job = j.job === undefined ? undefined : findJob(catalog, j.job);
+    const jobLink = j.job === undefined ? undefined : { id: j.job, status: (job?.status ?? "unknown"), ...(job === undefined ? {} : { story: job.story }) };
+    const personaId = personaLinkId(catalog, j);
+    const personaLink = personaId === undefined ? undefined : { id: personaId, status: (findPersona(catalog, personaId)?.status ?? "unknown") };
+    const unvetted = [
+        ...(jobLink !== undefined && jobLink.status !== "approved" ? [`job:${jobLink.id} (${jobLink.status})`] : []),
+        ...(personaLink !== undefined && personaLink.status !== "approved" ? [`persona:${personaLink.id} (${personaLink.status})`] : []),
+    ];
+    const needsReReview = [];
+    if (j.promoted) {
+        if (j.changedSinceApproval)
+            needsReReview.push("the Journey changed since its approval");
+        if (jobLink?.status === "stale")
+            needsReReview.push(`its job '${jobLink.id}' changed since that job's approval`);
+        if (personaLink?.status === "stale")
+            needsReReview.push(`its persona '${personaLink.id}' changed since that persona's approval`);
+    }
+    return {
+        linked: jobLink !== undefined || personaLink !== undefined,
+        ...(jobLink === undefined ? {} : { job: jobLink }),
+        ...(personaLink === undefined ? {} : { persona: personaLink }),
+        unvetted,
+        needsReReview,
+    };
+}
+// ── Writing an approval back ──────────────────────────────────────────────────────────────────
+/** #433: records a persona's approval in personas.json, on the same entry (a bare path entry becomes `{storageState, approval}`). */
+export async function writePersonaApproval(file, id, approval) {
+    const raw = await readJsonFile(file);
+    const entry = rawPersonas(raw, file).find((p) => p.id === id);
+    if (entry === undefined)
+        throw new UnknownCatalogItemError("persona", `unknown persona '${id}' in ${file}`);
+    const record = CatalogApprovalSchema.parse(approval);
+    let next;
+    if (entry.slot.form === "list") {
+        const list = [...(personaList(raw) ?? [])];
+        list[entry.slot.index] = { ...list[entry.slot.index], approval: record };
+        next = Array.isArray(raw) ? list : { ...raw, personas: list };
+    }
+    else {
+        const map = raw;
+        const value = map[entry.slot.key];
+        next = { ...map, [entry.slot.key]: typeof value === "string" ? { storageState: value, approval: record } : { ...value, approval: record } };
+    }
+    await writeJsonFile(file, next);
+}
+/** #433: records a job's approval in its jobs file. */
+export async function writeJobApproval(file, id, approval) {
+    const raw = await readJsonFile(file);
+    const list = [...jobList(raw, file)];
+    const index = list.findIndex((e) => isRecord(e) && e.id === id);
+    if (index === -1)
+        throw new UnknownCatalogItemError("job", `unknown job '${id}' in ${file}`);
+    list[index] = { ...list[index], approval: CatalogApprovalSchema.parse(approval) };
+    // Re-validated before writing: an approval is never written into a job the schema refuses.
+    catalogJob(list[index], index, file);
+    await writeJsonFile(file, Array.isArray(raw) ? list : { ...raw, jobs: list });
+}
+//# sourceMappingURL=catalog.js.map

package/dist/catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../src/catalog.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EACL,aAAa,EACb,qBAAqB,EACrB,cAAc,EACd,SAAS,EACT,cAAc,GAOf,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD;;;;;;;;;;;;;;;;;GAiBG;AAEH,MAAM,CAAC,MAAM,aAAa,GAAG,eAAe,CAAC;AAC7C,MAAM,CAAC,MAAM,SAAS,GAAG,WAAW,CAAC;AACrC,sFAAsF;AACtF,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;AAE9D,gGAAgG;AAChG,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IACjC,IAAI,GAAG,iBAAiB,CAAC;CACnC;AAED,sEAAsE;AACtE,MAAM,OAAO,uBAAwB,SAAQ,KAAK;IAErC;IADX,YACW,IAAuB,EAChC,OAAe;QAEf,KAAK,CAAC,OAAO,CAAC,CAAC;QAHN,SAAI,GAAJ,IAAI,CAAmB;IAIlC,CAAC;IACD,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,eAAe,CAAC;IACzE,CAAC;CACF;AAqDD,SAAS,QAAQ,CAAC,QAAqC,EAAE,IAAY;IACnE,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,OAAO,CAAC;IAC3C,OAAO,QAAQ,CAAC,WAAW,KAAK,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC;AAC9D,CAAC;AAED,SAAS,QAAQ,CAAC,CAAU;IAC1B,OAAO,CAAC,KAAK,IAAI,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AAClE,CAAC;AAED,KAAK,UAAU,YAAY,CAAC,IAAY;IACtC,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACzC,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAY,CAAC;IACpC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,iBAAiB,CAAC,GAAG,IAAI,uBAAuB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChH,CAAC;AACH,CAAC;AAED,KAAK,UAAU,aAAa,CAAC,IAAY,EAAE,KAAc;IACvD,MAAM,SAAS,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;AAC/D,CAAC;AAED,iGAAiG;AAEjG,sGAAsG;AACtG,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC,CAAC;AAWxD,SAAS,WAAW,CAAC,GAAY;IAC/B,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC;IACnC,IAAI,QAAQ,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC;QAAE,OAAO,GAAG,CAAC,QAAQ,CAAC;IACtE,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,WAAW,CAAC,GAAY,EAAE,IAAY;IAC7C,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;IAC9B,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAClB,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;YAC/B,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;gBAAE,MAAM,IAAI,iBAAiB,CAAC,GAAG,IAAI,WAAW,KAAK,wCAAwC,CAAC,CAAC;YACnH,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;YACpC,IAAI,OAAO,IAAI,KAAK,QAAQ;gBAAE,MAAM,IAAI,iBAAiB,CAAC,GAAG,IAAI,WAAW,KAAK,kCAAkC,CAAC,CAAC;YACrH,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,IAAI,KAAK,CAAC,EAAE,KAAK,SAAS,IAAI,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,EAAE,EAAE,CAAC;gBAClF,MAAM,IAAI,iBAAiB,CAAC,GAAG,IAAI,WAAW,KAAK,oBAAoB,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,mBAAmB,CAAC,CAAC;YAC7J,CAAC;YACD,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,MAAM,EAAE,GAAG,KAAK,CAAC;YAC9C,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC;QAC7D,CAAC,CAAC,CAAC;IACL,CAAC;IACD,IAAI,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAClB,OAAO,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE;YAC7C,IAAI,OAAO,KAAK,KAAK,QAAQ;gBAAE,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,CAAC;YAC9G,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;gBAAE,MAAM,IAAI,iBAAiB,CAAC,GAAG,IAAI,KAAK,EAAE,gDAAgD,CAAC,CAAC;YAClH,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,GAAG,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,CAAC;QACtE,CAAC,CAAC,CAAC;IACL,CAAC;IACD,MAAM,IAAI,iBAAiB,CAAC,GAAG,IAAI,4CAA4C,CAAC,CAAC;AACnF,CAAC;AAED,SAAS,cAAc,CAAC,CAAa,EAAE,IAAY;IACjD,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QAAE,MAAM,IAAI,iBAAiB,CAAC,GAAG,IAAI,gBAAgB,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,wDAAwD,CAAC,CAAC;IAChK,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9D,IAAI,WAAW,KAAK,SAAS,IAAI,CAAC,OAAO,WAAW,KAAK,QAAQ,IAAI,WAAW,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC;QAChG,MAAM,IAAI,iBAAiB,CAAC,GAAG,IAAI,aAAa,CAAC,CAAC,EAAE,sDAAsD,CAAC,CAAC;IAC9G,CAAC;IACD,IAAI,IAAI,KAAK,SAAS,IAAI,CAAC,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC;QAAE,MAAM,IAAI,iBAAiB,CAAC,GAAG,IAAI,aAAa,CAAC,CAAC,EAAE,8CAA8C,CAAC,CAAC;IAC/K,IAAI,QAAqC,CAAC;IAC1C,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;QAC9B,MAAM,MAAM,GAAG,qBAAqB,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;QAC5D,IAAI,CAAC,MAAM,CAAC,OAAO;YAAE,MAAM,IAAI,iBAAiB,CAAC,GAAG,IAAI,aAAa,CAAC,CAAC,EAAE,8CAA8C,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAChL,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC;IACzB,CAAC;IACD,MAAM,IAAI,GAAG,kBAAkB,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC;IAChD,OAAO;QACL,EAAE,EAAE,CAAC,CAAC,EAAE;QACR,GAAG,CAAC,OAAO,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3D,GAAG,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7C,eAAe,EAAE,OAAO,CAAC,CAAC,MAAM,CAAC,YAAY,KAAK,QAAQ;QAC1D,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,KAAK,SAAS;QACtC,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC;QAC/C,WAAW,EAAE,IAAI;QACjB,MAAM,EAAE,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC;KACjC,CAAC;AACJ,CAAC;AAED,8GAA8G;AAC9G,MAAM,UAAU,kBAAkB,CAAC,EAAU,EAAE,MAAyC;IACtF,MAAM,SAAS,GAA4B,EAAE,EAAE,EAAE,CAAC;IAClD,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC;QAAE,IAAI,CAAC,KAAK,UAAU,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC;YAAE,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAC5G,OAAO,WAAW,CAAC,SAAS,CAAC,CAAC;AAChC,CAAC;AAED,iGAAiG;AAEjG,SAAS,OAAO,CAAC,GAAY,EAAE,IAAY;IACzC,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC;IACnC,IAAI,QAAQ,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;QAAE,OAAO,GAAG,CAAC,IAAI,CAAC;IAC9D,MAAM,IAAI,iBAAiB,CAAC,GAAG,IAAI,gDAAgD,CAAC,CAAC;AACvF,CAAC;AAED,SAAS,UAAU,CAAC,KAAc,EAAE,KAAa,EAAE,IAAY;IAC7D,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,EAAE,CAAC;IACrH,MAAM,MAAM,GAAG,SAAS,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC1C,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,iBAAiB,CAAC,GAAG,IAAI,KAAK,KAAK,KAAK,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC1K,CAAC;IACD,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC;IACxB,MAAM,IAAI,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;IACjC,OAAO;QACL,EAAE,EAAE,GAAG,CAAC,EAAE;QACV,GAAG;QACH,KAAK,EAAE,cAAc,CAAC,GAAG,CAAC;QAC1B,QAAQ,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;QACtG,GAAG,CAAC,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,EAAE,CAAC;QACjE,WAAW,EAAE,IAAI;QACjB,MAAM,EAAE,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC;KACrC,CAAC;AACJ,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,cAAc,CAAC,GAAQ;IACrC,MAAM,EAAE,QAAQ,EAAE,EAAE,EAAE,GAAG,IAAI,EAAE,GAAG,GAAG,CAAC;IACtC,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC;AAC3B,CAAC;AAED,iGAAiG;AAEjG,MAAM,UAAU,cAAc,CAAC,OAAgB;IAC7C,MAAM,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC;IAC3B,MAAM,IAAI,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;IACxC,OAAO;QACL,EAAE,EAAE,CAAC,CAAC,EAAE;QACR,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,QAAQ,EAAE,CAAC,CAAC,QAAQ;QACpB,OAAO;QACP,GAAG,CAAC,CAAC,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC;QAC9C,GAAG,CAAC,CAAC,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;QAC9D,GAAG,CAAC,CAAC,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC;QAC7D,WAAW,EAAE,IAAI;QACjB,oBAAoB,EAAE,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,QAAQ,KAAK,SAAS,IAAI,CAAC,CAAC,QAAQ,CAAC,WAAW,KAAK,IAAI;KAChG,CAAC;AACJ,CAAC;AAWD;;;;GAIG;AACH,MAAM,OAAO,aAAa;IACK;IAA7B,YAA6B,IAA0B;QAA1B,SAAI,GAAJ,IAAI,CAAsB;IAAG,CAAC;IAE3D,wFAAwF;IACxF,YAAY;QACV,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;IAC1F,CAAC;IAED,yGAAyG;IACzG,QAAQ;QACN,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;QAC/C,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;QACnD,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,gBAAgB,CAAC,CAAC;QAC5D,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3C,MAAM,IAAI,iBAAiB,CAAC,QAAQ,IAAI,QAAQ,MAAM,gCAAgC,IAAI,eAAe,MAAM,gDAAgD,CAAC,CAAC;QACnK,CAAC;QACD,IAAI,UAAU,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC;QAClC,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;IAC5C,CAAC;IAED,KAAK,CAAC,YAAY;QAChB,MAAM,IAAI,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;QACjC,IAAI,IAAI,KAAK,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;QAC5E,MAAM,QAAQ,GAAG,WAAW,CAAC,MAAM,YAAY,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,cAAc,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;QACjG,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;QAC/B,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;YACzB,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;gBAAE,MAAM,IAAI,iBAAiB,CAAC,GAAG,IAAI,aAAa,CAAC,CAAC,EAAE,oBAAoB,CAAC,CAAC;YAC9F,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IAClC,CAAC;IAED,KAAK,CAAC,QAAQ;QACZ,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;QAC7B,IAAI,IAAI,KAAK,IAAI;YAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;QACnD,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,YAAY,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;QAC3F,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;QAC/B,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;YACrB,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;gBAAE,MAAM,IAAI,iBAAiB,CAAC,GAAG,IAAI,SAAS,CAAC,CAAC,EAAE,oBAAoB,CAAC,CAAC;YAC1F,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IAC9B,CAAC;IAED,KAAK,CAAC,YAAY;QAChB,MAAM,KAAK,GAAG,IAAI,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACxD,MAAM,GAAG,GAAqB,EAAE,CAAC;QACjC,KAAK,MAAM,IAAI,IAAI,MAAM,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;YACtC,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACzC,IAAI,OAAO,KAAK,IAAI;gBAAE,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC;QAC1D,CAAC;QACD,OAAO,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACtD,CAAC;IAED,KAAK,CAAC,IAAI;QACR,MAAM,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,QAAQ,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,IAAI,CAAC,QAAQ,EAAE,EAAE,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC;QAC9J,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;IAC7H,CAAC;CACF;AAED,MAAM,UAAU,WAAW,CAAC,OAAgB,EAAE,EAAU;IACtD,OAAO,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,OAAgB,EAAE,EAAU;IAClD,OAAO,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,OAAgB,EAAE,EAAU;IACzD,MAAM,CAAC,GAAG,WAAW,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IACnC,IAAI,CAAC,KAAK,SAAS;QAAE,OAAO,CAAC,CAAC;IAC9B,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,KAAK,IAAI,CAAC,CAAC,CAAC,uEAAuE,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,aAAa,CAAC,aAAa,OAAO,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;IACnQ,MAAM,IAAI,uBAAuB,CAAC,SAAS,EAAE,oBAAoB,EAAE,OAAO,KAAK,EAAE,CAAC,CAAC;AACrF,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,OAAgB,EAAE,EAAU;IACrD,MAAM,CAAC,GAAG,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAC/B,IAAI,CAAC,KAAK,SAAS;QAAE,OAAO,CAAC,CAAC;IAC9B,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,KAAK,IAAI,CAAC,CAAC,CAAC,uEAAuE,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,eAAe,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,QAAQ,aAAa,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;IACtQ,MAAM,IAAI,uBAAuB,CAAC,KAAK,EAAE,gBAAgB,EAAE,OAAO,KAAK,EAAE,CAAC,CAAC;AAC7E,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,kBAAkB,CAAC,OAAgB,EAAE,SAAiB;IACpE,OAAO,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,OAAO,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC;AACjF,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,OAAgB,EAAE,KAAa;IAC5D,OAAO,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,KAAK,CAAC,CAAC;AACzD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,OAAgB,EAAE,CAAiB;IAC/D,MAAM,IAAI,GAAG,CAAC,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC;IACnC,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,EAAE;QAAE,OAAO,SAAS,CAAC;IACxD,IAAI,WAAW,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IAC1D,OAAO,CAAC,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;AAChD,CAAC;AAID,kGAAkG;AAClG,MAAM,UAAU,YAAY,CAAC,OAAgB,EAAE,CAAiB;IAC9D,MAAM,GAAG,GAAG,CAAC,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC;IACtE,MAAM,OAAO,GAAG,CAAC,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,IAAI,SAAS,CAAe,EAAE,GAAG,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC;IACtK,MAAM,SAAS,GAAG,aAAa,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IAC5C,MAAM,WAAW,GAAG,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,WAAW,CAAC,OAAO,EAAE,SAAS,CAAC,EAAE,MAAM,IAAI,SAAS,CAAe,EAAE,CAAC;IAC1J,MAAM,QAAQ,GAAG;QACf,GAAG,CAAC,OAAO,KAAK,SAAS,IAAI,OAAO,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,CAAC,OAAO,OAAO,CAAC,EAAE,KAAK,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5G,GAAG,CAAC,WAAW,KAAK,SAAS,IAAI,WAAW,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,CAAC,WAAW,WAAW,CAAC,EAAE,KAAK,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;KACjI,CAAC;IACF,MAAM,aAAa,GAAa,EAAE,CAAC;IACnC,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC;QACf,IAAI,CAAC,CAAC,oBAAoB;YAAE,aAAa,CAAC,IAAI,CAAC,wCAAwC,CAAC,CAAC;QACzF,IAAI,OAAO,EAAE,MAAM,KAAK,OAAO;YAAE,aAAa,CAAC,IAAI,CAAC,YAAY,OAAO,CAAC,EAAE,qCAAqC,CAAC,CAAC;QACjH,IAAI,WAAW,EAAE,MAAM,KAAK,OAAO;YAAE,aAAa,CAAC,IAAI,CAAC,gBAAgB,WAAW,CAAC,EAAE,yCAAyC,CAAC,CAAC;IACnI,CAAC;IACD,OAAO;QACL,MAAM,EAAE,OAAO,KAAK,SAAS,IAAI,WAAW,KAAK,SAAS;QAC1D,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC;QAClD,GAAG,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC;QAC9D,QAAQ;QACR,aAAa;KACd,CAAC;AACJ,CAAC;AAED,iGAAiG;AAEjG,qIAAqI;AACrI,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,IAAY,EAAE,EAAU,EAAE,QAAyB;IAC5F,MAAM,GAAG,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,CAAC;IACrC,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IAC9D,IAAI,KAAK,KAAK,SAAS;QAAE,MAAM,IAAI,uBAAuB,CAAC,SAAS,EAAE,oBAAoB,EAAE,QAAQ,IAAI,EAAE,CAAC,CAAC;IAC5G,MAAM,MAAM,GAAG,qBAAqB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACrD,IAAI,IAAa,CAAC;IAClB,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAC/B,MAAM,IAAI,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QAC3C,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,GAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAA6B,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;QACtG,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,GAAI,GAA+B,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC7F,CAAC;SAAM,CAAC;QACN,MAAM,GAAG,GAAG,GAA8B,CAAC;QAC3C,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,GAAG,EAAE,GAAG,GAAG,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,GAAI,KAAiC,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,CAAC;IAC3K,CAAC;IACD,MAAM,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;AAClC,CAAC;AAED,uDAAuD;AACvD,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,IAAY,EAAE,EAAU,EAAE,QAAyB;IACxF,MAAM,GAAG,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,CAAC;IACrC,MAAM,IAAI,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC;IACrC,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IAChE,IAAI,KAAK,KAAK,CAAC,CAAC;QAAE,MAAM,IAAI,uBAAuB,CAAC,KAAK,EAAE,gBAAgB,EAAE,QAAQ,IAAI,EAAE,CAAC,CAAC;IAC7F,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,GAAI,IAAI,CAAC,KAAK,CAA6B,EAAE,QAAQ,EAAE,qBAAqB,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;IAC/G,2FAA2F;IAC3F,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;IACrC,MAAM,aAAa,CAAC,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,GAAI,GAA+B,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;AAC7G,CAAC"}

package/dist/change-context.d.ts

@@ -0,0 +1,44 @@
+/**
+ * #453 change-aware self-heal: read a git range read-only and build a `ChangeScope`.
+ * The only IO is `git rev-parse` / `git merge-base` / `git diff`, always via an argv array, never a
+ * shell, and only resolved 40-hex SHAs ever reach `diff`. Raw diff text leaves only as `ChangeEvidence`.
+ */
+import { type ChangeScope } from "@jevitate/runtime";
+/** The caller supplied a syntactically invalid range or note set. */
+export declare class ChangesArgsError extends Error {
+    readonly code: "E_CHANGES_ARGS";
+    constructor(message: string);
+}
+/** Git could not resolve the range, or the diff is too large to surface. */
+export declare class ChangesInputError extends Error {
+    readonly code: "E_CHANGES_INPUT";
+    constructor(message: string);
+}
+/** Runs one read-only git command. Injected in tests; never uses a shell. */
+export type GitExec = (args: string[], opts: {
+    cwd: string;
+    env: NodeJS.ProcessEnv;
+}) => Promise<{
+    stdout: string;
+}>;
+/** The production git runner: argv only, no shell, optional locks and prompts disabled. */
+export declare const execGitReadOnly: GitExec;
+/** Parse `a..b`, `a...b` (symmetric) or a single `X` (meaning `X..HEAD`) into its resolved ends. */
+export declare function parseChangeRange(s: string): {
+    from: string;
+    to: string;
+    symmetric: boolean;
+};
+/** Validate human change notes: at most 20, each 1-2000 chars, no NUL. Returns a copy. */
+export declare function validateChangeNotes(notes: readonly string[]): string[];
+/** Read a git range (and/or notes) and build the `ChangeScope` the healer consumes. */
+export declare function readChangeScope(o: {
+    cwd: string;
+    range?: string;
+    notes: readonly string[];
+    exec?: GitExec;
+    limits?: {
+        maxFiles?: number;
+        maxBytes?: number;
+    };
+}): Promise<ChangeScope>;

package/dist/change-context.js

@@ -0,0 +1,203 @@
+/**
+ * #453 change-aware self-heal: read a git range read-only and build a `ChangeScope`.
+ * The only IO is `git rev-parse` / `git merge-base` / `git diff`, always via an argv array, never a
+ * shell, and only resolved 40-hex SHAs ever reach `diff`. Raw diff text leaves only as `ChangeEvidence`.
+ */
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+import { extractChangeEvidence, isSkippedChangePath } from "@jevitate/runtime";
+const execFileAsync = promisify(execFile);
+const GIT_MAX_BUFFER = 8 * 1024 * 1024;
+const DEFAULT_MAX_FILES = 400;
+const DEFAULT_MAX_BYTES = 4_000_000;
+const MAX_NOTES = 20;
+const MAX_NOTE_LENGTH = 2000;
+const SHA_RE = /^[0-9a-f]{40}$/;
+// The whole range must be ref-safe characters; the separator, if any, is exactly `..` or `...`.
+const RANGE_RE = /^([A-Za-z0-9._\/~^@{}-]{1,200})(?:(\.\.\.?)([A-Za-z0-9._\/~^@{}-]{1,200}))?$/;
+/** The caller supplied a syntactically invalid range or note set. */
+export class ChangesArgsError extends Error {
+    code = "E_CHANGES_ARGS";
+    constructor(message) {
+        super(message);
+        this.name = "ChangesArgsError";
+    }
+}
+/** Git could not resolve the range, or the diff is too large to surface. */
+export class ChangesInputError extends Error {
+    code = "E_CHANGES_INPUT";
+    constructor(message) {
+        super(message);
+        this.name = "ChangesInputError";
+    }
+}
+/** The production git runner: argv only, no shell, optional locks and prompts disabled. */
+export const execGitReadOnly = async (args, opts) => {
+    const result = await execFileAsync("git", args, {
+        cwd: opts.cwd,
+        env: { ...opts.env, GIT_OPTIONAL_LOCKS: "0", GIT_TERMINAL_PROMPT: "0" },
+        maxBuffer: GIT_MAX_BUFFER,
+    });
+    return { stdout: result.stdout };
+};
+/** Parse `a..b`, `a...b` (symmetric) or a single `X` (meaning `X..HEAD`) into its resolved ends. */
+export function parseChangeRange(s) {
+    if (typeof s !== "string" || !RANGE_RE.test(s))
+        throw new ChangesArgsError(`invalid change range: ${JSON.stringify(s)}`);
+    const triple = s.indexOf("...");
+    const double = triple >= 0 ? -1 : s.indexOf("..");
+    let from;
+    let to;
+    let symmetric;
+    if (triple >= 0) {
+        from = s.slice(0, triple);
+        to = s.slice(triple + 3);
+        symmetric = true;
+    }
+    else if (double >= 0) {
+        from = s.slice(0, double);
+        to = s.slice(double + 2);
+        symmetric = false;
+    }
+    else {
+        from = s;
+        to = "HEAD";
+        symmetric = false;
+    }
+    for (const side of [from, to]) {
+        if (side === "" || side.startsWith("-") || side.includes("..") || side.includes("@{-")) {
+            throw new ChangesArgsError(`unsafe change range: ${JSON.stringify(s)}`);
+        }
+    }
+    return { from, to, symmetric };
+}
+/** Validate human change notes: at most 20, each 1-2000 chars, no NUL. Returns a copy. */
+export function validateChangeNotes(notes) {
+    if (notes.length > MAX_NOTES)
+        throw new ChangesArgsError(`at most ${MAX_NOTES} change notes are allowed`);
+    for (const note of notes) {
+        if (note.length < 1 || note.length > MAX_NOTE_LENGTH || note.includes("\u0000")) {
+            throw new ChangesArgsError(`each change note must be 1-${MAX_NOTE_LENGTH} characters and contain no NUL`);
+        }
+    }
+    return [...notes];
+}
+/** Read a git range (and/or notes) and build the `ChangeScope` the healer consumes. */
+export async function readChangeScope(o) {
+    const exec = o.exec ?? execGitReadOnly;
+    const notes = validateChangeNotes(o.notes);
+    const maxFiles = o.limits?.maxFiles ?? DEFAULT_MAX_FILES;
+    const maxBytes = o.limits?.maxBytes ?? DEFAULT_MAX_BYTES;
+    if (o.range === undefined) {
+        return { evidence: extractChangeEvidence("", notes), scanned: { files: 0, hunks: 0, skipped: [] } };
+    }
+    const { from, to, symmetric } = parseChangeRange(o.range);
+    const fromSha = await resolveCommit(exec, o.cwd, from);
+    const toSha = await resolveCommit(exec, o.cwd, to);
+    const baseSha = symmetric ? await mergeBase(exec, o.cwd, fromSha, toSha) : fromSha;
+    const headSha = toSha;
+    assertSha(baseSha);
+    assertSha(headSha);
+    const diffArgs = [
+        "-c",
+        "core.fsmonitor=",
+        "-c",
+        "diff.external=",
+        "diff",
+        "--no-ext-diff",
+        "--no-textconv",
+        "--no-color",
+        "-M",
+        "--unified=0",
+        `${baseSha}..${headSha}`,
+        "--",
+    ];
+    let stdout;
+    try {
+        ({ stdout } = await exec(diffArgs, { cwd: o.cwd, env: process.env }));
+    }
+    catch (error) {
+        throw new ChangesInputError(`git diff failed: ${messageOf(error)}`);
+    }
+    if (Buffer.byteLength(stdout, "utf8") > maxBytes) {
+        throw new ChangesInputError(`change diff exceeds ${maxBytes} bytes`);
+    }
+    const files = countDiffSections(stdout);
+    if (files > maxFiles) {
+        throw new ChangesInputError(`change diff touches ${files} files (max ${maxFiles})`);
+    }
+    return {
+        range: o.range,
+        baseSha,
+        headSha,
+        evidence: extractChangeEvidence(stdout, notes),
+        scanned: { files, hunks: countHunks(stdout), skipped: skippedPaths(stdout) },
+    };
+}
+async function resolveCommit(exec, cwd, rev) {
+    const args = ["rev-parse", "--verify", "--quiet", "--end-of-options", `${rev}^{commit}`];
+    let stdout;
+    try {
+        ({ stdout } = await exec(args, { cwd, env: process.env }));
+    }
+    catch (error) {
+        throw new ChangesInputError(`cannot resolve change revision ${JSON.stringify(rev)}: ${messageOf(error)}`);
+    }
+    const sha = stdout.trim();
+    if (!SHA_RE.test(sha))
+        throw new ChangesInputError(`cannot resolve change revision ${JSON.stringify(rev)}`);
+    return sha;
+}
+async function mergeBase(exec, cwd, shaA, shaB) {
+    let stdout;
+    try {
+        ({ stdout } = await exec(["merge-base", shaA, shaB], { cwd, env: process.env }));
+    }
+    catch (error) {
+        throw new ChangesInputError(`cannot find merge base: ${messageOf(error)}`);
+    }
+    const sha = stdout.trim();
+    if (!SHA_RE.test(sha))
+        throw new ChangesInputError(`cannot find merge base for ${shaA}...${shaB}`);
+    return sha;
+}
+function assertSha(sha) {
+    if (!SHA_RE.test(sha))
+        throw new ChangesInputError(`resolved revision is not a commit SHA: ${JSON.stringify(sha)}`);
+}
+function countDiffSections(diff) {
+    let count = 0;
+    for (const line of diff.split(/\r?\n/))
+        if (line.startsWith("diff --git "))
+            count++;
+    return count;
+}
+function countHunks(diff) {
+    let count = 0;
+    for (const line of diff.split(/\r?\n/))
+        if (line.startsWith("@@ "))
+            count++;
+    return count;
+}
+function skippedPaths(diff) {
+    const paths = [];
+    for (const line of diff.split(/\r?\n/)) {
+        const header = /^diff --git a\/(.*) b\/(.*)$/.exec(line);
+        if (!header)
+            continue;
+        const newPath = unquotePath(header[2]);
+        if (isSkippedChangePath(newPath))
+            paths.push(newPath);
+    }
+    return paths;
+}
+function unquotePath(value) {
+    const trimmed = value.trim();
+    if (trimmed.length >= 2 && trimmed.startsWith('"') && trimmed.endsWith('"'))
+        return trimmed.slice(1, -1);
+    return trimmed;
+}
+function messageOf(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=change-context.js.map

package/dist/change-context.js.map

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

package/dist/check-api.d.ts

@@ -1,5 +1,5 @@
 import { type CheckResult, type RunCheckOptions } from "./check-types.js";
 export { affectedBy } from "./check-plan.js";
 export { BudgetMeter } from "./check-budget.js";
-export { type BudgetReport, CheckAiSetupError, type CheckFinding, type CheckGateways, type CheckItemReport, CheckPreflightError, type CheckResult, type CheckRunners, type ItemKind, type RunCheckOptions } from "./check-types.js";
+export { type BudgetReport, CheckAiSetupError, CheckArgsError, type CheckFinding, type CheckGateways, type CheckItemReport, CheckPreflightError, type CheckResult, type CheckRunners, type ItemKind, type RunCheckOptions } from "./check-types.js";
 export declare function runCheck(opts: RunCheckOptions): Promise<CheckResult>;