@modootoday/pmcp 0.32.0 → 0.34.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 (148) 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-7G6Z6UIH.js} +3 -3
  6. package/dist/{apply-SSYZGDJU.js → apply-D72RERVD.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-2XPZHQKC.js +175 -0
  10. package/dist/{chunk-IAR7BL5R.js → chunk-3VXOYOSB.js} +2 -2
  11. package/dist/{chunk-QZY36KNT.js → chunk-3ZGNO4Y6.js} +2 -2
  12. package/dist/{chunk-C3G75JH7.js → chunk-4B2VDTHL.js} +16 -5
  13. package/dist/{chunk-6H3HN7E7.js → chunk-4DIR63AD.js} +5 -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-OIV44CYB.js → chunk-6AFTQ7J6.js} +3 -3
  18. package/dist/{chunk-OS5CYV27.js → chunk-6BE63FTB.js} +3 -3
  19. package/dist/{chunk-Y2XASHVY.js → chunk-AXNXNFSV.js} +2 -2
  20. package/dist/{chunk-3DRV5KHZ.js → chunk-BA3LAWC5.js} +4 -4
  21. package/dist/{chunk-HF5D6B2U.js → chunk-BN73TTTP.js} +7 -10
  22. package/dist/{chunk-XADROJFL.js → chunk-BVNENZWQ.js} +2 -2
  23. package/dist/{chunk-UT2NACLW.js → chunk-CJL5V5SY.js} +2 -2
  24. package/dist/{chunk-E2E4HIEN.js → chunk-CSZ2HI2R.js} +2 -2
  25. package/dist/{chunk-ITDJ2EXN.js → chunk-DIWQOLPW.js} +2 -2
  26. package/dist/{chunk-MUGHZ6QC.js → chunk-ECWE52ML.js} +2 -2
  27. package/dist/chunk-EWEY3ASH.js +21 -0
  28. package/dist/{chunk-KWCZKCTC.js → chunk-FN7S3SX7.js} +11 -15
  29. package/dist/{chunk-SMHHL25Y.js → chunk-FWAUMXQ3.js} +9 -6
  30. package/dist/{chunk-IFFOJ3IE.js → chunk-GS7KWWRO.js} +2 -2
  31. package/dist/{chunk-7DJQASH3.js → chunk-IH76KECZ.js} +10 -34
  32. package/dist/{chunk-Q6V274OB.js → chunk-JNW2Z36X.js} +2 -2
  33. package/dist/chunk-JOGLKWN7.js +52 -0
  34. package/dist/{chunk-VBVNOLRR.js → chunk-K4ZG3BXL.js} +2 -2
  35. package/dist/{chunk-JZKAJUVT.js → chunk-KESQUAKO.js} +2 -2
  36. package/dist/{chunk-UVTGY2R3.js → chunk-KRDNVEV6.js} +4 -7
  37. package/dist/{chunk-2HL2MFNI.js → chunk-KWSCDIE2.js} +2 -2
  38. package/dist/{chunk-OIYZT4BG.js → chunk-LBPMMSQQ.js} +11 -4
  39. package/dist/chunk-LWQIS2FC.js +7 -0
  40. package/dist/{chunk-QYLOIM4U.js → chunk-MFD2UEJY.js} +6 -8
  41. package/dist/{chunk-JPYQDOEW.js → chunk-MPYM2HYV.js} +7 -9
  42. package/dist/{chunk-YJVSN6UN.js → chunk-NFWN3AMZ.js} +3 -3
  43. package/dist/{chunk-GQRDEIQA.js → chunk-NQBSTHYF.js} +1 -1
  44. package/dist/{chunk-I4U2A6HP.js → chunk-NQVAFHDK.js} +2 -2
  45. package/dist/{chunk-LXWAU7AX.js → chunk-OOH47XJH.js} +6 -6
  46. package/dist/{chunk-FGG7JJ5M.js → chunk-PCSEVF6W.js} +3 -3
  47. package/dist/{chunk-AALSWFPA.js → chunk-PVRTQUZU.js} +7 -7
  48. package/dist/{chunk-ESM7TFTO.js → chunk-PXBG3PWL.js} +2 -2
  49. package/dist/{chunk-V4NPDK6X.js → chunk-QRLTTS5K.js} +1 -1
  50. package/dist/{chunk-4VVQLWTS.js → chunk-SXFW4COX.js} +2 -2
  51. package/dist/{chunk-UKGO2RR7.js → chunk-T3Z4HCOL.js} +2 -2
  52. package/dist/{chunk-WZYGM3FR.js → chunk-TLHWUYTW.js} +5 -5
  53. package/dist/{chunk-D7IDT7OA.js → chunk-UFGGQVB7.js} +5 -5
  54. package/dist/{chunk-OIKT4SYO.js → chunk-UOFHM6OM.js} +2 -2
  55. package/dist/{chunk-NQCAKDRY.js → chunk-UORJZ7TK.js} +3 -3
  56. package/dist/{chunk-A4P3IIPE.js → chunk-VCQQHIH5.js} +5 -5
  57. package/dist/{chunk-VEJU5HXJ.js → chunk-VNHQFQED.js} +3 -3
  58. package/dist/{chunk-FALOBFE6.js → chunk-WGVMNDIL.js} +3 -3
  59. package/dist/{chunk-QRCAGKC6.js → chunk-WWNY53B6.js} +14 -11
  60. package/dist/{chunk-WBPVNCQO.js → chunk-WYK57MIH.js} +6 -6
  61. package/dist/{chunk-TQRLWO4F.js → chunk-XPYY6K5L.js} +2 -2
  62. package/dist/{chunk-FFQA2R5P.js → chunk-XTZTZLRD.js} +6 -13
  63. package/dist/{chunk-PRQICZXO.js → chunk-XXKM57RC.js} +14 -14
  64. package/dist/{chunk-SU6R4VWV.js → chunk-Z4EIDZ4E.js} +3 -3
  65. package/dist/{cli-RHOETDBX.js → cli-AOVS3DLY.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-TJU5Y5V5.js} +18 -18
  69. package/dist/{diagnostics-7Y5OFV44.js → diagnostics-5MRXHPGM.js} +9 -8
  70. package/dist/{doctor-GBIPPKPD.js → doctor-4LDRVDRV.js} +18 -17
  71. package/dist/{doctor-XY6OMK7W.js → doctor-AOTBASUL.js} +19 -15
  72. package/dist/{entry-4WT2WM6C.js → entry-77M53A4M.js} +15 -14
  73. package/dist/{exec-mcp-BLTFBWND.js → exec-mcp-35X37R6L.js} +12 -11
  74. package/dist/{harness-HGBKFIUT.js → harness-NHCCUJCP.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-TVIMQZW2.js} +16 -13
  79. package/dist/{hooks-MT3CGRSU.js → hooks-HWVXTAXT.js} +5 -5
  80. package/dist/{host-AMKVSOYU.js → host-HFBE3VYV.js} +14 -13
  81. package/dist/{host-FXO4VGE6.js → host-KIYJQHMQ.js} +6 -6
  82. package/dist/{host-5AI4JAXD.js → host-ORJHLJIZ.js} +9 -8
  83. package/dist/{host-run-M2KMMU72.js → host-run-42GFROF7.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-H67C4O2W.js} +11 -10
  87. package/dist/index.d.ts +6 -7
  88. package/dist/index.js +18 -17
  89. package/dist/init-J2FE6GTQ.js +14 -0
  90. package/dist/{install-5JH4DSFF.js → install-ITEWB6V3.js} +3 -2
  91. package/dist/{invoke-D2CYSRFG.js → invoke-S6IZRUCO.js} +12 -11
  92. package/dist/{list-LV5EKCF6.js → list-CNLGT6TK.js} +3 -2
  93. package/dist/{list-UG67V5EO.js → list-PEUJYQDQ.js} +13 -12
  94. package/dist/{load-BEUBABtB.d.ts → load-C6Iite0Q.d.ts} +1 -1
  95. package/dist/{logout-Z5KMKTTP.js → logout-JEF4D25W.js} +12 -11
  96. package/dist/{logs-J4W6GFMK.js → logs-G4LAFJ3O.js} +83 -7
  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-5GVIB4O5.js} +7 -7
  101. package/dist/{marketplace-2X3OOEPW.js → marketplace-S3DXRVIR.js} +16 -8
  102. package/dist/{mcp-QARZ7L22.js → mcp-MT3XMFGL.js} +4 -4
  103. package/dist/{measure-K7D3GLC6.js → measure-NZ4BNKK3.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-6T2GG5CT.js} +7 -7
  108. package/dist/{preview-465CQJBQ.js → preview-PPA6UJDD.js} +3 -2
  109. package/dist/{project-5SL2CE5F.js → project-GMUHGTIY.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-EUU6TJBI.js → run-FBPJ234Y.js} +4 -4
  114. package/dist/{run-H22CN65S.js → run-NVQFGBGN.js} +11 -10
  115. package/dist/{serve-36VOPK47.js → serve-KUC235MZ.js} +12 -10
  116. package/dist/{session-3YVVO2GR.js → session-BTN4JXQ4.js} +3 -2
  117. package/dist/{setup-Y5SM4LKI.js → setup-2TDTMJHV.js} +4 -4
  118. package/dist/{smoke-GZECLXOJ.js → smoke-UK42EV7O.js} +3 -3
  119. package/dist/{start-login-3CUVLBDP.js → start-login-4CC753AK.js} +12 -11
  120. package/dist/{status-QFMN7IUG.js → status-GQHMLK4G.js} +5 -5
  121. package/dist/{status-SLQQMCZP.js → status-N4VRXN4H.js} +12 -11
  122. package/dist/{status-ZGFOO5YT.js → status-SGL5NDH2.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-R64EJ7WH.js} +13 -12
  127. package/dist/{tools-gpHNq9Dh.d.ts → tools-Dnu9wAAm.d.ts} +20 -6
  128. package/dist/{tui-QB42W3XZ.js → tui-HBZV5VJ6.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-2MOWPJLI.js} +13 -12
  132. package/docs/commands.md +37 -13
  133. package/docs/compatibility.md +5 -0
  134. package/docs/project-configuration.md +36 -36
  135. package/docs/upgrading.md +29 -0
  136. package/gemini-extension.json +2 -2
  137. package/mcp.json +1 -1
  138. package/package.json +5 -5
  139. package/plugin.json +1 -1
  140. package/plugins/pmcp/.claude-plugin/plugin.json +1 -1
  141. package/plugins/pmcp/.mcp.json +1 -1
  142. package/plugins/pmcp/gemini-extension.json +2 -2
  143. package/plugins/pmcp/mcp.json +1 -1
  144. package/plugins/pmcp/plugin.json +1 -1
  145. package/dist/chunk-BU65MNVU.js +0 -13
  146. package/dist/chunk-KNIHXLDE.js +0 -7
  147. package/dist/chunk-PPWEOXIU.js +0 -175
  148. package/dist/init-RAAQOP4D.js +0 -14
