@agentxm/client-core 0.1.6

package/dist/src/unstable/workspace/initialization.d.ts

@@ -0,0 +1,225 @@
+/**
+ * Workspace initialization logic.
+ *
+ * Handles initial setup of project and user-scope workspaces: agent detection,
+ * interactive agent selection, and settings/lockfile creation.
+ *
+ * @internal
+ */
+import * as FileSystem from "effect/FileSystem";
+import * as Path from "effect/Path";
+import * as Effect from "effect/Effect";
+import { CliRenderer } from "../cli-renderer/index.js";
+import type { WorkspaceContextOptions } from "./service-interface.js";
+import { type WorkspaceLocation } from "./paths.js";
+/**
+ * Initialize project workspace by detecting and selecting agents.
+ *
+ * @param localDir - Path to local .axm directory
+ * @param options - Workspace context options
+ * @returns Effect yielding selected agent IDs
+ */
+export declare const initializeProjectWorkspace: (localDir: string, options: WorkspaceContextOptions) => Effect.Effect<{
+    readonly skills?: {
+        readonly [x: string]: {
+            readonly source: string;
+            readonly enabled: boolean;
+        };
+    } | undefined;
+    readonly commands?: {
+        readonly [x: string]: {
+            readonly source: string;
+            readonly enabled: boolean;
+        };
+    } | undefined;
+    readonly subagents?: {
+        readonly [x: string]: {
+            readonly source: string;
+            readonly enabled: boolean;
+        };
+    } | undefined;
+    readonly packs?: {
+        readonly [x: string]: {
+            readonly source: string;
+        };
+    } | undefined;
+    readonly agents?: readonly ("adal" | "amp" | "antigravity" | "augment" | "claude-code" | "cline" | "codebuddy" | "codex" | "command-code" | "continue" | "crush" | "cursor" | "droid" | "gemini-cli" | "github-copilot" | "goose" | "iflow-cli" | "junie" | "kilo" | "kimi-cli" | "kiro-cli" | "kode" | "mcpjam" | "mistral-vibe" | "mux" | "neovate" | "openclaw" | "opencode" | "openhands" | "pi" | "pochi" | "qoder" | "qwen-code" | "replit" | "roo" | "trae" | "trae-cn" | "windsurf" | "zencoder")[] | undefined;
+    readonly mcpServers?: {
+        readonly [x: string]: {
+            readonly source: string;
+        };
+    } | undefined;
+    readonly telemetry?: boolean | "errors" | undefined;
+    readonly profile?: (string & import("effect/Brand").Brand<"Handle">) | undefined;
+    readonly sources?: readonly ({
+        readonly name: string;
+        readonly type: "github";
+        readonly url: URL;
+    } | {
+        readonly name: string;
+        readonly type: "gitlab";
+        readonly url: URL;
+    } | {
+        readonly name: string;
+        readonly type: "bitbucket";
+        readonly url: URL;
+    } | {
+        readonly name: string;
+        readonly type: "azurerepos";
+        readonly url: URL;
+    } | {
+        readonly name: string;
+        readonly type: "registry";
+        readonly location: URL;
+    })[] | undefined;
+    readonly ignored?: {
+        readonly skills?: readonly string[] | undefined;
+        readonly commands?: readonly string[] | undefined;
+        readonly subagents?: readonly string[] | undefined;
+        readonly packs?: readonly string[] | undefined;
+        readonly mcpServers?: readonly string[] | undefined;
+    } | undefined;
+}, import("../app-error/app-error.ts").AppError | import("../cli-prompt/prompt-cancelled.ts").PromptCancelled, FileSystem.FileSystem | Path.Path | "effect/unstable/cli/GlobalFlag/axm-non-interactive" | CliRenderer>;
+/**
+ * Ensure user-scope workspace directory has settings.json and axm-lock.yaml.
+ *
+ * Creates missing files with empty defaults.
+ *
+ * @param globalDir - Path to user-scope .axm directory
+ */
+export declare const ensureGlobalWorkspaceInitialized: (globalDir: string) => Effect.Effect<void, import("../app-error/app-error.ts").AppError, FileSystem.FileSystem | Path.Path>;
+/**
+ * Ensure project workspace is initialized, returning local settings.
+ *
+ * Reads existing local settings or runs the initialization flow when missing.
+ *
+ * @param localDir - Path to local .axm directory
+ * @param options - Workspace context options
+ * @returns Effect yielding local Settings
+ */
+export declare const ensureProjectWorkspaceInitialized: (localDir: string, options: WorkspaceContextOptions) => Effect.Effect<{
+    readonly skills?: {
+        readonly [x: string]: {
+            readonly source: string;
+            readonly enabled: boolean;
+        };
+    } | undefined;
+    readonly commands?: {
+        readonly [x: string]: {
+            readonly source: string;
+            readonly enabled: boolean;
+        };
+    } | undefined;
+    readonly subagents?: {
+        readonly [x: string]: {
+            readonly source: string;
+            readonly enabled: boolean;
+        };
+    } | undefined;
+    readonly packs?: {
+        readonly [x: string]: {
+            readonly source: string;
+        };
+    } | undefined;
+    readonly agents?: readonly ("adal" | "amp" | "antigravity" | "augment" | "claude-code" | "cline" | "codebuddy" | "codex" | "command-code" | "continue" | "crush" | "cursor" | "droid" | "gemini-cli" | "github-copilot" | "goose" | "iflow-cli" | "junie" | "kilo" | "kimi-cli" | "kiro-cli" | "kode" | "mcpjam" | "mistral-vibe" | "mux" | "neovate" | "openclaw" | "opencode" | "openhands" | "pi" | "pochi" | "qoder" | "qwen-code" | "replit" | "roo" | "trae" | "trae-cn" | "windsurf" | "zencoder")[] | undefined;
+    readonly mcpServers?: {
+        readonly [x: string]: {
+            readonly source: string;
+        };
+    } | undefined;
+    readonly telemetry?: boolean | "errors" | undefined;
+    readonly profile?: (string & import("effect/Brand").Brand<"Handle">) | undefined;
+    readonly sources?: readonly ({
+        readonly name: string;
+        readonly type: "github";
+        readonly url: URL;
+    } | {
+        readonly name: string;
+        readonly type: "gitlab";
+        readonly url: URL;
+    } | {
+        readonly name: string;
+        readonly type: "bitbucket";
+        readonly url: URL;
+    } | {
+        readonly name: string;
+        readonly type: "azurerepos";
+        readonly url: URL;
+    } | {
+        readonly name: string;
+        readonly type: "registry";
+        readonly location: URL;
+    })[] | undefined;
+    readonly ignored?: {
+        readonly skills?: readonly string[] | undefined;
+        readonly commands?: readonly string[] | undefined;
+        readonly subagents?: readonly string[] | undefined;
+        readonly packs?: readonly string[] | undefined;
+        readonly mcpServers?: readonly string[] | undefined;
+    } | undefined;
+}, import("../app-error/app-error.ts").AppError | import("../cli-prompt/prompt-cancelled.ts").PromptCancelled, FileSystem.FileSystem | Path.Path | "effect/unstable/cli/GlobalFlag/axm-non-interactive" | CliRenderer>;
+export declare const bootstrapWorkspace: (options: WorkspaceContextOptions) => Effect.Effect<{
+    settings: {
+        readonly skills?: {
+            readonly [x: string]: {
+                readonly source: string;
+                readonly enabled: boolean;
+            };
+        } | undefined;
+        readonly commands?: {
+            readonly [x: string]: {
+                readonly source: string;
+                readonly enabled: boolean;
+            };
+        } | undefined;
+        readonly subagents?: {
+            readonly [x: string]: {
+                readonly source: string;
+                readonly enabled: boolean;
+            };
+        } | undefined;
+        readonly packs?: {
+            readonly [x: string]: {
+                readonly source: string;
+            };
+        } | undefined;
+        readonly agents?: readonly ("adal" | "amp" | "antigravity" | "augment" | "claude-code" | "cline" | "codebuddy" | "codex" | "command-code" | "continue" | "crush" | "cursor" | "droid" | "gemini-cli" | "github-copilot" | "goose" | "iflow-cli" | "junie" | "kilo" | "kimi-cli" | "kiro-cli" | "kode" | "mcpjam" | "mistral-vibe" | "mux" | "neovate" | "openclaw" | "opencode" | "openhands" | "pi" | "pochi" | "qoder" | "qwen-code" | "replit" | "roo" | "trae" | "trae-cn" | "windsurf" | "zencoder")[] | undefined;
+        readonly mcpServers?: {
+            readonly [x: string]: {
+                readonly source: string;
+            };
+        } | undefined;
+        readonly telemetry?: boolean | "errors" | undefined;
+        readonly profile?: (string & import("effect/Brand").Brand<"Handle">) | undefined;
+        readonly sources?: readonly ({
+            readonly name: string;
+            readonly type: "github";
+            readonly url: URL;
+        } | {
+            readonly name: string;
+            readonly type: "gitlab";
+            readonly url: URL;
+        } | {
+            readonly name: string;
+            readonly type: "bitbucket";
+            readonly url: URL;
+        } | {
+            readonly name: string;
+            readonly type: "azurerepos";
+            readonly url: URL;
+        } | {
+            readonly name: string;
+            readonly type: "registry";
+            readonly location: URL;
+        })[] | undefined;
+        readonly ignored?: {
+            readonly skills?: readonly string[] | undefined;
+            readonly commands?: readonly string[] | undefined;
+            readonly subagents?: readonly string[] | undefined;
+            readonly packs?: readonly string[] | undefined;
+            readonly mcpServers?: readonly string[] | undefined;
+        } | undefined;
+    };
+    location: WorkspaceLocation;
+}, import("../app-error/app-error.ts").AppError | import("../cli-prompt/prompt-cancelled.ts").PromptCancelled, FileSystem.FileSystem | Path.Path | "effect/unstable/cli/GlobalFlag/axm-non-interactive" | CliRenderer>;
+//# sourceMappingURL=initialization.d.ts.map

