wooo/ewoooc

Fork 0

Files

ogt 157f0f98be

CD Pipeline / deploy (push) Has been cancelled

Details

feat(smoke): monitor pchome decision closeout

2026-07-03 08:30:17 +08:00

33 KiB

Raw Blame History

PChome AI 自動化優先工作清單

最後更新: 2026-07-03 Asia/Taipei 範圍: PChome growth / MOMO mapping AI 自動化主線真相來源: Gitea dev / main、正式環境 /health、正式 DB readback、machine-verifiable artifacts

不可遺漏的插入需求

以下是使用者在主線推進期間插入、且必須保留在完整工作項目裡的要求。後續不得再把這些需求漏掉或變成口頭提醒。

正式環境才是最新版本真相；不得用本機檔案、舊筆記、舊分支蓋過 production truth。
版本不得搞錯；目前正式環境 /health 版本維持 V10.728，除非有明確版本 bump、部署與 readback。
GitHub 全面 freeze；不得使用 GitHub、gh、GitHub API、GitHub Actions、PR、issue、mirror 或 read-only GitHub 流程。
實作結果必須推到 Gitea dev 與 main；若改到 runtime 行為，還必須部署到正式環境並回讀。
主方向是 AI 自動化，不是人工審核；人工欄位只能當 evidence / ledger / UI truth，不得阻擋低爆炸半徑、可驗證、可回滾的 controlled apply。
每條主線都要產生實作結果；不能只交計畫、UI 卡片、文件或口頭盤點。
中途插入的所有需求都必須進入本 backlog，且標明優先順序與狀態。
所有工作必須照優先順序推進；除非高優先 blocker 要求，否則不得開支線偏離。
產品體驗要往主流、專業產品網站前進：AI 狀態可見、下一步清楚、繁中介面、營運儀表板密度足夠、一般產品頁不暴露 raw engineering terms。
必須參考外部主流專業網站 / SaaS / observability dashboard 做法：狀態分層、下一步優先、收據可追蹤、drift 監控、automation health visibility。
AI 技術自動化要升級為可見能力：agent status、controlled apply、artifact receipts、drift verifier、rollback / re-apply evidence，不能把隱藏人工 gate 當主流程。
每次宣稱完成都必須列出 source truth、runtime truth、測試、production readback、artifact / blocker 狀態。
不把工作丟回給使用者；Codex 收到「批准 / 繼續」後，必須主動補齊 target selector、dry-run / check-mode、rollback、post-apply verifier 與回讀證據。
需要同時看清楚所有工作狀態：已完成、進行中、未開始；不能只報正在做的一小段。

優先順序總表

Priority	主線	狀態	為什麼排這裡
P0	Runtime truth + AI controlled apply closure	進行中，核心閉環已完成多段	先證明 AI 真的在正式環境可執行、可回讀、可驗證、可回滾
P1	產品可視化 + 專業網站體驗	進行中	使用者要看得到實作結果，AI 自動化不能只藏在 artifact / log
P2	外部主流 benchmark 落成 guardrails	已完成第一版，持續擴充	把主流專業做法變成可測規則，不只是參考口號
P3	擴大 AI 自動化覆蓋面	進行中	把目前 PChome retry lane 的閉環模式複製到更多安全場景
P4	Source / deployment governance	持續進行	保證版本、Gitea、正式環境、DB 安全紅線不再混亂

P0 - Runtime Truth And AI Controlled Apply Closure

狀態: 進行中，核心閉環已完成多段。

目的: 先讓 PChome mapping automation 在正式環境真的 execute、verify、stay correct。

已完成:

正式環境版本真相 guard：/health 是最高真相，目前維持 V10.728。
Gitea dev / main source truth 對齊。
Retry exception controlled apply executor 已落地，目標表為 pchome_product_matches。
正式 DB 已 controlled apply 4 個 selectors:
- 14560744 -> DDBH21-A900I79YR-002
- 8932783 -> DDBH21-A900I79YR-002
- 15132753 -> DDBH21-A900I79YR-002
- 14941743 -> DDBH21-A900I79YR-002
Executor receipt 已 materialize。
Receipt replay closeout 已用 artifacts 與 DB readback 補齊。
AI automation readiness 已可回報:
- AI_AUTOMATION_CONTROLLED_APPLY_CLOSEOUT_VERIFIED
- controlled apply lane completed
- receipt replay lane completed
Drift verifier 已完成:
- production readback 4/4
- drift_count=0
- drift lane completed
Drift verifier artifact receipt 已完成:
- materialized artifact count 1
- hash match count 1
Automated drift monitor / smoke path 已完成:
- PChome 受控落地 drift monitor 已納入 AI automation smoke checks
- 每次 /api/ai-automation/smoke 與每日 smoke 摘要都會例行執行 read-only drift verifier
- drift detected 或 verifier write-risk 會升為 critical
Drift rollback / re-apply recommendation package 已完成:
- direct-mapping-retry-candidate-exception-controlled-apply-drift-recovery-package 可輸出 read-only recovery package
- drift detected 時會產生 controlled re-apply SQL shape、rollback SQL shape、selector bindings 與 acceptance gates
- 0 drift 時會產生 no-op evidence，避免把正常狀態誤報成人工審核
Compact latest apply / replay / drift / recovery readback endpoint 已完成:
- direct-mapping-retry-candidate-exception-controlled-apply-compact-readback-package 會回傳 apply、replay、drift、recovery 四段 compact receipt
- 產品面可直接讀取 product_status、next_machine_action、selector readback、drift count 與 artifact hash 狀態
- compact readback 自身也可 materialize artifact 並驗證 hash
Controlled-apply artifact retention policy 已完成:
- direct-mapping-retry-candidate-exception-controlled-apply-artifact-retention-package 會掃描 controlled apply 相關 artifact families
- 每個 family 依 keep_latest_per_family 保留最新 evidence，並額外保護 active compact readback chain
- 只產生 prune candidates 與 retention receipt，不直接刪檔、不寫 DB、不執行 destructive prune
Product dashboard first-viewport surface 已完成:
- PChome 業績成長作戰台第一視窗已接入 AI automation readiness、receipt replay、drift verifier、drift recovery、compact readback 與 artifact retention policy
- 第一視窗直接顯示「AI 全自動閉環已回讀」、selector readback、drift count、retention 保留數與 automation lane 狀態
- 頁面讀取採 read-only package，不寫 DB、不刪 artifacts、不執行 prune
AI debt scanner 顯示產品面清空:
- PRODUCT_SURFACE_CLEAR
- finding_count=0
- primary_human_gate_count=0
PChome auto-policy authorization guard runtime monitoring 已完成:
- /api/ai-automation/smoke 已加入 PChome auto-policy authorization guard
- read-only 組裝 auto-policy DB apply guard lane，檢查 no-secret / no-SQL / no-DB-write / machine-verifiable / exception-only
- /api/ai-automation/scheduled-health-summary 已輸出 pchome_auto_policy_authorization_guard family
- /metrics 已輸出 momo_ai_automation_scheduled_health_family_status{family="pchome_auto_policy_authorization_guard",...}
- 不做外部 fetch、不寫 DB、不發 apply authorization，下一個機器動作是補 machine fetch evidence 與後續 controlled authorization lane
PChome auto-policy decision preflight runtime monitoring 已完成:
- /api/ai-automation/smoke 已加入 PChome auto-policy decision preflight
- 以本機 machine evidence adapter 自動推進 execute_fetch=True 的 decision preflight ready path
- 明確標記 payload_source=local_contract_fixture、outbound_network=false、business_data_source=false、writes_database_count=0、primary_human_gate_count=0
- /api/ai-automation/scheduled-health-summary 已輸出 pchome_auto_policy_decision_preflight family
- /metrics 已輸出 momo_ai_automation_scheduled_health_family_status{family="pchome_auto_policy_decision_preflight",...}
- 不讀 secret、不執行 SQL、不寫 DB、不發 apply authorization，下一個機器動作是 authorization decision closeout lane
PChome auto-policy decision closeout runtime monitoring 已完成:
- /api/ai-automation/smoke 已加入 PChome auto-policy decision closeout
- 以本機 contract fixture + machine evidence adapter 自動推進 decision closeout ready path
- 明確標記 post_apply_verifier_required_count=1、same_run_truth_required_count=1、writes_database_count=0、primary_human_gate_count=0
- /api/ai-automation/scheduled-health-summary 已輸出 pchome_auto_policy_decision_closeout family
- /metrics 已輸出 momo_ai_automation_scheduled_health_family_status{family="pchome_auto_policy_decision_closeout",...}
- 不讀 secret、不執行 SQL、不寫 DB、不發 apply authorization，下一個機器動作是 authorization issuer gate lane