@@ -112,8 +112,22 @@ interface SkillBundle {
112
112
  }
113
113
  declare function bundleSkill(entry: SkillEntry): SkillBundle;
114
114
 
115
+ declare const RUNTIME_IDS: readonly ["claude", "codex", "gemini", "antigravity", "grok", "opencode"];
116
+ type RuntimeId = (typeof RUNTIME_IDS)[number];
117
+ declare const PRODUCT_NAMES: readonly ["claude-code", "codex-cli", "gemini-cli", "grok-cli", "antigravity"];
118
+ type ProductName = (typeof PRODUCT_NAMES)[number];
119
+ declare const EXECUTABLES: {
120
+ readonly claude: "claude";
121
+ readonly codex: "codex";
122
+ readonly gemini: "gemini";
123
+ readonly antigravity: "agy";
124
+ readonly grok: "grok";
125
+ readonly opencode: "opencode";
126
+ };
127
+ type Executable = (typeof EXECUTABLES)[RuntimeId];
128
+
115
129
  declare const RUNTIMES: readonly ["claude-code", "codex-cli", "gemini-cli", "grok-cli", "antigravity"];
116
- type Runtime = (typeof RUNTIMES)[number];
130
+ type Runtime = ProductName;
117
131
  declare function verifiedRuntimesOf(metadata: Readonly<Record<string, MetadataValue>> | undefined): Runtime[];
