@pure-ds/core 0.7.8 → 0.7.9

package/.cursorrules

@@ -49,11 +49,11 @@ PDS follows the [Pure Web Manifesto](https://pureweb.dev/manifesto): "The browse
 2. Otherwise use workspace root paths (pure-ds development)
 3. Prefer reading actual files over guessing - the data is authoritative
 
-## 🔌 MCP-First Lookup Protocol (Preferred)
+## 🔌 MCP Lookup Protocol (Optional)
 
-If an MCP server named `pure-ds` is available, **use MCP tools first** before generating PDS code.
+Use MCP as an optimization, not a prerequisite. For fast, simple lookups, read local SSoT files directly first.
 
-### Required lookup order
+### When MCP is already connected
 
 1. **Tokens** → call `get_tokens`
 2. **Primitives / utilities / selectors** → call `find_utility_class`
@@ -66,8 +66,9 @@ If an MCP server named `pure-ds` is available, **use MCP tools first** before ge
 
 - Do not invent class names, tokens, attributes, events, or selectors.
 - If a value is not found in MCP results, state it is unavailable and suggest nearest matches.
-- Prefer MCP results over memory, including examples in this file.
-- If MCP is unavailable, fall back to direct SSoT file reads using the paths above.
+- Prefer MCP results over memory when MCP is already available.
+- If MCP is unavailable, slow to start, or errors, continue immediately with direct SSoT file reads using the paths above.
+- Never block or fail an answer solely because MCP is unavailable.
 - If neither MCP nor file reads are available, provide only conservative guidance and clearly mark uncertainty.
 
 ---

package/.github/copilot-instructions.md

@@ -49,11 +49,11 @@ PDS follows the [Pure Web Manifesto](https://pureweb.dev/manifesto): "The browse
 2. Otherwise use workspace root paths (pure-ds development)
 3. Prefer reading actual files over guessing - the data is authoritative
 
-## 🔌 MCP-First Lookup Protocol (Preferred)
+## 🔌 MCP Lookup Protocol (Optional)
 
-If an MCP server named `pure-ds` is available, **use MCP tools first** before generating PDS code.
+Use MCP as an optimization, not a prerequisite. For fast, simple lookups, read local SSoT files directly first.
 
-### Required lookup order
+### When MCP is already connected
 
 1. **Tokens** → call `get_tokens`
 2. **Primitives / utilities / selectors** → call `find_utility_class`
@@ -66,8 +66,9 @@ If an MCP server named `pure-ds` is available, **use MCP tools first** before ge
 
 - Do not invent class names, tokens, attributes, events, or selectors.
 - If a value is not found in MCP results, state it is unavailable and suggest nearest matches.
-- Prefer MCP results over memory, including examples in this file.
-- If MCP is unavailable, fall back to direct SSoT file reads using the paths above.
+- Prefer MCP results over memory when MCP is already available.
+- If MCP is unavailable, slow to start, or errors, continue immediately with direct SSoT file reads using the paths above.
+- Never block or fail an answer solely because MCP is unavailable.
 - If neither MCP nor file reads are available, provide only conservative guidance and clearly mark uncertainty.
 
 ---

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@pure-ds/core",
   "shortname": "pds",
-  "version": "0.7.8",
+  "version": "0.7.9",
   "description": "Why develop a Design System when you can generate one?",
   "repository": {
     "type": "git",

package/packages/pds-cli/bin/pds-mcp-health.js

@@ -57,6 +57,7 @@ async function runHealthCheck() {
 
   const state = { buffer: Buffer.alloc(0) };
   let initialized = false;
+  let serverName = 'pure-ds';
 
   const timer = setTimeout(() => {
     console.error('❌ MCP health check timed out while waiting for server responses.');
@@ -75,6 +76,7 @@ async function runHealthCheck() {
     parseFrames(state, chunk, (message) => {
       if (message.id === 1 && message.result?.serverInfo?.name) {
         initialized = true;
+        serverName = message.result.serverInfo.name;
         child.stdin.write(frame({ jsonrpc: '2.0', id: 2, method: 'tools/list', params: {} }));
         return;
       }
@@ -92,7 +94,7 @@ async function runHealthCheck() {
         }
 
         console.log('✅ PDS MCP health check passed');
-        console.log(`   Server: ${message.result?.serverInfo?.name || 'pds-ssoT'}`);
+        console.log(`   Server: ${serverName}`);
         console.log(`   Tools: ${toolNames.sort().join(', ')}`);
         clearTimeout(timer);
         child.kill();

package/packages/pds-cli/bin/pds-mcp-server.js

@@ -1,10 +1,15 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 
 import { createPdsMcpContext, getPdsMcpTools, runPdsMcpTool } from '../lib/pds-mcp-core.js';
 
-const SERVER_NAME = 'pds-ssoT';
+const SERVER_NAME = 'pure-ds';
 const SERVER_VERSION = '0.1.0';
-const PROTOCOL_VERSION = '2024-11-05';
+const DEFAULT_PROTOCOL_VERSION = '2024-11-05';
+const SUPPORTED_PROTOCOL_VERSIONS = new Set([
+  '2024-11-05',
+  '2025-03-26',
+  '2025-06-18',
+]);
 
 const ctx = createPdsMcpContext({ projectRoot: process.cwd() });
 const tools = getPdsMcpTools();
@@ -34,8 +39,13 @@ async function handleMessage(message) {
 
   try {
     if (method === 'initialize') {
+      const requestedProtocolVersion = params?.protocolVersion;
+      const protocolVersion = SUPPORTED_PROTOCOL_VERSIONS.has(requestedProtocolVersion)
+        ? requestedProtocolVersion
+        : DEFAULT_PROTOCOL_VERSION;
+
       return sendResponse(id, {
-        protocolVersion: PROTOCOL_VERSION,
+        protocolVersion,
         capabilities: {
           tools: {},
         },
@@ -138,3 +148,8 @@ process.on('uncaughtException', (error) => {
   const text = error?.stack || error?.message || String(error);
   process.stderr.write(`[pds-mcp-server] uncaughtException: ${text}\n`);
 });
+
+process.on('unhandledRejection', (error) => {
+  const text = error?.stack || error?.message || String(error);
+  process.stderr.write(`[pds-mcp-server] unhandledRejection: ${text}\n`);
+});

package/packages/pds-cli/bin/pds-setup-mcp.js

@@ -5,22 +5,27 @@ import { existsSync } from 'fs';
 import path from 'path';
 
 const projectRoot = process.cwd();
-const serverCommand = 'node';
+const serverCommand = process.execPath;
 
-function resolveServerScriptPath() {
-  const candidatePaths = [
-    './node_modules/@pure-ds/core/packages/pds-cli/bin/pds-mcp-server.js',
-    './packages/pds-cli/bin/pds-mcp-server.js',
+function getServerScriptCandidates() {
+  return [
+    'node_modules/@pure-ds/core/packages/pds-cli/bin/pds-mcp-server.js',
+    'node_modules/pure-ds/packages/pds-cli/bin/pds-mcp-server.js',
+    'packages/pds-cli/bin/pds-mcp-server.js',
   ];
+}
+
+function resolveServerScriptPath() {
+  const candidatePaths = getServerScriptCandidates();
 
-  for (const relativePath of candidatePaths) {
-    const absolutePath = path.join(projectRoot, relativePath);
+  for (const candidate of candidatePaths) {
+    const absolutePath = path.join(projectRoot, candidate);
     if (existsSync(absolutePath)) {
-      return relativePath;
+      return absolutePath;
     }
   }
 
-  return candidatePaths[0];
+  return path.join(projectRoot, candidatePaths[0]);
 }
 
 const serverArgs = [resolveServerScriptPath()];
@@ -49,6 +54,7 @@ async function setupVSCodeConfig() {
     type: 'stdio',
     command: serverCommand,
     args: serverArgs,
+    cwd: projectRoot,
   };
 
   await writeJson(configPath, { ...current, servers });
@@ -63,6 +69,7 @@ async function setupCursorConfig() {
   mcpServers['pure-ds'] = {
     command: serverCommand,
     args: serverArgs,
+    cwd: projectRoot,
   };
 
   await writeJson(configPath, { ...current, mcpServers });