@modootoday/pmcp 0.22.0 → 0.22.2

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 (81) 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-3PR4UOES.js → apply-AWZ32Z66.js} +14 -13
  6. package/dist/{chunk-TCW2H47H.js → chunk-4Z6NPSWX.js} +49 -16
  7. package/dist/{chunk-3LADLKAI.js → chunk-5A7QRZP6.js} +9 -9
  8. package/dist/{chunk-SEM6WD7J.js → chunk-5F7TL3V7.js} +23 -6
  9. package/dist/{chunk-E6YP2PMO.js → chunk-BUD3WS4Y.js} +2 -2
  10. package/dist/{chunk-S4Y44CCC.js → chunk-D2DDM5VZ.js} +2 -2
  11. package/dist/{chunk-RNC7PGW2.js → chunk-FOIQUPIQ.js} +2 -2
  12. package/dist/chunk-FWKQA6TX.js +7 -0
  13. package/dist/{chunk-LVNGMGOM.js → chunk-G25LCRIG.js} +2 -2
  14. package/dist/{chunk-SLCNCAWY.js → chunk-GE2PHR35.js} +3 -3
  15. package/dist/{chunk-73IDLWRI.js → chunk-GZQH3RJA.js} +3 -3
  16. package/dist/{chunk-5ZUDBC3P.js → chunk-JP27V2H4.js} +2 -2
  17. package/dist/{chunk-2QJGUR23.js → chunk-KLWZZTUQ.js} +7 -7
  18. package/dist/{chunk-XB363ZXT.js → chunk-NAXUAC5S.js} +27 -7
  19. package/dist/{chunk-GBKRDRMZ.js → chunk-NFJ44OE2.js} +5 -2
  20. package/dist/{chunk-5YCKFU5Q.js → chunk-OMIIXLMO.js} +1 -1
  21. package/dist/{chunk-NDED2O5B.js → chunk-SKOP4ZST.js} +5 -5
  22. package/dist/{chunk-SPZ42EWE.js → chunk-T6MQPVLH.js} +2 -2
  23. package/dist/{chunk-RNE4WPBS.js → chunk-U2NWTZQP.js} +2 -2
  24. package/dist/{chunk-TPGJXENR.js → chunk-U3IHGG7X.js} +3 -3
  25. package/dist/{chunk-EPNTYTDZ.js → chunk-VGW3N3HC.js} +12 -12
  26. package/dist/{chunk-2GI5RM3M.js → chunk-W6GA5RAW.js} +2 -2
  27. package/dist/chunk-XWLMZKH2.js +12 -0
  28. package/dist/{chunk-3OBJVG5R.js → chunk-ZYLJUABY.js} +2 -2
  29. package/dist/{cli-BEEDAD4E.js → cli-BOSY6VFP.js} +4 -4
  30. package/dist/cli.js +3 -3
  31. package/dist/{completion-LHYNCQ3N.js → completion-V756JVX6.js} +2 -2
  32. package/dist/{diagnostics-ABTJUYZQ.js → diagnostics-R7S3DNXD.js} +7 -5
  33. package/dist/{doctor-GPPO5L4F.js → doctor-44S5EWK5.js} +20 -13
  34. package/dist/{entry-ARGY5CKA.js → entry-GSGCMXE5.js} +11 -9
  35. package/dist/{exec-mcp-JEF74XVP.js → exec-mcp-3COXHDYT.js} +11 -10
  36. package/dist/{harness-OCXW6YE4.js → harness-K4WL2NSH.js} +3 -3
  37. package/dist/harness-launch-gate.js +5 -3
  38. package/dist/harness-worker.js +7 -5
  39. package/dist/hook-body.js +107 -38
  40. package/dist/{hooks-JHXUN5MD.js → hooks-HQOLXR3A.js} +3 -3
  41. package/dist/{host-VI4ZFCZP.js → host-4W3JUQAO.js} +11 -10
  42. package/dist/{host-OBRHBDRE.js → host-N5UILUK7.js} +8 -6
  43. package/dist/{host-run-H7AITG7C.js → host-run-CVYRZB7R.js} +6 -4
  44. package/dist/http.js +1 -1
  45. package/dist/{import-mcp-3Y33CUHF.js → import-mcp-IAGC3LJU.js} +10 -9
  46. package/dist/index.d.ts +1 -1
  47. package/dist/index.js +15 -14
  48. package/dist/{init-WZJHMWNJ.js → init-HPEVKKMU.js} +2 -2
  49. package/dist/{invoke-GWWTXQLO.js → invoke-TD5YR2G7.js} +9 -7
  50. package/dist/{list-Y6UPLGNF.js → list-YUHJ5CTT.js} +10 -9
  51. package/dist/{logout-KAUW4JZZ.js → logout-JQ5UPC5W.js} +9 -8
  52. package/dist/{mainline-Q42M2GJ2.js → mainline-7HO7RCQH.js} +55 -24
  53. package/dist/{mcp-IDEUIY2F.js → mcp-B6SYBT3X.js} +2 -2
  54. package/dist/{project-GVVWLDOJ.js → project-GOW2MEFY.js} +7 -7
  55. package/dist/{run-RRWB7U2Q.js → run-7UNRLLYD.js} +8 -7
  56. package/dist/{run-HVNKQHVU.js → run-ZOSIKNDX.js} +4 -4
  57. package/dist/{serve-KJSOU3BR.js → serve-VRBL67KO.js} +3 -3
  58. package/dist/{setup-3GET6K3J.js → setup-QMYAW3MB.js} +2 -2
  59. package/dist/{smoke-FQQJOQBD.js → smoke-EXPR7HLD.js} +4 -3
  60. package/dist/{start-login-RNHSEX5P.js → start-login-NRD323LK.js} +9 -8
  61. package/dist/{status-RR4VZARJ.js → status-JN2GT5UM.js} +10 -9
  62. package/dist/{status-Y25ONHA5.js → status-ZY5B7V6R.js} +9 -8
  63. package/dist/stdio.js +2 -2
  64. package/dist/{test-7NYPQ6YU.js → test-VGJXKCQT.js} +10 -9
  65. package/dist/{tui-H5RPSF4B.js → tui-GORRJIMA.js} +4 -4
  66. package/dist/{worker-YWFTWIBP.js → worker-LJG2NDMK.js} +9 -7
  67. package/docs/compatibility.md +11 -10
  68. package/docs/git-workflow.md +20 -12
  69. package/docs/hooks.md +7 -1
  70. package/docs/project-configuration.md +22 -1
  71. package/docs/upgrading.md +28 -0
  72. package/gemini-extension.json +2 -2
  73. package/mcp.json +1 -1
  74. package/package.json +5 -5
  75. package/plugin.json +1 -1
  76. package/plugins/pmcp/.claude-plugin/plugin.json +1 -1
  77. package/plugins/pmcp/.mcp.json +1 -1
  78. package/plugins/pmcp/gemini-extension.json +2 -2
  79. package/plugins/pmcp/mcp.json +1 -1
  80. package/plugins/pmcp/plugin.json +1 -1
  81. package/dist/chunk-L42U5XKC.js +0 -7
