agent-config-detect 0.0.0

package/dist/dts/types/ResourceKind.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Categories of resources that harnesses manage in named directories.
+ *
+ * Used with `HarnessKind.directoryNames` to query expected
+ * directory naming conventions.
+ *
+ * @module
+ */
+import { Schema } from "effect";
+/**
+ * Resource kind schema - represents the different types of resources
+ * that harnesses can manage.
+ */
+export declare const ResourceKind: Schema.Literal<["Skills", "Commands", "Agents", "Plugins"]>;
+/**
+ * Resource kind type.
+ */
+export type ResourceKind = typeof ResourceKind.Type;
+/**
+ * All supported resource kinds.
+ */
+export declare const ResourceKindAll: readonly ["Skills", "Commands", "Agents", "Plugins"];
+//# sourceMappingURL=ResourceKind.d.ts.map

package/dist/dts/types/ResourceKind.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResourceKind.d.ts","sourceRoot":"","sources":["../../../src/types/ResourceKind.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAE/B;;;GAGG;AACH,eAAO,MAAM,YAAY,6DAA4D,CAAA;AAErF;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,OAAO,YAAY,CAAC,IAAI,CAAA;AAEnD;;GAEG;AACH,eAAO,MAAM,eAAe,sDAE3B,CAAA"}

package/dist/dts/types/Scope.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Scope for path resolution.
+ *
+ * Determines whether to look up global (user-level) or
+ * project-local configuration paths.
+ *
+ * @module
+ */
+import { Schema } from "effect";
+declare const Global_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]; }) => Readonly<A> & {
+    readonly _tag: "Global";
+};
+/**
+ * User-level global configuration (e.g., `~/.config/...`).
+ */
+export declare class Global extends Global_base<{}> {
+}
+declare const Project_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]; }) => Readonly<A> & {
+    readonly _tag: "Project";
+};
+/**
+ * Project-local configuration (e.g., `.claude/` in project root).
+ */
+export declare class Project extends Project_base<{
+    readonly path: string;
+}> {
+}
+declare const Custom_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]; }) => Readonly<A> & {
+    readonly _tag: "Custom";
+};
+/**
+ * Custom path for profile-scoped resources (inherits harness directory structure).
+ */
+export declare class Custom extends Custom_base<{
+    readonly path: string;
+}> {
+}
+/**
+ * Scope type - union of all scope variants.
+ */
+export type Scope = Global | Project | Custom;
+/**
+ * Scope schema for serialization.
+ */
+export declare const Scope: Schema.Schema<Scope>;
+/**
+ * Creates a global scope.
+ */
+export declare const global: () => Scope;
+/**
+ * Creates a project scope with the given path.
+ */
+export declare const project: (path: string) => Scope;
+/**
+ * Creates a custom scope with the given path.
+ */
+export declare const custom: (path: string) => Scope;
+export {};
+//# sourceMappingURL=Scope.d.ts.map

package/dist/dts/types/Scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Scope.d.ts","sourceRoot":"","sources":["../../../src/types/Scope.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAQ,MAAM,EAAE,MAAM,QAAQ,CAAA;;;;AAErC;;GAEG;AACH,qBAAa,MAAO,SAAQ,YAA2B,EAAE,CAAC;CAAG;;;;AAE7D;;GAEG;AACH,qBAAa,OAAQ,SAAQ,aAA4B;IACvD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB,CAAC;CAAG;;;;AAEL;;GAEG;AACH,qBAAa,MAAO,SAAQ,YAA2B;IACrD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB,CAAC;CAAG;AAEL;;GAEG;AACH,MAAM,MAAM,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAA;AAE7C;;GAEG;AACH,eAAO,MAAM,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAId,CAAA;AAEzB;;GAEG;AACH,eAAO,MAAM,MAAM,QAAO,KAAqB,CAAA;AAE/C;;GAEG;AACH,eAAO,MAAM,OAAO,GAAI,MAAM,MAAM,KAAG,KAA8B,CAAA;AAErE;;GAEG;AACH,eAAO,MAAM,MAAM,GAAI,MAAM,MAAM,KAAG,KAA6B,CAAA"}

package/dist/dts/types/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Core type definitions for harness path resolution.
+ *
+ * @module
+ */
+export * from "./ConfigResource.js";
+export * from "./DirectoryResource.js";
+export * from "./DirectoryStructure.js";
+export * from "./EnvValue.js";
+export * from "./FileFormat.js";
+export * from "./HarnessKind.js";
+export * from "./InstallationStatus.js";
+export * from "./PathType.js";
+export * from "./ResourceKind.js";
+export * from "./Scope.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/dts/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,cAAc,qBAAqB,CAAA;AACnC,cAAc,wBAAwB,CAAA;AACtC,cAAc,yBAAyB,CAAA;AACvC,cAAc,eAAe,CAAA;AAC7B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,kBAAkB,CAAA;AAChC,cAAc,yBAAyB,CAAA;AACvC,cAAc,eAAe,CAAA;AAC7B,cAAc,mBAAmB,CAAA;AACjC,cAAc,YAAY,CAAA"}

package/dist/esm/errors.js

