@agentxm/client-core 0.1.6

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

@@ -0,0 +1,85 @@
+/**
+ * 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
+ * - dependencies: Optional map of `@owner/type/name` to semver range
+ * - integrity: SRI integrity string in `sha512-<base64>` format
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const VersionEntrySchema: Schema.Struct<{
+    readonly version: Schema.brand<Schema.String, "ExactSemverVersion">;
+    readonly published: Schema.String;
+    readonly dependencies: Schema.optional<Schema.$Record<Schema.String, Schema.brand<Schema.String, "VersionConstraint">>>;
+    readonly compatiblePackages: Schema.optional<Schema.$Array<Schema.decodeTo<Schema.toType<Schema.Struct<{
+        readonly type: Schema.brand<Schema.String, "PackageType">;
+        readonly namespace: Schema.optional<Schema.String>;
+        readonly name: Schema.String;
+        readonly version: Schema.optional<Schema.String>;
+    }>>, Schema.String, never, never>>>;
+    readonly integrity: Schema.String;
+}>;
+/**
+ * Inferred type for VersionEntry schema.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export type VersionEntry = Schema.Schema.Type<typeof VersionEntrySchema>;
+/**
+ * Extension index metadata describing a published extension in the registry.
+ *
+ * Fields:
+ * - name: Extension name without owner
+ * - owner: Owner namespace including `@` prefix (e.g., "@acme")
+ * - type: Extension type ("skill", "mcp-server", or "pack")
+ * - 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<{
+    readonly name: Schema.brand<Schema.String, "ExtensionName">;
+    readonly owner: Schema.brand<Schema.String, "Handle">;
+    readonly type: Schema.Literals<readonly ["skill", "command", "mcp-server", "subagent", "file", "rule", "pack"]>;
+    readonly description: Schema.optional<Schema.String>;
+    readonly repository: Schema.optional<Schema.String>;
+    readonly license: Schema.optional<Schema.String>;
+    readonly authors: Schema.optional<Schema.$Array<Schema.Struct<{
+        readonly name: Schema.String;
+        readonly email: Schema.optional<Schema.String>;
+        readonly url: Schema.optional<Schema.String>;
+    }>>>;
+    readonly versions: Schema.$Array<Schema.Struct<{
+        readonly version: Schema.brand<Schema.String, "ExactSemverVersion">;
+        readonly published: Schema.String;
+        readonly dependencies: Schema.optional<Schema.$Record<Schema.String, Schema.brand<Schema.String, "VersionConstraint">>>;
+        readonly compatiblePackages: Schema.optional<Schema.$Array<Schema.decodeTo<Schema.toType<Schema.Struct<{
+            readonly type: Schema.brand<Schema.String, "PackageType">;
+            readonly namespace: Schema.optional<Schema.String>;
+            readonly name: Schema.String;
+            readonly version: Schema.optional<Schema.String>;
+        }>>, Schema.String, never, never>>>;
+        readonly integrity: Schema.String;
+    }>>;
+}>;
+/**
+ * Inferred type for ExtensionIndex schema.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export type ExtensionIndex = Schema.Schema.Type<typeof ExtensionIndexSchema>;
+//# sourceMappingURL=schema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../../src/unstable/registry/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAgBxC;;;;;;;;;;GAUG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;EAU7B,CAAC;AAEH;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAMzE;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;EAa/B,CAAC;AAEH;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,oBAAoB,CAAC,CAAC"}

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

@@ -0,0 +1,73 @@
+/**
+ * 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 { IsoDateTimeStringSchema } from "../date-time.js";
+import { AuthorSchema, ExtensionDependencyConstraintMapSchema, ExtensionTypeSchema, } from "../extensions/index.js";
+import { ExtensionNameSchema } from "../extensions/common.js";
+import { HandleSchema } from "../extensions/handle.js";
+import { PackageUrlSchema } from "../packaging/package-url.js";
+import { ExactSemverVersionSchema } from "../version-constraints/version-constraints.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
+ * - dependencies: Optional map of `@owner/type/name` to semver range
+ * - integrity: SRI integrity string in `sha512-<base64>` format
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const VersionEntrySchema = Schema.Struct({
+    version: ExactSemverVersionSchema,
+    published: IsoDateTimeStringSchema,
+    dependencies: Schema.optional(ExtensionDependencyConstraintMapSchema),
+    compatiblePackages: Schema.optional(Schema.Array(PackageUrlSchema)),
+    integrity: Schema.String,
+}).annotate({
+    identifier: "VersionEntry",
+    title: "Version Entry",
+    description: "A single published version of an extension in the registry.",
+});
+// =============================================================================
+// Extension Index
+// =============================================================================
+/**
+ * Extension index metadata describing a published extension in the registry.
+ *
+ * Fields:
+ * - name: Extension name without owner
+ * - owner: Owner namespace including `@` prefix (e.g., "@acme")
+ * - type: Extension type ("skill", "mcp-server", or "pack")
+ * - 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: ExtensionNameSchema,
+    owner: HandleSchema,
+    type: ExtensionTypeSchema,
+    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),
+}).annotate({
+    identifier: "ExtensionIndex",
+    title: "Extension Index",
+    description: "Registry metadata describing a published extension and its available versions.",
+});
+//# sourceMappingURL=schema.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../../src/unstable/registry/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EACL,YAAY,EACZ,sCAAsC,EACtC,mBAAmB,GACpB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,wBAAwB,EAAE,MAAM,+CAA+C,CAAC;AAEzF,gFAAgF;AAChF,gBAAgB;AAChB,gFAAgF;AAEhF;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC,MAAM,CAAC;IAC9C,OAAO,EAAE,wBAAwB;IACjC,SAAS,EAAE,uBAAuB;IAClC,YAAY,EAAE,MAAM,CAAC,QAAQ,CAAC,sCAAsC,CAAC;IACrE,kBAAkB,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;IACnE,SAAS,EAAE,MAAM,CAAC,MAAM;CACzB,CAAC,CAAC,QAAQ,CAAC;IACV,UAAU,EAAE,cAAc;IAC1B,KAAK,EAAE,eAAe;IACtB,WAAW,EAAE,6DAA6D;CAC3E,CAAC,CAAC;AASH,gFAAgF;AAChF,kBAAkB;AAClB,gFAAgF;AAEhF;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,MAAM,CAAC,MAAM,CAAC;IAChD,IAAI,EAAE,mBAAmB;IACzB,KAAK,EAAE,YAAY;IACnB,IAAI,EAAE,mBAAmB;IACzB,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,QAAQ,CAAC;IACV,UAAU,EAAE,gBAAgB;IAC5B,KAAK,EAAE,iBAAiB;IACxB,WAAW,EAAE,gFAAgF;CAC9F,CAAC,CAAC"}

package/dist/src/unstable/registry/utils.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Registry utility functions extracted from sources/providers/registry.ts.
+ *
+ * Shared helpers for registry operations: version selection, integrity
+ * computation, zip extraction, type pluralization, and path building.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import * as FileSystem from "effect/FileSystem";
+import * as Path from "effect/Path";
+import * as Effect from "effect/Effect";
+import * as Option from "effect/Option";
+import type { Handle } from "../extensions/handle.js";
+import { type ExtensionType } from "../extensions/index.js";
+import type { VersionEntry } from "./schema.js";
+/**
+ * Select the best matching version from a list of versions.
+ *
+ * Returns the first version (newest first).
+ */
+export declare const selectVersion: (versions: ReadonlyArray<VersionEntry>) => Option.Option<VersionEntry>;
+export declare const resolveVersionEntry: (versions: ReadonlyArray<VersionEntry>, versionConstraint: Option.Option<string>) => Option.Option<VersionEntry>;
+/** Pluralize extension type for directory segments. */
+export declare const pluralizeType: (type: ExtensionType) => string;
+/** Build the path to an extension's directory within a registry. */
+export declare const extensionDir: (registryRoot: string, owner: Handle, type: ExtensionType, name: string, join: (...parts: readonly string[]) => string) => string;
+/**
+ * Extract a zip archive to a target directory.
+ * Uses fflate for in-memory decompression (portable across platforms).
+ */
+export declare const extractZip: (archive: Uint8Array, targetDir: string) => Effect.Effect<void, import("../app-error/app-error.ts").AppError, FileSystem.FileSystem | Path.Path>;
+//# sourceMappingURL=utils.d.ts.map

