@modootoday/pmcp 0.17.3 → 0.18.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.agents/plugins/marketplace.json +1 -1
- package/.claude-plugin/marketplace.json +1 -1
- package/.claude-plugin/plugin.json +1 -1
- package/CHANGELOG.md +60 -0
- package/README.md +29 -24
- package/dist/apply-4IGTXOCQ.js +242 -0
- package/dist/{attachment-tU5FZrgZ.d.ts → attachment-D84OGI6n.d.ts} +1 -1
- package/dist/available-DBSIVVJ6.js +73 -0
- package/dist/broadcast-3RY3OZGY.js +18 -0
- package/dist/chunk-25GHX674.js +1246 -0
- package/dist/chunk-2P4Z2NUX.js +28 -0
- package/dist/chunk-34DECPVC.js +22 -0
- package/dist/chunk-3NYG4SGU.js +45 -0
- package/dist/chunk-3PW4FI7U.js +32 -0
- package/dist/chunk-3Y3HDMHA.js +108 -0
- package/dist/chunk-47O3X4VS.js +113 -0
- package/dist/chunk-4NDEP7HU.js +26 -0
- package/dist/chunk-4VCC2NXE.js +104 -0
- package/dist/chunk-5OMOPUE6.js +39 -0
- package/dist/chunk-5QQWS4US.js +53 -0
- package/dist/chunk-5ZABTVSW.js +48 -0
- package/dist/chunk-65ZHM5RH.js +4985 -0
- package/dist/chunk-665TA55Z.js +419 -0
- package/dist/chunk-6STKGOCW.js +27 -0
- package/dist/chunk-6WXMJOMI.js +9 -0
- package/dist/chunk-73AKO4UL.js +24 -0
- package/dist/chunk-7BLPN3W6.js +31 -0
- package/dist/chunk-7DLZC73N.js +29 -0
- package/dist/chunk-7GBYECSK.js +72 -0
- package/dist/chunk-7TD53M7L.js +13 -0
- package/dist/chunk-A4PKLESO.js +112 -0
- package/dist/chunk-ABTJQ4QV.js +74 -0
- package/dist/chunk-BBTBJCFA.js +380 -0
- package/dist/chunk-BU65MNVU.js +13 -0
- package/dist/chunk-BVCTKPT3.js +83 -0
- package/dist/chunk-C4NHQGHL.js +142 -0
- package/dist/chunk-CJTKR6K6.js +1213 -0
- package/dist/chunk-DCU2EXQV.js +78 -0
- package/dist/chunk-DZ2MRTYT.js +135 -0
- package/dist/chunk-E2YOZ2FF.js +207 -0
- package/dist/chunk-E3DQB5LS.js +48 -0
- package/dist/chunk-E7OOHLQR.js +7 -0
- package/dist/chunk-EATCUWGG.js +66 -0
- package/dist/chunk-EIDIVIAD.js +33 -0
- package/dist/chunk-EJBZGIDK.js +1934 -0
- package/dist/chunk-ELAGZ635.js +252 -0
- package/dist/chunk-GZHHEHKY.js +44 -0
- package/dist/chunk-HDMBVLCZ.js +53 -0
- package/dist/chunk-HQOB7OQS.js +81 -0
- package/dist/chunk-IGYRMM62.js +28 -0
- package/dist/chunk-IJBSOWHK.js +86 -0
- package/dist/chunk-INT7QLEU.js +114 -0
- package/dist/chunk-J6QLLQVL.js +1025 -0
- package/dist/chunk-J7UYNJCR.js +9 -0
- package/dist/chunk-JEL35P7S.js +53 -0
- package/dist/chunk-JGJ4INEN.js +32 -0
- package/dist/chunk-JS5RTH4I.js +84 -0
- package/dist/chunk-JUXNIXN4.js +42 -0
- package/dist/chunk-JWRZDYB5.js +59 -0
- package/dist/chunk-KMXRRSKT.js +660 -0
- package/dist/chunk-LAZQBMAU.js +67 -0
- package/dist/chunk-LLBPVZXM.js +67 -0
- package/dist/chunk-LLT5FQBE.js +57 -0
- package/dist/chunk-LMT3PPXJ.js +17 -0
- package/dist/chunk-MM2Y43LC.js +87 -0
- package/dist/chunk-MPSQXSC6.js +346 -0
- package/dist/chunk-MVFH26QT.js +97 -0
- package/dist/chunk-MWFOUBFC.js +39 -0
- package/dist/chunk-N5AQ3PP7.js +211 -0
- package/dist/chunk-NQPURJT5.js +44 -0
- package/dist/chunk-NRBQK6UX.js +105 -0
- package/dist/chunk-NZS5CD72.js +333 -0
- package/dist/chunk-OEH47H6A.js +48 -0
- package/dist/chunk-OG7QR2DP.js +75 -0
- package/dist/chunk-OPYFEHKG.js +52 -0
- package/dist/chunk-P4N7DBD5.js +83 -0
- package/dist/chunk-PAX3QXX2.js +140 -0
- package/dist/chunk-PLX3BOOS.js +396 -0
- package/dist/chunk-PMJG2CXF.js +122 -0
- package/dist/chunk-PWSJJXLQ.js +643 -0
- package/dist/chunk-Q5H3L6Y4.js +23 -0
- package/dist/chunk-Q65R3XKX.js +155 -0
- package/dist/chunk-QEW4J3IZ.js +74 -0
- package/dist/chunk-QPL7E2HW.js +464 -0
- package/dist/chunk-R2GPCZUX.js +22 -0
- package/dist/chunk-R4L6LJJ2.js +778 -0
- package/dist/chunk-R5MT42JS.js +284 -0
- package/dist/chunk-RK4PYD7L.js +73 -0
- package/dist/chunk-RMATE45Z.js +197 -0
- package/dist/chunk-S3PIAMXV.js +230 -0
- package/dist/chunk-SG5TPMKH.js +93 -0
- package/dist/chunk-T3LKX23M.js +168 -0
- package/dist/chunk-T6GOWHK6.js +30 -0
- package/dist/chunk-TIA4SPU2.js +10 -0
- package/dist/chunk-TNCZ6444.js +57 -0
- package/dist/chunk-TVL5RTE6.js +269 -0
- package/dist/chunk-UOCLRM7P.js +151 -0
- package/dist/chunk-UPQTAHUK.js +189 -0
- package/dist/chunk-V4NPDK6X.js +14 -0
- package/dist/chunk-VJFEN6DJ.js +38 -0
- package/dist/chunk-WIW772I3.js +25 -0
- package/dist/chunk-XELAZAIM.js +136 -0
- package/dist/chunk-XNML2KIC.js +23 -0
- package/dist/chunk-XP2U3LO3.js +30 -0
- package/dist/chunk-YGOWIJPE.js +51 -0
- package/dist/chunk-YIXDHQYE.js +11 -0
- package/dist/chunk-YMHUM7AV.js +22 -0
- package/dist/chunk-YSAWTGNA.js +117 -0
- package/dist/chunk-Z4HRRXRF.js +478 -0
- package/dist/chunk-ZH6R642Z.js +102 -0
- package/dist/claude-U2JC2DNQ.js +77 -0
- package/dist/cli-VYCQJZ5X.js +41 -0
- package/dist/cli-ZTCBSDW4.js +46 -0
- package/dist/cli.js +144 -16160
- package/dist/completion-E7RRG3ZT.js +142 -0
- package/dist/config-DnpLL2kT.d.ts +46 -0
- package/dist/{service-qpCsOXkQ.d.ts → core-C1LPjxK6.d.ts} +2 -6
- package/dist/diagnostics-XXH4FLUG.js +93 -0
- package/dist/doctor-ZIOESU3N.js +538 -0
- package/dist/entry-ZNFCTDVE.js +305 -0
- package/dist/exec-mcp-X6372BLE.js +365 -0
- package/dist/harness-F2XFDYXF.js +177 -0
- package/dist/harness-egress-bridge.js +4 -4
- package/dist/harness-launch-gate.js +47 -940
- package/dist/harness-pane-runner.js +13 -80
- package/dist/harness-worker.js +21 -2703
- package/dist/hook-body.js +5221 -0
- package/dist/hook-spec-C5fWTSCH.d.ts +100 -0
- package/dist/hook.js +26 -0
- package/dist/hooks-FYE2L5RW.js +21 -0
- package/dist/host-GRY3VAHH.js +22 -0
- package/dist/host-X6BR6X4O.js +200 -0
- package/dist/host-run-GCA6H6SR.js +307 -0
- package/dist/http.d.ts +5 -42
- package/dist/http.js +21 -2234
- package/dist/import-mcp-2TTBPVLY.js +400 -0
- package/dist/index.d.ts +146 -168
- package/dist/index.js +133 -4911
- package/dist/init-627KFXTG.js +14 -0
- package/dist/install-GG7HHZK2.js +796 -0
- package/dist/invoke-LW22Z6ET.js +23 -0
- package/dist/list-MCP2FXUF.js +68 -0
- package/dist/list-NGMSQ5SH.js +65 -0
- package/dist/load-BEUBABtB.d.ts +21 -0
- package/dist/logout-6CSHUWWE.js +44 -0
- package/dist/logs-SPB6AANY.js +107 -0
- package/dist/mailbox/index.d.ts +10 -5
- package/dist/mailbox/index.js +53 -1572
- package/dist/mailbox-7BV54Q4R.js +285 -0
- package/dist/mailbox-GDJ7BWQN.js +189 -0
- package/dist/mainline-JQTTYJMI.js +639 -0
- package/dist/marketplace-G4VQET5W.js +191 -0
- package/dist/mcp-2DKVU3SW.js +15 -0
- package/dist/mcp-V23HC3LB.js +193 -0
- package/dist/models-ISU4DCMA.js +32 -0
- package/dist/opencode-CN7JLQYO.js +60 -0
- package/dist/pause-FFAYRBWI.js +18 -0
- package/dist/preview-DT7DWG5F.js +91 -0
- package/dist/project/hook-adapter.d.ts +6 -3
- package/dist/project/hook-adapter.js +66 -35
- package/dist/project-FY62G55N.js +70 -0
- package/dist/pty-XTJ4MIWK.js +94 -0
- package/dist/recovery-U6QB3PMT.js +100 -0
- package/dist/reindex-Y27QJFDB.js +22 -0
- package/dist/resume-UU4HZIUP.js +18 -0
- package/dist/run-HALGEJNJ.js +19 -0
- package/dist/run-OGA3P7FC.js +126 -0
- package/dist/serve-NBKT5BKY.js +104 -0
- package/dist/session-XM2CR425.js +159 -0
- package/dist/setup-DTKZLZUT.js +18 -0
- package/dist/start-login-UIQYQBMC.js +416 -0
- package/dist/status-A2OUTNGK.js +9 -0
- package/dist/status-H2VAHIDV.js +10 -0
- package/dist/status-NOOHW5WA.js +43 -0
- package/dist/status-VHODZPXB.js +55 -0
- package/dist/status-XQANBVXW.js +286 -0
- package/dist/stdio.d.ts +3 -13
- package/dist/stdio.js +16 -3186
- package/dist/sweep-64JDCGK6.js +18 -0
- package/dist/test-MKAXFJOL.js +561 -0
- package/dist/tools-gpHNq9Dh.d.ts +328 -0
- package/dist/tui-MWKAXE4K.js +153 -0
- package/dist/unbroadcast-KPUEFLZD.js +18 -0
- package/dist/validate-5GZ5YWNA.js +46 -0
- package/dist/worker-RQ575EJL.js +80 -0
- package/dist/worktree-create-PZSRB7PH.js +89 -0
- package/dist/worktree-list-JYB6VXLW.js +51 -0
- package/dist/worktree-sync-UF5CXPWV.js +30 -0
- package/docs/hooks/capabilities/antigravity.json +199 -0
- package/docs/hooks/capabilities/claude.json +179 -0
- package/docs/hooks/capabilities/codex.json +179 -0
- package/docs/hooks/capabilities/gemini.json +196 -0
- package/docs/hooks/capabilities/grok.json +192 -0
- package/docs/hooks/capabilities/opencode.json +184 -0
- package/docs/project-configuration.md +844 -4
- package/docs/terminal-harness.md +71 -28
- package/docs/terminal-workspace.md +91 -170
- package/gemini-extension.json +1 -1
- package/package.json +13 -1
- package/plugin.json +1 -1
- package/plugins/pmcp/.claude-plugin/plugin.json +4 -2
- package/plugins/pmcp/gemini-extension.json +1 -1
- package/plugins/pmcp/mod/commands.ts +72 -0
- package/plugins/pmcp/mod/contract.d.ts +39 -0
- package/plugins/pmcp/mod/draw.tsx +216 -0
- package/plugins/pmcp/mod/guard.ts +42 -0
- package/plugins/pmcp/mod/hooks.json +4 -0
- package/plugins/pmcp/mod/host.ts +46 -0
- package/plugins/pmcp/mod/model.ts +144 -0
- package/plugins/pmcp/mod/reader/index.ts +18 -0
- package/plugins/pmcp/mod/reader/read.ts +76 -0
- package/plugins/pmcp/mod/reader/settings.ts +54 -0
- package/plugins/pmcp/mod/reader/types.ts +38 -0
- package/plugins/pmcp/mod/register.tsx +73 -0
- package/plugins/pmcp/mod/sessions/format.ts +91 -0
- package/plugins/pmcp/mod/sessions/types.ts +162 -0
- package/plugins/pmcp/mod/snapshot.ts +75 -0
- package/plugins/pmcp/mod/spinner.tsx +30 -0
- package/plugins/pmcp/mod/state.ts +28 -0
- package/plugins/pmcp/plugin.json +1 -1
- package/plugins/pmcp/skills/agent-assets-migrate/SKILL.md +96 -0
- package/plugins/pmcp/skills/headless-agents-ci-scaffold/SKILL.md +100 -0
- package/plugins/pmcp/skills/marketplace-plugin-scaffold/SKILL.md +87 -0
- package/plugins/pmcp/skills/package-skill-catalog/SKILL.md +51 -11
- package/plugins/pmcp/skills/pmcp-project-init/SKILL.md +145 -0
- package/plugins/pmcp/skills/pmcp-sessions-and-git/SKILL.md +104 -0
- package/plugins/pmcp/skills/skill-package-scaffold/SKILL.md +88 -0
- package/schema/catalog-v1.json +158 -0
- package/schema/library.json +164 -0
- package/schema/marketplace-manifest.json +130 -0
- package/schema/plugin-manifest.json +55 -0
- package/schema/skill-frontmatter.json +144 -0
- package/schema/skill-metadata-core.json +110 -0
- package/skills/agent-assets-migrate/SKILL.md +96 -0
- package/skills/headless-agents-ci-scaffold/SKILL.md +100 -0
- package/skills/marketplace-plugin-scaffold/SKILL.md +87 -0
- package/skills/package-skill-catalog/SKILL.md +51 -11
- package/skills/pmcp-project-init/SKILL.md +145 -0
- package/skills/pmcp-sessions-and-git/SKILL.md +104 -0
- package/skills/skill-package-scaffold/SKILL.md +88 -0
- package/dist/config-BkSpjUG6.d.ts +0 -50
- package/dist/embed-DRROSD3F.d.ts +0 -53
- package/dist/hook-spec-PRSnYGLV.d.ts +0 -10
- package/dist/server-VWSY3Shw.d.ts +0 -543
- package/dist/tui-worker.js +0 -6549
- /package/dist/{tui-worker.d.ts → hook.d.ts} +0 -0
|
@@ -612,7 +612,7 @@
|
|
|
612
612
|
},
|
|
613
613
|
{
|
|
614
614
|
"name": "pmcp",
|
|
615
|
-
"version": "0.
|
|
615
|
+
"version": "0.18.0",
|
|
616
616
|
"description": "Find package skills and use native runtime project configuration.",
|
|
617
617
|
"source": { "source": "local", "path": "./plugins/pmcp" },
|
|
618
618
|
"policy": { "installation": "AVAILABLE", "authentication": "ON_USE" },
|
package/CHANGELOG.md
ADDED
|
@@ -0,0 +1,60 @@
|
|
|
1
|
+
# Changelog
|
|
2
|
+
|
|
3
|
+
## 0.18.0
|
|
4
|
+
|
|
5
|
+
This release replaces tmux with pmcp's own terminal host and adds project
|
|
6
|
+
hooks, sessions and two MCP servers for browser and desktop use. As a 0.x minor
|
|
7
|
+
release it contains breaking changes.
|
|
8
|
+
|
|
9
|
+
### Breaking
|
|
10
|
+
|
|
11
|
+
- tmux is no longer used or required. Native sessions run in pmcp-pty, a PTY
|
|
12
|
+
host with one daemon per harness group, and `pmcp tui` draws the workspace
|
|
13
|
+
with pmcp-tui. Groups and workspaces created by 0.17 and earlier are not
|
|
14
|
+
migrated: close them with the release that created them, then start a new
|
|
15
|
+
one.
|
|
16
|
+
- The `pmcp tui` view operations (`create`, `open`, `close`, `stop` and the
|
|
17
|
+
others taking `--view`) and their options are removed. `pmcp tui`,
|
|
18
|
+
`plan`, `recovery`, `doctor` and `start-worker` remain.
|
|
19
|
+
- Harness session records hold the pmcp-pty session, host instance and
|
|
20
|
+
process id instead of tmux pane identities.
|
|
21
|
+
- The terminal workspace and harness need Linux (glibc 2.35 or later) or
|
|
22
|
+
macOS. On Linux a user systemd manager caps each session's memory; macOS
|
|
23
|
+
runs sessions uncapped. Windows is not supported yet.
|
|
24
|
+
|
|
25
|
+
### Terminal host and workspace
|
|
26
|
+
|
|
27
|
+
- pmcp-pty hosts native runtimes with guarded writes, per-runtime screen
|
|
28
|
+
profiles, turn detection from hook events, and a lease that refuses any
|
|
29
|
+
other writer while someone holds control.
|
|
30
|
+
- pmcp-tui shows main, a worker dock and a coordination panel, with explicit
|
|
31
|
+
control, history and mailbox views, read only until you take control.
|
|
32
|
+
- npm installs pmcp-pty and pmcp-tui through a platform package
|
|
33
|
+
(`@modootoday/pmcp-<os>-<cpu>`) for Linux and macOS on x64 and arm64.
|
|
34
|
+
`PMCP_PTY_BIN` and `PMCP_TUI_BIN` override it. The macOS binaries are
|
|
35
|
+
unsigned.
|
|
36
|
+
- `[host]` in pmcp.toml declares which tool dialogs an operator-approved host
|
|
37
|
+
may answer; login, authentication and trust prompts are never answered.
|
|
38
|
+
- `pmcp harness host up`, `down` and `unit` manage a host for the project.
|
|
39
|
+
|
|
40
|
+
### Browser and desktop
|
|
41
|
+
|
|
42
|
+
- pmcp-browser runs an isolated, headless Chromium over MCP that reaches
|
|
43
|
+
public sites only. pmcp-desktop drives an Xvfb desktop through screenshots
|
|
44
|
+
and input. Both ship in the Linux platform package; name them bare in
|
|
45
|
+
`[mcp.<alias>] command` and `pmcp project` resolves the installed binary.
|
|
46
|
+
|
|
47
|
+
### Hooks, sessions and project configuration
|
|
48
|
+
|
|
49
|
+
- `[hooks]` compiles to one hook bundle projected for Claude Code, Codex,
|
|
50
|
+
Gemini CLI, Grok, Antigravity and opencode, with guards for secrets,
|
|
51
|
+
staging, pushes and worktrees.
|
|
52
|
+
- Sessions: a files-based session store, `pmcp sessions`, an addressed
|
|
53
|
+
mailbox, and waking idle recipients.
|
|
54
|
+
- `pmcp logs` reads the project's JSONL logs, with rotation and retention set
|
|
55
|
+
by `[logging]`.
|
|
56
|
+
- `pmcp git` creates and syncs worktrees and delivers commits to the mainline.
|
|
57
|
+
- `pmcp mcp` shares remote MCP authentication across runtimes.
|
|
58
|
+
- `pmcp status`, `pmcp init`, `pmcp hooks` and `pmcp completion` are new;
|
|
59
|
+
`[permissions.claude]`, `[catalog.validation]` and declared marketplaces
|
|
60
|
+
are projected from pmcp.toml.
|
package/README.md
CHANGED
|
@@ -143,12 +143,18 @@ and memory metadata.
|
|
|
143
143
|
## Manage native terminals
|
|
144
144
|
|
|
145
145
|
PMCP 0.13.0 or later can show a native main runtime, its worker terminals and a
|
|
146
|
-
coordination panel in one terminal workspace.
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
|
|
146
|
+
coordination panel in one terminal workspace. PMCP 0.18.0 and later run it on
|
|
147
|
+
pmcp-pty (`crates/pmcp-pty`), a PTY host, and draw it with pmcp-tui
|
|
148
|
+
(`crates/pmcp-tui`); earlier releases used tmux. The optional harness and TUI
|
|
149
|
+
need Linux (glibc 2.35 or later) or macOS, Node.js 22 or later, and on Linux a
|
|
150
|
+
working user systemd manager; npm installs pmcp-pty and pmcp-tui with PMCP.
|
|
151
|
+
Windows is not supported yet. Provider login, folder trust and tool approvals
|
|
152
|
+
remain native; an operator-approved `[host]` may answer the tool dialogs it
|
|
153
|
+
lists, and never login, auth or trust prompts (see
|
|
154
|
+
[Sessions pmcp-pty hosts](docs/project-configuration.md#sessions-pmcp-pty-hosts)).
|
|
155
|
+
|
|
156
|
+
See the [changelog](CHANGELOG.md) for what changed in 0.18.0, including the
|
|
157
|
+
removal of tmux.
|
|
152
158
|
|
|
153
159
|
```sh
|
|
154
160
|
npx @modootoday/pmcp --version
|
|
@@ -163,8 +169,8 @@ pmcp
|
|
|
163
169
|
```
|
|
164
170
|
|
|
165
171
|
The first launch lists installed native runtimes. Choose a number or accept the
|
|
166
|
-
default, then confirm the start; q cancels without creating a group. No group
|
|
167
|
-
|
|
172
|
+
default, then confirm the start; q cancels without creating a group. No group JSON is
|
|
173
|
+
required. Later launches reconnect to the workspace
|
|
168
174
|
created for this project. Native login and folder trust stay with the runtime.
|
|
169
175
|
Use `pmcp tui --runtime codex-cli` to choose the main, or set an optional default:
|
|
170
176
|
|
|
@@ -173,9 +179,8 @@ Use `pmcp tui --runtime codex-cli` to choose the main, or set an optional defaul
|
|
|
173
179
|
runtime = "codex-cli"
|
|
174
180
|
```
|
|
175
181
|
|
|
176
|
-
|
|
177
|
-
|
|
178
|
-
`pmcp tui start-worker --runtime gemini-cli`. The existing group keeps its
|
|
182
|
+
Add a worker with `pmcp tui start-worker --runtime gemini-cli`; it appears in
|
|
183
|
+
the workspace's dock. The existing group keeps its
|
|
179
184
|
runtime grants and resource bounds. Use `pmcp tui recovery` to inspect a saved
|
|
180
185
|
workspace and obtain explicit next commands after an interrupted start. Inspection
|
|
181
186
|
does not restart a runtime or replay input.
|
|
@@ -184,8 +189,8 @@ does not restart a runtime or replay input.
|
|
|
184
189
|
[terminal workspace guide](docs/terminal-workspace.md) covers defaults, custom
|
|
185
190
|
configuration and advanced controls. The [native terminal guide](docs/terminal-harness.md)
|
|
186
191
|
explains explicit group and session operations.
|
|
187
|
-
|
|
188
|
-
actions. This optional CLI feature does not add execution tools to the MCP server.
|
|
192
|
+
The workspace starts read only; taking control (Ctrl-g then c) and stopping a
|
|
193
|
+
runtime are explicit actions. This optional CLI feature does not add execution tools to the MCP server.
|
|
189
194
|
|
|
190
195
|
## Everyday commands
|
|
191
196
|
|
|
@@ -222,20 +227,20 @@ interactive hosts show help and prerequisite guidance.
|
|
|
222
227
|
|
|
223
228
|
## Compatibility
|
|
224
229
|
|
|
225
|
-
| Surface | Current qualification
|
|
226
|
-
| -------------------------------------- |
|
|
227
|
-
| CLI and MCP on Linux amd64 | Published 0.15.0 passed clean Docker installation with npm on Debian/Alpine and Bun/pnpm on Debian; 60 installation and failure contracts
|
|
228
|
-
| Optional terminal workspace | Linux
|
|
229
|
-
| Public skill installation | npm, Bun and pnpm 10.17.1; confirmation required, scripts disabled
|
|
230
|
-
| Native plugin export | Claude, Codex, Gemini, Grok and agy formats; export does not install or activate a vendor plugin
|
|
231
|
-
| pnpm workspace installation | Selects the member, preserves root dependencies and updates the shared lockfile
|
|
232
|
-
| Yarn skill installation | Refused without changing project files; Yarn PnP is not supported
|
|
233
|
-
| macOS, Windows and other architectures | Not qualified by the Linux Docker tests
|
|
230
|
+
| Surface | Current qualification |
|
|
231
|
+
| -------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
232
|
+
| CLI and MCP on Linux amd64 | Published 0.15.0 passed clean Docker installation with npm on Debian/Alpine and Bun/pnpm on Debian; 60 installation and failure contracts |
|
|
233
|
+
| Optional terminal workspace | Linux pmcp-pty checks and a native Claude main with a Gemini worker (control, input, wake turns, recovery); other runtimes measured on tmux in 0.17 |
|
|
234
|
+
| Public skill installation | npm, Bun and pnpm 10.17.1; confirmation required, scripts disabled |
|
|
235
|
+
| Native plugin export | Claude, Codex, Gemini, Grok and agy formats; export does not install or activate a vendor plugin |
|
|
236
|
+
| pnpm workspace installation | Selects the member, preserves root dependencies and updates the shared lockfile |
|
|
237
|
+
| Yarn skill installation | Refused without changing project files; Yarn PnP is not supported |
|
|
238
|
+
| macOS, Windows and other architectures | Not qualified by the Linux Docker tests; macOS terminal binaries ship unsigned, Windows is not supported yet |
|
|
234
239
|
|
|
235
240
|
Provider authentication, native children and vendor behavior have separate
|
|
236
241
|
qualification scopes. An installed executable or exported manifest is not proof
|
|
237
|
-
that every native feature works.
|
|
238
|
-
installation, CLI startup, MCP and SQLite
|
|
242
|
+
that every native feature works. The packed-package check, run before a
|
|
243
|
+
release, covers actual archive installation, CLI startup, MCP and SQLite; isolated projects
|
|
239
244
|
on a host are distinct from Docker and OS qualification.
|
|
240
245
|
|
|
241
246
|
## Guides
|
|
@@ -0,0 +1,242 @@
|
|
|
1
|
+
import {
|
|
2
|
+
specFrom
|
|
3
|
+
} from "./chunk-7BLPN3W6.js";
|
|
4
|
+
import {
|
|
5
|
+
catalogFrom
|
|
6
|
+
} from "./chunk-5QQWS4US.js";
|
|
7
|
+
import "./chunk-7DLZC73N.js";
|
|
8
|
+
import {
|
|
9
|
+
project
|
|
10
|
+
} from "./chunk-N5AQ3PP7.js";
|
|
11
|
+
import "./chunk-P4N7DBD5.js";
|
|
12
|
+
import {
|
|
13
|
+
renderFrontmatter,
|
|
14
|
+
splitFrontmatter
|
|
15
|
+
} from "./chunk-J6QLLQVL.js";
|
|
16
|
+
import "./chunk-PLX3BOOS.js";
|
|
17
|
+
import {
|
|
18
|
+
RUNTIMES
|
|
19
|
+
} from "./chunk-65ZHM5RH.js";
|
|
20
|
+
import "./chunk-HQOB7OQS.js";
|
|
21
|
+
import "./chunk-S3PIAMXV.js";
|
|
22
|
+
import "./chunk-JS5RTH4I.js";
|
|
23
|
+
import "./chunk-DCU2EXQV.js";
|
|
24
|
+
import "./chunk-XELAZAIM.js";
|
|
25
|
+
import "./chunk-QEW4J3IZ.js";
|
|
26
|
+
import "./chunk-OPYFEHKG.js";
|
|
27
|
+
import "./chunk-EATCUWGG.js";
|
|
28
|
+
import {
|
|
29
|
+
ProjectError
|
|
30
|
+
} from "./chunk-NRBQK6UX.js";
|
|
31
|
+
import "./chunk-3PW4FI7U.js";
|
|
32
|
+
import "./chunk-SG5TPMKH.js";
|
|
33
|
+
import "./chunk-Z4HRRXRF.js";
|
|
34
|
+
import "./chunk-C4NHQGHL.js";
|
|
35
|
+
import "./chunk-Q5H3L6Y4.js";
|
|
36
|
+
import "./chunk-73AKO4UL.js";
|
|
37
|
+
import "./chunk-JEL35P7S.js";
|
|
38
|
+
import "./chunk-A4PKLESO.js";
|
|
39
|
+
import "./chunk-V4NPDK6X.js";
|
|
40
|
+
import {
|
|
41
|
+
kindOf
|
|
42
|
+
} from "./chunk-KMXRRSKT.js";
|
|
43
|
+
import "./chunk-YSAWTGNA.js";
|
|
44
|
+
import "./chunk-4VCC2NXE.js";
|
|
45
|
+
import {
|
|
46
|
+
recordProjector
|
|
47
|
+
} from "./chunk-665TA55Z.js";
|
|
48
|
+
import "./chunk-OEH47H6A.js";
|
|
49
|
+
import "./chunk-IJBSOWHK.js";
|
|
50
|
+
import "./chunk-E7OOHLQR.js";
|
|
51
|
+
import "./chunk-QPL7E2HW.js";
|
|
52
|
+
import "./chunk-PMJG2CXF.js";
|
|
53
|
+
|
|
54
|
+
// src/project/edit.ts
|
|
55
|
+
import {
|
|
56
|
+
cpSync,
|
|
57
|
+
existsSync,
|
|
58
|
+
mkdirSync,
|
|
59
|
+
readFileSync,
|
|
60
|
+
rmSync,
|
|
61
|
+
statSync,
|
|
62
|
+
writeFileSync
|
|
63
|
+
} from "fs";
|
|
64
|
+
import { basename, dirname, join } from "path";
|
|
65
|
+
var CROSS_TOOL = ["name", "description"];
|
|
66
|
+
var tomlValue = (value) => JSON.stringify(value);
|
|
67
|
+
function findEntry(entries, wanted) {
|
|
68
|
+
const exact = entries.filter((e) => e.name === wanted);
|
|
69
|
+
if (exact.length === 1 && exact[0]) return exact[0];
|
|
70
|
+
const bySlug = entries.filter(
|
|
71
|
+
(e) => e.slug === wanted || e.slug.endsWith(`/${wanted}`)
|
|
72
|
+
);
|
|
73
|
+
if (bySlug.length === 1 && bySlug[0]) return bySlug[0];
|
|
74
|
+
if (bySlug.length > 1) {
|
|
75
|
+
throw new ProjectError(
|
|
76
|
+
`${wanted} is ambiguous: ${bySlug.map((e) => e.name).join(", ")}`
|
|
77
|
+
);
|
|
78
|
+
}
|
|
79
|
+
throw new ProjectError(`no catalog skill or agent named ${wanted}`);
|
|
80
|
+
}
|
|
81
|
+
function addEntry(root, entry) {
|
|
82
|
+
const kind = kindOf(entry);
|
|
83
|
+
if (kind !== "skill" && kind !== "agent") {
|
|
84
|
+
throw new ProjectError(
|
|
85
|
+
`${entry.name} is a ${kind}; only skills and agents are added to .agents/`
|
|
86
|
+
);
|
|
87
|
+
}
|
|
88
|
+
const { meta, body } = splitFrontmatter(readFileSync(entry.path, "utf8"));
|
|
89
|
+
const name = basename(entry.slug);
|
|
90
|
+
if (!/^[a-z0-9][a-z0-9-]*$/u.test(name)) {
|
|
91
|
+
throw new ProjectError(
|
|
92
|
+
`${entry.name}: ${name} is not a usable directory name`
|
|
93
|
+
);
|
|
94
|
+
}
|
|
95
|
+
if (kind === "skill") {
|
|
96
|
+
const dest2 = join(root, ".agents/skills", name);
|
|
97
|
+
if (existsSync(dest2))
|
|
98
|
+
throw new ProjectError(`.agents/skills/${name} already exists`);
|
|
99
|
+
const source = entry.root ?? dirname(entry.path);
|
|
100
|
+
mkdirSync(dirname(dest2), { recursive: true });
|
|
101
|
+
if (statSync(source).isDirectory()) {
|
|
102
|
+
cpSync(source, dest2, { recursive: true });
|
|
103
|
+
} else {
|
|
104
|
+
mkdirSync(dest2);
|
|
105
|
+
}
|
|
106
|
+
const head = renderFrontmatter({
|
|
107
|
+
...meta,
|
|
108
|
+
name,
|
|
109
|
+
description: meta["description"] ?? entry.description
|
|
110
|
+
});
|
|
111
|
+
writeFileSync(
|
|
112
|
+
join(dest2, "SKILL.md"),
|
|
113
|
+
`${head}
|
|
114
|
+
${body.replace(/^\n/u, "")}`
|
|
115
|
+
);
|
|
116
|
+
return { kind, name, path: `.agents/skills/${name}` };
|
|
117
|
+
}
|
|
118
|
+
const dest = join(root, ".agents/agents", name);
|
|
119
|
+
if (existsSync(dest))
|
|
120
|
+
throw new ProjectError(`.agents/agents/${name} already exists`);
|
|
121
|
+
const kept = {};
|
|
122
|
+
const moved = {};
|
|
123
|
+
for (const [key, value] of Object.entries({ ...meta, name })) {
|
|
124
|
+
if (CROSS_TOOL.includes(key)) {
|
|
125
|
+
kept[key] = value;
|
|
126
|
+
continue;
|
|
127
|
+
}
|
|
128
|
+
moved[key] = value;
|
|
129
|
+
}
|
|
130
|
+
mkdirSync(dest, { recursive: true });
|
|
131
|
+
writeFileSync(
|
|
132
|
+
join(dest, "agent.md"),
|
|
133
|
+
`${renderFrontmatter(kept)}
|
|
134
|
+
${body.replace(/^\n/u, "")}`
|
|
135
|
+
);
|
|
136
|
+
if (Object.keys(moved).length > 0) {
|
|
137
|
+
const config = join(root, "pmcp.toml");
|
|
138
|
+
const lines = [
|
|
139
|
+
`[agents.${name}.claude]`,
|
|
140
|
+
...Object.entries(moved).map(([k, v]) => `${k} = ${tomlValue(v)}`)
|
|
141
|
+
];
|
|
142
|
+
const before = existsSync(config) ? readFileSync(config, "utf8") : "";
|
|
143
|
+
const sep = before === "" || before.endsWith("\n\n") ? "" : "\n";
|
|
144
|
+
writeFileSync(config, `${before}${sep}${lines.join("\n")}
|
|
145
|
+
`);
|
|
146
|
+
}
|
|
147
|
+
return { kind, name, path: `.agents/agents/${name}/agent.md` };
|
|
148
|
+
}
|
|
149
|
+
function withoutTables(toml, name) {
|
|
150
|
+
const own = new RegExp(
|
|
151
|
+
`^\\[(skills\\.${name}|agents\\.${name}(\\.[a-z]+)?)\\]\\s*$`,
|
|
152
|
+
"u"
|
|
153
|
+
);
|
|
154
|
+
const out = [];
|
|
155
|
+
let skipping = false;
|
|
156
|
+
for (const line of toml.split("\n")) {
|
|
157
|
+
if (/^\[/u.test(line)) skipping = own.test(line);
|
|
158
|
+
if (!skipping) out.push(line);
|
|
159
|
+
}
|
|
160
|
+
return out.join("\n").replace(/\n{3,}/gu, "\n\n");
|
|
161
|
+
}
|
|
162
|
+
function removeAsset(root, name) {
|
|
163
|
+
const removed = [];
|
|
164
|
+
for (const rel of [`.agents/skills/${name}`, `.agents/agents/${name}`]) {
|
|
165
|
+
if (!existsSync(join(root, rel))) continue;
|
|
166
|
+
rmSync(join(root, rel), { recursive: true, force: true });
|
|
167
|
+
removed.push(rel);
|
|
168
|
+
}
|
|
169
|
+
if (removed.length === 0)
|
|
170
|
+
throw new ProjectError(`no skill or agent named ${name} in .agents/`);
|
|
171
|
+
const config = join(root, "pmcp.toml");
|
|
172
|
+
if (existsSync(config)) {
|
|
173
|
+
const before = readFileSync(config, "utf8");
|
|
174
|
+
const after = withoutTables(before, name);
|
|
175
|
+
if (after !== before) writeFileSync(config, after);
|
|
176
|
+
}
|
|
177
|
+
return removed;
|
|
178
|
+
}
|
|
179
|
+
|
|
180
|
+
// src/commands/project/apply.ts
|
|
181
|
+
function reproject(context, spec) {
|
|
182
|
+
const result = project(spec, { check: false });
|
|
183
|
+
for (const problem of result.problems) context.ui.error(problem);
|
|
184
|
+
if (result.code !== 0) {
|
|
185
|
+
return 1;
|
|
186
|
+
}
|
|
187
|
+
recordProjector(spec);
|
|
188
|
+
if (result.backup) {
|
|
189
|
+
context.ui.info("backup", result.backup);
|
|
190
|
+
}
|
|
191
|
+
context.ui.success(
|
|
192
|
+
`projected ${result.outputs} outputs`,
|
|
193
|
+
result.pruned > 0 ? `pruned ${result.pruned}` : void 0
|
|
194
|
+
);
|
|
195
|
+
for (const deprecation of spec.deprecations ?? [])
|
|
196
|
+
context.ui.warn(deprecation);
|
|
197
|
+
for (const id of spec.hookBundle?.policy?.targets ?? []) {
|
|
198
|
+
if (RUNTIMES[id].trust !== "folder") continue;
|
|
199
|
+
context.ui.info(
|
|
200
|
+
id,
|
|
201
|
+
"hooks run only once you trust this folder in the runtime; pmcp doctor reports it"
|
|
202
|
+
);
|
|
203
|
+
}
|
|
204
|
+
return 0;
|
|
205
|
+
}
|
|
206
|
+
function projectOrCheck(context) {
|
|
207
|
+
const spec = specFrom(context);
|
|
208
|
+
if (!context.args.flags.has("check")) {
|
|
209
|
+
return reproject(context, spec);
|
|
210
|
+
}
|
|
211
|
+
const result = project(spec, { check: true });
|
|
212
|
+
for (const problem of result.problems) context.ui.error(problem);
|
|
213
|
+
for (const warning of result.warnings ?? []) context.ui.warn(warning);
|
|
214
|
+
if (result.code !== 0) {
|
|
215
|
+
context.ui.info(
|
|
216
|
+
"fix",
|
|
217
|
+
"pmcp project (edit .agents/ or pmcp.toml, never the outputs)"
|
|
218
|
+
);
|
|
219
|
+
return 2;
|
|
220
|
+
}
|
|
221
|
+
context.ui.success(`${result.outputs} outputs match`);
|
|
222
|
+
return 0;
|
|
223
|
+
}
|
|
224
|
+
function addAndProject(context, name) {
|
|
225
|
+
const spec = specFrom(context);
|
|
226
|
+
const added = addEntry(spec.root, findEntry(catalogFrom(context), name));
|
|
227
|
+
context.ui.success(`added ${added.kind} ${added.name}`, added.path);
|
|
228
|
+
return reproject(context, specFrom(context));
|
|
229
|
+
}
|
|
230
|
+
function removeAndProject(context, name) {
|
|
231
|
+
const spec = specFrom(context);
|
|
232
|
+
for (const path of removeAsset(spec.root, name)) {
|
|
233
|
+
context.ui.success("removed", path);
|
|
234
|
+
}
|
|
235
|
+
return reproject(context, specFrom(context));
|
|
236
|
+
}
|
|
237
|
+
export {
|
|
238
|
+
addAndProject,
|
|
239
|
+
projectOrCheck,
|
|
240
|
+
removeAndProject
|
|
241
|
+
};
|
|
242
|
+
//# sourceMappingURL=apply-4IGTXOCQ.js.map
|
|
@@ -0,0 +1,73 @@
|
|
|
1
|
+
import {
|
|
2
|
+
sayStanding
|
|
3
|
+
} from "./chunk-4NDEP7HU.js";
|
|
4
|
+
import {
|
|
5
|
+
matchingSkills,
|
|
6
|
+
readInstalledDependencies
|
|
7
|
+
} from "./chunk-BBTBJCFA.js";
|
|
8
|
+
import {
|
|
9
|
+
invocation
|
|
10
|
+
} from "./chunk-J7UYNJCR.js";
|
|
11
|
+
import {
|
|
12
|
+
projectFrom,
|
|
13
|
+
remoteCatalog
|
|
14
|
+
} from "./chunk-R5MT42JS.js";
|
|
15
|
+
import "./chunk-RMATE45Z.js";
|
|
16
|
+
import "./chunk-73AKO4UL.js";
|
|
17
|
+
import {
|
|
18
|
+
availableSpec
|
|
19
|
+
} from "./chunk-ABTJQ4QV.js";
|
|
20
|
+
import {
|
|
21
|
+
ArgumentError
|
|
22
|
+
} from "./chunk-A4PKLESO.js";
|
|
23
|
+
import "./chunk-KMXRRSKT.js";
|
|
24
|
+
import "./chunk-YSAWTGNA.js";
|
|
25
|
+
|
|
26
|
+
// src/commands/available.ts
|
|
27
|
+
var availableCommand = {
|
|
28
|
+
...availableSpec,
|
|
29
|
+
async run(context) {
|
|
30
|
+
if (context.args.positional.length)
|
|
31
|
+
throw new ArgumentError("available takes no package arguments");
|
|
32
|
+
const inventory = readInstalledDependencies(projectFrom(context));
|
|
33
|
+
const catalog = await remoteCatalog(context);
|
|
34
|
+
const matches = matchingSkills(catalog, inventory);
|
|
35
|
+
if (context.args.flags.has("json")) {
|
|
36
|
+
context.ui.data(
|
|
37
|
+
`${JSON.stringify({ catalogRevision: catalog.revision, matches, issues: inventory.issues }, null, 2)}
|
|
38
|
+
`
|
|
39
|
+
);
|
|
40
|
+
} else {
|
|
41
|
+
for (const match of matches) {
|
|
42
|
+
const status = match.verified ? "verified" : "compatible, not verified at this exact version";
|
|
43
|
+
context.ui.data(
|
|
44
|
+
`${match.targetName}@${match.targetVersion} ${match.entry.delivery.packageName}@${match.entry.delivery.version} ${status}
|
|
45
|
+
`
|
|
46
|
+
);
|
|
47
|
+
const { verifiedOn, examplesExecuted } = match.entry.evidence;
|
|
48
|
+
context.ui.line(
|
|
49
|
+
` ${examplesExecuted} examples executed${verifiedOn ? ` on ${verifiedOn}` : ""}`
|
|
50
|
+
);
|
|
51
|
+
const headings = match.entry.preview?.headings ?? [];
|
|
52
|
+
if (headings.length > 0) {
|
|
53
|
+
context.ui.line(` ${headings.join(" \xB7 ")}`);
|
|
54
|
+
}
|
|
55
|
+
sayStanding(context, match.entry.line);
|
|
56
|
+
}
|
|
57
|
+
context.ui.info(`${matches.length} matching skills`, catalog.revision);
|
|
58
|
+
if (matches.length > 0) {
|
|
59
|
+
context.ui.info(
|
|
60
|
+
"preview",
|
|
61
|
+
`${invocation()} preview <package> shows the contents and a complete example`
|
|
62
|
+
);
|
|
63
|
+
}
|
|
64
|
+
for (const issue of inventory.issues)
|
|
65
|
+
context.ui.warn(issue.reason, issue.name);
|
|
66
|
+
}
|
|
67
|
+
return inventory.issues.length ? 1 : 0;
|
|
68
|
+
}
|
|
69
|
+
};
|
|
70
|
+
export {
|
|
71
|
+
availableCommand
|
|
72
|
+
};
|
|
73
|
+
//# sourceMappingURL=available-DBSIVVJ6.js.map
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
import {
|
|
2
|
+
change
|
|
3
|
+
} from "./chunk-RK4PYD7L.js";
|
|
4
|
+
import "./chunk-SG5TPMKH.js";
|
|
5
|
+
import "./chunk-Z4HRRXRF.js";
|
|
6
|
+
import "./chunk-C4NHQGHL.js";
|
|
7
|
+
import "./chunk-A4PKLESO.js";
|
|
8
|
+
import "./chunk-OEH47H6A.js";
|
|
9
|
+
import "./chunk-IJBSOWHK.js";
|
|
10
|
+
import "./chunk-QPL7E2HW.js";
|
|
11
|
+
import "./chunk-PMJG2CXF.js";
|
|
12
|
+
|
|
13
|
+
// src/sessions/cli/broadcast.ts
|
|
14
|
+
var run = (context) => change(context, "broadcast");
|
|
15
|
+
export {
|
|
16
|
+
run
|
|
17
|
+
};
|
|
18
|
+
//# sourceMappingURL=broadcast-3RY3OZGY.js.map
|