# H0 Ownership Matrix 与架构决策

## 1. 目标

先把 Hermes-first 的 ownership matrix、边界和成功标准写清楚，防止后续开发过程中又回到“先写 adapter，最后发现架构中心没变”。

## 2. 核心判断

这轮改造的目标不是：

- 给 Jarvis 再挂一个更强的 runtime adapter

而是：

- 让 Hermes 成为默认 execution core
- 让 Jarvis 退回 product shell

## 3. Ownership Matrix

### 3.1 Hermes Core

Hermes 应负责：

1. session lifecycle
2. runtime resume / recovery
3. execution loop
4. chunk streaming
5. runtime-internal tool orchestration
6. runtime health / restart metadata

### 3.2 Jarvis Product Shell

Jarvis 应负责：

1. conversation / message 持久化
2. user / auth / permission 边界
3. memory context assembly
4. retrospective / knowledge 注入
5. skill shortlist
6. task graph / parallel worthiness 分析
7. product continuity
8. SSE contract
9. observability / attachments / metrics
10. rollout / fallback / rollback policy

### 3.3 Shared Contracts

需要显式建模的共享边界：

1. runtime prepared context
2. runtime event model
3. continuity envelope
4. session health metadata
5. rollout policy metadata

## 4. 关键边界原则

1. 不把 Hermes session id 直接当成完整 continuity。
2. 不让前端直接依赖 Hermes-native event。
3. 不把 memory / skill / task graph 直接挪进 Hermes 黑盒。
4. 不让 `AgentService` 继续充当 runtime 本体。
5. 不把 runtime 选择长期暴露为普通用户负担。

## 5. 目标文件锚点

### Backend
- `backend/app/services/agent_service.py`
- `backend/app/services/agent_runtime/base.py`
- `backend/app/services/agent_runtime/hermes_runtime.py`
- `backend/app/services/agent_runtime/hermes_session_manager.py`
- `backend/app/models/conversation.py`

### Frontend
- `frontend/src/api/conversation.ts`
- `frontend/src/pages/chat/composables/useChatView.ts`
- `frontend/src/stores/conversation.ts`

## 6. 成功标准

- [ ] Hermes-first 的 ownership matrix 被写清楚
- [ ] 保留 Jarvis product shell 的范围被写清楚
- [ ] fallback / rollback 必须存在这一点被写清楚
- [ ] 后续 phase 的顺序依赖被写清楚

## 7. 本阶段结论

只有先把 ownership 定义清楚，后面 H1-H7 才不会演变成“代码改了很多，但架构中心没有变”。