docs(pmflow): rebaseline next plan to p7

CLAUDE.md

@@ -36,7 +36,7 @@ AIProjectManger/
 - 本地预览端口现按职责拆分：`docker-compose.dev.yml` 的热更新开发前端固定占用 `5174`，`docker-compose.yml` 的静态生产预览前端默认改为 `5175`（可通过 `FRONTEND_PROD_PORT` 覆盖），避免再和 Vite live preview 抢端口。
 - `docs/architecture/` 当前包含：`MASTER_CONTRACT.md`、`RUNTIME_GUARDRAILS.md`、`CODE_REFERENCE_INDEX.md`、`API_CONTRACTS.md`、`DATAFLOW.md`、`TASK_BRIEF_TEMPLATE.md`、`ARCHITECTURE_INVENTORY.md`
 - `docs/PMFLOW_PRODUCT_BLUEPRINT.md` 是当前产品蓝图真源：定义 PMFlow 为“对话驱动的 AI 产品执行操作系统”，并锁定 `solo-first, team-ready`、项目真相层、待确认变更中心、执行桥、人机混编团队等产品方向。
-- `docs/PMFLOW_PRODUCT_DELIVERY_STANDARD.md` 是 PMFlow 产品推进执行标准：记录当前推进状态、Phase A-F 下一步、单次任务范围、Codex 并行推进协议、完成后进度回写规则和新线程接续标准；继续产品推进前必须先读。
+- `docs/PMFLOW_PRODUCT_DELIVERY_STANDARD.md` 是 PMFlow 产品推进执行标准：记录当前推进状态、Phase A-F/P7 下一步、单次任务范围、Codex 并行推进协议、完成后进度回写规则和新线程接续标准；继续产品推进前必须先读。P6 后当前推荐任务已重定为 P7 Iteration Quality / Reviewer / Personal Queue，不再指向已完成的 Phase D.2。
 - `docs/PMFLOW_UI_CONTRACT.md` 是 PMFlow UI 契约真源：锁定 Logo、浅色白底 + `#2463EB`、移动端固定底部导航、用户动作/AI 操作/系统状态/待确认视觉语法、核心功能 canonical 契约和当前前端一致性审计；后续原型图和代码化原型不得绕过该文档。
 - `docs/superpowers/plans/` 保存实现计划，`docs/superpowers/specs/` 保存需求/方案规格，`docs/task_briefs/` 保存任务包产物与验收截图。
 - 当前与“统一 AI handoff / 全量业务结构化”直接相关的设计规格包括：`docs/superpowers/specs/2026-04-17-unified-project-ai-handoff.md`、`docs/superpowers/specs/2026-04-19-interaction-boundary-four-level-contract-design.md`、`docs/superpowers/specs/2026-04-20-full-business-structuring-and-conversation-baseline-design.md` 与 `docs/superpowers/specs/2026-04-20-business-golden20-refresh.md`；它们分别对应统一入口与项目型 AI 方向、四挡 interaction boundary、全量业务结构化与 58 条广覆盖语义矩阵，以及面向当前真实项目池和 plan mode 主链的 20 条核心黄金案例。

docs/PMFLOW_PRODUCT_DELIVERY_STANDARD.md

@@ -85,8 +85,8 @@
 2. `project-launch` 还没有接真实 AI 结构化、真实项目创建和真实草案确认。
 3. `pmflow-os` 本地 store 还没有接后端读写，当前仍是 mock truth store。
 4. `ChangeReview` 的接受、修改、暂缓还没有写入正式对象、审批记录和证据链。
-5. `ExecutionBridge` 页面还没有消费 dev-sync / GitHub / PromptPackage 真实接口。
+5. `ExecutionBridge` 已接入真实 execution-summary/dev-sync、execution handoff、运行端领取和 progress writeback；当前缺口不再是执行桥读写合同，而是执行质量、审查责任和个人队列的产品化。
-6. `ReleaseGrowth` 已接入 execution evidence gate、release validation run 与 feedback ingest；revenue、ROI、compliance 还没有串成完整发布后反馈循环。
+6. `ReleaseGrowth` 已接入 execution evidence gate、release validation run、feedback ingest 和 recommendation -> ChangeSet draft 回流；revenue、ROI、compliance 还没有串成完整发布后反馈循环。
 7. `TeamLayer` 仍是产品表达层，缺少真实成员角色、Role Inbox、Decision Desk、Team Feed 的数据模型和审查流程。
 
 ## 2. 下一步推进方向
