@senior-skills/core 1.0.0

package/dist/domain/posix-path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"posix-path.d.ts","sourceRoot":"","sources":["../../src/domain/posix-path.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,6FAA6F;AAC7F,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAqB/C;AAED,wBAAgB,IAAI,CAAC,GAAG,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAExD;AAED,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAM7C;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAI9C;AAED,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAI7C;AAED,yEAAyE;AACzE,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAIzD;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAKjE;AAED,uFAAuF;AACvF,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAGlD;AAED,wEAAwE;AACxE,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE7C"}

package/dist/domain/posix-path.js

@@ -0,0 +1,84 @@
+/**
+ * A minimal POSIX-style path helper.
+ *
+ * The domain keeps its own copy rather than importing `node:path` so that `@senior-skills/core`
+ * stays runtime-free: package-relative paths are always POSIX regardless of the host OS, and
+ * a domain that imported `node:path` would silently behave differently on Windows.
+ *
+ * Filesystem-absolute paths are the concern of the `FileSystem` port, not of this module.
+ */
+/** Normalise separators and collapse `.` / `..` segments without touching the filesystem. */
+export function normalize(input) {
+    const isAbsolute = input.startsWith('/');
+    const segments = [];
+    for (const segment of input.replace(/\\/g, '/').split('/')) {
+        if (segment === '' || segment === '.')
+            continue;
+        if (segment === '..') {
+            const last = segments[segments.length - 1];
+            if (segments.length > 0 && last !== '..') {
+                segments.pop();
+            }
+            else if (!isAbsolute) {
+                segments.push('..');
+            }
+            continue;
+        }
+        segments.push(segment);
+    }
+    const joined = segments.join('/');
+    if (isAbsolute)
+        return `/${joined}`;
+    return joined === '' ? '.' : joined;
+}
+export function join(...parts) {
+    return normalize(parts.filter((part) => part !== '').join('/'));
+}
+export function dirname(input) {
+    const normalized = normalize(input);
+    const index = normalized.lastIndexOf('/');
+    if (index === -1)
+        return '.';
+    if (index === 0)
+        return '/';
+    return normalized.slice(0, index);
+}
+export function basename(input) {
+    const normalized = normalize(input);
+    const index = normalized.lastIndexOf('/');
+    return index === -1 ? normalized : normalized.slice(index + 1);
+}
+export function extname(input) {
+    const base = basename(input);
+    const index = base.lastIndexOf('.');
+    return index <= 0 ? '' : base.slice(index);
+}
+/** Split into non-empty segments. `''` and `'.'` yield an empty list. */
+export function segments(input) {
+    const normalized = normalize(input);
+    if (normalized === '.' || normalized === '')
+        return [];
+    return normalized.replace(/^\//, '').split('/').filter(Boolean);
+}
+/**
+ * True when `candidate` stays inside `root`. Both are treated as POSIX-relative paths;
+ * this is a *lexical* check and is intentionally conservative — the filesystem-level
+ * check (symlinks, real paths) lives in the installer.
+ */
+export function isInside(root, candidate) {
+    const rootSegments = segments(root);
+    const candidateSegments = segments(candidate);
+    if (candidateSegments.length < rootSegments.length)
+        return false;
+    return rootSegments.every((segment, index) => candidateSegments[index] === segment);
+}
+/** True when the path escapes its own root, i.e. normalising leaves a leading `..`. */
+export function escapesRoot(input) {
+    const normalized = normalize(input);
+    return normalized === '..' || normalized.startsWith('../');
+}
+/** Convert an OS-native path to the POSIX form used inside packages. */
+export function toPosix(input) {
+    return input.replace(/\\/g, '/');
+}
+//# sourceMappingURL=posix-path.js.map

package/dist/domain/posix-path.js.map

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

package/dist/domain/receipt.d.ts

@@ -0,0 +1,41 @@
+import { type SemanticVersion } from './version.ts';
+import type { AgentId, InstallScope } from './agent.ts';
+/**
+ * An install receipt is how the tool knows what it owns.
+ *
+ * The brief's rule — "do not delete files that were not installed by the tool" — is only
+ * enforceable with a record of exactly which relative paths were written and what they
+ * hashed to. Uninstall consults this; a file whose hash has drifted is treated as
+ * user-modified and preserved unless `--force`.
+ */
+export declare const RECEIPT_DIRNAME = ".senior-skills";
+export declare const CURRENT_RECEIPT_VERSION = 1;
+export interface ReceiptFile {
+    /** POSIX path relative to the installed skill directory. */
+    readonly path: string;
+    readonly integrity: string;
+    readonly size: number;
+}
+export interface InstallReceipt {
+    readonly receiptVersion: number;
+    readonly name: string;
+    readonly version: SemanticVersion;
+    readonly agentId: AgentId;
+    readonly scope: InstallScope;
+    readonly registry: string;
+    readonly resolved: string;
+    /** Integrity of the neutral package, matching the lockfile and registry index. */
+    readonly integrity: string;
+    readonly installedAt: string;
+    readonly installedWith: string;
+    /** Absolute path of the installed directory at install time, for diagnostics. */
+    readonly directory: string;
+    readonly files: readonly ReceiptFile[];
+    /** Skills installed only because this one required them. */
+    readonly dependencyOf: readonly string[];
+}
+export declare function parseReceipt(text: string, source: string): InstallReceipt;
+export declare function stringifyReceipt(receipt: InstallReceipt): string;
+/** Where a receipt lives, relative to the agent's skill root. */
+export declare function receiptPath(skillName: string): string;
+//# sourceMappingURL=receipt.d.ts.map

package/dist/domain/receipt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"receipt.d.ts","sourceRoot":"","sources":["../../src/domain/receipt.ts"],"names":[],"mappings":"AACA,OAAO,EAAgB,KAAK,eAAe,EAAE,MAAM,cAAc,CAAC;AAClE,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAExD;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,mBAAmB,CAAC;AAChD,eAAO,MAAM,uBAAuB,IAAI,CAAC;AAEzC,MAAM,WAAW,WAAW;IAC1B,4DAA4D;IAC5D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,kFAAkF;IAClF,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,iFAAiF;IACjF,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,SAAS,WAAW,EAAE,CAAC;IACvC,4DAA4D;IAC5D,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1C;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,cAAc,CAiEzE;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CAoBhE;AAED,iEAAiE;AACjE,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAErD"}

