wabachi 0.2.0 → 0.3.0

package/dist/working-set/seeds.js

@@ -0,0 +1,433 @@
+import { createRepositoryMapping, normalizeRepositoryPath, } from "../architecture/canon/repository-mappings.js";
+/** Version of the bounded task and entrypoint seed contract. */
+export const WORKING_SET_SEED_SCHEMA_VERSION = 1;
+export const WORKING_SET_SEED_KIND = "working-set-seeds";
+export const WORKING_SET_SEED_RESOLUTION_KIND = "working-set-seed-resolution";
+export const WORKING_SET_SEED_KINDS = ["path", "symbol-export", "architecture-component"];
+/** V1 intent metadata is an identifier, not a task description or authority. */
+export const WORKING_SET_TASK_INTENTS = ["implement", "investigate", "verify"];
+export const WORKING_SET_SEED_LIMITS = Object.freeze({
+    maxSeeds: 128,
+    maxTaskIdLength: 128,
+    maxRepositoryFieldLength: 256,
+    maxRevisionLength: 64,
+    maxPathLength: 1024,
+    maxSymbolLength: 512,
+    maxExportNameLength: 512,
+    maxComponentIdLength: 512,
+    maxResolutionCandidates: 64,
+    maxResolutionEvidence: 64,
+});
+const seedKindOrder = Object.freeze({
+    path: 0,
+    "symbol-export": 1,
+    "architecture-component": 2,
+});
+const targetKindOrder = Object.freeze({
+    file: 0,
+    symbol: 1,
+    test: 2,
+});
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function assertAllowedKeys(value, keys, label) {
+    const allowed = new Set(keys);
+    for (const key of Object.keys(value)) {
+        if (!allowed.has(key))
+            throw new TypeError(`${label} contains unknown field: ${key}`);
+    }
+}
+function normalizeIdentifier(value, label, maxLength) {
+    if (typeof value !== "string")
+        throw new TypeError(`${label} must be a string`);
+    const normalized = value.normalize("NFC").trim();
+    if (normalized.length === 0 ||
+        normalized.length > maxLength ||
+        /[\p{White_Space}\p{Cc}\p{Cf}\p{Cs}]/u.test(normalized)) {
+        throw new TypeError(`${label} is malformed or exceeds its bound`);
+    }
+    return normalized;
+}
+function normalizeRepositoryField(value, label) {
+    if (typeof value !== "string")
+        throw new TypeError(`${label} must be a string`);
+    const normalized = value.normalize("NFC");
+    if (normalized.length === 0 ||
+        normalized.length > WORKING_SET_SEED_LIMITS.maxRepositoryFieldLength ||
+        /[\p{White_Space}\p{Cc}\p{Cf}\p{Cs}]/u.test(normalized)) {
+        throw new TypeError(`${label} is malformed or exceeds its bound`);
+    }
+    return normalized;
+}
+function normalizeRevision(value) {
+    const revision = normalizeIdentifier(value, "revision", WORKING_SET_SEED_LIMITS.maxRevisionLength);
+    if (!/^(?:[0-9a-f]{40}|[0-9a-f]{64})$/iu.test(revision)) {
+        throw new TypeError("revision must be a full immutable hexadecimal revision");
+    }
+    return revision.toLowerCase();
+}
+function normalizeRepository(value) {
+    if (!isRecord(value))
+        throw new TypeError("repository must be an object");
+    assertAllowedKeys(value, ["repositoryHost", "repositoryId", "repository"], "repository");
+    return Object.freeze({
+        repositoryHost: normalizeRepositoryField(value.repositoryHost, "repository repositoryHost"),
+        repositoryId: normalizeRepositoryField(value.repositoryId, "repository repositoryId"),
+        repository: normalizeRepositoryField(value.repository, "repository repository"),
+    });
+}
+function normalizeTask(value) {
+    if (!isRecord(value))
+        throw new TypeError("task must be an object");
+    assertAllowedKeys(value, ["taskId", "intent"], "task");
+    if (!WORKING_SET_TASK_INTENTS.includes(value.intent)) {
+        throw new TypeError("task intent is unsupported");
+    }
+    return Object.freeze({
+        taskId: normalizeIdentifier(value.taskId, "task taskId", WORKING_SET_SEED_LIMITS.maxTaskIdLength),
+        intent: value.intent,
+    });
+}
+function normalizeSeedPath(value) {
+    if (typeof value !== "string" || value.length > WORKING_SET_SEED_LIMITS.maxPathLength) {
+        throw new TypeError("seed path is malformed or exceeds its bound");
+    }
+    return normalizeRepositoryPath(value);
+}
+function normalizeSeed(value) {
+    if (!isRecord(value))
+        throw new TypeError("working-set seed must be an object");
+    if (!WORKING_SET_SEED_KINDS.includes(value.kind)) {
+        throw new TypeError("working-set seed kind is unsupported");
+    }
+    switch (value.kind) {
+        case "path":
+            assertAllowedKeys(value, ["kind", "path"], "path seed");
+            return Object.freeze({ kind: "path", path: normalizeSeedPath(value.path) });
+        case "symbol-export":
+            assertAllowedKeys(value, ["kind", "path", "symbol", "exportName"], "symbol-export seed");
+            return Object.freeze({
+                kind: "symbol-export",
+                path: normalizeSeedPath(value.path),
+                symbol: normalizeIdentifier(value.symbol, "symbol-export seed symbol", WORKING_SET_SEED_LIMITS.maxSymbolLength),
+                ...(value.exportName === undefined
+                    ? {}
+                    : {
+                        exportName: normalizeIdentifier(value.exportName, "symbol-export seed exportName", WORKING_SET_SEED_LIMITS.maxExportNameLength),
+                    }),
+            });
+        case "architecture-component":
+            assertAllowedKeys(value, ["kind", "componentId"], "architecture-component seed");
+            return Object.freeze({
+                kind: "architecture-component",
+                componentId: normalizeIdentifier(value.componentId, "architecture-component seed componentId", WORKING_SET_SEED_LIMITS.maxComponentIdLength),
+            });
+    }
+}
+function compareSeeds(left, right) {
+    const kind = seedKindOrder[left.kind] - seedKindOrder[right.kind];
+    if (kind !== 0)
+        return kind;
+    if (left.kind === "path" && right.kind === "path")
+        return left.path.localeCompare(right.path);
+    if (left.kind === "architecture-component" && right.kind === "architecture-component") {
+        return left.componentId.localeCompare(right.componentId);
+    }
+    if (left.kind !== "symbol-export" || right.kind !== "symbol-export")
+        return 0;
+    return (left.path.localeCompare(right.path) ||
+        left.symbol.localeCompare(right.symbol) ||
+        (left.exportName ?? "").localeCompare(right.exportName ?? ""));
+}
+function seedKey(seed) {
+    if (seed.kind === "path")
+        return `path\u0000${seed.path}`;
+    if (seed.kind === "architecture-component")
+        return `architecture-component\u0000${seed.componentId}`;
+    return `symbol-export\u0000${seed.path}\u0000${seed.symbol}\u0000${seed.exportName ?? ""}`;
+}
+function normalizeInput(input, requireVersion) {
+    if (!isRecord(input))
+        throw new TypeError("working-set seed document must be an object");
+    assertAllowedKeys(input, ["kind", "schemaVersion", "task", "repository", "revision", "seeds"], "working-set seed document");
+    if (input.kind !== undefined && input.kind !== WORKING_SET_SEED_KIND) {
+        throw new TypeError("working-set seed document kind is unsupported");
+    }
+    if (requireVersion && input.schemaVersion !== WORKING_SET_SEED_SCHEMA_VERSION) {
+        throw new TypeError("working-set seed schema version is unsupported");
+    }
+    if (input.schemaVersion !== undefined && input.schemaVersion !== WORKING_SET_SEED_SCHEMA_VERSION) {
+        throw new TypeError("working-set seed schema version is unsupported");
+    }
+    if (!Array.isArray(input.seeds))
+        throw new TypeError("working-set seeds must be an array");
+    if (input.seeds.length > WORKING_SET_SEED_LIMITS.maxSeeds) {
+        throw new TypeError("working-set seeds exceed their bound");
+    }
+    const unique = new Map();
+    for (const value of input.seeds) {
+        const seed = normalizeSeed(value);
+        unique.set(seedKey(seed), seed);
+    }
+    const seeds = [...unique.values()].sort(compareSeeds);
+    return Object.freeze({
+        kind: WORKING_SET_SEED_KIND,
+        schemaVersion: WORKING_SET_SEED_SCHEMA_VERSION,
+        task: normalizeTask(input.task),
+        repository: normalizeRepository(input.repository),
+        revision: normalizeRevision(input.revision),
+        seeds: Object.freeze(seeds),
+    });
+}
+/** Creates and canonicalizes a bounded structured task/seed document. */
+export function createWorkingSetSeeds(input) {
+    return normalizeInput(input, false);
+}
+/** Validates a serialized-shape seed document before semantic use. */
+export function validateWorkingSetSeeds(input) {
+    return normalizeInput(input, true);
+}
+function canonicalDocument(document) {
+    return {
+        kind: WORKING_SET_SEED_KIND,
+        schemaVersion: WORKING_SET_SEED_SCHEMA_VERSION,
+        task: { taskId: document.task.taskId, intent: document.task.intent },
+        repository: {
+            repositoryHost: document.repository.repositoryHost,
+            repositoryId: document.repository.repositoryId,
+            repository: document.repository.repository,
+        },
+        revision: document.revision,
+        seeds: document.seeds.map((seed) => {
+            if (seed.kind === "path")
+                return { kind: "path", path: seed.path };
+            if (seed.kind === "architecture-component") {
+                return { kind: "architecture-component", componentId: seed.componentId };
+            }
+            return {
+                kind: "symbol-export",
+                path: seed.path,
+                symbol: seed.symbol,
+                ...(seed.exportName === undefined ? {} : { exportName: seed.exportName }),
+            };
+        }),
+    };
+}
+/** Deterministic JSON serialization of the bounded seed contract. */
+export function serializeWorkingSetSeeds(input) {
+    const document = validateWorkingSetSeeds({ ...createWorkingSetSeeds(input), schemaVersion: 1 });
+    return JSON.stringify(canonicalDocument(document));
+}
+/** Parses JSON and rejects malformed or unsupported seed documents. */
+export function parseWorkingSetSeeds(serialized) {
+    if (typeof serialized !== "string")
+        throw new TypeError("working-set seed serialization must be a string");
+    let parsed;
+    try {
+        parsed = JSON.parse(serialized);
+    }
+    catch {
+        throw new TypeError("working-set seed serialization is malformed");
+    }
+    return validateWorkingSetSeeds(parsed);
+}
+export const decodeWorkingSetSeeds = parseWorkingSetSeeds;
+function compareEvidence(left, right) {
+    return left.artifact.localeCompare(right.artifact) || left.reference.localeCompare(right.reference);
+}
+function canonicalEvidence(references) {
+    const unique = new Map();
+    for (const reference of references)
+        unique.set(`${reference.artifact}\u0000${reference.reference}`, reference);
+    return Object.freeze([...unique.values()]
+        .sort(compareEvidence)
+        .slice(0, WORKING_SET_SEED_LIMITS.maxResolutionEvidence)
+        .map((reference) => Object.freeze({ artifact: reference.artifact, reference: reference.reference })));
+}
+function compareTargets(left, right) {
+    return targetKindOrder[left.kind] - targetKindOrder[right.kind] || left.locator.localeCompare(right.locator);
+}
+function canonicalTargets(targets) {
+    const unique = new Map();
+    for (const target of targets)
+        unique.set(`${target.kind}\u0000${target.locator}`, target);
+    return Object.freeze([...unique.values()]
+        .sort(compareTargets)
+        .map((target) => Object.freeze({ kind: target.kind, locator: target.locator })));
+}
+function unresolved(seed, reason, candidates = [], evidence = []) {
+    return Object.freeze({
+        status: "unresolved",
+        seed,
+        reason,
+        candidates: Object.freeze([...new Set(candidates)].sort().slice(0, WORKING_SET_SEED_LIMITS.maxResolutionCandidates)),
+        evidence: canonicalEvidence(evidence),
+    });
+}
+function resolved(seed, targets, evidence) {
+    const canonical = canonicalTargets(targets);
+    return canonical.length === 0
+        ? unresolved(seed, "missing", [], evidence)
+        : Object.freeze({
+            status: "resolved",
+            seed,
+            targets: canonical,
+            evidence: canonicalEvidence(evidence),
+        });
+}
+function compareRepository(left, right) {
+    return (left.repositoryHost === right.repositoryHost &&
+        left.repositoryId === right.repositoryId &&
+        left.repository === right.repository);
+}
+function normalizeContext(context) {
+    const repository = normalizeRepository(context.repository);
+    const revision = normalizeRevision(context.revision);
+    const resolvedRepository = context.resolvedRepository;
+    if (resolvedRepository === undefined) {
+        return { repository, revision, source: repository.repository, valid: true };
+    }
+    if (typeof resolvedRepository.source !== "string" || resolvedRepository.source.length === 0) {
+        throw new TypeError("resolved repository source is malformed");
+    }
+    const resolvedRevision = normalizeRevision(resolvedRepository.commitSha);
+    return {
+        repository,
+        revision,
+        source: resolvedRepository.source,
+        valid: resolvedRevision === revision,
+    };
+}
+function normalizedMappings(inputs) {
+    if (inputs === undefined)
+        return [];
+    if (!Array.isArray(inputs))
+        throw new TypeError("repository mappings must be an array");
+    return Object.freeze(inputs
+        .map((input) => createRepositoryMapping(input))
+        .sort((left, right) => left.canonId.localeCompare(right.canonId) || JSON.stringify(left).localeCompare(JSON.stringify(right))));
+}
+function mappingEvidence(mapping, kind, locator) {
+    return { artifact: "canon", reference: `${mapping.canonId}:${kind}:${locator}` };
+}
+function symbolLocator(path, symbol, exportName) {
+    return `${path}#${symbol}${exportName === undefined ? "" : `@${exportName}`}`;
+}
+function testLocator(path, selector) {
+    return `${path}#${selector}`;
+}
+function entityMatchesBinding(entity, source, revision) {
+    return entity.repository.source === source && entity.repository.commitSha.toLowerCase() === revision;
+}
+function memberMatchesSymbol(member, seed) {
+    const symbolValues = [member.nativeId, member.name, member.qualifiedName, ...member.aliases].filter((value) => value !== undefined);
+    if (!symbolValues.includes(seed.symbol))
+        return false;
+    if (seed.exportName === undefined)
+        return true;
+    return symbolValues.includes(seed.exportName);
+}
+function resolvePathSeed(seed, mappings) {
+    const evidence = [{ artifact: "repository-binding", reference: `path:${seed.path}` }];
+    for (const mapping of mappings) {
+        for (const path of mapping.paths) {
+            if (path.path === seed.path)
+                evidence.push(mappingEvidence(mapping, "path", path.path));
+        }
+    }
+    return resolved(seed, [{ kind: "file", locator: seed.path }], evidence);
+}
+function resolveSymbolSeed(seed, mappings, correlation, source, revision) {
+    const mappingMatches = mappings.flatMap((mapping) => mapping.symbols
+        .filter((symbol) => symbol.path === seed.path &&
+        symbol.symbol === seed.symbol &&
+        (symbol.exportName ?? "") === (seed.exportName ?? ""))
+        .map((symbol) => ({ mapping, symbol })));
+    const evidence = mappingMatches.map(({ mapping, symbol }) => mappingEvidence(mapping, "symbol", symbolLocator(symbol.path, symbol.symbol, symbol.exportName)));
+    const candidates = new Map();
+    for (const entity of correlation?.canonicalEntities ?? []) {
+        if (!entityMatchesBinding(entity, source, revision))
+            continue;
+        if (entity.members.some((member) => member.path === seed.path && memberMatchesSymbol(member, seed))) {
+            candidates.set(entity.canonicalId, entity);
+        }
+    }
+    const candidateIds = [...candidates.keys()].sort();
+    for (const canonicalId of candidateIds) {
+        evidence.push({ artifact: "provider-correlation", reference: canonicalId });
+    }
+    const hasAmbiguousEntity = [...candidates.values()].some((entity) => entity.status === "ambiguous" || entity.candidateCanonicalIds.length > 0);
+    if (mappingMatches.length > 1 || candidateIds.length > 1 || hasAmbiguousEntity) {
+        return unresolved(seed, "ambiguous", candidateIds, evidence);
+    }
+    if (mappingMatches.length === 0 && candidateIds.length === 0)
+        return unresolved(seed, "missing");
+    const exportName = seed.exportName ?? mappingMatches[0]?.symbol.exportName;
+    return resolved(seed, [{ kind: "symbol", locator: symbolLocator(seed.path, seed.symbol, exportName) }], evidence);
+}
+function resolveComponentSeed(seed, mappings) {
+    const matches = mappings.filter((mapping) => mapping.canonId === seed.componentId);
+    const evidence = matches.map((mapping) => ({
+        artifact: "canon",
+        reference: mapping.canonId,
+    }));
+    if (matches.length === 0)
+        return unresolved(seed, "missing");
+    if (matches.length > 1)
+        return unresolved(seed, "ambiguous", matches.map((mapping) => mapping.canonId), evidence);
+    const [mapping] = matches;
+    const targets = [
+        ...mapping.paths.map((path) => ({ kind: "file", locator: path.path })),
+        ...mapping.symbols.map((symbol) => ({
+            kind: "symbol",
+            locator: symbolLocator(symbol.path, symbol.symbol, symbol.exportName),
+        })),
+        ...mapping.tests.map((test) => ({ kind: "test", locator: testLocator(test.path, test.selector) })),
+    ];
+    return resolved(seed, targets, evidence.concat(mapping.paths.map((path) => mappingEvidence(mapping, "path", path.path)), mapping.symbols.map((symbol) => mappingEvidence(mapping, "symbol", symbolLocator(symbol.path, symbol.symbol, symbol.exportName))), mapping.tests.map((test) => mappingEvidence(mapping, "test", testLocator(test.path, test.selector)))));
+}
+function resolveSeed(seed, mappings, context, correlation) {
+    if (seed.kind === "path")
+        return resolvePathSeed(seed, mappings);
+    if (seed.kind === "symbol-export") {
+        return resolveSymbolSeed(seed, mappings, correlation, context.source, context.revision);
+    }
+    return resolveComponentSeed(seed, mappings);
+}
+/**
+ * Resolves only the supplied bounded seeds against the pinned repository,
+ * existing Canon mappings, and supplied correlation evidence. It never scans
+ * the repository or treats seed metadata as execution authority.
+ */
+export function resolveWorkingSetSeeds(input, context) {
+    const document = createWorkingSetSeeds(input);
+    const normalizedContext = normalizeContext(context);
+    const mappings = normalizedMappings(context.repositoryMappings);
+    const binding = normalizedContext.valid &&
+        compareRepository(document.repository, normalizedContext.repository) &&
+        document.revision === normalizedContext.revision;
+    const resolutions = document.seeds.map((seed) => binding
+        ? resolveSeed(seed, mappings, { source: normalizedContext.source, revision: normalizedContext.revision }, context.correlation)
+        : unresolved(seed, "repository-mismatch"));
+    return Object.freeze({
+        kind: WORKING_SET_SEED_RESOLUTION_KIND,
+        schemaVersion: WORKING_SET_SEED_SCHEMA_VERSION,
+        task: document.task,
+        repository: document.repository,
+        revision: document.revision,
+        binding: binding ? "matched" : "mismatch",
+        resolutions: Object.freeze(resolutions),
+    });
+}
+/** Resolves one already-canonical seed with the same bounded rules. */
+export function resolveWorkingSetSeed(seed, context) {
+    const document = createWorkingSetSeeds({
+        task: { taskId: "single-seed", intent: "investigate" },
+        repository: context.repository,
+        revision: context.revision,
+        seeds: [seed],
+    });
+    return resolveWorkingSetSeeds(document, context).resolutions[0] ?? unresolved(document.seeds[0], "missing");
+}
+//# sourceMappingURL=seeds.js.map