@@ -715,98 +715,120 @@ commit gate 判定：
 
 当前最建议下一步执行：
 
-**Phase D.2：Execution Bridge 执行交接合同。**
+**P7：Iteration Quality / Reviewer / Personal Queue 三线并行。**
 
 原因：
 
 - A3 已完成真实只读投影，Phase B 已完成真实 Project Launch 创建链。
 - Phase C1 已把项目内消息、结构化候选、审查动作和证据链落到真实表。
-- C2-contract 已锁定 commit API、原子提交规则、响应合同和失败语义。
+- C2 已实现真实 ChangeSet commit，Phase D/D.2/D.3 已把 Execution Bridge 从真实读侧推进到执行交接和执行结果回写。
-- C2-backend 已按合同实现 atomic commit route/service/schema/tests，C2-frontend 已把真实模式写入接到 commit API。
+- Release Validation P1、Release Feedback P1、Iteration Loop P1 已把发布前验证、发布后反馈和 recommendation -> 下一轮 ChangeSet draft 串回 Change Review。
-- Phase D 已把 `ExecutionBridgePage` 切到 `execution-summary` 与 dev-sync 真实数据。
+- Space P5 已只读展示下一轮迭代草稿关注，Account P6 已把 iteration review 事件映射到待确认提醒偏好。
-- 当前缺口是执行桥只读展示已经成立，但还不能把一个已确认任务推进到可追踪的真实执行交接；下一步应实现 `POST /pmflow-os/projects/{project_id}/execution-handoffs`，生成/复用 PromptPackage、绑定 task/repo/runtime，并创建 `handoff_created` progress event 起点。
+- 当前缺口不是继续扩页面或重做执行桥，而是让“下一轮待确认变更”更可审、更可分配、更容易被个人队列接住。
 
-### 7.1 下一批大模块并行建议
+### 7.1 P7 并行建议
 
-P0 公共壳冻结已完成，下一批可以进入 `Batch P1` 三模块并行；最终仍必须由 `Batch P2` integration owner 收口。
+P7 不新增战略页面，不新增顶层路由，不改移动底部导航；只在既有 `Main Flow / Space / Account Settings` 表面内补真实闭环质量。三个 Packet 可以并行，但共享文件仍由 Shell / Integration owner 最后收口。
 
-#### Batch P0：Shell / Route / Shared Contract Freeze
+#### Main Flow Packet：`main-flow-p7-iteration-quality`
-
-状态：`done`
-
-冻结结论：
-
-- 当前已存在 `/space`、`/project-launch`、`/pmflow-os`、`/command-center`、`/change-review`、`/execution-bridge`、`/release-growth`、`/me`。
-- `/settings` 当前未实现，标记为 Account Settings reserved route；不得由业务模块线程顺手新增。
-- 移动端底部导航已固定为 `空间 / 指挥台 / 待确认 / 动态 / 我的`，实现归 `Shell / Integration owner`。
-- `frontend/src/main.tsx` 全局 provider 顺序已确认：`QueryClientProvider -> PMFlowOsProvider -> ToastProvider -> RouterProvider`；后续 provider 变更必须由 Shell owner 串行处理。
-
-#### Batch P1：三模块并行
-
-在 P0 完成后，可以同时开三个长期 lane 的首个 Packet。
-
-##### Main Flow Packet：`main-flow-phase-d2-execution-handoff-contract`
 
 目标：
 
-- 继续执行 Phase D.2，把 Execution Bridge 从 execution dashboard 推进为 execution command bridge。
+- 提升 recommendation -> ChangeSet draft 的质量：分组、去重、风险级别、证据摘要和 nextActions 更清晰。
-- 新增 `POST /pmflow-os/projects/{project_id}/execution-handoffs`，允许对已确认任务发起真实执行交接。
+- 让 ReleaseGrowthPage / ChangeReviewPage 能区分“反馈建议草稿、任务草稿、风险草稿、决策草稿”，但不自动 commit。
-- 后端生成/复用 `PromptPackage`，记录 `runtime_target / repo_binding_id / task_id`，并创建 `ProgressEvent(event_type='handoff_created')`。
+- 保持 item 类型只落 `Requirement / Task / Risk / Decision`；不写 Project Memory、不创建正式 Task、不触发发布。
-- 前端真实模式下“发起执行交接”调用真实 API，成功后 refetch `execution-summary / truth-state`；无 task/repo/prompt 时必须显示明确 warning 和下一步。
 
