@axm.sh/cli 0.0.1

package/dist/src/cli-commands/skills/install/install-skill.js

@@ -0,0 +1,231 @@
+/**
+ * Install skill executor — orchestrates the full per-skill installation pipeline.
+ *
+ * Pipeline: sanitize name → validate paths → remove old canonical → copy files →
+ * symlink from agent dirs (concurrent) → update lockfile.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as FileSystem from "@effect/platform/FileSystem";
+import * as Path from "@effect/platform/Path";
+import * as Effect from "effect/Effect";
+import * as Option from "effect/Option";
+import { getAgentById } from "../../../agents/registry.js";
+import { printSourceInput } from "../../../sources/index.js";
+import { Log } from "../../../tui/index.js";
+import { createSymlink } from "../../../utils/create-symlink.js";
+import { isPathSafe } from "../../../utils/path-safety.js";
+import { OperationError } from "../../../workspace/apply-plan.js";
+import { Workspace } from "../../../workspace/service.js";
+import { copySkillDirectory } from "../copy-skill-directory.js";
+import { sourceToLockEntry } from "../source-to-lock-entry.js";
+import { sanitizeName } from "./skill-utils.js";
+// -----------------------------------------------------------------------------
+// Constants
+// -----------------------------------------------------------------------------
+const CANONICAL_SKILLS_DIR = ".agents/skills";
+const REGISTRY_EXTENSIONS_DIR = ".axm/extensions";
+// -----------------------------------------------------------------------------
+// Helpers
+// -----------------------------------------------------------------------------
+const installForAgent = (opts) => Effect.gen(function* () {
+    const path = yield* Path.Path;
+    const maybeAgent = getAgentById(opts.agentId);
+    if (Option.isNone(maybeAgent)) {
+        return {
+            success: false,
+            mode: "symlink",
+            symlinkFailed: false,
+            error: Option.some(`Unknown agent: ${opts.agentId}`),
+            path: "",
+            canonicalPath: opts.canonicalPath,
+        };
+    }
+    const agent = maybeAgent.value;
+    const agentSkillPath = path.join(opts.base, agent.skills.dir, opts.sanitizedName);
+    // Self-reference detection: agent's skills.dir resolves to canonical location
+    const agentSkillsDir = path.resolve(opts.base, agent.skills.dir);
+    const canonicalSkillsDir = path.resolve(opts.base, CANONICAL_SKILLS_DIR);
+    if (agentSkillsDir === canonicalSkillsDir) {
+        // Universal agent — reads directly from canonical, no symlink needed
+        return {
+            success: true,
+            mode: "symlink",
+            symlinkFailed: false,
+            error: Option.none(),
+            path: agentSkillPath,
+            canonicalPath: opts.canonicalPath,
+        };
+    }
+    // Validate agent path safety
+    if (!isPathSafe(opts.base, agentSkillPath)) {
+        return {
+            success: false,
+            mode: "symlink",
+            symlinkFailed: false,
+            error: Option.some(`Path traversal detected for agent ${opts.agentId}`),
+            path: agentSkillPath,
+            canonicalPath: opts.canonicalPath,
+        };
+    }
+    // Try symlink, fall back to copy
+    return yield* createSymlink({ target: opts.canonicalPath, link: agentSkillPath }).pipe(Effect.map(() => ({
+        success: true,
+        mode: "symlink",
+        symlinkFailed: false,
+        error: Option.none(),
+        path: agentSkillPath,
+        canonicalPath: opts.canonicalPath,
+    })), Effect.catchTag("SymlinkError", () => 
+    // Fallback: copy the canonical directory to the agent path
+    copySkillDirectory(opts.canonicalPath, agentSkillPath).pipe(Effect.map(() => ({
+        success: true,
+        mode: "copy",
+        symlinkFailed: true,
+        error: Option.none(),
+        path: agentSkillPath,
+        canonicalPath: opts.canonicalPath,
+    })), Effect.catchAll((copyErr) => Effect.succeed({
+        success: false,
+        mode: "copy",
+        symlinkFailed: true,
+        error: Option.some(`Copy fallback failed: ${copyErr.message}`),
+        path: agentSkillPath,
+        canonicalPath: opts.canonicalPath,
+    })))));
+});
+// -----------------------------------------------------------------------------
+// Public API
+// -----------------------------------------------------------------------------
+/**
+ * Remove a directory if it exists, ignoring errors.
+ */
+const removeIfExists = (fsService, dirPath) => fsService.exists(dirPath).pipe(Effect.catchAll(() => Effect.succeed(false)), Effect.flatMap((exists) => exists ? fsService.remove(dirPath, { recursive: true }).pipe(Effect.ignore) : Effect.void));
+/**
+ * Pre-clean from ALL known canonical locations for a skill.
+ *
+ * Ensures clean transitions when source type changes (e.g., fork workflow).
+ * Removes from:
+ * 1. `.agents/skills/<name>/` (non-registry canonical)
+ * 2. `.axm/extensions/@* /skills/<name>/` (registry canonical, any scope)
+ */
+const preCleanAllLocations = (fsService, base, sanitizedName, pathService) => Effect.gen(function* () {
+    // Remove from non-registry canonical location
+    yield* removeIfExists(fsService, pathService.join(base, CANONICAL_SKILLS_DIR, sanitizedName));
+    // Remove from any registry canonical location
+    const extensionsDir = pathService.join(base, REGISTRY_EXTENSIONS_DIR);
+    const extensionsDirExists = yield* fsService
+        .exists(extensionsDir)
+        .pipe(Effect.catchAll(() => Effect.succeed(false)));
+    if (extensionsDirExists) {
+        const scopeDirs = yield* fsService
+            .readDirectory(extensionsDir)
+            .pipe(Effect.catchAll(() => Effect.succeed([])));
+        yield* Effect.forEach(scopeDirs, (scopeDir) => {
+            if (!scopeDir.startsWith("@"))
+                return Effect.void;
+            const skillPath = pathService.join(extensionsDir, scopeDir, "skills", sanitizedName);
+            return removeIfExists(fsService, skillPath);
+        }, { concurrency: "unbounded" });
+    }
+});
+/**
+ * Install-skill operation handler.
+ *
+ * Reads workspace paths from the Workspace service, then orchestrates:
+ * 1. Sanitize skill name for filesystem
+ * 2. Validate all paths stay within the workspace base
+ * 3. Pre-clean from all known canonical locations
+ * 4. Copy skill files to canonical location
+ * 5. Create symlinks from each agent's skills dir (concurrent)
+ * 6. Update lockfile entry (failures logged as warnings)
+ */
+export const installSkill = (op) => Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    const path = yield* Path.Path;
+    const ws = yield* Workspace;
+    const log = yield* Log;
+    const axmDir = ws.path;
+    const base = path.dirname(axmDir);
+    const sanitizedName = sanitizeName(op.args.skill.name);
+    // Determine canonical path based on source type
+    const isRegistry = op.args.source.type === "registry";
+    // Normalize scope: parser gives "community" (no @), filesystem uses "@community"
+    const registryScope = isRegistry
+        ? op.args.source.scope.startsWith("@")
+            ? op.args.source.scope
+            : `@${op.args.source.scope}`
+        : undefined;
+    const canonicalPath = isRegistry
+        ? path.join(base, REGISTRY_EXTENSIONS_DIR, registryScope, "skills", sanitizedName)
+        : path.join(base, CANONICAL_SKILLS_DIR, sanitizedName);
+    // Validate canonical path safety
+    if (!isPathSafe(base, canonicalPath)) {
+        return yield* new OperationError({
+            operation: "install-skill",
+            message: `Path traversal detected in skill name "${op.args.skill.name}"`,
+            cause: null,
+        });
+    }
+    // For registry sources, content lives in src/ subdirectory; for others, content is at canonical root
+    const contentPath = isRegistry ? path.join(canonicalPath, "src") : canonicalPath;
+    // Resolve source path — the skill files to copy from
+    const sourcePath = op.args.location.replace(/^file:\/\//, "");
+    // Skip pre-clean and copy when source is already the content location
+    // (e.g., fork workflow where files are already in place)
+    const isSelfCopy = path.resolve(sourcePath) === path.resolve(contentPath);
+    if (!isSelfCopy) {
+        // Pre-clean from ALL known locations (ensures clean transitions between source types)
+        yield* preCleanAllLocations(fs, base, sanitizedName, path);
+        // For registry sources, copy to canonicalPath (extracted zip has manifest + src/)
+        // For other sources, copy to contentPath (no subdirectory structure)
+        const copyTarget = isRegistry ? canonicalPath : contentPath;
+        yield* copySkillDirectory(sourcePath, copyTarget).pipe(Effect.mapError((e) => new OperationError({
+            operation: "install-skill",
+            message: `Failed to copy skill files to ${copyTarget}`,
+            cause: e,
+        })));
+    }
+    // Create symlinks for each agent (concurrent)
+    // Symlinks target contentPath so agents only see skill content (not manifest)
+    const agentResults = yield* Effect.forEach(op.args.agents, (agentId) => installForAgent({
+        agentId,
+        canonicalPath: contentPath,
+        sanitizedName,
+        base,
+    }), { concurrency: "unbounded" });
+    // Update settings + lockfile atomically (warn on errors)
+    yield* ws
+        .setSkill(op.args.skill.name, printSourceInput(op.args.source), sourceToLockEntry({
+        source: op.args.source,
+        agents: op.args.agents,
+        gitTreeSha: op.args.gitTreeSha,
+        now: new Date(),
+        ...(isRegistry && {
+            registry: {
+                scope: registryScope,
+                name: sanitizedName,
+                resolvedVersion: Option.getOrElse(op.args.version, () => "0.0.0"),
+                checksum: "",
+                sourceName: "default",
+            },
+        }),
+    }))
+        .pipe(Effect.catchAll((e) => log.warn(`Skill update failed: ${String(e)}`)));
+    // Determine overall result
+    const anyFailed = agentResults.some((r) => !r.success);
+    if (anyFailed) {
+        const failedAgents = agentResults
+            .filter((r) => !r.success)
+            .map((r) => Option.getOrElse(r.error, () => "unknown error"));
+        return {
+            result: "error",
+            message: `Failed to install ${op.args.skill.name} for some agents: ${failedAgents.join(", ")}`,
+        };
+    }
+    return {
+        result: "success",
+        message: `Installed ${op.args.skill.name}`,
+    };
+});
+//# sourceMappingURL=install-skill.js.map