package/dist/domain/receipt.js

@@ -0,0 +1,93 @@
+import { AgentSkillsError, ErrorCode } from "./errors.js";
+import { parseVersion } from "./version.js";
+/**
+ * An install receipt is how the tool knows what it owns.
+ *
+ * The brief's rule — "do not delete files that were not installed by the tool" — is only
+ * enforceable with a record of exactly which relative paths were written and what they
+ * hashed to. Uninstall consults this; a file whose hash has drifted is treated as
+ * user-modified and preserved unless `--force`.
+ */
+export const RECEIPT_DIRNAME = '.senior-skills';
+export const CURRENT_RECEIPT_VERSION = 1;
+export function parseReceipt(text, source) {
+    let raw;
+    try {
+        raw = JSON.parse(text);
+    }
+    catch (cause) {
+        throw new AgentSkillsError(ErrorCode.IO_ERROR, `Corrupted install receipt: ${source}`, {
+            hints: ['Run `senior-skills doctor` to list corrupted metadata'],
+            cause,
+            data: { source },
+        });
+    }
+    if (raw === null || typeof raw !== 'object' || Array.isArray(raw)) {
+        throw new AgentSkillsError(ErrorCode.IO_ERROR, `Corrupted install receipt: ${source}`, {
+            data: { source },
+        });
+    }
+    const doc = raw;
+    const required = (key) => {
+        const value = doc[key];
+        if (typeof value !== 'string' || value === '') {
+            throw new AgentSkillsError(ErrorCode.IO_ERROR, `Install receipt ${source} is missing "${key}"`, { data: { source, field: key } });
+        }
+        return value;
+    };
+    const files = [];
+    if (Array.isArray(doc['files'])) {
+        for (const entry of doc['files']) {
+            if (entry === null || typeof entry !== 'object')
+                continue;
+            const record = entry;
+            if (typeof record['path'] !== 'string' || typeof record['integrity'] !== 'string')
+                continue;
+            files.push({
+                path: record['path'],
+                integrity: record['integrity'],
+                size: typeof record['size'] === 'number' ? record['size'] : 0,
+            });
+        }
+    }
+    const scope = doc['scope'];
+    return {
+        receiptVersion: typeof doc['receiptVersion'] === 'number' ? doc['receiptVersion'] : 1,
+        name: required('name'),
+        version: parseVersion(required('version'), source),
+        agentId: required('agentId'),
+        scope: scope === 'project' ? 'project' : 'global',
+        registry: typeof doc['registry'] === 'string' ? doc['registry'] : 'unknown',
+        resolved: typeof doc['resolved'] === 'string' ? doc['resolved'] : '',
+        integrity: typeof doc['integrity'] === 'string' ? doc['integrity'] : '',
+        installedAt: typeof doc['installedAt'] === 'string' ? doc['installedAt'] : '',
+        installedWith: typeof doc['installedWith'] === 'string' ? doc['installedWith'] : '',
+        directory: typeof doc['directory'] === 'string' ? doc['directory'] : '',
+        files,
+        dependencyOf: Array.isArray(doc['dependencyOf'])
+            ? doc['dependencyOf'].filter((item) => typeof item === 'string')
+            : [],
+    };
+}
+export function stringifyReceipt(receipt) {
+    return `${JSON.stringify({
+        receiptVersion: receipt.receiptVersion,
+        name: receipt.name,
+        version: receipt.version,
+        agentId: receipt.agentId,
+        scope: receipt.scope,
+        registry: receipt.registry,
+        resolved: receipt.resolved,
+        integrity: receipt.integrity,
+        installedAt: receipt.installedAt,
+        installedWith: receipt.installedWith,
+        directory: receipt.directory,
+        dependencyOf: [...receipt.dependencyOf].sort(),
+        files: [...receipt.files].sort((a, b) => a.path.localeCompare(b.path)),
+    }, null, 2)}\n`;
+}
+/** Where a receipt lives, relative to the agent's skill root. */
+export function receiptPath(skillName) {
+    return `${RECEIPT_DIRNAME}/receipts/${skillName}.json`;
+}
+//# sourceMappingURL=receipt.js.map

