@agentxm/client-core 0.5.3 → 0.6.2

package/site-content/__generated__/schemas/settings.schema.json

@@ -1,7 +1,13 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$ref": "#/definitions/Settings",
+  "$ref": "#/definitions/AxmSettings",
   "definitions": {
+    "TelemetryMode": {
+      "anyOf": [{ "type": "boolean" }, { "type": "string", "enum": ["errors"] }],
+      "title": "Telemetry Mode",
+      "description": "`true` sends usage and error telemetry, `\"errors\"` sends only errors, and `false` disables telemetry.",
+      "examples": [true, "errors", false]
+    },
     "Handle": {
       "type": "string",
       "allOf": [
@@ -13,13 +19,60 @@
         }
       ]
     },
+    "AgentId": {
+      "type": "string",
+      "enum": [
+        "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"
+      ],
+      "title": "Agent ID",
+      "description": "Supported coding agent identifier used in `.axm/settings.json` `agents`.",
+      "examples": ["claude-code", "codex", "cursor"]
+    },
     "SourceName": {
       "type": "string",
       "allOf": [
         {
           "pattern": "^[a-z0-9][a-z0-9.-]*$",
           "title": "Source Name",
-          "description": "A source name using lowercase letters, numbers, hyphens, and dots (e.g. github, my-registry.dev).",
+          "description": "Alias used in entry source strings for this source host.",
           "examples": ["github", "my-registry.dev"]
         }
       ]
@@ -34,7 +87,7 @@
       "required": ["name", "type", "url"],
       "additionalProperties": false,
       "title": "GitHub Source Host",
-      "description": "Configuration for a GitHub source."
+      "description": "A GitHub source host."
     },
     "GitLabSourceHostConfig": {
       "type": "object",
@@ -46,7 +99,7 @@
       "required": ["name", "type", "url"],
       "additionalProperties": false,
       "title": "GitLab Source Host",
-      "description": "Configuration for a GitLab source."
+      "description": "A GitLab source host."
     },
     "BitbucketSourceHostConfig": {
       "type": "object",
@@ -58,7 +111,7 @@
       "required": ["name", "type", "url"],
       "additionalProperties": false,
       "title": "Bitbucket Source Host",
-      "description": "Configuration for a Bitbucket source."
+      "description": "A Bitbucket source host."
     },
     "AzureReposSourceHostConfig": {
       "type": "object",
@@ -70,7 +123,7 @@
       "required": ["name", "type", "url"],
       "additionalProperties": false,
       "title": "Azure Repos Source Host",
-      "description": "Configuration for an Azure Repos source."
+      "description": "An Azure Repos source host."
     },
     "RegistrySourceHostConfig": {
       "type": "object",
@@ -82,7 +135,7 @@
       "required": ["name", "type", "location"],
       "additionalProperties": false,
       "title": "Registry Source Host",
-      "description": "Configuration for a package registry source."
+      "description": "A package registry source host."
     },
     "SourceHostConfig": {
       "anyOf": [
@@ -93,206 +146,322 @@
         { "$ref": "#/definitions/RegistrySourceHostConfig" }
       ],
       "title": "Source Host Config",
-      "description": "Where extensions are fetched from — GitHub, GitLab, Bitbucket, Azure Repos, or a package registry."
+      "description": "A source host configuration: GitHub, GitLab, Bitbucket, Azure Repos, or a package registry."
     },
