axm.sh 0.1.6

package/dist/src/root/skills/enable.d.ts

@@ -0,0 +1,16 @@
+import * as FileSystem from "effect/FileSystem";
+import * as Path from "effect/Path";
+import { Command } from "effect/unstable/cli";
+import * as Effect from "effect/Effect";
+import { type ExtensionName } from "@agentxm/client-core/unstable/extensions";
+import { CliRenderer } from "@agentxm/client-core/unstable/cli-renderer";
+import { Workspace } from "@agentxm/client-core/unstable/workspace";
+export interface EnableHandlerArgs {
+    readonly name: ExtensionName;
+    readonly yes: boolean;
+    readonly force: boolean;
+    readonly preview: boolean;
+}
+export declare const handleEnable: (args: EnableHandlerArgs) => Effect.Effect<undefined, import("@agentxm/client-core/unstable/app-error").AppError | import("packages/core/src/unstable/cli-prompt/prompt-cancelled.ts").PromptCancelled, CliRenderer | import("@agentxm/client-core/unstable/cli-flags").Verbosity | FileSystem.FileSystem | Path.Path | "effect/unstable/cli/GlobalFlag/axm-non-interactive" | Workspace>;
+export declare const enableCommand: Command.Command<"enable", Record<string, unknown>, {}, never, "effect/unstable/cli/GlobalFlag/axm-non-interactive" | "effect/unstable/cli/GlobalFlag/axm-json" | "effect/unstable/cli/GlobalFlag/axm-quiet" | "effect/unstable/cli/GlobalFlag/axm-verbose" | "effect/unstable/cli/GlobalFlag/axm-debug">;
+//# sourceMappingURL=enable.d.ts.map

package/dist/src/root/skills/enable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enable.d.ts","sourceRoot":"","sources":["../../../../src/root/skills/enable.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AAEpC,OAAO,EAAY,OAAO,EAAQ,MAAM,qBAAqB,CAAC;AAC9D,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,EAEL,KAAK,aAAa,EACnB,MAAM,0CAA0C,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,4CAA4C,CAAC;AACzE,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAWpE,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED,eAAO,MAAM,YAAY,2XAgFvB,CAAC;AAcH,eAAO,MAAM,aAAa,0SAqBzB,CAAC"}

package/dist/src/root/skills/enable.js

@@ -0,0 +1,92 @@
+import * as FileSystem from "effect/FileSystem";
+import * as Path from "effect/Path";
+import * as Option from "effect/Option";
+import { Argument, Command, Flag } from "effect/unstable/cli";
+import * as Effect from "effect/Effect";
+import { makeAppError } from "@agentxm/client-core/unstable/app-error";
+import { decodeExtensionNameSync, } from "@agentxm/client-core/unstable/extensions";
+import { CliRenderer } from "@agentxm/client-core/unstable/cli-renderer";
+import { Workspace } from "@agentxm/client-core/unstable/workspace";
+import { enableSkill } from "@agentxm/client-core/unstable/skills";
+import { forceFlag, previewFlag, yesFlag } from "@agentxm/client-core/unstable/cli-flags";
+import { withArgvTracking } from "@agentxm/client-core/unstable/cli-runtime";
+import { previewOrApplyPlan } from "@agentxm/client-core/unstable/workspace";
+import { emitNoOpResult, emitPlanResolutionResult } from "../../json-output.js";
+import { withRuntime, withWorkspace } from "../../runtime.js";
+import { scopeFlag } from "../../cli-flags.js";
+export const handleEnable = Effect.fn("Enable.handle")(function* (args) {
+    const ws = yield* Workspace;
+    const renderer = yield* CliRenderer;
+    const fs = yield* FileSystem.FileSystem;
+    const path = yield* Path.Path;
+    yield* renderer.info("axm skills enable");
+    // Load installed skills (configured ∪ implicit) — taxonomy lifecycle view
+    const installedSkills = yield* ws.getInstalledSkills();
+    const entry = installedSkills[args.name];
+    // Validate: skill is installed (ignored names are excluded from installed)
+    if (entry === undefined) {
+        return yield* makeAppError({
+            code: "SKILL_NOT_FOUND",
+            what: `Skill '${args.name}' is not installed`,
+            howToFix: "Run `axm skills list` to see available skills",
+        });
+    }
+    // Validate: skill is currently disabled
+    if (entry.enabled) {
+        if (yield* emitNoOpResult("skills.enable", {
+            planName: "Enable skill",
+            planDescription: `Enable ${args.name}`,
+            message: `Skill '${args.name}' is already enabled`,
+        })) {
+            return;
+        }
+        yield* renderer.info(`Skill '${args.name}' is already enabled`);
+        yield* renderer.success("Nothing to do.");
+        return;
+    }
+    // Build operation — operation handles both lock-backed and settings-only paths
+    const op = {
+        name: "enable-skill",
+        args: { skillName: args.name },
+    };
+    // Build plan with inline run closure
+    const toJobStepResult = (result) => result.result === "error" && result.error != null
+        ? { result: "error", message: result.message, error: result.error }
+        : { result: "success", message: result.message };
+    const step = {
+        readiness: "ready",
+        label: args.name,
+        run: enableSkill(op).pipe(Effect.map(toJobStepResult), Effect.provideService(Workspace, ws), Effect.provideService(FileSystem.FileSystem, fs), Effect.provideService(Path.Path, path)),
+    };
+    const plan = {
+        _tag: "Plan",
+        name: "Enable skill",
+        description: Option.some(`Enable ${args.name}`),
+        jobs: [{ concurrency: 1, steps: [step] }],
+    };
+    const resolution = yield* previewOrApplyPlan(plan, {
+        yes: args.yes,
+        force: args.force,
+        preview: args.preview,
+    });
+    yield* emitPlanResolutionResult("skills.enable", resolution);
+    yield* renderer.success("Done");
+});
+const enableConfig = {
+    name: Argument.string("name").pipe(Argument.withDescription("Name of the skill to enable")),
+    scope: scopeFlag.pipe(Flag.withDescription("Enable in project (default) or user-level configuration")),
+    yes: yesFlag.pipe(Flag.withDescription("Enable without confirmation")),
+    force: forceFlag.pipe(Flag.withDescription("Enable even if the skill has unresolved dependencies")),
+    preview: previewFlag.pipe(Flag.withDescription("Show what would change without enabling")),
+};
+export const enableCommand = Command.make("enable", enableConfig, ({ name, scope, yes, force, preview }) => handleEnable({ name: decodeExtensionNameSync(name), yes, force, preview }).pipe(withWorkspace(scope), withRuntime("skills enable"))).pipe(withArgvTracking(enableConfig), Command.withDescription("Enable a previously disabled skill"), Command.withExamples([
+    {
+        command: "axm skills enable code-review",
+        description: "Re-enable a skill you previously disabled",
+    },
+    {
+        command: "axm skills enable code-review --preview",
+        description: "Preview the change before enabling",
+    },
+]));
+//# sourceMappingURL=enable.js.map