package/dist/domain/receipt.js.map

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

package/dist/domain/registry-index.d.ts

@@ -0,0 +1,41 @@
+import { type SemanticVersion } from './version.ts';
+/**
+ * The registry index is the one document every registry kind must serve. It is
+ * denormalised so `search` and `info` work from a single cached fetch.
+ */
+export declare const CURRENT_INDEX_VERSION = 1;
+export type RegistryKind = 'local' | 'git' | 'http';
+export interface IndexVersionEntry {
+    readonly version: SemanticVersion;
+    /** Package location relative to the registry root. Mutually exclusive with `tarball`. */
+    readonly path?: string;
+    /** Absolute URL of a `.tar.gz`. Mutually exclusive with `path`. */
+    readonly tarball?: string;
+    readonly integrity?: string;
+    readonly publishedAt?: string;
+    readonly deprecated: boolean;
+    readonly deprecationReason?: string;
+}
+export interface IndexSkillEntry {
+    readonly name: string;
+    readonly description: string;
+    readonly keywords: readonly string[];
+    readonly latest: SemanticVersion;
+    /** Sorted newest-first. */
+    readonly versions: readonly IndexVersionEntry[];
+}
+export interface RegistryIndex {
+    readonly schemaVersion: number;
+    readonly name: string;
+    readonly updatedAt?: string;
+    readonly skills: readonly IndexSkillEntry[];
+}
+export interface ParseIndexOptions {
+    readonly source?: string;
+    /** Registry name to assume when the document omits one. */
+    readonly fallbackName?: string;
+}
+export declare function parseRegistryIndex(text: string, options?: ParseIndexOptions): RegistryIndex;
+export declare function stringifyRegistryIndex(index: RegistryIndex): string;
+export declare function findIndexEntry(index: RegistryIndex, name: string): IndexSkillEntry | undefined;
+//# sourceMappingURL=registry-index.d.ts.map