進行中 / 下一步，必須照順序:

將 auto-policy decision closeout 往 authorization issuer gate lane 推進。

完成標準:

Gitea dev / main 已 push。
runtime code change 已部署正式環境。
/health healthy 且 production version truth PASS。
正式 DB readback 與 artifact hash readback 都有證據。
focused PChome automation 與 AI debt tests 通過。

P1 - Product Visibility And Professional Website Experience

狀態: 進行中，本輪已完成 /ai_intelligence、/observability/overview、/ai_automation_smoke、/observability/agent_orchestration、/observability/ai_calls、/observability/quality_trend、/observability/budget、/observability/business_intel、/observability/host_health、/observability/rag_queries、/observability/promotion_review 與 /observability/ppt_audit_history 密集 AI 工作台文字密度守門，並新增高可見 AI surfaces route-level HTML readback 防退化 guard、runtime AI smoke readback 與整站 UI/UX Agent inventory。

目的: 讓 AI 自動化在產品裡可見，成為專業營運工作流，而不是只藏在後端。

已完成:

AI readiness 已聚合主要 automation lanes。
Controlled apply、receipt replay、drift verifier 已進 readiness。
產品層 automation result 已輸出 zero primary human gates。
PChome dashboard 第一視窗已接入 compact readback 與 artifact retention policy。
第一視窗 automation pipeline 已從「等待 verifier」改成顯示受控落地、最新回讀、證據留存的 read-only production 狀態。
Dashboard AI automation wording guard 已完成:
- 第一視窗可見文案改為繁中營運語言：異動、最新回讀、證據留存、資料寫入、清理建議
- 不再把 retention、Compact、Artifact、DB writes、prune 壓在產品第一視窗
- tests/test_pchome_dashboard_ai_wording_guard.py 已鎖住第一視窗不可退回 raw engineering terms
/ai_intelligence 商品明細價格證據 guard 已完成:
- 商品列與單品詳情都以 aria-label="價格證據" 與 data-evidence 固定 PChome 價格、MOMO 參考價、差距、可信度四格。
- 搜尋欄明確涵蓋商品、分類、編號與 MOMO 候選，排序支援優先級、近 7 天業績、價差、下滑幅度、可信度。
- tests/test_ai_intelligence_product_evidence_guardrails.py 已鎖住四格價格證據、候選待確認 / 待補狀態與搜尋排序契約。
/ai_intelligence 密集 AI 工作台文字密度 guard 已完成:
- 首屏改成 data-density-guardrail="compact-ai-workbench"，以「AI 作戰 / 證據優先 / 下一步」短標籤取代長說明。
- KPI note、benchmark detail、alert 副句、mini-card 說明、策略 note、decision copy、來源長句與單品 reason list 從可見 UI 退場。
- tests/test_ai_intelligence_text_density_guardrails.py 已鎖住短任務文案、detail meta 與 explanatory copy hidden contract。
/observability/overview 密集 AI 觀測工作台文字密度 guard 已完成:
- 首屏改成 data-density-guardrail="compact-observability-workbench"，以「AI 觀測 / 風險優先 / 下一步」短標籤承接 golden signals。
- hero lede、signal note、route desc、host meta 與資料來源長句從可見 UI 退場，保留狀態、數字與子頁入口。
- tests/test_observability_text_density_guardrails.py 已鎖住 compact marker、第一層狀態數字與 explanatory copy hidden contract。
/ai_automation_smoke 密集 AI 巡檢工作台文字密度 guard 已完成:
- 首屏改成 data-density-guardrail="compact-smoke-workbench"，以「AI 巡檢 / 風險優先 / 推播摘要」短標籤承接 AI 健康檢查。
- hero lede、趨勢說明、每日摘要說明與診斷細節提示從可見 UI 退場，保留狀態、數字、趨勢、每日摘要與檢查項目 summary。
- tests/test_ai_automation_smoke_text_density_guardrails.py 已鎖住 compact marker、第一層狀態數字與 explanatory copy hidden contract。
/observability/agent_orchestration 密集 AI Agent 工作台文字密度 guard 已完成:
- 首屏改成 data-density-guardrail="compact-agent-workbench"，以「AI 分工 / 成本守門 / 知識命中」短標籤承接 Agent 編排狀態。
- hero 說明、KPI 小註、列內描述、卡片描述與頁尾重複標題從可見 UI 退場，保留呼叫總量、主力路徑、付費成本、知識命中、分工矩陣與工具協作表。
- tests/test_agent_orchestration_text_density_guardrails.py 已鎖住 compact marker、第一層狀態數字與 explanatory copy hidden contract。
/observability/ai_calls 密集 AI 流量工作台文字密度 guard 已完成:
- 首屏改成 data-density-guardrail="compact-ai-calls-workbench"，以「流量監控 / 成本守門 / 知識命中」短標籤承接 AI 呼叫狀態。
- hero 說明、KPI 小註、素材說明與頁尾重複標題從可見 UI 退場，保留呼叫總量、用量、成本、延遲、知識命中、錯誤、情境矩陣與最近呼叫。
- tests/test_ai_calls_text_density_guardrails.py 已鎖住 compact marker、第一層狀態數字與 explanatory copy hidden contract。
/observability/quality_trend 密集 AI 品質工作台文字密度 guard 已完成:
- 首屏改成 data-density-guardrail="compact-quality-workbench"，以「品質回饋 / 知識可靠 / 行動成效」短標籤承接 AI 建議可靠性。
- hero 說明、KPI 小註與頁尾重複標題從可見 UI 退場，保留反饋總量、最低均分、蒸餾樣本、知識評分、使用情境反饋、根因建議與實際動作成效。
- tests/test_quality_trend_text_density_guardrails.py 已鎖住 compact marker、第一層狀態數字與 explanatory copy hidden contract。
/observability/budget 密集 AI 成本工作台文字密度 guard 已完成:
- 首屏改成 data-density-guardrail="compact-budget-workbench"，以「成本守門 / 節流狀態 / 知識策略」短標籤承接成本治理。
- hero 說明、按鈕註解、KPI 小註與頁尾重複標題從可見 UI 退場，保留當月花費、預算使用率、預警、已節流、預算線、成本趨勢、成本集中與 AI 價格決策成效。
- tests/test_budget_text_density_guardrails.py 已鎖住 compact marker、第一層成本訊號與 explanatory copy hidden contract。
/observability/business_intel 密集 AI 商業工作台文字密度 guard 已完成:
- 首屏改成 data-density-guardrail="compact-business-workbench"，以「戰果追蹤 / 閉環成效 / 競品訊號」短標籤承接 AI 商業狀態。
- hero 說明、決策節奏註解、KPI 小註、panel 說明與頁尾資料來源從可見 UI 退場，保留高信心未跟進、平均信心分、有效率、競品監測、外部促銷活動監控、策略族群、最近建議與閉環學習紀錄。
- tests/test_business_intel_text_density_guardrails.py 已鎖住 compact marker、第一層商業訊號與 explanatory copy hidden contract。
/observability/host_health 密集 AI runtime 工作台文字密度 guard 已完成:
- 首屏改成 data-density-guardrail="compact-runtime-workbench"，以「主機級聯 / 自癒閉環 / 成本節流」短標籤承接 AI runtime 狀態。
- hero 說明、KPI 小註與頁尾重複標題從可見 UI 退場，保留建議服務離線、AIOps 未解、自癒成功率、節流供應商、AI 建議服務主機、健康趨勢、自癒閉環、工具層與事件紀錄。
- tests/test_host_health_text_density_guardrails.py 已鎖住 compact marker、第一層 runtime 訊號與 explanatory copy hidden contract。
/observability/rag_queries 密集 AI 知識工作台文字密度 guard 已完成:
- 首屏改成 data-density-guardrail="compact-knowledge-workbench"，以「知識命中 / 省模閉環 / 回饋學習」短標籤承接 RAG 召回狀態。
- hero 說明、KPI 小註與頁尾重複標題從可見 UI 退場，保留查詢數、命中率、省模型、回饋分、查詢串流、使用情境品質與命中內容查閱。
- tests/test_rag_queries_text_density_guardrails.py 已鎖住 compact marker、第一層知識訊號與 explanatory copy hidden contract。
/observability/promotion_review 密集 AI 晉升例外工作台文字密度 guard 已完成:
- 首屏改成 data-density-guardrail="compact-promotion-workbench"，以「AI 例外 / 去重守門 / 防污染」短標籤承接知識晉升例外狀態。
- hero 說明、KPI 小註與頁尾重複標題從可見 UI 退場，保留待決策、知識庫、30 日採用、污染攔截、例外佇列、策略權重與最近知識。
- tests/test_promotion_review_text_density_guardrails.py 已鎖住 compact marker、第一層晉升例外訊號與 non-manual wording。
/observability/ppt_audit_history 密集 AI 視覺 QA 工作台文字密度 guard 已完成:
- 首屏改成 data-density-guardrail="compact-ppt-workbench"，以「預覽就緒 / 視覺審核 / 修復閉環」短標籤承接 PPT 產線狀態。
- hero 說明、KPI 小註、runtime/env var、DB/table wording 與頁尾重複標題從可見 UI 退場，保留最新簡報、產線健康度、最近可預覽簡報、工作隊列、視覺問題追蹤與修復流程。
- tests/test_ppt_audit_text_density_guardrails.py 已鎖住 compact marker、第一層視覺 QA 訊號、non-raw wording 與產出紀錄語言。
高可見 AI surfaces route-level HTML readback guard 已完成:
- Flask client 會實際 render /observability/overview、/observability/ai_calls、/observability/quality_trend、/observability/budget、/observability/business_intel、/observability/host_health、/observability/rag_queries、/observability/agent_orchestration、/observability/promotion_review、/observability/ppt_audit_history。
- 每頁都必須保留 compact density marker，且不得回流 PPT_VISION_ENABLED=、PPT_AUTO_GENERATION_ENABLED=、ppt_generation_runs、DB write raw wording、manual/human gate primary wording、Artifact retention / Compact 回讀等產品面 raw engineering copy。
- tests/test_admin_observability_routes.py::test_high_visibility_ai_surfaces_route_html_readback_keeps_compact_contract 已鎖住 route / HTML readback。
高可見 AI surface runtime readback 已完成:
- /api/ai-automation/surface-html-readback 會 read-only 檢查 10 個 AI observability surface contract。
- /api/ai-automation/smoke 已加入 AI surface HTML readback，從 7 項 smoke 擴充為 8 項。
- /api/ai-automation/scheduled-health-summary 已輸出 ai_surface_html_readback family，讓排程健康摘要也能看見產品頁退化。
- 此檢查不寫 DB、不發通知、不要求 browser；失敗時 next machine action 是 repair_ai_surface_html_contract。
整站 UI/UX Agent inventory 已完成:
- /api/ai-automation/sitewide-ui-ux-agent 會掃描真正頁面模板，排除 partial/components/base layouts。
- 當前基線: 55 個頁面模板、31 個高優先模板、29 個 compact guardrail、0 個待專業化 surface、0 個 raw engineering leak。
- /api/ai-automation/sitewide-ui-ux-repair-package 會產生 no-write controlled repair package，優先修復高曝光頁，且不寫 DB、不執行 shell、不讀 secrets。
- 四批 controlled UI/UX repair 已完成 AI observability、AI 建議、PPT/CI/CD/業績/比價/成長/供貨風險高優先 surface，整站 repair package 目前為 no_op。
整站 visual/mobile QA artifact readback 已完成:
- scripts/check_responsive_overflow.js --artifact-output data/ai_automation/sitewide_visual_qa_latest.json 會把 desktop / tablet / mobile overflow QA 輸出為 machine-readable artifact。
- /api/ai-automation/sitewide-visual-qa-readback 只讀 artifact，回報 route_count、viewport_count、failed_count、overflow_issue_count、stale 與 next_machine_action。
- /api/ai-automation/smoke 已加入 Sitewide visual QA readback，scheduled health summary 已加入 sitewide_visual_qa family，/metrics 會輸出對應 Prometheus family status。
- readback 不寫 DB、不送通知、不啟動 browser；artifact 生成才需要 Playwright/瀏覽器，避免把 visual QA 變成產品 API 的重型副作用。

