feat(unified-console): bind #home／#pipeline／#runtime to coordinator runtime truth via shared poller（unified-console-runtime-truth slice 1）

[monkey1sai]

Summary

• OpenSpec change unified-console-runtime-truth slice 1（§1 真值綁定＋§5 測試／設計閘對齊；owner 2026-08-25 口令執行，D1=P）。/ui 預設殼層 UnifiedConsole 的 #home（四 KPI＋六 svc-dot）、#pipeline（五段＋治理／報表列）、#runtime（Kit instance／GPU 未取得／服務健康／事件誠實停用）與頂列 GPU chip 改綁 coordinator :8004 的十個既有端點（/api/runtime/status、/api/conversion/records、/api/minio/objects、/api/external/minio-watch/status、/api/callback-outbox/summary、/api/kit/health、/api/kit/instances/current、/api/governance/issues、/api/governance/rule-runs、/api/external/ifc-ready），經共用 poller store coordinatorStatusStore（每端點單一 in-flight、指數退避 ≤60s、document.hidden 暫停）。不新增端點、不新 HTTP client。
• 誠實模型：data-prov 只用 canonical 七值；data-state ∈ {live, unavailable, offline, error}；只有 live 顯示數字，offline 顯示 —＋未連線，永不以 0 佔位；字面 82%／14.6/24 與原型固定值退出 production 顯示路徑（fixtureNotInProduction.test.ts 符號層守門＋ratchet）。六個假資料 export 移到 test-only；initialIssues 與 docks／WorkspacePage 消費的 4 個 export 留在 production 為 §2／§3 切片欠帳（ratchet 釘住）。
• 設計閘：e2e/design-system-semantic-cases.ts 改為誠實狀態斷言（case id 不變）；home／pipeline／runtime.ops 三屏 golden 依 owner 明示改為產品面誠實 offline 截圖（baseline_provenance.authority=canonical_product_surface，比照 PR test(design): reapprove canonical A4 baseline #429），其餘 10 屏與 workspace.a4.default digest 不變；本機 design gate 13/13 passed（pixel diff 三屏 0）。揭露：design.md §1.2 假設雙旗標 capture 腳本可重拍出產品 offline 態，實際該腳本只重拍設計原型（origin 未變 → golden 不變），故改用產品面升格機制；R-A2 偏離已在此揭露。
• 既有測試翻轉：EdgeConsole.sharedstatus.test.tsx（#home 經共用 poller 呼叫 runtimeStatus）、a1DockLive.test.tsx 解凍、unified.test.tsx KPI 斷言改 mock 值＋offline；新增 12 個 unified 測試檔。
• coordinatorClient.ts：加性擴充 CoordinatorHttpError（與 slice 2 後端 PR 逐字相同，避免 merge 衝突）、kitHealth／governanceIssues／governanceRuleRuns；jsonGet 改丟該型別、message 逐字不變（GitNexus impact HIGH：16 個同檔 caller、0 process；補強＝既有 client 測試全綠）。
• tasks.md §1／§5：只加「本機綠，待 181」子彈、不打勾（UI task 只憑 canonical-linux 181 證據勾選）；openspec/lifecycle-ledger.json／docs/plans/NOW.md 未動。
• spec-to-done：run unified-console-runtime-truth-s1（P1 wf_893ec66a-827、P3 wf_891c0e12-73b／wf_ab83125c-ad1：5 tasks、final review 8 findings → coordinator 修 f1（initialIssues 移回 production，修復 a3 semantic failure case 迴歸）／f4／f2／f3；續跑 run s1-r2：P4 attempt 2 wf_858af6b3-7ae、P5 round 1／2 wf_fad3e444-2b6／wf_da4dd3f7-191（見 Validation）；P4 首輪 wf_ab3ba806-652）→ owner 授權續跑 s1-r2（併 main；P4 wf_2d7339a5-892；P5 wf_fad3e444-2b6：round 1／2 見 Validation 表（fix_now 全閉合；殘 5 項 taxonomy 形式與設計裁決如實揭露））。state：artifacts/spec-to-done/unified-console-runtime-truth-s1{,-r2}-state.md。

AI Coding Governance

