@axm.sh/cli 0.0.1

package/dist/src/extensions/skills/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Skills management module for @axm.sh/core.
+ *
+ * @experimental All exports from this module are unstable and may change without notice.
+ * @packageDocumentation
+ */
+export type { SourceType as LockSourceType } from "../../sources/index.js";
+export { cloneRepo, getCurrentCommit, getTreeSha, isGitRepository, resolveRef, shallowClone, } from "../../sources/index.js";
+export type { GitError } from "../../sources/index.js";
+export { buildCloneUrl, CloneUrlError, getOrigin, isGitHostingProviderSource, ParseError, printSourceInput, } from "../../sources/index.js";
+export type { LockEntry, Skill } from "./types.js";
+export type { AzureReposSource, GitHostingProviderSource, SourceInput, SourceType, } from "../../sources/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/extensions/skills/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/extensions/skills/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,YAAY,EAAE,UAAU,IAAI,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAG3E,OAAO,EACL,SAAS,EACT,gBAAgB,EAChB,UAAU,EACV,eAAe,EACf,UAAU,EACV,YAAY,GACb,MAAM,wBAAwB,CAAC;AAChC,YAAY,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAGvD,OAAO,EACL,aAAa,EACb,aAAa,EACb,SAAS,EACT,0BAA0B,EAC1B,UAAU,EACV,gBAAgB,GACjB,MAAM,wBAAwB,CAAC;AAGhC,YAAY,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAGnD,YAAY,EACV,gBAAgB,EAChB,wBAAwB,EACxB,WAAW,EACX,UAAU,GACX,MAAM,wBAAwB,CAAC"}

package/dist/src/extensions/skills/index.js

@@ -0,0 +1,11 @@
+/**
+ * Skills management module for @axm.sh/core.
+ *
+ * @experimental All exports from this module are unstable and may change without notice.
+ * @packageDocumentation
+ */
+// Git - re-exported from sources/
+export { cloneRepo, getCurrentCommit, getTreeSha, isGitRepository, resolveRef, shallowClone, } from "../../sources/index.js";
+// Source Parser - re-exported from sources/
+export { buildCloneUrl, CloneUrlError, getOrigin, isGitHostingProviderSource, ParseError, printSourceInput, } from "../../sources/index.js";
+//# sourceMappingURL=index.js.map

package/dist/src/extensions/skills/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/extensions/skills/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,kCAAkC;AAClC,OAAO,EACL,SAAS,EACT,gBAAgB,EAChB,UAAU,EACV,eAAe,EACf,UAAU,EACV,YAAY,GACb,MAAM,wBAAwB,CAAC;AAGhC,4CAA4C;AAC5C,OAAO,EACL,aAAa,EACb,aAAa,EACb,SAAS,EACT,0BAA0B,EAC1B,UAAU,EACV,gBAAgB,GACjB,MAAM,wBAAwB,CAAC"}

