@senior-skills/core 1.0.0

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

@@ -0,0 +1,34 @@
+import type { InstallScope } from '../domain/agent.ts';
+import type { UninstallResult } from '../ports/installation.ts';
+import type { ApplicationContext } from './context.ts';
+export interface RemoveOptions {
+    readonly names: readonly string[];
+    readonly scope: InstallScope;
+    readonly agents?: readonly string[];
+    readonly projectRoot?: string;
+    readonly startDir?: string;
+    /** Delete files whose content no longer matches the receipt. */
+    readonly force?: boolean;
+    readonly dryRun?: boolean;
+}
+export interface RemoveReport {
+    readonly results: readonly UninstallResult[];
+    readonly warnings: readonly string[];
+    readonly scope: InstallScope;
+    readonly projectRoot?: string;
+    readonly dryRun: boolean;
+    readonly lockfileUpdated: boolean;
+}
+/**
+ * Uninstall.
+ *
+ * The rule that shapes this service: never delete a file the tool did not install. The
+ * installer enforces it from the receipt; this service's job is to fail loudly when a name
+ * is not installed anywhere, rather than reporting a cheerful no-op.
+ */
+export declare class RemoveSkills {
+    private readonly ctx;
+    constructor(ctx: ApplicationContext);
+    execute(options: RemoveOptions): Promise<RemoveReport>;
+}
+//# sourceMappingURL=remove-skills.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"remove-skills.d.ts","sourceRoot":"","sources":["../../src/application/remove-skills.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAIvD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAEhE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAGvD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,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,gEAAgE;IAChE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,OAAO,EAAE,SAAS,eAAe,EAAE,CAAC;IAC7C,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;CACnC;AAED;;;;;;GAMG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAqB;gBAE7B,GAAG,EAAE,kBAAkB;IAI7B,OAAO,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;CAyF7D"}

package/dist/application/remove-skills.js

@@ -0,0 +1,95 @@
+import { AgentSkillsError, ErrorCode } from "../domain/errors.js";
+import { withoutSkill } from "../domain/lockfile.js";
+import { parseSkillRef } from "../domain/skill-ref.js";
+import { selectAgents } from "./agent-selection.js";
+import { readLockfile, writeLockfile } from "./workspace.js";
+/**
+ * Uninstall.
+ *
+ * The rule that shapes this service: never delete a file the tool did not install. The
+ * installer enforces it from the receipt; this service's job is to fail loudly when a name
+ * is not installed anywhere, rather than reporting a cheerful no-op.
+ */
+export class RemoveSkills {
+    ctx;
+    constructor(ctx) {
+        this.ctx = ctx;
+    }
+    async execute(options) {
+        if (options.names.length === 0) {
+            throw new AgentSkillsError(ErrorCode.USAGE, 'No skills given', {
+                hints: ['senior-skills uninstall java-performance'],
+            });
+        }
+        const names = options.names.map((raw) => parseSkillRef(raw).name);
+        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 results = [];
+        const warnings = [];
+        for (const name of names) {
+            let removedSomewhere = false;
+            for (const target of selection.targets) {
+                const installed = await this.ctx.installer.read(target, name);
+                if (installed === undefined)
+                    continue;
+                if (installed.unmanaged) {
+                    warnings.push(`${name} exists in ${target.root} but was not installed by senior-skills; left untouched`);
+                    continue;
+                }
+                const adapter = this.ctx.agents.find(target.agentId);
+                const result = await this.ctx.installer.uninstall({
+                    name,
+                    adapter,
+                    target,
+                    force: options.force === true,
+                    dryRun: options.dryRun === true,
+                });
+                results.push(result);
+                removedSomewhere = true;
+                for (const preserved of result.preserved) {
+                    warnings.push(`${name}: kept modified file ${preserved} (use --force to delete it)`);
+                }
+            }
+            if (!removedSomewhere) {
+                throw new AgentSkillsError(ErrorCode.NOT_INSTALLED, `"${name}" is not installed`, {
+                    details: [
+                        '',
+                        'Looked in:',
+                        ...selection.targets.map((target) => `  ${target.displayName} (${target.scope}): ${target.root}`),
+                    ],
+                    hints: ['senior-skills list   to see what is installed'],
+                    data: { name },
+                });
+            }
+        }
+        let lockfileUpdated = false;
+        if (options.scope === 'project' &&
+            selection.projectRoot !== undefined &&
+            options.dryRun !== true) {
+            let lock = await readLockfile(this.ctx.fs, selection.projectRoot);
+            const before = Object.keys(lock.skills).length;
+            for (const name of names)
+                lock = withoutSkill(lock, name);
+            if (Object.keys(lock.skills).length !== before) {
+                await writeLockfile(this.ctx.fs, selection.projectRoot, {
+                    ...lock,
+                    generatedWith: this.ctx.toolVersion,
+                });
+                lockfileUpdated = true;
+            }
+        }
+        return {
+            results,
+            warnings,
+            scope: options.scope,
+            ...(selection.projectRoot === undefined ? {} : { projectRoot: selection.projectRoot }),
+            dryRun: options.dryRun === true,
+            lockfileUpdated,
+        };
+    }
+}
+//# sourceMappingURL=remove-skills.js.map

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

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