已完成 / 下一步，必須照順序:

對照外部主流 observability / workflow dashboard pattern，將 benchmark 結論固化為 UI guardrails。
增加專業的「今日 AI 自動化狀態」摘要:
- 已自動落地什麼
- 已驗證什麼
- 異動狀態
- 下一個機器動作
增加 route / HTML readback，避免產品頁退回 raw engineering wording。
- 已完成: 高可見 AI observability surfaces 已有 route-level rendered HTML guard。
- 已完成: 高可見 AI surface readback 已接入 runtime smoke 與 scheduled health summary。
啟動整站 UI/UX Agent，將所有頁面依主流專業 guardrails 排序並產生 controlled repair package。
- 已完成: Sitewide UI/UX Agent inventory 與 repair package API。
將 desktop / tablet / mobile visual QA 變成 AI automation artifact 與 runtime readback。
- 已完成: Sitewide visual QA artifact schema、readback API、AI smoke、scheduled family 與 metrics family。

完成標準:

使用者不用讀 log / artifact，就能在第一畫面看到 AI 自動化狀態。
頁面能回答「發生什麼、是否安全、下一步機器會做什麼」。
UI 是專業 dashboard pattern，不是裝飾卡片或空泛 marketing copy。

P2 - External Benchmark And Mainstream Product Practice

