JSON schema on SchemaStore is out of sync with hook events (TeammateIdle, TaskCompleted)
Problem
The Claude Code JSON schema hosted on SchemaStore (https://json.schemastore.org/claude-code-settings.json) is out of sync with the actual features available in Claude Code.
Specifically, the TeammateIdle and TaskCompleted hook events were added in v2.1.33 (Feb 6, 2026), but the schema on SchemaStore still has additionalProperties: false on the hooks object and does not list these events. This causes a false validation warning at startup:
Found 1 invalid settings file
This leads users to believe their configuration is broken and potentially delete working hooks.
Root Cause
The SchemaStore JSON schema for Claude Code is maintained by community contributors via PRs. There is no automated sync between Claude Code releases and SchemaStore updates. The last schema update covered v2.1.29 features.
Impact
- Users who configure
TeammateIdleorTaskCompletedhooks see a validation warning every time Claude Code starts - Some users may delete these hooks thinking they are invalid
- IDE JSON schema validation (VS Code, etc.) also flags these as errors
Fix Submitted
I submitted a PR to SchemaStore adding the missing events: https://github.com/SchemaStore/schemastore/pull/5361
Suggestion
Consider automating the schema sync as part of the release process, or maintaining the schema in the Claude Code repo itself and publishing it to SchemaStore via CI/CD.
This issue has 2 comments on GitHub. Read the full discussion on GitHub ↗