package/dist/application/resolution-source.d.ts

@@ -0,0 +1,25 @@
+import type { IndexVersionEntry } from '../domain/registry-index.ts';
+import type { SkillManifest } from '../domain/manifest.ts';
+import type { ResolutionSource } from '../domain/resolver.ts';
+import type { SemanticVersion } from '../domain/version.ts';
+import type { FederatedRegistry } from '../ports/skill-registry.ts';
+/**
+ * Bridges the federated registry to the resolver.
+ *
+ * The resolver deliberately knows nothing about precedence or registry kinds; it asks for
+ * versions and gets back the registry that owned the answer, which is what ends up pinned
+ * in `skills.lock`.
+ */
+export declare class FederationResolutionSource implements ResolutionSource {
+    private readonly federation;
+    /** From `--registry`: restricts every lookup to one configured registry. */
+    private readonly restrictTo?;
+    constructor(federation: FederatedRegistry, restrictTo?: string);
+    listVersions(name: string, registry?: string): Promise<{
+        registry: string;
+        versions: readonly IndexVersionEntry[];
+    }>;
+    loadManifest(name: string, version: SemanticVersion, registry: string): Promise<SkillManifest>;
+    private require;
+}
+//# sourceMappingURL=resolution-source.d.ts.map

package/dist/application/resolution-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolution-source.d.ts","sourceRoot":"","sources":["../../src/application/resolution-source.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,KAAK,EAAE,iBAAiB,EAAiB,MAAM,4BAA4B,CAAC;AAEnF;;;;;;GAMG;AACH,qBAAa,0BAA2B,YAAW,gBAAgB;IACjE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoB;IAC/C,4EAA4E;IAC5E,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAS;gBAEzB,UAAU,EAAE,iBAAiB,EAAE,UAAU,CAAC,EAAE,MAAM;IAKxD,YAAY,CAChB,IAAI,EAAE,MAAM,EACZ,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,SAAS,iBAAiB,EAAE,CAAA;KAAE,CAAC;IAelE,YAAY,CAChB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,eAAe,EACxB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,aAAa,CAAC;IAIzB,OAAO,CAAC,OAAO;CAahB"}

package/dist/application/resolution-source.js

@@ -0,0 +1,60 @@
+import { AgentSkillsError, ErrorCode } from "../domain/errors.js";
+/**
+ * Bridges the federated registry to the resolver.
+ *
+ * The resolver deliberately knows nothing about precedence or registry kinds; it asks for
+ * versions and gets back the registry that owned the answer, which is what ends up pinned
+ * in `skills.lock`.
+ */
+export class FederationResolutionSource {
+    federation;
+    /** From `--registry`: restricts every lookup to one configured registry. */
+    restrictTo;
+    constructor(federation, restrictTo) {
+        this.federation = federation;
+        this.restrictTo = restrictTo;
+    }
+    async listVersions(name, registry) {
+        const requested = registry ?? this.restrictTo;
+        if (requested !== undefined) {
+            const target = this.require(requested);
+            const versions = await target.versions(name);
+            if (versions.length === 0)
+                throw notFound(name, requested);
+            return { registry: requested, versions };
+        }
+        const owner = await this.federation.ownerOf(name);
+        if (owner === undefined)
+            throw notFound(name);
+        return { registry: owner, versions: await this.require(owner).versions(name) };
+    }
+    async loadManifest(name, version, registry) {
+        return this.require(registry).manifest(name, version);
+    }
+    require(name) {
+        const registry = this.federation.named(name);
+        if (registry !== undefined)
+            return registry;
+        throw new AgentSkillsError(ErrorCode.REGISTRY_NOT_FOUND, `No registry named "${name}"`, {
+            details: [
+                '',
+                'Configured registries:',
+                ...this.federation.members().map((member) => `  ${member.name}  (${member.kind})`),
+            ],
+            hints: ['senior-skills registry list', 'senior-skills registry add <name> <url>'],
+            data: { requested: name },
+        });
+    }
+}
+function notFound(name, registry) {
+    return new AgentSkillsError(ErrorCode.SKILL_NOT_FOUND, registry === undefined
+        ? `Skill "${name}" was not found in any configured registry`
+        : `Skill "${name}" was not found in registry "${registry}"`, {
+        hints: [
+            `senior-skills search ${name}   to look for a similar name`,
+            'senior-skills registry list   to see where the CLI is looking',
+        ],
+        data: { name, ...(registry === undefined ? {} : { registry }) },
+    });
+}
+//# sourceMappingURL=resolution-source.js.map

