@axm.sh/cli 0.0.1

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

@@ -0,0 +1,194 @@
+/**
+ * Schema definitions for AXM settings configuration.
+ *
+ * Settings define global configuration including sources, agents, and extensions.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as Schema from "effect/Schema";
+/**
+ * GitHub source configuration.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+declare const GitHubSourceConfigSchema: Schema.Struct<{
+    name: Schema.filter<typeof Schema.String>;
+    type: Schema.Literal<["github"]>;
+    url: typeof Schema.URL;
+}>;
+/**
+ * GitLab source configuration.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+declare const GitLabSourceConfigSchema: Schema.Struct<{
+    name: Schema.filter<typeof Schema.String>;
+    type: Schema.Literal<["gitlab"]>;
+    url: typeof Schema.URL;
+}>;
+/**
+ * Bitbucket source configuration.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+declare const BitbucketSourceConfigSchema: Schema.Struct<{
+    name: Schema.filter<typeof Schema.String>;
+    type: Schema.Literal<["bitbucket"]>;
+    url: typeof Schema.URL;
+}>;
+/**
+ * Azure Repos source configuration.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+declare const AzureReposSourceConfigSchema: Schema.Struct<{
+    name: Schema.filter<typeof Schema.String>;
+    type: Schema.Literal<["azurerepos"]>;
+    url: typeof Schema.URL;
+}>;
+/**
+ * Registry source configuration with optional scopes.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+declare const RegistrySourceConfigSchema: Schema.Struct<{
+    name: Schema.filter<typeof Schema.String>;
+    type: Schema.Literal<["registry"]>;
+    url: typeof Schema.URL;
+    scopes: Schema.optional<Schema.Array$<typeof Schema.String>>;
+}>;
+/**
+ * Discriminated union of source configurations on the `type` field.
+ *
+ * Variants: github, gitlab, bitbucket, azurerepos, registry.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const SourceConfigSchema: Schema.Union<[Schema.Struct<{
+    name: Schema.filter<typeof Schema.String>;
+    type: Schema.Literal<["github"]>;
+    url: typeof Schema.URL;
+}>, Schema.Struct<{
+    name: Schema.filter<typeof Schema.String>;
+    type: Schema.Literal<["gitlab"]>;
+    url: typeof Schema.URL;
+}>, Schema.Struct<{
+    name: Schema.filter<typeof Schema.String>;
+    type: Schema.Literal<["bitbucket"]>;
+    url: typeof Schema.URL;
+}>, Schema.Struct<{
+    name: Schema.filter<typeof Schema.String>;
+    type: Schema.Literal<["azurerepos"]>;
+    url: typeof Schema.URL;
+}>, Schema.Struct<{
+    name: Schema.filter<typeof Schema.String>;
+    type: Schema.Literal<["registry"]>;
+    url: typeof Schema.URL;
+    scopes: Schema.optional<Schema.Array$<typeof Schema.String>>;
+}>]>;
+/**
+ * Inferred type for SourceConfig schema.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export type SourceConfig = typeof SourceConfigSchema.Type;
+/** @experimental */
+export type GitHubSourceConfig = typeof GitHubSourceConfigSchema.Type;
+/** @experimental */
+export type GitLabSourceConfig = typeof GitLabSourceConfigSchema.Type;
+/** @experimental */
+export type BitbucketSourceConfig = typeof BitbucketSourceConfigSchema.Type;
+/** @experimental */
+export type AzureReposSourceConfig = typeof AzureReposSourceConfigSchema.Type;
+/** @experimental */
+export type RegistrySourceConfig = typeof RegistrySourceConfigSchema.Type;
+/**
+ * Extension map - maps skill names to version specifiers.
+ *
+ * Keys must be valid skill names per agentskills.io specification:
+ * - Max 64 characters
+ * - Lowercase letters, numbers, and hyphens only
+ * - Must not start or end with a hyphen
+ *
+ * Values are semver range strings (e.g., "^1.0.0", "~2.1.0", ">=1.0.0") or "*".
+ *
+ * @deprecated Use SkillsMapSchema for skills. This is kept for other extension types.
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const ExtensionMapSchema: Schema.filter<Schema.Record$<typeof Schema.String, typeof Schema.String>>;
+/**
+ * Inferred type for ExtensionMap schema.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export type ExtensionMap = typeof ExtensionMapSchema.Type;
+/**
+ * Skills map - maps skill names to source strings.
+ *
+ * Keys must be valid skill names per agentskills.io specification:
+ * - Max 64 characters
+ * - Lowercase letters, numbers, and hyphens only
+ * - Must not start or end with a hyphen
+ *
+ * Values are source strings in one of these formats:
+ * - Registry: `@scope/name` or `@scope/name@version`
+ * - GitHub: `github:owner/repo[/path][#ref]`
+ * - Git: `git:url[#ref]`
+ * - Local: `local:path`
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const SkillsMapSchema: Schema.filter<Schema.Record$<typeof Schema.String, typeof Schema.String>>;
+/**
+ * Inferred type for SkillsMap schema.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export type SkillsMap = typeof SkillsMapSchema.Type;
+/**
+ * Canonical key order for settings properties.
+ *
+ * Used by `writeSettings` and `ensureTopLevelProperty` to ensure properties
+ * appear in the same order as defined in `SettingsSchema`.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const SETTINGS_KEY_ORDER: ReadonlyArray<string>;
+export declare const SettingsSchema: Schema.Struct<{
+    scope: Schema.optional<Schema.transform<typeof Schema.String, typeof Schema.String>>;
+    agents: Schema.optional<Schema.Array$<Schema.Union<[Schema.Literal<["adal"]>, Schema.Literal<["amp"]>, Schema.Literal<["antigravity"]>, Schema.Literal<["augment"]>, Schema.Literal<["claude-code"]>, Schema.Literal<["cline"]>, Schema.Literal<["codebuddy"]>, Schema.Literal<["codex"]>, Schema.Literal<["command-code"]>, Schema.Literal<["continue"]>, Schema.Literal<["crush"]>, Schema.Literal<["cursor"]>, Schema.Literal<["droid"]>, Schema.Literal<["gemini-cli"]>, Schema.Literal<["github-copilot"]>, Schema.Literal<["goose"]>, Schema.Literal<["iflow-cli"]>, Schema.Literal<["junie"]>, Schema.Literal<["kilo"]>, Schema.Literal<["kimi-cli"]>, Schema.Literal<["kiro-cli"]>, Schema.Literal<["kode"]>, Schema.Literal<["mcpjam"]>, Schema.Literal<["mistral-vibe"]>, Schema.Literal<["mux"]>, Schema.Literal<["neovate"]>, Schema.Literal<["openclaw"]>, Schema.Literal<["opencode"]>, Schema.Literal<["openhands"]>, Schema.Literal<["pi"]>, Schema.Literal<["pochi"]>, Schema.Literal<["qoder"]>, Schema.Literal<["qwen-code"]>, Schema.Literal<["replit"]>, Schema.Literal<["roo"]>, Schema.Literal<["trae"]>, Schema.Literal<["trae-cn"]>, Schema.Literal<["windsurf"]>, Schema.Literal<["zencoder"]>]>>>;
+    sources: Schema.optional<Schema.Array$<Schema.Union<[Schema.Struct<{
+        name: Schema.filter<typeof Schema.String>;
+        type: Schema.Literal<["github"]>;
+        url: typeof Schema.URL;
+    }>, Schema.Struct<{
+        name: Schema.filter<typeof Schema.String>;
+        type: Schema.Literal<["gitlab"]>;
+        url: typeof Schema.URL;
+    }>, Schema.Struct<{
+        name: Schema.filter<typeof Schema.String>;
+        type: Schema.Literal<["bitbucket"]>;
+        url: typeof Schema.URL;
+    }>, Schema.Struct<{
+        name: Schema.filter<typeof Schema.String>;
+        type: Schema.Literal<["azurerepos"]>;
+        url: typeof Schema.URL;
+    }>, Schema.Struct<{
+        name: Schema.filter<typeof Schema.String>;
+        type: Schema.Literal<["registry"]>;
+        url: typeof Schema.URL;
+        scopes: Schema.optional<Schema.Array$<typeof Schema.String>>;
+    }>]>>>;
+    commands: Schema.optional<Schema.filter<Schema.Record$<typeof Schema.String, typeof Schema.String>>>;
+    "mcp-servers": Schema.optional<Schema.filter<Schema.Record$<typeof Schema.String, typeof Schema.String>>>;
+    packs: Schema.optional<Schema.filter<Schema.Record$<typeof Schema.String, typeof Schema.String>>>;
+    skills: Schema.optional<Schema.filter<Schema.Record$<typeof Schema.String, typeof Schema.String>>>;
+}>;
+/**
+ * Inferred type for Settings schema.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export type Settings = typeof SettingsSchema.Type;
+export {};
+//# sourceMappingURL=schema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/settings/schema.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAiBxC;;;;GAIG;AACH,QAAA,MAAM,wBAAwB;;;;EAI5B,CAAC;AAEH;;;;GAIG;AACH,QAAA,MAAM,wBAAwB;;;;EAI5B,CAAC;AAEH;;;;GAIG;AACH,QAAA,MAAM,2BAA2B;;;;EAI/B,CAAC;AAEH;;;;GAIG;AACH,QAAA,MAAM,4BAA4B;;;;EAIhC,CAAC;AAEH;;;;GAIG;AACH,QAAA,MAAM,0BAA0B;;;;;EAK9B,CAAC;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;IAM9B,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG,OAAO,kBAAkB,CAAC,IAAI,CAAC;AAE1D,oBAAoB;AACpB,MAAM,MAAM,kBAAkB,GAAG,OAAO,wBAAwB,CAAC,IAAI,CAAC;AACtE,oBAAoB;AACpB,MAAM,MAAM,kBAAkB,GAAG,OAAO,wBAAwB,CAAC,IAAI,CAAC;AACtE,oBAAoB;AACpB,MAAM,MAAM,qBAAqB,GAAG,OAAO,2BAA2B,CAAC,IAAI,CAAC;AAC5E,oBAAoB;AACpB,MAAM,MAAM,sBAAsB,GAAG,OAAO,4BAA4B,CAAC,IAAI,CAAC;AAC9E,oBAAoB;AAEpB,MAAM,MAAM,oBAAoB,GAAG,OAAO,0BAA0B,CAAC,IAAI,CAAC;AAyB1E;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,kBAAkB,2EAGc,CAAC;AAE9C;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG,OAAO,kBAAkB,CAAC,IAAI,CAAC;AAE1D;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,eAAe,2EAGiB,CAAC;AAE9C;;;;GAIG;AACH,MAAM,MAAM,SAAS,GAAG,OAAO,eAAe,CAAC,IAAI,CAAC;AAEpD;;;;;;;GAOG;AACH,eAAO,MAAM,kBAAkB,EAAE,aAAa,CAAC,MAAM,CAQpD,CAAC;AAsBF,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAQzB,CAAC;AAEH;;;;GAIG;AACH,MAAM,MAAM,QAAQ,GAAG,OAAO,cAAc,CAAC,IAAI,CAAC"}

package/dist/src/settings/schema.js

@@ -0,0 +1,182 @@
+/**
+ * Schema definitions for AXM settings configuration.
+ *
+ * Settings define global configuration including sources, agents, and extensions.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as Schema from "effect/Schema";
+import { AgentIdSchema } from "../extensions/common.js";
+// -----------------------------------------------------------------------------
+// Source Config (array-based, discriminated on `type` field)
+// -----------------------------------------------------------------------------
+/**
+ * Pattern for source names: lowercase alphanumeric, hyphens, and dots.
+ * Must start with a letter or digit.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+const SOURCE_NAME_PATTERN = /^[a-z0-9][a-z0-9.-]*$/;
+const SourceNameSchema = Schema.String.pipe(Schema.pattern(SOURCE_NAME_PATTERN));
+/**
+ * GitHub source configuration.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+const GitHubSourceConfigSchema = Schema.Struct({
+    name: SourceNameSchema,
+    type: Schema.Literal("github"),
+    url: Schema.URL,
+});
+/**
+ * GitLab source configuration.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+const GitLabSourceConfigSchema = Schema.Struct({
+    name: SourceNameSchema,
+    type: Schema.Literal("gitlab"),
+    url: Schema.URL,
+});
+/**
+ * Bitbucket source configuration.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+const BitbucketSourceConfigSchema = Schema.Struct({
+    name: SourceNameSchema,
+    type: Schema.Literal("bitbucket"),
+    url: Schema.URL,
+});
+/**
+ * Azure Repos source configuration.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+const AzureReposSourceConfigSchema = Schema.Struct({
+    name: SourceNameSchema,
+    type: Schema.Literal("azurerepos"),
+    url: Schema.URL,
+});
+/**
+ * Registry source configuration with optional scopes.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+const RegistrySourceConfigSchema = Schema.Struct({
+    name: SourceNameSchema,
+    type: Schema.Literal("registry"),
+    url: Schema.URL,
+    scopes: Schema.optional(Schema.Array(Schema.String)),
+});
+/**
+ * Discriminated union of source configurations on the `type` field.
+ *
+ * Variants: github, gitlab, bitbucket, azurerepos, registry.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const SourceConfigSchema = Schema.Union(GitHubSourceConfigSchema, GitLabSourceConfigSchema, BitbucketSourceConfigSchema, AzureReposSourceConfigSchema, RegistrySourceConfigSchema);
+/**
+ * Pattern for skill names per agentskills.io specification:
+ * - Max 64 characters
+ * - Lowercase letters, numbers, and hyphens only
+ * - Must not start or end with a hyphen
+ *
+ * @see https://agentskills.io/specification
+ */
+const SKILL_NAME_PATTERN = /^[a-z0-9](?:[a-z0-9-]{0,62}[a-z0-9])?$|^[a-z0-9]$/;
+/**
+ * Shared validation callback for skill name keys per agentskills.io spec.
+ * Used by both ExtensionMapSchema and SkillsMapSchema via Schema.filter.
+ */
+const validateSkillNameKeys = (record) => {
+    const invalidKeys = Object.keys(record).filter((key) => key.length > 64 || !SKILL_NAME_PATTERN.test(key));
+    if (invalidKeys.length > 0) {
+        return `Invalid skill name(s): ${invalidKeys.join(", ")}. Names must be max 64 chars, lowercase letters/numbers/hyphens, not starting or ending with hyphen.`;
+    }
+    return undefined;
+};
+/**
+ * Extension map - maps skill names to version specifiers.
+ *
+ * Keys must be valid skill names per agentskills.io specification:
+ * - Max 64 characters
+ * - Lowercase letters, numbers, and hyphens only
+ * - Must not start or end with a hyphen
+ *
+ * Values are semver range strings (e.g., "^1.0.0", "~2.1.0", ">=1.0.0") or "*".
+ *
+ * @deprecated Use SkillsMapSchema for skills. This is kept for other extension types.
+ * @experimental This API is unstable and may change without notice.
+ */
+export const ExtensionMapSchema = Schema.Record({
+    key: Schema.String,
+    value: Schema.String,
+}).pipe(Schema.filter(validateSkillNameKeys));
+/**
+ * Skills map - maps skill names to source strings.
+ *
+ * Keys must be valid skill names per agentskills.io specification:
+ * - Max 64 characters
+ * - Lowercase letters, numbers, and hyphens only
+ * - Must not start or end with a hyphen
+ *
+ * Values are source strings in one of these formats:
+ * - Registry: `@scope/name` or `@scope/name@version`
+ * - GitHub: `github:owner/repo[/path][#ref]`
+ * - Git: `git:url[#ref]`
+ * - Local: `local:path`
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const SkillsMapSchema = Schema.Record({
+    key: Schema.String,
+    value: Schema.String,
+}).pipe(Schema.filter(validateSkillNameKeys));
+/**
+ * Canonical key order for settings properties.
+ *
+ * Used by `writeSettings` and `ensureTopLevelProperty` to ensure properties
+ * appear in the same order as defined in `SettingsSchema`.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const SETTINGS_KEY_ORDER = [
+    "scope",
+    "sources",
+    "agents",
+    "skills",
+    "commands",
+    "packs",
+    "mcp-servers",
+];
+/**
+ * AXM settings configuration schema.
+ *
+ * Settings define global configuration for AXM including:
+ * - scope: Default scope for resolving/publishing extensions
+ * - sources: Source provider configurations
+ * - agents: List of agent IDs to sync extensions to
+ * - skills: Desired skills by name to source string
+ * - commands: Desired commands by name to version specifier
+ * - packs: Desired packs by name to version specifier
+ * - mcp-servers: Desired MCP servers by name to version specifier
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+const ScopeSchema = Schema.transform(Schema.String, Schema.String, {
+    strict: true,
+    decode: (s) => (s.startsWith("@") ? s : `@${s}`),
+    encode: (s) => s,
+});
+export const SettingsSchema = Schema.Struct({
+    scope: Schema.optional(ScopeSchema),
+    agents: Schema.optional(Schema.Array(AgentIdSchema)),
+    sources: Schema.optional(Schema.Array(SourceConfigSchema)),
+    commands: Schema.optional(ExtensionMapSchema),
+    "mcp-servers": Schema.optional(ExtensionMapSchema),
+    packs: Schema.optional(ExtensionMapSchema),
+    skills: Schema.optional(SkillsMapSchema),
+});
+//# sourceMappingURL=schema.js.map

package/dist/src/settings/schema.js.map

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

package/dist/src/settings/settings.d.ts

@@ -0,0 +1,143 @@
+/**
+ * Settings management for .axm/settings.json.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import * as FileSystem from "@effect/platform/FileSystem";
+import * as Path from "@effect/platform/Path";
+import * as Effect from "effect/Effect";
+import { type Settings } from "./schema.js";
+/**
+ * Filename for the settings file.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const SETTINGS_FILENAME = "settings.json";
+/**
+ * Default scope for skill resolution when not specified in settings.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const DEFAULT_SCOPE = "@community";
+declare const SettingsNotFoundError_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]; }) => import("effect/Cause").YieldableError & {
+    readonly _tag: "SettingsNotFoundError";
+} & Readonly<A>;
+/**
+ * Settings file not found.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare class SettingsNotFoundError extends SettingsNotFoundError_base<{
+    readonly path: string;
+    readonly message: string;
+}> {
+}
+declare const SettingsParseError_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]; }) => import("effect/Cause").YieldableError & {
+    readonly _tag: "SettingsParseError";
+} & Readonly<A>;
+/**
+ * Failed to parse settings JSON.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare class SettingsParseError extends SettingsParseError_base<{
+    readonly path: string;
+    readonly message: string;
+    readonly cause: unknown;
+}> {
+}
+declare const SettingsWriteError_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]; }) => import("effect/Cause").YieldableError & {
+    readonly _tag: "SettingsWriteError";
+} & Readonly<A>;
+/**
+ * Failed to write settings file.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare class SettingsWriteError extends SettingsWriteError_base<{
+    readonly path: string;
+    readonly message: string;
+    readonly cause: unknown;
+}> {
+}
+/**
+ * Union of all settings errors.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export type SettingsError = SettingsNotFoundError | SettingsParseError | SettingsWriteError;
+/**
+ * Create default settings object.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const createDefaultSettings: () => Settings;
+/**
+ * Reorder settings keys to match the canonical schema order.
+ *
+ * Creates a new object with keys in `SETTINGS_KEY_ORDER`, omitting keys
+ * not present in the input.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const orderSettingsKeys: (settings: Settings) => Settings;
+/**
+ * Read and parse settings from .axm/settings.json.
+ *
+ * @param axmDir - Path to the .axm directory
+ * @returns Parsed Settings object
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const readSettings: (axmDir: string) => Effect.Effect<{
+    readonly scope?: string | undefined;
+    readonly sources?: readonly ({
+        readonly type: "github";
+        readonly name: string;
+        readonly url: URL;
+    } | {
+        readonly type: "gitlab";
+        readonly name: string;
+        readonly url: URL;
+    } | {
+        readonly type: "bitbucket";
+        readonly name: string;
+        readonly url: URL;
+    } | {
+        readonly type: "azurerepos";
+        readonly name: string;
+        readonly url: URL;
+    } | {
+        readonly type: "registry";
+        readonly name: string;
+        readonly url: URL;
+        readonly scopes?: readonly string[] | undefined;
+    })[] | undefined;
+    readonly agents?: readonly ("cursor" | "adal" | "amp" | "antigravity" | "augment" | "claude-code" | "cline" | "codebuddy" | "codex" | "command-code" | "continue" | "crush" | "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 skills?: {
+        readonly [x: string]: string;
+    } | undefined;
+    readonly commands?: {
+        readonly [x: string]: string;
+    } | undefined;
+    readonly packs?: {
+        readonly [x: string]: string;
+    } | undefined;
+    readonly "mcp-servers"?: {
+        readonly [x: string]: string;
+    } | undefined;
+}, SettingsNotFoundError | SettingsParseError, Path.Path | FileSystem.FileSystem>;
+/**
+ * Write settings to .axm/settings.json.
+ *
+ * Creates the directory if it doesn't exist. Pretty-prints JSON with 2-space indent.
+ *
+ * @param axmDir - Path to the .axm directory
+ * @param settings - Settings object to write
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const writeSettings: (axmDir: string, settings: Settings) => Effect.Effect<void, SettingsWriteError, Path.Path | FileSystem.FileSystem>;
+export {};
+//# sourceMappingURL=settings.d.ts.map

package/dist/src/settings/settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../../../src/settings/settings.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,UAAU,MAAM,6BAA6B,CAAC;AAC1D,OAAO,KAAK,IAAI,MAAM,uBAAuB,CAAC;AAE9C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAGxC,OAAO,EAAsB,KAAK,QAAQ,EAAkB,MAAM,aAAa,CAAC;AAMhF;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,kBAAkB,CAAC;AAEjD;;;;GAIG;AACH,eAAO,MAAM,aAAa,eAAe,CAAC;;;;AAM1C;;;;GAIG;AACH,qBAAa,qBAAsB,SAAQ,2BAA0C;IACnF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,CAAC;CAAG;;;;AAEL;;;;GAIG;AACH,qBAAa,kBAAmB,SAAQ,wBAAuC;IAC7E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB,CAAC;CAAG;;;;AAEL;;;;GAIG;AACH,qBAAa,kBAAmB,SAAQ,wBAAuC;IAC7E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB,CAAC;CAAG;AAEL;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,qBAAqB,GAAG,kBAAkB,GAAG,kBAAkB,CAAC;AAM5F;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,QAAO,QAAgB,CAAC;AAM1D;;;;;;;GAOG;AACH,eAAO,MAAM,iBAAiB,GAAI,UAAU,QAAQ,KAAG,QAQtD,CAAC;AAMF;;;;;;;GAOG;AACH,eAAO,MAAM,YAAY,GAAI,QAAQ,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iFA4DvC,CAAC;AAEL;;;;;;;;;GASG;AACH,eAAO,MAAM,aAAa,GAAI,QAAQ,MAAM,EAAE,UAAU,QAAQ,+EAgC5D,CAAC"}