@axm.sh/cli 0.0.1

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

@@ -0,0 +1,64 @@
+/**
+ * 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 * as Effect from "effect/Effect";
+import * as Option from "effect/Option";
+import { resolveAxmName } from "./axm-name.js";
+// -----------------------------------------------------------------------------
+// Pattern Detection
+// -----------------------------------------------------------------------------
+/**
+ * Checks if input is a bare name (single identifier, no `/` or `@`).
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+const isBareNamePattern = (input) => {
+    return !input.includes("/") && !input.includes("@");
+};
+// -----------------------------------------------------------------------------
+// Resolver
+// -----------------------------------------------------------------------------
+/**
+ * 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 const resolveBareName = (input, options) => {
+    // Not a bare name if it contains / or @
+    if (!isBareNamePattern(input)) {
+        return Effect.succeed([]);
+    }
+    // No scope configured - cannot resolve bare name
+    if (Option.isNone(options.scope) || options.scope.value === "") {
+        return Effect.succeed([]);
+    }
+    // Transform to scoped AXM name: name -> @scope/name
+    const scopedName = `@${options.scope.value}/${input}`;
+    // Delegate to AXM name resolver and preserve original bare name input
+    return Effect.gen(function* () {
+        const results = yield* resolveAxmName(scopedName, options);
+        return results.map((ref) => ({
+            ...ref,
+            originalInput: input,
+        }));
+    });
+};
+//# sourceMappingURL=bare-name.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bare-name.js","sourceRoot":"","sources":["../../../../src/resolution/resolvers/bare-name.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C,gFAAgF;AAChF,oBAAoB;AACpB,gFAAgF;AAEhF;;;;GAIG;AACH,MAAM,iBAAiB,GAAG,CAAC,KAAa,EAAW,EAAE;IACnD,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;AACtD,CAAC,CAAC;AAEF,gFAAgF;AAChF,WAAW;AACX,gFAAgF;AAEhF;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAC7B,KAAa,EACb,OAA0B,EACmC,EAAE;IAC/D,wCAAwC;IACxC,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC9B,OAAO,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC5B,CAAC;IAED,iDAAiD;IACjD,IAAI,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,OAAO,CAAC,KAAK,CAAC,KAAK,KAAK,EAAE,EAAE,CAAC;QAC/D,OAAO,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC5B,CAAC;IAED,oDAAoD;IACpD,MAAM,UAAU,GAAG,IAAI,OAAO,CAAC,KAAK,CAAC,KAAK,IAAI,KAAK,EAAE,CAAC;IAEtD,sEAAsE;IACtE,OAAO,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;QACzB,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,cAAc,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QAC3D,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;YAC3B,GAAG,GAAG;YACN,aAAa,EAAE,KAAK;SACrB,CAAC,CAAC,CAAC;IACN,CAAC,CAAC,CAAC;AACL,CAAC,CAAC"}

package/dist/src/resolution/resolvers/explicit-source.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Explicit source resolver for prefixed inputs.
+ *
+ * Handles `github:owner/repo` and `gitlab:owner/repo` prefixed inputs
+ * by wrapping the existing source-parser.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import * as Effect from "effect/Effect";
+import type { ExtensionRef } from "../types.js";
+/**
+ * Resolve explicit source prefixed inputs to ExtensionRefs.
+ *
+ * Handles inputs like:
+ * - `github:owner/repo`
+ * - `github:owner/repo/path`
+ * - `github:owner/repo@ref`
+ * - `github:owner/repo/path@ref`
+ * - `gitlab:owner/repo`
+ * - (future: `bitbucket:owner/repo`, `azure:owner/repo`)
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @param input - The input string to resolve
+ * @param _options - Resolution options (unused currently)
+ * @returns Effect containing array of ExtensionRefs, or empty array if not a match
+ */
+export declare const resolveExplicitSource: (input: string) => Effect.Effect<never[] | ExtensionRef[], never, import("../../workspace/service.js").Workspace>;
+//# sourceMappingURL=explicit-source.d.ts.map

package/dist/src/resolution/resolvers/explicit-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"explicit-source.d.ts","sourceRoot":"","sources":["../../../../src/resolution/resolvers/explicit-source.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAGxC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AA2ChD;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,qBAAqB,GAAI,OAAO,MAAM,mGA0ClD,CAAC"}

