@modootoday/pmcp 0.21.0 → 0.22.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/.mcp.json +1 -1
- package/dist/{apply-6FLMTJDV.js → apply-3PR4UOES.js} +10 -10
- package/dist/{chunk-DJZPPCJP.js → chunk-2QJGUR23.js} +3 -3
- package/dist/{chunk-OS5DF3LL.js → chunk-3LADLKAI.js} +4 -4
- package/dist/{chunk-G6JXCUSK.js → chunk-3OBJVG5R.js} +2 -2
- package/dist/{chunk-KVNNVLJR.js → chunk-5ZUDBC3P.js} +2 -2
- package/dist/{chunk-5FW7A6TG.js → chunk-73IDLWRI.js} +2 -2
- package/dist/{chunk-TBKVC2TA.js → chunk-E6YP2PMO.js} +2 -2
- package/dist/{chunk-R3MVL67T.js → chunk-EPNTYTDZ.js} +12 -12
- package/dist/{chunk-ZIJ5IUXH.js → chunk-GBKRDRMZ.js} +14 -5
- package/dist/chunk-L42U5XKC.js +7 -0
- package/dist/{chunk-Z4Q6RYJH.js → chunk-LVNGMGOM.js} +2 -2
- package/dist/{chunk-GQP4GWU4.js → chunk-NDED2O5B.js} +5 -5
- package/dist/{chunk-VBDDFO2V.js → chunk-RNC7PGW2.js} +2 -2
- package/dist/{chunk-OFPNCLG7.js → chunk-RNE4WPBS.js} +2 -2
- package/dist/{chunk-33KGCJB2.js → chunk-S4Y44CCC.js} +2 -2
- package/dist/{chunk-UFWQTZDX.js → chunk-SEM6WD7J.js} +5 -5
- package/dist/{chunk-YLITJLTR.js → chunk-SLCNCAWY.js} +3 -3
- package/dist/{chunk-POTI2RJ6.js → chunk-SPZ42EWE.js} +2 -2
- package/dist/{chunk-VUM6LO77.js → chunk-TCW2H47H.js} +9 -21
- package/dist/{chunk-3X5JQYKN.js → chunk-TPGJXENR.js} +3 -3
- package/dist/chunk-UKR64U7J.js +20 -0
- package/dist/{chunk-DEY23WTH.js → chunk-XB363ZXT.js} +2 -2
- package/dist/{chunk-UD3BEEBQ.js → chunk-XZ2TDH3J.js} +80 -3
- package/dist/{cli-RVPR3MH3.js → cli-BEEDAD4E.js} +5 -5
- package/dist/cli.js +3 -3
- package/dist/{completion-YTPHEVEW.js → completion-LHYNCQ3N.js} +2 -2
- package/dist/{diagnostics-IW54MLFK.js → diagnostics-ABTJUYZQ.js} +5 -5
- package/dist/{doctor-EN4JPSKV.js → doctor-GPPO5L4F.js} +12 -12
- package/dist/{entry-TQWSDTJ4.js → entry-ARGY5CKA.js} +9 -9
- package/dist/{exec-mcp-KKQ75N5O.js → exec-mcp-JEF74XVP.js} +8 -8
- package/dist/{harness-EB76F6BG.js → harness-OCXW6YE4.js} +3 -3
- package/dist/harness-launch-gate.js +3 -3
- package/dist/harness-worker.js +5 -5
- package/dist/{hooks-YWSHUNLM.js → hooks-JHXUN5MD.js} +3 -3
- package/dist/{host-LSVITS6M.js → host-OBRHBDRE.js} +6 -6
- package/dist/{host-OGGADMBT.js → host-VI4ZFCZP.js} +10 -10
- package/dist/{host-run-XO2TS4JC.js → host-run-H7AITG7C.js} +4 -4
- package/dist/http.js +1 -1
- package/dist/{import-mcp-BJDJTPVS.js → import-mcp-3Y33CUHF.js} +7 -7
- package/dist/index.d.ts +1 -1
- package/dist/index.js +11 -11
- package/dist/{init-773PTQM5.js → init-WZJHMWNJ.js} +2 -2
- package/dist/{invoke-Y7XH5S2L.js → invoke-GWWTXQLO.js} +7 -7
- package/dist/{list-5W65XVES.js → list-Y6UPLGNF.js} +9 -9
- package/dist/{logout-XO6ALD45.js → logout-KAUW4JZZ.js} +8 -8
- package/dist/{mainline-M2NSTAGC.js → mainline-Q42M2GJ2.js} +106 -13
- package/dist/{mcp-R62ZNVGJ.js → mcp-IDEUIY2F.js} +2 -2
- package/dist/{project-W5DQIZA6.js → project-GVVWLDOJ.js} +4 -4
- package/dist/{run-WYJMTLX7.js → run-HVNKQHVU.js} +4 -4
- package/dist/{run-OZLGSRHF.js → run-RRWB7U2Q.js} +7 -7
- package/dist/{serve-DCQGAGB7.js → serve-KJSOU3BR.js} +3 -3
- package/dist/{setup-D3KEJBGO.js → setup-3GET6K3J.js} +2 -2
- package/dist/{start-login-EKXM75XQ.js → start-login-RNHSEX5P.js} +8 -8
- package/dist/{status-23UDIYYP.js → status-RR4VZARJ.js} +9 -9
- package/dist/{status-EDSEG32U.js → status-Y25ONHA5.js} +8 -8
- package/dist/stdio.js +2 -2
- package/dist/{test-TM6PIZTV.js → test-7NYPQ6YU.js} +8 -8
- package/dist/{tui-EQNJIDN5.js → tui-H5RPSF4B.js} +4 -4
- package/dist/{worker-7X6WBPEI.js → worker-YWFTWIBP.js} +7 -7
- package/dist/{worktree-sync-T6C5YEYS.js → worktree-sync-A277AF4M.js} +3 -5
- package/docs/commands.md +1 -1
- package/docs/git-workflow.md +29 -8
- package/docs/project-configuration.md +4 -0
- package/docs/upgrading.md +16 -0
- package/gemini-extension.json +2 -2
- package/mcp.json +1 -1
- package/package.json +5 -5
- package/plugin.json +1 -1
- package/plugins/pmcp/.claude-plugin/plugin.json +1 -1
- package/plugins/pmcp/.mcp.json +1 -1
- package/plugins/pmcp/gemini-extension.json +2 -2
- package/plugins/pmcp/mcp.json +1 -1
- package/plugins/pmcp/plugin.json +1 -1
- package/plugins/pmcp/skills/agent-assets-migrate/SKILL.md +11 -8
- package/plugins/pmcp/skills/pmcp-project-init/SKILL.md +11 -7
- package/skills/agent-assets-migrate/SKILL.md +11 -8
- package/skills/pmcp-project-init/SKILL.md +11 -7
- package/dist/chunk-2MAD4WNZ.js +0 -92
- package/dist/chunk-H4ZOKIER.js +0 -7
|
@@ -1,13 +1,13 @@
|
|
|
1
1
|
import {
|
|
2
2
|
serverFrom
|
|
3
|
-
} from "./chunk-
|
|
3
|
+
} from "./chunk-RNE4WPBS.js";
|
|
4
4
|
import {
|
|
5
5
|
status
|
|
6
6
|
} from "./chunk-UPQTAHUK.js";
|
|
7
7
|
import "./chunk-RPCIROW7.js";
|
|
8
|
-
import "./chunk-
|
|
9
|
-
import "./chunk-
|
|
10
|
-
import "./chunk-
|
|
8
|
+
import "./chunk-TCW2H47H.js";
|
|
9
|
+
import "./chunk-UKR64U7J.js";
|
|
10
|
+
import "./chunk-XZ2TDH3J.js";
|
|
11
11
|
import "./chunk-KUBHGVTD.js";
|
|
12
12
|
import "./chunk-EATCUWGG.js";
|
|
13
13
|
import "./chunk-OFJIMBTL.js";
|
|
@@ -16,7 +16,7 @@ import "./chunk-LFFIQBNY.js";
|
|
|
16
16
|
import "./chunk-HQOB7OQS.js";
|
|
17
17
|
import "./chunk-73AKO4UL.js";
|
|
18
18
|
import "./chunk-P6LNYYYH.js";
|
|
19
|
-
import "./chunk-
|
|
19
|
+
import "./chunk-GBKRDRMZ.js";
|
|
20
20
|
import "./chunk-2Q6MNGU5.js";
|
|
21
21
|
import "./chunk-MR5IBS6L.js";
|
|
22
22
|
import "./chunk-Z6WRFOFT.js";
|
|
@@ -25,10 +25,10 @@ import "./chunk-Q5H3L6Y4.js";
|
|
|
25
25
|
import "./chunk-5YCKFU5Q.js";
|
|
26
26
|
import "./chunk-A4PKLESO.js";
|
|
27
27
|
import "./chunk-V4NPDK6X.js";
|
|
28
|
-
import "./chunk-
|
|
28
|
+
import "./chunk-XB363ZXT.js";
|
|
29
29
|
import "./chunk-OEH47H6A.js";
|
|
30
30
|
import "./chunk-IJBSOWHK.js";
|
|
31
|
-
import "./chunk-
|
|
31
|
+
import "./chunk-L42U5XKC.js";
|
|
32
32
|
import "./chunk-GJXOFDJT.js";
|
|
33
33
|
import "./chunk-PMJG2CXF.js";
|
|
34
34
|
import "./chunk-J6KL3COD.js";
|
|
@@ -44,4 +44,4 @@ function run(context) {
|
|
|
44
44
|
export {
|
|
45
45
|
run
|
|
46
46
|
};
|
|
47
|
-
//# sourceMappingURL=status-
|
|
47
|
+
//# sourceMappingURL=status-Y25ONHA5.js.map
|
package/dist/stdio.js
CHANGED
|
@@ -4,8 +4,8 @@ import {
|
|
|
4
4
|
resolveRoots,
|
|
5
5
|
serve,
|
|
6
6
|
serveWithMailbox
|
|
7
|
-
} from "./chunk-
|
|
8
|
-
import "./chunk-
|
|
7
|
+
} from "./chunk-3OBJVG5R.js";
|
|
8
|
+
import "./chunk-LVNGMGOM.js";
|
|
9
9
|
import "./chunk-6WXMJOMI.js";
|
|
10
10
|
import "./chunk-4CRRLDDS.js";
|
|
11
11
|
import "./chunk-YSAWTGNA.js";
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import {
|
|
2
2
|
specFrom
|
|
3
|
-
} from "./chunk-
|
|
3
|
+
} from "./chunk-RNC7PGW2.js";
|
|
4
4
|
import {
|
|
5
5
|
sourceFor
|
|
6
6
|
} from "./chunk-7TD53M7L.js";
|
|
@@ -11,9 +11,9 @@ import {
|
|
|
11
11
|
commandsOf,
|
|
12
12
|
customMode,
|
|
13
13
|
customPolicy
|
|
14
|
-
} from "./chunk-
|
|
15
|
-
import "./chunk-
|
|
16
|
-
import "./chunk-
|
|
14
|
+
} from "./chunk-TCW2H47H.js";
|
|
15
|
+
import "./chunk-UKR64U7J.js";
|
|
16
|
+
import "./chunk-XZ2TDH3J.js";
|
|
17
17
|
import "./chunk-KUBHGVTD.js";
|
|
18
18
|
import "./chunk-EATCUWGG.js";
|
|
19
19
|
import "./chunk-OFJIMBTL.js";
|
|
@@ -25,7 +25,7 @@ import {
|
|
|
25
25
|
} from "./chunk-HQOB7OQS.js";
|
|
26
26
|
import "./chunk-73AKO4UL.js";
|
|
27
27
|
import "./chunk-P6LNYYYH.js";
|
|
28
|
-
import "./chunk-
|
|
28
|
+
import "./chunk-GBKRDRMZ.js";
|
|
29
29
|
import "./chunk-2Q6MNGU5.js";
|
|
30
30
|
import {
|
|
31
31
|
SESSION_ID,
|
|
@@ -53,7 +53,7 @@ import {
|
|
|
53
53
|
one
|
|
54
54
|
} from "./chunk-A4PKLESO.js";
|
|
55
55
|
import "./chunk-V4NPDK6X.js";
|
|
56
|
-
import "./chunk-
|
|
56
|
+
import "./chunk-XB363ZXT.js";
|
|
57
57
|
import {
|
|
58
58
|
expandPath
|
|
59
59
|
} from "./chunk-OEH47H6A.js";
|
|
@@ -61,7 +61,7 @@ import {
|
|
|
61
61
|
checkoutOf,
|
|
62
62
|
worktreesOf
|
|
63
63
|
} from "./chunk-IJBSOWHK.js";
|
|
64
|
-
import "./chunk-
|
|
64
|
+
import "./chunk-L42U5XKC.js";
|
|
65
65
|
import "./chunk-GJXOFDJT.js";
|
|
66
66
|
import "./chunk-PMJG2CXF.js";
|
|
67
67
|
import "./chunk-J6KL3COD.js";
|
|
@@ -607,4 +607,4 @@ async function run(context) {
|
|
|
607
607
|
export {
|
|
608
608
|
run
|
|
609
609
|
};
|
|
610
|
-
//# sourceMappingURL=test-
|
|
610
|
+
//# sourceMappingURL=test-7NYPQ6YU.js.map
|
|
@@ -112,10 +112,10 @@ var tuiCommand = {
|
|
|
112
112
|
try {
|
|
113
113
|
let receipt;
|
|
114
114
|
if (invocation.action === "doctor") {
|
|
115
|
-
const { inspectTerminalHost } = await import("./diagnostics-
|
|
115
|
+
const { inspectTerminalHost } = await import("./diagnostics-ABTJUYZQ.js");
|
|
116
116
|
receipt = inspectTerminalHost();
|
|
117
117
|
} else if (invocation.action === "start-worker") {
|
|
118
|
-
const { startWorkspaceWorker } = await import("./worker-
|
|
118
|
+
const { startWorkspaceWorker } = await import("./worker-YWFTWIBP.js");
|
|
119
119
|
receipt = await startWorkspaceWorker(
|
|
120
120
|
{ config: invocation.startup?.config, cwd: context.cwd },
|
|
121
121
|
invocation.startup.runtime,
|
|
@@ -128,7 +128,7 @@ var tuiCommand = {
|
|
|
128
128
|
cwd: context.cwd
|
|
129
129
|
});
|
|
130
130
|
} else {
|
|
131
|
-
const { launchStartup, planStartup } = await import("./entry-
|
|
131
|
+
const { launchStartup, planStartup } = await import("./entry-ARGY5CKA.js");
|
|
132
132
|
const request = { ...invocation.startup, cwd: context.cwd };
|
|
133
133
|
receipt = invocation.action === "plan" ? planStartup(request) : await launchStartup(
|
|
134
134
|
request,
|
|
@@ -150,4 +150,4 @@ var tuiCommand = {
|
|
|
150
150
|
export {
|
|
151
151
|
tuiCommand
|
|
152
152
|
};
|
|
153
|
-
//# sourceMappingURL=tui-
|
|
153
|
+
//# sourceMappingURL=tui-H5RPSF4B.js.map
|
|
@@ -5,19 +5,19 @@ import {
|
|
|
5
5
|
} from "./chunk-C3G75JH7.js";
|
|
6
6
|
import {
|
|
7
7
|
invoke
|
|
8
|
-
} from "./chunk-
|
|
8
|
+
} from "./chunk-NDED2O5B.js";
|
|
9
9
|
import "./chunk-DZ2MRTYT.js";
|
|
10
|
-
import "./chunk-
|
|
11
|
-
import "./chunk-
|
|
10
|
+
import "./chunk-SLCNCAWY.js";
|
|
11
|
+
import "./chunk-SPZ42EWE.js";
|
|
12
12
|
import {
|
|
13
13
|
locateExecutable
|
|
14
14
|
} from "./chunk-R2GPCZUX.js";
|
|
15
|
-
import "./chunk-
|
|
15
|
+
import "./chunk-S4Y44CCC.js";
|
|
16
16
|
import "./chunk-34DECPVC.js";
|
|
17
|
-
import "./chunk-
|
|
17
|
+
import "./chunk-XB363ZXT.js";
|
|
18
18
|
import "./chunk-OEH47H6A.js";
|
|
19
19
|
import "./chunk-IJBSOWHK.js";
|
|
20
|
-
import "./chunk-
|
|
20
|
+
import "./chunk-L42U5XKC.js";
|
|
21
21
|
import "./chunk-GJXOFDJT.js";
|
|
22
22
|
import "./chunk-PMJG2CXF.js";
|
|
23
23
|
import {
|
|
@@ -77,4 +77,4 @@ async function startWorkspaceWorker(request, runtime, memoryMb) {
|
|
|
77
77
|
export {
|
|
78
78
|
startWorkspaceWorker
|
|
79
79
|
};
|
|
80
|
-
//# sourceMappingURL=worker-
|
|
80
|
+
//# sourceMappingURL=worker-YWFTWIBP.js.map
|
|
@@ -2,11 +2,9 @@ import {
|
|
|
2
2
|
off
|
|
3
3
|
} from "./chunk-YIXDHQYE.js";
|
|
4
4
|
import {
|
|
5
|
+
installSpec,
|
|
5
6
|
syncWorktree
|
|
6
|
-
} from "./chunk-
|
|
7
|
-
import {
|
|
8
|
-
installSpec
|
|
9
|
-
} from "./chunk-UD3BEEBQ.js";
|
|
7
|
+
} from "./chunk-XZ2TDH3J.js";
|
|
10
8
|
import "./chunk-KUBHGVTD.js";
|
|
11
9
|
import "./chunk-P6LNYYYH.js";
|
|
12
10
|
import "./chunk-G7JONWL4.js";
|
|
@@ -28,4 +26,4 @@ var worktreeSync = (setup, _context, report) => {
|
|
|
28
26
|
export {
|
|
29
27
|
worktreeSync
|
|
30
28
|
};
|
|
31
|
-
//# sourceMappingURL=worktree-sync-
|
|
29
|
+
//# sourceMappingURL=worktree-sync-A277AF4M.js.map
|
package/docs/commands.md
CHANGED
|
@@ -190,7 +190,7 @@ The git workflow configured by [`[git]`](git-workflow.md). Each subcommand needs
|
|
|
190
190
|
- `worktree list` prints alias, branch, behind/ahead and path for the main checkout and each linked worktree.
|
|
191
191
|
- `worktree sync` moves the current worktree onto the mainline when that loses nothing; exit 1 when it is held back.
|
|
192
192
|
- `deliver` fetches, replays the named commits (default: the ones the upstream lacks) onto the mainline, runs the gate in its own tree under a lock, and pushes; it replays again if the mainline moved. A delivery that touches a leased path holds that lease until it has pushed and installed, and it refuses during a pause unless `--during-pause` or `during_pause = "allow"`. `--no-push` replays and runs the gate command, then stops: it takes no lease and pushes, syncs and notifies nothing, and it refuses `gate = "pre-push"`, where the push is the gate. Exit 0 delivered, gated with `--no-push`, or nothing to deliver; 1 refused, gate failed or attempts exhausted; 2 fetch failed or `--no-push` with the pre-push gate.
|
|
193
|
-
- `sync` moves the main checkout to the mainline, installs when a listed file changed, and follows clean submodule pins. Exit 0 moved or already equal, 1 when local work would be lost, 2 when blocked (undelivered edits) or the fetch failed.
|
|
193
|
+
- `sync` moves the main checkout to the mainline, installs when a listed file changed, and follows clean submodule pins. Exit 0 moved or already equal, 1 when local work would be lost, 2 when blocked (undelivered edits) or the fetch failed. Run in a desk (a linked worktree matching `[git.worktrees] desks`), it brings the desk up to date the same way without rebasing: exit 0 moved or current, 1 held (an unlanded commit, uncommitted tracked edits, a pause, another session's lease, a git operation in progress), with the reason. In any other linked worktree it exits 2.
|
|
194
194
|
|
|
195
195
|
## completion
|
|
196
196
|
|
package/docs/git-workflow.md
CHANGED
|
@@ -30,15 +30,34 @@ turn it on.
|
|
|
30
30
|
| `alias_pattern` | regex | `"^[a-z][a-z0-9-]{1,30}$"` |
|
|
31
31
|
| `bootstrap` | argv list | none |
|
|
32
32
|
| `link_from_main` | list | `[]` |
|
|
33
|
+
| `desks` | glob | `"<root>/*"` |
|
|
34
|
+
|
|
35
|
+
Each checkout is one of three kinds, derived and never declared per checkout:
|
|
36
|
+
**shared** is the main checkout (its `.git` is a directory), a **desk** is a
|
|
37
|
+
linked worktree whose path relative to the main checkout matches `desks` (by
|
|
38
|
+
default, the worktrees `pmcp git worktree create` makes), and every other linked
|
|
39
|
+
worktree is **scratch** (the gate tree, delivery replays, one made by hand).
|
|
33
40
|
|
|
34
41
|
`[git.worktrees.sync]` (opt-in) keeps each linked worktree on the mainline when moving it
|
|
35
42
|
loses nothing: `on_session_start` (`"fetch_and_move"` default, `"move"`,
|
|
36
43
|
`"off"`), `between_prompts` (`"move_if_light"` default, `"off"`: move only when
|
|
37
44
|
no install is needed), `install_after_move` (`"off"` default, `"background"`,
|
|
38
|
-
`"foreground"`)
|
|
39
|
-
session)
|
|
40
|
-
|
|
41
|
-
|
|
45
|
+
`"foreground"`), `notice_paths` (paths whose change is announced to the
|
|
46
|
+
session) and `after_deliver` (`"off"` default, or `"desk"`: a delivery run in a
|
|
47
|
+
desk then syncs that desk as `pmcp git sync` does there, holding its leases, and
|
|
48
|
+
the `--json` receipt reports it as `desk_sync`). Installs never block a session.
|
|
49
|
+
A worktree is not moved while the workspace is paused or while any lease is held
|
|
50
|
+
(every `[sessions.leases.<name>]`, or the implicit `lockfile` lease), and the
|
|
51
|
+
session is told which.
|
|
52
|
+
|
|
53
|
+
`pmcp git sync` acts by kind. In the main checkout it is the main checkout sync
|
|
54
|
+
described under `[git.mainline.sync]`. In a desk it brings the desk up to date
|
|
55
|
+
mid-session: it fetches, then fast-forwards, or uses `reset --keep` when every
|
|
56
|
+
commit the desk has beyond the mainline is landed there, follows clean
|
|
57
|
+
submodule pins and runs the install when the lockfile changed. It never rebases:
|
|
58
|
+
an unlanded commit, an uncommitted change to a tracked file, a pause, another
|
|
59
|
+
session's lease, or a git operation in progress holds the desk where it is
|
|
60
|
+
(exit 1, with the reason). In a scratch worktree it moves nothing (exit 2).
|
|
42
61
|
|
|
43
62
|
`[git.mainline.gate]`: `command` (argv; no gate when missing), `tree` (the
|
|
44
63
|
gate's worktree, default `<state dir>/gate/tree`; a relative path is relative to
|
|
@@ -107,15 +126,17 @@ variable reaches the push only if `push_env` names it.
|
|
|
107
126
|
|
|
108
127
|
`pmcp git deliver --json` prints one receipt on stdout when it ends, progress
|
|
109
128
|
staying on stderr: `{ok, code, delivered, upstream, attempts, replayed, gate,
|
|
110
|
-
leases, sync, reason?}`, where `delivered` is the upstream commit it pushed (or
|
|
129
|
+
leases, sync, desk_sync, reason?}`, where `delivered` is the upstream commit it pushed (or
|
|
111
130
|
`null`), `replayed` the tip of its last replay onto the upstream (or `null`),
|
|
112
131
|
`gate` is `{exit, log, by}` for the last gate run (or `null`; `by` is
|
|
113
132
|
`"command"` or `"pre-push"`), `leases` the leases it took, `sync` the main
|
|
114
133
|
checkout's sync after the delivery (or `null` when none ran) as
|
|
115
134
|
`{from, to, code, reason?}`: the main checkout's HEAD before and after, the exit
|
|
116
|
-
code `pmcp git sync` would have, and its last warning;
|
|
117
|
-
|
|
118
|
-
`
|
|
135
|
+
code `pmcp git sync` would have, and its last warning; `desk_sync` the same for the
|
|
136
|
+
delivering desk's own sync (`[git.worktrees.sync] after_deliver = "desk"`); and
|
|
137
|
+
`reason` is the last refusal or failure. `--no-push` stops after the gate, so its
|
|
138
|
+
receipt has `replayed` and `gate` but `delivered`, `sync` and `desk_sync` are
|
|
139
|
+
`null`.
|
|
119
140
|
Exit codes: `0` delivered or nothing to deliver, even when the sync after it was
|
|
120
141
|
refused; `1` refused, a lease or the gate lock held too long, a replay
|
|
121
142
|
conflict, the gate failed, the push failed or it gave up after `attempts`; `2`
|
|
@@ -144,6 +144,10 @@ pmcp doctor # ask each installed tool what it loads
|
|
|
144
144
|
|
|
145
145
|
Rules go to `.claude/rules/<dir>/`, never the top level, because Grok Build
|
|
146
146
|
loads top-level `.claude/rules/*.md` in every session regardless of `paths:`.
|
|
147
|
+
Grok Build reads `.agents/skills` itself in a trusted folder, so pmcp writes no
|
|
148
|
+
skill links for it; a skill placed by hand under `.grok/skills` would shadow the
|
|
149
|
+
`.agents/skills` one of the same name, and `pmcp project --check` reports it as
|
|
150
|
+
undeclared.
|
|
147
151
|
A server that names `${PROJECT_ROOT}` is launched through `sh`, which finds
|
|
148
152
|
`pmcp.toml` at spawn time, so the generated files hold no machine's path.
|
|
149
153
|
`pmcp.lock` records what was written; a file pmcp did not write is never
|
package/docs/upgrading.md
CHANGED
|
@@ -5,6 +5,22 @@
|
|
|
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.21 to 0.22
|
|
9
|
+
|
|
10
|
+
**pmcp writes no `.grok/skills` links.** Grok Build reads `.agents/skills` itself (measured on
|
|
11
|
+
1.0.62, in a folder it trusts), so the links were duplicates. The next `pmcp project` removes the
|
|
12
|
+
ones it wrote. A Grok older than 1.0.62 was not measured; check that `grok inspect --json`
|
|
13
|
+
lists your project's skills after upgrading, and keep 0.21 for that project if it does not.
|
|
14
|
+
|
|
15
|
+
**`pmcp git sync` now works in a desk.** In 0.21 it exited 2 in any linked worktree. A
|
|
16
|
+
linked worktree matching `[git.worktrees] desks` (by default every worktree under
|
|
17
|
+
`[git.worktrees] root`) is now brought up to date with the mainline when that loses
|
|
18
|
+
nothing, and held with exit 1 otherwise; any other linked worktree still exits 2. A script
|
|
19
|
+
that relied on exit 2 to skip desks should check the kind first, or set `desks` to a
|
|
20
|
+
pattern that matches none. `[git.worktrees.sync] after_deliver = "desk"` syncs the
|
|
21
|
+
delivering desk after a delivery, and the `--json` receipt gains `desk_sync`. See
|
|
22
|
+
[Git workflow](git-workflow.md).
|
|
23
|
+
|
|
8
24
|
## From 0.20 to 0.21
|
|
9
25
|
|
|
10
26
|
**Session records are written to `sessions/` alone.** 0.20 also wrote each record to the
|
package/gemini-extension.json
CHANGED
|
@@ -1,11 +1,11 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "pmcp",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.22.0",
|
|
4
4
|
"mcpServers": {
|
|
5
5
|
"pmcp": {
|
|
6
6
|
"type": "stdio",
|
|
7
7
|
"command": "npx",
|
|
8
|
-
"args": ["-y", "@modootoday/pmcp@0.
|
|
8
|
+
"args": ["-y", "@modootoday/pmcp@0.22.0", "serve"]
|
|
9
9
|
}
|
|
10
10
|
}
|
|
11
11
|
}
|
package/mcp.json
CHANGED
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@modootoday/pmcp",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.22.0",
|
|
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.
|
|
140
|
-
"@modootoday/pmcp-linux-arm64": "0.
|
|
141
|
-
"@modootoday/pmcp-darwin-x64": "0.
|
|
142
|
-
"@modootoday/pmcp-darwin-arm64": "0.
|
|
139
|
+
"@modootoday/pmcp-linux-x64": "0.22.0",
|
|
140
|
+
"@modootoday/pmcp-linux-arm64": "0.22.0",
|
|
141
|
+
"@modootoday/pmcp-darwin-x64": "0.22.0",
|
|
142
|
+
"@modootoday/pmcp-darwin-arm64": "0.22.0"
|
|
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.
|
|
4
|
+
"version": "0.22.0",
|
|
5
5
|
"description": "Find package skills and use native runtime project configuration.",
|
|
6
6
|
"author": { "name": "modootoday" },
|
|
7
7
|
"license": "Elastic-2.0",
|
package/plugins/pmcp/.mcp.json
CHANGED
|
@@ -1,11 +1,11 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "pmcp",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.22.0",
|
|
4
4
|
"mcpServers": {
|
|
5
5
|
"pmcp": {
|
|
6
6
|
"type": "stdio",
|
|
7
7
|
"command": "npx",
|
|
8
|
-
"args": ["-y", "@modootoday/pmcp@0.
|
|
8
|
+
"args": ["-y", "@modootoday/pmcp@0.22.0", "serve"]
|
|
9
9
|
}
|
|
10
10
|
}
|
|
11
11
|
}
|
package/plugins/pmcp/mcp.json
CHANGED
package/plugins/pmcp/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.
|
|
4
|
+
"version": "0.22.0",
|
|
5
5
|
"description": "Find package skills and use native runtime project configuration.",
|
|
6
6
|
"author": { "name": "modootoday" },
|
|
7
7
|
"license": "Elastic-2.0",
|
|
@@ -21,14 +21,14 @@ tool files.
|
|
|
21
21
|
|
|
22
22
|
List every source with its bytes and line count, and note which are links:
|
|
23
23
|
|
|
24
|
-
| Found | Goes to
|
|
25
|
-
| --------------------------------------------------------------------------------------------- |
|
|
26
|
-
| `CLAUDE.md`, `GEMINI.md`, `.cursorrules`, `.windsurfrules`, `.github/copilot-instructions.md` | merged into `AGENTS.md`; each then becomes a link to it
|
|
27
|
-
| `.claude/skills/<n>/`, `.agent/skills/<n>/` | `.agents/skills/<n>/` (whole folder)
|
|
28
|
-
| `.claude/commands/<n>.md`, `.agent/workflows/<n>.md` | `.agents/skills/<n>/SKILL.md` plus `[skills.<n>] invocation = "user"`
|
|
29
|
-
| `.claude/agents/<n>.md`, `.gemini/agents/<n>.md`, `.agent/agents/<n>.md` | `.agents/agents/<n>/agent.md`
|
|
30
|
-
| `.claude/rules/*.md` with `paths:` | `.agents/rules/<n>.md` with `trigger: glob` and `globs:`
|
|
31
|
-
| MCP entries in `.mcp.json`, `.gemini/settings.json`, `.codex/config.toml` | `[mcp.<alias>]` in `pmcp.toml`
|
|
24
|
+
| Found | Goes to |
|
|
25
|
+
| --------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------- |
|
|
26
|
+
| `CLAUDE.md`, `GEMINI.md`, `.cursorrules`, `.windsurfrules`, `.github/copilot-instructions.md` | merged into `AGENTS.md`; each then becomes a link to it, except `GEMINI.md` (section 2) |
|
|
27
|
+
| `.claude/skills/<n>/`, `.agent/skills/<n>/` | `.agents/skills/<n>/` (whole folder) |
|
|
28
|
+
| `.claude/commands/<n>.md`, `.agent/workflows/<n>.md` | `.agents/skills/<n>/SKILL.md` plus `[skills.<n>] invocation = "user"` |
|
|
29
|
+
| `.claude/agents/<n>.md`, `.gemini/agents/<n>.md`, `.agent/agents/<n>.md` | `.agents/agents/<n>/agent.md` |
|
|
30
|
+
| `.claude/rules/*.md` with `paths:` | `.agents/rules/<n>.md` with `trigger: glob` and `globs:` |
|
|
31
|
+
| MCP entries in `.mcp.json`, `.gemini/settings.json`, `.codex/config.toml` | `[mcp.<alias>]` in `pmcp.toml` |
|
|
32
32
|
|
|
33
33
|
pmcp has no Copilot or Cursor target. Keep those filenames as links to `AGENTS.md` so they
|
|
34
34
|
cannot drift.
|
|
@@ -38,6 +38,9 @@ cannot drift.
|
|
|
38
38
|
Diff each instruction file against the others line by line. Keep the union; where two say
|
|
39
39
|
different things, settle it from the code or ask, and record the decision. Do not summarise
|
|
40
40
|
during the move. Then replace each old file with a link (`ln -s AGENTS.md CLAUDE.md`).
|
|
41
|
+
For Gemini CLI, delete every `GEMINI.md` once its text is in the `AGENTS.md` beside it, and
|
|
42
|
+
set `"context": { "fileName": ["AGENTS.md"] }` in `.gemini/settings.json` (adding the key if
|
|
43
|
+
the file exists): Gemini CLI then reads `AGENTS.md` in each directory itself.
|
|
41
44
|
Use file-to-file links only: a directory symlink at the repository root, such as `.agents`
|
|
42
45
|
pointing at `.agent`, is rejected by the Codex sandbox.
|
|
43
46
|
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: pmcp-project-init
|
|
3
|
-
description: Set up a repository so every coding agent reads the same instructions, skills, subagents, rules and MCP servers - one AGENTS.md with CLAUDE.md and
|
|
3
|
+
description: Set up a repository so every coding agent reads the same instructions, skills, subagents, rules and MCP servers - one AGENTS.md with CLAUDE.md linked to it and Gemini CLI set to read it, sources under .agents/, a pmcp.toml with [targets] and [mcp.*] entries, then the optional layers chosen from what the repository is (hook guards, sessions, the git workflow when it is a git checkout, logging, shared MCP authentication, marketplaces), then pmcp project and pmcp doctor, plus the one-time trust step each agent CLI needs. Use when starting a new repository the pmcp way, adding pmcp to a repository that has no agent assets yet, enabling hooks, sessions or the git workflow, or when asked to write a pmcp.toml. Not for moving existing scattered agent files (migrate them instead) or for hosting a skills server.
|
|
4
4
|
metadata:
|
|
5
5
|
tier: open
|
|
6
6
|
level: L2
|
|
@@ -22,18 +22,22 @@ Install `@modootoday/pmcp` as a dev dependency. Never run the bare unscoped name
|
|
|
22
22
|
through npx: that name is not the package, and whoever publishes it later would run in your
|
|
23
23
|
repository.
|
|
24
24
|
|
|
25
|
-
## 1. Instructions: one file,
|
|
25
|
+
## 1. Instructions: one file, one link, one setting
|
|
26
26
|
|
|
27
27
|
```sh
|
|
28
28
|
printf '# <project>\n\n' > AGENTS.md
|
|
29
29
|
ln -s AGENTS.md CLAUDE.md
|
|
30
|
-
|
|
30
|
+
mkdir -p .gemini
|
|
31
|
+
printf '{\n "context": { "fileName": ["AGENTS.md"] }\n}\n' > .gemini/settings.json
|
|
31
32
|
```
|
|
32
33
|
|
|
33
|
-
`AGENTS.md` is the real file. Claude Code reads `CLAUDE.md
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
34
|
+
`AGENTS.md` is the real file. Claude Code reads `CLAUDE.md`, so the link makes it read the
|
|
35
|
+
same text. Gemini CLI reads every name in `context.fileName`, in each directory, so the
|
|
36
|
+
setting makes it read `AGENTS.md` itself, nested ones included, and no `GEMINI.md` is
|
|
37
|
+
needed. If `.gemini/settings.json` already exists, add the key to it; `pmcp project` keeps
|
|
38
|
+
keys it does not own. pmcp creates neither the link nor the setting. Keep the link
|
|
39
|
+
file-to-file; a directory symlink at the repository root (for example `.agents` pointing at
|
|
40
|
+
another folder) is rejected by the Codex sandbox.
|
|
37
41
|
|
|
38
42
|
## 2. Sources under .agents/
|
|
39
43
|
|
|
@@ -21,14 +21,14 @@ tool files.
|
|
|
21
21
|
|
|
22
22
|
List every source with its bytes and line count, and note which are links:
|
|
23
23
|
|
|
24
|
-
| Found | Goes to
|
|
25
|
-
| --------------------------------------------------------------------------------------------- |
|
|
26
|
-
| `CLAUDE.md`, `GEMINI.md`, `.cursorrules`, `.windsurfrules`, `.github/copilot-instructions.md` | merged into `AGENTS.md`; each then becomes a link to it
|
|
27
|
-
| `.claude/skills/<n>/`, `.agent/skills/<n>/` | `.agents/skills/<n>/` (whole folder)
|
|
28
|
-
| `.claude/commands/<n>.md`, `.agent/workflows/<n>.md` | `.agents/skills/<n>/SKILL.md` plus `[skills.<n>] invocation = "user"`
|
|
29
|
-
| `.claude/agents/<n>.md`, `.gemini/agents/<n>.md`, `.agent/agents/<n>.md` | `.agents/agents/<n>/agent.md`
|
|
30
|
-
| `.claude/rules/*.md` with `paths:` | `.agents/rules/<n>.md` with `trigger: glob` and `globs:`
|
|
31
|
-
| MCP entries in `.mcp.json`, `.gemini/settings.json`, `.codex/config.toml` | `[mcp.<alias>]` in `pmcp.toml`
|
|
24
|
+
| Found | Goes to |
|
|
25
|
+
| --------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------- |
|
|
26
|
+
| `CLAUDE.md`, `GEMINI.md`, `.cursorrules`, `.windsurfrules`, `.github/copilot-instructions.md` | merged into `AGENTS.md`; each then becomes a link to it, except `GEMINI.md` (section 2) |
|
|
27
|
+
| `.claude/skills/<n>/`, `.agent/skills/<n>/` | `.agents/skills/<n>/` (whole folder) |
|
|
28
|
+
| `.claude/commands/<n>.md`, `.agent/workflows/<n>.md` | `.agents/skills/<n>/SKILL.md` plus `[skills.<n>] invocation = "user"` |
|
|
29
|
+
| `.claude/agents/<n>.md`, `.gemini/agents/<n>.md`, `.agent/agents/<n>.md` | `.agents/agents/<n>/agent.md` |
|
|
30
|
+
| `.claude/rules/*.md` with `paths:` | `.agents/rules/<n>.md` with `trigger: glob` and `globs:` |
|
|
31
|
+
| MCP entries in `.mcp.json`, `.gemini/settings.json`, `.codex/config.toml` | `[mcp.<alias>]` in `pmcp.toml` |
|
|
32
32
|
|
|
33
33
|
pmcp has no Copilot or Cursor target. Keep those filenames as links to `AGENTS.md` so they
|
|
34
34
|
cannot drift.
|
|
@@ -38,6 +38,9 @@ cannot drift.
|
|
|
38
38
|
Diff each instruction file against the others line by line. Keep the union; where two say
|
|
39
39
|
different things, settle it from the code or ask, and record the decision. Do not summarise
|
|
40
40
|
during the move. Then replace each old file with a link (`ln -s AGENTS.md CLAUDE.md`).
|
|
41
|
+
For Gemini CLI, delete every `GEMINI.md` once its text is in the `AGENTS.md` beside it, and
|
|
42
|
+
set `"context": { "fileName": ["AGENTS.md"] }` in `.gemini/settings.json` (adding the key if
|
|
43
|
+
the file exists): Gemini CLI then reads `AGENTS.md` in each directory itself.
|
|
41
44
|
Use file-to-file links only: a directory symlink at the repository root, such as `.agents`
|
|
42
45
|
pointing at `.agent`, is rejected by the Codex sandbox.
|
|
43
46
|
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: pmcp-project-init
|
|
3
|
-
description: Set up a repository so every coding agent reads the same instructions, skills, subagents, rules and MCP servers - one AGENTS.md with CLAUDE.md and
|
|
3
|
+
description: Set up a repository so every coding agent reads the same instructions, skills, subagents, rules and MCP servers - one AGENTS.md with CLAUDE.md linked to it and Gemini CLI set to read it, sources under .agents/, a pmcp.toml with [targets] and [mcp.*] entries, then the optional layers chosen from what the repository is (hook guards, sessions, the git workflow when it is a git checkout, logging, shared MCP authentication, marketplaces), then pmcp project and pmcp doctor, plus the one-time trust step each agent CLI needs. Use when starting a new repository the pmcp way, adding pmcp to a repository that has no agent assets yet, enabling hooks, sessions or the git workflow, or when asked to write a pmcp.toml. Not for moving existing scattered agent files (migrate them instead) or for hosting a skills server.
|
|
4
4
|
metadata:
|
|
5
5
|
tier: open
|
|
6
6
|
level: L2
|
|
@@ -22,18 +22,22 @@ Install `@modootoday/pmcp` as a dev dependency. Never run the bare unscoped name
|
|
|
22
22
|
through npx: that name is not the package, and whoever publishes it later would run in your
|
|
23
23
|
repository.
|
|
24
24
|
|
|
25
|
-
## 1. Instructions: one file,
|
|
25
|
+
## 1. Instructions: one file, one link, one setting
|
|
26
26
|
|
|
27
27
|
```sh
|
|
28
28
|
printf '# <project>\n\n' > AGENTS.md
|
|
29
29
|
ln -s AGENTS.md CLAUDE.md
|
|
30
|
-
|
|
30
|
+
mkdir -p .gemini
|
|
31
|
+
printf '{\n "context": { "fileName": ["AGENTS.md"] }\n}\n' > .gemini/settings.json
|
|
31
32
|
```
|
|
32
33
|
|
|
33
|
-
`AGENTS.md` is the real file. Claude Code reads `CLAUDE.md
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
34
|
+
`AGENTS.md` is the real file. Claude Code reads `CLAUDE.md`, so the link makes it read the
|
|
35
|
+
same text. Gemini CLI reads every name in `context.fileName`, in each directory, so the
|
|
36
|
+
setting makes it read `AGENTS.md` itself, nested ones included, and no `GEMINI.md` is
|
|
37
|
+
needed. If `.gemini/settings.json` already exists, add the key to it; `pmcp project` keeps
|
|
38
|
+
keys it does not own. pmcp creates neither the link nor the setting. Keep the link
|
|
39
|
+
file-to-file; a directory symlink at the repository root (for example `.agents` pointing at
|
|
40
|
+
another folder) is rejected by the Codex sandbox.
|
|
37
41
|
|
|
38
42
|
## 2. Sources under .agents/
|
|
39
43
|
|