@modootoday/pmcp 0.17.3 → 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.
- package/.agents/plugins/marketplace.json +1 -1
- package/.claude-plugin/marketplace.json +1 -1
- package/.claude-plugin/plugin.json +1 -1
- package/CHANGELOG.md +60 -0
- package/README.md +29 -24
- package/dist/apply-4IGTXOCQ.js +242 -0
- package/dist/{attachment-tU5FZrgZ.d.ts → attachment-D84OGI6n.d.ts} +1 -1
- package/dist/available-DBSIVVJ6.js +73 -0
- package/dist/broadcast-3RY3OZGY.js +18 -0
- package/dist/chunk-25GHX674.js +1246 -0
- package/dist/chunk-2P4Z2NUX.js +28 -0
- package/dist/chunk-34DECPVC.js +22 -0
- package/dist/chunk-3NYG4SGU.js +45 -0
- package/dist/chunk-3PW4FI7U.js +32 -0
- package/dist/chunk-3Y3HDMHA.js +108 -0
- package/dist/chunk-47O3X4VS.js +113 -0
- package/dist/chunk-4NDEP7HU.js +26 -0
- package/dist/chunk-4VCC2NXE.js +104 -0
- package/dist/chunk-5OMOPUE6.js +39 -0
- package/dist/chunk-5QQWS4US.js +53 -0
- package/dist/chunk-5ZABTVSW.js +48 -0
- package/dist/chunk-65ZHM5RH.js +4985 -0
- package/dist/chunk-665TA55Z.js +419 -0
- package/dist/chunk-6STKGOCW.js +27 -0
- package/dist/chunk-6WXMJOMI.js +9 -0
- package/dist/chunk-73AKO4UL.js +24 -0
- package/dist/chunk-7BLPN3W6.js +31 -0
- package/dist/chunk-7DLZC73N.js +29 -0
- package/dist/chunk-7GBYECSK.js +72 -0
- package/dist/chunk-7TD53M7L.js +13 -0
- package/dist/chunk-A4PKLESO.js +112 -0
- package/dist/chunk-ABTJQ4QV.js +74 -0
- package/dist/chunk-BBTBJCFA.js +380 -0
- package/dist/chunk-BU65MNVU.js +13 -0
- package/dist/chunk-BVCTKPT3.js +83 -0
- package/dist/chunk-C4NHQGHL.js +142 -0
- package/dist/chunk-CJTKR6K6.js +1213 -0
- package/dist/chunk-DCU2EXQV.js +78 -0
- package/dist/chunk-DZ2MRTYT.js +135 -0
- package/dist/chunk-E2YOZ2FF.js +207 -0
- package/dist/chunk-E3DQB5LS.js +48 -0
- package/dist/chunk-E7OOHLQR.js +7 -0
- package/dist/chunk-EATCUWGG.js +66 -0
- package/dist/chunk-EIDIVIAD.js +33 -0
- package/dist/chunk-EJBZGIDK.js +1934 -0
- package/dist/chunk-ELAGZ635.js +252 -0
- package/dist/chunk-GZHHEHKY.js +44 -0
- package/dist/chunk-HDMBVLCZ.js +53 -0
- package/dist/chunk-HQOB7OQS.js +81 -0
- package/dist/chunk-IGYRMM62.js +28 -0
- package/dist/chunk-IJBSOWHK.js +86 -0
- package/dist/chunk-INT7QLEU.js +114 -0
- package/dist/chunk-J6QLLQVL.js +1025 -0
- package/dist/chunk-J7UYNJCR.js +9 -0
- package/dist/chunk-JEL35P7S.js +53 -0
- package/dist/chunk-JGJ4INEN.js +32 -0
- package/dist/chunk-JS5RTH4I.js +84 -0
- package/dist/chunk-JUXNIXN4.js +42 -0
- package/dist/chunk-JWRZDYB5.js +59 -0
- package/dist/chunk-KMXRRSKT.js +660 -0
- package/dist/chunk-LAZQBMAU.js +67 -0
- package/dist/chunk-LLBPVZXM.js +67 -0
- package/dist/chunk-LLT5FQBE.js +57 -0
- package/dist/chunk-LMT3PPXJ.js +17 -0
- package/dist/chunk-MM2Y43LC.js +87 -0
- package/dist/chunk-MPSQXSC6.js +346 -0
- package/dist/chunk-MVFH26QT.js +97 -0
- package/dist/chunk-MWFOUBFC.js +39 -0
- package/dist/chunk-N5AQ3PP7.js +211 -0
- package/dist/chunk-NQPURJT5.js +44 -0
- package/dist/chunk-NRBQK6UX.js +105 -0
- package/dist/chunk-NZS5CD72.js +333 -0
- package/dist/chunk-OEH47H6A.js +48 -0
- package/dist/chunk-OG7QR2DP.js +75 -0
- package/dist/chunk-OPYFEHKG.js +52 -0
- package/dist/chunk-P4N7DBD5.js +83 -0
- package/dist/chunk-PAX3QXX2.js +140 -0
- package/dist/chunk-PLX3BOOS.js +396 -0
- package/dist/chunk-PMJG2CXF.js +122 -0
- package/dist/chunk-PWSJJXLQ.js +643 -0
- package/dist/chunk-Q5H3L6Y4.js +23 -0
- package/dist/chunk-Q65R3XKX.js +155 -0
- package/dist/chunk-QEW4J3IZ.js +74 -0
- package/dist/chunk-QPL7E2HW.js +464 -0
- package/dist/chunk-R2GPCZUX.js +22 -0
- package/dist/chunk-R4L6LJJ2.js +778 -0
- package/dist/chunk-R5MT42JS.js +284 -0
- package/dist/chunk-RK4PYD7L.js +73 -0
- package/dist/chunk-RMATE45Z.js +197 -0
- package/dist/chunk-S3PIAMXV.js +230 -0
- package/dist/chunk-SG5TPMKH.js +93 -0
- package/dist/chunk-T3LKX23M.js +168 -0
- package/dist/chunk-T6GOWHK6.js +30 -0
- package/dist/chunk-TIA4SPU2.js +10 -0
- package/dist/chunk-TNCZ6444.js +57 -0
- package/dist/chunk-TVL5RTE6.js +269 -0
- package/dist/chunk-UOCLRM7P.js +151 -0
- package/dist/chunk-UPQTAHUK.js +189 -0
- package/dist/chunk-V4NPDK6X.js +14 -0
- package/dist/chunk-VJFEN6DJ.js +38 -0
- package/dist/chunk-WIW772I3.js +25 -0
- package/dist/chunk-XELAZAIM.js +136 -0
- package/dist/chunk-XNML2KIC.js +23 -0
- package/dist/chunk-XP2U3LO3.js +30 -0
- package/dist/chunk-YGOWIJPE.js +51 -0
- package/dist/chunk-YIXDHQYE.js +11 -0
- package/dist/chunk-YMHUM7AV.js +22 -0
- package/dist/chunk-YSAWTGNA.js +117 -0
- package/dist/chunk-Z4HRRXRF.js +478 -0
- package/dist/chunk-ZH6R642Z.js +102 -0
- package/dist/claude-U2JC2DNQ.js +77 -0
- package/dist/cli-VYCQJZ5X.js +41 -0
- package/dist/cli-ZTCBSDW4.js +46 -0
- package/dist/cli.js +144 -16160
- package/dist/completion-E7RRG3ZT.js +142 -0
- package/dist/config-DnpLL2kT.d.ts +46 -0
- package/dist/{service-qpCsOXkQ.d.ts → core-C1LPjxK6.d.ts} +2 -6
- package/dist/diagnostics-XXH4FLUG.js +93 -0
- package/dist/doctor-ZIOESU3N.js +538 -0
- package/dist/entry-ZNFCTDVE.js +305 -0
- package/dist/exec-mcp-X6372BLE.js +365 -0
- package/dist/harness-F2XFDYXF.js +177 -0
- package/dist/harness-egress-bridge.js +4 -4
- package/dist/harness-launch-gate.js +47 -940
- package/dist/harness-pane-runner.js +13 -80
- package/dist/harness-worker.js +21 -2703
- package/dist/hook-body.js +5221 -0
- package/dist/hook-spec-C5fWTSCH.d.ts +100 -0
- package/dist/hook.js +26 -0
- package/dist/hooks-FYE2L5RW.js +21 -0
- package/dist/host-GRY3VAHH.js +22 -0
- package/dist/host-X6BR6X4O.js +200 -0
- package/dist/host-run-GCA6H6SR.js +307 -0
- package/dist/http.d.ts +5 -42
- package/dist/http.js +21 -2234
- package/dist/import-mcp-2TTBPVLY.js +400 -0
- package/dist/index.d.ts +146 -168
- package/dist/index.js +133 -4911
- package/dist/init-627KFXTG.js +14 -0
- package/dist/install-GG7HHZK2.js +796 -0
- package/dist/invoke-LW22Z6ET.js +23 -0
- package/dist/list-MCP2FXUF.js +68 -0
- package/dist/list-NGMSQ5SH.js +65 -0
- package/dist/load-BEUBABtB.d.ts +21 -0
- package/dist/logout-6CSHUWWE.js +44 -0
- package/dist/logs-SPB6AANY.js +107 -0
- package/dist/mailbox/index.d.ts +10 -5
- package/dist/mailbox/index.js +53 -1572
- package/dist/mailbox-7BV54Q4R.js +285 -0
- package/dist/mailbox-GDJ7BWQN.js +189 -0
- package/dist/mainline-JQTTYJMI.js +639 -0
- package/dist/marketplace-G4VQET5W.js +191 -0
- package/dist/mcp-2DKVU3SW.js +15 -0
- package/dist/mcp-V23HC3LB.js +193 -0
- package/dist/models-ISU4DCMA.js +32 -0
- package/dist/opencode-CN7JLQYO.js +60 -0
- package/dist/pause-FFAYRBWI.js +18 -0
- package/dist/preview-DT7DWG5F.js +91 -0
- package/dist/project/hook-adapter.d.ts +6 -3
- package/dist/project/hook-adapter.js +66 -35
- package/dist/project-FY62G55N.js +70 -0
- package/dist/pty-XTJ4MIWK.js +94 -0
- package/dist/recovery-U6QB3PMT.js +100 -0
- package/dist/reindex-Y27QJFDB.js +22 -0
- package/dist/resume-UU4HZIUP.js +18 -0
- package/dist/run-HALGEJNJ.js +19 -0
- package/dist/run-OGA3P7FC.js +126 -0
- package/dist/serve-NBKT5BKY.js +104 -0
- package/dist/session-XM2CR425.js +159 -0
- package/dist/setup-DTKZLZUT.js +18 -0
- package/dist/start-login-UIQYQBMC.js +416 -0
- package/dist/status-A2OUTNGK.js +9 -0
- package/dist/status-H2VAHIDV.js +10 -0
- package/dist/status-NOOHW5WA.js +43 -0
- package/dist/status-VHODZPXB.js +55 -0
- package/dist/status-XQANBVXW.js +286 -0
- package/dist/stdio.d.ts +3 -13
- package/dist/stdio.js +16 -3186
- package/dist/sweep-64JDCGK6.js +18 -0
- package/dist/test-MKAXFJOL.js +561 -0
- package/dist/tools-gpHNq9Dh.d.ts +328 -0
- package/dist/tui-MWKAXE4K.js +153 -0
- package/dist/unbroadcast-KPUEFLZD.js +18 -0
- package/dist/validate-5GZ5YWNA.js +46 -0
- package/dist/worker-RQ575EJL.js +80 -0
- package/dist/worktree-create-PZSRB7PH.js +89 -0
- package/dist/worktree-list-JYB6VXLW.js +51 -0
- package/dist/worktree-sync-UF5CXPWV.js +30 -0
- package/docs/hooks/capabilities/antigravity.json +199 -0
- package/docs/hooks/capabilities/claude.json +179 -0
- package/docs/hooks/capabilities/codex.json +179 -0
- package/docs/hooks/capabilities/gemini.json +196 -0
- package/docs/hooks/capabilities/grok.json +192 -0
- package/docs/hooks/capabilities/opencode.json +184 -0
- package/docs/project-configuration.md +844 -4
- package/docs/terminal-harness.md +71 -28
- package/docs/terminal-workspace.md +91 -170
- package/gemini-extension.json +1 -1
- package/package.json +13 -1
- package/plugin.json +1 -1
- package/plugins/pmcp/.claude-plugin/plugin.json +4 -2
- package/plugins/pmcp/gemini-extension.json +1 -1
- package/plugins/pmcp/mod/commands.ts +72 -0
- package/plugins/pmcp/mod/contract.d.ts +39 -0
- package/plugins/pmcp/mod/draw.tsx +216 -0
- package/plugins/pmcp/mod/guard.ts +42 -0
- package/plugins/pmcp/mod/hooks.json +4 -0
- package/plugins/pmcp/mod/host.ts +46 -0
- package/plugins/pmcp/mod/model.ts +144 -0
- package/plugins/pmcp/mod/reader/index.ts +18 -0
- package/plugins/pmcp/mod/reader/read.ts +76 -0
- package/plugins/pmcp/mod/reader/settings.ts +54 -0
- package/plugins/pmcp/mod/reader/types.ts +38 -0
- package/plugins/pmcp/mod/register.tsx +73 -0
- package/plugins/pmcp/mod/sessions/format.ts +91 -0
- package/plugins/pmcp/mod/sessions/types.ts +162 -0
- package/plugins/pmcp/mod/snapshot.ts +75 -0
- package/plugins/pmcp/mod/spinner.tsx +30 -0
- package/plugins/pmcp/mod/state.ts +28 -0
- package/plugins/pmcp/plugin.json +1 -1
- package/plugins/pmcp/skills/agent-assets-migrate/SKILL.md +96 -0
- package/plugins/pmcp/skills/headless-agents-ci-scaffold/SKILL.md +100 -0
- package/plugins/pmcp/skills/marketplace-plugin-scaffold/SKILL.md +87 -0
- package/plugins/pmcp/skills/package-skill-catalog/SKILL.md +51 -11
- package/plugins/pmcp/skills/pmcp-project-init/SKILL.md +145 -0
- package/plugins/pmcp/skills/pmcp-sessions-and-git/SKILL.md +104 -0
- package/plugins/pmcp/skills/skill-package-scaffold/SKILL.md +88 -0
- package/schema/catalog-v1.json +158 -0
- package/schema/library.json +164 -0
- package/schema/marketplace-manifest.json +130 -0
- package/schema/plugin-manifest.json +55 -0
- package/schema/skill-frontmatter.json +144 -0
- package/schema/skill-metadata-core.json +110 -0
- package/skills/agent-assets-migrate/SKILL.md +96 -0
- package/skills/headless-agents-ci-scaffold/SKILL.md +100 -0
- package/skills/marketplace-plugin-scaffold/SKILL.md +87 -0
- package/skills/package-skill-catalog/SKILL.md +51 -11
- package/skills/pmcp-project-init/SKILL.md +145 -0
- package/skills/pmcp-sessions-and-git/SKILL.md +104 -0
- package/skills/skill-package-scaffold/SKILL.md +88 -0
- package/dist/config-BkSpjUG6.d.ts +0 -50
- package/dist/embed-DRROSD3F.d.ts +0 -53
- package/dist/hook-spec-PRSnYGLV.d.ts +0 -10
- package/dist/server-VWSY3Shw.d.ts +0 -543
- package/dist/tui-worker.js +0 -6549
- /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 };
|
package/dist/embed-DRROSD3F.d.ts
DELETED
|
@@ -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,10 +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
|
-
}
|
|
9
|
-
|
|
10
|
-
export type { HookTool as H, ShellHookSpec as S };
|