@axm.sh/cli 0.0.1

package/dist/src/resolution/resolver.js

@@ -0,0 +1,105 @@
+/**
+ * Main extension resolution entry point.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import * as Array from "effect/Array";
+import * as Effect from "effect/Effect";
+import * as Option from "effect/Option";
+import { resolveAmbiguous, resolveAxmName, resolveBareName, resolveExplicitSource, resolveLocalPath, resolveUrl, } from "./resolvers/index.js";
+/**
+ * Default resolution options with all fields set to None.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const defaultResolutionOptions = {
+    types: Option.none(),
+    sources: Option.none(),
+    agents: Option.none(),
+    cwd: Option.none(),
+    scope: Option.none(),
+    projectDir: Option.none(),
+    globalDir: Option.none(),
+};
+/**
+ * Filters extension references by source type.
+ *
+ * If sources is undefined or empty, returns all refs (no filtering).
+ * Otherwise, only returns refs whose source matches one of the specified sources.
+ *
+ * @param refs - Extension references to filter
+ * @param sources - Optional list of source types to include
+ * @returns Filtered extension references
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+const filterBySource = (refs, sources) => {
+    if (!sources || sources.length === 0)
+        return refs;
+    const sourceSet = new Set(sources);
+    return refs.filter((ref) => sourceSet.has(ref.source));
+};
+/**
+ * Filters extension references by extension type.
+ *
+ * If types is undefined or empty, returns all refs (no filtering).
+ * Otherwise, only returns refs whose type matches one of the specified types.
+ *
+ * @param refs - Extension references to filter
+ * @param types - Optional list of extension types to include
+ * @returns Filtered extension references
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+const filterByType = (refs, types) => {
+    if (!types || types.length === 0)
+        return refs;
+    const typeSet = new Set(types);
+    return refs.filter((ref) => typeSet.has(ref.type));
+};
+/**
+ * Resolves an extension input string to one or more extension references.
+ *
+ * Tries resolvers in order and returns the first non-empty result:
+ * 1. resolveAxmName - Scoped names like @owner/name
+ * 2. resolveBareName - Bare names like name
+ * 3. resolveExplicitSource - Explicit source prefixes (github:, gitlab:, etc.)
+ * 4. resolveAmbiguous - Multiple matches requiring user selection
+ * 5. resolveUrl - Direct URLs
+ *
+ * After resolution, filters results by source type and extension type if specified in options.
+ *
+ * @param input - The extension input string to resolve
+ * @param options - Resolution configuration options
+ * @returns Effect resolving to array of extension references (empty if no matches)
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const resolveExtension = (input, options = defaultResolutionOptions) => {
+    const resolvers = [
+        resolveAxmName,
+        resolveBareName,
+        resolveLocalPath,
+        resolveExplicitSource,
+        resolveAmbiguous,
+        resolveUrl,
+    ];
+    const tryResolvers = (remaining) => Effect.gen(function* () {
+        const maybeResolver = Array.head(remaining);
+        if (Option.isNone(maybeResolver))
+            return [];
+        const resolver = maybeResolver.value;
+        const rest = Array.tailNonEmpty(remaining);
+        const result = yield* resolver(input, options);
+        if (result.length > 0)
+            return result;
+        return yield* tryResolvers(rest);
+    });
+    return Effect.gen(function* () {
+        const results = yield* tryResolvers(resolvers);
+        const filteredBySource = filterBySource(results, Option.getOrUndefined(options.sources));
+        return filterByType(filteredBySource, Option.getOrUndefined(options.types));
+    });
+};
+//# sourceMappingURL=resolver.js.map

package/dist/src/resolution/resolver.js.map

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

package/dist/src/resolution/resolvers/ambiguous.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Ambiguous pattern resolver for `a/b` inputs.
+ *
+ * Disambiguates inputs that could be AXM names or source shorthand.
+ * Resolution order: AXM name -> Git hosting sources in workspace order.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import type { FileSystem } from "@effect/platform";
+import * as Effect from "effect/Effect";
+import { Workspace } from "../../workspace/index.js";
+import type { ExtensionRef, ResolutionOptions } from "../types.js";
+/**
+ * Resolve ambiguous `a/b` patterns that could be AXM names or source shorthand.
+ *
+ * Resolution order (early exit on first non-empty result):
+ * 1. Check if `@a/b` exists as an AXM name (treat first segment as scope)
+ * 2. Fall back to git hosting sources in workspace order (github, gitlab, bitbucket)
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @param input - The input string to resolve (expected format: `a/b`)
+ * @param options - Resolution options
+ * @returns Effect containing array of ExtensionRefs, or empty array if not a match
+ *
+ * @example
+ * ```typescript
+ * import { resolveAmbiguous } from "../../resolution/index.js";
+ * import { NodeFileSystem } from "@effect/platform-node";
+ * import { Effect } from "effect";
+ *
+ * const program = resolveAmbiguous("owner/repo", { cwd: "/home/user" }).pipe(
+ *   Effect.provide(NodeFileSystem.layer),
+ * );
+ *
+ * // If @owner/repo exists in AXM -> returns registry ExtensionRef
+ * // Else -> returns ExtensionRef from first git source that responds 200
+ * const refs = await Effect.runPromise(program);
+ * ```
+ */
+export declare const resolveAmbiguous: (input: string, options: ResolutionOptions) => Effect.Effect<ExtensionRef[], never, FileSystem.FileSystem | Workspace>;
+//# sourceMappingURL=ambiguous.d.ts.map

