fix(console): coverage 抽屜標註 usd_stage_enumeration 自我參照（避免 100% 誤讀為 IFC lossless）

[monkey1sai]

背景

#218（conv-coverage-report, M2-a 唯讀 passthrough）部署後，多 agent 交叉對抗驗證（Opus xhigh 反方）發現一個真實語意 nuance：

coverage_ratio=100% 在 materialization_strategy=usd_stage_enumeration 下是自我參照——source_ifc_entity_count 與 mapped_count 同源於同一次 USD stage prim 枚舉（adapter 端 source_count = len(mapping_items) = mapped_count），數學上結構性恆等於 1.0。意義是「枚舉到的都對映上」，並非對 IFC 原始 entity 全量的 lossless 覆蓋率。

資料值為真、passthrough 也誠實（coordinator 零計算、轉檔失敗誠實回 null），但 UI 未對此本質加註，使用者可能把 100% 誤讀成「IFC 零遺漏」。

修正

web-viewer-sample/src/console/pages.tsx 的 CoverageDrawer：

• materialization_strategy === "usd_stage_enumeration" 時，新增誠實 caveat note（紅色 ec-warn-note，data-testid=conv-coverage-selfref-note）。
• 同策略下 source 欄標籤 source IFC entity → source（USD 枚舉 prim 數）。
• 其他策略（如 sidecar）行為不變（caveat 不顯）。
• 數值不變，仍為真；僅補語意誠實標註。真 IFC 分母為 M2-b follow-up。

驗證

• npm run build 綠（129 modules）
• npm run test 249 passed（含新增正向 caveat 測試 + sidecar 負向守門）
• GitNexus detect_changes：risk=LOW、0 affected processes
• 瀏覽器實證：新 build 餵真 demo_lib payload（coverage 100% / 543 / usd_stage_enumeration），caveat + 改寫標籤正確渲染

🤖 Generated with Claude Code

[coderabbitai]

Warning

Review limit reached

@monkey1sai, we couldn't start this review because you've reached your PR review rate limit.

More reviews will be available in 55 minutes and 6 seconds. Learn how PR review limits work.

Your organization has used up its prepaid credits, and credit purchases are no longer available. Enable the review add-on in the billing tab to keep reviews running — you're only billed for reviews past your plan's rate limits ($0.25/file).

⌛ How to resolve this issue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans include higher PR review limits than trial, open-source, and free plans. In all cases, reviews become available again over time. During sustained high-volume PR review activity, CodeRabbit may temporarily slow when the next review becomes available.

Please see our Fair Usage Limits Policy for further information.

ℹ️ Review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: a22bc814-f3c2-4a9f-94a1-b04a7390135f

📥 Commits

Reviewing files that changed from the base of the PR and between 81ba1df and e0b4752.

📒 Files selected for processing (2)

• web-viewer-sample/src/console/ConversionSchedulingPage.test.tsx
• web-viewer-sample/src/console/pages.tsx

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch fix/conv-coverage-selfref-annotation

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[Copilot]

Pull request overview

This PR adds a semantic caveat annotation to the CoverageDrawer component in the Edge Console's conversion scheduling page. When the materialization_strategy is usd_stage_enumeration, the coverage ratio is structurally always 1.0 (self-referential — source count and mapped count derive from the same USD stage prim enumeration). Without this annotation, users could misinterpret 100% coverage as meaning zero IFC entity loss, which is not what the metric represents in this strategy.

Changes:

• Conditionally renders a warning note (ec-warn-note) when materialization_strategy === "usd_stage_enumeration", explaining the self-referential nature of the coverage ratio.
• Relabels the source field from "source IFC entity" to "source（USD 枚舉 prim 數）" under the same condition.
• Adds a positive test case verifying the caveat appears for usd_stage_enumeration, and a negative assertion in the existing sidecar test ensuring it does not appear for other strategies.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated no comments.

File	Description
web-viewer-sample/src/console/pages.tsx	Adds usdEnumSelfRef flag and conditional caveat <p> + source label rewrite in CoverageDrawer
web-viewer-sample/src/console/ConversionSchedulingPage.test.tsx	Adds positive test for usd_stage_enumeration caveat rendering and negative guard for sidecar strategy

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[github-actions]

PR Review Agent Summary

Field	Value
Status	blocked
Risk	high
PR	220
Head	fix/conv-coverage-selfref-annotation / e0b4752b04c7e8b3b5c8552b5783ce2e6503117c
Base	main / 81ba1df33a7fabdb3384b1f8189dfea55c456682

Blockers

• [high] Behavior, workflow, code, or repo-boundary changes require an OpenSpec change id or documented exception.

Warnings

• [medium] GitNexus detect changes did not pass: warning.

Validation Commands

• npm run verify

Checks

• passed web-viewer-sample verify (web-viewer-sample)

Human Review Notes

• Optional AI adapter is not required by policy and was skipped.