package/dist/src/root/skills/enable.js.map

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

package/dist/src/root/skills/fork.d.ts

@@ -0,0 +1,22 @@
+import * as FileSystem from "effect/FileSystem";
+import * as Path from "effect/Path";
+import { CodingAgentRepository } from "@agentxm/client-core/unstable/agents";
+import { SourceHostProviders } from "@agentxm/client-core/unstable/source-resolution";
+import * as Effect from "effect/Effect";
+import { Command } from "effect/unstable/cli";
+import { type AppError } from "@agentxm/client-core/unstable/app-error";
+import { CliRenderer } from "@agentxm/client-core/unstable/cli-renderer";
+import { Workspace } from "@agentxm/client-core/unstable/workspace";
+export interface ForkHandlerArgs {
+    readonly source: string;
+    readonly skills: readonly string[];
+    readonly yes: boolean;
+    readonly force: boolean;
+    readonly preview: boolean;
+}
+/**
+ * Handles the `axm skills fork` command.
+ */
+export declare const handleFork: (args: ForkHandlerArgs) => Effect.Effect<undefined, AppError | import("packages/core/src/unstable/cli-prompt/prompt-cancelled.ts").PromptCancelled, CliRenderer | import("effect/Scope").Scope | import("@agentxm/client-core/unstable/cli-flags").Verbosity | FileSystem.FileSystem | Path.Path | "effect/unstable/cli/GlobalFlag/axm-non-interactive" | Workspace | CodingAgentRepository | SourceHostProviders | import("@agentxm/client-core/unstable/auth").CredentialStore | import("@agentxm/client-core/unstable/auth").RegistryUrl>;
+export declare const forkCommand: Command.Command<"fork", Record<string, unknown>, {}, never, "effect/unstable/cli/GlobalFlag/axm-non-interactive" | "effect/unstable/cli/GlobalFlag/axm-json" | "effect/unstable/cli/GlobalFlag/axm-quiet" | "effect/unstable/cli/GlobalFlag/axm-verbose" | "effect/unstable/cli/GlobalFlag/axm-debug">;
+//# sourceMappingURL=fork.d.ts.map

package/dist/src/root/skills/fork.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fork.d.ts","sourceRoot":"","sources":["../../../../src/root/skills/fork.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AAGpC,OAAO,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAC7E,OAAO,EAEL,mBAAmB,EACpB,MAAM,iDAAiD,CAAC;AAEzD,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAGxC,OAAO,EAAY,OAAO,EAAQ,MAAM,qBAAqB,CAAC;AAE9D,OAAO,EAAgB,KAAK,QAAQ,EAAE,MAAM,yCAAyC,CAAC;AACtF,OAAO,EAAE,WAAW,EAAE,MAAM,4CAA4C,CAAC;AAUzE,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAepE,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAkED;;GAEG;AACH,eAAO,MAAM,UAAU,8gBAgQrB,CAAC;AAmBH,eAAO,MAAM,WAAW,wSA6BvB,CAAC"}

package/dist/src/root/skills/fork.js

