手冊首頁 ／ Release Notes ／ Guidant AI v1.7.0 Release Note

Guidant AI v1.7.0 Release Note

項目 內容
版本 1.7.0（功能版號；FR-040 行程查核指引 + FR-041 缺失改善頁重設計 + v2 架構 bug 收斂）
發布日期 2026-06-25
上一版本 1.6.0（2026-06-19）
涵蓋區間 2026-06-19 ~ 2026-06-25
規模 2 個新功能（FR-040 Phase 7 / FR-041）+ 3 個 tweak + 7 個 bug fix，跨 BE + FE + jedi-oscal-v2 + jedi-log
適用部署 dev / staging；poc / prod 待辦
部署性質 非破壞（加表 / 加選單 / 程式修正，無 drop）。含 2 支 DB migration + jedi-oscal-v2 2.1.0 / jedi-log 0.0.11 pin。多數 bug fix 為純程式碼修正，BE 需重啟生效。

1. 概述

v1.7.0 是 v1.6.0（FR-039 分散式檔案 agent）之後的功能 + bug 收斂版。兩條主線：

  • 新功能：FR-040 Phase 7 把 AP 行程「說明」升級成每個查核方法的逐步指引（activity.steps）；FR-041 把缺失改善（POA&M）頁整個 A 版重設計（DataTable 清單 + Sidebar 抽屜 + 里程碑卡片化）。
  • v2 架構 bug 收斂：FR-038 OSCAL v2 大結構切換後，數個讀控制集 / 輪次語意的路徑沒跟上而失效（標記審閱、雲端目錄、證據分類、退回任務凍結），本版逐一修回 v2 正典（living SSP 控制樹 / task_assignees→輪次）；另收操作日誌、問卷暫存、FR-039 agent 管理頁等回報。

所有 commit 目前仍在本地未 push（BE fix/v1.16-bugfix + FR-040-AP-improvement、FE 對應 branch、jedi-log 已發 Nexus 0.0.11、jedi-oscal-v2 已發 Nexus 2.1.0）。push 待人工執行。

2. 重點新功能

2.1 FR-040 Phase 7 — 行程「說明」升級每方法查核指引（feat）

  • AP 行程的「說明」從單段文字升級成每個查核方法的逐步指引（activity.steps）：稽核員規劃時可對每個方法寫明「怎麼查、查什麼、看哪些證據」。
  • 需 jedi-oscal-v2 2.1.0（釋出 FR-040 行程 link 表 model）+ DB migration 2026-06-21-fr040-ap-task-link-tables.sql、稽核方法選單 2026-06-20-audit-method-menu.sql。
  • 跨 BE + FE。

2.2 FR-041 — 缺失改善（POA&M）頁 A 版重設計（feat）

  • 清單：accordion → DataTable（控制項 / 嚴重度 / 狀態 / 期限 / 進度），欄位可排序 + 表頭篩選；點列滑出右側 Sidebar 抽屜（矯正措施 / 缺失脈絡 / 證據 三分頁）。
  • 里程碑卡片化 + 顯示/編輯兩模式：狀態 chip 點擊循環切換（未開始→進行中→完成，即存）；就地編輯卡取代彈窗；可新增 / 刪除。
  • 改善計畫來源徽章（稽核建議 / 自訂）；lifecycle=recommendation 的稽核建議隱藏刪除鈕（屬稽核紀錄）。
  • 缺失脈絡拆「看到什麼 / 蒐證方法 / 查核對象」標籤化；結案/覆核流程提示。
  • BE 新增 DELETE /audit-round/{round}/poam-milestone/{uid}、DELETE /audit-round/{round}/remediation/{uid}（manager 守門）。

3. 重要修補（v1.6 回報的「bug 太多」批次）

# 修補 根因 / 修法 模組
1 標記審閱（控制項/AO sign-off）v2 失效（500/404，按鈕被鎖） v1 AP-task 路徑在 v2 dark；改走 living SSP（控制集 + 進度同源） grc
2 雲端空間自動產生控制項目錄只剩 AP 層 舊讀控制集路徑回空；改走 v2 living SSP 控制樹 get_control_tree 正典 cloud_integration / oscal
3 證據自動分類吃整框架全集 硬編碼靜態 JSON 全集；改走 living SSP in-scope catalog（profile resolve） evidence_classification / oscal
4 輪次凍結後仍可退回任務 退回 gate 三層缺凍結檢查；走 task_assignees→最新輪 status 擋（GRC_412042） grc / flow_engine
5 操作日誌預設排序錯 + 總數只顯示 998 duration=0 組出幽靈 WHERE + 排序欄錯；jedi-log 0.0.11 修 api_log
6 問卷暫存對未評分題報 500 checkpoint 寫 score: null 踩 NOT NULL；未評分不落 score task_survey
7 FR-039 agent 管理頁：對帳走 mTLS+JWT、toast 顯示、編輯 base_url 唯讀 對帳裸 httpx 未帶認證；自我註冊 agent 換址不可改 base_url remote_agent

