@agentxm/client-core 0.1.6

package/dist/src/unstable/update-check/update-check.d.ts

@@ -0,0 +1,101 @@
+/**
+ * UpdateCheck service — manages cached version checks and notifications.
+ *
+ * Reads/writes a `~/.axm/update-check.json` cache file, determines whether
+ * the check should be skipped, and produces install-method-aware notification
+ * messages.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import * as Effect from "effect/Effect";
+import * as FileSystem from "effect/FileSystem";
+import * as Layer from "effect/Layer";
+import * as Option from "effect/Option";
+import * as Path from "effect/Path";
+import * as Schema from "effect/Schema";
+import * as ServiceMap from "effect/ServiceMap";
+import type { InstallMethodType } from "../install-method/install-method.js";
+/** Schema for the on-disk update check cache file. */
+export declare const UpdateCheckCacheSchema: Schema.Struct<{
+    readonly latestVersion: Schema.String;
+    readonly checkedAt: Schema.String;
+}>;
+/** Decoded cache shape. */
+export type UpdateCheckCache = typeof UpdateCheckCacheSchema.Type;
+/**
+ * Context used to determine whether the update check should be skipped.
+ * Accepts parameters rather than reading globals directly for testability.
+ */
+export interface SkipCheckContext {
+    readonly isJsonOutput: boolean;
+    readonly noUpdateCheckEnv: boolean;
+    readonly isUpgradeCommand: boolean;
+    readonly isNonInteractive: boolean;
+    readonly isStderrTTY: boolean;
+    readonly isAgentSession: boolean;
+}
+export type NotificationAudience = "human" | "agent";
+export interface UpdateCheckService {
+    /** Read the cached update check, returning None if missing, invalid, or stale. */
+    readonly readCache: () => Effect.Effect<Option.Option<UpdateCheckCache>>;
+    /** Write the cache with the given version and current timestamp. */
+    readonly writeCache: (latestVersion: string) => Effect.Effect<void>;
+    /** Check if an update is available based on cached data. */
+    readonly isUpdateAvailable: (localVersion: string) => Effect.Effect<Option.Option<{
+        readonly current: string;
+        readonly latest: string;
+    }>>;
+    /** Determine if the update check should be skipped entirely. */
+    readonly shouldSkip: (context: SkipCheckContext) => boolean;
+    /** Build an install-method-aware notification message. */
+    readonly notificationMessage: (method: InstallMethodType, current: string, latest: string, audience?: NotificationAudience) => string;
+}
+declare const UpdateCheck_base: ServiceMap.ServiceClass<UpdateCheck, "@agentxm/client-core/UpdateCheck", UpdateCheckService>;
+/**
+ * Effect service tag for update check management.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare class UpdateCheck extends UpdateCheck_base {
+}
+/**
+ * Determine if the update check should be skipped.
+ */
+export declare const shouldSkip: (context: SkipCheckContext) => boolean;
+/**
+ * Build an install-method-aware notification message.
+ */
+export declare const notificationMessage: (method: InstallMethodType, current: string, latest: string, audience?: NotificationAudience) => string;
+/**
+ * Check whether the cache is stale (older than 60 minutes).
+ */
+export declare const isCacheStale: (checkedAt: string, now: Date) => boolean;
+/**
+ * Read and parse the cache file, returning None if missing, invalid, or stale.
+ */
+export declare const readCacheFromPath: (cachePath: string) => Effect.Effect<Option.Option<{
+    readonly latestVersion: string;
+    readonly checkedAt: string;
+}>, never, FileSystem.FileSystem>;
+/**
+ * Write the cache file with the given version and current timestamp.
+ */
+export declare const writeCacheToPath: (cachePath: string, latestVersion: string) => Effect.Effect<void, never, FileSystem.FileSystem | Path.Path>;
+/**
+ * Check if an update is available by reading the cache and comparing versions.
+ */
+export declare const isUpdateAvailableFromPath: (cachePath: string, localVersion: string) => Effect.Effect<Option.None<{
+    readonly current: string;
+    readonly latest: string;
+}> | Option.Some<{
+    readonly current: string;
+    readonly latest: string;
+}>, never, FileSystem.FileSystem>;
+export declare const UpdateCheckLive: Layer.Layer<UpdateCheck, never, FileSystem.FileSystem | Path.Path>;
+/**
+ * Create an UpdateCheck layer for testing with a configurable cache path.
+ */
+export declare const UpdateCheckTest: (cachePath: string) => Layer.Layer<UpdateCheck, never, FileSystem.FileSystem | Path.Path>;
+export {};
+//# sourceMappingURL=update-check.d.ts.map