-默认写范围：
+建议写范围：
 
-- `frontend/src/features/pmflow-os/`
-- `frontend/src/api/pmflowOs.ts`
 - `backend/app/api/pmflow_os_api/`
 - `backend/app/services/pmflow_os_projection_service.py`
 - `backend/app/schemas/pmflow_os.py`
-- 相关 tests
+- `backend/tests/test_pmflow_os_projection_api.py`
+- `frontend/src/api/pmflowOs.ts`
+- `frontend/src/features/pmflow-os/store.tsx`
+- `frontend/src/features/pmflow-os/store.api.test.tsx`
+- `frontend/src/features/pmflow-os/pages/ReleaseGrowthPage.tsx`
+- `frontend/src/features/pmflow-os/pages/ChangeReviewPage.tsx`
+- 相关 Main Flow 文档
 
-##### Space Packet：`space-v1-workbench`
+禁止：
+
+- 不新增战略页面。
+- 不自动 commit ChangeSet。
+- 不改 Space / Account / router / bottom nav。
+
+#### Main Flow / Team Packet：`main-flow-p7-reviewer-decision-desk`
 
 目标：
 
-- 把 `/space` 推进成个人工作面聚合页。
+- 把 Change Review 从“只有待确认列表”推进到 reviewer / owner / escalation 的审查责任表达。
-- 展示继续推进、待我确认、AI 正在推进、暂存想法、草案箱、最近项目。
+- 优先复用 `PMFlowApproval / PMFlowChangeSet / PMFlowChangeItem` 或现有用户/项目成员关系，能不新增 migration 就不新增。
-- 优先只读聚合；点击项目进入 `/pmflow-os?projectId=...`，不直接写项目真相层。
+- 在 Change Review 或 TeamLayer 既有页面内表达 reviewer、风险升级、谁需要拍板；不新增新的战略页面。
 
-默认写范围：
+建议写范围：
 
+- `backend/app/services/pmflow_change_review_service.py`
+- `backend/app/api/pmflow_os_api/`
+- `backend/app/schemas/pmflow_os.py`
+- `backend/tests/test_pmflow_os_projection_api.py`
+- `frontend/src/api/pmflowOs.ts`
+- `frontend/src/features/pmflow-os/store.tsx`
+- `frontend/src/features/pmflow-os/pages/ChangeReviewPage.tsx`
+- `frontend/src/features/pmflow-os/pages/TeamLayerPage.tsx`
+- 相关 Main Flow 文档
+
+禁止：
+
+- 不改 router / MobileBottomNav / PMFlowOsFrame。
+- 不把 TeamLayer 扩成新战略后台。
+- 不绕过 Change Review 的人类确认边界。
+
+#### Space Packet：`space-p7-personal-queue`
+
+目标：
+
+- 把 `/space` 的待确认、下一轮草稿、发布关注和执行关注整理为更明确的个人队列。
+- 只读消费 PMFlow OS `truth-state / execution-summary / releaseSignals`；点击仍跳主流程。
+- 让用户能快速判断“我现在该确认什么、看什么、回到哪个项目”，但不在 Space 直接 accept/edit/defer/commit。
+
+建议写范围：
+
+- `frontend/src/api/space.ts`
 - `frontend/src/features/personal-space/`
-- `frontend/src/pages/PersonalSpacePage.tsx`
+- `frontend/src/features/personal-space/PersonalSpacePage.test.tsx`
-- `frontend/src/api/space.ts`（如需要）
+- Space 相关文档
-- `backend/app/api/space_api/`（如需要，只读聚合优先）
-- Space 相关测试
 
-##### Account Settings Packet：`account-settings-v1`
+禁止：
 
-目标：
+- 不写 Project Memory、ChangeSet 状态、ProgressEvent、ReleaseValidationRun、FeedbackIngest、RevenueEvent。
+- 不改 PMFlow OS store、Account Settings、router 或 bottom nav。
 
