@modootoday/pmcp 0.22.13 → 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 (144) 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-ZWO2F5EM.js → affected-D6FRJPPI.js} +2 -2
  6. package/dist/{apply-OIKQ5SIY.js → apply-3PWUO4J5.js} +20 -19
  7. package/dist/{available-Z5MIDFPH.js → available-74CMIBPD.js} +9 -9
  8. package/dist/{broadcast-BF2QL3O7.js → broadcast-VKZY7WSD.js} +3 -3
  9. package/dist/chunk-2GZKA33O.js +173 -0
  10. package/dist/chunk-2HL2MFNI.js +159 -0
  11. package/dist/{chunk-5PNS6V5C.js → chunk-2K4WYN4C.js} +2 -2
  12. package/dist/{chunk-4O4ZOSBQ.js → chunk-2MX5C7B2.js} +3 -3
  13. package/dist/chunk-43MXRTKH.js +134 -0
  14. package/dist/chunk-4VVQLWTS.js +93 -0
  15. package/dist/{chunk-24L4MO7H.js → chunk-5HNLHI5F.js} +2 -2
  16. package/dist/{chunk-JEL35P7S.js → chunk-5NDUWEMW.js} +2 -2
  17. package/dist/{chunk-737BENAU.js → chunk-6NRLBSEG.js} +5 -5
  18. package/dist/chunk-6QJ3F445.js +166 -0
  19. package/dist/{chunk-7ZOQELXR.js → chunk-72V6U7CZ.js} +3 -3
  20. package/dist/{chunk-J3QUG6O5.js → chunk-7CHUMF3E.js} +2 -2
  21. package/dist/{chunk-INT7QLEU.js → chunk-7DJQASH3.js} +25 -6
  22. package/dist/chunk-7IRXUPM2.js +7 -0
  23. package/dist/{chunk-UED3RH53.js → chunk-DNSHJIS4.js} +2 -2
  24. package/dist/{chunk-ISGBOJT7.js → chunk-DZTSCJOZ.js} +3 -3
  25. package/dist/{chunk-KEHB4FZP.js → chunk-E2E4HIEN.js} +49 -3
  26. package/dist/{chunk-VNZTULFD.js → chunk-EQF64INS.js} +3 -3
  27. package/dist/{chunk-G4ATQPQI.js → chunk-F3R5HEUB.js} +5 -1
  28. package/dist/{chunk-JW5NMQTU.js → chunk-HES44LTA.js} +4 -4
  29. package/dist/{chunk-RHJEGLYM.js → chunk-HF5D6B2U.js} +45 -6
  30. package/dist/{chunk-5OFQVW2K.js → chunk-HYXOJYVR.js} +2 -2
  31. package/dist/chunk-JANBBPKP.js +50 -0
  32. package/dist/{chunk-A6DARDQ4.js → chunk-JJFPSFDU.js} +2 -2
  33. package/dist/{chunk-XNML2KIC.js → chunk-JPYQDOEW.js} +3 -3
  34. package/dist/{chunk-733WVP2R.js → chunk-KYGGQPAH.js} +2 -2
  35. package/dist/{chunk-NNGGNXF2.js → chunk-LGRFYN5T.js} +2 -2
  36. package/dist/{chunk-GNVME5AD.js → chunk-LO54UUDE.js} +2 -2
  37. package/dist/{chunk-XSWF7APE.js → chunk-OGCJO6HQ.js} +9 -8
  38. package/dist/{chunk-T4GVN7XO.js → chunk-P25V6NEX.js} +5 -5
  39. package/dist/{chunk-A7XCUR2C.js → chunk-Q6V274OB.js} +8 -6
  40. package/dist/chunk-QR6A3TYP.js +315 -0
  41. package/dist/{chunk-EIDIVIAD.js → chunk-QYLOIM4U.js} +9 -2
  42. package/dist/{chunk-ZKB7ZNKY.js → chunk-RRKA3GF5.js} +4 -4
  43. package/dist/{chunk-P5D6RKMT.js → chunk-RZYZILU4.js} +5 -3
  44. package/dist/{chunk-5IZFEVPW.js → chunk-SDQYZDHS.js} +2 -2
  45. package/dist/chunk-UVTGY2R3.js +78 -0
  46. package/dist/{chunk-LLT5FQBE.js → chunk-VBVNOLRR.js} +7 -3
  47. package/dist/{chunk-ABTJQ4QV.js → chunk-WBPVNCQO.js} +20 -5
  48. package/dist/{chunk-K2VU3B4W.js → chunk-WQBKQTNT.js} +3 -3
  49. package/dist/{chunk-YGOWIJPE.js → chunk-WZYGM3FR.js} +6 -2
  50. package/dist/chunk-Y6NFETNG.js +232 -0
  51. package/dist/{chunk-5KWDQFVY.js → chunk-YRNFMPZB.js} +7 -8
  52. package/dist/{chunk-ZS5IDQFJ.js → chunk-ZXMECZBI.js} +4 -4
  53. package/dist/{cli-IHVNE3WL.js → cli-GFDT4YXM.js} +14 -15
  54. package/dist/{cli-FSSYFCV3.js → cli-YWV7FLYO.js} +18 -12
  55. package/dist/cli.js +307 -47
  56. package/dist/{completion-ZTTJVV4C.js → completion-OKGNN7DE.js} +25 -23
  57. package/dist/{diagnostics-XC5L6Z3E.js → diagnostics-N4XRRCQG.js} +5 -5
  58. package/dist/{doctor-FGDSUBR3.js → doctor-3H6UYNEA.js} +20 -20
  59. package/dist/{entry-NNB2CQLZ.js → entry-KDLLG6ED.js} +9 -9
  60. package/dist/{exec-mcp-ZU3Z3XT6.js → exec-mcp-AENALAHJ.js} +8 -8
  61. package/dist/{harness-B7ANLH5M.js → harness-GRYTNUF2.js} +26 -44
  62. package/dist/harness-launch-gate.js +3 -3
  63. package/dist/harness-worker.js +5 -5
  64. package/dist/{heavy-IIZBO4YM.js → heavy-BGXKJKYB.js} +78 -22
  65. package/dist/hooks-V25ANQ4Q.js +24 -0
  66. package/dist/{host-XXWQ23LD.js → host-4EGPADOJ.js} +6 -6
  67. package/dist/{host-5P4D7GSE.js → host-MLSWY7D7.js} +17 -14
  68. package/dist/{host-run-AEWHFVQL.js → host-run-VI52IUKF.js} +5 -5
  69. package/dist/http.js +1 -1
  70. package/dist/{import-mcp-BQM5DKYH.js → import-mcp-FIXFLUDM.js} +11 -11
  71. package/dist/index.d.ts +1 -1
  72. package/dist/index.js +10 -9
  73. package/dist/init-ALTBFUPP.js +14 -0
  74. package/dist/{install-OFVLR7TI.js → install-5JH4DSFF.js} +10 -10
  75. package/dist/{invoke-3BQ5NG3P.js → invoke-7T7UY57O.js} +7 -7
  76. package/dist/{list-EU4MJOXA.js → list-JFZ7UZLV.js} +11 -11
  77. package/dist/{list-WWYCGD3X.js → list-LV5EKCF6.js} +11 -7
  78. package/dist/{logout-6DFDYJUI.js → logout-7CNBO76Z.js} +8 -8
  79. package/dist/{logs-BRF6DBKG.js → logs-2JEMSNSG.js} +7 -7
  80. package/dist/{mailbox-QYA2LQSE.js → mailbox-5FVFMQ2J.js} +6 -6
  81. package/dist/{mailbox-AQCTXO3H.js → mailbox-ZHZWZMAY.js} +14 -21
  82. package/dist/{mainline-O5AEHG3J.js → mainline-6PBT3VNR.js} +8 -7
  83. package/dist/{marketplace-TI5HFAHB.js → marketplace-2X3OOEPW.js} +10 -9
  84. package/dist/{mcp-HR5JFUW7.js → mcp-MVQVMAKJ.js} +4 -4
  85. package/dist/{mcp-4R53HSGY.js → mcp-PBTQ5SJW.js} +2 -2
  86. package/dist/{models-63NQBSV3.js → models-XSF45MCD.js} +9 -5
  87. package/dist/{pause-UF7FQDJX.js → pause-CMZOIHTJ.js} +3 -3
  88. package/dist/{preview-WSESS2UN.js → preview-465CQJBQ.js} +4 -4
  89. package/dist/{project-JXXL24WN.js → project-FZGJRG2U.js} +14 -12
  90. package/dist/{reindex-3GPKAFBW.js → reindex-D62HQAN2.js} +7 -7
  91. package/dist/{report-JUSKQPAC.js → report-UB7MXAUB.js} +10 -10
  92. package/dist/{resume-3WAROOQ3.js → resume-PAKIT4TT.js} +3 -3
  93. package/dist/{run-XRWU4L73.js → run-TOP37ZQC.js} +7 -7
  94. package/dist/run-VGJDMA2O.js +23 -0
  95. package/dist/{serve-OEX5V5CD.js → serve-LR7SJHNH.js} +13 -13
  96. package/dist/{session-YZVX4NGN.js → session-3YVVO2GR.js} +6 -6
  97. package/dist/{setup-SWNAC2C7.js → setup-6AQUOWOH.js} +3 -2
  98. package/dist/{smoke-5BGJXAHX.js → smoke-6X6IXQIQ.js} +4 -4
  99. package/dist/{start-login-MG26NDE3.js → start-login-X37KGCCB.js} +9 -9
  100. package/dist/{status-GKCIVAAR.js → status-4PYPTYUB.js} +4 -4
  101. package/dist/{status-APADL7O2.js → status-E4AFUOQO.js} +17 -10
  102. package/dist/{status-LH7Q255G.js → status-LBRK37GA.js} +27 -26
  103. package/dist/stdio.js +2 -2
  104. package/dist/{sweep-VTVPDAPY.js → sweep-VURZU6DI.js} +3 -3
  105. package/dist/{test-TK2J3IB7.js → test-D2EEFUN2.js} +11 -11
  106. package/dist/{tui-YTPHHKCW.js → tui-D7E3MD3X.js} +45 -19
  107. package/dist/{unbroadcast-CH7BAQ2G.js → unbroadcast-7AMLURCG.js} +3 -3
  108. package/dist/{validate-5QVZBE6W.js → validate-YXR7FJJX.js} +11 -9
  109. package/dist/{wait-4HYJJAWO.js → wait-HEODT7KV.js} +3 -3
  110. package/dist/{worker-RBXYAMR4.js → worker-WTBC6VYO.js} +7 -7
  111. package/dist/{worktree-create-FEZNQUQ6.js → worktree-create-FTSLMZWS.js} +2 -2
  112. package/docs/commands.md +64 -28
  113. package/docs/hooks.md +3 -3
  114. package/docs/project-configuration.md +33 -33
  115. package/docs/terminal-workspace.md +2 -0
  116. package/docs/upgrading.md +43 -0
  117. package/gemini-extension.json +2 -2
  118. package/mcp.json +1 -1
  119. package/package.json +5 -5
  120. package/plugin.json +1 -1
  121. package/plugins/pmcp/.claude-plugin/plugin.json +1 -1
  122. package/plugins/pmcp/.mcp.json +1 -1
  123. package/plugins/pmcp/gemini-extension.json +2 -2
  124. package/plugins/pmcp/mcp.json +1 -1
  125. package/plugins/pmcp/plugin.json +1 -1
  126. package/plugins/pmcp/skills/headless-agents-ci-scaffold/SKILL.md +1 -1
  127. package/plugins/pmcp/skills/pmcp-project-init/SKILL.md +1 -1
  128. package/plugins/pmcp/skills/pmcp-sessions-and-git/SKILL.md +3 -2
  129. package/skills/headless-agents-ci-scaffold/SKILL.md +1 -1
  130. package/skills/pmcp-project-init/SKILL.md +1 -1
  131. package/skills/pmcp-sessions-and-git/SKILL.md +3 -2
  132. package/dist/chunk-2P4Z2NUX.js +0 -28
  133. package/dist/chunk-3Y3HDMHA.js +0 -108
  134. package/dist/chunk-74O7KZUH.js +0 -45
  135. package/dist/chunk-BN4XAXMQ.js +0 -65
  136. package/dist/chunk-E3DQB5LS.js +0 -48
  137. package/dist/chunk-JWRZDYB5.js +0 -59
  138. package/dist/chunk-LMUBBIE2.js +0 -83
  139. package/dist/chunk-QBSJL3SP.js +0 -162
  140. package/dist/chunk-VSTUKACC.js +0 -7
  141. package/dist/chunk-WFY7ATSZ.js +0 -116
  142. package/dist/hooks-IEJTW7BV.js +0 -24
  143. package/dist/init-L6GUO3PW.js +0 -14
  144. package/dist/run-VUUQS4WY.js +0 -19
