@modootoday/pmcp 0.22.12 → 0.23.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 (154) hide show
  1. package/.agents/plugins/marketplace.json +1 -1
  2. package/.claude-plugin/marketplace.json +1 -1
  3. package/.claude-plugin/plugin.json +1 -1
  4. package/.mcp.json +1 -1
  5. package/dist/affected-D6FRJPPI.js +836 -0
  6. package/dist/{apply-LPKZZ6EL.js → apply-3PWUO4J5.js} +27 -22
  7. package/dist/{available-BFXLII4A.js → available-74CMIBPD.js} +9 -9
  8. package/dist/{broadcast-DZGMSZRG.js → broadcast-VKZY7WSD.js} +6 -5
  9. package/dist/chunk-2GZKA33O.js +173 -0
  10. package/dist/chunk-2HL2MFNI.js +159 -0
  11. package/dist/{chunk-OAX6MIOZ.js → chunk-2K4WYN4C.js} +2 -2
  12. package/dist/{chunk-PEMMV5YQ.js → chunk-2MX5C7B2.js} +3 -3
  13. package/dist/{chunk-7I7O7ZNT.js → chunk-3V37OZQH.js} +5 -3
  14. package/dist/chunk-43MXRTKH.js +134 -0
  15. package/dist/chunk-4VVQLWTS.js +93 -0
  16. package/dist/{chunk-DYZVHO2L.js → chunk-5HNLHI5F.js} +2 -2
  17. package/dist/{chunk-JEL35P7S.js → chunk-5NDUWEMW.js} +2 -2
  18. package/dist/chunk-65BW7Y6O.js +40 -0
  19. package/dist/{chunk-HUBJWC7T.js → chunk-6NRLBSEG.js} +7 -7
  20. package/dist/chunk-6QJ3F445.js +166 -0
  21. package/dist/{chunk-2OOWAGBE.js → chunk-72V6U7CZ.js} +3 -3
  22. package/dist/{chunk-RPCIROW7.js → chunk-7CHUMF3E.js} +2 -2
  23. package/dist/{chunk-INT7QLEU.js → chunk-7DJQASH3.js} +25 -6
  24. package/dist/chunk-7IRXUPM2.js +7 -0
  25. package/dist/{chunk-UDVYVRGJ.js → chunk-DNSHJIS4.js} +2 -2
  26. package/dist/{chunk-UMQLIRSU.js → chunk-DZTSCJOZ.js} +3 -3
  27. package/dist/{chunk-KEHB4FZP.js → chunk-E2E4HIEN.js} +49 -3
  28. package/dist/{chunk-SUJCVEBM.js → chunk-EQF64INS.js} +3 -3
  29. package/dist/chunk-F3R5HEUB.js +39 -0
  30. package/dist/chunk-FOLA4EUJ.js +261 -0
  31. package/dist/chunk-FQLCD4HU.js +24 -0
  32. package/dist/{chunk-OEH47H6A.js → chunk-GUHOEIHP.js} +3 -20
  33. package/dist/{chunk-B2WRYGHJ.js → chunk-HES44LTA.js} +5 -5
  34. package/dist/{chunk-RHJEGLYM.js → chunk-HF5D6B2U.js} +45 -6
  35. package/dist/{chunk-R5MT42JS.js → chunk-HYXOJYVR.js} +2 -2
  36. package/dist/chunk-JANBBPKP.js +50 -0
  37. package/dist/{chunk-ITOTOC6Y.js → chunk-JJFPSFDU.js} +3 -3
  38. package/dist/{chunk-XNML2KIC.js → chunk-JPYQDOEW.js} +3 -3
  39. package/dist/{chunk-SPZQRLL5.js → chunk-KYGGQPAH.js} +18 -6
  40. package/dist/{chunk-EX4YXPVW.js → chunk-LGRFYN5T.js} +2 -2
  41. package/dist/{chunk-DP326AER.js → chunk-LO54UUDE.js} +2 -2
  42. package/dist/{chunk-5QKXEWDB.js → chunk-MHKY6TNF.js} +6 -4
  43. package/dist/chunk-N7ANFMA5.js +171 -0
  44. package/dist/{chunk-KPKMEUUH.js → chunk-OGCJO6HQ.js} +9 -8
  45. package/dist/{chunk-N63QCJHX.js → chunk-P25V6NEX.js} +5 -5
  46. package/dist/{chunk-PUIWESU3.js → chunk-Q6V274OB.js} +8 -6
  47. package/dist/chunk-QR6A3TYP.js +315 -0
  48. package/dist/{chunk-EIDIVIAD.js → chunk-QYLOIM4U.js} +9 -2
  49. package/dist/{chunk-MIFPPUWY.js → chunk-RRKA3GF5.js} +4 -4
  50. package/dist/{chunk-7CSUKCU7.js → chunk-RZYZILU4.js} +17 -96
  51. package/dist/{chunk-FODUHLZM.js → chunk-SDQYZDHS.js} +2 -2
  52. package/dist/chunk-SGFTHKKS.js +86 -0
  53. package/dist/chunk-T6C3TSTO.js +99 -0
  54. package/dist/chunk-UVTGY2R3.js +78 -0
  55. package/dist/{chunk-LLT5FQBE.js → chunk-VBVNOLRR.js} +7 -3
  56. package/dist/{chunk-ABTJQ4QV.js → chunk-WBPVNCQO.js} +20 -5
  57. package/dist/{chunk-63RZGEVI.js → chunk-WQBKQTNT.js} +98 -26
  58. package/dist/{chunk-YGOWIJPE.js → chunk-WZYGM3FR.js} +6 -2
  59. package/dist/chunk-Y6NFETNG.js +232 -0
  60. package/dist/{chunk-D5MIZM6L.js → chunk-YRNFMPZB.js} +7 -8
  61. package/dist/{chunk-2GRECE6B.js → chunk-ZXMECZBI.js} +4 -4
  62. package/dist/{cli-34EDFXJA.js → cli-GFDT4YXM.js} +14 -15
  63. package/dist/{cli-JXPJFHUA.js → cli-YWV7FLYO.js} +24 -12
  64. package/dist/cli.js +317 -51
  65. package/dist/{completion-KTECNPVY.js → completion-OKGNN7DE.js} +25 -21
  66. package/dist/{diagnostics-I5VZHK42.js → diagnostics-N4XRRCQG.js} +10 -6
  67. package/dist/{doctor-JJ2VUNHT.js → doctor-3H6UYNEA.js} +27 -23
  68. package/dist/{entry-OT7BN3ID.js → entry-KDLLG6ED.js} +19 -15
  69. package/dist/{exec-mcp-3E4SRJUY.js → exec-mcp-AENALAHJ.js} +15 -11
  70. package/dist/{harness-Q236VJSU.js → harness-GRYTNUF2.js} +26 -44
  71. package/dist/harness-launch-gate.js +8 -4
  72. package/dist/harness-worker.js +10 -6
  73. package/dist/heavy-BGXKJKYB.js +1965 -0
  74. package/dist/hook-body.js +69 -21
  75. package/dist/hooks-V25ANQ4Q.js +24 -0
  76. package/dist/{host-LT5JMUFJ.js → host-4EGPADOJ.js} +11 -7
  77. package/dist/{host-UDC4HVX3.js → host-MLSWY7D7.js} +24 -17
  78. package/dist/{host-run-LD63JGN7.js → host-run-VI52IUKF.js} +10 -6
  79. package/dist/http.js +1 -1
  80. package/dist/{import-mcp-URVONIZ3.js → import-mcp-FIXFLUDM.js} +18 -14
  81. package/dist/index.d.ts +1 -1
  82. package/dist/index.js +17 -12
  83. package/dist/init-ALTBFUPP.js +14 -0
  84. package/dist/{install-7V6NIA7W.js → install-5JH4DSFF.js} +10 -10
  85. package/dist/{invoke-JW5OC2HO.js → invoke-7T7UY57O.js} +12 -8
  86. package/dist/{list-UM4DYJRL.js → list-JFZ7UZLV.js} +18 -14
  87. package/dist/{list-WK2IYUK7.js → list-LV5EKCF6.js} +11 -7
  88. package/dist/{logout-H5X4D26I.js → logout-7CNBO76Z.js} +15 -11
  89. package/dist/{logs-UHJM7ZCL.js → logs-2JEMSNSG.js} +11 -10
  90. package/dist/{mailbox-NIMBOQPA.js → mailbox-5FVFMQ2J.js} +12 -44
  91. package/dist/{mailbox-YN6PG66A.js → mailbox-ZHZWZMAY.js} +14 -21
  92. package/dist/{mainline-74WCH4T4.js → mainline-6PBT3VNR.js} +75 -126
  93. package/dist/{marketplace-G4VQET5W.js → marketplace-2X3OOEPW.js} +10 -9
  94. package/dist/{mcp-6P3MVT4V.js → mcp-MVQVMAKJ.js} +4 -4
  95. package/dist/{mcp-AXHV547W.js → mcp-PBTQ5SJW.js} +2 -2
  96. package/dist/{models-ISU4DCMA.js → models-XSF45MCD.js} +9 -5
  97. package/dist/{pause-CBZ3BTJL.js → pause-CMZOIHTJ.js} +6 -5
  98. package/dist/{preview-DT7DWG5F.js → preview-465CQJBQ.js} +4 -4
  99. package/dist/{project-6QUIC73W.js → project-FZGJRG2U.js} +14 -12
  100. package/dist/{reindex-I7RYWCUR.js → reindex-D62HQAN2.js} +7 -7
  101. package/dist/{report-ZHOHQ4PZ.js → report-UB7MXAUB.js} +14 -13
  102. package/dist/{resume-UJEWQ66P.js → resume-PAKIT4TT.js} +6 -5
  103. package/dist/{run-HQTB7N2R.js → run-TOP37ZQC.js} +14 -10
  104. package/dist/run-VGJDMA2O.js +23 -0
  105. package/dist/{serve-APEVIJD2.js → serve-LR7SJHNH.js} +13 -13
  106. package/dist/{session-YZVX4NGN.js → session-3YVVO2GR.js} +6 -6
  107. package/dist/{setup-SOUBEZ3H.js → setup-6AQUOWOH.js} +7 -4
  108. package/dist/{smoke-2FI5D74B.js → smoke-6X6IXQIQ.js} +4 -4
  109. package/dist/{start-login-ER7DEGYN.js → start-login-X37KGCCB.js} +16 -12
  110. package/dist/{status-KN2ZE64O.js → status-4PYPTYUB.js} +7 -6
  111. package/dist/{status-7NYXRZ3R.js → status-E4AFUOQO.js} +24 -13
  112. package/dist/{status-OGABWCPO.js → status-LBRK37GA.js} +35 -30
  113. package/dist/stdio.js +2 -2
  114. package/dist/{sweep-EPZCW63Q.js → sweep-VURZU6DI.js} +6 -5
  115. package/dist/{test-WRZQERYC.js → test-D2EEFUN2.js} +18 -14
  116. package/dist/{tui-YUHQ36FC.js → tui-D7E3MD3X.js} +45 -19
  117. package/dist/{unbroadcast-N6LXHAMT.js → unbroadcast-7AMLURCG.js} +6 -5
  118. package/dist/{validate-KFBCUFI4.js → validate-YXR7FJJX.js} +11 -9
  119. package/dist/wait-HEODT7KV.js +141 -0
  120. package/dist/{worker-OKBJNDEI.js → worker-WTBC6VYO.js} +12 -8
  121. package/dist/{worktree-create-KMXPQXIQ.js → worktree-create-FTSLMZWS.js} +2 -2
  122. package/docs/commands.md +108 -36
  123. package/docs/git-workflow.md +51 -0
  124. package/docs/hooks.md +11 -4
  125. package/docs/project-configuration.md +136 -20
  126. package/docs/terminal-workspace.md +2 -0
  127. package/docs/upgrading.md +54 -0
  128. package/gemini-extension.json +2 -2
  129. package/mcp.json +1 -1
  130. package/package.json +5 -5
  131. package/plugin.json +1 -1
  132. package/plugins/pmcp/.claude-plugin/plugin.json +1 -1
  133. package/plugins/pmcp/.mcp.json +1 -1
  134. package/plugins/pmcp/gemini-extension.json +2 -2
  135. package/plugins/pmcp/mcp.json +1 -1
  136. package/plugins/pmcp/plugin.json +1 -1
  137. package/plugins/pmcp/skills/headless-agents-ci-scaffold/SKILL.md +1 -1
  138. package/plugins/pmcp/skills/pmcp-project-init/SKILL.md +1 -1
  139. package/plugins/pmcp/skills/pmcp-sessions-and-git/SKILL.md +3 -2
  140. package/skills/headless-agents-ci-scaffold/SKILL.md +1 -1
  141. package/skills/pmcp-project-init/SKILL.md +1 -1
  142. package/skills/pmcp-sessions-and-git/SKILL.md +3 -2
  143. package/dist/chunk-2P4Z2NUX.js +0 -28
  144. package/dist/chunk-3C5FVHQ3.js +0 -7
  145. package/dist/chunk-3Y3HDMHA.js +0 -108
  146. package/dist/chunk-A4PKLESO.js +0 -112
  147. package/dist/chunk-E3DQB5LS.js +0 -48
  148. package/dist/chunk-GFOQDLPL.js +0 -35
  149. package/dist/chunk-JWRZDYB5.js +0 -59
  150. package/dist/chunk-LMUBBIE2.js +0 -83
  151. package/dist/chunk-SMZPYJQI.js +0 -151
  152. package/dist/hooks-PABOEQO6.js +0 -24
  153. package/dist/init-4O24ZNUQ.js +0 -14
  154. package/dist/run-GZK3XJ62.js +0 -19
