pigment-mcp 0.2.1 → 0.4.0

package/README.md

@@ -3,11 +3,10 @@
 # pigment-mcp
 
 MCP server for [Pigment](https://pigmentui.com) design systems. Your coding agent (Claude Code, Codex,
-Cursor or any MCP client) reads tokens, rules, component specs and installation guides for a pinned
-version while it works.
+Cursor or any MCP client) reads tokens, rules, component specs and installation guides while it works.
 
-Every published design system ships inside this package, so it works offline and a version never changes
-under you. New systems arrive with new package versions.
+Every design system ships inside this package, so it works offline. New systems and updates arrive with new
+package releases.
 
 ## Connect
 
@@ -33,7 +32,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.
@@ -42,11 +41,12 @@ propose a plan, restyle one sample screen, then report build and visual checks.
 
 | Tool | Returns |
 | --- | --- |
-| `list_design_systems` | Published systems with tags and versions (`tone?`, `appearance?`) |
-| `get_design_system` | The full spec of one pinned version: rules, token tables, setup, verification |
+| `list_design_systems` | Systems with tags and when each was last updated (`tone?`, `appearance?`) |
+| `get_design_system` | The full spec of a system: rules, token tables, setup, verification |
 | `get_tokens` | `tokens.css` or `tokens.json`, to copy verbatim |
 | `get_component_spec` | One component: anatomy, variants, states, accessibility, token mapping |
 | `get_installation_guide` | Steps and approval points for `new`, `existing` or `ongoing` |
+| `get_changelog` | What changed, by date — to update a project that already has the system |
 | `get_references` | Screenshots of four reference apps restyled with the system |
 
 Requires Node 22+.

package/cli.js

