@modootoday/pmcp 0.26.1 → 0.28.1

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 (90) 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-7HWNHSQB.js → apply-6ORDPVZS.js} +9 -9
  6. package/dist/{chunk-GYL2C2Y5.js → chunk-2I54YKIV.js} +2 -2
  7. package/dist/{chunk-JDVDA5HW.js → chunk-45EC3JVG.js} +4 -4
  8. package/dist/{chunk-XPLT6DJC.js → chunk-4G6LXAM4.js} +26 -24
  9. package/dist/{chunk-YKICVMF7.js → chunk-4ZB5NJZA.js} +8 -3
  10. package/dist/{chunk-2VL3C52Y.js → chunk-5KE3B5TO.js} +2 -2
  11. package/dist/chunk-674APJDK.js +128 -0
  12. package/dist/{chunk-3T7CJS4A.js → chunk-6FUUX5WO.js} +2 -2
  13. package/dist/chunk-6TM7PLXG.js +154 -0
  14. package/dist/{chunk-RGTWJWQ7.js → chunk-7J25NFM6.js} +2 -2
  15. package/dist/{chunk-M2XABD33.js → chunk-BLE3YNCU.js} +3 -3
  16. package/dist/{chunk-GIK4TROM.js → chunk-C7VIQJLF.js} +2 -2
  17. package/dist/{chunk-CJD2HFXF.js → chunk-HUAPDSKW.js} +3 -3
  18. package/dist/{chunk-KWEW5EBE.js → chunk-IQYJWLGX.js} +2 -2
  19. package/dist/{chunk-A7MF7RMO.js → chunk-IWDZYK6V.js} +5 -5
  20. package/dist/{chunk-S2FUWBLO.js → chunk-J3C46RXZ.js} +61 -8
  21. package/dist/chunk-LXJTABBQ.js +1148 -0
  22. package/dist/{chunk-OHCUPXU4.js → chunk-LXWAU7AX.js} +65 -2
  23. package/dist/{chunk-MFQAQ4IJ.js → chunk-MPH7BQON.js} +4 -4
  24. package/dist/{chunk-T52AGUO7.js → chunk-N6Q2QB2H.js} +2 -2
  25. package/dist/{chunk-5ZP3ABPI.js → chunk-OFYDBK44.js} +2 -2
  26. package/dist/{chunk-BSG74PTY.js → chunk-Q2UBBZSD.js} +3 -3
  27. package/dist/{chunk-UHKHXS3E.js → chunk-Q7HMO7JX.js} +2 -2
  28. package/dist/chunk-RS2ST3KT.js +7 -0
  29. package/dist/{chunk-ZT75ACJ2.js → chunk-SHTSGJBH.js} +2 -2
  30. package/dist/chunk-TYXJBXZQ.js +441 -0
  31. package/dist/{chunk-E7BPELYH.js → chunk-V42DHBXN.js} +5 -5
  32. package/dist/chunk-WG7KH46S.js +71 -0
  33. package/dist/{cli-FVUHK2NB.js → cli-FXHKAXIV.js} +5 -5
  34. package/dist/cli.js +10 -10
  35. package/dist/{completion-O3KRUSJG.js → completion-OXAWXTUC.js} +6 -6
  36. package/dist/{diagnostics-PB5TKIAL.js → diagnostics-PTGOBBN7.js} +5 -5
  37. package/dist/{doctor-JVWINJT5.js → doctor-IVKT4F44.js} +11 -11
  38. package/dist/doctor-NKFZNSRD.js +106 -0
  39. package/dist/{entry-CY74PLN3.js → entry-7EWYX5XJ.js} +11 -11
  40. package/dist/{exec-mcp-HAKUGQZM.js → exec-mcp-WWVMIQLV.js} +7 -7
  41. package/dist/{harness-N234LNM7.js → harness-L5PBWKXS.js} +3 -3
  42. package/dist/harness-launch-gate.js +3 -3
  43. package/dist/harness-worker.js +5 -5
  44. package/dist/heavy-VBC4AGL6.js +1063 -0
  45. package/dist/hook-body.js +86 -45
  46. package/dist/{hooks-7K624JQC.js → hooks-BKLDQQSN.js} +3 -3
  47. package/dist/{host-PT7NRWG6.js → host-3GP3BJKY.js} +6 -6
  48. package/dist/host-TVWPNQV5.js +32 -0
  49. package/dist/{host-CCJFOCZJ.js → host-U7CA77BY.js} +9 -9
  50. package/dist/{host-run-RRBFTVYW.js → host-run-MHD72EGP.js} +4 -4
  51. package/dist/http.js +1 -1
  52. package/dist/{import-mcp-GCNNSLWH.js → import-mcp-7EV5RPWK.js} +6 -6
  53. package/dist/index.d.ts +1 -1
  54. package/dist/index.js +10 -10
  55. package/dist/{init-A4NLTERR.js → init-SHHALJOG.js} +2 -2
  56. package/dist/{invoke-G4LNWPTL.js → invoke-W42C5POV.js} +7 -7
  57. package/dist/jobs-FLHB3WER.js +26 -0
  58. package/dist/{list-EZYULVDW.js → list-GNNRY4NJ.js} +8 -8
  59. package/dist/{logout-BYO3UJUH.js → logout-DZVBFQYZ.js} +7 -7
  60. package/dist/{mainline-SWZPKA7U.js → mainline-D665V4Y3.js} +19 -3
  61. package/dist/{mcp-CZNYDYTJ.js → mcp-5A6WWV32.js} +2 -2
  62. package/dist/measure-Z5HPT26L.js +129 -0
  63. package/dist/plan-46BTJQIV.js +98 -0
  64. package/dist/{project-GLT3SO7Y.js → project-CKECETMB.js} +4 -4
  65. package/dist/{run-J5O2V3MB.js → run-LWVKCXS4.js} +6 -6
  66. package/dist/{run-OBQBKBPV.js → run-YMER7XMR.js} +4 -4
  67. package/dist/{serve-QCG4PCVS.js → serve-GYMBJPNJ.js} +3 -3
  68. package/dist/{setup-7JHWLV7K.js → setup-ZYD5XBKU.js} +2 -2
  69. package/dist/{start-login-LRO3RTHD.js → start-login-NE5QMH2F.js} +7 -7
  70. package/dist/{status-EZTFSD5S.js → status-HCZBWIC3.js} +8 -8
  71. package/dist/{status-BQLT7JRE.js → status-WP6NM6VP.js} +7 -7
  72. package/dist/stdio.js +2 -2
  73. package/dist/{test-O7TN5SBA.js → test-PLZ62G54.js} +7 -7
  74. package/dist/{tui-ODLF6QWC.js → tui-ZWLRAOCQ.js} +4 -4
  75. package/dist/{worker-AK4GLGPZ.js → worker-GMSWWVTS.js} +9 -9
  76. package/dist/{worktree-sync-BQZD4J73.js → worktree-sync-TQ75DK62.js} +4 -2
  77. package/docs/commands.md +24 -8
  78. package/docs/git-workflow.md +9 -0
  79. package/docs/project-configuration.md +1 -1
  80. package/gemini-extension.json +2 -2
  81. package/mcp.json +1 -1
  82. package/package.json +5 -5
  83. package/plugin.json +1 -1
  84. package/plugins/pmcp/.claude-plugin/plugin.json +1 -1
  85. package/plugins/pmcp/.mcp.json +1 -1
  86. package/plugins/pmcp/gemini-extension.json +2 -2
  87. package/plugins/pmcp/mcp.json +1 -1
  88. package/plugins/pmcp/plugin.json +1 -1
  89. package/dist/chunk-EIBKHS74.js +0 -7
  90. package/dist/heavy-X3KZ7WBU.js +0 -2211