@@ -73,6 +73,8 @@ Config budget changes apply to a new group; existing groups keep their grants.
73
73
  `pmcp tui launch --yes` explicitly confirms the first start without the prompt.
74
74
  Launch still requires a supported interactive terminal. `pmcp tui plan` reports
75
75
  resolved settings and saved paths without writing or invoking a provider.
76
+ `plan`, `doctor`, `recovery` and `start-worker` print their receipt as text; add
77
+ `--json` for the [JSON envelope](commands.md#json-output).
76
78
  The launcher checkpoint lives under XDG_STATE_HOME/pmcp/launcher, or
77
79
  ~/.local/state/pmcp/launcher, with private file permissions.
78
80
 
package/docs/upgrading.md CHANGED
@@ -5,6 +5,60 @@
5
5
  What to do when a release changes something you rely on. Each release's notes on GitHub
6
6
  Releases list its breaking changes and link here.
7
7
 
8
+ ## From 0.22 to 0.23
9
+
10
+ 0.23.0 makes the command line behave like other command-line tools; several changes break
11
+ scripts that relied on the old behaviour.
12
+
13
+ **Results go to standard output.** The human result of a command (the `list`, `models`,
14
+ `marketplace list` and `doctor` tables, `validate` findings, the `status` summary, `hooks`
15
+ and `sessions` listings, an `install` or `sync` plan, and help you asked for with `--help`)
16
+ now goes to standard output; before, it went to standard error. Progress, summaries,
17
+ warnings and errors stay on standard error. `-q` silences only standard error (errors still
18
+ print), so `pmcp -q list` prints the table. A script that captured a table with `2>&1` or
19
+ `2>file` should read standard output instead; one that discarded standard output to keep a
20
+ terminal quiet should redirect it too. Off a terminal a table is now one unpadded record per line
21
+ (`name description`), and on a terminal it wraps to the width.
22
+
23
+ **A leading option `serve` does not accept no longer starts the server.** `pmcp -v`,
24
+ `pmcp -V` and `pmcp version` print the version, like `--version`. Any other leading option,
25
+ such as `-x` or `--verison`, exits 2. A host that starts the server with leading options
26
+ (`pmcp --root ./node_modules`) is unaffected; one that passed an option `serve` rejects was
27
+ already failing. A short flag a command does not declare (`pmcp list -j`) exits 2 instead of
28
+ being ignored; use `--` before a positional that starts with a dash. A word after
29
+ `pmcp list` or `pmcp models`, which take none, exits 2 instead of being ignored.
30
+
31
+ **Drift has its own exit code, 4.** `pmcp status` with drift or an exceeded budget,
32
+ `pmcp project --check` with drifted, stale or undeclared outputs, `project --check --smoke`
33
+ and `hooks test --fixtures` with a finding now exit 4; before, the first three exited 2,
34
+ the same code as a mistyped flag, and `hooks test --fixtures` exited 1. Exit 2 now means
35
+ only that the command could not run as asked (bad arguments, no `pmcp.toml`). A failed
36
+ fetch in `pmcp git deliver` or `pmcp git sync` now exits 1, like the other failures, rather
37
+ than 2. A CI step that treated any non-zero code as failure needs no change; one that tested
38
+ for `2` to detect drift should test for `4`. See
39
+ [Exit codes](commands.md#exit-codes).
40
+
41
+ **`--json` prints one envelope.** Every `--json` output is now one line,
42
+ `{"schema":"pmcp.<command>[.<subcommand>].v1","ok":…,"data":…,"errors":[…]}`, and it is
43
+ printed on failure too (before, a failure printed nothing on standard output). What a
44
+ command printed before is `data`, unchanged, `version: 1` included: read `.data.policies`
45
+ where you read `.policies`, `.data` where `models --json` gave a bare array. `ok` mirrors
46
+ exit code 0, and `errors` carries the messages that went to standard error. `mcp status`
47
+ and the `tui plan`, `tui doctor`, `tui recovery` and `tui start-worker` receipts are human
48
+ text unless `--json` is given; before, they always printed JSON. `mailbox` and `harness`
49
+ keep their JSON receipts unchanged. See [JSON output](commands.md#json-output).
50
+
51
+ ## From 0.22.12 to 0.22.13
52
+
53
+ **A gate command that exits 75 makes `pmcp git deliver` exit 75.** 75 now means a test stage
54
+ under `pmcp heavy` never got the host lease: deliver reports "gate not run: host busy,
55
+ nothing pushed, retry later" instead of a failed gate and exit 1. A gate that used 75 for
56
+ another failure should exit with another code.
57
+
58
+ **Words after `--` belong to the command.** `-q`, `--quiet`, `--color`, `--no-color` and
59
+ `--help` after a bare `--` are no longer read as pmcp's own options, so
60
+ `pmcp heavy -- grep -q x file` passes `-q` to grep.
61
+
8
62
  ## From 0.22.8 to 0.22.9
9
63
 
10
64
  **Guards read commands with the shell's grammar.** A `cd` chain, a subshell, a pipeline stage
@@ -1,11 +1,11 @@
1
1
  {
2
2
  "name": "pmcp",
3
- "version": "0.22.12",
3
+ "version": "0.23.1",
4
4
  "mcpServers": {
5
5
  "pmcp": {
6
6
  "type": "stdio",
7
7
  "command": "npx",
8
- "args": ["-y", "@modootoday/pmcp@0.22.12", "serve"]
8
+ "args": ["-y", "@modootoday/pmcp@0.23.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.22.12", "serve"]
7
+ "args": ["-y", "@modootoday/pmcp@0.23.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.22.12",
3
+ "version": "0.23.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.22.12",
140
- "@modootoday/pmcp-linux-arm64": "0.22.12",
141
- "@modootoday/pmcp-darwin-x64": "0.22.12",
142
- "@modootoday/pmcp-darwin-arm64": "0.22.12"
139
+ "@modootoday/pmcp-linux-x64": "0.23.1",
140
+ "@modootoday/pmcp-linux-arm64": "0.23.1",
141
+ "@modootoday/pmcp-darwin-x64": "0.23.1",
142
+ "@modootoday/pmcp-darwin-arm64": "0.23.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.22.12",
4
+ "version": "0.23.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.22.12",
3
+ "version": "0.23.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.22.12", "serve"]
6
+ "args": ["-y", "@modootoday/pmcp@0.23.1", "serve"]
7
7
  }
8
8
  }
9
9
  }
@@ -1,11 +1,11 @@
1
1
  {
2
2
  "name": "pmcp",
3
- "version": "0.22.12",
3
+ "version": "0.23.1",
4
4
  "mcpServers": {
5
5
  "pmcp": {
6
6
  "type": "stdio",
7
7
  "command": "npx",
8
- "args": ["-y", "@modootoday/pmcp@0.22.12", "serve"]
8
+ "args": ["-y", "@modootoday/pmcp@0.23.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.22.12", "serve"]
7
+ "args": ["-y", "@modootoday/pmcp@0.23.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.22.12",
4
+ "version": "0.23.1",
5
5
  "description": "Find package skills and use native runtime project configuration.",
6
6
  "author": { "name": "modootoday" },
7
7
  "license": "Elastic-2.0",
@@ -73,7 +73,7 @@ tool can supply and grep for it.
73
73
  ## Projection gate
74
74
 
75
75
  ```sh
76
- pmcp project --check # exit 2: generated files drifted, went stale or are undeclared
76
+ pmcp project --check # exit 4: generated files drifted, went stale or are undeclared
77
77
  pmcp doctor # exit 1 on any failed check
78
78
  ```
79
79
 
@@ -123,7 +123,7 @@ next prompt; SessionEnd hooks get at most 3 seconds.
123
123
 
124
124
  ```sh
125
125
  pmcp project # write; exits 1 if it would overwrite a file it did not write
126
- pmcp project --check # write nothing; exit 2 on drift, stale, undeclared or dead-glob outputs
126
+ pmcp project --check # write nothing; exit 4 on drift, stale, undeclared or dead-glob outputs
127
127
  pmcp doctor # exit 1 on any failed check; prints the feature x runtime table
128
128
  ```
129
129
 
@@ -65,8 +65,9 @@ pmcp git deliver <commit>... # only these
65
65
 
66
66
  It fetches, replays the commits onto the mainline, runs the gate in its own tree under a
67
67
  lock, and pushes, replaying again if the mainline moved. Exit 0 delivered or nothing to
68
- deliver; 1 refused (pause, lease, gate failure, attempts exhausted) with the reason on
69
- stderr; 2 the fetch failed. Fix what the gate reports; never bypass it with
68
+ deliver; 1 refused (pause, lease, gate failure, attempts exhausted, failed fetch) with the
69
+ reason on stderr; 75 the gate never got the host lease, so retry later. Fix what the gate
70
+ reports; never bypass it with
70
71
  `--no-verify` or a gate-bypass variable, which the guards refuse.
71
72
 
72
73
  `pmcp git sync` moves the main checkout to the mainline afterwards; it refuses (exit 2)
@@ -73,7 +73,7 @@ tool can supply and grep for it.
73
73
  ## Projection gate
74
74
 
75
75
  ```sh
76
- pmcp project --check # exit 2: generated files drifted, went stale or are undeclared
76
+ pmcp project --check # exit 4: generated files drifted, went stale or are undeclared
77
77
  pmcp doctor # exit 1 on any failed check
78
78
  ```
79
79
 
@@ -123,7 +123,7 @@ next prompt; SessionEnd hooks get at most 3 seconds.
123
123
 
124
124
  ```sh
125
125
  pmcp project # write; exits 1 if it would overwrite a file it did not write
126
- pmcp project --check # write nothing; exit 2 on drift, stale, undeclared or dead-glob outputs
126
+ pmcp project --check # write nothing; exit 4 on drift, stale, undeclared or dead-glob outputs
127
127
  pmcp doctor # exit 1 on any failed check; prints the feature x runtime table
128
128
  ```
129
129
 
@@ -65,8 +65,9 @@ pmcp git deliver <commit>... # only these
65
65
 
66
66
  It fetches, replays the commits onto the mainline, runs the gate in its own tree under a
67
67
  lock, and pushes, replaying again if the mainline moved. Exit 0 delivered or nothing to
68
- deliver; 1 refused (pause, lease, gate failure, attempts exhausted) with the reason on
69
- stderr; 2 the fetch failed. Fix what the gate reports; never bypass it with
68
+ deliver; 1 refused (pause, lease, gate failure, attempts exhausted, failed fetch) with the
69
+ reason on stderr; 75 the gate never got the host lease, so retry later. Fix what the gate
70
+ reports; never bypass it with
70
71
  `--no-verify` or a gate-bypass variable, which the guards refuse.
71
72
 
72
73
  `pmcp git sync` moves the main checkout to the mainline afterwards; it refuses (exit 2)
@@ -1,28 +0,0 @@
1
- // src/commands/specs/marketplace.ts
2
- var marketplaceSpec = {
3
- name: "marketplace",
4
- describe: "List free public plugins or export a selected native plugin",
5
- usage: "pmcp marketplace list | export <plugin> --runtime <runtime> --output <directory> [--json]",
6
- options: [
7
- {
8
- name: "runtime",
9
- describe: "Native plugin format: claude, codex, gemini, grok or agy.",
10
- placeholder: "<runtime>"
11
- },
12
- {
13
- name: "output",
14
- describe: "New directory for the selected plugin; existing paths are preserved.",
15
- placeholder: "<directory>"
16
- },
17
- {
18
- name: "json",
19
- describe: "Print machine-readable results.",
20
- boolean: true
21
- }
22
- ]
23
- };
24
-
25
- export {
26
- marketplaceSpec
27
- };
28
- //# sourceMappingURL=chunk-2P4Z2NUX.js.map
@@ -1,7 +0,0 @@
1
- // src/commands/version.ts
2
- var VERSION = "0.22.12";
3
-
4
- export {
5
- VERSION
6
- };
7
- //# sourceMappingURL=chunk-3C5FVHQ3.js.map
@@ -1,108 +0,0 @@
1
- // src/commands/harness/options.ts
2
- var harnessOptions = [
3
- {
4
- name: "include-starts",
5
- describe: "Include pending native starts in recovery inspection",
6
- boolean: true
7
- },
8
- {
9
- name: "columns",
10
- describe: "Terminal width in cells",
11
- placeholder: "<integer>"
12
- },
13
- {
14
- name: "rows",
15
- describe: "Terminal height including status",
16
- placeholder: "<integer>"
17
- },
18
- {
19
- name: "generation",
20
- describe: "Expected group generation for a mutation",
21
- placeholder: "<id>"
22
- },
23
- {
24
- name: "group-file",
25
- describe: "Private owned group state",
26
- placeholder: "<file>"
27
- },
28
- {
29
- name: "input",
30
- describe: "Group, session, read or watch specification JSON",
31
- placeholder: "<file>"
32
- },
33
- { name: "session", describe: "Owned native session ID", placeholder: "<id>" },
34
- {
35
- name: "lease-file",
36
- describe: "Private writer credential",
37
- placeholder: "<file>"
38
- },
39
- {
40
- name: "controller",
41
- describe: "Local controller identity",
42
- placeholder: "<id>"
43
- },
44
- {
45
- name: "mode",
46
- describe: "Control cli/native; attachment observe/write",
47
- placeholder: "<mode>"
48
- },
49
- {
50
- name: "request-id",
51
- describe: "Explicit input idempotency key",
52
- placeholder: "<id>"
53
- },
54
- {
55
- name: "text-file",
56
- describe: "Literal single-line UTF-8 input without submission",
57
- placeholder: "<file>"
58
- }
59
- ];
60
-
61
- // src/commands/tui/options.ts
62
- var tuiOptions = [
63
- {
64
- name: "memory-mb",
65
- describe: "Worker memory reservation",
66
- placeholder: "<count>"
67
- },
68
- {
69
- name: "config",
70
- describe: "Project pmcp.toml",
71
- placeholder: "<file>"
72
- },
73
- {
74
- name: "runtime",
75
- describe: "Native runtime ID for main launch or worker start",
76
- placeholder: "<runtime>"
77
- },
78
- {
79
- name: "yes",
80
- describe: "Confirm the first native runtime start",
81
- boolean: true
82
- },
83
- {
84
- name: "new",
85
- describe: "Create a workspace after the previous group is stopped",
86
- boolean: true
87
- }
88
- ];
89
-
90
- // src/commands/specs/terminal.ts
91
- var harnessSpec = {
92
- name: "harness",
93
- describe: "Manage optional owned native sessions independently of the MCP server",
94
- usage: "pmcp harness layout | family operation [options]",
95
- options: harnessOptions
96
- };
97
- var tuiSpec = {
98
- name: "tui",
99
- describe: "Open a native terminal workspace with optional configuration",
100
- usage: "pmcp tui [--config <file>] [--runtime <id>] | plan | recovery | doctor | start-worker --runtime <id>",
101
- options: tuiOptions
102
- };
103
-
104
- export {
105
- harnessSpec,
106
- tuiSpec
107
- };
108
- //# sourceMappingURL=chunk-3Y3HDMHA.js.map
@@ -1,112 +0,0 @@
1
- // src/cli/command.ts
2
- var EXIT = {
3
- ok: 0,
4
- failure: 1,
5
- usage: 2,
6
- missingOptional: 3
7
- };
8
- var ArgumentError = class extends Error {
9
- constructor(message) {
10
- super(message);
11
- this.name = "ArgumentError";
12
- }
13
- };
14
- function parseArgs(argv, specs = []) {
15
- const byName = new Map(specs.map((spec) => [spec.name, spec]));
16
- const positional = [];
17
- const options = /* @__PURE__ */ new Map();
18
- const flags = /* @__PURE__ */ new Set();
19
- for (let i = 0; i < argv.length; i += 1) {
20
- const arg = argv[i];
21
- if (arg === "--") {
22
- positional.push(...argv.slice(i + 1));
23
- break;
24
- }
25
- if (!arg.startsWith("--")) {
26
- positional.push(arg);
27
- continue;
28
- }
29
- const eq = arg.indexOf("=");
30
- const name = eq === -1 ? arg.slice(2) : arg.slice(2, eq);
31
- const spec = byName.get(name);
32
- if (spec === void 0) {
33
- throw new ArgumentError(`unknown option --${name}`);
34
- }
35
- if (spec.boolean === true) {
36
- if (eq !== -1) {
37
- throw new ArgumentError(`--${name} does not take a value`);
38
- }
39
- flags.add(name);
40
- continue;
41
- }
42
- const value = eq === -1 ? argv[++i] : arg.slice(eq + 1);
43
- if (value === void 0 || value === "" || value.startsWith("--")) {
44
- throw new ArgumentError(`--${name} needs a value`);
45
- }
46
- const existing = options.get(name);
47
- if (existing !== void 0 && spec.repeat !== true) {
48
- throw new ArgumentError(`--${name} was given more than once`);
49
- }
50
- options.set(name, [...existing ?? [], value]);
51
- }
52
- return { positional, options, flags };
53
- }
54
- function one(args, name) {
55
- return args.options.get(name)?.[0];
56
- }
57
- function many(args, name) {
58
- return args.options.get(name) ?? [];
59
- }
60
- function printCommandHelp(ui, command) {
61
- ui.heading(`pmcp ${command.name}`);
62
- ui.line(` ${command.describe}`);
63
- ui.line();
64
- ui.line(` ${ui.paint(command.usage, "dim")}`);
65
- if (command.options && command.options.length > 0) {
66
- ui.line();
67
- ui.table(
68
- command.options.map((option) => [
69
- `--${option.name}${option.placeholder ? ` ${option.placeholder}` : ""}`,
70
- option.describe
71
- ])
72
- );
73
- }
74
- ui.line();
75
- }
76
- function printHelp(ui, commands, notImplemented) {
77
- ui.heading("pmcp \u2014 the skills your installed packages ship");
78
- ui.line();
79
- ui.table(commands.map((command) => [command.name, command.describe]));
80
- ui.line();
81
- ui.line(
82
- " With no command, pmcp opens a terminal workspace on a supported TTY."
83
- );
84
- ui.line(
85
- " Piped launches retain MCP stdio. Use pmcp serve explicitly for MCP."
86
- );
87
- ui.line();
88
- ui.table([
89
- ["-q, --quiet", "only errors"],
90
- ["--no-color", "never colour output; NO_COLOR is honoured too"],
91
- ["--version", "print the version"],
92
- ["-h, --help", "this, or help for one command"]
93
- ]);
94
- ui.line();
95
- if (notImplemented.length > 0) {
96
- ui.line(
97
- ` ${ui.paint(`not implemented yet: ${notImplemented.join(", ")}`, "dim")}`
98
- );
99
- ui.line();
100
- }
101
- }
102
-
103
- export {
104
- EXIT,
105
- ArgumentError,
106
- parseArgs,
107
- one,
108
- many,
109
- printCommandHelp,
110
- printHelp
111
- };
112
- //# sourceMappingURL=chunk-A4PKLESO.js.map
@@ -1,48 +0,0 @@
1
- import {
2
- jsonOption
3
- } from "./chunk-XNML2KIC.js";
4
-
5
- // src/commands/specs/mcp.ts
6
- var mcpSpec = {
7
- name: "mcp",
8
- describe: "Manage the project's shared remote MCP authentication",
9
- usage: "pmcp mcp <login|logout|status> <name> [--config <file>]",
10
- options: [
11
- jsonOption,
12
- {
13
- name: "config",
14
- describe: "Read this project configuration.",
15
- placeholder: "<file>"
16
- },
17
- {
18
- name: "code",
19
- describe: "Complete a pending login with a callback URL or authorization code.",
20
- placeholder: "<callback-or-code>"
21
- },
22
- {
23
- name: "no-wait",
24
- describe: "Print the authorization URL and save a pending login for later completion.",
25
- boolean: true
26
- },
27
- {
28
- name: "port",
29
- describe: "Loopback callback port; zero chooses an available port.",
30
- placeholder: "<port>"
31
- },
32
- {
33
- name: "client-id",
34
- describe: "Use a pre-registered OAuth client identifier.",
35
- placeholder: "<id>"
36
- },
37
- {
38
- name: "bearer-env",
39
- describe: "Store a bearer session from this environment variable without printing it.",
40
- placeholder: "<name>"
41
- }
42
- ]
43
- };
44
-
45
- export {
46
- mcpSpec
47
- };
48
- //# sourceMappingURL=chunk-E3DQB5LS.js.map
@@ -1,35 +0,0 @@
1
- import {
2
- configOption,
3
- jsonOption
4
- } from "./chunk-XNML2KIC.js";
5
-
6
- // src/commands/specs/git.ts
7
- var gitSpec = {
8
- name: "git",
9
- describe: "Create and sync worktrees, deliver commits to the mainline, sync the main checkout",
10
- usage: "pmcp git worktree create <alias> | worktree list | worktree sync | deliver [<commit>...] | sync",
11
- options: [
12
- jsonOption,
13
- configOption,
14
- {
15
- name: "base",
16
- describe: "Start a new worktree from this ref instead of the upstream",
17
- placeholder: "<ref>"
18
- },
19
- {
20
- name: "during-pause",
21
- describe: "Deliver although the sessions are paused",
22
- boolean: true
23
- },
24
- {
25
- name: "no-push",
26
- describe: "Replay and gate, then stop without pushing",
27
- boolean: true
28
- }
29
- ]
30
- };
31
-
32
- export {
33
- gitSpec
34
- };
35
- //# sourceMappingURL=chunk-GFOQDLPL.js.map
@@ -1,59 +0,0 @@
1
- import {
2
- configOption
3
- } from "./chunk-XNML2KIC.js";
4
-
5
- // src/commands/specs/mailbox.ts
6
- var mailboxSpec = {
7
- name: "mailbox",
8
- describe: "Manage opt-in local peer mail and launcher credentials",
9
- usage: "pmcp mailbox operation [--config <file>] [options]",
10
- options: [
11
- configOption,
12
- {
13
- name: "state-dir",
14
- describe: "Private mailbox state directory",
15
- placeholder: "<dir>"
16
- },
17
- { name: "actor", describe: "Registered actor ID", placeholder: "<id>" },
18
- {
19
- name: "actor-file",
20
- describe: "Private actor credential file",
21
- placeholder: "<file>"
22
- },
23
- {
24
- name: "binding-file",
25
- describe: "Private existing attachment file",
26
- placeholder: "<file>"
27
- },
28
- {
29
- name: "parent-binding",
30
- describe: "Live parent attachment for bounded child delegation",
31
- placeholder: "<file>"
32
- },
33
- {
34
- name: "input",
35
- describe: "Operation input JSON or backup source",
36
- placeholder: "<file>"
37
- },
38
- {
39
- name: "output",
40
- describe: "New export or backup destination",
41
- placeholder: "<file>"
42
- },
43
- {
44
- name: "scope-actor",
45
- describe: "Limit export to one actor's correspondence",
46
- placeholder: "<id>"
47
- },
48
- {
49
- name: "operator",
50
- describe: "Explicit local administrator intent",
51
- boolean: true
52
- }
53
- ]
54
- };
55
-
56
- export {
57
- mailboxSpec
58
- };
59
- //# sourceMappingURL=chunk-JWRZDYB5.js.map