🔴 一頁看完

結論三段：

1. jedi-asset 定形（已完成）。拿資產管理套件當範例，把它整理成「標準形狀」並寫進 SOP §4.3：CM-1676 結構整理（清施工日誌註解、plugin.py 拆五檔、api 拆 guards＋routing、統一 device／information_system 兩型別寫法、entity 改 dataclass、刪零呼叫者模組）；CM-1677 收尾（刪 upsert_by_name、引用計數改明確分派、補 18 支 testcontainers 整合測試、README 落差表、ctx() 改名 runtime()）；CM-1678 資訊系統表補 RLS 四條 policy＋FORCE、devices.tenant_id NOT NULL、enum 值域統一小寫——修好「五個系統狀態只有兩個存得進去」的真 bug。零對外行為變更。
2. 主專案側殘留收斂（FR-090，五棒 Done）。母卡 CM-1682：空殼清理、port 實作歸位、iam 宿主側收斂、補審計暱稱走 D8、接線收成 core/plugins/<pkg>.py 一支一檔。第 6 棒 DI 瘦身 CM-1696 待決策者定規則。詳見 FR-090 README。
3. 21 支套件套用（FR-091，25 卡 Done，2026-09-13）。三批＋三張大卡＋oscal-v2／common 輕量版；另兩條線同日完成：能力點宣告（21 支 80 筆 CAPABILITIES，主專案五條守衛對 seed 127 筆零未歸類）、版面殘留（頂層平鋪／ports 位置／api 四件）。詳見 FR-091 README。

套件側（jedi-asset 版，SOP §4.3）

• plugin/ 五檔：__init__／contract／runtime／assembly／migrations
• api/ 拆 guards.py（runtime()＋三個 lazy decorator）與 routing.py
• 取用執行期組件的函式一律叫 runtime()，不叫 ctx()
• logger 掛 common.jedi_<pkg>
• entity 一律 dataclass，並用 inspect.signature 對照 ORM 欄位（守衛測試維持形狀）

主專案側（FR-090 D1）

• port 實作放 infra/<pkg>/、接線放 core/<pkg>_wiring.py
• 套件上移後 app/<pkg>/ 整個刪
• 補暱稱由套件走 identity port（D8），主專案不寫 wrapper
• 主專案 DI 不重複建套件 service，只給 port

FR-080（母卡 CM-1619，八棒 Done、收口中）是插件化第一、二階段（合併四組、補實五支空殼、清套件間直接依賴）。本案是 FR-069 D8 定的第三階段「既有套件升級插件模式」。2026-09-12 已把 FR-080 的「發版推 Nexus、pin 還原、SPEC 頁更新、release note」四項移出歸本案，等 18 支整理完一次做（已寫進 CM-1619 末段）；FR-080 只收 code review、e2e 假綠、母卡與 design.md 收 Done。

出貨 image 只複製主專案 scripts/init/ 與 scripts/sql/，完全不碰套件自帶的 migrations/ 目錄——套件隨包的 migration 客戶端永遠套不到。CM-1678 的 002（RLS 四條 policy＋enum 小寫）目前只存在 jedi-asset 內，三環境與出貨基線都還帶著 enum bug。要做兩件事：① 另開卡評估「宿主自動撿套件 migration」機制；② CM-1678 的 002 內容在主專案 scripts/sql/ 另放一支（走 sql-migration skill，只套 DEV）。

2026-09-12 決策者裁定（起因：看到 app/auth/ 下九個檔問「不是已經拆成 iam 了嗎，怎麼還在」）：

• 全部做法統一——套件側 19 支各長各的、主專案側四種並存做法，都收成 jedi-asset 那一種。
• enum 值域走 A 案「統一小寫」——DB CHECK 與程式端寫入值對齊小寫，migration 只加不破。
• 先做主專案側再做 18 支——18 支每支都要確認主專案有沒有重複給工廠／port，主專案先清乾淨卡才寫得準。
• ctx() 改名 runtime()——「取執行期組件」比「context」貼切，且避免與 jedi-iam 的 IdentityContext 撞名。
• FR-080 四項移出歸本案——發版、pin 還原、SPEC、release note 等 18 支整理完一次做。

• 套件：~/Projects/Jedicogy/module/jedi-python-package/（形狀範本 jedi-asset/），branch feature/FR-075
• 主專案：infra/<pkg>/、core/<pkg>_wiring.py、test/test_module_boundaries.py，branch feature/FR-075
• 設計源頭：FR-069 design.md D8；FR-080
• skill：jedi-package-dev（path dependency）、sql-migration

• for-pm.md — 給 PM 的白話說明：零技術名詞，講為什麼要做、做完長什麼樣、對交付的意義與還沒做的事（CM-1736）
• plugin-anatomy.md — 插件解剖（工程師版）：袋子比喻、port/adapter 誰在哪、主專案接線六個檔、DI 與 runtime 的關係、設計模式對照、harness；末段「2026-09-13 之後的更新」補能力點清單、主專案守衛、版面四條

以下全部由 build 掃資料夾產生，新增檔案重 build 即自動出現。標題連結指向渲染後的 HTML，md 連向源檔。

其他文件

交接與收口時間軸（handoff/，2 份）

由新到舊。每份是某一棒次交接當下的完整現況快照，看某個時間點「當時知道什麼」請從這裡進。

卡片內容（決策紀錄、驗收條件）以 Notion 為準，本頁只記座標。

相關需求：

• FR-069 — jedi-module-extraction
• FR-080 — jedi-consolidation-and-service-path
• FR-090 — host-side-residue-cleanup