118
132
  declare function runtimeOfClient(name: string | undefined): Runtime | null;
119
133
  interface ClientSource {
@@ -167,11 +181,11 @@ declare const catalogItemSchema: z.ZodObject<{
167
181
  mcp: "mcp";
168
182
  }>>;
169
183
  verifiedRuntimes: z.ZodOptional<z.ZodArray<z.ZodEnum<{
184
+ antigravity: "antigravity";
170
185
  "claude-code": "claude-code";
171
186
  "codex-cli": "codex-cli";
172
187
  "gemini-cli": "gemini-cli";
173
188
  "grok-cli": "grok-cli";
174
- antigravity: "antigravity";
175
189
  }>>>;
176
190
  verified: z.ZodOptional<z.ZodBoolean>;
177
191
  }, z.core.$loose>;
@@ -193,11 +207,11 @@ declare const catalogResponseSchema: z.ZodObject<{
193
207
  mcp: "mcp";
194
208
  }>>;
195
209
  verifiedRuntimes: z.ZodOptional<z.ZodArray<z.ZodEnum<{
210
+ antigravity: "antigravity";
196
211
  "claude-code": "claude-code";
197
212
  "codex-cli": "codex-cli";
198
213
  "gemini-cli": "gemini-cli";
199
214
  "grok-cli": "grok-cli";
200
- antigravity: "antigravity";
201
215
  }>>>;