package/dist/domain/registry-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry-index.d.ts","sourceRoot":"","sources":["../../src/domain/registry-index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAiC,KAAK,eAAe,EAAE,MAAM,cAAc,CAAC;AAGnF;;;GAGG;AACH,eAAO,MAAM,qBAAqB,IAAI,CAAC;AAEvC,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,KAAK,GAAG,MAAM,CAAC;AAEpD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,yFAAyF;IACzF,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,mEAAmE;IACnE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;CACrC;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IACjC,2BAA2B;IAC3B,QAAQ,CAAC,QAAQ,EAAE,SAAS,iBAAiB,EAAE,CAAC;CACjD;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,SAAS,eAAe,EAAE,CAAC;CAC7C;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,2DAA2D;IAC3D,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,iBAAsB,GAAG,aAAa,CAiE/F;AAyGD,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CA0BnE;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAE9F"}

package/dist/domain/registry-index.js

@@ -0,0 +1,150 @@
+import { parse as parseYaml, stringify as stringifyYaml } from 'yaml';
+import { AgentSkillsError, ErrorCode } from "./errors.js";
+import { compareVersions, parseVersion } from "./version.js";
+import { validateSkillName } from "./skill-ref.js";
+/**
+ * The registry index is the one document every registry kind must serve. It is
+ * denormalised so `search` and `info` work from a single cached fetch.
+ */
+export const CURRENT_INDEX_VERSION = 1;
+export function parseRegistryIndex(text, options = {}) {
+    const source = options.source ?? 'registry index';
+    let raw;
+    try {
+        raw = parseYaml(text);
+    }
+    catch (cause) {
+        throw new AgentSkillsError(ErrorCode.REGISTRY_INVALID_INDEX, `Could not parse ${source}`, {
+            details: [cause instanceof Error ? cause.message : String(cause)],
+            cause,
+            data: { source },
+        });
+    }
+    if (raw === null || typeof raw !== 'object' || Array.isArray(raw)) {
+        throw new AgentSkillsError(ErrorCode.REGISTRY_INVALID_INDEX, `${source} must be a mapping with a "skills" list`, { data: { source } });
+    }
+    const doc = raw;
+    const schemaVersion = typeof doc['schemaVersion'] === 'number' ? doc['schemaVersion'] : 1;
+    if (schemaVersion > CURRENT_INDEX_VERSION) {
+        throw new AgentSkillsError(ErrorCode.UNSUPPORTED_SCHEMA, `${source} uses index format v${schemaVersion}; this CLI understands up to v${CURRENT_INDEX_VERSION}`, {
+            hints: ['Upgrade the CLI: npm install -g @senior-skills/cli@latest'],
+            data: { source },
+        });
+    }
+    const name = typeof doc['name'] === 'string' && doc['name'].trim() !== ''
+        ? doc['name'].trim()
+        : (options.fallbackName ?? 'unnamed');
+    const rawSkills = doc['skills'];
+    if (rawSkills !== undefined && !Array.isArray(rawSkills)) {
+        throw new AgentSkillsError(ErrorCode.REGISTRY_INVALID_INDEX, `${source}: "skills" must be a list`, {
+            data: { source },
+        });
+    }
+    const skills = [];
+    for (const entry of (rawSkills ?? [])) {
+        const skill = parseSkillEntry(entry, source);
+        if (skill !== undefined)
+            skills.push(skill);
+    }
+    skills.sort((a, b) => a.name.localeCompare(b.name));
+    return {
+        schemaVersion,
+        name,
+        ...(typeof doc['updatedAt'] === 'string' ? { updatedAt: doc['updatedAt'] } : {}),
+        skills,
+    };
+}
+function parseSkillEntry(entry, source) {
+    if (entry === null || typeof entry !== 'object' || Array.isArray(entry)) {
+        throw new AgentSkillsError(ErrorCode.REGISTRY_INVALID_INDEX, `${source}: each skill entry must be a mapping`, { data: { source } });
+    }
+    const record = entry;
+    const name = record['name'];
+    if (typeof name !== 'string') {
+        throw new AgentSkillsError(ErrorCode.REGISTRY_INVALID_INDEX, `${source}: a skill entry has no name`, {
+            data: { source },
+        });
+    }
+    const nameProblems = validateSkillName(name);
+    if (nameProblems.length > 0) {
+        throw new AgentSkillsError(ErrorCode.REGISTRY_INVALID_INDEX, `${source}: invalid skill name "${name}"`, { details: nameProblems.map((problem) => `- ${problem}`), data: { source, name } });
+    }
+    const rawVersions = record['versions'];
+    if (!Array.isArray(rawVersions) || rawVersions.length === 0) {
+        throw new AgentSkillsError(ErrorCode.REGISTRY_INVALID_INDEX, `${source}: skill "${name}" has no versions`, { data: { source, name } });
+    }
+    const versions = rawVersions.map((version) => parseVersionEntry(version, name, source));
+    // Newest first, so `latest` and `info` never have to re-sort.
+    const ordered = [...versions].sort((a, b) => compareVersions(b.version, a.version));
+    const declaredLatest = record['latest'];
+    const latest = typeof declaredLatest === 'string'
+        ? parseVersion(declaredLatest, `${source} ${name}.latest`)
+        : // Fall back to the newest non-deprecated version, or the newest overall.
+            (ordered.find((version) => !version.deprecated)?.version ?? ordered[0].version);
+    return {
+        name,
+        description: typeof record['description'] === 'string' ? record['description'] : '',
+        keywords: Array.isArray(record['keywords'])
+            ? record['keywords'].filter((k) => typeof k === 'string')
+            : [],
+        latest,
+        versions: ordered,
+    };
+}
+function parseVersionEntry(entry, skillName, source) {
+    if (typeof entry === 'string') {
+        return { version: parseVersion(entry, `${source} ${skillName}`), deprecated: false };
+    }
+    if (entry === null || typeof entry !== 'object' || Array.isArray(entry)) {
+        throw new AgentSkillsError(ErrorCode.REGISTRY_INVALID_INDEX, `${source}: version entries for "${skillName}" must be mappings`, { data: { source, name: skillName } });
+    }
+    const record = entry;
+    const version = record['version'];
+    if (typeof version !== 'string') {
+        throw new AgentSkillsError(ErrorCode.REGISTRY_INVALID_INDEX, `${source}: a version entry for "${skillName}" has no "version"`, { data: { source, name: skillName } });
+    }
+    const path = record['path'];
+    const tarball = record['tarball'];
+    if (typeof path === 'string' && typeof tarball === 'string') {
+        throw new AgentSkillsError(ErrorCode.REGISTRY_INVALID_INDEX, `${source}: "${skillName}@${version}" declares both "path" and "tarball"`, { hints: ['Use "path" for git/local registries and "tarball" for http registries'] });
+    }
+    return {
+        version: parseVersion(version, `${source} ${skillName}`),
+        ...(typeof path === 'string' ? { path } : {}),
+        ...(typeof tarball === 'string' ? { tarball } : {}),
+        ...(typeof record['integrity'] === 'string' ? { integrity: record['integrity'] } : {}),
+        ...(typeof record['publishedAt'] === 'string' ? { publishedAt: record['publishedAt'] } : {}),
+        deprecated: record['deprecated'] === true,
+        ...(typeof record['deprecationReason'] === 'string'
+            ? { deprecationReason: record['deprecationReason'] }
+            : {}),
+    };
+}
+export function stringifyRegistryIndex(index) {
+    return stringifyYaml({
+        schemaVersion: index.schemaVersion,
+        name: index.name,
+        ...(index.updatedAt === undefined ? {} : { updatedAt: index.updatedAt }),
+        skills: index.skills.map((skill) => ({
+            name: skill.name,
+            description: skill.description,
+            ...(skill.keywords.length > 0 ? { keywords: [...skill.keywords] } : {}),
+            latest: skill.latest,
+            versions: skill.versions.map((version) => ({
+                version: version.version,
+                ...(version.path === undefined ? {} : { path: version.path }),
+                ...(version.tarball === undefined ? {} : { tarball: version.tarball }),
+                ...(version.integrity === undefined ? {} : { integrity: version.integrity }),
+                ...(version.publishedAt === undefined ? {} : { publishedAt: version.publishedAt }),
+                ...(version.deprecated ? { deprecated: true } : {}),
+                ...(version.deprecationReason === undefined
+                    ? {}
+                    : { deprecationReason: version.deprecationReason }),
+            })),
+        })),
+    }, { lineWidth: 120, singleQuote: false });
+}
+export function findIndexEntry(index, name) {
+    return index.skills.find((skill) => skill.name === name);
+}
+//# sourceMappingURL=registry-index.js.map

