diff --git a/CLAUDE.md b/CLAUDE.md index f0c855a1..f4d7e5e1 100644 --- a/CLAUDE.md +++ b/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 条核心黄金案例。 diff --git a/docs/PMFLOW_PRODUCT_DELIVERY_STANDARD.md b/docs/PMFLOW_PRODUCT_DELIVERY_STANDARD.md index 289070f9..b6f1209e 100644 --- a/docs/PMFLOW_PRODUCT_DELIVERY_STANDARD.md +++ b/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 真实接口。 -6. `ReleaseGrowth` 已接入 execution evidence gate、release validation run 与 feedback ingest；revenue、ROI、compliance 还没有串成完整发布后反馈循环。 +5. `ExecutionBridge` 已接入真实 execution-summary/dev-sync、execution handoff、运行端领取和 progress writeback；当前缺口不再是执行桥读写合同，而是执行质量、审查责任和个人队列的产品化。 +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-backend 已按合同实现 atomic commit route/service/schema/tests，C2-frontend 已把真实模式写入接到 commit API。 -- Phase D 已把 `ExecutionBridgePage` 切到 `execution-summary` 与 dev-sync 真实数据。 -- 当前缺口是执行桥只读展示已经成立，但还不能把一个已确认任务推进到可追踪的真实执行交接；下一步应实现 `POST /pmflow-os/projects/{project_id}/execution-handoffs`，生成/复用 PromptPackage、绑定 task/repo/runtime，并创建 `handoff_created` progress event 起点。 +- C2 已实现真实 ChangeSet commit，Phase D/D.2/D.3 已把 Execution Bridge 从真实读侧推进到执行交接和执行结果回写。 +- Release Validation P1、Release Feedback P1、Iteration Loop P1 已把发布前验证、发布后反馈和 recommendation -> 下一轮 ChangeSet draft 串回 Change Review。 +- Space P5 已只读展示下一轮迭代草稿关注，Account P6 已把 iteration review 事件映射到待确认提醒偏好。 +- 当前缺口不是继续扩页面或重做执行桥，而是让“下一轮待确认变更”更可审、更可分配、更容易被个人队列接住。 -### 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 - -状态：`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` +#### Main Flow Packet：`main-flow-p7-iteration-quality` 目标： -- 继续执行 Phase D.2，把 Execution Bridge 从 execution dashboard 推进为 execution command bridge。 -- 新增 `POST /pmflow-os/projects/{project_id}/execution-handoffs`，允许对已确认任务发起真实执行交接。 -- 后端生成/复用 `PromptPackage`，记录 `runtime_target / repo_binding_id / task_id`，并创建 `ProgressEvent(event_type='handoff_created')`。 -- 前端真实模式下“发起执行交接”调用真实 API，成功后 refetch `execution-summary / truth-state`；无 task/repo/prompt 时必须显示明确 warning 和下一步。 +- 提升 recommendation -> ChangeSet draft 的质量：分组、去重、风险级别、证据摘要和 nextActions 更清晰。 +- 让 ReleaseGrowthPage / ChangeReviewPage 能区分“反馈建议草稿、任务草稿、风险草稿、决策草稿”，但不自动 commit。 +- 保持 item 类型只落 `Requirement / Task / Risk / Decision`；不写 Project Memory、不创建正式 Task、不触发发布。 -默认写范围： +建议写范围： -- `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` 推进成个人工作面聚合页。 -- 展示继续推进、待我确认、AI 正在推进、暂存想法、草案箱、最近项目。 -- 优先只读聚合；点击项目进入 `/pmflow-os?projectId=...`，不直接写项目真相层。 +- 把 Change Review 从“只有待确认列表”推进到 reviewer / owner / escalation 的审查责任表达。 +- 优先复用 `PMFlowApproval / PMFlowChangeSet / PMFlowChangeItem` 或现有用户/项目成员关系，能不新增 migration 就不新增。 +- 在 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/api/space.ts`（如需要） -- `backend/app/api/space_api/`（如需要，只读聚合优先） -- Space 相关测试 +- `frontend/src/features/personal-space/PersonalSpacePage.test.tsx` +- Space 相关文档 -##### Account Settings Packet：`account-settings-v1` +禁止： -目标： +- 不写 Project Memory、ChangeSet 状态、ProgressEvent、ReleaseValidationRun、FeedbackIngest、RevenueEvent。 +- 不改 PMFlow OS store、Account Settings、router 或 bottom nav。 -- 建设 `/me` 和个人设置首版。 -- 覆盖个人资料、AI 偏好、通知偏好、账户操作和移动端 bottom sheet。 -- 不改 OAuth/JWT/auth core，不改项目主链。 +### 7.2 P7 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 收口 - -目标： +Shell / 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 完成内容： diff --git a/docs/architecture/ARCHITECTURE_INVENTORY.md b/docs/architecture/ARCHITECTURE_INVENTORY.md index a36c4510..7e901564 100644 --- a/docs/architecture/ARCHITECTURE_INVENTORY.md +++ b/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`：跨栈主契约 diff --git a/docs/architecture/CODE_REFERENCE_INDEX.md b/docs/architecture/CODE_REFERENCE_INDEX.md index 54bcf480..e06e38b3 100644 --- a/docs/architecture/CODE_REFERENCE_INDEX.md +++ b/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=`；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/`