package/dist/src/unstable/registry/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../src/unstable/registry/utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AACpC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAGxC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAEtD,OAAO,EAAyB,KAAK,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACnF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAMhD;;;;GAIG;AACH,eAAO,MAAM,aAAa,GACxB,UAAU,aAAa,CAAC,YAAY,CAAC,KACpC,MAAM,CAAC,MAAM,CAAC,YAAY,CAI5B,CAAC;AAEF,eAAO,MAAM,mBAAmB,GAC9B,UAAU,aAAa,CAAC,YAAY,CAAC,EACrC,mBAAmB,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,KACvC,MAAM,CAAC,MAAM,CAAC,YAAY,CAa5B,CAAC;AAMF,uDAAuD;AACvD,eAAO,MAAM,aAAa,GAAI,MAAM,aAAa,KAAG,MAAqC,CAAC;AAM1F,oEAAoE;AACpE,eAAO,MAAM,YAAY,GACvB,cAAc,MAAM,EACpB,OAAO,MAAM,EACb,MAAM,aAAa,EACnB,MAAM,MAAM,EACZ,MAAM,CAAC,GAAG,KAAK,EAAE,SAAS,MAAM,EAAE,KAAK,MAAM,KAC5C,MAA4E,CAAC;AAMhF;;;GAGG;AACH,eAAO,MAAM,UAAU,GAAI,SAAS,UAAU,EAAE,WAAW,MAAM,yGA4D7D,CAAC"}

