@senior-skills/core 1.0.0

package/dist/application/diagnose.d.ts

@@ -0,0 +1,44 @@
+import type { ApplicationContext } from './context.ts';
+export type CheckStatus = 'ok' | 'warn' | 'fail' | 'skip';
+export interface DiagnosticCheck {
+    readonly status: CheckStatus;
+    readonly title: string;
+    readonly detail?: string;
+    /** Extra lines shown indented under the check. */
+    readonly notes?: readonly string[];
+    readonly hint?: string;
+}
+export interface DiagnosticSection {
+    readonly title: string;
+    readonly checks: readonly DiagnosticCheck[];
+}
+export interface DoctorReport {
+    readonly sections: readonly DiagnosticSection[];
+    readonly ok: boolean;
+    readonly failures: number;
+    readonly warnings: number;
+}
+export interface DoctorOptions {
+    readonly startDir?: string;
+    /** Skip network calls, for offline diagnosis. */
+    readonly offline?: boolean;
+}
+/**
+ * `doctor` exists to answer "why did that not work?" without the user reading source.
+ *
+ * Every check reports *what it looked at*, not just a verdict, because the common failures
+ * here are environmental — an agent installed somewhere unusual, a read-only directory, a
+ * registry behind a proxy — and a bare red cross does not help with any of them.
+ */
+export declare class DiagnoseSystem {
+    private readonly ctx;
+    constructor(ctx: ApplicationContext);
+    execute(options?: DoctorOptions): Promise<DoctorReport>;
+    private environmentSection;
+    private registrySection;
+    private agentSections;
+    private directoryCheck;
+    /** Reads every install receipt and reports drift, corruption and unmanaged directories. */
+    private installationsSection;
+}
+//# sourceMappingURL=diagnose.d.ts.map

package/dist/application/diagnose.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnose.d.ts","sourceRoot":"","sources":["../../src/application/diagnose.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAGvD,MAAM,MAAM,WAAW,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAE1D,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,kDAAkD;IAClD,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,SAAS,eAAe,EAAE,CAAC;CAC7C;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,QAAQ,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAChD,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,iDAAiD;IACjD,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;;;;;GAMG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAqB;gBAE7B,GAAG,EAAE,kBAAkB;IAI7B,OAAO,CAAC,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,YAAY,CAAC;IAsBjE,OAAO,CAAC,kBAAkB;YAqBZ,eAAe;YAkDf,aAAa;YAmDb,cAAc;IA0C5B,2FAA2F;YAC7E,oBAAoB;CAmDnC"}

package/dist/application/diagnose.js