@@ -7,19 +7,19 @@ import {
7
7
  } from "./chunk-VN34GLGJ.js";
8
8
  import {
9
9
  policyRows
10
- } from "./chunk-UHKHXS3E.js";
10
+ } from "./chunk-Q7HMO7JX.js";
11
11
  import "./chunk-E272CFPS.js";
12
12
  import {
13
13
  configFrom
14
14
  } from "./chunk-7CHUMF3E.js";
15
15
  import {
16
16
  checkProject
17
- } from "./chunk-CJD2HFXF.js";
17
+ } from "./chunk-HUAPDSKW.js";
18
18
  import {
19
19
  checkBudget,
20
20
  readSpec
21
- } from "./chunk-JDVDA5HW.js";
22
- import "./chunk-S2FUWBLO.js";
21
+ } from "./chunk-45EC3JVG.js";
22
+ import "./chunk-J3C46RXZ.js";
23
23
  import "./chunk-FLG7VRTC.js";
24
24
  import {
25
25
  distance
@@ -33,7 +33,7 @@ import "./chunk-73AKO4UL.js";
33
33
  import "./chunk-VQBXWMLT.js";
34
34
  import {
35
35
  readGitConfig
36
- } from "./chunk-YKICVMF7.js";
36
+ } from "./chunk-4ZB5NJZA.js";
37
37
  import "./chunk-WUFNKK3U.js";