package/dist/src/unstable/workspace/initialization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"initialization.d.ts","sourceRoot":"","sources":["../../../../src/unstable/workspace/initialization.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AAEpC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAMxC,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AASvD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAEtE,OAAO,EAAE,KAAK,iBAAiB,EAAa,MAAM,YAAY,CAAC;AAQ/D;;;;;;GAMG;AACH,eAAO,MAAM,0BAA0B,GAAI,UAAU,MAAM,EAAE,SAAS,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sNAoEzF,CAAC;AAEL;;;;;;GAMG;AACH,eAAO,MAAM,gCAAgC,GAAI,WAAW,MAAM,yGAmC9D,CAAC;AAEL;;;;;;;;GAQG;AACH,eAAO,MAAM,iCAAiC,GAC5C,UAAU,MAAM,EAChB,SAAS,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sNAkB9B,CAAC;AAEL,eAAO,MAAM,kBAAkB,GAAI,SAAS,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sNAoB/D,CAAC"}

package/dist/src/unstable/workspace/initialization.js

@@ -0,0 +1,156 @@
+/**
+ * Workspace initialization logic.
+ *
+ * Handles initial setup of project and user-scope workspaces: agent detection,
+ * interactive agent selection, and settings/lockfile creation.
+ *
+ * @internal
+ */
+import * as FileSystem from "effect/FileSystem";
+import * as Path from "effect/Path";
+import * as Array from "effect/Array";
+import * as Effect from "effect/Effect";
+import * as Option from "effect/Option";
+import { detectAgents, getAllAgents, getAgentById } from "../agents/index.js";
+import { isNonInteractive } from "../cli-flags/index.js";
+import { makeAppError } from "../app-error/index.js";
+import { CliRenderer } from "../cli-renderer/index.js";
+import { LOCKFILE_NAME, writeLockfile } from "../lockfile/index.js";
+import { createDefaultSettings, readSettings, SETTINGS_FILENAME, writeSettings, } from "../settings/index.js";
+import { WorkspaceInitializationInteraction } from "./initialization-interaction.js";
+import { getAxmDir } from "./paths.js";
+const SELECT_AGENTS_PROMPT_MISSING = makeAppError({
+    code: "PROMPT_REQUIRED",
+    what: "Interactive prompt required: Select agents to configure",
+    howToFix: "Provide WorkspaceInitializationInteraction in the runtime.",
+});
+/**
+ * Initialize project workspace by detecting and selecting agents.
+ *
+ * @param localDir - Path to local .axm directory
+ * @param options - Workspace context options
+ * @returns Effect yielding selected agent IDs
+ */
+export const initializeProjectWorkspace = (localDir, options) => Effect.gen(function* () {
+    const nonInteractive = yield* isNonInteractive;
+    // Select agents based on options
+    let selectedAgents;
+    // If explicit agents are provided, use those (no detection needed)
+    const agents = options.agents;
+    if (agents !== undefined && agents.length > 0) {
+        const renderer = yield* CliRenderer;
+        const requestedIds = [...agents];
+        selectedAgents = requestedIds.flatMap((id) => {
+            const agent = getAgentById(id);
+            return Option.isSome(agent) ? [agent.value] : [];
+        });
+        const unrecognized = requestedIds.filter((id) => Option.isNone(getAgentById(id)));
+        if (unrecognized.length > 0) {
+            yield* renderer.warn(`Unrecognized agent(s): ${unrecognized.join(", ")}. Use 'axm init --help' to see available agents.`);
+        }
+    }
+    else {
+        // Detect installed agents
+        const detectedAgents = yield* detectAgents(process.cwd()).pipe(Effect.mapError((error) => makeAppError({
+            code: "WORKSPACE_INITIALIZATION_FAILED",
+            what: `Failed to detect agents: ${error.message}`,
+            cause: error,
+        })));
+        if (nonInteractive) {
+            // Non-interactive mode: auto-select all detected agents
+            selectedAgents = detectedAgents;
+        }
+        else {
+            // Interactive mode — single multiselect with detected agents pre-selected
+            const interaction = yield* Effect.serviceOption(WorkspaceInitializationInteraction);
+            const allAgents = getAllAgents();
+            const detectedIds = Array.map(detectedAgents, (a) => a.id);
+            const selectedIds = Option.isSome(interaction)
+                ? yield* interaction.value.selectAgents({
+                    allAgents,
+                    detectedIds,
+                })
+                : yield* SELECT_AGENTS_PROMPT_MISSING;
+            selectedAgents = [...selectedIds].flatMap((id) => {
+                const agent = getAgentById(id);
+                return Option.isSome(agent) ? [agent.value] : [];
+            });
+        }
+    }
+    // Extract agent IDs for settings
+    const agentIds = selectedAgents.map((a) => a.id);
+    // Create settings with selected agents (satisfies ensures type safety without cast)
+    const settings = { agents: agentIds };
+    yield* writeSettings(localDir, settings);
+    // Create empty lockfile
+    yield* writeLockfile(localDir, { lockfileVersion: 1, skills: {} });
+    return settings;
+});
+/**
+ * Ensure user-scope workspace directory has settings.json and axm-lock.yaml.
+ *
+ * Creates missing files with empty defaults.
+ *
+ * @param globalDir - Path to user-scope .axm directory
+ */
+export const ensureGlobalWorkspaceInitialized = (globalDir) => Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    const path = yield* Path.Path;
+    const settingsPath = path.join(globalDir, SETTINGS_FILENAME);
+    const lockfilePath = path.join(globalDir, LOCKFILE_NAME);
+    const settingsExists = yield* fs.exists(settingsPath).pipe(Effect.mapError((error) => makeAppError({
+        code: "SETTINGS_PARSE_FAILED",
+        what: `Failed to check if settings file exists: ${settingsPath}`,
+        cause: error,
+    })));
+    const lockfileExists = yield* fs.exists(lockfilePath).pipe(Effect.mapError((error) => makeAppError({
+        code: "LOCKFILE_PARSE_FAILED",
+        what: `Failed to check if lockfile exists: ${lockfilePath}`,
+        cause: error,
+    })));
+    // Create settings.json with {} if missing
+    if (!settingsExists) {
+        yield* writeSettings(globalDir, {});
+    }
+    // Create axm-lock.yaml with version 1, empty skills if missing
+    if (!lockfileExists) {
+        yield* writeLockfile(globalDir, { lockfileVersion: 1, skills: {} });
+    }
+});
+/**
+ * Ensure project workspace is initialized, returning local settings.
+ *
+ * Reads existing local settings or runs the initialization flow when missing.
+ *
+ * @param localDir - Path to local .axm directory
+ * @param options - Workspace context options
+ * @returns Effect yielding local Settings
+ */
+export const ensureProjectWorkspaceInitialized = (localDir, options) => Effect.gen(function* () {
+    const localSettingsResult = yield* readSettings(localDir).pipe(Effect.map(Option.match({
+        onNone: () => ({ found: false, settings: createDefaultSettings() }),
+        onSome: (s) => ({ found: true, settings: s }),
+    })));
+    if (!localSettingsResult.found) {
+        // Initialize project workspace and return the settings it wrote
+        return yield* initializeProjectWorkspace(localDir, options);
+    }
+    return localSettingsResult.settings;
+});
+export const bootstrapWorkspace = (options) => Effect.gen(function* () {
+    const path = yield* Path.Path;
+    const workspaceDir = yield* getAxmDir(options.scope);
+    const location = {
+        scope: options.scope,
+        path: workspaceDir,
+        baseDir: path.dirname(workspaceDir),
+    };
+    if (options.scope === "user") {
+        yield* ensureGlobalWorkspaceInitialized(workspaceDir);
+        const settings = yield* readSettings(workspaceDir).pipe(Effect.map(Option.getOrElse(() => createDefaultSettings())));
+        return { settings, location };
+    }
+    const settings = yield* ensureProjectWorkspaceInitialized(workspaceDir, options);
+    return { settings, location };
+});
+//# sourceMappingURL=initialization.js.map