@@ -0,0 +1,228 @@
+import { INSTALL_SCOPES } from "../domain/agent.js";
+import { isAgentSkillsError } from "../domain/errors.js";
+import { targetsFor, detectAgents } from "./agent-selection.js";
+import { findProjectRoot } from "./workspace.js";
+/**
+ * `doctor` exists to answer "why did that not work?" without the user reading source.
+ *
+ * Every check reports *what it looked at*, not just a verdict, because the common failures
+ * here are environmental — an agent installed somewhere unusual, a read-only directory, a
+ * registry behind a proxy — and a bare red cross does not help with any of them.
+ */
+export class DiagnoseSystem {
+    ctx;
+    constructor(ctx) {
+        this.ctx = ctx;
+    }
+    async execute(options = {}) {
+        const projectRoot = await findProjectRoot(this.ctx.fs, options.startDir ?? this.ctx.env.cwd(), this.ctx.env.homeDir());
+        const detections = await detectAgents(this.ctx);
+        const sections = [
+            this.environmentSection(projectRoot),
+            await this.registrySection(options.offline === true),
+            ...(await this.agentSections(detections, projectRoot)),
+            await this.installationsSection(projectRoot),
+        ];
+        const checks = sections.flatMap((section) => section.checks);
+        const failures = checks.filter((check) => check.status === 'fail').length;
+        const warnings = checks.filter((check) => check.status === 'warn').length;
+        return { sections, ok: failures === 0, failures, warnings };
+    }
+    environmentSection(projectRoot) {
+        const nodeVersion = typeof process === 'undefined' ? 'unknown' : process.version;
+        return {
+            title: 'Environment',
+            checks: [
+                { status: 'ok', title: 'CLI', detail: this.ctx.toolVersion },
+                { status: 'ok', title: 'Node', detail: nodeVersion },
+                { status: 'ok', title: 'Platform', detail: this.ctx.env.platform() },
+                { status: 'ok', title: 'Home', detail: this.ctx.env.homeDir() },
+                projectRoot === undefined
+                    ? {
+                        status: 'skip',
+                        title: 'Project',
+                        detail: 'not inside a project',
+                        hint: 'Project-scoped commands need a directory with .git, skills.lock or an agent directory',
+                    }
+                    : { status: 'ok', title: 'Project', detail: projectRoot },
+            ],
+        };
+    }
+    async registrySection(offline) {
+        const members = this.ctx.registry.members();
+        if (members.length === 0) {
+            return {
+                title: 'Registries',
+                checks: [
+                    {
+                        status: 'fail',
+                        title: 'No registries configured',
+                        hint: 'senior-skills registry add official <url>',
+                    },
+                ],
+            };
+        }
+        const checks = [];
+        for (const [index, registry] of members.entries()) {
+            const precedence = `#${index + 1}`;
+            if (offline) {
+                checks.push({
+                    status: 'skip',
+                    title: `${registry.name} ${precedence}`,
+                    detail: `${registry.kind} (offline, not contacted)`,
+                });
+                continue;
+            }
+            try {
+                await registry.refresh();
+                const results = await registry.search({ text: '', limit: 1000 });
+                checks.push({
+                    status: registry.trusted ? 'ok' : 'warn',
+                    title: `${registry.name} ${precedence}`,
+                    detail: `${registry.kind} · ${results.length} skill${results.length === 1 ? '' : 's'}${registry.trusted ? '' : ' · marked untrusted'}`,
+                });
+            }
+            catch (error) {
+                checks.push({
+                    status: 'fail',
+                    title: `${registry.name} ${precedence}`,
+                    detail: isAgentSkillsError(error) ? error.message : String(error),
+                    hint: 'Check the URL and your network access, then re-run',
+                });
+            }
+        }
+        return { title: 'Registries', checks };
+    }
+    async agentSections(detections, projectRoot) {
+        const sections = [];
+        for (const adapter of this.ctx.agents.all()) {
+            const detection = detections.find((item) => item.agentId === adapter.id);
+            const enabled = this.ctx.config.agents[adapter.id]?.enabled !== false;
+            const checks = [];
+            checks.push({
+                status: detection?.installed === true ? 'ok' : detection?.strength === 'weak' ? 'warn' : 'skip',
+                title: 'Detected',
+                detail: detection === undefined
+                    ? 'detection failed'
+                    : detection.installed
+                        ? `yes${detection.version === undefined ? '' : ` (${detection.version})`}`
+                        : detection.strength === 'weak'
+                            ? 'weak evidence only'
+                            : 'no',
+                notes: detection?.evidence.map((item) => `${item.kind}: ${item.detail}`) ?? [],
+                ...(detection?.installed === true
+                    ? {}
+                    : { hint: `Use --agent ${adapter.aliases[0] ?? adapter.id} to target it anyway` }),
+            });
+            if (!enabled) {
+                checks.push({
+                    status: 'warn',
+                    title: 'Enabled',
+                    detail: 'disabled in config',
+                    hint: `Set agents.${adapter.id}.enabled to true in ${this.ctx.env.homeDir()}`,
+                });
+            }
+            for (const scope of INSTALL_SCOPES) {
+                if (scope === 'project' && projectRoot === undefined)
+                    continue;
+                for (const target of targetsFor(this.ctx, adapter, scope, projectRoot)) {
+                    checks.push(await this.directoryCheck(`${scope} ${target.kind} directory`, target.root));
+                }
+            }
+            sections.push({ title: adapter.displayName, checks });
+        }
+        return sections;
+    }
+    async directoryCheck(title, path) {
+        try {
+            if (!(await this.ctx.fs.exists(path))) {
+                return {
+                    status: 'skip',
+                    title,
+                    detail: `${path} (does not exist yet)`,
+                    hint: 'It is created on first install',
+                };
+            }
+            const stat = await this.ctx.fs.lstat(path);
+            if (stat.isSymbolicLink) {
+                const target = await this.ctx.fs.readlink(path).catch(() => '(unreadable)');
+                const broken = !(await this.ctx.fs.exists(path).catch(() => false));
+                return {
+                    status: broken ? 'fail' : 'warn',
+                    title,
+                    detail: `${path} -> ${target}${broken ? ' (broken link)' : ' (symlink)'}`,
+                    ...(broken ? { hint: 'Repair or remove the link before installing' } : {}),
+                };
+            }
+            if (!stat.isDirectory) {
+                return { status: 'fail', title, detail: `${path} exists but is not a directory` };
+            }
+            if (!(await this.ctx.fs.isWritable(path))) {
+                return {
+                    status: 'fail',
+                    title,
+                    detail: `${path} is not writable`,
+                    hint: 'Fix the permissions, or install into a different scope',
+                };
+            }
+            return { status: 'ok', title, detail: path };
+        }
+        catch (error) {
+            return {
+                status: 'fail',
+                title,
+                detail: `${path}: ${isAgentSkillsError(error) ? error.message : String(error)}`,
+            };
+        }
+    }
+    /** Reads every install receipt and reports drift, corruption and unmanaged directories. */
+    async installationsSection(projectRoot) {
+        const checks = [];
+        let managed = 0;
+        let modified = 0;
+        let unmanaged = 0;
+        for (const adapter of this.ctx.agents.all()) {
+            for (const scope of INSTALL_SCOPES) {
+                if (scope === 'project' && projectRoot === undefined)
+                    continue;
+                for (const target of targetsFor(this.ctx, adapter, scope, projectRoot)) {
+                    let skills;
+                    try {
+                        skills = await this.ctx.installer.list(target);
+                    }
+                    catch (error) {
+                        checks.push({
+                            status: 'fail',
+                            title: `${adapter.displayName} ${scope} ${target.kind} metadata`,
+                            detail: isAgentSkillsError(error) ? error.message : String(error),
+                        });
+                        continue;
+                    }
+                    for (const skill of skills) {
+                        if (skill.unmanaged) {
+                            unmanaged += 1;
+                            continue;
+                        }
+                        managed += 1;
+                        if (skill.modified) {
+                            modified += 1;
+                            checks.push({
+                                status: 'warn',
+                                title: `${skill.name} (${adapter.id}, ${scope}, ${target.kind})`,
+                                detail: 'files changed since installation',
+                                hint: `senior-skills install ${skill.name} --force   to restore, or leave it if the edits are intentional`,
+                            });
+                        }
+                    }
+                }
+            }
+        }
+        checks.unshift({
+            status: 'ok',
+            title: 'Installed package metadata',
+            detail: `${managed} managed · ${modified} modified · ${unmanaged} not managed by senior-skills`,
+        });
+        return { title: 'Installations', checks };
+    }
+}
+//# sourceMappingURL=diagnose.js.map