package/dist/src/unstable/update-check/update-check.d.ts.map

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

package/dist/src/unstable/update-check/update-check.js

@@ -0,0 +1,181 @@
+/**
+ * UpdateCheck service — manages cached version checks and notifications.
+ *
+ * Reads/writes a `~/.axm/update-check.json` cache file, determines whether
+ * the check should be skipped, and produces install-method-aware notification
+ * messages.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import * as Effect from "effect/Effect";
+import * as FileSystem from "effect/FileSystem";
+import * as Layer from "effect/Layer";
+import * as Option from "effect/Option";
+import * as Path from "effect/Path";
+import * as Schema from "effect/Schema";
+import * as ServiceMap from "effect/ServiceMap";
+import * as semver from "semver";
+import { resolveAxmDataDir } from "../utils/index.js";
+// -----------------------------------------------------------------------------
+// Constants
+// -----------------------------------------------------------------------------
+const CACHE_FILENAME = "update-check.json";
+const CACHE_TTL_MS = 60 * 60 * 1000; // 60 minutes
+// -----------------------------------------------------------------------------
+// Cache schema
+// -----------------------------------------------------------------------------
+/** Schema for the on-disk update check cache file. */
+export const UpdateCheckCacheSchema = Schema.Struct({
+    latestVersion: Schema.String,
+    checkedAt: Schema.String,
+});
+const decodeUpdateCheckCacheFromJsonString = Schema.decodeUnknownEffect(Schema.fromJsonString(UpdateCheckCacheSchema));
+/**
+ * Effect service tag for update check management.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export class UpdateCheck extends ServiceMap.Service()("@agentxm/client-core/UpdateCheck") {
+}
+// -----------------------------------------------------------------------------
+// Pure helpers
+// -----------------------------------------------------------------------------
+/**
+ * Determine if the update check should be skipped.
+ */
+export const shouldSkip = (context) => context.isJsonOutput ||
+    context.noUpdateCheckEnv ||
+    context.isUpgradeCommand ||
+    (context.isNonInteractive && !context.isAgentSession) ||
+    (!context.isStderrTTY && !context.isAgentSession);
+const notificationCommand = (method) => {
+    switch (method._tag) {
+        case "Script":
+        case "Unknown":
+            return "axm upgrade";
+        case "Homebrew":
+            return "brew upgrade agentxm/tap/axm";
+        case "Npm":
+            return "npm update -g axm.sh";
+    }
+};
+/**
+ * Build an install-method-aware notification message.
+ */
+export const notificationMessage = (method, current, latest, audience = "human") => {
+    const command = notificationCommand(method);
+    if (audience === "agent") {
+        return `AXM_UPDATE_AVAILABLE current=${current} latest=${latest} command="${command}"`;
+    }
+    const header = `Update available: ${current} \u2192 ${latest}`;
+    return `${header}\nRun: ${command}`;
+};
+/**
+ * Check whether the cache is stale (older than 60 minutes).
+ */
+export const isCacheStale = (checkedAt, now) => {
+    const checkedDate = new Date(checkedAt);
+    if (isNaN(checkedDate.getTime()))
+        return true;
+    return now.getTime() - checkedDate.getTime() > CACHE_TTL_MS;
+};
+/**
+ * Compare versions to determine if an update is available.
+ * Returns true when remote version is greater than local.
+ */
+const isNewer = (localVersion, latestVersion) => {
+    const local = semver.valid(localVersion);
+    const remote = semver.valid(latestVersion);
+    if (local === null || remote === null)
+        return false;
+    return semver.lt(local, remote);
+};
+// -----------------------------------------------------------------------------
+// Core effects
+// -----------------------------------------------------------------------------
+/**
+ * Read and parse the cache file, returning None if missing, invalid, or stale.
+ */
+export const readCacheFromPath = (cachePath) => Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    const exists = yield* fs.exists(cachePath).pipe(Effect.catch(() => Effect.succeed(false)));
+    if (!exists)
+        return Option.none();
+    const content = yield* fs.readFileString(cachePath).pipe(Effect.option);
+    if (Option.isNone(content))
+        return Option.none();
+    const decoded = yield* decodeUpdateCheckCacheFromJsonString(content.value).pipe(Effect.option);
+    if (Option.isNone(decoded))
+        return Option.none();
+    const now = yield* Effect.sync(() => new Date());
+    if (isCacheStale(decoded.value.checkedAt, now))
+        return Option.none();
+    return Option.some(decoded.value);
+});
+/**
+ * Write the cache file with the given version and current timestamp.
+ */
+export const writeCacheToPath = (cachePath, latestVersion) => Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    const path = yield* Path.Path;
+    const dir = path.dirname(cachePath);
+    yield* fs.makeDirectory(dir, { recursive: true }).pipe(Effect.catch(() => Effect.void));
+    const now = yield* Effect.sync(() => new Date().toISOString());
+    const data = { latestVersion, checkedAt: now };
+    yield* fs
+        .writeFileString(cachePath, JSON.stringify(data))
+        .pipe(Effect.catch(() => Effect.void));
+});
+/**
+ * Check if an update is available by reading the cache and comparing versions.
+ */
+export const isUpdateAvailableFromPath = (cachePath, localVersion) => Effect.gen(function* () {
+    const cache = yield* readCacheFromPath(cachePath);
+    if (Option.isNone(cache))
+        return Option.none();
+    if (isNewer(localVersion, cache.value.latestVersion)) {
+        return Option.some({ current: localVersion, latest: cache.value.latestVersion });
+    }
+    return Option.none();
+});
+// -----------------------------------------------------------------------------
+// Live layer
+// -----------------------------------------------------------------------------
+export const UpdateCheckLive = Layer.effect(UpdateCheck, Effect.gen(function* () {
+    const pathService = yield* Path.Path;
+    const fs = yield* FileSystem.FileSystem;
+    const dataDir = yield* resolveAxmDataDir(pathService.join);
+    const cachePath = pathService.join(dataDir, CACHE_FILENAME);
+    const readCache = () => readCacheFromPath(cachePath).pipe(Effect.provideService(FileSystem.FileSystem, fs));
+    const writeCache = (latestVersion) => writeCacheToPath(cachePath, latestVersion).pipe(Effect.provideService(FileSystem.FileSystem, fs), Effect.provideService(Path.Path, pathService));
+    const isUpdateAvailable = (localVersion) => isUpdateAvailableFromPath(cachePath, localVersion).pipe(Effect.provideService(FileSystem.FileSystem, fs));
+    return {
+        readCache,
+        writeCache,
+        isUpdateAvailable,
+        shouldSkip,
+        notificationMessage,
+    };
+}));
+// -----------------------------------------------------------------------------
+// Test layer factory
+// -----------------------------------------------------------------------------
+/**
+ * Create an UpdateCheck layer for testing with a configurable cache path.
+ */
+export const UpdateCheckTest = (cachePath) => Layer.effect(UpdateCheck, Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    const pathService = yield* Path.Path;
+    const readCache = () => readCacheFromPath(cachePath).pipe(Effect.provideService(FileSystem.FileSystem, fs));
+    const writeCache = (latestVersion) => writeCacheToPath(cachePath, latestVersion).pipe(Effect.provideService(FileSystem.FileSystem, fs), Effect.provideService(Path.Path, pathService));
+    const isUpdateAvailable = (localVersion) => isUpdateAvailableFromPath(cachePath, localVersion).pipe(Effect.provideService(FileSystem.FileSystem, fs));
+    return {
+        readCache,
+        writeCache,
+        isUpdateAvailable,
+        shouldSkip,
+        notificationMessage,
+    };
+}));
+//# sourceMappingURL=update-check.js.map

