# Context Compression Alignment TODO Index

只保留未完成项。已完成项不回填，历史以 Git commit 为准。

更新时间：2026-05-21

## 当前主线

- Claude Code context compression architecture parity：
  - [CLAUDE-CODE-COMPRESSION-ARCHITECTURE-PARITY-TODO-2026-05-21.md](./CLAUDE-CODE-COMPRESSION-ARCHITECTURE-PARITY-TODO-2026-05-21.md)
- Claude Code cache editing microcompact 迁移清单：
  - [CACHE-EDITING-MICROCOMPACT-TODO-2026-05-21.md](./CACHE-EDITING-MICROCOMPACT-TODO-2026-05-21.md)
- WebGPT / subagent 审查收敛修复清单：
  - [WEBGPT-REVIEW-FIX-TODO-2026-05-20.md](./WEBGPT-REVIEW-FIX-TODO-2026-05-20.md)
- 暂停中的后续项：
  - [CCA-180-DEFERRED-TASK-RESTORE-UTILITY-TODO-2026-05-21.md](./CCA-180-DEFERRED-TASK-RESTORE-UTILITY-TODO-2026-05-21.md)
- 后续阶段参考清单：
  - [NEXT-TODO-2026-04-07.md](./NEXT-TODO-2026-04-07.md)
- 当前暂停状态：
  - [PAUSE-STATE-2026-05-16.md](./PAUSE-STATE-2026-05-16.md)

## 当前推荐顺序

1. 先执行 Claude Code context compression architecture parity 的 Batch 0~2，把 durable projection / request reducer / cache side-effect / materializing compact 的架构边界锁住。
2. 在进入 durable `snip` / `context collapse` 迁移前，先做 Batch 3 的小状态风险修复：pending restore `/compact` path、request-collapse event boundary scope、compact snapshot recovery guard。
3. 再进入 durable `snip` migration；此时可以先复用当前 Formax snip heuristic，不急着对齐 Claude Code 内部参数。
4. durable `snip` 稳定后，再进入 durable context-collapse store / snapshot / overflow-drain 迁移。
5. `CCA-180` deferred-task restore utility 继续暂停；只有 architecture parity 主线完成 Batch 0~3 后，再决定是否恢复。

## 说明

- 当前建议：暂停在 post-`CCA-172` / pre-`CCA-180`。
- 2026-05-21 新增 Claude Code cache editing microcompact 迁移清单；在恢复 `CCA-180` 前，建议先完成 Batch 0~2，把 request-only side-channel 与 Anthropic payload 语义锁住。
- 2026-05-21 新增 Claude Code context compression architecture parity 清单；当前主线从“单点 cache-editing/WebGPT 收口”升级为“整层压缩架构对齐”。`snip` 与 `context collapse` 后续按 durable projection subsystem 处理，而不是先调 helper 内部启发式。
- 2026-05-20 新增 WebGPT / subagent 审查收敛清单；建议先完成 Batch 0~2 的测试优先收敛，再恢复原 `CCA-180` 主线。
- 2026-05-21 说明：`CCA-180` 的 Batch 1 / Batch 2 已通过 `a7a399ad` 提前完成并保留，但当前暂停继续扩展 `CCA-180`；当前工作重新回到 WebGPT/cache-editing 收敛主线。
- 当前暂停理由、剩余工作量估算、恢复顺序见：
  - [PAUSE-STATE-2026-05-16.md](./PAUSE-STATE-2026-05-16.md)
- `CCA-080` ~ `CCA-085` 与 `CCA-090` 这一波已经完成。
- `CCA-100` / `CCA-110` / `CCA-111` / `CCA-112` 已完成。
- `CCA-120` / `CCA-121` / `CCA-122` / `CCA-123` 这一波也已经完成，当前主线已切换。
- `CCA-130` / `CCA-131` / `CCA-132` 已完成，post-132 重排也已完成。
- `CCA-140` / `CCA-141` / `CCA-142` 已完成。
- `CCA-143` / `CCA-144` / `CCA-145` / `CCA-146` 已完成，当前 14x wave 已收口。
- `CCA-150` 已完成，working-set selector 现已按 anchor kind 区分 backtrack window，并把 `anchorMaxBacktrackTurns` 暴露到 diagnostics。
- `CCA-151` 已完成，app-server `thread/resume` 现在也会复用 canonical restore artifacts，并把 session-memory reminder 作为 next-turn-only injected blocks 在服务端消费一次。
- `CCA-152` 已完成，post-compact/manual/reactive/finalize 这些 surrounding flow 现在会复用 canonical middle-layer stack materialize persisted baseline；terminal prune 不再写回 future-turn history。
- `CCA-153` 已完成，app-server `thread/resume` 现在也会暴露 canonical `latestCompactBoundary`，Web runtime 会在 restore path 直接消费这份 compact protocol fact。
- post-`CCA-153` mainline re-rank 已完成。
- `CCA-160` 已完成，working-set selector 已从 filesystem-cluster-aware 推进到 task-minimal v5：当前会把 recent task planning/todo state 与 `task_execution_cluster`（例如 `Read + Edit + TodoWrite`）一起纳入 keep strategy，并把 `taskStateKinds` / `selectionReasons` 暴露到 diagnostics。
- `CCA-161` 已完成，session-memory restore utility 现在会通过 canonical restore-artifacts 路径生成结构化 `pendingSessionMemoryRestore` 摘要，并让 `thread/resume` / `thread/replay` 在 next-turn-only pending 窗口内共用这份 utility surface。
- `CCA-162` 已完成，`thread/replay` 现在会直接返回 canonical `latestCompactBoundary`，Web replay runtime 也会消费这份 compact protocol fact，并在 replay source 下继续显示 compact header。
- `CCA-163` 已完成，历史上曾引入基于 stale user-turn age 的 time-aware path；该路径已被 2026-05-21 Claude Code-style cache-editing / cold-cache wall-clock assistant-gap microcompact 语义 supersede。当前 active contract 见 `docs/contracts/context-strategy-stack-contract.md`。
- post-`CCA-163` mainline re-rank 已完成。
- `CCA-170` 已完成，manual `/compact` 现在会和 auto compact 一样复用 task-minimal `keep_combo` selector；即使 `keepLastTurns=0`，也会按当前 working-set anchor / planning state / recent files 保留最小任务上下文，而不再退回固定 `keep_last_turns`。
- `CCA-171` 已完成，higher-order restore utility v6 现在会在 canonical `pendingSessionMemoryRestore` / next-turn reminder 路径中额外暴露 bounded 的 `recentSkills` 与 `recentSubagentTypes`，让 restore surface 能恢复更高阶任务状态，而不引入新的 persisted authority。
- `CCA-172` 已完成，Web `thread/messages` inspection path 现在也会保留 canonical `keepStrategy`、`rehydrationPlan`、`rehydrationCost`、`preservedSegment` 这组 deeper compact-boundary fields；thread-scoped compact-boundary cache 也已改成用同一套 deep equality 刷新，避免 history/replay/read/resume 因消费路径不同而退化成不同深度的 compact summary。
- post-`CCA-172` mainline re-rank 已完成。
- 新的 18x 候选主线保留但暂停：
  - deferred-task restore utility v7
  - preserved-segment relink parity
  - reactive compact shaping v3
- 当前恢复顺序先回到 WebGPT/cache-editing 收敛主线；只有该主线收口后，才重新决定是否恢复 18x。
- 仍然不建议直接进入完整 collapse store / archived span 设计。