package/dist/application/diagnose.js.map

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

package/dist/application/install-skills.d.ts

@@ -0,0 +1,59 @@
+import type { AgentTarget, InstallScope } from '../domain/agent.ts';
+import type { InstallResult } from '../ports/installation.ts';
+import type { ValidationIssue } from '../domain/validation.ts';
+import { type AgentSelection } from './agent-selection.ts';
+import type { ApplicationContext } from './context.ts';
+import { type InstallResolvedSkill } from './resolve-suggestions.ts';
+export interface InstallOptions {
+    /** Raw `[registry:]name[@range]` strings from the command line. */
+    readonly refs: readonly string[];
+    readonly scope: InstallScope;
+    readonly agents?: readonly string[];
+    readonly projectRoot?: string;
+    readonly startDir?: string;
+    readonly registry?: string;
+    readonly force?: boolean;
+    readonly dryRun?: boolean;
+    /** Install exactly what was asked for, ignoring the dependency graph. */
+    readonly skipDependencies?: boolean;
+    /** Include only suggestions declared by the explicitly requested skills. */
+    readonly withSuggests?: boolean;
+    /** Update supplies ranges for already installed companions; new suggestions use normal pins. */
+    readonly suggestedVersionRanges?: Readonly<Record<string, string>>;
+}
+export interface InstallReport {
+    readonly scope: InstallScope;
+    readonly projectRoot?: string;
+    /** The roots actually written to: one per agent and package kind installed. */
+    readonly targets: readonly AgentTarget[];
+    readonly resolved: readonly InstallResolvedSkill[];
+    readonly results: readonly InstallResult[];
+    /** Non-fatal findings from package validation and optional-dependency skips. */
+    readonly warnings: readonly string[];
+    readonly dryRun: boolean;
+    readonly lockfileUpdated: boolean;
+}
+/**
+ * The install use case: resolve → fetch → verify → validate → install per agent → record.
+ *
+ * The service owns *ordering and policy*; it performs no filesystem mutation itself. Every
+ * write goes through the `InstallationEngine`, which is what keeps atomicity in one place.
+ */
+export declare class InstallSkills {
+    private readonly ctx;
+    constructor(ctx: ApplicationContext);
+    execute(options: InstallOptions): Promise<InstallReport>;
+    private resolve;
+    /**
+     * Fetches the payload, checks it against the lockfile pin, and validates it before any
+     * agent-specific work happens. Validation errors abort: installing a package we know is
+     * malformed just moves the failure into the agent.
+     */
+    private fetchAndVerify;
+    /** Empty `compatibility` means "every agent"; a non-empty list is an allowlist. */
+    private isCompatible;
+}
+export declare function formatIssue(issue: ValidationIssue): string;
+export type { AgentSelection };
+export type { InstallResolvedSkill };
+//# sourceMappingURL=install-skills.d.ts.map