@@ -0,0 +1,288 @@
+import * as FileSystem from "effect/FileSystem";
+import * as Path from "effect/Path";
+import { CodingAgentRepository } from "@agentxm/client-core/unstable/agents";
+import { resolveSourcePattern, SourceHostProviders, } from "@agentxm/client-core/unstable/source-resolution";
+import * as Array from "effect/Array";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Option from "effect/Option";
+import { Argument, Command, Flag } from "effect/unstable/cli";
+import { withAuthGuard } from "@agentxm/client-core/unstable/auth";
+import { makeAppError } from "@agentxm/client-core/unstable/app-error";
+import { CliRenderer } from "@agentxm/client-core/unstable/cli-renderer";
+import { forceFlag, previewFlag, yesFlag } from "@agentxm/client-core/unstable/cli-flags";
+import { setCommandSemanticProperties, summarizeCommandOutcome, withArgvTracking, } from "@agentxm/client-core/unstable/cli-runtime";
+import { DEFAULT_WORKSPACE_SCOPE } from "@agentxm/client-core/unstable/workspace";
+import { withAuthRuntime, withWorkspace } from "../../runtime.js";
+import { Workspace } from "@agentxm/client-core/unstable/workspace";
+import { copySkill } from "@agentxm/client-core/unstable/skills";
+import { installSkill } from "@agentxm/client-core/unstable/skills";
+import { publishSkill } from "@agentxm/client-core/unstable/skills";
+import { expandGlobs } from "@agentxm/client-core/unstable/utils";
+import { createRegistryClient } from "@agentxm/client-core/unstable/registry";
+import { decodeExactSemverVersionSync } from "@agentxm/client-core/unstable/version-constraints";
+import { previewOrApplyPlan } from "@agentxm/client-core/unstable/workspace";
+import { emitPlanResolutionResult, planResolutionToSummary } from "../../json-output.js";
+const filterBySkillGlobs = (discoveredSkills, skillPatterns) => Effect.gen(function* () {
+    if (skillPatterns.length === 0)
+        return discoveredSkills;
+    const allNames = Array.map(discoveredSkills, (r) => r.skill.name);
+    const matched = expandGlobs(skillPatterns, allNames);
+    if (matched.length === 0) {
+        return yield* makeAppError({
+            code: "NO_SKILLS_MATCHED",
+            what: "No skills matched the given patterns",
+            details: [`Patterns: ${skillPatterns.join(", ")}`, `Available: ${allNames.join(", ")}`],
+            howToFix: "Check skill names with `axm skills install --list <source>`.",
+        });
+    }
+    return Array.filter(discoveredSkills, (s) => matched.includes(s.skill.name));
+});
+const isAppError = (error) => typeof error === "object" &&
+    error !== null &&
+    "_tag" in error &&
+    error._tag === "AppError" &&
+    "what" in error &&
+    "code" in error;
+const summarizeError = (error) => {
+    if (isAppError(error)) {
+        return `${error.what} (${error.code})`;
+    }
+    if (error instanceof Error) {
+        return error.message;
+    }
+    return String(error);
+};
+const isRemoteReadNotImplemented = (error) => isAppError(error) &&
+    (error.code === "REGISTRY_REMOTE_NOT_SUPPORTED" ||
+        (error.code.startsWith("REGISTRY_REMOTE_") && error.code.endsWith("_NOT_IMPLEMENTED")));
+const discoverHowToFix = (source, error) => {
+    if (source.type === "registry") {
+        if (isRemoteReadNotImplemented(error)) {
+            return "Remote registry discovery is not yet supported for HTTP(S) sources. Use a file:// registry source, or fork from a local/git source.";
+        }
+        return "Verify the configured registry is reachable and contains the requested owner/skill.";
+    }
+    if (source.type === "local") {
+        return "Verify the source path contains directories with SKILL.md files.";
+    }
+    return "Verify the source is reachable and contains valid skill directories.";
+};
+const noSkillsFoundHowToFix = (sourceInput) => sourceInput.includes("@") ||
+    sourceInput.startsWith("http://") ||
+    sourceInput.startsWith("https://")
+    ? "Verify the owner and skill name, or use --list with skills install to inspect available skills."
+    : "Verify the source path contains directories with SKILL.md files.";
+const FALLBACK_PUBLISHED_VERSION = decodeExactSemverVersionSync("0.1.0");
+/**
+ * Handles the `axm skills fork` command.
+ */
+export const handleFork = Effect.fn("Fork.handle")(function* (args) {
+    const ws = yield* Workspace;
+    const renderer = yield* CliRenderer;
+    const fs = yield* FileSystem.FileSystem;
+    const path = yield* Path.Path;
+    const sources = yield* SourceHostProviders;
+    const agentRepo = yield* CodingAgentRepository;
+    const runLayer = Layer.mergeAll(Layer.succeed(Workspace, ws), Layer.succeed(CliRenderer, renderer), Layer.succeed(FileSystem.FileSystem, fs), Layer.succeed(Path.Path, path), Layer.succeed(SourceHostProviders, sources), Layer.succeed(CodingAgentRepository, agentRepo));
+    const provideRun = (effect) => Effect.provide(effect, runLayer);
+    yield* renderer.info("axm skills fork");
+    // Step 1: Resolve owner
+    const owner = yield* ws.getConfiguredProfile().pipe(Effect.mapError((e) => makeAppError({
+        code: "NAMESPACE_RESOLUTION_FAILED",
+        what: `Failed to resolve owner: ${e._tag}`,
+        howToFix: "Configure an owner in your settings with `axm init`.",
+        cause: e,
+    })));
+    // Step 2: Parse source and discover skills
+    const filtered = yield* renderer.withSpinner("Resolving skills...", () => Effect.gen(function* () {
+        const resolvedSources = yield* resolveSourcePattern(args.source).pipe(Effect.catchTag("AppError", (error) => error.code === "SOURCE_PARSE_FAILED"
+            ? (() => {
+                const reason = summarizeError(error);
+                return Effect.fail(makeAppError({
+                    code: "INVALID_SOURCE",
+                    what: "Invalid source",
+                    details: [`Provided: ${args.source}`, `Reason: ${reason}`],
+                    howToFix: "Valid formats: installed skill name, local path, github:owner/repo, or glob pattern",
+                    cause: error,
+                }));
+            })()
+            : Effect.fail(error)));
+        const allRefs = yield* Effect.forEach(resolvedSources, (source) => sources.find(source, {
+            names: [],
+            type: "skill",
+            owner: Option.none(),
+            versionConstraint: Option.none(),
+        }), { concurrency: "unbounded" }).pipe(Effect.map(Array.flatten), Effect.mapError((error) => {
+            const reason = summarizeError(error);
+            const firstResolved = resolvedSources[0];
+            const sourceLabel = firstResolved ? sources.origin(firstResolved) : args.source;
+            const howToFix = firstResolved
+                ? discoverHowToFix(firstResolved, error)
+                : noSkillsFoundHowToFix(args.source);
+            return makeAppError({
+                code: "DISCOVER_FAILED",
+                what: "Failed to discover skills from source",
+                details: [`Source: ${sourceLabel}`, `Reason: ${reason}`],
+                howToFix,
+                cause: error,
+            });
+        }));
+        const discoveredSkills = Array.filter(allRefs, (ref) => ref.type === "skill");
+        if (discoveredSkills.length === 0) {
+            return yield* makeAppError({
+                code: "NO_SKILLS_FOUND",
+                what: "No skills found in source",
+                details: [`Source: ${args.source}`],
+                howToFix: noSkillsFoundHowToFix(args.source),
+            });
+        }
+        // Step 3: Filter by --skill globs (if provided)
+        return yield* filterBySkillGlobs(discoveredSkills, args.skills);
+    }), {
+        successMessage: (matches) => `Found ${matches.length} skill(s)`,
+        failureMessage: "Failed",
+    });
+    // Step 4: Determine first registry source name for publishing
+    const registrySources = yield* ws.getRegistrySourceHosts().pipe(Effect.mapError((e) => makeAppError({
+        code: "REGISTRY_SOURCES_FAILED",
+        what: `Failed to get registry sources: ${e._tag}`,
+        cause: e,
+    })));
+    if (registrySources.length === 0) {
+        return yield* makeAppError({
+            code: "NO_REGISTRY_CONFIGURED",
+            what: "No registry sources configured",
+            howToFix: "Run the registry guard first.",
+        });
+    }
+    const [registrySource] = registrySources;
+    if (registrySource === undefined) {
+        return yield* makeAppError({
+            code: "NO_REGISTRY_CONFIGURED",
+            what: "No registry sources configured",
+            howToFix: "Run the registry guard first.",
+        });
+    }
+    const registryName = registrySource.name;
+    // Step 5: Build plan — fork + publish + install per skill (3 sequential ops)
+    // Steps use inline run closures so the install step can query the registry
+    // at execution time for the integrity hash computed during publish.
+    const registryLocationStr = registrySource.location.protocol === "file:"
+        ? registrySource.location.pathname
+        : registrySource.location.href;
+    const steps = Array.flatMap(filtered, (ref) => {
+        const targetName = `${owner}/skills/${ref.skill.name}`;
+        const extensionRef = ref;
+        // Run closures are Effect<JobStepResult, AppError, never>: services are
+        // provided via the provideRun helper before plan execution.
+        const copyStep = {
+            readiness: "ready",
+            label: `Fork ${ref.skill.name}`,
+            run: provideRun(copySkill({
+                name: "copy-skill",
+                args: { ref: extensionRef, targetName },
+            })),
+        };
+        const publishStep = {
+            readiness: "ready",
+            label: `Publish ${targetName}`,
+            run: provideRun(publishSkill({
+                name: "publish-skill",
+                args: { name: targetName, registryName },
+            })),
+        };
+        // Install step queries the registry at execution time to obtain the
+        // integrity hash that publish computed, rather than using a stale value.
+        const installStep = {
+            readiness: "ready",
+            label: `Install ${ref.skill.name}`,
+            run: provideRun(Effect.gen(function* () {
+                const client = yield* createRegistryClient(registryLocationStr);
+                const response = yield* client.getExtensionsByScope({
+                    owner,
+                    names: [ref.skill.name],
+                    types: ["skill"],
+                    limit: Option.some(1),
+                    offset: 0,
+                });
+                const published = response.extensions[0];
+                const registryRef = {
+                    type: "skill",
+                    refType: "registry",
+                    skill: {
+                        name: ref.skill.name,
+                        description: ref.skill.description,
+                        metadata: ref.skill.metadata,
+                    },
+                    source: {
+                        type: "registry",
+                        location: registrySource.location,
+                        owner: Option.none(),
+                    },
+                    owner,
+                    name: ref.skill.name,
+                    version: published?.version ?? FALLBACK_PUBLISHED_VERSION,
+                    integrity: Option.fromUndefinedOr(published?.integrity),
+                    compatiblePackages: [],
+                };
+                return yield* installSkill({
+                    name: "install-skill",
+                    args: {
+                        ref: registryRef,
+                        force: true,
+                        versionConstraint: Option.none(),
+                        skipSettings: Option.none(),
+                        strictUnknownAgents: Option.none(),
+                        existingInstalledAt: Option.none(),
+                        sourceName: Option.some(registryName),
+                    },
+                });
+            })),
+        };
+        return [copyStep, publishStep, installStep];
+    });
+    const plan = {
+        _tag: "Plan",
+        name: "Fork skill(s)",
+        description: Option.some(`Fork and publish ${filtered.length} skill(s)`),
+        jobs: [{ steps, concurrency: 1 }],
+    };
+    const resolution = yield* withAuthGuard(previewOrApplyPlan(plan, {
+        yes: args.yes,
+        force: args.force,
+        preview: args.preview,
+    }), { registryUrl: registrySource.location.href });
+    yield* setCommandSemanticProperties(summarizeCommandOutcome(planResolutionToSummary(resolution, {
+        subjectType: "skill",
+        sourceKind: "registry",
+    })));
+    yield* emitPlanResolutionResult("skills.fork", resolution);
+    yield* renderer.success("Done");
+});
+const forkConfig = {
+    source: Argument.string("source").pipe(Argument.withDescription("Installed skill name, glob pattern, or source string (local path, github:owner/repo, etc.)")),
+    skill: Flag.string("skill").pipe(Flag.withDescription("Fork only specific skill(s) matching the name or glob"), Flag.atLeast(0)),
+    yes: yesFlag.pipe(Flag.withDescription("Fork without confirmation")),
+    force: forceFlag.pipe(Flag.withDescription("Overwrite if a forked copy already exists")),
+    preview: previewFlag.pipe(Flag.withDescription("Show what would be forked without making changes")),
+};
+export const forkCommand = Command.make("fork", forkConfig, ({ source, skill, yes, force, preview }) => handleFork({ source, skills: [...skill], yes, force, preview }).pipe(withWorkspace(DEFAULT_WORKSPACE_SCOPE), withAuthRuntime("skills fork"))).pipe(withArgvTracking(forkConfig), Command.withDescription("Fork a skill for customization"), Command.withExamples([
+    {
+        command: "axm skills fork my-skill",
+        description: "Customize an installed skill by forking it",
+    },
+    {
+        command: 'axm skills fork "effect-*"',
+        description: "Fork all Effect-related skills at once",
+    },
+    {
+        command: "axm skills fork github:owner/repo",
+        description: "Fork from a GitHub source",
+    },
+    {
+        command: 'axm skills fork ./local/path --skill "effect-*"',
+        description: "Fork specific skills from a local directory",
+    },
+]));
+//# sourceMappingURL=fork.js.map

