@eir-labs/coltrane 0.4.0

package/dist/src/loader.js

@@ -0,0 +1,504 @@
+import { readdirSync, readFileSync, existsSync, statSync } from "node:fs";
+import { join, extname, resolve, isAbsolute, dirname } from "node:path";
+import { createRequire } from "node:module";
+import { defineAgent, composeStandard, CompositionError, GenomeIncompleteError } from "./composition.js";
+import { loadSkillPackage, SkillLoadError } from "./skills.js";
+import { SkillSchema, EvalSchema, DomainTypeSchema } from "./genome_schema.js";
+import { CANONICAL_CORE_TYPES } from "./canonical_core_types.js";
+export class GenomeLoadError extends Error {
+}
+/**
+ * Read every *.json file in `dir`. Files that fail to read or parse are
+ * accumulated into `parse_failures` instead of throwing — the caller (per
+ * Rob #129) decides whether the failure is hard (core types) or soft
+ * (definitions). Filesystem-level errors (readFileSync) still throw because
+ * they indicate the directory itself is unreadable.
+ */
+function readJsonDir(dir) {
+    if (!existsSync(dir))
+        return { files: [], parse_failures: [] };
+    const files = [];
+    const parse_failures = [];
+    for (const name of readdirSync(dir)) {
+        if (extname(name) !== ".json")
+            continue;
+        const path = join(dir, name);
+        if (!statSync(path).isFile())
+            continue;
+        let raw;
+        try {
+            raw = readFileSync(path, "utf-8");
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : String(e);
+            throw new GenomeLoadError(`failed to read ${path}: ${msg}`);
+        }
+        try {
+            files.push({ path, data: JSON.parse(raw) });
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : String(e);
+            parse_failures.push({ path, error: `malformed JSON at ${path}: ${msg}` });
+        }
+    }
+    return { files, parse_failures };
+}
+const REQUIRED_CORE_SLUGS = new Set([
+    "Signal",
+    "Interpretation",
+    "Judgment",
+    "Plan",
+    "Artifact",
+    "Verdict",
+]);
+/**
+ * #241 — an `agent.skill_slugs` entry that resolves to NO skill package is a dangling
+ * reference. `loadGenome` never cross-referenced the two maps, so `load_errors` stayed `[]`
+ * — the pass signal operators are explicitly instructed to trust — while the agent ran
+ * without the discipline it claims to hold.
+ *
+ * SOFT by design: the agent still loads. A non-required dangling binding degrades the prompt,
+ * it does not invalidate the definition; the RUNTIME decides whether it kills a chair, via
+ * `Chair.required_skills`. This only has to break the silence.
+ *
+ * Runs as a POST-PASS, after BOTH maps exist — and again in `loadLayeredGenome` after the
+ * fold, because a base-layer agent may legitimately bind a skill a higher layer supplies.
+ */
+function danglingSkillBindingErrors(agents, skills, pathOf) {
+    const out = [];
+    for (const [slug, agent] of agents) {
+        const missing = (agent.skill_slugs ?? []).filter((s) => !skills.has(s));
+        if (missing.length === 0)
+            continue;
+        out.push({
+            kind: "agent",
+            path: pathOf(slug),
+            slug,
+            error: `dangling skill binding: skill_slugs [${missing.join(", ")}] resolve to no skill package ` +
+                `(define the package under skills/<slug>/ or drop the binding — a bound skill with no package ` +
+                `contributes nothing to the prompt and is invisible in the sealed output)`,
+        });
+    }
+    return out;
+}
+export function loadGenome(root, opts) {
+    const load_errors = [];
+    // core_types/ stays STRICTLY hard-fail: the system can't function without
+    // the six core slugs, so soft-fail would just delay the inevitable crash
+    // somewhere downstream. Parse failures here throw too — same logic.
+    const coreRead = readJsonDir(join(root, "core_types"));
+    const firstCoreFailure = coreRead.parse_failures[0];
+    if (firstCoreFailure) {
+        throw new GenomeLoadError(firstCoreFailure.error);
+    }
+    // Genome extension Phase 1 (docs/genome-extension.md): when a genome root has NO
+    // core_types/ of its own, seed the canonical, immutable 6 the engine owns — so a
+    // downstream consumer boots without hand-copying core substrate. A PARTIAL
+    // core_types/ (some-but-not-all 6) still hard-fails the strict gate below; that's
+    // a corrupt genome, not a fresh one.
+    const coreList = coreRead.files.length > 0
+        ? coreRead.files
+        : CANONICAL_CORE_TYPES.map((data) => ({ path: "<engine-canonical>", data }));
+    const core_types = new Map();
+    const core_type_paths = new Map();
+    for (const { path, data: c } of coreList) {
+        if (core_types.has(c.slug)) {
+            throw new GenomeLoadError(`duplicate core type slug "${c.slug}" in ${path} (first seen in ${core_type_paths.get(c.slug)})`);
+        }
+        core_types.set(c.slug, c);
+        core_type_paths.set(c.slug, path);
+    }
+    const missing = [...REQUIRED_CORE_SLUGS].filter((s) => !core_types.has(s));
+    if (missing.length > 0) {
+        throw new GenomeLoadError(`core_types/ missing required slugs: ${missing.join(", ")}`);
+    }
+    if (core_types.size !== REQUIRED_CORE_SLUGS.size) {
+        const extra = [...core_types.keys()].filter((s) => !REQUIRED_CORE_SLUGS.has(s));
+        throw new GenomeLoadError(`core_types/ contains non-spec slugs: ${extra.join(", ")} (core set is immutable; v2 spec §2)`);
+    }
+    // domain_types/ — past the core gate, soft-fail. One broken type no longer
+    // kills the genome. Each parse-failure becomes a typed LoadError.
+    const domainRead = readJsonDir(join(root, "domain_types"));
+    for (const f of domainRead.parse_failures) {
+        load_errors.push({ kind: "domain_type", path: f.path, slug: null, error: f.error });
+    }
+    const domain_types = new Map();
+    const domain_type_paths = new Map();
+    for (const { path, data: d } of domainRead.files) {
+        try {
+            const key = `${d.slug}@${d.version}`;
+            if (domain_types.has(key)) {
+                throw new Error(`duplicate domain type "${key}" in ${path} (first seen in ${domain_type_paths.get(key)})`);
+            }
+            if (!core_types.has(d.extends)) {
+                throw new Error(`field "extends" references "${d.extends}" which is not a core type`);
+            }
+            // Validate the file shape against the single Zod source (genome_schema.ts). Soft-fail per
+            // the domain_types stance above — a malformed type file is a typed LoadError, not a genome kill.
+            const typeCheck = DomainTypeSchema.safeParse(d);
+            if (!typeCheck.success) {
+                const why = typeCheck.error.issues.map((i) => `${i.path.join(".") || "(root)"}: ${i.message}`).join("; ");
+                throw new Error(`type schema validation failed — ${why}`);
+            }
+            domain_types.set(key, d);
+            domain_type_paths.set(key, path);
+        }
+        catch (e) {
+            load_errors.push({
+                kind: "domain_type",
+                path,
+                slug: typeof d?.slug === "string" ? d.slug : null,
+                error: e instanceof Error ? e.message : String(e),
+            });
+        }
+    }
+    // agents/ — each file is an AgentDef; validated through defineAgent. Soft-fail
+    // per file: a broken agent does not block other agents from loading.
+    const agentRead = readJsonDir(join(root, "agents"));
+    for (const f of agentRead.parse_failures) {
+        load_errors.push({ kind: "agent", path: f.path, slug: null, error: f.error });
+    }
+    const agents = new Map();
+    const agent_paths = new Map();
+    for (const { path, data: def } of agentRead.files) {
+        const slug = typeof def?.slug === "string" ? def.slug : null;
+        try {
+            if (!def.slug || typeof def.slug !== "string") {
+                throw new Error(`missing required "slug" field`);
+            }
+            if (agents.has(def.slug)) {
+                throw new Error(`duplicate agent slug "${def.slug}" (first seen in ${agent_paths.get(def.slug)})`);
+            }
+            agents.set(def.slug, defineAgent(def));
+            agent_paths.set(def.slug, path);
+        }
+        catch (e) {
+            // An agent that fails to VALIDATE — malformed (bad primitives / illegal progression,
+            // CompositionError) OR incomplete against the schema (missing behavioral, the
+            // GenomeIncompleteError) — HARD-fails the whole load. A genome must load cleanly to
+            // run; a standard with a quietly-missing chair would produce silently-wrong outputs.
+            // (Non-validation issues like a duplicate-slug collision still soft-fail below.)
+            if (e instanceof CompositionError || e instanceof GenomeIncompleteError)
+                throw e;
+            load_errors.push({
+                kind: "agent",
+                path,
+                slug,
+                error: e instanceof Error ? e.message : String(e),
+            });
+        }
+    }
+    // standards/ — resolve agent_slugs against loaded agents, then composeStandard.
+    // Soft-fail per file. A standard that references a missing-or-broken agent
+    // gets skipped + recorded; other standards still load.
+    const standardRead = readJsonDir(join(root, "standards"));
+    for (const f of standardRead.parse_failures) {
+        load_errors.push({ kind: "standard", path: f.path, slug: null, error: f.error });
+    }
+    const standards = new Map();
+    const standard_paths = new Map();
+    for (const { path, data: def } of standardRead.files) {
+        const slug = typeof def?.slug === "string" ? def.slug : null;
+        try {
+            if (!def.slug || typeof def.slug !== "string") {
+                throw new Error(`missing required "slug" field`);
+            }
+            if (standards.has(def.slug)) {
+                throw new Error(`duplicate standard slug "${def.slug}" (first seen in ${standard_paths.get(def.slug)})`);
+            }
+            const resolved = [];
+            for (const aslug of def.agent_slugs ?? []) {
+                // Resolve against this layer's own agents first, then agents inherited from
+                // lower layers (genome extension) — so a consumer standard can compose base
+                // players it didn't define itself.
+                const a = agents.get(aslug) ?? opts?.inheritedAgents?.get(aslug);
+                if (!a) {
+                    throw new Error(`field "agent_slugs" references unknown agent "${aslug}"`);
+                }
+                resolved.push(a);
+            }
+            // Pass eval_slugs through to composeStandard when present (added in #128).
+            standards.set(def.slug, composeStandard({
+                slug: def.slug,
+                domain: def.domain,
+                agents: resolved,
+                phases: def.phases,
+                ...(def.eval_slugs ? { eval_slugs: def.eval_slugs } : {}),
+                // #177: the gig contract — types entering from outside the standard (gig / cross-standard).
+                ...(def.input_types ? { input_types: def.input_types } : {}),
+                // #genome-schema: fields the file declares must reach the runtime Standard, not be dropped.
+                ...(def.output_types ? { output_types: def.output_types } : {}),
+                ...(def.max_examine_rounds !== undefined ? { max_examine_rounds: def.max_examine_rounds } : {}),
+                ...(def.description ? { description: def.description } : {}),
+            }));
+            standard_paths.set(def.slug, path);
+        }
+        catch (e) {
+            load_errors.push({
+                kind: "standard",
+                path,
+                slug,
+                error: e instanceof CompositionError || e instanceof Error ? e.message : String(e),
+            });
+        }
+    }
+    // skills/<slug>/ PACKAGE directories are the ONLY skill format (the flat {slug, md} JSON
+    // is retired — no backwards-compat). A genome skill must be a COMPLETE package: meta +
+    // >=1 fixture (its pre-registered contract) + >=1 half (code and/or reasoning). Malformed
+    // (SkillLoadError) OR incomplete HARD-fails the load — a genome must load cleanly to run,
+    // mirroring the agent behavioral gate. Only a duplicate-slug collision soft-fails.
+    const skills = new Map();
+    const skill_paths = new Map();
+    const skillsDir = join(root, "skills");
+    if (existsSync(skillsDir)) {
+        for (const entry of readdirSync(skillsDir, { withFileTypes: true })) {
+            if (!entry.isDirectory())
+                continue;
+            const pkgDir = join(skillsDir, entry.name);
+            if (!existsSync(join(pkgDir, "meta.json")))
+                continue;
+            const pkg = loadSkillPackage(pkgDir); // SkillLoadError (malformed) propagates → hard-fail
+            if (pkg.fixtures.length === 0) {
+                throw new SkillLoadError(`skill ${pkg.meta.slug}: no fixtures — a skill must ship its pre-registered contract (fixtures capture intent at creation; deferring them loses it)`);
+            }
+            if (pkg.codeHash === null && pkg.mdPath === null) {
+                throw new SkillLoadError(`skill ${pkg.meta.slug}: empty — needs a code half (skill.mjs) and/or a reasoning half (skill.md)`);
+            }
+            // Validate the meta against the single Zod source — a malformed declared field (e.g. a
+            // non-numeric determinism_ratio, a malformed permission/network grant) hard-fails the load,
+            // mirroring the package-completeness gate above. Shape only: this does NOT re-impose any
+            // fixtures-pass-to-promote ceremony — promotion strictness is a separate, tunable policy.
+            const metaCheck = SkillSchema.safeParse(pkg.meta);
+            if (!metaCheck.success) {
+                const why = metaCheck.error.issues.map((i) => `${i.path.join(".") || "(root)"}: ${i.message}`).join("; ");
+                throw new SkillLoadError(`skill ${pkg.meta.slug}: meta failed schema validation — ${why}`);
+            }
+            if (skills.has(pkg.meta.slug)) {
+                load_errors.push({ kind: "skill", path: pkgDir, slug: pkg.meta.slug, error: `duplicate skill slug "${pkg.meta.slug}" (first seen in ${skill_paths.get(pkg.meta.slug)})` });
+                continue;
+            }
+            // resolve the reasoning half into the record so the prompt's Skills layer renders it
+            const md = pkg.mdPath ? readFileSync(pkg.mdPath, "utf-8") : undefined;
+            skills.set(pkg.meta.slug, { ...pkg.meta, slug: pkg.meta.slug, package_dir: pkgDir, code_hash: pkg.codeHash, ...(md !== undefined ? { md } : {}) });
+            skill_paths.set(pkg.meta.slug, pkgDir);
+        }
+    }
+    const evalRead = readJsonDir(join(root, "evals"));
+    for (const f of evalRead.parse_failures) {
+        load_errors.push({ kind: "eval", path: f.path, slug: null, error: f.error });
+    }
+    const evals = new Map();
+    const eval_paths = new Map();
+    for (const { path, data: e } of evalRead.files) {
+        const slug = typeof e?.slug === "string" ? e.slug : null;
+        try {
+            if (!e.slug)
+                throw new Error(`required field "slug" is missing`);
+            if (evals.has(e.slug)) {
+                throw new Error(`duplicate eval slug "${e.slug}" (first seen in ${eval_paths.get(e.slug)})`);
+            }
+            // Validate against the single Zod source — the {slug;[k]:unknown} bag is retired, so a
+            // malformed eval (e.g. a non-array non_empty_fields) is caught at load, not at score time.
+            const parsed = EvalSchema.safeParse(e);
+            if (!parsed.success) {
+                const why = parsed.error.issues.map((i) => `${i.path.join(".") || "(root)"}: ${i.message}`).join("; ");
+                throw new Error(`eval schema validation failed — ${why}`);
+            }
+            evals.set(e.slug, parsed.data);
+            eval_paths.set(e.slug, path);
+        }
+        catch (err) {
+            load_errors.push({ kind: "eval", path, slug, error: err instanceof Error ? err.message : String(err) });
+        }
+    }
+    // #241 — post-pass, now that BOTH the agents and skills maps exist.
+    if (!opts?.deferSkillBindingCheck) {
+        load_errors.push(...danglingSkillBindingErrors(agents, skills, (slug) => agent_paths.get(slug) ?? join(root, "agents")));
+    }
+    return { core_types, domain_types, agents, standards, skills, evals, load_errors };
+}
+/**
+ * Resolve a LAYERED genome from a stack of roots, lowest → highest (genome extension
+ * Phase 2 — docs/genome-extension.md). Each root is loaded as a normal genome, then
+ * folded so a higher layer's definitions OVERRIDE a lower layer's by slug, per class.
+ * A consumer extends a base by passing [baseRoot, consumerRoot]: it inherits the base,
+ * adds its own, and overrides where it specializes. `provenance` records which layer
+ * supplied each effective definition. core_types are the immutable 6 (every layer
+ * provides them, seeded or on-disk); the top layer's are used.
+ */
+export function loadLayeredGenome(roots) {
+    if (roots.length === 0) {
+        throw new GenomeLoadError("loadLayeredGenome requires at least one root");
+    }
+    const domain_types = new Map();
+    const agents = new Map();
+    const standards = new Map();
+    const skills = new Map();
+    const evals = new Map();
+    const load_errors = [];
+    const provenance = new Map();
+    let core_types = new Map();
+    const fold = (into, from, root, kind) => {
+        for (const [slug, val] of from) {
+            into.set(slug, val); // higher layer overrides
+            provenance.set(`${kind}:${slug}`, root);
+        }
+    };
+    for (const root of roots) {
+        // Each layer loaded normally (core types seeded), with the agents accumulated
+        // from lower layers passed in — so this layer's standards can compose them.
+        // #241 — the skill-binding check is deferred to the post-fold pass below: a BASE agent
+        // may legitimately bind a skill a HIGHER layer supplies, so per-layer it would report a
+        // dangle that the resolved genome does not have.
+        const layer = loadGenome(root, { inheritedAgents: agents, deferSkillBindingCheck: true });
+        core_types = layer.core_types; // immutable 6 — top layer's (all identical)
+        fold(domain_types, layer.domain_types, root, "domain_type");
+        fold(agents, layer.agents, root, "agent");
+        fold(standards, layer.standards, root, "standard");
+        fold(skills, layer.skills, root, "skill");
+        fold(evals, layer.evals, root, "eval");
+        for (const e of layer.load_errors)
+            load_errors.push(e);
+    }
+    // #241 — the post-fold pass. Reported once, against the resolved genome, not once per layer.
+    load_errors.push(...danglingSkillBindingErrors(agents, skills, (slug) => {
+        const layerRoot = provenance.get(`agent:${slug}`);
+        return layerRoot ? join(layerRoot, "agents") : "";
+    }));
+    return { core_types, domain_types, agents, standards, skills, evals, load_errors, provenance };
+}
+/**
+ * Manifest-aware genome load (genome extension Phase 2 — opt-in). A genome root may
+ * declare the base(s) it extends in a `genome.json` manifest: `{ "extends": [<path>] }`
+ * (absolute, or relative to that root). resolveGenome walks the extends chain, flattens
+ * it to a layer stack (bases first, this root last, deduped + cycle-guarded), and resolves
+ * it via loadLayeredGenome. No manifest → a plain single-root load. This is what the
+ * running server (bootstrapServerDeps) calls, so a downstream consumer's declared base
+ * is honored automatically.
+ */
+export function resolveGenome(root) {
+    const { roots, pinErrors } = resolveExtendsChain(root);
+    const genome = roots.length === 1 ? loadGenome(root) : loadLayeredGenome(roots);
+    if (pinErrors.length === 0)
+        return genome;
+    return { ...genome, load_errors: [...genome.load_errors, ...pinErrors] };
+}
+export function genomeCascadeCheck(consumerRoot, fromBase, toBase) {
+    const consumerReal = resolve(consumerRoot);
+    const consumerLayerErrors = (base) => loadLayeredGenome([base, consumerRoot]).load_errors.filter((e) => resolve(e.path).startsWith(consumerReal));
+    const key = (e) => `${e.kind}:${e.slug ?? ""}:${e.error}`;
+    const fromErrs = consumerLayerErrors(fromBase);
+    const toErrs = consumerLayerErrors(toBase);
+    const fromKeys = new Set(fromErrs.map(key));
+    const toKeys = new Set(toErrs.map(key));
+    return {
+        broken: toErrs.filter((e) => !fromKeys.has(key(e))),
+        healed: fromErrs.filter((e) => !toKeys.has(key(e))),
+    };
+}
+function readGenomeManifest(root, manifestErrors) {
+    const p = join(root, "genome.json");
+    if (!existsSync(p))
+        return [];
+    let raw;
+    try {
+        raw = readFileSync(p, "utf-8");
+    }
+    catch (e) {
+        manifestErrors.push({
+            kind: "manifest", path: p, slug: null,
+            error: `cannot read genome manifest: ${e instanceof Error ? e.message : String(e)} (the declared base(s) are NOT loaded)`,
+        });
+        return [];
+    }
+    try {
+        const data = JSON.parse(raw);
+        return Array.isArray(data.extends) ? data.extends.filter((e) => typeof e === "string") : [];
+    }
+    catch (e) {
+        // #247 — this used to `return []` silently, which UN-EXTENDS the genome: every inherited
+        // agent, standard, skill and type vanishes. The operator then gets a cascade of
+        // `references unknown agent "…"` errors pointing at files that are perfectly correct —
+        // the root cause destroyed and the symptom relocated. The manifest LoadError channel for
+        // exactly this class already existed (resolveExtendsEntry uses it for pin errors); this
+        // branch simply didn't use it. Still SOFT — one bad manifest is not a crash.
+        manifestErrors.push({
+            kind: "manifest", path: p, slug: null,
+            error: `malformed genome manifest — ${e instanceof Error ? e.message : String(e)} ` +
+                `(the declared base(s) are NOT loaded; every inherited definition is missing until this file parses, ` +
+                `so treat any "references unknown …" errors below as downstream of this one)`,
+        });
+        return [];
+    }
+}
+function resolveExtendsChain(root) {
+    const ordered = [];
+    const pinErrors = [];
+    const done = new Set();
+    const onStack = new Set();
+    const visit = (r) => {
+        const real = resolve(r);
+        if (done.has(real))
+            return;
+        if (onStack.has(real))
+            throw new GenomeLoadError(`genome extends cycle detected at ${real}`);
+        onStack.add(real);
+        for (const spec of readGenomeManifest(real, pinErrors)) {
+            const resolved = resolveExtendsEntry(spec, real, pinErrors);
+            if (resolved)
+                visit(resolved);
+        }
+        onStack.delete(real);
+        done.add(real);
+        ordered.push(real); // post-order: bases land before the root that extends them
+    };
+    visit(root);
+    return { roots: ordered, pinErrors };
+}
+// Split a package spec into name + optional version pin. Handles scoped names:
+//   "@scope/pkg@1.2.3" → { name: "@scope/pkg", version: "1.2.3" }
+//   "@scope/pkg"       → { name: "@scope/pkg" }
+//   "pkg@1.2.3"        → { name: "pkg", version: "1.2.3" }
+function parsePackageSpec(spec) {
+    const slash = spec.startsWith("@") ? spec.indexOf("/") : 0;
+    const at = spec.indexOf("@", slash + 1);
+    return at > 0 ? { name: spec.slice(0, at), version: spec.slice(at + 1) } : { name: spec };
+}
+// Resolve one `extends` entry to a genome root. A path (./ , / , absolute) resolves
+// relative to the declaring root. Anything else is an npm package spec
+// (`@scope/pkg[@version]`): resolve the installed package's dir from the declaring
+// root's node_modules; if a version was pinned, warn (manifest load_error) when the
+// installed version differs — the pin records "validated against vX", so a mismatch
+// means re-run the cascade and re-pin. Returns null (with a recorded error) if the
+// package can't be resolved.
+function resolveExtendsEntry(spec, fromRoot, pinErrors) {
+    if (spec.startsWith(".") || isAbsolute(spec) || spec.startsWith("/")) {
+        return isAbsolute(spec) ? spec : join(fromRoot, spec);
+    }
+    const { name, version } = parsePackageSpec(spec);
+    const manifestPath = join(fromRoot, "genome.json");
+    try {
+        const req = createRequire(join(fromRoot, "package.json"));
+        const pkgJsonPath = req.resolve(`${name}/package.json`);
+        const installed = JSON.parse(readFileSync(pkgJsonPath, "utf-8"));
+        if (version && installed.version && version !== installed.version) {
+            pinErrors.push({
+                kind: "manifest",
+                path: manifestPath,
+                slug: name,
+                error: `extends: base "${name}" pinned to ${version} but ${installed.version} is installed — re-run cascade + re-pin`,
+            });
+        }
+        return dirname(pkgJsonPath);
+    }
+    catch {
+        pinErrors.push({
+            kind: "manifest",
+            path: manifestPath,
+            slug: name,
+            error: `extends: cannot resolve base package "${name}" from ${fromRoot} (is it installed?)`,
+        });
+        return null;
+    }
+}
+//# sourceMappingURL=loader.js.map