package/dist/application/install-skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-skills.d.ts","sourceRoot":"","sources":["../../src/application/install-skills.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAMpE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAE9D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAgB,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACzE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAEvD,OAAO,EAAsB,KAAK,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAIzF,MAAM,WAAW,cAAc;IAC7B,mEAAmE;IACnE,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,yEAAyE;IACzE,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IACpC,4EAA4E;IAC5E,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;IAChC,gGAAgG;IAChG,QAAQ,CAAC,sBAAsB,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACpE;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,+EAA+E;IAC/E,QAAQ,CAAC,OAAO,EAAE,SAAS,WAAW,EAAE,CAAC;IACzC,QAAQ,CAAC,QAAQ,EAAE,SAAS,oBAAoB,EAAE,CAAC;IACnD,QAAQ,CAAC,OAAO,EAAE,SAAS,aAAa,EAAE,CAAC;IAC3C,gFAAgF;IAChF,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;CACnC;AAED;;;;;GAKG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAqB;gBAE7B,GAAG,EAAE,kBAAkB;IAI7B,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;YAqHhD,OAAO;IAkBrB;;;;OAIG;YACW,cAAc;IA8D5B,mFAAmF;IACnF,OAAO,CAAC,YAAY;CAIrB;AAiBD,wBAAgB,WAAW,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CAE1D;AAED,YAAY,EAAE,cAAc,EAAE,CAAC;AAC/B,YAAY,EAAE,oBAAoB,EAAE,CAAC"}

package/dist/application/install-skills.js