package/dist/src/unstable/workspace/initialization.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"initialization.js","sourceRoot":"","sources":["../../../../src/unstable/workspace/initialization.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AACpC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,EAAwB,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACpG,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACpE,OAAO,EACL,qBAAqB,EACrB,YAAY,EACZ,iBAAiB,EAEjB,aAAa,GACd,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,kCAAkC,EAAE,MAAM,iCAAiC,CAAC;AACrF,OAAO,EAA0B,SAAS,EAAE,MAAM,YAAY,CAAC;AAE/D,MAAM,4BAA4B,GAAG,YAAY,CAAC;IAChD,IAAI,EAAE,iBAAiB;IACvB,IAAI,EAAE,yDAAyD;IAC/D,QAAQ,EAAE,4DAA4D;CACvE,CAAC,CAAC;AAEH;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,QAAgB,EAAE,OAAgC,EAAE,EAAE,CAC/F,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,cAAc,GAAG,KAAK,CAAC,CAAC,gBAAgB,CAAC;IAE/C,iCAAiC;IACjC,IAAI,cAA8C,CAAC;IAEnD,mEAAmE;IACnE,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAC9B,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9C,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,WAAW,CAAC;QACpC,MAAM,YAAY,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC;QACjC,cAAc,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE;YAC3C,MAAM,KAAK,GAAG,YAAY,CAAC,EAAE,CAAC,CAAC;YAC/B,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACnD,CAAC,CAAC,CAAC;QACH,MAAM,YAAY,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAClF,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5B,KAAK,CAAC,CAAC,QAAQ,CAAC,IAAI,CAClB,0BAA0B,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,kDAAkD,CACpG,CAAC;QACJ,CAAC;IACH,CAAC;SAAM,CAAC;QACN,0BAA0B;QAC1B,MAAM,cAAc,GAAG,KAAK,CAAC,CAAC,YAAY,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,CAC5D,MAAM,CAAC,QAAQ,CAAC,CAAC,KAAK,EAAE,EAAE,CACxB,YAAY,CAAC;YACX,IAAI,EAAE,iCAAiC;YACvC,IAAI,EAAE,4BAA4B,KAAK,CAAC,OAAO,EAAE;YACjD,KAAK,EAAE,KAAK;SACb,CAAC,CACH,CACF,CAAC;QAEF,IAAI,cAAc,EAAE,CAAC;YACnB,wDAAwD;YACxD,cAAc,GAAG,cAAc,CAAC;QAClC,CAAC;aAAM,CAAC;YACN,0EAA0E;YAC1E,MAAM,WAAW,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,kCAAkC,CAAC,CAAC;YACpF,MAAM,SAAS,GAAG,YAAY,EAAE,CAAC;YACjC,MAAM,WAAW,GAAG,KAAK,CAAC,GAAG,CAAC,cAAc,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAE3D,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC;gBAC5C,CAAC,CAAC,KAAK,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,YAAY,CAAC;oBACpC,SAAS;oBACT,WAAW;iBACZ,CAAC;gBACJ,CAAC,CAAC,KAAK,CAAC,CAAC,4BAA4B,CAAC;YAExC,cAAc,GAAG,CAAC,GAAG,WAAW,CAAC,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE;gBAC/C,MAAM,KAAK,GAAG,YAAY,CAAC,EAAE,CAAC,CAAC;gBAC/B,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACnD,CAAC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,iCAAiC;IACjC,MAAM,QAAQ,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAEjD,oFAAoF;IACpF,MAAM,QAAQ,GAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;IAChD,KAAK,CAAC,CAAC,aAAa,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAEzC,wBAAwB;IACxB,KAAK,CAAC,CAAC,aAAa,CAAC,QAAQ,EAAE,EAAE,eAAe,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC;IAEnE,OAAO,QAAQ,CAAC;AAClB,CAAC,CAAC,CAAC;AAEL;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAAC,SAAiB,EAAE,EAAE,CACpE,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC;IACxC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;IAC9B,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,iBAAiB,CAAC,CAAC;IAC7D,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;IAEzD,MAAM,cAAc,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,IAAI,CACxD,MAAM,CAAC,QAAQ,CAAC,CAAC,KAAK,EAAE,EAAE,CACxB,YAAY,CAAC;QACX,IAAI,EAAE,uBAAuB;QAC7B,IAAI,EAAE,4CAA4C,YAAY,EAAE;QAChE,KAAK,EAAE,KAAK;KACb,CAAC,CACH,CACF,CAAC;IACF,MAAM,cAAc,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,IAAI,CACxD,MAAM,CAAC,QAAQ,CAAC,CAAC,KAAK,EAAE,EAAE,CACxB,YAAY,CAAC;QACX,IAAI,EAAE,uBAAuB;QAC7B,IAAI,EAAE,uCAAuC,YAAY,EAAE;QAC3D,KAAK,EAAE,KAAK;KACb,CAAC,CACH,CACF,CAAC;IAEF,0CAA0C;IAC1C,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,KAAK,CAAC,CAAC,aAAa,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;IACtC,CAAC;IAED,+DAA+D;IAC/D,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,KAAK,CAAC,CAAC,aAAa,CAAC,SAAS,EAAE,EAAE,eAAe,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC;IACtE,CAAC;AACH,CAAC,CAAC,CAAC;AAEL;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,iCAAiC,GAAG,CAC/C,QAAgB,EAChB,OAAgC,EAChC,EAAE,CACF,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,mBAAmB,GAAG,KAAK,CAAC,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,IAAI,CAC5D,MAAM,CAAC,GAAG,CACR,MAAM,CAAC,KAAK,CAAC;QACX,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,KAAc,EAAE,QAAQ,EAAE,qBAAqB,EAAE,EAAE,CAAC;QAC5E,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,IAAa,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;KACvD,CAAC,CACH,CACF,CAAC;IAEF,IAAI,CAAC,mBAAmB,CAAC,KAAK,EAAE,CAAC;QAC/B,gEAAgE;QAChE,OAAO,KAAK,CAAC,CAAC,0BAA0B,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC9D,CAAC;IAED,OAAO,mBAAmB,CAAC,QAAQ,CAAC;AACtC,CAAC,CAAC,CAAC;AAEL,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,OAAgC,EAAE,EAAE,CACrE,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;IAC9B,MAAM,YAAY,GAAG,KAAK,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACrD,MAAM,QAAQ,GAAsB;QAClC,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,IAAI,EAAE,YAAY;QAClB,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC;KACpC,CAAC;IAEF,IAAI,OAAO,CAAC,KAAK,KAAK,MAAM,EAAE,CAAC;QAC7B,KAAK,CAAC,CAAC,gCAAgC,CAAC,YAAY,CAAC,CAAC;QACtD,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC,IAAI,CACrD,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC,qBAAqB,EAAE,CAAC,CAAC,CAC5D,CAAC;QACF,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;IAChC,CAAC;IAED,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,iCAAiC,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IACjF,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;AAChC,CAAC,CAAC,CAAC"}

