🔴 一頁看完

結論三段：

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 一支一檔、主專案自有 35 筆能力點開申報處。20 支套件全部從 core/plugins/ 掛載，形狀一致。剩 DI 瘦身走 B 案（套件開 host_services() 取用口，主專案不再直綁套件 DI）：CM-1749（套件側）→ 1750（主專案 48 處）→ 1751（文件），併 jedi 1.1.0。詳見 FR-090 README。
3. 21 支套件套用（FR-091，28 卡 Done）。三批＋三張大卡＋oscal-v2／common 輕量版；另兩條線：能力點宣告（21 支 80 筆 CAPABILITIES＋主專案 35 筆，五條守衛對 seed 零未歸類）、版面殘留（頂層平鋪／ports 位置／api 四件）。收口後 arc review 兩 Critical 六 Important 全修，21 支出版 1.0.1。詳見 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 定案，SOP §5.1）

• 一支套件一個檔 core/plugins/<pkg>.py：port 實作（adapter）、填表、掛載三段同檔，接手的人一個檔看完
• 掛載一律走 core/plugins/__init__.py 的 PLUGINS 清單，app_factory 一個迴圈掛全部；Plugin(..., capabilities=) 必帶
• 套件上移後 app/<pkg>/ 整個刪，不留殼
• 補審計暱稱只有一條路：套件側 jedi_common.identity.fill_user_names、主專案側 common/util/audit_nickname.py，都經 D8 IdentityContext
• 主專案 DI 不重複建套件 service，只給 port（DI 瘦身 B 案落地後改由 host_services() 取用）

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。

• 出貨升級鏈（FR-093）：本案查出出貨 image 只讀主專案 scripts/sql/，套件自帶的 migrations/ 客戶端永遠套不到，能力點與選單也不會自動到位。已獨立成 FR-093（母卡 CM-1752，十棒），進行中。
• 租戶隔離（FR-094）：jedi-asset 002 補 RLS 時連帶盤出 13 張表隔離沒開，獨立成 FR-094（母卡 CM-1766，八棒），待派。

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
• 主專案：core/plugins/<pkg>.py（20 支）、core/host_capabilities.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 的白話說明：零技術名詞，講系統長什麼樣、零件怎麼裝、對交付的意義與還沒做的事
• plugin-anatomy.md — 插件解剖（工程師版）：五個詞、袋子比喻、guards.py、每個檔放什麼、主專案怎麼接、port 與 adapter、新手教程、DI 與 runtime、複雜度、設計模式、harness、一個 request 的旅程

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

說明與手冊

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

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

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

相關需求：

• FR-069 — jedi-module-extraction
• FR-080 — jedi-consolidation-and-service-path
• FR-090 — host-side-residue-cleanup
• FR-091 — package-shape-rollout
• FR-093 — package-migrations-and-capability-seeding
• FR-094 — tenant-isolation-fix