package/dist/src/root/skills/fork.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fork.js","sourceRoot":"","sources":["../../../../src/root/skills/fork.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AAGpC,OAAO,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAC7E,OAAO,EACL,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,iDAAiD,CAAC;AACzD,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AACnE,OAAO,EAAE,YAAY,EAAiB,MAAM,yCAAyC,CAAC;AACtF,OAAO,EAAE,WAAW,EAAE,MAAM,4CAA4C,CAAC;AACzE,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,yCAAyC,CAAC;AAC1F,OAAO,EACL,4BAA4B,EAC5B,uBAAuB,EACvB,gBAAgB,GACjB,MAAM,2CAA2C,CAAC;AACnD,OAAO,EAAE,uBAAuB,EAAE,MAAM,yCAAyC,CAAC;AAClF,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAElE,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIpE,OAAO,EAAE,SAAS,EAAE,MAAM,sCAAsC,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,MAAM,qCAAqC,CAAC;AAClE,OAAO,EAAE,oBAAoB,EAAE,MAAM,wCAAwC,CAAC;AAG9E,OAAO,EAAE,4BAA4B,EAAE,MAAM,mDAAmD,CAAC;AACjG,OAAO,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAC7E,OAAO,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAUzF,MAAM,kBAAkB,GAAG,CACzB,gBAAkD,EAClD,aAAgC,EAChC,EAAE,CACF,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,gBAAgB,CAAC;IACxD,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAClE,MAAM,OAAO,GAAG,WAAW,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC;IACrD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,CAAC,YAAY,CAAC;YACzB,IAAI,EAAE,mBAAmB;YACzB,IAAI,EAAE,sCAAsC;YAC5C,OAAO,EAAE,CAAC,aAAa,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,cAAc,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACvF,QAAQ,EAAE,8DAA8D;SACzE,CAAC,CAAC;IACL,CAAC;IACD,OAAO,KAAK,CAAC,MAAM,CAAC,gBAAgB,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;AAC/E,CAAC,CAAC,CAAC;AAEL,MAAM,UAAU,GAAG,CAAC,KAAc,EAAqB,EAAE,CACvD,OAAO,KAAK,KAAK,QAAQ;IACzB,KAAK,KAAK,IAAI;IACd,MAAM,IAAI,KAAK;IACf,KAAK,CAAC,IAAI,KAAK,UAAU;IACzB,MAAM,IAAI,KAAK;IACf,MAAM,IAAI,KAAK,CAAC;AAElB,MAAM,cAAc,GAAG,CAAC,KAAc,EAAU,EAAE;IAChD,IAAI,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,GAAG,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI,GAAG,CAAC;IACzC,CAAC;IACD,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO,KAAK,CAAC,OAAO,CAAC;IACvB,CAAC;IACD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC,CAAC;AAEF,MAAM,0BAA0B,GAAG,CAAC,KAAc,EAAW,EAAE,CAC7D,UAAU,CAAC,KAAK,CAAC;IACjB,CAAC,KAAK,CAAC,IAAI,KAAK,+BAA+B;QAC7C,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,kBAAkB,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC;AAE5F,MAAM,gBAAgB,GAAG,CAAC,MAAc,EAAE,KAAc,EAAU,EAAE;IAClE,IAAI,MAAM,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QAC/B,IAAI,0BAA0B,CAAC,KAAK,CAAC,EAAE,CAAC;YACtC,OAAO,qIAAqI,CAAC;QAC/I,CAAC;QACD,OAAO,qFAAqF,CAAC;IAC/F,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC5B,OAAO,kEAAkE,CAAC;IAC5E,CAAC;IACD,OAAO,sEAAsE,CAAC;AAChF,CAAC,CAAC;AAEF,MAAM,qBAAqB,GAAG,CAAC,WAAmB,EAAU,EAAE,CAC5D,WAAW,CAAC,QAAQ,CAAC,GAAG,CAAC;IACzB,WAAW,CAAC,UAAU,CAAC,SAAS,CAAC;IACjC,WAAW,CAAC,UAAU,CAAC,UAAU,CAAC;IAChC,CAAC,CAAC,iGAAiG;IACnG,CAAC,CAAC,kEAAkE,CAAC;AAEzE,MAAM,0BAA0B,GAAG,4BAA4B,CAAC,OAAO,CAAC,CAAC;AAEzE;;GAEG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,MAAM,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,QAAQ,CAAC,EAAE,IAAqB;IACjF,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,SAAS,CAAC;IAC5B,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,WAAW,CAAC;IACpC,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC;IACxC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;IAE9B,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,mBAAmB,CAAC;IAC3C,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,qBAAqB,CAAC;IAC/C,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAC7B,KAAK,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,EAC5B,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,QAAQ,CAAC,EACpC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,UAAU,EAAE,EAAE,CAAC,EACxC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,EAC9B,KAAK,CAAC,OAAO,CAAC,mBAAmB,EAAE,OAAO,CAAC,EAC3C,KAAK,CAAC,OAAO,CAAC,qBAAqB,EAAE,SAAS,CAAC,CAChD,CAAC;IACF,MAAM,UAAU,GAAG,CAAI,MAAiD,EAAE,EAAE,CAC1E,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAEnC,KAAK,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IAExC,wBAAwB;IACxB,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC,oBAAoB,EAAE,CAAC,IAAI,CACjD,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE,CACpB,YAAY,CAAC;QACX,IAAI,EAAE,6BAA6B;QACnC,IAAI,EAAE,4BAA4B,CAAC,CAAC,IAAI,EAAE;QAC1C,QAAQ,EAAE,sDAAsD;QAChE,KAAK,EAAE,CAAC;KACT,CAAC,CACH,CACF,CAAC;IAEF,2CAA2C;IAC3C,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,QAAQ,CAAC,WAAW,CAC1C,qBAAqB,EACrB,GAAG,EAAE,CACH,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;QAClB,MAAM,eAAe,GAAG,KAAK,CAAC,CAAC,oBAAoB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CACnE,MAAM,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC,KAAK,EAAE,EAAE,CACpC,KAAK,CAAC,IAAI,KAAK,qBAAqB;YAClC,CAAC,CAAC,CAAC,GAAG,EAAE;gBACJ,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;gBACrC,OAAO,MAAM,CAAC,IAAI,CAChB,YAAY,CAAC;oBACX,IAAI,EAAE,gBAAgB;oBACtB,IAAI,EAAE,gBAAgB;oBACtB,OAAO,EAAE,CAAC,aAAa,IAAI,CAAC,MAAM,EAAE,EAAE,WAAW,MAAM,EAAE,CAAC;oBAC1D,QAAQ,EACN,qFAAqF;oBACvF,KAAK,EAAE,KAAK;iBACb,CAAC,CACH,CAAC;YACJ,CAAC,CAAC,EAAE;YACN,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CACvB,CACF,CAAC;QAEF,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CACnC,eAAe,EACf,CAAC,MAAM,EAAE,EAAE,CACT,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE;YACnB,KAAK,EAAE,EAAE;YACT,IAAI,EAAE,OAAO;YACb,KAAK,EAAE,MAAM,CAAC,IAAI,EAAE;YACpB,iBAAiB,EAAE,MAAM,CAAC,IAAI,EAAE;SACjC,CAAC,EACJ,EAAE,WAAW,EAAE,WAAW,EAAE,CAC7B,CAAC,IAAI,CACJ,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,EACzB,MAAM,CAAC,QAAQ,CAAC,CAAC,KAAK,EAAE,EAAE;YACxB,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;YACrC,MAAM,aAAa,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC;YACzC,MAAM,WAAW,GAAG,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC;YAChF,MAAM,QAAQ,GAAG,aAAa;gBAC5B,CAAC,CAAC,gBAAgB,CAAC,aAAa,EAAE,KAAK,CAAC;gBACxC,CAAC,CAAC,qBAAqB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACvC,OAAO,YAAY,CAAC;gBAClB,IAAI,EAAE,iBAAiB;gBACvB,IAAI,EAAE,uCAAuC;gBAC7C,OAAO,EAAE,CAAC,WAAW,WAAW,EAAE,EAAE,WAAW,MAAM,EAAE,CAAC;gBACxD,QAAQ;gBACR,KAAK,EAAE,KAAK;aACb,CAAC,CAAC;QACL,CAAC,CAAC,CACH,CAAC;QAEF,MAAM,gBAAgB,GAAG,KAAK,CAAC,MAAM,CACnC,OAAO,EACP,CAAC,GAAG,EAA4B,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,OAAO,CACxD,CAAC;QAEF,IAAI,gBAAgB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAClC,OAAO,KAAK,CAAC,CAAC,YAAY,CAAC;gBACzB,IAAI,EAAE,iBAAiB;gBACvB,IAAI,EAAE,2BAA2B;gBACjC,OAAO,EAAE,CAAC,WAAW,IAAI,CAAC,MAAM,EAAE,CAAC;gBACnC,QAAQ,EAAE,qBAAqB,CAAC,IAAI,CAAC,MAAM,CAAC;aAC7C,CAAC,CAAC;QACL,CAAC;QAED,gDAAgD;QAChD,OAAO,KAAK,CAAC,CAAC,kBAAkB,CAAC,gBAAgB,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IAClE,CAAC,CAAC,EACJ;QACE,cAAc,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,SAAS,OAAO,CAAC,MAAM,WAAW;QAC/D,cAAc,EAAE,QAAQ;KACzB,CACF,CAAC;IAEF,8DAA8D;IAC9D,MAAM,eAAe,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC,sBAAsB,EAAE,CAAC,IAAI,CAC7D,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE,CACpB,YAAY,CAAC;QACX,IAAI,EAAE,yBAAyB;QAC/B,IAAI,EAAE,mCAAmC,CAAC,CAAC,IAAI,EAAE;QACjD,KAAK,EAAE,CAAC;KACT,CAAC,CACH,CACF,CAAC;IACF,IAAI,eAAe,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjC,OAAO,KAAK,CAAC,CAAC,YAAY,CAAC;YACzB,IAAI,EAAE,wBAAwB;YAC9B,IAAI,EAAE,gCAAgC;YACtC,QAAQ,EAAE,+BAA+B;SAC1C,CAAC,CAAC;IACL,CAAC;IACD,MAAM,CAAC,cAAc,CAAC,GAAG,eAAe,CAAC;IACzC,IAAI,cAAc,KAAK,SAAS,EAAE,CAAC;QACjC,OAAO,KAAK,CAAC,CAAC,YAAY,CAAC;YACzB,IAAI,EAAE,wBAAwB;YAC9B,IAAI,EAAE,gCAAgC;YACtC,QAAQ,EAAE,+BAA+B;SAC1C,CAAC,CAAC;IACL,CAAC;IACD,MAAM,YAAY,GAAG,cAAc,CAAC,IAAI,CAAC;IAEzC,6EAA6E;IAC7E,2EAA2E;IAC3E,oEAAoE;IACpE,MAAM,mBAAmB,GACvB,cAAc,CAAC,QAAQ,CAAC,QAAQ,KAAK,OAAO;QAC1C,CAAC,CAAC,cAAc,CAAC,QAAQ,CAAC,QAAQ;QAClC,CAAC,CAAC,cAAc,CAAC,QAAQ,CAAC,IAAI,CAAC;IAEnC,MAAM,KAAK,GAAkC,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,EAAE;QAC3E,MAAM,UAAU,GAAG,GAAG,KAAK,WAAW,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QACvD,MAAM,YAAY,GAAG,GAAG,CAAC;QAEzB,wEAAwE;QACxE,4DAA4D;QAC5D,MAAM,QAAQ,GAAmB;YAC/B,SAAS,EAAE,OAAO;YAClB,KAAK,EAAE,QAAQ,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE;YAC/B,GAAG,EAAE,UAAU,CACb,SAAS,CAAC;gBACR,IAAI,EAAE,YAAY;gBAClB,IAAI,EAAE,EAAE,GAAG,EAAE,YAAY,EAAE,UAAU,EAAE;aACX,CAAC,CAChC;SACF,CAAC;QAEF,MAAM,WAAW,GAAmB;YAClC,SAAS,EAAE,OAAO;YAClB,KAAK,EAAE,WAAW,UAAU,EAAE;YAC9B,GAAG,EAAE,UAAU,CACb,YAAY,CAAC;gBACX,IAAI,EAAE,eAAe;gBACrB,IAAI,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,YAAY,EAAE;aACT,CAAC,CACnC;SACF,CAAC;QAEF,oEAAoE;QACpE,yEAAyE;QACzE,MAAM,WAAW,GAAmB;YAClC,SAAS,EAAE,OAAO;YAClB,KAAK,EAAE,WAAW,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE;YAClC,GAAG,EAAE,UAAU,CACb,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;gBAClB,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,oBAAoB,CAAC,mBAAmB,CAAC,CAAC;gBAChE,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,oBAAoB,CAAC;oBAClD,KAAK;oBACL,KAAK,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC;oBACvB,KAAK,EAAE,CAAC,OAAO,CAAC;oBAChB,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;oBACrB,MAAM,EAAE,CAAC;iBACV,CAAC,CAAC;gBAEH,MAAM,SAAS,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;gBAEzC,MAAM,WAAW,GAAqB;oBACpC,IAAI,EAAE,OAAgB;oBACtB,OAAO,EAAE,UAAmB;oBAC5B,KAAK,EAAE;wBACL,IAAI,EAAE,GAAG,CAAC,KAAK,CAAC,IAAI;wBACpB,WAAW,EAAE,GAAG,CAAC,KAAK,CAAC,WAAW;wBAClC,QAAQ,EAAE,GAAG,CAAC,KAAK,CAAC,QAAQ;qBAC7B;oBACD,MAAM,EAAE;wBACN,IAAI,EAAE,UAAmB;wBACzB,QAAQ,EAAE,cAAc,CAAC,QAAQ;wBACjC,KAAK,EAAE,MAAM,CAAC,IAAI,EAAE;qBACrB;oBACD,KAAK;oBACL,IAAI,EAAE,GAAG,CAAC,KAAK,CAAC,IAAI;oBACpB,OAAO,EAAE,SAAS,EAAE,OAAO,IAAI,0BAA0B;oBACzD,SAAS,EAAE,MAAM,CAAC,eAAe,CAAC,SAAS,EAAE,SAAS,CAAC;oBACvD,kBAAkB,EAAE,EAAE;iBACvB,CAAC;gBAEF,OAAO,KAAK,CAAC,CAAC,YAAY,CAAC;oBACzB,IAAI,EAAE,eAAe;oBACrB,IAAI,EAAE;wBACJ,GAAG,EAAE,WAAW;wBAChB,KAAK,EAAE,IAAI;wBACX,iBAAiB,EAAE,MAAM,CAAC,IAAI,EAAE;wBAChC,YAAY,EAAE,MAAM,CAAC,IAAI,EAAE;wBAC3B,mBAAmB,EAAE,MAAM,CAAC,IAAI,EAAE;wBAClC,mBAAmB,EAAE,MAAM,CAAC,IAAI,EAAE;wBAClC,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC;qBACtC;iBAC8B,CAAC,CAAC;YACrC,CAAC,CAAC,CACH;SACF,CAAC;QAEF,OAAO,CAAC,QAAQ,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEH,MAAM,IAAI,GAAS;QACjB,IAAI,EAAE,MAAM;QACZ,IAAI,EAAE,eAAe;QACrB,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,oBAAoB,QAAQ,CAAC,MAAM,WAAW,CAAC;QACxE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,CAAU,EAAE,CAAC;KAC3C,CAAC;IAEF,MAAM,UAAU,GAAG,KAAK,CAAC,CAAC,aAAa,CACrC,kBAAkB,CAAC,IAAI,EAAE;QACvB,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,OAAO,EAAE,IAAI,CAAC,OAAO;KACtB,CAAC,EACF,EAAE,WAAW,EAAE,cAAc,CAAC,QAAQ,CAAC,IAAI,EAAE,CAC9C,CAAC;IACF,KAAK,CAAC,CAAC,4BAA4B,CACjC,uBAAuB,CACrB,uBAAuB,CAAC,UAAU,EAAE;QAClC,WAAW,EAAE,OAAO;QACpB,UAAU,EAAE,UAAU;KACvB,CAAC,CACH,CACF,CAAC;IACF,KAAK,CAAC,CAAC,wBAAwB,CAAC,aAAa,EAAE,UAAU,CAAC,CAAC;IAE3D,KAAK,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;AAClC,CAAC,CAAC,CAAC;AAEH,MAAM,UAAU,GAAG;IACjB,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CACpC,QAAQ,CAAC,eAAe,CACtB,4FAA4F,CAC7F,CACF;IACD,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAC9B,IAAI,CAAC,eAAe,CAAC,uDAAuD,CAAC,EAC7E,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAChB;IACD,GAAG,EAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,2BAA2B,CAAC,CAAC;IACpE,KAAK,EAAE,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,2CAA2C,CAAC,CAAC;IACxF,OAAO,EAAE,WAAW,CAAC,IAAI,CACvB,IAAI,CAAC,eAAe,CAAC,kDAAkD,CAAC,CACzE;CACO,CAAC;AAEX,MAAM,CAAC,MAAM,WAAW,GAAG,OAAO,CAAC,IAAI,CACrC,MAAM,EACN,UAAU,EACV,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,CACzC,UAAU,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,KAAK,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC,IAAI,CAClE,aAAa,CAAC,uBAAuB,CAAC,EACtC,eAAe,CAAC,aAAa,CAAC,CAC/B,CACJ,CAAC,IAAI,CACJ,gBAAgB,CAAC,UAAU,CAAC,EAC5B,OAAO,CAAC,eAAe,CAAC,gCAAgC,CAAC,EACzD,OAAO,CAAC,YAAY,CAAC;IACnB;QACE,OAAO,EAAE,0BAA0B;QACnC,WAAW,EAAE,4CAA4C;KAC1D;IACD;QACE,OAAO,EAAE,4BAA4B;QACrC,WAAW,EAAE,wCAAwC;KACtD;IACD;QACE,OAAO,EAAE,mCAAmC;QAC5C,WAAW,EAAE,2BAA2B;KACzC;IACD;QACE,OAAO,EAAE,iDAAiD;QAC1D,WAAW,EAAE,6CAA6C;KAC3D;CACF,CAAC,CACH,CAAC"}