@@ -0,0 +1,87 @@
+/**
+ * Error types for harness operations.
+ *
+ * @module
+ */
+import { Data } from "effect";
+/**
+ * The requested harness was not found on this system.
+ */
+export class NotFoundError extends /*#__PURE__*/Data.TaggedError("NotFoundError") {}
+/**
+ * The path is invalid or inaccessible.
+ */
+export class InvalidPathError extends /*#__PURE__*/Data.TaggedError("InvalidPathError") {
+  get message() {
+    return `invalid path: ${this.path}`;
+  }
+}
+/**
+ * An environment variable could not be read.
+ */
+export class EnvVarError extends /*#__PURE__*/Data.TaggedError("EnvVarError") {
+  get message() {
+    return `environment variable error: ${this.cause.message}`;
+  }
+}
+/**
+ * The current platform is not supported.
+ */
+export class UnsupportedPlatformError extends /*#__PURE__*/Data.TaggedError("UnsupportedPlatformError") {
+  get message() {
+    return "unsupported platform";
+  }
+}
+/**
+ * An I/O error occurred.
+ */
+export class IoError extends /*#__PURE__*/Data.TaggedError("IoError") {
+  get message() {
+    return `IO error: ${this.cause.message}`;
+  }
+}
+/**
+ * MCP server uses unsupported features for target harness.
+ */
+export class UnsupportedMcpConfigError extends /*#__PURE__*/Data.TaggedError("UnsupportedMcpConfigError") {
+  get message() {
+    return `unsupported MCP config for ${this.harness}: ${this.reason}`;
+  }
+}
+/**
+ * Binary detection failed due to system error.
+ */
+export class BinaryDetectionError extends /*#__PURE__*/Data.TaggedError("BinaryDetectionError") {}
+/**
+ * The requested scope is not supported by this harness.
+ */
+export class UnsupportedScopeError extends /*#__PURE__*/Data.TaggedError("UnsupportedScopeError") {
+  get message() {
+    return `${this.harness} does not support ${this.scope} scope`;
+  }
+}
+/**
+ * YAML parsing failed.
+ */
+export class YamlParseError extends /*#__PURE__*/Data.TaggedError("YamlParseError") {
+  get message() {
+    return `YAML parse error: ${this.cause.message}`;
+  }
+}
+/**
+ * A required field is missing from the input.
+ */
+export class MissingFieldError extends /*#__PURE__*/Data.TaggedError("MissingFieldError") {
+  get message() {
+    return `missing required field: ${this.field}`;
+  }
+}
+/**
+ * An environment variable referenced by EnvValue is not set.
+ */
+export class MissingEnvVarError extends /*#__PURE__*/Data.TaggedError("MissingEnvVarError") {
+  get message() {
+    return `missing environment variable: ${this.name}`;
+  }
+}
+//# sourceMappingURL=errors.js.map

package/dist/esm/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","names":["Data","NotFoundError","TaggedError","InvalidPathError","message","path","EnvVarError","cause","UnsupportedPlatformError","IoError","UnsupportedMcpConfigError","harness","reason","BinaryDetectionError","UnsupportedScopeError","scope","YamlParseError","MissingFieldError","field","MissingEnvVarError","name"],"sources":["../../src/errors.ts"],"sourcesContent":[null],"mappings":"AAAA;;;;;AAKA,SAASA,IAAI,QAAQ,QAAQ;AAE7B;;;AAGA,OAAM,MAAOC,aAAc,sBAAQD,IAAI,CAACE,WAAW,CAAC,eAAe,CAEjE;AAEF;;;AAGA,OAAM,MAAOC,gBAAiB,sBAAQH,IAAI,CAACE,WAAW,CAAC,kBAAkB,CAEvE;EACA,IAAIE,OAAOA,CAAA;IACT,OAAO,iBAAiB,IAAI,CAACC,IAAI,EAAE;EACrC;;AAGF;;;AAGA,OAAM,MAAOC,WAAY,sBAAQN,IAAI,CAACE,WAAW,CAAC,aAAa,CAE7D;EACA,IAAIE,OAAOA,CAAA;IACT,OAAO,+BAA+B,IAAI,CAACG,KAAK,CAACH,OAAO,EAAE;EAC5D;;AAGF;;;AAGA,OAAM,MAAOI,wBAAyB,sBAAQR,IAAI,CAACE,WAAW,CAAC,0BAA0B,CAAK;EAC5F,IAAIE,OAAOA,CAAA;IACT,OAAO,sBAAsB;EAC/B;;AAGF;;;AAGA,OAAM,MAAOK,OAAQ,sBAAQT,IAAI,CAACE,WAAW,CAAC,SAAS,CAErD;EACA,IAAIE,OAAOA,CAAA;IACT,OAAO,aAAa,IAAI,CAACG,KAAK,CAACH,OAAO,EAAE;EAC1C;;AAGF;;;AAGA,OAAM,MAAOM,yBAA0B,sBAAQV,IAAI,CAACE,WAAW,CAAC,2BAA2B,CAGzF;EACA,IAAIE,OAAOA,CAAA;IACT,OAAO,8BAA8B,IAAI,CAACO,OAAO,KAAK,IAAI,CAACC,MAAM,EAAE;EACrE;;AAGF;;;AAGA,OAAM,MAAOC,oBAAqB,sBAAQb,IAAI,CAACE,WAAW,CAAC,sBAAsB,CAE/E;AAEF;;;AAGA,OAAM,MAAOY,qBAAsB,sBAAQd,IAAI,CAACE,WAAW,CAAC,uBAAuB,CAGjF;EACA,IAAIE,OAAOA,CAAA;IACT,OAAO,GAAG,IAAI,CAACO,OAAO,qBAAqB,IAAI,CAACI,KAAK,QAAQ;EAC/D;;AAGF;;;AAGA,OAAM,MAAOC,cAAe,sBAAQhB,IAAI,CAACE,WAAW,CAAC,gBAAgB,CAEnE;EACA,IAAIE,OAAOA,CAAA;IACT,OAAO,qBAAqB,IAAI,CAACG,KAAK,CAACH,OAAO,EAAE;EAClD;;AAGF;;;AAGA,OAAM,MAAOa,iBAAkB,sBAAQjB,IAAI,CAACE,WAAW,CAAC,mBAAmB,CAEzE;EACA,IAAIE,OAAOA,CAAA;IACT,OAAO,2BAA2B,IAAI,CAACc,KAAK,EAAE;EAChD;;AAGF;;;AAGA,OAAM,MAAOC,kBAAmB,sBAAQnB,IAAI,CAACE,WAAW,CAAC,oBAAoB,CAE3E;EACA,IAAIE,OAAOA,CAAA;IACT,OAAO,iCAAiC,IAAI,CAACgB,IAAI,EAAE;EACrD","ignoreList":[]}