package/dist/src/cli-commands/skills/install/install-skill.js.map

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

package/dist/src/cli-commands/skills/install/parse-manifests.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Plugin manifest parsing for skill discovery.
+ *
+ * Parses .claude-plugin/marketplace.json and .claude-plugin/plugin.json
+ * to discover explicitly declared skill directories.
+ */
+import * as FileSystem from "@effect/platform/FileSystem";
+import * as Path from "@effect/platform/Path";
+import * as Effect from "effect/Effect";
+/**
+ * Parse plugin manifests and return validated skill parent directories.
+ * All paths are validated to be within basePath.
+ * Errors are silently skipped (returns empty array on failure).
+ */
+export declare const parseManifests: (basePath: string) => Effect.Effect<ReadonlyArray<string>, never, FileSystem.FileSystem | Path.Path>;
+//# sourceMappingURL=parse-manifests.d.ts.map

package/dist/src/cli-commands/skills/install/parse-manifests.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-manifests.d.ts","sourceRoot":"","sources":["../../../../../src/cli-commands/skills/install/parse-manifests.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,UAAU,MAAM,6BAA6B,CAAC;AAC1D,OAAO,KAAK,IAAI,MAAM,uBAAuB,CAAC;AAE9C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAsLxC;;;;GAIG;AACH,eAAO,MAAM,cAAc,GACzB,UAAU,MAAM,KACf,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,UAAU,CAAC,UAAU,GAAG,IAAI,CAAC,IAAI,CAO5E,CAAC"}

