Historical sessions created under the old code agent preset can no longer be opened after the code → ptc rename

[l5ng]

[ui-input-trigger] source "command" candidates failed: Error: command directory warmup failed: command.list failed: internal: resume failed for session "session-31f50f5e-4038-4819-8dc8-c5c14deb6580": Error: agent-presets: preset "code" not found (available: standard, ptc, minimal, cordis)
    at CommandDirectory.ensureReady (directory.ts:142:15)
    at async CommandUiRuntime.candidates (service.ts:251:18)

Repro steps

1. Create a session on a build that still shipped the code preset (pre-rename).
2. Start a conversation in that session (so the preset is persisted).
3. Upgrade to 0.1.2-alpha.1 (post-rename).
4. Try to open that session from the sidebar.

[liyangbing]

这个错误可以从源码确认是 持久化 preset identity 的升级兼容缺口，不是 Session 日志损坏。

重命名提交 3ca9c7d489 把 shipped preset 的目录/id 从 code 改成了 ptc，同时提交说明 Session-persistent 的 Code vocabulary 暂时保留。alpha.1 恢复 Session 时会读取 agentPreset projection，然后把记录的 id 原样传给 composeAgent() / agentPresets.resolve()。所以旧 Session 记录 code、新 roster 只有 ptc 时，会在 Agent 发布前直接失败；command warmup 只是其中一个触发面。

不建议直接改 Session 文件中的 code 字段。更安全的临时恢复方法是：

1. 停止使用同一 DSH_HOME 的所有 DSH writer，复制并 hash 受影响 Session；
2. 先在隔离的 DSH_HOME 和 Session 副本上测试；
3. 不打开故障 Session，进入 Agent preset 设置；
4. 使用 alpha.1 官方的 preset copy 能力，把 shipped ptc 完整复制为一个用户 preset，id 填 code，例如显示名填 Legacy code compatibility；
5. 重启 Host，确认 roster 同时包含 ptc 和用户级 code；
6. 冷打开 Session，分别验证 Chat、Trajectory、commands、Skills 和一次只读请求。

官方 copy 会复制整个 preset 目录（不只是 agent.cordis.yml），写入 user preset root，并处理权限；这比手工修改压缩 Session 安全。

需要注意：这个 alias 让 durable id code 在 alpha.1 上重新可解析，但实际挂载的是当前 ptc composition，不证明与旧版本逐字节/逐行为等价。恢复后建议把旧 Session 作为历史记录，新建明确使用 ptc 的 Session，并转移一份审核过的简短 handoff。旧 Session 是 nonblank，不能在原地切换 preset；这是为了避免中途更换工具和 prompt surface。

只要还需要对旧 Session 做 cold resume、commands、Skills、search、export 或 fork 检查，就不要删除这个 code alias，否则下次冷启动会再次失败。

完整的证据保全、恢复流程、失败做法和上游迁移测试契约：https://github.com/sandbaseai/deepseek-harness-handbook/blob/main/docs/en/troubleshooting/historical-code-preset-resume.md

[eugenewang5425]

补充受影响规模与实测：本地共 37 个历史会话受影响，其中 20 个旧 header 为 code（已改为 ptc；16 个 standard 与 1 个 liangshen 未改动）。当时救急直接改写了 header，事后看这是权宜手段，缺失压缩历史的可追溯性；楼里 liyangbing 的「复制 ptc 为 id=code 的用户 preset alias」方案更稳妥（不改写历史、可随时回退），赞成按该路径前进。
另外 #5099 提供了反向证据：alpha.1 中 PTC 模式的新会话也被写成 code，说明改名期读写两侧都存在不一致，建议官方在兼容层两侧一起处理。