package/dist/src/unstable/update-check/update-check.js.map

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

package/dist/src/unstable/utils/build-zip-archive.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Build a deterministic zip archive of a directory.
+ *
+ * Uses node:child_process and node:fs directly because this operation
+ * requires the system `zip` and `find` commands for deterministic archives.
+ * This is an intentional escape hatch from @effect/platform.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as Effect from "effect/Effect";
+/**
+ * Build a zip archive of a directory.
+ * Files are stored at the root of the zip (no enclosing directory).
+ *
+ * Copies the source directory to a temporary location before normalizing
+ * timestamps, so the original directory is never mutated.
+ */
+export declare const buildZipArchive: (dir: string, errorCode: string) => Effect.Effect<Uint8Array<ArrayBuffer>, import("../app-error/app-error.ts").AppError, never>;
+//# sourceMappingURL=build-zip-archive.d.ts.map

package/dist/src/unstable/utils/build-zip-archive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-zip-archive.d.ts","sourceRoot":"","sources":["../../../../src/unstable/utils/build-zip-archive.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAoBxC;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,GAAI,KAAK,MAAM,EAAE,WAAW,MAAM,gGAwC1D,CAAC"}

package/dist/src/unstable/utils/build-zip-archive.js

@@ -0,0 +1,66 @@
+/**
+ * Build a deterministic zip archive of a directory.
+ *
+ * Uses node:child_process and node:fs directly because this operation
+ * requires the system `zip` and `find` commands for deterministic archives.
+ * This is an intentional escape hatch from @effect/platform.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as Effect from "effect/Effect";
+import { makeAppError } from "../app-error/index.js";
+/**
+ * Check that a required system binary exists on PATH.
+ */
+const requireBinary = (name, errorCode) => Effect.tryPromise({
+    try: async () => {
+        const { execFileSync } = await import("node:child_process");
+        execFileSync("which", [name], { stdio: "pipe" });
+    },
+    catch: () => makeAppError({
+        code: errorCode,
+        what: `Required system command "${name}" not found`,
+        howToFix: `Install "${name}" and ensure it is available on your PATH.`,
+    }),
+});
+/**
+ * Build a zip archive of a directory.
+ * Files are stored at the root of the zip (no enclosing directory).
+ *
+ * Copies the source directory to a temporary location before normalizing
+ * timestamps, so the original directory is never mutated.
+ */
+export const buildZipArchive = (dir, errorCode) => Effect.gen(function* () {
+    yield* requireBinary("find", errorCode);
+    yield* requireBinary("zip", errorCode);
+    return yield* Effect.tryPromise({
+        try: async () => {
+            const { execFileSync } = await import("node:child_process");
+            const { readFile, mkdtemp, rm, cp } = await import("node:fs/promises");
+            const { tmpdir } = await import("node:os");
+            const p = await import("node:path");
+            const tmpDir = await mkdtemp(p.join(tmpdir(), "axm-publish-"));
+            const copyDir = p.join(tmpDir, "content");
+            const archivePath = p.join(tmpDir, "archive.zip");
+            // Copy source to temp directory to avoid mutating original timestamps
+            await cp(dir, copyDir, { recursive: true });
+            // Create deterministic zip (strip extra attributes, normalize timestamps)
+            // -X strips extra file attributes, -D disables directory entries
+            // find + touch normalizes file timestamps for reproducible archives
+            execFileSync("find", [copyDir, "-exec", "touch", "-t", "202001010000.00", "{}", "+"]);
+            execFileSync("zip", ["-r", "-q", "-X", "-D", archivePath, "."], {
+                cwd: copyDir,
+                stdio: "pipe",
+            });
+            const bytes = await readFile(archivePath);
+            await rm(tmpDir, { recursive: true, force: true });
+            return new Uint8Array(bytes);
+        },
+        catch: (e) => makeAppError({
+            code: errorCode,
+            what: "Failed to build zip archive",
+            cause: e,
+        }),
+    });
+});
+//# sourceMappingURL=build-zip-archive.js.map