package/dist/esm/index.js

@@ -0,0 +1,14 @@
+/**
+ * Agent config detection library.
+ *
+ * Port of harness-locate Rust crate to TypeScript + Effect.
+ *
+ * @module
+ */
+// Types
+export * from "./types/index.js";
+// Errors
+export * from "./errors.js";
+// Platform
+export { Platform, PlatformLive, TestPlatform, TestPlatformDarwin, TestPlatformLinux, TestPlatformWindows, withEnv, withoutEnv } from "./platform/index.js";
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["Platform","PlatformLive","TestPlatform","TestPlatformDarwin","TestPlatformLinux","TestPlatformWindows","withEnv","withoutEnv"],"sources":["../../src/index.ts"],"sourcesContent":[null],"mappings":"AAAA;;;;;;;AAQA;AACA,cAAc,kBAAkB;AAEhC;AACA,cAAc,aAAa;AAE3B;AACA,SAEEA,QAAQ,EACRC,YAAY,EAEZC,YAAY,EACZC,kBAAkB,EAClBC,iBAAiB,EACjBC,mBAAmB,EACnBC,OAAO,EACPC,UAAU,QACL,qBAAqB","ignoreList":[]}

package/dist/esm/package.json

@@ -0,0 +1,4 @@
+{
+  "type": "module",
+  "sideEffects": []
+}

package/dist/esm/platform/Platform.js

@@ -0,0 +1,6 @@
+import { Context } from "effect";
+/**
+ * Platform service tag.
+ */
+export class Platform extends /*#__PURE__*/Context.Tag("Platform")() {}
+//# sourceMappingURL=Platform.js.map

package/dist/esm/platform/Platform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Platform.js","names":["Context","Platform","Tag"],"sources":["../../../src/platform/Platform.ts"],"sourcesContent":[null],"mappings":"AAMA,SAASA,OAAO,QAAQ,QAAQ;AAsDhC;;;AAGA,OAAM,MAAOC,QAAS,sBAAQD,OAAO,CAACE,GAAG,CAAC,UAAU,CAAC,EAA6B","ignoreList":[]}

package/dist/esm/platform/TestPlatform.js

@@ -0,0 +1,54 @@
+/**
+ * Test platform layer for mocking in tests.
+ *
+ * @module
+ */
+import { Effect, Layer } from "effect";
+import { Platform } from "./Platform.js";
+/**
+ * Creates a test platform layer with the given configuration.
+ *
+ * Useful for testing platform-dependent code without relying on
+ * the actual filesystem or environment.
+ */
+export const TestPlatform = (config = {}) => {
+  const service = {
+    os: config.os ?? "darwin",
+    homeDir: Effect.succeed(config.home ?? "/home/testuser"),
+    configDir: Effect.succeed(config.config ?? "/home/testuser/.config"),
+    dataDir: Effect.succeed(config.data ?? "/home/testuser/.local/share"),
+    cacheDir: Effect.succeed(config.cache ?? "/home/testuser/.cache")
+  };
+  return Layer.succeed(Platform, service);
+};
+/**
+ * Creates a macOS test platform.
+ */
+export const TestPlatformDarwin = (home = "/Users/testuser") => TestPlatform({
+  os: "darwin",
+  home,
+  config: `${home}/.config`,
+  data: `${home}/Library/Application Support`,
+  cache: `${home}/Library/Application Support`
+});
+/**
+ * Creates a Linux test platform.
+ */
+export const TestPlatformLinux = (home = "/home/testuser") => TestPlatform({
+  os: "linux",
+  home,
+  config: `${home}/.config`,
+  data: `${home}/.local/share`,
+  cache: `${home}/.cache`
+});
+/**
+ * Creates a Windows test platform.
+ */
+export const TestPlatformWindows = (home = "C:\\Users\\testuser") => TestPlatform({
+  os: "win32",
+  home,
+  config: `${home}\\AppData\\Roaming`,
+  data: `${home}\\AppData\\Local`,
+  cache: `${home}\\AppData\\Local`
+});
+//# sourceMappingURL=TestPlatform.js.map

