CC 2.1.198→201 Adoption Plan

Before → After · Notification types

notification_type	desktop 🖥️	sound 🔔	webhook	after this plan
permission_prompt	✅	✅ Sosumi	✅	unchanged
idle_prompt	✅	✅ Ping	✅	unchanged
agent_needs_input 2.1.198	❌ dropped	❌ silent	✅	✅ notify + Ping
agent_completed 2.1.198	❌ dropped	❌ silent	✅	✅ Glass

Gate: desktop.ts:167 · map: sound.ts:19 — plumbing already reads input.notification_type; fix is two new cases per hook. Closes #2727.

#	idea	bucket	verdict	scope
1	Notification hooks: handle both agent events	fix	KEEP	A+
2	Stamp latest_known 2.1.197→2.1.201	fix	KEEP	A+
3	version-compatibility.md rows 198–201	docs	KEEP	A+
4	Backfill cc-snapshots 199/200/201	docs	KEEP	B+
5	Triage doc (2.1.186 pattern) — closes #2729	docs	KEEP	A+
6	Per-issue Closes #2721–#2729 wiring	hygiene	KEEP	A+
7	Background-by-default guidance (chain-patterns)	docs	KEEP	B+
8	Explore ≤Opus cost note (Fable 💸)	docs	KEEP	B+
9	Stacked slash-skills (≤5) in auto/help	docs	KEEP	B+
10	cc-watch backfill ALL versions since last snapshot	new	REFUTED · already exists (cc-release-watch.mjs:226–240)	—
11	"agent-notify" preference skill	new	DISCARD · YAGNI	—
12	RETRY_WATCHDOG note for bare-eval/CI	docs	KEEP	B+

	file	Δ	note
[M]	src/hooks/src/notification/desktop.ts	+~12	accept 2 new types in gate
[M]	src/hooks/src/notification/sound.ts	+~8	SOUND_MAP + Linux equivalents
[M]	hook tests (notification)	+~40	2 type-mapping tests
[M]	shared/cc-support.json	+~3	latest_known + dated override note
[S]	src/hooks/src/lib/cc-version-matrix.ts	stamp	script-generated — never by hand
[✓]	shared/cc-snapshots/2.1.{199,200,201}.md	0	already merged by cc-watch (#2743/#2750/#2752) — branch synced to origin/main instead; stale local checkout had hidden them
[M]	shared/cc-adoption-gaps.json	+~5	clear stuck 2.1.197 parse_failed entry (ends manual-triage churn)
[M]	doctor/references/version-compatibility.md	+4 rows	matrix ends at 2.1.193 today
[M]	5 skill docs (chain-patterns · explore · auto · configure · bare-eval)	+~60	new-capability guidance
[A]	docs/audits/cc-adoption-2.1.198-201-triage.md	+~80	no-op verdicts, evidence file:line
[A]	docs/feat--cc-adoption-2-1-201/plan-viz.html	this file	satisfies PR playground gate
[G]	plugins/** · docs/site generated	regen	stage with src — expected churn

P1 CODE

branch → notification hook fix + tests → biome + typecheck

P2 STAMP

cc-support.json latest_known → stamp-cc-support.mjs → npm run build

P3 DOCS

triage doc ∥ matrix rows ∥ snapshots ∥ 5 skill docs

P3.5 SYNC

⚠ backfill REFUTED (already upstream) → instead: fetch origin, ff branch, re-stamp, clear stuck 2.1.197 gaps entry

P4 SHIP

full npm test (read summary line!) → PR with per-issue Closes + "playground"

POST

file follow-up issue: cc-watch backfill (→ milestone #154)

hook code change

stamp bump

docs / snapshots

generated churn

💥 Fixture coupling: recovery test couples to latest (untouched) — cc-support tests ran explicitly after stamping: floor 6/6, ceiling 3/3, matrix 17/17 ✅
💥 Masked failure: npm test | tail exits 0 on red — read the summary line, never the pipe's exit code.
💥 Over-closing: each of the 19 issues needs its own Closes keyword; only close what the triage doc verdicts.
🔎 Caught in-flight (audit correction): "cc-watch missed 199/200" was an artifact of a stale local checkout + the alphabetical ls trap (2.1.199 sorts before 2.1.87, so ls | tail hides new snapshots). Two independent agents fell for it. Rule: audit pipeline state at origin/HEAD, never the local tree.

4 → 0

version lag

~14

src files

issues resolved

new notify behaviors

code gap (only)

8.6

composite score