package/dist/src/resolution/resolvers/explicit-source.js

@@ -0,0 +1,101 @@
+/**
+ * Explicit source resolver for prefixed inputs.
+ *
+ * Handles `github:owner/repo` and `gitlab:owner/repo` prefixed inputs
+ * by wrapping the existing source-parser.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import * as Effect from "effect/Effect";
+import * as Option from "effect/Option";
+import { resolveSource } from "../../sources/index.js";
+import { buildOriginUrl } from "./url-utils.js";
+/**
+ * Supported source prefixes that this resolver handles.
+ * These are the prefixes that the parser currently supports.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+const SUPPORTED_PREFIXES = ["github:", "gitlab:"];
+/**
+ * Future source prefixes (recognized but not yet implemented in parser).
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+const FUTURE_PREFIXES = ["bitbucket:", "azure:"];
+/**
+ * All known source prefixes.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+const ALL_PREFIXES = [...SUPPORTED_PREFIXES, ...FUTURE_PREFIXES];
+/**
+ * Check if input starts with a known source prefix.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+const hasKnownPrefix = (input) => {
+    return ALL_PREFIXES.some((prefix) => input.startsWith(prefix));
+};
+/**
+ * Check if input starts with a supported (implemented) source prefix.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+const hasSupportedPrefix = (input) => {
+    return SUPPORTED_PREFIXES.some((prefix) => input.startsWith(prefix));
+};
+/**
+ * Resolve explicit source prefixed inputs to ExtensionRefs.
+ *
+ * Handles inputs like:
+ * - `github:owner/repo`
+ * - `github:owner/repo/path`
+ * - `github:owner/repo@ref`
+ * - `github:owner/repo/path@ref`
+ * - `gitlab:owner/repo`
+ * - (future: `bitbucket:owner/repo`, `azure:owner/repo`)
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @param input - The input string to resolve
+ * @param _options - Resolution options (unused currently)
+ * @returns Effect containing array of ExtensionRefs, or empty array if not a match
+ */
+export const resolveExplicitSource = (input) => {
+    const trimmed = input.trim();
+    // Return empty array if input doesn't start with a known prefix
+    if (!hasKnownPrefix(trimmed)) {
+        return Effect.succeed([]);
+    }
+    // Return empty array for future prefixes not yet implemented in parser
+    if (!hasSupportedPrefix(trimmed)) {
+        return Effect.succeed([]);
+    }
+    // Use resolveSource for the heavy lifting
+    return resolveSource(trimmed).pipe(Effect.map((src) => {
+        // Only handle github/gitlab types (bitbucket/azure not yet implemented in parser)
+        if (src.type !== "github" && src.type !== "gitlab") {
+            return [];
+        }
+        const ref = {
+            type: "skill", // Infer as skill for now (will be enhanced later with manifest fetch)
+            source: src.type,
+            origin: buildOriginUrl(src.type, src.owner, src.repo),
+            originalInput: input,
+            name: Option.none(),
+            ref: src.ref,
+            path: src.subPath,
+            metadata: {
+                version: Option.none(),
+                description: Option.none(),
+                files: Option.none(),
+                versionConstraint: Option.none(),
+            },
+        };
+        return [ref];
+    }), 
+    // On parse error, return empty array (not a match for this resolver)
+    Effect.catchAll(() => Effect.succeed([])));
+};
+//# sourceMappingURL=explicit-source.js.map