package/dist/src/root/skills/install/command-actions.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Skill install command workflow actions.
+ *
+ * Implements `InstallExtensionCommandWorkflowActions` for the skill install
+ * command. The live layer captures all required services at construction time
+ * so action methods satisfy the `R = never` contract.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as FileSystem from "effect/FileSystem";
+import * as Path from "effect/Path";
+import * as ServiceMap from "effect/ServiceMap";
+import * as Layer from "effect/Layer";
+import * as Option from "effect/Option";
+import * as Terminal from "effect/Terminal";
+import type { Handle } from "@agentxm/client-core/unstable/extensions";
+import type { VersionConstraint } from "@agentxm/client-core/unstable/version-constraints";
+import type { Source } from "@agentxm/client-core/unstable/sources";
+import { SourceHostProviders } from "@agentxm/client-core/unstable/source-resolution";
+import { CliRenderer } from "@agentxm/client-core/unstable/cli-renderer";
+import { Workspace } from "@agentxm/client-core/unstable/workspace";
+import { SkillManager, type SkillExtensionRef } from "@agentxm/client-core/unstable/skills";
+import type { InstallExtensionCommandWorkflowActions } from "@agentxm/client-core/unstable/workflows";
+import type { PlanSection } from "@agentxm/client-core/unstable/workspace";
+import { type PackageUrlParts } from "@agentxm/client-core/unstable/packaging";
+import type { InstallSkillCommandIntent } from "./intent.js";
+export interface InstallSkillSourceHandlerArgs {
+    readonly source: string;
+    readonly skills: readonly string[];
+    readonly all: boolean;
+}
+/**
+ * Parsed and validated skill install arguments.
+ */
+export interface ParsedSkillInstallArgs {
+    readonly source: Source;
+    readonly versionConstraint: Option.Option<VersionConstraint>;
+    readonly requestedSkills: ReadonlyArray<string>;
+    readonly requestedOwner: Option.Option<Handle>;
+    readonly all: boolean;
+}
+/**
+ * Source request for skill install discovery.
+ */
+export interface SkillSourceRequest {
+    readonly source: Source;
+    readonly requestedSkills: ReadonlyArray<string>;
+    readonly requestedOwner: Option.Option<Handle>;
+    readonly versionConstraint: Option.Option<VersionConstraint>;
+}
+/**
+ * Extract compatible packages from a skill ref.
+ *
+ * Registry refs have a typed `compatiblePackages` field.
+ * Local/git-hosted refs may carry them in the generic `metadata` bag.
+ *
+ * @internal Exported for testing only.
+ */
+export declare const getCompatiblePackages: (ref: SkillExtensionRef) => ReadonlyArray<PackageUrlParts>;
+/**
+ * Build the "Compatible packages" plan section from skill refs.
+ * Returns undefined when no skill has compatible packages.
+ *
+ * @internal Exported for testing only.
+ */
+export declare const buildCompatiblePackagesSection: (refs: ReadonlyArray<SkillExtensionRef>) => PlanSection | undefined;
+declare const InstallSkillCommandWorkflowActions_base: ServiceMap.ServiceClass<InstallSkillCommandWorkflowActions, "InstallSkillCommandWorkflowActions", InstallExtensionCommandWorkflowActions<InstallSkillSourceHandlerArgs, ParsedSkillInstallArgs, SkillSourceRequest, SkillExtensionRef, InstallSkillCommandIntent>>;
+export declare class InstallSkillCommandWorkflowActions extends InstallSkillCommandWorkflowActions_base {
+}
+/**
+ * Constructs the actions by resolving all services at layer-build time.
+ * Each action method closes over the captured services so `R = never`.
+ */
+export declare const InstallSkillCommandWorkflowActionsLive: Layer.Layer<InstallSkillCommandWorkflowActions, never, CliRenderer | FileSystem.FileSystem | Path.Path | Terminal.Terminal | "effect/unstable/cli/GlobalFlag/axm-non-interactive" | Workspace | SourceHostProviders | SkillManager>;
+export {};
+//# sourceMappingURL=command-actions.d.ts.map