package/dist/application/resolution-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolution-source.js","sourceRoot":"","sources":["../../src/application/resolution-source.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAOlE;;;;;;GAMG;AACH,MAAM,OAAO,0BAA0B;IACpB,UAAU,CAAoB;IAC/C,4EAA4E;IAC3D,UAAU,CAAU;IAErC,YAAY,UAA6B,EAAE,UAAmB;QAC5D,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,YAAY,CAChB,IAAY,EACZ,QAAiB;QAEjB,MAAM,SAAS,GAAG,QAAQ,IAAI,IAAI,CAAC,UAAU,CAAC;QAE9C,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YAC5B,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;YACvC,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YAC7C,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;gBAAE,MAAM,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;YAC3D,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC;QAC3C,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAClD,IAAI,KAAK,KAAK,SAAS;YAAE,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC9C,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;IACjF,CAAC;IAED,KAAK,CAAC,YAAY,CAChB,IAAY,EACZ,OAAwB,EACxB,QAAgB;QAEhB,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACxD,CAAC;IAEO,OAAO,CAAC,IAAY;QAC1B,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC7C,IAAI,QAAQ,KAAK,SAAS;YAAE,OAAO,QAAQ,CAAC;QAC5C,MAAM,IAAI,gBAAgB,CAAC,SAAS,CAAC,kBAAkB,EAAE,sBAAsB,IAAI,GAAG,EAAE;YACtF,OAAO,EAAE;gBACP,EAAE;gBACF,wBAAwB;gBACxB,GAAG,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,KAAK,MAAM,CAAC,IAAI,MAAM,MAAM,CAAC,IAAI,GAAG,CAAC;aACnF;YACD,KAAK,EAAE,CAAC,6BAA6B,EAAE,yCAAyC,CAAC;YACjF,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE;SAC1B,CAAC,CAAC;IACL,CAAC;CACF;AAED,SAAS,QAAQ,CAAC,IAAY,EAAE,QAAiB;IAC/C,OAAO,IAAI,gBAAgB,CACzB,SAAS,CAAC,eAAe,EACzB,QAAQ,KAAK,SAAS;QACpB,CAAC,CAAC,UAAU,IAAI,4CAA4C;QAC5D,CAAC,CAAC,UAAU,IAAI,gCAAgC,QAAQ,GAAG,EAC7D;QACE,KAAK,EAAE;YACL,wBAAwB,IAAI,+BAA+B;YAC3D,+DAA+D;SAChE;QACD,IAAI,EAAE,EAAE,IAAI,EAAE,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE;KAChE,CACF,CAAC;AACJ,CAAC"}

package/dist/application/resolve-suggestions.d.ts

@@ -0,0 +1,17 @@
+import { type ResolvedSkill, type ResolutionResult, type ResolutionSource, type ResolveOptions } from '../domain/resolver.ts';
+import { type SkillRef } from '../domain/skill-ref.ts';
+/** Installation provenance, separate from the domain's dependency graph. */
+export interface InstallResolvedSkill extends ResolvedSkill {
+    /** Explicitly requested skills whose selected manifests suggest this package. */
+    readonly suggestedBy?: readonly string[];
+}
+interface InstallationResolution extends ResolutionResult {
+    readonly order: readonly InstallResolvedSkill[];
+}
+/**
+ * Expand only the selected manifests of the original requests. Suggestions become additional
+ * resolution roots, never dependency edges; their own suggestions are not traversed.
+ */
+export declare function resolveSuggestions(source: ResolutionSource, refs: readonly SkillRef[], options: ResolveOptions, suggestedVersionRanges?: Readonly<Record<string, string>>): Promise<InstallationResolution>;
+export {};
+//# sourceMappingURL=resolve-suggestions.d.ts.map

