@axm.sh/cli 0.0.1

package/dist/src/lockfile/schema.js

@@ -0,0 +1,187 @@
+/**
+ * Lockfile schema definition.
+ *
+ * The lockfile (axm-lock.yaml) records the exact resolved state of all installed
+ * skills, enabling reproducible installations across environments.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as Schema from "effect/Schema";
+// =============================================================================
+// Date Transform
+// =============================================================================
+/**
+ * Schema that transforms ISO 8601 strings to Date objects.
+ * Stored as string in YAML, decoded to Date in TypeScript.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const DateFromString = Schema.transform(Schema.String, Schema.DateFromSelf, {
+    decode: (s) => new Date(s),
+    encode: (d) => d.toISOString(),
+});
+// =============================================================================
+// Flat Source Schemas (discriminated by type field)
+// =============================================================================
+/**
+ * Common fields shared by all lock entries.
+ */
+const CommonFields = {
+    agents: Schema.Array(Schema.String),
+    installedAt: DateFromString,
+    updatedAt: DateFromString,
+    gitTreeHash: Schema.optional(Schema.String),
+};
+/**
+ * GitHub source - skill from a GitHub repository.
+ * Required: owner, repo
+ * Optional: ref, path
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const GitHubLockEntrySchema = Schema.Struct({
+    type: Schema.Literal("github"),
+    owner: Schema.String,
+    repo: Schema.String,
+    ref: Schema.optional(Schema.String),
+    path: Schema.optional(Schema.String),
+    ...CommonFields,
+});
+/**
+ * GitLab source - skill from a GitLab repository.
+ * Required: owner, repo
+ * Optional: ref, path
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const GitLabLockEntrySchema = Schema.Struct({
+    type: Schema.Literal("gitlab"),
+    owner: Schema.String,
+    repo: Schema.String,
+    ref: Schema.optional(Schema.String),
+    path: Schema.optional(Schema.String),
+    ...CommonFields,
+});
+/**
+ * Bitbucket source - skill from a Bitbucket repository.
+ * Required: owner, repo
+ * Optional: ref, path
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const BitbucketLockEntrySchema = Schema.Struct({
+    type: Schema.Literal("bitbucket"),
+    owner: Schema.String,
+    repo: Schema.String,
+    ref: Schema.optional(Schema.String),
+    path: Schema.optional(Schema.String),
+    ...CommonFields,
+});
+/**
+ * Azure Repos source - skill from an Azure DevOps repository.
+ * Required: organization, project, repo
+ * Optional: ref, path
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const AzureReposLockEntrySchema = Schema.Struct({
+    type: Schema.Literal("azurerepos"),
+    organization: Schema.String,
+    project: Schema.String,
+    repo: Schema.String,
+    ref: Schema.optional(Schema.String),
+    path: Schema.optional(Schema.String),
+    ...CommonFields,
+});
+/**
+ * Git source - skill from a generic git repository.
+ * Required: url
+ * Optional: ref, path
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const GitLockEntrySchema = Schema.Struct({
+    type: Schema.Literal("git"),
+    url: Schema.String,
+    ref: Schema.optional(Schema.String),
+    path: Schema.optional(Schema.String),
+    ...CommonFields,
+});
+/**
+ * Local source - skill from a local filesystem path.
+ * Required: path
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const LocalLockEntrySchema = Schema.Struct({
+    type: Schema.Literal("local"),
+    path: Schema.String,
+    ...CommonFields,
+});
+/**
+ * Registry source - skill from a registry.
+ * Required: scope, name, resolvedVersion, checksum, sourceName
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const RegistryLockEntrySchema = Schema.Struct({
+    type: Schema.Literal("registry"),
+    scope: Schema.String,
+    name: Schema.String,
+    resolvedVersion: Schema.String,
+    checksum: Schema.String,
+    sourceName: Schema.String,
+    ...CommonFields,
+});
+// =============================================================================
+// Skill Lock Entry (union of all source types)
+// =============================================================================
+/**
+ * Lock entry for a single installed skill.
+ * Discriminated union by the `type` field.
+ *
+ * Fields common to all entries:
+ * - type: Source type ("github", "gitlab", "bitbucket", "azurerepos", "git", "local", "registry")
+ * - agents: Agent IDs this skill is installed for (can be empty)
+ * - installedAt: ISO 8601 timestamp of initial installation (Date in TS)
+ * - updatedAt: ISO 8601 timestamp of last update (Date in TS)
+ * - gitTreeHash: Git tree SHA of source folder (git sources, optional)
+ *
+ * Source-specific fields are at the top level based on source type.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const SkillLockEntrySchema = Schema.Union(GitHubLockEntrySchema, GitLabLockEntrySchema, BitbucketLockEntrySchema, AzureReposLockEntrySchema, GitLockEntrySchema, LocalLockEntrySchema, RegistryLockEntrySchema);
+// =============================================================================
+// Skills Lock Map
+// =============================================================================
+/**
+ * Map of skill names to their lock entries.
+ * Skill names are simple identifiers (not FQN patterns).
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const SkillsLockMapSchema = Schema.Record({
+    key: Schema.String,
+    value: SkillLockEntrySchema,
+});
+// =============================================================================
+// Lockfile
+// =============================================================================
+/**
+ * Schema for lockfile (axm-lock.yaml).
+ *
+ * The lockfile records the exact resolved state of all installed skills,
+ * enabling reproducible installations across environments.
+ *
+ * Structure:
+ * - lockfileVersion: Schema version (currently 1)
+ * - skills: Map of skill names to their lock entries
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const LockfileSchema = Schema.Struct({
+    lockfileVersion: Schema.Number,
+    skills: SkillsLockMapSchema,
+});
+//# sourceMappingURL=schema.js.map

package/dist/src/lockfile/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/lockfile/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,gFAAgF;AAChF,iBAAiB;AACjB,gFAAgF;AAEhF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,YAAY,EAAE;IACjF,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC;IAC1B,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE;CAC/B,CAAC,CAAC;AAEH,gFAAgF;AAChF,oDAAoD;AACpD,gFAAgF;AAEhF;;GAEG;AACH,MAAM,YAAY,GAAG;IACnB,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC;IACnC,WAAW,EAAE,cAAc;IAC3B,SAAS,EAAE,cAAc;IACzB,WAAW,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC;CAC5C,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,MAAM,CAAC,MAAM,CAAC;IACjD,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC;IAC9B,KAAK,EAAE,MAAM,CAAC,MAAM;IACpB,IAAI,EAAE,MAAM,CAAC,MAAM;IACnB,GAAG,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC;IACnC,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC;IACpC,GAAG,YAAY;CAChB,CAAC,CAAC;AAEH;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,MAAM,CAAC,MAAM,CAAC;IACjD,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC;IAC9B,KAAK,EAAE,MAAM,CAAC,MAAM;IACpB,IAAI,EAAE,MAAM,CAAC,MAAM;IACnB,GAAG,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC;IACnC,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC;IACpC,GAAG,YAAY;CAChB,CAAC,CAAC;AAEH;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,MAAM,CAAC,MAAM,CAAC;IACpD,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC;IACjC,KAAK,EAAE,MAAM,CAAC,MAAM;IACpB,IAAI,EAAE,MAAM,CAAC,MAAM;IACnB,GAAG,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC;IACnC,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC;IACpC,GAAG,YAAY;CAChB,CAAC,CAAC;AAEH;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,MAAM,CAAC,MAAM,CAAC;IACrD,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC;IAClC,YAAY,EAAE,MAAM,CAAC,MAAM;IAC3B,OAAO,EAAE,MAAM,CAAC,MAAM;IACtB,IAAI,EAAE,MAAM,CAAC,MAAM;IACnB,GAAG,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC;IACnC,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC;IACpC,GAAG,YAAY;CAChB,CAAC,CAAC;AAEH;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC,MAAM,CAAC;IAC9C,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC;IAC3B,GAAG,EAAE,MAAM,CAAC,MAAM;IAClB,GAAG,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC;IACnC,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC;IACpC,GAAG,YAAY;CAChB,CAAC,CAAC;AAEH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,MAAM,CAAC,MAAM,CAAC;IAChD,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC;IAC7B,IAAI,EAAE,MAAM,CAAC,MAAM;IACnB,GAAG,YAAY;CAChB,CAAC,CAAC;AAEH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,MAAM,CAAC,MAAM,CAAC;IACnD,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC;IAChC,KAAK,EAAE,MAAM,CAAC,MAAM;IACpB,IAAI,EAAE,MAAM,CAAC,MAAM;IACnB,eAAe,EAAE,MAAM,CAAC,MAAM;IAC9B,QAAQ,EAAE,MAAM,CAAC,MAAM;IACvB,UAAU,EAAE,MAAM,CAAC,MAAM;IACzB,GAAG,YAAY;CAChB,CAAC,CAAC;AAEH,gFAAgF;AAChF,+CAA+C;AAC/C,gFAAgF;AAEhF;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,MAAM,CAAC,KAAK,CAC9C,qBAAqB,EACrB,qBAAqB,EACrB,wBAAwB,EACxB,yBAAyB,EACzB,kBAAkB,EAClB,oBAAoB,EACpB,uBAAuB,CACxB,CAAC;AASF,gFAAgF;AAChF,kBAAkB;AAClB,gFAAgF;AAEhF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,MAAM,CAAC,MAAM,CAAC;IAC/C,GAAG,EAAE,MAAM,CAAC,MAAM;IAClB,KAAK,EAAE,oBAAoB;CAC5B,CAAC,CAAC;AASH,gFAAgF;AAChF,WAAW;AACX,gFAAgF;AAEhF;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,CAAC;IAC1C,eAAe,EAAE,MAAM,CAAC,MAAM;IAC9B,MAAM,EAAE,mBAAmB;CAC5B,CAAC,CAAC"}

package/dist/src/main.d.ts

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+import * as Effect from "effect/Effect";
+export declare const program: Effect.Effect<{
+    [x: string]: unknown;
+    "non-interactive": boolean | undefined;
+    nonInteractive: boolean | undefined;
+    _: (string | number)[];
+    $0: string;
+}, never, never>;
+//# sourceMappingURL=main.d.ts.map

package/dist/src/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../src/main.ts"],"names":[],"mappings":";AACA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AASxC,eAAO,MAAM,OAAO;;;;;;gBAyBnB,CAAC"}

package/dist/src/main.js

@@ -0,0 +1,36 @@
+#!/usr/bin/env node
+import * as Effect from "effect/Effect";
+import yargs from "yargs";
+import { hideBin } from "yargs/helpers";
+import { initCommand } from "./cli-commands/init/command.js";
+import { skillsCommand } from "./cli-commands/skills/command.js";
+const version = "0.0.1";
+export const program = Effect.promise(() => yargs(hideBin(process.argv))
+    .scriptName("axm")
+    .usage("$0 <command> [options]\n\nManage skills (extensions) for AI coding agents.")
+    .version(version)
+    .help()
+    .strict()
+    .option("non-interactive", {
+    type: "boolean",
+    describe: "Disable all prompts",
+})
+    .command(initCommand)
+    .command(skillsCommand)
+    .example("$0 init", "Initialize axm in current project")
+    .example("$0 skills install owner/repo", "Install skills from a GitHub repository")
+    .demandCommand(1)
+    .fail((msg, _err, yargs) => {
+    if (msg?.includes("Not enough non-option arguments")) {
+        yargs.showHelp();
+        process.exit(0);
+    }
+    console.error(msg ?? _err);
+    process.exit(1);
+})
+    .parseAsync());
+Effect.runPromise(program).catch((error) => {
+    console.error(error);
+    process.exit(1);
+});
+//# sourceMappingURL=main.js.map

package/dist/src/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../../src/main.ts"],"names":[],"mappings":";AACA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAExC,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAEjE,MAAM,OAAO,GAAG,OAAO,CAAC;AAExB,MAAM,CAAC,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,CACzC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;KACzB,UAAU,CAAC,KAAK,CAAC;KACjB,KAAK,CAAC,4EAA4E,CAAC;KACnF,OAAO,CAAC,OAAO,CAAC;KAChB,IAAI,EAAE;KACN,MAAM,EAAE;KACR,MAAM,CAAC,iBAAiB,EAAE;IACzB,IAAI,EAAE,SAAS;IACf,QAAQ,EAAE,qBAAqB;CAChC,CAAC;KACD,OAAO,CAAC,WAAW,CAAC;KACpB,OAAO,CAAC,aAAa,CAAC;KACtB,OAAO,CAAC,SAAS,EAAE,mCAAmC,CAAC;KACvD,OAAO,CAAC,8BAA8B,EAAE,yCAAyC,CAAC;KAClF,aAAa,CAAC,CAAC,CAAC;KAChB,IAAI,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE;IACzB,IAAI,GAAG,EAAE,QAAQ,CAAC,iCAAiC,CAAC,EAAE,CAAC;QACrD,KAAK,CAAC,QAAQ,EAAE,CAAC;QACjB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC;IAC3B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC;KACD,UAAU,EAAE,CAChB,CAAC;AAEF,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACzC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACrB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/src/registry/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Registry feature module.
+ *
+ * Provides schema definitions for registry layout including extension index
+ * metadata and version entries.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+export type { ExtensionIndex, RegistryExtensionType, VersionEntry } from "./schema.js";
+export { ExtensionIndexSchema, RegistryExtensionTypeSchema, VersionEntrySchema } from "./schema.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/registry/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/registry/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,YAAY,EAAE,cAAc,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACvF,OAAO,EAAE,oBAAoB,EAAE,2BAA2B,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC"}

package/dist/src/registry/index.js

@@ -0,0 +1,11 @@
+/**
+ * Registry feature module.
+ *
+ * Provides schema definitions for registry layout including extension index
+ * metadata and version entries.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+export { ExtensionIndexSchema, RegistryExtensionTypeSchema, VersionEntrySchema } from "./schema.js";
+//# sourceMappingURL=index.js.map

package/dist/src/registry/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/registry/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAAE,oBAAoB,EAAE,2BAA2B,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC"}

package/dist/src/registry/schema.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Registry layout schemas for extension index and version entries.
+ *
+ * These schemas define the structure of registry metadata that describes
+ * published extensions and their available versions.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as Schema from "effect/Schema";
+/**
+ * A single published version of an extension in the registry.
+ *
+ * Fields:
+ * - version: Semver version string (e.g., "1.2.3")
+ * - published: ISO 8601 timestamp of publication
+ * - agents: Agent identifiers this version supports (plain strings for forward compatibility)
+ * - dependencies: Optional map of `@scope/name` to semver range
+ * - engines: Optional map of engine constraints (e.g., `{"axm": ">=0.2.0"}`)
+ * - checksum: Content hash in `sha256:<hex>` format
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const VersionEntrySchema: Schema.Struct<{
+    version: typeof Schema.String;
+    published: typeof Schema.String;
+    agents: Schema.Array$<typeof Schema.String>;
+    dependencies: Schema.optional<Schema.Record$<typeof Schema.String, typeof Schema.String>>;
+    engines: Schema.optional<Schema.Record$<typeof Schema.String, typeof Schema.String>>;
+    checksum: typeof Schema.String;
+}>;
+/**
+ * Inferred type for VersionEntry schema.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export type VersionEntry = typeof VersionEntrySchema.Type;
+/**
+ * Extension type within the registry — currently "skill" or "mcp-server".
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const RegistryExtensionTypeSchema: Schema.Union<[Schema.Literal<["skill"]>, Schema.Literal<["mcp-server"]>]>;
+/**
+ * Inferred type for RegistryExtensionType schema.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export type RegistryExtensionType = typeof RegistryExtensionTypeSchema.Type;
+/**
+ * Extension index metadata describing a published extension in the registry.
+ *
+ * Fields:
+ * - name: Extension name without scope
+ * - scope: Scope including `@` prefix (e.g., "@acme")
+ * - type: Extension type ("skill" or "mcp-server")
+ * - description: Optional human-readable description
+ * - repository: Optional repository URL
+ * - license: Optional SPDX license identifier
+ * - authors: Optional list of authors
+ * - versions: Array of version entries, newest first
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const ExtensionIndexSchema: Schema.Struct<{
+    name: typeof Schema.String;
+    scope: typeof Schema.String;
+    type: Schema.Union<[Schema.Literal<["skill"]>, Schema.Literal<["mcp-server"]>]>;
+    description: Schema.optional<typeof Schema.String>;
+    repository: Schema.optional<typeof Schema.String>;
+    license: 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>;
+    }>>>;
+    versions: Schema.Array$<Schema.Struct<{
+        version: typeof Schema.String;
+        published: typeof Schema.String;
+        agents: Schema.Array$<typeof Schema.String>;
+        dependencies: Schema.optional<Schema.Record$<typeof Schema.String, typeof Schema.String>>;
+        engines: Schema.optional<Schema.Record$<typeof Schema.String, typeof Schema.String>>;
+        checksum: typeof Schema.String;
+    }>>;
+}>;
+/**
+ * Inferred type for ExtensionIndex schema.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export type ExtensionIndex = typeof ExtensionIndexSchema.Type;
+//# sourceMappingURL=schema.d.ts.map

package/dist/src/registry/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/registry/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAOxC;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,kBAAkB;;;;;;;EAO7B,CAAC;AAEH;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG,OAAO,kBAAkB,CAAC,IAAI,CAAC;AAM1D;;;;GAIG;AACH,eAAO,MAAM,2BAA2B,2EAGvC,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,qBAAqB,GAAG,OAAO,2BAA2B,CAAC,IAAI,CAAC;AAE5E;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;EAS/B,CAAC;AAEH;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG,OAAO,oBAAoB,CAAC,IAAI,CAAC"}

package/dist/src/registry/schema.js

@@ -0,0 +1,69 @@
+/**
+ * Registry layout schemas for extension index and version entries.
+ *
+ * These schemas define the structure of registry metadata that describes
+ * published extensions and their available versions.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as Schema from "effect/Schema";
+import { AuthorSchema } from "../extensions/common.js";
+// =============================================================================
+// Version Entry
+// =============================================================================
+/**
+ * A single published version of an extension in the registry.
+ *
+ * Fields:
+ * - version: Semver version string (e.g., "1.2.3")
+ * - published: ISO 8601 timestamp of publication
+ * - agents: Agent identifiers this version supports (plain strings for forward compatibility)
+ * - dependencies: Optional map of `@scope/name` to semver range
+ * - engines: Optional map of engine constraints (e.g., `{"axm": ">=0.2.0"}`)
+ * - checksum: Content hash in `sha256:<hex>` format
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const VersionEntrySchema = Schema.Struct({
+    version: Schema.String,
+    published: Schema.String,
+    agents: Schema.Array(Schema.String),
+    dependencies: Schema.optional(Schema.Record({ key: Schema.String, value: Schema.String })),
+    engines: Schema.optional(Schema.Record({ key: Schema.String, value: Schema.String })),
+    checksum: Schema.String,
+});
+// =============================================================================
+// Extension Index
+// =============================================================================
+/**
+ * Extension type within the registry — currently "skill" or "mcp-server".
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const RegistryExtensionTypeSchema = Schema.Union(Schema.Literal("skill"), Schema.Literal("mcp-server"));
+/**
+ * Extension index metadata describing a published extension in the registry.
+ *
+ * Fields:
+ * - name: Extension name without scope
+ * - scope: Scope including `@` prefix (e.g., "@acme")
+ * - type: Extension type ("skill" or "mcp-server")
+ * - description: Optional human-readable description
+ * - repository: Optional repository URL
+ * - license: Optional SPDX license identifier
+ * - authors: Optional list of authors
+ * - versions: Array of version entries, newest first
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const ExtensionIndexSchema = Schema.Struct({
+    name: Schema.String,
+    scope: Schema.String,
+    type: RegistryExtensionTypeSchema,
+    description: Schema.optional(Schema.String),
+    repository: Schema.optional(Schema.String),
+    license: Schema.optional(Schema.String),
+    authors: Schema.optional(Schema.Array(AuthorSchema)),
+    versions: Schema.Array(VersionEntrySchema),
+});
+//# sourceMappingURL=schema.js.map

package/dist/src/registry/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/registry/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAEvD,gFAAgF;AAChF,gBAAgB;AAChB,gFAAgF;AAEhF;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC,MAAM,CAAC;IAC9C,OAAO,EAAE,MAAM,CAAC,MAAM;IACtB,SAAS,EAAE,MAAM,CAAC,MAAM;IACxB,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC;IACnC,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;IAC1F,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IACrF,QAAQ,EAAE,MAAM,CAAC,MAAM;CACxB,CAAC,CAAC;AASH,gFAAgF;AAChF,kBAAkB;AAClB,gFAAgF;AAEhF;;;;GAIG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,MAAM,CAAC,KAAK,CACrD,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EACvB,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,CAC7B,CAAC;AASF;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,MAAM,CAAC,MAAM,CAAC;IAChD,IAAI,EAAE,MAAM,CAAC,MAAM;IACnB,KAAK,EAAE,MAAM,CAAC,MAAM;IACpB,IAAI,EAAE,2BAA2B;IACjC,WAAW,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC;IAC3C,UAAU,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC;IAC1C,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC;IACvC,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;IACpD,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC;CAC3C,CAAC,CAAC"}

package/dist/src/resolution/errors.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Resolution error types.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+/**
+ * Error codes for resolution failures.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export type ResolutionErrorCode = "NOT_FOUND" | "AMBIGUOUS" | "INVALID_INPUT" | "NETWORK_ERROR";
+declare const ResolutionError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }) => import("effect/Cause").YieldableError & {
+    readonly _tag: "ResolutionError";
+} & Readonly<A>;
+/**
+ * Error thrown when extension resolution fails.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare class ResolutionError extends ResolutionError_base<{
+    readonly code: ResolutionErrorCode;
+    readonly message: string;
+    readonly input: string;
+    readonly suggestions?: readonly string[];
+}> {
+}
+export {};
+//# sourceMappingURL=errors.d.ts.map

package/dist/src/resolution/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/resolution/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAAG,WAAW,GAAG,WAAW,GAAG,eAAe,GAAG,eAAe,CAAC;;;;AAEhG;;;;GAIG;AACH,qBAAa,eAAgB,SAAQ,qBAAoC;IACvE,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1C,CAAC;CAAG"}

package/dist/src/resolution/errors.js

@@ -0,0 +1,15 @@
+/**
+ * Resolution error types.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import * as Data from "effect/Data";
+/**
+ * Error thrown when extension resolution fails.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export class ResolutionError extends Data.TaggedError("ResolutionError") {
+}
+//# sourceMappingURL=errors.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/resolution/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AASpC;;;;GAIG;AACH,MAAM,OAAO,eAAgB,SAAQ,IAAI,CAAC,WAAW,CAAC,iBAAiB,CAKrE;CAAG"}

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

@@ -0,0 +1,13 @@
+/**
+ * Extension resolution module.
+ *
+ * Resolves input strings to extension references with metadata.
+ * This module is reusable across all extension types and commands.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+export { ResolutionError, type ResolutionErrorCode } from "./errors.js";
+export { defaultResolutionOptions, resolveExtension } from "./resolver.js";
+export type { ExtensionMetadata, ExtensionRef, ExtensionType, ResolutionOptions } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/resolution/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,eAAe,EAAE,KAAK,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAExE,OAAO,EAAE,wBAAwB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAE3E,YAAY,EAAE,iBAAiB,EAAE,YAAY,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC"}

package/dist/src/resolution/index.js

@@ -0,0 +1,14 @@
+/**
+ * Extension resolution module.
+ *
+ * Resolves input strings to extension references with metadata.
+ * This module is reusable across all extension types and commands.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+// Re-export errors
+export { ResolutionError } from "./errors.js";
+// Re-export resolver
+export { defaultResolutionOptions, resolveExtension } from "./resolver.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/resolution/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,mBAAmB;AACnB,OAAO,EAAE,eAAe,EAA4B,MAAM,aAAa,CAAC;AACxE,qBAAqB;AACrB,OAAO,EAAE,wBAAwB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC"}

package/dist/src/resolution/resolver.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Main extension resolution entry point.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import * as Effect from "effect/Effect";
+import type { ResolutionError } from "./errors.js";
+import type { ExtensionRef, ResolutionOptions } from "./types.js";
+/**
+ * Default resolution options with all fields set to None.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const defaultResolutionOptions: ResolutionOptions;
+/**
+ * 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 declare const resolveExtension: (input: string, options?: ResolutionOptions) => Effect.Effect<ExtensionRef[], ResolutionError, any>;
+//# sourceMappingURL=resolver.d.ts.map

package/dist/src/resolution/resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../../../src/resolution/resolver.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAUnD,OAAO,KAAK,EAAE,YAAY,EAAiB,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEjF;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,EAAE,iBAQtC,CAAC;AAiDF;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,gBAAgB,GAC3B,OAAO,MAAM,EACb,UAAS,iBAA4C,wDAkCtD,CAAC"}