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).
This commit is contained in:
Kjell Tore Guttormsen 2026-06-18 13:35:00 +02:00
commit 624f5edabc
5 changed files with 119 additions and 8 deletions

View file

@ -1,10 +1,20 @@
# Claude Code config-surface delta — v2.1.114 → v2.1.181 (DRAFT)
# Claude Code config-surface delta — v2.1.114 → v2.1.181 (SUPERSEDED)
> **Status: DRAFT.** Produced by claude-code-guide research agent 2026-06-18 from the official
> changelog. Treated as a checklist — **each row is independently re-verified per-surface in Fase 2**
> (workflow `config-audit-cc-gap`) against https://raw.githubusercontent.com/anthropics/claude-code/main/CHANGELOG.md
> before any action. Items below the 2.1.114 floor (e.g. 2.1.105) are kept for the token-management
> thread (Fase 4) but are out of the primary window.
> **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