package/dist/src/unstable/utils/build-zip-archive.js.map

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

package/dist/src/unstable/utils/create-symlink.d.ts

@@ -0,0 +1,25 @@
+import * as FileSystem from "effect/FileSystem";
+import * as Path from "effect/Path";
+import * as Effect from "effect/Effect";
+/**
+ * Result of a createSymlink operation.
+ *
+ * - `"created"` — new symlink was created
+ * - `"replaced"` — existing wrong symlink/directory was replaced
+ * - `"no-op"` — existing symlink already points to the correct target
+ * - `"skipped"` — self-reference detected (link and target resolve to same path)
+ */
+export type SymlinkResult = "created" | "replaced" | "no-op" | "skipped";
+/**
+ * Creates a relative symlink from `link` to `target`, handling the full
+ * symlink lifecycle: self-reference detection, existing link inspection,
+ * ELOOP recovery, directory replacement, and parent directory creation.
+ *
+ * Relative paths are computed using resolved parent directories to handle
+ * cases where parent directories are themselves symlinks.
+ */
+export declare const createSymlink: (opts: {
+    readonly target: string;
+    readonly link: string;
+}) => Effect.Effect<"created" | "replaced" | "no-op" | "skipped", import("../app-error/app-error.ts").AppError, FileSystem.FileSystem | Path.Path>;
+//# sourceMappingURL=create-symlink.d.ts.map

