@modootoday/pmcp 0.32.0 → 0.33.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 (147) 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/{affected-BHHN2Q3D.js → affected-CLIKMDJJ.js} +3 -3
  6. package/dist/{apply-SSYZGDJU.js → apply-PHXWER4P.js} +15 -14
  7. package/dist/{available-74CMIBPD.js → available-CYDZYY7E.js} +3 -2
  8. package/dist/{broadcast-U7ZYOJWE.js → broadcast-4YBKHLXV.js} +5 -5
  9. package/dist/{chunk-SMHHL25Y.js → chunk-2D36J3YZ.js} +9 -6
  10. package/dist/{chunk-AALSWFPA.js → chunk-3H7UTRJW.js} +7 -7
  11. package/dist/{chunk-3DRV5KHZ.js → chunk-3QU7Z7SJ.js} +4 -4
  12. package/dist/{chunk-FALOBFE6.js → chunk-47MNSTNA.js} +3 -3
  13. package/dist/{chunk-C3G75JH7.js → chunk-4B2VDTHL.js} +16 -5
  14. package/dist/{chunk-65BW7Y6O.js → chunk-4F4CMDKZ.js} +1 -1
  15. package/dist/{chunk-YOWIYFIV.js → chunk-4U4GLMZ6.js} +5 -8
  16. package/dist/{chunk-JANBBPKP.js → chunk-5VGNZSB7.js} +6 -6
  17. package/dist/{chunk-VEJU5HXJ.js → chunk-6NVAKB2U.js} +3 -3
  18. package/dist/{chunk-6H3HN7E7.js → chunk-7RRZGHXM.js} +5 -5
  19. package/dist/{chunk-Y2XASHVY.js → chunk-AXNXNFSV.js} +2 -2
  20. package/dist/{chunk-HF5D6B2U.js → chunk-BN73TTTP.js} +7 -10
  21. package/dist/{chunk-XADROJFL.js → chunk-CD3NHHQ3.js} +2 -2
  22. package/dist/chunk-CGFLYYGD.js +175 -0
  23. package/dist/{chunk-E2E4HIEN.js → chunk-CSZ2HI2R.js} +2 -2
  24. package/dist/{chunk-OIYZT4BG.js → chunk-DGVXKZHP.js} +11 -4
  25. package/dist/{chunk-ITDJ2EXN.js → chunk-DIWQOLPW.js} +2 -2
  26. package/dist/chunk-EWEY3ASH.js +21 -0
  27. package/dist/{chunk-PRQICZXO.js → chunk-EWTJTS54.js} +14 -14
  28. package/dist/{chunk-KWCZKCTC.js → chunk-FDFVAZOE.js} +11 -15
  29. package/dist/{chunk-IAR7BL5R.js → chunk-GTPQUQCP.js} +2 -2
  30. package/dist/{chunk-OIV44CYB.js → chunk-HGVYHF3S.js} +3 -3
  31. package/dist/{chunk-SU6R4VWV.js → chunk-I4IQUTR4.js} +3 -3
  32. package/dist/{chunk-7DJQASH3.js → chunk-IH76KECZ.js} +10 -34
  33. package/dist/{chunk-UKGO2RR7.js → chunk-JFZU46JO.js} +2 -2
  34. package/dist/{chunk-Q6V274OB.js → chunk-JNW2Z36X.js} +2 -2
  35. package/dist/chunk-JOGLKWN7.js +52 -0
  36. package/dist/{chunk-VBVNOLRR.js → chunk-K4ZG3BXL.js} +2 -2
  37. package/dist/{chunk-JZKAJUVT.js → chunk-KESQUAKO.js} +2 -2
  38. package/dist/{chunk-OS5CYV27.js → chunk-KR3D7TQO.js} +3 -3
  39. package/dist/{chunk-UVTGY2R3.js → chunk-KRDNVEV6.js} +4 -7
  40. package/dist/{chunk-2HL2MFNI.js → chunk-KWSCDIE2.js} +2 -2
  41. package/dist/{chunk-UT2NACLW.js → chunk-MEQ43M6X.js} +2 -2
  42. package/dist/{chunk-QYLOIM4U.js → chunk-MFD2UEJY.js} +6 -8
  43. package/dist/{chunk-QZY36KNT.js → chunk-MIOKNRMY.js} +2 -2
  44. package/dist/{chunk-JPYQDOEW.js → chunk-MPYM2HYV.js} +7 -9
  45. package/dist/{chunk-YJVSN6UN.js → chunk-NFWN3AMZ.js} +3 -3
  46. package/dist/{chunk-GQRDEIQA.js → chunk-NQBSTHYF.js} +1 -1
  47. package/dist/{chunk-I4U2A6HP.js → chunk-NQVAFHDK.js} +2 -2
  48. package/dist/{chunk-LXWAU7AX.js → chunk-OOH47XJH.js} +6 -6
  49. package/dist/chunk-PN3U7FPZ.js +7 -0
  50. package/dist/{chunk-V4NPDK6X.js → chunk-QRLTTS5K.js} +1 -1
  51. package/dist/{chunk-FFQA2R5P.js → chunk-RBWTJQYR.js} +6 -13
  52. package/dist/{chunk-MUGHZ6QC.js → chunk-RM6IPG7B.js} +2 -2
  53. package/dist/{chunk-IFFOJ3IE.js → chunk-S5L65IJL.js} +2 -2
  54. package/dist/{chunk-4VVQLWTS.js → chunk-SXFW4COX.js} +2 -2
  55. package/dist/{chunk-WZYGM3FR.js → chunk-TLHWUYTW.js} +5 -5
  56. package/dist/{chunk-FGG7JJ5M.js → chunk-TRAC427I.js} +3 -3
  57. package/dist/{chunk-D7IDT7OA.js → chunk-UFGGQVB7.js} +5 -5
  58. package/dist/{chunk-OIKT4SYO.js → chunk-UOFHM6OM.js} +2 -2
  59. package/dist/{chunk-NQCAKDRY.js → chunk-UORJZ7TK.js} +3 -3
  60. package/dist/{chunk-A4P3IIPE.js → chunk-VCQQHIH5.js} +5 -5
  61. package/dist/{chunk-QRCAGKC6.js → chunk-WWNY53B6.js} +14 -11
  62. package/dist/{chunk-WBPVNCQO.js → chunk-WYK57MIH.js} +6 -6
  63. package/dist/{chunk-TQRLWO4F.js → chunk-XPYY6K5L.js} +2 -2
  64. package/dist/{chunk-ESM7TFTO.js → chunk-YKYHM54P.js} +2 -2
  65. package/dist/{cli-RHOETDBX.js → cli-33J5JI7Q.js} +7 -7
  66. package/dist/{cli-ZOY2274X.js → cli-TVVP3DZ5.js} +10 -10
  67. package/dist/cli.js +19 -19
  68. package/dist/{completion-PE6CHX4K.js → completion-KM3C2SHI.js} +18 -18
  69. package/dist/{diagnostics-7Y5OFV44.js → diagnostics-HQIZ5M24.js} +9 -8
  70. package/dist/{doctor-XY6OMK7W.js → doctor-PIJMN7XM.js} +7 -7
  71. package/dist/{doctor-GBIPPKPD.js → doctor-UGWGKB5U.js} +18 -17
  72. package/dist/{entry-4WT2WM6C.js → entry-VNL45DQN.js} +15 -14
  73. package/dist/{exec-mcp-BLTFBWND.js → exec-mcp-2QE7TWE4.js} +12 -11
  74. package/dist/{harness-HGBKFIUT.js → harness-5QEGA4RC.js} +3 -3
  75. package/dist/harness-launch-gate.js +8 -7
  76. package/dist/harness-pane-runner.js +3 -2
  77. package/dist/harness-worker.js +10 -9
  78. package/dist/{heavy-E55QD5LR.js → heavy-E2LBLJ7P.js} +10 -10
  79. package/dist/{hooks-MT3CGRSU.js → hooks-VOKZV5M4.js} +5 -5
  80. package/dist/{host-FXO4VGE6.js → host-2F5PG3DF.js} +6 -6
  81. package/dist/{host-5AI4JAXD.js → host-IZ2Y55HL.js} +9 -8
  82. package/dist/{host-AMKVSOYU.js → host-RJ72SAF6.js} +14 -13
  83. package/dist/{host-run-M2KMMU72.js → host-run-EQQDEUW5.js} +7 -6
  84. package/dist/http.d.ts +4 -4
  85. package/dist/http.js +4 -3
  86. package/dist/{import-mcp-QTUVK5GE.js → import-mcp-HEAIC23N.js} +11 -10
  87. package/dist/index.d.ts +6 -7
  88. package/dist/index.js +18 -17
  89. package/dist/init-CVKLSL5D.js +14 -0
  90. package/dist/{install-5JH4DSFF.js → install-ITEWB6V3.js} +3 -2
  91. package/dist/{invoke-D2CYSRFG.js → invoke-TA2SYXFJ.js} +12 -11
  92. package/dist/{list-LV5EKCF6.js → list-CNLGT6TK.js} +3 -2
  93. package/dist/{list-UG67V5EO.js → list-N7DWTEPL.js} +13 -12
  94. package/dist/{load-BEUBABtB.d.ts → load-C6Iite0Q.d.ts} +1 -1
  95. package/dist/{logout-Z5KMKTTP.js → logout-FVMOFMES.js} +12 -11
  96. package/dist/{logs-J4W6GFMK.js → logs-UQ3FJ5RY.js} +3 -3
  97. package/dist/mailbox/index.js +5 -4
  98. package/dist/{mailbox-6MHH6CUA.js → mailbox-AZR6YUC5.js} +5 -5
  99. package/dist/{mailbox-ZHZWZMAY.js → mailbox-GSGP5EGX.js} +6 -5
  100. package/dist/{mainline-Y4HOI5R7.js → mainline-GYF4BNMI.js} +7 -7
  101. package/dist/{marketplace-2X3OOEPW.js → marketplace-S3DXRVIR.js} +16 -8
  102. package/dist/{mcp-QARZ7L22.js → mcp-CAUFKA44.js} +4 -4
  103. package/dist/{measure-K7D3GLC6.js → measure-QB7SGMO3.js} +7 -7
  104. package/dist/{models-XSF45MCD.js → models-YEMUWADC.js} +3 -2
  105. package/dist/{owners-MPI22SFU.js → owners-E3WYJML3.js} +3 -3
  106. package/dist/{pause-3IMVYXQQ.js → pause-HVXLAT7D.js} +5 -5
  107. package/dist/{plan-JAHYXJHP.js → plan-T2GT3YN6.js} +7 -7
  108. package/dist/{preview-465CQJBQ.js → preview-PPA6UJDD.js} +3 -2
  109. package/dist/{project-5SL2CE5F.js → project-UGPOUTTR.js} +7 -7
  110. package/dist/{recovery-HB2YFQSQ.js → recovery-7ATXH6W5.js} +5 -4
  111. package/dist/{reindex-D62HQAN2.js → reindex-KQJAX323.js} +4 -3
  112. package/dist/{resume-7LCSV4X3.js → resume-MMHI3BNI.js} +5 -5
  113. package/dist/{run-H22CN65S.js → run-O6OYB423.js} +11 -10
  114. package/dist/{run-EUU6TJBI.js → run-Z2RXQJPJ.js} +4 -4
  115. package/dist/{serve-36VOPK47.js → serve-M4PZOOAW.js} +12 -10
  116. package/dist/{session-3YVVO2GR.js → session-BTN4JXQ4.js} +3 -2
  117. package/dist/{setup-Y5SM4LKI.js → setup-O75KDANV.js} +4 -4
  118. package/dist/{smoke-GZECLXOJ.js → smoke-UK42EV7O.js} +3 -3
  119. package/dist/{start-login-3CUVLBDP.js → start-login-GY62GMNC.js} +12 -11
  120. package/dist/{status-QFMN7IUG.js → status-GQHMLK4G.js} +5 -5
  121. package/dist/{status-SLQQMCZP.js → status-YMUZYN5M.js} +12 -11
  122. package/dist/{status-ZGFOO5YT.js → status-YWXOVGE3.js} +15 -14
  123. package/dist/stdio.d.ts +1 -1
  124. package/dist/stdio.js +7 -6
  125. package/dist/{sweep-BS7HVSNP.js → sweep-UVD3KAFD.js} +5 -5
  126. package/dist/{test-JKU4KELV.js → test-SBP54LNA.js} +13 -12
  127. package/dist/{tools-gpHNq9Dh.d.ts → tools-Dnu9wAAm.d.ts} +20 -6
  128. package/dist/{tui-QB42W3XZ.js → tui-TB7YQLMP.js} +5 -5
  129. package/dist/{unbroadcast-GRGX3F6T.js → unbroadcast-YWUKATJK.js} +5 -5
  130. package/dist/{validate-YXR7FJJX.js → validate-MIVCL2ZK.js} +5 -3
  131. package/dist/{worker-VPP2HD6O.js → worker-4VBEX5KF.js} +13 -12
  132. package/docs/compatibility.md +5 -0
  133. package/docs/project-configuration.md +36 -36
  134. package/docs/upgrading.md +12 -0
  135. package/gemini-extension.json +2 -2
  136. package/mcp.json +1 -1
  137. package/package.json +5 -5
  138. package/plugin.json +1 -1
  139. package/plugins/pmcp/.claude-plugin/plugin.json +1 -1
  140. package/plugins/pmcp/.mcp.json +1 -1
  141. package/plugins/pmcp/gemini-extension.json +2 -2
  142. package/plugins/pmcp/mcp.json +1 -1
  143. package/plugins/pmcp/plugin.json +1 -1
  144. package/dist/chunk-BU65MNVU.js +0 -13
  145. package/dist/chunk-KNIHXLDE.js +0 -7
  146. package/dist/chunk-PPWEOXIU.js +0 -175
  147. package/dist/init-RAAQOP4D.js +0 -14