package/dist/esm/platform/TestPlatform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TestPlatform.js","names":["Effect","Layer","Platform","TestPlatform","config","service","os","homeDir","succeed","home","configDir","dataDir","data","cacheDir","cache","TestPlatformDarwin","TestPlatformLinux","TestPlatformWindows"],"sources":["../../../src/platform/TestPlatform.ts"],"sourcesContent":[null],"mappings":"AAAA;;;;;AAKA,SAASA,MAAM,EAAEC,KAAK,QAAQ,QAAQ;AACtC,SAAkBC,QAAQ,QAA8B,eAAe;AAgCvE;;;;;;AAMA,OAAO,MAAMC,YAAY,GAAGA,CAACC,MAAA,GAA6B,EAAE,KAA2B;EACrF,MAAMC,OAAO,GAAoB;IAC/BC,EAAE,EAAEF,MAAM,CAACE,EAAE,IAAI,QAAQ;IACzBC,OAAO,EAAEP,MAAM,CAACQ,OAAO,CAACJ,MAAM,CAACK,IAAI,IAAI,gBAAgB,CAAC;IACxDC,SAAS,EAAEV,MAAM,CAACQ,OAAO,CAACJ,MAAM,CAACA,MAAM,IAAI,wBAAwB,CAAC;IACpEO,OAAO,EAAEX,MAAM,CAACQ,OAAO,CAACJ,MAAM,CAACQ,IAAI,IAAI,6BAA6B,CAAC;IACrEC,QAAQ,EAAEb,MAAM,CAACQ,OAAO,CAACJ,MAAM,CAACU,KAAK,IAAI,uBAAuB;GACjE;EAED,OAAOb,KAAK,CAACO,OAAO,CAACN,QAAQ,EAAEG,OAAO,CAAC;AACzC,CAAC;AAED;;;AAGA,OAAO,MAAMU,kBAAkB,GAAGA,CAACN,IAAI,GAAG,iBAAiB,KACzDN,YAAY,CAAC;EACXG,EAAE,EAAE,QAAQ;EACZG,IAAI;EACJL,MAAM,EAAE,GAAGK,IAAI,UAAU;EACzBG,IAAI,EAAE,GAAGH,IAAI,8BAA8B;EAC3CK,KAAK,EAAE,GAAGL,IAAI;CACf,CAAC;AAEJ;;;AAGA,OAAO,MAAMO,iBAAiB,GAAGA,CAACP,IAAI,GAAG,gBAAgB,KACvDN,YAAY,CAAC;EACXG,EAAE,EAAE,OAAO;EACXG,IAAI;EACJL,MAAM,EAAE,GAAGK,IAAI,UAAU;EACzBG,IAAI,EAAE,GAAGH,IAAI,eAAe;EAC5BK,KAAK,EAAE,GAAGL,IAAI;CACf,CAAC;AAEJ;;;AAGA,OAAO,MAAMQ,mBAAmB,GAAGA,CACjCR,IAAI,GAAG,qBAAqB,KAE5BN,YAAY,CAAC;EACXG,EAAE,EAAE,OAAO;EACXG,IAAI;EACJL,MAAM,EAAE,GAAGK,IAAI,oBAAoB;EACnCG,IAAI,EAAE,GAAGH,IAAI,kBAAkB;EAC/BK,KAAK,EAAE,GAAGL,IAAI;CACf,CAAC","ignoreList":[]}

package/dist/esm/platform/index.js

@@ -0,0 +1,68 @@
+/**
+ * Platform-specific path resolution.
+ *
+ * This module provides the Platform service for resolving base configuration
+ * directories on each supported platform (macOS, Linux, Windows).
+ *
+ * @module
+ */
+import { Layer } from "effect";
+import { UnsupportedPlatformError } from "../errors.js";
+import { homeDir } from "./internal/common.js";
+import * as darwin from "./internal/darwin.js";
+import * as linux from "./internal/linux.js";
+import * as windows from "./internal/windows.js";
+import { Platform } from "./Platform.js";
+// Re-export types and service
+export { withEnv, withoutEnv } from "./internal/testUtils.js";
+export { Platform } from "./Platform.js";
+export { TestPlatform, TestPlatformDarwin, TestPlatformLinux, TestPlatformWindows } from "./TestPlatform.js";
+/**
+ * Detects the current operating system.
+ */
+const detectOS = () => {
+  const platform = process.platform;
+  if (platform === "darwin" || platform === "linux" || platform === "win32") {
+    return platform;
+  }
+  throw new UnsupportedPlatformError();
+};
+/**
+ * Creates a platform service for the current OS.
+ */
+const createPlatformService = () => {
+  const os = detectOS();
+  switch (os) {
+    case "darwin":
+      return {
+        os,
+        homeDir,
+        configDir: darwin.configDir,
+        dataDir: darwin.dataDir,
+        cacheDir: darwin.cacheDir
+      };
+    case "linux":
+      return {
+        os,
+        homeDir,
+        configDir: linux.configDir,
+        dataDir: linux.dataDir,
+        cacheDir: linux.cacheDir
+      };
+    case "win32":
+      return {
+        os,
+        homeDir,
+        configDir: windows.configDir,
+        dataDir: windows.dataDir,
+        cacheDir: windows.cacheDir
+      };
+  }
+};
+/**
+ * Live platform layer that uses the actual system paths.
+ *
+ * Uses runtime platform detection to select the appropriate implementation.
+ */
+export const PlatformLive = /*#__PURE__*/Layer.sync(Platform, createPlatformService);
+//# sourceMappingURL=index.js.map