#7 BE 對帳路徑「部分待驗證」（FE 已確認，BE 對帳 mTLS+JWT 待重啟後重測）。

4. 其他調整（tweak）

  • jedi-oscal-v2 2.1.0 發版 Nexus + BE pin（釋出 FR-040 行程 link 表 model）。
  • AP 唯讀「行程與方法」乾淨唯讀呈現：取代 :disabled 灰掉表單，回頭 review 不再糊成一片。
  • 移除 AP / AR / 缺失改善 user-facing 的「OSCAL」字眼：對外不曝露內部格式術語。

5. Breaking Changes

無對外 breaking。FR-040 行程資料模型擴充為加表（向後相容）；既有 AP 不受影響。

6. DB Migration

依序套用（cmmgr、psql --single-transaction -v ON_ERROR_STOP=1）：

  1. scripts/sql/2026-06-20-audit-method-menu.sql — 稽核方法選單
  2. scripts/sql/2026-06-21-fr040-ap-task-link-tables.sql — FR-040 行程 ↔︎ AP task link 表

本版 bug fix 多為純程式碼修正，無額外 schema 異動；但 #2/#3/#4 修補依賴 FR-038 v2 living SSP 結構已就位（前版已遷移）。

7. 相依套件版本

套件 版本 本版變動
jedi-oscal-v2 2.1.0 ⬆ FR-040 行程 link 表 model
jedi-log 0.0.11 ⬆ 操作日誌排序 / 幽靈過濾修正
jedi-common 0.0.25 —
jedi-auth 0.1.20 —
jedi-flow-engine 0.0.31 —
jedi-oscal 0.0.23 —
jedi-project 0.0.5 —

部署前 poetry update jedi-oscal-v2 jedi-log（pin 已寫入 pyproject.toml）。

8. 部署順序

  1. 拉取 BE + FE 對應 branch；poetry update（取 jedi-oscal-v2 2.1.0 / jedi-log 0.0.11）。
  2. 套 §6 兩支 DB migration（dev → stg）。
  3. 重啟 BE（無 hot reload，多數 bug fix 靠重啟生效）。
  4. FE build / 部署（FR-040 / FR-041 / tweak 含 FE 變更）。
  5. 重測 §3 #7 的 BE 對帳 mTLS+JWT 路徑。

9. 已知 Follow-up

  • 證據分類的 put_state / archive_run / 報表仍用全集 catalog 反查 ao_id（in-scope 安全超集，正確性無虞，僅報表多列空白控制）— 是否一併改 in-scope 另案。
  • FR-039 agent 管理頁 BE 對帳路徑待重啟後重測。
  • 全部 commit 未 push（BE / FE / Nexus 已發但 git 未 push）。

10. 完整 changelog 索引

  • docs/changelog/2026-06-21-feat-fr040-phase7-ap-task-step-guidance.md
  • docs/changelog/2026-06-21-feat-fr041-poam-page-a-redesign.md
  • docs/changelog/2026-06-21-chore-jedi-oscal-v2-2.1.0-release.md
  • docs/changelog/2026-06-21-fix-fr039-reconcile-auth-and-edit-baseurl-readonly.md
  • docs/changelog/2026-06-21-fix-grc-review-mark-v2-living-ssp.md
  • docs/changelog/2026-06-21-tweak-ap-readonly-display.md
  • docs/changelog/2026-06-21-tweak-remove-oscal-copy-ap-ar-poam.md
  • docs/changelog/2026-06-25-fix-api-log-list-sort-and-duration-phantom-filter.md
  • docs/changelog/2026-06-25-fix-cloud-integration-control-tree-v2.md
  • docs/changelog/2026-06-25-fix-evidence-classification-inscope-catalog-v2.md
  • docs/changelog/2026-06-25-fix-revert-job-blocked-after-round-frozen.md
  • docs/changelog/2026-06-25-fix-task-survey-checkpoint-null-score.md

11. 相關文件索引

  • FR-040：docs/features/FR-040-*/
  • FR-041：docs/features/FR-041-*/
  • 稽核輪次模型：docs/analysis/2026-06-22-one-project-one-audit-round-model.md
  • v2 控制集讀取正典：docs/claude/domain-capabilities.md（get_control_tree / living SSP）
Guidant AI 功能 SPEC 手冊 current（持續更新中）｜本頁由 render_html.py 產生，內容源：specs/current/release-notes/v1.7.0.md