package/dist/src/cli-commands/skills/install/parse-manifests.js

@@ -0,0 +1,161 @@
+/**
+ * Plugin manifest parsing for skill discovery.
+ *
+ * Parses .claude-plugin/marketplace.json and .claude-plugin/plugin.json
+ * to discover explicitly declared skill directories.
+ */
+import * as FileSystem from "@effect/platform/FileSystem";
+import * as Path from "@effect/platform/Path";
+import * as Array from "effect/Array";
+import * as Effect from "effect/Effect";
+import * as Option from "effect/Option";
+import * as Schema from "effect/Schema";
+// -----------------------------------------------------------------------------
+// Path Validation
+// -----------------------------------------------------------------------------
+/**
+ * Validate a raw skill path from a manifest.
+ * Must start with `./`, must not contain `..`, and must resolve within basePath.
+ * Returns the parent directory of the skill path on success.
+ */
+const validatePath = (rawPath, basePath, path) => {
+    // Must start with ./
+    if (!rawPath.startsWith("./"))
+        return Option.none();
+    // Must not contain ..
+    if (rawPath.includes(".."))
+        return Option.none();
+    // Resolve and check within basePath
+    const resolved = path.resolve(basePath, rawPath);
+    const normalizedBase = path.resolve(basePath);
+    if (!resolved.startsWith(normalizedBase + path.sep) && resolved !== normalizedBase) {
+        return Option.none();
+    }
+    // Return parent directory of the skill path
+    return Option.some(path.dirname(resolved));
+};
+// -----------------------------------------------------------------------------
+// Manifest Parsers
+// -----------------------------------------------------------------------------
+const MarketplacePlugin = Schema.Struct({
+    source: Schema.optional(Schema.Unknown),
+    skills: Schema.optional(Schema.Array(Schema.String)),
+});
+const MarketplaceManifest = Schema.Struct({
+    metadata: Schema.optional(Schema.Struct({ pluginRoot: Schema.optional(Schema.String) })),
+    plugins: Schema.Array(MarketplacePlugin),
+});
+const PluginManifest = Schema.Struct({
+    skills: Schema.Array(Schema.String),
+});
+/**
+ * Read a file and parse as JSON, returning None on any failure.
+ */
+const readJsonFile = (filePath) => Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    const content = yield* fs.readFileString(filePath).pipe(Effect.option);
+    if (Option.isNone(content))
+        return Option.none();
+    return yield* Effect.try(() => JSON.parse(content.value)).pipe(Effect.map((json) => Option.some(json)), Effect.orElseSucceed(() => Option.none()));
+});
+/**
+ * Validate a directory path from a manifest (not a skill path — no dirname).
+ * Must start with `./`, must not contain `..`, and must resolve within basePath.
+ * Returns the resolved directory path on success.
+ */
+const validateDirPath = (rawPath, basePath, path) => {
+    if (!rawPath.startsWith("./"))
+        return Option.none();
+    if (rawPath.includes(".."))
+        return Option.none();
+    const resolved = path.resolve(basePath, rawPath);
+    const normalizedBase = path.resolve(basePath);
+    if (!resolved.startsWith(normalizedBase + path.sep) && resolved !== normalizedBase) {
+        return Option.none();
+    }
+    return Option.some(resolved);
+};
+/**
+ * Resolve a plugin's base directory from its source field and pluginRoot.
+ * - string source: must start with `./`, resolve relative to basePath + pluginRoot
+ * - omitted source: resolve to basePath + pluginRoot (or basePath if no pluginRoot)
+ * - object source: skip (remote plugin)
+ */
+const resolvePluginBase = (source, basePath, pluginRoot, path) => {
+    const rootBase = pluginRoot ? path.resolve(basePath, pluginRoot) : path.resolve(basePath);
+    // Object source → skip plugin
+    if (typeof source === "object" && source !== null)
+        return Option.none();
+    if (typeof source === "string") {
+        return validateDirPath(source, rootBase, path);
+    }
+    // Omitted source → root-level plugin
+    return Option.some(rootBase);
+};
+/**
+ * Parse .claude-plugin/marketplace.json and return validated skill parent directories.
+ *
+ * Supports metadata.pluginRoot, per-plugin source (string/omitted/object),
+ * per-plugin skills array, and conventional {pluginBase}/skills/ directory.
+ */
+const parseMarketplaceJson = (basePath) => Effect.gen(function* () {
+    const path = yield* Path.Path;
+    const manifestPath = path.join(basePath, ".claude-plugin", "marketplace.json");
+    const json = yield* readJsonFile(manifestPath);
+    if (Option.isNone(json))
+        return [];
+    const data = yield* Schema.decodeUnknown(MarketplaceManifest)(json.value).pipe(Effect.option);
+    if (Option.isNone(data))
+        return [];
+    // pluginRoot validation: if present and doesn't start with ./, skip entire manifest
+    const pluginRoot = data.value.metadata?.pluginRoot;
+    if (pluginRoot !== undefined && !pluginRoot.startsWith("./"))
+        return [];
+    const dirs = [];
+    for (const plugin of data.value.plugins) {
+        const pluginBase = resolvePluginBase(plugin.source, basePath, pluginRoot, path);
+        if (Option.isNone(pluginBase))
+            continue;
+        // Conventional {pluginBase}/skills/ always added
+        dirs.push(path.join(pluginBase.value, "skills"));
+        // Explicit skill paths transformed via dirname
+        if (plugin.skills) {
+            for (const skillPath of plugin.skills) {
+                const validated = validatePath(skillPath, pluginBase.value, path);
+                if (Option.isSome(validated)) {
+                    dirs.push(validated.value);
+                }
+            }
+        }
+    }
+    return dirs;
+});
+/**
+ * Parse .claude-plugin/plugin.json and return validated skill parent directories.
+ *
+ * Expected shape: { skills: string[] }
+ */
+const parsePluginJson = (basePath) => Effect.gen(function* () {
+    const path = yield* Path.Path;
+    const manifestPath = path.join(basePath, ".claude-plugin", "plugin.json");
+    const json = yield* readJsonFile(manifestPath);
+    if (Option.isNone(json))
+        return [];
+    const data = yield* Schema.decodeUnknown(PluginManifest)(json.value).pipe(Effect.option);
+    if (Option.isNone(data))
+        return [];
+    return Array.filterMap(data.value.skills, (skillPath) => validatePath(skillPath, basePath, path));
+});
+// -----------------------------------------------------------------------------
+// Public API
+// -----------------------------------------------------------------------------
+/**
+ * Parse plugin manifests and return validated skill parent directories.
+ * All paths are validated to be within basePath.
+ * Errors are silently skipped (returns empty array on failure).
+ */
+export const parseManifests = (basePath) => Effect.gen(function* () {
+    const [marketplaceDirs, pluginDirs] = yield* Effect.all([parseMarketplaceJson(basePath), parsePluginJson(basePath)], { concurrency: "unbounded" });
+    return Array.dedupe([...marketplaceDirs, ...pluginDirs]);
+});
+//# sourceMappingURL=parse-manifests.js.map