package/dist/src/root/skills/install/command-actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-actions.d.ts","sourceRoot":"","sources":["../../../../../src/root/skills/install/command-actions.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AAIpC,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAEhD,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,QAAQ,MAAM,iBAAiB,CAAC;AAG5C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0CAA0C,CAAC;AACvE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mDAAmD,CAAC;AAE3F,OAAO,KAAK,EAAE,MAAM,EAAoB,MAAM,uCAAuC,CAAC;AACtF,OAAO,EAAE,mBAAmB,EAAE,MAAM,iDAAiD,CAAC;AACtF,OAAO,EAAE,WAAW,EAAE,MAAM,4CAA4C,CAAC;AACzE,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,KAAK,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AAE5F,OAAO,KAAK,EAAE,sCAAsC,EAAE,MAAM,yCAAyC,CAAC;AACtG,OAAO,KAAK,EAAQ,WAAW,EAAE,MAAM,yCAAyC,CAAC;AACjF,OAAO,EAGL,KAAK,eAAe,EACrB,MAAM,yCAAyC,CAAC;AACjD,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AAW7D,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC;IAC7D,QAAQ,CAAC,eAAe,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAChD,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC/C,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,eAAe,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAChD,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC/C,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC;CAC9D;AAoED;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,GAAI,KAAK,iBAAiB,KAAG,aAAa,CAAC,eAAe,CAkB3F,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,8BAA8B,GACzC,MAAM,aAAa,CAAC,iBAAiB,CAAC,KACrC,WAAW,GAAG,SAgBhB,CAAC;;AAgCF,qBAAa,kCAAmC,SAAQ,uCASf;CAAG;AAM5C;;;GAGG;AACH,eAAO,MAAM,sCAAsC,qOA+OlD,CAAC"}