Kjell Tore Guttormsen
315ea2259f
Systematic review of Claude Code config-surface changes from the plugin's last-verified baseline (v2.1.114) to installed v2.1.181, against current scanner coverage. 12/12 surfaces, 162 verified gap rows via two background gap-analysis workflows (search-first, per-surface changelog verification).
Key finding: a cluster of ACTIVE FALSE POSITIVES - config-audit flags valid v2.1.181 config as wrong (effortLevel xhigh; ~12 settings keys incl. sandbox/fallbackModel/enforceAvailableModels/disableBundledSkills/agent; MCP ${CLAUDE_PROJECT_DIR} and POSIX expansions; param-qualified permission rules; MessageDisplay/post-session hooks). Recommended release v5.2.0 (byte-stable; fixes remove false findings). Voyage escalation: no.
- docs/cc-2.1.x-gap-review-plan.md - ratified plan (method A, floor v2.1.114)
- docs/cc-2.1.x-gap-matrix.md - full gap matrix + buckets + release call
- docs/cc-2.1.x-changelog-delta.md - changelog corpus (superseded by matrix)
STATE.md updated (gitignored) - next session resumes at Batch 1.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Ter3E2JSi1Khgmuf2kady8
45 lines
3.8 KiB
Markdown
45 lines
3.8 KiB
Markdown
# Plan — Claude Code 2.1.114→181 dekningsgjennomgang
|
||
|
||
**Ratifisert:** 2026-06-18 · **Scope:** kun `config-audit/` · **Metode:** A (orkestrert gap-matrise + verifikasjon per surface)
|
||
|
||
## Mål
|
||
Gå systematisk gjennom hver konfigurasjons-relevante Claude Code-endring i vinduet **v2.1.114 → v2.1.181** (~67 releaser), avgjøre om config-audit må endre hva den skanner/anbefaler, og produsere en prioritert tiltaksplan. Deretter (egen fase) token-optimalisering.
|
||
|
||
## Bakgrunn / hvorfor nå
|
||
Pluginens kunnskapsbase ble sist verifisert ved **v2.1.114** (`knowledge/claude-code-capabilities.md:4`). Installert CC er **2.1.181**. Verifisert staleness ved oppstart:
|
||
- `settings-validator.mjs:66` `VALID_EFFORT_LEVELS` mangler `xhigh` (CC 2.1.154) → **false positive** på gyldig konfig.
|
||
- Hook-events `post-session`, `MessageDisplay` udokumentert i `knowledge/hook-events-reference.md`.
|
||
- «Opus 4.7» hardkodet i `token-hotspots.mjs`, `opus-4.7-patterns.md`, `configuration-best-practices.md` — 4.8 er default, Fable 5 finnes.
|
||
- `feature-evolution.md` (staleness-tracker) stopper ved v2.1.111.
|
||
- Nyere settings-nøkler ukjente for validatoren (`fallbackModel`, `enforceAvailableModels`, `disableBundledSkills`, `skillOverrides`, `sandbox.allowAppleEvents` …).
|
||
|
||
## Versjonsgulv
|
||
**2.1.114** (pluginens faktiske sist-verifiserte punkt), ikke 2.1.130 — ellers mistes 2.1.115–129.
|
||
|
||
## Metode (ratifisert: A)
|
||
Hovedkontekst orkestrerer; én verifikasjons-agent per config-surface, mekanisert som dynamisk workflow `config-audit-cc-gap`. Eskalering til Voyage (`/trekbrief→/trekplan`) **kun hvis** Fase 2 avdekker netto-nye scannere store nok til å forsvare det.
|
||
|
||
## Faser
|
||
- **Fase 0 — Lås changelog-korpus.** Re-verifiser mot offisiell `CHANGELOG.md` for hele vinduet, per surface, med kildelenker. *Leveranse:* `docs/cc-2.1.x-changelog-delta.md` (draft → verifisert i Fase 2).
|
||
- **Fase 1 — Dekningsbaseline.** Map hver scanner + knowledge-fil til surface + kjent-sett (settings-nøkler, hook-events, 25 feature-checks, mcp-felter, token-mønstre).
|
||
- **Fase 2 — Gap-matrise (kjernen).** Kryss delta × dekning. Hver rad: `surface → CC-endring → dekket/delvis/mangler/nå-feil → tiltakstype → mål-fil → prioritet H/M/L`. *Leveranse:* `docs/cc-2.1.x-gap-matrix.md`.
|
||
- **Fase 3 — Prioritert tiltaksplan + release-skisse.** Quick wins (xhigh, kjent-nøkler, hook-events, 4.7→4.8) vs større (sandbox/managed-settings, `Tool(param:value)`-permissions, plugin `defaultEnabled`). Avgjør v5.2 vs 6.0. Ratifiseres FØR kode.
|
||
- **Fase 4 (etter, egen tråd) — Token-optimalisering.** Refresh `opus-4.7-patterns` → 4.8/Fable 5; nye token-styrings-settings som TOK/feature-gap-checks.
|
||
|
||
## Tiltakstyper (klassifisering i matrisen)
|
||
`update-knowledge` · `extend-scanner-known-set` · `new-feature-gap-check` · `new-scanner` · `fix-false-positive` · `none`.
|
||
|
||
## Verifisering (testbare kriterier)
|
||
- Hver HIGH-impact-endring i vinduet har **én rad** i gap-matrisen med verdikt + kildelenke (#HIGH = #rader).
|
||
- Regresjonstest: fixture med `effortLevel: "xhigh"` flagges **ikke** (beviser false-positive fikset).
|
||
- `node --test 'tests/**/*.test.mjs'` grønn (baseline 792) etter hver scanner-endring.
|
||
- `node scanners/self-audit.mjs` ren på pluginen selv.
|
||
- `feature-evolution.md` siste rad = v2.1.181.
|
||
- Ny changelog-scout finner **0** netto-nye uoppdagede surfaces (completeness-sjekk).
|
||
|
||
## Scope-gjerde
|
||
Kun `config-audit/`. Fase 0–3 = analyse/planlegging. INGEN produksjonskode-endring uten ratifisert tiltaksplan + failing test først (Iron Law). Fase 4 startes ikke før 0–3 er ratifisert.
|
||
|
||
## Risiko
|
||
- Agent-draft kan inneholde feil/items under gulvet → Fase 2 re-verifiserer hver rad mot offisiell kilde.
|
||
- Web-fetch utilgjengelig i headless workflow-agenter → graceful fallback til draft, rader merkes `web_verified:false`.
|