package/dist/src/cli-commands/skills/install/parse-manifests.js.map

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

package/dist/src/cli-commands/skills/install/parse-skill-md.d.ts

@@ -0,0 +1,18 @@
+/**
+ * SKILL.md frontmatter parser.
+ *
+ * Parses YAML frontmatter from SKILL.md files to extract skill metadata.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as Option from "effect/Option";
+import type { Skill } from "../operations.js";
+/**
+ * Parse a SKILL.md file's content and extract skill metadata from frontmatter.
+ *
+ * Returns `Option.some(Skill)` when the file has valid YAML frontmatter with
+ * non-empty `name` and `description` fields. Returns `Option.none()` for any
+ * invalid input: missing frontmatter, invalid YAML, or missing/empty required fields.
+ */
+export declare const parseSkillMd: (content: string) => Option.Option<Skill>;
+//# sourceMappingURL=parse-skill-md.d.ts.map

package/dist/src/cli-commands/skills/install/parse-skill-md.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-skill-md.d.ts","sourceRoot":"","sources":["../../../../../src/cli-commands/skills/install/parse-skill-md.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAE9C;;;;;;GAMG;AACH,eAAO,MAAM,YAAY,GAAI,SAAS,MAAM,KAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAiCjE,CAAC"}

package/dist/src/cli-commands/skills/install/parse-skill-md.js

