pigment-mcp 0.2.1 → 0.3.0

package/README.md

@@ -33,7 +33,7 @@ Prefer nothing to install? The same server runs remotely: `claude mcp add --tran
 
 Start a new session and just ask:
 
-> Apply the Pigment design system margin-notes@1.0.0 to this project.
+> Apply the Pigment design system margin-notes to this project.
 
 Or run the `apply` prompt (Claude Code: `/mcp__pigment__apply`), which adds the working agreement: audit first,
 propose a plan, restyle one sample screen, then report build and visual checks.

package/cli.js

@@ -34866,7 +34866,7 @@ var init_package = __esm({
   "package.json"() {
     package_default = {
       name: "@pigment/mcp",
-      version: "0.2.1",
+      version: "0.3.0",
       private: true,
       type: "module",
       description: "MCP server for Pigment design systems: tokens, rules, component specs and installation guides for your coding agent.",
@@ -34922,13 +34922,14 @@ function specForMcp(systemId, pinned) {
   ].join("\n");
   const body = start < 0 ? md : md.slice(0, start) + chapter + (end < 0 ? "" : md.slice(end));
   return [
-    `> Delivered over MCP as ${systemId}@${pinned}. Where this document says tokens.css or tokens.json, call get_tokens and copy the file verbatim.`,
+    `> Delivered over MCP as ${systemId}@${pinned}. Record exactly \`${systemId}@${pinned}\` in design-system/VERSION and pass version "${pinned}" in every later call.`,
+    "> Where this document says tokens.css or tokens.json, call get_tokens and copy the file verbatim.",
     "",
     body
   ].join("\n");
 }
 function createServer() {
-  const server = new McpServer({ name: "pigment", title: "Pigment design systems", version: SERVER_VERSION });
+  const server = new McpServer({ name: "pigment", title: "Pigment design systems", version: SERVER_VERSION }, { instructions: INSTRUCTIONS });
   server.registerTool(
     "list_design_systems",
     {
@@ -34949,7 +34950,7 @@ function createServer() {
     "get_design_system",
     {
       title: "Get design system",
-      description: "The full specification of one pinned version: character, the defining rules, color, type, spacing and motion rules, semantic and primitive token tables, setup and verification. Read it before changing any UI.",
+      description: "The full specification of one version (the latest unless the project pins one): character, the defining rules, color, type, spacing and motion rules, semantic and primitive token tables, setup and verification. Read it before changing any UI.",
       inputSchema: external_exports.object({ id, version: version2 }),
       annotations: { readOnlyHint: true }
     },
@@ -35035,7 +35036,7 @@ function createServer() {
   );
   return server;
 }
-var SERVER_VERSION, id, version2, mode;
+var SERVER_VERSION, id, version2, INSTRUCTIONS, mode;
 var init_server = __esm({
   "src/server.ts"() {
     "use strict";
@@ -35046,7 +35047,13 @@ var init_server = __esm({
     init_package();
     SERVER_VERSION = package_default.version;
     id = external_exports.string().describe('Design system id, e.g. "margin-notes" (see list_design_systems)');
-    version2 = external_exports.string().describe('Exact version such as "1.0.0". Pin the version a project installed; "latest" only when starting fresh.');
+    version2 = external_exports.string().default("latest").describe('Leave out (or "latest") when adding a system to a project. If the project has design-system/VERSION (e.g. margin-notes@1.0.0), pass that exact version.');
+    INSTRUCTIONS = [
+      "Pigment serves versioned design systems. Published versions never change.",
+      "Before UI work, check the project for design-system/VERSION. If it exists, use exactly that id and version in every call.",
+      "If it does not, the user is adding a system: omit the version (latest), then record the exact id@version that get_design_system reports in design-system/VERSION.",
+      "Only change the recorded version when the user asks to upgrade."
+    ].join("\n");
     mode = external_exports.enum(["new", "existing", "ongoing"]);
   }
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pigment-mcp",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "description": "MCP server for Pigment design systems: tokens, rules, component specs and installation guides for your coding agent.",
   "type": "module",
   "bin": {