@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.
Files changed (124) hide show
  1. package/.agents/plugins/marketplace.json +1 -1
  2. package/.claude-plugin/marketplace.json +1 -1
  3. package/.claude-plugin/plugin.json +1 -1
  4. package/.mcp.json +1 -1
  5. package/dist/{apply-QJ6MGLBX.js → apply-3PR4UOES.js} +58 -24
  6. package/dist/{available-HYSDAFYH.js → available-BFXLII4A.js} +7 -7
  7. package/dist/{broadcast-LYOA6BEW.js → broadcast-ZALGUJVR.js} +4 -4
  8. package/dist/chunk-2GI5RM3M.js +53 -0
  9. package/dist/chunk-2QJGUR23.js +274 -0
  10. package/dist/{chunk-FD6VGFYZ.js → chunk-3LADLKAI.js} +207 -15
  11. package/dist/{chunk-MZEMLFFD.js → chunk-3OBJVG5R.js} +2 -2
  12. package/dist/{chunk-IQD4W53M.js → chunk-57Q75MS4.js} +18 -18
  13. package/dist/chunk-5YCKFU5Q.js +1672 -0
  14. package/dist/{chunk-IZABPDAO.js → chunk-5ZUDBC3P.js} +2 -2
  15. package/dist/{chunk-EKPMVEIA.js → chunk-73IDLWRI.js} +7 -4
  16. package/dist/{chunk-QYH2NR6G.js → chunk-7FV2LORT.js} +2 -2
  17. package/dist/{chunk-4VK5G3SV.js → chunk-E6YP2PMO.js} +3 -5
  18. package/dist/{chunk-RMHZFWHF.js → chunk-EPNTYTDZ.js} +33 -33
  19. package/dist/{chunk-5JPD6VIH.js → chunk-GBKRDRMZ.js} +22 -7
  20. package/dist/{chunk-T6GOWHK6.js → chunk-GFOQDLPL.js} +6 -1
  21. package/dist/{chunk-RBNMNKNN.js → chunk-JQVSDPFL.js} +3 -3
  22. package/dist/{chunk-OG7QR2DP.js → chunk-KEHB4FZP.js} +17 -2
  23. package/dist/chunk-KUBHGVTD.js +126 -0
  24. package/dist/chunk-L42U5XKC.js +7 -0
  25. package/dist/chunk-LFFIQBNY.js +115 -0
  26. package/dist/{chunk-O2JWF7ZM.js → chunk-LVNGMGOM.js} +2 -2
  27. package/dist/{chunk-PQTM27GU.js → chunk-MR5IBS6L.js} +6 -7
  28. package/dist/{chunk-OAIQ7A3R.js → chunk-NDED2O5B.js} +5 -5
  29. package/dist/{chunk-M2RYXWX2.js → chunk-NHUMPEPV.js} +2 -2
  30. package/dist/{chunk-ONP6JRFZ.js → chunk-OFJIMBTL.js} +2 -2
  31. package/dist/{chunk-YN5GQCHN.js → chunk-RHJEGLYM.js} +6 -1
  32. package/dist/{chunk-JBHGJKSL.js → chunk-RNC7PGW2.js} +2 -2
  33. package/dist/{chunk-J6HNP6HA.js → chunk-RNE4WPBS.js} +2 -2
  34. package/dist/{chunk-YDICIB2A.js → chunk-S4Y44CCC.js} +2 -2
  35. package/dist/{chunk-K2C3KFGB.js → chunk-SEM6WD7J.js} +29 -17
  36. package/dist/{chunk-CQZYQAAV.js → chunk-SLCNCAWY.js} +3 -3
  37. package/dist/{chunk-L4MFGGSI.js → chunk-SPZ42EWE.js} +2 -2
  38. package/dist/{chunk-QOFSPFJ6.js → chunk-TCW2H47H.js} +3405 -3395
  39. package/dist/{chunk-FQAJSNNU.js → chunk-TPGJXENR.js} +3 -3
  40. package/dist/chunk-UKR64U7J.js +20 -0
  41. package/dist/{chunk-66F3HLW4.js → chunk-XB363ZXT.js} +122 -4
  42. package/dist/{chunk-UD3BEEBQ.js → chunk-XZ2TDH3J.js} +80 -3
  43. package/dist/{chunk-QSIADSMQ.js → chunk-Z6WRFOFT.js} +3 -3
  44. package/dist/{claude-GT2BPXEL.js → claude-XVLF4N4S.js} +3 -3
  45. package/dist/{cli-IV5DJCXU.js → cli-6FWRBCWM.js} +8 -8
  46. package/dist/{cli-6HTAJ54L.js → cli-BEEDAD4E.js} +7 -7
  47. package/dist/cli.js +11 -11
  48. package/dist/{completion-PPM7MEI2.js → completion-LHYNCQ3N.js} +7 -7
  49. package/dist/{diagnostics-EWU2ROTG.js → diagnostics-ABTJUYZQ.js} +5 -6
  50. package/dist/{doctor-ZWZQMDKZ.js → doctor-GPPO5L4F.js} +36 -36
  51. package/dist/{entry-NDICBQ2F.js → entry-ARGY5CKA.js} +14 -15
  52. package/dist/{exec-mcp-AG4G7SG7.js → exec-mcp-JEF74XVP.js} +16 -14
  53. package/dist/{harness-JABSZCAA.js → harness-OCXW6YE4.js} +6 -6
  54. package/dist/harness-launch-gate.js +3 -4
  55. package/dist/harness-worker.js +5 -6
  56. package/dist/hook-body.js +247 -86
  57. package/dist/{hook-spec-C7umArqw.d.ts → hook-spec-hZL4MSgi.d.ts} +8 -3
  58. package/dist/hooks-JHXUN5MD.js +24 -0
  59. package/dist/{host-2SZRMHZX.js → host-OBRHBDRE.js} +6 -7
  60. package/dist/{host-BWZ5LA4Q.js → host-VI4ZFCZP.js} +18 -16
  61. package/dist/{host-run-SXLV4LHI.js → host-run-H7AITG7C.js} +5 -7
  62. package/dist/http.js +1 -1
  63. package/dist/{import-mcp-2M7SZRVQ.js → import-mcp-3Y33CUHF.js} +15 -12
  64. package/dist/index.d.ts +11 -2
  65. package/dist/index.js +25 -25
  66. package/dist/{init-HOOIFBAD.js → init-WZJHMWNJ.js} +3 -3
  67. package/dist/{install-HF6CROQP.js → install-7V6NIA7W.js} +4 -4
  68. package/dist/{invoke-JP4MILYY.js → invoke-GWWTXQLO.js} +7 -8
  69. package/dist/{list-UBSBUZKS.js → list-Y6UPLGNF.js} +21 -18
  70. package/dist/{logout-OO3DERRK.js → logout-KAUW4JZZ.js} +16 -13
  71. package/dist/{logs-K3QXKRD4.js → logs-74JGLQG6.js} +4 -4
  72. package/dist/{mailbox-DAJV6VAI.js → mailbox-VK5AVTHI.js} +7 -7
  73. package/dist/{mainline-6K5BA3WX.js → mainline-Q42M2GJ2.js} +173 -34
  74. package/dist/{mcp-JXNTKRJG.js → mcp-IDEUIY2F.js} +2 -2
  75. package/dist/{pause-GRVTSKOK.js → pause-CZ2OZYLC.js} +4 -4
  76. package/dist/project/hook-adapter.d.ts +1 -1
  77. package/dist/{project-M672MKQH.js → project-GVVWLDOJ.js} +5 -5
  78. package/dist/{pty-LHKJKY2E.js → pty-CDLQ4NP2.js} +3 -3
  79. package/dist/report-Z3JV2PCT.js +105 -0
  80. package/dist/{resume-6DMPGG3N.js → resume-DFIHT2RO.js} +4 -4
  81. package/dist/{run-ORBIERI3.js → run-HVNKQHVU.js} +4 -4
  82. package/dist/{run-5W566T3V.js → run-RRWB7U2Q.js} +15 -12
  83. package/dist/{serve-73SRPAV4.js → serve-KJSOU3BR.js} +3 -3
  84. package/dist/{session-XM2CR425.js → session-YZVX4NGN.js} +4 -4
  85. package/dist/{setup-ULKDPF5B.js → setup-3GET6K3J.js} +4 -4
  86. package/dist/smoke-FQQJOQBD.js +16 -0
  87. package/dist/{start-login-BGFAMCZL.js → start-login-RNHSEX5P.js} +16 -13
  88. package/dist/{status-YHXEAJ7U.js → status-3RTGDN2K.js} +10 -10
  89. package/dist/{status-YCW6YJ3S.js → status-RR4VZARJ.js} +40 -23
  90. package/dist/{status-73FEFQUQ.js → status-Y25ONHA5.js} +16 -13
  91. package/dist/stdio.js +2 -2
  92. package/dist/{sweep-XF2HG3EO.js → sweep-EPJMEZR6.js} +4 -4
  93. package/dist/{test-IMNBXOYW.js → test-7NYPQ6YU.js} +30 -20
  94. package/dist/{tui-5GDA22TB.js → tui-H5RPSF4B.js} +4 -4
  95. package/dist/{unbroadcast-XP3OCVN3.js → unbroadcast-NTOC3PY3.js} +4 -4
  96. package/dist/{worker-RV6NGSXT.js → worker-YWFTWIBP.js} +9 -10
  97. package/dist/{worktree-list-4PLE7K6L.js → worktree-list-EMKUMCTQ.js} +2 -2
  98. package/dist/{worktree-sync-GQVYAXGJ.js → worktree-sync-A277AF4M.js} +4 -6
  99. package/docs/commands.md +14 -7
  100. package/docs/git-workflow.md +53 -13
  101. package/docs/hooks.md +138 -10
  102. package/docs/project-configuration.md +31 -1
  103. package/docs/upgrading.md +58 -0
  104. package/gemini-extension.json +2 -2
  105. package/mcp.json +1 -1
  106. package/package.json +5 -5
  107. package/plugin.json +1 -1
  108. package/plugins/pmcp/.claude-plugin/plugin.json +1 -1
  109. package/plugins/pmcp/.mcp.json +1 -1
  110. package/plugins/pmcp/gemini-extension.json +2 -2
  111. package/plugins/pmcp/mcp.json +1 -1
  112. package/plugins/pmcp/mod/sessions/format.ts +2 -2
  113. package/plugins/pmcp/plugin.json +1 -1
  114. package/plugins/pmcp/skills/agent-assets-migrate/SKILL.md +11 -8
  115. package/plugins/pmcp/skills/pmcp-project-init/SKILL.md +11 -7
  116. package/skills/agent-assets-migrate/SKILL.md +11 -8
  117. package/skills/pmcp-project-init/SKILL.md +11 -7
  118. package/dist/chunk-7SDOSTW7.js +0 -130
  119. package/dist/chunk-AWZF72SH.js +0 -1025
  120. package/dist/chunk-FGYFA6JY.js +0 -7
  121. package/dist/chunk-ICF2JZSN.js +0 -92
  122. package/dist/chunk-ISNRDHSD.js +0 -74
  123. package/dist/chunk-QDY6BWE6.js +0 -396
  124. 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, and logged errors from the last hour. 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. Missing or invalid input follows the normal usage/failure exit contract. Human output is a compact summary on stderr; JSON retains the full details.
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, 1 refused, gate failed or attempts exhausted, 2 fetch failed.
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
 