@@ -0,0 +1,47 @@
+/**
+ * SKILL.md frontmatter parser.
+ *
+ * Parses YAML frontmatter from SKILL.md files to extract skill metadata.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import matter from "gray-matter";
+import * as Option from "effect/Option";
+import * as Record from "effect/Record";
+/**
+ * Parse a SKILL.md file's content and extract skill metadata from frontmatter.
+ *
+ * Returns `Option.some(Skill)` when the file has valid YAML frontmatter with
+ * non-empty `name` and `description` fields. Returns `Option.none()` for any
+ * invalid input: missing frontmatter, invalid YAML, or missing/empty required fields.
+ */
+export const parseSkillMd = (content) => {
+    try {
+        const { data } = matter(content);
+        const name = data["name"];
+        const description = data["description"];
+        const rawMetadata = data["metadata"];
+        // Require non-empty name
+        if (typeof name !== "string" || name.trim() === "") {
+            return Option.none();
+        }
+        // Require non-empty description
+        if (typeof description !== "string" || description.trim() === "") {
+            return Option.none();
+        }
+        // Extract optional metadata
+        const metadata = rawMetadata != null && typeof rawMetadata === "object" && !Array.isArray(rawMetadata)
+            ? Option.some(rawMetadata)
+            : Option.none();
+        return Option.some({
+            name,
+            description,
+            metadata,
+        });
+    }
+    catch {
+        // Invalid YAML or other parsing errors — silently skip
+        return Option.none();
+    }
+};
+//# sourceMappingURL=parse-skill-md.js.map

