chore(claude-settings): append v2.1.139 changelog entry for env var bump

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
Shayan Rais
2026-05-12 23:51:13 +05:00
parent c6f74d84ae
commit 6504be55eb
@@ -506,3 +506,32 @@
| 12 | INVALID | Spurious Drift Claim | `workflow-claude-settings-agent` reported `autoSummaryEnabled` as a separate setting from `awaySummaryEnabled` (HIGH-confidence claim). Verified directly against official settings page — `autoSummaryEnabled` does NOT exist; only `awaySummaryEnabled` is documented | ❌ INVALID (agent contradicted by direct doc verification) |
| 13 | INVALID | Spurious Drift Claim | `workflow-claude-settings-agent` claimed `Agent` permission rule syntax should be `Agent(agent:name)` with an `agent:` prefix. Verified against official settings page — only references `Agent` rules without showing the `agent:` prefix syntax. Report's existing `Agent(name)` form matches established convention; no source confirms the prefix variant | ❌ INVALID (no source-verified evidence for `agent:` prefix) |
| 14 | INVALID | Spurious Drift Claim | `workflow-claude-settings-agent` flagged `model` default (`"default"`) and `language` default (`"english"`) in Core Configuration as cosmetically wrong because the official docs show `-`. The report's values are descriptive placeholders explaining behavior when unset; flipping to `-` would lose information without any user-facing benefit | ❌ INVALID (cosmetic re-verification with no user-facing benefit) |
---
## [2026-05-12 11:40 PM PKT] Claude Code v2.1.139
| # | Priority | Type | Action | Status |
|---|----------|------|--------|--------|
| 1 | HIGH | New Setting | Add `autoMode.hard_deny` field to `autoMode` description (v2.1.136) — unconditional block rules, cannot be overridden by `allow` exceptions or `$defaults` sentinel. Confirmed on official settings page | ✅ COMPLETE (added to `autoMode` field-list description) |
| 2 | HIGH | New Setting | Add `worktree.baseRef` (`"fresh" \| "head"`, default `"fresh"`, v2.1.133) to Worktree Settings table — which ref new worktrees branch from. Confirmed on official settings page | ✅ COMPLETE (added to Worktree Settings table after `worktree.sparsePaths`) |
| 3 | HIGH | New Setting | Add `sandbox.bwrapPath` and `sandbox.socatPath` (managed-only, Linux/WSL2, v2.1.133) to Sandbox Settings table — absolute paths to bubblewrap and socat binaries, overriding `PATH` detection. Confirmed on official settings page | ✅ COMPLETE (added to Sandbox Settings table after `enableWeakerNetworkIsolation`) |
| 4 | HIGH | New Setting | Add `parentSettingsBehavior` (`"first-wins" \| "merge"`, managed-only, default `"first-wins"`, v2.1.133) — controls whether SDK-host parent managed settings apply when admin-deployed managed tier is also present. Confirmed on official settings page | ✅ COMPLETE (added to new "Managed-only policy keys" subsection under Settings Hierarchy) |
| 5 | HIGH | New Setting | Add `policyHelper` (`{path: string}`, managed-only via MDM or file, v2.1.136) — admin-deployed executable that computes managed settings dynamically at startup. Confirmed on official settings page | ✅ COMPLETE (added alongside `parentSettingsBehavior` in Managed-only policy keys subsection) |
| 6 | HIGH | New Setting | Add `skillOverrides` (object, v2.1.129) to General Settings table — per-skill visibility (`"on" / "name-only" / "user-invocable-only" / "off"`). Confirmed on official settings page | ✅ COMPLETE (added to General Settings table between `awaySummaryEnabled` and `disableRemoteControl`) |
| 7 | HIGH | New Setting | Add `disableRemoteControl` (boolean, any scope, v2.1.128) to General Settings table — blocks `claude remote-control`, the `--remote-control` flag, auto-start, and in-session toggle. Confirmed on official settings page | ✅ COMPLETE (added to General Settings table before `feedbackSurveyRate`) |
| 8 | HIGH | New Setting | Add `gcpAuthRefresh` (string script) to AWS & Cloud Credentials section — custom script that refreshes GCP ADC when expired. Confirmed on official settings page | ✅ COMPLETE (added to Authentication Helpers table after `forceLoginOrgUUID`) |
| 9 | HIGH | Missing Env Vars | Add 6 env vars to Common Environment Variables table: `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` (v2.1.136), `CLAUDE_CODE_SESSION_ID` (v2.1.132), `CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN` (v2.1.132), `CLAUDE_CODE_FORCE_SYNC_OUTPUT` (v2.1.129), `CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE` (v2.1.129), `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` (v2.1.129). All confirmed on official /en/env-vars page | ✅ COMPLETE (all 6 env vars added to grouped sections of Common Environment Variables table) |
| 10 | HIGH | Version Bump | Update report version badge from v2.1.126 → v2.1.139 and header "As of v2.1.126" → "As of v2.1.139" | ✅ COMPLETE (badge updated in Phase 2.6; body header text updated; env var count bumped 175+ → 180+) |
| 11 | MED | Permission Syntax | Add `Skill(name *)` wildcard prefix-match note to Tool Permission Syntax (v2.1.139) — mirrors `Bash(ls *)` behavior, allowing patterns like `Skill(weather *)` to match `weather-fetcher`, `weather-svg-creator` | ✅ COMPLETE (Skill row in Tool Permission Syntax table updated with prefix-match example and v2.1.139 attribution) |
| 12 | MED | Permission Behavior | Add v2.1.136 plan-mode note: writes are blocked even when a matching `Edit(...)` allow rule exists | ✅ COMPLETE (plan-mode row in Permission Modes table updated with v2.1.136 override-allow-rules note) |
| 13 | MED | MCP Reserved Name | Add `Workspace` reserved MCP server name note (v2.1.128) — existing servers named "workspace" are skipped with a warning | ✅ COMPLETE (blockquote added under MCP Servers section header) |
| 14 | MED | Effort Variable Scope | Expand `${CLAUDE_EFFORT}` skill-template note: v2.1.133 also passes the env var to Bash tool subprocesses and hook handlers (not just skill templates) | ✅ COMPLETE (skill template variable note rewritten as "Effort env propagation" with v2.1.133 Bash + hook scope detail) |
| 15 | MED | Example Update | Update Quick Reference example to include `worktree.baseRef`, `autoMode.hard_deny`, and `skillOverrides` to showcase v2.1.129v2.1.136 features | ✅ COMPLETE (all 3 keys added to Quick Reference example) |
| 16 | LOW | Useful Commands | Add `claude plugin prune` (v2.1.121) and `claude plugin details` (v2.1.139) to Useful Commands table | ✅ COMPLETE (both commands added after `claude plugin tag`) |
| 17 | LOW | Sandbox Footnote | Add v2.1.139 `autoAllowBashIfSandboxed` shell-expansion fix note — now handles `$VAR` and `$(cmd)` correctly | ✅ COMPLETE (description expanded in Sandbox Settings table) |
| 18 | LOW | MCP Improvements | Add v2.1.139 `.mcp.json` hot-reload (via `/mcp` Reconnect) and `CLAUDE_PROJECT_DIR` MCP stdio injection notes to MCP Servers section | ✅ COMPLETE (combined into single blockquote under MCP Servers section) |
| 19 | LOW | Suspect Key Recurrence | `OTEL_LOG_TOOL_DETAILS` still "in v2.1.85 changelog, not yet on official env-vars page" after 17+ consecutive runs. Per Rule 10B, deferred pending official docs update | ✋ ON HOLD (kept — recurring from 2026-04-14 v2.1.107) |
| 20 | LOW | Suspect Key Recurrence | `OTEL_LOG_TOOL_CONTENT` still changelog-only. Defer per Rule 8A | ✋ ON HOLD (kept — recurring from 2026-04-16 v2.1.110) |
| 21 | INVALID | Spurious Drift Claim | `claude-code-guide` listed effort values as `"fast"`, `"balanced"`, `"thorough"`. Verified against official /en/env-vars — valid values are `low`, `medium`, `high`, `xhigh`, `max`, `auto`. Report retained | ❌ INVALID (agent contradicted by official docs) |
| 22 | INVALID | Spurious Drift Claim | `claude-code-guide` claimed `CLAUDE_EFFORT` is a documented env var. Verified — only `CLAUDE_CODE_EFFORT_LEVEL` exists on /en/env-vars. `CLAUDE_EFFORT` is changelog-only (subprocess injection, not user-configurable). Report retained | ❌ INVALID (agent contradicted by official docs) |