@adobe/design-data-agent-mcp 1.9.0 → 1.9.1

package/README.md

@@ -26,17 +26,26 @@ https://github.com/adobe/spectrum-design-data/tree/main/tools/design-data-agent-
 ### npm (MCP server)
 
 ```sh
-npx @adobe/design-data-agent-mcp
+npx @adobe/design-data-agent-mcp@latest
 ```
 
 The `@adobe/design-data` CLI binary is **only** needed for `authoring_session_step_intent`. All other tools run in-process. Set `DESIGN_DATA_BIN` if the binary is not on `PATH`.
 
+### Staying current
+
+The embedded Spectrum snapshot is baked into the wasm at build time and travels with the
+package version — there's no separate data update to run. Pin `@latest` (as above) so `npx`
+fetches the newest published version rather than reusing whatever it last cached; `-y` alone
+only skips the install confirmation, it doesn't force a re-fetch. Already on `/plugin`? Run
+`/plugin update design-data-agent@spectrum-design-data`. Call the primer tool and check
+`provenance.designDataVersion` to see which dataset version is embedded.
+
 ## MCP server
 
 Configure your MCP client to run:
 
 ```sh
-npx -y @adobe/design-data-agent-mcp
+npx -y @adobe/design-data-agent-mcp@latest
 ```
 
 Or from a repo clone:
@@ -100,7 +109,7 @@ node tools/design-data-agent-mcp/src/index.js
   "mcpServers": {
     "design-data-agent": {
       "command": "npx",
-      "args": ["-y", "@adobe/design-data-agent-mcp"],
+      "args": ["-y", "@adobe/design-data-agent-mcp@latest"],
       "env": {
         "DESIGN_DATA_ROOT": "/abs/path/to/your/repo",
         "DESIGN_DATA_PATH": "packages/design-data/tokens",
@@ -119,7 +128,7 @@ node tools/design-data-agent-mcp/src/index.js
   "mcpServers": {
     "design-data-agent": {
       "command": "npx",
-      "args": ["-y", "@adobe/design-data-agent-mcp"],
+      "args": ["-y", "@adobe/design-data-agent-mcp@latest"],
       "env": {
         "DESIGN_DATA_BIN": "design-data",
         "DESIGN_DATA_PATH": "/path/to/your/dataset"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adobe/design-data-agent-mcp",
-  "version": "1.9.0",
+  "version": "1.9.1",
   "description": "MCP server and Claude Code skill for the design-data agent surface — read tools run in-process via wasm",
   "type": "module",
   "main": "./src/index.js",
@@ -32,7 +32,7 @@
     "@modelcontextprotocol/sdk": "^1.27.1",
     "@adobe/design-data": "3.0.7",
     "@adobe/design-data-wasm": "0.7.0",
-    "@adobe/spectrum-design-data": "2.3.0"
+    "@adobe/spectrum-design-data": "2.3.1"
   },
   "devDependencies": {
     "ava": "^6.0.1"

package/skills/design-data/SKILL.md

@@ -6,7 +6,7 @@ description: >
   system, token lookup, spec-conformance, drift detection, or token authoring on custom data.
 metadata:
   author: adobe
-  version: "1.9.0"
+  version: "1.9.1"
 when_to_use: >
   Trigger on: design system, design tokens, spec-conformant, drift, validate tokens, token
   authoring, custom dataset, DESIGN_DATA_PATH, design-data validate, design-data diff,
@@ -38,7 +38,7 @@ Add `@adobe/design-data-agent-mcp` to your `.cursor/mcp.json`:
   "mcpServers": {
     "design-data-agent": {
       "command": "npx",
-      "args": ["-y", "@adobe/design-data-agent-mcp"],
+      "args": ["-y", "@adobe/design-data-agent-mcp@latest"],
       "env": {
         "DESIGN_DATA_PATH": "./packages/tokens/src",
         "DESIGN_DATA_COMPONENTS": "./packages/design-data/components",
@@ -49,7 +49,9 @@ Add `@adobe/design-data-agent-mcp` to your `.cursor/mcp.json`:
 }
 ```
 
-Adjust paths to match your dataset layout.
+Adjust paths to match your dataset layout. Pin `@latest` — the embedded Spectrum snapshot is
+baked into the wasm at build time and travels with the package version, so there's no separate
+data update to run, but plain `npx -y <pkg>` (no tag) can reuse a cached older build.
 
 ***
 

package/src/index.js

@@ -48,7 +48,17 @@ export function createMCPServer() {
   const allTools = createAllTools();
   const server = new Server(
     { name: "design-data-agent-mcp", version: pkg.version },
-    { capabilities: { tools: {} } },
+    {
+      capabilities: { tools: {} },
+      instructions:
+        "This server bundles a snapshot of Spectrum design data (tokens, components, " +
+        "guidelines) baked into its wasm at build time. The data version travels with the " +
+        "package version, so there is nothing to update separately. To get newer Spectrum " +
+        "data, install the latest published package (npx -y @adobe/design-data-agent-mcp@latest " +
+        '— plain "npx -y @adobe/design-data-agent-mcp" can reuse a cached older build). Call ' +
+        "the design-data primer tool and read provenance.designDataVersion to see the " +
+        "embedded dataset version.",
+    },
   );
   server.setRequestHandler(ListToolsRequestSchema, async () => ({
     tools: allTools.map(({ name, description, inputSchema }) => ({