package/dist/src/unstable/workspace/paths.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Path utilities for axm directory resolution.
+ *
+ * Provides functions to determine the location of axm configuration directories
+ * for both user and project configuration scopes.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import * as Path from "effect/Path";
+import * as Effect from "effect/Effect";
+import type { WorkspaceScope } from "./scope.js";
+export interface WorkspaceLocation {
+    readonly scope: WorkspaceScope;
+    readonly path: string;
+    readonly baseDir: string;
+}
+/**
+ * Returns the user-scope axm directory path (~/.axm).
+ *
+ * The user-scope directory stores user-level configuration and installed skills.
+ *
+ * @returns Effect yielding absolute path to the user-scope axm directory
+ *
+ * @experimental This API is unstable and may change without notice.
+ *
+ * @example
+ * ```typescript
+ * import { getUserScopeDir } from "./workspace/paths";
+ *
+ * const userScopeDir = yield* getUserScopeDir();
+ * // => "/Users/username/.axm" (macOS/Linux)
+ * // => "C:\\Users\\username\\.axm" (Windows)
+ * ```
+ */
+export declare const getUserScopeDir: () => Effect.Effect<string, never, Path.Path>;
+/**
+ * Returns the project-level axm directory path (./.axm).
+ *
+ * The project directory stores project-specific configuration and skills.
+ *
+ * @returns Effect yielding absolute path to the project axm directory (relative to cwd)
+ *
+ * @experimental This API is unstable and may change without notice.
+ *
+ * @example
+ * ```typescript
+ * import { getProjectDir } from "./workspace/paths";
+ *
+ * const projectDir = yield* getProjectDir();
+ * // => "/path/to/project/.axm"
+ * ```
+ */
+export declare const getProjectDir: () => Effect.Effect<string, never, Path.Path>;
+/**
+ * Returns the axm directory path based on configuration scope.
+ *
+ * - When `scope` is `"user"`, returns the user-scope directory (~/.axm)
+ * - When `scope` is `"project"`, returns the project directory (./.axm)
+ *
+ * @param scope - Workspace scope (`"project"` or `"user"`)
+ * @returns Effect yielding absolute path to the appropriate axm directory
+ *
+ * @experimental This API is unstable and may change without notice.
+ *
+ * @example
+ * ```typescript
+ * import { getAxmDir } from "./workspace/paths";
+ *
+ * // Project-level directory
+ * const projectDir = yield* getAxmDir("project");
+ * // => "/path/to/project/.axm"
+ *
+ * // User-scope directory
+ * const userScopeDir = yield* getAxmDir("user");
+ * // => "/Users/username/.axm"
+ * ```
+ */
+export declare const getAxmDir: (scope: WorkspaceScope) => Effect.Effect<string, never, Path.Path>;
+export declare const locateWorkspace: (scope: WorkspaceScope) => Effect.Effect<WorkspaceLocation, never, Path.Path>;
+//# sourceMappingURL=paths.d.ts.map

