Spec 3「AP 套用流程」Task Arc Summary

Branch：feature/project-flow-engine-integrate（BE + FE 同名） Task arc 範圍：Phase 5 實作（M0–M6 plan）→ M7 manual smoke discover bug → M9–M13 修補 → Phase 6 5-agent review → summary 收尾 時間：2026-05-13 single-day execution Status：可 ship，0 critical issue

讓 user 建專案 / 新增稽核計畫時挑選流程範本（flow_template_uid 必填），AP 建立同時 snapshot clone BPMN 到 per-AP 凍結。順手修補 Spec 2 漏蓋：launch_new_round 沒呼叫 _bind_main_workflow_to_ap 導致第二輪以後 AP 沒 main workflow snapshot，Banner 推進按鈕永遠 disabled。

實作完成後 M7 smoke 用「規劃→End」「規劃→執行→End」自建 BPMN 流程連續 discover 5 個 Spec 2 carry-forward bug，全部當 branch 內 patch fix 收掉。

BE repo（25 commits in ea8f573..HEAD）

FE repo（6 commits in 6f6f30b..HEAD）

內部套件異動

無。M2 implementer 評估 jedi-flow-engine 已有 get_workflow_template_by_uids，不動套件。pyproject.toml dev path mode 不 commit（部署時自動還原 pin 0.0.27）。

3.1 新增使用者操作

1. 建專案時必選流程範本 — 建專案 wizard step 0 加 dropdown + 「預覽」按鈕（FlowTemplatePreviewDialog reuse Spec 1 元件）
2. 新增稽核計畫時挑流程範本 — Dialog 加 dropdown，default 帶上一輪 AP 用的範本，含「預設沿用上一輪」hint
3. 稽核計畫列表 / 詳情看到 flow_template 資訊 — AP list / PUT response 含 {snapshot_uid, master_uid, master_name, is_master_active, stage_codes}

3.2 修補的 bug

1. launch_new_round 沒綁 main workflow snapshot（Spec 2 漏蓋）— 第二輪以後 AP Banner 推進按鈕現在能用
2. 自建單一 stage BPMN AP 卡死（M9）— 規劃 → End 流程能正常結案
3. 沒 audit/poam stage 的流程仍顯示對應 button（M10）— 自建流程隱藏 stage-irrelevant button
4. AP closed 但 project.status 卡 PENDING（M11）— 三個視圖狀態一致
5. AP closed 但 completion_rate 0%（M12）— 結案 AP 一律顯示 100%
6. 稽核計畫列表 row buttons 缺角色判斷（M13）— 對齊專案總覽右上同名 button

3.3 Breaking changes

• POST /oscal/projects/start 必填 flow_template_uid (UUID)
• POST /grc/project/<uid>/launch-new-round 必填 flow_template_uid (UUID)
• BE / FE 必須一起部署

規範文件 100% 齊全 — 每個 milestone 有 changelog，每個重大決策有 analysis，5 個 review agent 報告完整。

5-agent parallel review verdict：可 ship，0 critical issue。

4 個跨報告 cross-cutting pattern：

1. project.status 同步條件三處不一致（PENDING 白名單 / IN_PROGRESS 白名單 / != COMPLETED 黑名單）
2. 權限檢查依賴 caller 約定，terminal_close_ap 缺 defensive 層
3. Untyped dict 蔓延（payload / handler result / current_stage）
4. Lenient fallback 方向對但 log context 不足，BPMN data corruption vs legal terminal 二者無區分

詳見 docs/issues/pending/2026-05-13-spec3-phase-6-followups.md，8 個 PR 規劃：

7.1 部署條件

• BE / FE 必須一起部署（M4 breaking change）
• jedi-flow-engine 未動，不需 bump version；部署時 pyproject.toml dev path mode 還原 pin 0.0.27

7.2 部署清單

7.3 部署後驗證項

1. 建專案 wizard step 0 看到流程範本 dropdown + 預覽按鈕
2. 缺 flow_template_uid → 400
3. 自建「規劃→End」流程 lifecycle 通跑（規劃 advance → AP closed + project completed + completion_rate 100%）
4. 既有完整稽核流程（4 stage）行為不變
5. AP list response 含 flow_template.{snapshot_uid, master_uid, master_name, is_master_active, stage_codes}

7.4 dev DB 既有壞資料修正

1a55bbd5-35bf-4507-99e0-25fe2fe168f0「只有規劃流程」project 已用 SQL 手動修（pending → completed）。其他 project 用 M11 fix 後正常推進不受影響。

Plugin 架構

詳見 docs/analysis/2026-05-13-stage-plugin-architecture-thoughts.md：

行為決策反悔

逐輪 Q&A 對話紀錄存到本 dir 的 part-NN-of-NN-*.md（整個 dir 在 .gitignore 內，不入版控，本地檔）。Subagent 在 summary 收尾時處理，邊界按 milestone 拆。