package/dist/src/resolution/resolvers/explicit-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"explicit-source.js","sourceRoot":"","sources":["../../../../src/resolution/resolvers/explicit-source.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAEvD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhD;;;;;GAKG;AACH,MAAM,kBAAkB,GAAG,CAAC,SAAS,EAAE,SAAS,CAAU,CAAC;AAE3D;;;;GAIG;AACH,MAAM,eAAe,GAAG,CAAC,YAAY,EAAE,QAAQ,CAAU,CAAC;AAE1D;;;;GAIG;AACH,MAAM,YAAY,GAAG,CAAC,GAAG,kBAAkB,EAAE,GAAG,eAAe,CAAU,CAAC;AAE1E;;;;GAIG;AACH,MAAM,cAAc,GAAG,CAAC,KAAa,EAAW,EAAE;IAChD,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;AACjE,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,kBAAkB,GAAG,CAAC,KAAa,EAAW,EAAE;IACpD,OAAO,kBAAkB,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;AACvE,CAAC,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,KAAa,EAAE,EAAE;IACrD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAE7B,gEAAgE;IAChE,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,EAAE,CAAC;QAC7B,OAAO,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC5B,CAAC;IAED,uEAAuE;IACvE,IAAI,CAAC,kBAAkB,CAAC,OAAO,CAAC,EAAE,CAAC;QACjC,OAAO,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC5B,CAAC;IAED,0CAA0C;IAC1C,OAAO,aAAa,CAAC,OAAO,CAAC,CAAC,IAAI,CAChC,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QACjB,kFAAkF;QAClF,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACnD,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,GAAG,GAAiB;YACxB,IAAI,EAAE,OAAO,EAAE,sEAAsE;YACrF,MAAM,EAAE,GAAG,CAAC,IAAI;YAChB,MAAM,EAAE,cAAc,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,CAAC;YACrD,aAAa,EAAE,KAAK;YACpB,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE;YACnB,GAAG,EAAE,GAAG,CAAC,GAAG;YACZ,IAAI,EAAE,GAAG,CAAC,OAAO;YACjB,QAAQ,EAAE;gBACR,OAAO,EAAE,MAAM,CAAC,IAAI,EAAE;gBACtB,WAAW,EAAE,MAAM,CAAC,IAAI,EAAE;gBAC1B,KAAK,EAAE,MAAM,CAAC,IAAI,EAAE;gBACpB,iBAAiB,EAAE,MAAM,CAAC,IAAI,EAAE;aACjC;SACF,CAAC;QAEF,OAAO,CAAC,GAAG,CAAC,CAAC;IACf,CAAC,CAAC;IACF,qEAAqE;IACrE,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAC1C,CAAC;AACJ,CAAC,CAAC"}

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