package/dist/esm/platform/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["Layer","UnsupportedPlatformError","homeDir","darwin","linux","windows","Platform","withEnv","withoutEnv","TestPlatform","TestPlatformDarwin","TestPlatformLinux","TestPlatformWindows","detectOS","platform","process","createPlatformService","os","configDir","dataDir","cacheDir","PlatformLive","sync"],"sources":["../../../src/platform/index.ts"],"sourcesContent":[null],"mappings":"AAAA;;;;;;;;AAQA,SAASA,KAAK,QAAQ,QAAQ;AAC9B,SAASC,wBAAwB,QAAQ,cAAc;AACvD,SAASC,OAAO,QAAQ,sBAAsB;AAC9C,OAAO,KAAKC,MAAM,MAAM,sBAAsB;AAC9C,OAAO,KAAKC,KAAK,MAAM,qBAAqB;AAC5C,OAAO,KAAKC,OAAO,MAAM,uBAAuB;AAChD,SAAkBC,QAAQ,QAA8B,eAAe;AAEvE;AACA,SAASC,OAAO,EAAEC,UAAU,QAAQ,yBAAyB;AAC7D,SAAkBF,QAAQ,QAA8B,eAAe;AACvE,SAASG,YAAY,EAAEC,kBAAkB,EAAEC,iBAAiB,EAAEC,mBAAmB,QAAQ,mBAAmB;AAE5G;;;AAGA,MAAMC,QAAQ,GAAGA,CAAA,KAAS;EACxB,MAAMC,QAAQ,GAAGC,OAAO,CAACD,QAAQ;EACjC,IAAIA,QAAQ,KAAK,QAAQ,IAAIA,QAAQ,KAAK,OAAO,IAAIA,QAAQ,KAAK,OAAO,EAAE;IACzE,OAAOA,QAAQ;EACjB;EACA,MAAM,IAAIb,wBAAwB,EAAE;AACtC,CAAC;AAED;;;AAGA,MAAMe,qBAAqB,GAAGA,CAAA,KAAsB;EAClD,MAAMC,EAAE,GAAGJ,QAAQ,EAAE;EAErB,QAAQI,EAAE;IACR,KAAK,QAAQ;MACX,OAAO;QACLA,EAAE;QACFf,OAAO;QACPgB,SAAS,EAAEf,MAAM,CAACe,SAAS;QAC3BC,OAAO,EAAEhB,MAAM,CAACgB,OAAO;QACvBC,QAAQ,EAAEjB,MAAM,CAACiB;OAClB;IACH,KAAK,OAAO;MACV,OAAO;QACLH,EAAE;QACFf,OAAO;QACPgB,SAAS,EAAEd,KAAK,CAACc,SAAS;QAC1BC,OAAO,EAAEf,KAAK,CAACe,OAAO;QACtBC,QAAQ,EAAEhB,KAAK,CAACgB;OACjB;IACH,KAAK,OAAO;MACV,OAAO;QACLH,EAAE;QACFf,OAAO;QACPgB,SAAS,EAAEb,OAAO,CAACa,SAAS;QAC5BC,OAAO,EAAEd,OAAO,CAACc,OAAO;QACxBC,QAAQ,EAAEf,OAAO,CAACe;OACnB;EACL;AACF,CAAC;AAED;;;;;AAKA,OAAO,MAAMC,YAAY,gBAA0BrB,KAAK,CAACsB,IAAI,CAAChB,QAAQ,EAAEU,qBAAqB,CAAC","ignoreList":[]}

package/dist/esm/platform/internal/common.js

@@ -0,0 +1,30 @@
+/**
+ * Common platform utilities.
+ *
+ * @module
+ */
+import { Effect } from "effect";
+import * as os from "node:os";
+import * as path from "node:path";
+import { NotFoundError } from "../../errors.js";
+/**
+ * Returns the user's home directory.
+ */
+export const homeDir = /*#__PURE__*/Effect.sync(() => {
+  const home = os.homedir();
+  if (!home) {
+    return Effect.fail(new NotFoundError({
+      message: "home directory"
+    }));
+  }
+  return Effect.succeed(home);
+}).pipe(Effect.flatten);
+/**
+ * Joins path segments.
+ */
+export const joinPath = (...segments) => path.join(...segments);
+/**
+ * Checks if a path is absolute.
+ */
+export const isAbsolute = p => path.isAbsolute(p);
+//# sourceMappingURL=common.js.map

package/dist/esm/platform/internal/common.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.js","names":["Effect","os","path","NotFoundError","homeDir","sync","home","homedir","fail","message","succeed","pipe","flatten","joinPath","segments","join","isAbsolute","p"],"sources":["../../../../src/platform/internal/common.ts"],"sourcesContent":[null],"mappings":"AAAA;;;;;AAKA,SAASA,MAAM,QAAQ,QAAQ;AAC/B,OAAO,KAAKC,EAAE,MAAM,SAAS;AAC7B,OAAO,KAAKC,IAAI,MAAM,WAAW;AACjC,SAASC,aAAa,QAAQ,iBAAiB;AAE/C;;;AAGA,OAAO,MAAMC,OAAO,gBAAGJ,MAAM,CAACK,IAAI,CAAC,MAAK;EACtC,MAAMC,IAAI,GAAGL,EAAE,CAACM,OAAO,EAAE;EACzB,IAAI,CAACD,IAAI,EAAE;IACT,OAAON,MAAM,CAACQ,IAAI,CAAC,IAAIL,aAAa,CAAC;MAAEM,OAAO,EAAE;IAAgB,CAAE,CAAC,CAAC;EACtE;EACA,OAAOT,MAAM,CAACU,OAAO,CAACJ,IAAI,CAAC;AAC7B,CAAC,CAAC,CAACK,IAAI,CAACX,MAAM,CAACY,OAAO,CAAC;AAEvB;;;AAGA,OAAO,MAAMC,QAAQ,GAAGA,CAAC,GAAGC,QAAuB,KAAaZ,IAAI,CAACa,IAAI,CAAC,GAAGD,QAAQ,CAAC;AAEtF;;;AAGA,OAAO,MAAME,UAAU,GAAIC,CAAS,IAAcf,IAAI,CAACc,UAAU,CAACC,CAAC,CAAC","ignoreList":[]}

package/dist/esm/platform/internal/darwin.js

@@ -0,0 +1,33 @@
+/**
+ * macOS-specific path resolution.
+ *
+ * @module
+ */
+import { Effect } from "effect";
+import { homeDir, joinPath } from "./common.js";
+/**
+ * Returns the user's config directory on macOS.
+ *
+ * Most CLI tools use `~/.config/` following XDG conventions,
+ * though native macOS apps prefer `~/Library/Application Support/`.
+ */
+export const configDir = /*#__PURE__*/Effect.map(homeDir, home => joinPath(home, ".config"));
+/**
+ * Returns the user's data directory on macOS.
+ *
+ * Returns `~/Library/Application Support/` for native macOS conventions.
+ */
+export const dataDir = /*#__PURE__*/Effect.map(homeDir, home => joinPath(home, "Library", "Application Support"));
+/**
+ * Returns the Application Support directory on macOS.
+ *
+ * This is `~/Library/Application Support/`, used by native macOS applications.
+ */
+export const applicationSupportDir = dataDir;
+/**
+ * Returns the cache directory on macOS.
+ *
+ * On macOS, we use the data directory as there's no standard XDG cache.
+ */
+export const cacheDir = dataDir;
+//# sourceMappingURL=darwin.js.map