package/dist/working-set/seeds.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"seeds.js","sourceRoot":"","sources":["../../src/working-set/seeds.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EACvB,uBAAuB,GAGxB,MAAM,8CAA8C,CAAC;AAKtD,gEAAgE;AAChE,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAAU,CAAC;AAG1D,MAAM,CAAC,MAAM,qBAAqB,GAAG,mBAA4B,CAAC;AAClE,MAAM,CAAC,MAAM,gCAAgC,GAAG,6BAAsC,CAAC;AAEvF,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,MAAM,EAAE,eAAe,EAAE,wBAAwB,CAAU,CAAC;AAGnG,gFAAgF;AAChF,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,WAAW,EAAE,aAAa,EAAE,QAAQ,CAAU,CAAC;AAGxF,MAAM,CAAC,MAAM,uBAAuB,GAAG,MAAM,CAAC,MAAM,CAAC;IACnD,QAAQ,EAAE,GAAG;IACb,eAAe,EAAE,GAAG;IACpB,wBAAwB,EAAE,GAAG;IAC7B,iBAAiB,EAAE,EAAE;IACrB,aAAa,EAAE,IAAI;IACnB,eAAe,EAAE,GAAG;IACpB,mBAAmB,EAAE,GAAG;IACxB,oBAAoB,EAAE,GAAG;IACzB,uBAAuB,EAAE,EAAE;IAC3B,qBAAqB,EAAE,EAAE;CAC1B,CAAC,CAAC;AAiHH,MAAM,aAAa,GAAiD,MAAM,CAAC,MAAM,CAAC;IAChF,IAAI,EAAE,CAAC;IACP,eAAe,EAAE,CAAC;IAClB,wBAAwB,EAAE,CAAC;CAC5B,CAAC,CAAC;AAEH,MAAM,eAAe,GAA2D,MAAM,CAAC,MAAM,CAAC;IAC5F,IAAI,EAAE,CAAC;IACP,MAAM,EAAE,CAAC;IACT,IAAI,EAAE,CAAC;CACR,CAAC,CAAC;AAEH,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,SAAS,iBAAiB,CAAC,KAA8B,EAAE,IAAuB,EAAE,KAAa;IAC/F,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC;IAC9B,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACrC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,MAAM,IAAI,SAAS,CAAC,GAAG,KAAK,4BAA4B,GAAG,EAAE,CAAC,CAAC;IACxF,CAAC;AACH,CAAC;AAED,SAAS,mBAAmB,CAAC,KAAc,EAAE,KAAa,EAAE,SAAiB;IAC3E,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,MAAM,IAAI,SAAS,CAAC,GAAG,KAAK,mBAAmB,CAAC,CAAC;IAChF,MAAM,UAAU,GAAG,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;IACjD,IACE,UAAU,CAAC,MAAM,KAAK,CAAC;QACvB,UAAU,CAAC,MAAM,GAAG,SAAS;QAC7B,sCAAsC,CAAC,IAAI,CAAC,UAAU,CAAC,EACvD,CAAC;QACD,MAAM,IAAI,SAAS,CAAC,GAAG,KAAK,oCAAoC,CAAC,CAAC;IACpE,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,SAAS,wBAAwB,CAAC,KAAc,EAAE,KAAa;IAC7D,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,MAAM,IAAI,SAAS,CAAC,GAAG,KAAK,mBAAmB,CAAC,CAAC;IAChF,MAAM,UAAU,GAAG,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC1C,IACE,UAAU,CAAC,MAAM,KAAK,CAAC;QACvB,UAAU,CAAC,MAAM,GAAG,uBAAuB,CAAC,wBAAwB;QACpE,sCAAsC,CAAC,IAAI,CAAC,UAAU,CAAC,EACvD,CAAC;QACD,MAAM,IAAI,SAAS,CAAC,GAAG,KAAK,oCAAoC,CAAC,CAAC;IACpE,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAc;IACvC,MAAM,QAAQ,GAAG,mBAAmB,CAAC,KAAK,EAAE,UAAU,EAAE,uBAAuB,CAAC,iBAAiB,CAAC,CAAC;IACnG,IAAI,CAAC,mCAAmC,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QACxD,MAAM,IAAI,SAAS,CAAC,wDAAwD,CAAC,CAAC;IAChF,CAAC;IACD,OAAO,QAAQ,CAAC,WAAW,EAAE,CAAC;AAChC,CAAC;AAED,SAAS,mBAAmB,CAAC,KAAc;IACzC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,MAAM,IAAI,SAAS,CAAC,8BAA8B,CAAC,CAAC;IAC1E,iBAAiB,CAAC,KAAK,EAAE,CAAC,gBAAgB,EAAE,cAAc,EAAE,YAAY,CAAC,EAAE,YAAY,CAAC,CAAC;IACzF,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,cAAc,EAAE,wBAAwB,CAAC,KAAK,CAAC,cAAc,EAAE,2BAA2B,CAAC;QAC3F,YAAY,EAAE,wBAAwB,CAAC,KAAK,CAAC,YAAY,EAAE,yBAAyB,CAAC;QACrF,UAAU,EAAE,wBAAwB,CAAC,KAAK,CAAC,UAAU,EAAE,uBAAuB,CAAC;KAChF,CAAC,CAAC;AACL,CAAC;AAED,SAAS,aAAa,CAAC,KAAc;IACnC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,MAAM,IAAI,SAAS,CAAC,wBAAwB,CAAC,CAAC;IACpE,iBAAiB,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,CAAC;IACvD,IAAI,CAAC,wBAAwB,CAAC,QAAQ,CAAC,KAAK,CAAC,MAA8B,CAAC,EAAE,CAAC;QAC7E,MAAM,IAAI,SAAS,CAAC,4BAA4B,CAAC,CAAC;IACpD,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,MAAM,EAAE,mBAAmB,CAAC,KAAK,CAAC,MAAM,EAAE,aAAa,EAAE,uBAAuB,CAAC,eAAe,CAAC;QACjG,MAAM,EAAE,KAAK,CAAC,MAA8B;KAC7C,CAAC,CAAC;AACL,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAc;IACvC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,uBAAuB,CAAC,aAAa,EAAE,CAAC;QACtF,MAAM,IAAI,SAAS,CAAC,6CAA6C,CAAC,CAAC;IACrE,CAAC;IACD,OAAO,uBAAuB,CAAC,KAAK,CAAC,CAAC;AACxC,CAAC;AAED,SAAS,aAAa,CAAC,KAAc;IACnC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,MAAM,IAAI,SAAS,CAAC,oCAAoC,CAAC,CAAC;IAChF,IAAI,CAAC,sBAAsB,CAAC,QAAQ,CAAC,KAAK,CAAC,IAA0B,CAAC,EAAE,CAAC;QACvE,MAAM,IAAI,SAAS,CAAC,sCAAsC,CAAC,CAAC;IAC9D,CAAC;IAED,QAAQ,KAAK,CAAC,IAA0B,EAAE,CAAC;QACzC,KAAK,MAAM;YACT,iBAAiB,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,CAAC,CAAC;YACxD,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC9E,KAAK,eAAe;YAClB,iBAAiB,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,CAAC,EAAE,oBAAoB,CAAC,CAAC;YACzF,OAAO,MAAM,CAAC,MAAM,CAAC;gBACnB,IAAI,EAAE,eAAe;gBACrB,IAAI,EAAE,iBAAiB,CAAC,KAAK,CAAC,IAAI,CAAC;gBACnC,MAAM,EAAE,mBAAmB,CAAC,KAAK,CAAC,MAAM,EAAE,2BAA2B,EAAE,uBAAuB,CAAC,eAAe,CAAC;gBAC/G,GAAG,CAAC,KAAK,CAAC,UAAU,KAAK,SAAS;oBAChC,CAAC,CAAC,EAAE;oBACJ,CAAC,CAAC;wBACE,UAAU,EAAE,mBAAmB,CAC7B,KAAK,CAAC,UAAU,EAChB,+BAA+B,EAC/B,uBAAuB,CAAC,mBAAmB,CAC5C;qBACF,CAAC;aACP,CAAC,CAAC;QACL,KAAK,wBAAwB;YAC3B,iBAAiB,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,aAAa,CAAC,EAAE,6BAA6B,CAAC,CAAC;YACjF,OAAO,MAAM,CAAC,MAAM,CAAC;gBACnB,IAAI,EAAE,wBAAwB;gBAC9B,WAAW,EAAE,mBAAmB,CAC9B,KAAK,CAAC,WAAW,EACjB,yCAAyC,EACzC,uBAAuB,CAAC,oBAAoB,CAC7C;aACF,CAAC,CAAC;IACP,CAAC;AACH,CAAC;AAED,SAAS,YAAY,CAAC,IAAoB,EAAE,KAAqB;IAC/D,MAAM,IAAI,GAAG,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAClE,IAAI,IAAI,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAC5B,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM;QAAE,OAAO,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC9F,IAAI,IAAI,CAAC,IAAI,KAAK,wBAAwB,IAAI,KAAK,CAAC,IAAI,KAAK,wBAAwB,EAAE,CAAC;QACtF,OAAO,IAAI,CAAC,WAAW,CAAC,aAAa,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IAC3D,CAAC;IACD,IAAI,IAAI,CAAC,IAAI,KAAK,eAAe,IAAI,KAAK,CAAC,IAAI,KAAK,eAAe;QAAE,OAAO,CAAC,CAAC;IAC9E,OAAO,CACL,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC;QACnC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,MAAM,CAAC;QACvC,CAAC,IAAI,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,UAAU,IAAI,EAAE,CAAC,CAC9D,CAAC;AACJ,CAAC;AAED,SAAS,OAAO,CAAC,IAAoB;IACnC,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM;QAAE,OAAO,aAAa,IAAI,CAAC,IAAI,EAAE,CAAC;IAC1D,IAAI,IAAI,CAAC,IAAI,KAAK,wBAAwB;QAAE,OAAO,+BAA+B,IAAI,CAAC,WAAW,EAAE,CAAC;IACrG,OAAO,sBAAsB,IAAI,CAAC,IAAI,SAAS,IAAI,CAAC,MAAM,SAAS,IAAI,CAAC,UAAU,IAAI,EAAE,EAAE,CAAC;AAC7F,CAAC;AAED,SAAS,cAAc,CAAC,KAAc,EAAE,cAAuB;IAC7D,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,MAAM,IAAI,SAAS,CAAC,6CAA6C,CAAC,CAAC;IACzF,iBAAiB,CACf,KAAK,EACL,CAAC,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,OAAO,CAAC,EACpE,2BAA2B,CAC5B,CAAC;IACF,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,IAAI,KAAK,CAAC,IAAI,KAAK,qBAAqB,EAAE,CAAC;QACrE,MAAM,IAAI,SAAS,CAAC,+CAA+C,CAAC,CAAC;IACvE,CAAC;IACD,IAAI,cAAc,IAAI,KAAK,CAAC,aAAa,KAAK,+BAA+B,EAAE,CAAC;QAC9E,MAAM,IAAI,SAAS,CAAC,gDAAgD,CAAC,CAAC;IACxE,CAAC;IACD,IAAI,KAAK,CAAC,aAAa,KAAK,SAAS,IAAI,KAAK,CAAC,aAAa,KAAK,+BAA+B,EAAE,CAAC;QACjG,MAAM,IAAI,SAAS,CAAC,gDAAgD,CAAC,CAAC;IACxE,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC;QAAE,MAAM,IAAI,SAAS,CAAC,oCAAoC,CAAC,CAAC;IAC3F,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,uBAAuB,CAAC,QAAQ,EAAE,CAAC;QAC1D,MAAM,IAAI,SAAS,CAAC,sCAAsC,CAAC,CAAC;IAC9D,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,GAAG,EAA0B,CAAC;IACjD,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAChC,MAAM,IAAI,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;QAClC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC;IAClC,CAAC;IACD,MAAM,KAAK,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACtD,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,IAAI,EAAE,qBAAqB;QAC3B,aAAa,EAAE,+BAA+B;QAC9C,IAAI,EAAE,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC;QAC/B,UAAU,EAAE,mBAAmB,CAAC,KAAK,CAAC,UAAU,CAAC;QACjD,QAAQ,EAAE,iBAAiB,CAAC,KAAK,CAAC,QAAQ,CAAC;QAC3C,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC;KAC5B,CAAC,CAAC;AACL,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,qBAAqB,CAAC,KAAkC;IACtE,OAAO,cAAc,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;AACtC,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,uBAAuB,CAAC,KAAc;IACpD,OAAO,cAAc,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;AACrC,CAAC;AAED,SAAS,iBAAiB,CAAC,QAAgC;IACzD,OAAO;QACL,IAAI,EAAE,qBAAqB;QAC3B,aAAa,EAAE,+BAA+B;QAC9C,IAAI,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE;QACpE,UAAU,EAAE;YACV,cAAc,EAAE,QAAQ,CAAC,UAAU,CAAC,cAAc;YAClD,YAAY,EAAE,QAAQ,CAAC,UAAU,CAAC,YAAY;YAC9C,UAAU,EAAE,QAAQ,CAAC,UAAU,CAAC,UAAU;SAC3C;QACD,QAAQ,EAAE,QAAQ,CAAC,QAAQ;QAC3B,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;YACjC,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM;gBAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;YACnE,IAAI,IAAI,CAAC,IAAI,KAAK,wBAAwB,EAAE,CAAC;gBAC3C,OAAO,EAAE,IAAI,EAAE,wBAAwB,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC;YAC3E,CAAC;YACD,OAAO;gBACL,IAAI,EAAE,eAAe;gBACrB,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,GAAG,CAAC,IAAI,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC;aAC1E,CAAC;QACJ,CAAC,CAAC;KACH,CAAC;AACJ,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,wBAAwB,CAAC,KAA2D;IAClG,MAAM,QAAQ,GAAG,uBAAuB,CAAC,EAAE,GAAG,qBAAqB,CAAC,KAAK,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,CAAC,CAAC;IAChG,OAAO,IAAI,CAAC,SAAS,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC,CAAC;AACrD,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,oBAAoB,CAAC,UAAkB;IACrD,IAAI,OAAO,UAAU,KAAK,QAAQ;QAAE,MAAM,IAAI,SAAS,CAAC,iDAAiD,CAAC,CAAC;IAC3G,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IAClC,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,SAAS,CAAC,6CAA6C,CAAC,CAAC;IACrE,CAAC;IACD,OAAO,uBAAuB,CAAC,MAAM,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,CAAC,MAAM,qBAAqB,GAAG,oBAAoB,CAAC;AAE1D,SAAS,eAAe,CAAC,IAAiC,EAAE,KAAkC;IAC5F,OAAO,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;AACtG,CAAC;AAED,SAAS,iBAAiB,CAAC,UAAkD;IAC3E,MAAM,MAAM,GAAG,IAAI,GAAG,EAAuC,CAAC;IAC9D,KAAK,MAAM,SAAS,IAAI,UAAU;QAAE,MAAM,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,QAAQ,SAAS,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,CAAC,CAAC;IAC/G,OAAO,MAAM,CAAC,MAAM,CAClB,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;SACjB,IAAI,CAAC,eAAe,CAAC;SACrB,KAAK,CAAC,CAAC,EAAE,uBAAuB,CAAC,qBAAqB,CAAC;SACvD,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,SAAS,CAAC,QAAQ,EAAE,SAAS,EAAE,SAAS,CAAC,SAAS,EAAE,CAAC,CAAC,CACvG,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CAAC,IAA0B,EAAE,KAA2B;IAC7E,OAAO,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;AAC/G,CAAC;AAED,SAAS,gBAAgB,CAAC,OAAwC;IAChE,MAAM,MAAM,GAAG,IAAI,GAAG,EAAgC,CAAC;IACvD,KAAK,MAAM,MAAM,IAAI,OAAO;QAAE,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,IAAI,SAAS,MAAM,CAAC,OAAO,EAAE,EAAE,MAAM,CAAC,CAAC;IAC1F,OAAO,MAAM,CAAC,MAAM,CAClB,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;SACjB,IAAI,CAAC,cAAc,CAAC;SACpB,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAClF,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CACjB,IAAoB,EACpB,MAAsC,EACtC,aAAgC,EAAE,EAClC,WAAmD,EAAE;IAErD,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,MAAM,EAAE,YAAY;QACpB,IAAI;QACJ,MAAM;QACN,UAAU,EAAE,MAAM,CAAC,MAAM,CACvB,CAAC,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,uBAAuB,CAAC,uBAAuB,CAAC,CAC1F;QACD,QAAQ,EAAE,iBAAiB,CAAC,QAAQ,CAAC;KACtC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,QAAQ,CACf,IAAoB,EACpB,OAAwC,EACxC,QAAgD;IAEhD,MAAM,SAAS,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAC5C,OAAO,SAAS,CAAC,MAAM,KAAK,CAAC;QAC3B,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,QAAQ,CAAC;QAC3C,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC;YACZ,MAAM,EAAE,UAAU;YAClB,IAAI;YACJ,OAAO,EAAE,SAAS;YAClB,QAAQ,EAAE,iBAAiB,CAAC,QAAQ,CAAC;SACtC,CAAC,CAAC;AACT,CAAC;AAED,SAAS,iBAAiB,CAAC,IAAwB,EAAE,KAAyB;IAC5E,OAAO,CACL,IAAI,CAAC,cAAc,KAAK,KAAK,CAAC,cAAc;QAC5C,IAAI,CAAC,YAAY,KAAK,KAAK,CAAC,YAAY;QACxC,IAAI,CAAC,UAAU,KAAK,KAAK,CAAC,UAAU,CACrC,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB,CAAC,OAAwC;IAMhE,MAAM,UAAU,GAAG,mBAAmB,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAC3D,MAAM,QAAQ,GAAG,iBAAiB,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACrD,MAAM,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IACtD,IAAI,kBAAkB,KAAK,SAAS,EAAE,CAAC;QACrC,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAC,UAAU,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IAC9E,CAAC;IACD,IAAI,OAAO,kBAAkB,CAAC,MAAM,KAAK,QAAQ,IAAI,kBAAkB,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5F,MAAM,IAAI,SAAS,CAAC,yCAAyC,CAAC,CAAC;IACjE,CAAC;IACD,MAAM,gBAAgB,GAAG,iBAAiB,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC;IACzE,OAAO;QACL,UAAU;QACV,QAAQ;QACR,MAAM,EAAE,kBAAkB,CAAC,MAAM;QACjC,KAAK,EAAE,gBAAgB,KAAK,QAAQ;KACrC,CAAC;AACJ,CAAC;AAED,SAAS,kBAAkB,CACzB,MAA2E;IAE3E,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IACpC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;QAAE,MAAM,IAAI,SAAS,CAAC,sCAAsC,CAAC,CAAC;IACxF,OAAO,MAAM,CAAC,MAAM,CAClB,MAAM;SACH,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,uBAAuB,CAAC,KAAK,CAAC,CAAC;SAC9C,IAAI,CACH,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CACd,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CACzG,CACJ,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CAAC,OAA0B,EAAE,IAAY,EAAE,OAAe;IAChF,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,OAAO,IAAI,IAAI,IAAI,OAAO,EAAE,EAAE,CAAC;AACnF,CAAC;AAED,SAAS,aAAa,CAAC,IAAY,EAAE,MAAc,EAAE,UAA8B;IACjF,OAAO,GAAG,IAAI,IAAI,MAAM,GAAG,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,UAAU,EAAE,EAAE,CAAC;AAChF,CAAC;AAED,SAAS,WAAW,CAAC,IAAY,EAAE,QAAgB;IACjD,OAAO,GAAG,IAAI,IAAI,QAAQ,EAAE,CAAC;AAC/B,CAAC;AAED,SAAS,oBAAoB,CAAC,MAAuB,EAAE,MAAc,EAAE,QAAgB;IACrF,OAAO,MAAM,CAAC,UAAU,CAAC,MAAM,KAAK,MAAM,IAAI,MAAM,CAAC,UAAU,CAAC,SAAS,CAAC,WAAW,EAAE,KAAK,QAAQ,CAAC;AACvG,CAAC;AAED,SAAS,mBAAmB,CAAC,MAA6B,EAAE,IAAgC;IAC1F,MAAM,YAAY,GAAG,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,aAAa,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CACjG,CAAC,KAAK,EAAmB,EAAE,CAAC,KAAK,KAAK,SAAS,CAChD,CAAC;IACF,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC;QAAE,OAAO,KAAK,CAAC;IACtD,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IAC/C,OAAO,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;AAChD,CAAC;AAED,SAAS,eAAe,CAAC,IAAwB,EAAE,QAAsC;IACvF,MAAM,QAAQ,GAAkC,CAAC,EAAE,QAAQ,EAAE,oBAAoB,EAAE,SAAS,EAAE,QAAQ,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACrH,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;YACjC,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI;gBAAE,QAAQ,CAAC,IAAI,CAAC,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAC1F,CAAC;IACH,CAAC;IACD,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,QAAQ,CAAC,CAAC;AAC1E,CAAC;AAED,SAAS,iBAAiB,CACxB,IAAgC,EAChC,QAAsC,EACtC,WAA0C,EAC1C,MAAc,EACd,QAAgB;IAEhB,MAAM,cAAc,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAClD,OAAO,CAAC,OAAO;SACZ,MAAM,CACL,CAAC,MAAM,EAAE,EAAE,CACT,MAAM,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI;QACzB,MAAM,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM;QAC7B,CAAC,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,IAAI,EAAE,CAAC,CACxD;SACA,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC,CAC1C,CAAC;IACF,MAAM,QAAQ,GAAkC,cAAc,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,CACzF,eAAe,CAAC,OAAO,EAAE,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC,CACjG,CAAC;IACF,MAAM,UAAU,GAAG,IAAI,GAAG,EAA2B,CAAC;IACtD,KAAK,MAAM,MAAM,IAAI,WAAW,EAAE,iBAAiB,IAAI,EAAE,EAAE,CAAC;QAC1D,IAAI,CAAC,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC;YAAE,SAAS;QAC9D,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,IAAI,mBAAmB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC;YACpG,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC;IACD,MAAM,YAAY,GAAG,CAAC,GAAG,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACnD,KAAK,MAAM,WAAW,IAAI,YAAY,EAAE,CAAC;QACvC,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,sBAAsB,EAAE,SAAS,EAAE,WAAW,EAAE,CAAC,CAAC;IAC9E,CAAC;IAED,MAAM,kBAAkB,GAAG,CAAC,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CACtD,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,KAAK,WAAW,IAAI,MAAM,CAAC,qBAAqB,CAAC,MAAM,GAAG,CAAC,CACrF,CAAC;IACF,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,IAAI,kBAAkB,EAAE,CAAC;QAC/E,OAAO,UAAU,CAAC,IAAI,EAAE,WAAW,EAAE,YAAY,EAAE,QAAQ,CAAC,CAAC;IAC/D,CAAC;IACD,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,UAAU,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IACjG,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,cAAc,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IAC3E,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC,EAAE,CAAC,EAAE,QAAQ,CAAC,CAAC;AACpH,CAAC;AAED,SAAS,oBAAoB,CAC3B,IAAyC,EACzC,QAAsC;IAEtC,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,KAAK,IAAI,CAAC,WAAW,CAAC,CAAC;IACnF,MAAM,QAAQ,GAAkC,OAAO,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QACxE,QAAQ,EAAE,OAAO;QACjB,SAAS,EAAE,OAAO,CAAC,OAAO;KAC3B,CAAC,CAAC,CAAC;IACJ,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,UAAU,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IAC7D,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;QACpB,OAAO,UAAU,CACf,IAAI,EACJ,WAAW,EACX,OAAO,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,EACzC,QAAQ,CACT,CAAC;IAEJ,MAAM,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;IAC1B,MAAM,OAAO,GAA2B;QACtC,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAC/E,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;YAClC,IAAI,EAAE,QAAiB;YACvB,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,UAAU,CAAC;SACtE,CAAC,CAAC;QACH,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,OAAO,EAAE,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;KAC5G,CAAC;IACF,OAAO,QAAQ,CACb,IAAI,EACJ,OAAO,EACP,QAAQ,CAAC,MAAM,CACb,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,EACxE,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAC7B,eAAe,CAAC,OAAO,EAAE,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC,CACjG,EACD,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CACrG,CACF,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAClB,IAAoB,EACpB,QAAsC,EACtC,OAA6C,EAC7C,WAA0C;IAE1C,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM;QAAE,OAAO,eAAe,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IACjE,IAAI,IAAI,CAAC,IAAI,KAAK,eAAe,EAAE,CAAC;QAClC,OAAO,iBAAiB,CAAC,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC1F,CAAC;IACD,OAAO,oBAAoB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AAC9C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CACpC,KAA2D,EAC3D,OAAwC;IAExC,MAAM,QAAQ,GAAG,qBAAqB,CAAC,KAAK,CAAC,CAAC;IAC9C,MAAM,iBAAiB,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IACpD,MAAM,QAAQ,GAAG,kBAAkB,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAChE,MAAM,OAAO,GACX,iBAAiB,CAAC,KAAK;QACvB,iBAAiB,CAAC,QAAQ,CAAC,UAAU,EAAE,iBAAiB,CAAC,UAAU,CAAC;QACpE,QAAQ,CAAC,QAAQ,KAAK,iBAAiB,CAAC,QAAQ,CAAC;IACnD,MAAM,WAAW,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAC9C,OAAO;QACL,CAAC,CAAC,WAAW,CACT,IAAI,EACJ,QAAQ,EACR,EAAE,MAAM,EAAE,iBAAiB,CAAC,MAAM,EAAE,QAAQ,EAAE,iBAAiB,CAAC,QAAQ,EAAE,EAC1E,OAAO,CAAC,WAAW,CACpB;QACH,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,qBAAqB,CAAC,CAC5C,CAAC;IACF,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,IAAI,EAAE,gCAAgC;QACtC,aAAa,EAAE,+BAA+B;QAC9C,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,UAAU,EAAE,QAAQ,CAAC,UAAU;QAC/B,QAAQ,EAAE,QAAQ,CAAC,QAAQ;QAC3B,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU;QACzC,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC;KACxC,CAAC,CAAC;AACL,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,qBAAqB,CACnC,IAAyB,EACzB,OAAwC;IAExC,MAAM,QAAQ,GAAG,qBAAqB,CAAC;QACrC,IAAI,EAAE,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,aAAa,EAAE;QACtD,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,KAAK,EAAE,CAAC,IAAI,CAAC;KACd,CAAC,CAAC;IACH,OAAO,sBAAsB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;AAC9G,CAAC"}

