@axm.sh/cli 0.0.1

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

@@ -0,0 +1,62 @@
+/**
+ * Core domain types for skills management.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import * as Option from "effect/Option";
+import * as Record from "effect/Record";
+export type { GitHostingProviderSource, SourceInput, SourceType } from "../../sources/index.js";
+export { isGitHostingProviderSource } from "../../sources/index.js";
+/**
+ * Represents a discovered skill.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export interface Skill {
+    /** Unique name of the skill */
+    readonly name: string;
+    /** Description of the skill */
+    readonly description: string;
+    /** Optional metadata from SKILL.md frontmatter */
+    readonly metadata: Option.Option<Record.ReadonlyRecord<string, unknown>>;
+}
+/**
+ * Per-skill entry in the lockfile.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export interface LockEntry {
+    /** Canonical source notation (e.g., "github:owner/repo") */
+    readonly source: string;
+    /** Fully resolved URL or path */
+    readonly origin: string;
+    /** Git tree SHA for git sources, or SHA-256 content hash for local sources */
+    readonly folderHash: string;
+    /** ISO 8601 timestamp of initial installation */
+    readonly installedAt: string;
+    /** ISO 8601 timestamp of last update */
+    readonly updatedAt: string;
+}
+/**
+ * Extensions section in lockfile containing locked extension entries.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export interface LockfileExtensions {
+    /** Skills keyed by name */
+    readonly skills: Readonly<Record.ReadonlyRecord<string, LockEntry>>;
+}
+/**
+ * Contents of .axm/axm.lock (JSON format).
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export interface Lockfile {
+    /** Lockfile schema version */
+    readonly lockfileVersion: number;
+    /** Locked extensions keyed by type */
+    readonly extensions: LockfileExtensions;
+}
+export type { Settings } from "../../settings/index.js";
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/extensions/skills/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAGxC,YAAY,EAAE,wBAAwB,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAChG,OAAO,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AAMpE;;;;GAIG;AACH,MAAM,WAAW,KAAK;IACpB,+BAA+B;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,+BAA+B;IAC/B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,kDAAkD;IAClD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAC1E;AAMD;;;;GAIG;AACH,MAAM,WAAW,SAAS;IACxB,4DAA4D;IAC5D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,iCAAiC;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,8EAA8E;IAC9E,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,iDAAiD;IACjD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,wCAAwC;IACxC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,2BAA2B;IAC3B,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;CACrE;AAED;;;;GAIG;AACH,MAAM,WAAW,QAAQ;IACvB,8BAA8B;IAC9B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,sCAAsC;IACtC,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAC;CACzC;AAMD,YAAY,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC"}

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

@@ -0,0 +1,10 @@
+/**
+ * Core domain types for skills management.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import * as Option from "effect/Option";
+import * as Record from "effect/Record";
+export { isGitHostingProviderSource } from "../../sources/index.js";
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/extensions/skills/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAIxC,OAAO,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC"}

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

@@ -0,0 +1,26 @@
+/**
+ * Error types for git operations.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import * as Option from "effect/Option";
+declare const GitError_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: "GitError";
+} & Readonly<A>;
+/**
+ * Error type for git operations.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare class GitError extends GitError_base<{
+    /** What operation failed */
+    readonly operation: "clone" | "checkout" | "resolve-ref" | "get-commit" | "get-tree-sha" | "is-git-repo";
+    /** Human-readable error message */
+    readonly message: string;
+    /** Original error cause */
+    readonly cause: Option.Option<unknown>;
+}> {
+}
+export {};
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/git/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;;;;AAExC;;;;GAIG;AACH,qBAAa,QAAS,SAAQ,cAA6B;IACzD,4BAA4B;IAC5B,QAAQ,CAAC,SAAS,EACd,OAAO,GACP,UAAU,GACV,aAAa,GACb,YAAY,GACZ,cAAc,GACd,aAAa,CAAC;IAClB,mCAAmC;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,2BAA2B;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;CACxC,CAAC;CAAG"}

package/dist/src/git/errors.js