package/dist/esm/platform/internal/darwin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"darwin.js","names":["Effect","homeDir","joinPath","configDir","map","home","dataDir","applicationSupportDir","cacheDir"],"sources":["../../../../src/platform/internal/darwin.ts"],"sourcesContent":[null],"mappings":"AAAA;;;;;AAKA,SAASA,MAAM,QAAQ,QAAQ;AAE/B,SAASC,OAAO,EAAEC,QAAQ,QAAQ,aAAa;AAE/C;;;;;;AAMA,OAAO,MAAMC,SAAS,gBAAyCH,MAAM,CAACI,GAAG,CACvEH,OAAO,EACNI,IAAI,IAAKH,QAAQ,CAACG,IAAI,EAAE,SAAS,CAAC,CACpC;AAED;;;;;AAKA,OAAO,MAAMC,OAAO,gBAAyCN,MAAM,CAACI,GAAG,CACrEH,OAAO,EACNI,IAAI,IAAKH,QAAQ,CAACG,IAAI,EAAE,SAAS,EAAE,qBAAqB,CAAC,CAC3D;AAED;;;;;AAKA,OAAO,MAAME,qBAAqB,GAAyCD,OAAO;AAElF;;;;;AAKA,OAAO,MAAME,QAAQ,GAAyCF,OAAO","ignoreList":[]}

package/dist/esm/platform/internal/linux.js

@@ -0,0 +1,62 @@
+/**
+ * Linux-specific path resolution with XDG Base Directory support.
+ *
+ * @module
+ */
+import { Effect, Option } from "effect";
+import { homeDir, isAbsolute, joinPath } from "./common.js";
+/**
+ * Gets an XDG path if the environment variable is set and valid.
+ *
+ * Returns None if:
+ * - The environment variable is not set
+ * - The value is empty
+ * - The path is not absolute
+ */
+const xdgPathIfValid = varName => {
+  const value = process.env[varName];
+  if (value && value.length > 0 && isAbsolute(value)) {
+    return Option.some(value);
+  }
+  return Option.none();
+};
+/**
+ * Returns the user's config directory on Linux.
+ *
+ * Respects `XDG_CONFIG_HOME` if set to an absolute path,
+ * otherwise defaults to `~/.config/`.
+ */
+export const configDir = /*#__PURE__*/Effect.suspend(() => {
+  const xdgPath = xdgPathIfValid("XDG_CONFIG_HOME");
+  if (Option.isSome(xdgPath)) {
+    return Effect.succeed(xdgPath.value);
+  }
+  return Effect.map(homeDir, home => joinPath(home, ".config"));
+});
+/**
+ * Returns the user's data directory on Linux.
+ *
+ * Respects `XDG_DATA_HOME` if set to an absolute path,
+ * otherwise defaults to `~/.local/share/`.
+ */
+export const dataDir = /*#__PURE__*/Effect.suspend(() => {
+  const xdgPath = xdgPathIfValid("XDG_DATA_HOME");
+  if (Option.isSome(xdgPath)) {
+    return Effect.succeed(xdgPath.value);
+  }
+  return Effect.map(homeDir, home => joinPath(home, ".local", "share"));
+});
+/**
+ * Returns the user's cache directory on Linux.
+ *
+ * Respects `XDG_CACHE_HOME` if set to an absolute path,
+ * otherwise defaults to `~/.cache/`.
+ */
+export const cacheDir = /*#__PURE__*/Effect.suspend(() => {
+  const xdgPath = xdgPathIfValid("XDG_CACHE_HOME");
+  if (Option.isSome(xdgPath)) {
+    return Effect.succeed(xdgPath.value);
+  }
+  return Effect.map(homeDir, home => joinPath(home, ".cache"));
+});
+//# sourceMappingURL=linux.js.map