package/dist/src/unstable/utils/create-symlink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-symlink.d.ts","sourceRoot":"","sources":["../../../../src/unstable/utils/create-symlink.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AACpC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAKxC;;;;;;;GAOG;AACH,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,UAAU,GAAG,OAAO,GAAG,SAAS,CAAC;AAEzE;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,GAAI,MAAM;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,iJAsElF,CAAC"}

package/dist/src/unstable/utils/create-symlink.js

@@ -0,0 +1,89 @@
+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 { resolveParentSymlinks } from "./resolve-parent-symlinks.js";
+/**
+ * Creates a relative symlink from `link` to `target`, handling the full
+ * symlink lifecycle: self-reference detection, existing link inspection,
+ * ELOOP recovery, directory replacement, and parent directory creation.
+ *
+ * Relative paths are computed using resolved parent directories to handle
+ * cases where parent directories are themselves symlinks.
+ */
+export const createSymlink = (opts) => Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    const p = yield* Path.Path;
+    // Resolve both paths through parent symlinks for accurate comparison
+    const resolvedTarget = yield* resolveParentSymlinks(opts.target).pipe(Effect.mapError((e) => makeAppError({
+        code: "SYMLINK_CREATE_FAILED",
+        what: `Failed to resolve target path`,
+        cause: e,
+    })));
+    const resolvedLink = yield* resolveParentSymlinks(opts.link).pipe(
+    // Link parent may not exist yet — fall back to the raw path
+    Effect.catch(() => Effect.succeed(opts.link)));
+    // Self-reference detection: skip if both resolve to the same location
+    if (resolvedTarget === resolvedLink) {
+        return "skipped";
+    }
+    // Compute relative path from resolved parent dirs
+    const resolvedLinkParent = p.dirname(resolvedLink);
+    const relTarget = p.relative(resolvedLinkParent, resolvedTarget);
+    // Check what currently exists at the link path
+    const existingResult = yield* inspectExisting(fs, p, opts.link, resolvedTarget);
+    if (existingResult === "no-op")
+        return "no-op";
+    // If something exists that needs replacing, remove it
+    if (existingResult === "replace") {
+        yield* fs.remove(opts.link, { recursive: true }).pipe(Effect.mapError((e) => makeAppError({
+            code: "SYMLINK_CREATE_FAILED",
+            what: `Failed to remove existing path at ${opts.link}`,
+            cause: e,
+        })));
+    }
+    // Create parent directories
+    const linkParent = p.dirname(opts.link);
+    yield* fs.makeDirectory(linkParent, { recursive: true }).pipe(Effect.mapError((e) => makeAppError({
+        code: "SYMLINK_CREATE_FAILED",
+        what: `Failed to create parent directory ${linkParent}`,
+        cause: e,
+    })));
+    // Create the symlink
+    yield* fs.symlink(relTarget, opts.link).pipe(Effect.mapError((e) => makeAppError({
+        code: "SYMLINK_CREATE_FAILED",
+        what: `Failed to create symlink at ${opts.link}`,
+        cause: e,
+    })));
+    return existingResult === "replace" ? "replaced" : "created";
+});
+/**
+ * Inspect what exists at the link path.
+ *
+ * Uses readLink to detect symlinks (since Effect's FileSystem.stat always
+ * follows symlinks — there is no lstat equivalent). Falls back to stat
+ * for non-symlink entries.
+ */
+const inspectExisting = (fs, p, linkPath, resolvedAbsTarget) => Effect.gen(function* () {
+    // Try readLink first — succeeds only if linkPath is a symlink
+    const linkTarget = yield* fs.readLink(linkPath).pipe(Effect.option);
+    if (Option.isSome(linkTarget)) {
+        // It's a symlink — check if it points to the correct target
+        const linkParent = p.dirname(linkPath);
+        const currentAbsTarget = p.resolve(linkParent, linkTarget.value);
+        // Resolve through realpath for cases where parent dirs are symlinks
+        const resolvedCurrentTarget = yield* fs
+            .realPath(currentAbsTarget)
+            .pipe(Effect.catch(() => Effect.succeed(currentAbsTarget)));
+        if (resolvedCurrentTarget === resolvedAbsTarget)
+            return "no-op";
+        return "replace";
+    }
+    // Not a symlink — check if anything else exists (directory, file)
+    const stat = yield* fs.stat(linkPath).pipe(Effect.option);
+    if (Option.isSome(stat))
+        return "replace";
+    return "create";
+});
+//# sourceMappingURL=create-symlink.js.map