package/dist/application/resolve-suggestions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-suggestions.d.ts","sourceRoot":"","sources":["../../src/application/resolve-suggestions.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACpB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAiB,KAAK,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAEtE,4EAA4E;AAC5E,MAAM,WAAW,oBAAqB,SAAQ,aAAa;IACzD,iFAAiF;IACjF,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1C;AAED,UAAU,sBAAuB,SAAQ,gBAAgB;IACvD,QAAQ,CAAC,KAAK,EAAE,SAAS,oBAAoB,EAAE,CAAC;CACjD;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,SAAS,QAAQ,EAAE,EACzB,OAAO,EAAE,cAAc,EACvB,sBAAsB,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAM,GAC5D,OAAO,CAAC,sBAAsB,CAAC,CA2EjC"}

package/dist/application/resolve-suggestions.js

@@ -0,0 +1,77 @@
+import { AgentSkillsError } from "../domain/errors.js";
+import { Resolver, } from "../domain/resolver.js";
+import { parseSkillRef } from "../domain/skill-ref.js";
+/**
+ * Expand only the selected manifests of the original requests. Suggestions become additional
+ * resolution roots, never dependency edges; their own suggestions are not traversed.
+ */
+export async function resolveSuggestions(source, refs, options, suggestedVersionRanges = {}) {
+    const resolver = new Resolver(source);
+    const initial = await resolver.resolve(refs, options);
+    const directNames = new Set(refs.map((ref) => ref.name));
+    const roots = initial.order.filter((skill) => directNames.has(skill.name));
+    const suggestedBy = new Map();
+    for (const root of roots) {
+        for (const name of root.manifest.suggests) {
+            const origins = suggestedBy.get(name) ?? new Set();
+            origins.add(root.name);
+            suggestedBy.set(name, origins);
+        }
+    }
+    if (suggestedBy.size === 0)
+        return initial;
+    // Exact qualified roots preserve the manifests from which suggestions were read. A
+    // companion constraint may conflict with a root, but must never silently replace it.
+    const expanded = roots.map((root) => parseSkillRef(`${root.registry}:${root.name}@${root.version}`));
+    const pinned = { ...options.pinned };
+    for (const root of roots)
+        delete pinned[root.name];
+    for (const name of [...suggestedBy.keys()].sort()) {
+        if (directNames.has(name))
+            continue;
+        const range = suggestedVersionRanges[name] ?? pinned[name];
+        expanded.push(parseSkillRef(range === undefined ? name : `${name}@${range}`));
+        // Its root constraint now enforces the pin/range. Keep manifest dependency ranges
+        // intact, particularly when update deliberately moves beyond a previous lock pin.
+        delete pinned[name];
+    }
+    let resolved;
+    try {
+        resolved = await resolver.resolve(expanded, { ...options, pinned });
+    }
+    catch (cause) {
+        if (!(cause instanceof AgentSkillsError))
+            throw cause;
+        const suggestions = [...suggestedBy].map(([name, origins]) => ({
+            name,
+            suggestedBy: [...origins].sort(),
+        }));
+        throw new AgentSkillsError(cause.code, cause.message, {
+            cause,
+            details: [
+                ...cause.details,
+                'Requested suggestions:',
+                ...suggestions.map(({ name, suggestedBy: origins }) => `  ${name} suggested by ${origins.join(', ')}`),
+            ],
+            hints: cause.hints,
+            data: { ...cause.data, suggestions },
+        });
+    }
+    return {
+        warnings: [...new Set([...initial.warnings, ...resolved.warnings])],
+        order: resolved.order.map((skill) => ({
+            ...skill,
+            direct: directNames.has(skill.name),
+            ...(suggestedBy.has(skill.name)
+                ? { suggestedBy: [...suggestedBy.get(skill.name)].sort() }
+                : {}),
+            // Derive ownership from the complete graph: a later constraint can refer to an
+            // already selected version without causing the resolver to choose it again.
+            requiredBy: resolved.order
+                .filter((owner) => [...owner.manifest.dependencies, ...owner.manifest.optionalDependencies].some((dependency) => dependency.name === skill.name))
+                .map((owner) => `${owner.name}@${owner.version}`)
+                .sort(),
+        })),
+    };
+}
+//# sourceMappingURL=resolve-suggestions.js.map

package/dist/application/resolve-suggestions.js.map

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

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