package/dist/esm/platform/internal/linux.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"linux.js","names":["Effect","Option","homeDir","isAbsolute","joinPath","xdgPathIfValid","varName","value","process","env","length","some","none","configDir","suspend","xdgPath","isSome","succeed","map","home","dataDir","cacheDir"],"sources":["../../../../src/platform/internal/linux.ts"],"sourcesContent":[null],"mappings":"AAAA;;;;;AAKA,SAASA,MAAM,EAAEC,MAAM,QAAQ,QAAQ;AAEvC,SAASC,OAAO,EAAEC,UAAU,EAAEC,QAAQ,QAAQ,aAAa;AAE3D;;;;;;;;AAQA,MAAMC,cAAc,GAAIC,OAAe,IAA2B;EAChE,MAAMC,KAAK,GAAGC,OAAO,CAACC,GAAG,CAACH,OAAO,CAAC;EAClC,IAAIC,KAAK,IAAIA,KAAK,CAACG,MAAM,GAAG,CAAC,IAAIP,UAAU,CAACI,KAAK,CAAC,EAAE;IAClD,OAAON,MAAM,CAACU,IAAI,CAACJ,KAAK,CAAC;EAC3B;EACA,OAAON,MAAM,CAACW,IAAI,EAAE;AACtB,CAAC;AAED;;;;;;AAMA,OAAO,MAAMC,SAAS,gBAAyCb,MAAM,CAACc,OAAO,CAAC,MAAK;EACjF,MAAMC,OAAO,GAAGV,cAAc,CAAC,iBAAiB,CAAC;EACjD,IAAIJ,MAAM,CAACe,MAAM,CAACD,OAAO,CAAC,EAAE;IAC1B,OAAOf,MAAM,CAACiB,OAAO,CAACF,OAAO,CAACR,KAAK,CAAC;EACtC;EACA,OAAOP,MAAM,CAACkB,GAAG,CAAChB,OAAO,EAAGiB,IAAI,IAAKf,QAAQ,CAACe,IAAI,EAAE,SAAS,CAAC,CAAC;AACjE,CAAC,CAAC;AAEF;;;;;;AAMA,OAAO,MAAMC,OAAO,gBAAyCpB,MAAM,CAACc,OAAO,CAAC,MAAK;EAC/E,MAAMC,OAAO,GAAGV,cAAc,CAAC,eAAe,CAAC;EAC/C,IAAIJ,MAAM,CAACe,MAAM,CAACD,OAAO,CAAC,EAAE;IAC1B,OAAOf,MAAM,CAACiB,OAAO,CAACF,OAAO,CAACR,KAAK,CAAC;EACtC;EACA,OAAOP,MAAM,CAACkB,GAAG,CAAChB,OAAO,EAAGiB,IAAI,IAAKf,QAAQ,CAACe,IAAI,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;AACzE,CAAC,CAAC;AAEF;;;;;;AAMA,OAAO,MAAME,QAAQ,gBAAyCrB,MAAM,CAACc,OAAO,CAAC,MAAK;EAChF,MAAMC,OAAO,GAAGV,cAAc,CAAC,gBAAgB,CAAC;EAChD,IAAIJ,MAAM,CAACe,MAAM,CAACD,OAAO,CAAC,EAAE;IAC1B,OAAOf,MAAM,CAACiB,OAAO,CAACF,OAAO,CAACR,KAAK,CAAC;EACtC;EACA,OAAOP,MAAM,CAACkB,GAAG,CAAChB,OAAO,EAAGiB,IAAI,IAAKf,QAAQ,CAACe,IAAI,EAAE,QAAQ,CAAC,CAAC;AAChE,CAAC,CAAC","ignoreList":[]}

package/dist/esm/platform/internal/testUtils.js

@@ -0,0 +1,70 @@
+/**
+ * Test utilities for platform testing.
+ *
+ * @module
+ */
+import { Effect } from "effect";
+/**
+ * Runs an effect with mocked environment variables.
+ *
+ * The original environment is restored after the effect completes,
+ * regardless of success or failure.
+ *
+ * @example
+ * ```ts
+ * const result = await Effect.runPromise(
+ *   withEnv({ XDG_CONFIG_HOME: "/custom/config" }, myEffect)
+ * )
+ * ```
+ */
+export const withEnv = (vars, effect) => {
+  const states = [];
+  return Effect.acquireUseRelease(
+  // Acquire: save original values and set new ones
+  Effect.sync(() => {
+    for (const [key, value] of Object.entries(vars)) {
+      states.push({
+        key,
+        originalValue: process.env[key]
+      });
+      if (value === undefined) {
+        delete process.env[key];
+      } else {
+        process.env[key] = value;
+      }
+    }
+  }),
+  // Use: run the effect
+  () => effect,
+  // Release: restore original values
+  () => Effect.sync(() => {
+    for (const {
+      key,
+      originalValue
+    } of states) {
+      if (originalValue === undefined) {
+        delete process.env[key];
+      } else {
+        process.env[key] = originalValue;
+      }
+    }
+  }));
+};
+/**
+ * Removes environment variables for the duration of an effect.
+ *
+ * @example
+ * ```ts
+ * const result = await Effect.runPromise(
+ *   withoutEnv(["XDG_CONFIG_HOME", "XDG_DATA_HOME"], myEffect)
+ * )
+ * ```
+ */
+export const withoutEnv = (keys, effect) => {
+  const vars = {};
+  for (const key of keys) {
+    vars[key] = undefined;
+  }
+  return withEnv(vars, effect);
+};
+//# sourceMappingURL=testUtils.js.map

package/dist/esm/platform/internal/testUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"testUtils.js","names":["Effect","withEnv","vars","effect","states","acquireUseRelease","sync","key","value","Object","entries","push","originalValue","process","env","undefined","withoutEnv","keys"],"sources":["../../../../src/platform/internal/testUtils.ts"],"sourcesContent":[null],"mappings":"AAAA;;;;;AAKA,SAASA,MAAM,QAAQ,QAAQ;AAU/B;;;;;;;;;;;;;AAaA,OAAO,MAAMC,OAAO,GAAGA,CACrBC,IAAwC,EACxCC,MAA8B,KACJ;EAC1B,MAAMC,MAAM,GAAoB,EAAE;EAElC,OAAOJ,MAAM,CAACK,iBAAiB;EAC7B;EACAL,MAAM,CAACM,IAAI,CAAC,MAAK;IACf,KAAK,MAAM,CAACC,GAAG,EAAEC,KAAK,CAAC,IAAIC,MAAM,CAACC,OAAO,CAACR,IAAI,CAAC,EAAE;MAC/CE,MAAM,CAACO,IAAI,CAAC;QAAEJ,GAAG;QAAEK,aAAa,EAAEC,OAAO,CAACC,GAAG,CAACP,GAAG;MAAC,CAAE,CAAC;MACrD,IAAIC,KAAK,KAAKO,SAAS,EAAE;QACvB,OAAOF,OAAO,CAACC,GAAG,CAACP,GAAG,CAAC;MACzB,CAAC,MAAM;QACLM,OAAO,CAACC,GAAG,CAACP,GAAG,CAAC,GAAGC,KAAK;MAC1B;IACF;EACF,CAAC,CAAC;EACF;EACA,MAAML,MAAM;EACZ;EACA,MACEH,MAAM,CAACM,IAAI,CAAC,MAAK;IACf,KAAK,MAAM;MAAEC,GAAG;MAAEK;IAAa,CAAE,IAAIR,MAAM,EAAE;MAC3C,IAAIQ,aAAa,KAAKG,SAAS,EAAE;QAC/B,OAAOF,OAAO,CAACC,GAAG,CAACP,GAAG,CAAC;MACzB,CAAC,MAAM;QACLM,OAAO,CAACC,GAAG,CAACP,GAAG,CAAC,GAAGK,aAAa;MAClC;IACF;EACF,CAAC,CAAC,CACL;AACH,CAAC;AAED;;;;;;;;;;AAUA,OAAO,MAAMI,UAAU,GAAGA,CACxBC,IAA2B,EAC3Bd,MAA8B,KACJ;EAC1B,MAAMD,IAAI,GAA8B,EAAE;EAC1C,KAAK,MAAMK,GAAG,IAAIU,IAAI,EAAE;IACtBf,IAAI,CAACK,GAAG,CAAC,GAAGQ,SAAS;EACvB;EACA,OAAOd,OAAO,CAACC,IAAI,EAAEC,MAAM,CAAC;AAC9B,CAAC","ignoreList":[]}