package/dist/domain/registry-index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry-index.js","sourceRoot":"","sources":["../../src/domain/registry-index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,SAAS,IAAI,aAAa,EAAE,MAAM,MAAM,CAAC;AACtE,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,YAAY,EAAwB,MAAM,cAAc,CAAC;AACnF,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEnD;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC;AAsCvC,MAAM,UAAU,kBAAkB,CAAC,IAAY,EAAE,UAA6B,EAAE;IAC9E,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,gBAAgB,CAAC;IAElD,IAAI,GAAY,CAAC;IACjB,IAAI,CAAC;QACH,GAAG,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,gBAAgB,CAAC,SAAS,CAAC,sBAAsB,EAAE,mBAAmB,MAAM,EAAE,EAAE;YACxF,OAAO,EAAE,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACjE,KAAK;YACL,IAAI,EAAE,EAAE,MAAM,EAAE;SACjB,CAAC,CAAC;IACL,CAAC;IAED,IAAI,GAAG,KAAK,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAClE,MAAM,IAAI,gBAAgB,CACxB,SAAS,CAAC,sBAAsB,EAChC,GAAG,MAAM,yCAAyC,EAClD,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,EAAE,CACrB,CAAC;IACJ,CAAC;IAED,MAAM,GAAG,GAAG,GAA8B,CAAC;IAC3C,MAAM,aAAa,GAAG,OAAO,GAAG,CAAC,eAAe,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1F,IAAI,aAAa,GAAG,qBAAqB,EAAE,CAAC;QAC1C,MAAM,IAAI,gBAAgB,CACxB,SAAS,CAAC,kBAAkB,EAC5B,GAAG,MAAM,uBAAuB,aAAa,iCAAiC,qBAAqB,EAAE,EACrG;YACE,KAAK,EAAE,CAAC,2DAA2D,CAAC;YACpE,IAAI,EAAE,EAAE,MAAM,EAAE;SACjB,CACF,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,GACR,OAAO,GAAG,CAAC,MAAM,CAAC,KAAK,QAAQ,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE;QAC1D,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE;QACpB,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,IAAI,SAAS,CAAC,CAAC;IAE1C,MAAM,SAAS,GAAG,GAAG,CAAC,QAAQ,CAAC,CAAC;IAChC,IAAI,SAAS,KAAK,SAAS,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QACzD,MAAM,IAAI,gBAAgB,CACxB,SAAS,CAAC,sBAAsB,EAChC,GAAG,MAAM,2BAA2B,EACpC;YACE,IAAI,EAAE,EAAE,MAAM,EAAE;SACjB,CACF,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAsB,EAAE,CAAC;IACrC,KAAK,MAAM,KAAK,IAAI,CAAC,SAAS,IAAI,EAAE,CAAc,EAAE,CAAC;QACnD,MAAM,KAAK,GAAG,eAAe,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAC7C,IAAI,KAAK,KAAK,SAAS;YAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC9C,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAEpD,OAAO;QACL,aAAa;QACb,IAAI;QACJ,GAAG,CAAC,OAAO,GAAG,CAAC,WAAW,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAChF,MAAM;KACP,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CAAC,KAAc,EAAE,MAAc;IACrD,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACxE,MAAM,IAAI,gBAAgB,CACxB,SAAS,CAAC,sBAAsB,EAChC,GAAG,MAAM,sCAAsC,EAC/C,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,EAAE,CACrB,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GAAG,KAAgC,CAAC;IAChD,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;IAC5B,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7B,MAAM,IAAI,gBAAgB,CACxB,SAAS,CAAC,sBAAsB,EAChC,GAAG,MAAM,6BAA6B,EACtC;YACE,IAAI,EAAE,EAAE,MAAM,EAAE;SACjB,CACF,CAAC;IACJ,CAAC;IACD,MAAM,YAAY,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC7C,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,gBAAgB,CACxB,SAAS,CAAC,sBAAsB,EAChC,GAAG,MAAM,yBAAyB,IAAI,GAAG,EACzC,EAAE,OAAO,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,KAAK,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,CACnF,CAAC;IACJ,CAAC;IAED,MAAM,WAAW,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC;IACvC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5D,MAAM,IAAI,gBAAgB,CACxB,SAAS,CAAC,sBAAsB,EAChC,GAAG,MAAM,YAAY,IAAI,mBAAmB,EAC5C,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,CAC3B,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,iBAAiB,CAAC,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;IACxF,8DAA8D;IAC9D,MAAM,OAAO,GAAG,CAAC,GAAG,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IAEpF,MAAM,cAAc,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;IACxC,MAAM,MAAM,GACV,OAAO,cAAc,KAAK,QAAQ;QAChC,CAAC,CAAC,YAAY,CAAC,cAAc,EAAE,GAAG,MAAM,IAAI,IAAI,SAAS,CAAC;QAC1D,CAAC,CAAC,yEAAyE;YACzE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,OAAO,IAAI,OAAO,CAAC,CAAC,CAAE,CAAC,OAAO,CAAC,CAAC;IAEvF,OAAO;QACL,IAAI;QACJ,WAAW,EAAE,OAAO,MAAM,CAAC,aAAa,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,EAAE;QACnF,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;YACzC,CAAC,CAAE,MAAM,CAAC,UAAU,CAAe,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC;YACrF,CAAC,CAAC,EAAE;QACN,MAAM;QACN,QAAQ,EAAE,OAAO;KAClB,CAAC;AACJ,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAc,EAAE,SAAiB,EAAE,MAAc;IAC1E,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,EAAE,OAAO,EAAE,YAAY,CAAC,KAAK,EAAE,GAAG,MAAM,IAAI,SAAS,EAAE,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;IACvF,CAAC;IACD,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACxE,MAAM,IAAI,gBAAgB,CACxB,SAAS,CAAC,sBAAsB,EAChC,GAAG,MAAM,0BAA0B,SAAS,oBAAoB,EAChE,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,CACtC,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GAAG,KAAgC,CAAC;IAChD,MAAM,OAAO,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC;IAClC,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAChC,MAAM,IAAI,gBAAgB,CACxB,SAAS,CAAC,sBAAsB,EAChC,GAAG,MAAM,0BAA0B,SAAS,oBAAoB,EAChE,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,CACtC,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;IAC5B,MAAM,OAAO,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC;IAClC,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAC5D,MAAM,IAAI,gBAAgB,CACxB,SAAS,CAAC,sBAAsB,EAChC,GAAG,MAAM,MAAM,SAAS,IAAI,OAAO,sCAAsC,EACzE,EAAE,KAAK,EAAE,CAAC,uEAAuE,CAAC,EAAE,CACrF,CAAC;IACJ,CAAC;IAED,OAAO;QACL,OAAO,EAAE,YAAY,CAAC,OAAO,EAAE,GAAG,MAAM,IAAI,SAAS,EAAE,CAAC;QACxD,GAAG,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7C,GAAG,CAAC,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACnD,GAAG,CAAC,OAAO,MAAM,CAAC,WAAW,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACtF,GAAG,CAAC,OAAO,MAAM,CAAC,aAAa,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5F,UAAU,EAAE,MAAM,CAAC,YAAY,CAAC,KAAK,IAAI;QACzC,GAAG,CAAC,OAAO,MAAM,CAAC,mBAAmB,CAAC,KAAK,QAAQ;YACjD,CAAC,CAAC,EAAE,iBAAiB,EAAE,MAAM,CAAC,mBAAmB,CAAC,EAAE;YACpD,CAAC,CAAC,EAAE,CAAC;KACR,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,KAAoB;IACzD,OAAO,aAAa,CAClB;QACE,aAAa,EAAE,KAAK,CAAC,aAAa;QAClC,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,GAAG,CAAC,KAAK,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC;QACxE,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YACnC,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACvE,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;gBACzC,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,GAAG,CAAC,OAAO,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC;gBAC7D,GAAG,CAAC,OAAO,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC;gBACtE,GAAG,CAAC,OAAO,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC;gBAC5E,GAAG,CAAC,OAAO,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC;gBAClF,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACnD,GAAG,CAAC,OAAO,CAAC,iBAAiB,KAAK,SAAS;oBACzC,CAAC,CAAC,EAAE;oBACJ,CAAC,CAAC,EAAE,iBAAiB,EAAE,OAAO,CAAC,iBAAiB,EAAE,CAAC;aACtD,CAAC,CAAC;SACJ,CAAC,CAAC;KACJ,EACD,EAAE,SAAS,EAAE,GAAG,EAAE,WAAW,EAAE,KAAK,EAAE,CACvC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAoB,EAAE,IAAY;IAC/D,OAAO,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AAC3D,CAAC"}