package/dist/src/resolution/resolvers/ambiguous.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ambiguous.d.ts","sourceRoot":"","sources":["../../../../src/resolution/resolvers/ambiguous.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAGxC,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAkLnE;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,eAAO,MAAM,gBAAgB,GAAI,OAAO,MAAM,EAAE,SAAS,iBAAiB,4EAmCzE,CAAC"}

package/dist/src/resolution/resolvers/ambiguous.js

@@ -0,0 +1,216 @@
+/**
+ * Ambiguous pattern resolver for `a/b` inputs.
+ *
+ * Disambiguates inputs that could be AXM names or source shorthand.
+ * Resolution order: AXM name -> Git hosting sources in workspace order.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import * as Effect from "effect/Effect";
+import * as Option from "effect/Option";
+import { Workspace } from "../../workspace/index.js";
+import { resolveAxmName } from "./axm-name.js";
+// -----------------------------------------------------------------------------
+// Pattern Detection
+// -----------------------------------------------------------------------------
+/**
+ * Pattern for ambiguous `a/b` inputs.
+ * Matches: something/something (no prefix, no @, not a path prefix)
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+const AMBIGUOUS_PATTERN = /^[^/@.:][^/@:]*\/[^/@]+(?:\/[^@]+)?(?:@.+)?$/;
+/**
+ * Check if input is an ambiguous `a/b` pattern.
+ *
+ * Returns false if:
+ * - Input has a known prefix (github:, gitlab:, etc.)
+ * - Input starts with @ (scoped package)
+ * - Input is a local path (./,  ../, /, C:\)
+ * - Input is a URL
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+const isAmbiguousPattern = (input) => {
+    const trimmed = input.trim();
+    // Skip if empty
+    if (!trimmed)
+        return false;
+    // Skip if has known prefix
+    if (/^(github|gitlab|bitbucket|azure):/.test(trimmed))
+        return false;
+    // Skip if starts with @ (scoped package name)
+    if (trimmed.startsWith("@"))
+        return false;
+    // Skip if looks like a local path
+    if (/^(\.\.?\/|\/|~[/\\]|[A-Za-z]:[\\/])/.test(trimmed))
+        return false;
+    // Skip if looks like a URL
+    if (/^https?:\/\//.test(trimmed))
+        return false;
+    // Skip if looks like SSH URL
+    if (/^git@/.test(trimmed))
+        return false;
+    // Must match the ambiguous pattern
+    return AMBIGUOUS_PATTERN.test(trimmed);
+};
+// -----------------------------------------------------------------------------
+// Helper: Build Origin URL
+// -----------------------------------------------------------------------------
+/**
+ * Build probe URL from source config and owner/repo pattern.
+ * Returns None for sources that don't support owner/repo pattern.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+const buildProbeUrl = (source, owner, repo) => {
+    if (source.type === "github" || source.type === "gitlab" || source.type === "bitbucket") {
+        return Option.some(`${source.url.origin}/${owner}/${repo}`);
+    }
+    // Azure Repos uses different URL format, registry/local don't apply
+    return Option.none();
+};
+// -----------------------------------------------------------------------------
+// Sub-Resolvers
+// -----------------------------------------------------------------------------
+/**
+ * Try to resolve as AXM scoped name by prepending @.
+ *
+ * Converts `scope/name` to `@scope/name` and delegates to resolveAxmName.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+const tryAxmName = (input, options) => {
+    // Extract scope and name from input (a/b -> @a/b)
+    const match = input.match(/^([^/@]+)\/([^/@]+)(?:@(.+))?$/);
+    if (!match || !match[1] || !match[2]) {
+        return Effect.succeed([]);
+    }
+    const scope = match[1];
+    const name = match[2];
+    const version = match[3];
+    // Build AXM name: @scope/name[@version]
+    const axmName = version ? `@${scope}/${name}@${version}` : `@${scope}/${name}`;
+    return resolveAxmName(axmName, options);
+};
+/**
+ * Resolve via git hosting sources from workspace configuration.
+ * Tries sources in order, first successful probe wins.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+const tryGitSources = (input, options) => {
+    // Extract owner/repo from input
+    const match = input.match(/^([^/@]+)\/([^/@]+)(?:@(.+))?$/);
+    if (!match || !match[1] || !match[2]) {
+        return Effect.succeed([]);
+    }
+    const owner = match[1];
+    const repo = match[2];
+    const version = match[3];
+    return Effect.gen(function* () {
+        const workspace = yield* Workspace;
+        const allSources = yield* workspace.getConfiguredSources();
+        // Filter to git-hosting sources
+        const gitSources = allSources.filter((s) => s.type === "github" || s.type === "gitlab" || s.type === "bitbucket");
+        // Apply source filter if provided
+        const sourcesFilter = Option.getOrUndefined(options.sources);
+        const filteredSources = sourcesFilter
+            ? gitSources.filter((s) => sourcesFilter.includes(s.type))
+            : gitSources;
+        // Try each source in order
+        for (const source of filteredSources) {
+            const probeUrl = buildProbeUrl(source, owner, repo);
+            if (Option.isNone(probeUrl))
+                continue;
+            // Probe with HEAD request
+            const probeResult = yield* Effect.tryPromise({
+                try: () => fetch(probeUrl.value, { method: "HEAD" }),
+                catch: () => null, // Network error - continue to next source
+            });
+            if (probeResult && probeResult.ok) {
+                // Found it! Build ExtensionRef
+                const ref = {
+                    type: "skill",
+                    source: source.type,
+                    origin: probeUrl.value,
+                    originalInput: input,
+                    name: Option.none(),
+                    ref: Option.none(),
+                    path: Option.none(),
+                    metadata: {
+                        version: Option.none(),
+                        description: Option.none(),
+                        files: Option.none(),
+                        versionConstraint: Option.fromNullable(version),
+                    },
+                };
+                return [ref];
+            }
+        }
+        // No sources succeeded
+        return [];
+    }).pipe(Effect.catchAll(() => Effect.succeed([])));
+};
+// -----------------------------------------------------------------------------
+// Main Resolver
+// -----------------------------------------------------------------------------
+/**
+ * Resolve ambiguous `a/b` patterns that could be AXM names or source shorthand.
+ *
+ * Resolution order (early exit on first non-empty result):
+ * 1. Check if `@a/b` exists as an AXM name (treat first segment as scope)
+ * 2. Fall back to git hosting sources in workspace order (github, gitlab, bitbucket)
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @param input - The input string to resolve (expected format: `a/b`)
+ * @param options - Resolution options
+ * @returns Effect containing array of ExtensionRefs, or empty array if not a match
+ *
+ * @example
+ * ```typescript
+ * import { resolveAmbiguous } from "../../resolution/index.js";
+ * import { NodeFileSystem } from "@effect/platform-node";
+ * import { Effect } from "effect";
+ *
+ * const program = resolveAmbiguous("owner/repo", { cwd: "/home/user" }).pipe(
+ *   Effect.provide(NodeFileSystem.layer),
+ * );
+ *
+ * // If @owner/repo exists in AXM -> returns registry ExtensionRef
+ * // Else -> returns ExtensionRef from first git source that responds 200
+ * const refs = await Effect.runPromise(program);
+ * ```
+ */
+export const resolveAmbiguous = (input, options) => {
+    const trimmed = input.trim();
+    // Return empty array if input doesn't match ambiguous pattern
+    if (!isAmbiguousPattern(trimmed)) {
+        return Effect.succeed([]);
+    }
+    // Check source filter
+    const sources = Option.getOrUndefined(options.sources);
+    const allowRegistry = !sources || sources.includes("registry");
+    const allowGitSources = !sources || sources.some((s) => ["github", "gitlab", "bitbucket"].includes(s));
+    // Try resolution in order with early exit
+    return Effect.gen(function* () {
+        // 1. Try AXM name (if not filtered out)
+        if (allowRegistry) {
+            const axmResults = yield* tryAxmName(trimmed, options);
+            if (axmResults.length > 0) {
+                return axmResults;
+            }
+        }
+        // 2. Fall back to git hosting sources (if not filtered out)
+        if (allowGitSources) {
+            const gitResults = yield* tryGitSources(trimmed, options);
+            if (gitResults.length > 0) {
+                return gitResults;
+            }
+        }
+        // No matches found
+        return [];
+    });
+};
+//# sourceMappingURL=ambiguous.js.map

