@modootoday/pmcp 0.18.2 → 0.18.4

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 (108) 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/CONTRIBUTING.md +10 -1
  6. package/README.md +22 -20
  7. package/dist/{apply-JUTGS5WZ.js → apply-75UWIUVQ.js} +12 -11
  8. package/dist/{available-DBSIVVJ6.js → available-GFMTJW4E.js} +3 -3
  9. package/dist/{chunk-I2ZP2PSA.js → chunk-3CA3NNVH.js} +5 -5
  10. package/dist/{chunk-VRPMYPZU.js → chunk-45Y3KZ3Q.js} +22 -2
  11. package/dist/{chunk-KMXRRSKT.js → chunk-4CRRLDDS.js} +1 -1
  12. package/dist/{chunk-LW4TG7EL.js → chunk-4JUSGIMX.js} +2 -2
  13. package/dist/{chunk-TXQ7L33K.js → chunk-6UXJ62XJ.js} +3 -3
  14. package/dist/{chunk-T3LKX23M.js → chunk-7B6IC3F7.js} +3 -3
  15. package/dist/{chunk-D77IRGHO.js → chunk-ARA4VDHD.js} +5 -5
  16. package/dist/{chunk-QEF7EK3T.js → chunk-DAR6RGRN.js} +2 -2
  17. package/dist/{chunk-BBTBJCFA.js → chunk-F5WBMUOT.js} +2 -2
  18. package/dist/{chunk-7HFIGCSL.js → chunk-FBIDDE3N.js} +19 -7
  19. package/dist/{chunk-NLEXKE7U.js → chunk-HE2C2S5A.js} +3 -3
  20. package/dist/{chunk-5QQWS4US.js → chunk-HEBCQTOD.js} +2 -2
  21. package/dist/{chunk-AJ4VXM2U.js → chunk-HEWZ6INU.js} +2 -2
  22. package/dist/{chunk-MPSQXSC6.js → chunk-ISZOLR3D.js} +5 -3
  23. package/dist/{chunk-TVL5RTE6.js → chunk-ITDJ2EXN.js} +11 -1
  24. package/dist/{chunk-PAX3QXX2.js → chunk-J5ZS7GLA.js} +2 -2
  25. package/dist/chunk-J6KL3COD.js +34 -0
  26. package/dist/{chunk-CJTKR6K6.js → chunk-JZK7ZO7K.js} +2 -2
  27. package/dist/{chunk-A7VF7A35.js → chunk-LFR245MZ.js} +5 -5
  28. package/dist/{chunk-7UCZAN4J.js → chunk-LGO2SZAS.js} +3 -3
  29. package/dist/{chunk-DMZHQZ7P.js → chunk-MSOZPOPX.js} +25 -3
  30. package/dist/chunk-MZCRCMEY.js +7 -0
  31. package/dist/{chunk-7GBYECSK.js → chunk-NLHLA2N5.js} +3 -3
  32. package/dist/{chunk-HDMBVLCZ.js → chunk-NWOV2E26.js} +2 -2
  33. package/dist/{chunk-RPQOBHVU.js → chunk-OB3P5RMN.js} +3 -3
  34. package/dist/{chunk-IG33DXLT.js → chunk-QBJC4DRP.js} +18 -18
  35. package/dist/{chunk-47O3X4VS.js → chunk-QRCAGKC6.js} +1 -1
  36. package/dist/{chunk-F5QYZK7E.js → chunk-R26RWSFW.js} +2 -2
  37. package/dist/{chunk-3IDXEV5E.js → chunk-TFRJ5QOS.js} +67 -17
  38. package/dist/{chunk-FENOGX3U.js → chunk-VQ2HEGWH.js} +2 -2
  39. package/dist/{chunk-2FIV63WC.js → chunk-XMXBE5IQ.js} +6 -6
  40. package/dist/{chunk-TNCZ6444.js → chunk-Y2XASHVY.js} +2 -2
  41. package/dist/{chunk-PKODFR5F.js → chunk-YRGDWUFY.js} +2 -2
  42. package/dist/{chunk-VMHUEOT5.js → chunk-YSUINA5Q.js} +9 -7
  43. package/dist/{chunk-3FCFAQDG.js → chunk-ZWLUH3F2.js} +2 -2
  44. package/dist/cli.js +3 -3
  45. package/dist/{completion-ILSRB3LW.js → completion-WYJAKJE4.js} +2 -2
  46. package/dist/{diagnostics-XKXVVQWH.js → diagnostics-ADIVFSBW.js} +7 -6
  47. package/dist/{doctor-O2E63YGO.js → doctor-BBCS4DF5.js} +12 -11
  48. package/dist/{entry-X6CSYQRQ.js → entry-DMOTX4SS.js} +13 -12
  49. package/dist/{exec-mcp-2PMWBPD7.js → exec-mcp-OBUM3DVW.js} +7 -6
  50. package/dist/{harness-L2KSI2ZB.js → harness-6AUE3I4Q.js} +4 -4
  51. package/dist/harness-launch-gate.js +6 -5
  52. package/dist/harness-pane-runner.js +2 -1
  53. package/dist/harness-worker.js +8 -7
  54. package/dist/{hooks-BHTA44X7.js → hooks-HLPQPVRY.js} +3 -3
  55. package/dist/{host-UWK754BW.js → host-5Q3X6OY7.js} +9 -8
  56. package/dist/{host-UIZAXXQH.js → host-LGSWU3PJ.js} +8 -7
  57. package/dist/{host-run-BI2OTZDZ.js → host-run-4NMQQASQ.js} +23 -10
  58. package/dist/http.js +5 -5
  59. package/dist/{import-mcp-GPKJI7DI.js → import-mcp-WU7TO2RT.js} +5 -4
  60. package/dist/index.d.ts +5 -1
  61. package/dist/index.js +17 -16
  62. package/dist/{init-3C2Y7BNJ.js → init-XA6XXLGA.js} +2 -2
  63. package/dist/{install-GG7HHZK2.js → install-MQ7QSJQ7.js} +3 -3
  64. package/dist/invoke-CYQZYU5T.js +24 -0
  65. package/dist/{list-MCP2FXUF.js → list-FB6RNYYB.js} +3 -3
  66. package/dist/{list-WL6L4J5H.js → list-FNGXY5D7.js} +7 -6
  67. package/dist/{logout-F5EJ5MOU.js → logout-N753FBZP.js} +6 -5
  68. package/dist/mailbox/index.js +4 -4
  69. package/dist/{mailbox-GDJ7BWQN.js → mailbox-5DWLH4W2.js} +3 -3
  70. package/dist/{mcp-FJ2UQ4RH.js → mcp-AXHV547W.js} +5 -5
  71. package/dist/{mcp-235QZN2A.js → mcp-GR4VXKTG.js} +2 -2
  72. package/dist/{project-5YV5CUEG.js → project-OEBACWEX.js} +4 -4
  73. package/dist/{recovery-U6QB3PMT.js → recovery-54KHNJX4.js} +4 -3
  74. package/dist/{reindex-Y27QJFDB.js → reindex-ZULHSQWY.js} +5 -5
  75. package/dist/{run-3SOVRQIA.js → run-7XNGPU2I.js} +4 -4
  76. package/dist/{run-3AXTZSR7.js → run-MDRUOEFL.js} +5 -4
  77. package/dist/{serve-DQMKTFIV.js → serve-HXHNWKEK.js} +12 -12
  78. package/dist/{start-login-YTZV6KMF.js → start-login-PWCEKNED.js} +6 -5
  79. package/dist/{status-MROQ7WR7.js → status-54IYX2FN.js} +6 -5
  80. package/dist/{status-UME2L33L.js → status-QFOBQ42J.js} +9 -8
  81. package/dist/stdio.js +7 -7
  82. package/dist/{test-AGZOJLRZ.js → test-36ZUVALT.js} +6 -5
  83. package/dist/{tui-G5LLWCSV.js → tui-CSRW4DN2.js} +5 -5
  84. package/dist/{validate-IU52H2IC.js → validate-AVM2VHMM.js} +4 -4
  85. package/dist/{worker-QZ5T6LJD.js → worker-EODWT4KK.js} +11 -10
  86. package/docs/compatibility.md +2 -1
  87. package/docs/known-issues.md +17 -0
  88. package/docs/project-configuration.md +8 -0
  89. package/docs/terminal-harness.md +14 -0
  90. package/docs/upgrading.md +23 -0
  91. package/gemini-extension.json +2 -2
  92. package/mcp.json +1 -1
  93. package/package.json +5 -6
  94. package/plugin.json +1 -1
  95. package/plugins/pmcp/.claude-plugin/plugin.json +1 -1
  96. package/plugins/pmcp/.mcp.json +1 -1
  97. package/plugins/pmcp/gemini-extension.json +2 -2
  98. package/plugins/pmcp/mcp.json +1 -1
  99. package/plugins/pmcp/plugin.json +1 -1
  100. package/plugins/pmcp/skills/agent-assets-migrate/SKILL.md +8 -8
  101. package/plugins/pmcp/skills/marketplace-plugin-scaffold/SKILL.md +10 -8
  102. package/plugins/pmcp/skills/skill-package-scaffold/SKILL.md +12 -12
  103. package/skills/agent-assets-migrate/SKILL.md +8 -8
  104. package/skills/marketplace-plugin-scaffold/SKILL.md +10 -8
  105. package/skills/skill-package-scaffold/SKILL.md +12 -12
  106. package/CHANGELOG.md +0 -152
  107. package/dist/chunk-65KAQSJP.js +0 -7
  108. package/dist/invoke-44CJRVMK.js +0 -23
