docs(31-03): complete oauth-conflicts-integration plan

Author: ZaneL1u

.planning/REQUIREMENTS.md

@@ -18,7 +18,7 @@
 - [x] **REQ-F1-B**：cloud-claude 启动后，从命令执行到出现可输入 prompt 的总耗时 ≤ 8s（含首轮 Mutagen 同步），过程中输出三段式中文进度：`初始化文件映射 (1/3) 热同步源码中…`
 - [x] **REQ-F1-C**：在 10k 文件源码树执行 `rg .` / `ls -R` 的延迟 ≤ 等价本地操作的 1.5×
 - [x] **REQ-F1-D**：候选同步目录大小 > 50MB 时，cloud-claude 拒绝热同步并自动改用 sshfs 兜底，同时给出明确中文提示与 ignore 配置建议
-- [ ] **REQ-F1-E**：Mutagen 同步出现 conflict 时，下次回车前在 prompt 上方插入中文警告：`⚠ 有 N 个文件同步冲突，运行 cloud-claude sync conflicts 查看`
+- [x] **REQ-F1-E**：Mutagen 同步出现 conflict 时，下次回车前在 prompt 上方插入中文警告：`⚠ 有 N 个文件同步冲突，运行 cloud-claude sync conflicts 查看`
 
 ### A2 · 降级路径与 `--mount-mode` 手动切换（F2）
 
@@ -57,7 +57,7 @@
 
 - [ ] **REQ-F7-A**：`~/.claude/` 与 `~/.cache/claude` 通过独立 Docker named volume 持久化；命名粒度 = 单个 `claude_account`（建议 `claude-state-{claude_account_id}`，带 label `com.cloud-cli-proxy.account_id`）
 - [ ] **REQ-F7-B**：容器重建后未过期的 OAuth credentials 必须保留，用户无需重新执行 `claude login`
-- [ ] **REQ-F7-C**：credentials 即将过期或已过期时，cloud-claude 必须在连接建立前给出明确的中文提示，不能让 claude 进程进入报错后才发现
+- [x] **REQ-F7-C**：credentials 即将过期或已过期时，cloud-claude 必须在连接建立前给出明确的中文提示，不能让 claude 进程进入报错后才发现
 - [ ] **REQ-F7-D**：通过 admin API 删除 claude_account 时，事务性联动删除对应的 Docker named volume
 
 ### C3 · 错误码与中文提示统一升级（F8）
@@ -171,7 +171,7 @@
 | REQ-F1-B | Phase 31 | Complete | 首连 ≤ 8s 含三段式中文进度（最终验收对接 Phase 35 / BASE-02） |
 | REQ-F1-C | Phase 31 | Complete | 10k 文件 1.5× 性能（最终验收对接 Phase 35 / BASE-01） |
 | REQ-F1-D | Phase 31 | Complete | > 50MB 候选目录拒绝 + 自动降级 sshfs |
-| REQ-F1-E | Phase 31 | Pending | Mutagen conflict 中文冒泡 |
+| REQ-F1-E | Phase 31 | Complete | Mutagen conflict 中文冒泡 |
 | REQ-F2-A | Phase 31 | Complete | `--mount-mode` 四档切换 |
 | REQ-F2-B | Phase 31 | Complete | 任一层失败 ≤ 2s 降级 + 禁止静默 |
 | REQ-F2-C | Phase 31 | Complete | banner 彩色 mount 模式标签 |
@@ -192,7 +192,7 @@
 | REQ-F6-D | Phase 34 | Pending | doctor `--verbose` / `--json` / 退出码 0/1/2 |
 | REQ-F7-A | Phase 33 | Pending | named volume `claude-state-{id}` + label（数据模型在 Phase 30） |
 | REQ-F7-B | Phase 33 | Pending | 容器重建 OAuth 保留 |
-| REQ-F7-C | Phase 31 | Pending | 连接握手期 OAuth 过期中文提示 |
+| REQ-F7-C | Phase 31 | Complete | 连接握手期 OAuth 过期中文提示 |
 | REQ-F7-D | Phase 33 | Pending | admin DELETE 事务联动 `volume rm` |
 | REQ-F8-A | Phase 34 | Complete | 错误码 `<DOMAIN>_<KIND>_<NUM>` 体系（横切：各 phase 落码时遵循） |
 | REQ-F8-B | Phase 34 | Complete | 错误三要素（横切：各 phase 落码时遵循） |