@@ -0,0 +1,191 @@
+import { AgentSkillsError, ErrorCode } from "../domain/errors.js";
+import { assertIntegrityMatches, withSkill } from "../domain/lockfile.js";
+import { Resolver } from "../domain/resolver.js";
+import { parseSkillRef } from "../domain/skill-ref.js";
+import { selectAgents } from "./agent-selection.js";
+import { FederationResolutionSource } from "./resolution-source.js";
+import { resolveSuggestions } from "./resolve-suggestions.js";
+import { validatePackage } from "./validate-package.js";
+import { pinsFrom, readLockfile, writeLockfile } from "./workspace.js";
+/**
+ * The install use case: resolve → fetch → verify → validate → install per agent → record.
+ *
+ * The service owns *ordering and policy*; it performs no filesystem mutation itself. Every
+ * write goes through the `InstallationEngine`, which is what keeps atomicity in one place.
+ */
+export class InstallSkills {
+    ctx;
+    constructor(ctx) {
+        this.ctx = ctx;
+    }
+    async execute(options) {
+        if (options.withSuggests === true && options.skipDependencies === true) {
+            throw new AgentSkillsError(ErrorCode.USAGE, '--with-suggests cannot be combined with --no-deps', {
+                hints: [
+                    'Use --with-suggests without --no-deps to include the suggestions and their dependencies',
+                ],
+            });
+        }
+        if (options.refs.length === 0) {
+            throw new AgentSkillsError(ErrorCode.USAGE, 'No skills given', {
+                hints: ['senior-skills install java-performance'],
+            });
+        }
+        const refs = options.refs.map((raw) => parseSkillRef(raw));
+        const selection = await selectAgents(this.ctx, {
+            scope: options.scope,
+            ...(options.agents === undefined ? {} : { agents: options.agents }),
+            ...(options.projectRoot === undefined ? {} : { projectRoot: options.projectRoot }),
+            ...(options.startDir === undefined ? {} : { startDir: options.startDir }),
+        });
+        const lock = options.scope === 'project' && selection.projectRoot !== undefined
+            ? await readLockfile(this.ctx.fs, selection.projectRoot)
+            : undefined;
+        const resolution = await this.resolve(refs, options, lock);
+        const warnings = [...resolution.warnings];
+        const results = [];
+        const used = new Map();
+        let nextLock = lock;
+        for (const skill of resolution.order) {
+            const fetched = await this.fetchAndVerify(skill, lock, warnings);
+            const kind = fetched.pkg.manifest.kind;
+            // A package goes only into the root its kind belongs in, and only for agents that have
+            // such a root at all: Codex has no user-invoked commands, so a command install there is
+            // reported as skipped rather than written into a directory it never reads.
+            const targets = selection.targets.filter((target) => target.kind === kind);
+            for (const adapter of selection.adapters) {
+                if (targets.some((target) => target.agentId === adapter.id))
+                    continue;
+                warnings.push(`${adapter.displayName} has no ${kind} directory; ${skill.name}@${skill.version} was skipped for it`);
+            }
+            const installedInto = [];
+            for (const target of targets) {
+                if (!this.isCompatible(skill, target)) {
+                    warnings.push(`${skill.name}@${skill.version} does not declare compatibility with ${target.agentId}; skipped`);
+                    continue;
+                }
+                const adapter = this.ctx.agents.find(target.agentId);
+                results.push(await this.ctx.installer.install({
+                    pkg: fetched.pkg,
+                    adapter,
+                    target,
+                    registry: fetched.registry,
+                    resolved: fetched.resolved,
+                    integrity: fetched.integrity,
+                    dependencyOf: skill.requiredBy,
+                    force: options.force === true,
+                    dryRun: options.dryRun === true,
+                }));
+                installedInto.push(target);
+                used.set(`${target.agentId}:${target.scope}:${target.kind}`, target);
+            }
+            if (nextLock !== undefined) {
+                nextLock = withSkill(nextLock, skill.name, {
+                    version: skill.version,
+                    registry: fetched.registry,
+                    resolved: fetched.resolved,
+                    integrity: fetched.integrity,
+                    agents: [...new Set(installedInto.map((target) => target.agentId))],
+                    dependencies: dependencyVersions(skill, resolution.order),
+                });
+            }
+        }
+        const lockfileUpdated = nextLock !== undefined &&
+            selection.projectRoot !== undefined &&
+            options.dryRun !== true &&
+            results.length > 0;
+        if (lockfileUpdated) {
+            await writeLockfile(this.ctx.fs, selection.projectRoot, {
+                ...nextLock,
+                generatedWith: this.ctx.toolVersion,
+            });
+        }
+        return {
+            scope: options.scope,
+            ...(selection.projectRoot === undefined ? {} : { projectRoot: selection.projectRoot }),
+            targets: [...used.values()],
+            resolved: resolution.order,
+            results,
+            warnings,
+            dryRun: options.dryRun === true,
+            lockfileUpdated,
+        };
+    }
+    async resolve(refs, options, lock) {
+        const source = new FederationResolutionSource(this.ctx.registry, options.registry);
+        const resolveOptions = {
+            // A bare `name` honours the lockfile pin; `name@latest` deliberately does not.
+            ...(lock === undefined ? {} : { pinned: pinsFrom(lock) }),
+            ...(options.skipDependencies === undefined
+                ? {}
+                : { skipDependencies: options.skipDependencies }),
+        };
+        return options.withSuggests === true
+            ? resolveSuggestions(source, refs, resolveOptions, options.suggestedVersionRanges)
+            : new Resolver(source).resolve(refs, resolveOptions);
+    }
+    /**
+     * Fetches the payload, checks it against the lockfile pin, and validates it before any
+     * agent-specific work happens. Validation errors abort: installing a package we know is
+     * malformed just moves the failure into the agent.
+     */
+    async fetchAndVerify(skill, lock, warnings) {
+        const registry = this.ctx.registry.named(skill.registry);
+        if (registry === undefined) {
+            throw new AgentSkillsError(ErrorCode.REGISTRY_NOT_FOUND, `No registry named "${skill.registry}"`);
+        }
+        const fetched = await registry.fetch(skill.name, skill.version);
+        const locked = lock?.skills[skill.name];
+        if (locked !== undefined && locked.version === skill.version) {
+            assertIntegrityMatches(skill.name, locked.integrity, fetched.integrity);
+        }
+        if (skill.entry.integrity !== undefined && skill.entry.integrity !== fetched.integrity) {
+            throw new AgentSkillsError(ErrorCode.INTEGRITY_MISMATCH, `Integrity mismatch for ${skill.name}@${skill.version}`, {
+                details: [
+                    `registry index declares: ${skill.entry.integrity}`,
+                    `downloaded content is:   ${fetched.integrity}`,
+                    '',
+                    'The payload does not match what the registry index says it should be.',
+                ],
+                hints: ['Report this to the registry maintainers before installing'],
+                data: { name: skill.name, version: skill.version },
+            });
+        }
+        const report = validatePackage(fetched.pkg, { adapters: this.ctx.agents.all() });
+        if (!report.ok) {
+            throw new AgentSkillsError(ErrorCode.INVALID_PACKAGE, `Package ${skill.name}@${skill.version} failed validation`, {
+                details: report.errors.map(formatIssue),
+                hints: ['This is a problem with the published package, not with your machine'],
+                data: { name: skill.name, version: skill.version, issues: report.errors },
+            });
+        }
+        for (const warning of report.warnings) {
+            warnings.push(`${skill.name}@${skill.version}: ${warning.message}`);
+        }
+        if (skill.entry.deprecated) {
+            warnings.push(`${skill.name}@${skill.version} is deprecated${skill.entry.deprecationReason === undefined ? '' : `: ${skill.entry.deprecationReason}`}`);
+        }
+        return fetched;
+    }
+    /** Empty `compatibility` means "every agent"; a non-empty list is an allowlist. */
+    isCompatible(skill, target) {
+        const declared = skill.manifest.compatibility;
+        return declared.length === 0 || declared.some((entry) => entry.id === target.agentId);
+    }
+}
+function dependencyVersions(skill, order) {
+    const versions = {};
+    for (const dependency of [
+        ...skill.manifest.dependencies,
+        ...skill.manifest.optionalDependencies,
+    ]) {
+        const resolved = order.find((candidate) => candidate.name === dependency.name);
+        if (resolved !== undefined)
+            versions[dependency.name] = resolved.version;
+    }
+    return versions;
+}
+export function formatIssue(issue) {
+    return `  ${issue.at}: ${issue.message}${issue.hint === undefined ? '' : ` (${issue.hint})`}`;
+}
+//# sourceMappingURL=install-skills.js.map

