config-audit/docs/cc-2.1.x-changelog-delta.md
Kjell Tore Guttormsen 624f5edabc docs(knowledge): refresh corpus to Opus 4.8 era (CC 2.1.114->181 Batch 3)
The knowledge base was frozen at ~v2.1.111, describing an Opus-4.7 world
after CC shipped Opus 4.8 and Fable 5. Refreshed three agent-facing
knowledge files; every fact re-verified against the official changelog
(~/.claude/cache/changelog.md, CC 2.1.181) on 2026-06-18.

- feature-evolution.md: new Opus-4.8-era rows above the v2.1.111 freeze --
  Opus 4.8 default + /effort xhigh (2.1.154), Fable 5 Mythos-class
  (2.1.170), post-session hook (2.1.169), MessageDisplay (2.1.152),
  /simplify -> /code-review (2.1.147), /config key=value (2.1.181).
- hook-events-reference.md: 26 -> 28 events (+MessageDisplay, +post-session);
  documented Stop/SubagentStop additionalContext output field.
- claude-code-capabilities.md: 2026-06 model/effort lineup table;
  bundled skills /simplify -> /code-review; documented /config key=value.
- cc-2.1.x-changelog-delta.md: marked SUPERSEDED by the gap-matrix.

Verification caught two version errors in STATE/matrix, corrected to the
changelog:
- Stop/SubagentStop additionalContext is 2.1.163, not 2.1.165 (2.1.165 was
  "Bug fixes" only; matrix row 109 already said 2.1.163).
- settings `agent` field introduced 2.0.59; 2.1.157 = honored for
  dispatched `claude agents` sessions, not the introduction.

New tests/knowledge/knowledge-staleness.test.mjs (8 tests) encodes the
verified facts as a re-freeze guard (RED before edits, GREEN after).

Full suite: 850/850 green (+8). self-audit PASS, A(100)/A(97).
2026-06-18 13:35:00 +02:00

6.5 KiB

Claude Code config-surface delta — v2.1.114 → v2.1.181 (SUPERSEDED)

Status: SUPERSEDED by docs/cc-2.1.x-gap-matrix.md (the verified truth source). This draft is kept only as the historical research artifact. Do not action rows from here — the matrix re-verified every row per-surface. Two version errors that propagated into both this draft and the matrix's draft-correction note were re-checked against the official changelog on 2026-06-18 (Batch 3) and corrected at the knowledge layer:

  • Stop/SubagentStop additionalContext: v2.1.163 (not v2.1.165 — that release was "Bug fixes and reliability improvements" only). The gap-matrix even self-contradicts here: row 109 already said 2.1.163.
  • settings agent field: introduced v2.0.59; v2.1.157 is when it became "honored for dispatched claude agents sessions" — this draft's "2.1.154" and the matrix's "2.1.157-as-introduction" are both imprecise.

Original draft note: produced by the claude-code-guide research agent 2026-06-18 from the official changelog. Items below the 2.1.114 floor (e.g. 2.1.105) belong to the token-management thread (Fase 4).

Current latest: v2.1.181 · Window: 2.1.114 → 2.1.181

1. settings.json / settings.local.json

  • 2.1.181 sandbox.allowAppleEvents (macOS opt-in) — HIGH
  • 2.1.181 env CLAUDE_CLIENT_PRESENCE_FILE (suppress mobile notifications) — HIGH
  • 2.1.175 enforceAvailableModels (managed, constrains default model) — HIGH
  • 2.1.176 footerLinksRegexes (footer badges) — MED
  • 2.1.174 wheelScrollAccelerationEnabled — LOW
  • 2.1.169 disableBundledSkills — HIGH
  • 2.1.166 fallbackModel (chain up to 3) — HIGH
  • 2.1.163 managed requiredMinimumVersion, requiredMaximumVersion — HIGH
  • 2.1.161 env OTEL_RESOURCE_ATTRIBUTES — MED
  • 2.1.154 agent (run main thread as named subagent) — HIGH
  • 2.1.154 fastModePerSessionOptIn — HIGH
  • 2.1.153 skipLfs (Git plugin sources) — MED
  • 2.1.149 managed allowAllClaudeAiMcps — HIGH
  • 2.1.143 worktree.bgIsolation: 'none' — HIGH
  • 2.1.141 env CLAUDE_CODE_PLUGIN_PREFER_HTTPS, ANTHROPIC_WORKSPACE_ID — MED/HIGH
  • 2.1.133 managed parentSettingsBehavior, policyHelper — HIGH
  • 2.1.129 skillOverrides (per-skill visibility) — HIGH

2. CLAUDE.md / memory

  • 2.1.169 --safe-mode disables customizations (CLAUDE.md not loaded) — MED
  • 2.1.157 plugins in .claude/skills auto-load; "closest .claude/ wins" precedence — HIGH
  • 2.1.178 nested .claude/skills directory loading — MED