package/dist/src/cli-commands/skills/install/parse-skill-md.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-skill-md.js","sourceRoot":"","sources":["../../../../../src/cli-commands/skills/install/parse-skill-md.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAGxC;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,OAAe,EAAwB,EAAE;IACpE,IAAI,CAAC;QACH,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;QAEjC,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;QAC1B,MAAM,WAAW,GAAG,IAAI,CAAC,aAAa,CAAC,CAAC;QACxC,MAAM,WAAW,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC;QAErC,yBAAyB;QACzB,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YACnD,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;QACvB,CAAC;QAED,gCAAgC;QAChC,IAAI,OAAO,WAAW,KAAK,QAAQ,IAAI,WAAW,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YACjE,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;QACvB,CAAC;QAED,4BAA4B;QAC5B,MAAM,QAAQ,GACZ,WAAW,IAAI,IAAI,IAAI,OAAO,WAAW,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC;YACnF,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,WAAqD,CAAC;YACpE,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QAEpB,OAAO,MAAM,CAAC,IAAI,CAAC;YACjB,IAAI;YACJ,WAAW;YACX,QAAQ;SACT,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,uDAAuD;QACvD,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;IACvB,CAAC;AACH,CAAC,CAAC"}

package/dist/src/cli-commands/skills/install/select-skills.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Skill selection logic for the install command.
+ *
+ * Determines which skills to install based on flags, then optionally
+ * prompts the user for confirmation via `confirmSkillsToInstall`.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import type { SkillRef } from "../operations.js";
+import { Log, Multiselect } from "../../../tui/index.js";
+import { InstallError } from "./handler.js";
+import * as Array from "effect/Array";
+import * as Effect from "effect/Effect";
+interface SelectSkillsArgs {
+    readonly requestedSkills: readonly string[];
+    readonly all: boolean;
+    readonly yes: boolean;
+}
+/**
+ * Determines which skills to install from already-discovered skills.
+ *
+ * Selection logic:
+ * 1. `--skill` specified -> validate ALL exist, return matches
+ * 2. `--all` / `--yes` -> return all (no prompt)
+ * 3. Single skill -> auto-select (no prompt)
+ * 4. Multiple skills -> `confirmSkillsToInstall` (multiselect prompt)
+ */
+export declare const determineSkillsToInstall: (skills: Array.NonEmptyReadonlyArray<SkillRef>, args: SelectSkillsArgs) => Effect.Effect<readonly SkillRef[], InstallError, Log | Multiselect>;
+/**
+ * Prompts the user to select which skills to install from a list.
+ *
+ * Shows a multiselect prompt with no skills pre-selected.
+ * Maps prompt errors to `InstallError`.
+ */
+export declare const confirmSkillsToInstall: (skills: Array.NonEmptyReadonlyArray<SkillRef>) => Effect.Effect<readonly SkillRef[], InstallError, Multiselect>;
+export {};
+//# sourceMappingURL=select-skills.d.ts.map