202
216
  verified: z.ZodOptional<z.ZodBoolean>;
203
217
  }, z.core.$loose>>;
@@ -209,11 +223,11 @@ declare const findResultSchema: z.ZodObject<{
209
223
  lexical: "lexical";
210
224
  }>;
211
225
  runtime: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
226
+ antigravity: "antigravity";
212
227
  "claude-code": "claude-code";
213
228
  "codex-cli": "codex-cli";
214
229
  "gemini-cli": "gemini-cli";
215
230
  "grok-cli": "grok-cli";
216
- antigravity: "antigravity";
217
231
  }>>>;
218
232
  matches: z.ZodArray<z.ZodObject<{
219
233
  name: z.ZodString;
@@ -221,11 +235,11 @@ declare const findResultSchema: z.ZodObject<{
221
235
  description: z.ZodString;
222
236
  score: z.ZodNumber;
223
237
  verifiedRuntimes: z.ZodOptional<z.ZodArray<z.ZodEnum<{
238
+ antigravity: "antigravity";
224
239
  "claude-code": "claude-code";
225
240
  "codex-cli": "codex-cli";
226
241
  "gemini-cli": "gemini-cli";
227
242
  "grok-cli": "grok-cli";
228
- antigravity: "antigravity";
229
243
  }>>>;
230
244
  verified: z.ZodOptional<z.ZodBoolean>;
231
245
  }, z.core.$loose>>;
@@ -325,4 +339,4 @@ declare function createSkillTools(options: SkillServerOptions): {
325
339
  skills: () => readonly SkillEntry[];
326
340
  };
327
341
 
328
- export { normaliseIntent as $, ASSET_KINDS as A, type BundleFile as B, type CatalogOptions as C, DEFAULT_FIND_LIMIT as D, type Embedder as E, type FileKind as F, bundleResponseSchema as G, bundleSkill as H, type IntentCache as I, catalogResponseSchema as J, type KindFilter as K, classify as L, type MetadataValue as M, NAME_MAX as N, cosine as O, createSkillTools as P, describeResponseSchema as Q, type Runtime as R, type SkillServerOptions as S, detectRuntime as T, find as U, findResultSchema as V, isUtf8Text as W, kindOf as X, lexicalScore as Y, listSkillFiles as Z, mimeOf as _, type SkillEntry as a, frontmatterObject as a0, readSkillFile as a1, runtimeOfClient as a2, specProblems as a3, type Ranking as b, type SkillTools as c, type AssetKind as d, COMPATIBILITY_MAX as e, type CallResponse as f, type CatalogItem as g, type CatalogResponse as h, type Classified as i, DESCRIPTION_MAX as j, type FindOptions as k, type FindResult as l, type IntentCacheStats as m, MAX_SKILL_DEPTH as n, type Match as o, type MetadataLeaf as p, READ_BUDGET_BYTES as q, RUNTIMES as r, type ReadResult as s, SKIPPED_DIRS as t, type SkillBundle as u, verifiedRuntimesOf as v, type SkillFile as w, type SkillFileContent as x, type SkillFileListing as y, type SkillFilters as z };
342
+ export { mimeOf as $, ASSET_KINDS as A, type BundleFile as B, type CatalogOptions as C, DEFAULT_FIND_LIMIT as D, type Embedder as E, type FileKind as F, type SkillFilters as G, bundleResponseSchema as H, type IntentCache as I, bundleSkill as J, type KindFilter as K, catalogResponseSchema as L, type MetadataValue as M, NAME_MAX as N, classify as O, cosine as P, createSkillTools as Q, type Runtime as R, type SkillServerOptions as S, describeResponseSchema as T, detectRuntime as U, find as V, findResultSchema as W, isUtf8Text as X, kindOf as Y, lexicalScore as Z, listSkillFiles as _, type SkillEntry as a, normaliseIntent as a0, frontmatterObject as a1, readSkillFile as a2, runtimeOfClient as a3, specProblems as a4, type Ranking as b, type Executable as c, type SkillTools as d, type AssetKind as e, COMPATIBILITY_MAX as f, type CallResponse as g, type CatalogItem as h, type CatalogResponse as i, type Classified as j, DESCRIPTION_MAX as k, type FindOptions as l, type FindResult as m, type IntentCacheStats as n, MAX_SKILL_DEPTH as o, type Match as p, type MetadataLeaf as q, READ_BUDGET_BYTES as r, RUNTIMES as s, type ReadResult as t, SKIPPED_DIRS as u, verifiedRuntimesOf as v, type SkillBundle as w, type SkillFile as x, type SkillFileContent as y, type SkillFileListing as z };
@@ -140,23 +140,23 @@ var tuiCommand = {
140
140
  try {
141
141
  let receipt;
142
142
  if (invocation.action === "doctor") {
143
- const { inspectTerminalHost } = await import("./diagnostics-7Y5OFV44.js");
143
+ const { inspectTerminalHost } = await import("./diagnostics-5MRXHPGM.js");
144
144
  receipt = inspectTerminalHost();
145
145
  } else if (invocation.action === "start-worker") {
146
- const { startWorkspaceWorker } = await import("./worker-VPP2HD6O.js");
146
+ const { startWorkspaceWorker } = await import("./worker-2MOWPJLI.js");
147
147
  receipt = await startWorkspaceWorker(
148
148
  { config: invocation.startup?.config, cwd: context.cwd },
149
149
  invocation.startup.runtime,
150
150
  invocation.startup?.memoryMb
151
151
  );
152
152
  } else if (invocation.action === "recovery") {
153
- const { inspectStartupRecovery } = await import("./recovery-HB2YFQSQ.js");
153
+ const { inspectStartupRecovery } = await import("./recovery-7ATXH6W5.js");
154
154
  receipt = inspectStartupRecovery({
155
155
  ...invocation.startup,
156
156
  cwd: context.cwd
157
157
  });
158
158
  } else {
159
- const { launchStartup, planStartup } = await import("./entry-4WT2WM6C.js");
159
+ const { launchStartup, planStartup } = await import("./entry-77M53A4M.js");
160
160
  const request = { ...invocation.startup, cwd: context.cwd };
161
161
  receipt = invocation.action === "plan" ? planStartup(request) : await launchStartup(
162
162
  request,
@@ -176,4 +176,4 @@ var tuiCommand = {
176
176
  export {
177
177
  tuiCommand
178
178
  };
179
- //# sourceMappingURL=tui-QB42W3XZ.js.map
179
+ //# sourceMappingURL=tui-HBZV5VJ6.js.map
@@ -1,9 +1,9 @@
1
1
  import {
2
2
  change
3
- } from "./chunk-YJVSN6UN.js";
4
- import "./chunk-65BW7Y6O.js";
5
- import "./chunk-OIKT4SYO.js";
6
- import "./chunk-NQCAKDRY.js";
3
+ } from "./chunk-NFWN3AMZ.js";
4
+ import "./chunk-4F4CMDKZ.js";
5
+ import "./chunk-UOFHM6OM.js";
6
+ import "./chunk-UORJZ7TK.js";
7
7
  import "./chunk-PAY6HEEY.js";
8
8
  import "./chunk-Z6WRFOFT.js";
9
9
  import "./chunk-Y6NFETNG.js";
@@ -18,4 +18,4 @@ var run = (context) => change(context, "unbroadcast");
18
18
  export {
19
19
  run
20
20
  };
21
- //# sourceMappingURL=unbroadcast-GRGX3F6T.js.map
21
+ //# sourceMappingURL=unbroadcast-YWUKATJK.js.map
@@ -7,17 +7,19 @@ import {
7
7
  import {
8
8
  validateCatalog,
9
9
  validateSkillDir
10
- } from "./chunk-YOWIYFIV.js";
10
+ } from "./chunk-4U4GLMZ6.js";
11
11
  import "./chunk-73AKO4UL.js";
12
12
  import {
13
13
  validateSpec
14
- } from "./chunk-7DJQASH3.js";
14
+ } from "./chunk-IH76KECZ.js";
15
15
  import "./chunk-5NDUWEMW.js";
16
+ import "./chunk-MPYM2HYV.js";
16
17
  import "./chunk-Y6NFETNG.js";
17
18
  import "./chunk-4CRRLDDS.js";
18
19
  import "./chunk-YSAWTGNA.js";
19
20
  import "./chunk-GJXOFDJT.js";
20
21
  import "./chunk-PMJG2CXF.js";
22
+ import "./chunk-JOGLKWN7.js";
21
23
 
22
24
  // src/commands/validate.ts
23
25
  var validateCommand = {
@@ -45,4 +47,4 @@ var validateCommand = {
45
47
  export {
46
48
  validateCommand
47
49
  };
48
- //# sourceMappingURL=validate-YXR7FJJX.js.map
50
+ //# sourceMappingURL=validate-MIVCL2ZK.js.map
@@ -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-PVRTQUZU.js";
9
9
  import "./chunk-DZ2MRTYT.js";
10
- import "./chunk-FFQA2R5P.js";
11
- import "./chunk-MUGHZ6QC.js";
10
+ import "./chunk-XTZTZLRD.js";
11
+ import "./chunk-ECWE52ML.js";
12
12
  import {
13
13
  locateExecutable
14
14
  } from "./chunk-R2GPCZUX.js";
15
- import "./chunk-FGG7JJ5M.js";
15
+ import "./chunk-PCSEVF6W.js";
16
16
  import "./chunk-34DECPVC.js";
17
- import "./chunk-PRQICZXO.js";
18
- import "./chunk-QZY36KNT.js";
17
+ import "./chunk-XXKM57RC.js";
18
+ import "./chunk-3ZGNO4Y6.js";
19
19
  import "./chunk-N7ANFMA5.js";
20
20
  import "./chunk-TYY5TYHF.js";
21
- import "./chunk-ESM7TFTO.js";
21
+ import "./chunk-PXBG3PWL.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-LWQIS2FC.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-2MOWPJLI.js.map
package/docs/commands.md CHANGED
@@ -73,18 +73,41 @@ Every command that prints a result takes `--json` and then writes exactly one li
73
73
 
74
74
  No colour or human text is mixed into standard output; the same errors also go to standard error. Without `--json` every command prints human output (`mcp status` and the `tui` receipts included). `mailbox` and `harness` are machine protocols: they always print their own JSON receipts (`{ok, data}` and `{schemaVersion, ok, ...}`), take no `--json`, and are unchanged. `logs` without `--json` keeps its JSONL stream.
75
75
 
76
- The `data` of these commands has a published schema in [schemas.json](https://pmcp.build/commands/schemas.json), with `version: 1` inside `data`; each entry under `schemas` uses the shared root `$defs`, and `envelope` describes the wrapper. Consumers must allow unknown fields inside session, decision and log records. Tokens are never part of an auth status object.
77
-
78
- | Command | Schema | Fields after version |
79
- | -------------------------- | ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
80
- | `status --json` | status | config, drift, features, projection, sessions, worktrees, mcp, errors |
81
- | `hooks list --json` | hooks-list | policies: runtime, event, policy, mode, source |
82
- | `hooks test --json` | hooks-test | runtime, event, payload, decision, policies, rendered |
83
- | `sessions status --json` | sessions-status | live, pause, leases, broadcasts with unseenBy session IDs |
84
- | `logs --json` | logs | records; filtered snapshot, incompatible with --follow and --pretty |
85
- | `git worktree list --json` | git-worktree-list | worktrees: path, main, optional alias, branch, behind and ahead |
86
- | `mcp status <name> --json` | mcp-status | name, present, expiresAt (UTC string or null), scopes |
87
- | `heavy status --json` | heavy-status | schema `pmcp.heavy.status.v1`, enabled, dir, budget, running_weight, legacy_holder, host, lanes with running jobs, waiters, tickets, grace_24h, outside, skip |
76
+ The `data` of these commands has a published schema in [schemas.json](https://pmcp.build/commands/schemas.json), with `version: 1` inside `data`; each entry under `schemas` uses the shared root `$defs`, and `envelope` describes the wrapper. Consumers must allow unknown fields inside session, decision and log records and mailbox messages. Tokens are never part of an auth status object.
77
+
78
+ | Command | Schema | Fields after version |
79
+ | ------------------------------ | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
80
+ | `status --json` | status | config, drift, features, projection, sessions, worktrees, mcp, errors |
81
+ | `hooks list --json` | hooks-list | policies: runtime, event, policy, mode, source |
82
+ | `hooks test --json` | hooks-test | runtime, event, payload, decision, policies, rendered |
83
+ | `sessions status --json` | sessions-status | live, pause, leases, broadcasts with unseenBy session IDs |
84
+ | `logs --json` | logs | records; filtered snapshot, incompatible with --follow and --pretty |
85
+ | `git worktree list --json` | git-worktree-list | worktrees: path, main, optional alias, branch, behind and ahead |
86
+ | `mcp status <name> --json` | mcp-status | name, present, expiresAt (UTC string or null), scopes |
87
+ | `heavy status --json` | heavy-status | schema `pmcp.heavy.status.v1`, enabled, dir, budget, running_weight, legacy_holder, host, lanes with running jobs, waiters, tickets, grace_24h, outside, skip |
88
+ | `heavy queue --json` | heavy-queue | schema `pmcp.heavy.queue.v1`, waiters (as in heavy-status) |
89
+ | `heavy stats --json` | heavy-stats | an array, no version: signature, samples, failed, timeouts, skipped, p50 and p90 of wall_s, user_s, sys_s, max_rss_kb, read_bytes, write_bytes |
90
+ | `hooks report --json` | hooks-report | lines, sessions, excluded, guards (calls, raw and verdict counts, modes, durationMs); with `--switch-check`, guard and refused |
91
+ | `whoami --json` | whoami | no version: signedIn, and when signed in issuer, optional scope and expiresInMinutes |
92
+ | `validate --json` | validate | no version: findings with path, reason and level |
93
+ | `models --json` | models | an array, no version: name, modelId, dtype, dtypes, dimensions, revision, encoder |
94
+ | `marketplace list --json` | marketplace-list | no version: marketplace, plugins with name, version and description |
95
+ | `marketplace export --json` | marketplace-export | no version: plugin, runtime, output, files |
96
+ | `owners --json` | owners | paths: path, owners with owner, optional note and mode |
97
+ | `doctor --json` | doctor | no version: findings with tool, check, status and optional detail; in a project with hooks, features with a cell per runtime |
98
+ | `sessions inbox --json` | sessions-inbox | an array, no version: messages with id, from, to, body, createdAt, expiresAt, once and acked |
99
+ | `heavy result <ticket> --json` | heavy-result | id, state, label, pid, position, result (null until done; exit, outcome and the run's usage) |
100
+ | `list --json` | list | no version: skills with name, package, slug, description, path and optional tier, metadata, keywords, kind and root; rejected with path and reason |
101
+ | `available --json` | available | no version: catalogRevision, matches with targetName, targetVersion, verified and the catalog entry; issues with name and reason |
102
+ | `preview <package> --json` | preview | no version: productId, title, summary, package, evidence, targets and optional line and preview |
103
+ | `git affected --json` | git-affected | schema `pmcp.git.affected.v1`, no version: testsOnly, all, optional reason, base and head, changed, members, unmapped, optional rootDependencies and workspaceMembers, selected (a list or `ALL`) |
104
+ | `git deliver --json` | git-deliver | no version: ok, code, delivered, upstream, attempts, replayed, gate (exit, log, logs, by) or null, leases, sync and desk_sync (from, to, code) or null, optional reason |
105
+ | `host io measure --json` | host-io-measure | version 1, device, measured_at, pmcp, dir, seconds, size_mb, model (six io.cost fields), probes, live_model and live_qos lines or null |
106
+ | `host io plan --json` | host-io-plan | version 1, devices with model_line and qos_line, unit (path, text), apply |
107
+ | `host io doctor --json` | host-io-doctor | version 1, record, live_model and live_qos (device and fields) or null, findings (level, device, message), weights with `--weights` |
108
+ | `tui doctor --json` | tui-doctor | schemaVersion 1: ok, platform, the tool paths or null, supported, userManagerAvailable, runtimes, remediation, nextCommands; or the tui failure shape (ok false, error, hint) |
109
+ | `tui plan --json` | tui-plan | schemaVersion 1: ok, settings, savedWorkspace or null, willStartRuntime, runtimeExecutable or null; or the tui failure shape |
110
+ | `tui recovery --json` | tui-recovery | schemaVersion 1: ok, checkpoint, projectRoot, status, hint, commands and optional phase, groupFile, generation; or the tui failure shape |
88
111
 
89
112
  Feature rows have feature, enabled and source. Projection has drift, outputs and problems. Session snapshots include only live records; broadcasts include the IDs that have not yet seen each entry. Worktree counts are omitted when the upstream cannot be compared; absence does not assert equality. Status auth rows add a redacted error when credentials are unavailable or invalid. Errors are JSONL records with valid timestamps within the last hour, excluding future rows. Hooks test observations have policy, mode, decision, durationMs, skipped, source, verdict and reason; rendered has stdout and exitCode. The final decision includes runtime lowering, while each policy row retains its configured verdict. Heavy status jobs have pid, label, cwd, lane, weight, session, started, running_s, flags (grace, bypass, over_hold_warn, over_hold_max) and bypass_reason; waiters have pid, label, cwd, lane, weight, session, position, waited_s and eta_s (a rough estimate or null). It only reads: no record is pruned and nothing is written. Mutating sessions, git and MCP verbs reject `--json`.
90
113
 
@@ -193,10 +216,11 @@ Coordinate the live agent sessions of this repository and its worktrees, through
193
216
  pmcp logs --since 10m --level warn --pretty
194
217
  pmcp logs --session 4f92 --component hooks
195
218
  pmcp logs --trace 7cef825e8fbd8c3f
219
+ pmcp logs --component lease --since 2h --level warn
196
220
  pmcp logs --follow
197
221
  ```
198
222
 
199
- Read this project's JSONL logs from the state directory, or the file `[hooks] error_log` names. Filters combine: `--session` takes an id prefix, `--trace` one hook call, `--component` a component and those below it, `--level` that level and more severe, `--since` a duration (`10m`, `2h`, `3d`) or an ISO time. Records print as JSON lines unless `--pretty`; `--follow` keeps printing until interrupted. Secret values, prompt text and environment values are redacted at write time, per [`[logging]`](project-configuration.md#logging). Exit 0, or 2 for an unusable filter or no `pmcp.toml`.
223
+ Read this project's JSONL logs from the state directory, or the file `[hooks] error_log` names. Filters combine: `--session` takes an id prefix, `--trace` one hook call, `--component` a component and those below it, `--level` that level and more severe, `--since` a duration (`10m`, `2h`, `3d`) or an ISO time. Records print as JSON lines unless `--pretty`; `--follow` keeps printing until interrupted. Secret values, prompt text and environment values are redacted at write time, per [`[logging]`](project-configuration.md#logging). `--component lease` adds the host lease's records, read from its directory rather than this project's logs: each `heavy.log` event (acquired, released, skip, grace, timeout and the rest; refusals and timeouts at `warn`) and, as `lease.usage`, each finished run from `usage.jsonl`; `--follow` does not include them. Exit 0, or 2 for an unusable filter or no `pmcp.toml`.
200
224
 
201
225
  ## git
202
226
 
@@ -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,35 @@ 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.33 to 0.34
19
+
20
+ **`pmcp heavy queue --json` names its own schema.** Its data was labelled
21
+ `pmcp.heavy.status.v1`, the name `pmcp heavy status --json` uses, although it carries only
22
+ `version`, `schema` and `waiters`. It now says `pmcp.heavy.queue.v1`. A client that branches on
23
+ the schema name and read the queue as a status snapshot should branch on the new name; the
24
+ fields are unchanged.
25
+
26
+ **Every `--json` command with a stable shape has a published schema.**
27
+ `docs/commands/schemas.json` now describes, and the test suite checks against real output,
28
+ the data of the commands listed in [Commands](commands.md). Three schemas gained fields the
29
+ commands already printed: `restart` and `wake` in sessions, `lagging` and `budget` in status,
30
+ and `raw` in a hooks test policy row. No output changed for them.
31
+
32
+ **`pmcp logs --component lease`** also reads the host lease's own records. A plain
33
+ `pmcp logs` is unchanged.
34
+
35
+ ## From 0.32 to 0.33
36
+
37
+ **A long wait also reaches grace sooner.** A waiter that has waited `age_limit` seconds now
38
+ counts as past its profile's `load_grace` when that is longer, so it may start into moderate
39
+ overload (below `hard_factor` times `max_load` and `max_io`) while no leased job runs. A
40
+ profile with `load_grace = 0` still has no grace.
41
+
42
+ **Runtime names: any spelling where you type one.** `[[host.sessions]] runtime`, `[tui] runtime`,
43
+ `pmcp tui --runtime`, `pmcp marketplace export --runtime` and a skill's `verified-runtimes`
44
+ accept every spelling of a runtime (`agy` or `antigravity`, `claude` or `claude-code`). What
45
+ pmcp writes is unchanged.
46
+
18
47
  ## From 0.31 to 0.32
19
48
 
20
49
  **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.34.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.34.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.34.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.34.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.34.0",
140
+ "@modootoday/pmcp-linux-arm64": "0.34.0",
141
+ "@modootoday/pmcp-darwin-x64": "0.34.0",
142
+ "@modootoday/pmcp-darwin-arm64": "0.34.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.34.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.34.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.34.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.34.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.34.0", "serve"]
9
9
  }
10
10
  }
11
11
  }