@modootoday/pmcp 0.17.4 → 0.18.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (246) 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/CHANGELOG.md +60 -0
  5. package/README.md +29 -24
  6. package/dist/apply-4IGTXOCQ.js +242 -0
  7. package/dist/{attachment-tU5FZrgZ.d.ts → attachment-D84OGI6n.d.ts} +1 -1
  8. package/dist/available-DBSIVVJ6.js +73 -0
  9. package/dist/broadcast-3RY3OZGY.js +18 -0
  10. package/dist/chunk-25GHX674.js +1246 -0
  11. package/dist/chunk-2P4Z2NUX.js +28 -0
  12. package/dist/chunk-34DECPVC.js +22 -0
  13. package/dist/chunk-3NYG4SGU.js +45 -0
  14. package/dist/chunk-3PW4FI7U.js +32 -0
  15. package/dist/chunk-3Y3HDMHA.js +108 -0
  16. package/dist/chunk-47O3X4VS.js +113 -0
  17. package/dist/chunk-4NDEP7HU.js +26 -0
  18. package/dist/chunk-4VCC2NXE.js +104 -0
  19. package/dist/chunk-5OMOPUE6.js +39 -0
  20. package/dist/chunk-5QQWS4US.js +53 -0
  21. package/dist/chunk-5ZABTVSW.js +48 -0
  22. package/dist/chunk-65ZHM5RH.js +4985 -0
  23. package/dist/chunk-665TA55Z.js +419 -0
  24. package/dist/chunk-6STKGOCW.js +27 -0
  25. package/dist/chunk-6WXMJOMI.js +9 -0
  26. package/dist/chunk-73AKO4UL.js +24 -0
  27. package/dist/chunk-7BLPN3W6.js +31 -0
  28. package/dist/chunk-7DLZC73N.js +29 -0
  29. package/dist/chunk-7GBYECSK.js +72 -0
  30. package/dist/chunk-7TD53M7L.js +13 -0
  31. package/dist/chunk-A4PKLESO.js +112 -0
  32. package/dist/chunk-ABTJQ4QV.js +74 -0
  33. package/dist/chunk-BBTBJCFA.js +380 -0
  34. package/dist/chunk-BU65MNVU.js +13 -0
  35. package/dist/chunk-BVCTKPT3.js +83 -0
  36. package/dist/chunk-C4NHQGHL.js +142 -0
  37. package/dist/chunk-CJTKR6K6.js +1213 -0
  38. package/dist/chunk-DCU2EXQV.js +78 -0
  39. package/dist/chunk-DZ2MRTYT.js +135 -0
  40. package/dist/chunk-E2YOZ2FF.js +207 -0
  41. package/dist/chunk-E3DQB5LS.js +48 -0
  42. package/dist/chunk-E7OOHLQR.js +7 -0
  43. package/dist/chunk-EATCUWGG.js +66 -0
  44. package/dist/chunk-EIDIVIAD.js +33 -0
  45. package/dist/chunk-EJBZGIDK.js +1934 -0
  46. package/dist/chunk-ELAGZ635.js +252 -0
  47. package/dist/chunk-GZHHEHKY.js +44 -0
  48. package/dist/chunk-HDMBVLCZ.js +53 -0
  49. package/dist/chunk-HQOB7OQS.js +81 -0
  50. package/dist/chunk-IGYRMM62.js +28 -0
  51. package/dist/chunk-IJBSOWHK.js +86 -0
  52. package/dist/chunk-INT7QLEU.js +114 -0
  53. package/dist/chunk-J6QLLQVL.js +1025 -0
  54. package/dist/chunk-J7UYNJCR.js +9 -0
  55. package/dist/chunk-JEL35P7S.js +53 -0
  56. package/dist/chunk-JGJ4INEN.js +32 -0
  57. package/dist/chunk-JS5RTH4I.js +84 -0
  58. package/dist/chunk-JUXNIXN4.js +42 -0
  59. package/dist/chunk-JWRZDYB5.js +59 -0
  60. package/dist/chunk-KMXRRSKT.js +660 -0
  61. package/dist/chunk-LAZQBMAU.js +67 -0
  62. package/dist/chunk-LLBPVZXM.js +67 -0
  63. package/dist/chunk-LLT5FQBE.js +57 -0
  64. package/dist/chunk-LMT3PPXJ.js +17 -0
  65. package/dist/chunk-MM2Y43LC.js +87 -0
  66. package/dist/chunk-MPSQXSC6.js +346 -0
  67. package/dist/chunk-MVFH26QT.js +97 -0
  68. package/dist/chunk-MWFOUBFC.js +39 -0
  69. package/dist/chunk-N5AQ3PP7.js +211 -0
  70. package/dist/chunk-NQPURJT5.js +44 -0
  71. package/dist/chunk-NRBQK6UX.js +105 -0
  72. package/dist/chunk-NZS5CD72.js +333 -0
  73. package/dist/chunk-OEH47H6A.js +48 -0
  74. package/dist/chunk-OG7QR2DP.js +75 -0
  75. package/dist/chunk-OPYFEHKG.js +52 -0
  76. package/dist/chunk-P4N7DBD5.js +83 -0
  77. package/dist/chunk-PAX3QXX2.js +140 -0
  78. package/dist/chunk-PLX3BOOS.js +396 -0
  79. package/dist/chunk-PMJG2CXF.js +122 -0
  80. package/dist/chunk-PWSJJXLQ.js +643 -0
  81. package/dist/chunk-Q5H3L6Y4.js +23 -0
  82. package/dist/chunk-Q65R3XKX.js +155 -0
  83. package/dist/chunk-QEW4J3IZ.js +74 -0
  84. package/dist/chunk-QPL7E2HW.js +464 -0
  85. package/dist/chunk-R2GPCZUX.js +22 -0
  86. package/dist/chunk-R4L6LJJ2.js +778 -0
  87. package/dist/chunk-R5MT42JS.js +284 -0
  88. package/dist/chunk-RK4PYD7L.js +73 -0
  89. package/dist/chunk-RMATE45Z.js +197 -0
  90. package/dist/chunk-S3PIAMXV.js +230 -0
  91. package/dist/chunk-SG5TPMKH.js +93 -0
  92. package/dist/chunk-T3LKX23M.js +168 -0
  93. package/dist/chunk-T6GOWHK6.js +30 -0
  94. package/dist/chunk-TIA4SPU2.js +10 -0
  95. package/dist/chunk-TNCZ6444.js +57 -0
  96. package/dist/chunk-TVL5RTE6.js +269 -0
  97. package/dist/chunk-UOCLRM7P.js +151 -0
  98. package/dist/chunk-UPQTAHUK.js +189 -0
  99. package/dist/chunk-V4NPDK6X.js +14 -0
  100. package/dist/chunk-VJFEN6DJ.js +38 -0
  101. package/dist/chunk-WIW772I3.js +25 -0
  102. package/dist/chunk-XELAZAIM.js +136 -0
  103. package/dist/chunk-XNML2KIC.js +23 -0
  104. package/dist/chunk-XP2U3LO3.js +30 -0
  105. package/dist/chunk-YGOWIJPE.js +51 -0
  106. package/dist/chunk-YIXDHQYE.js +11 -0
  107. package/dist/chunk-YMHUM7AV.js +22 -0
  108. package/dist/chunk-YSAWTGNA.js +117 -0
  109. package/dist/chunk-Z4HRRXRF.js +478 -0
  110. package/dist/chunk-ZH6R642Z.js +102 -0
  111. package/dist/claude-U2JC2DNQ.js +77 -0
  112. package/dist/cli-VYCQJZ5X.js +41 -0
  113. package/dist/cli-ZTCBSDW4.js +46 -0
  114. package/dist/cli.js +144 -16197
  115. package/dist/completion-E7RRG3ZT.js +142 -0
  116. package/dist/config-DnpLL2kT.d.ts +46 -0
  117. package/dist/{service-qpCsOXkQ.d.ts → core-C1LPjxK6.d.ts} +2 -6
  118. package/dist/diagnostics-XXH4FLUG.js +93 -0
  119. package/dist/doctor-ZIOESU3N.js +538 -0
  120. package/dist/entry-ZNFCTDVE.js +305 -0
  121. package/dist/exec-mcp-X6372BLE.js +365 -0
  122. package/dist/harness-F2XFDYXF.js +177 -0
  123. package/dist/harness-egress-bridge.js +4 -4
  124. package/dist/harness-launch-gate.js +47 -940
  125. package/dist/harness-pane-runner.js +13 -80
  126. package/dist/harness-worker.js +21 -2703
  127. package/dist/hook-body.js +5221 -0
  128. package/dist/hook-spec-C5fWTSCH.d.ts +100 -0
  129. package/dist/hook.js +26 -0
  130. package/dist/hooks-FYE2L5RW.js +21 -0
  131. package/dist/host-GRY3VAHH.js +22 -0
  132. package/dist/host-X6BR6X4O.js +200 -0
  133. package/dist/host-run-GCA6H6SR.js +307 -0
  134. package/dist/http.d.ts +5 -42
  135. package/dist/http.js +21 -2234
  136. package/dist/import-mcp-2TTBPVLY.js +400 -0
  137. package/dist/index.d.ts +146 -168
  138. package/dist/index.js +133 -4948
  139. package/dist/init-627KFXTG.js +14 -0
  140. package/dist/install-GG7HHZK2.js +796 -0
  141. package/dist/invoke-LW22Z6ET.js +23 -0
  142. package/dist/list-MCP2FXUF.js +68 -0
  143. package/dist/list-NGMSQ5SH.js +65 -0
  144. package/dist/load-BEUBABtB.d.ts +21 -0
  145. package/dist/logout-6CSHUWWE.js +44 -0
  146. package/dist/logs-SPB6AANY.js +107 -0
  147. package/dist/mailbox/index.d.ts +10 -5
  148. package/dist/mailbox/index.js +53 -1572
  149. package/dist/mailbox-7BV54Q4R.js +285 -0
  150. package/dist/mailbox-GDJ7BWQN.js +189 -0
  151. package/dist/mainline-JQTTYJMI.js +639 -0
  152. package/dist/marketplace-G4VQET5W.js +191 -0
  153. package/dist/mcp-2DKVU3SW.js +15 -0
  154. package/dist/mcp-V23HC3LB.js +193 -0
  155. package/dist/models-ISU4DCMA.js +32 -0
  156. package/dist/opencode-CN7JLQYO.js +60 -0
  157. package/dist/pause-FFAYRBWI.js +18 -0
  158. package/dist/preview-DT7DWG5F.js +91 -0
  159. package/dist/project/hook-adapter.d.ts +5 -2
  160. package/dist/project/hook-adapter.js +41 -27
  161. package/dist/project-FY62G55N.js +70 -0
  162. package/dist/pty-XTJ4MIWK.js +94 -0
  163. package/dist/recovery-U6QB3PMT.js +100 -0
  164. package/dist/reindex-Y27QJFDB.js +22 -0
  165. package/dist/resume-UU4HZIUP.js +18 -0
  166. package/dist/run-HALGEJNJ.js +19 -0
  167. package/dist/run-OGA3P7FC.js +126 -0
  168. package/dist/serve-NBKT5BKY.js +104 -0
  169. package/dist/session-XM2CR425.js +159 -0
  170. package/dist/setup-DTKZLZUT.js +18 -0
  171. package/dist/start-login-UIQYQBMC.js +416 -0
  172. package/dist/status-A2OUTNGK.js +9 -0
  173. package/dist/status-H2VAHIDV.js +10 -0
  174. package/dist/status-NOOHW5WA.js +43 -0
  175. package/dist/status-VHODZPXB.js +55 -0
  176. package/dist/status-XQANBVXW.js +286 -0
  177. package/dist/stdio.d.ts +3 -13
  178. package/dist/stdio.js +16 -3186
  179. package/dist/sweep-64JDCGK6.js +18 -0
  180. package/dist/test-MKAXFJOL.js +561 -0
  181. package/dist/tools-gpHNq9Dh.d.ts +328 -0
  182. package/dist/tui-MWKAXE4K.js +153 -0
  183. package/dist/unbroadcast-KPUEFLZD.js +18 -0
  184. package/dist/validate-5GZ5YWNA.js +46 -0
  185. package/dist/worker-RQ575EJL.js +80 -0
  186. package/dist/worktree-create-PZSRB7PH.js +89 -0
  187. package/dist/worktree-list-JYB6VXLW.js +51 -0
  188. package/dist/worktree-sync-UF5CXPWV.js +30 -0
  189. package/docs/hooks/capabilities/antigravity.json +199 -0
  190. package/docs/hooks/capabilities/claude.json +179 -0
  191. package/docs/hooks/capabilities/codex.json +179 -0
  192. package/docs/hooks/capabilities/gemini.json +196 -0
  193. package/docs/hooks/capabilities/grok.json +192 -0
  194. package/docs/hooks/capabilities/opencode.json +184 -0
  195. package/docs/project-configuration.md +821 -4
  196. package/docs/terminal-harness.md +71 -28
  197. package/docs/terminal-workspace.md +91 -170
  198. package/gemini-extension.json +1 -1
  199. package/package.json +13 -1
  200. package/plugin.json +1 -1
  201. package/plugins/pmcp/.claude-plugin/plugin.json +4 -2
  202. package/plugins/pmcp/gemini-extension.json +1 -1
  203. package/plugins/pmcp/mod/commands.ts +72 -0
  204. package/plugins/pmcp/mod/contract.d.ts +39 -0
  205. package/plugins/pmcp/mod/draw.tsx +216 -0
  206. package/plugins/pmcp/mod/guard.ts +42 -0
  207. package/plugins/pmcp/mod/hooks.json +4 -0
  208. package/plugins/pmcp/mod/host.ts +46 -0
  209. package/plugins/pmcp/mod/model.ts +144 -0
  210. package/plugins/pmcp/mod/reader/index.ts +18 -0
  211. package/plugins/pmcp/mod/reader/read.ts +76 -0
  212. package/plugins/pmcp/mod/reader/settings.ts +54 -0
  213. package/plugins/pmcp/mod/reader/types.ts +38 -0
  214. package/plugins/pmcp/mod/register.tsx +73 -0
  215. package/plugins/pmcp/mod/sessions/format.ts +91 -0
  216. package/plugins/pmcp/mod/sessions/types.ts +162 -0
  217. package/plugins/pmcp/mod/snapshot.ts +75 -0
  218. package/plugins/pmcp/mod/spinner.tsx +30 -0
  219. package/plugins/pmcp/mod/state.ts +28 -0
  220. package/plugins/pmcp/plugin.json +1 -1
  221. package/plugins/pmcp/skills/agent-assets-migrate/SKILL.md +96 -0
  222. package/plugins/pmcp/skills/headless-agents-ci-scaffold/SKILL.md +100 -0
  223. package/plugins/pmcp/skills/marketplace-plugin-scaffold/SKILL.md +87 -0
  224. package/plugins/pmcp/skills/package-skill-catalog/SKILL.md +51 -11
  225. package/plugins/pmcp/skills/pmcp-project-init/SKILL.md +145 -0
  226. package/plugins/pmcp/skills/pmcp-sessions-and-git/SKILL.md +104 -0
  227. package/plugins/pmcp/skills/skill-package-scaffold/SKILL.md +88 -0
  228. package/schema/catalog-v1.json +158 -0
  229. package/schema/library.json +164 -0
  230. package/schema/marketplace-manifest.json +130 -0
  231. package/schema/plugin-manifest.json +55 -0
  232. package/schema/skill-frontmatter.json +144 -0
  233. package/schema/skill-metadata-core.json +110 -0
  234. package/skills/agent-assets-migrate/SKILL.md +96 -0
  235. package/skills/headless-agents-ci-scaffold/SKILL.md +100 -0
  236. package/skills/marketplace-plugin-scaffold/SKILL.md +87 -0
  237. package/skills/package-skill-catalog/SKILL.md +51 -11
  238. package/skills/pmcp-project-init/SKILL.md +145 -0
  239. package/skills/pmcp-sessions-and-git/SKILL.md +104 -0
  240. package/skills/skill-package-scaffold/SKILL.md +88 -0
  241. package/dist/config-BkSpjUG6.d.ts +0 -50
  242. package/dist/embed-DRROSD3F.d.ts +0 -53
  243. package/dist/hook-spec-CSJJySsH.d.ts +0 -11
  244. package/dist/server-VWSY3Shw.d.ts +0 -543
  245. package/dist/tui-worker.js +0 -6549
  246. /package/dist/{tui-worker.d.ts → hook.d.ts} +0 -0