38
38
  import "./chunk-374AZ4J4.js";
39
39
  import {
@@ -58,7 +58,7 @@ import {
58
58
  EXIT,
59
59
  noConfig
60
60
  } from "./chunk-Y6NFETNG.js";
61
- import "./chunk-2VL3C52Y.js";
61
+ import "./chunk-5KE3B5TO.js";
62
62
  import "./chunk-PZ6D3WKD.js";
63
63
  import "./chunk-N7ANFMA5.js";
64
64
  import "./chunk-TYY5TYHF.js";
@@ -70,7 +70,7 @@ import {
70
70
  worktreesOf
71
71
  } from "./chunk-IJBSOWHK.js";
72
72
  import "./chunk-XWLMZKH2.js";
73
- import "./chunk-EIBKHS74.js";
73
+ import "./chunk-RS2ST3KT.js";
74
74
  import "./chunk-GJXOFDJT.js";
75
75
  import "./chunk-PMJG2CXF.js";
76
76
  import "./chunk-J6KL3COD.js";
@@ -306,4 +306,4 @@ var statusCommand = {
306
306
  export {
307
307
  statusCommand
308
308
  };
309
- //# sourceMappingURL=status-EZTFSD5S.js.map
309
+ //# sourceMappingURL=status-HCZBWIC3.js.map
@@ -1,12 +1,12 @@
1
1
  import {
2
2
  serverFrom
3
- } from "./chunk-ZT75ACJ2.js";
3
+ } from "./chunk-SHTSGJBH.js";
4
4
  import {
5
5
  status
6
6
  } from "./chunk-UPQTAHUK.js";
7
7
  import "./chunk-7CHUMF3E.js";
8
- import "./chunk-JDVDA5HW.js";
9
- import "./chunk-S2FUWBLO.js";
8
+ import "./chunk-45EC3JVG.js";
9
+ import "./chunk-J3C46RXZ.js";
10
10
  import "./chunk-FLG7VRTC.js";
11
11
  import "./chunk-2GD7PQ7J.js";
12
12
  import "./chunk-EATCUWGG.js";
@@ -16,7 +16,7 @@ import "./chunk-LFFIQBNY.js";
16
16
  import "./chunk-HQOB7OQS.js";
17
17
  import "./chunk-73AKO4UL.js";
18
18
  import "./chunk-VQBXWMLT.js";
19
- import "./chunk-YKICVMF7.js";
19
+ import "./chunk-4ZB5NJZA.js";
20
20
  import "./chunk-WUFNKK3U.js";
21
21
  import "./chunk-374AZ4J4.js";
22
22
  import "./chunk-SDFJJJB5.js";
@@ -27,7 +27,7 @@ import "./chunk-Q5H3L6Y4.js";
27
27
  import "./chunk-GQRDEIQA.js";
28
28
  import "./chunk-V4NPDK6X.js";
29
29
  import "./chunk-Y6NFETNG.js";
30
- import "./chunk-2VL3C52Y.js";
30
+ import "./chunk-5KE3B5TO.js";
31
31
  import "./chunk-PZ6D3WKD.js";
32
32
  import "./chunk-N7ANFMA5.js";
33
33
  import "./chunk-TYY5TYHF.js";
@@ -36,7 +36,7 @@ import "./chunk-KLIYFD3W.js";
36
36
  import "./chunk-GUHOEIHP.js";
37
37
  import "./chunk-IJBSOWHK.js";
38
38
  import "./chunk-XWLMZKH2.js";
39
- import "./chunk-EIBKHS74.js";
39
+ import "./chunk-RS2ST3KT.js";
40
40
  import "./chunk-GJXOFDJT.js";
41
41
  import "./chunk-PMJG2CXF.js";
42
42
  import "./chunk-J6KL3COD.js";
@@ -59,4 +59,4 @@ function run(context) {
59
59
  export {
60
60
  run
61
61
  };
62
- //# sourceMappingURL=status-BQLT7JRE.js.map
62
+ //# sourceMappingURL=status-WP6NM6VP.js.map
package/dist/stdio.js CHANGED
@@ -4,8 +4,8 @@ import {
4
4
  resolveRoots,
5
5
  serve,
6
6
  serveWithMailbox
7
- } from "./chunk-GYL2C2Y5.js";
8
- import "./chunk-KWEW5EBE.js";
7
+ } from "./chunk-2I54YKIV.js";
8
+ import "./chunk-IQYJWLGX.js";
9
9
  import "./chunk-6WXMJOMI.js";
10
10
  import "./chunk-4CRRLDDS.js";
11
11
  import "./chunk-YSAWTGNA.js";
@@ -1,6 +1,6 @@
1
1
  import {
2
2
  specFrom
3
- } from "./chunk-GIK4TROM.js";
3
+ } from "./chunk-C7VIQJLF.js";
4
4
  import {
5
5
  sourceFor
6
6
  } from "./chunk-E272CFPS.js";
