Skip to content

v0.7.0

Choose a tag to compare

View all tags
@github-actions github-actions released this 30 Aug 08:17
· 9 commits to main since this release
v0.7.0
785ebde

Changelog

All notable changes to pi-codex-marketplace are documented here. Format follows Keep a Changelog and SemVer (starting at 0.1.0; Git tags v* mirror npm versions).

[0.7.0] - 2026-08-30

Added

  • 分層、狀態感知 autocomplete（#121–#124，文件 #125）：/codex-marketplace 以 Pi 原生 autocomplete 提供兩層候選——純文字指令表面與輸出語意不變，autocomplete 只是 discoverability 與輸入效率層：
    • 根層九個候選（#121）：輸入完整 /codex-marketplace 後按 Tab，顯示 add／list／install／update／disable／enable／remove／forget／help 與說明，不分大小寫模糊搜尋；需參數的子命令套用後補尾隨空格，update／help 不加。
    • 第二層狀態感知候選（#122–#124）：再按一次 Tab 依 Bridge State 只列當下可執行選項——install 只給可安裝／可重裝 plugin（不含 Unavailable Entry，同名含 unavailable sibling 改插 enumeration 編號）；enable 只列已停用、disable 只列已啟用、remove 列全部已安裝 Installation；list／forget 列 Marketplace Registrations（名稱無法唯一解析依序改插唯一可解析的 alias、其次 Registration id）——描述顯示 marketplace／格式／狀態來源。
    • add 保持 Pi 原生（#124）：不提供 Bridge 候選，Tab 委派 Pi 原生路徑 completion，Git locator 維持自由輸入。
    • terminal-only 且被動：provider 只在 TUI session 註冊（RPC／JSON／print 模式不受影響）；候選被動讀取 Bridge State，不重置／重寫損壞文件；未屬 Bridge 的輸入原樣委派 Pi 既有 provider（其他 slash 指令、文字、檔案補完）。
    • 文件與回歸驗證（#125）：README 新增 Autocomplete 章節（兩層 Tab 流程、狀態篩選與歧義處理、add 委派、明示無 custom TUI／自動二層 selector、純文字輸入保留）；Pi adapter 測試涵蓋 command completion registration、exact-command interception、第二次 Tab、completion application 與 previous-provider delegation；全部 typecheck／unit／integration／E2E／acceptance 全綠。

Fixed

  • CI acceptance gate 失效修復：acceptance step 改跑 test:acceptance matrix runner——原 step 引用已退休的 tests/unit/registration/git-selector.test.ts 且以 pipe 遮罩失敗，實際未擋任何列。

[0.6.2] - 2026-08-29