@@ -1,6 +1,6 @@
1
1
  import {
2
2
  specFrom
3
- } from "./chunk-RNC7PGW2.js";
3
+ } from "./chunk-FOIQUPIQ.js";
4
4
  import {
5
5
  sourceFor
6
6
  } from "./chunk-7TD53M7L.js";
@@ -11,13 +11,12 @@ import {
11
11
  commandsOf,
12
12
  customMode,
13
13
  customPolicy
14
- } from "./chunk-TCW2H47H.js";
14
+ } from "./chunk-4Z6NPSWX.js";
15
15
  import "./chunk-UKR64U7J.js";
16
16
  import "./chunk-XZ2TDH3J.js";
17
17
  import "./chunk-KUBHGVTD.js";
18
18
  import "./chunk-EATCUWGG.js";
19
19
  import "./chunk-OFJIMBTL.js";
20
- import "./chunk-NRBQK6UX.js";
21
20
  import "./chunk-LFFIQBNY.js";
22
21
  import {
23
22
  DEFAULT_LOG_SETTINGS,
@@ -25,7 +24,7 @@ import {
25
24
  } from "./chunk-HQOB7OQS.js";
26
25
  import "./chunk-73AKO4UL.js";
27
26
  import "./chunk-P6LNYYYH.js";
28
- import "./chunk-GBKRDRMZ.js";
27
+ import "./chunk-NFJ44OE2.js";
29
28
  import "./chunk-2Q6MNGU5.js";
30
29
  import {
31
30
  SESSION_ID,
@@ -47,13 +46,14 @@ import {
47
46
  NEUTRAL_EVENTS,
48
47
  RUNTIMES,
49
48
  RUNTIME_IDS
50
- } from "./chunk-5YCKFU5Q.js";
49
+ } from "./chunk-OMIIXLMO.js";
51
50
  import {
52
51
  ArgumentError,
53
52
  one
54
53
  } from "./chunk-A4PKLESO.js";
55
54
  import "./chunk-V4NPDK6X.js";
56
- import "./chunk-XB363ZXT.js";
55
+ import "./chunk-NAXUAC5S.js";
56
+ import "./chunk-NRBQK6UX.js";
57
57
  import {
58
58
  expandPath
59
59
  } from "./chunk-OEH47H6A.js";
@@ -61,7 +61,8 @@ import {
61
61
  checkoutOf,
62
62
  worktreesOf
63
63
  } from "./chunk-IJBSOWHK.js";
64
- import "./chunk-L42U5XKC.js";
64
+ import "./chunk-XWLMZKH2.js";
65
+ import "./chunk-FWKQA6TX.js";
65
66
  import "./chunk-GJXOFDJT.js";
66
67
  import "./chunk-PMJG2CXF.js";
67
68
  import "./chunk-J6KL3COD.js";
@@ -543,7 +544,7 @@ async function simulate(input, compiled, store) {
543
544
  async function run(context) {
544
545
  const fixtures = one(context.args, "fixtures");
545
546
  if (fixtures !== void 0)
546
- return (await import("./smoke-FQQJOQBD.js")).run(context, fixtures);
547
+ return (await import("./smoke-EXPR7HLD.js")).run(context, fixtures);
547
548
  const runtime = one(context.args, "runtime");
548
549
  if (!RUNTIME_IDS.includes(runtime))
549
550
  throw new ArgumentError("--runtime must be claude or codex");
@@ -607,4 +608,4 @@ async function run(context) {
607
608
  export {
608
609
  run
609
610
  };
610
- //# sourceMappingURL=test-7NYPQ6YU.js.map
611
+ //# sourceMappingURL=test-VGJXKCQT.js.map
@@ -112,10 +112,10 @@ var tuiCommand = {
112
112
  try {
113
113
  let receipt;
114
114
  if (invocation.action === "doctor") {
115
- const { inspectTerminalHost } = await import("./diagnostics-ABTJUYZQ.js");
115
+ const { inspectTerminalHost } = await import("./diagnostics-R7S3DNXD.js");
116
116
  receipt = inspectTerminalHost();
117
117
  } else if (invocation.action === "start-worker") {
118
- const { startWorkspaceWorker } = await import("./worker-YWFTWIBP.js");
118
+ const { startWorkspaceWorker } = await import("./worker-LJG2NDMK.js");
119
119
  receipt = await startWorkspaceWorker(
120
120
  { config: invocation.startup?.config, cwd: context.cwd },
121
121
  invocation.startup.runtime,
@@ -128,7 +128,7 @@ var tuiCommand = {
128
128
  cwd: context.cwd
129
129
  });
130
130
  } else {
131
- const { launchStartup, planStartup } = await import("./entry-ARGY5CKA.js");
131
+ const { launchStartup, planStartup } = await import("./entry-GSGCMXE5.js");
132
132
  const request = { ...invocation.startup, cwd: context.cwd };
133
133
  receipt = invocation.action === "plan" ? planStartup(request) : await launchStartup(
134
134
  request,
@@ -150,4 +150,4 @@ var tuiCommand = {
150
150
  export {
151
151
  tuiCommand
152
152
  };
153
- //# sourceMappingURL=tui-H5RPSF4B.js.map
153
+ //# sourceMappingURL=tui-GORRJIMA.js.map
@@ -5,19 +5,21 @@ import {
5
5
  } from "./chunk-C3G75JH7.js";
6
6
  import {
7
7
  invoke
8
- } from "./chunk-NDED2O5B.js";
8
+ } from "./chunk-SKOP4ZST.js";
9
9
  import "./chunk-DZ2MRTYT.js";
10
- import "./chunk-SLCNCAWY.js";
11
- import "./chunk-SPZ42EWE.js";
10
+ import "./chunk-GE2PHR35.js";
11
+ import "./chunk-T6MQPVLH.js";
12
12
  import {
13
13
  locateExecutable
14
14
  } from "./chunk-R2GPCZUX.js";
15
- import "./chunk-S4Y44CCC.js";
15
+ import "./chunk-D2DDM5VZ.js";
16
16
  import "./chunk-34DECPVC.js";
17
- import "./chunk-XB363ZXT.js";
17
+ import "./chunk-NAXUAC5S.js";
18
+ import "./chunk-NRBQK6UX.js";
18
19
  import "./chunk-OEH47H6A.js";
19
20
  import "./chunk-IJBSOWHK.js";
20
- import "./chunk-L42U5XKC.js";
21
+ import "./chunk-XWLMZKH2.js";
22
+ import "./chunk-FWKQA6TX.js";
21
23
  import "./chunk-GJXOFDJT.js";
22
24
  import "./chunk-PMJG2CXF.js";
23
25
  import {
@@ -77,4 +79,4 @@ async function startWorkspaceWorker(request, runtime, memoryMb) {
77
79
  export {
78
80
  startWorkspaceWorker
79
81
  };
80
- //# sourceMappingURL=worker-YWFTWIBP.js.map
82
+ //# sourceMappingURL=worker-LJG2NDMK.js.map
@@ -38,16 +38,17 @@ prompts.
38
38
 
39
39
  ## Installation and packaging
40
40
 
41
- | Surface | Current qualification |
42
- | ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
43
- | CLI and MCP on Linux amd64 | Published 0.15.0 passed clean Docker installation with npm on Debian/Alpine and Bun/pnpm on Debian; 60 installation and failure contracts |
44
- | Optional terminal workspace | Linux pmcp-pty checks and a native Claude main with a Gemini worker (control, input, wake turns, recovery); other runtimes measured on tmux in 0.17 |
45
- | Public skill installation | npm, Bun and pnpm 10.17.1; confirmation required, scripts disabled |
46
- | Native plugin export | Claude, Codex, Gemini, Grok and agy formats; export does not install or activate a vendor plugin |
47
- | pnpm workspace installation | Selects the member, preserves root dependencies and updates the shared lockfile |
48
- | Yarn skill installation | Refused without changing project files; Yarn PnP is not supported |
49
- | Docker profile for the harness | Codex 0.161.0 login and main/worker responses through the profile's proxy; other vendors and token refresh not measured |
50
- | OpenCode user-only skills | OpenCode 1.18.33: `invocation = "user"` hides the skill from the model and keeps the `/<name>` command, measured with isolated CLI calls and scripted responses, no model call |
41
+ | Surface | Current qualification |
42
+ | ------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
43
+ | CLI and MCP on Linux amd64 | Published 0.15.0 passed clean Docker installation with npm on Debian/Alpine and Bun/pnpm on Debian; 60 installation and failure contracts |
44
+ | Optional terminal workspace | Linux pmcp-pty checks and a native Claude main with a Gemini worker (control, input, wake turns, recovery); other runtimes measured on tmux in 0.17 |
45
+ | Public skill installation | npm, Bun and pnpm 10.17.1; confirmation required, scripts disabled |
46
+ | Native plugin export | Claude, Codex, Gemini, Grok and agy formats; export does not install or activate a vendor plugin |
47
+ | pnpm workspace installation | Selects the member, preserves root dependencies and updates the shared lockfile |
48
+ | Yarn skill installation | Refused without changing project files; Yarn PnP is not supported |
49
+ | Docker profile for the harness | Codex 0.161.0 login and main/worker responses through the profile's proxy; other vendors and token refresh not measured |
50
+ | OpenCode user-only skills | OpenCode 1.18.33: `invocation = "user"` hides the skill from the model and keeps the `/<name>` command, measured with isolated CLI calls and scripted responses, no model call |
51
+ | Codex project agents | codex-cli 0.163.0: the name a sub-agent is spawned under must be lowercase letters, digits and underscores, so pmcp writes Codex agent names with `_` for `-`. In `codex exec` the model found no way to pick a custom agent role when spawning, with or without `features.multi_agent_v2.hide_spawn_agent_metadata = false`; whether a role named with a hyphen can be picked was not measured |
51
52
 
52
53
  Provider authentication, native children and vendor behavior have separate
53
54
  qualification scopes. An installed executable or exported manifest is not proof
@@ -63,10 +63,16 @@ session's lease, or a git operation in progress holds the desk where it is
63
63
  gate's worktree, default `<state dir>/gate/tree`; a relative path is relative to
64
64
  the main checkout, like `state_dir`), `lock_wait_seconds`
65
65
  (default `5400`), `lock_env` (an environment variable name), `tree_env` (an
66
- environment variable name) and `log_dir` (default `<dir of tree>/logs`). Each
67
- gate's full output goes to `<log_dir>/<UTC time>-<tip>.log` as well as the
68
- terminal; pmcp names the file when the gate starts and again if it fails, and
69
- keeps the newest 20. With `max_load` (the 1-minute load average, e.g. `6`) a
66
+ environment variable name), `log_dir` (default `<state dir>/gate-logs`, wherever
67
+ the gate tree is) and `log_keep` (default `20`). Each gate's full output, stdout
68
+ and stderr as they streamed to the terminal, is kept in
69
+ `<log_dir>/<tip>/<UTC time>-<run>.log`, one file per gate run of that replayed
70
+ tip (the full hash), with `<log_dir>/<tip>/latest` holding the newest file's
71
+ name; a pre-push gate's output is kept the same way. pmcp names the file when
72
+ the gate starts and again if it fails, and the `--json` receipt names it for
73
+ passing and failing runs alike, so a failure can be read without running the
74
+ gate again. The newest `log_keep` tips are kept, with every run of each; older
75
+ tips' directories are removed when a new tip's is made. With `max_load` (the 1-minute load average, e.g. `6`) a
70
76
  delivery that holds the lock waits until the load is below it before the gate starts,
71
77
  checking every 15 seconds for up to `load_wait_seconds` (default `1800`), and then
72
78
  fails without running the gate; once started, a gate is never retried.
@@ -128,7 +134,8 @@ variable reaches the push only if `push_env` names it.
128
134
  staying on stderr: `{ok, code, delivered, upstream, attempts, replayed, gate,
129
135
  leases, sync, desk_sync, reason?}`, where `delivered` is the upstream commit it pushed (or
130
136
  `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
137
+ `gate` is `{exit, log, logs, by}` for the last gate run (or `null`; `log` is that
138
+ run's file, `logs` the tip's directory holding every run, and `by` is
132
139
  `"command"` or `"pre-push"`), `leases` the leases it took, `sync` the main
133
140
  checkout's sync after the delivery (or `null` when none ran) as
134
141
  `{from, to, code, reason?}`: the main checkout's HEAD before and after, the exit
@@ -185,10 +192,11 @@ formats: within a release line fields are only added, never renamed, retyped or
185
192
  removed, and readers ignore fields they do not know. Times are UTC ISO 8601
186
193
  strings, and JSON files are written whole through a rename.
187
194
 
188
- | File | Where | Content |
189
- | ------------------- | -------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
190
- | `lock` | beside the gate tree | Empty; held with `flock -x` for the whole of one delivery's gate. |
191
- | `holder.json` | beside `lock` | `{tip, subject, checkout, pid, startedAt}`: the commit being gated (full hash), its subject, the checkout delivering it, the holding process and when it took the lock. Removed by its writer before the lock is released, and only when `pid` is its own. |
192
- | `<name>-lease.json` | the state directory, or `[sessions.leases.<name>] file` | `{pid, subject, since, cwd?}`. A lease whose `pid` is not alive is free; whoever takes it next replaces the file. |
193
- | lease events | `[sessions.leases.<name>] events` | JSON Lines, one per delivery that changed the leased paths: `{at, subject, commit, hash, installed, lease}`, with `commit` the delivered upstream (10 characters), `hash` the leased files' hash in the main checkout after sync, and `installed` whether sync's install ran for that hash. |
194
- | install stamp | `[git.mainline.sync] stamp`, else pmcp's state directory | One line: the hash last installed. With `stamp_hash = "plain"` it is the sha256 hex of the single `install_when_changed` file's bytes; with `"pmcp"`, a hash of every listed path and its name. |
195
+ | File | Where | Content |
196
+ | ------------------- | ----------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
197
+ | `lock` | beside the gate tree | Empty; held with `flock -x` for the whole of one delivery's gate. |
198
+ | `holder.json` | beside `lock` | `{tip, subject, checkout, pid, startedAt}`: the commit being gated (full hash), its subject, the checkout delivering it, the holding process and when it took the lock. Removed by its writer before the lock is released, and only when `pid` is its own. |
199
+ | gate logs | `[git.mainline.gate] log_dir`, else `<state dir>/gate-logs` | `<tip>/<UTC time>-<run>.log` per gate run of a replayed tip (full hash), the output as it streamed; `<tip>/latest` holds the newest file's name. The newest `log_keep` tip directories are kept. |
200
+ | `<name>-lease.json` | the state directory, or `[sessions.leases.<name>] file` | `{pid, subject, since, cwd?}`. A lease whose `pid` is not alive is free; whoever takes it next replaces the file. |
201
+ | lease events | `[sessions.leases.<name>] events` | JSON Lines, one per delivery that changed the leased paths: `{at, subject, commit, hash, installed, lease}`, with `commit` the delivered upstream (10 characters), `hash` the leased files' hash in the main checkout after sync, and `installed` whether sync's install ran for that hash. |
202
+ | install stamp | `[git.mainline.sync] stamp`, else pmcp's state directory | One line: the hash last installed. With `stamp_hash = "plain"` it is the sha256 hex of the single `install_when_changed` file's bytes; with `"pmcp"`, a hash of every listed path and its name. |
package/docs/hooks.md CHANGED
@@ -14,7 +14,13 @@ features use. Gemini, Antigravity, Grok and OpenCode are opt-in: name them in
14
14
  `[hooks] targets` and pmcp registers the same hook in their files (see
15
15
  [Runtime support](#runtime-support)). `pmcp.lock` pins the hash of `policy.json`; the hook refuses to
16
16
  act on a policy that does not match it, so every policy change is a reviewed
17
- projection. Codex shows changed entries under `/hooks` as needing review;
17
+ projection. When `pmcp.lock` itself cannot be read, as when a merge leaves git
18
+ conflict markers in it, no guard can be verified, so the hook refuses every tool
19
+ call except its repair: a read, an edit or write of `pmcp.lock` alone, and
20
+ `git show <rev>:pmcp.lock > pmcp.lock`, `git checkout [<rev>|--ours|--theirs]
21
+ [--] pmcp.lock` or `git restore [--source=<rev>] [--] pmcp.lock`. The refusal names
22
+ the line with the first marker and those commands; `pmcp project --check` and
23
+ `pmcp doctor` report the same. Codex shows changed entries under `/hooks` as needing review;
18
24
  untrusted hooks do not run. Each Codex, Claude and Grok entry carries a
19
25
  `statusMessage` such as `pmcp session start` or `pmcp before tool`: Codex
20
26
  lists hooks under that name, and Claude and Grok show it while the hook runs.
@@ -139,7 +139,7 @@ pmcp doctor # ask each installed tool what it loads
139
139
  | ------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
140
140
  | `[targets]` | `tools`: list of `claude`, `codex`, `gemini`, `grok`, `antigravity`, `opencode`. Missing means nothing is projected. |
141
141
  | `[skills.<name>]` | `invocation`: `"any"` (default) or `"user"`. |
142
- | `[agents.<name>.<tool>]` | Any keys, merged over the agent's frontmatter; Claude keeps `name`, `description`, `tools`, `model`, `effort`, Gemini keeps `name`, `description`. |
142
+ | `[agents.<name>.<tool>]` | Any keys, merged over the agent's frontmatter; Claude keeps `name`, `description`, `tools`, `model`, `effort`, Gemini keeps `name`, `description`. Codex keeps every key: see below. |
143
143
  | `[rules.packages]` | `file` (required): the file name each package keeps its rules in; every tracked `<package>/<file>` is linked as `.claude/rules/<dir>/<name>.md`. `dir` (default `"pkg"`, not `"pmcp"`). `strip` (default `[]`): leading path segments dropped when deriving `<name>`. Written only for Claude. |
144
144
 
145
145
  Rules go to `.claude/rules/<dir>/`, never the top level, because Grok Build
@@ -148,6 +148,27 @@ Grok Build reads `.agents/skills` itself in a trusted folder, so pmcp writes no
148
148
  skill links for it; a skill placed by hand under `.grok/skills` would shadow the
149
149
  `.agents/skills` one of the same name, and `pmcp project --check` reports it as
150
150
  undeclared.
151
+
152
+ Each agent becomes `.codex/agents/<codex name>.toml` for Codex, where the Codex
153
+ name is the agent's name with `-` turned into `_` (Codex refuses a hyphen where it
154
+ uses agent names), or `[agents.<name>.codex] name`, which must be lowercase
155
+ letters, digits and underscores. Two agents with the same Codex name are an error
156
+ naming both. `description` comes from the frontmatter unless the table sets it,
157
+ `developer_instructions` is always the agent's body (setting it in the table is an
158
+ error), and every other key in `[agents.<name>.codex]` is written as it is, plain
159
+ values first and then tables:
160
+
161
+ ```toml
162
+ [agents.test-planner.codex]
163
+ name = "browser_test_planner"
164
+ sandbox_mode = "read-only"
165
+
166
+ [agents.test-planner.codex.mcp_servers.browser]
167
+ command = "npx"
168
+ args = ["@playwright/mcp"]
169
+ enabled_tools = ["browser_navigate", "browser_snapshot"]
170
+ ```
171
+
151
172
  A server that names `${PROJECT_ROOT}` is launched through `sh`, which finds
152
173
  `pmcp.toml` at spawn time, so the generated files hold no machine's path.
153
174
  `pmcp.lock` records what was written; a file pmcp did not write is never
package/docs/upgrading.md CHANGED
@@ -5,6 +5,34 @@
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.22.1 to 0.22.2
9
+
10
+ **Gate logs move to a directory per tip in the state directory.** A delivery's gate output was
11
+ `<dir of the gate tree>/logs/<time>-<tip>.log`, the newest 20 runs kept. It is now
12
+ `<state dir>/gate-logs/<tip>/<time>-<run>.log` (or under `[git.mainline.gate] log_dir`), every
13
+ run of a tip kept, with `<tip>/latest` naming the newest, and the newest `log_keep` (default 20) tips kept. The `--json` receipt's `gate` gains `logs`, the tip's directory. pmcp no longer
14
+ writes or prunes the old `logs/` directory; delete it when you no longer need it. A tool that
15
+ looked for logs there should use the receipt's `gate.log` or `<log_dir>/<tip>/latest`.
16
+
17
+ **A `pmcp.lock` a merge left unreadable no longer locks a session out.** The hook refuses
18
+ everything but the lock's repair, and names the conflict line and the commands that restore
19
+ it; see [Hooks](hooks.md).
20
+
21
+ ## From 0.22.0 to 0.22.1
22
+
23
+ **Codex agent files are named with underscores.** Codex refuses a hyphen in the name it
24
+ spawns a sub-agent under, so an agent `frontend-implementer` is now
25
+ `.codex/agents/frontend_implementer.toml` with `name = "frontend_implementer"`. The next
26
+ `pmcp project` writes the new files and removes the hyphenated ones it wrote before. Anything
27
+ that names a Codex agent by its old hyphenated name, a prompt or a script, should use the
28
+ underscore name; `[agents.<name>.codex] name` sets another one.
29
+
30
+ **`[agents.<name>.codex]` reaches the Codex agent file.** 0.22.0 ignored it. Its keys are now
31
+ written into the file, so a hand-written Codex agent with settings such as `sandbox_mode` or
32
+ an `[mcp_servers.<id>]` table can move to `.agents/agents/<name>/agent.md` plus that table.
33
+ `developer_instructions` in the table is now an error: it is the agent's body. See
34
+ [Native files for each agent tool](project-configuration.md#native-files-for-each-agent-tool).
35
+
8
36
  ## From 0.21 to 0.22
9
37
 
10
38
  **pmcp writes no `.grok/skills` links.** Grok Build reads `.agents/skills` itself (measured on
@@ -1,11 +1,11 @@
1
1
  {
2
2
  "name": "pmcp",
3
- "version": "0.22.0",
3
+ "version": "0.22.2",
4
4
  "mcpServers": {
5
5
  "pmcp": {
6
6
  "type": "stdio",
7
7
  "command": "npx",
8
- "args": ["-y", "@modootoday/pmcp@0.22.0", "serve"]
8
+ "args": ["-y", "@modootoday/pmcp@0.22.2", "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.22.0", "serve"]
7
+ "args": ["-y", "@modootoday/pmcp@0.22.2", "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.22.0",
3
+ "version": "0.22.2",
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.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"
139
+ "@modootoday/pmcp-linux-x64": "0.22.2",
140
+ "@modootoday/pmcp-linux-arm64": "0.22.2",
141
+ "@modootoday/pmcp-darwin-x64": "0.22.2",
142
+ "@modootoday/pmcp-darwin-arm64": "0.22.2"
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.22.0",
4
+ "version": "0.22.2",
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.22.0",
3
+ "version": "0.22.2",
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.22.0", "serve"]
6
+ "args": ["-y", "@modootoday/pmcp@0.22.2", "serve"]
7
7
  }
8
8
  }
9
9
  }
@@ -1,11 +1,11 @@
1
1
  {
2
2
  "name": "pmcp",
3
- "version": "0.22.0",
3
+ "version": "0.22.2",
4
4
  "mcpServers": {
5
5
  "pmcp": {
6
6
  "type": "stdio",
7
7
  "command": "npx",
8
- "args": ["-y", "@modootoday/pmcp@0.22.0", "serve"]
8
+ "args": ["-y", "@modootoday/pmcp@0.22.2", "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.22.0", "serve"]
7
+ "args": ["-y", "@modootoday/pmcp@0.22.2", "serve"]
8
8
  }
9
9
  }
10
10
  }
@@ -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.22.0",
4
+ "version": "0.22.2",
5
5
  "description": "Find package skills and use native runtime project configuration.",
6
6
  "author": { "name": "modootoday" },
7
7
  "license": "Elastic-2.0",
@@ -1,7 +0,0 @@
1
- // src/commands/version.ts
2
- var VERSION = "0.22.0";
3
-
4
- export {
5
- VERSION
6
- };
7
- //# sourceMappingURL=chunk-L42U5XKC.js.map