@@ -0,0 +1,13 @@
+/**
+ * Resolvers barrel exports.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+export { resolveAmbiguous } from "./ambiguous.js";
+export { isAxmName, resolveAxmName } from "./axm-name.js";
+export { resolveBareName } from "./bare-name.js";
+export { resolveExplicitSource } from "./explicit-source.js";
+export { isLocalPath, resolveLocalPath } from "./local-path.js";
+export { resolveUrl } from "./url.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/resolution/resolvers/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC"}

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

@@ -0,0 +1,13 @@
+/**
+ * Resolvers barrel exports.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+export { resolveAmbiguous } from "./ambiguous.js";
+export { isAxmName, resolveAxmName } from "./axm-name.js";
+export { resolveBareName } from "./bare-name.js";
+export { resolveExplicitSource } from "./explicit-source.js";
+export { isLocalPath, resolveLocalPath } from "./local-path.js";
+export { resolveUrl } from "./url.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/resolution/resolvers/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC"}

package/dist/src/resolution/resolvers/local-path.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Local path resolver for extension resolution.
+ *
+ * Handles local filesystem paths: `./`, `../`, `/`, `~/`, Windows paths like `C:\`.
+ * Scans directories for extension manifest files and returns ExtensionRef[].
+ *
+ * @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 local path pattern.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const isLocalPath: (input: string) => boolean;
+/**
+ * Resolve a local filesystem path to extension references.
+ *
+ * This resolver handles:
+ * - Relative paths: `./path`, `../path`
+ * - Absolute POSIX paths: `/path`
+ * - Home directory paths: `~/path`, `~\path`
+ * - Windows paths: `C:\path`
+ *
+ * Returns an empty array if:
+ * - Input doesn't match local path pattern
+ * - Path doesn't exist on filesystem
+ * - No extension manifest files found in directory
+ *
+ * @param input - The input string to resolve
+ * @param options - Resolution options including cwd
+ * @returns Effect containing ExtensionRef[] (empty if no match)
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const resolveLocalPath: (input: string, options: ResolutionOptions) => Effect.Effect<ExtensionRef[], never, FileSystem.FileSystem>;
+//# sourceMappingURL=local-path.d.ts.map

package/dist/src/resolution/resolvers/local-path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-path.d.ts","sourceRoot":"","sources":["../../../../src/resolution/resolvers/local-path.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,UAAU,MAAM,6BAA6B,CAAC;AAC1D,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,KAAK,EAAE,YAAY,EAAiB,iBAAiB,EAAE,MAAM,aAAa,CAAC;AA6BlF;;;;GAIG;AACH,eAAO,MAAM,WAAW,GAAI,OAAO,MAAM,KAAG,OAAyC,CAAC;AAwItF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,gBAAgB,GAC3B,OAAO,MAAM,EACb,SAAS,iBAAiB,KACzB,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,EAAE,KAAK,EAAE,UAAU,CAAC,UAAU,CA0BzD,CAAC"}

package/dist/src/resolution/resolvers/local-path.js

@@ -0,0 +1,192 @@
+/**
+ * Local path resolver for extension resolution.
+ *
+ * Handles local filesystem paths: `./`, `../`, `/`, `~/`, Windows paths like `C:\`.
+ * Scans directories for extension manifest files and returns ExtensionRef[].
+ *
+ * @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
+// -----------------------------------------------------------------------------
+/**
+ * Local path pattern.
+ * Matches: ./path, ../path, /path, ~/path, ~\path, or Windows paths like C:\path
+ */
+const LOCAL_PATH_PATTERN = /^(?:\.\.?\/|\/|~\/|~\\|[A-Za-z]:[\\/])/;
+/**
+ * Extension manifest files mapped to their types.
+ */
+const EXTENSION_FILES = [
+    { file: "SKILL.md", type: "skill" },
+    { file: "skill.md", type: "skill" },
+    { file: "Skill.md", type: "skill" },
+    { file: "axm-skill.json", type: "skill" },
+    { file: "axm-command.json", type: "command" },
+    { file: "axm-mcp-server.json", type: "mcp-server" },
+];
+// -----------------------------------------------------------------------------
+// Helper Functions
+// -----------------------------------------------------------------------------
+/**
+ * Check if an input string matches the local path pattern.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const isLocalPath = (input) => LOCAL_PATH_PATTERN.test(input);
+/**
+ * Resolve a potentially relative path against the cwd option.
+ */
+const resolvePath = (input, cwd) => {
+    const expanded = expandHome(input);
+    if (nodePath.isAbsolute(expanded)) {
+        return nodePath.normalize(expanded);
+    }
+    return nodePath.resolve(cwd, expanded);
+};
+/**
+ * Check if a file exists at the given path.
+ */
+const fileExists = (filePath) => Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    const result = yield* fs.exists(filePath).pipe(Effect.catchAll(() => Effect.succeed(false)));
+    return result;
+});
+/**
+ * Check if a path is a directory.
+ */
+const isDirectory = (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";
+});
+/**
+ * Scan a directory for extension manifest files.
+ * Returns ExtensionRef for each found manifest.
+ */
+const scanDirectory = (dirPath, originalInput) => Effect.gen(function* () {
+    // Check all extension files concurrently
+    const existsResults = yield* Effect.forEach(EXTENSION_FILES, ({ file }) => fileExists(nodePath.join(dirPath, file)), { concurrency: "unbounded" });
+    // Build results, filtering duplicates for skill type
+    const results = [];
+    for (let i = 0; i < EXTENSION_FILES.length; i++) {
+        const extensionFile = EXTENSION_FILES[i];
+        if (!existsResults[i] || !extensionFile)
+            continue;
+        const { file, type } = extensionFile;
+        // For SKILL.md variants, only add one entry (avoid duplicates)
+        if (type === "skill" && results.some((r) => r.type === "skill")) {
+            continue;
+        }
+        results.push({
+            type,
+            source: "local",
+            origin: dirPath,
+            originalInput,
+            ref: Option.none(),
+            name: Option.none(),
+            path: Option.none(),
+            metadata: {
+                version: Option.none(),
+                description: Option.none(),
+                files: Option.some([file]),
+                versionConstraint: Option.none(),
+            },
+        });
+    }
+    return results;
+});
+/**
+ * Handle a direct file path (pointing to a manifest file).
+ */
+const handleFilePath = (filePath, originalInput) => Effect.gen(function* () {
+    const basename = nodePath.basename(filePath).toLowerCase();
+    const dirPath = nodePath.dirname(filePath);
+    // Determine type from filename
+    let type = null;
+    if (basename === "skill.md" || basename === "axm-skill.json") {
+        type = "skill";
+    }
+    else if (basename === "axm-command.json") {
+        type = "command";
+    }
+    else if (basename === "axm-mcp-server.json") {
+        type = "mcp-server";
+    }
+    if (type === null) {
+        // Not a recognized extension file
+        return [];
+    }
+    const exists = yield* fileExists(filePath);
+    if (!exists) {
+        return [];
+    }
+    return [
+        {
+            type,
+            source: "local",
+            origin: dirPath,
+            originalInput,
+            ref: Option.none(),
+            name: Option.none(),
+            path: Option.none(),
+            metadata: {
+                version: Option.none(),
+                description: Option.none(),
+                files: Option.some([nodePath.basename(filePath)]),
+                versionConstraint: Option.none(),
+            },
+        },
+    ];
+});
+// -----------------------------------------------------------------------------
+// Public API
+// -----------------------------------------------------------------------------
+/**
+ * Resolve a local filesystem path to extension references.
+ *
+ * This resolver handles:
+ * - Relative paths: `./path`, `../path`
+ * - Absolute POSIX paths: `/path`
+ * - Home directory paths: `~/path`, `~\path`
+ * - Windows paths: `C:\path`
+ *
+ * Returns an empty array if:
+ * - Input doesn't match local path pattern
+ * - Path doesn't exist on filesystem
+ * - No extension manifest files found in directory
+ *
+ * @param input - The input string to resolve
+ * @param options - Resolution options including cwd
+ * @returns Effect containing ExtensionRef[] (empty if no match)
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const resolveLocalPath = (input, options) => Effect.gen(function* () {
+    // Check if input matches local path pattern
+    if (!isLocalPath(input)) {
+        return [];
+    }
+    const cwd = Option.getOrElse(options.cwd, () => process.cwd());
+    const absolutePath = resolvePath(input, cwd);
+    // Check if path exists
+    const exists = yield* fileExists(absolutePath);
+    if (!exists) {
+        return [];
+    }
+    // Check if it's a directory or file
+    const isDir = yield* isDirectory(absolutePath);
+    if (isDir) {
+        // Scan directory for extension files
+        return yield* scanDirectory(absolutePath, input);
+    }
+    // Handle direct file path
+    return yield* handleFilePath(absolutePath, input);
+});
+//# sourceMappingURL=local-path.js.map

package/dist/src/resolution/resolvers/local-path.js.map

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

package/dist/src/resolution/resolvers/path-utils.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Shared path utilities for resolvers.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+/**
+ * Expand `~` or `~/...` to the user's home directory.
+ *
+ * Handles both bare `~` and `~/path` (or `~\path` on Windows).
+ */
+export declare const expandHome: (p: string) => string;
+//# sourceMappingURL=path-utils.d.ts.map