-- 建设 `/me` 和个人设置首版。
+### 7.2 P7 Integration Owner 收口
-- 覆盖个人资料、AI 偏好、通知偏好、账户操作和移动端 bottom sheet。
-- 不改 OAuth/JWT/auth core，不改项目主链。
 
-默认写范围：
+Shell / Integration owner 负责：
-
-- `frontend/src/features/account-settings/`（建议新建）
-- `frontend/src/features/pmflow-os/pages/AccountPage.tsx`
-- `frontend/src/features/pmflow-os/components/AccountControls.tsx`
-- `frontend/src/api/accountSettings.ts`（如需要）
-- `backend/app/api/account_settings_api/`（如需要）
-- Account Settings 相关测试
-
-#### Batch P2：Integration Owner 收口
-
-目标：
 
 - 检查三个 Packet 的 `git diff --name-only` 是否越界。
-- 统一处理 router、bottom nav、shared docs、API index 的冲突。
+- 统一处理共享文档、API 索引和状态台账冲突。
-- 跑后端/前端最小集成验证。
+- 确认 P7 仍不新增战略页面，仍使用既有 `/space / /change-review / /release-growth / /team-layer` 表面。
+- 跑 Main Flow / Space focused tests，并在包含 `frontend/src/lib/*` 的集成环境跑 full typecheck/build。
 - 更新 `## 8. 进度台账`、`CODE_REFERENCE_INDEX.md`、`ARCHITECTURE_INVENTORY.md` 与必要的 `CLAUDE.md`。
 
 ## 8. 进度台账
 
+### 2026-04-26 / shell-p7-rebaseline-next-plan / implemented
+
+完成内容：
+
+- 将第 7 节“当前下一步推荐任务”从已完成的 `Phase D.2：Execution Bridge 执行交接合同` 重定为 `P7：Iteration Quality / Reviewer / Personal Queue 三线并行`。
+- 明确 P6 后当前真实闭环状态：`feedback -> recommendation -> ChangeSet draft -> Change Review accept/edit/defer` 已成立，仍不自动 commit、不写 Project Memory、不创建正式 Task。
+- 写清 P7 三个推荐 Packet 边界：`main-flow-p7-iteration-quality`、`main-flow-p7-reviewer-decision-desk`、`space-p7-personal-queue`。
+- 明确 P7 不新增战略页面、不新增顶层路由、不改移动底部导航，不绕过 Change Review 人类确认边界。
+
+验证：
+
+- `git diff --name-only` 仅包含本 Packet 文档 write scope。
+- `rg -n "Phase D.2|当前最建议下一步|P7|Iteration Quality" docs/PMFLOW_PRODUCT_DELIVERY_STANDARD.md CLAUDE.md docs/architecture/CODE_REFERENCE_INDEX.md docs/architecture/ARCHITECTURE_INVENTORY.md` 已用于确认推荐任务真源更新。
+
 ### 2026-04-26 / big-module-integration-p6 / done
 
 完成内容：

docs/architecture/ARCHITECTURE_INVENTORY.md

@@ -18,7 +18,7 @@
 
 ## 3. 顶层库存
 - `docs/PMFLOW_PRODUCT_BLUEPRINT.md`：PMFlow 产品蓝图真源；锁定“对话驱动的 AI 产品执行操作系统”、`solo-first, team-ready`、项目真相层、ChangeSet 待确认、Execution Bridge 与人机混编团队方向
-- `docs/PMFLOW_PRODUCT_DELIVERY_STANDARD.md`：PMFlow 产品推进执行标准；记录当前进度、Phase A-F 推进顺序、单次任务范围、Codex 并行推进协议、进度台账和新线程接续规则
+- `docs/PMFLOW_PRODUCT_DELIVERY_STANDARD.md`：PMFlow 产品推进执行标准；记录当前进度、Phase A-F/P7 推进顺序、单次任务范围、Codex 并行推进协议、进度台账和新线程接续规则；P6 后当前推荐任务已重定为 P7 Iteration Quality / Reviewer / Personal Queue，不再指向已完成的 Phase D.2
 - `docs/PMFLOW_UI_CONTRACT.md`：PMFlow UI 契约真源；锁定 Logo、浅色白底 + `#2463EB`、移动端固定底部导航、四类视觉语法、核心功能 canonical 契约和当前前端一致性审计
 - `docs/INBOX_INLINE_OPS_3_PHASE_CHECKLIST.md`：消息台内联操作执行清单
 - `docs/architecture/MASTER_CONTRACT.md`：跨栈主契约