@@ -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"`) and `notice_paths` (paths whose change is announced to the
39
- session). Installs never block a session. A worktree is not moved while the
40
- workspace is paused or while any lease is held (every `[sessions.leases.<name>]`,
41
- or the implicit `lockfile` lease), and the session is told which.
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 is the gate log, and a refused push is a
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, gate, leases,
102
- reason?}`, where `delivered` is the upstream commit it pushed (or `null`), `gate`
103
- is `{exit, log, by}` for the last gate run (or `null`; `by` is `"command"` or
104
- `"pre-push"`), `leases` the leases it took
105
- and `reason` the last refusal or failure. Exit codes: `0` delivered or nothing
106
- to deliver; `1` refused, a lease or the gate lock held too long, a replay
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 script under `.agents/guards/` that decides like a built-in guard.
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
- | Key | Type | Default | Meaning |
110
- | ------------ | --------- | ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
111
- | `name` | string | required | `^[a-z0-9][a-z0-9-]*$`, unique across custom, shell and edit entries. |
112
- | `command` | argv list | required | The first or second element is the script, which must exist inside `.agents/guards/`; its sha256 is pinned in `policy.json`. |
113
- | `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. |
114
- | `timeout_ms` | integer | `15000` | 100 to 60000. |
115
- | `on` | string | `"before_shell"` | `before_shell` or `after_edit`. |
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
- The script receives the JSON contract described under
118
- [Deprecated shell guards](#deprecated-shell-guards). Custom guards have no `mode`.
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.*]` | [Hooks](hooks.md) |
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.
@@ -1,11 +1,11 @@
1
1
  {
2
2
  "name": "pmcp",
3
- "version": "0.20.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.20.0", "serve"]
8
+ "args": ["-y", "@modootoday/pmcp@0.22.0", "serve"]
9
9
  }
10
10
  }
11
11
  }
package/mcp.json CHANGED
@@ -4,7 +4,7 @@
4
4
  "pmcp": {
5
5
  "type": "stdio",
6
6
  "command": "npx",
7
- "args": ["-y", "@modootoday/pmcp@0.20.0", "serve"]
7
+ "args": ["-y", "@modootoday/pmcp@0.22.0", "serve"]
8
8
  }
9
9
  }
10
10
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@modootoday/pmcp",
3
- "version": "0.20.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.20.0",
140
- "@modootoday/pmcp-linux-arm64": "0.20.0",
141
- "@modootoday/pmcp-darwin-x64": "0.20.0",
142
- "@modootoday/pmcp-darwin-arm64": "0.20.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.20.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",
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "pmcp",
3
- "version": "0.20.0",
3
+ "version": "0.22.0",
4
4
  "description": "Find package skills and use native runtime project configuration.",
5
5
  "author": { "name": "modootoday" },
6
6
  "license": "Elastic-2.0",
@@ -3,7 +3,7 @@
3
3
  "pmcp": {
4
4
  "type": "stdio",
5
5
  "command": "npx",
6
- "args": ["-y", "@modootoday/pmcp@0.20.0", "serve"]
6
+ "args": ["-y", "@modootoday/pmcp@0.22.0", "serve"]
7
7
  }
8
8
  }
9
9
  }
@@ -1,11 +1,11 @@
1
1
  {
2
2
  "name": "pmcp",
3
- "version": "0.20.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.20.0", "serve"]
8
+ "args": ["-y", "@modootoday/pmcp@0.22.0", "serve"]
9
9
  }
10
10
  }
11
11
  }
@@ -4,7 +4,7 @@
4
4
  "pmcp": {
5
5
  "type": "stdio",
6
6
  "command": "npx",
7
- "args": ["-y", "@modootoday/pmcp@0.20.0", "serve"]
7
+ "args": ["-y", "@modootoday/pmcp@0.22.0", "serve"]
8
8
  }
9
9
  }
10
10
  }
@@ -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: 0.20 still writes every record there too and
8
- // reads it when sessions/ lacks one; 0.21 stops writing it.
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",
@@ -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.20.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",