.planning/ROADMAP.md

@@ -113,7 +113,7 @@
 | 28. 生产 FUSE 兼容性验证 | v2.0 | 2/2 | Complete | 2026-04-15 |
 | 29. 受管镜像 v3 + Worker 容器参数 | v3.0 | 6/6 | Complete    | 2026-04-18 |
 | 30. 控制面数据模型 + Entry API | v3.0 | 2/2 | Complete    | 2026-04-18 |
-| 31. CLI 三层文件映射重构 | v3.0 | 2/3 | In Progress|  |
+| 31. CLI 三层文件映射重构 | v3.0 | 3/3 | Complete   | 2026-04-19 |
 | 32. SSH 会话可靠性 + tmux + 多端 | v3.0 | 0/3 | Pending | — |
 | 33. Claude Code 状态持久化 | v3.0 | 0/2 | Pending | — |
 | 34. cloud-claude doctor v3 + 错误码统一 | v3.0 | 0/3 | Pending | — |

.planning/STATE.md

@@ -2,9 +2,9 @@
 gsd_state_version: 1.0
 milestone: v3.0
 milestone_name: 远端开发体验升级
-status: executing
-stopped_at: Completed 31-cli/02-mount-three-layer-PLAN.md
-last_updated: "2026-04-19T09:35:14.546Z"
+status: verifying
+stopped_at: Completed 31-cli/03-oauth-conflicts-integration-PLAN.md
+last_updated: "2026-04-19T09:55:34.225Z"
 last_activity: 2026-04-19
 progress:
   total_phases: 7
@@ -28,7 +28,7 @@ See: .planning/PROJECT.md (updated 2026-04-17)
 Milestone: v3.0 远端开发体验升级
 Phase: 31 (cli) — EXECUTING
 Plan: 3 of 3
-Status: Ready to execute
+Status: Phase complete — ready for verification
 Last activity: 2026-04-19
 
 Progress: [░░░░░░░░░░░░░░░░░░░░] 0%（v3.0；Phase 29 待执行）
@@ -53,6 +53,9 @@ v3.0 关键方向已定：
 - [Phase 31-cli]: mutagen_bin/.gitattributes 关闭 LFS 行 + 占位 stub 提交，由 CI build-images workflow 拉取真实 v0.18.1 二进制（Plan 31-01 Task 1.2 自决）
 - [Phase 31-cli]: Plan 02：三层 mount 状态机落地，Mode={Auto,Full,MutagenOnly,SSHFSOnly}，Auto 任一档失败 ≤2s 降级到下一档；exitcodes.go 9 个常量与 v2.0 0-5 对齐 + OAuth/mount 6-8
 - [Phase 31-cli]: Plan 02：M13 防御「禁止静默降级」由 stderr MOUNT_AUTO_DOWNGRADED + last-session.json downgrade_chain 双留痕；ConnectAndRunClaudeV3 留 TODO(plan-03) OAuth hook 点
+- [Phase 31-cli]: Plan 03：OAuth 三态检查接入 ConnectAndRunClaudeV3 (mount ready 后、claude 前)，Expired→ExitOAuthExpired(7) / NotFound→ExitOAuthNotFound(6)，ExpiringSoon 仅警告
+- [Phase 31-cli]: Plan 03：MutagenSyncStatus{SessionName,ConflictCount,LastError} 引入，mountMutagen 第二返回值 int→struct，sync list --template 解析 conflict count（v0.18.1 不支持 --json）
+- [Phase 31-cli]: Plan 03：6 个 TestIntegration_* + docker compose fixture 脚本就位，未引入 testcontainers-go；C3 netem 场景 t.Skip 留 Phase 35 真机
 
 ### Pending Todos
 
@@ -76,6 +79,6 @@ None — 等待 REQUIREMENTS.md 与 ROADMAP.md 产出后进入 phase 执行。
 
 ## Session Continuity
 
-Last session: 2026-04-19T09:35:03.006Z
-Stopped at: Completed 31-cli/02-mount-three-layer-PLAN.md
+Last session: 2026-04-19T09:55:21.345Z
+Stopped at: Completed 31-cli/03-oauth-conflicts-integration-PLAN.md
 Resume file: None