# 聊天主链补完 Implementation Plan

> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.

**Goal:** 打通主 Agent 单聊、普通线程单聊和群聊推荐执行三条聊天链，并让 Android 端能稳定展示等待、确认、失败和结果回流。

**Architecture:** 后端继续沿用 `boss-state.json + master-agent task queue + local-agent` 路线，把普通线程单聊纳入 `conversation_reply` 任务执行链；群聊继续沿用 `dispatch_execution`。Android 端用轮询项目详情和待确认计划来收束聊天状态，而不是一次发送后只做单次刷新。

**Tech Stack:** Next.js App Router, TypeScript, file-backed state store, local-agent, Android AppCompat/Java, node:test, Gradle unit tests

---

### Task 1: 后端补普通线程单聊执行链

**Files:**
- Modify: `/Users/kris/code/boss/src/app/api/v1/projects/[projectId]/messages/route.ts`
- Modify: `/Users/kris/code/boss/src/lib/boss-data.ts`
- Modify: `/Users/kris/code/boss/local-agent/server.mjs`
- Test: `/Users/kris/code/boss/tests/single-thread-message-execution.test.ts`

- [ ] 写失败测试，覆盖“普通线程单聊发送后会排 `conversation_reply` 任务”
- [ ] 跑测试确认当前失败
- [ ] 在消息路由和状态模型里补任务创建
- [ ] 在 `local-agent` 完成回写时把线程原始回复写回单线程项目
- [ ] 再跑测试确认通过

### Task 2: 后端补主 Agent/普通线程统一任务状态语义

**Files:**
- Modify: `/Users/kris/code/boss/src/app/api/v1/projects/[projectId]/messages/route.ts`
- Modify: `/Users/kris/code/boss/src/lib/boss-master-agent.ts`
- Test: `/Users/kris/code/boss/tests/project-message-task-status.test.ts`

- [ ] 写失败测试，覆盖发送返回 `taskId/taskType/status`
- [ ] 跑测试确认失败
- [ ] 在消息接口里把任务状态统一返回给客户端
- [ ] 主 Agent 单聊保持现有执行逻辑，但返回值补清晰任务状态
- [ ] 再跑测试确认通过

### Task 3: Android 补发送后等待/轮询/收束链

**Files:**
- Modify: `/Users/kris/code/boss/android/app/src/main/java/com/hyzq/boss/ProjectDetailActivity.java`
- Modify: `/Users/kris/code/boss/android/app/src/main/java/com/hyzq/boss/BossApiClient.java`
- Test: `/Users/kris/code/boss/android/app/src/test/java/com/hyzq/boss/ProjectDetailActivityChatFlowTest.java`

- [ ] 写失败测试，覆盖主 Agent / 普通线程 / 群聊三种发送后的状态流
- [ ] 跑测试确认失败
- [ ] 在 `ProjectDetailActivity` 增加轮询与等待态收束
- [ ] 群聊确认后继续轮询直到看到线程结果或主 Agent 汇总
- [ ] 再跑测试确认通过

### Task 4: 文档、验证、部署

**Files:**
- Modify: `/Users/kris/code/boss/README.md`
- Modify: `/Users/kris/code/boss/docs/architecture/current_runtime_and_deploy_status_cn.md`
- Modify: `/Users/kris/code/boss/docs/architecture/api_and_service_inventory_cn.md`

- [ ] 运行 `npm run lint`
- [ ] 运行 `npm run build`
- [ ] 运行新增 node:test 与 Android 单测
- [ ] 验证 `curl -sS http://127.0.0.1:3000/api/health`
- [ ] 验证 `curl -sS http://127.0.0.1:4317/health`
- [ ] 部署到服务器并验证 `curl -sS https://boss.hyzq.net/api/health`
- [ ] 同步文档写明三条聊天链当前状态