Item	Result
Change lane	S
Behavior contract changed	yes
Linked issue	none — owner directive 2026-08-25（/spec-to-done 執行 unified-console-runtime-truth §1）
Requirement source	superpowers spec: docs/superpowers/specs/2026-08-25-unified-console-runtime-truth-s1-design.md（切片自 OpenSpec change unified-console-runtime-truth：design.md §3–§6、tasks.md §1／§5、specs/unified-console-runtime-truth/spec.md「預設入口真值」「十端點綁定＋共用 poller」「設計閘相容」＋ MODIFIED unified-governance-console／edge-console-operator-frontend scenario）
CODEOWNERS / owner review	requested
GitNexus evidence	impact: jsonGet HIGH（16 同檔 caller、0 process，追認）、getL／Dict／UnifiedStateShape MEDIUM、其餘 LOW；per-task impact 已記；detect_changes（--scope compare --base-ref main，index=e6d0213）: 44 files／145 symbols（含 origin/main 合併帶入的 governance docs 與 scripts/agent-tooling 測試）、risk high＝新共用 poller 的扇出（HomePage／PipelinePage／OpsPage → poll／schedule／emit／retain／isHidden，15 個 execution flows），非 auth／session 核心；per-task detect 皆 pass 或 fallback（linked worktree 已知坑，已揭露）
Browser E2E evidence	Playwright — web-viewer-sample/e2e/unified-console-runtime-truth.spec.ts 7 passed ×2（P4 attempt 2 於 88608cb：run A 空 stack→handoff-none；run B executor 以真 API 種入一個 review session→handoff-link；隔離 HEAD stack：本 worktree host-native coordinator :8006＋HEAD dist-ui，非 canonical :8004 亦非 181）；summary.json 如實列 15 項 not-observed；截圖／summary 見 Frontend Verification
Agent workflow changed?	no
Required checks expected	CI / Agent Governance / PR Metadata Contract / design-semantic-visual / functional-runtime-conv

Frontend Verification

Item	Result
Frontend route	/ui#home（總覽）、/ui#pipeline（模型資料與轉檔）、/ui#runtime（Runtime / Kit·GPU）——UnifiedConsole 預設殼層；頂列 GPU chip
Main button(s) tested	#home KPI 卡「活躍 Sessions」（data-action=nav → #sessions，已點擊）；KPI 卡 轉檔中／未結 Issue／Outbox 待送（nav）；「進入生產線 →」；頂列 chips Coordinator／Governance／Kit Runtime／GPU；#pipeline handoff anchor（/ui/open?session=<id>，target=_blank）；「觸發轉檔」disabled（不發請求，附「需 allowlist 來源」原因）；#runtime 事件列 disabled 附原因
Fixture used	none in production path — 全部值來自共用 poller；斷言無 2026-07-14／990_model.ifc／82% 等固定值；本切片未改的殼層靜態字串（頂列 Demo Project – A1 Tower、側欄容器 data-prov="fixture"、頁腳 :8004/ui）與 A1–A4 badge 屬 §2.3 切片，列 Known gaps
Backend API called	GET /api/runtime/status、/api/conversion/records?limit=100、/api/minio/objects、/api/external/minio-watch/status、/api/callback-outbox/summary?limit=200、/api/kit/health、/api/kit/instances/current、/api/governance/issues、/api/governance/rule-runs、/api/external/ifc-ready（皆真 coordinator process，非 mock；每端點初次＋每 10s 一輪、無重疊 in-flight）
Runtime action	共用 poller 輪詢十端點（P4 attempt 2 觀測 runtime id：sessionId=review_session_410bb21f549c（executor 以真 API 種入，#pipeline handoff-link /ui/open?session=review_session_410bb21f549c）、kit id=kit_local_001（/api/kit/instances/current）；run A 空 stack 對照＝handoff-none）；/api/** 503 → 全部 KPI —／未連線、chips 未連線；解除後於退避上限內恢復 live（18–21s）；loading 時先顯示 —（永不以 0 佔位）；KPI nav 導向 legacy 真頁
Visible success state	loading（載入）：首次回應前 KPI 顯示 —／未連線、data-state=offline（永不以 0 佔位，P4 loading 截圖）；success（成功）：KPI 值帶 data-prov=asbuilt data-state=live＋最後更新 hh:mm:ss、chips Coordinator OK／GPU 未取得（unavailable）、六 svc-dot ok／unknown、#pipeline 顯示 kit_local_001（Kit instance）與 review_session_410bb21f549c · active（executor 以真 API 種入的 seed session，非產品流程產生）、#runtime GPU 未取得（非數字）；failure（失敗／錯誤）：/api/** 503 → 全部 KPI —／未連線、chips Coordinator 未連線（offline 截圖）；retry（重試）：503 解除後共用 poller 以指數退避（≤60s）自動重試，18–21s 內恢復 live（recovered 截圖）
E2E command	cd web-viewer-sample && npx playwright test e2e/unified-console-runtime-truth.spec.ts（viewer 由 config 於 :5180 起；coordinator＝本 worktree bim-review-coordinator 以 tsx src/index.ts 於 :8006 起並服務 HEAD dist-ui；E2E_REQUIRE_REAL=1 在此 spec 設計下不可用，skip-free 以 JSON report stats 驗：expected 7／skipped 0）
Screenshot / trace	artifacts/e2e/unified-console-runtime-truth-s1-{home,pipeline,runtime,offline,loading,recovered,sessions-nav}.png＋artifacts/e2e/unified-console-runtime-truth-s1-trace/（7 trace.zip）＋artifacts/e2e/unified-console-runtime-truth-s1-summary.json；tracked 抽樣：docs/evidence/unified-console-runtime-truth-s1/（summary.json＋home／pipeline／runtime／offline）
Design gate status	mixed
Design screen(s)	workspace.a1.default, workspace.a2.default, workspace.a3.default, workspace.a4.default, concept.a5.default, concept.a6.default, concept.a7.default, concept.a8.default, concept.a9.default, concept.a10.default
Reference-missing route(s) / surface(s)	#home, #pipeline, #runtime, #issues, #reports, #viewer, #gpu, #conv, #sessions, #instances, #minio, #admin, #spec, #review
Full completion claimed	no
Design reference manifest	docs/plans/design-system-reference.manifest.json
Visual fidelity result	CI output artifacts/e2e/design-system-visual-result.json
Visual comparison	Chromium DPR 1; 1440x900 + 1920x1080; pixel diff <=1%; semantic parity 100%
Visual artifacts	CI output artifacts/e2e/design-system-visual/<screen>/<viewport>-actual.png + -diff.png
Manual test steps	開 /ui#home → 四 KPI 應顯示 最後更新 hh:mm:ss 與真值（無 2026-07-14）；停 coordinator → KPI 轉 —／未連線；恢復後 60s 內回 live；#runtime GPU 顯示「未取得」非數字；#pipeline 有 session 時 handoff anchor 指向 /ui/open?session=<id>
Known gaps	(1) canonical-linux 181 與本機 :8004 docker 皆仍服務舊 bundle——UI task 勾選留 §6 部署驗收；(2) 空資料狀態未觀測：conversion record 列、governance issue／rule-run id、MinIO watch 啟用、未取得 截斷分支；handoff 分支只以 seed session（無 artifact／participants）走到，/ui/open 目標頁未驗；(3) 殼層靜態字串（Demo Project – A1 Tower、側欄 data-prov="fixture"、頁腳 :8004/ui）與 A1–A4 LIVE badge 屬 §2.3 切片；(4) #pipeline 逐物件 has_source_ifc 列表隨 §2.4（D2 token 輸入）落地；(5) 4 個 docks／WorkspacePage 假資料 export 留 §2／§3（ratchet）；(6) bootstrap ledger 未登記（Get-SelfReferentialMechanismPaths 不含 e2e/**，且 ledger 有 open entry）——spec 5.4 字面未滿足，需 successor 修 spec 措辭或機制清單；(7) 3D／GPU：本切片無 3D 路由，不宣稱任何 3D 完成；(4) design-system reference_missing 路由（無 pixel golden，gate 誠實列出，非 pass）：#home, #pipeline, #runtime, #issues, #reports, #viewer, #gpu, #conv, #sessions, #instances, #minio, #admin, #spec, #review——#home／#pipeline／#runtime 由三段路線第 3 段重新核准 PR 補回，其餘為既有欠帳

