pi-codex-marketplace 1.0.5 → 1.1.0

package/README.md

@@ -23,7 +23,7 @@ Requirements: **Pi `0.87.0`（相容下限 `0.84.2`）** · **Node >=22.19.0**
 
 ## 子命令速查
 
-TUI `/codex-marketplace` 與 Headless CLI `pi-codex-marketplace` 共用同一組九個子命令（無參數＝總覽）：
+TUI `/codex-marketplace` 與 Headless CLI `pi-codex-marketplace` 共用同一組十個子命令（無參數＝總覽）：
 
 | 子命令 | 行為 |
 |--------|------|
@@ -34,6 +34,7 @@ TUI `/codex-marketplace` 與 Headless CLI `pi-codex-marketplace` 共用同一組
 | `disable <名稱>` / `enable <名稱>` | 停用／啟用 plugin |
 | `remove <名稱>` | 移除單支 plugin |
 | `forget <名稱>` | 移除整個 marketplace（含其全部安裝） |
+| `skills <名稱> [exclude \| include \| only \| reset]` | 查看 skills 與排除狀態；逐項排除／恢復、一次性只保留、重設 |
 | `help` | 子命令清單 |
 
 ## Documentation
@@ -43,7 +44,7 @@ TUI `/codex-marketplace` 與 Headless CLI `pi-codex-marketplace` 共用同一組
 | 文件 | 內容 |
 |------|------|
 | [docs/installation.md](./docs/installation.md) | 安裝／更新／移除：Pi Extension 各模式、Headless CLI、`-l` 語意、requirements |
-| [docs/usage.md](./docs/usage.md) | `/codex-marketplace` 使用手冊：九子命令細節、語意鐵則、Pi 原生 autocomplete |
+| [docs/usage.md](./docs/usage.md) | `/codex-marketplace` 使用手冊：十子命令細節、Skill 排除清單、語意鐵則、Pi 原生 autocomplete |
 | [docs/cli.md](./docs/cli.md) | Headless Bridge CLI：執行方式、輸出與退出代碼契約、狀態生效時機 |
 | [docs/private-repos.md](./docs/private-repos.md) | 私有 Git repo：Credentialed Acquisition（核准式取得）、SSH 定位器 |
 | [docs/architecture.md](./docs/architecture.md) | 架構：Bridge State storage、支援矩陣、領域詞彙、ADR |

package/extensions/pi/autocomplete.ts

@@ -4,9 +4,10 @@
  * Pi's built-in combined provider completes the slash-command name and inserts a
  * trailing space without exposing empty-prefix argument completion (root subcommands) when
  * the editor holds exactly `/codex-marketplace`. This wrapper intercepts that exact editor