@@ -0,0 +1,315 @@
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: "json",
65
+ describe: "Print the result as one JSON envelope on stdout.",
66
+ boolean: true
67
+ },
68
+ {
69
+ name: "memory-mb",
70
+ describe: "Worker memory reservation",
71
+ placeholder: "<count>"
72
+ },
73
+ {
74
+ name: "config",
75
+ describe: "A pmcp.toml to read instead of the nearest one.",
76
+ placeholder: "<file>"
77
+ },
78
+ {
79
+ name: "runtime",
80
+ describe: "Native runtime ID for main launch or worker start",
81
+ placeholder: "<runtime>"
82
+ },
83
+ {
84
+ name: "yes",
85
+ describe: "Confirm the first native runtime start",
86
+ boolean: true,
87
+ short: "y"
88
+ },
89
+ {
90
+ name: "new",
91
+ describe: "Create a workspace after the previous group is stopped",
92
+ boolean: true
93
+ }
94
+ ];
95
+
96
+ // src/commands/specs/harness-operations.ts
97
+ var common = ["group-file", "generation"];
98
+ var HARNESS_OPERATIONS = {
99
+ "capabilities:inspect": {
100
+ describe: "Report what this host can run",
101
+ options: []
102
+ },
103
+ "doctor:inspect": { describe: "Check host prerequisites", options: [] },
104
+ "group:create": {
105
+ describe: "Create an owned session group from --input",
106
+ options: ["input"]
107
+ },
108
+ "group:list": { describe: "List owned groups", options: [] },
109
+ "group:inspect": {
110
+ describe: "Show one group",
111
+ options: ["group-file"]
112
+ },
113
+ "group:configure": {
114
+ describe: "Change a group's settings from --input",
115
+ options: [...common, "input"]
116
+ },
117
+ "group:pause": {
118
+ describe: "Pause every session of a group",
119
+ options: common
120
+ },
121
+ "group:resume": { describe: "Resume a paused group", options: common },
122
+ "group:stop": { describe: "Stop a group and its sessions", options: common },
123
+ "session:start": {
124
+ describe: "Start a main or worker session from --input",
125
+ options: [...common, "input"]
126
+ },
127
+ "session:list": {
128
+ describe: "List a group's sessions",
129
+ options: ["group-file"]
130
+ },
131
+ "session:inspect": {
132
+ describe: "Show one session",
133
+ options: ["group-file", "session"]
134
+ },
135
+ "session:read": {
136
+ describe: "Read a session's recent output",
137
+ options: ["group-file", "session", "input"]
138
+ },
139
+ "session:watch": {
140
+ describe: "Follow a session's output",
141
+ options: ["group-file", "session", "input"]
142
+ },
143
+ "session:stop": {
144
+ describe: "Stop one session",
145
+ options: [...common, "session"]
146
+ },
147
+ "control:acquire": {
148
+ describe: "Take the input lease of a session",
149
+ options: [...common, "session", "controller", "mode"]
150
+ },
151
+ "control:renew": {
152
+ describe: "Renew a held input lease",
153
+ options: [...common, "lease-file"]
154
+ },
155
+ "control:release": {
156
+ describe: "Give the input lease back",
157
+ options: [...common, "lease-file"]
158
+ },
159
+ "input:write": {
160
+ describe: "Type text into a session without submitting it",
161
+ options: [...common, "lease-file", "request-id", "text-file"]
162
+ },
163
+ "input:submit": {
164
+ describe: "Submit what was written",
165
+ options: [...common, "lease-file", "request-id"]
166
+ },
167
+ "input:interrupt": {
168
+ describe: "Interrupt the session's current turn",
169
+ options: [...common, "lease-file"]
170
+ },
171
+ "attach:open": {
172
+ describe: "Attach a terminal to a session, read only unless --mode write",
173
+ options: [...common, "session", "mode", "lease-file"]
174
+ },
175
+ "attach:inspect": {
176
+ describe: "Show a session's attachments",
177
+ options: ["group-file", "session"]
178
+ },
179
+ "attach:detach": {
180
+ describe: "Detach from a session",
181
+ options: [...common, "session"]
182
+ },
183
+ "delivery:list": {
184
+ describe: "List input deliveries",
185
+ options: ["group-file"]
186
+ },
187
+ "delivery:inspect": {
188
+ describe: "Show one input delivery",
189
+ options: ["group-file", "request-id"]
190
+ },
191
+ "recovery:inspect": {
192
+ describe: "Find sessions and starts that need recovery",
193
+ options: ["group-file", "include-starts"]
194
+ },
195
+ "recovery:reconcile": {
196
+ describe: "Reconcile recorded state with live processes",
197
+ options: common
198
+ },
199
+ "recovery:replace-main": {
200
+ describe: "Replace a lost main session from --input",
201
+ options: [...common, "input"]
202
+ },
203
+ "recovery:stop-orphan": {
204
+ describe: "Stop a session no group owns",
205
+ options: [...common, "session"]
206
+ },
207
+ "recovery:abort-start": {
208
+ describe: "Abort a session start that never finished",
209
+ options: [...common, "session"]
210
+ }
211
+ };
212
+
213
+ // src/commands/specs/terminal.ts
214
+ var HOST = [
215
+ ["approve", "Record your approval of the projected [host] policy"],
216
+ ["status", "Whether the projected policy is approved"],
217
+ ["up", "Start pmcp-pty and the approved sessions (Linux)"],
218
+ ["down", "Stop the host's sessions"],
219
+ ["unit", "Print a systemd user unit for pmcp-pty (Linux)"]
220
+ ].map(([verb, describe]) => ({
221
+ name: `host ${verb}`,
222
+ describe,
223
+ usage: `pmcp harness host ${verb}`,
224
+ options: [],
225
+ examples: [`pmcp harness host ${verb}`]
226
+ }));
227
+ var FAMILY = Object.entries(
228
+ HARNESS_OPERATIONS
229
+ ).map(([key, operation]) => {
230
+ const name = key.replace(":", " ");
231
+ const flags = operation.options.map((option) => `--${option} <value>`);
232
+ return {
233
+ name,
234
+ describe: operation.describe,
235
+ usage: [`pmcp harness ${name}`, ...flags].join(" "),
236
+ options: operation.options,
237
+ examples: [[`pmcp harness ${name}`, ...flags].join(" ")]
238
+ };
239
+ });
240
+ var harnessSpec = {
241
+ name: "harness",
242
+ protocol: true,
243
+ describe: "Manage optional owned native sessions independently of the MCP server",
244
+ usage: "pmcp harness <subcommand> [options]",
245
+ options: harnessOptions,
246
+ subcommands: [
247
+ {
248
+ name: "layout",
249
+ describe: "Plan the terminal layout for a size",
250
+ usage: "pmcp harness layout [--columns <count>] [--rows <count>]",
251
+ options: ["columns", "rows"],
252
+ examples: ["pmcp harness layout --columns 120 --rows 40"]
253
+ },
254
+ ...HOST,
255
+ {
256
+ name: "mcp",
257
+ describe: "A stdio MCP server for one pmcp-pty socket (PMCP_PTY_SOCKET)",
258
+ usage: "pmcp harness mcp",
259
+ options: [],
260
+ examples: [
261
+ "PMCP_PTY_SOCKET=/run/user/1000/pmcp-pty.sock pmcp harness mcp"
262
+ ]
263
+ },
264
+ ...FAMILY
265
+ ],
266
+ examples: [
267
+ "pmcp harness doctor inspect",
268
+ 'pmcp harness group inspect --group-file "$GROUP_FILE"',
269
+ "pmcp harness host status"
270
+ ]
271
+ };
272
+ var tuiSpec = {
273
+ name: "tui",
274
+ describe: "Open a native terminal workspace with optional configuration",
275
+ usage: "pmcp tui [--config <file>] [--runtime <id>] [-y] [--new] | pmcp tui <subcommand> [options]",
276
+ options: tuiOptions,
277
+ subcommands: [
278
+ {
279
+ name: "plan",
280
+ describe: "What a launch would do, without starting it",
281
+ usage: "pmcp tui plan [--config <file>] [--runtime <id>] [--json]",
282
+ options: ["config", "runtime", "json"],
283
+ examples: ["pmcp tui plan --runtime codex-cli"]
284
+ },
285
+ {
286
+ name: "recovery",
287
+ describe: "What to run when a workspace was left behind",
288
+ usage: "pmcp tui recovery [--config <file>] [--json]",
289
+ options: ["config", "json"],
290
+ examples: ["pmcp tui recovery"]
291
+ },
292
+ {
293
+ name: "doctor",
294
+ describe: "Terminal host prerequisites",
295
+ usage: "pmcp tui doctor [--json]",
296
+ options: ["json"],
297
+ examples: ["pmcp tui doctor --json"]
298
+ },
299
+ {
300
+ name: "start-worker",
301
+ describe: "Start a worker in the dock",
302
+ usage: "pmcp tui start-worker --runtime <id> [--memory-mb <count>] [--config <file>] [--json]",
303
+ options: ["config", "runtime", "memory-mb", "json"],
304
+ examples: ["pmcp tui start-worker --runtime claude-code"]
305
+ }
306
+ ],
307
+ examples: ["pmcp tui", "pmcp tui --runtime codex-cli", "pmcp tui plan"]
308
+ };
309
+
310
+ export {
311
+ HARNESS_OPERATIONS,
312
+ harnessSpec,
313
+ tuiSpec
314
+ };
315
+ //# sourceMappingURL=chunk-QR6A3TYP.js.map
@@ -1,6 +1,7 @@
1
1
  // src/commands/specs/session.ts