@@ -2,38 +2,39 @@ import {
2
2
  readStartup,
3
3
  startupFile,
4
4
  startupSettings
5
- } from "./chunk-C3G75JH7.js";
5
+ } from "./chunk-4B2VDTHL.js";
6
6
  import {
7
7
  invoke
8
- } from "./chunk-AALSWFPA.js";
8
+ } from "./chunk-3H7UTRJW.js";
9
9
  import "./chunk-DZ2MRTYT.js";
10
- import "./chunk-FFQA2R5P.js";
11
- import "./chunk-MUGHZ6QC.js";
10
+ import "./chunk-RBWTJQYR.js";
11
+ import "./chunk-RM6IPG7B.js";
12
12
  import {
13
13
  locateExecutable
14
14
  } from "./chunk-R2GPCZUX.js";
15
- import "./chunk-FGG7JJ5M.js";
15
+ import "./chunk-TRAC427I.js";
16
16
  import "./chunk-34DECPVC.js";
17
- import "./chunk-PRQICZXO.js";
18
- import "./chunk-QZY36KNT.js";
17
+ import "./chunk-EWTJTS54.js";
18
+ import "./chunk-MIOKNRMY.js";
19
19
  import "./chunk-N7ANFMA5.js";
20
20
  import "./chunk-TYY5TYHF.js";