Deploy Path Verification

Item	Result
Affects runtime / docker / Kit / viewer / ports / env?	yes — viewer /ui bundle（canonical 部署於 docker build 內 build:ui 重建）；無 env／port／Kit／compose 變更
Canonical deploy path updated?	verified — scripts/deploy.ps1 與 Dockerfile 未改；npm run build:ui 本機成功（dist-ui 不含 GPU/Stream 82%）
New root script added?	no
Deploy dry-run command	not needed — deploy mechanism unchanged（UI 由既有 build 步驟產出）
Full deploy tested	not available — canonical-linux 部署屬 merge 後 §6（owner inventory scripts/dev/rebuild-test-deploy.ps1）
Verify command	cd web-viewer-sample && npx tsc --noEmit && npm run lint:baseline && npx vitest run && npm run test:visual:design-system
Frontend URL verified	http://127.0.0.1:8006/ui#home／#pipeline／#runtime（隔離 HEAD stack；截圖見上）
Evidence path	docs/evidence/unified-console-runtime-truth-s1/summary.json

Self-Referential Bootstrap

Item	Result
Self-referential bootstrap	no
Bootstrap ledger entry	not applicable
Bootstrap reason	not applicable

Validation

Check	Result
npx tsc --noEmit（web-viewer-sample）	exit 0
npm run lint:baseline	trusted=18 baseline=18 current=18 regressions=0
npx vitest run（web-viewer-sample）	89 test files／1175 tests passed
npm run test:visual:design-system（乾淨樹，head 88608cb，#698 之後）	passed — 10 screens（#home／#pipeline／#runtime 為 reference_missing，無 pixel 比對；第三段重新核准 PR 補回）
npm run test:visual:design-system（乾淨樹，head 4e73c10，#698 之前、以升格 golden）	passed — 13 screens；home／pipeline／runtime.ops diff 0；其餘 ≤0.21%（歷史紀錄）
pwsh scripts/tests/verify-design-system-reference.ps1 -VerifyOrigin（88608cb）	passed — 10 screens, 20 golden files（main 現況，#698）
Playwright e2e/unified-console-runtime-truth.spec.ts（P4 attempt 2，88608cb）	7 passed ×2（空 stack／種入 session；隔離 HEAD stack :8006；JSON stats expected 7／skipped 0／unexpected 0）
spec-to-done P5 round 1（wf_fad3e444-2b6，續跑 run s1-r2）	14 registry＋critic 9：fix_now f1／g1／e4／c1／c2／c3 → 修於 5e6d7ce（launcher data-prov=demo、E2E 檔頭誠實、tasks 1.8／5.4／5.5／5.6 同步、golden 移出本 PR）；follow_up f4／f5／f7／e5／e7／e8／c4／c5／c6／c7／c9；known_gap f8／e2；c8 unverified（證據不在 range）
spec-to-done P4 attempt 2（wf_858af6b3-7ae，88608cb）	Playwright 7 passed ×2（空 stack／種入 session）；verticalSliceOk；notObserved 15 項如實列於 summary.json（機械 held=no_browser_evidence，coordinator 裁決揭露）
spec-to-done P5 round 2（wf_da4dd3f7-191，5876bb1）	fix_now=0、external_blocker=0；round 1 六項 fix 全部複驗閉合（f1／g1／e4／c1／c3／c8 refuted）、5.5 三段路線敘述逐項核實；殘餘 5 項因 taxonomy（in_scope 不得為 follow_up／known_gap）機械 review_unverified：HomePage.tsx:6 註解矛盾（已修於後續 commit）、殼層 chrome 既有 fixture 標記（base 已存在、§2.3 欠帳）、e9 loading 與 offline 不可區分（設計裁決交 owner）、tasks 5.4 引用未 tracked 輸出＋過期句（已修）
CI functional-runtime-conv（hifi-token-authority.spec）	769b682／d973a79 紅：unified-home.png 與 fixture 時代 baseline diff 2.73%（#home 改綁真值後預期）→ 以該 CI run 的 actual 重設 baseline（artifacts/e2e/hifi-token-authority/unified-home.png，非 docs/plans reference authority）；token-authority 斷言未動
git diff --cached --check	clean