2
2
  var loginSpec = {
3
3
  name: "login",
4
+ examples: ["pmcp login"],
4
5
  describe: "Sign in on this machine, to obtain skills this project lacks",
5
6
  usage: "pmcp login [--issuer <url>]",
6
7
  options: [
@@ -13,15 +14,21 @@ var loginSpec = {
13
14
  };
14
15
  var logoutSpec = {
15
16
  name: "logout",
17
+ examples: ["pmcp logout"],
16
18
  describe: "Forget the sign-in on this machine",
17
19
  usage: "pmcp logout"
18
20
  };
19
21
  var whoamiSpec = {
20
22
  name: "whoami",
23
+ examples: ["pmcp whoami", "pmcp whoami --json"],
21
24
  describe: "Whether this machine is signed in, and to what",
22
25
  usage: "pmcp whoami [--json]",
23
26
  options: [
24
- { name: "json", describe: "Print the answer as JSON.", boolean: true }
27
+ {
28
+ name: "json",
29
+ describe: "Print the result as one JSON envelope on stdout.",
30
+ boolean: true
31
+ }
25
32
  ]
26
33
  };
27
34
 
@@ -30,4 +37,4 @@ export {
30
37
  logoutSpec,
31
38
  whoamiSpec
32
39
  };
33
- //# sourceMappingURL=chunk-EIDIVIAD.js.map
40
+ //# sourceMappingURL=chunk-QYLOIM4U.js.map
@@ -1,12 +1,12 @@
1
1
  import {
2
2
  configFrom
3
- } from "./chunk-J3QUG6O5.js";
3
+ } from "./chunk-7CHUMF3E.js";
4
4
  import {
5
5
  readSpec
6
- } from "./chunk-K2VU3B4W.js";
6
+ } from "./chunk-WQBKQTNT.js";
7
7
  import {
8
8
  ArgumentError
9
- } from "./chunk-WFY7ATSZ.js";
9
+ } from "./chunk-Y6NFETNG.js";
10
10
 