package/dist/src/resolution/resolvers/ambiguous.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ambiguous.js","sourceRoot":"","sources":["../../../../src/resolution/resolvers/ambiguous.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAErD,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C,gFAAgF;AAChF,oBAAoB;AACpB,gFAAgF;AAEhF;;;;;GAKG;AACH,MAAM,iBAAiB,GAAG,8CAA8C,CAAC;AAEzE;;;;;;;;;;GAUG;AACH,MAAM,kBAAkB,GAAG,CAAC,KAAa,EAAW,EAAE;IACpD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAE7B,gBAAgB;IAChB,IAAI,CAAC,OAAO;QAAE,OAAO,KAAK,CAAC;IAE3B,2BAA2B;IAC3B,IAAI,mCAAmC,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,KAAK,CAAC;IAEpE,8CAA8C;IAC9C,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IAE1C,kCAAkC;IAClC,IAAI,qCAAqC,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,KAAK,CAAC;IAEtE,2BAA2B;IAC3B,IAAI,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,KAAK,CAAC;IAE/C,6BAA6B;IAC7B,IAAI,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,KAAK,CAAC;IAExC,mCAAmC;IACnC,OAAO,iBAAiB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AACzC,CAAC,CAAC;AAEF,gFAAgF;AAChF,2BAA2B;AAC3B,gFAAgF;AAEhF;;;;;GAKG;AACH,MAAM,aAAa,GAAG,CACpB,MAAoB,EACpB,KAAa,EACb,IAAY,EACW,EAAE;IACzB,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;QACxF,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,MAAM,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC,CAAC;IAC9D,CAAC;IACD,oEAAoE;IACpE,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;AACvB,CAAC,CAAC;AAEF,gFAAgF;AAChF,gBAAgB;AAChB,gFAAgF;AAEhF;;;;;;GAMG;AACH,MAAM,UAAU,GAAG,CACjB,KAAa,EACb,OAA0B,EACmC,EAAE;IAC/D,kDAAkD;IAClD,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,gCAAgC,CAAC,CAAC;IAC5D,IAAI,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QACrC,OAAO,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC5B,CAAC;IAED,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IACvB,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IACtB,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IAEzB,wCAAwC;IACxC,MAAM,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,IAAI,IAAI,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;IAE/E,OAAO,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;AAC1C,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,aAAa,GAAG,CAAC,KAAa,EAAE,OAA0B,EAAE,EAAE;IAClE,gCAAgC;IAChC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,gCAAgC,CAAC,CAAC;IAC5D,IAAI,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QACrC,OAAO,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC5B,CAAC;IAED,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IACvB,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IACtB,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IAEzB,OAAO,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;QACzB,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,SAAS,CAAC;QACnC,MAAM,UAAU,GAAG,KAAK,CAAC,CAAC,SAAS,CAAC,oBAAoB,EAAE,CAAC;QAE3D,gCAAgC;QAChC,MAAM,UAAU,GAAG,UAAU,CAAC,MAAM,CAClC,CAAC,CAAC,EAA2E,EAAE,CAC7E,CAAC,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,KAAK,WAAW,CACvE,CAAC;QAEF,kCAAkC;QAClC,MAAM,aAAa,GAAG,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAC7D,MAAM,eAAe,GAAG,aAAa;YACnC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAC1D,CAAC,CAAC,UAAU,CAAC;QAEf,2BAA2B;QAC3B,KAAK,MAAM,MAAM,IAAI,eAAe,EAAE,CAAC;YACrC,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;YACpD,IAAI,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC;gBAAE,SAAS;YAEtC,0BAA0B;YAC1B,MAAM,WAAW,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC;gBAC3C,GAAG,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;gBACpD,KAAK,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE,0CAA0C;aAC9D,CAAC,CAAC;YAEH,IAAI,WAAW,IAAI,WAAW,CAAC,EAAE,EAAE,CAAC;gBAClC,+BAA+B;gBAC/B,MAAM,GAAG,GAAiB;oBACxB,IAAI,EAAE,OAAO;oBACb,MAAM,EAAE,MAAM,CAAC,IAAI;oBACnB,MAAM,EAAE,QAAQ,CAAC,KAAK;oBACtB,aAAa,EAAE,KAAK;oBACpB,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE;oBACnB,GAAG,EAAE,MAAM,CAAC,IAAI,EAAE;oBAClB,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE;oBACnB,QAAQ,EAAE;wBACR,OAAO,EAAE,MAAM,CAAC,IAAI,EAAE;wBACtB,WAAW,EAAE,MAAM,CAAC,IAAI,EAAE;wBAC1B,KAAK,EAAE,MAAM,CAAC,IAAI,EAAE;wBACpB,iBAAiB,EAAE,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC;qBAChD;iBACF,CAAC;gBACF,OAAO,CAAC,GAAG,CAAC,CAAC;YACf,CAAC;QACH,CAAC;QAED,uBAAuB;QACvB,OAAO,EAAE,CAAC;IACZ,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AACrD,CAAC,CAAC;AAEF,gFAAgF;AAChF,gBAAgB;AAChB,gFAAgF;AAEhF;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,KAAa,EAAE,OAA0B,EAAE,EAAE;IAC5E,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAE7B,8DAA8D;IAC9D,IAAI,CAAC,kBAAkB,CAAC,OAAO,CAAC,EAAE,CAAC;QACjC,OAAO,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC5B,CAAC;IAED,sBAAsB;IACtB,MAAM,OAAO,GAAG,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACvD,MAAM,aAAa,GAAG,CAAC,OAAO,IAAI,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;IAC/D,MAAM,eAAe,GACnB,CAAC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IAEjF,0CAA0C;IAC1C,OAAO,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;QACzB,wCAAwC;QACxC,IAAI,aAAa,EAAE,CAAC;YAClB,MAAM,UAAU,GAAG,KAAK,CAAC,CAAC,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YACvD,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC1B,OAAO,UAAU,CAAC;YACpB,CAAC;QACH,CAAC;QAED,4DAA4D;QAC5D,IAAI,eAAe,EAAE,CAAC;YACpB,MAAM,UAAU,GAAG,KAAK,CAAC,CAAC,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC1D,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC1B,OAAO,UAAU,CAAC;YACpB,CAAC;QACH,CAAC;QAED,mBAAmB;QACnB,OAAO,EAAE,CAAC;IACZ,CAAC,CAAC,CAAC;AACL,CAAC,CAAC"}

