Explicit document profiles shared with macdoc: inherit and official

[kiki830621]

Problem

CLI 與 Word MCP 共用 ~/.config/macdoc/config.json；新增文件設定群組、預設 profile 與逐次覆寫介面，不猜測文件是否官方。
— 使用者核准的 PsychQuant/macdoc#185 計畫

Word MCP 的 create_document/open_document/execute_script 缺少共用文件 profiles 入口。

Type

feature

Priority

P2

Expected

新建文件可採 config defaultProfile 或 explicit profile。既有文件／script replay 僅 explicit profile 才變更格式。inherit 不注入字型、保留既有 styles/theme；official 採已匯入的安全格式快照並套標楷體，缺失／損壞 fail-loud。重用 OOXML 層 API，禁止另一套獨立 XML profile 實作，保留 atomic publish／verify-before-publish 與 session 同步。

Actual

create_document 直接建立 WordDocument，open_document 讀取後初始化 session，尚無 profile 決策。

Impact

工具 schema、document/session handlers、script execution adapter、測試與 plugin 使用說明。

Tracking parent: PsychQuant/macdoc#185

---

Current Status

Phase: implemented
Last updated: 2026-09-10 by idd-update

Reviewer dashboard

Key Decisions

• 父案補修完成同步：先前 blocker 已修並由父案驗證；本上游仍開啟，結案／發布不自動執行。
• 下列 FAIL 與較早測試計數均為歷史紀錄，不代表目前仍有該阻擋。
• 父案正式驗證通知：FAIL，重播關聯／格式保留待修正。
• 先前獨立 review 與平台驗收為歷史範圍，不能取代本輪最終 snapshot 的結論。
• macdoc#185 已完成 Mac 與 Windows Word 實際驗收；VM 已恢復暫停。
• 新建採 explicit > config > inherit；既有與 replay 僅 explicit 改格式。
• 失敗 open 回復自己建立的 session；theme 工具讀寫與保存一致。
• 獨立限定範圍複審通過，沒有未處理的 Critical／Important。
• 完整測試 379 項，12 skips，0 failures。

Scope Changes

• (none)

Blocking

• 無父案已知實作 blocker；本上游結案／依賴發布仍待其獨立流程與授權。

Commits

• 9501f61、cae5655、92e66860：replay 關聯回歸與最終證據文件。
• 2fd544a..7c261fa1493bf8ee5331a67ed7884b5563cae0a0。
• 分支 codex/macdoc-185-profile；未推送、合併或關閉 issue。

Dependencies

• 跨平台驗收由 plugin 層的寫作預設：官方文件預設標楷體、其餘沿用 Word 既有預設（參考 che-apple-mail-mcp 的 rules + env 兩層做法） macdoc#185 追蹤；Mac／Windows 均已完成。

[kiki830621]

Implementation Complete

Checklist

• create_document 採 explicit > config > inherit。
• open_document / execute_script 僅 explicit profile 改格式。
• 共用 OOXML DocumentProfileStore 與安全 profile API；缺失／損壞明確失敗。
• profile 在 script staging/verify 前套用，保留原子發布。
• 失敗的 official + autosave open 清理自己新註冊的 session，保護其他 dirty session。
• get_theme/update_theme_fonts/update_theme_color(s)/set_theme_xml 共用有效 theme；保存與重開保留 caller XML 擴充。
• 工具 schema、文件、端到端回歸與獨立審查修補。

Changes

隔離分支 codex/macdoc-185-profile，2fd544a..7c261fa1493bf8ee5331a67ed7884b5563cae0a0。
5 files changed, 421 insertions(+), 20 deletions(-)。
新增 DocumentProfileTools adapter 與測試，更新 Server、ScriptPipelineTools、README。

Verification

最新完整 swift test：379 tests，12 skips，0 failures；總數包含 skips。
最後 theme 集中回歸：37 tests，2 skips，0 failures。
失敗 open 的兩種注入故障先得到 10 assertion failures，修補後 covering suite 49 tests 全通過。
theme 修補前有 12 assertion failures；修補後驗證即時 getter、ordinary/authoring save/reopen、原始 XML 擴充與原始無 theme 文件。

Scope Compliance

重用 OOXML API，未另寫獨立 profile XML 實作。未改使用者實際設定或其他文件。
依賴本機尚未發布的 OOXML d9f1f59 editable；Mac/Windows 視覺驗收由 PsychQuant/macdoc#185 追蹤。
未發布、推送、合併或關閉 issue；既有遠端依賴尚無本次 API。

Sister Bugs Filed

session rollback 與 theme 儲存問題均屬本案整合一致性，已在原範圍修補。

Next: verification pending

仍須正式驗證與上游依賴發布流程。

[kiki830621]

📊 For Reviewer / Collaborator

現在：父案補修已驗證，先前關聯／編碼 blocker 已解除；本上游保持 OPEN。
證據：補修同步。
下一步：依本上游的獨立結案／發布流程處理；不能把本機 editable 當作遠端版本已交付。

last-updated by idd-update at implemented, 2026-09-10

[kiki830621]

Verify (via macdoc #185)

Result: FAIL（依賴修復與重驗待完成）。

父案正式驗證已指出 execute_script 明確套用 official 時依賴的 OOXML authoring/replay 關聯保存 需要修正／回歸。此結論來自凍結 source 的完整呼叫路徑審查；尚未獨立產生含圖片／頁首頁尾的損毀成品，不能把靜態推論寫成 Word 實測。

不要沿用較早「無未解 Important」當成目前正式驗證結論。共用設定／既有平台成品的正向證據仍保留，但最終 tip 的產物鏈與關聯完整性未通過。

本通知不關閉、不發布、不合併此上游 issue。詳情與處置以父案 Verify 為準。

[kiki830621]

Implementation Complete — 父案補修範圍同步

父案 macdoc#185 已依驗證門檻結案。先前的關聯／編碼阻擋已修，不再以舊 needs-fix 通知表示仍未修復。

• CORE 3aa221aa：最後完整 1598 tests／32 skips／0 failures。
• MCP 92e66860：最後 CORE 下 profile focused 11/11；CLI profile 7/7。先前 MCP 全套 380／12 skips 屬前一波，不冒稱本輪全套重跑。
• Mac／Windows 直接渲染 992a3d67 的基本 official 格式；最後核心產物全部 10 parts 經系統 unzip＋diff 獨立證明等價，沒有再次執行 Word。複合圖片／頁首頁尾／連結保存為自動 package 回歸，與視覺驗收分開。
• 非阻擋後續：macdoc#194／bug: refuse release when source tree changes during build #195／Build releases from an isolated source snapshot #196；README 語言鏡像及一般發布說明可在本上游後續流程查核。

本次只同步父案已證實的實作結果，不關閉本上游 issue、不宣稱上游獨立結案／發布已完成。原 remote pins 仍不提供未發布新 API，使用本機 editable；沒有推送、tag、發布或合併。