package/dist/esm/platform/internal/windows.js

@@ -0,0 +1,54 @@
+/**
+ * Windows-specific path resolution.
+ *
+ * @module
+ */
+import { Effect } from "effect";
+import { EnvVarError } from "../../errors.js";
+/**
+ * Returns the user's config directory on Windows.
+ *
+ * Returns `%APPDATA%` which is typically `C:\Users\<user>\AppData\Roaming`.
+ */
+export const configDir = /*#__PURE__*/Effect.suspend(() => {
+  const appdata = process.env.APPDATA;
+  if (!appdata) {
+    return Effect.fail(new EnvVarError({
+      cause: new Error("APPDATA environment variable not set")
+    }));
+  }
+  return Effect.succeed(appdata);
+});
+/**
+ * Returns the user's data directory on Windows.
+ *
+ * Returns `%LOCALAPPDATA%` which is typically `C:\Users\<user>\AppData\Local`.
+ */
+export const dataDir = /*#__PURE__*/Effect.suspend(() => {
+  const localAppData = process.env.LOCALAPPDATA;
+  if (!localAppData) {
+    return Effect.fail(new EnvVarError({
+      cause: new Error("LOCALAPPDATA environment variable not set")
+    }));
+  }
+  return Effect.succeed(localAppData);
+});
+/**
+ * Returns the roaming app data directory on Windows.
+ *
+ * This is `%APPDATA%`, used for settings that should roam with the user.
+ */
+export const roamingAppDataDir = configDir;
+/**
+ * Returns the local app data directory on Windows.
+ *
+ * This is `%LOCALAPPDATA%`, used for data that should stay on the local machine.
+ */
+export const localAppDataDir = dataDir;
+/**
+ * Returns the cache directory on Windows.
+ *
+ * On Windows, we use the local app data directory.
+ */
+export const cacheDir = dataDir;
+//# sourceMappingURL=windows.js.map

package/dist/esm/platform/internal/windows.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"windows.js","names":["Effect","EnvVarError","configDir","suspend","appdata","process","env","APPDATA","fail","cause","Error","succeed","dataDir","localAppData","LOCALAPPDATA","roamingAppDataDir","localAppDataDir","cacheDir"],"sources":["../../../../src/platform/internal/windows.ts"],"sourcesContent":[null],"mappings":"AAAA;;;;;AAKA,SAASA,MAAM,QAAQ,QAAQ;AAC/B,SAASC,WAAW,QAA4B,iBAAiB;AAEjE;;;;;AAKA,OAAO,MAAMC,SAAS,gBAAyCF,MAAM,CAACG,OAAO,CAAC,MAAK;EACjF,MAAMC,OAAO,GAAGC,OAAO,CAACC,GAAG,CAACC,OAAO;EACnC,IAAI,CAACH,OAAO,EAAE;IACZ,OAAOJ,MAAM,CAACQ,IAAI,CAChB,IAAIP,WAAW,CAAC;MAAEQ,KAAK,EAAE,IAAIC,KAAK,CAAC,sCAAsC;IAAC,CAAE,CAAC,CAC9E;EACH;EACA,OAAOV,MAAM,CAACW,OAAO,CAACP,OAAO,CAAC;AAChC,CAAC,CAAC;AAEF;;;;;AAKA,OAAO,MAAMQ,OAAO,gBAAyCZ,MAAM,CAACG,OAAO,CAAC,MAAK;EAC/E,MAAMU,YAAY,GAAGR,OAAO,CAACC,GAAG,CAACQ,YAAY;EAC7C,IAAI,CAACD,YAAY,EAAE;IACjB,OAAOb,MAAM,CAACQ,IAAI,CAChB,IAAIP,WAAW,CAAC;MAAEQ,KAAK,EAAE,IAAIC,KAAK,CAAC,2CAA2C;IAAC,CAAE,CAAC,CACnF;EACH;EACA,OAAOV,MAAM,CAACW,OAAO,CAACE,YAAY,CAAC;AACrC,CAAC,CAAC;AAEF;;;;;AAKA,OAAO,MAAME,iBAAiB,GAAyCb,SAAS;AAEhF;;;;;AAKA,OAAO,MAAMc,eAAe,GAAyCJ,OAAO;AAE5E;;;;;AAKA,OAAO,MAAMK,QAAQ,GAAyCL,OAAO","ignoreList":[]}