package/dist/src/unstable/workspace/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../../../src/unstable/workspace/paths.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AACpC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAMD;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,eAAe,QAAO,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,IAAI,CAKrE,CAAC;AAEL;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,aAAa,QAAO,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,IAAI,CAKnE,CAAC;AAEL;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,SAAS,GAAI,OAAO,cAAc,KAAG,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,IAAI,CAChC,CAAC;AAEzD,eAAO,MAAM,eAAe,GAC1B,OAAO,cAAc,KACpB,MAAM,CAAC,MAAM,CAAC,iBAAiB,EAAE,KAAK,EAAE,IAAI,CAAC,IAAI,CAUhD,CAAC"}

package/dist/src/unstable/workspace/paths.js

@@ -0,0 +1,95 @@
+/**
+ * Path utilities for axm directory resolution.
+ *
+ * Provides functions to determine the location of axm configuration directories
+ * for both user and project configuration scopes.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import * as os from "node:os";
+import * as Path from "effect/Path";
+import * as Effect from "effect/Effect";
+// -----------------------------------------------------------------------------
+// Public API
+// -----------------------------------------------------------------------------
+/**
+ * Returns the user-scope axm directory path (~/.axm).
+ *
+ * The user-scope directory stores user-level configuration and installed skills.
+ *
+ * @returns Effect yielding absolute path to the user-scope axm directory
+ *
+ * @experimental This API is unstable and may change without notice.
+ *
+ * @example
+ * ```typescript
+ * import { getUserScopeDir } from "./workspace/paths";
+ *
+ * const userScopeDir = yield* getUserScopeDir();
+ * // => "/Users/username/.axm" (macOS/Linux)
+ * // => "C:\\Users\\username\\.axm" (Windows)
+ * ```
+ */
+export const getUserScopeDir = () => Effect.gen(function* () {
+    const path = yield* Path.Path;
+    const home = yield* Effect.sync(() => os.homedir());
+    return path.join(home, ".axm");
+});
+/**
+ * Returns the project-level axm directory path (./.axm).
+ *
+ * The project directory stores project-specific configuration and skills.
+ *
+ * @returns Effect yielding absolute path to the project axm directory (relative to cwd)
+ *
+ * @experimental This API is unstable and may change without notice.
+ *
+ * @example
+ * ```typescript
+ * import { getProjectDir } from "./workspace/paths";
+ *
+ * const projectDir = yield* getProjectDir();
+ * // => "/path/to/project/.axm"
+ * ```
+ */
+export const getProjectDir = () => Effect.gen(function* () {
+    const path = yield* Path.Path;
+    const cwd = yield* Effect.sync(() => process.cwd());
+    return path.join(cwd, ".axm");
+});
+/**
+ * Returns the axm directory path based on configuration scope.
+ *
+ * - When `scope` is `"user"`, returns the user-scope directory (~/.axm)
+ * - When `scope` is `"project"`, returns the project directory (./.axm)
+ *
+ * @param scope - Workspace scope (`"project"` or `"user"`)
+ * @returns Effect yielding absolute path to the appropriate axm directory
+ *
+ * @experimental This API is unstable and may change without notice.
+ *
+ * @example
+ * ```typescript
+ * import { getAxmDir } from "./workspace/paths";
+ *
+ * // Project-level directory
+ * const projectDir = yield* getAxmDir("project");
+ * // => "/path/to/project/.axm"
+ *
+ * // User-scope directory
+ * const userScopeDir = yield* getAxmDir("user");
+ * // => "/Users/username/.axm"
+ * ```
+ */
+export const getAxmDir = (scope) => scope === "user" ? getUserScopeDir() : getProjectDir();
+export const locateWorkspace = (scope) => Effect.gen(function* () {
+    const path = yield* Path.Path;
+    const workspacePath = yield* getAxmDir(scope);
+    return {
+        scope,
+        path: workspacePath,
+        baseDir: path.dirname(workspacePath),
+    };
+});
+//# sourceMappingURL=paths.js.map

package/dist/src/unstable/workspace/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../../../src/unstable/workspace/paths.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AACpC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AASxC,gFAAgF;AAChF,aAAa;AACb,gFAAgF;AAEhF;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,GAA4C,EAAE,CAC3E,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;IAC9B,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;IACpD,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AACjC,CAAC,CAAC,CAAC;AAEL;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,GAA4C,EAAE,CACzE,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;IAC9B,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IACpD,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;AAChC,CAAC,CAAC,CAAC;AAEL;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,KAAqB,EAA2C,EAAE,CAC1F,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;AAEzD,MAAM,CAAC,MAAM,eAAe,GAAG,CAC7B,KAAqB,EAC+B,EAAE,CACtD,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;IAC9B,MAAM,aAAa,GAAG,KAAK,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAE9C,OAAO;QACL,KAAK;QACL,IAAI,EAAE,aAAa;QACnB,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC;KACT,CAAC;AAChC,CAAC,CAAC,CAAC"}