REC e2e fixture 可移植性 — ooxml-swift 測試跨 repo 引用 gitignored test-files/，standalone clone 靜默 XCTSkip

[kiki830621]

Problem

RawChannelSlotTests 的 REC e2e 測試曾以 #filePath 往上跨 repo 引用 gitignored private fixture，standalone clone／CI 只能靜默跳過。

Type

refactor

Expected

REC 與 thesis 真實 fixture 皆透過明確 environment gate 提供；預設 hermetic 測試維持強制，opt-in fixture 缺少時訊息必須可操作且不可洩漏主機路徑。

Cross-repo implementation

• PsychQuant/ooxml-swift#118 — REC fixture gate（verified）
• PsychQuant/ooxml-swift#120 — thesis fixture gate（verified）
• PsychQuant/ooxml-swift#119 — 等待人工合併
• 合併後更新 macdoc 的 ooxml-swift dependency pointer 並執行父層驗證

---

Current Status

Phase: implemented (upstream verified; awaiting merge)
Last updated: 2026-08-31 by idd-verify

Key Decisions

• 使用既有 MACDOC_TEMPLATE_DIR / TemplateFixtureGate；不提交 private 文件。
• Hermetic raw-channel tests 保持 mandatory；真實 REC／thesis tests 為 opt-in 且 loud skip。
• Missing fixture 訊息只列環境變數與精確檔名，不列實際 host directory。

Scope Changes

• 上游實作集中於 ooxml-swift PR MCP release pipelines: add pre-upload signature-verification gate (verify follow-up from #112) #119；macdoc REC e2e fixture 可移植性 — ooxml-swift 測試跨 repo 引用 gitignored test-files/，standalone clone 靜默 XCTSkip #172 保持 cross-repo tracker。

Blocking

• 等待人工合併 PR MCP release pipelines: add pre-upload signature-verification gate (verify follow-up from #112) #119；本流程不自動合併。
• 合併／release 後才能更新 macdoc dependency pointer，完成父層 verify。

Upstream Evidence

• PR head 3d81a45
• Full suite: 1,444 tests, 32 conditional skips, 0 failures
• CodeQL: PASS
• Five reviewers + Codex CLI: PASS

[kiki830621]

Diagnosis

Type

refactor

Root Cause / Analysis

RawChannelSlotTests.recFixtureURL() 由 #filePath 向上走四層，假設 ooxml-swift 永遠嵌在 macdoc checkout，接著讀取 root test-files/REC-O-01-*.docx。該檔 gitignored 且不屬於 ooxml-swift，因此 standalone clone／CI 只能 skip；skip 訊息只有硬編路徑，沒有告知如何提供 fixture。

同 repo 已有 TemplateFixtureGate.requireTemplate，用 MACDOC_TEMPLATE_DIR 明確 gate private Word template；#172 應採同一契約，而不是複製私有文件。Hermetic table/raw-slot tests已涵蓋 locator、byte-equal、substitution與 corruption guards，故 CI 不因 private fixture 缺席失去全部行為覆蓋。

Impact

• Primary implementation：refactor: gate REC raw-channel fixture without parent-repo paths ooxml-swift#118。
• 影響三條 REC E2E：default replay、substitution、full paraId sweep。
• 不影響 production library；只修測試可攜性與 skip 診斷。

Strategy

• 以現有 TemplateFixtureGate 解析固定 REC filename。
• 移除 parent-repo traversal 與 gitignored macdoc path假設。
• 加入 gate helper unit coverage與source guard，防止跨 repo path回歸。
• 跑 RawChannelSlot／TemplateFixtureGate focused與full suite。

Conflict Class

C_independent — test-only helper與單一 fixture resolver；與 #115 production change分支隔離。

Complexity

Simple — 不改 public API／production行為／frozen capability。

Sister Concerns Filed

• refactor: gate REC raw-channel fixture without parent-repo paths ooxml-swift#118

[kiki830621]

Implementation Complete (via upstream)

• Upstream child：refactor: gate REC raw-channel fixture without parent-repo paths ooxml-swift#118。
• PR：test: gate private cross-repo fixtures explicitly ooxml-swift#119。
• Commit：c641d32。
• Full ooxml suite：1,443 tests，31 skips，0 failures。

macdoc root 無 production code change；#172 等 upstream verify／merge 後再更新追蹤狀態。