狀態: 已完成第一版，後續持續擴充。

目的: 把外部主流專業產品網站 / SaaS / observability dashboard 的做法落到規則與測試。

必須採用的 benchmark 原則:

狀態分層清楚: healthy、warning、blocked、completed。
下一步優先: next machine action 必須比細節更早被看見。
Evidence-on-demand: receipts、hashes、raw payload 放詳細層，不壓在主畫面。
Manual review 是例外處理，不是 primary flow。
產品面不顯示 raw stack traces、provider internals、database naming。
Golden signals: 第一視窗必須能回答已自動落地、已驗證、異動狀態、下一步。
Dashboard-as-code: benchmark 結論必須進 focused tests，不靠口頭記憶。

已完成:

已參考 Grafana、Datadog、New Relic、Atlassian Statuspage 官方資料。
已更新 docs/guides/external_professional_benchmark.md 的 AI automation dashboard benchmark。
已新增 tests/test_pchome_dashboard_benchmark_guardrails.py，鎖住狀態分層、下一步優先、證據按需與 golden signals。
PChome dashboard 第一視窗已新增「今日 AI 自動化狀態」：已自動落地、已驗證、異動狀態、下一步。

下一步:

將同一套 benchmark guardrails 套到 /ai_intelligence 與 /observability/overview。
- 已完成: /ai_intelligence 與 /observability/overview 首屏都有 AI 自動化狀態 golden-signal strip。
- 已完成: 兩頁都明確呈現「已自動落地、已驗證、異動狀態、下一步」。
- 已完成: tests/test_ai_surface_benchmark_guardrails.py 鎖住 DOM、下一步優先與 evidence-on-demand wording。
為後續 safe automation lanes 建立同樣的 first-viewport summary。
- 已完成: /api/ai/pchome-growth/ai-automation-surface-summary 會把 readiness safe lanes 收斂成 golden_signals、safe_automation_lanes、surface_contract、next_machine_action 與 no-write 安全欄位。
- 已完成: /ai_intelligence 首屏改吃 surface summary，不再自行拼接 receipt replay / drift verifier 欄位。