package/dist/src/unstable/utils/create-symlink.js.map

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

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

@@ -0,0 +1,37 @@
+/**
+ * Runtime environment detection utilities.
+ *
+ * Pure functions for env var / process checks. Effect-based for filesystem checks.
+ *
+ * CLI-specific detection (isCI, isNonInteractive, nonInteractiveFlag) lives in
+ * cli-flags/non-interactive.ts. This module covers general environment detection.
+ */
+import * as FileSystem from "effect/FileSystem";
+import * as Effect from "effect/Effect";
+import * as Option from "effect/Option";
+/** Read an optional env var. Centralized access point for process.env. */
+export declare const envOption: (name: string) => Effect.Effect<Option.Option<string>>;
+/** Read an env var with a default value. Centralized access point for process.env. */
+export declare const envWithDefault: (name: string, fallback: string) => Effect.Effect<string>;
+/** Returns true if SSH_CLIENT or SSH_TTY env var is set. */
+export declare const isSSH: Effect.Effect<boolean>;
+/** Returns true if running as root (uid 0). */
+export declare const isRoot: () => boolean;
+/** Returns true if /.dockerenv or /.containerenv exists. Requires FileSystem. */
+export declare const isContainer: Effect.Effect<boolean, never, FileSystem.FileSystem>;
+/**
+ * Pure data-dir resolution given explicit platform inputs.
+ * Shared by `resolveAxmDataDir` (reads process globals) and call sites
+ * that supply inputs directly for testability.
+ */
+export declare const resolveAxmDataDirPure: (pathJoin: (...segments: ReadonlyArray<string>) => string, platform: string, homeDir: string, localAppData: string | undefined) => string;
+/**
+ * Resolve the axm data directory using platform conventions.
+ *
+ * - Unix: `~/.axm/`
+ * - Windows: `%LOCALAPPDATA%\axm\`
+ */
+export declare const resolveAxmDataDir: (pathJoin: (...segments: ReadonlyArray<string>) => string) => Effect.Effect<string, never, never>;
+/** Returns true if /proc/version contains "microsoft". Requires FileSystem. */
+export declare const isWSL: Effect.Effect<boolean, never, FileSystem.FileSystem>;
+//# sourceMappingURL=environment.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"environment.d.ts","sourceRoot":"","sources":["../../../../src/unstable/utils/environment.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAKxC,0EAA0E;AAC1E,eAAO,MAAM,SAAS,GAAI,MAAM,MAAM,KAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAClB,CAAC;AAE3D,sFAAsF;AACtF,eAAO,MAAM,cAAc,GAAI,MAAM,MAAM,EAAE,UAAU,MAAM,KAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CACtC,CAAC;AAE/C,4DAA4D;AAC5D,eAAO,MAAM,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,CAExC,CAAC;AAEF,+CAA+C;AAC/C,eAAO,MAAM,MAAM,QAAO,OAAmC,CAAC;AAE9D,iFAAiF;AACjF,eAAO,MAAM,WAAW,sDAUtB,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,GAChC,UAAU,CAAC,GAAG,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,KAAK,MAAM,EACxD,UAAU,MAAM,EAChB,SAAS,MAAM,EACf,cAAc,MAAM,GAAG,SAAS,KAC/B,MAKF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,GAAI,UAAU,CAAC,GAAG,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,KAAK,MAAM,wCAMtF,CAAC;AAEL,+EAA+E;AAC/E,eAAO,MAAM,KAAK,sDAQhB,CAAC"}

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