package/docs/USAGE.md

@@ -0,0 +1,118 @@
+# Wabachi usage
+
+Wabachi is a deterministic repository-analysis and Architecture Canon CLI.
+This manual explains the normal workflows for people. The installed command
+contract is authoritative: use `wabachi --help`, progressive command help, and
+`wabachi skill` for the exact current syntax.
+
+## Install and discover
+
+Wabachi requires Node.js 24 or newer.
+
+```bash
+npm install --global wabachi
+wabachi --version
+wabachi --help
+```
+
+For an ephemeral run, use `npx --yes wabachi --help`. Agents can begin with
+`wabachi skill` and then request one bounded playbook with
+`wabachi skill <scenario>`. Add `--json` to skill or help when consuming the
+projection from a script.
+
+## Analyze a repository
+
+`run` resolves a repository and executes the registered analysis providers. It
+can use the default revision resolution or an explicit revision, and writes a
+manifest plus provider output under a temporary directory unless `--out` is
+provided.
+
+```bash
+wabachi run .
+wabachi run . --revision HEAD --out ./artifacts/run
+```
+
+Use a commit SHA or another stable ref when the result will be compared or
+reviewed. The command prints the manifest path. Keep the directory named by
+`--out` if downstream work needs the facts or provider outputs.
+
+## Build a provider matrix
+
+`matrix` runs the matrix workflow for one explicit revision and requires a
+retained output directory. Pass a full 40-character commit SHA with
+`--revision`; unlike `run`, `matrix` never falls back to `HEAD`.
+
+```bash
+wabachi matrix . --revision 0123456789abcdef0123456789abcdef01234567 --out ./artifacts/matrix
+```
+
+The command prints the report path. The output directory also contains the
+supporting facts and correlation artifacts used to produce the report. For a
+configured provider workflow, pass a JSON configuration file with the source,
+revision, provider IDs, and addition order:
+
+```bash
+wabachi matrix --config ./matrix-workflow.json --out ./artifacts/matrix
+```
+
+The configured provider set must match the providers registered by the
+installed Wabachi version.
+
+## Architecture Canon
+
+Architecture Canon authoring is an explicit file-editing step. Wabachi does
+not provide an init or edit command. Create or revise the conventional
+`.wabachi/architecture.json` document using the repository's documented
+schema, then validate it before rendering. To discover the current Canon shape
+and obtain a minimal valid starting document, run the read-only example command
+and redirect it explicitly:
+
+```bash
+wabachi architecture --help
+mkdir -p .wabachi
+wabachi architecture example > ./.wabachi/architecture.json
+```
+
+The example is printed from the installed package and is not written by
+Wabachi. It is a starting point for explicit authoring, not an implicit init or
+edit workflow. Omitted-file validation and rendering resolve exactly
+`.wabachi/architecture.json`; an explicit `<file>` remains an override.
+
+```bash
+wabachi architecture validate
+wabachi architecture validate ./.wabachi/architecture.json --json
+```
+
+Rendering uses the bundled React Flow + ELK renderer and requires only the
+supported Node.js/npm environment. No Java, Docker, Chromium, Structurizr,
+CDN, or network access is required by the render command. Wabachi writes the
+generated documentation and local static diagrams beneath the directory passed
+to `--out`:
+
+```bash
+wabachi architecture render --out ./artifacts/site
+```
+
+The normal documentation path is: author the conventional Canon, validate it,
+then render it into a retained site. The matching live playbook is
+`wabachi skill architecture-documentation`. Passing an explicit Canon path to
+either command preserves the same workflow for another file.
+
+## Common failures and recovery
+
+- If a repository cannot be resolved, confirm the path or remote and retry
+  `run` with an explicit revision. Preserve the printed diagnostic when the
+  failure needs investigation.
+- If `matrix` rejects a revision, use a full commit SHA and provide `--out`.
+  If a configuration is rejected, compare its provider IDs and addition order
+  with the installed provider set.
+- If Canon validation fails, fix the reported document issue and validate the
+  same file again before rendering. `--json` is useful for automation.
+- If rendering fails, validate the Canon and inspect the bounded output
+  directory. The render command does not invoke an external diagram executable.
+- If syntax is uncertain, stop relying on a copied example and resolve the
+  current contract with `wabachi architecture --help` or the relevant leaf
+  help. Unsupported commands fail closed.
+
+Generated outputs are ordinary retained files; Wabachi does not publish them
+or activate an agent plugin as a side effect of npm installation.