package/dist/src/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../src/loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,QAAQ,EAA4B,MAAM,SAAS,CAAC;AACpG,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACxE,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,gBAAgB,EAAE,qBAAqB,EAA2D,MAAM,kBAAkB,CAAC;AAClK,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,gBAAgB,EAA4D,MAAM,oBAAoB,CAAC;AAEzI,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAyEjE,MAAM,OAAO,eAAgB,SAAQ,KAAK;CAAG;AAK7C;;;;;;GAMG;AACH,SAAS,WAAW,CAAI,GAAW;IACjC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,cAAc,EAAE,EAAE,EAAE,CAAC;IAC/D,MAAM,KAAK,GAAwB,EAAE,CAAC;IACtC,MAAM,cAAc,GAAmB,EAAE,CAAC;IAC1C,KAAK,MAAM,IAAI,IAAI,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC;QACpC,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,OAAO;YAAE,SAAS;QACxC,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAC7B,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE;YAAE,SAAS;QACvC,IAAI,GAAW,CAAC;QAChB,IAAI,CAAC;YACH,GAAG,GAAG,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACpC,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,GAAG,GAAG,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YACvD,MAAM,IAAI,eAAe,CAAC,kBAAkB,IAAI,KAAK,GAAG,EAAE,CAAC,CAAC;QAC9D,CAAC;QACD,IAAI,CAAC;YACH,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAM,EAAE,CAAC,CAAC;QACnD,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,GAAG,GAAG,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YACvD,cAAc,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,qBAAqB,IAAI,KAAK,GAAG,EAAE,EAAE,CAAC,CAAC;QAC5E,CAAC;IACH,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC;AACnC,CAAC;AAED,MAAM,mBAAmB,GAAG,IAAI,GAAG,CAAC;IAClC,QAAQ;IACR,gBAAgB;IAChB,UAAU;IACV,MAAM;IACN,UAAU;IACV,SAAS;CACV,CAAC,CAAC;AAEH;;;;;;;;;;;;GAYG;AACH,SAAS,0BAA0B,CACjC,MAAkC,EAClC,MAAoC,EACpC,MAAqC;IAErC,MAAM,GAAG,GAAgB,EAAE,CAAC;IAC5B,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,EAAE,CAAC;QACnC,MAAM,OAAO,GAAG,CAAC,KAAK,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACxE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QACnC,GAAG,CAAC,IAAI,CAAC;YACP,IAAI,EAAE,OAAO;YACb,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC;YAClB,IAAI;YACJ,KAAK,EACH,wCAAwC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,gCAAgC;gBAC1F,+FAA+F;gBAC/F,0EAA0E;SAC7E,CAAC,CAAC;IACL,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,UAAU,CACxB,IAAY,EACZ,IAKC;IAED,MAAM,WAAW,GAAgB,EAAE,CAAC;IAEpC,0EAA0E;IAC1E,yEAAyE;IACzE,oEAAoE;IACpE,MAAM,QAAQ,GAAG,WAAW,CAAiB,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC;IACvE,MAAM,gBAAgB,GAAG,QAAQ,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;IACpD,IAAI,gBAAgB,EAAE,CAAC;QACrB,MAAM,IAAI,eAAe,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;IACpD,CAAC;IACD,iFAAiF;IACjF,iFAAiF;IACjF,2EAA2E;IAC3E,kFAAkF;IAClF,qCAAqC;IACrC,MAAM,QAAQ,GACZ,QAAQ,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC;QACvB,CAAC,CAAC,QAAQ,CAAC,KAAK;QAChB,CAAC,CAAC,oBAAoB,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,oBAAoB,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAEjF,MAAM,UAAU,GAAG,IAAI,GAAG,EAA0B,CAAC;IACrD,MAAM,eAAe,GAAG,IAAI,GAAG,EAAkB,CAAC;IAClD,KAAK,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,QAAQ,EAAE,CAAC;QACzC,IAAI,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3B,MAAM,IAAI,eAAe,CACvB,6BAA6B,CAAC,CAAC,IAAI,QAAQ,IAAI,mBAAmB,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CACjG,CAAC;QACJ,CAAC;QACD,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QAC1B,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACpC,CAAC;IAED,MAAM,OAAO,GAAG,CAAC,GAAG,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3E,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,eAAe,CACvB,uCAAuC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC5D,CAAC;IACJ,CAAC;IACD,IAAI,UAAU,CAAC,IAAI,KAAK,mBAAmB,CAAC,IAAI,EAAE,CAAC;QACjD,MAAM,KAAK,GAAG,CAAC,GAAG,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAChF,MAAM,IAAI,eAAe,CACvB,wCAAwC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,sCAAsC,CAC/F,CAAC;IACJ,CAAC;IAED,2EAA2E;IAC3E,kEAAkE;IAClE,MAAM,UAAU,GAAG,WAAW,CAAmB,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC;IAC7E,KAAK,MAAM,CAAC,IAAI,UAAU,CAAC,cAAc,EAAE,CAAC;QAC1C,WAAW,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;IACtF,CAAC;IACD,MAAM,YAAY,GAAG,IAAI,GAAG,EAA4B,CAAC;IACzD,MAAM,iBAAiB,GAAG,IAAI,GAAG,EAAkB,CAAC;IACpD,KAAK,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,UAAU,CAAC,KAAK,EAAE,CAAC;QACjD,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;YACrC,IAAI,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC1B,MAAM,IAAI,KAAK,CACb,0BAA0B,GAAG,QAAQ,IAAI,mBAAmB,iBAAiB,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAC1F,CAAC;YACJ,CAAC;YACD,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC/B,MAAM,IAAI,KAAK,CACb,+BAA+B,CAAC,CAAC,OAAO,4BAA4B,CACrE,CAAC;YACJ,CAAC;YACD,0FAA0F;YAC1F,iGAAiG;YACjG,MAAM,SAAS,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;YAChD,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;gBACvB,MAAM,GAAG,GAAG,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,QAAQ,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAC1G,MAAM,IAAI,KAAK,CAAC,mCAAmC,GAAG,EAAE,CAAC,CAAC;YAC5D,CAAC;YACD,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;YACzB,iBAAiB,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QACnC,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,WAAW,CAAC,IAAI,CAAC;gBACf,IAAI,EAAE,aAAa;gBACnB,IAAI;gBACJ,IAAI,EAAE,OAAO,CAAC,EAAE,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI;gBACjD,KAAK,EAAE,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;aAClD,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,+EAA+E;IAC/E,qEAAqE;IACrE,MAAM,SAAS,GAAG,WAAW,CAAe,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC;IAClE,KAAK,MAAM,CAAC,IAAI,SAAS,CAAC,cAAc,EAAE,CAAC;QACzC,WAAW,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;IAChF,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,GAAG,EAAiB,CAAC;IACxC,MAAM,WAAW,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC9C,KAAK,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,SAAS,CAAC,KAAK,EAAE,CAAC;QAClD,MAAM,IAAI,GAAG,OAAO,GAAG,EAAE,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;QAC7D,IAAI,CAAC;YACH,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAC9C,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;YACnD,CAAC;YACD,IAAI,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBACzB,MAAM,IAAI,KAAK,CACb,yBAAyB,GAAG,CAAC,IAAI,oBAAoB,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAClF,CAAC;YACJ,CAAC;YACD,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC;YACvC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAClC,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,qFAAqF;YACrF,8EAA8E;YAC9E,oFAAoF;YACpF,qFAAqF;YACrF,iFAAiF;YACjF,IAAI,CAAC,YAAY,gBAAgB,IAAI,CAAC,YAAY,qBAAqB;gBAAE,MAAM,CAAC,CAAC;YACjF,WAAW,CAAC,IAAI,CAAC;gBACf,IAAI,EAAE,OAAO;gBACb,IAAI;gBACJ,IAAI;gBACJ,KAAK,EAAE,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;aAClD,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,gFAAgF;IAChF,2EAA2E;IAC3E,uDAAuD;IACvD,MAAM,YAAY,GAAG,WAAW,CAAkB,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC;IAC3E,KAAK,MAAM,CAAC,IAAI,YAAY,CAAC,cAAc,EAAE,CAAC;QAC5C,WAAW,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;IACnF,CAAC;IACD,MAAM,SAAS,GAAG,IAAI,GAAG,EAAoB,CAAC;IAC9C,MAAM,cAAc,GAAG,IAAI,GAAG,EAAkB,CAAC;IACjD,KAAK,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,YAAY,CAAC,KAAK,EAAE,CAAC;QACrD,MAAM,IAAI,GAAG,OAAO,GAAG,EAAE,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;QAC7D,IAAI,CAAC;YACH,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAC9C,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;YACnD,CAAC;YACD,IAAI,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC5B,MAAM,IAAI,KAAK,CACb,4BAA4B,GAAG,CAAC,IAAI,oBAAoB,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CACxF,CAAC;YACJ,CAAC;YACD,MAAM,QAAQ,GAAY,EAAE,CAAC;YAC7B,KAAK,MAAM,KAAK,IAAI,GAAG,CAAC,WAAW,IAAI,EAAE,EAAE,CAAC;gBAC1C,4EAA4E;gBAC5E,4EAA4E;gBAC5E,mCAAmC;gBACnC,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,eAAe,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC;gBACjE,IAAI,CAAC,CAAC,EAAE,CAAC;oBACP,MAAM,IAAI,KAAK,CAAC,iDAAiD,KAAK,GAAG,CAAC,CAAC;gBAC7E,CAAC;gBACD,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACnB,CAAC;YACD,2EAA2E;YAC3E,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,eAAe,CAAC;gBACtC,IAAI,EAAE,GAAG,CAAC,IAAI;gBACd,MAAM,EAAE,GAAG,CAAC,MAAM;gBAClB,MAAM,EAAE,QAAQ;gBAChB,MAAM,EAAE,GAAG,CAAC,MAAM;gBAClB,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACzD,4FAA4F;gBAC5F,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC5D,4FAA4F;gBAC5F,GAAG,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,GAAG,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC/D,GAAG,CAAC,GAAG,CAAC,kBAAkB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,kBAAkB,EAAE,GAAG,CAAC,kBAAkB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC/F,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC7D,CAAC,CAAC,CAAC;YACJ,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACrC,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,WAAW,CAAC,IAAI,CAAC;gBACf,IAAI,EAAE,UAAU;gBAChB,IAAI;gBACJ,IAAI;gBACJ,KAAK,EAAE,CAAC,YAAY,gBAAgB,IAAI,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;aACnF,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,yFAAyF;IACzF,uFAAuF;IACvF,0FAA0F;IAC1F,0FAA0F;IAC1F,mFAAmF;IACnF,MAAM,MAAM,GAAG,IAAI,GAAG,EAAuB,CAAC;IAC9C,MAAM,WAAW,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC9C,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IACvC,IAAI,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC1B,KAAK,MAAM,KAAK,IAAI,WAAW,CAAC,SAAS,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;YACpE,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE;gBAAE,SAAS;YACnC,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YAC3C,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;gBAAE,SAAS;YACrD,MAAM,GAAG,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC,oDAAoD;YAC1F,IAAI,GAAG,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC9B,MAAM,IAAI,cAAc,CAAC,SAAS,GAAG,CAAC,IAAI,CAAC,IAAI,8HAA8H,CAAC,CAAC;YACjL,CAAC;YACD,IAAI,GAAG,CAAC,QAAQ,KAAK,IAAI,IAAI,GAAG,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;gBACjD,MAAM,IAAI,cAAc,CAAC,SAAS,GAAG,CAAC,IAAI,CAAC,IAAI,4EAA4E,CAAC,CAAC;YAC/H,CAAC;YACD,uFAAuF;YACvF,4FAA4F;YAC5F,yFAAyF;YACzF,0FAA0F;YAC1F,MAAM,SAAS,GAAG,WAAW,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAClD,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;gBACvB,MAAM,GAAG,GAAG,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,QAAQ,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAC1G,MAAM,IAAI,cAAc,CAAC,SAAS,GAAG,CAAC,IAAI,CAAC,IAAI,qCAAqC,GAAG,EAAE,CAAC,CAAC;YAC7F,CAAC;YACD,IAAI,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC9B,WAAW,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,yBAAyB,GAAG,CAAC,IAAI,CAAC,IAAI,oBAAoB,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;gBAC3K,SAAS;YACX,CAAC;YACD,qFAAqF;YACrF,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YACtE,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,GAAG,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;YACnJ,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;IAED,MAAM,QAAQ,GAAG,WAAW,CAAa,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;IAC9D,KAAK,MAAM,CAAC,IAAI,QAAQ,CAAC,cAAc,EAAE,CAAC;QACxC,WAAW,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;IAC/E,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,GAAG,EAAsB,CAAC;IAC5C,MAAM,UAAU,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC7C,KAAK,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;QAC/C,MAAM,IAAI,GAAG,OAAO,CAAC,EAAE,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;QACzD,IAAI,CAAC;YACH,IAAI,CAAC,CAAC,CAAC,IAAI;gBAAE,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;YACjE,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;gBACtB,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC,IAAI,oBAAoB,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAC/F,CAAC;YACD,uFAAuF;YACvF,2FAA2F;YAC3F,MAAM,MAAM,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;YACvC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBACpB,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,QAAQ,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACvG,MAAM,IAAI,KAAK,CAAC,mCAAmC,GAAG,EAAE,CAAC,CAAC;YAC5D,CAAC;YACD,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;YAC/B,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC/B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,WAAW,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC1G,CAAC;IACH,CAAC;IAED,oEAAoE;IACpE,IAAI,CAAC,IAAI,EAAE,sBAAsB,EAAE,CAAC;QAClC,WAAW,CAAC,IAAI,CACd,GAAG,0BAA0B,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CACvG,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC;AACrF,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAwB;IACxD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,eAAe,CAAC,8CAA8C,CAAC,CAAC;IAC5E,CAAC;IACD,MAAM,YAAY,GAAG,IAAI,GAAG,EAA4B,CAAC;IACzD,MAAM,MAAM,GAAG,IAAI,GAAG,EAAiB,CAAC;IACxC,MAAM,SAAS,GAAG,IAAI,GAAG,EAAoB,CAAC;IAC9C,MAAM,MAAM,GAAG,IAAI,GAAG,EAAuB,CAAC;IAC9C,MAAM,KAAK,GAAG,IAAI,GAAG,EAAsB,CAAC;IAC5C,MAAM,WAAW,GAAgB,EAAE,CAAC;IACpC,MAAM,UAAU,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC7C,IAAI,UAAU,GAAwC,IAAI,GAAG,EAAE,CAAC;IAEhE,MAAM,IAAI,GAAG,CAAI,IAAoB,EAAE,IAA4B,EAAE,IAAY,EAAE,IAAY,EAAE,EAAE;QACjG,KAAK,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC;YAC/B,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,yBAAyB;YAC9C,UAAU,CAAC,GAAG,CAAC,GAAG,IAAI,IAAI,IAAI,EAAE,EAAE,IAAI,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC,CAAC;IAEF,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,8EAA8E;QAC9E,4EAA4E;QAC5E,uFAAuF;QACvF,wFAAwF;QACxF,iDAAiD;QACjD,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,EAAE,EAAE,eAAe,EAAE,MAAM,EAAE,sBAAsB,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1F,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC,4CAA4C;QAC3E,IAAI,CAAC,YAAY,EAAE,KAAK,CAAC,YAAY,EAAE,IAAI,EAAE,aAAa,CAAC,CAAC;QAC5D,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;QAC1C,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;QACnD,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;QAC1C,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;QACvC,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,WAAW;YAAE,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACzD,CAAC;IAED,6FAA6F;IAC7F,WAAW,CAAC,IAAI,CACd,GAAG,0BAA0B,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;QACrD,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;QAClD,OAAO,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACpD,CAAC,CAAC,CACH,CAAC;IAEF,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC;AACjG,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC;IACvD,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC;IAChF,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC;IAC1C,OAAO,EAAE,GAAG,MAAM,EAAE,WAAW,EAAE,CAAC,GAAG,MAAM,CAAC,WAAW,EAAE,GAAG,SAAS,CAAC,EAAE,CAAC;AAC3E,CAAC;AAgBD,MAAM,UAAU,kBAAkB,CAAC,YAAoB,EAAE,QAAgB,EAAE,MAAc;IACvF,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAC3C,MAAM,mBAAmB,GAAG,CAAC,IAAY,EAAe,EAAE,CACxD,iBAAiB,CAAC,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAC/D,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,YAAY,CAAC,CACzC,CAAC;IACJ,MAAM,GAAG,GAAG,CAAC,CAAY,EAAU,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,IAAI,EAAE,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;IAC7E,MAAM,QAAQ,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IAC/C,MAAM,MAAM,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAC3C,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5C,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;IACxC,OAAO;QACL,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACnD,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;KACpD,CAAC;AACJ,CAAC;AAED,SAAS,kBAAkB,CAAC,IAAY,EAAE,cAA2B;IACnE,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;IACpC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;QAAE,OAAO,EAAE,CAAC;IAC9B,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,YAAY,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IACjC,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,cAAc,CAAC,IAAI,CAAC;YAClB,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI;YACrC,KAAK,EAAE,gCAAgC,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,wCAAwC;SAC1H,CAAC,CAAC;QACH,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAA0B,CAAC;QACtD,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC3G,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,yFAAyF;QACzF,gFAAgF;QAChF,uFAAuF;QACvF,yFAAyF;QACzF,wFAAwF;QACxF,6EAA6E;QAC7E,cAAc,CAAC,IAAI,CAAC;YAClB,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI;YACrC,KAAK,EACH,+BAA+B,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG;gBAC5E,sGAAsG;gBACtG,6EAA6E;SAChF,CAAC,CAAC;QACH,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,SAAS,mBAAmB,CAAC,IAAY;IACvC,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,SAAS,GAAgB,EAAE,CAAC;IAClC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,MAAM,KAAK,GAAG,CAAC,CAAS,EAAQ,EAAE;QAChC,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;QACxB,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,OAAO;QAC3B,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,MAAM,IAAI,eAAe,CAAC,oCAAoC,IAAI,EAAE,CAAC,CAAC;QAC7F,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAClB,KAAK,MAAM,IAAI,IAAI,kBAAkB,CAAC,IAAI,EAAE,SAAS,CAAC,EAAE,CAAC;YACvD,MAAM,QAAQ,GAAG,mBAAmB,CAAC,IAAI,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;YAC5D,IAAI,QAAQ;gBAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;QAChC,CAAC;QACD,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACrB,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACf,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,2DAA2D;IACjF,CAAC,CAAC;IACF,KAAK,CAAC,IAAI,CAAC,CAAC;IACZ,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;AACvC,CAAC;AAED,+EAA+E;AAC/E,kEAAkE;AAClE,gDAAgD;AAChD,2DAA2D;AAC3D,SAAS,gBAAgB,CAAC,IAAY;IACpC,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3D,MAAM,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;IACxC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AAC5F,CAAC;AAED,oFAAoF;AACpF,uEAAuE;AACvE,mFAAmF;AACnF,oFAAoF;AACpF,oFAAoF;AACpF,mFAAmF;AACnF,6BAA6B;AAC7B,SAAS,mBAAmB,CAAC,IAAY,EAAE,QAAgB,EAAE,SAAsB;IACjF,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACrE,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IACxD,CAAC;IACD,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACjD,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;IACnD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,aAAa,CAAC,IAAI,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC,CAAC;QAC1D,MAAM,WAAW,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,IAAI,eAAe,CAAC,CAAC;QACxD,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAyB,CAAC;QACzF,IAAI,OAAO,IAAI,SAAS,CAAC,OAAO,IAAI,OAAO,KAAK,SAAS,CAAC,OAAO,EAAE,CAAC;YAClE,SAAS,CAAC,IAAI,CAAC;gBACb,IAAI,EAAE,UAAU;gBAChB,IAAI,EAAE,YAAY;gBAClB,IAAI,EAAE,IAAI;gBACV,KAAK,EAAE,kBAAkB,IAAI,eAAe,OAAO,QAAQ,SAAS,CAAC,OAAO,yCAAyC;aACtH,CAAC,CAAC;QACL,CAAC;QACD,OAAO,OAAO,CAAC,WAAW,CAAC,CAAC;IAC9B,CAAC;IAAC,MAAM,CAAC;QACP,SAAS,CAAC,IAAI,CAAC;YACb,IAAI,EAAE,UAAU;YAChB,IAAI,EAAE,YAAY;YAClB,IAAI,EAAE,IAAI;YACV,KAAK,EAAE,yCAAyC,IAAI,UAAU,QAAQ,qBAAqB;SAC5F,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/src/mcp.d.ts

@@ -0,0 +1,23 @@
+import type { ChangeClass } from "./type_versioning.js";
+export type MCPCategory = "understand" | "build" | "run" | "improve" | "manage_context";
+export interface MCPToolDef {
+    slug: string;
+    category: MCPCategory;
+    input_schema: object;
+    output_schema: object;
+}
+export declare const MCP_TOOLS: readonly MCPToolDef[];
+export declare const AGENT_STATUS_ORDER: readonly string[];
+export declare const STANDARD_STATUS_ORDER: readonly string[];
+export declare const SKILL_STATUS_ORDER: readonly string[];
+export declare class PromotionError extends Error {
+}
+/** Validate a forward-only transition through the given status chain. Throws on
+ * unknown current/target or any backward/sideways move. Idempotent (current = target). */
+export declare function checkPromotion(current: string, target: string, order: readonly string[]): void;
+export interface ApprovalQuery {
+    slug: string;
+    change_class: ChangeClass | null;
+    target_kind: string | null;
+}
+export declare function requiresApproval(q: ApprovalQuery): boolean;