Add Claude Code settings.json schema (SchemaStore#4798)

* Add Claude Code settings.json schema

- Add JSON schema for Claude Code settings.json file
- Supports all settings properties including models, themes, permissions
- Includes comprehensive test files covering edge cases
- Matches **/.claude/settings.json files

* [pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci

---------

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>

Author: wagerfield

src/api/json/catalog.json

@@ -1196,6 +1196,12 @@
       "fileMatch": [".clawjectrc", ".clawjectrc.json"],
       "url": "https://raw.githubusercontent.com/clawject/clawject/main/packages/core/src/config/schema.json"
     },
+    {
+      "name": "Claude Code Settings",
+      "description": "Configuration file for Claude Code",
+      "fileMatch": ["**/.claude/settings.json"],
+      "url": "https://json.schemastore.org/claude-code-settings.json"
+    },
     {
       "name": "CVE Record Format",
       "description": "CVE record format to describe security vulnerabilities",

src/schemas/json/claude-code-settings.json

@@ -0,0 +1,103 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://json.schemastore.org/claude-code-settings.json",
+  "$defs": {
+    "rule": {
+      "type": "string",
+      "description": "Tool permission rule (e.g., 'Bash(ls:*)', 'Read(~/.zshrc)', 'WebFetch(domain:github.com)')",
+      "pattern": "^(Agent|Bash|Edit|Glob|Grep|LS|MultiEdit|NotebookEdit|NotebookRead|Read|TodoRead|TodoWrite|WebFetch|WebSearch|Write)\\(?|^mcp__"
+    }
+  },
+  "description": "Configuration file for Claude Code CLI settings",
+  "allowTrailingCommas": true,
+  "additionalProperties": true,
+  "type": "object",
+  "properties": {
+    "$schema": {
+      "type": "string",
+      "description": "The schema for the settings.json file"
+    },
+    "apiKeyHelper": {
+      "type": "string",
+      "description": "Custom script path to generate an auth value"
+    },
+    "autoUpdaterStatus": {
+      "type": "string",
+      "description": "Enable or disable the auto-updater",
+      "enum": ["enabled", "disabled"],
+      "default": "enabled"
+    },
+    "cleanupPeriodDays": {
+      "type": "number",
+      "description": "How long to locally retain chat transcripts (in days)",
+      "default": 30,
+      "minimum": 0
+    },
+    "env": {
+      "type": "object",
+      "description": "Environment variables applied to every session",
+      "additionalProperties": false,
+      "patternProperties": {
+        "^[A-Z_]+$": {
+          "type": "string",
+          "description": "Environment variable value"
+        }
+      },
+      "default": {}
+    },
+    "includeCoAuthoredBy": {
+      "type": "boolean",
+      "description": "Include 'co-authored-by Claude' byline in git commits and pull requests",
+      "default": true
+    },
+    "model": {
+      "type": "string",
+      "description": "Claude model to use",
+      "enum": ["opus", "sonnet"]
+    },
+    "permissions": {
+      "type": "object",
+      "description": "Tool permissions",
+      "additionalProperties": false,
+      "properties": {
+        "allow": {
+          "type": "array",
+          "description": "List of allowed tool rules",
+          "items": { "$ref": "#/$defs/rule" },
+          "uniqueItems": true
+        },
+        "deny": {
+          "type": "array",
+          "description": "List of denied tool rules",
+          "items": { "$ref": "#/$defs/rule" },
+          "uniqueItems": true
+        }
+      },
+      "default": {
+        "allow": [],
+        "deny": []
+      }
+    },
+    "preferredNotifChannel": {
+      "type": "string",
+      "description": "Preferred notification channel",
+      "enum": [
+        "iterm2",
+        "iterm2_with_bell",
+        "terminal_bell",
+        "notifications_disabled"
+      ],
+      "default": "iterm2"
+    },
+    "theme": {
+      "type": "string",
+      "description": "UI theme configuration",
+      "enum": ["dark", "light", "light-daltonized", "dark-daltonized"]
+    },
+    "verbose": {
+      "type": "boolean",
+      "description": "Show full bash and command outputs",
+      "default": false
+    }
+  }
+}

src/test/claude-code-settings/basic-config.json

@@ -0,0 +1,4 @@
+{
+  "model": "sonnet",
+  "verbose": false
+}

src/test/claude-code-settings/complete-config.json

@@ -0,0 +1,28 @@
+{
+  "apiKeyHelper": "/usr/local/bin/claude-auth",
+  "autoUpdaterStatus": "enabled",
+  "cleanupPeriodDays": 30,
+  "env": {
+    "DEBUG_MODE": "true",
+    "EDITOR": "vim"
+  },
+  "includeCoAuthoredBy": false,
+  "model": "sonnet",
+  "permissions": {
+    "allow": [
+      "Read(~/.zshrc)",
+      "Bash(ls:*)",
+      "Bash(git log:*)",
+      "WebFetch(domain:anthropic.com)"
+    ],
+    "deny": [
+      "Bash(rm:*)",
+      "Bash(curl:*)",
+      "Bash(wget:*)",
+      "WebFetch(domain:bad.actor.com)"
+    ]
+  },
+  "preferredNotifChannel": "iterm2",
+  "theme": "dark",
+  "verbose": false
+}

src/test/claude-code-settings/edge-cases.json

@@ -0,0 +1,9 @@
+{
+  "apiKeyHelper": "",
+  "cleanupPeriodDays": 0,
+  "env": {},
+  "permissions": {
+    "allow": [],
+    "deny": []
+  }
+}

src/test/claude-code-settings/empty-config.json

@@ -0,0 +1 @@
+{}

src/test/claude-code-settings/env-variables.json

@@ -0,0 +1,8 @@
+{
+  "env": {
+    "DEBUG_LEVEL": "2",
+    "EDITOR": "nano",
+    "HOME_DIR": "/home/user",
+    "PATH": "/usr/local/bin:/usr/bin:/bin"
+  }
+}

src/test/claude-code-settings/model-opus.json

@@ -0,0 +1,4 @@
+{
+  "includeCoAuthoredBy": true,
+  "model": "opus"
+}

src/test/claude-code-settings/notifications-disabled.json

@@ -0,0 +1,4 @@
+{
+  "preferredNotifChannel": "notifications_disabled",
+  "verbose": true
+}

src/test/claude-code-settings/notifications.json

@@ -0,0 +1,4 @@
+{
+  "preferredNotifChannel": "terminal_bell",
+  "theme": "dark-daltonized"
+}