open/config-audit
1
0
Fork 0
Code Issues Pull requests Releases Wiki Activity Actions
config-audit/docs/cc-2.1.x-gap-review-plan.md
Kjell Tore Guttormsen 315ea2259f docs(config-audit): CC 2.1.114-181 coverage gap analysis (Fase 0-2) 
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
2026-06-18 11:31:48 +02:00

3.8 KiB
Raw Permalink Blame History

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.