II.
HookSurface JSON
Structured · livehook-surface:claude.config-change
ConfigChange (Claude Code) json
Inspect the normalized record payload exactly as the atlas UI reads it.
{
"id": "hook-surface:claude.config-change",
"_kind": "HookSurface",
"_file": "channels-hooks/hook-surfaces/native/claude-code-extended-hooks.yaml",
"_cluster": "channels-hooks",
"attributes": {
"eventName": "ConfigChange (Claude Code)",
"displayName": "ConfigChange (Claude Code)",
"kind": "native",
"originVendor": "Anthropic",
"direction": "pre",
"blocking": true,
"family": "in-process",
"payloadSchema": {
"type": "object",
"required": [
"hook_event_name",
"source"
],
"properties": {
"hook_event_name": {
"type": "string",
"const": "ConfigChange"
},
"source": {
"type": "string",
"enum": [
"user_settings",
"project_settings",
"local_settings",
"policy_settings",
"skills"
]
},
"previous_config": {
"type": [
"object",
"null"
]
},
"new_config": {
"type": [
"object",
"null"
]
}
}
},
"description": "Fires when a configuration file changes during the session. Exit 2\nblocks the change (except for policy_settings, which always wins).\nUsed to enforce org-wide config invariants. Matchable by source.\n"
},
"outgoingEdges": [],
"incomingEdges": [
{
"from": "agent-runtime-impl:claude-code.runtime@1.x",
"to": "hook-surface:claude.config-change",
"kind": "exposes",
"attributes": {}
},
{
"from": "hook-mapping:claude-config-change",
"to": "hook-surface:claude.config-change",
"kind": "maps_hook",
"attributes": {}
}
]
}