package/dist/src/resolution/resolvers/axm-name.d.ts

@@ -0,0 +1,56 @@
+/**
+ * AXM name resolver.
+ *
+ * Resolves fully qualified AXM names like `@scope/name` or `@scope/name@^1.0.0`.
+ * Checks project level first, then global level, then registry (placeholder).
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import * as FileSystem from "@effect/platform/FileSystem";
+import * as Effect from "effect/Effect";
+import type { ExtensionRef, ResolutionOptions } from "../types.js";
+/**
+ * Check if an input string matches the AXM name pattern.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const isAxmName: (input: string) => boolean;
+/**
+ * Resolve an AXM name to extension references.
+ *
+ * AXM names follow the pattern `@scope/name[@version]`.
+ *
+ * Resolution order:
+ * 1. Project level: `.axm/skills/@scope/name/`
+ * 2. Global level: `~/.axm/skills/@scope/name/`
+ * 3. Registry lookup (placeholder - returns empty)
+ *
+ * Returns an empty array if:
+ * - Input doesn't match `@scope/name` pattern
+ * - No matching directory found at project or global level
+ * - Registry lookup returns no results (placeholder behavior)
+ *
+ * @param input - The input string to resolve (e.g., `@scope/name` or `@scope/name@^1.0.0`)
+ * @param options - Resolution options
+ * @returns Effect containing array of ExtensionRef (empty if no match)
+ *
+ * @example
+ * ```typescript
+ * import { resolveAxmName } from "../../resolution/index.js";
+ * import { NodeFileSystem } from "@effect/platform-node";
+ * import { Effect } from "effect";
+ *
+ * const program = resolveAxmName("@wayne/grappling-hook", {
+ *   projectDir: ".axm",
+ *   globalDir: "~/.axm",
+ * }).pipe(Effect.provide(NodeFileSystem.layer));
+ *
+ * const refs = await Effect.runPromise(program);
+ * // [{ type: "skill", source: "registry", origin: ".axm/skills/@wayne/grappling-hook", name: "@wayne/grappling-hook", ... }]
+ * ```
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const resolveAxmName: (input: string, options: ResolutionOptions) => Effect.Effect<ExtensionRef[], never, FileSystem.FileSystem>;
+//# sourceMappingURL=axm-name.d.ts.map

package/dist/src/resolution/resolvers/axm-name.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"axm-name.d.ts","sourceRoot":"","sources":["../../../../src/resolution/resolvers/axm-name.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,UAAU,MAAM,6BAA6B,CAAC;AAC1D,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAiBnE;;;;GAIG;AACH,eAAO,MAAM,SAAS,GAAI,OAAO,MAAM,KAAG,OAAuC,CAAC;AA4ClF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,eAAO,MAAM,cAAc,GACzB,OAAO,MAAM,EACb,SAAS,iBAAiB,KACzB,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,EAAE,KAAK,EAAE,UAAU,CAAC,UAAU,CAqCzD,CAAC"}

package/dist/src/resolution/resolvers/axm-name.js

@@ -0,0 +1,132 @@
+/**
+ * AXM name resolver.
+ *
+ * Resolves fully qualified AXM names like `@scope/name` or `@scope/name@^1.0.0`.
+ * Checks project level first, then global level, then registry (placeholder).
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import * as nodePath from "node:path";
+import * as FileSystem from "@effect/platform/FileSystem";
+import * as Effect from "effect/Effect";
+import * as Option from "effect/Option";
+import { expandHome } from "./path-utils.js";
+// -----------------------------------------------------------------------------
+// Constants
+// -----------------------------------------------------------------------------
+/**
+ * Pattern for AXM names: @scope/name optionally with @version
+ * Captures: [1] = scope (with @), [2] = name, [3] = version (optional)
+ */
+const AXM_NAME_PATTERN = /^(@[^/@]+)\/([^/@]+)(?:@(.+))?$/;
+// -----------------------------------------------------------------------------
+// Helper Functions
+// -----------------------------------------------------------------------------
+/**
+ * Check if an input string matches the AXM name pattern.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const isAxmName = (input) => AXM_NAME_PATTERN.test(input);
+/**
+ * Check if a directory exists at the given path.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+const directoryExists = (dirPath) => Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    const stat = yield* fs.stat(dirPath).pipe(Effect.catchAll(() => Effect.succeed(null)));
+    return stat !== null && stat.type === "Directory";
+});
+/**
+ * Build an ExtensionRef for an AXM name found at a local path.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+const buildExtensionRef = (fullName, origin, originalInput, versionConstraint) => ({
+    type: "skill", // Default to skill, could be detected from manifest
+    source: "registry",
+    origin,
+    name: Option.some(fullName),
+    ref: Option.none(),
+    path: Option.none(),
+    originalInput,
+    metadata: {
+        version: Option.none(),
+        description: Option.none(),
+        files: Option.none(),
+        versionConstraint: Option.fromNullable(versionConstraint),
+    },
+});
+// -----------------------------------------------------------------------------
+// Public API
+// -----------------------------------------------------------------------------
+/**
+ * Resolve an AXM name to extension references.
+ *
+ * AXM names follow the pattern `@scope/name[@version]`.
+ *
+ * Resolution order:
+ * 1. Project level: `.axm/skills/@scope/name/`
+ * 2. Global level: `~/.axm/skills/@scope/name/`
+ * 3. Registry lookup (placeholder - returns empty)
+ *
+ * Returns an empty array if:
+ * - Input doesn't match `@scope/name` pattern
+ * - No matching directory found at project or global level
+ * - Registry lookup returns no results (placeholder behavior)
+ *
+ * @param input - The input string to resolve (e.g., `@scope/name` or `@scope/name@^1.0.0`)
+ * @param options - Resolution options
+ * @returns Effect containing array of ExtensionRef (empty if no match)
+ *
+ * @example
+ * ```typescript
+ * import { resolveAxmName } from "../../resolution/index.js";
+ * import { NodeFileSystem } from "@effect/platform-node";
+ * import { Effect } from "effect";
+ *
+ * const program = resolveAxmName("@wayne/grappling-hook", {
+ *   projectDir: ".axm",
+ *   globalDir: "~/.axm",
+ * }).pipe(Effect.provide(NodeFileSystem.layer));
+ *
+ * const refs = await Effect.runPromise(program);
+ * // [{ type: "skill", source: "registry", origin: ".axm/skills/@wayne/grappling-hook", name: "@wayne/grappling-hook", ... }]
+ * ```
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const resolveAxmName = (input, options) => Effect.gen(function* () {
+    // Check if input matches AXM name pattern
+    const match = input.match(AXM_NAME_PATTERN);
+    if (!match || !match[1] || !match[2]) {
+        return [];
+    }
+    const scope = match[1]; // @scope
+    const name = match[2]; // name
+    const versionConstraint = match[3]; // optional version
+    const fullName = `${scope}/${name}`;
+    // Determine directories to check
+    const projectDir = Option.getOrElse(options.projectDir, () => ".axm");
+    const globalDir = expandHome(Option.getOrElse(options.globalDir, () => "~/.axm"));
+    const cwd = Option.getOrElse(options.cwd, () => process.cwd());
+    // Build paths to check
+    const projectPath = nodePath.resolve(cwd, projectDir, "skills", scope, name);
+    const globalPath = nodePath.resolve(globalDir, "skills", scope, name);
+    // Step 1: Check project level
+    const projectExists = yield* directoryExists(projectPath);
+    if (projectExists) {
+        return [buildExtensionRef(fullName, projectPath, input, versionConstraint)];
+    }
+    // Step 2: Check global level
+    const globalExists = yield* directoryExists(globalPath);
+    if (globalExists) {
+        return [buildExtensionRef(fullName, globalPath, input, versionConstraint)];
+    }
+    // Step 3: Registry lookup (placeholder - return empty)
+    // Future: Query remote registry API
+    return [];
+});
+//# sourceMappingURL=axm-name.js.map

package/dist/src/resolution/resolvers/axm-name.js.map

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

package/dist/src/resolution/resolvers/bare-name.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Bare name resolver.
+ *
+ * Resolves bare names (single identifiers without `/` or `@`) by prepending
+ * the configured scope and delegating to the AXM name resolver.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import type { FileSystem } from "@effect/platform";
+import * as Effect from "effect/Effect";
+import type { ExtensionRef, ResolutionOptions } from "../types.js";
+/**
+ * Resolves a bare name by prepending the configured scope and delegating to AXM name resolution.
+ *
+ * A bare name is a single identifier without `/` or `@` (e.g., `grappling-hook`).
+ *
+ * Behavior:
+ * - Returns empty array if input contains `/` or `@` (not a bare name)
+ * - Returns empty array if no scope is configured in options
+ * - Transforms `name` to `@scope/name` and delegates to resolveAxmName
+ * - Preserves version constraint if present: `name@version` to `@scope/name@version`
+ *   (Note: bare names by definition don't have `@`, so version isn't preserved in practice)
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @param input - The input string to resolve
+ * @param options - Resolution options containing scope configuration
+ * @returns Effect containing array of resolved extension references
+ */
+export declare const resolveBareName: (input: string, options: ResolutionOptions) => Effect.Effect<ExtensionRef[], never, FileSystem.FileSystem>;
+//# sourceMappingURL=bare-name.d.ts.map

package/dist/src/resolution/resolvers/bare-name.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bare-name.d.ts","sourceRoot":"","sources":["../../../../src/resolution/resolvers/bare-name.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAoBnE;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,eAAe,GAC1B,OAAO,MAAM,EACb,SAAS,iBAAiB,KACzB,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,EAAE,KAAK,EAAE,UAAU,CAAC,UAAU,CAsB5D,CAAC"}