@@ -13,8 +13,8 @@ import {
13
13
  customPolicy,
14
14
  externalPolicy,
15
15
  readScript
16
- } from "./chunk-JDVDA5HW.js";
17
- import "./chunk-S2FUWBLO.js";
16
+ } from "./chunk-45EC3JVG.js";
17
+ import "./chunk-J3C46RXZ.js";
18
18
  import "./chunk-FLG7VRTC.js";
19
19
  import "./chunk-2GD7PQ7J.js";
20
20
  import "./chunk-EATCUWGG.js";
@@ -27,7 +27,7 @@ import {
27
27
  } from "./chunk-HQOB7OQS.js";
28
28
  import "./chunk-73AKO4UL.js";
29
29
  import "./chunk-VQBXWMLT.js";
30
- import "./chunk-YKICVMF7.js";
30
+ import "./chunk-4ZB5NJZA.js";
31
31
  import "./chunk-WUFNKK3U.js";
32
32
  import "./chunk-374AZ4J4.js";
33
33
  import "./chunk-SDFJJJB5.js";
@@ -57,7 +57,7 @@ import {
57
57
  ArgumentError,
58
58
  one
59
59
  } from "./chunk-Y6NFETNG.js";
60
- import "./chunk-2VL3C52Y.js";
60
+ import "./chunk-5KE3B5TO.js";
61
61
  import "./chunk-PZ6D3WKD.js";
62
62
  import "./chunk-N7ANFMA5.js";