完成標準:

benchmark-derived requirements 已被 tests 或 guardrails 固化。
desktop / mobile 都維持可操作、專業、可掃描。

P3 - Broader AI Automation Expansion

狀態: 進行中。

目的: 把目前 PChome retry mapping lane 的 controlled apply 閉環模式擴展到更多安全場景。

進行中 / 下一步，必須照順序:

將 auto-policy decision closeout 推進到 authorization issuer gate lane。
對其他 safe mapping backlog lanes 套用 receipt / replay / drift verifier 模式。
為每一類 controlled apply 自動產生 rollback evidence package。
把 AI automation metrics 持續整合進既有 observability surfaces。

完成標準:

每個 automation family 都有 preflight、executor、receipt、replay、drift verifier、product readiness。
每條 lane 都有 machine-verifiable evidence，且沒有隱藏人工-primary blocker。

P4 - Source / Deployment Governance

狀態: 持續進行。

目的: 保持 source control、部署、正式環境真相一致，避免版本與環境再次混亂。

持續規則:

Gitea 是 source-control truth。
GitHub 維持 freeze。
不從未驗證分支部署。
不意外 bump version。
不 recreate / destroy / prune momo-db。
source-control success、deployment success、production runtime readback 必須分開回報。
scripts/ops/report_source_deploy_runtime_truth.py 必須可輸出 machine-readable P4 report，明確拆開 local / origin / Gitea refs、部署檔案 hash、正式 /health、容器狀態與安全紅線。