@@ -7,18 +7,18 @@ import {
7
7
  } from "./chunk-JGJ4INEN.js";
8
8
  import {
9
9
  policyRows
10
- } from "./chunk-3FCFAQDG.js";
10
+ } from "./chunk-ZWLUH3F2.js";
11
11
  import "./chunk-7TD53M7L.js";
12
12
  import {
13
13
  configFrom
14
14
  } from "./chunk-7DLZC73N.js";
15
15
  import {
16
16
  checkProject
17
- } from "./chunk-A7VF7A35.js";
18
- import "./chunk-F5QYZK7E.js";
17
+ } from "./chunk-LFR245MZ.js";
18
+ import "./chunk-R26RWSFW.js";
19
19
  import {
20
20
  readSpec
21
- } from "./chunk-VRPMYPZU.js";
21
+ } from "./chunk-45Y3KZ3Q.js";
22
22
  import "./chunk-HQOB7OQS.js";
23
23
  import {
24
24
  readGitConfig
@@ -53,8 +53,8 @@ import {
53
53
  ArgumentError
54
54
  } from "./chunk-A4PKLESO.js";
55
55
  import "./chunk-V4NPDK6X.js";
56
- import "./chunk-DMZHQZ7P.js";
57
- import "./chunk-7HFIGCSL.js";
56
+ import "./chunk-MSOZPOPX.js";
57
+ import "./chunk-FBIDDE3N.js";
58
58
  import {
59
59
  projectStateDir
60
60
  } from "./chunk-OEH47H6A.js";
@@ -62,9 +62,10 @@ import {
62
62
  checkoutOf,
63
63
  worktreesOf
64
64
  } from "./chunk-IJBSOWHK.js";
65
- import "./chunk-65KAQSJP.js";
65
+ import "./chunk-MZCRCMEY.js";
66
66
  import "./chunk-QPL7E2HW.js";
67
67
  import "./chunk-PMJG2CXF.js";
68
+ import "./chunk-J6KL3COD.js";
68
69
 
69
70
  // src/status/auth.ts
70
71
  async function authPresence(spec, env) {
@@ -283,4 +284,4 @@ var statusCommand = {
283
284
  export {
284
285
  statusCommand
285
286
  };
286
- //# sourceMappingURL=status-UME2L33L.js.map
287
+ //# sourceMappingURL=status-QFOBQ42J.js.map
package/dist/stdio.js CHANGED
@@ -4,15 +4,15 @@ import {
4
4
  resolveRoots,
5
5
  serve,
6
6
  serveWithMailbox
7
- } from "./chunk-RPQOBHVU.js";
8
- import "./chunk-D77IRGHO.js";
7
+ } from "./chunk-OB3P5RMN.js";
8
+ import "./chunk-ARA4VDHD.js";
9
9
  import "./chunk-6WXMJOMI.js";
10
- import "./chunk-KMXRRSKT.js";
10
+ import "./chunk-4CRRLDDS.js";
11
11
  import "./chunk-YSAWTGNA.js";
12
- import "./chunk-HDMBVLCZ.js";
13
- import "./chunk-CJTKR6K6.js";
14
- import "./chunk-TNCZ6444.js";
15
- import "./chunk-47O3X4VS.js";
12
+ import "./chunk-NWOV2E26.js";
13
+ import "./chunk-JZK7ZO7K.js";
14
+ import "./chunk-Y2XASHVY.js";
15
+ import "./chunk-QRCAGKC6.js";
16
16
  import "./chunk-6STKGOCW.js";
17
17
  import "./chunk-QPL7E2HW.js";
18
18
  import "./chunk-PMJG2CXF.js";
@@ -1,6 +1,6 @@
1
1
  import {
2
2
  specFrom
3
- } from "./chunk-FENOGX3U.js";
3
+ } from "./chunk-VQ2HEGWH.js";
4
4
  import {
5
5
  sourceFor
6
6
  } from "./chunk-7TD53M7L.js";
@@ -12,7 +12,7 @@ import {
12
12
  RUNTIME_IDS,
13
13
  commandsOf,
14
14
  customPolicy
15
- } from "./chunk-VRPMYPZU.js";
15
+ } from "./chunk-45Y3KZ3Q.js";
16
16
  import {
17
17
  DEFAULT_LOG_SETTINGS,
18
18
  LEVEL_RANK
@@ -47,7 +47,7 @@ import {
47
47
  one
48
48
  } from "./chunk-A4PKLESO.js";
49
49
  import "./chunk-V4NPDK6X.js";
50
- import "./chunk-7HFIGCSL.js";
50
+ import "./chunk-FBIDDE3N.js";
51
51
  import {
52
52
  expandPath
53
53
  } from "./chunk-OEH47H6A.js";
@@ -55,9 +55,10 @@ import {
55
55
  checkoutOf,
56
56
  worktreesOf
57
57
  } from "./chunk-IJBSOWHK.js";
58
- import "./chunk-65KAQSJP.js";
58
+ import "./chunk-MZCRCMEY.js";
59
59
  import "./chunk-QPL7E2HW.js";
60
60
  import "./chunk-PMJG2CXF.js";
61
+ import "./chunk-J6KL3COD.js";
61
62
 
62
63
  // src/commands/hooks/test.ts
63
64
  import { mkdtempSync, rmSync } from "fs";
@@ -558,4 +559,4 @@ async function run(context) {
558
559
  export {
559
560
  run
560
561
  };
561
- //# sourceMappingURL=test-AGZOJLRZ.js.map
562
+ //# sourceMappingURL=test-36ZUVALT.js.map
@@ -112,23 +112,23 @@ var tuiCommand = {
112
112
  try {
113
113
  let receipt;
114
114
  if (invocation.action === "doctor") {
115
- const { inspectTerminalHost } = await import("./diagnostics-XKXVVQWH.js");
115
+ const { inspectTerminalHost } = await import("./diagnostics-ADIVFSBW.js");
116
116
  receipt = inspectTerminalHost();
117
117
  } else if (invocation.action === "start-worker") {
118
- const { startWorkspaceWorker } = await import("./worker-QZ5T6LJD.js");
118
+ const { startWorkspaceWorker } = await import("./worker-EODWT4KK.js");
119
119
  receipt = await startWorkspaceWorker(
120
120
  { config: invocation.startup?.config, cwd: context.cwd },
121
121
  invocation.startup.runtime,
122
122
  invocation.startup?.memoryMb
123
123
  );
124
124
  } else if (invocation.action === "recovery") {
125
- const { inspectStartupRecovery } = await import("./recovery-U6QB3PMT.js");
125
+ const { inspectStartupRecovery } = await import("./recovery-54KHNJX4.js");
126
126
  receipt = inspectStartupRecovery({
127
127
  ...invocation.startup,
128
128
  cwd: context.cwd
129
129
  });
130
130
  } else {
131
- const { launchStartup, planStartup } = await import("./entry-X6CSYQRQ.js");
131
+ const { launchStartup, planStartup } = await import("./entry-DMOTX4SS.js");
132
132
  const request = { ...invocation.startup, cwd: context.cwd };
133
133
  receipt = invocation.action === "plan" ? planStartup(request) : await launchStartup(
134
134
  request,
@@ -150,4 +150,4 @@ var tuiCommand = {
150
150
  export {
151
151
  tuiCommand
152
152
  };
153
- //# sourceMappingURL=tui-G5LLWCSV.js.map
153
+ //# sourceMappingURL=tui-CSRW4DN2.js.map
@@ -1,20 +1,20 @@
1
1
  import {
2
2
  catalogOptionsFrom
3
- } from "./chunk-5QQWS4US.js";
3
+ } from "./chunk-HEBCQTOD.js";
4
4
  import {
5
5
  configFrom
6
6
  } from "./chunk-7DLZC73N.js";
7
7
  import {
8
8
  validateCatalog,
9
9
  validateSkillDir
10
- } from "./chunk-AJ4VXM2U.js";
10
+ } from "./chunk-HEWZ6INU.js";
11
11
  import "./chunk-73AKO4UL.js";
12
12
  import {
13
13
  validateSpec
14
14
  } from "./chunk-INT7QLEU.js";
15
15
  import "./chunk-JEL35P7S.js";
16
16
  import "./chunk-A4PKLESO.js";
17
- import "./chunk-KMXRRSKT.js";
17
+ import "./chunk-4CRRLDDS.js";
18
18
  import "./chunk-YSAWTGNA.js";
19
19
  import "./chunk-QPL7E2HW.js";
20
20
  import "./chunk-PMJG2CXF.js";
@@ -43,4 +43,4 @@ var validateCommand = {
43
43
  export {
44
44
  validateCommand
45
45
  };
46
- //# sourceMappingURL=validate-IU52H2IC.js.map
46
+ //# sourceMappingURL=validate-AVM2VHMM.js.map
@@ -1,33 +1,34 @@
1
1
  import {
2
2
  invoke
3
- } from "./chunk-2FIV63WC.js";
3
+ } from "./chunk-XMXBE5IQ.js";
4
4
  import {
5
5
  readStartup,
6
6
  startupFile,
7
7
  startupSettings
8
- } from "./chunk-PAX3QXX2.js";
8
+ } from "./chunk-J5ZS7GLA.js";
9
9
  import "./chunk-DZ2MRTYT.js";
10
- import "./chunk-3IDXEV5E.js";
11
- import "./chunk-LW4TG7EL.js";
10
+ import "./chunk-TFRJ5QOS.js";
11
+ import "./chunk-4JUSGIMX.js";
12
12
  import {
13
13
  locateExecutable
14
14
  } from "./chunk-R2GPCZUX.js";
15
- import "./chunk-7UCZAN4J.js";
15
+ import "./chunk-LGO2SZAS.js";
16
16
  import "./chunk-34DECPVC.js";
17
- import "./chunk-DMZHQZ7P.js";
18
- import "./chunk-7HFIGCSL.js";
17
+ import "./chunk-MSOZPOPX.js";
18
+ import "./chunk-FBIDDE3N.js";
19
19
  import "./chunk-OEH47H6A.js";
20
20
  import "./chunk-IJBSOWHK.js";
21
- import "./chunk-65KAQSJP.js";
21
+ import "./chunk-MZCRCMEY.js";
22
22
  import "./chunk-QPL7E2HW.js";
23
23
  import "./chunk-PMJG2CXF.js";
24
24
  import {
25
25
  GroupStore
26
- } from "./chunk-TVL5RTE6.js";
26
+ } from "./chunk-ITDJ2EXN.js";
27
27
  import "./chunk-5OMOPUE6.js";
28
28
  import {
29
29
  runtimeExecutables
30
30
  } from "./chunk-BU65MNVU.js";
31
+ import "./chunk-J6KL3COD.js";
31
32
 
32
33
  // src/tui/startup/worker.ts
33
34
  async function startWorkspaceWorker(request, runtime, memoryMb) {
@@ -77,4 +78,4 @@ async function startWorkspaceWorker(request, runtime, memoryMb) {
77
78
  export {
78
79
  startWorkspaceWorker
79
80
  };
80
- //# sourceMappingURL=worker-QZ5T6LJD.js.map
81
+ //# sourceMappingURL=worker-EODWT4KK.js.map
@@ -2,7 +2,8 @@
2
2
 
3
3
  [Back to the overview](../README.md)
4
4
 
5
- What runs where. Other pages link here instead of repeating requirements.
5
+ What runs where. Other pages link here instead of repeating requirements. What does not work yet
6
+ is on [Known issues](known-issues.md).
6
7
 
7
8
  ## Platforms
8
9
 
@@ -0,0 +1,17 @@
1
+ # Known issues
2
+
3
+ [Back to the overview](../README.md)
4
+
5
+ What the current release does not do yet, and what to do instead. An entry leaves this page in
6
+ the commit that fixes it, so the fix shows in that release's notes.
7
+
8
+ - macOS binaries are unsigned. They run when installed through npm, which sets no quarantine
9
+ flag. (`scripts/platform-packages.mjs`)
10
+ - Windows is not supported: the harness, `pmcp tui` and pmcp-pty stop with
11
+ `platform_unsupported`. (`src/harness/platform.ts`)
12
+ - `pmcp harness host up` and `host unit` need Linux with a user systemd manager; on macOS
13
+ they refuse with `platform_unsupported`. Use `pmcp tui` or a harness group there.
14
+ (`src/harness/platform.ts`)
15
+ - pmcp-browser and pmcp-desktop ship for Linux only. (`scripts/platform-packages.mjs`)
16
+ - `[sessions.roles]` applies to Claude Code only; Codex and the other runtimes send no agent
17
+ type. ([Hooks](hooks.md#runtime-support))
@@ -65,6 +65,7 @@ ignored.
65
65
  | `[ui.claude]` | [Claude session panes](#claude-session-panes) |
66
66
  | `[tui]`, `[mailbox]` | [Terminal workspace](terminal-workspace.md) |
67
67
  | `[host]`, `[[host.sessions]]`, `[[host.answers]]`, `[host.browser]`, `[host.desktop]`, `[[host.desktop.launch]]` | [Sessions pmcp-pty hosts](#sessions-pmcp-pty-hosts) |
68
+ | `[harness]` | [Terminal harness](terminal-harness.md#create-a-group-and-its-sessions) |
68
69
 
69
70
  ## Marketplaces
70
71
 
@@ -171,6 +172,7 @@ cwd = "." # inside the project
171
172
  argv = ["claude"] # default: the runtime's name
172
173
  labels = { task = "review" }
173
174
  restart = "on-exit" # or "no" (default); max_restarts defaults to 3
175
+ env = ["GOOGLE_CLOUD_PROJECT"] # names host up passes from its own environment
174
176
 
175
177
  [[host.answers]]
176
178
  runtime = "gemini"
@@ -185,6 +187,12 @@ name = "terminal" # what pmcp-desktop's launch tool takes
185
187
  argv = ["xterm"] # never a browser
186
188
  ```
187
189
 
190
+ `env` lists variable names, never values: `pmcp harness host up` reads each from
191
+ its own environment and passes it in that session's spawn request, so the session
192
+ gets it whether the pmcp-pty daemon started from this shell or from an installed
193
+ unit. A name that is unset or empty refuses that session (`host up` reports which),
194
+ and `pmcp doctor` shows each session's names as set or not set where it runs.
195
+
188
196
  Login and authentication (`auth-*`), folder and workspace trust and hook
189
197
  review dialogs are never answered: a `[[host.answers]]` entry naming one is a
190
198
  configuration error, and pmcp-pty refuses them whatever a policy says. Paths
@@ -165,6 +165,20 @@ pmcp harness group create --input group-spec.json
165
165
  pmcp harness group list
166
166
  ```
167
167
 
168
+ Add `"env": ["GOOGLE_CLOUD_PROJECT", "GOOGLE_CLOUD_LOCATION"]` to the group spec when
169
+ its runtimes need variables from your environment (a cloud project for gemini on
170
+ Vertex AI, for example). Without `env` in the spec, the group takes the project's
171
+ default from pmcp.toml:
172
+
173
+ ```toml
174
+ [harness]
175
+ env = ["GOOGLE_CLOUD_PROJECT", "GOOGLE_CLOUD_LOCATION"]
176
+ ```
177
+
178
+ Only the names are stored; each `session start` reads the
179
+ values from its own environment and refuses with `env_not_set:<names>` when one is
180
+ unset, instead of starting a runtime that waits for a login. Native groups only.
181
+
168
182
  The JSON receipt provides the private groupFile and generation. Set GROUP_FILE
169
183
  and GENERATION to those values for the examples below. Group state lives below
170
184
  XDG_STATE_HOME/pmcp/harness, or ~/.local/state/pmcp/harness. pmcp keeps the group
@@ -0,0 +1,23 @@
1
+ # Upgrading
2
+
3
+ [Back to the overview](../README.md)
4
+
5
+ What to do when a release changes something you rely on. Each release's notes on GitHub
6
+ Releases list its breaking changes and link here.
7
+
8
+ ## From 0.17 to 0.18
9
+
10
+ 0.18 replaces tmux with pmcp's own terminal host, so it does not read tmux groups or views.
11
+ Stop what 0.17 started before you upgrade, with the 0.17 release that created it:
12
+
13
+ ```sh
14
+ npx @modootoday/pmcp@0.17.4 tui recovery # a workspace from bare pmcp: prints groupFile and generation
15
+ npx @modootoday/pmcp@0.17.4 tui close --view "$VIEW_FILE"
16
+ npx @modootoday/pmcp@0.17.4 harness group inspect --group-file "$GROUP_FILE" # any other group: prints the generation
17
+ npx @modootoday/pmcp@0.17.4 harness group stop --group-file "$GROUP_FILE" --generation "$GENERATION"
18
+ ```
19
+
20
+ Then upgrade and start a new workspace with `pmcp tui --new` (plain `pmcp` once no 0.17
21
+ checkpoint is left). Scripts that called the removed `pmcp tui` view operations now get a
22
+ usage error (exit 2). The terminal workspace needs Linux or macOS; see
23
+ [Compatibility](compatibility.md).
@@ -1,11 +1,11 @@
1
1
  {
2
2
  "name": "pmcp",
3
- "version": "0.18.2",
3
+ "version": "0.18.4",
4
4
  "mcpServers": {
5
5
  "pmcp": {
6
6
  "type": "stdio",
7
7
  "command": "npx",
8
- "args": ["-y", "@modootoday/pmcp@0.18.2", "serve"]
8
+ "args": ["-y", "@modootoday/pmcp@0.18.4", "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.18.2", "serve"]
7
+ "args": ["-y", "@modootoday/pmcp@0.18.4", "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.18.2",
3
+ "version": "0.18.4",
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.",
@@ -75,7 +75,6 @@
75
75
  "docs/hooks/capabilities/*.json",
76
76
  "docs/*.md",
77
77
  "README.md",
78
- "CHANGELOG.md",
79
78
  "CONTRIBUTING.md",
80
79
  "SECURITY.md",
81
80
  "LICENSE",
@@ -137,9 +136,9 @@
137
136
  "bun": ">=1.3.0"
138
137
  },
139
138
  "optionalDependencies": {
140
- "@modootoday/pmcp-linux-x64": "0.18.2",
141
- "@modootoday/pmcp-linux-arm64": "0.18.2",
142
- "@modootoday/pmcp-darwin-x64": "0.18.2",
143
- "@modootoday/pmcp-darwin-arm64": "0.18.2"
139
+ "@modootoday/pmcp-linux-x64": "0.18.4",
140
+ "@modootoday/pmcp-linux-arm64": "0.18.4",
141
+ "@modootoday/pmcp-darwin-x64": "0.18.4",
142
+ "@modootoday/pmcp-darwin-arm64": "0.18.4"
144
143
  }
145
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.18.2",
4
+ "version": "0.18.4",
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.18.2",
3
+ "version": "0.18.4",
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.18.2", "serve"]
6
+ "args": ["-y", "@modootoday/pmcp@0.18.4", "serve"]
7
7
  }
8
8
  }
9
9
  }
@@ -1,11 +1,11 @@
1
1
  {
2
2
  "name": "pmcp",
3
- "version": "0.18.2",
3
+ "version": "0.18.4",
4
4
  "mcpServers": {
5
5
  "pmcp": {
6
6
  "type": "stdio",
7
7
  "command": "npx",
8
- "args": ["-y", "@modootoday/pmcp@0.18.2", "serve"]
8
+ "args": ["-y", "@modootoday/pmcp@0.18.4", "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.18.2", "serve"]
7
+ "args": ["-y", "@modootoday/pmcp@0.18.4", "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.18.2",
4
+ "version": "0.18.4",
5
5
  "description": "Find package skills and use native runtime project configuration.",
6
6
  "author": { "name": "modootoday" },
7
7
  "license": "Elastic-2.0",
@@ -21,14 +21,14 @@ tool files.
21
21
 
22
22
  List every source with its bytes and line count, and note which are links:
23
23
 
24
- | Found | Goes to |
25
- | --- | --- |
26
- | `CLAUDE.md`, `GEMINI.md`, `.cursorrules`, `.windsurfrules`, `.github/copilot-instructions.md` | merged into `AGENTS.md`; each then becomes a link to it |
27
- | `.claude/skills/<n>/`, `.agent/skills/<n>/` | `.agents/skills/<n>/` (whole folder) |
28
- | `.claude/commands/<n>.md`, `.agent/workflows/<n>.md` | `.agents/skills/<n>/SKILL.md` plus `[skills.<n>] invocation = "user"` |
29
- | `.claude/agents/<n>.md`, `.gemini/agents/<n>.md`, `.agent/agents/<n>.md` | `.agents/agents/<n>/agent.md` |
30
- | `.claude/rules/*.md` with `paths:` | `.agents/rules/<n>.md` with `trigger: glob` and `globs:` |
31
- | MCP entries in `.mcp.json`, `.gemini/settings.json`, `.codex/config.toml` | `[mcp.<alias>]` in `pmcp.toml` |
24
+ | Found | Goes to |
25
+ | --------------------------------------------------------------------------------------------- | --------------------------------------------------------------------- |
26
+ | `CLAUDE.md`, `GEMINI.md`, `.cursorrules`, `.windsurfrules`, `.github/copilot-instructions.md` | merged into `AGENTS.md`; each then becomes a link to it |
27
+ | `.claude/skills/<n>/`, `.agent/skills/<n>/` | `.agents/skills/<n>/` (whole folder) |
28
+ | `.claude/commands/<n>.md`, `.agent/workflows/<n>.md` | `.agents/skills/<n>/SKILL.md` plus `[skills.<n>] invocation = "user"` |
29
+ | `.claude/agents/<n>.md`, `.gemini/agents/<n>.md`, `.agent/agents/<n>.md` | `.agents/agents/<n>/agent.md` |
30
+ | `.claude/rules/*.md` with `paths:` | `.agents/rules/<n>.md` with `trigger: glob` and `globs:` |
31
+ | MCP entries in `.mcp.json`, `.gemini/settings.json`, `.codex/config.toml` | `[mcp.<alias>]` in `pmcp.toml` |
32
32
 
33
33
  pmcp has no Copilot or Cursor target. Keep those filenames as links to `AGENTS.md` so they
34
34
  cannot drift.
@@ -37,7 +37,9 @@ reason, not served.
37
37
  {
38
38
  "name": "acme",
39
39
  "metadata": { "tier": "open" },
40
- "plugins": [{ "name": "billing-skills", "source": "./plugins/billing-skills" }]
40
+ "plugins": [
41
+ { "name": "billing-skills", "source": "./plugins/billing-skills" }
42
+ ]
41
43
  }
42
44
  ```
43
45
 
@@ -55,13 +57,13 @@ name a different hooks file (a string path); otherwise `hooks/hooks.json` is rea
55
57
 
56
58
  ## What each place becomes
57
59
 
58
- | Place | Catalog entry | Name in the catalog |
59
- | --- | --- | --- |
60
- | `skills/<name>/SKILL.md` | a skill; its folder is what describe and read may open | `<marketplace>/<plugin>/<name>` |
61
- | `commands/<name>.md` | a one-file skill; only that file is readable | `<marketplace>/<plugin>/<name>` |
62
- | `agents/<name>.md`, `agents/<name>/agent.md` | kind `agent` | `<marketplace>/<plugin>/agents/<name>` |
63
- | `hooks/hooks.json` | one kind `hook` entry for the plugin; needs a `description` in the file or in plugin.json | `<marketplace>/<plugin>/hooks` |
64
- | `.mcp.json` | one kind `mcp` entry per key of `mcpServers` | `<marketplace>/<plugin>/mcp/<server>` |
60
+ | Place | Catalog entry | Name in the catalog |
61
+ | -------------------------------------------- | ----------------------------------------------------------------------------------------- | -------------------------------------- |
62
+ | `skills/<name>/SKILL.md` | a skill; its folder is what describe and read may open | `<marketplace>/<plugin>/<name>` |
63
+ | `commands/<name>.md` | a one-file skill; only that file is readable | `<marketplace>/<plugin>/<name>` |
64
+ | `agents/<name>.md`, `agents/<name>/agent.md` | kind `agent` | `<marketplace>/<plugin>/agents/<name>` |
65
+ | `hooks/hooks.json` | one kind `hook` entry for the plugin; needs a `description` in the file or in plugin.json | `<marketplace>/<plugin>/hooks` |
66
+ | `.mcp.json` | one kind `mcp` entry per key of `mcpServers` | `<marketplace>/<plugin>/mcp/<server>` |
65
67
 
66
68
  Skills and commands appear in `skill_catalog` and `skill_find`. Agents, hooks and MCP
67
69
  servers are left out unless the caller asks for that `kind` (`agent`, `hook`, `mcp` or
@@ -37,14 +37,14 @@ for code that is not there.
37
37
 
38
38
  These are the Agent Skills checks `pmcp validate` always runs:
39
39
 
40
- | Field | Rule |
41
- | --- | --- |
42
- | `name` | required; at most 64 characters; lowercase letters, digits and single hyphens, not starting or ending with one; equal to the directory name |
43
- | `description` | required, non-blank; at most 1024 characters |
44
- | `compatibility` | optional string; at most 500 characters |
45
- | `license` | optional string |
46
- | `allowed-tools` | optional; one space-separated string, not a list |
47
- | `metadata` | optional map |
40
+ | Field | Rule |
41
+ | --------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
42
+ | `name` | required; at most 64 characters; lowercase letters, digits and single hyphens, not starting or ending with one; equal to the directory name |
43
+ | `description` | required, non-blank; at most 1024 characters |
44
+ | `compatibility` | optional string; at most 500 characters |
45
+ | `license` | optional string |
46
+ | `allowed-tools` | optional; one space-separated string, not a list |
47
+ | `metadata` | optional map |
48
48
 
49
49
  A marketplace may add its own rules on top (a metadata schema, tiers, ASCII-only text).
50
50
  `pmcp validate` checks them only when `pmcp.toml` names a profile in `[catalog.validation]`
@@ -59,10 +59,10 @@ description: Draft a reply to a customer disputing an invoice ... Use when ... N
59
59
 
60
60
  ## Evals: three cases, each self-contained
61
61
 
62
- | Case | Tests |
63
- | --- | --- |
64
- | normal | the common request, with every input present |
65
- | exception | the input that should change the answer: a rule's exception, an edge value, a refusal |
62
+ | Case | Tests |
63
+ | ------------ | --------------------------------------------------------------------------------------------- |
64
+ | normal | the common request, with every input present |
65
+ | exception | the input that should change the answer: a rule's exception, an edge value, a refusal |
66
66
  | missing-info | a request lacking something essential; the skill must ask or state the assumption, not invent |
67
67
 
68
68
  Each `prompt.md` must carry everything the case needs. The grader's sandbox starts empty, so
@@ -21,14 +21,14 @@ tool files.
21
21
 
22
22
  List every source with its bytes and line count, and note which are links:
23
23
 
24
- | Found | Goes to |
25
- | --- | --- |
26
- | `CLAUDE.md`, `GEMINI.md`, `.cursorrules`, `.windsurfrules`, `.github/copilot-instructions.md` | merged into `AGENTS.md`; each then becomes a link to it |
27
- | `.claude/skills/<n>/`, `.agent/skills/<n>/` | `.agents/skills/<n>/` (whole folder) |
28
- | `.claude/commands/<n>.md`, `.agent/workflows/<n>.md` | `.agents/skills/<n>/SKILL.md` plus `[skills.<n>] invocation = "user"` |
29
- | `.claude/agents/<n>.md`, `.gemini/agents/<n>.md`, `.agent/agents/<n>.md` | `.agents/agents/<n>/agent.md` |
30
- | `.claude/rules/*.md` with `paths:` | `.agents/rules/<n>.md` with `trigger: glob` and `globs:` |
31
- | MCP entries in `.mcp.json`, `.gemini/settings.json`, `.codex/config.toml` | `[mcp.<alias>]` in `pmcp.toml` |
24
+ | Found | Goes to |
25
+ | --------------------------------------------------------------------------------------------- | --------------------------------------------------------------------- |
26
+ | `CLAUDE.md`, `GEMINI.md`, `.cursorrules`, `.windsurfrules`, `.github/copilot-instructions.md` | merged into `AGENTS.md`; each then becomes a link to it |
27
+ | `.claude/skills/<n>/`, `.agent/skills/<n>/` | `.agents/skills/<n>/` (whole folder) |
28
+ | `.claude/commands/<n>.md`, `.agent/workflows/<n>.md` | `.agents/skills/<n>/SKILL.md` plus `[skills.<n>] invocation = "user"` |
29
+ | `.claude/agents/<n>.md`, `.gemini/agents/<n>.md`, `.agent/agents/<n>.md` | `.agents/agents/<n>/agent.md` |
30
+ | `.claude/rules/*.md` with `paths:` | `.agents/rules/<n>.md` with `trigger: glob` and `globs:` |
31
+ | MCP entries in `.mcp.json`, `.gemini/settings.json`, `.codex/config.toml` | `[mcp.<alias>]` in `pmcp.toml` |
32
32
 
33
33
  pmcp has no Copilot or Cursor target. Keep those filenames as links to `AGENTS.md` so they
34
34
  cannot drift.
@@ -37,7 +37,9 @@ reason, not served.
37
37
  {
38
38
  "name": "acme",
39
39
  "metadata": { "tier": "open" },
40
- "plugins": [{ "name": "billing-skills", "source": "./plugins/billing-skills" }]
40
+ "plugins": [
41
+ { "name": "billing-skills", "source": "./plugins/billing-skills" }
42
+ ]
41
43
  }
42
44
  ```
43
45
 
@@ -55,13 +57,13 @@ name a different hooks file (a string path); otherwise `hooks/hooks.json` is rea
55
57
 
56
58
  ## What each place becomes
57
59
 
58
- | Place | Catalog entry | Name in the catalog |
59
- | --- | --- | --- |
60
- | `skills/<name>/SKILL.md` | a skill; its folder is what describe and read may open | `<marketplace>/<plugin>/<name>` |
61
- | `commands/<name>.md` | a one-file skill; only that file is readable | `<marketplace>/<plugin>/<name>` |
62
- | `agents/<name>.md`, `agents/<name>/agent.md` | kind `agent` | `<marketplace>/<plugin>/agents/<name>` |
63
- | `hooks/hooks.json` | one kind `hook` entry for the plugin; needs a `description` in the file or in plugin.json | `<marketplace>/<plugin>/hooks` |
64
- | `.mcp.json` | one kind `mcp` entry per key of `mcpServers` | `<marketplace>/<plugin>/mcp/<server>` |
60
+ | Place | Catalog entry | Name in the catalog |
61
+ | -------------------------------------------- | ----------------------------------------------------------------------------------------- | -------------------------------------- |
62
+ | `skills/<name>/SKILL.md` | a skill; its folder is what describe and read may open | `<marketplace>/<plugin>/<name>` |
63
+ | `commands/<name>.md` | a one-file skill; only that file is readable | `<marketplace>/<plugin>/<name>` |
64
+ | `agents/<name>.md`, `agents/<name>/agent.md` | kind `agent` | `<marketplace>/<plugin>/agents/<name>` |
65
+ | `hooks/hooks.json` | one kind `hook` entry for the plugin; needs a `description` in the file or in plugin.json | `<marketplace>/<plugin>/hooks` |
66
+ | `.mcp.json` | one kind `mcp` entry per key of `mcpServers` | `<marketplace>/<plugin>/mcp/<server>` |
65
67
 
66
68
  Skills and commands appear in `skill_catalog` and `skill_find`. Agents, hooks and MCP
67
69
  servers are left out unless the caller asks for that `kind` (`agent`, `hook`, `mcp` or