63
63
  import "./chunk-TYY5TYHF.js";
@@ -71,7 +71,7 @@ import {
71
71
  worktreesOf
72
72
  } from "./chunk-IJBSOWHK.js";
73
73
  import "./chunk-XWLMZKH2.js";
74
- import "./chunk-EIBKHS74.js";
74
+ import "./chunk-RS2ST3KT.js";
75
75
  import "./chunk-GJXOFDJT.js";
76
76
  import "./chunk-PMJG2CXF.js";
77
77
  import "./chunk-J6KL3COD.js";
@@ -639,4 +639,4 @@ async function run(context) {
639
639
  export {
640
640
  run
641
641
  };
642
- //# sourceMappingURL=test-O7TN5SBA.js.map
642
+ //# sourceMappingURL=test-PLZ62G54.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-PB5TKIAL.js");
143
+ const { inspectTerminalHost } = await import("./diagnostics-PTGOBBN7.js");
144
144
  receipt = inspectTerminalHost();
145
145
  } else if (invocation.action === "start-worker") {
146
- const { startWorkspaceWorker } = await import("./worker-AK4GLGPZ.js");
146
+ const { startWorkspaceWorker } = await import("./worker-GMSWWVTS.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-CY74PLN3.js");
159
+ const { launchStartup, planStartup } = await import("./entry-7EWYX5XJ.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-ODLF6QWC.js.map
179
+ //# sourceMappingURL=tui-ZWLRAOCQ.js.map
@@ -1,20 +1,20 @@
1
- import {
2
- invoke
3
- } from "./chunk-E7BPELYH.js";
4
1
  import {
5
2
  readStartup,
6
3
  startupFile,
7
4
  startupSettings
8
5
  } from "./chunk-C3G75JH7.js";
6
+ import {
7
+ invoke
8
+ } from "./chunk-V42DHBXN.js";
9
9
  import "./chunk-DZ2MRTYT.js";
10
- import "./chunk-BSG74PTY.js";
11
- import "./chunk-3T7CJS4A.js";
10
+ import "./chunk-Q2UBBZSD.js";
11
+ import "./chunk-6FUUX5WO.js";
12
12
  import {
13
13
  locateExecutable
14
14
  } from "./chunk-R2GPCZUX.js";
15
- import "./chunk-T52AGUO7.js";
15
+ import "./chunk-N6Q2QB2H.js";
16
16
  import "./chunk-34DECPVC.js";
17
- import "./chunk-2VL3C52Y.js";
17
+ import "./chunk-5KE3B5TO.js";
18
18
  import "./chunk-PZ6D3WKD.js";
19
19
  import "./chunk-N7ANFMA5.js";
20
20
  import "./chunk-TYY5TYHF.js";
@@ -23,7 +23,7 @@ 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-EIBKHS74.js";
26
+ import "./chunk-RS2ST3KT.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-AK4GLGPZ.js.map
86
+ //# sourceMappingURL=worker-GMSWWVTS.js.map
@@ -2,9 +2,10 @@ import {
2
2
  off
3
3
  } from "./chunk-YIXDHQYE.js";
4
4
  import {
5
+ dirToGitlinkPolicy,
5
6
  installSpec,
6
7
  syncWorktree
7
- } from "./chunk-S2FUWBLO.js";
8
+ } from "./chunk-J3C46RXZ.js";
8
9
  import "./chunk-2GD7PQ7J.js";
9
10
  import "./chunk-VQBXWMLT.js";
10
11
  import "./chunk-23PE3HZB.js";
@@ -20,6 +21,7 @@ var worktreeSync = (setup, _context, report) => {
20
21
  const result = syncWorktree({
21
22
  ctx,
22
23
  followSubmodules: config.submodules?.follow === "clean_pins",
24
+ dirToGitlink: dirToGitlinkPolicy(config.submodules),
23
25
  report,
24
26
  ...config.umask !== void 0 ? { umask: config.umask } : {},
25
27
  ...install === void 0 ? {} : { install }
@@ -29,4 +31,4 @@ var worktreeSync = (setup, _context, report) => {
29
31
  export {
30
32
  worktreeSync
31
33
  };
32
- //# sourceMappingURL=worktree-sync-BQZD4J73.js.map
34
+ //# sourceMappingURL=worktree-sync-TQ75DK62.js.map
package/docs/commands.md CHANGED
@@ -240,6 +240,22 @@ pmcp heavy priority <id> +2 --reason "the session waits on it"
240
240
 
241
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. Every job keeps its stdout and stderr in its ticket, bounded by `[host.lease] job_log_bytes` (default 4 MiB, rotated once to `log.1`, so a job keeps at most twice that): a submitted job's runner writes them there, and a blocking run opens a ticket of its own and copies them there as they reach the terminal, so the command sees pipes instead of a terminal; a blocking run that fails ends with a line naming its id. `job_log_bytes = 0`, or a disabled lease, keeps nothing for blocking runs, which then write to the terminal directly. `result <id>` reads the state (queued with its position, running, done, or lost when the runner died), `--json` as data, and `result <id> --log` prints the kept output instead, the rotated part first; `--tail <n>` keeps its last n lines. `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
+ ## host
244
+
245
+ ```sh
246
+ pmcp host io measure [--dir <path>] [--seconds <n>] [--json]
247
+ pmcp host io plan [--unit <name>] [--json]
248
+ pmcp host io doctor [--weights [--seconds <n>]] [--json]
249
+ ```
250
+
251
+ Fit the kernel's io.cost model to the disk, so the lanes' `io.weight` (`[host.lease.io]`) divides it. Linux with cgroup v2 only; elsewhere these exit 3. The kernel's own estimate (`ctrl=auto`) can overstate a network volume several times, and while it does, weights of 25 and 100 get nearly the same IOPS. A measured model alone is not enough: with qos `ctrl=auto` the kernel may raise vrate far past the model, so the model always comes with qos `ctrl=user rpct=0 rlat=0 wpct=0 wlat=0 min=50 max=100`.
252
+
253
+ `measure` waits for the host lease in the bulk lane with the whole budget, like any heavy job (75 when it never gets it), then probes a 1 GiB file on the filesystem of `--dir` (default: the lease directory) with `O_DIRECT`, so the page cache is bypassed; it never touches the raw device. The probe runs in its own `systemd-run --user` scope under `pmcp-io.slice`, outside the lanes' scopes and their `io.max`, and its directory is removed however it ends. It writes the file in 1 MiB blocks, then runs 1 MiB sequential reads at depth 4 and 4 KiB sequential and random reads and writes at depth 16 for `--seconds` each (default 8), about a minute in all, and records the model with the whole disk's major:minor (a partition resolves to its disk), the time, the pmcp version and the io.cost lines live at the time in `<dir>/io-model.json` of [`[host.lease]`](project-configuration.md#host-lease). While the device's qos is `ctrl=user`, vrate is held to the current model and a probe would measure that cap, so `measure` refuses before it takes the lease, with exit 4: it prints the line that lifts the cap (`echo '259:0 enable=1 ctrl=auto' > /sys/fs/cgroup/io.cost.qos` as root, for that device), and `plan` prints the capped line to restore afterwards. There is no override.
254
+
255
+ `plan` reads the record and prints, per device, the `io.cost.model` line, the `io.cost.qos` line and a systemd unit (`pmcp-io-cost.service`) that writes both at boot; `--unit <name>` prints a drop-in for an existing oneshot unit instead. It only prints: install the unit as root. Exit 1 without a record.
256
+
257
+ `doctor` only reads: it compares the live `io.cost.model` with the record and checks that qos is enabled, `ctrl=user` and `max` at most 100. `--weights` also runs two 4 KiB random readers at `io.weight` 25 and 100 in sibling scopes for `--seconds` (default 20), under the host lease like `measure`; each scope first checks that every cgroup above it has `io` in `cgroup.subtree_control`, since without it the weights are never read, and the check is reported as not valid instead of as a ratio. A ratio under 2 is a warning. Exit 0 when every check passes, 4 with a warning (no record included), 3 without io.cost.
258
+
243
259
  ## wait
244
260
 
245
261
  ```sh
@@ -395,14 +411,14 @@ An unknown command, subcommand or option exits 2 with one line naming it, the cl
395
411
 
396
412
  Every command uses one table, so a script can branch on the code alone:
397
413
 
398
- | Code | Means | For example |
399
- | ---- | ------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
400
- | `0` | it did what you asked | skills listed, the whole catalog indexed, nothing to deliver |
401
- | `1` | it ran and failed, or found a problem | no skills under those roots, a partial index, no SQLite to store vectors in, `validate` errors, a `doctor` FAIL, a declined or failed install, a refused delivery, a failed gate or fetch |
402
- | `2` | usage error: it could not run as asked | an unknown command, subcommand or option, a missing value, no `pmcp.toml` or a missing `[git]` table, `git sync` in the wrong checkout |
403
- | `3` | an optional dependency is missing | `index` without `@huggingface/transformers` |
404
- | `4` | a check ran and found differences | `status` projection drift, `project --check` drift or an exceeded budget, stale or undeclared outputs, a `hooks test --fixtures` or `--smoke` finding |
405
- | `75` | the host stayed busy, so nothing ran; retry later | `heavy` past `max_wait`, a `git deliver` gate whose test stage never got the host lease, `wait` past `--timeout` |
414
+ | Code | Means | For example |
415
+ | ---- | ------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
416
+ | `0` | it did what you asked | skills listed, the whole catalog indexed, nothing to deliver |
417
+ | `1` | it ran and failed, or found a problem | no skills under those roots, a partial index, no SQLite to store vectors in, `validate` errors, a `doctor` FAIL, a declined or failed install, a refused delivery, a failed gate or fetch |
418
+ | `2` | usage error: it could not run as asked | an unknown command, subcommand or option, a missing value, no `pmcp.toml` or a missing `[git]` table, `git sync` in the wrong checkout |
419
+ | `3` | an optional dependency is missing | `index` without `@huggingface/transformers`, `host io` off Linux or without io.cost |
420
+ | `4` | a check ran and found differences | `status` projection drift, `project --check` drift or an exceeded budget, stale or undeclared outputs, a `hooks test --fixtures` or `--smoke` finding, a `host io doctor` warning, `host io measure` refused under a capped qos |
421
+ | `75` | the host stayed busy, so nothing ran; retry later | `heavy` or `host io measure` past `max_wait`, a `git deliver` gate whose test stage never got the host lease, `wait` past `--timeout` |
406
422
 
407
423
  1 says the project is not what you expected; 2 says the command line or the setup is wrong, so retrying the same command will not help; 3 says the machine is missing something optional and the server still works without it; 4 says a check did its job and found something to fix, usually with `pmcp project`. A command that runs another command, such as `heavy`, exits with that command's code. Before 0.23.0, drift exited 2 like a usage error; see [Upgrading](upgrading.md).
408
424
 
@@ -205,6 +205,15 @@ long as no edited or untracked file is one the pin changes. When one is, the
205
205
  submodule stays on the old pin and sync names the files; pmcp never restores,
206
206
  stashes or discards them.
207
207
 
208
+ `dir_to_gitlink` decides what a sync does when the move turns a tracked directory
209
+ that still holds files into a gitlink (an app split out into its own repository).
210
+ `"adopt"` (the default) moves, then checks the new submodule out, setting ignored
211
+ output aside. `"refuse"` leaves the checkout where it is, with the directory and
212
+ its files untouched, and exits 1, so a separate step can adopt it; the optional
213
+ `dir_to_gitlink_hint` is appended to the refusal to name that step. It applies to
214
+ `pmcp git sync` in the main checkout and on desks, to `pmcp git worktree sync`,
215
+ and to the sync after a delivery, which still reports the delivery as done.
216
+
208
217
  With `push = "pins"`, `pmcp git deliver` first makes sure every submodule commit the
209
218
  delivered commits pin is on that submodule's origin. A pin already on a remote branch
210
219
  needs nothing. Otherwise exactly the pinned commit is pushed to the submodule's
@@ -323,7 +323,7 @@ load_grace = 600
323
323
  | `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. |
324
324
  | `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. |
325
325
  | `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`. |
326
- | `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. |
326
+ | `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. |
327
327
  | `io.weights.<lane>` | integer | gate 500, hook 300, interactive 100, bulk 25 | The scope's `io.weight` per lane (1 to 10000). |
328
328
  | `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. |
329
329
  | `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. |
@@ -1,11 +1,11 @@
1
1
  {
2
2
  "name": "pmcp",
3
- "version": "0.26.1",
3
+ "version": "0.28.1",
4
4
  "mcpServers": {
5
5
  "pmcp": {
6
6
  "type": "stdio",
7
7
  "command": "npx",
8
- "args": ["-y", "@modootoday/pmcp@0.26.1", "serve"]
8
+ "args": ["-y", "@modootoday/pmcp@0.28.1", "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.26.1", "serve"]
7
+ "args": ["-y", "@modootoday/pmcp@0.28.1", "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.26.1",
3
+ "version": "0.28.1",
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.26.1",
140
- "@modootoday/pmcp-linux-arm64": "0.26.1",
141
- "@modootoday/pmcp-darwin-x64": "0.26.1",
142
- "@modootoday/pmcp-darwin-arm64": "0.26.1"
139
+ "@modootoday/pmcp-linux-x64": "0.28.1",
140
+ "@modootoday/pmcp-linux-arm64": "0.28.1",
141
+ "@modootoday/pmcp-darwin-x64": "0.28.1",
142
+ "@modootoday/pmcp-darwin-arm64": "0.28.1"
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.26.1",
4
+ "version": "0.28.1",
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.26.1",
3
+ "version": "0.28.1",
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.26.1", "serve"]
6
+ "args": ["-y", "@modootoday/pmcp@0.28.1", "serve"]
7
7
  }
8
8
  }
9
9
  }
@@ -1,11 +1,11 @@
1
1
  {
2
2
  "name": "pmcp",
3
- "version": "0.26.1",
3
+ "version": "0.28.1",
4
4
  "mcpServers": {
5
5
  "pmcp": {
6
6
  "type": "stdio",
7
7
  "command": "npx",
8
- "args": ["-y", "@modootoday/pmcp@0.26.1", "serve"]
8
+ "args": ["-y", "@modootoday/pmcp@0.28.1", "serve"]
9
9
  }
10
10
  }
11
11
  }
@@ -4,7 +4,7 @@
4
4
  "pmcp": {
5
5
  "type": "stdio",
6
6
  "command": "npx",
7
- "args": ["-y", "@modootoday/pmcp@0.26.1", "serve"]
7
+ "args": ["-y", "@modootoday/pmcp@0.28.1", "serve"]
8
8
  }
9
9
  }
10
10
  }
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
3
3
  "name": "pmcp",
4
- "version": "0.26.1",
4
+ "version": "0.28.1",
5
5
  "description": "Find package skills and use native runtime project configuration.",
6
6
  "author": { "name": "modootoday" },
7
7
  "license": "Elastic-2.0",
@@ -1,7 +0,0 @@
1
- // src/commands/version.ts
2
- var VERSION = "0.26.1";
3
-
4
- export {
5
- VERSION
6
- };
7
- //# sourceMappingURL=chunk-EIBKHS74.js.map