refactor(multi): update multiple files

[HelloWorldU]

变更内容

• 更新 ARCHITECTURE.md 文档
• 新增/更新 agent.ts 逻辑
• 新增/更新 engine.ts 逻辑
• 新增/更新 types.ts 逻辑
• 新增/更新 useSwarmStore.ts 逻辑

类型

• feat: 新功能
• fix: Bug 修复
• refactor: 代码重构
• docs: 文档更新
• test: 测试补充
• chore: 构建/工具链

检查项

• 本地 pre-commit 通过
• 测试已补充或无需补充
• 文档已同步或无需同步

[HelloWorldU]

[自审] 当前状态非 ready，跳过审阅

注：GitHub 不允许 PR 作者 approve 自己的 PR，此评论仅作为审阅记录。

[HelloWorldU]

[自审] 当前状态非 ready，跳过审阅

注：GitHub 不允许 PR 作者 approve 自己的 PR，此评论仅作为审阅记录。

[HelloWorldU]

[自审] 审阅发现潜在问题，kimi 输出如下：

注：GitHub 不允许 PR 作者 approve 自己的 PR，此评论仅作为审阅记录。

[HelloWorldU]

[自审] 审阅发现潜在问题，kimi 输出如下：
经审阅，发现以下问题：

1. 🐛 Bug / 安全隐患：syncState() 直接传递 this.state 引用

private syncState() {
    this.emit({ type: 'agent-state', agentId: this.state.id, state: this.state })
}

这里将 this.state 引用直接作为事件负载发出。如果 Store 端（或其他监听方）对接收到的 state 进行任何修改（如增量更新时直接赋值、修改 reviews 数组等），会直接污染 Agent Engine 的内部状态，导致不可预期的副作用。

建议：发送深拷贝，如：

private syncState() {
    this.emit({ type: 'agent-state', agentId: this.state.id, state: structuredClone(this.state) })
}

或至少进行浅拷贝并冻结嵌套对象。

---

2. ⚠️ 规范/一致性问题：Diff 末尾截断，无法完整审阅

Diff 在以下位置截断：

@@ -779,6 +789,7 @@ expo

最后一个 hunk 的内容未提供，无法判断第 789 行附近的变更是否正确（可能涉及另一个 syncState() 调用点或其他逻辑）。建议补全 diff 后再做最终确认。

---

3. ✅ 正面反馈：状态更新顺序调整正确

将以下模式：

this.setStatus('completed')
this.state.prStatus = 'merged'
this.state.reviews = []

调整为：

this.state.prStatus = 'merged'
this.state.reviews = []
this.setStatus('completed')

是非常必要的。因为 setStatus() 现在内部会调用 syncState()，必须先更新关联字段再触发同步，否则 Store 会收到 status='completed' 但 prStatus 仍为旧值的不一致快照。

---

总结：除 state 引用传递问题需修复外，其余变更逻辑正确。请在修复引用传递问题并补全 diff 后重新提交审阅。

注：GitHub 不允许 PR 作者 approve 自己的 PR，此评论仅作为审阅记录。