feat(claude-code-settings): sync to Claude Code v2.1.112

[miteshashar]

Syncs claude-code-settings.json from v2.1.76 (previous sync) to v2.1.112. Subsumes the contributions in open PRs #5483 (large v2.1.81 sync) and #5583 (hookCommand fields). Resulting diff reflects a deep review of live docs at https://code.claude.com/docs/en with multi-pass verification and matching with docs and Changelog.

Schema

New hookCommand fields

• Add asyncRewake (command-only) — background hook that wakes the model on exit code 2 (v2.1.79)
• Add shell (command-only, enum bash|powershell) — shell interpreter selector, per hooks documentation (v2.1.85)
• Add if (command/prompt/agent/http) — permission-rule-syntax filter, per hooks-guide#filter-hooks-with-matchers. Evaluated only on tool-related events; description notes the scope.
• Excluded: once — proposed in claude-code-settings: add if, shell, once to hookCommand #5583, but current hooks docs scope this field to skill frontmatter YAML, not settings.json hookCommand.

New hook event

• Add StopFailure — runs when a turn ends due to an API error (matcher values: rate_limit, authentication_failed, billing_error, invalid_request, server_error, max_output_tokens, unknown), per hooks documentation (v2.1.84)

Top-level properties (17)

• agent — run the main thread as a named subagent, per settings documentation
• allowedChannelPlugins — managed-only allowlist of plugins that may push channel notifications when channelsEnabled is true
• autoMemoryDirectory — custom auto-memory storage path, per memory documentation
• autoMode — auto-mode classifier prompt customization (allow/soft_deny/environment), per permissions documentation. Description warns that allow/soft_deny entirely replace classifier defaults.
• channelsEnabled — Teams/Enterprise opt-in for channel notifications
• defaultShell (enum bash|powershell) — default shell for input-box ! commands; notes that powershell requires CLAUDE_CODE_USE_POWERSHELL_TOOL=1 with pwsh on PATH
• disableDeepLinkRegistration ("disable") — prevents claude:// protocol handler registration (managed-only)
• disableSkillShellExecution — disable inline shell execution in skills and custom slash commands (v2.1.91)
• forceRemoteSettingsRefresh — fail-closed managed-only bootstrap policy (v2.1.92)
• minimumVersion — prevents downgrades when switching release channels
• showClearContextOnPlanAccept — adds clear-context option on plan approval dialog
• showThinkingSummaries — restore thinking summaries in transcript view (off by default, v2.1.89)
• skipDangerousModePermissionPrompt — tracks bypass-permissions opt-in dialog acceptance
• strictPluginOnlyCustomization — managed-only; locks customization surfaces (skills/agents/hooks/mcp) to plugin sources
• tui (enum fullscreen|default) — flicker-free alt-screen vs classic renderer (v2.1.110)
• useAutoModeDuringPlan — apply auto-mode classifier during plan mode
• viewMode (enum default|verbose|focus) — transcript view mode (focus is the Ctrl+O toggle)
• voiceEnabled — push-to-talk dictation (see voice-dictation docs)

Nested additions

• permissions.disableAutoMode ("disable") — mirror of disableBypassPermissionsMode, per permissions documentation. Note: feat(claude-code): update settings schema to match v2.1.81 #5483 placed this at both top-level and under permissions; only the nested form is correct per docs.
• sandbox.network.allowMachLookup — macOS-only XPC/Mach service allowlist, per settings documentation (v2.1.97)
• sandbox.ripgrep — custom ripgrep binary/args
• statusLine.refreshInterval (min 1) — re-run status line every N seconds, per statusline documentation (v2.1.97)
• pluginConfigs.*.options — non-sensitive plugin userConfig values, per plugins-reference

Enum extensions

• effortLevel: add xhigh (Opus 4.7, v2.1.111) and max; description rewritten to match model-config documentation for per-model/plan defaults and max session-only behavior
• permissionRule pattern: add Monitor and PowerShell tools

Tightenings

• cleanupPeriodDays minimum: 0 → 1 — v2.1.89 validator explicitly rejects 0 (previously silently disabled cleanup)

Doc-anchor fixes

• hooks-guide#filter-hooks-with-if → hooks-guide#filter-hooks-with-matchers
• hooks#http-hooks → hooks#http-hook-fields
• memory#exclude-specific-claudemd-files → memory#exclude-specific-claude-md-files
• settings#tools-available-to-claude → /docs/en/tools-reference (canonical tool list page)

Tests

• modern-complete-config.json — exercises every new property for full coverage
• complete-config.json — adds effortLevel: medium and viewMode: default for enum-value spread
• edge-cases.json — updates cleanupPeriodDays: 0 → 1 (forced by tightened minimum)
• New enum-coverage.json — filename/concept taken from feat(claude-code): update settings schema to match v2.1.81 #5483 by @r-johnv; content adapted to our schema to cover alternate enum values (bash, fullscreen, xhigh, verbose) and fill positive-coverage gaps across the new enums

Negative tests

• invalid-enum-values.json — adds invalid values for defaultShell, disableDeepLinkRegistration, permissions.disableAutoMode, tui, viewMode
• New invalid-hook-shell.json — identical to the file proposed in claude-code-settings: add if, shell, once to hookCommand #5583 by @sarahdeaton; exercises the hookCommand.shell invalid-enum path

Coverage helper

• src/helpers/coverage.js — adds a deep name-based fallback for $defs-path resolution in collectValuesByPath so enum/required checks match values exercised via $ref. Included from feat(claude-code): update settings schema to match v2.1.81 #5483 by @r-johnv to extend the coverage gate so the #$defs/hookCommand.shell check passes in this sync (would otherwise fail the gate). Committed separately to preserve authorship.

Skipped

• once hookCommand field (alike claude-code-settings: add if, shell, once to hookCommand #5583) — Had added, but removed after validation. Per hooks documentation, the once field belongs to skill frontmatter YAML (hooks declared inside skills), not to hookCommand entries declared in settings.json.
• Top-level disableAutoMode duplicate from feat(claude-code): update settings schema to match v2.1.81 #5483 — kept only under permissions per docs.

🤖 Generated with Claude Code

[github-actions]

Thanks for the PR!

This section of the codebase is owned by @domdomegg, @bogini, and @sarahdeaton - if they write a comment saying "LGTM" then it will be merged.