107 KiB

Raw Blame History

PMFlow 产品推进执行标准

版本日期：2026-04-24

本文档是 PMFlow 产品方案落地的推进标准。它回答四件事：

当前产品方案推进到哪里了。
下一步应该继续往哪里推进。
每次推进的范围、验收和文档回写怎么做。
新开 Codex 线程时如何接续，避免重做、漏做或偏离方向。

产品方向真源仍以 docs/PMFLOW_PRODUCT_BLUEPRINT.md 为准。本文档不重新定义战略，只管理落地节奏和进度。

1. 当前推进判断

截至 2026-04-24，PMFlow 已经完成“产品方向收敛 + 前端本地高保真主链 + 后端局部控制面”的阶段，但还没有完成“真实数据闭环产品化”。

1.1 已经推进到位的部分

产品方向

已明确 PMFlow 不是“聊天工具 + 项目管理工具”，而是“对话驱动的 AI 产品执行操作系统”。
已明确首版方向为 solo-first, team-ready，面向个人开发者、一人公司、半技术产品创作者和 1-10 人 AI 应用小团队。
已明确团队协作不是传统多人维护任务表，而是围绕 AI 维护的项目真相层进行异步审查和人机混编执行。
已明确 V1 主链为：创意输入 -> AI 结构化提取 -> 变更确认 -> 项目对象沉淀 -> 任务拆解 -> 推送 IDE / agent -> 开发与测试回写 -> 发布 -> 数据反馈 -> 下一轮迭代。

真源：

docs/PMFLOW_PRODUCT_BLUEPRINT.md
USER.md

前端产品域

当前已经存在三条独立产品域：

frontend/src/features/personal-space/
- 空间入口。
- 用本地 mock 展示继续推进、待我确认、AI 正在推进、暂存想法、草案箱和新建项目入口。
frontend/src/features/project-launch/
- 新项目启动台。
- 用本地状态机覆盖意图输入、AI 工作、人类确认、草案修改、失败态、创建成功态和移动端 bottom sheet。
frontend/src/features/pmflow-os/
- PMFlow OS 项目内主体验。
- 已有本地 truth store 和页面：CommandCenter / StructuredExtraction / ChangeReview / MemoryWritebackResult / WorkGraph / ExecutionBridge / ReleaseGrowth / TeamLayer / ProjectMemory。
- 已有本地状态动作：sendMessage -> generateExtraction -> acceptChange/editChange/deferChange -> promoteAcceptedToGraph -> pushTaskToExecution -> writeBackExecution -> publishRelease -> ingestGrowthSignal。

当前性质：

这是产品主链的高保真原型和本地行为闭环。
还不是正式后端数据闭环。
不接真实 AI 提取，不写真实数据库，不消费真实项目对象。

后端控制面

当前已经出现 AI 应用项目控制面的初步生产化能力：

backend/app/models/ai_project_control.py
- 模型目录、项目模型绑定、模型推荐快照、模型用量、模型评测。
- Prompt Package。
- IDE 工作区绑定、Repo 绑定、GitHub App 安装/仓库/webhook 投递。
- TaskCodeLink、ProgressEvent、DevSession。
- ReleaseValidationRun、FeedbackIngest、IterationRecommendation、RevenueEvent、ROISnapshot、ComplianceCheckRun、EvidencePack。
backend/app/services/ai_project_control_service.py
- 模型推荐、模型绑定、prompt package、开发同步、GitHub/repo 绑定、进度事件、发布验证、反馈/收入/合规等服务能力。
backend/app/api/sstc_api/model_control.py
- 模型推荐、模型绑定、模型用量、Prompt Package、发布验证、反馈摄取、收入记录、合规检查等接口。
backend/app/api/dev_sync.py
- GitHub App 安装、仓库绑定、开发任务、项目 dev-sync summary、任务进度事件等接口。

当前性质：

后端已经有 V1 产品化需要的部分基础对象和接口。
但它们还没有和 frontend/src/features/pmflow-os/ 的本地 truth store 正式打通。
ChangeSet / Approval / Evidence / Project Memory 这条主产品链仍主要停留在前端本地态和旧 SSTC/semantic facts 体系之间，缺少统一的 PMFlow OS 产品级 API 合同。

1.2 当前缺口

当前最大缺口不是再讨论产品方向，而是：

把已经成立的产品主链从本地原型推进成真实可用的数据闭环。

关键缺口按优先级排序：

Project Thread / ChangeSet / Evidence / Approval / Project Memory 的前后端合同没有完全收口。
project-launch 还没有接真实 AI 结构化、真实项目创建和真实草案确认。
pmflow-os 本地 store 还没有接后端读写，当前仍是 mock truth store。
ChangeReview 的接受、修改、暂缓还没有写入正式对象、审批记录和证据链。
ExecutionBridge 页面还没有消费 dev-sync / GitHub / PromptPackage 真实接口。
ReleaseGrowth 已接入 execution evidence gate，但 release validation、feedback、revenue、ROI、compliance 还没有串成完整发布后反馈循环。
TeamLayer 仍是产品表达层，缺少真实成员角色、Role Inbox、Decision Desk、Team Feed 的数据模型和审查流程。

2. 下一步推进方向

下一步不要扩大战线，不要新增新的战略产品表面；可以在已确认的 Main Flow / Space / Account Settings 这些既有表面内并行推进。正确方向是：

把 V1 主链真实闭环化。

也就是从“本地高保真原型”推进到“真实项目对象 + 真实 AI 提取 + 真实确认写入 + 真实执行回写”。

2.1 下一阶段总目标

阶段目标命名为：

V1 Productized Loop

验收标准：

用户从 /project-launch 输入一个 AI 应用创意。
后端生成可审查的结构化草案或变更集。
用户确认后创建项目，并写入项目真相层。
进入 /command-center 后能看到真实项目线程、结构化提取、待确认项和项目对象。
用户接受变更后，正式对象、审批记录、证据链同步更新。
至少一个任务能生成 Prompt Package，并进入 Execution Bridge。
Execution Bridge 能消费真实 dev-sync summary 或 progress event。
发布/反馈页能消费至少一类真实 release validation / feedback / revenue / compliance 数据。

2.2 暂不推进的方向

下一阶段暂不推进：

完整财务系统。
完整合规平台。
企业组织树和复杂权限矩阵。
多项目 portfolio。
应用市场、投融资、孵化生态。
前台多 agent 选择器。
与产品主链无关的后台治理页扩展。

这些都不是当前瓶颈。

3. 推荐推进顺序

3.0 功能原型一致性治理

任何 PMFlow 核心功能在继续出图、重画、实现或新开线程接续前，必须先确认是否已有 canonical 功能契约。若已有契约，后续只能在该契约下新增状态、补充局部区域或做明确版本迭代，不能把同一功能重新设计成另一套页面。

功能契约至少包含：

功能定位
页面/状态列表
固定导航壳
核心对象模型
状态标签体系
用户动作
AI 动作
系统状态
移动端规则
不可随意改变的部分
可扩展的部分

确认流程：

先列出本轮涉及的功能清单。
每次只提交一个功能契约给用户确认。
用户确认后，才把该功能契约写入本文档或对应产品真源。
后续原型图、实现、验收都以已确认契约为准。
如需重构，必须先说明旧版是什么、新版改什么、迁移影响是什么，并得到明确确认。

当前需要逐个确认的功能清单：

新项目启动台
个人空间首页
项目指挥台
本轮结构化提取
决策与待确认
项目记忆
移动端底部导航
项目切换器
项目工作台
开发执行联动
发布与增长
团队协作

Phase A：产品合同收口

目标：

把 pmflow-os 本地类型、现有 SSTC/semantic facts/ai_project_control 后端对象和 V1 蓝图对象对齐。

范围：

梳理 ProjectThread / ChangeSet / ChangeItem / Evidence / Approval / ProjectMemory / ExecutionRun 的后端合同。
明确哪些对象复用现有表，哪些需要新表或投影表。
明确 frontend/src/features/pmflow-os/types.ts 如何映射到 API response。
明确哪些接口走已有 sstc_api / dev_sync，哪些需要新增 pmflow_os_api。

产物：

API/Schema 设计说明或直接 Pydantic schema。
更新 docs/architecture/CODE_REFERENCE_INDEX.md。
如新增表，必须 Alembic migration。

验收：

能回答“前端每一个本地对象从哪个后端字段来，写回到哪里去”。
不能再出现前端原型对象和后端业务对象各讲各话。

Phase B：Project Launch 真实创建链

目标：

把新项目启动台从本地状态机接到真实项目创建/草案确认主链。

范围：

/project-launch 意图输入接真实 API。
AI 结构化结果必须产出可审查草案，而不是直接静默创建。
用户确认后创建项目，并跳转真实 /command-center。
创建结果必须写入项目真相层初始对象：Idea、Requirement、Decision、Risk、Task 或等价 SSTC 对象。

验收：

真实接口创建项目。
失败时显式失败，不用 mock 冒充成功。
创建成功后进入真实项目上下文。
项目创建前移动端仍不展示正式底部导航。

Phase C：Change Review 与 Project Memory 写入

目标：

让对话/结构化提取生成的 ChangeSet 能被接受、修改、暂缓，并写入正式项目对象和证据链。

当前拆分：

C1：真实 Change Review 数据底座与审查状态机，已实现 ChangeSet / ChangeItem / Approval / EvidenceLink 表和 accept / edit / defer，但不 commit。
C2：提交入库，把已接受/已编辑 ChangeItem 写入 truth_nodes / tasks / semantic_facts 并完成高风险 approval gate。

范围：

StructuredExtractionPage 接真实提取结果。
ChangeReviewPage 接真实 ChangeSet。
接受/修改/暂缓动作调用后端。
C2 写入后 ProjectMemoryPage / WorkGraphPage / TeamFeed 能读到最新对象。

验收：

ChangeSet 有 Evidence。
高风险变更需要 Approval。
C1 接受后只进入 accepted / edited / deferred 审查状态，不进入 Project Memory。
C2 commit 后对象状态从 proposed/draft 进入 confirmed 或对应正式状态。
暂缓后不进入项目真相层，但仍留审计。

Phase D：Execution Bridge 真实开发同步

目标：

让 PMFlow 真正连接开发执行，而不是只展示执行概念。

范围：

ExecutionBridgePage 消费 devSyncApi。
任务能生成 Prompt Package。
能绑定 repo 或展示 GitHub App 安装状态。
能创建或读取 ProgressEvent。
能把 PR/commit/test 信息回写到任务和 Team Feed。

验收：

至少一个真实任务能进入执行桥。
能看到真实 Prompt Package 或 dev task。
能看到真实 progress event。
任务状态能随回写变化。

Phase E：Release / Growth 轻量闭环

目标：

上线后反馈进入下一轮迭代，不停在“开发完成”。

范围：

ReleaseGrowthPage 已消费 execution evidence gate；后续继续接 release validation。
支持 feedback ingest。
支持 revenue event 或基础 ROI snapshot。
支持 compliance check 的轻量门禁。
反馈能生成 IterationRecommendation 或下一轮 ChangeSet。

验收：

发布前有门禁。
发布后有反馈/收入/成本/合规至少一类真实信号。
信号能回流为下一轮建议，不只是展示图表。

Phase F：Team-ready 最小闭环

目标：

不做重型团队管理，但补齐小团队围绕项目真相层协作的最小能力。

范围：

成员归属。
角色收件箱 Role Inbox。
Team Feed。
Decision Desk 或高风险变更多人审查。
Agent Workforce 的只读可见化。

验收：

不同角色看到不同待处理项。
高风险 ChangeSet 能指定 reviewer/owner。
Team Feed 展示 AI 提取、人工确认、执行回写、测试/发布变化。

4. 单次任务范围标准

每次 Codex 执行产品推进任务，必须控制为一个“可闭环增量”，不要跨太多面。

4.1 默认范围

一次任务最多覆盖：

一个产品表面：如 Project Launch / Change Review / Execution Bridge。
一个后端合同或服务切片。
一个前端接入切片。
对应测试。
对应文档进度回写。

如果预计改动超过 5 个核心文件或超过约 200 行业务代码，必须先拆子任务，除非是同一根因的缺陷修复。

4.2 推荐任务模板

每次新任务开始前，先给自己明确：

本次要推进的 Phase。
本次要打通的用户路径。
涉及的前端入口。
涉及的后端 API / service / model。
本次不处理的边界。
最小验证命令。
完成后要更新的进度文档。

4.3 禁止范围漂移

产品推进任务里禁止顺手做：

无关视觉重构。
无关后台治理页扩展。
无关权限体系大改。
无关 AI prompt 大改。
无关模型路由策略调整。
无关文案大清洗。

除非这些问题直接阻断本次用户路径。

4.4 Codex 并行推进协议

PMFlow 允许多个 Codex 线程并行推进。产品上可以按“大模块 lane”长期并行，例如主流程、空间、个人中心，但实际执行单位仍必须是明确的 Packet。不能只用“做空间”“做个人中心”“做主流程”这类模糊大模块直接开工；每个模块 lane 都必须拆成带 write_scope 的 Packet。没有 write_scope 的任务不允许并行执行。

每个并行 Packet 开始前必须声明：

packet_id
phase
owner_thread
base_ref
read_scope
write_scope
forbidden_paths
shared_files
depends_on
merge_after
verification
docs_to_sync

并行硬规则：

