docs: record final database-truth automation rerun

2026-05-14 17:11:55 +08:00
parent 8430fd464d
commit 74cae5afb9
1 changed files with 52 additions and 0 deletions
@@ -1309,3 +1309,55 @@
 - 当前数据库真相源快照里 `review_tasks=167`，而 CSV fallback 口径里最近一轮为 `99`
  - 这说明数据库真相源当前保留的是更完整的 assignment 级任务视图
  - 该差异目前不阻断门禁，但后续如果要统一审批统计口径，仍建议单独做一轮“CSV 与数据库 approval metrics 口径对齐”梳理。
+
+## 2026-05-14 database truth 全量自动化复跑收口
+
+### 本轮先核对的阶段、边界与未完成项
+- 已再次按 `project-docs/README.md` 与路线图核对当前阶段：
+  - 当前自动化主线目标不是继续新增 Phase 1/2 功能，而是验证“带远程 PostgreSQL 真相源参数”的全量自动化能否稳定跑到正式上线批准门禁。
+  - knowledge_bases 发布链远端能力缺口、`ops / production_approver` 角色细化仍然是独立 backlog，不影响本轮门禁复跑。
+
+### 本轮完成项
+- 已发现并修复自动化总脚本的一处参数透传缺陷：
+  - 原因：`scripts/run-ai-contract-full-automation-until-blocked.ps1` 的 `New-ScriptStep` 使用了参数名 `Args`
+  - 该命名会与 PowerShell 的自动变量 `$args` 发生冲突，导致 `-SkipBaseline` 以及 `-FormalLaunchDatabaseUrl / -FormalLaunchRequireDatabaseTruth` 等数组参数被静默吞掉
+  - 修复：把 `New-ScriptStep` 的参数名改为 `ScriptArgs`，并同步调整调用点
+  - 提交：`8430fd4 fix: pass script args through automation steps`
+- 已在修复后重新执行带 database truth 参数的全量自动化：
+  - `scripts/run-ai-contract-full-automation-until-blocked.ps1 -FormalLaunchDatabaseUrl 'postgresql+psycopg://postgres:postgres@127.0.0.1:15432/ai_contract_platform' -FormalLaunchRequireDatabaseTruth`
+  - 本轮全量自动化已真正把 `-DatabaseUrl` 和 `-RequireDatabaseTruth` 透传给 `formal-launch-approval-gate`
+
+### 本轮验证
+- 参数透传最小复现实验：
+  - `New-ScriptStep` 在修复前会得到 `COUNT=0`
+  - 修复后会得到 `COUNT=3`
+- 全量自动化复跑：
+  - 产物：`project-docs/automation-artifacts/run-until-blocked/2026-05-14T16-58-34/summary.md`
+  - 结果：Phase 0 到 Phase 5 的 `formal-launch-preparation-gate` 全部 PASS
+  - `formal-launch-approval-gate` 被正确执行为：
+    - `& 'D:\ai-contract-platform\scripts\run-formal-launch-approval-gate.ps1' -DatabaseUrl postgresql+psycopg://postgres:postgres@127.0.0.1:15432/ai_contract_platform -RequireDatabaseTruth`
+- 最终批准门禁产物：
+  - `project-docs/qa-artifacts/formal-launch-approval-gate/2026-05-14T17-08-11-966/formal-launch-approval-summary.md`
+  - `source_mode=database`
+  - `warnings=0`
+  - `database truth source=PASS`
+
+### 当前状态更新
+- 现在全量自动化主线已经真正具备 database truth 能力，而不只是“手工补跑 approval gate”：
+  - 总脚本可直接携带远程 PostgreSQL 真相源参数
+  - 最终门禁摘要不再回退到 `csv fallback`
+- 当前全量自动化的最终阻塞点已经稳定收敛为 database truth 下的正式上线批准门禁：
+  - `review_tasks=167`
+  - `missing_reviewer_tasks=0`
+  - `blocked_required=8`
+
+### 当前阻塞项
+- 当前剩余阻塞仍全部属于真实人工签收，而非代码或自动化缺陷：
+  - `approved_review_tasks=0`，要求至少 31
+  - `approved_materials=0`，要求 7
+  - `approved_public_materials=0`，要求 3
+  - `approved_templates=0`，要求至少 5
+  - `approved_knowledge_cards=0`，要求至少 10
+  - `approved_review_rules=0`，要求至少 8
+  - `approved_clauses=0`，要求至少 8
+  - `final launch approval checklist` 仍为 `TEMPLATE`