package/dist/src/resolution/resolvers/path-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-utils.d.ts","sourceRoot":"","sources":["../../../../src/resolution/resolvers/path-utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH;;;;GAIG;AACH,eAAO,MAAM,UAAU,GAAI,GAAG,MAAM,KAAG,MAQtC,CAAC"}

package/dist/src/resolution/resolvers/path-utils.js

@@ -0,0 +1,22 @@
+/**
+ * Shared path utilities for resolvers.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as os from "node:os";
+import * as nodePath from "node:path";
+/**
+ * Expand `~` or `~/...` to the user's home directory.
+ *
+ * Handles both bare `~` and `~/path` (or `~\path` on Windows).
+ */
+export const expandHome = (p) => {
+    if (p === "~") {
+        return os.homedir();
+    }
+    if (p.startsWith("~/") || p.startsWith("~\\")) {
+        return nodePath.join(os.homedir(), p.slice(2));
+    }
+    return p;
+};
+//# sourceMappingURL=path-utils.js.map

package/dist/src/resolution/resolvers/path-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-utils.js","sourceRoot":"","sources":["../../../../src/resolution/resolvers/path-utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,QAAQ,MAAM,WAAW,CAAC;AAEtC;;;;GAIG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAS,EAAU,EAAE;IAC9C,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;QACd,OAAO,EAAE,CAAC,OAAO,EAAE,CAAC;IACtB,CAAC;IACD,IAAI,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QAC9C,OAAO,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACjD,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC,CAAC"}

