decisions and learnings.

Signed-off-by: Jose Alekhinne <jose@ctx.ist>

Author: josealekhine

.context/DECISIONS.md

@@ -3,6 +3,7 @@
 <!-- INDEX:START -->
 | Date | Decision |
 |----|--------|
+| 2026-07-03 | Keep sonnet-4-6 at the 200k default despite the API catalog listing 1M |
 | 2026-06-07 | ctx-dream executor is a documented contract, not a hardcoded cron/claude assumption |
 | 2026-06-07 | Output belongs in write/ — taxonomy and emission style (consolidated) |
 | 2026-06-07 | Package taxonomy and shared-code placement (consolidated) |
@@ -109,6 +110,20 @@ For significant decisions:
 
 -->
 
+## [2026-07-03-182236] Keep sonnet-4-6 at the 200k default despite the API catalog listing 1M
+
+**Status**: Accepted
+
+**Context**: Claude 5 window-detection fix (specs/model-context-window-fable.md); Anthropic's current catalog shows Sonnet 4.6 with a 1M window at the API level
+
+**Decision**: Keep sonnet-4-6 at the 200k default despite the API catalog listing 1M
+
+**Rationale**: ctx models Claude Code's per-session gating, not raw API capability: Sonnet 4.6's 1M is an explicit opt-in already handled by ModelSuffix1M and ClaudeSettingsHas1M, and the existing test deliberately pins the 200k default
+
+**Consequence**: Revisit only with session-level evidence (a sonnet-4-6 JSONL showing 1M without the [1m] suffix); over-reporting the window would silence the context hook while a session genuinely fills
+
+---
+
 ## [2026-06-07-112203] ctx-dream executor is a documented contract, not a hardcoded cron/claude assumption
 
 **Status**: Accepted

.context/LEARNINGS.md

@@ -17,6 +17,7 @@ DO NOT UPDATE FOR:
 <!-- INDEX:START -->
 | Date | Learning |
 |----|--------|
+| 2026-07-03 | New Claude model families silently fall to the 200k default in ModelContextWindow |
 | 2026-06-07 | Pin an on-disk contract before splitting work across parallel agents |
 | 2026-06-07 | site/ is tracked build output — rebuild and bundle it with doc commits |
 | 2026-06-07 | ctx-dream is headless-first; invoking /ctx-dream interactively is debugging, not the UX |
@@ -107,6 +108,16 @@ DO NOT UPDATE FOR:
 
 ---
 
+## [2026-07-03-182238] New Claude model families silently fall to the 200k default in ModelContextWindow
+
+**Context**: claude-fable-5 sessions warned '104 percent full' while the 1M window was 79 percent free; ModelContextWindow only recognized the [1m] suffix and the opus substring
+
+**Lesson**: Unmapped model families inherit rc.DefaultContextWindow (200k), and every EffectiveContextWindow consumer (check-context-size hook, heartbeat, nudges, provenance) misreports against the wrong window
+
+**Application**: At every model launch: add the family substring to internal/config/claude, extend TestModelContextWindow, and sanity-check against a live session's /context output before trusting hook percentages
+
+---
+
 ## [2026-06-07-162840] Pin an on-disk contract before splitting work across parallel agents
 
 **Context**: The ctx-dream skill (proposal writer) and the ctx dream CLI

specs/ctx-task-out.md

@@ -108,9 +108,14 @@ to rename, keep the phrasal-verb constraint.
       milestone m0a) produces a plan passing the skill's own quality
       checklist — including a correct refusal while D-001 (language
       choice) is unresolved
-      *(gate half verified read-only 2026-07-03: D-001 open in the spec
-      → blocking-TBD refusal fires by construction; the plan-producing
-      run happens post-reinstall via the originating session)*
+      *(refusal half executed live 2026-07-03 by session c887a6d4
+      hand-running the landed SKILL.md against zhc/os m0a: the gate
+      surfaced TWO blockers — D-001 and D-003 (artifact schema
+      language), one more than this work order predicted; the
+      "schema format" example in the blocking definition earned its
+      place. Both blockers resolved same day via zhc/os DECISIONS.md
+      (D-003 → JSON Schema, steering; D-001 → Go, Board). The
+      plan-producing run happens post-reinstall.)*
 
 ## Review