@axm.sh/cli 0.0.1

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

@@ -0,0 +1,231 @@
+/**
+ * Skill discovery algorithm (3-phase: direct match, priority scan, recursive fallback).
+ *
+ * The `discoverSkillsInDir` function is used by source providers (local, git-hosting)
+ * to discover skills within a directory structure.
+ *
+ * @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 { getAllAgents } from "../../../agents/index.js";
+import { parseManifests } from "./parse-manifests.js";
+import { parseSkillMd } from "./parse-skill-md.js";
+import * as Array from "effect/Array";
+import * as Data from "effect/Data";
+import * as Effect from "effect/Effect";
+import * as Option from "effect/Option";
+/**
+ * Build a SkillRef from a skill, its directory path, and source.
+ */
+const makeSkillRef = (skill, fullPath, source) => ({
+    type: "skill",
+    skill,
+    source,
+    location: `file://${fullPath}`,
+    version: Option.none(),
+    gitTreeSha: Option.none(),
+});
+// -----------------------------------------------------------------------------
+// Errors
+// -----------------------------------------------------------------------------
+/**
+ * Error during skill discovery.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export class DiscoveryError extends Data.TaggedError("DiscoveryError") {
+}
+// -----------------------------------------------------------------------------
+// Constants
+// -----------------------------------------------------------------------------
+/**
+ * Exact filename for skill definition files.
+ */
+const SKILL_FILENAME = "SKILL.md";
+/**
+ * Non-agent static directories for Phase 2 priority scan.
+ */
+const STATIC_PRIORITY_DIRECTORIES = [
+    "skills/.curated",
+    "skills/.experimental",
+    "skills/.system",
+];
+/**
+ * Derive the full Phase 2 priority directory list.
+ *
+ * Composition:
+ * 1. `.` (searchPath root) — always first, highest priority
+ * 2. Non-agent static dirs: skills/.curated, skills/.experimental, skills/.system
+ * 3. Agent dirs: unique `skills.dir` values from the AgentDescriptor registry
+ */
+export const getPriorityDirectories = () => {
+    const agentDirs = Array.dedupe(Array.map(getAllAgents(), (agent) => agent.skills.dir));
+    return [".", ...STATIC_PRIORITY_DIRECTORIES, ...agentDirs];
+};
+/**
+ * Directories to skip during recursive Phase 3 scan.
+ */
+const SKIPPED_DIRECTORIES = new Set(["node_modules", ".git", "dist", "build", "__pycache__"]);
+/**
+ * Maximum recursion depth for Phase 3.
+ */
+const MAX_DEPTH = 5;
+// -----------------------------------------------------------------------------
+// Internal Skill Filtering
+// -----------------------------------------------------------------------------
+const isInternalSkill = (skill) => Option.match(skill.metadata, {
+    onNone: () => false,
+    onSome: (m) => m["internal"] === true,
+});
+const shouldIncludeSkill = (skill, options) => {
+    if (!isInternalSkill(skill))
+        return true;
+    const envVal = process.env["INSTALL_INTERNAL_SKILLS"];
+    return options.includeInternal || envVal === "1" || envVal === "true";
+};
+// -----------------------------------------------------------------------------
+// Phase Helpers
+// -----------------------------------------------------------------------------
+/**
+ * Try to find and parse a SKILL.md in a given directory.
+ * Returns Option.some(Skill) if found and valid, Option.none() otherwise.
+ * All errors are silently swallowed.
+ */
+const tryParseSkillInDir = (dir) => Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    const path = yield* Path.Path;
+    const entries = yield* fs.readDirectory(dir).pipe(Effect.option);
+    if (Option.isNone(entries))
+        return Option.none();
+    if (!entries.value.includes(SKILL_FILENAME))
+        return Option.none();
+    const fullPath = path.join(dir, SKILL_FILENAME);
+    const content = yield* fs.readFileString(fullPath).pipe(Effect.option);
+    if (Option.isNone(content))
+        return Option.none();
+    return parseSkillMd(content.value);
+});
+/**
+ * Scan one level of children in a directory for skills.
+ * Each immediate subdirectory is checked for a SKILL.md.
+ */
+const scanDirectory = (dir, options, source) => Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    const path = yield* Path.Path;
+    const entries = yield* fs.readDirectory(dir).pipe(Effect.option);
+    if (Option.isNone(entries))
+        return [];
+    return yield* Effect.forEach(entries.value, (entry) => Effect.gen(function* () {
+        const fullPath = path.join(dir, entry);
+        const stat = yield* fs.stat(fullPath).pipe(Effect.option);
+        if (Option.isNone(stat) || stat.value.type !== "Directory")
+            return [];
+        const skill = yield* tryParseSkillInDir(fullPath);
+        if (Option.isNone(skill))
+            return [];
+        if (!shouldIncludeSkill(skill.value, options))
+            return [];
+        return [makeSkillRef(skill.value, fullPath, source)];
+    }), { concurrency: "unbounded" }).pipe(Effect.map((results) => Array.flatten(results)));
+});
+/**
+ * Recursive DFS scan with depth limit.
+ * Skips well-known non-skill directories.
+ */
+const recursiveScan = (dir, options, depth, source) => Effect.gen(function* () {
+    if (depth > MAX_DEPTH)
+        return [];
+    const fs = yield* FileSystem.FileSystem;
+    const path = yield* Path.Path;
+    const entries = yield* fs.readDirectory(dir).pipe(Effect.option);
+    if (Option.isNone(entries))
+        return [];
+    return yield* Effect.forEach(entries.value, (entry) => Effect.gen(function* () {
+        if (SKIPPED_DIRECTORIES.has(entry))
+            return [];
+        const fullPath = path.join(dir, entry);
+        const stat = yield* fs.stat(fullPath).pipe(Effect.option);
+        if (Option.isNone(stat) || stat.value.type !== "Directory")
+            return [];
+        // Try to parse a skill in this directory
+        const skill = yield* tryParseSkillInDir(fullPath);
+        const current = Option.isSome(skill) && shouldIncludeSkill(skill.value, options)
+            ? [makeSkillRef(skill.value, fullPath, source)]
+            : [];
+        // Recurse into subdirectories
+        const subResults = yield* recursiveScan(fullPath, options, depth + 1, source);
+        return [...current, ...subResults];
+    }), { concurrency: "unbounded" }).pipe(Effect.map((results) => Array.flatten(results)));
+});
+// -----------------------------------------------------------------------------
+// 3-Phase Discovery
+// -----------------------------------------------------------------------------
+/**
+ * Discover skills in a directory using a 3-phase algorithm:
+ *
+ * Phase 1 — Direct match: check if search root itself contains SKILL.md
+ * Phase 2 — Priority directory scan: scan well-known directories one level deep
+ * Phase 3 — Recursive fallback: bounded DFS when prior phases find nothing or fullDepth is true
+ *
+ * Skills are deduplicated by name (first-found wins). Internal skills are
+ * filtered unless opted in.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const discoverSkillsInDir = (basePath, subPath, options, source) => Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    const path = yield* Path.Path;
+    // Compute effective search root
+    const searchRoot = Option.match(subPath, {
+        onNone: () => basePath,
+        onSome: (p) => path.join(basePath, p),
+    });
+    // Verify the search root exists and is a directory
+    const stat = yield* fs.stat(searchRoot).pipe(Effect.mapError((error) => new DiscoveryError({
+        message: `Directory does not exist or is not accessible: ${searchRoot}`,
+        path: searchRoot,
+        cause: error,
+        retryable: false,
+    })));
+    if (stat.type !== "Directory") {
+        return yield* new DiscoveryError({
+            message: `Path is not a directory: ${searchRoot}`,
+            path: searchRoot,
+            cause: undefined,
+            retryable: false,
+        });
+    }
+    // ── Phase 1: Direct Match ──────────────────────────────────────────
+    const rootSkill = yield* tryParseSkillInDir(searchRoot);
+    const phase1Skills = Option.isSome(rootSkill) && shouldIncludeSkill(rootSkill.value, options)
+        ? [makeSkillRef(rootSkill.value, searchRoot, source)]
+        : [];
+    if (phase1Skills.length > 0 && !options.fullDepth) {
+        return phase1Skills;
+    }
+    // ── Phase 2: Priority Directory Scan ───────────────────────────────
+    // Collect manifest-declared directories to append to priority scan
+    const manifestDirs = yield* parseManifests(searchRoot);
+    // Build full list of directories to scan: derived priority dirs + manifest dirs
+    const priorityDirs = getPriorityDirectories();
+    const priorityFullDirs = priorityDirs.map((priorityDir) => priorityDir === "." ? searchRoot : path.join(searchRoot, priorityDir));
+    // Deduplicate manifest dirs against static priority dirs
+    const manifestDirsToAdd = manifestDirs.filter((d) => !priorityFullDirs.includes(d));
+    const allPriorityDirs = [...priorityFullDirs, ...manifestDirsToAdd];
+    const phase2Skills = yield* Effect.forEach(allPriorityDirs, (fullDir) => scanDirectory(fullDir, options, source), { concurrency: "unbounded" }).pipe(Effect.map((results) => Array.flatten(results)));
+    // ── Phase 3: Recursive Fallback ────────────────────────────────────
+    const shouldRunPhase3 = (phase1Skills.length === 0 && phase2Skills.length === 0) || options.fullDepth;
+    const phase3Skills = shouldRunPhase3
+        ? yield* recursiveScan(searchRoot, options, 0, source)
+        : [];
+    // Deduplicate by name (first-found wins across phases)
+    const seen = new Set();
+    return [...phase1Skills, ...phase2Skills, ...phase3Skills].filter(({ skill: { name } }) => {
+        if (seen.has(name))
+            return false;
+        seen.add(name);
+        return true;
+    });
+});
+//# sourceMappingURL=discover-skills.js.map

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

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

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

@@ -0,0 +1,75 @@
+/**
+ * Install command handler - Effect-based orchestration for `axm skills install`.
+ *
+ * Uses desired-state reconciliation pattern:
+ * 1. Create workspace context (local vs global)
+ * 2. Ensure workspace is initialized
+ * 3. Load current state (actual from disk + locked from lockfile)
+ * 4. Build ideal state from command
+ * 5. Build plan (diff current vs ideal)
+ * 6. Resolve plan via workspace (display, confirm, apply based on flags)
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import { SourceProviders } from "../../../sources/index.js";
+import * as Effect from "effect/Effect";
+import * as Option from "effect/Option";
+import { Log, Spinner } from "../../../tui/index.js";
+import { Workspace as Workspace } from "../../../workspace/index.js";
+/**
+ * Arguments for the install command.
+ */
+export interface InstallHandlerArgs {
+    /** Source to install skills from */
+    readonly source: string;
+    /** Install to global ~/.axm/ instead of local .axm/ */
+    readonly global: boolean;
+    /** Target agent(s) to install skills for */
+    readonly agents: readonly string[];
+    /** Specific skill(s) to install (by name) */
+    readonly skills: readonly string[];
+    /** Skip confirmations */
+    readonly yes: boolean;
+    /** List available skills without installing */
+    readonly list: boolean;
+    /** Install all available skills */
+    readonly all: boolean;
+    /** Overwrite existing skills */
+    readonly force: boolean;
+    /** Disable all prompts */
+    readonly nonInteractive: Option.Option<boolean>;
+}
+declare const InstallError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }) => import("effect/Cause").YieldableError & {
+    readonly _tag: "InstallError";
+} & Readonly<A>;
+/**
+ * Error that occurs during skill installation.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare class InstallError extends InstallError_base<{
+    readonly message: string;
+    readonly cause: unknown;
+    readonly retryable: boolean;
+}> {
+}
+/**
+ * Handles the `axm skills install` command.
+ *
+ * Flow (state-based architecture):
+ * 1. Parse source string to determine type
+ * 2. Ensure .axm/ is initialized
+ * 3. Detect installed agents (or use --agent flag)
+ * 4. Load current state (actual + locked)
+ * 5. Discover skills from source
+ * 6. List mode (--list stops here)
+ * 7. Select skills to install
+ * 8. Build ideal state
+ * 9. Build plan (diff current vs ideal)
+ * 10. Resolve plan via workspace (display, confirm, apply based on flags)
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const handleInstall: (args: InstallHandlerArgs) => Effect.Effect<undefined, import("../../../tui/errors.js").PromptError | import("../../../tui/errors.js").PromptCancelled | import("../../../settings/settings.js").SettingsError | import("../../../sources/provider.js").SourceError | import("../../../sources/provider.js").RegistryNotConfiguredError | import("../../../lockfile/lockfile.js").LockfileError | InstallError, import("../../../tui/index.js").Confirm | Log | import("../../../tui/index.js").Multiselect | Spinner | import("../../../tui/index.js").TextInput | import("@effect/platform/Path").Path | import("@effect/platform/FileSystem").FileSystem | import("effect/Scope").Scope | Workspace | SourceProviders>;
+export {};
+//# sourceMappingURL=handler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../../../../src/cli-commands/skills/install/handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAGL,eAAe,EAEhB,MAAM,2BAA2B,CAAC;AAInC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAErD,OAAO,EAAE,SAAS,IAAI,SAAS,EAAE,MAAM,6BAA6B,CAAC;AASrE;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,oCAAoC;IACpC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,uDAAuD;IACvD,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,4CAA4C;IAC5C,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,6CAA6C;IAC7C,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,yBAAyB;IACzB,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;IACtB,+CAA+C;IAC/C,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,mCAAmC;IACnC,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;IACtB,gCAAgC;IAChC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,0BAA0B;IAC1B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;CACjD;;;;AAMD;;;;GAIG;AACH,qBAAa,YAAa,SAAQ,kBAAiC;IACjE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B,CAAC;CAAG;AAML;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,aAAa,GAAI,MAAM,kBAAkB,gqBAgJrD,CAAC"}

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

@@ -0,0 +1,151 @@
+/**
+ * Install command handler - Effect-based orchestration for `axm skills install`.
+ *
+ * Uses desired-state reconciliation pattern:
+ * 1. Create workspace context (local vs global)
+ * 2. Ensure workspace is initialized
+ * 3. Load current state (actual from disk + locked from lockfile)
+ * 4. Build ideal state from command
+ * 5. Build plan (diff current vs ideal)
+ * 6. Resolve plan via workspace (display, confirm, apply based on flags)
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import { resolveSource, printSourceInput, SourceProviders, registryGuard, } from "../../../sources/index.js";
+import { determineSkillsToInstall } from "./select-skills.js";
+import * as Array from "effect/Array";
+import * as Data from "effect/Data";
+import * as Effect from "effect/Effect";
+import * as Option from "effect/Option";
+import { Log, Spinner } from "../../../tui/index.js";
+import { formatError } from "../../../utils/errors.js";
+import { Workspace as Workspace } from "../../../workspace/index.js";
+import { buildPlan } from "./build-plan.js";
+import { installSkill } from "./install-skill.js";
+// -----------------------------------------------------------------------------
+// Errors
+// -----------------------------------------------------------------------------
+/**
+ * Error that occurs during skill installation.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export class InstallError extends Data.TaggedError("InstallError") {
+}
+// -----------------------------------------------------------------------------
+// Main Handler
+// -----------------------------------------------------------------------------
+/**
+ * Handles the `axm skills install` command.
+ *
+ * Flow (state-based architecture):
+ * 1. Parse source string to determine type
+ * 2. Ensure .axm/ is initialized
+ * 3. Detect installed agents (or use --agent flag)
+ * 4. Load current state (actual + locked)
+ * 5. Discover skills from source
+ * 6. List mode (--list stops here)
+ * 7. Select skills to install
+ * 8. Build ideal state
+ * 9. Build plan (diff current vs ideal)
+ * 10. Resolve plan via workspace (display, confirm, apply based on flags)
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const handleInstall = (args) => {
+    const scopeLabel = args.global ? "global" : "project";
+    return Effect.gen(function* () {
+        const ws = yield* Workspace;
+        const sources = yield* SourceProviders;
+        // Get TUI services
+        const log = yield* Log;
+        const spinnerSvc = yield* Spinner;
+        // Show intro
+        yield* log.info(`axm skills install (${scopeLabel})`);
+        // Step 1: Parse source
+        const parseHandle = yield* spinnerSvc.start("Parsing source...");
+        const source = yield* resolveSource(args.source).pipe(Effect.mapError((error) => new InstallError({
+            message: formatError(`Invalid source: ${error.message}`, [`Provided: ${args.source || "(empty)"}`], "Valid formats: local path, github:owner/repo, gitlab:owner/repo, or https://example.com"),
+            cause: error,
+            retryable: false,
+        })));
+        yield* parseHandle.stop(`Source: ${printSourceInput(source)} (${source.type})`);
+        // Step 1.5: Registry guard — ensure a registry source is configured
+        if (source.type === "registry") {
+            yield* registryGuard;
+        }
+        // Step 2: Get workspace context (provided by runtime)
+        // Step 5: Discover skills from source via SourceProviders
+        const discoverHandle = yield* spinnerSvc.start("Discovering skills...");
+        const findOptions = {
+            names: (source.type === "registry" ? [source.name] : []),
+            agents: args.agents,
+            type: "skill",
+        };
+        const allRefs = yield* sources.resolveExtension(source, findOptions).pipe(Effect.mapError((error) => new InstallError({
+            message: formatError(`Failed to discover skills: ${error.message}`, [`Source: ${printSourceInput(source)}`], "Verify the source path contains directories with SKILL.md files."),
+            cause: error,
+            retryable: false,
+        })), Effect.tapError(() => discoverHandle.stop("Failed")));
+        // Filter to skill refs only
+        const discoveredSkills = Array.filter(allRefs, (ref) => ref.type === "skill");
+        if (!Array.isNonEmptyReadonlyArray(discoveredSkills)) {
+            yield* discoverHandle.stop("No skills found");
+            return yield* new InstallError({
+                message: formatError("No skills found in source", [`Source: ${printSourceInput(source)}`], "Verify the source path contains directories with SKILL.md files."),
+                cause: undefined,
+                retryable: false,
+            });
+        }
+        yield* discoverHandle.stop(`Found ${discoveredSkills.length} skill(s)`);
+        // Step 6: List mode -> display and exit
+        if (args.list) {
+            yield* log.info("Available skills:");
+            for (const ref of discoveredSkills) {
+                const desc = ref.skill.description ? ` - ${ref.skill.description}` : "";
+                yield* log.message(`  ${ref.skill.name}${desc}`);
+            }
+            yield* log.success(`${discoveredSkills.length} skill(s) available`);
+            return;
+        }
+        // Step 7: Select skills to install
+        const selectedSkills = yield* determineSkillsToInstall(discoveredSkills, {
+            requestedSkills: args.skills,
+            all: args.all,
+            yes: args.yes,
+        });
+        if (!Array.isNonEmptyReadonlyArray(selectedSkills)) {
+            yield* log.warn("No skills selected.");
+            yield* log.success("Nothing to install.");
+            return;
+        }
+        // For registry sources, fetch and extract the archive to a temp dir
+        const resolvedSkills = yield* Effect.forEach(selectedSkills, (s) => {
+            if (s.source.type !== "registry")
+                return Effect.succeed(s);
+            return sources
+                .fetch(s)
+                .pipe(Effect.map((files) => ({ ...s, location: `file://${files.directory}` })));
+        }, { concurrency: "unbounded" });
+        const agentIds = yield* ws.getConfiguredAgents();
+        const ops = resolvedSkills.map((s) => ({
+            name: "install-skill",
+            args: {
+                agents: agentIds,
+                force: args.force,
+                source: s.source,
+                skill: s.skill,
+                location: s.location,
+                version: s.version,
+                gitTreeSha: s.gitTreeSha,
+            },
+        }));
+        // Build plan
+        const lockedSkills = yield* ws.getLockedSkills();
+        const lockfile = { lockfileVersion: 1, skills: lockedSkills };
+        const plan = buildPlan(ops, lockfile, "Install skill(s)", Option.some(`Install skills from ${printSourceInput(source)}`));
+        yield* ws.resolvePlan(plan, { "install-skill": installSkill });
+        yield* log.success("Done");
+    });
+};
+//# sourceMappingURL=handler.js.map

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

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

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

@@ -0,0 +1,31 @@
+/**
+ * Structured per-agent installation result.
+ *
+ * Captures the outcome of installing a skill for a single agent,
+ * including success/failure state and symlink fallback information.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import type * as Option from "effect/Option";
+/**
+ * Result of installing a skill for a single agent.
+ *
+ * - `success: true, mode: "symlink"` — installed via symlink
+ * - `success: true, mode: "copy"` — symlink failed, fell back to copy
+ * - `success: false` — installation failed
+ */
+export interface InstallResult {
+    /** Whether the installation succeeded for this agent. */
+    readonly success: boolean;
+    /** Installation mode used ("symlink" or "copy"). */
+    readonly mode: "symlink" | "copy";
+    /** Whether symlink creation was attempted and failed (triggering copy fallback). */
+    readonly symlinkFailed: boolean;
+    /** Error message if installation failed. */
+    readonly error: Option.Option<string>;
+    /** Agent-specific skill directory path. */
+    readonly path: string;
+    /** Canonical skill location (.agents/skills/<name>). */
+    readonly canonicalPath: string;
+}
+//# sourceMappingURL=install-result.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"install-result.d.ts","sourceRoot":"","sources":["../../../../../src/cli-commands/skills/install/install-result.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,KAAK,MAAM,MAAM,eAAe,CAAC;AAE7C;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC5B,yDAAyD;IACzD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,oDAAoD;IACpD,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAAC;IAClC,oFAAoF;IACpF,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,4CAA4C;IAC5C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACtC,2CAA2C;IAC3C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,wDAAwD;IACxD,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC"}

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

