JSON schema on SchemaStore is out of sync with hook events (TeammateIdle, TaskCompleted)

Resolved 💬 2 comments Opened Feb 11, 2026 by Johntycour Closed Mar 12, 2026

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 TeammateIdle or TaskCompleted hooks 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.

View original on GitHub ↗

This issue has 2 comments on GitHub. Read the full discussion on GitHub ↗