@modootoday/pmcp 0.24.1 → 0.25.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 (93) 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-CDJQJAZH.js → apply-6XLLYLJT.js} +9 -8
  6. package/dist/{broadcast-VKZY7WSD.js → broadcast-34CEG2NQ.js} +5 -2
  7. package/dist/{chunk-264DIB5U.js → chunk-2TXVOHRS.js} +3 -3
  8. package/dist/{chunk-X3RUXLAV.js → chunk-3P6Y2BAO.js} +3 -3
  9. package/dist/{chunk-7CGGDX7X.js → chunk-5MUD7FHP.js} +2 -2
  10. package/dist/{chunk-2GZKA33O.js → chunk-A4P3IIPE.js} +2 -2
  11. package/dist/{chunk-GEDRPMBH.js → chunk-BG6TONJO.js} +2 -2
  12. package/dist/{chunk-HES44LTA.js → chunk-C3KRMTIZ.js} +28 -4
  13. package/dist/{chunk-QY2P54Z2.js → chunk-DITIXBFB.js} +61 -8
  14. package/dist/{chunk-LNKAR3IS.js → chunk-DWHM5BAY.js} +2 -2
  15. package/dist/{chunk-VBWB2T3C.js → chunk-EC5QLEZD.js} +2 -2
  16. package/dist/{chunk-MZ52S4YJ.js → chunk-ISWR2XIU.js} +2 -2
  17. package/dist/{chunk-D4FIBB2G.js → chunk-LZVHFPN6.js} +5 -5
  18. package/dist/{chunk-3SEJNT6F.js → chunk-MBHI2TKQ.js} +4 -4
  19. package/dist/{chunk-43MXRTKH.js → chunk-NAHAESFV.js} +9 -4
  20. package/dist/chunk-NQCAKDRY.js +156 -0
  21. package/dist/chunk-OIKT4SYO.js +42 -0
  22. package/dist/{chunk-3O3JZTUU.js → chunk-PECS47OL.js} +3 -3
  23. package/dist/{chunk-AQM2JZMB.js → chunk-PGZZI42O.js} +2 -2
  24. package/dist/{chunk-5NQZGNKT.js → chunk-QYHM6554.js} +2 -2
  25. package/dist/{chunk-DLIO2D7S.js → chunk-RF6RDJYH.js} +16 -16
  26. package/dist/chunk-SMBU3QLE.js +7 -0
  27. package/dist/{chunk-V5PXMLLL.js → chunk-SRSKCFFS.js} +3 -3
  28. package/dist/{chunk-DGXZBQCA.js → chunk-SSQ6EWNA.js} +5 -5
  29. package/dist/{chunk-MOKZPZZO.js → chunk-TJW4DP26.js} +2 -2
  30. package/dist/{chunk-2ZH77O2D.js → chunk-TOR6SKRB.js} +141 -58
  31. package/dist/{chunk-PG62GOPU.js → chunk-UQHJUTDW.js} +2 -2
  32. package/dist/{cli-GFDT4YXM.js → cli-5G2OYTIL.js} +9 -9
  33. package/dist/{cli-OV5LSSGE.js → cli-QDQYUHAP.js} +4 -4
  34. package/dist/cli.js +38 -5
  35. package/dist/{completion-QNDCU4MF.js → completion-3GVNPLZY.js} +4 -4
  36. package/dist/{diagnostics-TPK3VC5F.js → diagnostics-2W7QDQNG.js} +6 -6
  37. package/dist/{doctor-K2LADSW2.js → doctor-3TDO5LJ5.js} +11 -10
  38. package/dist/{entry-HFQHKL5L.js → entry-E62DZQJF.js} +10 -10
  39. package/dist/{exec-mcp-I2YGGWY4.js → exec-mcp-4N7FLY52.js} +7 -6
  40. package/dist/{harness-BMWGAXCF.js → harness-E2AUZDLV.js} +3 -3
  41. package/dist/harness-launch-gate.js +4 -4
  42. package/dist/harness-worker.js +6 -6
  43. package/dist/{heavy-G6CYQQ7O.js → heavy-HZQVFI6P.js} +150 -36
  44. package/dist/hook-body.js +116 -45
  45. package/dist/{hooks-R7AYQXHY.js → hooks-VAEAK2FY.js} +4 -4
  46. package/dist/{host-PLE2T55E.js → host-4GJDGTLW.js} +7 -7
  47. package/dist/{host-EUD6GLWV.js → host-I2EMQ7UE.js} +12 -59
  48. package/dist/{host-run-QFNGIDL5.js → host-run-DDMKD3BU.js} +5 -5
  49. package/dist/http.js +1 -1
  50. package/dist/{import-mcp-DVKJOEOE.js → import-mcp-TNSAMJXI.js} +6 -5
  51. package/dist/index.d.ts +1 -1
  52. package/dist/index.js +10 -9
  53. package/dist/{init-DKWNL62M.js → init-UA7MDNTZ.js} +2 -2
  54. package/dist/{invoke-U6JTPTXT.js → invoke-HW7NBPGP.js} +8 -8
  55. package/dist/{list-YKQFJN3G.js → list-A7VQJXE5.js} +8 -7
  56. package/dist/{logout-5YSKC46N.js → logout-HNPLUKJY.js} +7 -6
  57. package/dist/{mailbox-5FVFMQ2J.js → mailbox-MR6TPD3P.js} +20 -6
  58. package/dist/{mainline-D3PSR6AJ.js → mainline-MSLW3UFD.js} +8 -2
  59. package/dist/{mcp-CHKKXHBB.js → mcp-6C23GX2E.js} +2 -2
  60. package/dist/{pause-CMZOIHTJ.js → pause-H6ZYZF7C.js} +5 -2
  61. package/dist/{project-QEYXISHC.js → project-BX6NCGKB.js} +4 -4
  62. package/dist/{report-UB7MXAUB.js → report-43SFNNCF.js} +2 -2
  63. package/dist/{resume-PAKIT4TT.js → resume-2BWGSTCN.js} +5 -2
  64. package/dist/{run-HKMYYEZJ.js → run-2UVAWBAF.js} +6 -5
  65. package/dist/{run-FYKDIW4C.js → run-7TRWZFEZ.js} +4 -4
  66. package/dist/{serve-QZNG5UUV.js → serve-4XZ5SKJJ.js} +3 -3
  67. package/dist/{start-login-4GPM32RA.js → start-login-AR7ITWNV.js} +7 -6
  68. package/dist/{status-4PYPTYUB.js → status-2GDYLIR3.js} +6 -3
  69. package/dist/{status-55CD352M.js → status-VQCMJFVE.js} +25 -22
  70. package/dist/{status-W6SCF2GF.js → status-ZY6LDQSF.js} +7 -6
  71. package/dist/stdio.js +2 -2
  72. package/dist/{sweep-VURZU6DI.js → sweep-76BUOGEI.js} +5 -2
  73. package/dist/{test-XYEMYZ2P.js → test-VWGNFSH5.js} +9 -7
  74. package/dist/{tui-FXSWN2PV.js → tui-TUMOQBE7.js} +4 -4
  75. package/dist/{unbroadcast-7AMLURCG.js → unbroadcast-HJHYUHZL.js} +5 -2
  76. package/dist/{worker-Q4I4EIAJ.js → worker-NEEPJRVV.js} +8 -8
  77. package/dist/{worktree-list-2HV6ODBS.js → worktree-list-WZC75NLF.js} +8 -9
  78. package/docs/commands.md +8 -6
  79. package/docs/glossary.md +1 -1
  80. package/docs/hooks.md +20 -16
  81. package/docs/project-configuration.md +73 -36
  82. package/docs/sessions.md +9 -2
  83. package/docs/upgrading.md +58 -0
  84. package/gemini-extension.json +2 -2
  85. package/mcp.json +1 -1
  86. package/package.json +5 -5
  87. package/plugin.json +1 -1
  88. package/plugins/pmcp/.claude-plugin/plugin.json +1 -1
  89. package/plugins/pmcp/.mcp.json +1 -1
  90. package/plugins/pmcp/gemini-extension.json +2 -2
  91. package/plugins/pmcp/mcp.json +1 -1
  92. package/plugins/pmcp/plugin.json +1 -1
  93. package/dist/chunk-65H4PN33.js +0 -7