@@ -0,0 +1,104 @@
1
+ ---
2
+ name: pmcp-sessions-and-git
3
+ description: Work alongside other agent sessions in a pmcp repository - read who is working and what is held with pmcp sessions status, pause, resume and broadcast as the operator, wait out a lease, work in a desk (a linked worktree) instead of the shared main checkout, deliver commits through pmcp git deliver rather than git push, sync the main checkout and desks, and read pmcp logs to explain a hook refusal. Use when a pmcp hook refused or warned, when several agents share one repository, when asked to land or deliver work, or when a session reports a pause, lease or leftover edits. Not for writing pmcp.toml (set the project up first) or for repositories without pmcp hooks.
4
+ metadata:
5
+ tier: open
6
+ level: L2
7
+ domain: agent-workflow
8
+ install: optional
9
+ keywords: "pmcp, sessions, pause, broadcast, lease, worktree, desk, deliver, mainline, git sync, pmcp logs, hook refusal"
10
+ requires-bin: "pmcp"
11
+ ---
12
+
13
+ # Working with other sessions under pmcp
14
+
15
+ pmcp hooks see every session in the repository and its worktrees. They refuse or warn with
16
+ a reason that names what to do instead. Do what the reason says; never work around a
17
+ refusal with another spelling of the same command.
18
+
19
+ ## Read the room first
20
+
21
+ ```sh
22
+ pmcp sessions status
23
+ ```
24
+
25
+ It prints each live session (its id, runtime, checkout and current tool), the pause, current
26
+ broadcasts, held leases, and files edited but not landed in a shared checkout. Read it
27
+ before landing anything, and whenever a hook mentions another session.
28
+
29
+ ## Pause and broadcast (operator)
30
+
31
+ ```sh
32
+ pmcp sessions pause "release freeze" --by operator
33
+ pmcp sessions resume
34
+ pmcp sessions broadcast "main moved; sync your desk before delivering"
35
+ pmcp sessions unbroadcast
36
+ pmcp sessions sweep # drop records whose process is gone
37
+ ```
38
+
39
+ While paused, every other session's edits and mutating commands are refused; reading and
40
+ planning continue. A broadcast reaches each session once, as context. An agent does not
41
+ pause, resume or broadcast on its own initiative; it reports the need to the operator.
42
+
43
+ ## Leases
44
+
45
+ A lease protects a file two sessions must not change at once, such as a lockfile. While a
46
+ delivery that touches it is landing, the commands listed for that lease are refused with
47
+ `... is landing ... retry when it has landed`. Wait and retry; do not run the command another
48
+ way.
49
+
50
+ ## Desks, not the shared checkout
51
+
52
+ When the repository has worktrees, the main checkout is shared: an edit left there blocks
53
+ syncing the mainline for every session, and the hook says so. Work in a desk:
54
+
55
+ ```sh
56
+ pmcp git worktree create <alias> # prints the desk path; work there
57
+ pmcp git worktree list # alias, branch, behind/ahead, path
58
+ pmcp git worktree sync # move this desk onto the mainline when nothing is lost
59
+ ```
60
+
61
+ If you already edited the main checkout, land those files within the task or move them to a
62
+ desk. `pmcp sessions status` lists them under the shared checkout.
63
+
64
+ ## Deliver, do not push
65
+
66
+ With `[git.mainline.deliver]`, a direct `git push` from any checkout of the repository is
67
+ refused. Commit in the desk, then:
68
+
69
+ ```sh
70
+ pmcp git deliver # every commit the upstream lacks
71
+ pmcp git deliver <commit>... # only these
72
+ ```
73
+
74
+ It fetches, replays the commits onto the mainline, runs the gate in its own tree under a
75
+ lock, and pushes, replaying again if the mainline moved. Exit 0 delivered or nothing to
76
+ deliver; 1 refused (pause, lease, gate failure, attempts exhausted) with the reason on
77
+ stderr; 2 the fetch failed. Fix what the gate reports; never bypass it with
78
+ `--no-verify` or a gate-bypass variable, which the guards refuse.
79
+
80
+ `pmcp git sync` moves the main checkout to the mainline afterwards; it refuses (exit 2)
81
+ while unlanded edits sit there.
82
+
83
+ ## Explain a refusal with pmcp logs
84
+
85
+ ```sh
86
+ pmcp logs --since 15m --level warn --pretty
87
+ pmcp logs --session <id-prefix> --pretty
88
+ pmcp logs --trace <trace-id>
89
+ ```
90
+
91
+ Each hook call has a trace id; one trace shows every policy that ran, its verdict and
92
+ duration. Secret values, prompt text and environment values are redacted.
93
+
94
+ ## Runtime differences
95
+
96
+ - Codex has no ask: a guard that would ask denies there.
97
+ - Codex sends no agent type, so roles apply only in Claude Code.
98
+ - Claude hears end-of-turn notices in the same turn; Codex at the next prompt.
99
+
100
+ ## Report
101
+
102
+ What `pmcp sessions status` showed, which refusal or warning occurred and what it asked
103
+ for, the commands run instead (delivery or sync and their exit codes), and anything left for
104
+ the operator (a pause to lift, a lease still held, leftovers in the shared checkout).
@@ -0,0 +1,88 @@
1
+ ---
2
+ name: skill-package-scaffold
3
+ description: Lay out one new skill folder that passes the Agent Skills specification - SKILL.md frontmatter within the limits pmcp validate enforces, references/, scripts/ and assets/ only where needed, and evals/ with a normal, an exception and a missing-information case - then gate it with pmcp validate. Use when creating the folder for a new skill, when pmcp validate rejects a skill, or when a skill needs its first eval cases. Not for deciding what the skill should teach or for packaging several skills as a plugin.
4
+ metadata:
5
+ tier: open
6
+ level: L2
7
+ domain: agent-workflow
8
+ install: optional
9
+ keywords: "SKILL.md, skill scaffold, Agent Skills specification, pmcp validate, skill frontmatter, skill evals"
10
+ requires-bin: "pmcp"
11
+ ---
12
+
13
+ # Scaffolding one skill folder
14
+
15
+ This is the shape, not the content. What the body should say, and how to word a description
16
+ that triggers, is skill authoring (domain-skill-authoring covers it). Here the job is a
17
+ folder that every loader accepts and that carries its own test cases.
18
+
19
+ ## Layout
20
+
21
+ ```
22
+ <name>/
23
+ SKILL.md
24
+ references/ only files the body names, read on demand
25
+ scripts/ only code the body tells the agent to run
26
+ assets/ templates or files the output is built from
27
+ evals/
28
+ normal/prompt.md
29
+ exception/prompt.md
30
+ missing-info/prompt.md
31
+ ```
32
+
33
+ Create a directory only when something goes in it. An empty `scripts/` makes reviewers look
34
+ for code that is not there.
35
+
36
+ ## Frontmatter limits
37
+
38
+ These are the checks `pmcp validate` runs (pmcp 0.8):
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 |
48
+
49
+ A marketplace may add its own rules on top (a metadata schema, tiers, ASCII-only text).
50
+ Check those separately; `pmcp validate` does not know them.
51
+
52
+ ```markdown
53
+ ---
54
+ name: invoice-dispute-reply
55
+ description: Draft a reply to a customer disputing an invoice ... Use when ... Not for ...
56
+ ---
57
+ ```
58
+
59
+ ## Evals: three cases, each self-contained
60
+
61
+ | Case | Tests |
62
+ | --- | --- |
63
+ | normal | the common request, with every input present |
64
+ | exception | the input that should change the answer: a rule's exception, an edge value, a refusal |
65
+ | missing-info | a request lacking something essential; the skill must ask or state the assumption, not invent |
66
+
67
+ Each `prompt.md` must carry everything the case needs. The grader's sandbox starts empty, so
68
+ paste file contents into the prompt instead of naming a path. Write what PASS means next to
69
+ the prompt, as checkable statements, before writing the body.
70
+
71
+ ## Gate
72
+
73
+ ```sh
74
+ pmcp validate path/to/<name> # one folder; exit 1 on any error
75
+ pmcp validate --marketplace <dir> # every skill a marketplace reaches
76
+ ```
77
+
78
+ `pmcp validate` checks frontmatter and naming only. It does not run the eval cases; run
79
+ those with your eval harness, with and without the skill.
80
+
81
+ Size matters when the skill is served over MCP: the Skills extension lists a skill only if
82
+ it stays within 512 files and 16 MiB. Larger skills stay reachable through the tools.
83
+ Scripts are returned as text by catalog servers, never run by them.
84
+
85
+ ## Report
86
+
87
+ The tree created, the `pmcp validate` output, and the three eval prompts with their PASS
88
+ statements.
@@ -1,50 +0,0 @@
1
- import { E as EncoderOptions } from './encoder-DGRy9skC.js';
2
-
3
- /**
4
- * `pmcp.toml`, the project's one record of where its catalog lives.
5
- *
6
- * Paths in it are relative to the file, so the same file works from any
7
- * directory a host starts pmcp in. Catalog and embedding settings are checked
8
- * here; projector sections are kept as given.
9
- */
10
-
11
- declare const CONFIG_FILE = "pmcp.toml";
12
- /** What `[catalog]` may say. Each mirrors the repeatable CLI flag of the same meaning. */
13
- interface CatalogSection {
14
- readonly builtin?: boolean;
15
- readonly roots?: readonly string[];
16
- readonly scopes?: readonly string[];
17
- readonly workspaces?: readonly string[];
18
- readonly packages?: readonly string[];
19
- readonly marketplaces?: readonly string[];
20
- }
21
- interface ProjectConfig {
22
- /** Absolute path of the file read. */
23
- readonly path: string;
24
- /** Its directory; every relative path in the file resolves against it. */
25
- readonly dir: string;
26
- /** `[catalog]` with paths already absolute. */
27
- readonly catalog: CatalogSection;
28
- readonly embedding?: EmbeddingSection;
29
- /** The whole document, for sections this module does not interpret. */
30
- readonly raw: Readonly<Record<string, unknown>>;
31
- }
32
- interface EmbeddingSection extends EncoderOptions {
33
- readonly enabled?: boolean;
34
- readonly modelId?: string;
35
- readonly modelPath?: string;
36
- readonly cacheDir?: string;
37
- }
38
- declare class ConfigError extends Error {
39
- constructor(path: string, message: string);
40
- }
41
- /** The nearest pmcp.toml at or above start, or null when there is none. */
42
- declare function findConfig(start: string): string | null;
43
- /**
44
- * Reads and checks one file. An unknown key under `[catalog]` is an error
45
- * rather than ignored, for the same reason an unknown flag is: a misspelt
46
- * `workspace = [...]` must not look like it worked.
47
- */
48
- declare function readConfig(path: string): ProjectConfig;
49
-
50
- export { CONFIG_FILE as C, type EmbeddingSection as E, type ProjectConfig as P, type CatalogSection as a, ConfigError as b, findConfig as f, readConfig as r };
@@ -1,53 +0,0 @@
1
- import { E as Embedder } from './server-VWSY3Shw.js';
2
- import { E as EncoderOptions } from './encoder-DGRy9skC.js';
3
-
4
- /**
5
- * The optional encoder and the store for the vectors it produces.
6
- *
7
- * Neither the model nor its runtime is a dependency: a caller who wants
8
- * semantic ranking installs the peer and runs `pmcp index`, and everything
9
- * here degrades to null rather than throwing when that has not happened.
10
- */
11
-
12
- interface LoadEmbedderOptions extends EncoderOptions {
13
- /** Where model files live; a host bakes them into its image here. */
14
- readonly cacheDir?: string;
15
- readonly modelPath?: string;
16
- /** Refuse to download, so a missing model is an error rather than a fetch. */
17
- readonly localOnly?: boolean;
18
- /** Injected for tests. The optional peer is imported otherwise. */
19
- readonly module?: unknown;
20
- }
21
- /**
22
- * Loads the encoder, or returns null when the peer is not installed.
23
- *
24
- * Absence is not failure anywhere in this package: the caller reports it and
25
- * ranking stays lexical.
26
- */
27
- declare function loadEmbedder(modelId?: string, options?: LoadEmbedderOptions): Promise<Embedder | null>;
28
- /**
29
- * One vector per entry, reusing those whose description has not changed.
30
- * Encoded as passages, the side the intent is compared against.
31
- */
32
- declare function encodeEntries(embedder: Embedder, entries: readonly {
33
- readonly name: string;
34
- readonly description: string;
35
- }[], previous?: ReadonlyMap<string, {
36
- hash: string;
37
- vector: Float32Array;
38
- }>): Promise<Map<string, {
39
- hash: string;
40
- vector: Float32Array;
41
- }>>;
42
- interface EntryVectorStore {
43
- read(modelId: string): Map<string, Float32Array>;
44
- /** Names whose stored hash disagrees with the description they now have. */
45
- stale(modelId: string, entries: ReadonlyMap<string, string>): string[];
46
- write(modelId: string, name: string, description: string, vector: Float32Array): void;
47
- close(): void;
48
- }
49
- declare function openEntryVectors(path: string, options?: {
50
- readOnly?: boolean;
51
- }): Promise<EntryVectorStore | null>;
52
-
53
- export { type EntryVectorStore as E, type LoadEmbedderOptions as L, encodeEntries as e, loadEmbedder as l, openEntryVectors as o };
@@ -1,11 +0,0 @@
1
- declare const HOOK_TOOLS: readonly ["codex", "gemini", "antigravity"];
2
- type HookTool = (typeof HOOK_TOOLS)[number];
3
- interface ShellHookSpec {
4
- readonly name: string;
5
- readonly command: readonly string[];
6
- readonly targets: readonly HookTool[];
7
- readonly timeoutMs: number;
8
- readonly event?: "after_edit";
9
- }
10
-
11
- export type { HookTool as H, ShellHookSpec as S };