Fixed

  • Marketplace root plugin path (#118)：允許 catalog plugin 以 ./ 指向 marketplace 根目錄本身，同時維持 canonical containment 與 symlink 逸出防護。

[0.6.1] - 2026-08-29

Fixed

  • Git snapshot contained symlink (#117)：canonicalize 暫存來源根目錄後再檢查 symlink containment，避免 macOS /var → /private/var 導致 root 內 symlink 被誤判為逸出；同時封鎖指向 FIFO 等 special file 的 contained symlink。

[0.6.0] - 2026-08-29

Added

  • 開箱即用自動偵測 (#117)：add／update 未設 PI_CODEX_MARKETPLACE_CREDENTIAL_HELPERS 時，自動偵測固定白名單（gh CLI 已登入 → !gh auth git-credential；macOS osxkeychain；git credential-store）並逐次核准——私有 HTTPS repo 不再需要先設環境變數；env 顯式設定完全覆蓋自動偵測；認證失敗診斷擴為三態（none／detected／approved）。（ADR 0006 修訂、CONTEXT.md 詞彙同步）
  • GIT-35 helper 名稱無效診斷：PI_CODEX_MARKETPLACE_CREDENTIAL_HELPERS 設了非原生 helper 名稱（如直接寫 gh）時，錯誤訊息指出正確寫法（原生 helper 名稱或 !gh auth git-credential），不再誤導為「檢查登入」。

[0.5.0] - 2026-08-29

Added

  • Credentialed Acquisition (#109)：以 PI_CODEX_MARKETPLACE_CREDENTIAL_HELPERS 環境變數（逗號分隔的 git credential.helper 字串）逐次核准 credential helper，add 與 update 共用同一核准來源——解析結果以既有 trust options 傳入 Git 取得，底層不讀環境變數；未設定或空白＝未核准，行為與 credential-free 完全相同；憑證與核准清單永不進入指令輸出、Bridge State、快照指紋或 cache 位址。（ADRs/0006、CONTEXT.md 詞彙補齊）
  • 認證失敗診斷 (#110)：Git 401 依核准狀態分兩變體訊息——未核准 → 提示設定 PI_CODEX_MARKETPLACE_CREDENTIAL_HELPERS 或改用 SSH 定位器；已核准仍失敗 → 提示檢查憑證（gh auth status／keychain）；ls-remote 與 clone 的 not-found 分支一致分類。

Changed

  • README 私有 repo 支援文件 (#111)：add 指令表格補環境變數用法與範例，安全線段落補 Credentialed Acquisition 語意（per-invocation、永不持久化、憑證不入 locator/snapshot/cache identity），新增 SSH 定位器作為私有 repo 替代路徑的說明（known_hosts 前提、StrictHostKeyChecking=yes、BatchMode=yes），詞彙與 CONTEXT.md 正典一致。

0.4.0 - 2026-08-29

Added

  • 極簡骨架：runCommand 縫＋薄 Pi adapter＋極簡 Bridge State＋總覽/help (#88)：
    • 新增 src/bridge/state.ts：極簡 Bridge State（schemaVersion＋registrations＋installations），atomicWriteWithLock 寫入防護與壞檔／未知格式自動重置。
    • 新增 src/bridge/command.ts：純 Node 可測試的 runCommand(argv) 分派縫，九個子命令、無參數總覽、help 與未知命令用法提示。
    • extensions/pi/index.ts 收斂為薄 Pi adapter（輸出導向 ctx.ui.notify、依 reload 旗標觸發 ctx.reload()、維持 resources_discover 投影）。
  • add 本機 codex marketplace 註冊與 list 顯示 (#89)：add <路徑> 以 local realpath 計算 Source Key、格式偵測（codex 優先）、解析 catalog、重複註冊拒絕（提示「想更新？update；想換？先 remove 再 add」）；list 顯示已註冊 marketplace（名稱／格式／來源）並支援 [名稱] 過濾；catalog 缺失或 malformed 顯示錯誤、不註冊、不寫入。
  • install 本機 codex plugin (#90)：list 顯示 plugins（編號／所屬 marketplace／狀態：可安裝、已裝啟用、已裝停用）；install <編號> 走 contained path 檢查 → 讀 manifest name → 寫入 enabled installation → 投影推導 → 回傳 reload 旗標；同名衝突逐項列出「未投影（名稱衝突）」；重複 install 視為重抓最新覆寫；無 skills 的 plugin 照裝並明說 0 skills；真 Pi host e2e 驗證 install → reload → resources_discover 回傳含該 plugin skill 的 skillPaths。
  • claude 雙格式 open 政策 (#91)：claude catalog 解析改採 open 政策（未知欄位一律忽略不 block，含 renames/$schema/metadata）；runCommand add/list/install 與 codex 同一條解析鏈與 install 路徑；catalog 內 git 型／不支援 source 型 entry → list 顯示 unavailable＋原因、install 拒絕；同資料夾雙格式並存 codex 優先；exposure 技能推導 manifest.skills 優先、缺席時 fallback 掃描 skills/ 目錄。
  • Git marketplace (#92)：add <GitHub 完整網址|owner/repo>——HTTPS 正規化（拒絕內嵌憑證／明文傳輸／query＆fragment）→ ls-remote HEAD → clone → checkout → 讀 catalog → 記入 registrations；重複註冊同 canonical URL 拒絕；安全線保留（hooksPath=/dev/null、LFS skip、終端提示禁、StrictHostKeyChecking）；git plugin install 與本機同一條路徑、投影材料直讀 fingerprint 位址化的 cache entries（此位址不可換成別種身份值）。
  • disable／enable／remove／forget＋總覽狀態 (#93)：disable <名稱> 停用（不再投影、下次 discovery pass 自然消失）、enable <名稱> 重新投影＋reload、remove <名稱> 移除單支 plugin（不動 marketplace、不動來源資料）、forget <名稱> 移除整個 marketplace（含其全部安裝）；無參數總覽反映 marketplace 與 installed 狀態。
  • update：全部 marketplace 重抓最新 (#94)：對全部已註冊 marketplace 重新抓取當下最新（本機重讀／git 重抓），有變化的 plugin 升到最新並以「已重新載入生效」收尾，無變化的各自顯示「無變化」；投影指向最新材料。語意上「重裝＝更新」，不引入任何更新計畫機械。

Changed

  • 文件收斂＋全綠收尾 (#97)：
    • CONTEXT.md 移除僅描述已退場機械的詞彙（Git Selector、Validation Ruleset），修正 Validation Snapshot／Validation Budget 描述至極簡現狀（指紋不再綁 ruleset/budget 字串；budget 為固定常數限制），存活詞彙全部保留並同步至最新語意（Resolved Revision 僅 HEAD、Source Key 固定 default selector）。
    • ADR 收斂至與極簡一致：0001（投影縫）與 0003（雙格式偵測 codex 優先）標記仍生效並改寫退場機械引用（receipt／Retry Application／Project Scope layering／Refresh／Update Plan）；0002（Global-only）標記部分仍生效並註明生命週期機械後續退場；0004／0005 維持 superseded 並更正拆除範圍（#95/#96、parseGitEntrySpec 已移除）。
    • README 持續反映新指令表面與極簡承諾（九子命令、重建＝重置、無 repair／migration／State Revision）。
    • 全專案 typecheck＋測試全綠（CI gate 維持）。

Removed

  • 拆防損毀／生命週期機械＋舊 TUI 殘餘 (#95)：
    • 移除 receipt／fence／journal／State Revision／CAS／repair／startup reconciliation／migration／refresh／update／update-plan／rebind 機械及其對應測試（src/journal/、src/lifecycle/、src/reconciliation/、src/bridge-state/{migrate,repair,schema,store,types}.ts、src/installation/、src/compatibility/、src/projection/{runtime,effective-state}.ts、src/registration/{fence,receipt,flow,git-flow,registration}.ts）。
    • 移除舊 TUI 殘餘與重疊舊 extensions（bridge ledger、transaction sheet、journal view、effective-state view、ui-strings、terminal-presentation 等）；extension 收斂為薄 adapter（runCommand＋resources_discover）。
    • 存活消費者收斂：投影僅讀 Minimal Bridge State、Source Cache pinning 讀極簡 state、Entry Acquisition 收斂為 entry-spec 純解析（git 家族 entry 一律 unavailable 不取得）。
    • CONTEXT.md 詞彙與 README 收斂至極簡表面；ADR 0004／0005 標記 superseded。
    • 全專案 typecheck＋存活測試全綠。
  • 拆讀取／分類退場 (#96)：移除 entry-acquisition（外部 git entry 收編＋pin 矩陣）、git-selector（pins）、compatibility v2 儀式（atomic 三分法分類、Agent Profile 解析、resources 掃描、captureFingerprint、ruleset/budget/profile 字串常數）及其測試；catalog 內 git 型／不支援 entry 的 unavailable 行為維持（#91）。

0.3.0 - 2026-08-27

Added

  • R2 文件落地（ADR 0005、Entry 術語） (#52)：
    • CONTEXT.md 新增 Entry Acquisition 與 Entry Pin 正典詞條，並同步更新 Marketplace Entry、Acquisition Trust Base 與 Unavailable Entry 描述。
    • 新增架構決策記錄：ADR 0005（0005-entry-acquisition-trust-boundary.md），詳述 Entry 級取得之信任邊界（重用既有 Acquisition Trust Base）、零執行安全承諾、command 來源永久不合格理由、HTTPS shorthand 正規化、Pin 矩陣映射與漂移更新語意。
  • Entry Acquisition 接入雙格式與 Refresh 流程 (#51)：
    • 接合 Claude marketplace github/url/git-subdir 與 Codex git-kind 條目取得。
    • 於 Registration Confirmation 持久化每項 entry 的 entrySnapshots 獨立快照。
    • 整合 Marketplace Refresh：可動 ref 在上游漂移時產生 Update Candidate，sha-pinned 條目不產生 candidate；Update Plan 與 Apply Update 實施原子處置與快取 pin 保留。
    • npm、archive 與 command 來源一致披露為 Unavailable Entry。
  • Entry Acquisition 引擎（git 家族 entry） (#50)：
    • 實作格式中立的 Entry 級取得引擎（src/registration/entry-acquisition.ts）。
    • 支援 github（含 owner/repo shorthand 展開為 canonical HTTPS 定位器）、url、git-subdir（含子目錄 containment 驗證）。
    • Selector 映射與 Pin 矩陣：sha→commit、ref→branch/tag、皆無→可動 default；並存時 sha 為有效 pin、ref 僅作格式檢驗。
    • 嚴格 Acquisition Trust Base（StrictHostKeyChecking=yes、core.hooksPath=/dev/null、GIT_LFS_SKIP_SMUDGE=1）與 Validation Budget fail-closed 約束。
    • 批次取得原子性：任一 entry 失敗或超限即整批 fail-closed 並自動清理暫存目錄。
  • R1 文件落地（CONTEXT.md、ADR×2、README） (#49)：
    • CONTEXT.md 術語修訂與新增：Marketplace Catalog 收編 .claude-plugin/marketplace.json、Compatibility Profile 改述 v2 雙格式契約、Marketplace 與 Plugin 去除 Codex-format 限定、Unavailable Entry 擴充結構化原因分類表、Skill Agent Profile 明示 Codex 專屬（Claude 下視為一般 Skill Resource）、新增 Marketplace Format 正典詞條。
    • 新增架構決策記錄：ADR 0003（雙格式偵測與 codex 優先）與 ADR 0004（統一 Compatibility Profile v2 取代凍結 v1）。
    • README.md 與 package.json 描述全面更新反映 Codex 與 Claude 雙格式支援（套件名稱與 /codex-marketplace 指令維持不變）。
  • Claude 外掛完整生命週期與驗收劇本 (#48)：
    • Claude 安裝生命週期完備：Install Disabled 建立 disabled 狀態（無須 Activation Confirmation）；啟用經由 preflightPluginEnable 重新驗證並要求 Activation Confirmation（Default No）。
    • Runtime Application 與投影：安裝啟用後 projectEffectiveState 及 discoverProjectedSkillPaths 動態貢獻 Claude plugins 的宣告技能目錄，並遵循 Pi → Global 優先序。
    • Runtime Skill Collision 如實裁決：本地 Pi 原生 skill 優先保留，碰撞之 Bridge 候選標示為 unavailable-collision，未碰撞技能正常投影，外掛分類不受影響保持 Compatible。
    • Refresh 與 Update Plan：上游變更產生 format-bound Update Candidate；buildUpdatePlan 與 applyUpdate 遵循全有全無原子提交，要求重新 Registration Confirmation 與 Activation Confirmation。
    • Registration Removal 連帶級聯同 registration 下所有 Claude Installations，Global Scope 其餘註冊與安裝不受波及。
    • 驗收劇本與測試：以 mattpocock-shaped fixture 完整驗證相容外掛、技能列出、同名碰撞與 TUI transaction-flow。
  • 格式偵測接入登記與瀏覽流程（local + git） (#47)：
    • 掃描 Marketplace Root 決定性推導 Marketplace Format（codex 優先；兩種 catalog 並存時自動採用 codex，無額外提問）。
    • 僅含 .claude-plugin/marketplace.json 的 repo 全程可登記：format=claude 固化於 Registration；兩者皆無時 CATALOG_MISSING 行為不變。
    • 驗證披露、Registration Confirmation 畫面與 Attempt Receipt（Transaction Sheet、Receipt Journal、Attempt Summary 通知）顯示 Marketplace Format。
    • 瀏覽（Bridge Ledger / 安裝選單）讀經註冊格式：Compatible entry 顯示外掛與技能清單，不合格 entry 顯示 Unavailable 原因；上游格式翻轉不被靜默採用，僅經 Marketplace Refresh 產生的 Update Candidate 加上明確 Apply Update 變更。
    • transaction-flow 測試以 mock Git executor 完整登記仿 mattpocock 夾具成功。
  • Claude catalog 結構解析器 (#46)：
    • 實作 .claude-plugin/marketplace.json 結構解析器與 fail-closed 欄位政策。
    • 雙格式 Marketplace Entry ID 一致收斂為 /plugins/<zero-based ordinal>。
    • 第一天本地相對路徑（./ 開頭）分流為 locatable entry，非 git 家族、entry-defined (strict:false)、bare name/pluginRoot 與外部 git 來源產生結構化 Unavailable Entry 原因，command 來源永久不合格。
  • Compatibility Profile v2 (#45)：
    • 推出單一統一 Compatibility Profile v2 與 Validation Ruleset v2，收斂 Codex 與 Claude 雙格式外掛契約。
    • Manifest 欄位三分法：未知欄位 fail-closed Blocking、主動元件 Blocking、已知慣性呈現欄位 Validation Warning；Claude entry metadata 物件視為 Inert Metadata。
    • SKILL.md frontmatter 實施白名單（僅允許 name, description, disable-model-invocation）。

Changed

  • Bridge State Schema v3 + format 屬性遷移 (#44)：schemaVersion 升為 3。
    • Registration 記錄新增 Marketplace Format 屬性（codex | claude）——本票只鋪持久層地基，格式偵測與 claude 解析由後續票交付。
    • v2 → v3 WAL migration 為既有 Registration 自動補上 format=codex 預設值，內容零損失（已宣告的 codex | claude 值原樣保留）。
    • 新寫入的 Registration 可承載 format=claude 並正確回讀。

0.2.0 - 2026-08-26

Removed (Breaking)

  • Project Scope 與多範圍架構退休（Global-only simplification） (#58, #61, ADR 0002)：
    • 徹底移除多範圍維度，Bridge State 轉為單一 Global Scope 管理（~/.pi/agent/codex-marketplace/state.json）。
    • 磁碟上殘留的既有 project state 檔（{cwd}/.pi/codex-marketplace/state.json）完全無視（不讀、不提示、不刪）。
    • 刪除內部 API 之 Scope type 與 'global' | 'project' 參數；路徑、store、fence、journal、reconciliation 全部收斂為單一全域實例。
    • 移除約 1,800 行專屬 project 模組（src/projection/overrides.ts、src/projection/project.ts、src/barrier/global-barrier.ts 等）。
  • Scope Override 功能端到端退休 (#59)：
    • 移除 overrides 核心模組與 TUI「Scope 與繼承」分區、建立／移除 Scope Override 動作與 inherited／suppresses 標記。
    • 繼承自 Global 的 Registration / Installation 一律參與 Effective State，無任何抑制路徑。
  • Global Pending Barrier 端到端退休 (#60)：
    • 刪除 barrier 核心模組（src/barrier/global-barrier.ts）與全部呼叫點；Attempt Fence 取得前不再檢查 barrier。
    • BARRIER-01 finding code／rule／ui-strings 文案全數清除；Pending Application 復原語意由既有 active recovery chain（如 Retry Application）承擔。

Changed

  • Bridge State Schema v2 + WAL Migration (#63)：
    • schemaVersion 升為 2。
    • v1 → v2 WAL migration 剝除 scopeOverrides 死欄位；非空 overrides 剝除並產出 non-blocking MIGRATE-01 診斷 finding（不 fail-closed）。
    • 規範化 Installation ID：自動剝除舊版 global/ 前綴。
  • Runtime Skill Collision 簡化為兩層 (#61)：
    • 碰撞解析由 Pi → Project Scope → Global Scope 三層收斂為 Pi → Global Scope 兩層。
    • 任何已啟用的 Global Plugin skill 只要未與 Pi 原生/本機 skill 碰撞即正常暴露；同層 Bridge 碰撞者皆為 unavailable。
  • TUI Bridge Ledger 單軌收斂 (#62)：
    • 移除 Project 軌、G/P marker、g/p 瀏覽焦點鍵與 Trust/Barrier 指示區。
    • 導航重整為 Observe、Sources、Plugins、Recovery & receipts 四大正典群組。
  • 文件與版本定錨 (#64)：
    • README 全面改寫為單一 Global 行為，釐清 pi install -l 屬 Pi host 套件位置，更新 v2 schema 與 TUI 導覽說明。
    • package.json 版本定錨為 0.2.0，description 移除多範圍字樣。

0.1.10 - 2026-08-25

Added

  • Runtime Skill Exposure (#54)：Bridge Extension 實作 host 資源發現接縫（pi.on("resources_discover") 回傳 skillPaths，startup 與 reload 兩種 reason 皆支援），依當下 Effective State（enabled Installation 減去 Scope Override 與 Project Trust 排除）之 Runtime Skill Collision 存活者，動態貢獻 skill 目錄——Git Registration 直接指向 Source Cache 中其 Validation Snapshot fingerprint 對應 entry 內的個別 skill 目錄，Local Registration 指向 live Marketplace Root；路徑解析重用 retained catalog + Contained Path 解析。發現時僅做被動存在性檢查：不重算指紋、不改動 Bridge State、不產生任何 Attempt Receipt；快取 entry 遭外部刪除時逐項略過且 discovery 必定完成（SOURCE_REACQUISITION_REQUIRED / SOURCE_DRIFT 仍由 Lifecycle Operations 產生）。新增領域模組 src/projection/exposure.ts（ADR 0001）。
  • Invocation Policy advisory warning（COMP-W02） (#55)：當 agents/openai.yaml 宣告 allow_implicit_invocation: false 且 Skill Descriptor 未宣告 disable-model-invocation 時，驗證產出非 blocking 的 UNENFORCEABLE_INVOCATION_POLICY（COMP-W02）warning finding，outcome 引導作者在 SKILL.md frontmatter 補上 disable-model-invocation: true；Effective Invocation Policy 計算與 Compatibility Verdict 不變，Registration 不因此被擋。

0.1.9 - 2026-08-24

Added

  • TUI 正體中文化 (#41)：新增集中式呈現字串模組 extensions/pi/ui-strings.ts（以穩定訊息 ID 索引的 zh_TW 字典，保留 locale 切換模組縫），/codex-marketplace TUI 全部使用者可見字串改由字串模組供應——分區名與描述、列標籤、按鍵提示、狀態列、確認與 consent 文案、help 全譯；Attempt Summary／Recovery Action／Verdict 封閉值以正典在前、中文釋義在後並列（如 Blocked（受阻））；findings 於呈現邊界依 rule code 對應中文文案（rule code／classification／順序不變）；glossary 術語（Bridge State、Receipt Journal…）維持英文；CJK 雙寬字元於 120/80/60 欄寬度安全（無溢位、面板框線完整）；分派續用結構化 intent，顯示語言不影響任何行為。非 TUI 的 list/inspect 輸出依議題範圍維持原樣。

0.1.8 - 2026-08-24

Added

  • Bridge Ledger TUI (#38): replace the flat /codex-marketplace menu with a responsive five-section workspace, simultaneous Global / Project authority rails, persistent Project Trust and Global Pending Barrier status, structured canonical action intents, scope-partitioned browsing focus, Entry-level Plugin rows with directly bound install paths, eligibility-aware State Repair, and 120/80/60-column keyboard navigation.
  • Shared Transaction Sheet (#38): present every mutation as Intent → Validation → Consent → Plan → Commit → Receipt, preserve separate Default-No Registration / Activation confirmations, provide expandable complete disclosures, and render Durable / Findings / Runtime outcomes with terminal-safe quoting; preflight cancellation produces a durable Declined Receipt, while active Pending Application chains expose an Attempt Fence-held, exact Revision + Validation Snapshot-bound Retry Application with final pre-reload/post-reload verification (missing snapshots disable unsafe replay, interaction-time drift fails closed without reload, and reload errors remain Pending Application). Repair State also exposes safe atomic Receipt Journal reconstruction for JOURNAL-02 degradation while preserving parsed active chains.

0.1.7 - 2026-08-23

Added

  • Compatibility Profile v1 Skill Agent Profile (#36/#37)：支援 skills/<skill>/agents/openai.yaml 與 invocation policy，並以 bounded YAML parsing、Skill ownership 與 Validation Budget 拒絕不安全輸入；新增 yaml runtime dependency。

0.1.6 - 2026-08-22

Added

  • Git Marketplace Plugin 檢驗與安裝 (#34)：接合 SourceCache（Git 定址快取）與 buildGitSnapshot 指紋驗證，支援 Git Marketplace 的 Plugin 檢驗、TUI 條目呈現（顯示「可安裝」）、Install Disabled / Install and Enable 以及啟用（Enable）完整生命週期；快取遺失或指紋漂移時精確產生 SOURCE_REACQUISITION_REQUIRED / SOURCE_DRIFT Blocking Finding。

0.1.5 - 2026-08-22

Fixed

  • README 安裝語意：對齊 pi --help 與 docs/packages.md — pi install 需 npm: 前綴、本地路徑用 pi install ./path、臨時試用用 pi -e <source>（非 pi install -e）、update/remove/list/config 語意修正。

0.1.4 - 2026-08-22

Fixed

  • publish Node 22 → 24：publish job npm 10.9.3 不支援 OIDC Trusted Publishing（需 npm 11.5.1+），改為 node 24（opencode 同款），移除臨時調試步驟。

0.1.3 - 2026-08-22

Fixed

  • 調試 OIDC：新增暫時性 debug OIDC token 步驟與 verbose 日誌以定位 ENEEDAUTH。

0.1.2 - 2026-08-22

Fixed

  • Trusted Publisher OIDC：對齊 opencode-roast-tone-plugin 可發版樣式 — repository.url 去除 git+ 前綴 (https://github.com/SamWang32191/pi-codex-marketplace)，publish.yml 移除 environment: npm（OIDC token 不帶 environment claim），升級 actions/checkout@v5/setup-node@v5 以匹配可發版 repo 的 proven 流程。

0.1.1 - 2026-08-22

Added

  • Release skill .agents/skills/release — project skill 將發版流程固化為 v* tag → CI gate → npm provenance → GitHub Release 五步，涵蓋首發 OTP 與 OIDC Trusted Publisher 分支、常見失敗與完成條件。

0.1.0 - 2026-08-22

Initial Bridge Package release — single pi extension, Pi 0.84.2 baseline.

Added

  • Bridge Package pi-codex-marketplace@0.1.0 with pi extension entry extensions/pi/index.ts (loaded via jiti, no build step). Published to npm with npm publish --provenance; Git tag v0.1.0 mirrors npm.
  • Bridge State dual-document atomic store: global {getAgentDir()}/codex-marketplace/state.json + project {cwd}/.pi/codex-marketplace/state.json with schemaVersion=1, opaque monotonic stateRevision ("0"→"1"→"2"…), file lock (.lock), WAL (state.json.wal), temp→fsync→rename + dir fsync + read-after-verify. Only authoritative fields persisted; Effective State, catalogs, diagnostics derived at read time.
  • WAL migration (src/bridge-state/migrate.ts): forward migrations via state.json.wal (fsynced before commit, replayed on next read after crash, cleaned after commit). Supported forward paths only; unknown/ newer schemaVersion → incompatible fail-closed; downgrade never writes back.
  • Source Acquisition: local (canonical real path) and Git (Canonical Git Locator credential-free + Normalized Git Selector default/branch refs/heads/*/tag refs/tags/*/commit lower 40/64 hex) with Resolved Revision, non-executing retrieval (no hooks/filters/submodules/dependencies/Plugin components), Acquisition Trust Base validation (selected Git/SSH, system CAs, existing known-hosts, approved credential helper/agent; rejects unknown/changed host keys and locator-changing redirects).
  • Validation: Validation Snapshot (ordered paths/types/modes/symlink targets/content hashes + Source Key + Canonical Locator + Resolved Revision + Compatibility Profile v1 + Ruleset + Budget fingerprints), Contained Path/Contained Symlink strict containment, Validation Budget fail-closed at boundary, ordered Findings with stable rule codes (CONT-01, COMP-02, FENCE-01, BARRIER-01, etc.) sorted class→phase→target→pointer→rule.
  • Compatibility Profile v1: atomic Compatible/Incompatible/Invalid classification; closed manifest + Skill Descriptor/Body contract, Pi-native skill semantics, Inert Metadata tolerates as Warning, unknown/unsupported Active Component → Incompatible/Incompatible, no partial projection. Collision never changes Plugin classification.
  • Lifecycle: Scope-local atomic Lifecycle Operations — Registration (local/Git), Installation (Install Disabled without Activation Confirmation vs Install and Enable with Activation Confirmation, re-enable re-validates), Removal (Registration cascades same-scope Installations), Rebind (fresh validation + Registration Confirmation + complete Update Plan), Marketplace Refresh (non-mutating, Update Candidate only when snapshot differs; full-commit ref movement alone never produces a candidate), Apply Update (single WAL commit per complete Update Plan with Registration Confirmation + per-Installation update/disable/remove + per-enabled Activation Confirmation), Scope Overrides (project-only sparse suppression by Registration ID / Installation ID, removal reveals inherited Global without mutating it), Read-time Effective State (global-baseline + project additions – overrides, only enabled, project-over-global precedence), Projected Skills via Pi resource-discovery seam (raw snapshot paths, Bridge-held provenance, host-verifiable reload = Applied).
  • Runtime Skill Collision: skill-granular Pi → Project Scope → Global Scope exact-name layering, same-scope Bridge colliders all unavailable, only surviving higher-layer skill reserves the name, lower survives when no higher contender. Available only by independent host evidence.
  • Source Cache (src/cache/): Git-only, fingerprint-addressed at {getAgentDir()}/codex-marketplace/cache, pinned set = committed Bridge State + pending Update Candidate + in-flight, total 2 GiB LRU on unpinned only, synchronous evict/prune, no background/TTL, offline reuse only on exact fingerprint hit, Stale Snapshot never becomes success. Per-fingerprint flock, p50 <200ms on hit.
  • Source Drift: external local-source mutation detected as Blocking Finding, Bridge State unchanged, affected Installations not Projected until explicit Refresh produces an Update Candidate.
  • Receipt Journal + Attempt Fence + Global Pending Barrier (src/journal/, src/barrier/, src/reconciliation/): immutable redacted Attempt Receipts (expected/target/observed revisions + Validation Snapshots + findings + earlier receipt recovery link), bounded durable journal with active recovery chains preserved across restarts (reconstructible from authority, prunable only outside active chain, degraded diagnosis separate from persistence outcome), per-scope Attempt Fence exclusivity and exact-state binding (Rejected as Stale when State Revision or snapshot moves, no queue), Persistence Failed (previous still verified) vs Persistence Indeterminate (neither previous nor target verifiable — blocks further Lifecycle/Runtime until readable and exact, no auto-rollback), Global Pending Barrier (global pending/indeterminate/journal-degraded blocks every project mutation/application, including Lifecycle/Repair/project startup reconciliation; inspection/Refresh remain, global-first recovery), 8 closed Attempt Summaries, closed Recovery Actions (only currently safe next step, no auto-retry), startup reconciliation (produces a new receipt for pending, no retry/rollback).
  • TUI management flow (/codex-marketplace): single aggregated command faithful to prototype/tui-management-flow@c9107d2 — hybrid discovery/guided, explicit scope choice per operation, Registration/Activation separated snapshot+revision bound Default No confirmations, Update Plan Checklist, partitioned Global/Project lists, skill-granular diagnostics, synchronized Findings, closed Recovery Actions, immediate-reload three-orthogonal Receipt report, Pending/Global Barrier blocking hints.
  • Verification matrix: synthetic / pinned SamWang32191/codex-plugins@98e78ca / adversarial three-tier fixtures × (unit + integration + E2E at the TUI seam) on Pi 0.84.2 / macOS / Linux / Node >=22.19.0; every row is a release gate (v* → CI full matrix green → npm publish --provenance latest/next channels, 0.y/1.0 maintenance windows).

What's Changed

Full Changelog: v0.6.2...v0.7.0

Contributors

SamWang32191
Assets 2
Loading