package/dist/application/install-skills.js.map

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

package/dist/application/list-installed.d.ts

@@ -0,0 +1,39 @@
+import { type AgentTarget, type InstallScope } from '../domain/agent.ts';
+import type { InstalledSkill } from '../ports/installation.ts';
+import type { ApplicationContext } from './context.ts';
+export interface ListOptions {
+    readonly agents?: readonly string[];
+    /** Omit to list both global and project scopes. */
+    readonly scope?: InstallScope;
+    readonly projectRoot?: string;
+    readonly startDir?: string;
+    /** Include directories in the skill root that the tool did not install. */
+    readonly includeUnmanaged?: boolean;
+}
+export interface ListEntry {
+    readonly target: AgentTarget;
+    readonly skills: readonly InstalledSkill[];
+}
+export interface ListReport {
+    readonly entries: readonly ListEntry[];
+    readonly projectRoot?: string;
+    readonly total: number;
+}
+/**
+ * Lists what is installed, per agent and scope.
+ *
+ * Unlike install, this never fails when an agent is undetected: showing an empty Codex
+ * section is more useful than an error, because the usual question is "what do I have?"
+ * rather than "what can I install into?".
+ */
+export declare class ListInstalled {
+    private readonly ctx;
+    constructor(ctx: ApplicationContext);
+    execute(options?: ListOptions): Promise<ListReport>;
+    /**
+     * Canonical form of a root for identity comparison. A root that does not exist yet has no
+     * canonical form to resolve — the resolved literal path is the best available identity.
+     */
+    private canonical;
+}
+//# sourceMappingURL=list-installed.d.ts.map

package/dist/application/list-installed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-installed.d.ts","sourceRoot":"","sources":["../../src/application/list-installed.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,WAAW,EAAE,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACzF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE/D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAGvD,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,mDAAmD;IACnD,QAAQ,CAAC,KAAK,CAAC,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,2EAA2E;IAC3E,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,CAAC;CACrC;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,SAAS,cAAc,EAAE,CAAC;CAC5C;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,OAAO,EAAE,SAAS,SAAS,EAAE,CAAC;IACvC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;GAMG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAqB;gBAE7B,GAAG,EAAE,kBAAkB;IAI7B,OAAO,CAAC,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,UAAU,CAAC;IAwD7D;;;OAGG;YACW,SAAS;CAIxB"}