@@ -0,0 +1,36 @@
+import type { IndexVersionEntry } from '../domain/registry-index.ts';
+import type { SkillManifest } from '../domain/manifest.ts';
+import type { InstalledSkill } from '../ports/installation.ts';
+import type { SkillSummary } from '../ports/skill-registry.ts';
+import type { ApplicationContext } from './context.ts';
+export interface SearchOptions {
+    readonly query: string;
+    readonly registry?: string;
+    readonly limit?: number;
+}
+export declare class SearchSkills {
+    private readonly ctx;
+    constructor(ctx: ApplicationContext);
+    execute(options: SearchOptions): Promise<readonly SkillSummary[]>;
+}
+export interface SkillInfo {
+    readonly name: string;
+    readonly registry: string;
+    readonly manifest: SkillManifest;
+    readonly versions: readonly IndexVersionEntry[];
+    readonly latest: IndexVersionEntry;
+    /** Where this skill is currently installed, across every agent and scope. */
+    readonly installed: readonly InstalledSkill[];
+}
+/**
+ * `info` answers "what is this and do I have it?" in one call, which is why it joins registry
+ * metadata with local install state rather than making the user run two commands.
+ */
+export declare class DescribeSkill {
+    private readonly ctx;
+    constructor(ctx: ApplicationContext);
+    execute(rawRef: string, options?: {
+        readonly registry?: string;
+    }): Promise<SkillInfo>;
+}
+//# sourceMappingURL=search-skills.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"search-skills.d.ts","sourceRoot":"","sources":["../../src/application/search-skills.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAE3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAGvD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAqB;gBAE7B,GAAG,EAAE,kBAAkB;IAI7B,OAAO,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,SAAS,YAAY,EAAE,CAAC;CA0BxE;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IACjC,QAAQ,CAAC,QAAQ,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAChD,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACnC,6EAA6E;IAC7E,QAAQ,CAAC,SAAS,EAAE,SAAS,cAAc,EAAE,CAAC;CAC/C;AAED;;;GAGG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAqB;gBAE7B,GAAG,EAAE,kBAAkB;IAI7B,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,OAAO,CAAC,SAAS,CAAC;CA+DhG"}

package/dist/application/search-skills.js

@@ -0,0 +1,78 @@
+import { AgentSkillsError, ErrorCode } from "../domain/errors.js";
+import { parseSkillRef } from "../domain/skill-ref.js";
+import { ListInstalled } from "./list-installed.js";
+export class SearchSkills {
+    ctx;
+    constructor(ctx) {
+        this.ctx = ctx;
+    }
+    async execute(options) {
+        const source = options.registry === undefined
+            ? this.ctx.registry
+            : this.ctx.registry.named(options.registry);
+        if (source === undefined) {
+            throw new AgentSkillsError(ErrorCode.REGISTRY_NOT_FOUND, `No registry named "${options.registry}"`, {
+                details: [
+                    '',
+                    'Configured registries:',
+                    ...this.ctx.registry.members().map((member) => `  ${member.name}  (${member.kind})`),
+                ],
+                hints: ['senior-skills registry list'],
+            });
+        }
+        return source.search({
+            text: options.query,
+            ...(options.limit === undefined ? {} : { limit: options.limit }),
+        });
+    }
+}
+/**
+ * `info` answers "what is this and do I have it?" in one call, which is why it joins registry
+ * metadata with local install state rather than making the user run two commands.
+ */
+export class DescribeSkill {
+    ctx;
+    constructor(ctx) {
+        this.ctx = ctx;
+    }
+    async execute(rawRef, options = {}) {
+        const ref = parseSkillRef(rawRef);
+        const registryName = ref.registry ?? options.registry ?? (await this.ctx.registry.ownerOf(ref.name));
+        if (registryName === undefined) {
+            throw new AgentSkillsError(ErrorCode.SKILL_NOT_FOUND, `Skill "${ref.name}" was not found in any configured registry`, {
+                hints: [`senior-skills search ${ref.name}`, 'senior-skills registry list'],
+                data: { name: ref.name },
+            });
+        }
+        const registry = this.ctx.registry.named(registryName);
+        if (registry === undefined) {
+            throw new AgentSkillsError(ErrorCode.REGISTRY_NOT_FOUND, `No registry named "${registryName}"`);
+        }
+        const versions = await registry.versions(ref.name);
+        if (versions.length === 0) {
+            throw new AgentSkillsError(ErrorCode.SKILL_NOT_FOUND, `Skill "${ref.name}" was not found in registry "${registryName}"`, { hints: [`senior-skills search ${ref.name}`], data: { name: ref.name } });
+        }
+        const selected = ref.range === undefined || ref.range === 'latest'
+            ? (versions.find((entry) => !entry.deprecated) ?? versions[0])
+            : versions.find((entry) => entry.version === ref.range);
+        if (selected === undefined) {
+            throw new AgentSkillsError(ErrorCode.VERSION_NOT_FOUND, `${ref.name}@${ref.range} was not found`, {
+                details: ['', `Published versions: ${versions.map((entry) => entry.version).join(', ')}`],
+                data: { name: ref.name, range: ref.range },
+            });
+        }
+        const list = await new ListInstalled(this.ctx).execute({});
+        const installed = list.entries
+            .flatMap((entry) => entry.skills)
+            .filter((skill) => skill.name === ref.name);
+        return {
+            name: ref.name,
+            registry: registryName,
+            manifest: await registry.manifest(ref.name, selected.version),
+            versions,
+            latest: selected,
+            installed,
+        };
+    }
+}
+//# sourceMappingURL=search-skills.js.map

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

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

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