11
11
  // src/commands/mcp/server.ts
12
12
  function serverFrom(context) {
@@ -25,4 +25,4 @@ function serverFrom(context) {
25
25
  export {
26
26
  serverFrom
27
27
  };
28
- //# sourceMappingURL=chunk-ZKB7ZNKY.js.map
28
+ //# sourceMappingURL=chunk-RRKA3GF5.js.map
@@ -6,6 +6,9 @@ import {
6
6
  resolveLeaseFiles,
7
7
  resolvePauseFile
8
8
  } from "./chunk-3V37OZQH.js";
9
+ import {
10
+ NO_CONFIG
11
+ } from "./chunk-Y6NFETNG.js";
9
12
  import {
10
13
  Reader,
11
14
  child,
@@ -269,8 +272,7 @@ function readGitConfig(config) {
269
272
  // src/git/setup.ts
270
273
  function loadGit(cwd, configPath, env) {
271
274
  const path = configPath === void 0 ? findConfig(cwd) : resolve(cwd, configPath);
272
- if (path === null)
273
- return new Error("no pmcp.toml found; the git workflow is opt-in");
275
+ if (path === null) return new Error(NO_CONFIG);
274
276
  const project = readConfig(path);
275
277
  const config = readGitConfig(project);
276
278
  if (config === null)
@@ -311,4 +313,4 @@ export {
311
313
  gateTreePath,
312
314
  leaseSpecs
313
315
  };
314
- //# sourceMappingURL=chunk-P5D6RKMT.js.map
316
+ //# sourceMappingURL=chunk-RZYZILU4.js.map
@@ -6,7 +6,7 @@ import {
6
6
  } from "./chunk-34DECPVC.js";
7
7
  import {
8
8
  ptyBinary
9
- } from "./chunk-733WVP2R.js";
9
+ } from "./chunk-KYGGQPAH.js";
10
10
 
11
11
  // src/harness/adapters/systemd/admission.ts
12
12
  var nativeHostTools = ["systemctl", "systemd-run"];
@@ -36,4 +36,4 @@ export {
36
36
  nativeHostTools,
37
37
  assertNativeHost
38
38
  };
39
- //# sourceMappingURL=chunk-5IZFEVPW.js.map
39
+ //# sourceMappingURL=chunk-SDQYZDHS.js.map
@@ -0,0 +1,78 @@
1
+ import {
2
+ jsonOption
3
+ } from "./chunk-JPYQDOEW.js";
4
+
5
+ // src/commands/specs/mcp.ts
6
+ var mcpSpec = {
7
+ name: "mcp",
8
+ examples: [
9
+ "pmcp mcp login remote --no-wait",
10
+ "pmcp mcp status remote --json"
11
+ ],
12
+ subcommands: [
13
+ {
14
+ name: "login",
15
+ describe: "Sign a shared remote MCP server in",
16
+ usage: "pmcp mcp login <name> [--no-wait | --code <callback-or-code>] [--port <port>] [--client-id <id>] [--bearer-env <name>]",
17
+ options: ["code", "no-wait", "port", "client-id", "bearer-env", "config"],
18
+ examples: [
19
+ "pmcp mcp login remote --no-wait",
20
+ "pmcp mcp login remote --code 'http://127.0.0.1:8976/callback?code=...'"
21
+ ]
22
+ },
23
+ {
24
+ name: "logout",
25
+ describe: "Clear its stored credentials",
26
+ usage: "pmcp mcp logout <name>",
27
+ options: ["config"],
28
+ examples: ["pmcp mcp logout remote"]
29
+ },
30
+ {
31
+ name: "status",
32
+ describe: "Presence, UTC expiry and scopes; never tokens",
33
+ usage: "pmcp mcp status <name> [--json]",
34
+ options: ["config", "json"],
35
+ examples: ["pmcp mcp status remote"]
36
+ }
37
+ ],
38
+ describe: "Manage the project's shared remote MCP authentication",
39
+ usage: "pmcp mcp <subcommand> <name> [options]",
40
+ options: [
41
+ jsonOption,
42
+ {
43
+ name: "config",
44
+ describe: "A pmcp.toml to read instead of the nearest one.",
45
+ placeholder: "<file>"
46
+ },
47
+ {
48
+ name: "code",
49
+ describe: "Complete a pending login with a callback URL or authorization code.",
50
+ placeholder: "<callback-or-code>"
51
+ },
52
+ {
53
+ name: "no-wait",
54
+ describe: "Print the authorization URL and save a pending login for later completion.",
55
+ boolean: true
56
+ },
57
+ {
58
+ name: "port",
59
+ describe: "Loopback callback port; zero chooses an available port.",
60
+ placeholder: "<port>"
61
+ },
62
+ {
63
+ name: "client-id",
64
+ describe: "Use a pre-registered OAuth client identifier.",
65
+ placeholder: "<id>"
66
+ },
67
+ {
68
+ name: "bearer-env",
69
+ describe: "Store a bearer session from this environment variable without printing it.",
70
+ placeholder: "<name>"
71
+ }
72
+ ]
73
+ };
74
+
75
+ export {
76
+ mcpSpec
77
+ };
78
+ //# sourceMappingURL=chunk-UVTGY2R3.js.map
@@ -1,13 +1,17 @@
1
1
  import {
2
2
  EMBEDDING_OPTIONS
3
- } from "./chunk-INT7QLEU.js";
3
+ } from "./chunk-7DJQASH3.js";
4
4
  import {
5
5
  CATALOG_OPTIONS
6
- } from "./chunk-JEL35P7S.js";
6
+ } from "./chunk-5NDUWEMW.js";
7
7
 
8
8
  // src/commands/specs/serve.ts
9
9
  var serveSpec = {
10
10
  name: "serve",
11
+ examples: [
12
+ "pmcp serve --root ./node_modules",
13
+ "pmcp serve --lexical --prompts"
14
+ ],
11
15
  describe: "Run the MCP server on stdio (also the default for piped launches)",
12
16
  usage: "pmcp serve [--root <dir>] [--scope <prefix>] [--marketplace <dir>] [--package <dir>] [--workspace <dir>] [--config <file> | --no-config] [--prompts]",
13
17
  options: [
@@ -54,4 +58,4 @@ var serveSpec = {
54
58
  export {
55
59
  serveSpec
56
60
  };
57
- //# sourceMappingURL=chunk-LLT5FQBE.js.map
61
+ //# sourceMappingURL=chunk-VBVNOLRR.js.map
@@ -16,18 +16,27 @@ var REMOTE_OPTIONS = [
16
16
  describe: "Use a saved catalog response without network access.",
17
17
  placeholder: "<file>"
18
18
  },
19
- { name: "json", describe: "Print machine-readable results.", boolean: true }
19
+ {
20
+ name: "json",
21
+ describe: "Print the result as one JSON envelope on stdout.",
22
+ boolean: true
23
+ }
20
24
  ];
21
25
 
22
26
  // src/commands/specs/remote.ts
23
27
  var availableSpec = {
24
28
  name: "available",
29
+ examples: [
30
+ "pmcp available",
31
+ "pmcp available --catalog saved-catalog.json --json"
32
+ ],
25
33
  describe: "Find provided skills matching this project's installed dependencies",
26
34
  usage: "pmcp available [--project <dir>] [--catalog <file>] [--json]",
27
35
  options: REMOTE_OPTIONS
28
36
  };
29
37
  var previewSpec = {
30
38
  name: "preview",
39
+ examples: ["pmcp preview @modootoday/skill-react"],
31
40
  describe: "Show a skill's contents and a complete example",
32
41
  usage: "pmcp preview <skill-package> [--json]",
33
42
  options: REMOTE_OPTIONS
@@ -42,13 +51,18 @@ var MANAGE_OPTIONS = [
42
51
  {
43
52
  name: "yes",
44
53
  describe: "Approve the displayed project and lockfile changes.",
45
- boolean: true
54
+ boolean: true,
55
+ short: "y"
46
56
  }
47
57
  ];
48
58
  var installSpec = {
49
59
  name: "install",
60
+ examples: [
61
+ "pmcp install --all --dry-run",
62
+ "pmcp install @modootoday/skill-react -y"
63
+ ],
50
64
  describe: "Install matching skill npm packages with the project's package manager",
51
- usage: "pmcp install <skill-package>... | --all [--dry-run | --yes]",
65
+ usage: "pmcp install <skill-package>... | --all [--dry-run | -y]",
52
66
  options: [
53
67
  ...MANAGE_OPTIONS,
54
68
  {
@@ -60,8 +74,9 @@ var installSpec = {
60
74
  };
61
75
  var syncSpec = {
62
76
  name: "sync",
77
+ examples: ["pmcp sync --dry-run", "pmcp sync -y"],
63
78
  describe: "Update declared skill packages without removing other dependencies",
64
- usage: "pmcp sync [--project <dir>] [--dry-run | --yes]",
79
+ usage: "pmcp sync [--project <dir>] [--dry-run | -y]",
65
80
  options: MANAGE_OPTIONS
66
81
  };
67
82
 
@@ -71,4 +86,4 @@ export {
71
86
  installSpec,
72
87
  syncSpec
73
88
  };
74
- //# sourceMappingURL=chunk-ABTJQ4QV.js.map
89
+ //# sourceMappingURL=chunk-WBPVNCQO.js.map
@@ -28,7 +28,7 @@ import {
28
28
  import {
29
29
  leaseSpecs,
30
30
  readGitConfig
31
- } from "./chunk-P5D6RKMT.js";
31
+ } from "./chunk-RZYZILU4.js";
32
32
  import {
33
33
  detect
34
34
  } from "./chunk-SUDG7B6S.js";
@@ -69,7 +69,7 @@ import {
69
69
  readHost,
70
70
  readLock,
71
71
  readLockFile
72
- } from "./chunk-733WVP2R.js";
72
+ } from "./chunk-KYGGQPAH.js";
73
73
  import {
74
74
  DISABLE_ENV,
75
75
  readLeaseSettings
@@ -6367,4 +6367,4 @@ export {
6367
6367
  checkBudget,
6368
6368
  readSpec
6369
6369
  };
6370
- //# sourceMappingURL=chunk-K2VU3B4W.js.map
6370
+ //# sourceMappingURL=chunk-WQBKQTNT.js.map
@@ -1,11 +1,15 @@
1
1
  import {
2
2
  jsonOption,
3
3
  nearestConfigOption
4
- } from "./chunk-XNML2KIC.js";
4
+ } from "./chunk-JPYQDOEW.js";
5
5
 
6
6
  // src/commands/specs/logs.ts
7
7
  var logsSpec = {
8
8
  name: "logs",
9
+ examples: [
10
+ "pmcp logs --since 10m --level warn --pretty",
11
+ "pmcp logs --trace 7cef825e8fbd8c3f --json"
12
+ ],
9
13
  describe: "Read this project's pmcp JSONL logs, filtered by session, trace, component, level or time",
10
14
  usage: "pmcp logs [--session <id>] [--trace <id>] [--component <name>] [--level <level>] [--since <10m|ISO>] [--follow] [--pretty]",
11
15
  options: [
@@ -48,4 +52,4 @@ var logsSpec = {
48
52
  export {
49
53
  logsSpec
50
54
  };
51
- //# sourceMappingURL=chunk-YGOWIJPE.js.map
55
+ //# sourceMappingURL=chunk-WZYGM3FR.js.map