{"name":"policyHelpers","slug":"policyhelpers","family":"setting","title":"Settings keys","noun":"settings key","description":"An admin policy helper can no longer chain to another policy helper.","description_source":"entry","described_by":{"version":"2.1.228","anchor":"a-policy-helper-can-no-longer-configure-another-policy-helpe"},"presence":{"first_seen":"2.1.228","removed_in":"2.1.284","in_current_build":false,"newest_mined":"2.1.308","builds":46,"mined_builds":149,"first_cited":{"version":"2.1.228","released_at":"2026-08-11 17:45:45","spans":6}},"aliases":[],"entries":[{"version":"2.1.281","anchor":"new-policy-helper-predicate-requires-a-verified-gateway-host","heading":"New policy-helper predicate requires a verified gateway host (hostVerdict)","line":"A new check passes only when the gateway host has been verified and a policy helper is configured","released_at":"2026-09-23 17:01:17","reason":"found in this entry's text"},{"version":"2.1.265","anchor":"policyhelpers-per-source-shadowing-warning-gated-behind-man","heading":"policyHelpers per-source shadowing warning gated behind managedSourcesBehavior: \"merge\"","line":"Claude Code now warns when multiple managed settings sources define conflicting policy helper config under merge mode","released_at":"2026-09-08 19:05:16","reason":"found in this entry's text"},{"version":"2.1.265","anchor":"policyhelpers-per-entry-onfailure-and-retries-settings-now-v","heading":"policyHelpers per-entry onFailure and retries settings now validated for effect","line":"Claude Code now flags policy helpers that require success but have no fallback settings","released_at":"2026-09-08 19:05:16","reason":"found in this entry's text"},{"version":"2.1.265","anchor":"policyhelper-singular-field-now-also-warns-for-ignored-onfai","heading":"policyHelper singular field now also warns for ignored onFailure\/retries","line":"Claude Code now warns if onFailure or retries is set on the singular policyHelper entry, since those are ignored there","released_at":"2026-09-08 19:05:16","reason":"found in this entry's text"},{"version":"2.1.265","anchor":"policyhelpers-onfailureretries-per-os-validation-messag","heading":"policyHelpers onFailure \/ retries per-OS validation messages added","line":"Claude Code now warns when `onFailure` or `retries` are set on the wrong `policyHelper` key, and can refuse to start if an OS-admin helper fails","released_at":"2026-09-08 19:05:16","reason":"found in this entry's text"},{"version":"2.1.265","anchor":"policyhelpers-now-honored-from-remote-managed-settings-too","heading":"policyHelpers now honored from remote managed settings too","line":"policyHelpers can now be delivered via remote managed settings, not just admin-controlled policy sources","released_at":"2026-09-08 19:05:16","reason":"found in this entry's text, named in this entry"},{"version":"2.1.265","anchor":"policyhelpers-entries-gain-a-retries-setting-for-helper-exec","heading":"policyHelpers entries gain a retries setting for helper execution failures","line":"Per-OS `policyHelpers` entries can now set `retries` to control retry attempts after a failed run","released_at":"2026-09-08 19:05:16","reason":"found in this entry's text"},{"version":"2.1.242","anchor":"policy-helpers-can-declare-whether-their-settings-merge-or-r","heading":"Policy helpers can declare whether their settings merge or replace","line":"Admins can say whether a per-OS policy helper's settings replace or merge over the source.","released_at":"2026-08-24 19:16:14","reason":"named in this entry, found in this entry's text"},{"version":"2.1.239","anchor":"policy-helper-warnings-say-which-platform-they-apply-to","heading":"Policy-helper warnings say which platform they apply to","line":"policyHelpers warnings now understand per-OS entries and say when yours has none.","released_at":"2026-08-21 17:18:54","reason":"named in this entry, found in this entry's text"},{"version":"2.1.235","anchor":"policy-helpers-can-now-be-delivered-by-remote-settings-but","heading":"Policy helpers can now be delivered by remote settings, but only after an explicit consent record \u2014 and they run in a scrubbed environment","line":"Remote-delivered policy helpers now require explicit consent and run with a scrubbed environment","released_at":"2026-08-18 18:24:10","reason":"found in this entry's text"}],"entries_total":24,"docs":[],"docs_total":0,"gates":[],"related":[],"url":"https:\/\/changelogs.core-directive.com\/reference\/setting\/policyhelpers","family_url":"https:\/\/changelogs.core-directive.com\/reference\/setting.json"}