已完成:

Source / deploy / runtime truth report 已建立:
- policy: p4_source_deployment_runtime_truth_v1
- source truth: local HEAD、origin main / dev、Gitea SSH main / dev
- deployment truth: tracked file SHA256 readback
- runtime truth: production /health version/status 與 optional container readback
- safety truth: GitHub freeze、momo-db protected、no --remove-orphans、no secret read、no DB write

完成標準:

每次 push / deploy 都回報 Gitea head、production health、version truth、相關 readback。

Current Work Queue

Priority	Work item	Status	Latest evidence	Next action
P0.1	Controlled apply executor	已完成	`DIRECT_MAPPING_RETRY_EXCEPTION_CONTROLLED_APPLY_EXECUTED`, 4 DB rows	納入 drift verifier 監控
P0.2	Executor receipt	已完成	executor receipt artifact generated	進 compact summary
P0.3	Receipt replay closeout	已完成	`DIRECT_MAPPING_RETRY_EXCEPTION_CONTROLLED_APPLY_RECEIPT_REPLAYED`, readback `4/4`	作為 baseline
P0.4	Product readiness visibility	已完成	`AI_AUTOMATION_CONTROLLED_APPLY_CLOSEOUT_VERIFIED`	接到 UI first viewport
P0.5	Drift verifier	已完成	`DRIFT_VERIFIED`, `drift_count=0`, readback `4/4`	由 monitor 持續檢查
P0.6	Drift verifier artifact	已完成	drift artifact hash match `1`	增加 latest compact readback
P0.7	Automated drift monitor	已完成	smoke check `PChome 受控落地 drift monitor`	納入每日 smoke 與 runtime readback
P0.8	Drift rollback / re-apply package	已完成	drift recovery package route + focused tests	接入 compact readback
P0.9	Compact latest apply / replay / drift / recovery readback endpoint	已完成	compact readback route + focused tests	接入 product dashboard first viewport
P0.10	Controlled-apply artifact retention policy	已完成	retention policy route + focused tests	接入 product dashboard first viewport
P1.1	Dashboard AI automation first-viewport surface	已完成	dashboard command center reads compact + retention packages	P1.2 wording guard
P1.2	UI wording guard for no raw engineering terms	已完成	focused wording guard test	P2.1 benchmark guardrails
P1.3	AI intelligence product evidence guardrails	已完成	detail rows + single product detail expose four evidence cells + focused guard tests	P2 / P3 automation surfaces
P1.4	AI intelligence compact workbench text-density guardrails	已完成	`/ai_intelligence` first viewport and drilldown hide explanatory copy; focused density guard test	P2.2 benchmark guardrails and future AI surfaces
P1.5	Observability compact workbench text-density guardrails	已完成	`/observability/overview` first viewport hides explanatory copy; focused density guard test	Apply density guard to remaining high-visibility AI surfaces
P1.6	AI automation smoke compact workbench text-density guardrails	已完成	`/ai_automation_smoke` first viewport hides explanatory copy; focused density guard test	Apply density guard to remaining high-visibility AI surfaces
P1.7	Agent orchestration compact workbench text-density guardrails	已完成	`/observability/agent_orchestration` first viewport hides explanatory copy; focused density guard test	Apply density guard to remaining high-visibility AI surfaces
P1.8	AI calls compact workbench text-density guardrails	已完成	`/observability/ai_calls` first viewport hides explanatory copy; focused density guard test	Apply density guard to remaining high-visibility AI surfaces
P1.9	Quality trend compact workbench text-density guardrails	已完成	`/observability/quality_trend` first viewport hides explanatory copy; focused density guard test	Apply density guard to remaining high-visibility AI surfaces
P1.10	Promotion review compact AI exception workbench guardrails	已完成	`/observability/promotion_review` first viewport hides explanatory copy and avoids manual-primary wording; focused density guard test	Apply density guard to PPT audit surface
P1.11	PPT audit compact AI visual QA workbench guardrails	已完成	`/observability/ppt_audit_history` first viewport hides explanatory copy and avoids env/table wording; focused density guard test	P1.12 route-level HTML readback guard
P1.12	High-visibility AI surface route HTML readback guard	已完成	10 observability routes render compact markers and block raw engineering wording in Flask client readback	Continue P1 surface sweep and P3 automation expansion
P1.13	Runtime AI surface HTML readback automation	已完成	`/api/ai-automation/surface-html-readback` + AI smoke check + scheduled health family + focused tests	P3 safe lane expansion
P1.14	Sitewide UI/UX Agent inventory and repair package	已完成	55 page templates inventoried, 31 high-priority, 15 controlled repair candidates, 0 raw engineering leaks; first repairs applied to `ai_history` and `ai_recommend`	Apply next controlled UI/UX repairs
P2.1	External benchmark encoded into requirements	已完成	benchmark guide + focused guard test + first-viewport status	P3.1 safe lane expansion
P3.1	Extend receipt / replay / drift pattern to more lanes	已完成	direct mapping candidate decision lane closeout route + focused tests	P3.2 scheduled automation health summaries
P3.2	Scheduled automation health summaries	已完成	`/api/ai-automation/scheduled-health-summary` + smoke service focused tests	P3.3 rollback evidence packages
P3.3	Rollback evidence packages	已完成	controlled apply rollback evidence route + focused tests	P3.4 observability metrics integration
P3.4	Observability metrics integration	已完成	`/metrics` exports scheduled health summary gauges + focused tests; AI surface HTML readback now feeds smoke and scheduled health	P3.5 auto-policy guard monitoring
P3.5	PChome auto-policy authorization guard monitoring	已完成	AI smoke + scheduled family + metrics family read no-write/no-secret/exception-only guard; focused tests	machine fetch evidence / authorization decision preflight lane
P3.6	PChome auto-policy machine evidence decision preflight monitoring	已完成	AI smoke + scheduled family + metrics family prove local contract fixture, no-network machine evidence, decision preflight ready, no DB write, no human primary gate	authorization decision closeout lane
P3.7	PChome auto-policy authorization decision closeout monitoring	已完成	AI smoke + scheduled family + metrics family prove decision closeout ready, post-apply verifier bound, same-run truth required, no DB write, no apply authorization	authorization issuer gate lane
P4.1	Source / deployment / runtime truth package	已完成	`scripts/ops/report_source_deploy_runtime_truth.py` + focused tests	每次 Gitea push / production deploy 後執行 P4 report
P2.2	Benchmark guardrails applied to core AI surfaces	已完成	`/ai_intelligence` + `/observability/overview` golden-signal strips + focused tests	後續 safe automation lanes 套同樣 first-viewport summary

後續回報格式

每次 continuation 必須回報:

current_priority:
- item: ...
- reason: ...

implemented:
- ...

verification:
- tests: ...
- gitea: ...
- production: ...
- artifacts: ...

next_priority:
- ...

33 KiB Raw Blame History Unescape Escape

PChome AI 自動化優先工作清單

不可遺漏的插入需求

優先順序總表

P0 - Runtime Truth And AI Controlled Apply Closure

P1 - Product Visibility And Professional Website Experience

P2 - External Benchmark And Mainstream Product Practice

P3 - Broader AI Automation Expansion

P4 - Source / Deployment Governance

Current Work Queue

後續回報格式

33 KiB

Raw Blame History