[DOCS] Hooks reference missing `ConfigChange` hook event and input schema
Documentation Type
Missing documentation (feature not documented)
Documentation Location
https://code.claude.com/docs/en/hooks
Section/Topic
Hook events lifecycle section and event-specific schema docs.
Current Documentation
The page documents hook events and schemas, for example:
## Hook events Each event corresponds to a point in Claude Code's lifecycle where hooks can run. ### SessionStart ... ### PreCompact ... ### SessionEnd
There is currently no ConfigChange event section.
What's Wrong or Missing?
Claude Code v2.1.49 adds a new ConfigChange hook event, but the hooks reference does not document it.
That leaves hook authors without:
- when
ConfigChangefires, - expected matcher behavior,
- input payload schema,
- decision/output behavior for this event.
Suggested Improvement
Add a ### ConfigChange section in https://code.claude.com/docs/en/hooks that matches the format used for other events:
- When it fires (configuration files changed during an active session)
- Matcher semantics (if supported)
- Input schema with a full JSON example
- Decision control/output behavior
- Example use cases for auditing and policy enforcement
Impact
Medium - Makes feature difficult to understand
Additional Context
Affected Pages:
| Page | Line(s) | Context |
|------|---------|---------|
| https://code.claude.com/docs/en/hooks | 551+ | Hook events reference includes event sections but no ConfigChange entry |
Total scope: 1 page affected
This issue has 2 comments on GitHub. Read the full discussion on GitHub ↗