package/dist/domain/resolver.d.ts

@@ -0,0 +1,54 @@
+import type { SkillManifest } from './manifest.ts';
+import type { IndexVersionEntry } from './registry-index.ts';
+import { type SkillRef } from './skill-ref.ts';
+import { type SemanticVersion } from './version.ts';
+/** What the resolver needs from a registry. Kept separate so the resolver stays testable. */
+export interface ResolutionSource {
+    /**
+     * Versions of `name`. When `registry` is given the lookup is restricted to it; otherwise
+     * federation precedence decides which registry owns the name.
+     */
+    listVersions(name: string, registry?: string): Promise<{
+        readonly registry: string;
+        readonly versions: readonly IndexVersionEntry[];
+    }>;
+    loadManifest(name: string, version: SemanticVersion, registry: string): Promise<SkillManifest>;
+}
+export interface ResolvedSkill {
+    readonly name: string;
+    readonly version: SemanticVersion;
+    readonly registry: string;
+    readonly entry: IndexVersionEntry;
+    readonly manifest: SkillManifest;
+    /** True when the user asked for this skill by name, rather than it being pulled in. */
+    readonly direct: boolean;
+    /** Names of skills that required this one. Empty for a purely direct install. */
+    readonly requiredBy: readonly string[];
+}
+export interface ResolutionResult {
+    /** Dependencies before dependents, so installing in order never leaves a dangling need. */
+    readonly order: readonly ResolvedSkill[];
+    readonly warnings: readonly string[];
+}
+export interface ResolveOptions {
+    /** Pins that must be honoured exactly, from `skills.lock`. */
+    readonly pinned?: Readonly<Record<string, SemanticVersion>>;
+    /** Skip transitive dependencies entirely. Used by `--no-deps`-style flows and `info`. */
+    readonly skipDependencies?: boolean;
+}
+/**
+ * Breadth-first constraint resolution without backtracking.
+ *
+ * Adding a constraint can only lower the chosen version, never raise it, so the fixed-point
+ * loop terminates; the iteration cap exists to turn a hypothetical resolver bug into a clear
+ * error rather than a hang.
+ */
+export declare class Resolver {
+    private readonly source;
+    constructor(source: ResolutionSource);
+    resolve(refs: readonly SkillRef[], options?: ResolveOptions): Promise<ResolutionResult>;
+    /** The first name (alphabetically, for determinism) whose choice does not satisfy its constraints. */
+    private findStale;
+    private choose;
+}
+//# sourceMappingURL=resolver.d.ts.map

package/dist/domain/resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../../src/domain/resolver.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAU,KAAK,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAA8C,KAAK,eAAe,EAAE,MAAM,cAAc,CAAC;AAEhG,6FAA6F;AAC7F,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,YAAY,CACV,IAAI,EAAE,MAAM,EACZ,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC;QAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,QAAQ,EAAE,SAAS,iBAAiB,EAAE,CAAA;KAAE,CAAC,CAAC;IAE3F,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;CAChG;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IACjC,uFAAuF;IACvF,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,iFAAiF;IACjF,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;CACxC;AAED,MAAM,WAAW,gBAAgB;IAC/B,2FAA2F;IAC3F,QAAQ,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,CAAC;IACzC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AAYD,MAAM,WAAW,cAAc;IAC7B,8DAA8D;IAC9D,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC;IAC5D,yFAAyF;IACzF,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,CAAC;CACrC;AAED;;;;;;GAMG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmB;gBAE9B,MAAM,EAAE,gBAAgB;IAI9B,OAAO,CACX,IAAI,EAAE,SAAS,QAAQ,EAAE,EACzB,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,gBAAgB,CAAC;IAuE5B,sGAAsG;IACtG,OAAO,CAAC,SAAS;YAaH,MAAM;CA0CrB"}