package/docs/examples/minimal-canon.json

@@ -0,0 +1,24 @@
+{
+  "canonVersion": 1,
+  "documentId": "minimal-architecture-canon",
+  "root": { "kind": "architecture", "id": "architecture" },
+  "elements": [],
+  "interfaces": [],
+  "relationships": [],
+  "responsibilities": { "responsibilities": [] },
+  "authority": { "authority": [], "ownership": [] },
+  "boundaries": [],
+  "constraints": [],
+  "flows": [],
+  "deployment": {
+    "runtimeEnvironments": [],
+    "deploymentNodes": [],
+    "deploymentInstances": [],
+    "infrastructureReferences": [],
+    "mappings": []
+  },
+  "repositoryMappings": [],
+  "decisions": { "decisions": [], "references": [], "referenceAttachments": [] },
+  "views": [],
+  "globalIdentityRegistry": { "entries": [{ "id": "architecture", "namespace": "architecture" }] }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wabachi",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Repository analysis and Architecture Canon tooling for deterministic codebase understanding.",
   "type": "module",
   "bin": {
@@ -9,19 +9,29 @@
   "files": [
     "dist",
     "README.md",
-    "LICENSE"
+    "LICENSE",
+    "docs/USAGE.md",
+    "docs/examples",
+    "skills",
+    ".codex-plugin"
   ],
   "dependencies": {
+    "@xyflow/react": "12.11.6",
     "@sourcegraph/scip-typescript": "0.4.0",
+    "elkjs": "0.12.0",
+    "react": "19.3.0",
+    "react-dom": "19.3.0",
     "typescript": "^6.0.3"
   },
   "devDependencies": {
     "@types/node": "^26.5.1",
-    "eslint": "10.8.1",
+    "@types/react": "19.3.0",
+    "@types/react-dom": "19.3.0",
+    "eslint": "10.10.0",
     "js-yaml": "^4.1.0",
     "prettier": "3.9.6",
     "tsx": "^4.23.12",
-    "typescript-eslint": "8.67.0"
+    "typescript-eslint": "8.70.0"
   },
   "engines": {
     "node": ">=24"