-    "CommandEntryObject": {
-      "type": "object",
-      "properties": {
-        "source": { "type": "string", "allOf": [{ "minLength": 1 }] },
-        "enabled": {
-          "anyOf": [
-            {
+    "SkillEntry": {
+      "anyOf": [
+        { "type": "string" },
+        {
+          "type": "object",
+          "properties": {
+            "source": {
+              "type": "string",
+              "allOf": [
+                {
+                  "minLength": 1,
+                  "description": "FQN with optional version constraint, source-scheme ref like github:owner/repo, or local path.",
+                  "examples": [
+                    "@acme/skills/code-review@^1.0.0",
+                    "github:acme/agent-extensions",
+                    "./extensions/code-review"
+                  ]
+                }
+              ]
+            },
+            "enabled": {
               "type": "boolean",
-              "description": "Whether this entry is enabled. Defaults to true when omitted.",
+              "description": "Set to false to disable this entry. Omit otherwise — true is the default and should not be written explicitly.",
               "default": true
             },
-            { "type": "null" }
-          ]
-        },
-        "authored": {
-          "anyOf": [
-            {
+            "authored": {
               "type": "boolean",
-              "description": "Whether this entry was authored locally. Defaults to false when omitted.",
+              "description": "Set to true to mark this entry as authored locally in this workspace. Omit otherwise — false is the default and should not be written explicitly.",
               "default": false
-            },
-            { "type": "null" }
-          ]
+            }
+          },
+          "required": ["source"],
+          "additionalProperties": false,
+          "title": "Skill Entry Object",
+          "description": "A skill entry with source and optional enabled/authored flags."
+        }
+      ],
+      "title": "Skill Entry",
+      "description": "A skill entry: a source string, or an object with source plus optional flags.",
+      "examples": [
+        "@acme/skills/code-review@^1.0.0",
+        { "source": "github:acme/agent-extensions", "enabled": false }
+      ]
+    },
+    "SkillsMap": {
+      "type": "object",
+      "title": "Skills Map",
+      "description": "A map of skill names to skill entries.",
+      "propertyNames": { "pattern": "^[a-z0-9](?:[a-z0-9-]{0,62}[a-z0-9])?$" },
+      "additionalProperties": { "$ref": "#/definitions/SkillEntry" }
+    },
+    "SkillsConfig": {
+      "type": "object",
+      "properties": {
+        "ignore": {
+          "type": "array",
+          "description": "Installed skill names AXM should leave unmanaged.",
+          "examples": [["local-*", "legacy-helper"]],
+          "items": { "type": "string" }
         }
       },
-      "required": ["source"],
       "additionalProperties": false,
-      "title": "Command Entry Object",
-      "description": "A command with its source location and whether it's enabled."
+      "title": "Skills Config",
+      "description": "Feature-level configuration for skills."
     },
     "CommandEntry": {
-      "anyOf": [{ "type": "string" }, { "$ref": "#/definitions/CommandEntryObject" }]
+      "anyOf": [
+        { "type": "string" },
+        {
+          "type": "object",
+          "properties": {
+            "source": {
+              "type": "string",
+              "allOf": [
+                {
+                  "minLength": 1,
+                  "description": "FQN with optional version constraint, source-scheme ref like github:owner/repo, or local path.",
+                  "examples": [
+                    "@acme/commands/code-review@^1.0.0",
+                    "github:acme/agent-extensions",
+                    "./extensions/code-review"
+                  ]
+                }
+              ]
+            },
+            "enabled": {
+              "type": "boolean",
+              "description": "Set to false to disable this entry. Omit otherwise — true is the default and should not be written explicitly.",
+              "default": true
+            },
+            "authored": {
+              "type": "boolean",
+              "description": "Set to true to mark this entry as authored locally in this workspace. Omit otherwise — false is the default and should not be written explicitly.",
+              "default": false
+            }
+          },
+          "required": ["source"],
+          "additionalProperties": false,
+          "title": "Command Entry Object",
+          "description": "A command entry with source and optional enabled/authored flags."
+        }
+      ],
+      "title": "Command Entry",
+      "description": "A command entry: a source string, or an object with source plus optional flags.",
+      "examples": [
+        "@acme/commands/code-review@^1.0.0",
+        { "source": "github:acme/agent-extensions", "enabled": false }
+      ]
     },
     "CommandsMap": {
       "type": "object",
       "title": "Commands Map",
-      "description": "Your installed commands, keyed by name.",
+      "description": "A map of command names to command entries.",
       "propertyNames": { "pattern": "^[a-z0-9](?:[a-z0-9-]{0,62}[a-z0-9])?$" },
       "additionalProperties": { "$ref": "#/definitions/CommandEntry" }
     },
-    "SubagentEntryObject": {
+    "CommandsConfig": {
       "type": "object",
       "properties": {
-        "source": { "type": "string", "allOf": [{ "minLength": 1 }] },
-        "enabled": {
-          "anyOf": [
-            {
+        "ignore": {
+          "type": "array",
+          "description": "Installed command names AXM should leave unmanaged.",
+          "examples": [["local-*", "legacy-helper"]],
+          "items": { "type": "string" }
+        }
+      },
+      "additionalProperties": false,
+      "title": "Commands Config",
+      "description": "Feature-level configuration for commands."
+    },
+    "SubagentEntry": {
+      "anyOf": [
+        { "type": "string" },
+        {
+          "type": "object",
+          "properties": {
+            "source": {
+              "type": "string",
+              "allOf": [
+                {
+                  "minLength": 1,
+                  "description": "FQN with optional version constraint, source-scheme ref like github:owner/repo, or local path.",
+                  "examples": [
+                    "@acme/subagents/code-review@^1.0.0",
+                    "github:acme/agent-extensions",
+                    "./extensions/code-review"
+                  ]
+                }
+              ]
+            },
+            "enabled": {
               "type": "boolean",
-              "description": "Whether this entry is enabled. Defaults to true when omitted.",
+              "description": "Set to false to disable this entry. Omit otherwise — true is the default and should not be written explicitly.",
               "default": true
             },
-            { "type": "null" }
-          ]
-        },
-        "authored": {
-          "anyOf": [
-            {
+            "authored": {
               "type": "boolean",
-              "description": "Whether this entry was authored locally. Defaults to false when omitted.",
+              "description": "Set to true to mark this entry as authored locally in this workspace. Omit otherwise — false is the default and should not be written explicitly.",
               "default": false
-            },
-            { "type": "null" }
-          ]
+            }
+          },
+          "required": ["source"],
+          "additionalProperties": false,
+          "title": "Subagent Entry Object",
+          "description": "A subagent entry with source and optional enabled/authored flags."
         }
-      },
-      "required": ["source"],
-      "additionalProperties": false,
-      "title": "Subagent Entry Object",
-      "description": "A subagent with its source location and whether it's enabled."
-    },
-    "SubagentEntry": {
-      "anyOf": [{ "type": "string" }, { "$ref": "#/definitions/SubagentEntryObject" }]
+      ],
+      "title": "Subagent Entry",
+      "description": "A subagent entry: a source string, or an object with source plus optional flags.",
+      "examples": [
+        "@acme/subagents/reviewer@^1.0.0",
+        { "source": "github:acme/agent-extensions", "enabled": false }
+      ]
     },
     "SubagentsMap": {
       "type": "object",
       "title": "Subagents Map",
-      "description": "Your installed subagents, keyed by name.",
+      "description": "A map of subagent names to subagent entries.",
       "propertyNames": { "pattern": "^[a-z0-9](?:[a-z0-9-]{0,62}[a-z0-9])?$" },
       "additionalProperties": { "$ref": "#/definitions/SubagentEntry" }
     },
-    "McpServerEntryObject": {
+    "SubagentsConfig": {
       "type": "object",
       "properties": {
-        "source": { "type": "string", "allOf": [{ "minLength": 1 }] },
-        "authored": {
-          "anyOf": [
-            {
-              "type": "boolean",
-              "description": "Whether this entry was authored locally. Defaults to false when omitted.",
-              "default": false
-            },
-            { "type": "null" }
-          ]
+        "ignore": {
+          "type": "array",
+          "description": "Installed subagent names AXM should leave unmanaged.",
+          "examples": [["local-*", "legacy-helper"]],
+          "items": { "type": "string" }
         }
       },
-      "required": ["source"],
       "additionalProperties": false,
-      "title": "MCP Server Entry Object",
-      "description": "An MCP server with its source location."
-    },
-    "McpServerEntry": {
-      "anyOf": [{ "type": "string" }, { "$ref": "#/definitions/McpServerEntryObject" }]
+      "title": "Subagents Config",
+      "description": "Feature-level configuration for subagents."
     },
-    "McpServersMap": {
-      "type": "object",
-      "title": "MCP Servers Map",
-      "description": "Your installed MCP servers, keyed by name.",
-      "propertyNames": { "pattern": "^[a-z0-9](?:[a-z0-9-]{0,62}[a-z0-9])?$" },
-      "additionalProperties": { "$ref": "#/definitions/McpServerEntry" }
-    },
-    "PackEntryObject": {
-      "type": "object",
-      "properties": {
-        "source": { "type": "string", "allOf": [{ "minLength": 1 }] },
-        "authored": {
-          "anyOf": [
-            {
+    "PackEntry": {
+      "anyOf": [
+        { "type": "string" },
+        {
+          "type": "object",
+          "properties": {
+            "source": {
+              "type": "string",
+              "allOf": [
+                {
+                  "minLength": 1,
+                  "description": "FQN with optional version constraint, source-scheme ref like github:owner/repo, or local path.",
+                  "examples": [
+                    "@acme/packs/code-review@^1.0.0",
+                    "github:acme/agent-extensions",
+                    "./extensions/code-review"
+                  ]
+                }
+              ]
+            },
+            "authored": {
               "type": "boolean",
-              "description": "Whether this entry was authored locally. Defaults to false when omitted.",
+              "description": "Set to true to mark this entry as authored locally in this workspace. Omit otherwise — false is the default and should not be written explicitly.",
               "default": false
-            },
-            { "type": "null" }
-          ]
+            }
+          },
+          "required": ["source"],
+          "additionalProperties": false,
+          "title": "Pack Entry Object",
+          "description": "A pack entry with source and optional authored flag."
         }
-      },
-      "required": ["source"],
-      "additionalProperties": false,
-      "title": "Pack Entry Object",
-      "description": "A pack with its source location."
+      ],
+      "title": "Pack Entry",
+      "description": "A pack entry: a source string, or an object with source plus optional authored flag.",
+      "examples": [
+        "@acme/packs/typescript@^1.0.0",
+        { "source": "github:acme/agent-extensions", "authored": true }
+      ]
     },
-    "PackEntry": { "anyOf": [{ "type": "string" }, { "$ref": "#/definitions/PackEntryObject" }] },
     "PacksMap": {
       "type": "object",
       "title": "Packs Map",
-      "description": "Your installed packs, keyed by name.",
+      "description": "A map of pack names to pack entries.",
       "propertyNames": { "pattern": "^[a-z0-9](?:[a-z0-9-]{0,62}[a-z0-9])?$" },
       "additionalProperties": { "$ref": "#/definitions/PackEntry" }
     },
-    "SkillEntryObject": {
+    "PacksConfig": {
       "type": "object",
       "properties": {
-        "source": { "type": "string", "allOf": [{ "minLength": 1 }] },
-        "enabled": {
-          "anyOf": [
-            {
-              "type": "boolean",
-              "description": "Whether this entry is enabled. Defaults to true when omitted.",
-              "default": true
+        "ignore": {
+          "type": "array",
+          "description": "Installed pack names AXM should leave unmanaged.",
+          "examples": [["local-*", "legacy-helper"]],
+          "items": { "type": "string" }
+        }
+      },
+      "additionalProperties": false,
+      "title": "Packs Config",
+      "description": "Feature-level configuration for packs."
+    },
+    "McpServerEntry": {
+      "anyOf": [
+        { "type": "string" },
+        {
+          "type": "object",
+          "properties": {
+            "source": {
+              "type": "string",
+              "allOf": [
+                {
+                  "minLength": 1,
+                  "description": "FQN with optional version constraint, source-scheme ref like github:owner/repo, or local path.",
+                  "examples": [
+                    "@acme/mcp-servers/code-review@^1.0.0",
+                    "github:acme/agent-extensions",
+                    "./extensions/code-review"
+                  ]
+                }
+              ]
             },
-            { "type": "null" }
-          ]
-        },
-        "authored": {
-          "anyOf": [
-            {
+            "authored": {
               "type": "boolean",
-              "description": "Whether this entry was authored locally. Defaults to false when omitted.",
+              "description": "Set to true to mark this entry as authored locally in this workspace. Omit otherwise — false is the default and should not be written explicitly.",
               "default": false
-            },
-            { "type": "null" }
-          ]
+            }
+          },
+          "required": ["source"],
+          "additionalProperties": false,
+          "title": "MCP Server Entry Object",
+          "description": "An MCP server entry with source and optional authored flag."
         }
-      },
-      "required": ["source"],
-      "additionalProperties": false,
-      "title": "Skill Entry Object",
-      "description": "A skill with its source location and whether it's enabled."
+      ],
+      "title": "MCP Server Entry",
+      "description": "An MCP server entry: a source string, or an object with source plus optional authored flag.",
+      "examples": [
+        "@acme/mcp-servers/context@^1.0.0",
+        { "source": "github:acme/agent-extensions", "authored": true }
+      ]
     },
-    "SkillEntry": { "anyOf": [{ "type": "string" }, { "$ref": "#/definitions/SkillEntryObject" }] },
-    "SkillsMap": {
+    "McpServersMap": {
       "type": "object",
-      "title": "Skills Map",
-      "description": "Your installed skills, keyed by name.",
+      "title": "MCP Servers Map",
+      "description": "A map of MCP server names to MCP server entries.",
       "propertyNames": { "pattern": "^[a-z0-9](?:[a-z0-9-]{0,62}[a-z0-9])?$" },
-      "additionalProperties": { "$ref": "#/definitions/SkillEntry" }
+      "additionalProperties": { "$ref": "#/definitions/McpServerEntry" }
     },
-    "IgnoredSettings": {
+    "McpServersConfig": {
       "type": "object",
       "properties": {
-        "skills": {
-          "anyOf": [{ "type": "array", "items": { "type": "string" } }, { "type": "null" }]
-        },
-        "commands": {
-          "anyOf": [{ "type": "array", "items": { "type": "string" } }, { "type": "null" }]
-        },
-        "subagents": {
-          "anyOf": [{ "type": "array", "items": { "type": "string" } }, { "type": "null" }]
-        },
-        "mcpServers": {
-          "anyOf": [{ "type": "array", "items": { "type": "string" } }, { "type": "null" }]
-        },
-        "packs": {
-          "anyOf": [{ "type": "array", "items": { "type": "string" } }, { "type": "null" }]
+        "ignore": {
+          "type": "array",
+          "description": "Installed MCP server names AXM should leave unmanaged.",
+          "examples": [["local-*", "legacy-helper"]],
+          "items": { "type": "string" }
         }
       },
       "additionalProperties": false,
-      "title": "Ignored Settings",
-      "description": "Glob patterns for extensions to ignore, grouped by type (e.g. skills, commands)."
+      "title": "MCP Servers Config",
+      "description": "Feature-level configuration for MCP servers."
     },
     "LintRuleSeverity": {
       "type": "string",
@@ -300,98 +469,103 @@
       "title": "Lint Rule Severity",
       "description": "Severity override for a lint rule: 'off' silences it, 'info'/'warn'/'error' raise or lower severity."
     },
-    "LintRulesMap": {
-      "type": "object",
-      "additionalProperties": { "$ref": "#/definitions/LintRuleSeverity" }
-    },
     "LintConfig": {
       "type": "object",
       "properties": {
-        "rules": { "anyOf": [{ "$ref": "#/definitions/LintRulesMap" }, { "type": "null" }] }
+        "rules": {
+          "type": "object",
+          "additionalProperties": { "$ref": "#/definitions/LintRuleSeverity" },
+          "title": "Lint Rules Map",
+          "description": "Map of exact <namespace>/<name> rule ids to severity overrides for `axm lint`."
+        }
       },
       "additionalProperties": false,
       "title": "Lint Config",
-      "description": "WorkspaceMutations lint configuration under `lint` in `.axm/settings.json`."
+      "description": "Lint configuration under `lint` in `.axm/settings.json`."
     },
-    "Settings": {
+    "AxmSettings": {
       "type": "object",
       "properties": {
         "telemetry": {
-          "anyOf": [
-            { "anyOf": [{ "type": "boolean" }, { "type": "string", "enum": ["errors"] }] },
-            { "type": "null" }
-          ]
+          "anyOf": [{ "$ref": "#/definitions/TelemetryMode" }],
+          "description": "Workspace telemetry mode: full, errors-only, or disabled."
+        },
+        "owner": {
+          "anyOf": [{ "$ref": "#/definitions/Handle" }],
+          "description": "Default owner handle used when AXM scaffolds or resolves workspace extensions."
         },
-        "owner": { "anyOf": [{ "$ref": "#/definitions/Handle" }, { "type": "null" }] },
         "agents": {
-          "anyOf": [
-            {
-              "type": "array",
-              "items": {
-                "type": "string",
-                "enum": [
-                  "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"
-                ]
-              }
-            },
-            { "type": "null" }
-          ]
+          "type": "array",
+          "description": "Coding agents AXM should sync managed extensions into.",
+          "examples": [["claude-code", "codex"]],
+          "allOf": [{ "uniqueItems": true }],
+          "items": { "$ref": "#/definitions/AgentId" }
         },
         "sources": {
-          "anyOf": [
-            { "type": "array", "items": { "$ref": "#/definitions/SourceHostConfig" } },
-            { "type": "null" }
-          ]
+          "type": "array",
+          "description": "Named source hosts used to resolve source-scheme entry references.",
+          "items": { "$ref": "#/definitions/SourceHostConfig" }
         },
-        "commands": { "anyOf": [{ "$ref": "#/definitions/CommandsMap" }, { "type": "null" }] },
-        "subagents": { "anyOf": [{ "$ref": "#/definitions/SubagentsMap" }, { "type": "null" }] },
-        "mcpServers": { "anyOf": [{ "$ref": "#/definitions/McpServersMap" }, { "type": "null" }] },
-        "packs": { "anyOf": [{ "$ref": "#/definitions/PacksMap" }, { "type": "null" }] },
-        "skills": { "anyOf": [{ "$ref": "#/definitions/SkillsMap" }, { "type": "null" }] },
-        "ignored": { "anyOf": [{ "$ref": "#/definitions/IgnoredSettings" }, { "type": "null" }] },
-        "lint": { "anyOf": [{ "$ref": "#/definitions/LintConfig" }, { "type": "null" }] }
+        "skills": {
+          "anyOf": [{ "$ref": "#/definitions/SkillsMap" }],
+          "description": "Your installed skills, keyed by workspace skill name. Prefer plain source strings; use the object form only to set `enabled: false` or `authored: true`, and never write `enabled: true` or `authored: false` explicitly."
+        },
+        "skillsConfig": {
+          "anyOf": [{ "$ref": "#/definitions/SkillsConfig" }],
+          "description": "Feature-level options for skill management."
+        },
+        "commands": {
+          "anyOf": [{ "$ref": "#/definitions/CommandsMap" }],
+          "description": "Your installed commands, keyed by workspace command name. Prefer plain source strings; use the object form only to set `enabled: false` or `authored: true`, and never write `enabled: true` or `authored: false` explicitly."
+        },
+        "commandsConfig": {
+          "anyOf": [{ "$ref": "#/definitions/CommandsConfig" }],
+          "description": "Feature-level options for command management."
+        },
+        "subagents": {
+          "anyOf": [{ "$ref": "#/definitions/SubagentsMap" }],
+          "description": "Your installed subagents, keyed by workspace subagent name. Prefer plain source strings; use the object form only to set `enabled: false` or `authored: true`, and never write `enabled: true` or `authored: false` explicitly."
+        },
+        "subagentsConfig": {
+          "anyOf": [{ "$ref": "#/definitions/SubagentsConfig" }],
+          "description": "Feature-level options for subagent management."
+        },
+        "packs": {
+          "anyOf": [{ "$ref": "#/definitions/PacksMap" }],
+          "description": "Your installed packs, keyed by workspace pack name. Prefer plain source strings; use the object form only to set `authored: true`, and never write `authored: false` explicitly. Pack entries do not support `enabled` yet."
+        },
+        "packsConfig": {
+          "anyOf": [{ "$ref": "#/definitions/PacksConfig" }],
+          "description": "Feature-level options for pack management."
+        },
+        "mcpServers": {
+          "anyOf": [{ "$ref": "#/definitions/McpServersMap" }],
+          "description": "Your installed MCP servers, keyed by workspace MCP server name. Prefer plain source strings; use the object form only to set `authored: true`, and never write `authored: false` explicitly. MCP server entries do not support `enabled` yet."
+        },
+        "mcpServersConfig": {
+          "anyOf": [{ "$ref": "#/definitions/McpServersConfig" }],
+          "description": "Feature-level options for MCP server management."
+        },
+        "lint": {
+          "anyOf": [{ "$ref": "#/definitions/LintConfig" }],
+          "description": "Lint configuration for `axm lint` in this workspace."
+        }
       },
       "additionalProperties": false,
       "title": "AXM Settings",
-      "description": "Your workspace configuration — owner, sources, installed extensions, and ignore patterns."
+      "description": "Your workspace configuration — owner, sources, installed extensions, feature config, and lint config.",
+      "examples": [
+        {
+          "telemetry": "errors",
+          "agents": ["claude-code", "codex"],
+          "skills": {
+            "code-review": "@acme/skills/code-review@^1.0.0",
+            "legacy-rules": { "source": "@acme/skills/legacy-rules@^1.0.0", "enabled": false }
+          },
+          "skillsConfig": { "ignore": ["local-*"] },
+          "lint": { "rules": { "workspace/settings-schema-valid": "error" } }
+        }
+      ]
     }
   }
 }