@@ -0,0 +1,69 @@
+/**
+ * Runtime environment detection utilities.
+ *
+ * Pure functions for env var / process checks. Effect-based for filesystem checks.
+ *
+ * CLI-specific detection (isCI, isNonInteractive, nonInteractiveFlag) lives in
+ * cli-flags/non-interactive.ts. This module covers general environment detection.
+ */
+import * as FileSystem from "effect/FileSystem";
+import * as Effect from "effect/Effect";
+import * as Option from "effect/Option";
+// eslint-disable-next-line no-restricted-properties -- Centralized env var access point; all callers use these helpers
+const readEnv = (name) => process.env[name];
+/** Read an optional env var. Centralized access point for process.env. */
+export const envOption = (name) => Effect.sync(() => Option.fromUndefinedOr(readEnv(name)));
+/** Read an env var with a default value. Centralized access point for process.env. */
+export const envWithDefault = (name, fallback) => Effect.sync(() => readEnv(name) ?? fallback);
+/** Returns true if SSH_CLIENT or SSH_TTY env var is set. */
+export const isSSH = Effect.sync(() => readEnv("SSH_CLIENT") !== undefined || readEnv("SSH_TTY") !== undefined);
+/** Returns true if running as root (uid 0). */
+export const isRoot = () => process.getuid?.() === 0;
+/** Returns true if /.dockerenv or /.containerenv exists. Requires FileSystem. */
+export const isContainer = Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    const dockerExists = yield* fs
+        .exists("/.dockerenv")
+        .pipe(Effect.catch(() => Effect.succeed(false)));
+    if (dockerExists)
+        return true;
+    const containerExists = yield* fs
+        .exists("/.containerenv")
+        .pipe(Effect.catch(() => Effect.succeed(false)));
+    return containerExists;
+});
+/**
+ * Pure data-dir resolution given explicit platform inputs.
+ * Shared by `resolveAxmDataDir` (reads process globals) and call sites
+ * that supply inputs directly for testability.
+ */
+export const resolveAxmDataDirPure = (pathJoin, platform, homeDir, localAppData) => {
+    if (platform === "win32" && localAppData !== undefined) {
+        return pathJoin(localAppData, "axm");
+    }
+    return pathJoin(homeDir, ".axm");
+};
+/**
+ * Resolve the axm data directory using platform conventions.
+ *
+ * - Unix: `~/.axm/`
+ * - Windows: `%LOCALAPPDATA%\axm\`
+ */
+export const resolveAxmDataDir = (pathJoin) => Effect.sync(() => {
+    const platform = process.platform;
+    const localAppData = readEnv("LOCALAPPDATA");
+    const homeDir = readEnv("HOME") ?? readEnv("USERPROFILE") ?? readEnv("HOMEPATH") ?? "/tmp";
+    return resolveAxmDataDirPure(pathJoin, platform, homeDir, localAppData);
+});
+/** Returns true if /proc/version contains "microsoft". Requires FileSystem. */
+export const isWSL = Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    const exists = yield* fs.exists("/proc/version").pipe(Effect.catch(() => Effect.succeed(false)));
+    if (!exists)
+        return false;
+    const content = yield* fs
+        .readFileString("/proc/version")
+        .pipe(Effect.catch(() => Effect.succeed("")));
+    return /microsoft/i.test(content);
+});
+//# sourceMappingURL=environment.js.map