@@ -0,0 +1,10 @@
+/**
+ * Structured per-agent installation result.
+ *
+ * Captures the outcome of installing a skill for a single agent,
+ * including success/failure state and symlink fallback information.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export {};
+//# sourceMappingURL=install-result.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"install-result.js","sourceRoot":"","sources":["../../../../../src/cli-commands/skills/install/install-result.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

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

@@ -0,0 +1,27 @@
+/**
+ * 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 { Log } from "../../../tui/index.js";
+import { type OperationHandler } from "../../../workspace/apply-plan.js";
+import { Workspace } from "../../../workspace/service.js";
+import type { InstallSkillOperation } from "../operations.js";
+/**
+ * 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 declare const installSkill: OperationHandler<InstallSkillOperation, FileSystem.FileSystem | Path.Path | Workspace | Log>;
+//# sourceMappingURL=install-skill.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"install-skill.d.ts","sourceRoot":"","sources":["../../../../../src/cli-commands/skills/install/install-skill.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,UAAU,MAAM,6BAA6B,CAAC;AAC1D,OAAO,KAAK,IAAI,MAAM,uBAAuB,CAAC;AAK9C,OAAO,EAAE,GAAG,EAAE,MAAM,uBAAuB,CAAC;AAG5C,OAAO,EAAkB,KAAK,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAEzF,OAAO,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAE1D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAsK9D;;;;;;;;;;GAUG;AACH,eAAO,MAAM,YAAY,EAAE,gBAAgB,CACzC,qBAAqB,EACrB,UAAU,CAAC,UAAU,GAAG,IAAI,CAAC,IAAI,GAAG,SAAS,GAAG,GAAG,CAoHjD,CAAC"}