@@ -0,0 +1,55 @@
+import type { InstallScope } from '../domain/agent.ts';
+import { type SemanticVersion, type VersionBump } from '../domain/version.ts';
+import type { InstallResult } from '../ports/installation.ts';
+import type { ApplicationContext } from './context.ts';
+import { type InstallReport } from './install-skills.ts';
+export interface UpdateOptions {
+    /** Empty means "everything installed in this scope". */
+    readonly names: readonly string[];
+    readonly scope: InstallScope;
+    readonly agents?: readonly string[];
+    readonly projectRoot?: string;
+    readonly startDir?: string;
+    readonly registry?: string;
+    readonly dryRun?: boolean;
+    /**
+     * Allow a major-version jump. Without it, update stays within the current major, which is
+     * the behaviour people expect from `update` as opposed to `install <name>@latest`.
+     */
+    readonly major?: boolean;
+    readonly force?: boolean;
+    /** Include direct suggestions of explicitly named update targets for this invocation. */
+    readonly withSuggests?: boolean;
+}
+export interface UpdateChange {
+    readonly name: string;
+    readonly from: SemanticVersion;
+    readonly to: SemanticVersion;
+    readonly bump: VersionBump;
+}
+export interface UpdateReport {
+    readonly changes: readonly UpdateChange[];
+    readonly additions: readonly UpdateAddition[];
+    readonly unchanged: readonly string[];
+    readonly install: InstallReport;
+}
+export interface UpdateAddition {
+    readonly name: string;
+    readonly version: SemanticVersion;
+    readonly suggestedBy: readonly string[];
+    /** New destinations, or empty for a new package skipped everywhere. Dry runs describe the plan. */
+    readonly results: readonly InstallResult[];
+}
+/**
+ * Update: detect current → resolve newest compatible → install atomically → report the diff.
+ *
+ * Implemented on top of {@link InstallSkills} rather than beside it. The install pipeline
+ * already does fetch/verify/validate/atomic-commit correctly; duplicating it here would mean
+ * two places to keep safe.
+ */
+export declare class UpdateSkills {
+    private readonly ctx;
+    constructor(ctx: ApplicationContext);
+    execute(options: UpdateOptions): Promise<UpdateReport>;
+}
+//# sourceMappingURL=update-skills.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"update-skills.d.ts","sourceRoot":"","sources":["../../src/application/update-skills.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,OAAO,EAAkB,KAAK,eAAe,EAAE,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAC9F,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAE9D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,EAAiB,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAExE,MAAM,WAAW,aAAa;IAC5B,wDAAwD;IACxD,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,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,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B;;;OAGG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,yFAAyF;IACzF,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;CACjC;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,QAAQ,CAAC,EAAE,EAAE,eAAe,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;CAC5B;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,OAAO,EAAE,SAAS,YAAY,EAAE,CAAC;IAC1C,QAAQ,CAAC,SAAS,EAAE,SAAS,cAAc,EAAE,CAAC;IAC9C,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;CACjC;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,mGAAmG;IACnG,QAAQ,CAAC,OAAO,EAAE,SAAS,aAAa,EAAE,CAAC;CAC5C;AAED;;;;;;GAMG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAqB;gBAE7B,GAAG,EAAE,kBAAkB;IAI7B,OAAO,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;CAkH7D"}