@@ -1536,10 +1536,10 @@ var init_regexes = __esm({
     duration = /^P(?:(\d+W)|(?!.*W)(?=\d|T\d)(\d+Y)?(\d+M)?(\d+D)?(T(?=\d)(\d+H)?(\d+M)?(\d+([.,]\d+)?S)?)?)$/;
     extendedDuration = /^[-+]?P(?!$)(?:(?:[-+]?\d+Y)|(?:[-+]?\d+[.,]\d+Y$))?(?:(?:[-+]?\d+M)|(?:[-+]?\d+[.,]\d+M$))?(?:(?:[-+]?\d+W)|(?:[-+]?\d+[.,]\d+W$))?(?:(?:[-+]?\d+D)|(?:[-+]?\d+[.,]\d+D$))?(?:T(?=[\d+-])(?:(?:[-+]?\d+H)|(?:[-+]?\d+[.,]\d+H$))?(?:(?:[-+]?\d+M)|(?:[-+]?\d+[.,]\d+M$))?(?:[-+]?\d+(?:[.,]\d+)?S)?)??$/;
     guid = /^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$/;
-    uuid = (version3) => {
-      if (!version3)
+    uuid = (version2) => {
+      if (!version2)
         return /^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$/;
-      return new RegExp(`^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-${version3}[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$`);
+      return new RegExp(`^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-${version2}[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$`);
     };
     uuid4 = /* @__PURE__ */ uuid(4);
     uuid6 = /* @__PURE__ */ uuid(6);
@@ -19777,10 +19777,10 @@ function fromJSONSchema(schema, params) {
   } catch {
     throw new Error("fromJSONSchema input is not valid JSON (possibly cyclic); use $defs/$ref for recursive schemas");
   }
-  const version3 = detectVersion(normalized, params?.defaultTarget);
+  const version2 = detectVersion(normalized, params?.defaultTarget);
   const defs = normalized.$defs || normalized.definitions || {};
   const ctx = {
-    version: version3,
+    version: version2,
     defs,
     refs: /* @__PURE__ */ new Map(),
     processing: /* @__PURE__ */ new Set(),
@@ -21466,14 +21466,14 @@ function missingClientCapabilities(required2, declared) {
   }
   return Object.keys(missing).length > 0 ? missing : void 0;
 }
-function isModernProtocolVersion(version3) {
-  return version3 >= FIRST_MODERN_PROTOCOL_VERSION;
+function isModernProtocolVersion(version2) {
+  return version2 >= FIRST_MODERN_PROTOCOL_VERSION;
 }
 function legacyProtocolVersions(versions) {
-  return versions.filter((version3) => !isModernProtocolVersion(version3));
+  return versions.filter((version2) => !isModernProtocolVersion(version2));
 }
 function modernProtocolVersions(versions) {
-  return versions.filter((version3) => isModernProtocolVersion(version3));
+  return versions.filter((version2) => isModernProtocolVersion(version2));
 }
 function appendTextFallbackForNonObject(result) {
   const sc = result.structuredContent;
@@ -23588,8 +23588,8 @@ function getWireResultSchemas() {
   };
   return wireResultSchemasMemo;
 }
-function codecForVersion(version3) {
-  return version3 !== void 0 && isModernProtocolVersion(version3) ? rev2026Codec : rev2025Codec;
+function codecForVersion(version2) {
+  return version2 !== void 0 && isModernProtocolVersion(version2) ? rev2026Codec : rev2025Codec;
 }
 function classifiedWireEra(classification) {
   if (classification.revision !== void 0) return codecForVersion(classification.revision).era;
@@ -25202,8 +25202,8 @@ var init_src_Cqbh3MYc = __esm({
       */
       _negotiatedProtocolVersion;
       static {
-        writeNegotiatedProtocolVersion = (instance, version3) => {
-          instance._negotiatedProtocolVersion = version3;
+        writeNegotiatedProtocolVersion = (instance, version2) => {
+          instance._negotiatedProtocolVersion = version2;
         };
       }
       _supportedProtocolVersions;
@@ -33268,7 +33268,7 @@ var init_mcp_DIH4cS6P = __esm({
           if (identity.clientInfo !== void 0) server._clientVersion = identity.clientInfo;
         };
         installDiscoverHandler = (server, servedModernVersions) => {
-          const missing = servedModernVersions.filter((version3) => !server._supportedProtocolVersions.includes(version3));
+          const missing = servedModernVersions.filter((version2) => !server._supportedProtocolVersions.includes(version2));
           if (missing.length > 0) server._supportedProtocolVersions = [...server._supportedProtocolVersions, ...missing];
           server.setRequestHandler("server/discover", () => server._ondiscover());
         };
@@ -34680,7 +34680,7 @@ var init_src = __esm({
 
 // ../content/src/index.ts
 import { existsSync, readdirSync, readFileSync } from "node:fs";
-import { dirname, join, resolve } from "node:path";
+import { basename, dirname, join, resolve } from "node:path";
 function findContentRoot() {
   if (process.env.PIGMENT_CONTENT_DIR) return resolve(process.env.PIGMENT_CONTENT_DIR);
   let dir = process.cwd();
@@ -34705,25 +34705,31 @@ function publishedVersions(id2) {
   if (!entry) throw new ContentError("unknown_template", `No published template "${id2}"`);
   return entry.versions.filter((v) => v.status === "published").map((v) => v.version);
 }
-function versionDir(id2, version3) {
+function versionDir(id2, version2) {
   const versions = publishedVersions(id2);
-  const resolvedVersion = version3 === "latest" ? registry2().templates.find((t) => t.id === id2)?.latest : version3;
+  const resolvedVersion = version2 === "latest" ? registry2().templates.find((t) => t.id === id2)?.latest : version2;
   if (!resolvedVersion || !versions.includes(resolvedVersion)) {
-    throw new ContentError("unknown_version", `"${id2}" has no published version "${version3}". Available: ${versions.join(", ") || "none"}`);
+    throw new ContentError("unknown_version", `"${id2}" has no published version "${version2}". Available: ${versions.join(", ") || "none"}`);
   }
   return join(contentRoot(), "templates", id2, resolvedVersion);
 }
-function getManifest(id2, version3) {
-  return Manifest.parse(readJson(join(versionDir(id2, version3), "manifest.json")));
+function getManifest(id2, version2) {
+  return Manifest.parse(readJson(join(versionDir(id2, version2), "manifest.json")));
 }
-function readArtifact(id2, version3, rel) {
-  const file2 = join(versionDir(id2, version3), rel);
-  if (!existsSync(file2)) throw new ContentError("unavailable_artifact", `${id2}@${version3} has no ${rel}`);
-  return readFileSync(file2, "utf8");
+function readArtifact(id2, version2, rel) {
+  const dir = versionDir(id2, version2);
+  const file2 = join(dir, rel);
+  if (!existsSync(file2)) throw new ContentError("unavailable_artifact", `${id2}@${version2} has no ${rel}`);
+  return unversioned(id2, basename(dir), readFileSync(file2, "utf8"));
 }
-function getTokens(id2, version3) {
-  const manifest = getManifest(id2, version3);
-  const dir = versionDir(id2, version3);
+function unversioned(id2, version2, text2) {
+  const name = getManifest(id2, version2).name;
+  const date5 = (registry2().templates.find((t) => t.id === id2)?.versions.find((v) => v.version === version2)?.publishedAt ?? "").slice(0, 10);
+  return text2.replaceAll(`${name} ${version2}`, name).replaceAll(`${id2}@${version2}`, date5 ? `${id2}, updated ${date5}` : id2).replaceAll(`"version": "${version2}",`, `"updated": "${date5}",`);
+}
+function getTokens(id2, version2) {
+  const manifest = getManifest(id2, version2);
+  const dir = versionDir(id2, version2);
   const primitives = readJson(join(dir, manifest.artifacts.tokens.primitives));
   const out = {};
   for (const mode2 of ["light", "dark"]) {
@@ -34734,41 +34740,67 @@ function getTokens(id2, version3) {
   }
   return out;
 }
-function getComponents(id2, version3) {
-  const manifest = getManifest(id2, version3);
-  return ComponentIndex.parse(JSON.parse(readArtifact(id2, version3, manifest.artifacts.components)));
+function getComponents(id2, version2) {
+  const manifest = getManifest(id2, version2);
+  return ComponentIndex.parse(JSON.parse(readArtifact(id2, version2, manifest.artifacts.components)));
 }
-function getComponentSpec(id2, version3, name) {
-  const entry = getComponents(id2, version3).components.find((c) => c.name === name);
-  if (!entry) throw new ContentError("invalid_component", `${id2}@${version3} has no component "${name}"`);
-  if (entry.status === "unsupported" || !entry.file) return { entry, markdown: `${name} is not specified in this version.` };
-  return { entry, markdown: readArtifact(id2, version3, join("components", entry.file)) };
+function getComponentSpec(id2, version2, name) {
+  const entry = getComponents(id2, version2).components.find((c) => c.name === name);
+  if (!entry) throw new ContentError("invalid_component", `${id2}@${version2} has no component "${name}"`);
+  if (entry.status === "unsupported" || !entry.file) return { entry, markdown: `${name} is not specified in this system.` };
+  return { entry, markdown: readArtifact(id2, version2, join("components", entry.file)) };
 }
-function getGuide(id2, version3, mode2) {
+function getGuide(id2, version2, mode2) {
   if (!(mode2 in GUIDE_SECTIONS)) throw new ContentError("invalid_mode", `mode must be one of ${Object.keys(GUIDE_SECTIONS).join(", ")}`);
-  const text2 = readArtifact(id2, version3, getManifest(id2, version3).artifacts.instructions);
+  const text2 = readArtifact(id2, version2, getManifest(id2, version2).artifacts.instructions);
   const start = text2.indexOf(GUIDE_SECTIONS[mode2]);
   const rest = text2.slice(start);
   const next = rest.indexOf("\n## ", 3);
   const verification = text2.slice(text2.indexOf("## Verification"));
   return (next > 0 ? rest.slice(0, next) : rest).trim() + "\n\n" + verification.trim();
 }
-function getAgentMd(id2, version3) {
-  return readArtifact(id2, version3, join("dist", "agent.md"));
+function getAgentMd(id2, version2) {
+  return readArtifact(id2, version2, join("dist", "agent.md"));
 }
-function getTokenFile(id2, version3, format) {
-  return readArtifact(id2, version3, join("dist", `tokens.${format}`));
+function getTokenFile(id2, version2, format) {
+  return readArtifact(id2, version2, join("dist", `tokens.${format}`));
 }
-function resolveVersion(id2, version3) {
-  return getManifest(id2, version3).version;
+function changelogEntry(id2, version2) {
+  let md;
+  try {
+    md = readArtifact(id2, version2, "CHANGELOG.md").replace(/\r\n/g, "\n");
+  } catch {
+    return { summary: "", changes: [] };
+  }
+  const start = md.indexOf(`
+## ${version2}
+`);
+  if (start < 0) return { summary: "", changes: [] };
+  const rest = md.slice(start + version2.length + 5);
+  const section = rest.slice(0, rest.search(/\n## |$/)).trim();
+  const summary = (section.split(/\n\s*\n/)[0] ?? "").replace(/\s*\n\s*/g, " ").trim();
+  const changes = [];
+  for (const line of section.split("\n")) {
+    if (line.startsWith("- ")) changes.push(line.slice(2).trim());
+    else if (/^\s+\S/.test(line) && changes.length) changes[changes.length - 1] += ` ${line.trim()}`;
+  }
+  return { summary, changes };
+}
+function getHistory(id2) {
+  const entry = registry2().templates.find((t) => t.id === id2);
+  if (!entry) throw new ContentError("unknown_template", `No published template "${id2}"`);
+  return entry.versions.filter((v) => v.status === "published").reverse().map((v) => ({ date: (v.publishedAt ?? "").slice(0, 10), ...changelogEntry(id2, v.version) }));
+}
+function resolveVersion(id2, version2) {
+  return getManifest(id2, version2).version;
 }
-function getShots(id2, version3) {
-  return shotsFor(id2, resolveVersion(id2, version3));
+function getShots(id2, version2) {
+  return shotsFor(id2, resolveVersion(id2, version2));
 }
-function shotsFor(id2, version3) {
+function shotsFor(id2, version2) {
   const index = join(contentRoot(), "shots.json");
-  if (existsSync(index)) return readJson(index)[`${id2}@${version3}`] ?? {};
-  const dir = join(contentRoot(), "..", "apps", "web", "public", "showcase", id2, version3);
+  if (existsSync(index)) return readJson(index)[`${id2}@${version2}`] ?? {};
+  const dir = join(contentRoot(), "..", "apps", "web", "public", "showcase", id2, version2);
   const shots = {};
   if (!existsSync(dir)) return shots;
   for (const app of readdirSync(dir)) {
@@ -34777,27 +34809,28 @@ function shotsFor(id2, version3) {
     const files = readdirSync(join(dir, app)).filter((f) => f.endsWith(".png"));
     for (const [key, re] of Object.entries({ desktopLight: /desktop-light/, desktopDark: /desktop-dark/, mobileLight: /mobile-light/, mobileDark: /mobile-dark/ })) {
       const f = cover[key] ?? files.find((x) => re.test(x));
-      if (f) shots[`${app}.${key}`] = `/showcase/${id2}/${version3}/${app}/${f}`;
+      if (f) shots[`${app}.${key}`] = `/showcase/${id2}/${version2}/${app}/${f}`;
     }
   }
   return shots;
 }
 function listTemplates() {
   return registry2().templates.filter((t) => t.latest).map((t) => {
-    const version3 = t.latest;
-    const manifest = getManifest(t.id, version3);
-    const tokens = getTokens(t.id, version3);
+    const version2 = t.latest;
+    const manifest = getManifest(t.id, version2);
+    const tokens = getTokens(t.id, version2);
     const light = tokens.light ?? tokens.dark ?? {};
     const swatch = (k) => typeof light[k] === "string" ? light[k] : "#000000";
     return {
       id: t.id,
-      version: version3,
+      version: version2,
       name: manifest.name,
       description: manifest.description,
       tags: manifest.tags,
       versions: t.versions.filter((v) => v.status === "published").map((v) => v.version),
+      updated: (t.versions.find((v) => v.version === version2)?.publishedAt ?? "").slice(0, 10),
       swatches: ["color.surface.default", "color.surface.subtle", "color.text.primary", "color.action.primary", "color.action.primaryHover"].map(swatch),
-      shots: shotsFor(t.id, version3)
+      shots: shotsFor(t.id, version2)
     };
   });
 }
@@ -34819,17 +34852,16 @@ var init_src2 = __esm({
 });
 
 // ../content/src/prompts.ts
-function specRef(id2, version3, delivery) {
-  if (delivery === "url") return `Spec: ${SITE_URL}/s/${id2}/${version3}/agent.md`;
+function specRef(id2, delivery) {
+  if (delivery === "url") return `Spec: ${SITE_URL}/s/${id2}/agent.md`;
   if (delivery === "mcp") return "Read the spec with the Pigment MCP tools (get_design_system, get_component_spec).";
-  return `Spec: ./design-packages/${id2}-${version3}/dist/agent.md`;
+  return `Spec: dist/agent.md in the ${id2} package, unzipped under ./design-packages/`;
 }
-function buildPrompt(id2, version3, mode2, delivery) {
-  const ref = `${id2}@${version3}`;
-  const spec = specRef(id2, version3, delivery);
+function buildPrompt(id2, mode2, delivery) {
+  const spec = specRef(id2, delivery);
   if (mode2 === "new") {
     return [
-      `Set up design system ${ref} in this codebase.`,
+      `Set up design system ${id2} in this codebase.`,
       spec,
       "First inspect the framework, styling approach and component structure, then propose an installation plan and wait for my approval.",
       "Don't add libraries that don't fit the existing stack. Leave an AGENTS.md / CLAUDE.md pointer so future screens reuse the system.",
@@ -34838,7 +34870,7 @@ function buildPrompt(id2, version3, mode2, delivery) {
   }
   if (mode2 === "existing") {
     return [
-      `Apply design system ${ref} to this project.`,
+      `Apply design system ${id2} to this project.`,
       spec,
       "Preserve features, routes, business logic, API contracts, tests and accessibility.",
       "Audit styles and components first, then propose a migration plan and wait for my approval. Restyle one screen as a sample and wait again.",
@@ -34846,7 +34878,7 @@ function buildPrompt(id2, version3, mode2, delivery) {
     ].join("\n");
   }
   return [
-    `Build this with the installed design system ${ref}.`,
+    `Build this with the installed design system ${id2}.`,
     "Use its semantic tokens and component conventions from design-system/. Don't hard-code new style values.",
     "If the spec doesn't cover something, ask me with options before deciding."
   ].join("\n");
@@ -34866,7 +34898,7 @@ var init_package = __esm({
   "package.json"() {
     package_default = {
       name: "@pigment/mcp",
-      version: "0.2.1",
+      version: "0.4.0",
       private: true,
       type: "module",
       description: "MCP server for Pigment design systems: tokens, rules, component specs and installation guides for your coding agent.",
@@ -34908,9 +34940,15 @@ function guard(fn) {
     throw e;
   }
 }
-function specForMcp(systemId, pinned) {
-  const md = getAgentMd(systemId, pinned);
-  const index = getComponents(systemId, pinned).components;
+function updated(systemId) {
+  const t = listTemplates().find((x) => x.id === systemId);
+  if (!t) throw new ContentError("unknown_template", `No published system "${systemId}". Call list_design_systems.`);
+  return t.updated;
+}
+function specForMcp(systemId) {
+  const date5 = updated(systemId);
+  const md = getAgentMd(systemId, CURRENT);
+  const index = getComponents(systemId, CURRENT).components;
   const start = md.indexOf("\n## Components");
   const end = start < 0 ? -1 : md.indexOf("\n## ", start + 4);
   const specified = index.filter((c) => c.status !== "unsupported").map((c) => c.name);
@@ -34918,22 +34956,23 @@ function specForMcp(systemId, pinned) {
   const chapter = [
     "\n## Components\n",
     `Specified: ${specified.join(", ")}. Read each with get_component_spec before building it.`,
-    unsupported.length ? `Not specified in this version: ${unsupported.join(", ")} \u2014 compose them from tokens and say so in your report.` : ""
+    unsupported.length ? `Not specified in this system: ${unsupported.join(", ")} \u2014 compose them from tokens and say so in your report.` : ""
   ].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.`,
+    `> Pigment system ${systemId}, updated ${date5}. Write \`${systemId}, updated ${date5}\` in design-system/VERSION.`,
+    "> 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",
     {
       title: "List design systems",
-      description: "Browse the published Pigment design systems with their tone, appearance, keywords and latest stable version. Use it to pick a system or check which versions exist.",
+      description: "Browse the Pigment design systems with their tone, appearance, keywords and when each was last updated. Use it to pick a system.",
       inputSchema: external_exports.object({
         tone: external_exports.string().optional().describe("Filter by tone: minimal, natural, soft, editorial, brutalist, technical, playful, luxury"),
         appearance: external_exports.enum(["light", "dark"]).optional().describe("Only systems that support this appearance")
@@ -34941,67 +34980,77 @@ function createServer() {
       annotations: { readOnlyHint: true }
     },
     async ({ tone, appearance }) => guard(() => {
-      const items = listTemplates().filter((t) => !tone || t.tags.tone === tone).filter((t) => !appearance || t.tags.appearance.includes(appearance)).map((t) => ({ id: t.id, name: t.name, latest: t.version, versions: t.versions, description: t.description, tags: t.tags, page: `${SITE_URL}/s/${t.id}` }));
-      return items.length ? JSON.stringify(items, null, 2) : "No published system matches that filter.";
+      const items = listTemplates().filter((t) => !tone || t.tags.tone === tone).filter((t) => !appearance || t.tags.appearance.includes(appearance)).map((t) => ({ id: t.id, name: t.name, updated: t.updated, description: t.description, tags: t.tags, page: `${SITE_URL}/s/${t.id}` }));
+      return items.length ? JSON.stringify(items, null, 2) : "No system matches that filter.";
     })
   );
   server.registerTool(
     "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.",
-      inputSchema: external_exports.object({ id, version: version2 }),
+      description: "The full specification of a system: 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 }),
       annotations: { readOnlyHint: true }
     },
-    async (args) => guard(() => specForMcp(args.id, resolveVersion(args.id, args.version)))
+    async (args) => guard(() => specForMcp(args.id))
   );
   server.registerTool(
     "get_tokens",
     {
       title: "Get token file",
       description: "The exact token values, light and dark, as tokens.css (CSS custom properties) or tokens.json. Copy the file into the project unchanged; never retype values.",
-      inputSchema: external_exports.object({ id, version: version2, format: external_exports.enum(["css", "json"]).default("css") }),
+      inputSchema: external_exports.object({ id, format: external_exports.enum(["css", "json"]).default("css") }),
       annotations: { readOnlyHint: true }
     },
-    async (args) => guard(() => getTokenFile(args.id, args.version, args.format))
+    async (args) => guard(() => getTokenFile(args.id, CURRENT, args.format))
   );
   server.registerTool(
     "get_component_spec",
     {
       title: "Get component spec",
       description: "Anatomy, variants, every state, accessibility and token mapping for one component (e.g. button, table, dialog). Read it before building or restyling that component.",
-      inputSchema: external_exports.object({ id, version: version2, component: external_exports.string().describe("Component name from the Components list in get_design_system") }),
+      inputSchema: external_exports.object({ id, component: external_exports.string().describe("Component name from the Components list in get_design_system") }),
       annotations: { readOnlyHint: true }
     },
-    async (args) => guard(() => getComponentSpec(args.id, args.version, args.component).markdown)
+    async (args) => guard(() => getComponentSpec(args.id, CURRENT, args.component).markdown)
   );
   server.registerTool(
     "get_installation_guide",
     {
       title: "Get installation guide",
       description: "Steps, approval points and checks for one scenario: new (set up a fresh project), existing (restyle a working app without changing behavior) or ongoing (build new screens in a project that already uses the system).",
-      inputSchema: external_exports.object({ id, version: version2, mode }),
+      inputSchema: external_exports.object({ id, mode }),
       annotations: { readOnlyHint: true }
     },
-    async (args) => guard(() => getGuide(args.id, args.version, args.mode))
+    async (args) => guard(() => getGuide(args.id, CURRENT, args.mode))
+  );
+  server.registerTool(
+    "get_changelog",
+    {
+      title: "Get changelog",
+      description: "What changed in a system, newest first, by date. Use it to update a project: apply only the entries dated after the date in the project's design-system/VERSION.",
+      inputSchema: external_exports.object({ id }),
+      annotations: { readOnlyHint: true }
+    },
+    async (args) => guard(() => JSON.stringify(getHistory(args.id), null, 2))
   );
   server.registerTool(
     "get_references",
     {
       title: "Get references",
-      description: "Screenshots of four reference apps (dashboard, store, blog, settings) restyled with this version by an agent \u2014 desktop and mobile, light and dark \u2014 plus links to the system page, spec and offline package.",
-      inputSchema: external_exports.object({ id, version: version2, app: external_exports.string().optional().describe("Only one app: dashboard, commerce, blog or settings") }),
+      description: "Screenshots of four reference apps (dashboard, store, blog, settings) restyled with this system by an agent \u2014 desktop and mobile, light and dark \u2014 plus links to the system page, spec and offline package.",
+      inputSchema: external_exports.object({ id, app: external_exports.string().optional().describe("Only one app: dashboard, commerce, blog or settings") }),
       annotations: { readOnlyHint: true }
     },
     async (args) => guard(() => {
-      const pinned = resolveVersion(args.id, args.version);
-      const shots = Object.entries(getShots(args.id, pinned)).filter(([key]) => !args.app || key.startsWith(`${args.app}.`)).map(([key, path]) => ({ view: key, url: SITE_URL + path }));
+      const shots = Object.entries(getShots(args.id, CURRENT)).filter(([key]) => !args.app || key.startsWith(`${args.app}.`)).map(([key, path]) => ({ view: key, url: SITE_URL + path }));
       return JSON.stringify(
         {
-          system: `${args.id}@${pinned}`,
-          page: `${SITE_URL}/s/${args.id}/${pinned}`,
-          spec: `${SITE_URL}/s/${args.id}/${pinned}/agent.md`,
-          package: `${SITE_URL}/download/${args.id}/${pinned}`,
+          system: args.id,
+          updated: updated(args.id),
+          page: `${SITE_URL}/s/${args.id}`,
+          spec: `${SITE_URL}/s/${args.id}/agent.md`,
+          package: `${SITE_URL}/download/${args.id}`,
           screenshots: shots
         },
         null,
@@ -35013,29 +35062,22 @@ function createServer() {
     "apply",
     {
       title: "Apply a design system",
-      description: "Install or apply a pinned Pigment design system with a plan, an approval step and a verification report.",
+      description: "Install or apply a Pigment design system with a plan, an approval step and a verification report.",
       argsSchema: external_exports.object({
         id: external_exports.string().describe('Design system id, e.g. "margin-notes"'),
-        version: external_exports.string().optional().describe("Version to pin; defaults to the latest stable version"),
         mode: external_exports.string().optional().describe("new, existing (default) or ongoing")
       })
     },
-    ({ id: systemId, version: wanted, mode: scenario }) => {
-      const pinned = getManifest(systemId, wanted ?? "latest").version;
+    ({ id: systemId, mode: scenario }) => {
       const m = mode.safeParse(scenario ?? "existing");
       return {
-        messages: [
-          {
-            role: "user",
-            content: { type: "text", text: buildPrompt(systemId, pinned, m.success ? m.data : "existing", "mcp") }
-          }
-        ]
+        messages: [{ role: "user", content: { type: "text", text: buildPrompt(systemId, m.success ? m.data : "existing", "mcp") } }]
       };
     }
   );
   return server;
 }
-var SERVER_VERSION, id, version2, mode;
+var SERVER_VERSION, CURRENT, id, mode, INSTRUCTIONS;
 var init_server = __esm({
   "src/server.ts"() {
     "use strict";
@@ -35045,9 +35087,15 @@ var init_server = __esm({
     init_zod();
     init_package();
     SERVER_VERSION = package_default.version;
+    CURRENT = "latest";
     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.');
     mode = external_exports.enum(["new", "existing", "ongoing"]);
+    INSTRUCTIONS = [
+      "Pigment serves design systems for coding agents. Every tool returns the current system; there is nothing to choose or pin.",
+      "Applying a system copies it into the project's design-system/ folder (tokens, component notes and a VERSION file naming the system and its update date).",
+      "From then on design-system/ is the project's source of truth: build new screens from it and don't re-fetch tokens unless the user asks to update.",
+      "To update, call get_changelog, apply only the entries dated after the date in design-system/VERSION, and then write the new date."
+    ].join("\n");
   }
 });
 

package/package.json

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