Known Risks

• jsonGet 改丟 CoordinatorHttpError（HIGH：16 同檔 caller）——message 逐字不變、既有 client 測試全綠；與後端 PR（slice 2a）逐字相同的 class 定義，先合者落地、後合者為相同 hunk。
• 三段 golden 路線（owner 核准 2026-08-26）：test(design): demote home／pipeline／runtime.ops baselines to reference_missing（unified-console-runtime-truth 3-PR route step 1） #698 已把 #home／#pipeline／#runtime 降為 reference_missing（本 PR 期間三屏無 pixel golden，gate 誠實列出）；本 PR 合併後由重新核准 PR 以合併後產品面升格 canonical_product_surface（未完成前缺口持續）；未來版面變動需再走升格流程。
• HomePage／PipelinePage 仍直讀 rt.sessions.*（RuntimeStatus 型別宣告必存在；serviceRows 已防禦）；200 但缺欄位時可能拋錯（P3 f4，低機率）。
• 後補 commit（P4 attempt 2 證據之後，皆非渲染輸出變更）：769b682 HomePage 註解／tasks 5.4 措辭；d973a79 測試 mock 把 http://127.0.0.1:49101 改為非 listener 佔位（production-boundary gate）；hifi unified-home.png baseline 以 CI actual 重設。spec-to-done state 於 5876bb1 停在 HELD@P5 review_unverified，owner 2026-08-26 選 A（接受 coordinator 裁決開 PR）。
• Full completion claimed = no（本 PR 為 slice 1；UI task 待 181 驗收）。

🤖 Generated with Claude Code

https://claude.ai/code/session_0134ZvBvDDUpHSjzjvDZXEBE

[monkey1sai-blip]

{"kind":"ai-bim-automated-approve-only","version":1,"automated":true,"repo":"monkey1sai/AI-BIM-governance","prNumber":700,"headOid":"a246130784d91606ca84a0efd8dc9b7820b2c9c4","baseOid":"e775595479fed594a39ad4766328a95e2ee8b207","action":"approve-only"}