package/dist/src/extensions/skills/manifest-schema.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Skill manifest schema definition.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as Schema from "effect/Schema";
+/**
+ * Schema for skill manifest files (axm-skill.json).
+ *
+ * Skills extend coding agent capabilities with reusable prompts
+ * and context that can be invoked on demand.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const SkillManifestSchema: Schema.Struct<{
+    agents: Schema.optional<Schema.Array$<typeof Schema.String>>;
+    dependencies: Schema.optional<Schema.Record$<typeof Schema.String, typeof Schema.String>>;
+    name: Schema.filter<typeof Schema.String>;
+    version: typeof Schema.String;
+    description: Schema.optional<typeof Schema.String>;
+    keywords: Schema.optional<Schema.Array$<typeof Schema.String>>;
+    repository: Schema.optional<typeof Schema.String>;
+    homepage: Schema.optional<typeof Schema.String>;
+    license: Schema.optional<typeof Schema.String>;
+    bugs: Schema.optional<typeof Schema.String>;
+    authors: Schema.optional<Schema.Array$<Schema.Struct<{
+        name: typeof Schema.String;
+        email: Schema.optional<typeof Schema.String>;
+        url: Schema.optional<typeof Schema.String>;
+    }>>>;
+}>;
+/**
+ * Inferred type for SkillManifest schema.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export type SkillManifest = typeof SkillManifestSchema.Type;
+//# sourceMappingURL=manifest-schema.d.ts.map

package/dist/src/extensions/skills/manifest-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest-schema.d.ts","sourceRoot":"","sources":["../../../../src/extensions/skills/manifest-schema.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAGxC;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;EAI9B,CAAC;AAEH;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,mBAAmB,CAAC,IAAI,CAAC"}

package/dist/src/extensions/skills/manifest-schema.js

@@ -0,0 +1,21 @@
+/**
+ * Skill manifest schema definition.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as Schema from "effect/Schema";
+import { CommonManifestFields } from "../common.js";
+/**
+ * Schema for skill manifest files (axm-skill.json).
+ *
+ * Skills extend coding agent capabilities with reusable prompts
+ * and context that can be invoked on demand.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const SkillManifestSchema = Schema.Struct({
+    ...CommonManifestFields,
+    agents: Schema.optional(Schema.Array(Schema.String)),
+    dependencies: Schema.optional(Schema.Record({ key: Schema.String, value: Schema.String })),
+});
+//# sourceMappingURL=manifest-schema.js.map

package/dist/src/extensions/skills/manifest-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest-schema.js","sourceRoot":"","sources":["../../../../src/extensions/skills/manifest-schema.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEpD;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,MAAM,CAAC,MAAM,CAAC;IAC/C,GAAG,oBAAoB;IACvB,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACpD,YAAY,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;CAC3F,CAAC,CAAC"}

package/dist/src/extensions/skills/state/index.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Skills state types module - V2 types for workspace-based architecture.
+ *
+ * This module provides types for the state-based reconciliation model:
+ * - **Actual state** - What exists on disk (.axm/skills/)
+ * - **Locked state** - What the lockfile says should exist (axm-lock.yaml)
+ * - **Ideal state** - Desired state after an operation
+ * - **Plan** - Changes to transform actual to ideal
+ *
+ * For the implementation, use the workspace module:
+ * @see {@link ../workspace/index.js}
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   loadCurrentState,
+ *   buildIdealForInstall,
+ *   buildPlan,
+ *   planHasChanges,
+ *   applyPlan,
+ * } from "../workspace/index.js";
+ *
+ * const program = Effect.gen(function* () {
+ *   // Load current state
+ *   const current = yield* loadCurrentState(axmDir);
+ *
+ *   // Build ideal state for install
+ *   const ideal = yield* buildIdealForInstall(current, source, options);
+ *
+ *   // Build plan
+ *   const plan = buildPlan(current, ideal);
+ *
+ *   // Check if there are changes
+ *   if (!planHasChanges(plan)) {
+ *     console.log("Already up to date");
+ *     return;
+ *   }
+ *
+ *   // Apply plan
+ *   yield* applyPlan(plan);
+ * });
+ * ```
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+export type { ActualSkill, ActualSkillIssue, AnyIssue, CurrentState, DiffSummary, IdealSkillLegacy, IdealSkillsState, IdealSkillType as IdealSkill, IdealSkillV2, IdealState, LockedSkill, LockedSkillV2, Severity, SkillChange, SkillChangeWithName, SkillFrontmatter, SkillSource, SourceInput, SkillState, SkillStateIssue, SkillStateV2, SkillsDiff, SkillsDiffJson, SkillsState, SkillValidity, SkillValidityCode, ValiditySeverity, WorkspaceIssue, } from "./types.js";
+export { ActualSkillIssue as ActualSkillIssueConstructors, ActualSkillIssueSchema, ActualSkillSchema, AnyIssueSchema, CurrentStateSchema, DiffSummarySchema, getValidityCode, IdealSkill as IdealSkillConstructors, IdealSkillLegacySchema, IdealSkillsStateSchema, IdealSkillV2 as IdealSkillV2Constructors, IdealSkillV2Schema, IdealStateV2Schema, LockedSkillSchema, LockedSkillV2Schema, SeveritySchema, SkillChange as SkillChangeConstructors, SkillChangeSchema, SkillFrontmatterSchema, SkillSource as SkillSourceConstructors, SkillSourceSchema, SkillStateIssue as SkillStateIssueConstructors, SkillStateIssueSchema, SkillStateSchema, SkillStateV2Schema, SkillsDiffSchema, SkillsStateSchema, SkillValidity as SkillValidityConstructors, SkillValiditySchema, severityFromCode, skillsDiffToJson, WorkspaceIssue as WorkspaceIssueConstructors, WorkspaceIssueSchema, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/extensions/skills/state/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/extensions/skills/state/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AAQH,YAAY,EACV,WAAW,EACX,gBAAgB,EAChB,QAAQ,EACR,YAAY,EACZ,WAAW,EACX,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,IAAI,UAAU,EAC5B,YAAY,EACZ,UAAU,EACV,WAAW,EACX,aAAa,EACb,QAAQ,EACR,WAAW,EACX,mBAAmB,EACnB,gBAAgB,EAChB,WAAW,EACX,WAAW,EACX,UAAU,EACV,eAAe,EACf,YAAY,EACZ,UAAU,EACV,cAAc,EACd,WAAW,EACX,aAAa,EACb,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,GACf,MAAM,YAAY,CAAC;AASpB,OAAO,EACL,gBAAgB,IAAI,4BAA4B,EAChD,sBAAsB,EACtB,iBAAiB,EACjB,cAAc,EACd,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EACf,UAAU,IAAI,sBAAsB,EACpC,sBAAsB,EACtB,sBAAsB,EACtB,YAAY,IAAI,wBAAwB,EACxC,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,cAAc,EACd,WAAW,IAAI,uBAAuB,EACtC,iBAAiB,EACjB,sBAAsB,EACtB,WAAW,IAAI,uBAAuB,EACtC,iBAAiB,EACjB,eAAe,IAAI,2BAA2B,EAC9C,qBAAqB,EACrB,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,aAAa,IAAI,yBAAyB,EAC1C,mBAAmB,EACnB,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,IAAI,0BAA0B,EAC5C,oBAAoB,GACrB,MAAM,YAAY,CAAC"}

package/dist/src/extensions/skills/state/index.js

@@ -0,0 +1,54 @@
+/**
+ * Skills state types module - V2 types for workspace-based architecture.
+ *
+ * This module provides types for the state-based reconciliation model:
+ * - **Actual state** - What exists on disk (.axm/skills/)
+ * - **Locked state** - What the lockfile says should exist (axm-lock.yaml)
+ * - **Ideal state** - Desired state after an operation
+ * - **Plan** - Changes to transform actual to ideal
+ *
+ * For the implementation, use the workspace module:
+ * @see {@link ../workspace/index.js}
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   loadCurrentState,
+ *   buildIdealForInstall,
+ *   buildPlan,
+ *   planHasChanges,
+ *   applyPlan,
+ * } from "../workspace/index.js";
+ *
+ * const program = Effect.gen(function* () {
+ *   // Load current state
+ *   const current = yield* loadCurrentState(axmDir);
+ *
+ *   // Build ideal state for install
+ *   const ideal = yield* buildIdealForInstall(current, source, options);
+ *
+ *   // Build plan
+ *   const plan = buildPlan(current, ideal);
+ *
+ *   // Check if there are changes
+ *   if (!planHasChanges(plan)) {
+ *     console.log("Already up to date");
+ *     return;
+ *   }
+ *
+ *   // Apply plan
+ *   yield* applyPlan(plan);
+ * });
+ * ```
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+// =============================================================================
+// Schemas and Constructors
+// =============================================================================
+// Legacy schemas and constructors
+// New reconciliation constructors and schemas
+// Backwards compatibility: IdealSkill constructor alias for IdealSkillV2
+export { ActualSkillIssue as ActualSkillIssueConstructors, ActualSkillIssueSchema, ActualSkillSchema, AnyIssueSchema, CurrentStateSchema, DiffSummarySchema, getValidityCode, IdealSkill as IdealSkillConstructors, IdealSkillLegacySchema, IdealSkillsStateSchema, IdealSkillV2 as IdealSkillV2Constructors, IdealSkillV2Schema, IdealStateV2Schema, LockedSkillSchema, LockedSkillV2Schema, SeveritySchema, SkillChange as SkillChangeConstructors, SkillChangeSchema, SkillFrontmatterSchema, SkillSource as SkillSourceConstructors, SkillSourceSchema, SkillStateIssue as SkillStateIssueConstructors, SkillStateIssueSchema, SkillStateSchema, SkillStateV2Schema, SkillsDiffSchema, SkillsStateSchema, SkillValidity as SkillValidityConstructors, SkillValiditySchema, severityFromCode, skillsDiffToJson, WorkspaceIssue as WorkspaceIssueConstructors, WorkspaceIssueSchema, } from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/src/extensions/skills/state/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/extensions/skills/state/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AAuCH,gFAAgF;AAChF,2BAA2B;AAC3B,gFAAgF;AAEhF,kCAAkC;AAClC,8CAA8C;AAC9C,yEAAyE;AACzE,OAAO,EACL,gBAAgB,IAAI,4BAA4B,EAChD,sBAAsB,EACtB,iBAAiB,EACjB,cAAc,EACd,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EACf,UAAU,IAAI,sBAAsB,EACpC,sBAAsB,EACtB,sBAAsB,EACtB,YAAY,IAAI,wBAAwB,EACxC,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,cAAc,EACd,WAAW,IAAI,uBAAuB,EACtC,iBAAiB,EACjB,sBAAsB,EACtB,WAAW,IAAI,uBAAuB,EACtC,iBAAiB,EACjB,eAAe,IAAI,2BAA2B,EAC9C,qBAAqB,EACrB,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,aAAa,IAAI,yBAAyB,EAC1C,mBAAmB,EACnB,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,IAAI,0BAA0B,EAC5C,oBAAoB,GACrB,MAAM,YAAY,CAAC"}

package/dist/src/extensions/skills/state/pure-functions.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Pure functions for skills state management.
+ *
+ * These functions are pure (no side effects) and can be tested without effects.
+ * They compute derived values from state without modifying anything.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import * as Option from "effect/Option";
+import type { SourceInput } from "../../../sources/types.js";
+/**
+ * Skill source type re-exported from sources/types.ts for convenience.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export type SkillSource = SourceInput;
+/**
+ * Compute install path from source type and skill name.
+ *
+ * Registry skills are installed to scoped directories:
+ * `.axm/extensions/@<scope>/skills/<name>`
+ *
+ * External skills (GitHub, Local) are installed to a shared external directory:
+ * `.axm/extensions/external/skills/<name>`
+ *
+ * @param source - The skill source (Registry, GitHub, or Local)
+ * @param name - The skill name to use in the path
+ * @returns The relative install path for the skill
+ *
+ * @example
+ * ```typescript
+ * import { Option } from "effect";
+ *
+ * // Registry source
+ * const registrySource = {
+ *   _tag: "Registry" as const,
+ *   location: { _tag: "Remote" as const, url: "https://registry.example.com" },
+ *   scope: "official",
+ *   name: "commit",
+ *   version: Option.some("1.0.0"),
+ * };
+ * computeInstallPath(registrySource, "commit");
+ * // => ".axm/extensions/@official/skills/commit"
+ *
+ * // GitHub source
+ * const githubSource = {
+ *   _tag: "GitHub" as const,
+ *   owner: "anthropics",
+ *   repo: "skills",
+ *   ref: Option.none(),
+ *   path: Option.none(),
+ * };
+ * computeInstallPath(githubSource, "my-skill");
+ * // => ".axm/extensions/external/skills/my-skill"
+ * ```
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const computeInstallPath: (source: SkillSource, name: string) => string;
+/**
+ * Compare two optional version strings for equality.
+ *
+ * This function handles version comparison with the following logic:
+ * - If both are None, they're equal (returns true)
+ * - If one is None and one is Some, they're not equal (returns false)
+ * - If both are Some, attempt semver comparison first:
+ *   - If both parse as valid semver, use semver.eq() for comparison
+ *   - If either fails to parse as semver, fall back to string equality
+ *
+ * This is useful for comparing versions from different source types:
+ * - Registry sources use semver (e.g., "1.0.0", "2.1.0-beta.1")
+ * - Git sources may use non-semver identifiers (e.g., git tree hashes)
+ *
+ * @param a - First optional version string
+ * @param b - Second optional version string
+ * @returns true if versions are equal, false otherwise
+ *
+ * @example
+ * ```typescript
+ * import { Option } from "effect";
+ *
+ * // Both None - equal
+ * versionsEqual(Option.none(), Option.none()); // true
+ *
+ * // One None - not equal
+ * versionsEqual(Option.some("1.0.0"), Option.none()); // false
+ *
+ * // Both valid semver - uses semver comparison
+ * versionsEqual(Option.some("1.0.0"), Option.some("1.0.0")); // true
+ * versionsEqual(Option.some("1.0.0+build1"), Option.some("1.0.0+build2")); // true (build metadata ignored)
+ *
+ * // Non-semver strings - falls back to string equality
+ * versionsEqual(Option.some("abc123"), Option.some("abc123")); // true
+ * versionsEqual(Option.some("abc123"), Option.some("def456")); // false
+ * ```
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const versionsEqual: (a: Option.Option<string>, b: Option.Option<string>) => boolean;
+//# sourceMappingURL=pure-functions.d.ts.map

package/dist/src/extensions/skills/state/pure-functions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pure-functions.d.ts","sourceRoot":"","sources":["../../../../../src/extensions/skills/state/pure-functions.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAE7D;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAAG,WAAW,CAAC;AAMtC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,eAAO,MAAM,kBAAkB,GAAI,QAAQ,WAAW,EAAE,MAAM,MAAM,KAAG,MAQtE,CAAC;AAMF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,eAAO,MAAM,aAAa,GAAI,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,KAAG,OAYhF,CAAC"}

package/dist/src/extensions/skills/state/pure-functions.js

@@ -0,0 +1,118 @@
+/**
+ * Pure functions for skills state management.
+ *
+ * These functions are pure (no side effects) and can be tested without effects.
+ * They compute derived values from state without modifying anything.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import { pipe } from "effect/Function";
+import * as Option from "effect/Option";
+import * as semver from "semver";
+// =============================================================================
+// Install Path Computation
+// =============================================================================
+/**
+ * Compute install path from source type and skill name.
+ *
+ * Registry skills are installed to scoped directories:
+ * `.axm/extensions/@<scope>/skills/<name>`
+ *
+ * External skills (GitHub, Local) are installed to a shared external directory:
+ * `.axm/extensions/external/skills/<name>`
+ *
+ * @param source - The skill source (Registry, GitHub, or Local)
+ * @param name - The skill name to use in the path
+ * @returns The relative install path for the skill
+ *
+ * @example
+ * ```typescript
+ * import { Option } from "effect";
+ *
+ * // Registry source
+ * const registrySource = {
+ *   _tag: "Registry" as const,
+ *   location: { _tag: "Remote" as const, url: "https://registry.example.com" },
+ *   scope: "official",
+ *   name: "commit",
+ *   version: Option.some("1.0.0"),
+ * };
+ * computeInstallPath(registrySource, "commit");
+ * // => ".axm/extensions/@official/skills/commit"
+ *
+ * // GitHub source
+ * const githubSource = {
+ *   _tag: "GitHub" as const,
+ *   owner: "anthropics",
+ *   repo: "skills",
+ *   ref: Option.none(),
+ *   path: Option.none(),
+ * };
+ * computeInstallPath(githubSource, "my-skill");
+ * // => ".axm/extensions/external/skills/my-skill"
+ * ```
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const computeInstallPath = (source, name) => {
+    switch (source.type) {
+        case "registry":
+            // Registry sources don't have scope in the unified Source type
+            return `.axm/extensions/external/skills/${name}`;
+        default:
+            return `.axm/extensions/external/skills/${name}`;
+    }
+};
+// =============================================================================
+// Version Comparison
+// =============================================================================
+/**
+ * Compare two optional version strings for equality.
+ *
+ * This function handles version comparison with the following logic:
+ * - If both are None, they're equal (returns true)
+ * - If one is None and one is Some, they're not equal (returns false)
+ * - If both are Some, attempt semver comparison first:
+ *   - If both parse as valid semver, use semver.eq() for comparison
+ *   - If either fails to parse as semver, fall back to string equality
+ *
+ * This is useful for comparing versions from different source types:
+ * - Registry sources use semver (e.g., "1.0.0", "2.1.0-beta.1")
+ * - Git sources may use non-semver identifiers (e.g., git tree hashes)
+ *
+ * @param a - First optional version string
+ * @param b - Second optional version string
+ * @returns true if versions are equal, false otherwise
+ *
+ * @example
+ * ```typescript
+ * import { Option } from "effect";
+ *
+ * // Both None - equal
+ * versionsEqual(Option.none(), Option.none()); // true
+ *
+ * // One None - not equal
+ * versionsEqual(Option.some("1.0.0"), Option.none()); // false
+ *
+ * // Both valid semver - uses semver comparison
+ * versionsEqual(Option.some("1.0.0"), Option.some("1.0.0")); // true
+ * versionsEqual(Option.some("1.0.0+build1"), Option.some("1.0.0+build2")); // true (build metadata ignored)
+ *
+ * // Non-semver strings - falls back to string equality
+ * versionsEqual(Option.some("abc123"), Option.some("abc123")); // true
+ * versionsEqual(Option.some("abc123"), Option.some("def456")); // false
+ * ```
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const versionsEqual = (a, b) => pipe(Option.all([a, b]), Option.match({
+    onNone: () => Option.isNone(a) && Option.isNone(b),
+    onSome: ([va, vb]) => {
+        // Attempt semver comparison, fall back to string equality
+        const parsedA = semver.parse(va);
+        const parsedB = semver.parse(vb);
+        return parsedA && parsedB ? semver.eq(parsedA, parsedB) : va === vb;
+    },
+}));
+//# sourceMappingURL=pure-functions.js.map

package/dist/src/extensions/skills/state/pure-functions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pure-functions.js","sourceRoot":"","sources":["../../../../../src/extensions/skills/state/pure-functions.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACvC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AAUjC,gFAAgF;AAChF,2BAA2B;AAC3B,gFAAgF;AAEhF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,MAAmB,EAAE,IAAY,EAAU,EAAE;IAC9E,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,KAAK,UAAU;YACb,+DAA+D;YAC/D,OAAO,mCAAmC,IAAI,EAAE,CAAC;QACnD;YACE,OAAO,mCAAmC,IAAI,EAAE,CAAC;IACrD,CAAC;AACH,CAAC,CAAC;AAEF,gFAAgF;AAChF,qBAAqB;AACrB,gFAAgF;AAEhF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAwB,EAAE,CAAwB,EAAW,EAAE,CAC3F,IAAI,CACF,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAClB,MAAM,CAAC,KAAK,CAAC;IACX,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;IAClD,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE;QACnB,0DAA0D;QAC1D,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACjC,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACjC,OAAO,OAAO,IAAI,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC;IACtE,CAAC;CACF,CAAC,CACH,CAAC"}