- * content and presents the nine root candidates. It also owns the second-level argument
+ * content and presents the ten root candidates. It also owns the second-level argument
  * contexts (`install` #122, the Installation lifecycle `enable` / `disable` / `remove` #123,
- * and the Marketplace Registration `list` / `forget` #124) on forced (Tab) requests, which
+ * the Marketplace Registration `list` / `forget` #124, and the Skill Exclusion surface
+ * `skills` #158) on forced (Tab) requests, which
  * Pi routes to file completion instead of slash-command argument completion (its
  * argument path only runs when `force` is false) — the wrapper returns the state-aware
  * candidates there. `add` stays free-form (#124): its forced Tab keeps Pi's native
@@ -17,6 +18,11 @@
  * The wrapper is installed from a `session_start` handler via `ctx.ui.addAutocompleteProvider`,
  * which interactive (TUI) mode wires into the editor and RPC/JSON/print modes no-op, so a
  * terminal-only provider is never registered outside a TUI session.
+ *
+ * The `skills` context (#158) nests deeper than the other contexts: the same forced-Tab
+ * interception covers `skills <名稱> ` (operations) and `skills <名稱> exclude|include|only `
+ * (skill names) because they share the `/codex-marketplace skills ` prefix — see
+ * `completeArguments` for the grammar it owns at each depth.
  */
 
 import type { AutocompleteProvider } from '@earendil-works/pi-tui';
@@ -27,12 +33,13 @@ import { completeArguments, type CompletionReadOptions } from '../../src/bridge/
 export const EXACT_COMMAND = '/codex-marketplace';
 
 /**
- * The Bridge-owned second-level argument contexts on forced requests: `install` plus the
- * installation lifecycle actions plus the Marketplace Registration commands — each followed
- * by the trailing space root candidates insert. `add` is deliberately absent (#124): its
- * argument is an arbitrary path or Git locator that stays under Pi's native completion.
+ * The Bridge-owned second-level argument contexts on forced requests: `install`, the
+ * installation lifecycle actions, the Marketplace Registration commands, and the Skill
+ * Exclusion surface (`skills`) — each followed by the trailing space root candidates insert.
+ * `add` is deliberately absent (#124): its argument is an arbitrary path or Git locator that
+ * stays under Pi's native completion.
  */
-export const SECOND_LEVEL_ARGUMENT_RE = /^\/codex-marketplace (?:install|list|forget|enable|disable|remove) /;
+export const SECOND_LEVEL_ARGUMENT_RE = /^\/codex-marketplace (?:install|list|forget|enable|disable|remove|skills) /;
 
 /**
  * Wrap the host's current autocomplete provider. Suggestion generation intercepts only the

package/extensions/pi/index.ts

@@ -18,7 +18,7 @@ import { completeArguments } from '../../src/bridge/completion.js';
 import { createBridgeAutocompleteProvider } from './autocomplete.js';
 
 export default function (pi: ExtensionAPI) {
-  // Root-level autocomplete (#121) + second-level autocomplete (#122–#124): stack a narrow
+  // Root-level autocomplete (#121) + second-level autocomplete (#122–#124, #158): stack a narrow
   // provider for the exact `/codex-marketplace` editor text and the forced `install `,
   // Installation lifecycle (`enable ` / `disable ` / `remove `), and Marketplace Registration
   // (`list ` / `forget `) argument contexts (Pi otherwise completes just the command name
@@ -46,9 +46,10 @@ export default function (pi: ExtensionAPI) {
   });
 
   pi.registerCommand('codex-marketplace', {
-    description: 'codex / claude marketplace 管理（add/list/install/update/disable/enable/remove/forget/help）',
-    // Standard argument completion (#121–#124): typed subcommand and `install <query>` /
-    // lifecycle `<query>` / Registration (`list` / `forget`) `<query>` prefixes go through
+    description: 'codex / claude marketplace 管理（add/list/install/update/disable/enable/remove/forget/skills/help）',
+    // Standard argument completion (#121–#124, #158): typed subcommand and `install <query>` /
+    // lifecycle `<query>` / Registration (`list` / `forget`) `<query>` / Skill Exclusion
+    // (`skills <名稱> [操作]`) prefixes go through
     // Pi's normal autocomplete; unowned syntax (including `add`'s free-form argument) returns
     // null so Pi falls through to its own behavior.
     getArgumentCompletions: (argumentPrefix: string) => completeArguments(argumentPrefix),

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "pi-codex-marketplace",
-  "version": "1.0.5",
-  "description": "Bridge Package for Codex and Claude Marketplace compatibility in Pi — 極簡 /codex-marketplace 純文字指令與 Headless CLI（add/list/install/update/disable/enable/remove/forget）、單一 Global Bridge State、當下最新安裝與即時投影",
+  "version": "1.1.0",
+  "description": "Bridge Package for Codex and Claude Marketplace compatibility in Pi — 極簡 /codex-marketplace 純文字指令與 Headless CLI（add/list/install/update/disable/enable/remove/forget/skills）、單一 Global Bridge State、當下最新安裝與即時投影",
   "type": "module",
   "keywords": [
     "pi-package",