3. Hooks

  • 2.1.178 new matcher syntax Tool(param:value) — HIGH
  • 2.1.172 OTEL model attribute in hook output context — MED
  • 2.1.169 new event post-session (self-hosted runners) — HIGH
  • 2.1.163 SubagentStop supports additionalContext return — HIGH
  • 2.1.157 hook "args: string[]" exec form (no shell wrap) — HIGH
  • 2.1.152 new event MessageDisplay — HIGH
  • 2.1.145 hook input fields background_tasks, session_crons — HIGH
  • 2.1.141 hook output field terminalSequence — HIGH
  • 2.1.139 hook condition "if" syntax — HIGH

4. MCP (.mcp.json)

  • 2.1.153 skipLfs for Git-based sources — MED
  • 2.1.149 managed allowAllClaudeAiMcps (auto-approve claude.ai connectors) — HIGH
  • 2.1.141 env CLAUDE_CODE_PLUGIN_PREFER_HTTPS (transport) — MED
  • (format stdio/SSE/HTTP, scopes local/project/user, OAuth: stable in window)

5. Plugins & marketplace

  • 2.1.178 "closest .claude/" precedence; nested .claude/skills — HIGH
  • 2.1.157 plugins auto-load from .claude/skills/; claude plugin init — HIGH/MED
  • 2.1.154 plugin defaultEnabled: false manifest field — HIGH
  • 2.1.149 managed pluginSuggestionMarketplaces — MED
  • 2.1.143 plugin dependency enforcement (disable/enable) — MED
  • 2.1.142 root-level SKILL.md plugin surfacing — MED
  • 2.1.128 --plugin-dir ./x.zip + --plugin-url (below window but note) — HIGH

6. Skills

  • 2.1.178 nested .claude/skills directory loading — HIGH
  • 2.1.163 \$ escape for literal $ in descriptions — MED
  • 2.1.152 frontmatter Skill type indicator + disallowed-tools; /reload-skills — HIGH
  • 2.1.142 root-level SKILL.md — MED
  • (below window, Fase 4) 2.1.105 skillListingBudgetFraction, maxSkillDescriptionChars

7. Subagents / agents

  • 2.1.178 "closest .claude/" precedence for agent conflicts — HIGH
  • 2.1.172 nested sub-agents (5-level depth limit) — HIGH
  • 2.1.157 subagent_type case/separator-insensitive; /agents discovery — MED
  • 2.1.154 settings agent key; plugin defaultEnabled applies to agents — HIGH
  • 2.1.143 agent spawning in auto mode — MED

8. Slash commands

  • 2.1.147 /simplify/code-review rename — LOW
  • 2.1.152 /code-review --fix — LOW
  • 2.1.139 /goal, /scroll-speed new commands — LOW
  • (frontmatter argument-hint/allowed-tools/model + namespacing: stable)

9. Permissions

  • 2.1.178 Tool(param:value) parameter-level matching — HIGH
  • 2.1.166 glob pattern support in deny rule tool-name position — HIGH
  • 2.1.154 auto mode hard-deny rules — HIGH
  • 2.1.162 WebFetch precedence fixes — MED
  • 2.1.160 single-file grep satisfies read-before-edit — MED
  • (allow/deny/ask arrays: stable)

10. Model lineup

  • 2.1.154 Opus 4.8 new default; /effort xhigh new effort level — HIGH
  • 2.1.158 auto mode on Bedrock/Vertex/Foundry for Opus 4.7/4.8 — HIGH
  • 2.1.170 Fable 5 (Mythos-class) introduced — HIGH
  • 2.1.173 Fable 5 name normalization ([1m] suffix) — HIGH
  • 2.1.142 fast mode default Opus 4.6 → 4.7 — HIGH
  • settings model keys: model, availableModels, enforceAvailableModels, fallbackModel, effortLevel (now incl. xhigh)

11. Output styles / statusline / background / managed / sandbox

  • 2.1.181 sandbox.allowAppleEvents — HIGH
  • 2.1.176 footerLinksRegexes; language key — MED
  • 2.1.169 --safe-mode; env CLAUDE_CLIENT_PRESENCE_FILE — HIGH
  • 2.1.166 env MAX_THINKING_TOKENS=0 — MED
  • 2.1.153 statusline env COLUMNS, LINES — MED
  • 2.1.143 worktree.bgIsolation — HIGH
  • 2.1.141 hook terminalSequence; background agent permission-mode preservation — HIGH/MED
  • 2.1.140 settings symlink hot-reload — MED
  • 2.1.133 managed parentSettingsBehavior, policyHelper — HIGH
  • 2.1.128 env CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS — MED

Sources