只有 write_scope 不重叠的 Packet 才允许并行。
任意两个 Packet 若同时需要改 router / schema / migration / shared API client / shared store / CLAUDE.md / CODE_REFERENCE_INDEX.md，必须串行。
每轮并行最多保留一个 contract / migration / router owner；其它线程只能消费该 owner 已定义的稳定接口。
并行线程不得在自己的 write_scope 外做“顺手修复”；发现阻塞问题时，只记录到 integration notes 或新建后续 Packet。
同一批并行开发必须指定一个 integration owner，负责最终合并共享文件、跑集成验证和更新进度台账。

4.4.1 大模块并行治理

大模块并行的目标是让不同产品表面长期同时推进，但不让它们抢同一批共享文件、共享状态和共享合同。

大模块 lane 可以长期存在；Packet 必须短生命周期。lane owner 负责该产品表面的连续性，Packet owner 负责一次可验证增量。一个 lane 同一时间可以只有一个活跃 Packet，也可以拆成同 lane 内串行小 Packet；不同 lane 只有在 write_scope 不重叠时才允许并行。

大模块并行必须遵守以下规则：

先由 Shell / Integration owner 冻结公共壳、路由、导航、Provider、共享 API client、共享文档归属。
Main Flow / Space / Account Settings 等模块线程只能写自己 lane 的 owned files。
任一模块需要改共享文件，必须先把该修改拆给 Shell / Integration owner，不能在模块 Packet 里顺手改。
模块之间只能通过稳定合同交互：URL、route params、只读 summary API、事件/待确认摘要、用户偏好 API；禁止跨模块直接 import 对方 store 内部实现。
Space 只能聚合和跳转，不直接写 Project Memory、ChangeSet commit、Execution Bridge 回写。
Account Settings 只能处理用户资料、偏好、通知和账户壳，不直接改项目主链、权限核心或 AI 路由。
Main Flow 可以继续推进 PMFlow OS 主链，但不得顺手重做 Space 首页或个人中心。
每批大模块并行仍必须有一个 integration owner 统一执行 Parallel Integration Gate。

共享高冲突文件默认只归 Shell / Integration owner：