docs/architecture/CODE_REFERENCE_INDEX.md

@@ -96,6 +96,7 @@
 ## 3. 前端参考
 - PMFlow UI 契约真源：先读 `docs/PMFLOW_UI_CONTRACT.md`，再修改 `project-launch`、`personal-space`、`pmflow-os` 相关页面；该文档锁定 Logo、色彩、移动端底部导航、状态标签、AI 操作/用户动作/待确认视觉语法和核心功能 canonical 契约
 - PMFlow 大模块并行公共壳：参考 `docs/PMFLOW_PRODUCT_DELIVERY_STANDARD.md` 的 `4.4.1-4.4.3` 与 `frontend/src/router/index.tsx`、`frontend/src/main.tsx`、`frontend/src/features/pmflow-os/components/MobileBottomNav.tsx`、`frontend/src/features/pmflow-os/components/PMFlowOsFrame.tsx`；`/space` 归 Space lane，`/pmflow-os / /command-center / /change-review / /execution-bridge / /release-growth` 归 Main Flow lane，`/me` 归 Account Settings lane，`/settings` 当前仅为 reserved route，新增或改动必须由 Shell / Integration owner 串行处理
+- PMFlow P7 当前推荐任务：参考 `docs/PMFLOW_PRODUCT_DELIVERY_STANDARD.md` 第 7 节；P6 后真实闭环已到 `feedback -> recommendation -> ChangeSet draft -> Change Review`，下一步推荐并行推进 `main-flow-p7-iteration-quality`、`main-flow-p7-reviewer-decision-desk`、`space-p7-personal-queue`，不新增战略页面、不改 router / bottom nav、不绕过 Change Review 人类确认边界
 - PMFlow OS 产品合同真源：先读 `docs/architecture/PMFLOW_OS_PRODUCT_CONTRACT.md`，再实现 `pmflow-os` 真实后端接入；该文档锁定 `ProjectTruthState / Thread / ChangeSet / ChangeItem / Evidence / Approval / Project Memory / ExecutionContext` 与 `truth_nodes / tasks / semantic_facts / ai_project_control / dev_sync` 的复用边界和后续 API 草案
 - 新增前端 API 调用：参考 `frontend/src/api/sstc.ts`；Space 工作面只读聚合参考 `frontend/src/api/space.ts`，只消费项目摘要与 PMFlow OS `truth-state / execution-summary`，不写 Project Memory、ChangeSet 状态、ProgressEvent 或 ReleaseValidationRun；Space P3 的 `releaseAttention` 优先从 `truth-state.releases` 的 release validation 投影生成“发布验证阻塞 / 发布验证待确认”，没有发布验证投影时才回落到 `PMFlowExecutionSummary.releaseGate` 的“发布候选 / 发布门禁阻塞”，所有动作只跳转 `/release-growth?projectId=<id>`；PMFlow OS 真实接入参考 `frontend/src/api/pmflowOs.ts` 的 `getPMFlowTruthState(projectId)`、`getPMFlowExecutionSummary(projectId)`、`createPMFlowExecutionHandoff`、`consumePMFlowExecutionHandoff`、`createPMFlowExecutionProgressEvent`、`createPMFlowReleaseValidationRun`、`createPMFlowReleaseFeedbackIngest`、`createPMFlowIterationRecommendationChangeSetDraft`、`createPMFlowThreadMessage`、`createPMFlowExtraction`、`getPMFlowChangeSet`、`acceptPMFlowChangeItem`、`editPMFlowChangeItem`、`deferPMFlowChangeItem`、`commitPMFlowChangeSet`；`PMFlowExecutionSummary.releaseGate` 是 ReleaseGrowth 真实发布门禁前端合同，`releaseGate.latestValidationRun` 是最新发布验证记录前端合同，`execution-summary.releaseSignals` 是 Release/Growth 发布后 feedback/revenue/recommendation 信号与下一轮 ChangeSet draft 状态前端合同；Project Launch 创建链参考 `frontend/src/api/pmflowLaunch.ts` 的 `createPMFlowLaunchDraft` 与 `confirmPMFlowLaunchDraft`
 - AI Steward 页面入口：参考 `frontend/src/pages/ai-steward/`