@adea-ai/plugins 4.0.0 → 4.0.6

package/dist/catalog-store.js

@@ -0,0 +1,463 @@
+/**
+ * Catalog output coordination and publication.
+ *
+ * Contract (see docs/architecture.md, "Catalog publication"):
+ *
+ * - Every writer and every coordinated reader of one output directory uses a
+ *   lock directory that sits beside the output, in the output's real parent.
+ *   The lock is keyed by the output, never by `TMPDIR`, so processes with
+ *   different temporary directories, users or working directories still meet.
+ * - Supported filesystems are local filesystems where `mkdir` and same-directory
+ *   `rename` are atomic: Linux (ext4, xfs, btrfs, tmpfs, overlayfs), macOS
+ *   (APFS, HFS+) and Windows (NTFS, ReFS). Network filesystems are not
+ *   supported: their lock leases depend on clocks and caches this module does
+ *   not control.
+ * - A sync reads a base snapshot under the lock, builds without it, and then
+ *   publishes only if the output still has the same fingerprint (compare and
+ *   swap). A writer that replaced the catalog in between makes the later
+ *   publication fail with `CATALOG_BASE_CHANGED` instead of being overwritten.
+ * - Publication stages a complete directory, records a journal, moves the
+ *   current output to `<output>.previous`, then renames the staged directory
+ *   into place. Coordinated readers never observe the window between the two
+ *   renames. A process killed at any point leaves a journal that the next lock
+ *   holder (writer or reader) rolls back or forward before doing anything else.
+ * - A lock whose holder process is gone (same host) or whose heartbeat is older
+ *   than the lease is broken automatically and safely: the stale directory is
+ *   renamed aside first, so only one contender can break it, and a holder that
+ *   lost its lock refuses to swap with `CATALOG_LOCK_LOST`.
+ */
+import { createHash, randomUUID } from 'node:crypto';
+import { promises as fs } from 'node:fs';
+import { hostname } from 'node:os';
+import { basename, dirname, join, sep } from 'node:path';
+import { setTimeout as sleep } from 'node:timers/promises';
+import { writeDurably } from './fs-atomic.js';
+const LOCK_PREFIX = '.catalog-';
+const ABSENT = 'absent';
+const READ_ONLY_CODES = new Set(['EACCES', 'EPERM', 'EROFS']);
+/** Names the coordination files of one output, beside it in its real parent. */
+export function catalogPathsIn(parent, name) {
+    const normalized = name.normalize('NFC').toLowerCase();
+    // Case-insensitive and Unicode-normalized so that `Generated` and
+    // `generated` on macOS or Windows share one lock. On a case-sensitive
+    // filesystem such outputs are merely serialized together, which is harmless.
+    const hash = createHash('sha256').update(normalized).digest('hex').slice(0, 16);
+    const label = normalized.replace(/[^a-z0-9_-]/g, '_').slice(0, 32);
+    const stem = `${LOCK_PREFIX}${label}-${hash}`;
+    const output = join(parent, name);
+    const lock = `${stem}.lock`;
+    return {
+        output,
+        parent,
+        backup: `${output}.previous`,
+        lock: join(parent, lock),
+        owner: join(parent, lock, 'owner.json'),
+        journal: join(parent, `${stem}.journal.json`),
+        stagePrefix: join(parent, `${stem}.stage-`),
+    };
+}
+function isReservedName(name) {
+    return name.startsWith(LOCK_PREFIX);
+}
+function reserved(component) {
+    return isReservedName(component) || component.endsWith('.previous');
+}
+/** Resolves the output's real parent, optionally creating it. */
+async function resolvePaths(output, create) {
+    // Not `resolve()`: it would collapse `link/..` lexically, while the
+    // filesystem resolves the symbolic link first. `realpath` below does that.
+    const name = basename(output);
+    const parent = dirname(output);
+    // Reading a backup or a coordination directory, for example while
+    // inspecting one by hand, is allowed but not coordinated; writing is not.
+    if (create && (name === '' || name === '.' || name === '..'))
+        throw new Error(`CATALOG_OUTPUT_INVALID: ${output}`);
+    if (reserved(name) || parent.split(/[\\/]/).some(reserved)) {
+        if (!create)
+            return undefined;
+        throw new Error(`CATALOG_WRITE_LOCK_RESERVED: ${output}`);
+    }
+    if (create)
+        await fs.mkdir(parent, { recursive: true });
+    let actualParent;
+    try {
+        actualParent = await fs.realpath(parent);
+    }
+    catch (error) {
+        if (!create && error.code === 'ENOENT')
+            return undefined;
+        throw error;
+    }
+    // An output reached through a coordination directory, for example a
+    // symbolic link into another output's lock, would be destroyed when that
+    // lock is released or broken.
+    if (actualParent.split(sep).some(reserved)) {
+        if (!create)
+            return undefined;
+        throw new Error(`CATALOG_WRITE_LOCK_RESERVED: ${output}`);
+    }
+    return catalogPathsIn(actualParent, name);
+}
+async function inspectHolder(lock) {
+    const owner = join(lock, 'owner.json');
+    try {
+        const [text, stat] = await Promise.all([fs.readFile(owner, 'utf8'), fs.stat(owner)]);
+        const parsed = JSON.parse(text);
+        return {
+            ...(typeof parsed.token === 'string' ? { token: parsed.token } : {}),
+            ...(typeof parsed.pid === 'number' ? { pid: parsed.pid } : {}),
+            ...(typeof parsed.host === 'string' ? { host: parsed.host } : {}),
+            heartbeatAt: stat.mtimeMs,
+        };
+    }
+    catch (error) {
+        const code = error.code;
+        if (code !== 'ENOENT' && !(error instanceof SyntaxError))
+            throw error;
+    }
+    // The holder created the directory but has not written its owner record yet
+    // (or was killed in between): the directory's own age is the heartbeat.
+    try {
+        return { heartbeatAt: (await fs.stat(lock)).mtimeMs };
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return undefined;
+        throw error;
+    }
+}
+function processIsAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (error) {
+        return error.code === 'EPERM';
+    }
+}
+function holderIsStale(holder, staleAfterMs) {
+    if (holder.pid !== undefined && holder.host === hostname() && !processIsAlive(holder.pid))
+        return true;
+    return Date.now() - holder.heartbeatAt > staleAfterMs;
+}
+/**
+ * Breaks a stale lock. Renaming first means two contenders cannot both remove
+ * it; re-inspecting the renamed directory catches the case where the stale
+ * lock was replaced by a live one between inspection and rename.
+ */
+async function breakLock(paths, staleAfterMs) {
+    const grave = `${paths.lock}.stale-${randomUUID()}`;
+    try {
+        await fs.rename(paths.lock, grave);
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return;
+        throw error;
+    }
+    const taken = await inspectHolder(grave);
+    if (taken && !holderIsStale(taken, staleAfterMs)) {
+        // A live holder: give the lock back. If someone already took the name,
+        // the live holder will see CATALOG_LOCK_LOST before it swaps anything.
+        await fs.rename(grave, paths.lock).catch(() => undefined);
+        return;
+    }
+    await fs.rm(grave, { recursive: true, force: true });
+}
+export class CatalogLock {
+    paths;
+    token;
+    #timer;
+    #released = false;
+    constructor(paths, token, heartbeatMs) {
+        this.paths = paths;
+        this.token = token;
+        this.#timer = setInterval(() => {
+            const now = new Date();
+            fs.utimes(paths.owner, now, now).catch(() => undefined);
+        }, heartbeatMs);
+        this.#timer.unref?.();
+    }
+    /** Fails with `CATALOG_LOCK_LOST` if another process broke this lock. */
+    async assertHeld() {
+        const holder = await inspectHolder(this.paths.lock);
+        if (holder?.token !== this.token)
+            throw new Error(`CATALOG_LOCK_LOST: ${this.paths.output}`);
+    }
+    async release() {
+        if (this.#released)
+            return;
+        this.#released = true;
+        clearInterval(this.#timer);
+        const holder = await inspectHolder(this.paths.lock);
+        if (holder?.token !== this.token)
+            return;
+        await fs.rm(this.paths.lock, { recursive: true, force: true });
+    }
+}
+async function acquire(paths, mode, options) {
+    const waitMs = options.waitMs ?? 30_000;
+    const staleAfterMs = options.staleAfterMs ?? 120_000;
+    const pollMs = options.pollMs ?? 50;
+    const deadline = Date.now() + waitMs;
+    for (;;) {
+        try {
+            await fs.mkdir(paths.lock);
+        }
+        catch (error) {
+            const code = error.code;
+            // A read-only output cannot be published by anyone using this mount, so
+            // a reader proceeds without coordination there.
+            if (mode === 'read' && code !== undefined && READ_ONLY_CODES.has(code))
+                return undefined;
+            if (code !== 'EEXIST')
+                throw error;
+            const holder = await inspectHolder(paths.lock);
+            if (holder === undefined)
+                continue;
+            if (holderIsStale(holder, staleAfterMs)) {
+                await breakLock(paths, staleAfterMs);
+                continue;
+            }
+            if (Date.now() >= deadline) {
+                const who = holder.pid === undefined ? '' : ` (held by pid ${holder.pid} on ${holder.host})`;
+                throw new Error(`CATALOG_WRITE_IN_PROGRESS: ${paths.output}${who}`, { cause: error });
+            }
+            await sleep(pollMs);
+            continue;
+        }
+        const token = randomUUID();
+        try {
+            await fs.writeFile(paths.owner, `${JSON.stringify({ token, pid: process.pid, host: hostname(), mode, acquiredAt: new Date().toISOString() })}\n`, { flag: 'wx' });
+        }
+        catch (error) {
+            // A contender that misjudged a live lock as stale restored it over the
+            // directory just created here (see breakLock): the lock is not ours.
+            if (error.code === 'EEXIST')
+                continue;
+            throw error;
+        }
+        const lock = new CatalogLock(paths, token, options.heartbeatMs ?? 5_000);
+        try {
+            await options.onLocked?.(mode);
+        }
+        catch (error) {
+            await lock.release();
+            throw error;
+        }
+        return lock;
+    }
+}
+async function exists(path) {
+    try {
+        await fs.lstat(path);
+        return true;
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return false;
+        throw error;
+    }
+}
+async function readJournal(paths) {
+    let text;
+    try {
+        text = await fs.readFile(paths.journal, 'utf8');
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return undefined;
+        throw error;
+    }
+    try {
+        const parsed = JSON.parse(text);
+        if (parsed.version === 1 &&
+            typeof parsed.stage === 'string' &&
+            join(paths.parent, parsed.stage).startsWith(paths.stagePrefix) &&
+            !parsed.stage.includes(sep) &&
+            !parsed.stage.includes('/'))
+            return parsed;
+    }
+    catch {
+        // An empty or torn journal: the writer died while writing it, before it
+        // moved anything, so the output and backup have not been touched.
+        return { version: 1, stage: '' };
+    }
+    throw new Error(`CATALOG_RECOVERY_REQUIRED: unrecognized journal ${paths.journal}`);
+}
+/** Best effort: directory fsync is unavailable on Windows and some filesystems. */
+async function syncDirectory(path) {
+    let handle;
+    try {
+        handle = await fs.open(path, 'r');
+        await handle.sync();
+    }
+    catch {
+        // Process-crash safety does not depend on it; power-loss durability does.
+    }
+    finally {
+        await handle?.close().catch(() => undefined);
+    }
+}
+async function removeOrphanStages(paths, keep) {
+    const prefix = basename(paths.stagePrefix);
+    for (const name of await fs.readdir(paths.parent))
+        if (name.startsWith(prefix) && name !== keep)
+            await fs.rm(join(paths.parent, name), { recursive: true, force: true });
+}
+/**
+ * Completes or undoes an interrupted publication. Must run under the lock.
+ *
+ * | output | backup | staged dir | meaning                          | action         |
+ * | ------ | ------ | ---------- | -------------------------------- | -------------- |
+ * | yes    | no     | any        | not swapped, or already cleaned  | drop staging   |
+ * | no     | yes    | any        | died between the two renames     | roll back      |
+ * | yes    | yes    | no         | swapped, backup not yet removed  | roll forward   |
+ * | no     | no     | any        | first publication never swapped  | drop staging   |
+ * | yes    | yes    | yes        | inconsistent                     | stop, preserve |
+ */
+export async function recoverCatalogOutput(paths) {
+    const journal = await readJournal(paths);
+    if (journal === undefined) {
+        // Staging directories without a journal belong to a writer that died
+        // before it recorded anything; nothing else references them.
+        await removeOrphanStages(paths);
+        return;
+    }
+    const stage = journal.stage === '' ? undefined : join(paths.parent, journal.stage);
+    const [hasOutput, hasBackup, hasStage] = await Promise.all([
+        exists(paths.output),
+        exists(paths.backup),
+        stage ? exists(stage) : Promise.resolve(false),
+    ]);
+    if (stage === undefined && hasBackup)
+        // A torn journal is written before anything moves, so a backup next to it
+        // was not made by that writer.
+        throw new Error(`CATALOG_RECOVERY_REQUIRED: preserve and inspect ${paths.backup}`);
+    if (!hasOutput && hasBackup)
+        await fs.rename(paths.backup, paths.output);
+    else if (hasOutput && hasBackup && !hasStage)
+        await fs.rm(paths.backup, { recursive: true, force: true });
+    else if (hasOutput && hasBackup)
+        throw new Error(`CATALOG_RECOVERY_REQUIRED: preserve and inspect ${paths.backup}`);
+    await removeOrphanStages(paths);
+    await syncDirectory(paths.parent);
+    await fs.rm(paths.journal, { force: true });
+}
+/**
+ * A digest of the output's entries and bytes, or `absent`. Run it under the
+ * lock (inside {@link withCatalogRead}) so it describes a published state.
+ */
+export async function catalogFingerprint(output) {
+    let names;
+    try {
+        names = (await fs.readdir(output)).toSorted();
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return ABSENT;
+        throw error;
+    }
+    const hash = createHash('sha256');
+    for (const name of names) {
+        const path = join(output, name);
+        const stat = await fs.lstat(path);
+        hash.update(`${name}\0`);
+        if (stat.isFile())
+            hash.update('f\0').update(await fs.readFile(path));
+        else if (stat.isSymbolicLink())
+            hash.update('l\0').update(await fs.readlink(path));
+        else
+            hash.update(`o\0${stat.mode}\0${stat.size}`);
+        hash.update('\0');
+    }
+    return `sha256:${hash.digest('hex')}`;
+}
+/**
+ * Runs `read` while no writer can publish to `output`, after finishing any
+ * interrupted publication. Readers are serialized with writers and with each
+ * other; the lock is held only for the read itself.
+ */
+export async function withCatalogRead(output, read, options = {}) {
+    const paths = await resolvePaths(output, false);
+    if (paths === undefined)
+        return read();
+    const lock = await acquire(paths, 'read', options);
+    try {
+        if (lock)
+            await recoverCatalogOutput(paths);
+        return await read();
+    }
+    finally {
+        await lock?.release();
+    }
+}
+/**
+ * Replaces `output` with exactly `files`. The previous output stays in place
+ * until the new one is complete, and a coordinated reader sees either one or
+ * the other.
+ */
+export async function publishCatalog(output, files, options = {}) {
+    const paths = await resolvePaths(output, true);
+    if (paths === undefined)
+        throw new Error(`CATALOG_OUTPUT_UNRESOLVED: ${output}`);
+    await options.onStep?.('acquiring');
+    const lock = await acquire(paths, 'write', options);
+    if (lock === undefined)
+        throw new Error(`CATALOG_OUTPUT_UNRESOLVED: ${output}`);
+    try {
+        await recoverCatalogOutput(paths);
+        // A backup without a journal predates coordinated publication or was made
+        // by hand. Its provenance is unknown, so it is never deleted or restored.
+        if (await exists(paths.backup))
+            throw new Error(`CATALOG_RECOVERY_REQUIRED: preserve and inspect ${paths.backup}`);
+        if (options.expectedBase !== undefined) {
+            const current = await catalogFingerprint(paths.output);
+            if (current !== options.expectedBase)
+                throw new Error(`CATALOG_BASE_CHANGED: ${paths.output} was replaced after this sync read it; run the sync again`);
+        }
+        const stage = await fs.mkdtemp(paths.stagePrefix);
+        try {
+            await writeDurably(paths.journal, `${JSON.stringify({ version: 1, stage: basename(stage) })}\n`);
+            for (const [name, content] of Object.entries(files)) {
+                if (name === '' ||
+                    name.includes('/') ||
+                    name.includes('\\') ||
+                    name === '.' ||
+                    name === '..')
+                    throw new Error(`CATALOG_ARTIFACT_NAME_INVALID: ${name}`);
+                await writeDurably(join(stage, name), content);
+            }
+            await syncDirectory(stage);
+            await options.onStep?.('staged');
+            await lock.assertHeld();
+            try {
+                await fs.rename(paths.output, paths.backup);
+            }
+            catch (error) {
+                if (error.code !== 'ENOENT')
+                    throw error;
+            }
+            await options.onStep?.('backed-up');
+            await fs.rename(stage, paths.output);
+            await syncDirectory(paths.parent);
+            await options.onStep?.('swapped');
+            await fs.rm(paths.backup, { recursive: true, force: true });
+            await fs.rm(paths.journal, { force: true });
+            await options.onStep?.('cleaned');
+        }
+        catch (error) {
+            // Same state machine a later process would run after a crash, unless
+            // another process now holds the lock: then it owns the recovery.
+            const held = await lock.assertHeld().then(() => true, () => false);
+            if (held)
+                await recoverCatalogOutput(paths);
+            throw error;
+        }
+        await options.afterPublish?.();
+    }
+    finally {
+        await lock.release();
+    }
+}
+//# sourceMappingURL=catalog-store.js.map

package/dist/catalog-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-store.js","sourceRoot":"","sources":["../src/catalog-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACpD,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAA;AACxC,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AAClC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,WAAW,CAAA;AACxD,OAAO,EAAE,UAAU,IAAI,KAAK,EAAE,MAAM,sBAAsB,CAAA;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAgC7C,MAAM,WAAW,GAAG,WAAW,CAAA;AAC/B,MAAM,MAAM,GAAG,QAAQ,CAAA;AACvB,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAA;AAY7D,gFAAgF;AAChF,MAAM,UAAU,cAAc,CAAC,MAAc,EAAE,IAAY;IACzD,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAA;IACtD,kEAAkE;IAClE,sEAAsE;IACtE,6EAA6E;IAC7E,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;IAC/E,MAAM,KAAK,GAAG,UAAU,CAAC,OAAO,CAAC,cAAc,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;IAClE,MAAM,IAAI,GAAG,GAAG,WAAW,GAAG,KAAK,IAAI,IAAI,EAAE,CAAA;IAC7C,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;IACjC,MAAM,IAAI,GAAG,GAAG,IAAI,OAAO,CAAA;IAC3B,OAAO;QACL,MAAM;QACN,MAAM;QACN,MAAM,EAAE,GAAG,MAAM,WAAW;QAC5B,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC;QACxB,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,YAAY,CAAC;QACvC,OAAO,EAAE,IAAI,CAAC,MAAM,EAAE,GAAG,IAAI,eAAe,CAAC;QAC7C,WAAW,EAAE,IAAI,CAAC,MAAM,EAAE,GAAG,IAAI,SAAS,CAAC;KAC5C,CAAA;AACH,CAAC;AAED,SAAS,cAAc,CAAC,IAAY;IAClC,OAAO,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,CAAA;AACrC,CAAC;AAED,SAAS,QAAQ,CAAC,SAAiB;IACjC,OAAO,cAAc,CAAC,SAAS,CAAC,IAAI,SAAS,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAA;AACrE,CAAC;AAED,iEAAiE;AACjE,KAAK,UAAU,YAAY,CAAC,MAAc,EAAE,MAAe;IACzD,oEAAoE;IACpE,2EAA2E;IAC3E,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAA;IAC7B,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IAC9B,kEAAkE;IAClE,0EAA0E;IAC1E,IAAI,MAAM,IAAI,CAAC,IAAI,KAAK,EAAE,IAAI,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,IAAI,CAAC;QAC1D,MAAM,IAAI,KAAK,CAAC,2BAA2B,MAAM,EAAE,CAAC,CAAA;IACtD,IAAI,QAAQ,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC3D,IAAI,CAAC,MAAM;YAAE,OAAO,SAAS,CAAA;QAC7B,MAAM,IAAI,KAAK,CAAC,gCAAgC,MAAM,EAAE,CAAC,CAAA;IAC3D,CAAC;IACD,IAAI,MAAM;QAAE,MAAM,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IACvD,IAAI,YAAoB,CAAA;IACxB,IAAI,CAAC;QACH,YAAY,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAA;IAC1C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,CAAC,MAAM,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,SAAS,CAAA;QACnF,MAAM,KAAK,CAAA;IACb,CAAC;IACD,oEAAoE;IACpE,yEAAyE;IACzE,8BAA8B;IAC9B,IAAI,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC3C,IAAI,CAAC,MAAM;YAAE,OAAO,SAAS,CAAA;QAC7B,MAAM,IAAI,KAAK,CAAC,gCAAgC,MAAM,EAAE,CAAC,CAAA;IAC3D,CAAC;IACD,OAAO,cAAc,CAAC,YAAY,EAAE,IAAI,CAAC,CAAA;AAC3C,CAAC;AASD,KAAK,UAAU,aAAa,CAAC,IAAY;IACvC,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC,CAAA;IACtC,IAAI,CAAC;QACH,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;QACpF,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAuD,CAAA;QACrF,OAAO;YACL,GAAG,CAAC,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACpE,GAAG,CAAC,OAAO,MAAM,CAAC,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC9D,GAAG,CAAC,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACjE,WAAW,EAAE,IAAI,CAAC,OAAO;SAC1B,CAAA;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,GAAI,KAA+B,CAAC,IAAI,CAAA;QAClD,IAAI,IAAI,KAAK,QAAQ,IAAI,CAAC,CAAC,KAAK,YAAY,WAAW,CAAC;YAAE,MAAM,KAAK,CAAA;IACvE,CAAC;IACD,4EAA4E;IAC5E,wEAAwE;IACxE,IAAI,CAAC;QACH,OAAO,EAAE,WAAW,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,EAAE,CAAA;IACvD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,SAAS,CAAA;QACxE,MAAM,KAAK,CAAA;IACb,CAAC;AACH,CAAC;AAED,SAAS,cAAc,CAAC,GAAW;IACjC,IAAI,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAA;QACpB,OAAO,IAAI,CAAA;IACb,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAQ,KAA+B,CAAC,IAAI,KAAK,OAAO,CAAA;IAC1D,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CAAC,MAAc,EAAE,YAAoB;IACzD,IAAI,MAAM,CAAC,GAAG,KAAK,SAAS,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,GAAG,CAAC;QACvF,OAAO,IAAI,CAAA;IACb,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,WAAW,GAAG,YAAY,CAAA;AACvD,CAAC;AAED;;;;GAIG;AACH,KAAK,UAAU,SAAS,CAAC,KAAmB,EAAE,YAAoB;IAChE,MAAM,KAAK,GAAG,GAAG,KAAK,CAAC,IAAI,UAAU,UAAU,EAAE,EAAE,CAAA;IACnD,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;IACpC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAM;QAC9D,MAAM,KAAK,CAAA;IACb,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,aAAa,CAAC,KAAK,CAAC,CAAA;IACxC,IAAI,KAAK,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,YAAY,CAAC,EAAE,CAAC;QACjD,uEAAuE;QACvE,uEAAuE;QACvE,MAAM,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAA;QACzD,OAAM;IACR,CAAC;IACD,MAAM,EAAE,CAAC,EAAE,CAAC,KAAK,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;AACtD,CAAC;AAED,MAAM,OAAO,WAAW;IAKX,KAAK;IACL,KAAK;IALhB,MAAM,CAA4C;IAClD,SAAS,GAAG,KAAK,CAAA;IAEjB,YACW,KAAmB,EACnB,KAAa,EACtB,WAAmB;qBAFV,KAAK;qBACL,KAAK;QAGd,IAAI,CAAC,MAAM,GAAG,WAAW,CAAC,GAAG,EAAE;YAC7B,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAA;YACtB,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAA;QACzD,CAAC,EAAE,WAAW,CAAC,CAAA;QACf,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,CAAA;IACvB,CAAC;IAED,yEAAyE;IACzE,KAAK,CAAC,UAAU;QACd,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;QACnD,IAAI,MAAM,EAAE,KAAK,KAAK,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,sBAAsB,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAA;IAC9F,CAAC;IAED,KAAK,CAAC,OAAO;QACX,IAAI,IAAI,CAAC,SAAS;YAAE,OAAM;QAC1B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAA;QACrB,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QAC1B,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;QACnD,IAAI,MAAM,EAAE,KAAK,KAAK,IAAI,CAAC,KAAK;YAAE,OAAM;QACxC,MAAM,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;IAChE,CAAC;CACF;AAED,KAAK,UAAU,OAAO,CACpB,KAAmB,EACnB,IAAc,EACd,OAAmC;IAEnC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,MAAM,CAAA;IACvC,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,OAAO,CAAA;IACpD,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,EAAE,CAAA;IACnC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,CAAA;IACpC,SAAS,CAAC;QACR,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;QAC5B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,GAAI,KAA+B,CAAC,IAAI,CAAA;YAClD,wEAAwE;YACxE,gDAAgD;YAChD,IAAI,IAAI,KAAK,MAAM,IAAI,IAAI,KAAK,SAAS,IAAI,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC;gBAAE,OAAO,SAAS,CAAA;YACxF,IAAI,IAAI,KAAK,QAAQ;gBAAE,MAAM,KAAK,CAAA;YAClC,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;YAC9C,IAAI,MAAM,KAAK,SAAS;gBAAE,SAAQ;YAClC,IAAI,aAAa,CAAC,MAAM,EAAE,YAAY,CAAC,EAAE,CAAC;gBACxC,MAAM,SAAS,CAAC,KAAK,EAAE,YAAY,CAAC,CAAA;gBACpC,SAAQ;YACV,CAAC;YACD,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,QAAQ,EAAE,CAAC;gBAC3B,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,iBAAiB,MAAM,CAAC,GAAG,OAAO,MAAM,CAAC,IAAI,GAAG,CAAA;gBAC5F,MAAM,IAAI,KAAK,CAAC,8BAA8B,KAAK,CAAC,MAAM,GAAG,GAAG,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAA;YACvF,CAAC;YACD,MAAM,KAAK,CAAC,MAAM,CAAC,CAAA;YACnB,SAAQ;QACV,CAAC;QACD,MAAM,KAAK,GAAG,UAAU,EAAE,CAAA;QAC1B,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,SAAS,CAChB,KAAK,CAAC,KAAK,EACX,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC,IAAI,EAChH,EAAE,IAAI,EAAE,IAAI,EAAE,CACf,CAAA;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,uEAAuE;YACvE,qEAAqE;YACrE,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;gBAAE,SAAQ;YAChE,MAAM,KAAK,CAAA;QACb,CAAC;QACD,MAAM,IAAI,GAAG,IAAI,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,WAAW,IAAI,KAAK,CAAC,CAAA;QACxE,IAAI,CAAC;YACH,MAAM,OAAO,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC,CAAA;QAChC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,CAAC,OAAO,EAAE,CAAA;YACpB,MAAM,KAAK,CAAA;QACb,CAAC;QACD,OAAO,IAAI,CAAA;IACb,CAAC;AACH,CAAC;AAED,KAAK,UAAU,MAAM,CAAC,IAAY;IAChC,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;QACpB,OAAO,IAAI,CAAA;IACb,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAA;QACpE,MAAM,KAAK,CAAA;IACb,CAAC;AACH,CAAC;AAOD,KAAK,UAAU,WAAW,CAAC,KAAmB;IAC5C,IAAI,IAAY,CAAA;IAChB,IAAI,CAAC;QACH,IAAI,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;IACjD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,SAAS,CAAA;QACxE,MAAM,KAAK,CAAA;IACb,CAAC;IACD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAqB,CAAA;QACnD,IACE,MAAM,CAAC,OAAO,KAAK,CAAC;YACpB,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ;YAChC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,WAAW,CAAC;YAC9D,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC;YAC3B,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC;YAE3B,OAAO,MAAiB,CAAA;IAC5B,CAAC;IAAC,MAAM,CAAC;QACP,wEAAwE;QACxE,kEAAkE;QAClE,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAA;IAClC,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,mDAAmD,KAAK,CAAC,OAAO,EAAE,CAAC,CAAA;AACrF,CAAC;AAED,mFAAmF;AACnF,KAAK,UAAU,aAAa,CAAC,IAAY;IACvC,IAAI,MAAM,CAAA;IACV,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,CAAA;QACjC,MAAM,MAAM,CAAC,IAAI,EAAE,CAAA;IACrB,CAAC;IAAC,MAAM,CAAC;QACP,0EAA0E;IAC5E,CAAC;YAAS,CAAC;QACT,MAAM,MAAM,EAAE,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAA;IAC9C,CAAC;AACH,CAAC;AAED,KAAK,UAAU,kBAAkB,CAAC,KAAmB,EAAE,IAAa;IAClE,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,WAAW,CAAC,CAAA;IAC1C,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC;QAC/C,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,IAAI,KAAK,IAAI;YAC1C,MAAM,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;AAC7E,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,KAAmB;IAC5D,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,KAAK,CAAC,CAAA;IACxC,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,qEAAqE;QACrE,6DAA6D;QAC7D,MAAM,kBAAkB,CAAC,KAAK,CAAC,CAAA;QAC/B,OAAM;IACR,CAAC;IACD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,CAAA;IAClF,MAAM,CAAC,SAAS,EAAE,SAAS,EAAE,QAAQ,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACzD,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC;QACpB,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC;QACpB,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC;KAC/C,CAAC,CAAA;IACF,IAAI,KAAK,KAAK,SAAS,IAAI,SAAS;QAClC,0EAA0E;QAC1E,+BAA+B;QAC/B,MAAM,IAAI,KAAK,CAAC,mDAAmD,KAAK,CAAC,MAAM,EAAE,CAAC,CAAA;IACpF,IAAI,CAAC,SAAS,IAAI,SAAS;QAAE,MAAM,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;SACnE,IAAI,SAAS,IAAI,SAAS,IAAI,CAAC,QAAQ;QAC1C,MAAM,EAAE,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;SACxD,IAAI,SAAS,IAAI,SAAS;QAC7B,MAAM,IAAI,KAAK,CAAC,mDAAmD,KAAK,CAAC,MAAM,EAAE,CAAC,CAAA;IACpF,MAAM,kBAAkB,CAAC,KAAK,CAAC,CAAA;IAC/B,MAAM,aAAa,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IACjC,MAAM,EAAE,CAAC,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;AAC7C,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,MAAc;IACrD,IAAI,KAAe,CAAA;IACnB,IAAI,CAAC;QACH,KAAK,GAAG,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAA;IAC/C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,MAAM,CAAA;QACrE,MAAM,KAAK,CAAA;IACb,CAAC;IACD,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAA;IACjC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;QAC/B,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;QACjC,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,CAAA;QACxB,IAAI,IAAI,CAAC,MAAM,EAAE;YAAE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAA;aAChE,IAAI,IAAI,CAAC,cAAc,EAAE;YAAE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAA;;YAC7E,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,EAAE,CAAC,CAAA;QACjD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IACnB,CAAC;IACD,OAAO,UAAU,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAA;AACvC,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,MAAc,EACd,IAAsB,EACtB,OAAO,GAA+B,EAAE;IAExC,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;IAC/C,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,IAAI,EAAE,CAAA;IACtC,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,CAAA;IAClD,IAAI,CAAC;QACH,IAAI,IAAI;YAAE,MAAM,oBAAoB,CAAC,KAAK,CAAC,CAAA;QAC3C,OAAO,MAAM,IAAI,EAAE,CAAA;IACrB,CAAC;YAAS,CAAC;QACT,MAAM,IAAI,EAAE,OAAO,EAAE,CAAA;IACvB,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,MAAc,EACd,KAAoD,EACpD,OAAO,GAAmB,EAAE;IAE5B,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;IAC9C,IAAI,KAAK,KAAK,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,MAAM,EAAE,CAAC,CAAA;IAChF,MAAM,OAAO,CAAC,MAAM,EAAE,CAAC,WAAW,CAAC,CAAA;IACnC,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,CAAA;IACnD,IAAI,IAAI,KAAK,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,MAAM,EAAE,CAAC,CAAA;IAC/E,IAAI,CAAC;QACH,MAAM,oBAAoB,CAAC,KAAK,CAAC,CAAA;QACjC,0EAA0E;QAC1E,0EAA0E;QAC1E,IAAI,MAAM,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC;YAC5B,MAAM,IAAI,KAAK,CAAC,mDAAmD,KAAK,CAAC,MAAM,EAAE,CAAC,CAAA;QACpF,IAAI,OAAO,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;YACvC,MAAM,OAAO,GAAG,MAAM,kBAAkB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;YACtD,IAAI,OAAO,KAAK,OAAO,CAAC,YAAY;gBAClC,MAAM,IAAI,KAAK,CACb,yBAAyB,KAAK,CAAC,MAAM,2DAA2D,CACjG,CAAA;QACL,CAAC;QACD,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,CAAA;QACjD,IAAI,CAAC;YACH,MAAM,YAAY,CAChB,KAAK,CAAC,OAAO,EACb,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,EAAoB,CAAC,IAAI,CAChF,CAAA;YACD,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBACpD,IACE,IAAI,KAAK,EAAE;oBACX,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;oBAClB,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;oBACnB,IAAI,KAAK,GAAG;oBACZ,IAAI,KAAK,IAAI;oBAEb,MAAM,IAAI,KAAK,CAAC,kCAAkC,IAAI,EAAE,CAAC,CAAA;gBAC3D,MAAM,YAAY,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,CAAA;YAChD,CAAC;YACD,MAAM,aAAa,CAAC,KAAK,CAAC,CAAA;YAC1B,MAAM,OAAO,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,CAAA;YAChC,MAAM,IAAI,CAAC,UAAU,EAAE,CAAA;YACvB,IAAI,CAAC;gBACH,MAAM,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;YAC7C,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;oBAAE,MAAM,KAAK,CAAA;YACrE,CAAC;YACD,MAAM,OAAO,CAAC,MAAM,EAAE,CAAC,WAAW,CAAC,CAAA;YACnC,MAAM,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;YACpC,MAAM,aAAa,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;YACjC,MAAM,OAAO,CAAC,MAAM,EAAE,CAAC,SAAS,CAAC,CAAA;YACjC,MAAM,EAAE,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;YAC3D,MAAM,EAAE,CAAC,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;YAC3C,MAAM,OAAO,CAAC,MAAM,EAAE,CAAC,SAAS,CAAC,CAAA;QACnC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,qEAAqE;YACrE,iEAAiE;YACjE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC,IAAI,CACvC,GAAG,EAAE,CAAC,IAAI,EACV,GAAG,EAAE,CAAC,KAAK,CACZ,CAAA;YACD,IAAI,IAAI;gBAAE,MAAM,oBAAoB,CAAC,KAAK,CAAC,CAAA;YAC3C,MAAM,KAAK,CAAA;QACb,CAAC;QACD,MAAM,OAAO,CAAC,YAAY,EAAE,EAAE,CAAA;IAChC,CAAC;YAAS,CAAC;QACT,MAAM,IAAI,CAAC,OAAO,EAAE,CAAA;IACtB,CAAC;AACH,CAAC"}

package/dist/concurrency.d.ts

@@ -0,0 +1 @@
+export declare function mapWithConcurrency<T, U>(values: readonly T[], concurrency: number, mapper: (value: T, index: number) => Promise<U>): Promise<U[]>;

package/dist/concurrency.js

@@ -0,0 +1,15 @@
+export async function mapWithConcurrency(values, concurrency, mapper) {
+    const results = Array.from({ length: values.length });
+    let nextIndex = 0;
+    const worker = async () => {
+        while (true) {
+            const index = nextIndex++;
+            if (index >= values.length)
+                return;
+            results[index] = await mapper(values[index], index);
+        }
+    };
+    await Promise.all(Array.from({ length: Math.min(Math.max(concurrency, 1), values.length) }, () => worker()));
+    return results;
+}
+//# sourceMappingURL=concurrency.js.map

package/dist/concurrency.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"concurrency.js","sourceRoot":"","sources":["../src/concurrency.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,MAAoB,EACpB,WAAmB,EACnB,MAA+C;IAE/C,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAI,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAA;IACxD,IAAI,SAAS,GAAG,CAAC,CAAA;IACjB,MAAM,MAAM,GAAG,KAAK,IAAmB,EAAE;QACvC,OAAO,IAAI,EAAE,CAAC;YACZ,MAAM,KAAK,GAAG,SAAS,EAAE,CAAA;YACzB,IAAI,KAAK,IAAI,MAAM,CAAC,MAAM;gBAAE,OAAM;YAClC,OAAO,CAAC,KAAK,CAAC,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,KAAK,CAAE,EAAE,KAAK,CAAC,CAAA;QACtD,CAAC;IACH,CAAC,CAAA;IACD,MAAM,OAAO,CAAC,GAAG,CACf,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE,CAAC,CAC1F,CAAA;IACD,OAAO,OAAO,CAAA;AAChB,CAAC"}

package/dist/consumer-index.d.ts

@@ -24,7 +24,7 @@ export declare function parseProductPreference(input: unknown): ProductPreferenc
 export interface ProductIcon {
     /** `content` is the vendor's own plugin file; `favicon` is the product site's. */
     readonly kind: 'content' | 'favicon';
-    /** Release asset name; fetch it from the release for this `catalogId`. */
+    /** Content-addressed asset name, published beside the catalog's artifacts. */
     readonly asset: string;
     /**
      * Absolute, immutable URL for the asset, present when the build knows where
@@ -75,31 +75,6 @@ export interface ConsumerRelease {
     readonly packageStatus?: string;
     readonly packageDigest?: string;
 }
-/** One installable product, resolved from every source variant that publishes it. */ /**
- * The install-relevant facts of the release a product installs.
- *
- * A browsing client shows a plugin, then plans an install from it: the digest it
- * must pin, the connectors and credentials setup will ask for, and the
- * capabilities the harness has to negotiate. Carrying them here means the grid
- * needs no second artifact.
- */
-export interface ConsumerRelease {
-    readonly releaseId: string;
-    readonly canonicalContentDigest: string;
-    readonly contentResolution: string;
-    readonly capabilities: readonly {
-        readonly type: string;
-        readonly name: string;
-    }[];
-    readonly requiredConnectors: readonly string[];
-    readonly requiredCredentials: readonly string[];
-    /** Commit the release was resolved from, for audit and update state. */
-    readonly sourceRevision: string;
-    readonly upstreamVersion?: string;
-    /** Canonical package status, when the release carries one. */
-    readonly packageStatus?: string;
-    readonly packageDigest?: string;
-}
 /** One installable product, resolved from every source variant that publishes it. */
 export interface ConsumerProduct {
     readonly productKey: string;
@@ -158,7 +133,7 @@ export interface ConsumerCategory {
 export interface LeadingDiagnostic {
     readonly category: string;
     readonly name: string;
-    readonly reason: 'UNKNOWN_CATEGORY' | 'PRODUCT_NOT_FOUND' | 'PRODUCT_NOT_IN_CATEGORY';
+    readonly reason: 'UNKNOWN_CATEGORY' | 'PRODUCT_NOT_FOUND' | 'PRODUCT_NOT_IN_CATEGORY' | 'PRODUCT_AMBIGUOUS';
 }
 /** Brand-mark coverage, so an incomplete set is visible rather than implied. */
 export interface IconCoverage {
@@ -206,10 +181,13 @@ export declare function monogramFor(displayName: string, productKey: string): Pr
  * stable identifiers.
  */
 export declare function buildConsumerIndex(input: {
-    readonly catalog: Pick<Catalog, 'plugins' | 'sources'>;
+    /** A catalog without its ID yields records with no published asset URLs. */
+    readonly catalog: Pick<Catalog, 'plugins' | 'sources'> & {
+        readonly catalogId?: string;
+    };
     readonly leading?: Readonly<Record<string, readonly string[]>>;
     readonly topCount?: number;
-    readonly preference?: ProductPreference;
+    readonly productPreference?: ProductPreference;
     /** Where the catalog will be published, so records can carry absolute URLs. */
     readonly publicationRepositoryUrl?: string;
     /** Committed asset base a browser can fetch directly; preferred when set. */