package/dist/src/resolution/resolvers/url-utils.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Shared URL utilities for resolvers.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+/**
+ * Build HTTPS URL from source type and owner/repo.
+ */
+export declare const buildOriginUrl: (sourceType: "github" | "gitlab" | "bitbucket" | "azure", owner: string, repo: string) => string;
+//# sourceMappingURL=url-utils.d.ts.map

package/dist/src/resolution/resolvers/url-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-utils.d.ts","sourceRoot":"","sources":["../../../../src/resolution/resolvers/url-utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,eAAO,MAAM,cAAc,GACzB,YAAY,QAAQ,GAAG,QAAQ,GAAG,WAAW,GAAG,OAAO,EACvD,OAAO,MAAM,EACb,MAAM,MAAM,KACX,MAaF,CAAC"}

package/dist/src/resolution/resolvers/url-utils.js

@@ -0,0 +1,23 @@
+/**
+ * Shared URL utilities for resolvers.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+/**
+ * Build HTTPS URL from source type and owner/repo.
+ */
+export const buildOriginUrl = (sourceType, owner, repo) => {
+    switch (sourceType) {
+        case "github":
+            return `https://github.com/${owner}/${repo}`;
+        case "gitlab":
+            return `https://gitlab.com/${owner}/${repo}`;
+        case "bitbucket":
+            return `https://bitbucket.org/${owner}/${repo}`;
+        case "azure":
+            // Azure DevOps URL format: https://dev.azure.com/{org}/{project}/_git/{repo}
+            // For simplicity, treating owner as org/project combined
+            return `https://dev.azure.com/${owner}/${repo}`;
+    }
+};
+//# sourceMappingURL=url-utils.js.map

package/dist/src/resolution/resolvers/url-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-utils.js","sourceRoot":"","sources":["../../../../src/resolution/resolvers/url-utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAC5B,UAAuD,EACvD,KAAa,EACb,IAAY,EACJ,EAAE;IACV,QAAQ,UAAU,EAAE,CAAC;QACnB,KAAK,QAAQ;YACX,OAAO,sBAAsB,KAAK,IAAI,IAAI,EAAE,CAAC;QAC/C,KAAK,QAAQ;YACX,OAAO,sBAAsB,KAAK,IAAI,IAAI,EAAE,CAAC;QAC/C,KAAK,WAAW;YACd,OAAO,yBAAyB,KAAK,IAAI,IAAI,EAAE,CAAC;QAClD,KAAK,OAAO;YACV,6EAA6E;YAC7E,yDAAyD;YACzD,OAAO,yBAAyB,KAAK,IAAI,IAAI,EAAE,CAAC;IACpD,CAAC;AACH,CAAC,CAAC"}

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

@@ -0,0 +1,30 @@
+/**
+ * URL resolver for unmatched URL-like inputs.
+ *
+ * Handles GitHub/GitLab HTTPS URLs, SSH URLs, and other HTTP URLs
+ * that weren't caught by earlier resolvers.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import * as Effect from "effect/Effect";
+import type { ExtensionRef } from "../types.js";
+/**
+ * Resolve URL-like inputs to ExtensionRefs.
+ *
+ * Handles:
+ * - GitHub HTTPS URLs: `https://github.com/owner/repo`
+ * - GitLab HTTPS URLs: `https://gitlab.com/owner/repo`
+ * - GitHub SSH URLs: `git@github.com:owner/repo.git`
+ * - GitLab SSH URLs: `git@gitlab.com:owner/repo.git`
+ *
+ * This is the last resolver in the pipeline - catches any URL-like inputs
+ * that weren't handled by earlier resolvers.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @param input - The input string to resolve
+ * @param _options - Resolution options (unused currently)
+ * @returns Effect containing array of ExtensionRefs, or empty array if not a match
+ */
+export declare const resolveUrl: (input: string) => Effect.Effect<never[] | ExtensionRef[], never, import("../../workspace/service.js").Workspace>;
+//# sourceMappingURL=url.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"url.d.ts","sourceRoot":"","sources":["../../../../src/resolution/resolvers/url.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAGxC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAoBhD;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,UAAU,GAAI,OAAO,MAAM,mGAsCvC,CAAC"}