@santi020k/lumen-mcp 3.0.0 → 4.0.0

package/dist/server.js

@@ -1,6 +1,9 @@
-import { McpServer, ResourceTemplate } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { McpServer, ResourceTemplate } from '@modelcontextprotocol/server';
 import * as z from 'zod';
+import { checkCompatibility } from './compatibility.js';
+import { compatibilityOutputSchema, componentOutputSchema, nativeComponentOutputSchema, recipeOutputSchema } from './contracts.js';
 import { loadLumenData } from './data.js';
+import { getMigration } from './migration.js';
 import { diagnose, diffCatalog, getCatalogManifest, getComponent, getMeta, getNativeComponent, getRecipe, getRules, getTokens, listComponents, listNativeComponents, search } from './tools.js';
 const readOnlyAnnotations = {
     destructiveHint: false,
@@ -21,11 +24,6 @@ const listComponentsOutputSchema = z.strictObject({
     components: z.array(componentSummarySchema),
     count: z.int().min(0)
 });
-const componentOutputSchema = z.strictObject({
-    component: z.record(z.string(), z.unknown()).optional(),
-    found: z.boolean(),
-    message: z.string().trim().optional()
-});
 const nativePlatformSchema = z.enum(['react-native', 'swiftui', 'compose']);
 const nativeComponentSummarySchema = z.strictObject({
     accessibility: z.string().trim(),
@@ -40,11 +38,6 @@ const listNativeComponentsOutputSchema = z.strictObject({
     components: z.array(nativeComponentSummarySchema),
     count: z.int().min(0)
 });
-const recipeOutputSchema = z.strictObject({
-    found: z.boolean(),
-    message: z.string().trim().optional(),
-    recipe: z.record(z.string(), z.unknown()).optional()
-});
 const searchResultSchema = z.strictObject({
     category: z.string().trim().optional(),
     description: z.string().trim(),
@@ -62,10 +55,18 @@ const searchOutputSchema = z.strictObject({
 });
 const tokensOutputSchema = z.strictObject({
     tokens: z.strictObject({
-        chart: z.record(z.string(), z.string().trim()),
-        colors: z.record(z.string(), z.string().trim()),
-        glass: z.record(z.string(), z.string().trim()),
+        presets: z.strictObject({
+            attribute: z.string().trim(),
+            names: z.array(z.enum(['default', 'studio', 'glass'])),
+            schemeAttribute: z.string().trim(),
+            materialPolicy: z.literal('explicit-surfaces')
+        }),
+        chart: z.record(z.string().trim(), z.string().trim()),
+        colors: z.record(z.string().trim(), z.string().trim()),
+        glass: z.record(z.string().trim(), z.string().trim()),
         semantic: z.array(z.string().trim()),
+        spacing: z.record(z.string().trim(), z.number().nonnegative()),
+        spacingRoles: z.record(z.string().trim(), z.string().trim()),
         themeAttribute: z.string().trim()
     })
 });
@@ -78,7 +79,7 @@ const metaOutputSchema = z.strictObject({
         componentCount: z.int().min(0),
         nativeComponentCount: z.int().min(0),
         packages: z.array(z.string().trim()),
-        packageVersions: z.record(z.string(), z.string().trim()),
+        packageVersions: z.record(z.string().trim(), z.string().trim()),
         registryName: z.string().trim(),
         registryVersion: z.int().min(1),
         schemaVersion: z.int().min(1),
@@ -86,10 +87,10 @@ const metaOutputSchema = z.strictObject({
     })
 });
 const catalogManifestSchema = z.strictObject({
-    components: z.record(z.string(), z.string().trim().regex(/^[a-f0-9]{64}$/)),
-    nativeComponents: z.record(z.string(), z.string().trim().regex(/^[a-f0-9]{64}$/))
+    components: z.record(z.string().trim(), z.string().trim().regex(/^[a-f0-9]{64}$/)),
+    nativeComponents: z.record(z.string().trim(), z.string().trim().regex(/^[a-f0-9]{64}$/))
         .optional(),
-    recipes: z.record(z.string(), z.string().trim().regex(/^[a-f0-9]{64}$/))
+    recipes: z.record(z.string().trim(), z.string().trim().regex(/^[a-f0-9]{64}$/))
 });
 const catalogChangesSchema = z.strictObject({
     added: z.array(z.string().trim()),
@@ -145,7 +146,7 @@ const jsonResource = (uri, data, mimeType = 'application/json') => ({
 export const createLumenServer = () => {
     const data = loadLumenData();
     const server = new McpServer({ name: '@santi020k/lumen-mcp', version: data.meta.serverVersion }, {
-        instructions: 'Read lumen://meta, lumen://diagnostics, and lumen://rules before generating Lumen code. Search or list the catalog, ' +
+        instructions: 'Compare resolved installed versions with lumen_check_compatibility. On mismatch use installed public types or a matching catalog. Read lumen://meta, lumen://diagnostics, and lumen://rules before generating Lumen code. Search or list the catalog, ' +
             'then inspect the selected web or native component for the target framework or platform at usage detail before requesting source.'
     });
     server.registerTool('lumen_list_components', {
@@ -204,7 +205,7 @@ export const createLumenServer = () => {
             platform: nativePlatformSchema
                 .meta({ description: 'Native implementation contract to return.' })
         }),
-        outputSchema: componentOutputSchema
+        outputSchema: nativeComponentOutputSchema
     }, args => toMcpResult(getNativeComponent(args)));
     server.registerTool('lumen_get_recipe', {
         annotations: readOnlyAnnotations,
@@ -227,6 +228,8 @@ export const createLumenServer = () => {
             framework: z.enum(['astro', 'react', 'elements'])
                 .optional()
                 .meta({ description: 'Only search framework-specific component contracts for this target.' }),
+            kind: z.enum(['component', 'native-component', 'recipe', 'rule', 'token']).optional()
+                .meta({ description: 'Return only this kind of match; combine with limit for focused discovery.' }),
             limit: z.int().min(1).max(100)
                 .optional()
                 .meta({ description: 'Maximum results to return (1-100, default 20).' }),
@@ -237,6 +240,32 @@ export const createLumenServer = () => {
         }),
         outputSchema: searchOutputSchema
     }, args => toMcpResult(search(args)));
+    server.registerTool('lumen_check_compatibility', {
+        annotations: readOnlyAnnotations,
+        description: 'Compare resolved installed Lumen package versions with this snapshot before generating or migrating code. Does not read repositories or change dependencies.',
+        inputSchema: z.strictObject({
+            packageVersions: z.record(z.string().trim().min(1).max(160), z.string().trim().min(1).max(100))
+                .meta({ description: 'Resolved versions from installed package metadata or native lock files, not manifest ranges. Include only Lumen packages.' })
+        }),
+        outputSchema: compatibilityOutputSchema
+    }, args => toMcpResult(checkCompatibility(args)));
+    server.registerTool('lumen_get_migration', {
+        annotations: readOnlyAnnotations,
+        description: 'Read the v4 migration contract, affected packages and review guidance. Does not modify consumer code or versions.',
+        inputSchema: z.strictObject({ packageName: z.string().trim().min(1).max(160).optional() }),
+        outputSchema: z.strictObject({
+            changes: z.array(z.strictObject({
+                currentContract: z.string().trim(),
+                docs: z.array(z.string().trim()),
+                id: z.string().trim(),
+                migration: z.string().trim(),
+                packages: z.array(z.string().trim()),
+                replacement: z.string().trim()
+            })),
+            status: z.string().trim(),
+            targetVersion: z.string().trim()
+        })
+    }, args => toMcpResult(getMigration(args)));
     server.registerTool('lumen_get_meta', {
         annotations: readOnlyAnnotations,
         description: 'Return snapshot provenance: server and package versions, schema version, component count, ' +
@@ -270,7 +299,7 @@ export const createLumenServer = () => {
     }, () => toMcpResult(diagnose()));
     server.registerTool('lumen_get_tokens', {
         annotations: readOnlyAnnotations,
-        description: 'Return structured Lumen semantic tokens, base color values, glass tokens, and theme attribute.',
+        description: 'Return Lumen spacing dimensions and content roles, semantic colors, glass tokens, and theme attribute.',
         inputSchema: z.strictObject({}),
         outputSchema: tokensOutputSchema
     }, () => toMcpResult(getTokens()));

package/dist/tools.d.ts

@@ -80,6 +80,7 @@ declare const componentDetail: (component: LumenComponentSnapshot, framework: Lu
                 name: string;
                 type: string;
             }[];
+            runtimeBypass?: string;
             setup: string;
         };
         example: string;
@@ -214,6 +215,7 @@ export declare const getRecipe: (args: {
 }>;
 export declare const search: (args: {
     framework?: FrameworkFilter | undefined;
+    kind?: SearchResult["kind"] | undefined;
     limit?: number | undefined;
     platform?: NativePlatformFilter | undefined;
     query: string;

package/dist/tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"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"}

package/dist/tools.js

@@ -1,5 +1,7 @@
 import { loadLumenData } from './data.js';
 const normalize = (value) => value
+    .normalize('NFD')
+    .replaceAll(/[\u0300-\u036f]/g, '')
     .replaceAll(/([a-z0-9])([A-Z])/g, '$1-$2')
     .replaceAll(/[\s_]+/g, '-')
     .toLowerCase();
@@ -25,9 +27,40 @@ const searchStopWords = new Set([
     'the',
     'to',
     'ui',
-    'with'
+    'with',
+    'de',
+    'del',
+    'el',
+    'la',
+    'las',
+    'los',
+    'para',
+    'un',
+    'una',
+    'y',
+    'con',
+    'accesible'
 ]);
 const searchTermAliases = {
+    boton: ['button'],
+    buscar: ['search'],
+    calendario: ['calendar'],
+    confirmar: ['confirm', 'confirmation'],
+    contrasena: ['password'],
+    eliminacion: ['delete', 'destructive'],
+    eliminar: ['delete', 'destructive'],
+    fecha: ['date'],
+    fechas: ['date'],
+    formulario: ['form'],
+    modal: ['modal', 'dialog'],
+    notificacion: ['toast', 'notification'],
+    oscuro: ['dark', 'theme'],
+    paginada: ['pagination', 'paginated'],
+    rango: ['range'],
+    registros: ['records', 'data-table'],
+    seleccion: ['select'],
+    selector: ['select', 'picker'],
+    tabla: ['table'],
     booking: ['booking', 'schedule', 'calendar', 'appointment', 'date'],
     dark: ['dark', 'theme'],
     dashboard: ['dashboard', 'data-table', 'sidebar', 'chart', 'stat', 'metric'],
@@ -141,19 +174,19 @@ const nativeComponentSearchText = (component, platform) => [
 ].join(' ');
 const scoreCandidate = (query, terms, searchableText, primaryName = '') => {
     const normalizedText = normalize(searchableText);
-    const matchedTerms = terms.filter(term => (Reflect.get(searchTermAliases, term) ?? [term]).some(candidate => normalizedText.includes(candidate)));
+    const matchedTerms = terms.filter(term => ((Object.hasOwn(searchTermAliases, term) ? searchTermAliases[term] : undefined) ?? [term]).some(candidate => normalizedText.includes(candidate)));
     if (matchedTerms.length === 0)
         return { matchedTerms, score: 0 };
     const normalizedQuery = terms.join('-');
     const normalizedName = normalize(primaryName);
     const coverage = matchedTerms.length / terms.length;
     let score = matchedTerms.reduce((total, term) => total +
-        ((Reflect.get(searchTermAliases, term) ?? [term]).some(candidate => normalizedName.includes(candidate)) ?
+        (((Object.hasOwn(searchTermAliases, term) ? searchTermAliases[term] : undefined) ?? [term]).some(candidate => normalizedName.includes(candidate)) ?
             20 :
             5), 0);
     score += Math.round(coverage * 80);
     score -= (terms.length - matchedTerms.length) * 3;
-    if (terms.some(term => (Reflect.get(searchTermAliases, term) ?? [term]).includes(normalizedName)))
+    if (terms.some(term => ((Object.hasOwn(searchTermAliases, term) ? searchTermAliases[term] : undefined) ?? [term]).includes(normalizedName)))
         score += 150;
     if (normalizedText.includes(normalizedQuery))
         score += 100;
@@ -199,6 +232,12 @@ const collectComponentSearchResults = (query, terms, data, framework, platform)
     }
     return results;
 };
+const spacingValue = (tokens, token) => {
+    const value = tokens.spacing[token];
+    if (value === undefined)
+        throw new Error(`Missing spacing dimension for ${token}.`);
+    return value;
+};
 const collectReferenceSearchResults = (query, terms, data) => {
     const results = [];
     for (const recipe of data.recipes) {
@@ -216,6 +255,10 @@ const collectReferenceSearchResults = (query, terms, data) => {
             name: token
         }, query, terms, token);
     }
+    for (const [role, token] of Object.entries(data.tokens.spacingRoles)) {
+        const description = `Content flow spacing role ${role}: ${spacingValue(data.tokens, token)}px; CSS --ui-space-${role}.`;
+        appendSearchResult(results, { description, kind: 'token', name: role }, query, terms, `${description} layout gap padding rhythm`);
+    }
     for (const line of data.rules.split('\n').filter(rule => rule.trim())) {
         appendSearchResult(results, {
             description: line.trim(),
@@ -509,6 +552,22 @@ export const getNativeComponent = (args, data = loadLumenData()) => {
         text: formatNativeComponent(component, args.platform, detail, data)
     };
 };
+const recipeExamples = (recipe, framework) => {
+    const frameworks = [framework];
+    return frameworks.flatMap(target => {
+        const source = recipe.examples[target];
+        if (!source)
+            return [];
+        return [
+            '',
+            `## Complete composition (${target})`,
+            'Wire application actions and persistence before shipping; replace sample IDs when rendering multiple instances.',
+            `\`\`\`${{ astro: 'astro', elements: 'html', react: 'tsx' }[target]}`,
+            source,
+            '```'
+        ];
+    });
+};
 export const getRecipe = (args, data = loadLumenData()) => {
     const recipe = resolveRecipe(args.name, data);
     if (!recipe) {
@@ -536,7 +595,8 @@ export const getRecipe = (args, data = loadLumenData()) => {
             `Install for ${framework}: ${getRecipeInstall(recipe.install, framework)}`,
             '',
             '## Components',
-            ...componentLines
+            ...componentLines,
+            ...recipeExamples(recipe, framework)
         ].join('\n')
     };
 };
@@ -550,7 +610,7 @@ export const search = (args, data = loadLumenData()) => {
         };
     }
     const limit = Math.max(1, Math.min(args.limit ?? 20, 100));
-    const results = collectSearchResults(query, meaningfulSearchTerms(query), data, args.framework, args.platform);
+    const results = collectSearchResults(query, meaningfulSearchTerms(query), data, args.framework, args.platform).filter(result => !args.kind || result.kind === args.kind);
     const kindPriority = {
         component: 0,
         'native-component': 1,
@@ -775,6 +835,16 @@ export const getTokens = (data = loadLumenData()) => {
     const text = [
         '# Lumen design tokens',
         `Theme attribute: ${tokens.themeAttribute} (values: light, dark)`,
+        `Appearance presets: ${tokens.presets.names.join(', ')} via ${tokens.presets.attribute}; scheme via ${tokens.presets.schemeAttribute}.`,
+        'Studio follows the neutral PostLens appearance. Glass is explicit on supporting surfaces; native adapters use platform materials or opaque fallbacks.',
+        '',
+        '## Spacing scale (px at the default 16px root; CSS uses rem)',
+        Object.entries(tokens.spacing).map(([name, value]) => `- ${name}: ${value}px; --ui-space-${name}`).join('\n'),
+        '',
+        '## Content flow roles',
+        Object.entries(tokens.spacingRoles).map(([role, token]) => `- ${role}: ${token} (${spacingValue(tokens, token)}px); --ui-space-${role}`).join('\n'),
+        'Stack and Grid own sibling gaps; surfaces own padding; Field owns control feedback spacing.',
+        'Use related, group or section for Stack/Grid gap. Use inset for surface padding, not a gap prop.',
         '',
         '## Semantic token names (use as `text-ink`, `bg-surface`, `border-line`, etc.)',
         tokens.semantic.map(token => `- ${token}`).join('\n'),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@santi020k/lumen-mcp",
-  "version": "3.0.0",
+  "version": "4.0.0",
   "publishConfig": {
     "access": "public"
   },
@@ -33,16 +33,19 @@
     "lumen-mcp-http": "./bin/lumen-mcp-http.mjs"
   },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.30.1",
+    "@modelcontextprotocol/express": "^2.0.1",
+    "@modelcontextprotocol/server": "^2.2.0",
+    "express": "^5.2.1",
     "zod": "^4.6.5"
   },
   "devDependencies": {
     "@astrojs/compiler": "^4.0.0",
+    "@modelcontextprotocol/client": "^2.2.0",
     "@types/express": "^5.0.6",
-    "@types/node": "^26.6.2",
-    "@vitest/coverage-v8": "^5.0.1",
+    "@types/node": "^26.6.4",
+    "@vitest/coverage-v8": "^5.0.3",
     "typescript": "~6.0.3",
-    "vitest": "^5.0.1"
+    "vitest": "^5.0.3"
   },
   "engines": {
     "node": ">=20.20.0"