frontend/src/router/index.tsx
frontend/src/main.tsx
frontend/src/lib/api.ts 或其它共享 API base
frontend/src/features/pmflow-os/components/PMFlowOsFrame.tsx
frontend/src/features/pmflow-os/components/MobileBottomNav.tsx
backend/app/api/router.py
backend/app/models/__init__.py
backend/alembic/versions/*
CLAUDE.md
docs/PMFLOW_PRODUCT_DELIVERY_STANDARD.md
docs/architecture/CODE_REFERENCE_INDEX.md
docs/architecture/ARCHITECTURE_INVENTORY.md
docs/architecture/API_CONTRACTS.md

4.4.2 当前大模块 lane 划分

Lane 0：Shell / Integration

定位：

冻结公共应用壳、路由、移动底部导航、Provider、共享文档和合并顺序。
不承担具体产品表面的大量 UI 实现。

默认写范围：

frontend/src/router/index.tsx
frontend/src/main.tsx
frontend/src/features/pmflow-os/components/PMFlowOsFrame.tsx
frontend/src/features/pmflow-os/components/MobileBottomNav.tsx
CLAUDE.md
docs/PMFLOW_PRODUCT_DELIVERY_STANDARD.md
docs/architecture/CODE_REFERENCE_INDEX.md
docs/architecture/ARCHITECTURE_INVENTORY.md
docs/architecture/API_CONTRACTS.md

Lane 1：Main Flow / PMFlow OS 主流程

定位：

打穿 V1 主链：Project Thread -> Structured Extraction -> Change Review -> Project Memory -> Execution Bridge -> Release/Growth。
这是产品核心闭环，优先级最高。

默认写范围：

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/services/pmflow_change_review_service.py
backend/app/schemas/pmflow_os.py
backend/tests/test_pmflow_*

默认禁止：

不改 frontend/src/features/personal-space/。
不改 Account Settings 域。
不改共享 router / nav / docs，除非本 Packet 就是 integration owner。

Lane 2：Space / 个人空间入口

定位：

建设 /space 作为所有项目、想法、草案、待确认和 AI 推进状态的上层入口。
Space 是聚合与导航层，不是 Project Memory 或 ChangeSet 的写入层。

默认写范围：

frontend/src/features/personal-space/
frontend/src/pages/PersonalSpacePage.tsx
frontend/src/api/space.ts（如需要）
backend/app/api/space_api/（如需要，只读聚合优先）
Space 相关测试

默认禁止：

不改 frontend/src/features/pmflow-os/store.tsx。
不改 PMFlow OS 主流程页面。
不改 ChangeSet commit / Execution Bridge 写回服务。
不直接写项目真相层；写动作必须跳转或调用已有主流程合同。

Lane 3：Account Settings / 个人中心与设置

定位：

建设 /me、个人资料、偏好、通知、AI 使用偏好和账户操作。
Account Settings 是用户偏好层，不是项目协作层或权限核心重构。

默认写范围：

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 相关测试

默认禁止：

不改 Project Memory / ChangeSet / Execution Bridge。
不改 Space 聚合。
不改 OAuth/JWT/auth core；如必须改，另开安全 Packet。
不改共享 router / nav，除非由 integration owner 串行处理。

4.4.3 P0 公共壳冻结结果

截至 2026-04-26，P0 对当前共享壳的冻结结论如下。后续 main-flow-phase-d-execution / space-v1-workbench / account-settings-v1 必须按此边界开工。

Route 归属

路由	当前实现	归属 lane	后续规则
`/space`	已存在，`PersonalSpaceStandalone` -> `frontend/src/pages/PersonalSpacePage.tsx` -> `frontend/src/features/personal-space/`	Space	Space lane 可改页面域；不得在本 lane 改 router，除非通过 Shell owner
`/project-launch`	已存在，`ProjectLaunchStandalone` -> `frontend/src/pages/ProjectLaunchPage.tsx` -> `frontend/src/features/project-launch/`	Project Launch / Shell owned route	非本批三线程主任务；后续只作为 Space 和 Main Flow 的入口/跳转消费
`/pmflow-os`	已存在，alias 到 `CommandCenterStandalone`，支持 `?projectId=<id>` 真实项目上下文	Main Flow	Main Flow lane 消费；route alias 归 Shell owner
`/command-center`	已存在，standalone 与 AuthGuard children 双入口均存在	Main Flow	当前作为免登录产品预览壳和项目指挥台入口；后续是否收敛双入口由 Shell owner 单独处理
`/change-review`	已存在，移动底导“待确认”指向此路由	Main Flow	Space 只能聚合摘要并跳转，不直接写 Change Review 状态
`/execution-bridge`	已存在于 AuthGuard children	Main Flow	Phase D 真实接入由 Main Flow lane 负责
`/release-growth`	已存在于 AuthGuard children	Main Flow	Phase E 再推进，不进入本批 Space / Account scope
`/me`	已存在，standalone 与 AuthGuard children 双入口均存在，页面来自 `frontend/src/features/pmflow-os/pages/AccountPage.tsx`	Account Settings	Account lane 可改 AccountPage/AccountControls；route 归 Shell owner
`/settings`	当前未实现	Account Settings reserved	不在 P0 临时新增；由 `account-settings-v1` 提出需要后，Shell owner 串行加 route

Provider 与共享状态

frontend/src/main.tsx 当前全局挂载 QueryClientProvider -> PMFlowOsProvider -> ToastProvider -> RouterProvider。
PMFlowOsProvider 当前是全局 provider，但业务所有权归 Main Flow / PMFlow OS。
Space 和 Account Settings 可读取稳定公开 hook/API，但禁止直接改 frontend/src/features/pmflow-os/store.tsx 或依赖其内部 mutation 细节。
如果 Space 需要“待确认 / AI 正在推进 / 最近项目”摘要，优先新增 frontend/src/api/space.ts 与只读后端聚合接口，不能从 PMFlow OS store 内部反向拼。
如果 Account Settings 需要用户偏好，优先新增 frontend/src/api/accountSettings.ts 与独立后端接口，不能把个人偏好塞进 PMFlow OS truth store。

导航与移动底部栏

frontend/src/features/pmflow-os/components/MobileBottomNav.tsx 是正式应用壳唯一移动底部导航实现。
当前五项固定为：空间 -> /space、指挥台 -> /command-center、待确认 -> /change-review、动态 -> /command-center、我的 -> /me。
Space / Main Flow / Account 三个模块线程不得各自改底部导航。任何导航项新增、重命名、跳转变更，都必须交给 Shell owner。
当前 动态 暂时回到 /command-center，属于保留占位；后续如实现 /activity 或动态页，必须单独开 Shell / Integration Packet。

下一批开工条件

main-flow-phase-d-execution 可以直接开工，前提是不改 router、MobileBottomNav、PMFlowOsFrame 的导航归属。
space-v1-workbench 可以直接开工，前提是只改 personal-space owned files 和可选 space.ts / space_api，不碰 PMFlow OS store。
account-settings-v1 可以直接开工，前提是不新增 /settings route；如确需 /settings，先把 route 需求写入 integration notes，再由 Shell owner 添加。

4.5 V1 Productized Loop 默认并行切片

V1 主链并行开发默认按 lane 切分：

Contract Lane：API / Schema / DB migration / 核心对象合同，只允许单线程拥有。
Backend Lane：service + route + tests，必须依赖 Contract Lane。
Frontend Lane：frontend/src/api/ + React Query / store 接入，必须依赖稳定 API 合同。
UI Lane：页面展示、状态、交互、响应式，只能改功能域内组件，不能改 API 合同。
Docs/Test Lane：回归补充、文档同步、验证矩阵，可以和非共享代码并行，但最终由 integration owner 统一收口。

默认合并顺序：

Contract / migration
Backend service / API
Frontend API / store
UI / page
Docs / test / integration

4.6 Phase C2 并行试点拆包

当前下一阶段 Phase C2：ChangeSet commit 入库 默认拆成四个 Packet：

C2-contract
- Lane：Contract Lane
- 目标：定义 commit API、写入规则、高风险 approval gate、响应合同和失败语义。
- 写范围：PMFlow OS 产品合同、API 合同、schema 草案或对应设计文档。
- 退出条件：后端和前端实现线程不需要再自行决定 API shape。
C2-backend
- Lane：Backend Lane
- 目标：实现 ChangeSet commit service、route、transaction、权限边界和后端测试。
- 依赖：C2-contract
- 写范围：backend/app/api/pmflow_os_api/、backend/app/services/pmflow_change_review_service.py、backend/app/schemas/pmflow_os.py、相关 tests；若需要 migration，必须回到 Contract Lane 串行处理。
C2-frontend
- Lane：Frontend Lane
- 目标：接入 commit API，更新 pmflow-os store、Change Review 状态和错误/成功反馈。
- 依赖：C2-contract
- 写范围：frontend/src/api/pmflowOs.ts、frontend/src/features/pmflow-os/store.tsx、ChangeReviewPage 或 owned 组件测试。
C2-docs-verification
- Lane：Docs/Test Lane
- 目标：同步产品推进台账、代码索引、API 合同、架构库存，并执行最终集成验证。
- 依赖：C2-backend、C2-frontend
- 写范围：文档和验证记录；共享文档由 integration owner 统一合并。

C2-contract 必须先完成；C2-backend 和 C2-frontend 只能在合同稳定后有限并行；最终必须由一个 integration owner 统一收口。

4.7 分支与 worktree 协议

并行开发默认使用独立分支和独立 worktree：

分支命名：codex/<packet_id>。
每个 Packet 必须记录启动时的 base_ref。
每个并行线程优先使用独立 git worktree，避免同一工作区文件互相覆盖。
合并前必须检查当前分支是否落后主集成分支。
合并前必须检查 git diff --name-only，确认没有写出 write_scope。
触碰共享高冲突文件时，必须交由 integration owner 合并。

4.8 Packet commit 协议

并行开发不是“每改一行就提交”，也不是“多个 Packet 混在一个长期分支里攒”。默认规则：

一个 Packet 对应一个短生命周期分支：codex/<packet_id>。
Packet 完成、验证通过、文档同步完成后，必须形成至少一个可审查 commit。
Codex 必须自行执行 commit gate 判定，不把“该不该提交”默认丢给用户判断。
复杂 Packet 可以在同一分支内做多个 checkpoint commit，但每个 commit 都必须是逻辑完整切片，不能提交半成品、失败验证或越界改动。
不允许把多个不同 Packet 的实现混进同一个 commit。
不允许在旧 Packet 分支上继续做新 Packet；新 Packet 必须从最新 integration base 或明确依赖分支重新开 codex/<new_packet_id>。
如果新 Packet 依赖尚未合并的 Contract Lane，优先等待合同分支合入；确需提前开发时，必须以该合同分支作为 base_ref，并在任务包里写明 depends_on / merge_after。
integration owner 只合并通过 Parallel Integration Gate 的 Packet commit；未验证 commit 只能留在 Packet 分支内，不进入主集成分支。
每个 Packet 合并后，旧 Packet 分支只用于追溯，不再追加新业务改动。

commit gate 判定：

auto_commit：满足全部条件时，Codex 应自行提交当前 Packet 分支。
- 当前改动全部在 write_scope 内。
- 没有混入用户或其它线程的未归属改动。
- 触碰共享高冲突文件时，当前线程就是该文件的 owner 或 integration owner。
- 必要验证已通过；若验证无法执行，原因和影响已经写入结果与任务包。
- 必要文档已同步。
- commit 内容只包含当前 Packet。
hold_no_commit：满足任一条件时，Codex 不得提交，只能报告阻塞和证据。
- 验证失败且失败与本 Packet 相关。
- git diff --name-only 发现越界改动。
- 工作区混入无法归属的用户改动或其它线程改动。
- 发现 migration 多 head、合同不稳定、API shape 未定或依赖 Packet 未完成。
- 需要破坏性删除、重置、强推、覆盖、批量迁移等高风险操作。
ask_before_commit：满足任一条件时，Codex 必须先说明事实并等用户拍板。
- 用户明确要求只改不提交。
- commit 需要包含共享高冲突文件，但当前线程不是 owner。
- 验证无法运行且该 Packet 风险较高。
- 需要把多个 Packet 的改动临时合在一个 commit 里。
- 需要提交历史遗留脏改动才能让当前 Packet 自洽。

4.9 Parallel Integration Gate

每批并行开发结束后，integration owner 必须执行集成验收：

git diff --name-only 检查每个 Packet 是否越界。
后端改动：python -m py_compile + 相关 pytest。
前端改动：npm run typecheck + npm run build + 相关 focused tests。
migration 改动：alembic heads 必须单 head；必要时执行 alembic upgrade head。
文档：产品推进台账、代码索引、API 合同、架构库存同步完成。
若后端或 migration 改动已经落地，按项目规则执行热部署/重启；若不能执行，必须明确写阻塞原因。

5. 每次完成后的进度回写标准

后续 Codex 每完成一个 PMFlow 产品推进任务，必须自己更新进度，不需要用户额外提醒。

5.1 必须更新的地方

每次完成后至少更新：

本文档 ## 8. 进度台账
- 新增一条记录。
- 写清完成内容、影响范围、验证结果、下一步建议。
如果新增/删除/重命名文件或入口：
- 更新 CLAUDE.md
- 更新 docs/architecture/ARCHITECTURE_INVENTORY.md
- 更新 docs/architecture/CODE_REFERENCE_INDEX.md
如果新增/修改 API/Schema：
- 更新 docs/architecture/CODE_REFERENCE_INDEX.md
- 必要时更新 docs/architecture/API_CONTRACTS.md
如果新增运行边界、禁止项或系统行为约束：
- 更新 docs/architecture/RUNTIME_GUARDRAILS.md
如果改变产品战略或不可偏离项：
- 更新 docs/PMFLOW_PRODUCT_BLUEPRINT.md
- 更新 USER.md

5.2 进度台账记录格式

每条记录必须包含：

日期。
Phase。
状态：done / partial / blocked。
完成内容。
涉及文件。
验证命令和结果。
未完成或风险。
下一步建议。

5.3 什么时候不用更新蓝图

普通实现、接 API、修 bug、补测试，不更新产品蓝图。

只有以下情况才更新蓝图：

用户改变产品定位。
V1 范围改变。
团队方向改变。
新增/删除核心产品表面。
改变不可偏离项。

6. 新开线程接续标准

任何新 Codex 线程，如果用户要求继续 PMFlow 产品推进，必须先读：

USER.md
docs/PMFLOW_PRODUCT_BLUEPRINT.md
docs/PMFLOW_PRODUCT_DELIVERY_STANDARD.md
CLAUDE.md
docs/architecture/CODE_REFERENCE_INDEX.md

然后再查当前目标相关代码。

新线程不得：

重新讨论 PMFlow 是否应该做对话驱动 OS。
重新建议变成传统项目管理工具。
重新发散大而全模块。
忽略 ## 8. 进度台账 直接从头设计。
把本地原型当成真实后端闭环。
把已有后端 ai_project_control / dev_sync / sstc model_control 忽略后重造一套。

7. 当前下一步推荐任务

当前最建议下一步执行：

Phase D.2：Execution Bridge 执行交接合同。

原因：

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 起点。

7.1 下一批大模块并行建议

P0 公共壳冻结已完成，下一批可以进入 Batch P1 三模块并行；最终仍必须由 Batch P2 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`

目标：

继续执行 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 和下一步。

默认写范围：

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

Space Packet：`space-v1-workbench`

目标：

把 /space 推进成个人工作面聚合页。
展示继续推进、待我确认、AI 正在推进、暂存想法、草案箱、最近项目。
优先只读聚合；点击项目进入 /pmflow-os?projectId=...，不直接写项目真相层。

默认写范围：

frontend/src/features/personal-space/
frontend/src/pages/PersonalSpacePage.tsx
frontend/src/api/space.ts（如需要）
backend/app/api/space_api/（如需要，只读聚合优先）
Space 相关测试

Account Settings Packet：`account-settings-v1`

目标：

建设 /me 和个人设置首版。
覆盖个人资料、AI 偏好、通知偏好、账户操作和移动端 bottom sheet。
不改 OAuth/JWT/auth core，不改项目主链。

默认写范围：

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 的冲突。
跑后端/前端最小集成验证。
更新 ## 8. 进度台账、CODE_REFERENCE_INDEX.md、ARCHITECTURE_INVENTORY.md 与必要的 CLAUDE.md。

8. 进度台账

2026-04-26 / release-feedback-p1-feedback-ingest-readmodel / implemented

完成内容：

在 PMFlow OS 后端新增轻量写入口 POST /pmflow-os/projects/{project_id}/release-feedback-ingests，复用现有 AIProjectControlService.ingest_feedback 与 FeedbackIngest / IterationRecommendation 模型，不新增 migration。
GET /pmflow-os/projects/{project_id}/execution-summary 新增 releaseSignals 投影，聚合真实发布后 feedback / revenueEvents / recommendations，并显式返回 releaseGateStatus / latestValidationRunId / changeSetCreated=false 关系信息。
ReleaseGrowthPage 真实模式新增“发布后反馈信号”区域和“摄取发布后反馈”表单；无信号时展示明确 empty/warning，不用 mock 成功数据补位。
前端 PMFlowOsProvider 新增 createReleaseFeedbackIngest 动作，真实模式调用 PMFlow OS API 并 refetch truth-state / execution-summary；demo 模式仍只在显式 ?demo=1 下走本地演示 mutation。
本阶段只沉淀下一轮 iteration recommendation 所需数据，不自动创建 ChangeSet，不触发真实发布，不接外部支付，不接邮件/桌面推送。

涉及文件：

backend/app/api/pmflow_os_api/__init__.py
backend/app/schemas/pmflow_os.py
backend/app/services/pmflow_os_projection_service.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/store.api.test.tsx
frontend/src/features/pmflow-os/pages/ReleaseGrowthPage.tsx
docs/PMFLOW_PRODUCT_DELIVERY_STANDARD.md
docs/architecture/CODE_REFERENCE_INDEX.md
docs/architecture/ARCHITECTURE_INVENTORY.md
CLAUDE.md

验证：

PYTHONPATH=backend /opt/homebrew/bin/python3.11 -m py_compile backend/app/api/pmflow_os_api/__init__.py backend/app/services/pmflow_os_projection_service.py backend/app/schemas/pmflow_os.py 通过。
PYTHONPATH=backend /opt/homebrew/bin/python3.11 -m pytest backend/tests/test_pmflow_os_projection_api.py -q 通过：18 passed；仍有既有 backend/app/schemas/recipe.py Pydantic V2 class-based config deprecation warning。
cd frontend && npm run test -- src/features/pmflow-os 通过：2 passed / 8 passed。
cd frontend && npm run typecheck 未通过：当前独立 worktree 没有被 .gitignore 忽略的 frontend/src/lib/* 本地 helper 文件，导致全仓 @/lib/api、@/lib/utils、@/lib/datetime、@/lib/display、@/lib/rbac 等 alias 解析失败；这些文件不在本 Packet write scope，未越界补入。
cd frontend && npm run build 同样停在上述 frontend/src/lib/* 缺失的 TypeScript 解析错误，未进入 Vite build。

未完成或风险：

本阶段只接入 feedback ingest 与 releaseSignals 读模型；RevenueEvent / ComplianceCheckRun 已可被后续扩展继续纳入更完整发布后运营读模型。
iteration recommendation 目前作为建议底座展示，不自动生成 ChangeSet；下一轮如果要从 recommendation 进入待确认中心，需要单独开 Main Flow packet。
全量前端 typecheck/build 需在包含 frontend/src/lib/* helper 的集成环境或由 Shell / Integration owner 修正该 ignored 文件边界后重新验证。

2026-04-26 / big-module-integration-p4 / done

完成内容：

收口 Release Validation P1、Space P3、Account P3 与 Release/Growth P2 的并行成果，当前集成分支已包含 875b929 feat(pmflow-os): record release validation runs、b9b4b5a feat(space): surface release validation attention、fe7807b feat(account): define release notification consumption、32af422 feat(pmflow-os): respect release notification preferences。
确认本轮只做共享文档收口和依赖分支合并，没有修改 frontend/src/router/index.tsx、frontend/src/features/pmflow-os/components/MobileBottomNav.tsx 或新增 route/nav；现有 /release-growth、/space、/me 入口足够承接本批成果。
共享文档冲突已按 lane 边界合并：Main Flow 负责 release gate、release validation run 和 ReleaseGrowth 偏好消费；Space 只读消费 truth-state.releases / execution-summary.releaseGate 并跳转主流程；Account 只提供通知偏好 helper，不接真实邮件、桌面推送或通知中心。
CODE_REFERENCE_INDEX.md、ARCHITECTURE_INVENTORY.md 与 CLAUDE.md 已同步到 P4 后的当前合同，明确 ReleaseGrowthPage 可创建 validation run、消费 Account notification preference，但不执行部署命令、不隐藏真实证据和审计状态。

涉及文件：

CLAUDE.md
docs/PMFLOW_PRODUCT_DELIVERY_STANDARD.md
docs/architecture/CODE_REFERENCE_INDEX.md
docs/architecture/ARCHITECTURE_INVENTORY.md
合并依赖分支带入的 Main Flow / Space / Account owned files

验证：

git diff --name-only 已执行，最终待提交 diff 仅为 P4 integration 文档收口。
PYTHONPATH=backend /opt/homebrew/bin/python3.11 -m pytest backend/tests/test_pmflow_os_projection_api.py backend/tests/test_account_settings_api.py -q 通过：21 passed；仍有既有 backend/app/schemas/recipe.py Pydantic V2 class-based config deprecation warning。
cd frontend && npm run test -- src/features/pmflow-os 通过：6 passed。
cd frontend && npm run test -- src/features/personal-space/PersonalSpacePage.test.tsx 通过：2 passed；仍有既有 React Router v7 future flag warning。
cd frontend && npm run test -- src/features/account-settings/accountSettings.test.ts 通过：9 passed。
cd frontend && npm run typecheck 通过。
cd frontend && npm run build 通过；Vite 仍提示既有 manual chunk circular warning（ai-steward / sstc / charts / governance chunk 环）。
docker compose restart backend 已执行，docker compose ps backend 确认 pmflow-backend 恢复 healthy。

未完成或风险：

P4 仍不接真实发布部署、邮件、桌面推送或系统通知中心；这些必须后续单独开 Packet。
本轮未做路由/导航变更；如后续新增 /settings 或发布验证独立入口，必须继续由 Shell / Integration owner 串行处理。

2026-04-26 / release-growth-p2-notification-preference-consume / implemented

完成内容：

ReleaseGrowthPage 真实模式读取 Account Settings 通知偏好，通过 shouldShowAccountNotification(settings, "releaseGate") 控制发布门禁强调提醒，通过 shouldShowAccountNotification(settings, "failureAlert") 控制失败强调提醒。
releaseGate 偏好关闭时，页面不展示“发布门禁提醒”强调卡，也降低缺证据 / 阻塞门禁视觉强调；底层 releaseGate 状态、执行证据、阻塞原因、下一步动作和发布验证记录仍完整展示。
failureAlert 偏好关闭时，失败 evidence 与阻塞原因仍可见，但不展示额外醒目的“失败提醒”卡，也不把阻塞原因渲染成额外告警态。
本阶段只消费本地页面内提醒偏好，不接邮件、桌面推送或通知中心；不修改 Account Settings 合同、PMFlow OS store、后端发布验证 API、router、Space 或 Account 页面。
store.api.test.tsx 补充 ReleaseGrowth 偏好开启 / 关闭两条路径，覆盖提醒展示、静默展示和 release evidence 仍可见。

涉及文件：

frontend/src/features/pmflow-os/pages/ReleaseGrowthPage.tsx
frontend/src/features/pmflow-os/store.api.test.tsx
docs/PMFLOW_PRODUCT_DELIVERY_STANDARD.md
docs/architecture/CODE_REFERENCE_INDEX.md
docs/architecture/ARCHITECTURE_INVENTORY.md

验证：

cd frontend && npm run test -- src/features/pmflow-os 通过：2 passed / 6 passed。
cd frontend && npm run typecheck 未通过：当前前端树缺失整组共享 src/lib/* 模块（例如 @/lib/api、@/lib/utils、@/lib/datetime、@/lib/display、@/lib/rbac），影响全仓大量既有文件和 forbidden router/index.tsx；本 Packet 未越界修复。
cd frontend && npm run build 同样停在上述共享 src/lib/* 缺失的 TypeScript 解析错误，未进入 Vite build。

未完成或风险：

本阶段不隐藏业务真相，只控制提醒表达强度；发布证据、审计状态和 validation run 仍以 PMFlow OS 真实读侧为准。
全量前端 typecheck/build 需由 Shell / Integration owner 或共享前端基础模块 owner 先恢复 frontend/src/lib/* 后再重新验证。

2026-04-26 / release-validation-p1-real-run-records / implemented

完成内容：

新增 POST /pmflow-os/projects/{project_id}/release-validation-runs，复用 PMFlow OS 项目成员/OWNER/REVIEWER 权限边界和统一 {code,message,data} 返回包络。
复用现有 ReleaseValidationRun 模型，不新增 migration；从当前 execution-summary.releaseGate 固化 status / evidence / blockingReasons / nextActions / createdBy / createdAt / humanDecision。
ready evidence + enter_release_candidate 生成 ready run；needs confirmation evidence 生成 needs_confirmation run；failed / blocked evidence 或 keep_blocked 生成 blocked run。
无 execution evidence 或 releaseGate.status=empty 时返回 release_validation_evidence_empty，不创建成功 run，也不使用 mock validation。
execution-summary.releaseGate.latestValidationRun 返回最新发布验证记录，ReleaseGrowthPage 真实模式新增“发布验证记录”区域和“生成发布验证记录 / 记录保持阻塞”动作；页面仍不执行真实部署。
frontend/src/api/pmflowOs.ts 改为 PMFlow OS API 层自包含 /api fetch 包络解析，避免当前工作树缺失共享 @/lib/api 时影响 PMFlow OS focused tests；不改全局 API client。

涉及文件：

backend/app/api/pmflow_os_api/__init__.py
backend/app/services/pmflow_os_projection_service.py
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/store.api.test.tsx
frontend/src/features/pmflow-os/pages/ReleaseGrowthPage.tsx
docs/PMFLOW_PRODUCT_DELIVERY_STANDARD.md
docs/architecture/CODE_REFERENCE_INDEX.md
docs/architecture/ARCHITECTURE_INVENTORY.md

验证：

PYTHONPATH=backend /opt/homebrew/bin/python3.11 -m py_compile backend/app/api/pmflow_os_api/__init__.py backend/app/services/pmflow_os_projection_service.py backend/app/schemas/pmflow_os.py 通过。
PYTHONPATH=backend /opt/homebrew/bin/python3.11 -m pytest backend/tests/test_pmflow_os_projection_api.py -q 通过：17 passed；仍有既有 backend/app/schemas/recipe.py Pydantic V2 class-based config deprecation warning。
cd frontend && npm run test -- src/features/pmflow-os 通过：4 passed。
cd frontend && npm run typecheck 未通过：当时前端树缺失整组共享 src/lib/* 模块（例如 @/lib/api、@/lib/utils、@/lib/datetime、@/lib/display、@/lib/rbac），影响全仓大量既有文件和 forbidden router/index.tsx；本 Packet 未越界修复。
cd frontend && npm run build 同样停在上述共享 src/lib/* 缺失的 TypeScript 解析错误，未进入 Vite build。

未完成或风险：

本阶段只创建发布验证记录和人工确认快照，不执行部署命令、不写外部系统。
全量前端 typecheck/build 需由 Shell / Integration owner 在整合最新主线后重新验证。

2026-04-26 / account-p3-release-notification-consumption-contract / implemented

完成内容：

在 frontend/src/api/accountSettings.ts 新增 AccountReleaseNotificationEvent 与 getReleaseGateNotificationPreference(settings, event) 轻量合同。
Release/Growth 后续页面可按事件类型消费偏好：release_gate_blocked / release_gate_ready / release_validation_blocked / release_validation_needs_confirmation 映射到 releaseGate，failed_event 映射到 failureAlert。
helper 明确返回 inAppEnabled / desktopPreference / emailDigestPreference，以及 notificationKey / surface / reason，用于后续 Main Flow 页面决定页面内提醒展示或静默。
本轮只做 Account Settings API/helper 与测试，不改 ReleaseGrowthPage、PMFlow OS store、router、auth core，不新增后端字段，不接入真实邮件/桌面推送。

涉及文件：

frontend/src/api/accountSettings.ts
frontend/src/features/account-settings/accountSettings.test.ts
docs/architecture/CODE_REFERENCE_INDEX.md
docs/architecture/ARCHITECTURE_INVENTORY.md
docs/PMFLOW_PRODUCT_DELIVERY_STANDARD.md

验证：

cd frontend && npm run test -- src/features/account-settings/accountSettings.test.ts 通过：9 passed。
cd frontend && npm run typecheck 通过。
cd frontend && npm run build 通过；Vite 仍提示既有 manual chunk circular warning，但构建成功。

未完成或风险：

Main Flow 尚未在 ReleaseGrowthPage 消费该 helper；后续应由 Main Flow lane 读取账号设置后按 release gate / release validation / failed event 类型调用。
desktopPreference / emailDigestPreference 仍只是偏好记录，不代表真实系统级桌面通知、邮件通知或通知中心已接入。

2026-04-26 / space-p3-validation-run-attention / implemented

完成内容：

在 frontend/src/api/space.ts 将 releaseAttention 从单纯 release gate 关注升级为 truth-state.releases 发布验证投影 + execution-summary.releaseGate 的只读聚合。
/space 桌面端和移动端“发布关注”区块现在优先显示“发布验证阻塞 / 发布验证待确认”；没有发布验证投影时才回落显示“发布候选 / 发布门禁阻塞”。
发布关注项只展示来源标签、验证/门禁状态、检查项摘要、阻塞原因和更新时间；点击只跳转 /release-growth?projectId=<id>。
发布验证缺失时显示“暂无发布验证记录”空态，不使用 mock 或默认成功结果冒充真实验证。
本轮不创建 validation run、不写 ProgressEvent、不写 ReleaseValidationRun、不新增后端接口、不执行发布命令。

涉及文件：

frontend/src/api/space.ts
frontend/src/features/personal-space/PersonalSpacePage.tsx
frontend/src/features/personal-space/PersonalSpacePage.test.tsx
docs/architecture/CODE_REFERENCE_INDEX.md
docs/architecture/ARCHITECTURE_INVENTORY.md
docs/PMFLOW_PRODUCT_DELIVERY_STANDARD.md

验证：

cd frontend && npm run test -- src/features/personal-space/PersonalSpacePage.test.tsx 通过：2 passed；仍有既有 React Router v7 future flag warning。
cd frontend && npm run typecheck 通过。
cd frontend && npm run build 通过；Vite 仍提示既有 manual chunk circular warning，但构建成功。

未完成或风险：

Space P3 只消费 release validation 投影，不负责创建/更新 release validation run；真实运行记录仍由 Release/Growth lane 维护。
当前 Space 侧使用 truth-state.releases 的状态和 gateItems 表达验证结果；若后续 PMFlow OS 暴露独立 validationRuns 合同，需要由 Space lane 再切换到更精确字段。

2026-04-26 / big-module-integration-p3 / done

完成内容：

收口 Release/Growth P1、Space P2 与 Account P2 的并行成果，确认三条 lane 均已形成独立提交后再进入集成验证。
Release/Growth P1 已形成 e90adbc feat(pmflow-os): gate releases on execution evidence，将 execution-summary.releaseGate 接入 ReleaseGrowthPage，从 branch、commit、PR、test、failed evidence 推导 ready / blocked / needs_confirmation / empty 发布门禁状态。
Space P2 已形成 9ba9876 feat(space): surface release attention read model，只读消费 execution-summary.releaseGate 并在 /space 展示发布关注项，动作只跳 /release-growth?projectId=<id>。
Account P2 已形成 5a86007 feat(account): map notification preferences to surfaces，把通知偏好映射到待确认、Execution Bridge、Release/Growth 和失败提醒四类页面内提醒消费模型，不接入真实邮件/桌面推送。
本轮未修改 router、MobileBottomNav 或 PMFlow OS frame；现有 /release-growth、/space、/me 入口已足够承接本批成果。
同步 CLAUDE.md、CODE_REFERENCE_INDEX.md、ARCHITECTURE_INVENTORY.md 与本交付台账，确认 Main Flow 产出发布门禁判断、Space 只读聚合、Account 只影响本地 UI 提醒消费。

涉及文件：

CLAUDE.md
docs/PMFLOW_PRODUCT_DELIVERY_STANDARD.md
docs/architecture/CODE_REFERENCE_INDEX.md
docs/architecture/ARCHITECTURE_INVENTORY.md

验证：

PYTHONPATH=backend /opt/homebrew/bin/python3.11 -m pytest backend/tests/test_pmflow_os_projection_api.py backend/tests/test_account_settings_api.py -q 通过。
cd frontend && npm run test -- src/features/pmflow-os 通过。
cd frontend && npm run test -- src/features/personal-space/PersonalSpacePage.test.tsx 通过。
cd frontend && npm run test -- src/features/account-settings/accountSettings.test.ts 通过。
cd frontend && npm run typecheck 通过。
cd frontend && npm run build 通过；Vite 仍提示既有 manual chunk circular warning，但构建成功。

未完成或风险：

Release/Growth P1 仍只做发布门禁判断，不执行真实部署、不写 release validation run。
Space 暂存想法真实只读聚合后端合同仍未实现。
Account P2 只控制页面内提醒消费模型，不代表系统级桌面通知、邮件通知或通知中心已接入。
本轮未执行热部署/重启；当前环境是本地开发工作区。部署环境要生效，需要按实际栈执行 backend restart/reload。

下一步建议：

进入 release-validation-p1-real-run-records：把当前 release gate 判断推进为真实 release validation run 记录，保留“不执行真实部署”的边界，先沉淀发布前证据链和人工确认结果。

2026-04-26 / release-growth-p1-execution-evidence-gate / implemented

完成内容：

在 ExecutionSummaryProjection 中新增 releaseGate 投影，从 ProgressEvent 的 branch、commit、PR、test、failed / blocked 证据推导发布判断。
releaseGate.status 覆盖 ready / blocked / needs_confirmation / empty：测试通过可进入发布候选，failed / test_failed / blocked 事件 fail-closed 阻塞发布，无 execution evidence 时返回明确 empty/warning。
扩展 execution progress event 合同，允许显式 failed event 回写。
ReleaseGrowthPage 真实模式改为只消费 execution-summary.releaseGate、execution evidence、阻塞原因、下一步动作和 warning；不再展示静态“已发布/增长指标”mock 结果。
静态高保真发布/增长原型只保留在显式 ?demo=1 / dataSource=demo 模式。
本轮不执行发布命令、不做真实部署、不新增 migration。

涉及文件：

backend/app/schemas/pmflow_os.py
backend/app/services/pmflow_os_projection_service.py
backend/tests/test_pmflow_os_projection_api.py
frontend/src/api/pmflowOs.ts
frontend/src/features/pmflow-os/pages/ReleaseGrowthPage.tsx
frontend/src/features/pmflow-os/pages/ExecutionBridgePage.tsx
frontend/src/features/pmflow-os/store.api.test.tsx
docs/architecture/CODE_REFERENCE_INDEX.md
docs/architecture/ARCHITECTURE_INVENTORY.md
docs/PMFLOW_PRODUCT_DELIVERY_STANDARD.md

验证：

PYTHONPATH=backend /opt/homebrew/bin/python3.11 -m py_compile backend/app/api/pmflow_os_api/__init__.py backend/app/services/pmflow_os_projection_service.py backend/app/schemas/pmflow_os.py 通过。
PYTHONPATH=backend /opt/homebrew/bin/python3.11 -m pytest backend/tests/test_pmflow_os_projection_api.py -q 通过：14 passed；仍有既有 backend/app/schemas/recipe.py Pydantic V2 class-based config deprecation warning。
cd frontend && npm run test -- src/features/pmflow-os 通过：4 passed。
cd frontend && npm run typecheck 通过。
cd frontend && npm run build 通过；Vite 仍提示既有 manual chunk circular warning，但构建成功。

未完成或风险：

ReleaseGrowth P1 只生成发布判断和下一步动作，不触发真实部署、不写 release validation run。
增长反馈、收入、ROI 和 compliance 的真实发布后反馈循环仍待后续 Packet 接入。

2026-04-26 / space-p2-release-attention-readmodel / implemented

完成内容：

在 frontend/src/api/space.ts 新增 releaseAttention 只读聚合，从已有项目摘要、truth-state 与 execution-summary.releaseGate 派生个人空间发布关注项。
/space 桌面端和移动端新增“发布关注”区块，显示测试失败、PR 未合并、发布门禁阻塞、发布候选或需要人工确认的项目。
发布关注项只展示 release gate 状态、阻塞原因、证据标签和更新时间；点击只跳转 /release-growth?projectId=<id>。
本轮不写 Project Memory、不写 ChangeSet、不写 ProgressEvent、不新增后端接口、不执行发布命令。
暂存想法仍保持真实 empty/warning，不使用 mock 冒充。

涉及文件：

frontend/src/api/space.ts
frontend/src/features/personal-space/PersonalSpacePage.tsx
frontend/src/features/personal-space/PersonalSpacePage.test.tsx
docs/architecture/CODE_REFERENCE_INDEX.md
docs/architecture/ARCHITECTURE_INVENTORY.md
docs/PMFLOW_PRODUCT_DELIVERY_STANDARD.md

验证：

cd frontend && npm run test -- src/features/personal-space/PersonalSpacePage.test.tsx 通过：2 passed；仍有既有 React Router v7 future flag warning。
cd frontend && npm run typecheck 通过。
cd frontend && npm run build 通过；Vite 仍提示既有 manual chunk circular warning，但构建成功。

未完成或风险：

Space P2 依赖 Main Flow release-growth-p1-execution-evidence-gate 的 execution-summary.releaseGate 合同；最终合并需确保该合同先进入 integration base。
本轮只做个人空间 read model，不做发布验证运行、真实部署、增长反馈或发布后指标聚合。

2026-04-26 / big-module-integration-p2 / done

完成内容：

收口 Main Flow D.3、Space P1 与 Account P1 的并行成果，并将 Space / Account lane 代码先分别形成独立 commit，避免 forbidden lane 文件混入 integration commit。
Main Flow D.3 已形成 a7008bb feat(pmflow-os): add execution progress writeback，负责把 branch、commit、PR、test progress event 回写到 execution-summary。
Space P1 已形成 6c0f6da feat(space): route workbench execution items，执行中 / AI 正在推进项只跳转 /execution-bridge?projectId=<id>，不写 execution event。
Account P1 已形成 95892d2 feat(account): add account settings sync contract，新增 account_settings_api、schema、service 与测试，不改 OAuth/JWT/auth core。
Shell / Integration 串行补上 backend/app/api/router.py 的 account_settings_api 核心路由挂载，避免前端 /api/account-settings/me 在真实环境 404。
同步 CODE_REFERENCE_INDEX.md、ARCHITECTURE_INVENTORY.md 与本交付台账，确认 Space 只读、Account 独立偏好合同、Main Flow 执行回写三条边界。

涉及文件：

backend/app/api/router.py
docs/PMFLOW_PRODUCT_DELIVERY_STANDARD.md
docs/architecture/CODE_REFERENCE_INDEX.md
docs/architecture/ARCHITECTURE_INVENTORY.md

验证：

PYTHONPATH=backend /opt/homebrew/bin/python3.11 -m py_compile backend/app/api/router.py backend/app/api/account_settings_api/__init__.py backend/app/schemas/account_settings.py backend/app/services/account_settings_service.py 通过。
PYTHONPATH=backend /opt/homebrew/bin/python3.11 -m pytest backend/tests/test_account_settings_api.py -q 通过：4 passed；仍有既有 backend/app/schemas/recipe.py Pydantic V2 class-based config deprecation warning。
cd frontend && npm run test -- src/features/pmflow-os 通过。
cd frontend && npm run test -- src/features/personal-space/PersonalSpacePage.test.tsx 通过：2 passed；仍有既有 React Router future flag warning。
cd frontend && npm run test -- src/features/account-settings/accountSettings.test.ts 通过：5 passed。
cd frontend && npm run typecheck 通过。
cd frontend && npm run build 通过；Vite 仍提示既有 manual chunk circular warning，但构建成功。

未完成或风险：

本轮未执行热部署/重启；当前环境是本地开发工作区。部署环境要生效，需要按实际栈执行 backend restart/reload。
Account P1 当前复用 integrations 表保存偏好包，后续如要独立偏好表，必须另开 migration Packet。
Space 暂存想法真实只读聚合后端合同仍未实现，当前仍明确展示 empty/warning。

下一步建议：

Release/Growth P1 已由 e90adbc feat(pmflow-os): gate releases on execution evidence 完成，后续应进入真实 release validation run 记录。

2026-04-26 / space-p1-real-workbench-dashboard / implemented

完成内容：

将 /space 继续收敛为真实个人工作台 read model：继续推进、待确认、执行中、最近项目、草案、暂存想法均来自 frontend/src/api/space.ts 的只读聚合，不写主流程状态。
继续推进项目卡片主动作保持 /pmflow-os?projectId=<id>；待确认项保持 /change-review?projectId=<id>&changeSetId=<id>；执行中 / AI 正在推进项改为 /execution-bridge?projectId=<id>。
执行中仍只消费 PMFlow OS execution-summary、recentProgressEvents、activeDevTasks 与 loopStage 摘要，不直接写 execution event 或触发执行动作。
暂存想法后端合同仍未接入，继续返回空数组并展示明确 warning，不使用 mock/demo 数据冒充真实状态。
补充 Space focused 测试，锁定六个工作台区块和三类主流程导航 URL。

涉及文件：

frontend/src/api/space.ts
frontend/src/features/personal-space/PersonalSpacePage.tsx
frontend/src/features/personal-space/PersonalSpacePage.test.tsx
docs/architecture/CODE_REFERENCE_INDEX.md
docs/architecture/ARCHITECTURE_INVENTORY.md
docs/PMFLOW_PRODUCT_DELIVERY_STANDARD.md

验证：

cd frontend && npm run test -- src/features/personal-space/PersonalSpacePage.test.tsx 通过。
cd frontend && npm run typecheck 通过。
cd frontend && npm run build 通过；Vite 仍提示既有 manual chunk circular warning，但构建成功。

剩余缺口：

暂存想法真实只读聚合后端合同尚未实现；当前 Space 明确暴露为空态和 warning，不使用演示数据兜底。

2026-04-26 / main-flow-p1-execution-handoff-consume / done

完成内容：

在 D.2 的 handoff_created 起点上继续补齐执行交接消费闭环，新增 POST /pmflow-os/projects/{project_id}/execution-handoffs/{prompt_package_id}/consume。
后端校验项目成员权限、项目边界与 PromptPackage(package_kind='execution_handoff') 边界；消费动作只记录运行端领取，不执行本机命令、不写宿主机配置。
PMFlowOSProjectionService.consume_execution_handoff 将 PromptPackage.package_payload.latest_handoff 更新为 handoff_state=consumed，并写入 ProgressEvent(event_type='handoff_consumed', derived_task_status='coding')。
execution-summary 会因最新 handoff_consumed 事件把执行状态投影为 coding，前端执行桥可显示“运行端领取确认”。
前端 ExecutionBridgePage 在真实模式新增“标记为已领取”动作，调用 consumePMFlowExecutionHandoff 后 refetch truth-state / execution-summary；demo 模式仍只走本地演示推进。
修复 D.2 中 active PromptPackage.package_payload 嵌套 JSONB 更新可能未被 SQLAlchemy 标脏的问题，显式使用 flag_modified。

涉及文件：

backend/app/api/pmflow_os_api/__init__.py
backend/app/services/pmflow_os_projection_service.py
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/store.api.test.tsx
frontend/src/features/pmflow-os/pages/ExecutionBridgePage.tsx
CLAUDE.md
docs/architecture/CODE_REFERENCE_INDEX.md
docs/architecture/ARCHITECTURE_INVENTORY.md
docs/PMFLOW_PRODUCT_DELIVERY_STANDARD.md

验证：

PYTHONPATH=backend /opt/homebrew/bin/python3.11 -m py_compile backend/app/api/pmflow_os_api/__init__.py backend/app/services/pmflow_os_projection_service.py backend/app/schemas/pmflow_os.py 通过。
PYTHONPATH=backend /opt/homebrew/bin/python3.11 -m pytest backend/tests/test_pmflow_os_projection_api.py -q 通过：10 passed；仍有既有 backend/app/schemas/recipe.py Pydantic V2 class-based config deprecation warning。
cd frontend && npm run test -- src/features/pmflow-os/store.api.test.tsx 通过：3 passed。
cd frontend && npm run test -- src/features/pmflow-os 通过：4 passed。
cd frontend && npm run typecheck 通过。
cd frontend && npm run build 通过。

未完成或风险：

本轮仍不执行真实命令；Codex / Local Bridge / GitHub agent 的 branch、commit、PR、test 回写仍属于下一步 D.3。
本轮新增后端运行时代码但未执行热部署/重启；当前环境是本地开发工作区，未连接实际部署服务。部署环境需要按实际栈执行 backend restart/reload。

下一步建议：

进入 D.3：补 Dev Sync 写回闭环，把运行端执行结果回写为 branch/commit/PR/test progress event，并投影回 execution-summary / truth-state。

2026-04-26 / big-module-integration-p1 / done

完成内容：

作为 Shell / Integration owner 收口 Batch P1 三条 lane：Main Flow D.2、Space V1 Workbench Hardening、Account Settings V1。
已确认当前分支为 codex/main-flow-phase-d2-execution-handoff-contract，Main Flow D.2 已落提交 f95bd15 feat(pmflow-os): add execution handoff contract，本轮不重写 D.2，只验证其与 Space / Account dirty worktree 的组合。
已检查 tracked diff 与 untracked files，当前脏文件均落在本次集成范围：AGENTS.md / CLAUDE.md / TASK_BRIEF_TEMPLATE.md / ARCHITECTURE_INVENTORY.md / personal-space / account-settings / accountSettings.ts / space.ts / AccountPage.tsx。
Space 改动符合 P0 边界：frontend/src/api/space.ts 只读聚合项目摘要、PMFlow OS truth-state / execution-summary，待确认项只跳转 /change-review，不直接写 Project Memory、ChangeSet 状态或 Execution Bridge event。
Account Settings 改动符合 P0 边界：/me 由 AccountSettingsPanel 承接个人资料、AI 偏好和通知偏好；当时首版只做浏览器本机持久化，不改 OAuth/JWT/auth core、router、MobileBottomNav、PMFlow OS store 或项目主链，后续已由 account-p1-preferences-backend-contract 补后端同步合同。
P0 文档残留已收口：AGENTS.md / CLAUDE.md / TASK_BRIEF_TEMPLATE.md 的大模块 lane、integration owner、共享文件锁与 Packet 模板规则可纳入 integration commit；ARCHITECTURE_INVENTORY.md 修正旧的 Space 只能消费 mock data / 禁止接后端描述，改为当前只读聚合合同。
CODE_REFERENCE_INDEX.md 已确认包含 Space API、Account Settings API、PMFlow OS D.2 execution handoff API 索引；CLAUDE.md 已确认不再保留旧的“commit 未实现”描述。

涉及文件：

AGENTS.md
CLAUDE.md
docs/PMFLOW_PRODUCT_DELIVERY_STANDARD.md
docs/architecture/ARCHITECTURE_INVENTORY.md
docs/architecture/TASK_BRIEF_TEMPLATE.md
frontend/src/api/space.ts
frontend/src/api/accountSettings.ts
frontend/src/features/personal-space/PersonalSpacePage.tsx
frontend/src/features/personal-space/PersonalSpacePage.test.tsx
frontend/src/features/personal-space/components/SpaceChrome.tsx
frontend/src/features/account-settings/AccountSettingsPanel.tsx
frontend/src/features/account-settings/accountSettings.test.ts
frontend/src/features/pmflow-os/pages/AccountPage.tsx

验证：

cd frontend && npm run test -- src/features/personal-space/PersonalSpacePage.test.tsx 通过：1 passed。
cd frontend && npm run test -- src/features/account-settings/accountSettings.test.ts 通过：3 passed。
cd frontend && npm run test -- src/features/pmflow-os 通过：4 passed。
cd frontend && npm run typecheck 通过。
cd frontend && npm run build 通过；Vite 仍输出既有 manual chunk circular warning（ai-steward / sstc / charts / governance），未阻断构建。
PYTHONPATH=backend /opt/homebrew/bin/python3.11 -m pytest backend/tests/test_pmflow_os_projection_api.py -q 通过：9 passed；仍有既有 backend/app/schemas/recipe.py Pydantic V2 class-based config deprecation warning。

未完成或风险：

本 integration packet 未新增或修改后端运行时代码、Schema 或 migration；本轮未执行热部署/重启。当前验证发生在本地开发工作区，未连接实际部署服务；若要让 Main Flow D.2 的后端提交在部署环境生效，需要在对应部署机执行 docker compose restart backend、scripts/docker_stack.sh restart|dev-restart 或等价发布流程。
Space 的 savedIdeas 后端只读聚合合同仍未实现；当前 UI 明确展示 empty/warning，不使用 mock 数据冒充真实内容。
Account Settings V1 当时仍是前端合同 + 本机持久化；后续已由 account-p1-preferences-backend-contract 独立新增 account_settings_api 合同，当前全局 router 挂载仍需 Shell / Integration owner 串行处理。

下一步建议：

进入 D.3：补 Dev Sync 写回闭环，把 Codex / Local Bridge / GitHub agent 的 branch、commit、PR、test progress event 回写到 execution-summary / truth-state。

2026-04-26 / Space V1 Workbench Hardening / implemented

完成内容：

将 /space 收敛为只读个人工作面聚合入口，继续覆盖 继续推进 / 待我确认 / AI 正在推进 / 暂存想法 / 草案箱 / 最近项目，不写 Project Memory、ChangeSet 状态或 Execution Bridge event。
frontend/src/api/space.ts 作为 Space read model wrapper，仅消费项目摘要、PMFlow OS truth-state 与 execution-summary；项目主动作仍进入 /pmflow-os?projectId=<id>。
待确认项只读取 ChangeSet / approvals 摘要，点击进入稳定主流程 /change-review?projectId=<id>&changeSetId=<id>，不直接执行 accept/edit/defer/commit。
暂存想法合同已显式建模为 savedIdeas；当前后端只读聚合未接入时返回空数组并展示 warning，禁止用 mock/demo 数据冒充真实想法。
移动端继续使用 Space 独立单手路径，补齐最近项目区块，不把桌面多栏布局压缩到手机。
补充 PersonalSpacePage.test.tsx focused 回归，锁定六个 Space 区块与“暂存想法未接入不冒充真实数据”的空态。

涉及文件：

frontend/src/api/space.ts
frontend/src/features/personal-space/PersonalSpacePage.tsx
frontend/src/features/personal-space/PersonalSpacePage.test.tsx
frontend/src/features/personal-space/components/SpaceChrome.tsx
docs/architecture/CODE_REFERENCE_INDEX.md
docs/architecture/ARCHITECTURE_INVENTORY.md
docs/PMFLOW_PRODUCT_DELIVERY_STANDARD.md

验证：

cd frontend && npm run test -- src/features/personal-space/PersonalSpacePage.test.tsx 通过。
cd frontend && npm run typecheck 未通过，阻塞来自 Main Flow 越界文件 frontend/src/features/pmflow-os/pages/ExecutionBridgePage.tsx:21 的既有 import type 语法错误，本 Space 包不跨线修。
cd frontend && npm run build 未通过，同样阻塞于 frontend/src/features/pmflow-os/pages/ExecutionBridgePage.tsx:21，未进入 Vite build 阶段。

剩余缺口：

暂存想法真实只读聚合后端合同尚未实现；当前 Space 明确暴露为空态和 warning，不使用演示数据兜底。

2026-04-26 / Account P2 Notification Preference Consumption / implemented

完成内容：

frontend/src/api/accountSettings.ts 新增通知偏好消费模型，将 pendingConfirmation / executionWriteback / releaseGate / failureAlert 映射到 待确认中心 / Execution Bridge / Release Growth / 全局失败提醒 四类页面内提醒。
新增 shouldShowAccountNotification 与 getAccountNotificationConsumption，用于本地 UI 判断页面提醒显示或静默；不接入真实邮件、桌面推送或系统级通知中心。
修正通知偏好合并逻辑：旧本机缓存或后端返回缺字段时，按默认偏好逐项补齐，避免浅合并导致 desktop/emailDigest 丢失。
AccountSettingsPanel 在通知偏好区域展示“页面内提醒消费说明”，明确哪些开关会影响待确认、执行回写、发布门禁和失败提醒，也明确桌面/邮件仅记录偏好、不代表系统级推送已接入。
测试覆盖通知偏好读取、保存、消费模型和 fallback。

涉及文件：

frontend/src/api/accountSettings.ts
frontend/src/features/account-settings/AccountSettingsPanel.tsx
frontend/src/features/account-settings/accountSettings.test.ts
docs/architecture/ARCHITECTURE_INVENTORY.md
docs/architecture/CODE_REFERENCE_INDEX.md
docs/PMFLOW_PRODUCT_DELIVERY_STANDARD.md

验证：

cd frontend && npm run test -- src/features/account-settings/accountSettings.test.ts 通过：7 passed。
cd frontend && npm run typecheck 通过。
cd frontend && npm run build 通过；Vite 仍输出既有 manual chunk circular warning，未阻断构建。

未完成或风险：

本轮只在 Account Settings 合同和本地 UI 消费层落地通知偏好，不修改 PMFlow OS truth store、router、JWT/OAuth/auth core，也不新增后端表。
由于本包 write scope 不包含 ExecutionBridgePage / ReleaseGrowthPage / ChangeReviewPage，本轮没有跨页直接接入这些页面；后续如要让各页面读取该 helper，应单独开对应 Main Flow/Integration packet。

2026-04-26 / Account P1 Preferences Backend Contract / implemented

完成内容：

新增 backend/app/api/account_settings_api/，建立 GET /account-settings/me 与 PUT /account-settings/me 合同，统一返回 {code,message,data}。
新增 backend/app/schemas/account_settings.py，锁定个人资料、默认语言、AI 回答深度、证据显示偏好、待确认/执行回写/发布门禁/失败提醒通知偏好合同。
新增 backend/app/services/account_settings_service.py，当前复用既有 integrations 表以 account_settings_preferences 类型按 tenant_id + user_id 持久化账号偏好；未新增表，因此未触发 Alembic migration。
frontend/src/api/accountSettings.ts 改为有 token 时优先账号同步；后端不可用或未登录时明确回落本机暂存。
Shell / Integration 已将 account_settings_api 挂入 backend/app/api/router.py 的核心路由组，真实环境可通过 /api/account-settings/me 访问。
/me 保存状态继续区分 已保存到当前账号 / 仅本机暂存 / 保存失败，不假装云端成功。
本 Packet 不改 OAuth/JWT/auth core，不改 /settings route，不改 PMFlow OS store，不做组织权限、账单、安全中心、设备管理或团队空间。

涉及文件：

frontend/src/api/accountSettings.ts
frontend/src/features/account-settings/AccountSettingsPanel.tsx
frontend/src/features/account-settings/accountSettings.test.ts
backend/app/api/router.py
backend/app/api/account_settings_api/__init__.py
backend/app/schemas/account_settings.py
backend/app/services/account_settings_service.py
backend/tests/test_account_settings_api.py
docs/architecture/ARCHITECTURE_INVENTORY.md
docs/architecture/CODE_REFERENCE_INDEX.md
docs/PMFLOW_PRODUCT_DELIVERY_STANDARD.md

验证：

cd backend && /Users/guojing/.cache/codex-runtimes/codex-primary-runtime/dependencies/python/bin/python3 -m pytest tests/test_account_settings_api.py 通过：4 passed。
cd frontend && npm run test -- src/features/account-settings/accountSettings.test.ts 通过：5 passed。

未完成或风险：

本轮已由 Shell / Integration owner 串行 include account_settings_api；后续新增账号设置子能力仍不得塞入 OAuth/JWT/auth core。
当前复用 integrations 表承接 P1 合同，避免越界新增 model/migration；后续如果需要独立偏好表，再开 migration Packet。

2026-04-26 / Account Settings V1 / implemented

完成内容：

新增 frontend/src/api/accountSettings.ts，定义个人资料、默认语言、AI 回答深度、证据展示偏好和通知偏好前端合同；首版用浏览器本地持久化承接设置保存，不写 PMFlow OS truth store。
新增 frontend/src/features/account-settings/AccountSettingsPanel.tsx，承接 /me 桌面设置页与移动端分组列表 + bottom sheet。
将 /me 的 AccountPage.tsx 改为薄入口，继续复用 AccountControls.tsx 的退出登录 bottom sheet，不改 router、MobileBottomNav、PMFlow OS store 或 OAuth/JWT/auth core。
通知偏好已覆盖 待确认 / 执行回写 / 发布门禁 / 失败提醒，每类支持总开关、桌面提醒和邮件摘要。
保存状态已收口为 仅本机暂存 / 已保存到当前账号 / 保存失败 三态；当前 V1 只做本机暂存，不假装云端账号保存。
补充 frontend/src/features/account-settings/accountSettings.test.ts，锁定默认设置和持久化行为。

涉及文件：

frontend/src/api/accountSettings.ts
frontend/src/features/account-settings/AccountSettingsPanel.tsx
frontend/src/features/account-settings/accountSettings.test.ts
frontend/src/features/pmflow-os/pages/AccountPage.tsx
CLAUDE.md
docs/architecture/ARCHITECTURE_INVENTORY.md
docs/architecture/CODE_REFERENCE_INDEX.md
docs/PMFLOW_PRODUCT_DELIVERY_STANDARD.md

验证：

npm run test -- src/features/account-settings/accountSettings.test.ts 通过：3 passed。
npm run typecheck 通过。
npm run build 通过；Vite 仍输出既有 manual chunk circular warning，未阻断构建。
Playwright 本地浏览器检查通过：http://localhost:5186/me 桌面与 390px 移动视口均可渲染，移动端通知偏好 bottom sheet 可打开。

未完成或风险：

Account Settings V1 当时是前端合同 + 本地持久化；后续已由 account-p1-preferences-backend-contract 独立新增 backend/app/api/account_settings_api/ 同步合同，仍不能塞入 auth core 或 PMFlow OS truth store。

2026-04-26 / P0 Shell Module Boundaries / done

完成内容：

核对当前公共壳真实落点：frontend/src/router/index.tsx、frontend/src/main.tsx、MobileBottomNav.tsx、PMFlowOsFrame.tsx。
冻结大模块 route 归属：/space 归 Space，/project-launch 作为启动层入口，/pmflow-os / /command-center / /change-review / /execution-bridge / /release-growth 归 Main Flow，/me 归 Account Settings。
明确 /settings 当前未实现，仅作为 Account Settings reserved route；后续如需新增，必须由 Shell / Integration owner 串行处理。
冻结全局 provider 归属：QueryClientProvider -> PMFlowOsProvider -> ToastProvider -> RouterProvider，Space / Account 不得直接改 PMFlow OS store 内部 mutation。
冻结移动端底部导航归属：唯一实现为 MobileBottomNav.tsx，固定 空间 / 指挥台 / 待确认 / 动态 / 我的；其中 动态 仍是 /command-center 占位，后续要做 /activity 必须单独开 Shell Packet。
同步修正 ARCHITECTURE_INVENTORY.md 中 C1/C2 commit 的旧描述，明确 C2 backend/frontend commit 已完成。

涉及文件：

docs/PMFLOW_PRODUCT_DELIVERY_STANDARD.md
docs/architecture/CODE_REFERENCE_INDEX.md
docs/architecture/ARCHITECTURE_INVENTORY.md
CLAUDE.md

验证：

git diff --name-only 已确认本轮只改文档与约束文件，未改前端共享壳代码。
本轮未修改前端代码，因此未运行 npm run typecheck。

未完成或风险：

/settings 尚未实现；account-settings-v1 如需要该入口，必须先把 route 需求交给 Shell / Integration owner。
动态 底部导航仍指向 /command-center，后续如做动态页需独立 Packet。

下一步建议：

并行启动 main-flow-phase-d-execution、space-v1-workbench、account-settings-v1；三个 Packet 均不得改 router/nav/provider/shared docs，最终由 integration owner 收口。

2026-04-26 / Phase D.2 - Execution Handoff Contract / done

完成内容：

新增 POST /pmflow-os/projects/{project_id}/execution-handoffs 后端入口，复用 PMFlow OS 项目成员/OWNER/REVIEWER 权限边界。
PMFlowOSProjectionService.create_execution_handoff 校验 task/project/tenant 边界，校验可选 active repo binding；无 repo 时允许创建 handoff draft 并保留 repo warning。
对任务复用 active PromptPackage；没有 active package 时，从真实 Project / Task / Project Memory / RepoBinding 生成 deterministic PromptPackage(package_kind='execution_handoff')，不使用 demo 文案。
创建 ProgressEvent(event_type='handoff_created', source='pmflow_os') 作为执行起点，payload 记录 runtime_target / prompt_package_id / repo_binding_id / boundary。
前端 ExecutionBridgePage 在真实模式展示“发起执行交接”按钮，调用 createPMFlowExecutionHandoff 后 refetch truth-state / execution-summary；demo 模式仍只走本地推进。
无 active task、无 repo、无 prompt package 时继续显示明确 empty/warning 和下一步，不回退假数据。

涉及文件：

backend/app/api/pmflow_os_api/__init__.py
backend/app/services/pmflow_os_projection_service.py
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/store.api.test.tsx
frontend/src/features/pmflow-os/pages/ExecutionBridgePage.tsx
frontend/src/features/pmflow-os/components/ExecutionBridgeCards.tsx
docs/architecture/PMFLOW_OS_PRODUCT_CONTRACT.md
docs/architecture/CODE_REFERENCE_INDEX.md
docs/architecture/ARCHITECTURE_INVENTORY.md
docs/PMFLOW_PRODUCT_DELIVERY_STANDARD.md

验证：

PYTHONPATH=backend /opt/homebrew/bin/python3.11 -m py_compile backend/app/api/pmflow_os_api/__init__.py backend/app/services/pmflow_os_projection_service.py backend/app/schemas/pmflow_os.py 通过。
PYTHONPATH=backend /opt/homebrew/bin/python3.11 -m pytest backend/tests/test_pmflow_os_projection_api.py -q 通过：9 passed。
cd frontend && npm run test -- src/features/pmflow-os 通过。
cd frontend && npm run typecheck 通过。
cd frontend && npm run build 通过；Vite 仍输出既有 manual chunk circular warning，未阻断构建。

未完成或风险：

D.2 只创建 handoff 合同、PromptPackage 与 progress event 起点，不直接执行本机命令；真实命令执行仍必须通过 Local Bridge、Codex、GitHub agent 或兼容 MCP host。
当前未新增 migration，沿用既有 PromptPackage / RepoBinding / ProgressEvent。

下一步建议：

进入 D.3：补 Dev Sync 写回闭环，把 Codex/Local Bridge/GitHub agent 的执行结果回写为 branch/commit/PR/test progress event，并把任务状态/证据链投影回 truth-state。

2026-04-26 / Big Module Parallel Governance / done

完成内容：

将大模块并行治理写入产品推进标准：允许 Main Flow / Space / Account Settings 作为长期模块 lane 并行，但实际执行仍必须拆成带 write_scope 的短生命周期 Packet。
明确 Shell / Integration owner 负责共享路由、导航、Provider、共享 API base、共享文档和合并顺序。
定义当前四条 lane：Shell / Integration、Main Flow / PMFlow OS 主流程、Space / 个人空间入口、Account Settings / 个人中心与设置。
明确每条 lane 的默认写范围、默认禁止范围和跨模块交互边界。
更新下一批推荐任务：先执行 P0-shell-module-boundaries，再并行推进 main-flow-phase-d-execution / space-v1-workbench / account-settings-v1，最后由 integration owner 收口。

涉及文件：

docs/PMFLOW_PRODUCT_DELIVERY_STANDARD.md
docs/architecture/TASK_BRIEF_TEMPLATE.md
AGENTS.md
CLAUDE.md

验证：

文档静态检查完成；本轮只更新治理文档和任务模板，未改代码、API、Schema 或 migration，未运行编译/单测。

未完成或风险：

该记录是大模块治理规则落盘；具体公共壳真实路由和 provider 核对已由后续 P0 Shell Module Boundaries 完成。

下一步建议：

后续按 P0 冻结结果同时分派 main-flow-phase-d-execution、space-v1-workbench、account-settings-v1 三个大模块 Packet。

2026-04-26 / Phase C2 Frontend - ChangeSet Commit Wiring / done

完成内容：

在 frontend/src/api/pmflowOs.ts 增加 commitPMFlowChangeSet，调用 POST /pmflow-os/change-sets/{change_set_id}/commit，默认 mode=atomic。
扩展 PMFlow OS 前端类型，允许后端投影返回 ChangeSet.status=committed/partially_committed 与 ChangeItem.status=committed/skipped。
将 PMFlowOsProvider.promoteAcceptedToGraph 的真实模式接到后端 commit API，commit 后 refetch truth-state；demo 模式继续使用本地 mutation。
将 ChangeReviewPage 的真实模式主按钮从“下一阶段开放”改为“确认写入项目记忆”，不再用前端本地状态冒充正式写入。
补充 API 模式 store 测试，确认 promoteAcceptedToGraph("11") 会调用 commitPMFlowChangeSet("11", { mode: "atomic", ... })，且不会本地写入 requirements。

涉及文件：

frontend/src/api/pmflowOs.ts
frontend/src/features/pmflow-os/types.ts
frontend/src/features/pmflow-os/store.tsx
frontend/src/features/pmflow-os/store.api.test.tsx
frontend/src/features/pmflow-os/pages/ChangeReviewPage.tsx
frontend/src/features/pmflow-os/components/ProjectStructuredLoop.tsx
frontend/src/features/pmflow-os/components/chrome.tsx
docs/architecture/PMFLOW_OS_PRODUCT_CONTRACT.md
docs/architecture/CODE_REFERENCE_INDEX.md
docs/PMFLOW_PRODUCT_DELIVERY_STANDARD.md

验证：

npm run test -- src/features/pmflow-os/store.api.test.tsx 通过：3 passed。
npm run test -- src/features/pmflow-os 通过：4 passed。
npm run typecheck 通过。
npm run build 通过；Vite 仍输出既有 manual chunk circular warning，未阻断构建。

未完成或风险：

前端真实 commit 依赖后端已完成审查状态；若仍存在 pending_review item，后端会按合同显式返回 changeset_not_reviewed。
Release / ModelDecision / MetricSignal commit 仍按 C2 合同暂缓或 fail-closed。
当前为本地开发工作区验证，未执行部署环境热重启。

下一步建议：

执行 Phase D：把 ExecutionBridgePage 切到 GET /pmflow-os/projects/{project_id}/execution-summary 与 dev-sync 真实数据，继续保留 demo fallback。

2026-04-26 / Phase C2 Backend - ChangeSet Atomic Commit / done

完成内容：

新增 POST /pmflow-os/change-sets/{change_set_id}/commit 后端入口，复用项目成员/OWNER/REVIEWER 权限边界，统一响应包络。
在 PMFlowChangeReviewService 实现 atomic commit：只处理 accepted / edited 项，默认提交全部 eligible items；存在未审项时阻断全量 commit；任一写入失败则回滚整个事务。
将 Requirement / Decision / Risk 写入 truth_nodes，将 Task 写入 truth_nodes(node_type='task') + tasks，并为 truth node/task 写入 semantic_facts seed。
补齐高风险 approval gate：risk_level=high 必须存在同 item 的 approved/edited approval 与 evidence，否则返回 409 high_risk_approval_required 且不写正式对象。
将 PMFlowChangeSet / PMFlowChangeItem 序列化扩展到 committed / partially_committed / skipped 状态，避免 commit 后投影被误映射为 deferred。
将 backend/app/api/__init__.py 改为轻量包入口，避免 focused API 测试导入单个模块时拉起 Feishu/MCP 等可选依赖。

涉及文件：

backend/app/api/__init__.py
backend/app/api/pmflow_os_api/__init__.py
backend/app/schemas/pmflow_os.py
backend/app/services/pmflow_change_review_service.py
backend/tests/test_pmflow_change_review_api.py
docs/architecture/PMFLOW_OS_PRODUCT_CONTRACT.md
docs/architecture/CODE_REFERENCE_INDEX.md
docs/PMFLOW_PRODUCT_DELIVERY_STANDARD.md

验证：

/opt/homebrew/bin/python3.11 -m py_compile backend/app/api/__init__.py backend/app/api/pmflow_os_api/__init__.py backend/app/services/pmflow_change_review_service.py backend/app/schemas/pmflow_os.py backend/tests/test_pmflow_change_review_api.py 通过。
/opt/homebrew/bin/python3.11 -m pytest tests/test_pmflow_change_review_api.py -q 通过：6 passed。
/opt/homebrew/bin/python3.11 -m pytest tests/test_pmflow_change_review_api.py tests/test_pmflow_os_projection_api.py tests/test_pmflow_launch_api.py -q 通过：18 passed。

未完成或风险：

C2 V1 暂不支持 ModelDecision / MetricSignal commit；按合同必须 fail-closed。
本地仍有未提交删除痕迹，未纳入本次提交。
当前为本地开发工作区验证，未执行部署环境热重启。

下一步建议：

已执行 C2-frontend；下一步进入 Phase D Execution Bridge 真实数据接入。

2026-04-26 / G0 Freeze + C2 Contract / done

完成内容：

将当前非删除工作区成果直接 checkpoint 到 master，形成 b52428f docs: codify PMFlow product delivery governance 与 e04ea4d chore: checkpoint current PMFlow workspace 两个提交；删除痕迹未提交，避免未确认地固化旧截图、表格、tunnel 脚本和临时文件删除。
收口 Phase C2 commit 合同：POST /pmflow-os/change-sets/{change_set_id}/commit 的请求体、权限、原子提交模式、响应结构、错误码、高风险 approval gate、C2 V1 objectType 白名单和 ProjectTruthState 投影规则。
明确 C2 V1 默认 mode=atomic，任一 eligible item 写入失败时整个 commit 回滚，禁止半写入 Project Memory。
明确 C2 必须实现 Requirement / Decision / Task / Risk；Release 可选；ModelDecision / MetricSignal 暂缓并必须 fail-closed。

涉及文件：

docs/architecture/PMFLOW_OS_PRODUCT_CONTRACT.md
docs/architecture/API_CONTRACTS.md
docs/PMFLOW_PRODUCT_DELIVERY_STANDARD.md

验证：

git status --short --branch 已确认 checkpoint 后仅剩未提交删除痕迹。
git diff --cached --name-status 阶段检查未发现删除项被纳入 checkpoint。
本轮 C2-contract 只改合同文档，未新增代码、Schema 或 migration，未运行编译/单测。

未完成或风险：

工作区仍有未提交删除痕迹，需用户单独确认是否删除或恢复。
C2 后端 route/service/schema 与前端 API/store 尚未实现。

下一步建议：

执行 C2-backend：实现 atomic ChangeSet commit service、route、权限、事务、高风险 gate 与后端测试。
合同稳定后并行执行 C2-frontend：接入 commit API，替换真实模式下的 demo-only promoteAcceptedToGraph。

2026-04-26 / Parallel Delivery Governance / done

完成内容：

新增 Codex 并行推进协议，明确并行单位必须是带 read_scope / write_scope / forbidden_paths / shared_files / base_ref / merge_after 的 Packet。
建立 V1 Productized Loop 默认并行 lane：Contract / Backend / Frontend / UI / Docs-Test，并固定合同、后端、前端、UI、文档集成的合并顺序。
将下一阶段 Phase C2 拆成 C2-contract / C2-backend / C2-frontend / C2-docs-verification 四个可分派 Packet，明确依赖和写范围。
新增分支、worktree、Packet commit 与 commit gate 协议：并行线程默认使用 codex/<packet_id> 分支、记录 base_ref、优先独立 worktree；Packet 完成后由 Codex 自行判定 auto_commit / hold_no_commit / ask_before_commit，通过验证后形成可审查 commit，新 Packet 从最新 integration base 或明确依赖分支重新开分支。
新增 Parallel Integration Gate，要求 integration owner 检查越界 diff、后端/前端/migration 验证、文档同步和热部署说明。

涉及文件：

docs/PMFLOW_PRODUCT_DELIVERY_STANDARD.md
docs/architecture/TASK_BRIEF_TEMPLATE.md
AGENTS.md
CLAUDE.md
docs/architecture/ARCHITECTURE_INVENTORY.md

验证：

文档静态检查通过：新增协议覆盖并行前置条件、Packet 模板、write scope / forbidden paths、共享文件锁、branch / worktree / base ref、Packet commit、commit gate、merge order、integration gate。
本轮只改治理文档，未新增代码、API、Schema 或 migration，未运行编译/单测。

未完成或风险：

当前仓库仍是大面积脏工作区；正式启动多线程并行前，需要先冻结当前改动归属，避免历史脏状态被误判为新冲突。

下一步建议：

以 C2-contract 作为第一条并行治理试点 Packet，先锁定 ChangeSet commit 合同，再分派后端和前端线程。

2026-04-25 / Phase A - PMFlow OS Product Contract / done

完成内容：

新增 PMFlow OS 产品合同，明确 ProjectTruthState / Thread / Message / ChangeSet / ChangeItem / Evidence / Approval / Requirement / Decision / Task / Risk / ModelDecision / TestRun / Release / MetricSignal / ExecutionContext / TeamFeed 的前后端映射。
明确复用边界：正式项目对象优先复用 truth_nodes / tasks / semantic_facts，AI 应用控制面复用 ai_project_control 与 SSTC model_control，执行桥复用 dev_sync / prompt_packages / progress_events。
明确建议新增但本轮不建表的 PMFlow OS 专属合同对象：pmflow_threads / pmflow_thread_messages / pmflow_change_sets / pmflow_change_items / pmflow_approvals / pmflow_evidence_links。
定义 PMFlow OS API 草案：truth-state / messages / extractions / change-set detail / accept / edit / defer / commit / execution-summary。
明确 accept/edit/defer 只改变审查状态，commit 才写入 truth_nodes / tasks / semantic_facts 等正式对象。

涉及文件：

docs/architecture/PMFLOW_OS_PRODUCT_CONTRACT.md
docs/architecture/CODE_REFERENCE_INDEX.md
docs/architecture/ARCHITECTURE_INVENTORY.md
CLAUDE.md
docs/PMFLOW_PRODUCT_DELIVERY_STANDARD.md

验证：

静态检查引用路径与核心对象完成。
本轮只改文档，未新增代码、API、Schema 或 migration，未运行编译/单测。

未完成或风险：

API 尚未实现，数据库 migration 尚未创建。
truth_nodes.node_type 的历史值需要在后续 projection 实现时做白名单映射。
ChangeSet / Approval / EvidenceLink / Thread 仍需后续实现真实表与服务。

下一步建议：

执行 A3 最小真实读路径：新增只读 pmflow_os_api projection，先实现 GET /pmflow-os/projects/{project_id}/truth-state 与 GET /pmflow-os/projects/{project_id}/execution-summary。

2026-04-25 / A3 - PMFlow OS 最小真实读路径 / done

完成内容：

新增只读后端入口 backend/app/api/pmflow_os_api/，注册 GET /pmflow-os/projects/{project_id}/truth-state 与 GET /pmflow-os/projects/{project_id}/execution-summary，统一返回 {code,message,data}。
新增 backend/app/services/pmflow_os_projection_service.py 与 backend/app/schemas/pmflow_os.py，把 ProjectTruthState 投影接到真实后端对象：Requirement / Decision / Risk / Release 来自 truth_nodes，Task 来自 tasks，Project Memory 来自 truth_nodes + semantic_facts，ExecutionContext 来自 dev-sync summary + prompt_packages + progress_events + repo/task code link。
Thread / ChangeSet / ChangeItem / Approval / EvidenceLink 本轮没有稳定表，不用 mock 冒充；接口返回空集合并通过 projectionWarnings 明确说明。
新增前端 API frontend/src/api/pmflowOs.ts，封装 getPMFlowTruthState(projectId) 与 getPMFlowExecutionSummary(projectId)。
frontend/src/features/pmflow-os/store.tsx 现支持 ?projectId=<id> 通过 React Query 读取真实 truth-state；只有显式 ?demo=1 或 ?dataSource=demo 才启用本地 mock 演示动作。真实 API 失败时显示错误/空态，不静默 fallback 成 mock 成功。
ProjectMemoryPage 在真实模式下展示后端 projectMemory.truthNodeFacts / semanticFacts，不再把前端 mock 当作项目记忆来源。

涉及文件：

backend/app/api/pmflow_os_api/__init__.py
backend/app/services/pmflow_os_projection_service.py
backend/app/schemas/pmflow_os.py
backend/app/api/router.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/components/PMFlowOsFrame.tsx
frontend/src/features/pmflow-os/pages/CommandCenterPage.tsx
frontend/src/features/pmflow-os/pages/ProjectMemoryPage.tsx
docs/architecture/CODE_REFERENCE_INDEX.md
docs/architecture/ARCHITECTURE_INVENTORY.md
docs/PMFLOW_PRODUCT_DELIVERY_STANDARD.md
CLAUDE.md

验证：

静态路径检查完成。
后端：python -m py_compile（Python 3.12 runtime）通过。
后端：pytest tests/test_pmflow_os_projection_api.py -q 通过，覆盖空项目 truth-state、Project Memory projection、tasks projection、execution-summary 空态、tenant/project 权限边界。
后端 router import smoke：from app.api.router import api_router 通过。
前端：npm run typecheck 通过。
前端：npm run build 通过。

剩余缺口：

本轮不新增 migration，因此 Thread / ChangeSet / ChangeItem / Approval / EvidenceLink 仍为空集合或 warning；后续 Phase C 再补真实表与 mutation。
WorkGraph / ExecutionBridge / ReleaseGrowth 仍有部分静态展示区，A3 只保证 truth store 与 Project Memory 真实读取入口，不做 UI 重画和完整页面数据替换。
后端代码已改，但当前是在本地开发工作区执行验证，未连接运行中的部署服务；热部署/重启需要在实际部署环境执行。

2026-04-25 / Phase B - Project Launch 真实创建链 / done

完成内容：

新增 Phase B 专用启动链表 migration backend/alembic/versions/20260425_add_pmflow_launch_tables.py，只创建 pmflow_launch_drafts / pmflow_threads / pmflow_thread_messages；本轮未创建 pmflow_change_sets / pmflow_change_items / pmflow_approvals / pmflow_evidence_links。
新增后端启动链入口 backend/app/api/pmflow_launch_api/，注册 POST /pmflow-launch/drafts 与 POST /pmflow-launch/drafts/{draft_id}/confirm，统一返回 {code,message,data}。
新增 backend/app/services/pmflow_launch_service.py 与 backend/app/schemas/pmflow_launch.py：草案生成调用 llm_service.generate_structured_object(function_name="pmflow_launch_draft_v1") 并显式传 routing_meta；结构化失败返回明确错误或 warnings，不用模板句冒充成功。
confirm 在同一事务内锁定草案并创建 Project / UserProject / PMFlowThread / PMFlowThreadMessage / truth_nodes / tasks / semantic_facts seed / OperationLog，随后更新草案 status=confirmed 与 confirmed_project_id；重复 confirm 幂等返回同一 project_id，不重复写正式对象。
truth_nodes.content 与任务 payload 写入 launch_draft_id / thread_id / thread_message_id / source=pmflow_launch_confirmed_draft / confidence / evidence，确保初始 Project Memory 与 Task 能追溯到启动草案和首条用户输入。
A3 truth-state projection 已更新为优先读取 pmflow_threads 默认启动线程与 pmflow_thread_messages，Project Memory 仍只来自 truth_nodes + semantic_facts，不从 launch draft 直接拼。
新增前端 API frontend/src/api/pmflowLaunch.ts，封装 createPMFlowLaunchDraft 与 confirmPMFlowLaunchDraft。
frontend/src/features/project-launch/useProjectLaunchState.ts 默认走真实 API；只有显式 ?demo=1 或 ?dataSource=demo 才启用本地演示状态机。draft/confirm 失败进入明确失败态，不静默跳 mock 成功态。
新增 /pmflow-os route alias，创建成功后使用后端返回的 /pmflow-os?projectId=<id> 进入 A3 真实读路径。

涉及文件：

backend/alembic/versions/20260425_add_pmflow_launch_tables.py
backend/app/models/pmflow_launch.py
backend/app/api/pmflow_launch_api/__init__.py
backend/app/services/pmflow_launch_service.py
backend/app/schemas/pmflow_launch.py
backend/app/services/pmflow_os_projection_service.py
backend/app/config/ai_prompts_catalog/part_scenes_06.py
backend/app/services/llm_service/shared_part_01.py
backend/tests/test_pmflow_launch_api.py
backend/tests/test_pmflow_os_projection_api.py
frontend/src/api/pmflowLaunch.ts
frontend/src/features/project-launch/useProjectLaunchState.ts
frontend/src/features/project-launch/useProjectLaunchState.test.ts
frontend/src/router/index.tsx
docs/architecture/CODE_REFERENCE_INDEX.md
docs/architecture/ARCHITECTURE_INVENTORY.md
docs/PMFLOW_PRODUCT_DELIVERY_STANDARD.md
CLAUDE.md

验证：

后端：python -m py_compile 新增后端模块、migration、router、prompt 聚合文件通过。
后端：pytest tests/test_pmflow_launch_api.py tests/test_pmflow_os_projection_api.py -q 通过，覆盖 draft 成功、结构化字段缺失、warnings、confirm 创建 Project/thread/message/truth_nodes/tasks、truth-state 回读、幂等、过期/跨 tenant/跨 user、rollback。
Alembic：alembic upgrade head 在本地开发 PostgreSQL 成功从 20260421_finalize_v1_productization 升级到 20260425_add_pmflow_launch_tables。
前端：npm run test -- src/features/project-launch/useProjectLaunchState.test.ts 通过，覆盖真实 draft API、draft 失败、confirm 成功、confirm 失败不进成功态、显式 demo 分支。
前端：npm run typecheck 通过。
前端：npm run build 通过。

剩余缺口：

Phase B 只覆盖首次 Project Launch 创建链；项目内后续 ChangeSet / ChangeItem / Approval / EvidenceLink 审查系统仍留给 Phase C。
初始 semantic_facts seed 仅写用户确认后的 project-level facts；完整异步抽取和治理仍复用既有 semantic facts 管线。

2026-04-26 / Phase C1 - PMFlow Change Review 数据底座与审查状态机 / done

完成内容：

新增 C1 review 表 migration backend/alembic/versions/20260426_add_pmflow_change_review_tables.py，只创建 pmflow_change_sets / pmflow_change_items / pmflow_approvals / pmflow_evidence_links；未新增 commit 或 Phase C2 表。
新增模型 backend/app/models/pmflow_change_review.py，所有表包含 tenant_id，并按 tenant_id + project_id 查询；ChangeItem 归属 ChangeSet，Approval 记录 accept / edit / defer 的 before/after，EvidenceLink 可引用 thread message。
新增服务 backend/app/services/pmflow_change_review_service.py，实现项目内消息、proposed_items extraction、ChangeSet detail、accept/edit/defer 审查状态机；老项目无真实线程时仅允许 default 或 thread-project-{project_id} 懒创建默认线程。
在 backend/app/api/pmflow_os_api/ 扩展 /pmflow-os API：POST /projects/{project_id}/threads/{thread_id}/messages、POST /projects/{project_id}/extractions、GET /projects/{project_id}/change-sets/{change_set_id}、POST /change-items/{change_item_id}/accept|edit|defer，统一响应包络。
PMFlowOSProjectionService 已投影 changeSets / changeItems / evidence / approvals，activeChangeSetId 取最近 open ChangeSet，loopStage 映射为 command_idle / extraction_ready / review_open；Project Memory 仍只来自 truth_nodes + semantic_facts。
前端 frontend/src/api/pmflowOs.ts 增加 Change Review API wrapper；frontend/src/features/pmflow-os/store.tsx 真实模式调用后端 message/extraction/accept/edit/defer，并在成功后 refetch truth-state。真实模式不再本地 promote accepted item，也不假装写入项目记忆；demo 模式仍需显式 ?demo=1 或 ?dataSource=demo。

涉及文件：

backend/alembic/versions/20260426_add_pmflow_change_review_tables.py
backend/app/models/pmflow_change_review.py
backend/app/services/pmflow_change_review_service.py
backend/app/api/pmflow_os_api/__init__.py
backend/app/schemas/pmflow_os.py
backend/app/services/pmflow_os_projection_service.py
backend/tests/test_pmflow_change_review_api.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/store.api.test.tsx
frontend/src/features/pmflow-os/pages/ChangeReviewPage.tsx
frontend/src/features/pmflow-os/components/ProjectStructuredLoop.tsx
docs/architecture/CODE_REFERENCE_INDEX.md
docs/architecture/ARCHITECTURE_INVENTORY.md
docs/architecture/PMFLOW_OS_PRODUCT_CONTRACT.md
docs/PMFLOW_PRODUCT_DELIVERY_STANDARD.md
CLAUDE.md

验证：

后端：python -m py_compile 新增后端模型、service、schema、router、migration 通过。
后端：pytest tests/test_pmflow_change_review_api.py tests/test_pmflow_os_projection_api.py tests/test_pmflow_launch_api.py -q 通过，覆盖 message 懒创建线程、extraction、change items、evidence link、detail、accept/edit/defer、reviewed 自动推进、权限边界、truth-state 投影，以及 accepted/edited 不进入 Project Memory。
Alembic：alembic heads 返回 20260426_add_pmflow_change_review_tables (head)；alembic upgrade head 在本地开发 PostgreSQL 成功从 20260425_add_pmflow_launch_tables 升级到 20260426_add_pmflow_change_review_tables。
前端：npm run test -- src/features/pmflow-os 通过。
前端：npm run typecheck 通过。
前端：npm run build 通过；Vite 仍提示既有循环 chunk warning，但构建成功。

剩余缺口：

C1 不实现 /commit，不写 truth_nodes / tasks / semantic_facts；accepted/edited 仅代表审查状态，不代表 confirmed Project Memory。
POST /extractions 本轮只接收 proposed_items，不默认调用 LLM 结构化提取；AI extraction 主链留给后续阶段。
高风险 risk_level=high 本轮只记录风险等级和 approval，commit gate 留给 C2。

下一步建议：

执行 Phase C2：实现 ChangeSet commit，把 accepted / edited ChangeItem 按对象类型写入正式 truth_nodes / tasks / semantic_facts，并补齐高风险 approval gate 与部分失败回滚/明细返回。

2026-04-24 / Product Blueprint / done

完成内容：

整理并落盘 PMFlow 产品蓝图真源。
明确 PMFlow 是“对话驱动的 AI 产品执行操作系统”。
明确 solo-first, team-ready、项目真相层、ChangeSet 待确认、Execution Bridge、人机混编团队等不可偏离项。

涉及文件：

docs/PMFLOW_PRODUCT_BLUEPRINT.md
USER.md
CLAUDE.md
docs/architecture/ARCHITECTURE_INVENTORY.md

验证：

文档新增与引用检查完成。
无代码改动，未运行编译/测试。

下一步：

执行 Phase A：PMFlow OS 产品合同收口。

2026-04-24 / Delivery Standard / done

完成内容：

建立 PMFlow 产品推进执行标准。
记录当前推进状态、下一阶段方向、Phase A-F 推进顺序、单次任务范围标准和完成后进度回写标准。
明确新开线程必须先读蓝图、执行标准和代码索引，避免重做或漏做。

涉及文件：

docs/PMFLOW_PRODUCT_DELIVERY_STANDARD.md
USER.md
CLAUDE.md
docs/architecture/ARCHITECTURE_INVENTORY.md

验证：

文档新增与引用检查完成。
无代码改动，未运行编译/测试。

下一步：

从 A1 对象合同映射开始，把前端 pmflow-os/types.ts 与后端现有对象逐一对齐。

107 KiB Raw Blame History Unescape Escape

PMFlow 产品推进执行标准

1. 当前推进判断

1.1 已经推进到位的部分

产品方向

前端产品域

后端控制面

1.2 当前缺口

2. 下一步推进方向

2.1 下一阶段总目标

2.2 暂不推进的方向

3. 推荐推进顺序

3.0 功能原型一致性治理

Phase A：产品合同收口

Phase B：Project Launch 真实创建链

Phase C：Change Review 与 Project Memory 写入

Phase D：Execution Bridge 真实开发同步

Phase E：Release / Growth 轻量闭环

Phase F：Team-ready 最小闭环

4. 单次任务范围标准

4.1 默认范围

4.2 推荐任务模板

4.3 禁止范围漂移

4.4 Codex 并行推进协议

4.4.1 大模块并行治理

4.4.2 当前大模块 lane 划分

Lane 0：Shell / Integration

Lane 1：Main Flow / PMFlow OS 主流程

Lane 2：Space / 个人空间入口

Lane 3：Account Settings / 个人中心与设置

4.4.3 P0 公共壳冻结结果

Route 归属

Provider 与共享状态

导航与移动底部栏

下一批开工条件

4.5 V1 Productized Loop 默认并行切片

4.6 Phase C2 并行试点拆包

4.7 分支与 worktree 协议

4.8 Packet commit 协议

4.9 Parallel Integration Gate

5. 每次完成后的进度回写标准

5.1 必须更新的地方

5.2 进度台账记录格式

5.3 什么时候不用更新蓝图

6. 新开线程接续标准

7. 当前下一步推荐任务

7.1 下一批大模块并行建议

Batch P0：Shell / Route / Shared Contract Freeze

Batch P1：三模块并行

Main Flow Packet：main-flow-phase-d2-execution-handoff-contract

Space Packet：space-v1-workbench

Account Settings Packet：account-settings-v1

Batch P2：Integration Owner 收口

8. 进度台账

2026-04-26 / release-feedback-p1-feedback-ingest-readmodel / implemented

2026-04-26 / big-module-integration-p4 / done

2026-04-26 / release-growth-p2-notification-preference-consume / implemented

2026-04-26 / release-validation-p1-real-run-records / implemented

2026-04-26 / account-p3-release-notification-consumption-contract / implemented

2026-04-26 / space-p3-validation-run-attention / implemented

2026-04-26 / big-module-integration-p3 / done

2026-04-26 / release-growth-p1-execution-evidence-gate / implemented

2026-04-26 / space-p2-release-attention-readmodel / implemented

2026-04-26 / big-module-integration-p2 / done

2026-04-26 / space-p1-real-workbench-dashboard / implemented

2026-04-26 / main-flow-p1-execution-handoff-consume / done

2026-04-26 / big-module-integration-p1 / done

2026-04-26 / Space V1 Workbench Hardening / implemented

2026-04-26 / Account P2 Notification Preference Consumption / implemented

2026-04-26 / Account P1 Preferences Backend Contract / implemented

2026-04-26 / Account Settings V1 / implemented

2026-04-26 / P0 Shell Module Boundaries / done

2026-04-26 / Phase D.2 - Execution Handoff Contract / done

2026-04-26 / Big Module Parallel Governance / done

2026-04-26 / Phase C2 Frontend - ChangeSet Commit Wiring / done

2026-04-26 / Phase C2 Backend - ChangeSet Atomic Commit / done

2026-04-26 / G0 Freeze + C2 Contract / done

2026-04-26 / Parallel Delivery Governance / done

2026-04-25 / Phase A - PMFlow OS Product Contract / done

2026-04-25 / A3 - PMFlow OS 最小真实读路径 / done

107 KiB

Raw Blame History

Main Flow Packet：`main-flow-phase-d2-execution-handoff-contract`

Space Packet：`space-v1-workbench`

Account Settings Packet：`account-settings-v1`