@@ -0,0 +1,16 @@
+/**
+ * Error types for git operations.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import * as Data from "effect/Data";
+import * as Option from "effect/Option";
+/**
+ * Error type for git operations.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export class GitError extends Data.TaggedError("GitError") {
+}
+//# sourceMappingURL=errors.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/git/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AACpC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC;;;;GAIG;AACH,MAAM,OAAO,QAAS,SAAQ,IAAI,CAAC,WAAW,CAAC,UAAU,CAavD;CAAG"}

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

@@ -0,0 +1,9 @@
+/**
+ * Git operations module.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+export { GitError } from "./errors.js";
+export { cloneRepo, getCurrentCommit, getTreeSha, isGitRepository, resolveRef, shallowClone, } from "./operations.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/git/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EACL,SAAS,EACT,gBAAgB,EAChB,UAAU,EACV,eAAe,EACf,UAAU,EACV,YAAY,GACb,MAAM,iBAAiB,CAAC"}

package/dist/src/git/index.js

@@ -0,0 +1,9 @@
+/**
+ * Git operations module.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+export { GitError } from "./errors.js";
+export { cloneRepo, getCurrentCommit, getTreeSha, isGitRepository, resolveRef, shallowClone, } from "./operations.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/git/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EACL,SAAS,EACT,gBAAgB,EAChB,UAAU,EACV,eAAe,EACf,UAAU,EACV,YAAY,GACb,MAAM,iBAAiB,CAAC"}

package/dist/src/git/operations.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Git operations for cloning repositories at specific refs.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import * as Effect from "effect/Effect";
+import { GitError } from "./errors.js";
+/**
+ * Clone a git repository to destination.
+ * If ref provided, checkout that ref after clone.
+ *
+ * @param url - Repository URL (HTTPS or SSH)
+ * @param destination - Local path to clone to
+ * @param ref - Optional git ref (tag, branch, or SHA) to checkout
+ * @returns Effect that resolves on success or fails with GitError
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const cloneRepo: (url: string, destination: string, ref?: string) => Effect.Effect<void, GitError>;
+/**
+ * Shallow clone a git repository (depth 1, single branch).
+ * Significantly faster than a full clone for read-only use cases like skill discovery.
+ *
+ * @param url - Repository URL (HTTPS or SSH)
+ * @param destination - Local path to clone to
+ * @param ref - Optional git ref (branch or tag) to clone
+ * @returns Effect that resolves on success or fails with GitError
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const shallowClone: (url: string, destination: string, ref?: string) => Effect.Effect<void, GitError>;
+/**
+ * Resolve a ref (tag, branch, SHA) to a full commit SHA.
+ *
+ * @param repoPath - Path to the git repository
+ * @param ref - Git ref to resolve (tag, branch, or SHA)
+ * @returns Effect that resolves to the full commit SHA
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const resolveRef: (repoPath: string, ref: string) => Effect.Effect<string, GitError>;
+/**
+ * Get the current HEAD commit SHA.
+ * Used after clone to record in lockfile.
+ *
+ * @param repoPath - Path to the git repository
+ * @returns Effect that resolves to the current HEAD commit SHA
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const getCurrentCommit: (repoPath: string) => Effect.Effect<string, GitError>;
+/**
+ * Get the git tree SHA for a path within a repository.
+ *
+ * The tree SHA is a hash of the directory's contents at the current commit.
+ * Unlike commit SHA, it is stable across rebases that don't change content.
+ *
+ * @param repoPath - Path to the git repository root
+ * @param subPath - Optional subpath within the repository (defaults to root ".")
+ * @returns Effect that resolves to the tree SHA, or fails if path is not in a git repo
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const getTreeSha: (repoPath: string, subPath?: string) => Effect.Effect<string, GitError>;
+/**
+ * Check if a directory is within a git repository.
+ *
+ * @param dirPath - Path to check
+ * @returns Effect that resolves to true if in a git repo, false otherwise
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const isGitRepository: (dirPath: string) => Effect.Effect<boolean, never>;
+//# sourceMappingURL=operations.d.ts.map

package/dist/src/git/operations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operations.d.ts","sourceRoot":"","sources":["../../../src/git/operations.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAIxC,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAgDvC;;;;;;;;;;GAUG;AACH,eAAO,MAAM,SAAS,GACpB,KAAK,MAAM,EACX,aAAa,MAAM,EACnB,MAAM,MAAM,KACX,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,CAe3B,CAAC;AAEL;;;;;;;;;;GAUG;AACH,eAAO,MAAM,YAAY,GACvB,KAAK,MAAM,EACX,aAAa,MAAM,EACnB,MAAM,MAAM,KACX,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,CAU3B,CAAC;AAEL;;;;;;;;GAQG;AACH,eAAO,MAAM,UAAU,GAAI,UAAU,MAAM,EAAE,KAAK,MAAM,KAAG,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CASrF,CAAC;AAEL;;;;;;;;GAQG;AACH,eAAO,MAAM,gBAAgB,GAAI,UAAU,MAAM,KAAG,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAQ9E,CAAC;AAEL;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,UAAU,GAAI,UAAU,MAAM,EAAE,gBAAa,KAAG,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CA2BvF,CAAC;AAEL;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,GAAI,SAAS,MAAM,KAAG,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAO3E,CAAC"}

package/dist/src/git/operations.js

@@ -0,0 +1,175 @@
+/**
+ * Git operations for cloning repositories at specific refs.
+ *
+ * @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 simpleGit, {} from "simple-git";
+import { GitError } from "./errors.js";
+// -----------------------------------------------------------------------------
+// Internal Helpers
+// -----------------------------------------------------------------------------
+/**
+ * Creates a simple-git instance with options that allow SSH passphrase prompts.
+ * Using 'inherit' for stdio enables interactive authentication.
+ */
+const createGit = (baseDir) => {
+    const options = {
+        baseDir: baseDir ?? process.cwd(),
+        binary: "git",
+        maxConcurrentProcesses: 1,
+        config: [],
+    };
+    return simpleGit(options);
+};
+/**
+ * Maps unknown errors to GitError with appropriate context.
+ */
+const mapGitError = (operation, context) => (error) => {
+    const baseMessage = context ?? `Git ${operation} failed`;
+    if (error instanceof Error) {
+        return new GitError({
+            operation,
+            message: `${baseMessage}: ${error.message}`,
+            cause: Option.some(error),
+        });
+    }
+    return new GitError({
+        operation,
+        message: `${baseMessage}: ${String(error)}`,
+        cause: Option.some(error),
+    });
+};
+// -----------------------------------------------------------------------------
+// Git Operations
+// -----------------------------------------------------------------------------
+/**
+ * Clone a git repository to destination.
+ * If ref provided, checkout that ref after clone.
+ *
+ * @param url - Repository URL (HTTPS or SSH)
+ * @param destination - Local path to clone to
+ * @param ref - Optional git ref (tag, branch, or SHA) to checkout
+ * @returns Effect that resolves on success or fails with GitError
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const cloneRepo = (url, destination, ref) => Effect.gen(function* () {
+    // Clone the repository
+    yield* Effect.tryPromise({
+        try: () => createGit().clone(url, destination),
+        catch: mapGitError("clone", `Failed to clone ${url}`),
+    });
+    // If ref provided, checkout that ref
+    if (ref) {
+        yield* Effect.tryPromise({
+            try: () => createGit(destination).checkout(ref),
+            catch: mapGitError("checkout", `Failed to checkout ref '${ref}'`),
+        });
+    }
+});
+/**
+ * Shallow clone a git repository (depth 1, single branch).
+ * Significantly faster than a full clone for read-only use cases like skill discovery.
+ *
+ * @param url - Repository URL (HTTPS or SSH)
+ * @param destination - Local path to clone to
+ * @param ref - Optional git ref (branch or tag) to clone
+ * @returns Effect that resolves on success or fails with GitError
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const shallowClone = (url, destination, ref) => Effect.tryPromise({
+    try: () => createGit().clone(url, destination, [
+        "--depth",
+        "1",
+        "--single-branch",
+        ...(ref ? ["--branch", ref] : []),
+    ]),
+    catch: mapGitError("clone", `Failed to shallow clone ${url}`),
+});
+/**
+ * Resolve a ref (tag, branch, SHA) to a full commit SHA.
+ *
+ * @param repoPath - Path to the git repository
+ * @param ref - Git ref to resolve (tag, branch, or SHA)
+ * @returns Effect that resolves to the full commit SHA
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const resolveRef = (repoPath, ref) => Effect.tryPromise({
+    try: async () => {
+        const git = createGit(repoPath);
+        // rev-parse resolves any ref to its full SHA
+        const sha = await git.revparse([ref]);
+        return sha.trim();
+    },
+    catch: mapGitError("resolve-ref", `Failed to resolve ref '${ref}'`),
+});
+/**
+ * Get the current HEAD commit SHA.
+ * Used after clone to record in lockfile.
+ *
+ * @param repoPath - Path to the git repository
+ * @returns Effect that resolves to the current HEAD commit SHA
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const getCurrentCommit = (repoPath) => Effect.tryPromise({
+    try: async () => {
+        const git = createGit(repoPath);
+        const sha = await git.revparse(["HEAD"]);
+        return sha.trim();
+    },
+    catch: mapGitError("get-commit", "Failed to get current commit"),
+});
+/**
+ * Get the git tree SHA for a path within a repository.
+ *
+ * The tree SHA is a hash of the directory's contents at the current commit.
+ * Unlike commit SHA, it is stable across rebases that don't change content.
+ *
+ * @param repoPath - Path to the git repository root
+ * @param subPath - Optional subpath within the repository (defaults to root ".")
+ * @returns Effect that resolves to the tree SHA, or fails if path is not in a git repo
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const getTreeSha = (repoPath, subPath = ".") => Effect.tryPromise({
+    try: async () => {
+        const git = createGit(repoPath);
+        // For root directory, use rev-parse HEAD^{tree}
+        if (subPath === "." || subPath === "") {
+            const result = await git.revparse(["HEAD^{tree}"]);
+            return result.trim();
+        }
+        // For subdirectories, use ls-tree to get the tree object SHA
+        // ls-tree returns: <mode> <type> <sha>\t<path>
+        const result = await git.raw(["ls-tree", "HEAD", subPath]);
+        const trimmed = result.trim();
+        if (!trimmed) {
+            throw new Error(`Path '${subPath}' not found in repository`);
+        }
+        // Parse the output: "040000 tree <sha>\t<path>" or "100644 blob <sha>\t<path>"
+        const parts = trimmed.split(/\s+/);
+        const sha = Option.getOrThrowWith(Array.get(parts, 2), () => new Error(`Unexpected ls-tree output: ${trimmed}`));
+        return sha;
+    },
+    catch: mapGitError("get-tree-sha", `Failed to get tree SHA for '${subPath}'`),
+});
+/**
+ * Check if a directory is within a git repository.
+ *
+ * @param dirPath - Path to check
+ * @returns Effect that resolves to true if in a git repo, false otherwise
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const isGitRepository = (dirPath) => Effect.tryPromise({
+    try: () => createGit(dirPath).revparse(["--git-dir"]),
+    catch: mapGitError("is-git-repo", `Failed to check git repository at '${dirPath}'`),
+}).pipe(Effect.as(true), Effect.catchAll(() => Effect.succeed(false)));
+//# sourceMappingURL=operations.js.map

package/dist/src/git/operations.js.map

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

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

@@ -0,0 +1,15 @@
+/**
+ * Lockfile feature module.
+ *
+ * Provides lockfile schema definitions and I/O functions for managing
+ * the `.axm/axm-lock.yaml` file that tracks installed skill versions.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+export type { Lockfile, SkillLockEntry, SkillsLockMap } from "./schema.js";
+export { AzureReposLockEntrySchema, BitbucketLockEntrySchema, DateFromString, GitHubLockEntrySchema, GitLabLockEntrySchema, GitLockEntrySchema, LocalLockEntrySchema, LockfileSchema, RegistryLockEntrySchema, SkillLockEntrySchema, SkillsLockMapSchema, } from "./schema.js";
+export type { LockfileError } from "./lockfile.js";
+export { LOCKFILE_NAME, LockfileNotFoundError, LockfileParseError, LockfileWriteError, } from "./lockfile.js";
+export { readLockfile, writeLockfile } from "./lockfile.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lockfile/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,YAAY,EAAE,QAAQ,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC3E,OAAO,EACL,yBAAyB,EACzB,wBAAwB,EACxB,cAAc,EACd,qBAAqB,EACrB,qBAAqB,EACrB,kBAAkB,EAClB,oBAAoB,EACpB,cAAc,EACd,uBAAuB,EACvB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,aAAa,CAAC;AAGrB,YAAY,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EACL,aAAa,EACb,qBAAqB,EACrB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC"}

package/dist/src/lockfile/index.js

@@ -0,0 +1,13 @@
+/**
+ * Lockfile feature module.
+ *
+ * Provides lockfile schema definitions and I/O functions for managing
+ * the `.axm/axm-lock.yaml` file that tracks installed skill versions.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+export { AzureReposLockEntrySchema, BitbucketLockEntrySchema, DateFromString, GitHubLockEntrySchema, GitLabLockEntrySchema, GitLockEntrySchema, LocalLockEntrySchema, LockfileSchema, RegistryLockEntrySchema, SkillLockEntrySchema, SkillsLockMapSchema, } from "./schema.js";
+export { LOCKFILE_NAME, LockfileNotFoundError, LockfileParseError, LockfileWriteError, } from "./lockfile.js";
+export { readLockfile, writeLockfile } from "./lockfile.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lockfile/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EACL,yBAAyB,EACzB,wBAAwB,EACxB,cAAc,EACd,qBAAqB,EACrB,qBAAqB,EACrB,kBAAkB,EAClB,oBAAoB,EACpB,cAAc,EACd,uBAAuB,EACvB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,aAAa,CAAC;AAIrB,OAAO,EACL,aAAa,EACb,qBAAqB,EACrB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC"}

package/dist/src/lockfile/lockfile.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Lockfile module for managing `.axm/axm-lock.yaml` (YAML format).
+ *
+ * Provides functions to read, write, and update lockfile entries
+ * for tracking installed skill versions.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import * as FileSystem from "@effect/platform/FileSystem";
+import * as Path from "@effect/platform/Path";
+import * as Effect from "effect/Effect";
+import { type Lockfile } from "./schema.js";
+/**
+ * Filename for the lockfile.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const LOCKFILE_NAME = "axm-lock.yaml";
+declare const LockfileNotFoundError_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: "LockfileNotFoundError";
+} & Readonly<A>;
+/**
+ * Error when lockfile does not exist.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare class LockfileNotFoundError extends LockfileNotFoundError_base<{
+    readonly path: string;
+    readonly message: string;
+}> {
+}
+declare const LockfileParseError_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: "LockfileParseError";
+} & Readonly<A>;
+/**
+ * Error parsing the lockfile YAML content.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare class LockfileParseError extends LockfileParseError_base<{
+    readonly message: string;
+    readonly cause?: unknown;
+    readonly retryable: boolean;
+}> {
+}
+declare const LockfileWriteError_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: "LockfileWriteError";
+} & Readonly<A>;
+/**
+ * Error writing the lockfile to disk.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare class LockfileWriteError extends LockfileWriteError_base<{
+    readonly message: string;
+    readonly cause?: unknown;
+    readonly retryable: boolean;
+}> {
+}
+/**
+ * Union of all lockfile-related errors.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export type LockfileError = LockfileNotFoundError | LockfileParseError | LockfileWriteError;
+/**
+ * Reads and parses the lockfile from `.axm/axm-lock.yaml`.
+ *
+ * Returns an empty lockfile if the file does not exist.
+ * Returns a LockfileParseError if the file exists but is invalid.
+ *
+ * @param axmDir - Path to the `.axm` directory
+ * @returns Effect yielding the parsed Lockfile
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const readLockfile: (axmDir: string) => Effect.Effect<Lockfile, LockfileError, FileSystem.FileSystem | Path.Path>;
+/**
+ * Writes the lockfile to `.axm/axm-lock.yaml` in YAML format.
+ *
+ * Creates the `.axm` directory if it does not exist.
+ * Encodes Date fields to ISO strings for YAML serialization.
+ *
+ * @param axmDir - Path to the `.axm` directory
+ * @param lockfile - The lockfile object to write
+ * @returns Effect yielding void on success
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const writeLockfile: (axmDir: string, lockfile: Lockfile) => Effect.Effect<void, LockfileError, FileSystem.FileSystem | Path.Path>;
+export {};
+//# sourceMappingURL=lockfile.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lockfile.d.ts","sourceRoot":"","sources":["../../../src/lockfile/lockfile.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,UAAU,MAAM,6BAA6B,CAAC;AAC1D,OAAO,KAAK,IAAI,MAAM,uBAAuB,CAAC;AAE9C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAIxC,OAAO,EAAE,KAAK,QAAQ,EAAkB,MAAM,aAAa,CAAC;AAM5D;;;;GAIG;AACH,eAAO,MAAM,aAAa,kBAAkB,CAAC;;;;AAQ7C;;;;GAIG;AACH,qBAAa,qBAAsB,SAAQ,2BAA0C;IACnF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,CAAC;CAAG;;;;AAEL;;;;GAIG;AACH,qBAAa,kBAAmB,SAAQ,wBAAuC;IAC7E,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B,CAAC;CAAG;;;;AAEL;;;;GAIG;AACH,qBAAa,kBAAmB,SAAQ,wBAAuC;IAC7E,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B,CAAC;CAAG;AAEL;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,qBAAqB,GAAG,kBAAkB,GAAG,kBAAkB,CAAC;AAkC5F;;;;;;;;;;GAUG;AACH,eAAO,MAAM,YAAY,GACvB,QAAQ,MAAM,KACb,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,aAAa,EAAE,UAAU,CAAC,UAAU,GAAG,IAAI,CAAC,IAAI,CA6CvE,CAAC;AAEL;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,aAAa,GACxB,QAAQ,MAAM,EACd,UAAU,QAAQ,KACjB,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,aAAa,EAAE,UAAU,CAAC,UAAU,GAAG,IAAI,CAAC,IAAI,CAmDnE,CAAC"}