package/dist/src/unstable/registry/utils.js

@@ -0,0 +1,98 @@
+/**
+ * Registry utility functions extracted from sources/providers/registry.ts.
+ *
+ * Shared helpers for registry operations: version selection, integrity
+ * computation, zip extraction, type pluralization, and path building.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import { unzipSync } from "fflate";
+import * as FileSystem from "effect/FileSystem";
+import * as Path from "effect/Path";
+import * as Effect from "effect/Effect";
+import * as Option from "effect/Option";
+import { makeAppError } from "../app-error/index.js";
+import { resolveVersionWithConstraint } from "../version-constraints/version-constraints.js";
+import { toExtensionTypePlural } from "../extensions/index.js";
+// -----------------------------------------------------------------------------
+// Version Selection
+// -----------------------------------------------------------------------------
+/**
+ * Select the best matching version from a list of versions.
+ *
+ * Returns the first version (newest first).
+ */
+export const selectVersion = (versions) => {
+    if (versions.length === 0)
+        return Option.none();
+    const [latest] = versions;
+    return latest === undefined ? Option.none() : Option.some(latest);
+};
+export const resolveVersionEntry = (versions, versionConstraint) => {
+    if (Option.isNone(versionConstraint)) {
+        return selectVersion(versions);
+    }
+    const resolved = resolveVersionWithConstraint(versions, versionConstraint);
+    if (Option.isNone(resolved)) {
+        return Option.none();
+    }
+    return Option.fromUndefinedOr(versions.find((candidate) => candidate.version === resolved.value.version));
+};
+// -----------------------------------------------------------------------------
+// Type Pluralization
+// -----------------------------------------------------------------------------
+/** Pluralize extension type for directory segments. */
+export const pluralizeType = (type) => toExtensionTypePlural(type);
+// -----------------------------------------------------------------------------
+// Extension Directory
+// -----------------------------------------------------------------------------
+/** Build the path to an extension's directory within a registry. */
+export const extensionDir = (registryRoot, owner, type, name, join) => join(registryRoot, "extensions", owner, pluralizeType(type), name);
+// -----------------------------------------------------------------------------
+// Zip Extraction
+// -----------------------------------------------------------------------------
+/**
+ * Extract a zip archive to a target directory.
+ * Uses fflate for in-memory decompression (portable across platforms).
+ */
+export const extractZip = (archive, targetDir) => Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    const path = yield* Path.Path;
+    // Decompress zip archive in memory
+    const entries = yield* Effect.try({
+        try: () => unzipSync(archive),
+        catch: (e) => makeAppError({
+            code: "SOURCE_FETCH_FAILED",
+            what: "Failed to decompress zip archive",
+            cause: e,
+        }),
+    });
+    // Write each entry to the target directory
+    yield* Effect.forEach(Object.entries(entries), ([name, data]) => Effect.gen(function* () {
+        const fullPath = path.join(targetDir, name);
+        // Directory entries end with '/'
+        if (name.endsWith("/")) {
+            yield* fs.makeDirectory(fullPath, { recursive: true }).pipe(Effect.mapError((e) => makeAppError({
+                code: "SOURCE_FETCH_FAILED",
+                what: `Failed to create directory: ${name}`,
+                cause: e,
+            })));
+        }
+        else {
+            // Ensure parent directory exists
+            const parentDir = path.dirname(fullPath);
+            yield* fs.makeDirectory(parentDir, { recursive: true }).pipe(Effect.mapError((e) => makeAppError({
+                code: "SOURCE_FETCH_FAILED",
+                what: `Failed to create parent directory for: ${name}`,
+                cause: e,
+            })));
+            yield* fs.writeFile(fullPath, data).pipe(Effect.mapError((e) => makeAppError({
+                code: "SOURCE_FETCH_FAILED",
+                what: `Failed to write file: ${name}`,
+                cause: e,
+            })));
+        }
+    }), { concurrency: 1 });
+});
+//# sourceMappingURL=utils.js.map