package/dist/src/cli-commands/skills/install/select-skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"select-skills.d.ts","sourceRoot":"","sources":["../../../../../src/cli-commands/skills/install/select-skills.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAG5C,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAOxC,UAAU,gBAAgB;IACxB,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5C,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;CACvB;AAMD;;;;;;;;GAQG;AACH,eAAO,MAAM,wBAAwB,GACnC,QAAQ,KAAK,CAAC,qBAAqB,CAAC,QAAQ,CAAC,EAC7C,MAAM,gBAAgB,wEAsCpB,CAAC;AAEL;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,GAAI,QAAQ,KAAK,CAAC,qBAAqB,CAAC,QAAQ,CAAC,kEA8BhF,CAAC"}

package/dist/src/cli-commands/skills/install/select-skills.js

@@ -0,0 +1,84 @@
+/**
+ * Skill selection logic for the install command.
+ *
+ * Determines which skills to install based on flags, then optionally
+ * prompts the user for confirmation via `confirmSkillsToInstall`.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import { Log, Multiselect } from "../../../tui/index.js";
+import { InstallError } from "./handler.js";
+import { formatError } from "../../../utils/errors.js";
+import { expandGlobs } from "../../../skills/index.js";
+import * as Array from "effect/Array";
+import * as Effect from "effect/Effect";
+import * as Option from "effect/Option";
+// -----------------------------------------------------------------------------
+// Public API
+// -----------------------------------------------------------------------------
+/**
+ * Determines which skills to install from already-discovered skills.
+ *
+ * Selection logic:
+ * 1. `--skill` specified -> validate ALL exist, return matches
+ * 2. `--all` / `--yes` -> return all (no prompt)
+ * 3. Single skill -> auto-select (no prompt)
+ * 4. Multiple skills -> `confirmSkillsToInstall` (multiselect prompt)
+ */
+export const determineSkillsToInstall = (skills, args) => Effect.gen(function* () {
+    const log = yield* Log;
+    // 1. --skill specified -> glob-aware matching
+    if (args.requestedSkills.length > 0) {
+        const allNames = Array.map(skills, (s) => s.skill.name);
+        const matched = expandGlobs(args.requestedSkills, allNames);
+        if (matched.length === 0) {
+            return yield* new InstallError({
+                message: formatError(`No skills matched: ${args.requestedSkills.join(", ")}`, [`Available: ${skills.map((s) => s.skill.name).join(", ")}`], "Check the skill names or patterns and try again."),
+                cause: undefined,
+                retryable: false,
+            });
+        }
+        return Array.filter(skills, (s) => matched.includes(s.skill.name));
+    }
+    // 2. --all / --yes -> return all
+    if (args.all || args.yes) {
+        if (args.all)
+            yield* log.info(`Installing all ${skills.length} skill(s)`);
+        return skills;
+    }
+    // 3. Single skill -> auto-select
+    if (skills.length === 1) {
+        return skills;
+    }
+    // 4. Multiple skills -> multiselect prompt
+    return yield* confirmSkillsToInstall(skills);
+});
+/**
+ * Prompts the user to select which skills to install from a list.
+ *
+ * Shows a multiselect prompt with no skills pre-selected.
+ * Maps prompt errors to `InstallError`.
+ */
+export const confirmSkillsToInstall = (skills) => Effect.gen(function* () {
+    const multiselect = yield* Multiselect;
+    return yield* multiselect
+        .prompt({
+        message: "Select skills to install",
+        items: skills,
+        toOption: (s) => ({
+            value: s.skill.name,
+            label: s.skill.name,
+            hint: Option.some(s.skill.description),
+        }),
+        initialValues: Option.none(),
+        required: Option.some(true),
+    })
+        .pipe(Effect.mapError((error) => new InstallError(error._tag === "PromptCancelled"
+        ? { message: "Operation cancelled.", cause: undefined, retryable: false }
+        : {
+            message: "Failed to prompt for skill selection",
+            cause: error,
+            retryable: false,
+        })));
+});
+//# sourceMappingURL=select-skills.js.map

package/dist/src/cli-commands/skills/install/select-skills.js.map

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