@godxjp/ui-mcp 28.4.0 → 28.5.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/README.md +27 -0
- package/dist/index.js +45 -39
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -45,6 +45,33 @@ npx @godxjp/ui-mcp
|
|
|
45
45
|
|
|
46
46
|
---
|
|
47
47
|
|
|
48
|
+
## Upgrading is TWO steps, and the second one is not optional
|
|
49
|
+
|
|
50
|
+
```sh
|
|
51
|
+
npm install @godxjp/ui@<version> @godxjp/ui-mcp@<version>
|
|
52
|
+
npx @godxjp/ui sync-rules # ← the half that is easy to skip
|
|
53
|
+
```
|
|
54
|
+
|
|
55
|
+
`node_modules` is not where this server is launched from. `.mcp.json` launches it by
|
|
56
|
+
`npx @godxjp/ui-mcp@<pin>`, so **a package upgrade alone leaves the pin where it was** and the agent
|
|
57
|
+
keeps reading the catalog of whatever release the project first installed. Measured in gh#794: a
|
|
58
|
+
project upgraded to 28.3.0 and every answer that session came from a **27.6.0** catalog — two minors
|
|
59
|
+
behind the pin itself, seven behind the package on disk.
|
|
60
|
+
|
|
61
|
+
`sync-rules` moves the pin for you. It recognises an entry this package wrote, under any pin, and
|
|
62
|
+
rewrites it; a registration you wrote by hand is left alone and reported instead of overwritten.
|
|
63
|
+
|
|
64
|
+
**Two things will tell you when the pin is stale**, and neither is the version line — that line
|
|
65
|
+
prints on every answer and reads as boilerplate:
|
|
66
|
+
|
|
67
|
+
- **`npx @godxjp/ui audit`** raises `owned-rules-stale`. This is the reliable one: it runs from the
|
|
68
|
+
**installed** package, so it is never the stale party, however old the pinned server is.
|
|
69
|
+
- **The server's own `⚠️ SERVER OLDER THAN INSTALLED PACKAGE` line**, from **v27.9.0** onward. Note
|
|
70
|
+
the ordering: a server old enough to predate that release cannot warn you about itself, so the
|
|
71
|
+
pinned lane can fail silently exactly once — on the upgrade that crosses 27.9.0.
|
|
72
|
+
|
|
73
|
+
---
|
|
74
|
+
|
|
48
75
|
## Configure your agent
|
|
49
76
|
|
|
50
77
|
### Claude Code
|