JARVIS/development-doc/plan/hermes-update/checklist.md

Hermes-first 执行清单

H0 Ownership / ADR

• 新增 Hermes-first README.md
• 新增 ADR：Hermes-first architecture
• 明确 ownership matrix
• 明确 Jarvis product shell 与 Hermes core 的边界
• 明确成功标准与关键风险

H1 AgentService 架构倒置

• 把 AgentService 明确拆分为 assembly / dispatch / finalization
• 正式 adapter 化 Jarvis graph 路径
• 引入 runtime registry / factory
• 减少 if runtime == ... 的散落逻辑
• 保持 router / SSE 契约不破坏

H2 Continuity Envelope

• 设计统一 Conversation.agent_state envelope
• 加入 active_runtime
• 加入 runtime_state.hermes
• 保留 Jarvis product continuity
• 增加 migration/version metadata
• 补充兼容旧状态读取策略

H3 Durable Session Lifecycle

• 升级 HermesSessionManager 为 durable lifecycle manager
• 支持 warm / resumed / cold 状态
• 支持 hydrate / recreate / idle reclaim
• 增加 health / restart / stale session 处理
• 补充 session recovery 测试

H4 Product Shell Assembly

• 固化 memory assembly
• 固化 skill shortlist assembly
• 固化 task graph assembly
• 把这些能力统一收敛到 prepared context
• 保证 Hermes 不直接吞掉产品层职责

H5 Event Mapper / SSE

• 新增 Hermes event mapper 边界
• 保持 metadata/progress/chunk/error/done
• richer diagnostics 落到 observability / attachments
• 保证前端 parser 无需重写

H6 Frontend Hermes-first Session Model

• 减少 jarvis 默认 runtime 假设
• 减少 Jarvis-specific runtime 文案耦合
• 提升 session/run metadata 为一等状态
• runtime toggle 收缩为灰度/调试能力
• 保持 chat 仍是消息流体验

H7 Default Rollout / Fallback

• 引入默认 runtime policy
• 支持 cohort / feature flag rollout
• 保留 Jarvis graph fallback 路径
• 定义 rollback 条件与动作
• 用真实对话与指标验证默认切换时机