@@ -7,18 +7,18 @@ import {
7
7
  } from "./chunk-MHKY6TNF.js";
8
8
  import {
9
9
  policyRows
10
- } from "./chunk-VBWB2T3C.js";
10
+ } from "./chunk-EC5QLEZD.js";
11
11
  import "./chunk-7TD53M7L.js";
12
12
  import {
13
13
  configFrom
14
14
  } from "./chunk-7CHUMF3E.js";
15
15
  import {
16
16
  checkProject
17
- } from "./chunk-V5PXMLLL.js";
17
+ } from "./chunk-SRSKCFFS.js";
18
18
  import {
19
19
  checkBudget,
20
20
  readSpec
21
- } from "./chunk-2ZH77O2D.js";
21
+ } from "./chunk-TOR6SKRB.js";
22
22
  import "./chunk-VYQJPT27.js";
23
23
  import "./chunk-UKR64U7J.js";
24
24
  import {
@@ -26,6 +26,7 @@ import {
26
26
  } from "./chunk-2GD7PQ7J.js";
27
27
  import "./chunk-EATCUWGG.js";
28
28
  import "./chunk-OFJIMBTL.js";
29
+ import "./chunk-NQCAKDRY.js";
29
30
  import "./chunk-LFFIQBNY.js";
30
31
  import "./chunk-HQOB7OQS.js";
31
32
  import "./chunk-73AKO4UL.js";
@@ -55,8 +56,8 @@ import {
55
56
  EXIT,
56
57
  noConfig
57
58
  } from "./chunk-Y6NFETNG.js";
58
- import "./chunk-264DIB5U.js";
59
- import "./chunk-QY2P54Z2.js";
59
+ import "./chunk-2TXVOHRS.js";
60
+ import "./chunk-DITIXBFB.js";
60
61
  import "./chunk-N7ANFMA5.js";
61
62
  import "./chunk-TYY5TYHF.js";
62
63
  import "./chunk-T6C3TSTO.js";
@@ -67,7 +68,7 @@ import {
67
68
  worktreesOf
68
69
  } from "./chunk-IJBSOWHK.js";
69
70
  import "./chunk-XWLMZKH2.js";
70
- import "./chunk-65H4PN33.js";
71
+ import "./chunk-SMBU3QLE.js";
71
72
  import "./chunk-GJXOFDJT.js";
72
73
  import "./chunk-PMJG2CXF.js";
73
74
  import "./chunk-J6KL3COD.js";
@@ -219,11 +220,15 @@ async function readStatus(config, env) {
219
220
  const leases = Object.keys(sessions.leases ?? {});
220
221
  const worktrees = desks(config);
221
222
  const budget = spec.budget ? checkBudget(spec, spec.budget) : null;
222
- const drift = checked.code !== 0 || (budget?.problems.length ?? 0) > 0 || worktrees.some((row) => (row.behind ?? 0) > 0 || (row.ahead ?? 0) > 0);
223
+ const drift = checked.code !== 0 || (budget?.problems.length ?? 0) > 0;
224
+ const lagging = worktrees.filter(
225
+ (row) => (row.behind ?? 0) > 0 || (row.ahead ?? 0) > 0
226
+ ).length;
223
227
  return {
224
228
  version: 1,
225
229
  config: config.path,
226
230
  drift,
231
+ lagging,
227
232
  features: features(config, spec),
228
233
  projection: {
229
234
  drift: checked.code !== 0,
@@ -241,16 +246,16 @@ async function readStatus(config, env) {
241
246
 
242
247
  // src/status/render.ts
243
248
  function renderStatus(context, report) {
244
- context.ui.results.line("pmcp status: " + report.config);
249
+ const lines = ["pmcp status: " + report.config];
245
250
  const enabled = report.features.filter((row) => row.enabled);
246
- context.ui.results.line(
251
+ lines.push(
247
252
  "Features: " + (enabled.map((row) => row.feature + " [" + row.source + "]").join(", ") || "none")
248
253
  );
249
- context.ui.results.line(
254
+ lines.push(
250
255
  "Projection: " + (report.projection.drift ? report.projection.problems.length + " drift(s)" : "matches") + " (" + report.projection.outputs + " outputs)"
251
256
  );
252
257
  for (const problem of report.projection.problems.slice(0, 3))
253
- context.ui.results.line(" " + problem);
258
+ lines.push(" " + problem);
254
259
  if (report.budget) {
255
260
  const worst = /* @__PURE__ */ new Map();
256
261
  for (const row of report.budget.rows) {
@@ -258,26 +263,24 @@ function renderStatus(context, report) {
258
263
  if (!seen || row.value - row.limit > seen.value - seen.limit)
259
264
  worst.set(row.key, row);
260
265
  }
261
- context.ui.results.line(
266
+ lines.push(
262
267
  "Budget: " + (report.budget.problems.length ? report.budget.problems.length + " over" : "within") + ([...worst.values()].map((row) => `; ${row.key} ${row.subject} ${row.value}/${row.limit}`).join("") || "")
263
268
  );
264
269
  for (const problem of report.budget.problems.slice(0, 3))
265
- context.ui.results.line(" " + problem);
270
+ lines.push(" " + problem);
266
271
  }
267
272
  const state = report.sessions;
268
- context.ui.results.line(
273
+ lines.push(
269
274
  "Sessions: " + state.live.length + " live; pause " + (state.pause?.reason ?? "none") + "; " + state.leases.length + " lease(s); " + state.broadcasts.filter((row) => row.unseenBy.length > 0).length + " unseen broadcast(s)"
270
275
  );
271
- const drifted = report.worktrees.filter(
272
- (row) => (row.behind ?? 0) > 0 || (row.ahead ?? 0) > 0
273
- );
274
- context.ui.results.line(
275
- "Linked worktrees: " + report.worktrees.length + "; " + drifted.length + " ahead/behind"
276
+ lines.push(
277
+ "Linked worktrees: " + report.worktrees.length + "; " + report.lagging + " ahead/behind"
276
278
  );
277
- context.ui.results.line(
279
+ lines.push(
278
280
  "MCP auth: " + (report.mcp.map((row) => row.name + "=" + (row.present ? "present" : "absent")).join(", ") || "no pmcp-auth servers")
279
281
  );
280
- context.ui.results.line("Errors (last hour): " + report.errors.length);
282
+ lines.push("Errors (last hour): " + report.errors.length);
283
+ context.ui.results.records(lines);
281
284
  }
282
285
 
283
286
  // src/status/run.ts
@@ -301,4 +304,4 @@ var statusCommand = {
301
304
  export {
302
305
  statusCommand
303
306
  };
304
- //# sourceMappingURL=status-55CD352M.js.map
307
+ //# sourceMappingURL=status-VQCMJFVE.js.map
@@ -1,16 +1,17 @@
1
1
  import {
2
2
  serverFrom
3
- } from "./chunk-MOKZPZZO.js";
3
+ } from "./chunk-TJW4DP26.js";
4
4
  import {
5
5
  status
6
6
  } from "./chunk-UPQTAHUK.js";
7
7
  import "./chunk-7CHUMF3E.js";
8
- import "./chunk-2ZH77O2D.js";
8
+ import "./chunk-TOR6SKRB.js";
9
9
  import "./chunk-VYQJPT27.js";
10
10
  import "./chunk-UKR64U7J.js";
11
11
  import "./chunk-2GD7PQ7J.js";
12
12
  import "./chunk-EATCUWGG.js";
13
13
  import "./chunk-OFJIMBTL.js";
14
+ import "./chunk-NQCAKDRY.js";
14
15
  import "./chunk-LFFIQBNY.js";
15
16
  import "./chunk-HQOB7OQS.js";
16
17
  import "./chunk-73AKO4UL.js";
@@ -24,8 +25,8 @@ import "./chunk-Q5H3L6Y4.js";
24
25
  import "./chunk-ARXCYFFZ.js";
25
26
  import "./chunk-V4NPDK6X.js";
26
27
  import "./chunk-Y6NFETNG.js";
27
- import "./chunk-264DIB5U.js";
28
- import "./chunk-QY2P54Z2.js";
28
+ import "./chunk-2TXVOHRS.js";
29
+ import "./chunk-DITIXBFB.js";
29
30
  import "./chunk-N7ANFMA5.js";
30
31
  import "./chunk-TYY5TYHF.js";
31
32
  import "./chunk-T6C3TSTO.js";
@@ -33,7 +34,7 @@ import "./chunk-FQLCD4HU.js";
33
34
  import "./chunk-GUHOEIHP.js";
34
35
  import "./chunk-IJBSOWHK.js";
35
36
  import "./chunk-XWLMZKH2.js";
36
- import "./chunk-65H4PN33.js";
37
+ import "./chunk-SMBU3QLE.js";
37
38
  import "./chunk-GJXOFDJT.js";
38
39
  import "./chunk-PMJG2CXF.js";
39
40
  import "./chunk-J6KL3COD.js";
@@ -56,4 +57,4 @@ function run(context) {
56
57
  export {
57
58
  run
58
59
  };
59
- //# sourceMappingURL=status-W6SCF2GF.js.map
60
+ //# sourceMappingURL=status-ZY6LDQSF.js.map
package/dist/stdio.js CHANGED
@@ -4,8 +4,8 @@ import {
4
4
  resolveRoots,
5
5
  serve,
6
6
  serveWithMailbox
7
- } from "./chunk-PG62GOPU.js";
8
- import "./chunk-7CGGDX7X.js";
7
+ } from "./chunk-UQHJUTDW.js";
8
+ import "./chunk-5MUD7FHP.js";
9
9
  import "./chunk-6WXMJOMI.js";
10
10
  import "./chunk-4CRRLDDS.js";
11
11
  import "./chunk-YSAWTGNA.js";
@@ -1,6 +1,9 @@
1
1
  import {
2
2
  change
3
- } from "./chunk-HES44LTA.js";
3
+ } from "./chunk-C3KRMTIZ.js";
4
+ import "./chunk-65BW7Y6O.js";
5
+ import "./chunk-OIKT4SYO.js";
6
+ import "./chunk-NQCAKDRY.js";
4
7
  import "./chunk-3V37OZQH.js";
5
8
  import "./chunk-Z6WRFOFT.js";
6
9
  import "./chunk-Y6NFETNG.js";
@@ -15,4 +18,4 @@ var run = (context) => change(context, "sweep");
15
18
  export {
16
19
  run
17
20
  };
18
- //# sourceMappingURL=sweep-VURZU6DI.js.map
21
+ //# sourceMappingURL=sweep-76BUOGEI.js.map
@@ -1,6 +1,6 @@
1
1
  import {
2
2
  specFrom
3
- } from "./chunk-GEDRPMBH.js";
3
+ } from "./chunk-BG6TONJO.js";
4
4
  import {
5
5
  sourceFor
6
6
  } from "./chunk-7TD53M7L.js";
@@ -12,12 +12,13 @@ import {
12
12
  customMode,
13
13
  customPolicy,
14
14
  readScript
15
- } from "./chunk-2ZH77O2D.js";
15
+ } from "./chunk-TOR6SKRB.js";
16
16
  import "./chunk-VYQJPT27.js";
17
17
  import "./chunk-UKR64U7J.js";
18
18
  import "./chunk-2GD7PQ7J.js";
19
19
  import "./chunk-EATCUWGG.js";
20
20
  import "./chunk-OFJIMBTL.js";
21
+ import "./chunk-NQCAKDRY.js";
21
22
  import "./chunk-LFFIQBNY.js";
22
23
  import {
23
24
  DEFAULT_LOG_SETTINGS,
@@ -53,8 +54,8 @@ import {
53
54
  ArgumentError,
54
55
  one
55
56
  } from "./chunk-Y6NFETNG.js";
56
- import "./chunk-264DIB5U.js";
57
- import "./chunk-QY2P54Z2.js";
57
+ import "./chunk-2TXVOHRS.js";
58
+ import "./chunk-DITIXBFB.js";
58
59
  import "./chunk-N7ANFMA5.js";
59
60
  import "./chunk-TYY5TYHF.js";
60
61
  import "./chunk-T6C3TSTO.js";
@@ -67,7 +68,7 @@ import {
67
68
  worktreesOf
68
69
  } from "./chunk-IJBSOWHK.js";
69
70
  import "./chunk-XWLMZKH2.js";
70
- import "./chunk-65H4PN33.js";
71
+ import "./chunk-SMBU3QLE.js";
71
72
  import "./chunk-GJXOFDJT.js";
72
73
  import "./chunk-PMJG2CXF.js";
73
74
  import "./chunk-J6KL3COD.js";
@@ -314,7 +315,8 @@ async function runPolicy(selected, input, deps) {
314
315
  }
315
316
  }
316
317
  const decision = applyMode(policy.id, raw, mode);
317
- log.debug("policy", {
318
+ const letThrough = (raw.verdict ?? "allow") !== "allow" && decision.verdict !== "deny" && decision.verdict !== raw.verdict;
319
+ log[letThrough ? "info" : "debug"]("policy", {
318
320
  raw: raw.verdict ?? "allow",
319
321
  mode,
320
322
  verdict: decision.verdict ?? "allow",
@@ -627,4 +629,4 @@ async function run(context) {
627
629
  export {
628
630
  run
629
631
  };
630
- //# sourceMappingURL=test-XYEMYZ2P.js.map
632
+ //# sourceMappingURL=test-VWGNFSH5.js.map
@@ -140,10 +140,10 @@ var tuiCommand = {
140
140
  try {
141
141
  let receipt;
142
142
  if (invocation.action === "doctor") {
143
- const { inspectTerminalHost } = await import("./diagnostics-TPK3VC5F.js");
143
+ const { inspectTerminalHost } = await import("./diagnostics-2W7QDQNG.js");
144
144
  receipt = inspectTerminalHost();
145
145
  } else if (invocation.action === "start-worker") {
146
- const { startWorkspaceWorker } = await import("./worker-Q4I4EIAJ.js");
146
+ const { startWorkspaceWorker } = await import("./worker-NEEPJRVV.js");
147
147
  receipt = await startWorkspaceWorker(
148
148
  { config: invocation.startup?.config, cwd: context.cwd },
149
149
  invocation.startup.runtime,
@@ -156,7 +156,7 @@ var tuiCommand = {
156
156
  cwd: context.cwd
157
157
  });
158
158
  } else {
159
- const { launchStartup, planStartup } = await import("./entry-HFQHKL5L.js");
159
+ const { launchStartup, planStartup } = await import("./entry-E62DZQJF.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-FXSWN2PV.js.map
179
+ //# sourceMappingURL=tui-TUMOQBE7.js.map
@@ -1,6 +1,9 @@
1
1
  import {
2
2
  change
3
- } from "./chunk-HES44LTA.js";
3
+ } from "./chunk-C3KRMTIZ.js";
4
+ import "./chunk-65BW7Y6O.js";
5
+ import "./chunk-OIKT4SYO.js";
6
+ import "./chunk-NQCAKDRY.js";
4
7
  import "./chunk-3V37OZQH.js";
5
8
  import "./chunk-Z6WRFOFT.js";
6
9
  import "./chunk-Y6NFETNG.js";
@@ -15,4 +18,4 @@ var run = (context) => change(context, "unbroadcast");
15
18
  export {
16
19
  run
17
20
  };
18
- //# sourceMappingURL=unbroadcast-7AMLURCG.js.map
21
+ //# sourceMappingURL=unbroadcast-HJHYUHZL.js.map
@@ -5,17 +5,17 @@ import {
5
5
  } from "./chunk-C3G75JH7.js";
6
6
  import {
7
7
  invoke
8
- } from "./chunk-D4FIBB2G.js";
8
+ } from "./chunk-LZVHFPN6.js";
9
9
  import "./chunk-DZ2MRTYT.js";
10
- import "./chunk-X3RUXLAV.js";
11
- import "./chunk-MZ52S4YJ.js";
10
+ import "./chunk-3P6Y2BAO.js";
11
+ import "./chunk-ISWR2XIU.js";
12
12
  import {
13
13
  locateExecutable
14
14
  } from "./chunk-R2GPCZUX.js";
15
- import "./chunk-LNKAR3IS.js";
15
+ import "./chunk-DWHM5BAY.js";
16
16
  import "./chunk-34DECPVC.js";
17
- import "./chunk-264DIB5U.js";
18
- import "./chunk-QY2P54Z2.js";
17
+ import "./chunk-2TXVOHRS.js";
18
+ import "./chunk-DITIXBFB.js";
19
19
  import "./chunk-N7ANFMA5.js";
20
20
  import "./chunk-TYY5TYHF.js";
21
21
  import "./chunk-T6C3TSTO.js";
@@ -23,7 +23,7 @@ import "./chunk-FQLCD4HU.js";
23
23
  import "./chunk-GUHOEIHP.js";
24
24
  import "./chunk-IJBSOWHK.js";
25
25
  import "./chunk-XWLMZKH2.js";
26
- import "./chunk-65H4PN33.js";
26
+ import "./chunk-SMBU3QLE.js";
27
27
  import "./chunk-GJXOFDJT.js";
28
28
  import "./chunk-PMJG2CXF.js";
29
29
  import {
@@ -83,4 +83,4 @@ async function startWorkspaceWorker(request, runtime, memoryMb) {
83
83
  export {
84
84
  startWorkspaceWorker
85
85
  };
86
- //# sourceMappingURL=worker-Q4I4EIAJ.js.map
86
+ //# sourceMappingURL=worker-NEEPJRVV.js.map
@@ -35,17 +35,16 @@ var worktreeList = (setup, context) => {
35
35
  context.ui.data(JSON.stringify({ version: 1, worktrees: rows }) + "\n");
36
36
  return 0;
37
37
  }
38
- for (const row of rows) {
39
- const name = row.main ? "(main)" : row.alias ?? "-";
40
- const counts = row.behind === void 0 ? "-" : `-${row.behind}/+${row.ahead}`;
41
- context.ui.data(
42
- `${name} ${row.branch ?? "(detached)"} ${counts} ${row.path}
43
- `
44
- );
45
- }
38
+ context.ui.results.records(
39
+ rows.map((row) => {
40
+ const name = row.main ? "(main)" : row.alias ?? "-";
41
+ const counts = row.behind === void 0 ? "-" : `-${row.behind}/+${row.ahead}`;
42
+ return `${name} ${row.branch ?? "(detached)"} ${counts} ${row.path}`;
43
+ })
44
+ );
46
45
  return 0;
47
46
  };
48
47
  export {
49
48
  worktreeList
50
49
  };
51
- //# sourceMappingURL=worktree-list-2HV6ODBS.js.map
50
+ //# sourceMappingURL=worktree-list-WZC75NLF.js.map
package/docs/commands.md CHANGED
@@ -22,7 +22,7 @@ An unrecognised command does not fall through to a server the caller did not ask
22
22
  pmcp status [--config <file>] [--json]
23
23
  ```
24
24
 
25
- Show enabled features and their TOML or auto source, projection drift, live sessions, pause, leases, unseen broadcasts, worktree ahead/behind counts, shared MCP credential presence, logged errors from the last hour, and, with a [`[budget]`](project-configuration.md#budget) table, each limit beside what it measured. Reads do not acknowledge broadcasts, refresh credentials, prune logs, fetch or move git refs. Projection uses the same check as `project --check`. Exit 0, or 4 when projection or worktree ahead/behind drift exists or a budget limit is exceeded; 2 when there is no `pmcp.toml`. Missing or invalid input follows the normal usage/failure exit contract. Human output is a compact summary on stdout; JSON retains the full details.
25
+ Show enabled features and their TOML or auto source, projection drift, live sessions, pause, leases, unseen broadcasts, worktree ahead/behind counts, shared MCP credential presence, logged errors from the last hour, and, with a [`[budget]`](project-configuration.md#budget) table, each limit beside what it measured. Reads do not acknowledge broadcasts, refresh credentials, prune logs, fetch or move git refs. Projection uses the same check as `project --check`. Exit 0, or 4 when projection drift exists or a budget limit is exceeded; 2 when there is no `pmcp.toml`. Linked worktrees ahead of or behind the mainline are live state in a multi-session workspace: the summary and `data.lagging` count them, and they never change the exit code. Missing or invalid input follows the normal usage/failure exit contract. Human output is a compact summary on stdout; JSON retains the full details.
26
26
 
27
27
  ## init
28
28
 
@@ -185,7 +185,7 @@ pmcp sessions send --to <selector>... [--subject <s>] [--wake] <body>
185
185
  pmcp sessions inbox
186
186
  ```
187
187
 
188
- Coordinate the live agent sessions of this repository and its worktrees, through the state the hooks keep for [`[sessions]`](project-configuration.md#sessions). `status` (the default verb) prints each live session, the pause, current broadcasts, held leases and undelivered edits in a shared checkout to standard output, or `no live sessions`. `pause` refuses edits and mutating commands in every other session until `resume`; `broadcast` delivers its text once to each session as context, and `unbroadcast` withdraws it. `--by` names the sender, whose own session is exempt; it defaults to `operator`. `sweep` removes records whose process is gone. `send` addresses `all`, `session:<id>`, `alias:<name>`, `role:<name>` or `worktree:<path>` through `[sessions.mailbox]`; `inbox` lists your messages. [Run several agents](sessions.md) walks through them. Exit 0, or 2 for an unknown verb, missing text or no `pmcp.toml`.
188
+ Coordinate the live agent sessions of this repository and its worktrees, through the state the hooks keep for [`[sessions]`](project-configuration.md#sessions). `status` (the default verb) prints each live session, the pause, current broadcasts, held leases and undelivered edits in a shared checkout to standard output, or `no live sessions`. `pause` refuses edits and mutating commands in every other session until `resume`; `broadcast` delivers its text once to each session as context, and `unbroadcast` withdraws it. `--by` names the sender, whose own session is exempt; without it the sender is the agent session the command runs in, or `operator` from the operator's terminal (`--by operator` is refused anywhere else). `pause` and `resume` are operator verbs: inside an agent session they exit 1 with a line naming who to ask (see [the operator](project-configuration.md#the-operator)). `sweep` removes records whose process is gone. `send` addresses `all`, `session:<id>`, `alias:<name>`, `role:<name>` or `worktree:<path>` through `[sessions.mailbox]`; `inbox` lists your messages. [Run several agents](sessions.md) walks through them. Exit 0, or 2 for an unknown verb, missing text or no `pmcp.toml`.
189
189
 
190
190
  ## logs
191
191
 
@@ -214,7 +214,7 @@ The git workflow configured by [`[git]`](git-workflow.md). Each subcommand needs
214
214
  - `worktree create <alias>` makes a linked worktree under `[git.worktrees] root` on a new branch from the upstream (or `--base`), links the configured files from the main checkout, runs `bootstrap`, and prints the path.
215
215
  - `worktree list` prints alias, branch, behind/ahead and path for the main checkout and each linked worktree.
216
216
  - `worktree sync` moves the current worktree onto the mainline when that loses nothing; exit 1 when it is held back.
217
- - `deliver` fetches, replays the named commits (default: the ones the upstream lacks) onto the mainline, runs the gate in its own tree under a lock, and pushes; it replays again if the mainline moved. A delivery that touches a leased path holds that lease until it has pushed and installed, and it refuses during a pause unless `--during-pause` or `during_pause = "allow"`. `--no-push` replays and runs the gate command, then stops: it takes no lease and pushes, syncs and notifies nothing, and it refuses `gate = "pre-push"`, where the push is the gate. Deliver never takes the [host lease](project-configuration.md#host-lease): replay, gate tree, hooks and push run without it, and the gate wraps only its test stages in `pmcp heavy --profile gate`. Exit 0 delivered, gated with `--no-push`, or nothing to deliver; 1 refused, fetch failed, gate failed or attempts exhausted; 2 `--no-push` with the pre-push gate; 75 the gate command exited 75 because a test stage never got the host lease ("gate not run: host busy"), so nothing was pushed.
217
+ - `deliver` fetches, replays the named commits (default: the ones the upstream lacks) onto the mainline, runs the gate in its own tree under a lock, and pushes; it replays again if the mainline moved. A delivery that touches a leased path holds that lease until it has pushed and installed, and it refuses during a pause unless `--during-pause` (an operator verb, refused inside an agent session) or `during_pause = "allow"`. `--no-push` replays and runs the gate command, then stops: it takes no lease and pushes, syncs and notifies nothing, and it refuses `gate = "pre-push"`, where the push is the gate. Deliver never takes the [host lease](project-configuration.md#host-lease): replay, gate tree, hooks and push run without it, and the gate wraps only its test stages in `pmcp heavy --profile gate`. Exit 0 delivered, gated with `--no-push`, or nothing to deliver; 1 refused, fetch failed, gate failed or attempts exhausted; 2 `--no-push` with the pre-push gate; 75 the gate command exited 75 because a test stage never got the host lease ("gate not run: host busy"), so nothing was pushed.
218
218
  - `sync` moves the main checkout to the mainline, installs when a listed file changed, and follows clean submodule pins. Exit 0 moved or already equal, 1 when local work would be lost or the fetch failed, 2 when blocked (undelivered edits, another branch, a git operation in progress). Run in a desk (a linked worktree matching `[git.worktrees] desks`), it brings the desk up to date the same way without rebasing: exit 0 moved or current, 1 held (an unlanded commit, uncommitted tracked edits, a pause, another session's lease, a git operation in progress), with the reason. In any other linked worktree it exits 2.
219
219
  - `affected --base <ref>` prints the workspace members the delta from `<ref>` to `--head` (default `HEAD`) touches, with their consumers when [`[git.affected]`](git-workflow.md#affected-members) `consumers` is on (`--tests-only` leaves them out), or `ALL`; unmapped files are named on stderr. It reads git objects at `--head` (each submodule at its pin), never the working tree. It needs only `[git.affected]`, not an enabled workflow. Exit 0 with an answer, `ALL` included when the base does not resolve, equals the head or a manifest does not parse; 2 for a missing `--base` or an invalid table. `--json` prints the [envelope](#json-output) `pmcp.git.affected.v1`, whose `data` has `all`, `reason`, `base`, `head`, `changed`, `members`, `unmapped` and `selected` (the printed list, or `"ALL"`).
220
220
 
@@ -227,7 +227,7 @@ pmcp heavy --profile gate --weight 2 -- npm run typecheck
227
227
  pmcp heavy --profile hook -- npm run lint:staged
228
228
  pmcp heavy --now --reason "prod is down" -- npm run deploy
229
229
  pmcp heavy status [--json]
230
- pmcp heavy stats [--json]
230
+ pmcp heavy stats [--top <n>] [--json]
231
231
  ticket=$(pmcp heavy submit --lane bulk -- npm run build:all)
232
232
  pmcp heavy result "$ticket"
233
233
  pmcp heavy wait "$ticket" --timeout 1800
@@ -238,7 +238,7 @@ pmcp heavy priority <id> gate --reason "blocks a land"
238
238
  pmcp heavy priority <id> +2 --reason "the session waits on it"
239
239
  ```
240
240
 
241
- Run a heavy command within the host-wide budget of [`[host.lease]`](project-configuration.md#host-lease), across every session and worktree on the host. A job starts once its lane has a free slot, its weight fits what the running jobs leave of the budget, and the host is under `max_load` and `max_io` (or, past `load_grace` and with nothing leased running, under `hard_factor` times them). Waiting jobs start by lane (gate, hook, interactive, bulk), oldest first within a lane, with a line on standard error every `heartbeat`; `--lane` and `--weight` override the profile and `[host.lease] commands`. The command runs with the lease marker set, so a nested `pmcp heavy` runs at once. Everything after `--` is the command, options included. `status` prints the lock, the host readings, when the host was last settled, the holder record, each waiter with its lane, weight, position and a rough wait estimate from the log's run times, the lanes' use and the running weight against the budget, each running job against `hold_warn` and `hold_max`, the IO average the check reads, how many jobs started on `load_grace` in the last day, and the busiest processes outside the lease. With the lease disabled (`enabled = false`), the command runs at once. With `PMCP_HEAVY_DISABLE=<reason>` set, an ordinary command runs at once and its usage record keeps the reason, but a bulk job (`--lane bulk`, or a `commands` entry with `lane = "bulk"`) still queues in the bulk lane, with a line saying the skip was not honoured, unless `[host.lease] skip_always` lists the reason. `--now --reason <text>` (or `PMCP_HEAVY_NOW=<reason>`) is the emergency bypass: it runs at once, logged and shown in status, and still counts its weight. Where the io controller reaches the user's scopes, each job runs in its own scope with its lane's `io.weight`. `submit` queues the command and returns a ticket at once, so the caller keeps working: a detached runner (its own session, so it outlives the caller) waits and runs it under the same rules, its output in the ticket's log and its exit code and usage record in the ticket's result. `result <ticket>` reads the state (queued with its position, running, done, or lost when the runner died), `--json` as data; `wait <ticket>` blocks until it is done, prints the log's tail and exits with the job's code (75 at `--timeout`); `cancel <ticket>` stops a queued job and, with `--force`, a running one. Tickets live under `<dir>/tickets/` and finished ones are removed after a week. Every waiting or running job has an id (a ticket's, or one made for a blocking run), shown by `status` and `queue`: `queue` lists the waiters with id, lane, position, waited and estimated time, weight, pid, session and label; `promote <id> --now --reason` starts a waiter at once as a bypass; `priority <id> <lane|+N|-N> --reason` moves it to another lane's end or N places within its lane; `cancel <id>` takes a waiter out of the queue (its run exits 130) and, with `--force`, stops a running job. The waiting process reads the change on its next poll; each change is made under the admission lock and logged as a `control` line with the uid, the session and the reason, and a waiter whose process died is removed instead of changed. `stats` lists each command signature's recorded runs with the median and 90th percentile of wall time, CPU time, peak RSS and IO and how many skipped the lease, after one line with the share of all runs that skipped it, `--json` as data. Exit: the command's own code; 75 when nothing ran within `max_wait`, with the reason (the queue, the session's cap, a shell wrapper's hold, a host past `hard_factor`); 2 for a missing `--`, an unknown profile or lane, a bad weight, or `--now` without a reason.
241
+ Run a heavy command within the host-wide budget of [`[host.lease]`](project-configuration.md#host-lease), across every session and worktree on the host. A job starts once its lane has a free slot, its weight fits what the running jobs leave of the budget, and the host is under `max_load` and `max_io` (or, past `load_grace` and with nothing leased running, under `hard_factor` times them). Waiting jobs start by lane (gate, hook, interactive, bulk), oldest first within a lane, with a line on standard error every `heartbeat`; `--lane` and `--weight` override the profile and `[host.lease] commands`. The command runs with the lease marker set, so a nested `pmcp heavy` runs at once. Everything after `--` is the command, options included. `status` prints the lock, the host readings, when the host was last settled, the holder record, each waiter with its lane, weight, position and a rough wait estimate from the log's run times, the lanes' use and the running weight against the budget, each running job against `hold_warn` and `hold_max`, the IO average the check reads, how many jobs started on `load_grace` in the last day, and the busiest processes outside the lease. With the lease disabled (`enabled = false`), the command runs at once. With `PMCP_HEAVY_DISABLE=<reason>` set to an allowed reason (`nested` inside a leased job, `operator` for the operator, or one listed in `[host.lease] skip_reasons` or `skip_always`), an ordinary command runs at once and its usage record keeps the reason; any other reason runs nothing and exits 2 with the allowed list, but a bulk job (`--lane bulk`, or a `commands` entry with `lane = "bulk"`) still queues in the bulk lane, with a line saying the skip was not honoured, unless `[host.lease] skip_always` lists the reason. `--now --reason <text>` (or `PMCP_HEAVY_NOW=<reason>`) is the operator's emergency bypass: it runs at once, logged and shown in status, and still counts its weight; from an agent session it exits 1 and names who to ask, as `promote --now` and `cancel --force` on another session's job do. Where the io controller reaches the user's scopes, each job runs in its own scope with its lane's `io.weight`. `submit` queues the command and returns a ticket at once, so the caller keeps working: a detached runner (its own session, so it outlives the caller) waits and runs it under the same rules, its output in the ticket's log and its exit code and usage record in the ticket's result. `result <ticket>` reads the state (queued with its position, running, done, or lost when the runner died), `--json` as data; `wait <ticket>` blocks until it is done, prints the log's tail and exits with the job's code (75 at `--timeout`); `cancel <ticket>` stops a queued job and, with `--force`, a running one. Tickets live under `<dir>/tickets/` and finished ones are removed after a week. Every waiting or running job has an id (a ticket's, or one made for a blocking run), shown by `status` and `queue`: `queue` lists the waiters with id, lane, position, waited and estimated time, weight, pid, session and label; `promote <id> --now --reason` starts a waiter at once as a bypass; `priority <id> <lane|+N|-N> --reason` moves it to another lane's end or N places within its lane; `cancel <id>` takes a waiter out of the queue (its run exits 130) and, with `--force`, stops a running job. The waiting process reads the change on its next poll; each change is made under the admission lock and logged as a `control` line with the uid, the session and the reason, and a waiter whose process died is removed instead of changed. `stats` lists each command signature's recorded runs with the median and 90th percentile of wall time, CPU time, peak RSS and IO and how many skipped the lease, after a line with the share of all runs that skipped it and lines counting the skip reasons and the refused ones, the most-run first; `--top <n>` keeps the first n, `--json` as data. Exit: the command's own code; 75 when nothing ran within `max_wait`, with the reason (the queue, the session's cap, a shell wrapper's hold, a host past `hard_factor`); 2 for a missing `--`, an unknown profile or lane, a bad weight, `--now` without a reason, or a skip reason that is not allowed; 1 for an operator verb outside the operator's terminal.
242
242
 
243
243
  ## wait
244
244
 
@@ -374,7 +374,9 @@ Both show the project and lockfile changes and stop: `--yes` (`-y`) approves the
374
374
 
375
375
  With `TERM=dumb`, or a locale that is not UTF-8, the few typographic characters in messages (an em dash, a middle dot) print as ASCII. Long operations such as `index` report progress on standard error: one rewritten line on a terminal, a plain `k/N` line every tenth of the work otherwise.
376
376
 
377
- Help and tables fit the terminal: `COLUMNS` when set, else the terminal width, kept between 40 and 120 columns; long descriptions wrap under their column, and a name too wide for its column puts its description on the next lines. Off a terminal, help wraps at 80 columns and a table prints one plain record per line (`name description`, no padding), so `grep` and `cut` see whole records.
377
+ Help and tables fit the terminal: `COLUMNS` when set, else the terminal width, kept between 40 and 120 columns; long descriptions wrap under their column, and a name too wide for its column puts its description on the next lines. Status records (`status`, `sessions status`, `heavy status`, `queue` and `stats`, `git worktree list`) fit the same width on a terminal: a long record wraps under a hanging indent, and a word wider than the line is cut with an ellipsis. Off a terminal, help wraps at 80 columns and a table or status listing prints one plain record per line (`name description`, no padding), so `grep` and `cut` see whole records.
378
+
379
+ A reader that closes the pipe early, as `pmcp list | head -1` or `pmcp heavy stats | head` does, ends the command quietly with exit 0 instead of a write error.
378
380
 
379
381
  Options are parsed against the command's own list, so an unknown flag is an error rather than a silently ignored typo. Giving a non-repeatable option twice, or leaving off a value it needs, is the same error.
380
382
 
package/docs/glossary.md CHANGED
@@ -22,7 +22,7 @@ The words pmcp's documentation and messages use, each with the page that owns it
22
22
  | broadcast | Text every running session receives once, as context. |
23
23
  | sessions mailbox | Addressed messages between the sessions of one repository, `pmcp sessions send`. [Run several agents](sessions.md) |
24
24
  | local mailbox | Messages between actors that hold their own credentials, `pmcp mailbox`, across projects and hosts. [Local mailbox](mailbox.md) |
25
- | `operator` | A name, not a role: the default sender of `pmcp sessions pause`, `broadcast` and `send` (`--by`), and a mailbox actor you may register. The docs call the person "you". |
25
+ | `operator` | You, recognised by `[sessions.operator]`: your own terminal, or a token file agents cannot read. Only the operator runs the operator verbs or signs as `operator` (`--by`). The docs say "you". |
26
26
  | runtime id | How each table names a native runtime; the ids differ between tables. [Compatibility](compatibility.md#native-runtimes) |
27
27
  | main and worker | In a terminal workspace or harness group, the session you mainly talk to and the ones it delegates to. [Terminal workspace](terminal-workspace.md) |
28
28
  | harness group | The sessions one pmcp-pty daemon hosts for `pmcp tui` or `pmcp harness`, with a budget and a generation that changes when the group is replaced. [Native terminal control](terminal-harness.md) |
package/docs/hooks.md CHANGED
@@ -70,21 +70,25 @@ nothing, no verdict and no context, even when the guard fails; use it to run a g
70
70
  beside a hook it will replace and compare. Every guard writes one debug log line per
71
71
  call: `policy`, `session`, `verdict` (what the call got) and, under `data`, `raw`
72
72
  (what the guard found: `allow`, `ask` or `deny`), `mode`, `tool` (the tool kind) and
73
- `native` (the runtime's tool name), never the command, the reason or the prompt.
74
-
75
- | Table | Default mode | Modes | Refuses |
76
- | ------------------------------------------ | ------------ | ------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
77
- | `[hooks.guards.shell.in_place_edit]` | deny | deny, ask, warn, observe, off | `sed -i`, `perl -i`, `awk -i inplace`: edits without a diff. |
78
- | `[hooks.guards.shell.heredoc]` | deny | deny, ask, warn, observe, off | Heredocs and here-strings, whose body the shell expands silently. |
79
- | `[hooks.guards.shell.stdin_interpreter]` | ask | deny, ask, warn, observe, off | An interpreter reading its program from stdin (`python3 -`, `cat x.py \| python3`). |
80
- | `[hooks.guards.shell.compose_teardown]` | deny | deny, ask, warn, observe, off | `docker compose down`, and `stop`, `rm` or `kill` with no service named: they hit every service. |
81
- | `[hooks.guards.shell.secret_exfiltration]` | graded | deny, ask, warn, observe, off, graded | Reading a credential asks; sending one over the network, or changing a live one, denies. |
82
- | `[hooks.guards.shell.host_approval]` | deny | deny, ask, warn, observe, off | `host approve`, and commands or edits touching the host approvals directory. On by itself when `[host]` is declared. |
83
- | `[hooks.guards.shell.runaway_regex]` | deny | deny, ask, warn, observe, off | A grep pattern that can hold a core for minutes: a repetition count over the threshold (`\{0,2500\}`, `{0,2500}` with `-E` or `-P`), or a `-P` group quantified inside a quantifier such as `(a+)+`. ripgrep (`rg`) matches in linear time and is never refused. |
84
- | `[hooks.guards.git.push_without_verify]` | deny | deny, ask, warn, observe, off | `git push --no-verify`. |
85
- | `[hooks.guards.git.forced_branch_move]` | deny | deny, ask, warn, observe, off | Forcing a branch that is checked out in another working tree. |
86
- | `[hooks.guards.git.gate_bypass_env]` | deny | deny, ask, warn, observe, off | Setting a named gate-bypass variable where it takes effect, and optionally `--no-verify` on any git command. |
87
- | `[hooks.guards.git.stage_all]` | deny | deny, ask, warn, observe, off | `git add -A`, `git add .`, `git commit -a` and similar; stage explicit paths. |
73
+ `native` (the runtime's tool name), never the command, the reason or the prompt. A call
74
+ an `observe` or `warn` guard found something in but let through is written at info
75
+ instead, so `pmcp hooks report --switch-check <guard>` counts a week of observe at the
76
+ default log level.
77
+
78
+ | Table | Default mode | Modes | Refuses |
79
+ | ------------------------------------------ | ------------ | ------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
80
+ | `[hooks.guards.shell.in_place_edit]` | deny | deny, ask, warn, observe, off | `sed -i`, `perl -i`, `awk -i inplace`: edits without a diff. |
81
+ | `[hooks.guards.shell.heredoc]` | deny | deny, ask, warn, observe, off | Heredocs and here-strings, whose body the shell expands silently. |
82
+ | `[hooks.guards.shell.stdin_interpreter]` | ask | deny, ask, warn, observe, off | An interpreter reading its program from stdin (`python3 -`, `cat x.py \| python3`). |
83
+ | `[hooks.guards.shell.compose_teardown]` | deny | deny, ask, warn, observe, off | `docker compose down`, and `stop`, `rm` or `kill` with no service named: they hit every service. |
84
+ | `[hooks.guards.shell.secret_exfiltration]` | graded | deny, ask, warn, observe, off, graded | Reading a credential asks; sending one over the network, or changing a live one, denies. |
85
+ | `[hooks.guards.shell.host_approval]` | deny | deny, ask, warn, observe, off | `host approve`, and commands or edits touching the host approvals directory. On by itself when `[host]` is declared. |
86
+ | `[hooks.guards.shell.runaway_regex]` | deny | deny, ask, warn, observe, off | A grep pattern that can hold a core for minutes: a repetition count over the threshold (`\{0,2500\}`, `{0,2500}` with `-E` or `-P`), or a `-P` group quantified inside a quantifier such as `(a+)+`. ripgrep (`rg`) matches in linear time and is never refused. |
87
+ | `[hooks.guards.git.push_without_verify]` | deny | deny, ask, warn, observe, off | `git push --no-verify`. |
88
+ | `[hooks.guards.git.forced_branch_move]` | deny | deny, ask, warn, observe, off | Forcing a branch that is checked out in another working tree. |
89
+ | `[hooks.guards.git.gate_bypass_env]` | deny | deny, ask, warn, observe, off | Setting a named gate-bypass variable where it takes effect, and optionally `--no-verify` on any git command. |
90
+ | `[hooks.guards.git.stage_all]` | deny | deny, ask, warn, observe, off | `git add -A`, `git add .`, `git commit -a` and similar; stage explicit paths. |
91
+ | `[hooks.guards.pmcp.operator_verbs]` | deny | deny, ask, warn, observe, off | The operator verbs: `pmcp sessions pause` and `resume`, `pmcp heavy --now` and `promote --now`, `pmcp heavy cancel --force`, `pmcp git deliver --during-pause`, and setting `PMCP_HEAVY_NOW`, `PMCP_OPERATOR_TOKEN` or the lease skip `PMCP_HEAVY_DISABLE=operator`. On by itself with any session feature. |
88
92
 
89
93
  Options:
90
94
 
@@ -330,7 +334,7 @@ table for your project, with Codex trust.
330
334
  | `[git.shared_checkout]`, `[git.worktrees.sync]`, `[git.mainline.deliver]` | measured | measured |
331
335
  | heredoc, compose_teardown, push_without_verify, forced_branch_move, gate_bypass_env, stage_all | measured | measured |
332
336
  | in_place_edit, stdin_interpreter, secret_exfiltration (ask) | ask not measured | ask lowered by `ask_fallback` |
333
- | host_approval | works; not live-measured | works; not live-measured |
337
+ | host_approval, operator_verbs | works; not live-measured | works; not live-measured |
334
338
  | `[hooks.checks.after_edit]` | measured | measured |
335
339
  | `[hooks.checks.on_stop]` | measured, in the same turn | at the next prompt |
336
340
  | `[[hooks.guards.custom]]` | not measured | not measured |