@axm.sh/cli 0.0.1

package/dist/src/lockfile/lockfile.js

@@ -0,0 +1,161 @@
+/**
+ * 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 Data from "effect/Data";
+import * as Effect from "effect/Effect";
+import * as Schema from "effect/Schema";
+import YAML from "yaml";
+import { LockfileSchema } from "./schema.js";
+// -----------------------------------------------------------------------------
+// Constants
+// -----------------------------------------------------------------------------
+/**
+ * Filename for the lockfile.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const LOCKFILE_NAME = "axm-lock.yaml";
+const LOCKFILE_VERSION = 1;
+// -----------------------------------------------------------------------------
+// Error Types
+// -----------------------------------------------------------------------------
+/**
+ * Error when lockfile does not exist.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export class LockfileNotFoundError extends Data.TaggedError("LockfileNotFoundError") {
+}
+/**
+ * Error parsing the lockfile YAML content.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export class LockfileParseError extends Data.TaggedError("LockfileParseError") {
+}
+/**
+ * Error writing the lockfile to disk.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export class LockfileWriteError extends Data.TaggedError("LockfileWriteError") {
+}
+// -----------------------------------------------------------------------------
+// Internal Helpers
+// -----------------------------------------------------------------------------
+/**
+ * Creates an empty lockfile with default values.
+ */
+const createEmptyLockfile = () => ({
+    lockfileVersion: LOCKFILE_VERSION,
+    skills: {},
+});
+/**
+ * Validates parsed YAML data against the lockfile schema.
+ * Returns a typed LockfileParseError on validation failure.
+ */
+const decodeLockfile = (data) => Schema.decodeUnknown(LockfileSchema)(data).pipe(Effect.mapError((e) => new LockfileParseError({
+    message: "Invalid lockfile format",
+    cause: e,
+    retryable: false,
+})));
+// -----------------------------------------------------------------------------
+// Public Functions
+// -----------------------------------------------------------------------------
+/**
+ * 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 const readLockfile = (axmDir) => Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    const path = yield* Path.Path;
+    const lockfilePath = path.join(axmDir, LOCKFILE_NAME);
+    // Check if file exists
+    const exists = yield* fs.exists(lockfilePath).pipe(Effect.mapError((error) => new LockfileParseError({
+        message: `Failed to check if lockfile exists at ${lockfilePath}`,
+        cause: error,
+        retryable: false,
+    })));
+    if (!exists) {
+        return createEmptyLockfile();
+    }
+    // Read and parse the file
+    const content = yield* fs.readFileString(lockfilePath).pipe(Effect.mapError((error) => new LockfileParseError({
+        message: `Failed to read lockfile at ${lockfilePath}`,
+        cause: error,
+        retryable: false,
+    })));
+    // Parse YAML
+    const parsed = yield* Effect.try({
+        try: () => YAML.parse(content),
+        catch: (error) => new LockfileParseError({
+            message: `Failed to parse lockfile YAML at ${lockfilePath}`,
+            cause: error,
+            retryable: false,
+        }),
+    });
+    return yield* decodeLockfile(parsed);
+});
+/**
+ * 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 const writeLockfile = (axmDir, lockfile) => Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    const path = yield* Path.Path;
+    const lockfilePath = path.join(axmDir, LOCKFILE_NAME);
+    // Ensure directory exists
+    yield* fs.makeDirectory(axmDir, { recursive: true }).pipe(Effect.mapError((error) => new LockfileWriteError({
+        message: `Failed to create directory ${axmDir}`,
+        cause: error,
+        retryable: false,
+    })));
+    // Encode Dates to ISO strings for YAML serialization
+    const encoded = yield* Effect.try({
+        try: () => Schema.encodeSync(LockfileSchema)(lockfile),
+        catch: (error) => new LockfileWriteError({
+            message: "Failed to encode lockfile",
+            cause: error,
+            retryable: false,
+        }),
+    });
+    // Convert to YAML
+    const yamlContent = yield* Effect.try({
+        try: () => YAML.stringify(encoded),
+        catch: (error) => new LockfileWriteError({
+            message: "Failed to serialize lockfile to YAML",
+            cause: error,
+            retryable: false,
+        }),
+    });
+    // Write file
+    yield* fs.writeFileString(lockfilePath, yamlContent).pipe(Effect.mapError((error) => new LockfileWriteError({
+        message: `Failed to write lockfile at ${lockfilePath}`,
+        cause: error,
+        retryable: false,
+    })));
+});
+//# sourceMappingURL=lockfile.js.map

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

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

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

@@ -0,0 +1,400 @@
+/**
+ * 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";
+/**
+ * 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 declare const DateFromString: Schema.transform<typeof Schema.String, typeof Schema.DateFromSelf>;
+/**
+ * GitHub source - skill from a GitHub repository.
+ * Required: owner, repo
+ * Optional: ref, path
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const GitHubLockEntrySchema: Schema.Struct<{
+    agents: Schema.Array$<typeof Schema.String>;
+    installedAt: Schema.transform<typeof Schema.String, typeof Schema.DateFromSelf>;
+    updatedAt: Schema.transform<typeof Schema.String, typeof Schema.DateFromSelf>;
+    gitTreeHash: Schema.optional<typeof Schema.String>;
+    type: Schema.Literal<["github"]>;
+    owner: typeof Schema.String;
+    repo: typeof Schema.String;
+    ref: Schema.optional<typeof Schema.String>;
+    path: Schema.optional<typeof Schema.String>;
+}>;
+/**
+ * GitLab source - skill from a GitLab repository.
+ * Required: owner, repo
+ * Optional: ref, path
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const GitLabLockEntrySchema: Schema.Struct<{
+    agents: Schema.Array$<typeof Schema.String>;
+    installedAt: Schema.transform<typeof Schema.String, typeof Schema.DateFromSelf>;
+    updatedAt: Schema.transform<typeof Schema.String, typeof Schema.DateFromSelf>;
+    gitTreeHash: Schema.optional<typeof Schema.String>;
+    type: Schema.Literal<["gitlab"]>;
+    owner: typeof Schema.String;
+    repo: typeof Schema.String;
+    ref: Schema.optional<typeof Schema.String>;
+    path: Schema.optional<typeof Schema.String>;
+}>;
+/**
+ * Bitbucket source - skill from a Bitbucket repository.
+ * Required: owner, repo
+ * Optional: ref, path
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const BitbucketLockEntrySchema: Schema.Struct<{
+    agents: Schema.Array$<typeof Schema.String>;
+    installedAt: Schema.transform<typeof Schema.String, typeof Schema.DateFromSelf>;
+    updatedAt: Schema.transform<typeof Schema.String, typeof Schema.DateFromSelf>;
+    gitTreeHash: Schema.optional<typeof Schema.String>;
+    type: Schema.Literal<["bitbucket"]>;
+    owner: typeof Schema.String;
+    repo: typeof Schema.String;
+    ref: Schema.optional<typeof Schema.String>;
+    path: Schema.optional<typeof Schema.String>;
+}>;
+/**
+ * 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 declare const AzureReposLockEntrySchema: Schema.Struct<{
+    agents: Schema.Array$<typeof Schema.String>;
+    installedAt: Schema.transform<typeof Schema.String, typeof Schema.DateFromSelf>;
+    updatedAt: Schema.transform<typeof Schema.String, typeof Schema.DateFromSelf>;
+    gitTreeHash: Schema.optional<typeof Schema.String>;
+    type: Schema.Literal<["azurerepos"]>;
+    organization: typeof Schema.String;
+    project: typeof Schema.String;
+    repo: typeof Schema.String;
+    ref: Schema.optional<typeof Schema.String>;
+    path: Schema.optional<typeof Schema.String>;
+}>;
+/**
+ * Git source - skill from a generic git repository.
+ * Required: url
+ * Optional: ref, path
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const GitLockEntrySchema: Schema.Struct<{
+    agents: Schema.Array$<typeof Schema.String>;
+    installedAt: Schema.transform<typeof Schema.String, typeof Schema.DateFromSelf>;
+    updatedAt: Schema.transform<typeof Schema.String, typeof Schema.DateFromSelf>;
+    gitTreeHash: Schema.optional<typeof Schema.String>;
+    type: Schema.Literal<["git"]>;
+    url: typeof Schema.String;
+    ref: Schema.optional<typeof Schema.String>;
+    path: Schema.optional<typeof Schema.String>;
+}>;
+/**
+ * Local source - skill from a local filesystem path.
+ * Required: path
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const LocalLockEntrySchema: Schema.Struct<{
+    agents: Schema.Array$<typeof Schema.String>;
+    installedAt: Schema.transform<typeof Schema.String, typeof Schema.DateFromSelf>;
+    updatedAt: Schema.transform<typeof Schema.String, typeof Schema.DateFromSelf>;
+    gitTreeHash: Schema.optional<typeof Schema.String>;
+    type: Schema.Literal<["local"]>;
+    path: typeof Schema.String;
+}>;
+/**
+ * Registry source - skill from a registry.
+ * Required: scope, name, resolvedVersion, checksum, sourceName
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const RegistryLockEntrySchema: Schema.Struct<{
+    agents: Schema.Array$<typeof Schema.String>;
+    installedAt: Schema.transform<typeof Schema.String, typeof Schema.DateFromSelf>;
+    updatedAt: Schema.transform<typeof Schema.String, typeof Schema.DateFromSelf>;
+    gitTreeHash: Schema.optional<typeof Schema.String>;
+    type: Schema.Literal<["registry"]>;
+    scope: typeof Schema.String;
+    name: typeof Schema.String;
+    resolvedVersion: typeof Schema.String;
+    checksum: typeof Schema.String;
+    sourceName: typeof Schema.String;
+}>;
+/**
+ * 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 declare const SkillLockEntrySchema: Schema.Union<[Schema.Struct<{
+    agents: Schema.Array$<typeof Schema.String>;
+    installedAt: Schema.transform<typeof Schema.String, typeof Schema.DateFromSelf>;
+    updatedAt: Schema.transform<typeof Schema.String, typeof Schema.DateFromSelf>;
+    gitTreeHash: Schema.optional<typeof Schema.String>;
+    type: Schema.Literal<["github"]>;
+    owner: typeof Schema.String;
+    repo: typeof Schema.String;
+    ref: Schema.optional<typeof Schema.String>;
+    path: Schema.optional<typeof Schema.String>;
+}>, Schema.Struct<{
+    agents: Schema.Array$<typeof Schema.String>;
+    installedAt: Schema.transform<typeof Schema.String, typeof Schema.DateFromSelf>;
+    updatedAt: Schema.transform<typeof Schema.String, typeof Schema.DateFromSelf>;
+    gitTreeHash: Schema.optional<typeof Schema.String>;
+    type: Schema.Literal<["gitlab"]>;
+    owner: typeof Schema.String;
+    repo: typeof Schema.String;
+    ref: Schema.optional<typeof Schema.String>;
+    path: Schema.optional<typeof Schema.String>;
+}>, Schema.Struct<{
+    agents: Schema.Array$<typeof Schema.String>;
+    installedAt: Schema.transform<typeof Schema.String, typeof Schema.DateFromSelf>;
+    updatedAt: Schema.transform<typeof Schema.String, typeof Schema.DateFromSelf>;
+    gitTreeHash: Schema.optional<typeof Schema.String>;
+    type: Schema.Literal<["bitbucket"]>;
+    owner: typeof Schema.String;
+    repo: typeof Schema.String;
+    ref: Schema.optional<typeof Schema.String>;
+    path: Schema.optional<typeof Schema.String>;
+}>, Schema.Struct<{
+    agents: Schema.Array$<typeof Schema.String>;
+    installedAt: Schema.transform<typeof Schema.String, typeof Schema.DateFromSelf>;
+    updatedAt: Schema.transform<typeof Schema.String, typeof Schema.DateFromSelf>;
+    gitTreeHash: Schema.optional<typeof Schema.String>;
+    type: Schema.Literal<["azurerepos"]>;
+    organization: typeof Schema.String;
+    project: typeof Schema.String;
+    repo: typeof Schema.String;
+    ref: Schema.optional<typeof Schema.String>;
+    path: Schema.optional<typeof Schema.String>;
+}>, Schema.Struct<{
+    agents: Schema.Array$<typeof Schema.String>;
+    installedAt: Schema.transform<typeof Schema.String, typeof Schema.DateFromSelf>;
+    updatedAt: Schema.transform<typeof Schema.String, typeof Schema.DateFromSelf>;
+    gitTreeHash: Schema.optional<typeof Schema.String>;
+    type: Schema.Literal<["git"]>;
+    url: typeof Schema.String;
+    ref: Schema.optional<typeof Schema.String>;
+    path: Schema.optional<typeof Schema.String>;
+}>, Schema.Struct<{
+    agents: Schema.Array$<typeof Schema.String>;
+    installedAt: Schema.transform<typeof Schema.String, typeof Schema.DateFromSelf>;
+    updatedAt: Schema.transform<typeof Schema.String, typeof Schema.DateFromSelf>;
+    gitTreeHash: Schema.optional<typeof Schema.String>;
+    type: Schema.Literal<["local"]>;
+    path: typeof Schema.String;
+}>, Schema.Struct<{
+    agents: Schema.Array$<typeof Schema.String>;
+    installedAt: Schema.transform<typeof Schema.String, typeof Schema.DateFromSelf>;
+    updatedAt: Schema.transform<typeof Schema.String, typeof Schema.DateFromSelf>;
+    gitTreeHash: Schema.optional<typeof Schema.String>;
+    type: Schema.Literal<["registry"]>;
+    scope: typeof Schema.String;
+    name: typeof Schema.String;
+    resolvedVersion: typeof Schema.String;
+    checksum: typeof Schema.String;
+    sourceName: typeof Schema.String;
+}>]>;
+/**
+ * Inferred type for SkillLockEntry schema.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export type SkillLockEntry = typeof SkillLockEntrySchema.Type;
+/**
+ * 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 declare const SkillsLockMapSchema: Schema.Record$<typeof Schema.String, Schema.Union<[Schema.Struct<{
+    agents: Schema.Array$<typeof Schema.String>;
+    installedAt: Schema.transform<typeof Schema.String, typeof Schema.DateFromSelf>;
+    updatedAt: Schema.transform<typeof Schema.String, typeof Schema.DateFromSelf>;
+    gitTreeHash: Schema.optional<typeof Schema.String>;
+    type: Schema.Literal<["github"]>;
+    owner: typeof Schema.String;
+    repo: typeof Schema.String;
+    ref: Schema.optional<typeof Schema.String>;
+    path: Schema.optional<typeof Schema.String>;
+}>, Schema.Struct<{
+    agents: Schema.Array$<typeof Schema.String>;
+    installedAt: Schema.transform<typeof Schema.String, typeof Schema.DateFromSelf>;
+    updatedAt: Schema.transform<typeof Schema.String, typeof Schema.DateFromSelf>;
+    gitTreeHash: Schema.optional<typeof Schema.String>;
+    type: Schema.Literal<["gitlab"]>;
+    owner: typeof Schema.String;
+    repo: typeof Schema.String;
+    ref: Schema.optional<typeof Schema.String>;
+    path: Schema.optional<typeof Schema.String>;
+}>, Schema.Struct<{
+    agents: Schema.Array$<typeof Schema.String>;
+    installedAt: Schema.transform<typeof Schema.String, typeof Schema.DateFromSelf>;
+    updatedAt: Schema.transform<typeof Schema.String, typeof Schema.DateFromSelf>;
+    gitTreeHash: Schema.optional<typeof Schema.String>;
+    type: Schema.Literal<["bitbucket"]>;
+    owner: typeof Schema.String;
+    repo: typeof Schema.String;
+    ref: Schema.optional<typeof Schema.String>;
+    path: Schema.optional<typeof Schema.String>;
+}>, Schema.Struct<{
+    agents: Schema.Array$<typeof Schema.String>;
+    installedAt: Schema.transform<typeof Schema.String, typeof Schema.DateFromSelf>;
+    updatedAt: Schema.transform<typeof Schema.String, typeof Schema.DateFromSelf>;
+    gitTreeHash: Schema.optional<typeof Schema.String>;
+    type: Schema.Literal<["azurerepos"]>;
+    organization: typeof Schema.String;
+    project: typeof Schema.String;
+    repo: typeof Schema.String;
+    ref: Schema.optional<typeof Schema.String>;
+    path: Schema.optional<typeof Schema.String>;
+}>, Schema.Struct<{
+    agents: Schema.Array$<typeof Schema.String>;
+    installedAt: Schema.transform<typeof Schema.String, typeof Schema.DateFromSelf>;
+    updatedAt: Schema.transform<typeof Schema.String, typeof Schema.DateFromSelf>;
+    gitTreeHash: Schema.optional<typeof Schema.String>;
+    type: Schema.Literal<["git"]>;
+    url: typeof Schema.String;
+    ref: Schema.optional<typeof Schema.String>;
+    path: Schema.optional<typeof Schema.String>;
+}>, Schema.Struct<{
+    agents: Schema.Array$<typeof Schema.String>;
+    installedAt: Schema.transform<typeof Schema.String, typeof Schema.DateFromSelf>;
+    updatedAt: Schema.transform<typeof Schema.String, typeof Schema.DateFromSelf>;
+    gitTreeHash: Schema.optional<typeof Schema.String>;
+    type: Schema.Literal<["local"]>;
+    path: typeof Schema.String;
+}>, Schema.Struct<{
+    agents: Schema.Array$<typeof Schema.String>;
+    installedAt: Schema.transform<typeof Schema.String, typeof Schema.DateFromSelf>;
+    updatedAt: Schema.transform<typeof Schema.String, typeof Schema.DateFromSelf>;
+    gitTreeHash: Schema.optional<typeof Schema.String>;
+    type: Schema.Literal<["registry"]>;
+    scope: typeof Schema.String;
+    name: typeof Schema.String;
+    resolvedVersion: typeof Schema.String;
+    checksum: typeof Schema.String;
+    sourceName: typeof Schema.String;
+}>]>>;
+/**
+ * Inferred type for SkillsLockMap schema.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export type SkillsLockMap = typeof SkillsLockMapSchema.Type;
+/**
+ * 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 declare const LockfileSchema: Schema.Struct<{
+    lockfileVersion: typeof Schema.Number;
+    skills: Schema.Record$<typeof Schema.String, Schema.Union<[Schema.Struct<{
+        agents: Schema.Array$<typeof Schema.String>;
+        installedAt: Schema.transform<typeof Schema.String, typeof Schema.DateFromSelf>;
+        updatedAt: Schema.transform<typeof Schema.String, typeof Schema.DateFromSelf>;
+        gitTreeHash: Schema.optional<typeof Schema.String>;
+        type: Schema.Literal<["github"]>;
+        owner: typeof Schema.String;
+        repo: typeof Schema.String;
+        ref: Schema.optional<typeof Schema.String>;
+        path: Schema.optional<typeof Schema.String>;
+    }>, Schema.Struct<{
+        agents: Schema.Array$<typeof Schema.String>;
+        installedAt: Schema.transform<typeof Schema.String, typeof Schema.DateFromSelf>;
+        updatedAt: Schema.transform<typeof Schema.String, typeof Schema.DateFromSelf>;
+        gitTreeHash: Schema.optional<typeof Schema.String>;
+        type: Schema.Literal<["gitlab"]>;
+        owner: typeof Schema.String;
+        repo: typeof Schema.String;
+        ref: Schema.optional<typeof Schema.String>;
+        path: Schema.optional<typeof Schema.String>;
+    }>, Schema.Struct<{
+        agents: Schema.Array$<typeof Schema.String>;
+        installedAt: Schema.transform<typeof Schema.String, typeof Schema.DateFromSelf>;
+        updatedAt: Schema.transform<typeof Schema.String, typeof Schema.DateFromSelf>;
+        gitTreeHash: Schema.optional<typeof Schema.String>;
+        type: Schema.Literal<["bitbucket"]>;
+        owner: typeof Schema.String;
+        repo: typeof Schema.String;
+        ref: Schema.optional<typeof Schema.String>;
+        path: Schema.optional<typeof Schema.String>;
+    }>, Schema.Struct<{
+        agents: Schema.Array$<typeof Schema.String>;
+        installedAt: Schema.transform<typeof Schema.String, typeof Schema.DateFromSelf>;
+        updatedAt: Schema.transform<typeof Schema.String, typeof Schema.DateFromSelf>;
+        gitTreeHash: Schema.optional<typeof Schema.String>;
+        type: Schema.Literal<["azurerepos"]>;
+        organization: typeof Schema.String;
+        project: typeof Schema.String;
+        repo: typeof Schema.String;
+        ref: Schema.optional<typeof Schema.String>;
+        path: Schema.optional<typeof Schema.String>;
+    }>, Schema.Struct<{
+        agents: Schema.Array$<typeof Schema.String>;
+        installedAt: Schema.transform<typeof Schema.String, typeof Schema.DateFromSelf>;
+        updatedAt: Schema.transform<typeof Schema.String, typeof Schema.DateFromSelf>;
+        gitTreeHash: Schema.optional<typeof Schema.String>;
+        type: Schema.Literal<["git"]>;
+        url: typeof Schema.String;
+        ref: Schema.optional<typeof Schema.String>;
+        path: Schema.optional<typeof Schema.String>;
+    }>, Schema.Struct<{
+        agents: Schema.Array$<typeof Schema.String>;
+        installedAt: Schema.transform<typeof Schema.String, typeof Schema.DateFromSelf>;
+        updatedAt: Schema.transform<typeof Schema.String, typeof Schema.DateFromSelf>;
+        gitTreeHash: Schema.optional<typeof Schema.String>;
+        type: Schema.Literal<["local"]>;
+        path: typeof Schema.String;
+    }>, Schema.Struct<{
+        agents: Schema.Array$<typeof Schema.String>;
+        installedAt: Schema.transform<typeof Schema.String, typeof Schema.DateFromSelf>;
+        updatedAt: Schema.transform<typeof Schema.String, typeof Schema.DateFromSelf>;
+        gitTreeHash: Schema.optional<typeof Schema.String>;
+        type: Schema.Literal<["registry"]>;
+        scope: typeof Schema.String;
+        name: typeof Schema.String;
+        resolvedVersion: typeof Schema.String;
+        checksum: typeof Schema.String;
+        sourceName: typeof Schema.String;
+    }>]>>;
+}>;
+/**
+ * Inferred type for Lockfile schema.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export type Lockfile = typeof LockfileSchema.Type;
+//# sourceMappingURL=schema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/lockfile/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAMxC;;;;;GAKG;AACH,eAAO,MAAM,cAAc,oEAGzB,CAAC;AAgBH;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;EAOhC,CAAC;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;EAOhC,CAAC;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;EAOnC,CAAC;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;;EAQpC,CAAC;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;EAM7B,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB;;;;;;;EAI/B,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;EAQlC,CAAC;AAMH;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAQhC,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG,OAAO,oBAAoB,CAAC,IAAI,CAAC;AAM9D;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAG9B,CAAC;AAEH;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,mBAAmB,CAAC,IAAI,CAAC;AAM5D;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAGzB,CAAC;AAEH;;;;GAIG;AACH,MAAM,MAAM,QAAQ,GAAG,OAAO,cAAc,CAAC,IAAI,CAAC"}