21
- import "./chunk-ESM7TFTO.js";
21
+ import "./chunk-YKYHM54P.js";
22
22
  import "./chunk-KLIYFD3W.js";
23
23
  import "./chunk-GUHOEIHP.js";
24
24
  import "./chunk-IJBSOWHK.js";
25
25
  import "./chunk-XWLMZKH2.js";
26
- import "./chunk-KNIHXLDE.js";
26
+ import "./chunk-PN3U7FPZ.js";
27
27
  import "./chunk-GJXOFDJT.js";
28
28
  import "./chunk-PMJG2CXF.js";
29
29
  import {
30
30
  GroupStore
31
- } from "./chunk-ITDJ2EXN.js";
31
+ } from "./chunk-DIWQOLPW.js";
32
32
  import "./chunk-5OMOPUE6.js";
33
33
  import {
34
34
  runtimeExecutables
35
- } from "./chunk-BU65MNVU.js";
35
+ } from "./chunk-EWEY3ASH.js";
36
36
  import "./chunk-J6KL3COD.js";
37
+ import "./chunk-JOGLKWN7.js";
37
38
 
38
39
  // src/tui/startup/worker.ts
39
40
  async function startWorkspaceWorker(request, runtime, memoryMb) {
@@ -83,4 +84,4 @@ async function startWorkspaceWorker(request, runtime, memoryMb) {
83
84
  export {
84
85
  startWorkspaceWorker
85
86
  };
86
- //# sourceMappingURL=worker-VPP2HD6O.js.map
87
+ //# sourceMappingURL=worker-4VBEX5KF.js.map
@@ -31,6 +31,11 @@ unsigned; installed through npm they run as they are, since npm sets no quaranti
31
31
  | Antigravity (agy) | `antigravity` | `antigravity` | `agy` |
32
32
  | OpenCode | `opencode` | not available | `opencode` |
33
33
 
34
+ The columns are what pmcp writes. Where you name a runtime yourself (`[[host.sessions]] runtime`,
35
+ `[tui] runtime` and `pmcp tui --runtime`, `pmcp marketplace export --runtime`, and a skill's
36
+ `verified-runtimes`), any spelling in the row is accepted: `agy` or `antigravity`, `claude` or
37
+ `claude-code`.
38
+
34
39
  Which hook features each runtime supports, as measured, is in
35
40
  [Runtime support](hooks.md#runtime-support). Provider login, folder trust and
36
41
  tool approvals stay in each runtime; pmcp never answers login, auth, trust or hook-review
@@ -300,42 +300,42 @@ max_wait = 2700
300
300
  load_grace = 600
301
301
  ```
302
302
 
303
- | Key | Type | Default | Meaning |
304
- | ------------------- | -------------------------- | -------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
305
- | `enabled` | boolean | `true` | `false` runs every `pmcp heavy` command at once, gates without the lease and turns the guard off. |
306
- | `dir` | path | `~/.cache/pmcp/host` | Where the lock file (`heavy.lock`), the admission lock, the `running/` and `waiters/` records, the holder record and `heavy.log` live. Every tool sharing the lease names the same directory. |
307
- | `budget` | integer | `4` | The most weight that runs at once. `1` is one job at a time. |
308
- | `gate_alone` | boolean | `false` | `true` starts no job of another lane while a `gate` job runs or waits, so a land's gate never shares the host with a test or build that the same calm moment let in beside it. Jobs already running finish; `tiny` jobs still start. |
309
- | `age_limit` | seconds | `600` | An `interactive` or `bulk` waiter that has waited this long goes ahead of both lanes (still behind `gate` and `hook`), oldest first, and, as the first job the budget cannot fit, stops new admissions until it fits. Short jobs that keep arriving can then no longer hold a heavy one back indefinitely. `0` keeps plain lane order. |
310
- | `lanes.<lane>` | integer | gate 1, hook 1, interactive 2, bulk 1 | How many jobs of a lane run at once; `0` closes the lane. |
311
- | `weights.<lane>` | integer | gate 1, hook 1, interactive 2, bulk 3 | A job's weight when neither `--weight` nor a `commands` entry names one. A weight above the budget counts as the budget. |
312
- | `commands` | tables | none | `argv` prefix, `lane` and `weight` for commands run without `--lane` or `--weight`; the first match wins. |
313
- | `tiny` | argv lists | none | Commands so short (a few seconds) that they take no slot and no budget (weight 0, also `--weight 0`); only the hard ceiling holds them back, and the log still records them. |
314
- | `per_session` | integer | `1` | How many jobs one agent session may have queued in the interactive lane, and in the bulk lane; the next one waits outside the queue holding no place. `0` is no cap. Gate and hook are exempt. |
315
- | `marker_env` | name | `PMCP_HEAVY_LEASE` | Set to the job's pid for the leased command; a nested `pmcp heavy` whose marker names a running job runs at once. |
316
- | `legacy_marker_env` | name | none | A second marker, set and honoured like `marker_env`, for a shell wrapper that shares `dir`. |
317
- | `legacy_skip_env` | name | none | A second skip variable, honoured like `PMCP_HEAVY_DISABLE`, and set for the leased command so a nested shell wrapper runs at once. |
318
- | `skip_always` | list of reasons | `[]` | Skip reasons honoured even for a bulk job, for callers that must never wait on the lease (a commit hook). They are allowed skip reasons too. |
319
- | `skip_reasons` | list of reasons | `[]` | The further reasons `PMCP_HEAVY_DISABLE` may carry for an ordinary command, beside the built-in `nested` and `operator`. Lower-case words (`a-z`, digits, `-`, `_`, `.`, `:`). |
320
- | `max_load` | number | the CPU count | A job starts only while the 1-minute load average is below this. |
321
- | `max_io` | number | `8` | And while IO pressure (`some`, the `io_window` average) is below this. A host without pressure files checks load only; one without a load average checks neither. |
322
- | `io_window` | string | `avg60` | Which pressure average the check reads: `avg10` follows spikes, `avg60` and `avg300` smooth them so the queue does not stall on a burst. |
323
- | `max_wait` | seconds | `3600` | How long the `default` profile waits; then nothing runs and the exit is 75. |
324
- | `load_grace` | seconds | `900` | After this long waiting on the host, a job may start into moderate overload, but only while no leased job runs, so a grace never starts two jobs together. `0` is no grace. |
325
- | `hard_factor` | number | `2` | Never start, grace or not, while load or IO is at this many times its limit; such a job waits until `max_wait`, then exits 75. |
326
- | `hold_warn` | seconds | `1800` | A job running past this prints one warning, and `pmcp heavy status` marks it. |
327
- | `hold_max` | seconds | none | `pmcp heavy status` flags a job past this as over the limit. Nothing is killed. |
328
- | `memory_max` | size | none | Runs each command in `systemd-run --user --scope -p MemoryMax=<size> -p MemorySwapMax=0` where that is available, so a runaway job is killed alone. Without a reachable user manager (no `XDG_RUNTIME_DIR`, or no manager socket in it, as under `env -i` or cron) the command runs without the scope and one line on stderr says why; if `systemd-run` still cannot reach the bus, the command runs once more without it. A missing scope never fails the command. |
329
- | `heartbeat`, `poll` | seconds | `60`, `15` | How often a waiter prints that it is still waiting, and how often the host is reread. |
330
- | `profiles.<name>` | table | gate 2700/600, hook 900/30 | `max_wait`, `load_grace` and `memory_max` for `pmcp heavy --profile <name>`. The `gate` and `hook` profiles also choose their lane. Any other profile starts from the top-level values. |
331
- | `heavy` | argv lists, or `"default"` | `"default"` with the table, none without | The commands the `host.lease` guard expects under the lease, as argv prefixes. `"default"`, alone or as an item of the list, names pmcp's preset: `install` (and `i`, `ci`), `test`, `build` and `typecheck` for npm, pnpm, yarn and bun (`<manager> run <script>` too), and `cargo build`, `test` and `check`. An empty list turns the guard off. |
332
- | `guard` | string | `observe` | The `host.lease` guard's mode: `observe` logs what it would have refused (at info, so `pmcp hooks report --switch-check host.lease` reads it at the default log level), `warn` tells the agent, `deny` refuses with the command to run instead (`pmcp heavy -- <command>`), `off`. A command already wrapped passes. Run a week in `observe`, read the report, then set `deny`. |
333
- | `io.enabled` | `"auto"` or boolean | `"auto"` | Each leased job runs in its own `systemd-run --user` scope and gets its lane's `io.weight` where the cgroup v2 io controller reaches the user manager; elsewhere nothing changes. `true` also says when it could not; `false` never. The weights only divide the disk when the kernel's io.cost model and qos fit it: [`pmcp host io`](commands.md#host) measures the disk and checks both. |
334
- | `io.weights.<lane>` | integer | gate 500, hook 300, interactive 100, bulk 25 | The scope's `io.weight` per lane (1 to 10000). |
335
- | `io.max.<lane>` | string | none | An `io.max` line for the lane's scopes, such as `"259:0 wbps=50000000"`; the device is this host's to name. |
336
- | `settle_window` | seconds | `60` | After a leased job ends, its own leftover IO may hold the queue only this long: then a waiter starts on a moderately busy host (below `hard_factor`). `0` turns it off. |
337
- | `usage_cap` | bytes | `5000000` | `usage.jsonl` (one record per run) moves to `usage.jsonl.1` past this size. |
338
- | `job_log_bytes` | bytes | `4194304` | Each job's stdout and stderr are kept in its ticket (`<dir>/tickets/<id>/log`), moving to `log.1` past this size; `pmcp heavy result <id> --log` prints them. `0` keeps nothing for blocking runs, which then write to the terminal directly; a submitted job always keeps its output. |
303
+ | Key | Type | Default | Meaning |
304
+ | ------------------- | -------------------------- | -------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
305
+ | `enabled` | boolean | `true` | `false` runs every `pmcp heavy` command at once, gates without the lease and turns the guard off. |
306
+ | `dir` | path | `~/.cache/pmcp/host` | Where the lock file (`heavy.lock`), the admission lock, the `running/` and `waiters/` records, the holder record and `heavy.log` live. Every tool sharing the lease names the same directory. |
307
+ | `budget` | integer | `4` | The most weight that runs at once. `1` is one job at a time. |
308
+ | `gate_alone` | boolean | `false` | `true` starts no job of another lane while a `gate` job runs or waits, so a land's gate never shares the host with a test or build that the same calm moment let in beside it. Jobs already running finish; `tiny` jobs still start. |
309
+ | `age_limit` | seconds | `600` | An `interactive` or `bulk` waiter that has waited this long goes ahead of both lanes (still behind `gate` and `hook`), oldest first, and, as the first job the budget cannot fit, stops new admissions until it fits. Short jobs that keep arriving can then no longer hold a heavy one back indefinitely. From 0.33.0 a waiter also reaches its `load_grace` here when that comes later, so it may start below `hard_factor` instead of waiting for the soft limits. `0` keeps plain lane order and grace. |
310
+ | `lanes.<lane>` | integer | gate 1, hook 1, interactive 2, bulk 1 | How many jobs of a lane run at once; `0` closes the lane. |
311
+ | `weights.<lane>` | integer | gate 1, hook 1, interactive 2, bulk 3 | A job's weight when neither `--weight` nor a `commands` entry names one. A weight above the budget counts as the budget. |
312
+ | `commands` | tables | none | `argv` prefix, `lane` and `weight` for commands run without `--lane` or `--weight`; the first match wins. |
313
+ | `tiny` | argv lists | none | Commands so short (a few seconds) that they take no slot and no budget (weight 0, also `--weight 0`); only the hard ceiling holds them back, and the log still records them. |
314
+ | `per_session` | integer | `1` | How many jobs one agent session may have queued in the interactive lane, and in the bulk lane; the next one waits outside the queue holding no place. `0` is no cap. Gate and hook are exempt. |
315
+ | `marker_env` | name | `PMCP_HEAVY_LEASE` | Set to the job's pid for the leased command; a nested `pmcp heavy` whose marker names a running job runs at once. |
316
+ | `legacy_marker_env` | name | none | A second marker, set and honoured like `marker_env`, for a shell wrapper that shares `dir`. |
317
+ | `legacy_skip_env` | name | none | A second skip variable, honoured like `PMCP_HEAVY_DISABLE`, and set for the leased command so a nested shell wrapper runs at once. |
318
+ | `skip_always` | list of reasons | `[]` | Skip reasons honoured even for a bulk job, for callers that must never wait on the lease (a commit hook). They are allowed skip reasons too. |
319
+ | `skip_reasons` | list of reasons | `[]` | The further reasons `PMCP_HEAVY_DISABLE` may carry for an ordinary command, beside the built-in `nested` and `operator`. Lower-case words (`a-z`, digits, `-`, `_`, `.`, `:`). |
320
+ | `max_load` | number | the CPU count | A job starts only while the 1-minute load average is below this. |
321
+ | `max_io` | number | `8` | And while IO pressure (`some`, the `io_window` average) is below this. A host without pressure files checks load only; one without a load average checks neither. |
322
+ | `io_window` | string | `avg60` | Which pressure average the check reads: `avg10` follows spikes, `avg60` and `avg300` smooth them so the queue does not stall on a burst. |
323
+ | `max_wait` | seconds | `3600` | How long the `default` profile waits; then nothing runs and the exit is 75. |
324
+ | `load_grace` | seconds | `900` | After this long waiting on the host, a job may start into moderate overload, but only while no leased job runs, so a grace never starts two jobs together. `0` is no grace. |
325
+ | `hard_factor` | number | `2` | Never start, grace or not, while load or IO is at this many times its limit; such a job waits until `max_wait`, then exits 75. |
326
+ | `hold_warn` | seconds | `1800` | A job running past this prints one warning, and `pmcp heavy status` marks it. |
327
+ | `hold_max` | seconds | none | `pmcp heavy status` flags a job past this as over the limit. Nothing is killed. |
328
+ | `memory_max` | size | none | Runs each command in `systemd-run --user --scope -p MemoryMax=<size> -p MemorySwapMax=0` where that is available, so a runaway job is killed alone. Without a reachable user manager (no `XDG_RUNTIME_DIR`, or no manager socket in it, as under `env -i` or cron) the command runs without the scope and one line on stderr says why; if `systemd-run` still cannot reach the bus, the command runs once more without it. A missing scope never fails the command. |
329
+ | `heartbeat`, `poll` | seconds | `60`, `15` | How often a waiter prints that it is still waiting, and how often the host is reread. |
330
+ | `profiles.<name>` | table | gate 2700/600, hook 900/30 | `max_wait`, `load_grace` and `memory_max` for `pmcp heavy --profile <name>`. The `gate` and `hook` profiles also choose their lane. Any other profile starts from the top-level values. |
331
+ | `heavy` | argv lists, or `"default"` | `"default"` with the table, none without | The commands the `host.lease` guard expects under the lease, as argv prefixes. `"default"`, alone or as an item of the list, names pmcp's preset: `install` (and `i`, `ci`), `test`, `build` and `typecheck` for npm, pnpm, yarn and bun (`<manager> run <script>` too), and `cargo build`, `test` and `check`. An empty list turns the guard off. |
332
+ | `guard` | string | `observe` | The `host.lease` guard's mode: `observe` logs what it would have refused (at info, so `pmcp hooks report --switch-check host.lease` reads it at the default log level), `warn` tells the agent, `deny` refuses with the command to run instead (`pmcp heavy -- <command>`), `off`. A command already wrapped passes. Run a week in `observe`, read the report, then set `deny`. |
333
+ | `io.enabled` | `"auto"` or boolean | `"auto"` | Each leased job runs in its own `systemd-run --user` scope and gets its lane's `io.weight` where the cgroup v2 io controller reaches the user manager; elsewhere nothing changes. `true` also says when it could not; `false` never. The weights only divide the disk when the kernel's io.cost model and qos fit it: [`pmcp host io`](commands.md#host) measures the disk and checks both. |
334
+ | `io.weights.<lane>` | integer | gate 500, hook 300, interactive 100, bulk 25 | The scope's `io.weight` per lane (1 to 10000). |
335
+ | `io.max.<lane>` | string | none | An `io.max` line for the lane's scopes, such as `"259:0 wbps=50000000"`; the device is this host's to name. |
336
+ | `settle_window` | seconds | `60` | After a leased job ends, its own leftover IO may hold the queue only this long: then a waiter starts on a moderately busy host (below `hard_factor`). `0` turns it off. |
337
+ | `usage_cap` | bytes | `5000000` | `usage.jsonl` (one record per run) moves to `usage.jsonl.1` past this size. |
338
+ | `job_log_bytes` | bytes | `4194304` | Each job's stdout and stderr are kept in its ticket (`<dir>/tickets/<id>/log`), moving to `log.1` past this size; `pmcp heavy result <id> --log` prints them. `0` keeps nothing for blocking runs, which then write to the terminal directly; a submitted job always keeps its output. |
339
339
 
340
340
  Lanes, in the order a short budget goes to them: `gate` (a land's gate),
341
341
  `hook` (commit-hook work, a short slot that skips the host wait unless the host
package/docs/upgrading.md CHANGED
@@ -15,6 +15,18 @@ it: a lease-wrapped install (`pmcp heavy`) only warns about an unknown top-level
15
15
  on, a refused key in a checkout whose `package.json` pins a newer pmcp than the one
16
16
  running says so and names the install to run.
17
17
 
18
+ ## From 0.32 to 0.33
19
+
20
+ **A long wait also reaches grace sooner.** A waiter that has waited `age_limit` seconds now
21
+ counts as past its profile's `load_grace` when that is longer, so it may start into moderate
22
+ overload (below `hard_factor` times `max_load` and `max_io`) while no leased job runs. A
23
+ profile with `load_grace = 0` still has no grace.
24
+
25
+ **Runtime names: any spelling where you type one.** `[[host.sessions]] runtime`, `[tui] runtime`,
26
+ `pmcp tui --runtime`, `pmcp marketplace export --runtime` and a skill's `verified-runtimes`
27
+ accept every spelling of a runtime (`agy` or `antigravity`, `claude` or `claude-code`). What
28
+ pmcp writes is unchanged.
29
+
18
30
  ## From 0.31 to 0.32
19
31
 
20
32
  **A long wait now outranks the lane order.** A `pmcp heavy` waiter that has waited
@@ -1,11 +1,11 @@
1
1
  {
2
2
  "name": "pmcp",
3
- "version": "0.32.0",
3
+ "version": "0.33.0",
4
4
  "mcpServers": {
5
5
  "pmcp": {
6
6
  "type": "stdio",
7
7
  "command": "npx",
8
- "args": ["-y", "@modootoday/pmcp@0.32.0", "serve"]
8
+ "args": ["-y", "@modootoday/pmcp@0.33.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.32.0", "serve"]
7
+ "args": ["-y", "@modootoday/pmcp@0.33.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.32.0",
3
+ "version": "0.33.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.32.0",
140
- "@modootoday/pmcp-linux-arm64": "0.32.0",
141
- "@modootoday/pmcp-darwin-x64": "0.32.0",
142
- "@modootoday/pmcp-darwin-arm64": "0.32.0"
139
+ "@modootoday/pmcp-linux-x64": "0.33.0",
140
+ "@modootoday/pmcp-linux-arm64": "0.33.0",
141
+ "@modootoday/pmcp-darwin-x64": "0.33.0",
142
+ "@modootoday/pmcp-darwin-arm64": "0.33.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.32.0",
4
+ "version": "0.33.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.32.0",
3
+ "version": "0.33.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.32.0", "serve"]
6
+ "args": ["-y", "@modootoday/pmcp@0.33.0", "serve"]
7
7
  }
8
8
  }
9
9
  }
@@ -1,11 +1,11 @@
1
1
  {
2
2
  "name": "pmcp",
3
- "version": "0.32.0",
3
+ "version": "0.33.0",
4
4
  "mcpServers": {
5
5
  "pmcp": {
6
6
  "type": "stdio",
7
7
  "command": "npx",
8
- "args": ["-y", "@modootoday/pmcp@0.32.0", "serve"]
8
+ "args": ["-y", "@modootoday/pmcp@0.33.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.32.0", "serve"]
7
+ "args": ["-y", "@modootoday/pmcp@0.33.0", "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.32.0",
4
+ "version": "0.33.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,13 +0,0 @@
1
- // src/harness/runtimes/registry.ts
2
- var runtimeExecutables = {
3
- "codex-cli": "codex",
4
- "claude-code": "claude",
5
- "gemini-cli": "gemini",
6
- "grok-cli": "grok",
7
- antigravity: "agy"
8
- };
9
-
10
- export {
11
- runtimeExecutables
12
- };
13
- //# sourceMappingURL=chunk-BU65MNVU.js.map
@@ -1,7 +0,0 @@
1
- // src/commands/version.ts
2
- var VERSION = "0.32.0";
3
-
4
- export {
5
- VERSION
6
- };
7
- //# sourceMappingURL=chunk-KNIHXLDE.js.map
@@ -1,175 +0,0 @@
1
- import {
2
- marketplaceSpec
3
- } from "./chunk-JANBBPKP.js";
4
- import {
5
- mailboxSpec
6
- } from "./chunk-2HL2MFNI.js";
7
- import {
8
- harnessSpec,
9
- tuiSpec
10
- } from "./chunk-QR6A3TYP.js";
11
- import {
12
- waitSpec
13
- } from "./chunk-F3R5HEUB.js";
14
- import {
15
- ownersSpec
16
- } from "./chunk-D7IDT7OA.js";
17
- import {
18
- mcpSpec
19
- } from "./chunk-UVTGY2R3.js";
20
- import {
21
- gitSpec
22
- } from "./chunk-4VVQLWTS.js";
23
- import {
24
- heavySpec,
25
- hostSpec
26
- } from "./chunk-LXWAU7AX.js";
27
- import {
28
- sessionsSpec
29
- } from "./chunk-A4P3IIPE.js";
30
- import {
31
- logsSpec
32
- } from "./chunk-WZYGM3FR.js";
33
- import {
34
- availableSpec,
35
- installSpec,
36
- previewSpec,
37
- syncSpec
38
- } from "./chunk-WBPVNCQO.js";
39
- import {
40
- doctorSpec,
41
- projectSpec
42
- } from "./chunk-HF5D6B2U.js";
43
- import {
44
- serveSpec
45
- } from "./chunk-VBVNOLRR.js";
46
- import {
47
- indexSpec,
48
- listSpec,
49
- modelsSpec,
50
- validateSpec
51
- } from "./chunk-7DJQASH3.js";
52
- import {
53
- loginSpec,
54
- logoutSpec,
55
- whoamiSpec
56
- } from "./chunk-QYLOIM4U.js";
57
- import {
58
- hooksSpec,
59
- initSpec,
60
- statusSpec
61
- } from "./chunk-E2E4HIEN.js";
62
-
63
- // src/commands/specs/completion.ts
64
- var completionSpec = {
65
- name: "completion",
66
- examples: [
67
- "pmcp completion bash > ~/.local/share/bash-completion/completions/pmcp",
68
- 'pmcp completion zsh > "${fpath[1]}/_pmcp"'
69
- ],
70
- describe: "Print a shell completion script for bash, zsh or fish",
71
- usage: "pmcp completion bash | zsh | fish"
72
- };
73
-
74
- // src/commands/registry.ts
75
- var COMMANDS = [
76
- {
77
- ...statusSpec,
78
- load: async () => (await import("./status-ZGFOO5YT.js")).statusCommand
79
- },
80
- { ...initSpec, load: async () => (await import("./init-RAAQOP4D.js")).initCommand },
81
- { ...hooksSpec, load: async () => (await import("./hooks-MT3CGRSU.js")).hooksCommand },
82
- { ...serveSpec, load: async () => (await import("./serve-36VOPK47.js")).serveCommand },
83
- { ...listSpec, load: async () => (await import("./list-LV5EKCF6.js")).listCommand },
84
- {
85
- ...indexSpec,
86
- load: async () => (await import("./reindex-D62HQAN2.js")).indexCommand
87
- },
88
- {
89
- ...modelsSpec,
90
- load: async () => (await import("./models-XSF45MCD.js")).modelsCommand
91
- },
92
- {
93
- ...loginSpec,
94
- load: async () => (await import("./session-3YVVO2GR.js")).loginCommand
95
- },
96
- {
97
- ...logoutSpec,
98
- load: async () => (await import("./session-3YVVO2GR.js")).logoutCommand
99
- },
100
- {
101
- ...whoamiSpec,
102
- load: async () => (await import("./session-3YVVO2GR.js")).whoamiCommand
103
- },
104
- {
105
- ...availableSpec,
106
- load: async () => (await import("./available-74CMIBPD.js")).availableCommand
107
- },
108
- {
109
- ...previewSpec,
110
- load: async () => (await import("./preview-465CQJBQ.js")).previewCommand
111
- },
112
- {
113
- ...installSpec,
114
- load: async () => (await import("./install-5JH4DSFF.js")).installCommand
115
- },
116
- { ...syncSpec, load: async () => (await import("./install-5JH4DSFF.js")).syncCommand },
117
- {
118
- ...projectSpec,
119
- load: async () => (await import("./project-5SL2CE5F.js")).projectCommand
120
- },
121
- {
122
- ...doctorSpec,
123
- load: async () => (await import("./doctor-GBIPPKPD.js")).doctorCommand
124
- },
125
- {
126
- ...sessionsSpec,
127
- load: async () => (await import("./cli-ZOY2274X.js")).sessionsCommand
128
- },
129
- { ...logsSpec, load: async () => (await import("./logs-J4W6GFMK.js")).logsCommand },
130
- { ...gitSpec, load: async () => (await import("./cli-RHOETDBX.js")).gitCommand },
131
- {
132
- ...heavySpec,
133
- load: async () => (await import("./heavy-E55QD5LR.js")).heavyCommand
134
- },
135
- { ...hostSpec, load: async () => (await import("./host-FXO4VGE6.js")).hostCommand },
136
- { ...waitSpec, load: async () => (await import("./wait-HEODT7KV.js")).waitCommand },
137
- {
138
- ...ownersSpec,
139
- load: async () => (await import("./owners-MPI22SFU.js")).ownersCommand
140
- },
141
- { ...mcpSpec, load: async () => (await import("./mcp-QARZ7L22.js")).mcpCommand },
142
- {
143
- ...validateSpec,
144
- load: async () => (await import("./validate-YXR7FJJX.js")).validateCommand
145
- },
146
- {
147
- ...mailboxSpec,
148
- load: async () => (await import("./mailbox-ZHZWZMAY.js")).mailboxCommand
149
- },
150
- {
151
- ...harnessSpec,
152
- load: async () => (await import("./harness-HGBKFIUT.js")).harnessCommand
153
- },
154
- { ...tuiSpec, load: async () => (await import("./tui-QB42W3XZ.js")).tuiCommand },
155
- {
156
- ...marketplaceSpec,
157
- load: async () => (await import("./marketplace-2X3OOEPW.js")).marketplaceCommand
158
- },
159
- {
160
- ...completionSpec,
161
- load: async () => (await import("./completion-PE6CHX4K.js")).completionCommand
162
- }
163
- ];
164
- var PLANNED = [];
165
- function commandNamed(name) {
166
- return COMMANDS.find((command) => command.name === name);
167
- }
168
-
169
- export {
170
- completionSpec,
171
- COMMANDS,
172
- PLANNED,
173
- commandNamed
174
- };
175
- //# sourceMappingURL=chunk-PPWEOXIU.js.map
@@ -1,14 +0,0 @@
1
- import {
2
- initSpec
3
- } from "./chunk-E2E4HIEN.js";
4
- import "./chunk-JPYQDOEW.js";
5
-
6
- // src/commands/init.ts
7
- var initCommand = {
8
- ...initSpec,
9
- run: async (context) => (await import("./run-H22CN65S.js")).run(context)
10
- };
11
- export {
12
- initCommand
13
- };
14
- //# sourceMappingURL=init-RAAQOP4D.js.map