package/dist/src/unstable/registry/utils.js.map

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

package/dist/src/unstable/schema/format-issues.d.ts

@@ -0,0 +1,13 @@
+import * as SchemaIssue from "effect/SchemaIssue";
+/**
+ * Format a schema validation issue into human-readable lines with dot-notation
+ * paths.
+ *
+ * Each line has the form `"path.to.field: message"` for issues with a path, or
+ * just `"message"` for root-level issues. The result is capped at `maxIssues`
+ * lines (default 5).
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const formatSchemaIssuesToLines: (issue: SchemaIssue.Issue, maxIssues?: number) => ReadonlyArray<string>;
+//# sourceMappingURL=format-issues.d.ts.map

package/dist/src/unstable/schema/format-issues.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-issues.d.ts","sourceRoot":"","sources":["../../../../src/unstable/schema/format-issues.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,WAAW,MAAM,oBAAoB,CAAC;AAIlD;;;;;;;;;GASG;AACH,eAAO,MAAM,yBAAyB,GACpC,OAAO,WAAW,CAAC,KAAK,EACxB,YAAW,MAA2B,KACrC,aAAa,CAAC,MAAM,CAmBtB,CAAC"}

package/dist/src/unstable/schema/format-issues.js

@@ -0,0 +1,34 @@
+import * as SchemaIssue from "effect/SchemaIssue";
+const DEFAULT_MAX_ISSUES = 5;
+/**
+ * Format a schema validation issue into human-readable lines with dot-notation
+ * paths.
+ *
+ * Each line has the form `"path.to.field: message"` for issues with a path, or
+ * just `"message"` for root-level issues. The result is capped at `maxIssues`
+ * lines (default 5).
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const formatSchemaIssuesToLines = (issue, maxIssues = DEFAULT_MAX_ISSUES) => {
+    const formatter = SchemaIssue.makeFormatterStandardSchemaV1();
+    const { issues } = formatter(issue);
+    const lines = [];
+    for (const item of issues) {
+        const path = item.path;
+        if (path !== undefined && path.length > 0) {
+            const segments = path.map((segment) => {
+                if (typeof segment === "object" && segment !== null && "key" in segment) {
+                    return String(segment.key);
+                }
+                return String(segment);
+            });
+            lines.push(`${segments.join(".")}: ${item.message}`);
+        }
+        else {
+            lines.push(item.message);
+        }
+    }
+    return lines.slice(0, maxIssues);
+};
+//# sourceMappingURL=format-issues.js.map

package/dist/src/unstable/schema/format-issues.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-issues.js","sourceRoot":"","sources":["../../../../src/unstable/schema/format-issues.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,WAAW,MAAM,oBAAoB,CAAC;AAElD,MAAM,kBAAkB,GAAG,CAAC,CAAC;AAE7B;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CACvC,KAAwB,EACxB,YAAoB,kBAAkB,EACf,EAAE;IACzB,MAAM,SAAS,GAAG,WAAW,CAAC,6BAA6B,EAAE,CAAC;IAC9D,MAAM,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;IACpC,MAAM,KAAK,GAAkB,EAAE,CAAC;IAChC,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;QAC1B,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACvB,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1C,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE;gBACpC,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,IAAI,KAAK,IAAI,OAAO,EAAE,CAAC;oBACxE,OAAO,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;gBAC7B,CAAC;gBACD,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC;YACzB,CAAC,CAAC,CAAC;YACH,KAAK,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QACvD,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;AACnC,CAAC,CAAC"}

package/dist/src/unstable/schema/index.d.ts

@@ -0,0 +1,4 @@
+export type { JsonFileReadResult } from "./types.js";
+export { formatSchemaIssuesToLines } from "./format-issues.js";
+export { readAndValidateJsonFile } from "./read-and-validate-json-file.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/unstable/schema/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/unstable/schema/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC"}

package/dist/src/unstable/schema/index.js

@@ -0,0 +1,3 @@
+export { formatSchemaIssuesToLines } from "./format-issues.js";
+export { readAndValidateJsonFile } from "./read-and-validate-json-file.js";
+//# sourceMappingURL=index.js.map

package/dist/src/unstable/schema/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/unstable/schema/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC"}

package/dist/src/unstable/schema/read-and-validate-json-file.d.ts

@@ -0,0 +1,20 @@
+import * as Effect from "effect/Effect";
+import * as FileSystem from "effect/FileSystem";
+import * as Schema from "effect/Schema";
+import type { JsonFileReadResult } from "./types.js";
+/**
+ * Read a JSON file, parse it, and validate it against a schema.
+ *
+ * Returns a {@link JsonFileReadResult} discriminated union so callers can
+ * decide how to present each failure mode (missing file, I/O error, malformed
+ * JSON, schema mismatch) without catching exceptions.
+ *
+ * @param filePath - Absolute path to the JSON file.
+ * @param schema   - Effect Schema to validate the parsed JSON against.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const readAndValidateJsonFile: <S extends Schema.Top>(filePath: string, schema: S, options?: {
+    readonly maxSchemaIssues?: number;
+}) => Effect.Effect<JsonFileReadResult<S["Type"]>, never, FileSystem.FileSystem | S["DecodingServices"]>;
+//# sourceMappingURL=read-and-validate-json-file.d.ts.map

package/dist/src/unstable/schema/read-and-validate-json-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-and-validate-json-file.d.ts","sourceRoot":"","sources":["../../../../src/unstable/schema/read-and-validate-json-file.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAEhD,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAsBrD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,uBAAuB,GAAI,CAAC,SAAS,MAAM,CAAC,GAAG,EAC1D,UAAU,MAAM,EAChB,QAAQ,CAAC,EACT,UAAU;IAAE,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CAAE,KAC9C,MAAM,CAAC,MAAM,CACd,kBAAkB,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,EAC7B,KAAK,EACL,UAAU,CAAC,UAAU,GAAG,CAAC,CAAC,kBAAkB,CAAC,CAwD3C,CAAC"}

package/dist/src/unstable/schema/read-and-validate-json-file.js

@@ -0,0 +1,85 @@
+import * as Effect from "effect/Effect";
+import * as FileSystem from "effect/FileSystem";
+import * as Option from "effect/Option";
+import * as Schema from "effect/Schema";
+import { formatSchemaIssuesToLines } from "./format-issues.js";
+/**
+ * Extract a human-readable location string from a JSON `SyntaxError`.
+ *
+ * Returns `Option.some("at position N")` or `Option.some("line N column N")`
+ * when the engine includes position information, otherwise `Option.none()`.
+ */
+const extractParseErrorLocation = (error) => {
+    if (error instanceof SyntaxError && typeof error.message === "string") {
+        const posMatch = /at position (\d+)/.exec(error.message);
+        if (posMatch !== null) {
+            return Option.some(`at position ${posMatch[1]}`);
+        }
+        const lineMatch = /line (\d+) column (\d+)/.exec(error.message);
+        if (lineMatch !== null) {
+            return Option.some(`line ${lineMatch[1]} column ${lineMatch[2]}`);
+        }
+    }
+    return Option.none();
+};
+/**
+ * Read a JSON file, parse it, and validate it against a schema.
+ *
+ * Returns a {@link JsonFileReadResult} discriminated union so callers can
+ * decide how to present each failure mode (missing file, I/O error, malformed
+ * JSON, schema mismatch) without catching exceptions.
+ *
+ * @param filePath - Absolute path to the JSON file.
+ * @param schema   - Effect Schema to validate the parsed JSON against.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const readAndValidateJsonFile = (filePath, schema, options) => Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    // 1. Check existence
+    const existsResult = yield* Effect.result(fs.exists(filePath));
+    if (existsResult._tag === "Failure") {
+        return {
+            _tag: "read-failure",
+            error: `Failed to check if file exists: ${String(existsResult.failure)}`,
+        };
+    }
+    if (!existsResult.success) {
+        return { _tag: "missing" };
+    }
+    // 2. Read file
+    const readResult = yield* Effect.result(fs.readFileString(filePath));
+    if (readResult._tag === "Failure") {
+        return {
+            _tag: "read-failure",
+            error: `Failed to read file: ${String(readResult.failure)}`,
+        };
+    }
+    // 3. Parse JSON
+    const parseResult = yield* Effect.result(Effect.try({
+        try: () => JSON.parse(readResult.success),
+        catch: (error) => {
+            const message = error instanceof Error ? error.message : String(error);
+            const location = Option.getOrUndefined(extractParseErrorLocation(error));
+            return { message, location };
+        },
+    }));
+    if (parseResult._tag === "Failure") {
+        const failure = parseResult.failure;
+        return {
+            _tag: "unparseable",
+            error: failure.message,
+            ...(failure.location !== undefined ? { location: failure.location } : {}),
+        };
+    }
+    // 4. Validate against schema
+    const decoded = yield* Effect.result(Schema.decodeUnknownEffect(schema)(parseResult.success));
+    if (decoded._tag === "Failure") {
+        return {
+            _tag: "schema-invalid",
+            issues: formatSchemaIssuesToLines(decoded.failure.issue, options?.maxSchemaIssues),
+        };
+    }
+    return { _tag: "ok", value: decoded.success };
+});
+//# sourceMappingURL=read-and-validate-json-file.js.map

package/dist/src/unstable/schema/read-and-validate-json-file.js.map

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

package/dist/src/unstable/schema/types.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Discriminated union representing the outcome of reading and validating a JSON
+ * file against a schema.
+ *
+ * The `ok` variant carries the decoded value so callers that need it can avoid
+ * re-reading the file.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export type JsonFileReadResult<A> = {
+    readonly _tag: "ok";
+    readonly value: A;
+} | {
+    readonly _tag: "missing";
+} | {
+    readonly _tag: "read-failure";
+    readonly error: string;
+} | {
+    readonly _tag: "unparseable";
+    readonly error: string;
+    readonly location?: string;
+} | {
+    readonly _tag: "schema-invalid";
+    readonly issues: ReadonlyArray<string>;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/src/unstable/schema/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/unstable/schema/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,MAAM,kBAAkB,CAAC,CAAC,IAC5B;IAAE,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAA;CAAE,GAC1C;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;CAAE,GAC5B;IAAE,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACzD;IAAE,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GACpF;IAAE,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;CAAE,CAAC"}

package/dist/src/unstable/schema/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/unstable/schema/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/unstable/schema/types.ts"],"names":[],"mappings":""}

package/dist/src/unstable/settings/format-preserving-json.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Format-preserving JSON modification utilities.
+ *
+ * Detects and preserves existing formatting (indentation, line endings)
+ * when modifying JSON files using jsonc-parser's surgical edit operations.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+/**
+ * A single JSON modification: set or remove a value at a path.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export interface JsonModification {
+    readonly path: ReadonlyArray<string | number>;
+    readonly value: unknown;
+}
+//# sourceMappingURL=format-preserving-json.d.ts.map

package/dist/src/unstable/settings/format-preserving-json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-preserving-json.d.ts","sourceRoot":"","sources":["../../../../src/unstable/settings/format-preserving-json.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IAC9C,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB"}

package/dist/src/unstable/settings/format-preserving-json.js

@@ -0,0 +1,11 @@
+/**
+ * Format-preserving JSON modification utilities.
+ *
+ * Detects and preserves existing formatting (indentation, line endings)
+ * when modifying JSON files using jsonc-parser's surgical edit operations.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+export {};
+//# sourceMappingURL=format-preserving-json.js.map

package/dist/src/unstable/settings/format-preserving-json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-preserving-json.js","sourceRoot":"","sources":["../../../../src/unstable/settings/format-preserving-json.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/src/unstable/settings/ignored-patterns.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Normalization and validation for ignored extension patterns.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import * as Effect from "effect/Effect";
+/**
+ * Normalize ignored patterns: trim whitespace, reject empty patterns, deduplicate.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const normalizeIgnoredPatterns: (patterns: ReadonlyArray<string>) => Effect.Effect<string[], import("../app-error/app-error.ts").AppError, never>;
+/**
+ * Validate that no configured extension names conflict with ignored patterns.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const validateIgnoredConfigConflicts: (configuredNames: ReadonlyArray<string>, ignoredPatterns: ReadonlyArray<string>) => Effect.Effect<undefined, import("../app-error/app-error.ts").AppError, never>;
+//# sourceMappingURL=ignored-patterns.d.ts.map

package/dist/src/unstable/settings/ignored-patterns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ignored-patterns.d.ts","sourceRoot":"","sources":["../../../../src/unstable/settings/ignored-patterns.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAIxC;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,GAAI,UAAU,aAAa,CAAC,MAAM,CAAC,iFAYpE,CAAC;AAEL;;;;GAIG;AACH,eAAO,MAAM,8BAA8B,GACzC,iBAAiB,aAAa,CAAC,MAAM,CAAC,EACtC,iBAAiB,aAAa,CAAC,MAAM,CAAC,kFAgBpC,CAAC"}