@modootoday/pmcp 0.20.0 → 0.22.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/.mcp.json +1 -1
- package/dist/{apply-QJ6MGLBX.js → apply-3PR4UOES.js} +58 -24
- package/dist/{available-HYSDAFYH.js → available-BFXLII4A.js} +7 -7
- package/dist/{broadcast-LYOA6BEW.js → broadcast-ZALGUJVR.js} +4 -4
- package/dist/chunk-2GI5RM3M.js +53 -0
- package/dist/chunk-2QJGUR23.js +274 -0
- package/dist/{chunk-FD6VGFYZ.js → chunk-3LADLKAI.js} +207 -15
- package/dist/{chunk-MZEMLFFD.js → chunk-3OBJVG5R.js} +2 -2
- package/dist/{chunk-IQD4W53M.js → chunk-57Q75MS4.js} +18 -18
- package/dist/chunk-5YCKFU5Q.js +1672 -0
- package/dist/{chunk-IZABPDAO.js → chunk-5ZUDBC3P.js} +2 -2
- package/dist/{chunk-EKPMVEIA.js → chunk-73IDLWRI.js} +7 -4
- package/dist/{chunk-QYH2NR6G.js → chunk-7FV2LORT.js} +2 -2
- package/dist/{chunk-4VK5G3SV.js → chunk-E6YP2PMO.js} +3 -5
- package/dist/{chunk-RMHZFWHF.js → chunk-EPNTYTDZ.js} +33 -33
- package/dist/{chunk-5JPD6VIH.js → chunk-GBKRDRMZ.js} +22 -7
- package/dist/{chunk-T6GOWHK6.js → chunk-GFOQDLPL.js} +6 -1
- package/dist/{chunk-RBNMNKNN.js → chunk-JQVSDPFL.js} +3 -3
- package/dist/{chunk-OG7QR2DP.js → chunk-KEHB4FZP.js} +17 -2
- package/dist/chunk-KUBHGVTD.js +126 -0
- package/dist/chunk-L42U5XKC.js +7 -0
- package/dist/chunk-LFFIQBNY.js +115 -0
- package/dist/{chunk-O2JWF7ZM.js → chunk-LVNGMGOM.js} +2 -2
- package/dist/{chunk-PQTM27GU.js → chunk-MR5IBS6L.js} +6 -7
- package/dist/{chunk-OAIQ7A3R.js → chunk-NDED2O5B.js} +5 -5
- package/dist/{chunk-M2RYXWX2.js → chunk-NHUMPEPV.js} +2 -2
- package/dist/{chunk-ONP6JRFZ.js → chunk-OFJIMBTL.js} +2 -2
- package/dist/{chunk-YN5GQCHN.js → chunk-RHJEGLYM.js} +6 -1
- package/dist/{chunk-JBHGJKSL.js → chunk-RNC7PGW2.js} +2 -2
- package/dist/{chunk-J6HNP6HA.js → chunk-RNE4WPBS.js} +2 -2
- package/dist/{chunk-YDICIB2A.js → chunk-S4Y44CCC.js} +2 -2
- package/dist/{chunk-K2C3KFGB.js → chunk-SEM6WD7J.js} +29 -17
- package/dist/{chunk-CQZYQAAV.js → chunk-SLCNCAWY.js} +3 -3
- package/dist/{chunk-L4MFGGSI.js → chunk-SPZ42EWE.js} +2 -2
- package/dist/{chunk-QOFSPFJ6.js → chunk-TCW2H47H.js} +3405 -3395
- package/dist/{chunk-FQAJSNNU.js → chunk-TPGJXENR.js} +3 -3
- package/dist/chunk-UKR64U7J.js +20 -0
- package/dist/{chunk-66F3HLW4.js → chunk-XB363ZXT.js} +122 -4
- package/dist/{chunk-UD3BEEBQ.js → chunk-XZ2TDH3J.js} +80 -3
- package/dist/{chunk-QSIADSMQ.js → chunk-Z6WRFOFT.js} +3 -3
- package/dist/{claude-GT2BPXEL.js → claude-XVLF4N4S.js} +3 -3
- package/dist/{cli-IV5DJCXU.js → cli-6FWRBCWM.js} +8 -8
- package/dist/{cli-6HTAJ54L.js → cli-BEEDAD4E.js} +7 -7
- package/dist/cli.js +11 -11
- package/dist/{completion-PPM7MEI2.js → completion-LHYNCQ3N.js} +7 -7
- package/dist/{diagnostics-EWU2ROTG.js → diagnostics-ABTJUYZQ.js} +5 -6
- package/dist/{doctor-ZWZQMDKZ.js → doctor-GPPO5L4F.js} +36 -36
- package/dist/{entry-NDICBQ2F.js → entry-ARGY5CKA.js} +14 -15
- package/dist/{exec-mcp-AG4G7SG7.js → exec-mcp-JEF74XVP.js} +16 -14
- package/dist/{harness-JABSZCAA.js → harness-OCXW6YE4.js} +6 -6
- package/dist/harness-launch-gate.js +3 -4
- package/dist/harness-worker.js +5 -6
- package/dist/hook-body.js +247 -86
- package/dist/{hook-spec-C7umArqw.d.ts → hook-spec-hZL4MSgi.d.ts} +8 -3
- package/dist/hooks-JHXUN5MD.js +24 -0
- package/dist/{host-2SZRMHZX.js → host-OBRHBDRE.js} +6 -7
- package/dist/{host-BWZ5LA4Q.js → host-VI4ZFCZP.js} +18 -16
- package/dist/{host-run-SXLV4LHI.js → host-run-H7AITG7C.js} +5 -7
- package/dist/http.js +1 -1
- package/dist/{import-mcp-2M7SZRVQ.js → import-mcp-3Y33CUHF.js} +15 -12
- package/dist/index.d.ts +11 -2
- package/dist/index.js +25 -25
- package/dist/{init-HOOIFBAD.js → init-WZJHMWNJ.js} +3 -3
- package/dist/{install-HF6CROQP.js → install-7V6NIA7W.js} +4 -4
- package/dist/{invoke-JP4MILYY.js → invoke-GWWTXQLO.js} +7 -8
- package/dist/{list-UBSBUZKS.js → list-Y6UPLGNF.js} +21 -18
- package/dist/{logout-OO3DERRK.js → logout-KAUW4JZZ.js} +16 -13
- package/dist/{logs-K3QXKRD4.js → logs-74JGLQG6.js} +4 -4
- package/dist/{mailbox-DAJV6VAI.js → mailbox-VK5AVTHI.js} +7 -7
- package/dist/{mainline-6K5BA3WX.js → mainline-Q42M2GJ2.js} +173 -34
- package/dist/{mcp-JXNTKRJG.js → mcp-IDEUIY2F.js} +2 -2
- package/dist/{pause-GRVTSKOK.js → pause-CZ2OZYLC.js} +4 -4
- package/dist/project/hook-adapter.d.ts +1 -1
- package/dist/{project-M672MKQH.js → project-GVVWLDOJ.js} +5 -5
- package/dist/{pty-LHKJKY2E.js → pty-CDLQ4NP2.js} +3 -3
- package/dist/report-Z3JV2PCT.js +105 -0
- package/dist/{resume-6DMPGG3N.js → resume-DFIHT2RO.js} +4 -4
- package/dist/{run-ORBIERI3.js → run-HVNKQHVU.js} +4 -4
- package/dist/{run-5W566T3V.js → run-RRWB7U2Q.js} +15 -12
- package/dist/{serve-73SRPAV4.js → serve-KJSOU3BR.js} +3 -3
- package/dist/{session-XM2CR425.js → session-YZVX4NGN.js} +4 -4
- package/dist/{setup-ULKDPF5B.js → setup-3GET6K3J.js} +4 -4
- package/dist/smoke-FQQJOQBD.js +16 -0
- package/dist/{start-login-BGFAMCZL.js → start-login-RNHSEX5P.js} +16 -13
- package/dist/{status-YHXEAJ7U.js → status-3RTGDN2K.js} +10 -10
- package/dist/{status-YCW6YJ3S.js → status-RR4VZARJ.js} +40 -23
- package/dist/{status-73FEFQUQ.js → status-Y25ONHA5.js} +16 -13
- package/dist/stdio.js +2 -2
- package/dist/{sweep-XF2HG3EO.js → sweep-EPJMEZR6.js} +4 -4
- package/dist/{test-IMNBXOYW.js → test-7NYPQ6YU.js} +30 -20
- package/dist/{tui-5GDA22TB.js → tui-H5RPSF4B.js} +4 -4
- package/dist/{unbroadcast-XP3OCVN3.js → unbroadcast-NTOC3PY3.js} +4 -4
- package/dist/{worker-RV6NGSXT.js → worker-YWFTWIBP.js} +9 -10
- package/dist/{worktree-list-4PLE7K6L.js → worktree-list-EMKUMCTQ.js} +2 -2
- package/dist/{worktree-sync-GQVYAXGJ.js → worktree-sync-A277AF4M.js} +4 -6
- package/docs/commands.md +14 -7
- package/docs/git-workflow.md +53 -13
- package/docs/hooks.md +138 -10
- package/docs/project-configuration.md +31 -1
- package/docs/upgrading.md +58 -0
- package/gemini-extension.json +2 -2
- package/mcp.json +1 -1
- package/package.json +5 -5
- package/plugin.json +1 -1
- package/plugins/pmcp/.claude-plugin/plugin.json +1 -1
- package/plugins/pmcp/.mcp.json +1 -1
- package/plugins/pmcp/gemini-extension.json +2 -2
- package/plugins/pmcp/mcp.json +1 -1
- package/plugins/pmcp/mod/sessions/format.ts +2 -2
- package/plugins/pmcp/plugin.json +1 -1
- package/plugins/pmcp/skills/agent-assets-migrate/SKILL.md +11 -8
- package/plugins/pmcp/skills/pmcp-project-init/SKILL.md +11 -7
- package/skills/agent-assets-migrate/SKILL.md +11 -8
- package/skills/pmcp-project-init/SKILL.md +11 -7
- package/dist/chunk-7SDOSTW7.js +0 -130
- package/dist/chunk-AWZF72SH.js +0 -1025
- package/dist/chunk-FGYFA6JY.js +0 -7
- package/dist/chunk-ICF2JZSN.js +0 -92
- package/dist/chunk-ISNRDHSD.js +0 -74
- package/dist/chunk-QDY6BWE6.js +0 -396
- package/dist/hooks-YVQSDQV3.js +0 -21
package/docs/commands.md
CHANGED
|
@@ -20,7 +20,7 @@ An unrecognised command does not fall through to a server the caller did not ask
|
|
|
20
20
|
pmcp status [--config <file>] [--json]
|
|
21
21
|
```
|
|
22
22
|
|
|
23
|
-
Show enabled features and their TOML or auto source, projection drift, live sessions, pause, leases, unseen broadcasts, worktree ahead/behind counts, shared MCP credential presence,
|
|
23
|
+
Show enabled features and their TOML or auto source, projection drift, live sessions, pause, leases, unseen broadcasts, worktree ahead/behind counts, shared MCP credential presence, logged errors from the last hour, and, with a [`[budget]`](project-configuration.md#budget) table, each limit beside what it measured. Reads do not acknowledge broadcasts, refresh credentials, prune logs, fetch or move git refs. Projection uses the same check as `project --check`. Exit 0, or 2 when projection or worktree ahead/behind drift exists or a budget limit is exceeded. Missing or invalid input follows the normal usage/failure exit contract. Human output is a compact summary on stderr; JSON retains the full details.
|
|
24
24
|
|
|
25
25
|
## init
|
|
26
26
|
|
|
@@ -44,6 +44,13 @@ Session state is isolated in a temporary directory, then removed. Commands and p
|
|
|
44
44
|
|
|
45
45
|
`--session-state` accepts a JSON object with optional `records` (session records with valid 8–64 character IDs), `pause` (by, reason, since), `leases` (name to pid, subject, since, optional cwd), and `broadcast` (id, by, text, since). Pause and broadcast may be null. Existing liveness and unseen-broadcast rules apply. This file and the real session store remain unchanged.
|
|
46
46
|
|
|
47
|
+
```sh
|
|
48
|
+
pmcp hooks report [--since 2d] [--json]
|
|
49
|
+
pmcp hooks report --switch-check shell.heredoc [--since 2d] [--json]
|
|
50
|
+
```
|
|
51
|
+
|
|
52
|
+
`report` summarises the guard lines the hook bundle writes to the project log at debug level (`[logging] level = "debug"`, or `PMCP_LOG=debug`). For each guard and runtime it counts the runs, what the guard found before its mode (`raw`: allow, deny, ask) and what the call got, the modes seen, the sessions, and the p50, p95 and longest durations. Sessions matching a `[hooks.report] exclude_sessions` regex (replays, smoke runs) are left out and counted. `--since` takes a duration such as `10m`, `2h` or `3d`, or an ISO time. `--switch-check <guard>` lists instead the calls that guard found something in and let through, because it was in `observe` or `warn`: what `deny` would have refused. The log holds no command, prompt or transcript text, so neither does the report. `--json` prints `{version, since?, lines, sessions, excluded, guards}`, or `{version, guard, refused}` with `--switch-check`.
|
|
53
|
+
|
|
47
54
|
## Read command JSON schemas
|
|
48
55
|
|
|
49
56
|
These opt-in snapshots write one JSON object and a newline to stdout, with `version: 1`. No color or human summary is mixed into stdout. Errors remain on stderr. Without the flag, existing human output is retained, including MCP status's original unversioned object and logs' JSONL stream. Schemas are named in [schemas.json](https://pmcp.build/commands/schemas.json); each entry under `schemas` uses the shared root `$defs`. Consumers must allow unknown fields inside session, decision and log records. Tokens are never part of an auth status object.
|
|
@@ -133,11 +140,11 @@ Credentials and attachment files contain secrets and must stay outside source co
|
|
|
133
140
|
|
|
134
141
|
```sh
|
|
135
142
|
pmcp project
|
|
136
|
-
pmcp project --check
|
|
143
|
+
pmcp project --check [--smoke]
|
|
137
144
|
pmcp project import-mcp --source codex:/path/to/config.toml
|
|
138
145
|
```
|
|
139
146
|
|
|
140
|
-
Generate selected runtimes' native files from `pmcp.toml`. Unmanaged entries and credential references are preserved; conflicts stop the write. `--check` reports drift without writes, and MCP import previews changes by default; `--write` applies them. [Configuration and guard examples](project-configuration.md).
|
|
147
|
+
Generate selected runtimes' native files from `pmcp.toml`. Unmanaged entries and credential references are preserved; conflicts stop the write. `--check` reports drift without writes, and MCP import previews changes by default; `--write` applies them. `--check --smoke` then runs the `[hooks.test] fixtures` file as `pmcp hooks test --fixtures` does, and exits 2 on any finding. [Configuration and guard examples](project-configuration.md).
|
|
141
148
|
|
|
142
149
|
Configuration files and the ownership lock are replaced atomically one file at a time. If projection is interrupted, inspect with `pmcp project --check`, then run `pmcp project` explicitly to repair drift. Projection does not start a runtime or replay terminal input. The complete set of files is not a single transaction.
|
|
143
150
|
|
|
@@ -173,7 +180,7 @@ Read this project's JSONL logs from the state directory, or the file `[hooks] er
|
|
|
173
180
|
pmcp git worktree create review [--base <ref>]
|
|
174
181
|
pmcp git worktree list
|
|
175
182
|
pmcp git worktree sync
|
|
176
|
-
pmcp git deliver [<commit>...] [--during-pause] [--json]
|
|
183
|
+
pmcp git deliver [<commit>...] [--during-pause] [--no-push] [--json]
|
|
177
184
|
pmcp git sync
|
|
178
185
|
```
|
|
179
186
|
|
|
@@ -182,8 +189,8 @@ The git workflow configured by [`[git]`](git-workflow.md). Each subcommand needs
|
|
|
182
189
|
- `worktree create <alias>` makes a linked worktree under `[git.worktrees] root` on a new branch from the upstream (or `--base`), links the configured files from the main checkout, runs `bootstrap`, and prints the path.
|
|
183
190
|
- `worktree list` prints alias, branch, behind/ahead and path for the main checkout and each linked worktree.
|
|
184
191
|
- `worktree sync` moves the current worktree onto the mainline when that loses nothing; exit 1 when it is held back.
|
|
185
|
-
- `deliver` fetches, replays the named commits (default: the ones the upstream lacks) onto the mainline, runs the gate in its own tree under a lock, and pushes; it replays again if the mainline moved. A delivery that touches a leased path holds that lease until it has pushed and installed, and it refuses during a pause unless `--during-pause` or `during_pause = "allow"`. Exit 0 delivered or nothing to deliver
|
|
186
|
-
- `sync` moves the main checkout to the mainline, installs when a listed file changed, and follows clean submodule pins. Exit 0 moved or already equal, 1 when local work would be lost, 2 when blocked (undelivered edits) or the fetch failed.
|
|
192
|
+
- `deliver` fetches, replays the named commits (default: the ones the upstream lacks) onto the mainline, runs the gate in its own tree under a lock, and pushes; it replays again if the mainline moved. A delivery that touches a leased path holds that lease until it has pushed and installed, and it refuses during a pause unless `--during-pause` or `during_pause = "allow"`. `--no-push` replays and runs the gate command, then stops: it takes no lease and pushes, syncs and notifies nothing, and it refuses `gate = "pre-push"`, where the push is the gate. Exit 0 delivered, gated with `--no-push`, or nothing to deliver; 1 refused, gate failed or attempts exhausted; 2 fetch failed or `--no-push` with the pre-push gate.
|
|
193
|
+
- `sync` moves the main checkout to the mainline, installs when a listed file changed, and follows clean submodule pins. Exit 0 moved or already equal, 1 when local work would be lost, 2 when blocked (undelivered edits) or the fetch failed. Run in a desk (a linked worktree matching `[git.worktrees] desks`), it brings the desk up to date the same way without rebasing: exit 0 moved or current, 1 held (an unlanded commit, uncommitted tracked edits, a pause, another session's lease, a git operation in progress), with the reason. In any other linked worktree it exits 2.
|
|
187
194
|
|
|
188
195
|
## completion
|
|
189
196
|
|
|
@@ -212,7 +219,7 @@ pmcp doctor
|
|
|
212
219
|
pmcp doctor --memory
|
|
213
220
|
```
|
|
214
221
|
|
|
215
|
-
Inspect native configuration and prerequisites. The optional memory report shows enabled state and paths; it does not read memory contents or synchronize personal memory. [Doctor scope and runtime compatibility](project-configuration.md).
|
|
222
|
+
Inspect native configuration and prerequisites, including [native hook entries pmcp does not own](hooks.md#native-hook-entries-pmcp-does-not-own), which `project --check` also checks. The optional memory report shows enabled state and paths; it does not read memory contents or synchronize personal memory. [Doctor scope and runtime compatibility](project-configuration.md).
|
|
216
223
|
|
|
217
224
|
## validate
|
|
218
225
|
|
package/docs/git-workflow.md
CHANGED
|
@@ -30,15 +30,34 @@ turn it on.
|
|
|
30
30
|
| `alias_pattern` | regex | `"^[a-z][a-z0-9-]{1,30}$"` |
|
|
31
31
|
| `bootstrap` | argv list | none |
|
|
32
32
|
| `link_from_main` | list | `[]` |
|
|
33
|
+
| `desks` | glob | `"<root>/*"` |
|
|
34
|
+
|
|
35
|
+
Each checkout is one of three kinds, derived and never declared per checkout:
|
|
36
|
+
**shared** is the main checkout (its `.git` is a directory), a **desk** is a
|
|
37
|
+
linked worktree whose path relative to the main checkout matches `desks` (by
|
|
38
|
+
default, the worktrees `pmcp git worktree create` makes), and every other linked
|
|
39
|
+
worktree is **scratch** (the gate tree, delivery replays, one made by hand).
|
|
33
40
|
|
|
34
41
|
`[git.worktrees.sync]` (opt-in) keeps each linked worktree on the mainline when moving it
|
|
35
42
|
loses nothing: `on_session_start` (`"fetch_and_move"` default, `"move"`,
|
|
36
43
|
`"off"`), `between_prompts` (`"move_if_light"` default, `"off"`: move only when
|
|
37
44
|
no install is needed), `install_after_move` (`"off"` default, `"background"`,
|
|
38
|
-
`"foreground"`)
|
|
39
|
-
session)
|
|
40
|
-
|
|
41
|
-
|
|
45
|
+
`"foreground"`), `notice_paths` (paths whose change is announced to the
|
|
46
|
+
session) and `after_deliver` (`"off"` default, or `"desk"`: a delivery run in a
|
|
47
|
+
desk then syncs that desk as `pmcp git sync` does there, holding its leases, and
|
|
48
|
+
the `--json` receipt reports it as `desk_sync`). Installs never block a session.
|
|
49
|
+
A worktree is not moved while the workspace is paused or while any lease is held
|
|
50
|
+
(every `[sessions.leases.<name>]`, or the implicit `lockfile` lease), and the
|
|
51
|
+
session is told which.
|
|
52
|
+
|
|
53
|
+
`pmcp git sync` acts by kind. In the main checkout it is the main checkout sync
|
|
54
|
+
described under `[git.mainline.sync]`. In a desk it brings the desk up to date
|
|
55
|
+
mid-session: it fetches, then fast-forwards, or uses `reset --keep` when every
|
|
56
|
+
commit the desk has beyond the mainline is landed there, follows clean
|
|
57
|
+
submodule pins and runs the install when the lockfile changed. It never rebases:
|
|
58
|
+
an unlanded commit, an uncommitted change to a tracked file, a pause, another
|
|
59
|
+
session's lease, or a git operation in progress holds the desk where it is
|
|
60
|
+
(exit 1, with the reason). In a scratch worktree it moves nothing (exit 2).
|
|
42
61
|
|
|
43
62
|
`[git.mainline.gate]`: `command` (argv; no gate when missing), `tree` (the
|
|
44
63
|
gate's worktree, default `<state dir>/gate/tree`; a relative path is relative to
|
|
@@ -81,14 +100,22 @@ through delivery), `during_pause` (`"refuse"` default or `"allow"`),
|
|
|
81
100
|
`lease_wait_seconds` (default `3600`), `notify` (argv run after a
|
|
82
101
|
delivery), `gate` and `push_env`.
|
|
83
102
|
|
|
103
|
+
A commit is already on the mainline when `git cherry` finds the same patch there,
|
|
104
|
+
or when it only moves submodule pins, each to a commit that the mainline's pin for
|
|
105
|
+
that path equals or contains. Containment is read in the submodule's checkout,
|
|
106
|
+
else in the repository git keeps for it, and without either the commit counts as
|
|
107
|
+
missing. Delivery skips such a commit; `pmcp git sync` and worktree sync move past
|
|
108
|
+
it as a landed duplicate, so another session's newer pin never makes a replay
|
|
109
|
+
conflict or a sync refusal.
|
|
110
|
+
|
|
84
111
|
The push of a delivery runs the repository's own hooks, so a pre-push hook that
|
|
85
112
|
gates as well needs one of two set-ups.
|
|
86
113
|
|
|
87
114
|
- `gate = "pre-push"` makes that hook the gate: pmcp takes the lock, replays and
|
|
88
115
|
retries, runs no `[git.mainline.gate] command` (declaring one is an error),
|
|
89
116
|
and pushes with `lock_env` set to `1`, so a hook that takes the same lock does
|
|
90
|
-
not wait on pmcp. The push output
|
|
91
|
-
failed gate.
|
|
117
|
+
not wait on pmcp. The push output streams to the terminal as it comes and is
|
|
118
|
+
kept as the gate log, and a refused push is a failed gate.
|
|
92
119
|
- `gate = "command"` (the default) keeps pmcp's command as the gate.
|
|
93
120
|
`push_env` (a table of variable names to strings, default `{}`) adds variables
|
|
94
121
|
to the push alone in either mode, so a hook can recognise a delivery that was
|
|
@@ -98,19 +125,32 @@ Every delivery push also carries `PMCP_GIT_DELIVER=1`. In command mode the lock
|
|
|
98
125
|
variable reaches the push only if `push_env` names it.
|
|
99
126
|
|
|
100
127
|
`pmcp git deliver --json` prints one receipt on stdout when it ends, progress
|
|
101
|
-
staying on stderr: `{ok, code, delivered, upstream, attempts,
|
|
102
|
-
reason?}`, where `delivered` is the upstream commit it pushed (or
|
|
103
|
-
|
|
104
|
-
`
|
|
105
|
-
|
|
106
|
-
|
|
128
|
+
staying on stderr: `{ok, code, delivered, upstream, attempts, replayed, gate,
|
|
129
|
+
leases, sync, desk_sync, reason?}`, where `delivered` is the upstream commit it pushed (or
|
|
130
|
+
`null`), `replayed` the tip of its last replay onto the upstream (or `null`),
|
|
131
|
+
`gate` is `{exit, log, by}` for the last gate run (or `null`; `by` is
|
|
132
|
+
`"command"` or `"pre-push"`), `leases` the leases it took, `sync` the main
|
|
133
|
+
checkout's sync after the delivery (or `null` when none ran) as
|
|
134
|
+
`{from, to, code, reason?}`: the main checkout's HEAD before and after, the exit
|
|
135
|
+
code `pmcp git sync` would have, and its last warning; `desk_sync` the same for the
|
|
136
|
+
delivering desk's own sync (`[git.worktrees.sync] after_deliver = "desk"`); and
|
|
137
|
+
`reason` is the last refusal or failure. `--no-push` stops after the gate, so its
|
|
138
|
+
receipt has `replayed` and `gate` but `delivered`, `sync` and `desk_sync` are
|
|
139
|
+
`null`.
|
|
140
|
+
Exit codes: `0` delivered or nothing to deliver, even when the sync after it was
|
|
141
|
+
refused; `1` refused, a lease or the gate lock held too long, a replay
|
|
107
142
|
conflict, the gate failed, the push failed or it gave up after `attempts`; `2`
|
|
108
143
|
fetch failed or no configuration.
|
|
109
144
|
|
|
110
145
|
`[git.mainline.sync]` enables `pmcp git sync`, which moves the main checkout to
|
|
111
146
|
the mainline: `install` (argv), `install_when_changed` (paths; when no
|
|
112
147
|
`[sessions.leases]` are declared, these become an implicit `lockfile` lease),
|
|
113
|
-
`keep_identical_files` and `refuse_with_unlanded` (booleans, default `true`)
|
|
148
|
+
`keep_identical_files` and `refuse_with_unlanded` (booleans, default `true`) and
|
|
149
|
+
`after_deliver`. With the table present, a delivery syncs the main checkout once it is
|
|
150
|
+
delivered, holding its leases through the install: `after_deliver = "from_main"`
|
|
151
|
+
(the default) does so only for a delivery run in the main checkout, `"always"`
|
|
152
|
+
also for one run in a linked worktree, and `"off"` never. Every refusal of
|
|
153
|
+
`pmcp git sync` still applies, and a refused sync leaves the delivery a success.
|
|
114
154
|
|
|
115
155
|
After a successful install, sync records the hash it installed in a stamp and
|
|
116
156
|
installs again only when that hash changes. By default the stamp is pmcp's own,
|
package/docs/hooks.md
CHANGED
|
@@ -104,18 +104,128 @@ command the parser cannot read is judged by a conservative pattern instead.
|
|
|
104
104
|
|
|
105
105
|
## `[[hooks.guards.custom]]`
|
|
106
106
|
|
|
107
|
-
A project
|
|
107
|
+
A project command that decides like a built-in guard: a script under
|
|
108
|
+
`.agents/guards/`, or an installed program pinned by its version.
|
|
109
|
+
|
|
110
|
+
| Key | Type | Default | Meaning |
|
|
111
|
+
| ------------ | --------- | ---------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
112
|
+
| `name` | string | required | `^[a-z0-9][a-z0-9-]*$`, unique across custom, shell and edit entries. |
|
|
113
|
+
| `command` | argv list | required | Without `version`, the first or second element is the script, which must exist inside `.agents/guards/`; its sha256 is pinned in `policy.json`. With `version`, the first element is the program, found on `PATH`. |
|
|
114
|
+
| `version` | string | none | The version an installed program reports: `pmcp project`, `pmcp project --check` and `pmcp doctor` run `<program> --version` and refuse when the output does not contain it as a whole token (`1.2.3` matches `tool v1.2.3`, not `1.2.30`). A script under `.agents/guards/` cannot take one. |
|
|
115
|
+
| `targets` | list | required | Any `[hooks] targets` runtime. A runtime in `[hooks] targets` runs it in the hook bundle; otherwise Codex, Gemini and Antigravity use the shell adapter, and Claude, Grok and OpenCode are an error. |
|
|
116
|
+
| `timeout_ms` | integer | `15000` | 100 to 60000. |
|
|
117
|
+
| `on` | string | `"before_shell"` | `before_shell`, `after_edit`, `prompt`, `stop` or `session_start`. |
|
|
118
|
+
| `mode` | string | `"deny"` | `deny`, `ask`, `warn`, `observe` or `off`, as for a built-in guard. |
|
|
119
|
+
|
|
120
|
+
What a refusal (`mode = "deny"`) does depends on the event and the runtime; pmcp
|
|
121
|
+
renders it as each runtime's hooks can take it, and where one cannot, the reason
|
|
122
|
+
goes nowhere:
|
|
123
|
+
|
|
124
|
+
| `on` | Claude Code | Codex | Gemini, OpenCode | Antigravity | Grok |
|
|
125
|
+
| --------------- | ------------------------------------ | ------------------------------------ | --------------------- | ---------------------------------- | ----------------------------------------------- |
|
|
126
|
+
| `before_shell` | refuses the call (`ask` asks) | refuses the call | refuses the call | refuses the call | refuses the call |
|
|
127
|
+
| `after_edit` | the reason as feedback | the reason as feedback | the reason as context | nothing | the reason as context |
|
|
128
|
+
| `prompt` | blocks the prompt, with the reason | blocks the prompt, with the reason | the reason as context | the reason as a message | nothing |
|
|
129
|
+
| `stop` | keeps the turn going with the reason | keeps the turn going with the reason | nothing | continues the turn with the reason | the reason as context, which continues the turn |
|
|
130
|
+
| `session_start` | the reason as context | the reason as context | the reason as context | the reason as a message | the reason as context at its next tool call |
|
|
131
|
+
|
|
132
|
+
With `mode = "warn"` the reason reaches every runtime as context, at that event
|
|
133
|
+
or, where the runtime takes none there, at the next event that carries context.
|
|
134
|
+
A session cannot be refused at its start, so on `session_start` the modes
|
|
135
|
+
`deny` and `ask` act as `warn`. `ask` asks only in Claude Code; elsewhere
|
|
136
|
+
`[hooks] ask_fallback` decides. A turn kept going by `stop` is not kept going
|
|
137
|
+
again by the stop that ends it.
|
|
138
|
+
|
|
139
|
+
### The guard contract, `pmcp.guard.v1`
|
|
140
|
+
|
|
141
|
+
The command gets one JSON object on stdin:
|
|
142
|
+
|
|
143
|
+
```json
|
|
144
|
+
{
|
|
145
|
+
"protocol": "pmcp.guard.v1",
|
|
146
|
+
"runtime": "claude",
|
|
147
|
+
"event": "before_shell",
|
|
148
|
+
"session": "<session id>",
|
|
149
|
+
"command": "<the shell command, or empty>",
|
|
150
|
+
"cwd": "<the session's directory>",
|
|
151
|
+
"paths": ["<the edited paths, after_edit>"],
|
|
152
|
+
"prompt": "<the prompt text, on prompt only>"
|
|
153
|
+
}
|
|
154
|
+
```
|
|
155
|
+
|
|
156
|
+
It runs in the project root with only `PATH` and `LANG`, and answers on stdout
|
|
157
|
+
with one JSON object and exit 0:
|
|
108
158
|
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
159
|
+
```json
|
|
160
|
+
{
|
|
161
|
+
"decision": "deny",
|
|
162
|
+
"reason": "why",
|
|
163
|
+
"findings": [{ "path": "src/a.ts", "line": 3, "message": "what is wrong" }]
|
|
164
|
+
}
|
|
165
|
+
```
|
|
116
166
|
|
|
117
|
-
|
|
118
|
-
|
|
167
|
+
`decision` is `allow` or `deny`; `reason` and `findings` are optional, and
|
|
168
|
+
`protocol`, when echoed, must be `pmcp.guard.v1`. Each finding needs `message`
|
|
169
|
+
and may give `path` and `line` (a whole number from 1). Up to 20 findings are
|
|
170
|
+
added to a refusal's reason, one `path:line: message` line each, and findings
|
|
171
|
+
with `allow` reach the session as a note; either way the guard log records how
|
|
172
|
+
many there were. Any other reply, a nonzero exit, or running past `timeout_ms`
|
|
173
|
+
is a failed guard, which refuses. A guard written for the earlier contract, which
|
|
174
|
+
had no `protocol`, `session`, `prompt` or `findings`, keeps working unchanged.
|
|
175
|
+
|
|
176
|
+
`mode` means what it does for a built-in guard: the script runs and its refusal
|
|
177
|
+
is a deny, an ask, a note in the session's context (`warn`), or only a log line
|
|
178
|
+
(`observe`); `off` does not run it. The guard log records the script's own
|
|
179
|
+
verdict as `raw` in every mode. Only the hook bundle applies a mode: a runtime
|
|
180
|
+
the shell adapter serves (Codex, Gemini or Antigravity outside `[hooks]
|
|
181
|
+
targets`) can only refuse, so a mode other than `deny` there is a configuration
|
|
182
|
+
error naming the guard, the mode and the runtime. The same holds for `on` other
|
|
183
|
+
than `before_shell` or `after_edit` and for an installed program with `version`:
|
|
184
|
+
the shell adapter runs neither, and keeps the earlier contract below.
|
|
185
|
+
|
|
186
|
+
A command that needs to end a session's turn with a check of its own (tests, a
|
|
187
|
+
linter, a generated-file check) is a custom guard with `on = "stop"` and
|
|
188
|
+
`mode = "warn"`.
|
|
189
|
+
|
|
190
|
+
## `[hooks.report]`
|
|
191
|
+
|
|
192
|
+
Read by [`pmcp hooks report`](commands.md#hooks) alone; it changes nothing in the
|
|
193
|
+
hooks.
|
|
194
|
+
|
|
195
|
+
| Key | Type | Default | Meaning |
|
|
196
|
+
| ------------------ | ---- | ------- | --------------------------------------------------------------------------------- |
|
|
197
|
+
| `exclude_sessions` | list | `[]` | Regexes; guard log lines of a session id matching one are left out of the report. |
|
|
198
|
+
|
|
199
|
+
## `[hooks.test]`
|
|
200
|
+
|
|
201
|
+
| Key | Type | Default | Meaning |
|
|
202
|
+
| ---------- | ---- | ------- | --------------------------------------------------------------------------------------------- |
|
|
203
|
+
| `fixtures` | path | none | The cases `pmcp project --check --smoke` runs; relative to the directory holding `pmcp.toml`. |
|
|
204
|
+
|
|
205
|
+
A fixtures file is JSON: `{cases, failure?}`. Each case is
|
|
206
|
+
`{name, guard, command, cwd?, expect}`, where `guard` is the guard the case is
|
|
207
|
+
about (`shell.heredoc`, `custom.<name>`), `cwd = "linked-worktree"` runs it from a
|
|
208
|
+
scratch repository with a branch checked out in a linked worktree, and `expect`
|
|
209
|
+
is `allow`, `deny` or `ask` for every runtime, or a table of runtime to one of
|
|
210
|
+
them (a runtime left out does not run the case). `failure`, when present, must
|
|
211
|
+
equal the projected `[hooks.failure]` (`{timeoutMs, retry, pass}`).
|
|
212
|
+
|
|
213
|
+
`pmcp hooks test --fixtures <file>` and `pmcp project --check --smoke` run each
|
|
214
|
+
case through the projected `.agents/pmcp-hooks/hook.mjs`, once per `[hooks]
|
|
215
|
+
targets` runtime that answers a shell call, with that runtime's own payload. The
|
|
216
|
+
command is classified by the guards, never run; state goes to a throwaway
|
|
217
|
+
`XDG_STATE_HOME`, and `GIT_*` variables are removed, so a run from inside a git
|
|
218
|
+
hook does not look at the repository being committed. Findings:
|
|
219
|
+
|
|
220
|
+
- a decision that differs from `expect`, or a hook that fails or times out;
|
|
221
|
+
- coverage: every guard that can refuse (`deny`, `ask` or `graded`, including
|
|
222
|
+
custom guards on `before_shell`) needs, per runtime, one case it refuses and
|
|
223
|
+
one it lets through;
|
|
224
|
+
- `[hooks.failure]` differing from the fixtures' `failure`;
|
|
225
|
+
- a target whose native hook entry is missing, and a run in which no case ran.
|
|
226
|
+
|
|
227
|
+
`hooks test --fixtures` exits 0 with no finding and 1 otherwise; `project --check
|
|
228
|
+
--smoke` exits 2 on a finding, as for drift.
|
|
119
229
|
|
|
120
230
|
## `[hooks.failure]`
|
|
121
231
|
|
|
@@ -166,6 +276,24 @@ as `projector.json`), and only at the version `pmcp.lock` records. A pmcp on
|
|
|
166
276
|
`PATH` is never used. When none matches, the session hears
|
|
167
277
|
`projecting pmcp not available` once instead of a drift report.
|
|
168
278
|
|
|
279
|
+
## Native hook entries pmcp does not own
|
|
280
|
+
|
|
281
|
+
Hook entries a project or a tool wrote itself run beside pmcp's, and a broken one
|
|
282
|
+
fails every call it matches. `pmcp project --check` (exit 2) and `pmcp doctor`
|
|
283
|
+
check each such entry in `.claude/settings.json`, `.claude/settings.local.json`,
|
|
284
|
+
`.codex/hooks.json`, and the `hooks/hooks.json` (or the manifest's `hooks` path)
|
|
285
|
+
of each plugin whose `.claude-plugin/plugin.json` is tracked by git. Entries that
|
|
286
|
+
run `.agents/pmcp-hooks/` are pmcp's and are not checked here.
|
|
287
|
+
|
|
288
|
+
The command's first simple command is read, never run. A leading `NAME=value`
|
|
289
|
+
is skipped; `$CLAUDE_PROJECT_DIR` is the project root, `${CLAUDE_PLUGIN_ROOT}` the
|
|
290
|
+
plugin's directory (an error outside a plugin), and `~` and `$HOME` the home
|
|
291
|
+
directory. A program run directly must be an existing file that is executable
|
|
292
|
+
and starts with `#!`; a script given to an interpreter (`node`, `bun`, `deno`,
|
|
293
|
+
`tsx`, `python`, `python3`, `bash`, `sh`, `zsh`, `dash`, `ruby`, `perl`) must
|
|
294
|
+
exist. A bare program name found on `PATH`, inline code (`node -e`) and a path
|
|
295
|
+
built from another variable are not checked.
|
|
296
|
+
|
|
169
297
|
## Runtime support
|
|
170
298
|
|
|
171
299
|
From the measured capability files in `docs/hooks/capabilities/` (Claude Code
|
|
@@ -58,7 +58,8 @@ ignored.
|
|
|
58
58
|
| `[marketplaces.<name>]` | [Marketplaces](#marketplaces) |
|
|
59
59
|
| `[targets]`, `[skills.<name>]`, `[agents.<name>.<tool>]`, `[rules.packages]` | [Native files for each agent tool](#native-files-for-each-agent-tool) |
|
|
60
60
|
| `[mcp.<alias>]` | [Unified project MCP configuration](#unified-project-mcp-configuration) |
|
|
61
|
-
| `[hooks]`, `[hooks.guards.*]`, `[[hooks.guards.custom]]`, `[hooks.checks.*]`
|
|
61
|
+
| `[hooks]`, `[hooks.guards.*]`, `[[hooks.guards.custom]]`, `[hooks.checks.*]`, `[hooks.failure]`, `[hooks.report]`, `[hooks.test]` | [Hooks](hooks.md) |
|
|
62
|
+
| `[budget]` | [Budget](#budget) |
|
|
62
63
|
| `[[hooks.shell]]`, `[[hooks.edit]]` | [Deprecated shell guards](hooks.md#deprecated-shell-guards) |
|
|
63
64
|
| `[sessions]`, `[sessions.registry]`, `[sessions.pause]`, `[sessions.broadcast]`, `[sessions.mailbox]`, `[sessions.leases.<name>]`, `[sessions.roles.<name>]` | [Sessions](#sessions) |
|
|
64
65
|
| `[git]`, `[git.shared_checkout]`, `[git.worktrees]`, `[git.worktrees.sync]`, `[git.mainline]`, `[git.mainline.gate]`, `[git.mainline.deliver]`, `[git.mainline.sync]`, `[git.submodules]` | [Git workflow](git-workflow.md) |
|
|
@@ -143,6 +144,10 @@ pmcp doctor # ask each installed tool what it loads
|
|
|
143
144
|
|
|
144
145
|
Rules go to `.claude/rules/<dir>/`, never the top level, because Grok Build
|
|
145
146
|
loads top-level `.claude/rules/*.md` in every session regardless of `paths:`.
|
|
147
|
+
Grok Build reads `.agents/skills` itself in a trusted folder, so pmcp writes no
|
|
148
|
+
skill links for it; a skill placed by hand under `.grok/skills` would shadow the
|
|
149
|
+
`.agents/skills` one of the same name, and `pmcp project --check` reports it as
|
|
150
|
+
undeclared.
|
|
146
151
|
A server that names `${PROJECT_ROOT}` is launched through `sh`, which finds
|
|
147
152
|
`pmcp.toml` at spawn time, so the generated files hold no machine's path.
|
|
148
153
|
`pmcp.lock` records what was written; a file pmcp did not write is never
|
|
@@ -579,6 +584,31 @@ messages too.
|
|
|
579
584
|
|
|
580
585
|
Worktrees, delivery to the mainline and main checkout sync: [Git workflow](git-workflow.md).
|
|
581
586
|
|
|
587
|
+
## Budget
|
|
588
|
+
|
|
589
|
+
`[budget]` sets limits on what every agent session loads and on paths the
|
|
590
|
+
project keeps out of its tree. `pmcp project --check` exits 2 when one is
|
|
591
|
+
exceeded, naming each, and `pmcp status` shows the measurements beside the
|
|
592
|
+
limits (its JSON gains `budget: {rows, problems}`, and an exceeded limit counts
|
|
593
|
+
as drift). Every key is optional; nothing is checked without the table.
|
|
594
|
+
|
|
595
|
+
| Key | Type | Meaning |
|
|
596
|
+
| --------------- | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
597
|
+
| `root_bytes` | integer | Largest size of each of `AGENTS.md`, `CLAUDE.md` and `GEMINI.md` at the root that is a file (a symbolic link to another is not measured twice). |
|
|
598
|
+
| `root_lines` | integer | Largest line count of the same files. |
|
|
599
|
+
| `package_bytes` | integer | Largest size of each tracked `AGENTS.md` below the root, and of each `[rules.packages] file`. |
|
|
600
|
+
| `skills_max` | integer | Most skills under `.agents/skills` (each a folder with a `SKILL.md`), the skills every runtime is offered. |
|
|
601
|
+
| `forbid_paths` | glob list | Tracked paths that must not exist: `*` within a segment, `**` across segments, `?` one character; a glob naming a directory covers everything below it (`docs/adr`). |
|
|
602
|
+
|
|
603
|
+
```toml
|
|
604
|
+
[budget]
|
|
605
|
+
root_bytes = 16000
|
|
606
|
+
root_lines = 300
|
|
607
|
+
package_bytes = 8000
|
|
608
|
+
skills_max = 40
|
|
609
|
+
forbid_paths = [".spec/**", "docs/adr"]
|
|
610
|
+
```
|
|
611
|
+
|
|
582
612
|
## Logging
|
|
583
613
|
|
|
584
614
|
| `[logging]` key | Type | Default | Allowed |
|
package/docs/upgrading.md
CHANGED
|
@@ -5,6 +5,64 @@
|
|
|
5
5
|
What to do when a release changes something you rely on. Each release's notes on GitHub
|
|
6
6
|
Releases list its breaking changes and link here.
|
|
7
7
|
|
|
8
|
+
## From 0.21 to 0.22
|
|
9
|
+
|
|
10
|
+
**pmcp writes no `.grok/skills` links.** Grok Build reads `.agents/skills` itself (measured on
|
|
11
|
+
1.0.62, in a folder it trusts), so the links were duplicates. The next `pmcp project` removes the
|
|
12
|
+
ones it wrote. A Grok older than 1.0.62 was not measured; check that `grok inspect --json`
|
|
13
|
+
lists your project's skills after upgrading, and keep 0.21 for that project if it does not.
|
|
14
|
+
|
|
15
|
+
**`pmcp git sync` now works in a desk.** In 0.21 it exited 2 in any linked worktree. A
|
|
16
|
+
linked worktree matching `[git.worktrees] desks` (by default every worktree under
|
|
17
|
+
`[git.worktrees] root`) is now brought up to date with the mainline when that loses
|
|
18
|
+
nothing, and held with exit 1 otherwise; any other linked worktree still exits 2. A script
|
|
19
|
+
that relied on exit 2 to skip desks should check the kind first, or set `desks` to a
|
|
20
|
+
pattern that matches none. `[git.worktrees.sync] after_deliver = "desk"` syncs the
|
|
21
|
+
delivering desk after a delivery, and the `--json` receipt gains `desk_sync`. See
|
|
22
|
+
[Git workflow](git-workflow.md).
|
|
23
|
+
|
|
24
|
+
## From 0.20 to 0.21
|
|
25
|
+
|
|
26
|
+
**Session records are written to `sessions/` alone.** 0.20 also wrote each record to the
|
|
27
|
+
deprecated `fleet/` in the state directory; 0.21 stops. A tool that still reads `fleet/`
|
|
28
|
+
must read `sessions/<session>.json` instead. pmcp still reads `fleet/`, and of two copies
|
|
29
|
+
uses the one updated last, so a hook bundle from before 0.20 sharing the state directory
|
|
30
|
+
keeps being followed until `pmcp project` runs there again.
|
|
31
|
+
|
|
32
|
+
**`pmcp project --check` also fails on a broken hook entry pmcp does not own.** A command
|
|
33
|
+
in `.claude/settings*.json`, `.codex/hooks.json` or a tracked plugin's `hooks.json` that
|
|
34
|
+
names a missing script, or a script run directly that is not executable or has no `#!`
|
|
35
|
+
line, now makes `--check` exit 2 and `pmcp doctor` report a failure. Fix the entry, or the
|
|
36
|
+
script; [Hooks](hooks.md#native-hook-entries-pmcp-does-not-own) lists what is checked.
|
|
37
|
+
|
|
38
|
+
The rest is new, not removed:
|
|
39
|
+
|
|
40
|
+
- A commit that only moves submodule pins, each to a commit the mainline's pin already
|
|
41
|
+
equals or contains, now counts as delivered. `pmcp git deliver` skips it, and
|
|
42
|
+
`pmcp git sync` and worktree sync move past it instead of refusing.
|
|
43
|
+
- `[git.mainline.sync] after_deliver = "always"` also syncs the main checkout after a
|
|
44
|
+
delivery run in a linked worktree; `"off"` turns the sync after a delivery off. The
|
|
45
|
+
default `"from_main"` is 0.20's behaviour.
|
|
46
|
+
- With `gate = "pre-push"` the push output streams to the terminal as it comes; the gate
|
|
47
|
+
log still keeps all of it.
|
|
48
|
+
- The `pmcp git deliver --json` receipt gains `sync`, the main checkout's sync after the
|
|
49
|
+
delivery, and `replayed`, the tip of the last replay.
|
|
50
|
+
- `pmcp git deliver --no-push` replays and gates, then stops. See
|
|
51
|
+
[Git workflow](git-workflow.md).
|
|
52
|
+
- `[[hooks.guards.custom]]` takes `mode` like a built-in guard (the default `deny` is
|
|
53
|
+
0.20's behaviour), `on = "prompt"`, `"stop"` or `"session_start"`, and an installed
|
|
54
|
+
program pinned by `version` instead of a script. Its request gains `protocol`
|
|
55
|
+
(`pmcp.guard.v1`), `session` and, on `prompt`, `prompt`; its reply may add `findings`.
|
|
56
|
+
A guard that reads only the earlier fields keeps working. See
|
|
57
|
+
[Hooks](hooks.md#hooksguardscustom).
|
|
58
|
+
- `pmcp hooks report` summarises the guard log; `[hooks.report] exclude_sessions` leaves
|
|
59
|
+
sessions out.
|
|
60
|
+
- `pmcp hooks test --fixtures <file>`, and `pmcp project --check --smoke` with
|
|
61
|
+
`[hooks.test] fixtures`, run cases through the projected hooks.
|
|
62
|
+
- `[budget]` limits the root and package instruction files, the skills and the tracked
|
|
63
|
+
paths; `pmcp project --check` enforces it and `pmcp status` shows it. See
|
|
64
|
+
[Budget](project-configuration.md#budget).
|
|
65
|
+
|
|
8
66
|
## From 0.19 to 0.20
|
|
9
67
|
|
|
10
68
|
0.20 removes defaults that suited one kind of project rather than pmcp's users in general.
|
package/gemini-extension.json
CHANGED
|
@@ -1,11 +1,11 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "pmcp",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.22.0",
|
|
4
4
|
"mcpServers": {
|
|
5
5
|
"pmcp": {
|
|
6
6
|
"type": "stdio",
|
|
7
7
|
"command": "npx",
|
|
8
|
-
"args": ["-y", "@modootoday/pmcp@0.
|
|
8
|
+
"args": ["-y", "@modootoday/pmcp@0.22.0", "serve"]
|
|
9
9
|
}
|
|
10
10
|
}
|
|
11
11
|
}
|
package/mcp.json
CHANGED
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@modootoday/pmcp",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.22.0",
|
|
4
4
|
"license": "Elastic-2.0",
|
|
5
5
|
"author": "modootoday",
|
|
6
6
|
"description": "Use the skills your packages already ship, and keep your AI tools' project configuration in one place.",
|
|
@@ -136,9 +136,9 @@
|
|
|
136
136
|
"bun": ">=1.3.0"
|
|
137
137
|
},
|
|
138
138
|
"optionalDependencies": {
|
|
139
|
-
"@modootoday/pmcp-linux-x64": "0.
|
|
140
|
-
"@modootoday/pmcp-linux-arm64": "0.
|
|
141
|
-
"@modootoday/pmcp-darwin-x64": "0.
|
|
142
|
-
"@modootoday/pmcp-darwin-arm64": "0.
|
|
139
|
+
"@modootoday/pmcp-linux-x64": "0.22.0",
|
|
140
|
+
"@modootoday/pmcp-linux-arm64": "0.22.0",
|
|
141
|
+
"@modootoday/pmcp-darwin-x64": "0.22.0",
|
|
142
|
+
"@modootoday/pmcp-darwin-arm64": "0.22.0"
|
|
143
143
|
}
|
|
144
144
|
}
|
package/plugin.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
|
|
3
3
|
"name": "pmcp",
|
|
4
|
-
"version": "0.
|
|
4
|
+
"version": "0.22.0",
|
|
5
5
|
"description": "Find package skills and use native runtime project configuration.",
|
|
6
6
|
"author": { "name": "modootoday" },
|
|
7
7
|
"license": "Elastic-2.0",
|
package/plugins/pmcp/.mcp.json
CHANGED
|
@@ -1,11 +1,11 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "pmcp",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.22.0",
|
|
4
4
|
"mcpServers": {
|
|
5
5
|
"pmcp": {
|
|
6
6
|
"type": "stdio",
|
|
7
7
|
"command": "npx",
|
|
8
|
-
"args": ["-y", "@modootoday/pmcp@0.
|
|
8
|
+
"args": ["-y", "@modootoday/pmcp@0.22.0", "serve"]
|
|
9
9
|
}
|
|
10
10
|
}
|
|
11
11
|
}
|
package/plugins/pmcp/mcp.json
CHANGED
|
@@ -4,8 +4,8 @@ import type { Broadcast, Lease, Pause, SessionRecord } from "./types";
|
|
|
4
4
|
|
|
5
5
|
export const STATE_FILES = {
|
|
6
6
|
records: "sessions",
|
|
7
|
-
// The records' former directory. Deprecated:
|
|
8
|
-
//
|
|
7
|
+
// The records' former directory. Deprecated: read beside sessions/ but no longer written; a
|
|
8
|
+
// pmcp before 0.20 sharing the state directory still writes there.
|
|
9
9
|
legacyRecords: "fleet",
|
|
10
10
|
pause: "pause.json",
|
|
11
11
|
broadcast: "broadcast.json",
|
package/plugins/pmcp/plugin.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
|
|
3
3
|
"name": "pmcp",
|
|
4
|
-
"version": "0.
|
|
4
|
+
"version": "0.22.0",
|
|
5
5
|
"description": "Find package skills and use native runtime project configuration.",
|
|
6
6
|
"author": { "name": "modootoday" },
|
|
7
7
|
"license": "Elastic-2.0",
|