@decantr/mcp-server 1.0.0-beta.11 → 1.0.0-beta.12

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Decantr AI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/bin.js

@@ -1,2 +1,2 @@
 #!/usr/bin/env node
-import "./chunk-ARK7P76H.js";
+import "./chunk-YOFQYTEC.js";

package/dist/{chunk-ARK7P76H.js → chunk-YOFQYTEC.js}

@@ -1091,6 +1091,20 @@ var TOOLS = [
       required: ["component"]
     },
     annotations: READ_ONLY
+  },
+  // 15. decantr_critique — local read
+  {
+    name: "decantr_critique",
+    title: "Design Critique",
+    description: "Evaluate generated code against the essence spec for visual quality. Returns a scorecard covering treatment usage, decorator coverage, personality alignment, motion, accessibility, and responsiveness.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        file_path: { type: "string", description: "Path to the component file to critique" }
+      },
+      required: ["file_path"]
+    },
+    annotations: READ_ONLY
   }
 ];
 async function handleTool(name, args) {
@@ -1198,14 +1212,14 @@ async function handleTool(name, args) {
       try {
         const blueprint = await apiClient.getBlueprint(namespace, args.id);
         let topology = null;
-        const composeEntries = blueprint.compose || blueprint.data?.compose;
+        const composeEntries = blueprint.compose;
         if (composeEntries && Array.isArray(composeEntries) && composeEntries.length > 0) {
           const zoneInputs = [];
           const archetypePromises = composeEntries.map(async (entry) => {
             const arcId = typeof entry === "string" ? entry : entry.archetype;
             try {
               const arch = await apiClient.getContent("archetypes", namespace, arcId);
-              const archData = arch.data || arch;
+              const archData = arch;
               const explicitRole = typeof entry === "object" ? entry.role : void 0;
               zoneInputs.push({
                 archetypeId: arcId,
@@ -1252,50 +1266,72 @@ async function handleTool(name, args) {
           namespace: "@official",
           limit: 100
         });
-        const suggestions = [];
+        const prelimScores = [];
         for (const p of patternsResponse.items) {
-          const searchable = [
-            p.name || "",
-            p.description || "",
-            ...p.components || [],
-            ...p.tags || []
-          ].join(" ").toLowerCase();
+          const slug = p.slug || "";
+          const name2 = p.name || slug;
+          const description = p.description || "";
+          const searchable = [name2, description].join(" ").toLowerCase();
           let score = 0;
           const words = desc.split(/\s+/);
           for (const word of words) {
             if (word.length < 3) continue;
             if (searchable.includes(word)) score += 10;
           }
-          if (desc.includes("dashboard") && ["kpi-grid", "chart-grid", "data-table", "filter-bar"].includes(p.id)) score += 20;
-          if (desc.includes("metric") && p.id === "kpi-grid") score += 15;
-          if (desc.includes("chart") && p.id === "chart-grid") score += 15;
-          if (desc.includes("table") && p.id === "data-table") score += 15;
-          if (desc.includes("form") && p.id === "form-sections") score += 15;
-          if (desc.includes("setting") && p.id === "form-sections") score += 15;
-          if (desc.includes("landing") && ["hero", "cta-section", "card-grid"].includes(p.id)) score += 20;
-          if (desc.includes("hero") && p.id === "hero") score += 20;
-          if (desc.includes("ecommerce") && ["card-grid", "filter-bar", "detail-header"].includes(p.id)) score += 15;
-          if (desc.includes("product") && p.id === "card-grid") score += 15;
-          if (desc.includes("feed") && p.id === "activity-feed") score += 15;
-          if (desc.includes("filter") && p.id === "filter-bar") score += 15;
-          if (desc.includes("search") && p.id === "filter-bar") score += 10;
+          if (desc.includes("dashboard") && ["kpi-grid", "chart-grid", "data-table", "filter-bar"].includes(slug)) score += 20;
+          if (desc.includes("metric") && slug === "kpi-grid") score += 15;
+          if (desc.includes("chart") && slug === "chart-grid") score += 15;
+          if (desc.includes("table") && slug === "data-table") score += 15;
+          if (desc.includes("form") && slug === "form-sections") score += 15;
+          if (desc.includes("setting") && slug === "form-sections") score += 15;
+          if (desc.includes("landing") && ["hero", "cta-section", "card-grid"].includes(slug)) score += 20;
+          if (desc.includes("hero") && slug === "hero") score += 20;
+          if (desc.includes("ecommerce") && ["card-grid", "filter-bar", "detail-header"].includes(slug)) score += 15;
+          if (desc.includes("product") && slug === "card-grid") score += 15;
+          if (desc.includes("feed") && slug === "activity-feed") score += 15;
+          if (desc.includes("filter") && slug === "filter-bar") score += 15;
+          if (desc.includes("search") && slug === "filter-bar") score += 10;
           if (score > 0) {
-            const preset = p.presets ? Object.values(p.presets)[0] : null;
-            suggestions.push({
-              id: p.id,
-              score,
-              name: p.name || p.id,
-              description: p.description || "",
-              components: p.components || [],
-              layout: preset?.layout ? preset.layout.layout : "grid"
-            });
+            prelimScores.push({ slug, score, name: name2, description });
+          }
+        }
+        prelimScores.sort((a, b) => b.score - a.score);
+        const top10 = prelimScores.slice(0, 10);
+        const suggestions = [];
+        for (const candidate of top10) {
+          let fullPattern = null;
+          try {
+            const fetched = await apiClient.getPattern("@official", candidate.slug);
+            fullPattern = fetched;
+          } catch {
           }
+          let score = candidate.score;
+          if (fullPattern) {
+            const fullSearchable = [
+              ...fullPattern.components || [],
+              ...fullPattern.tags || []
+            ].join(" ").toLowerCase();
+            const words = desc.split(/\s+/);
+            for (const word of words) {
+              if (word.length < 3) continue;
+              if (fullSearchable.includes(word)) score += 10;
+            }
+          }
+          const preset = fullPattern?.presets ? Object.values(fullPattern.presets)[0] : null;
+          suggestions.push({
+            id: candidate.slug,
+            score,
+            name: fullPattern?.name || candidate.name,
+            description: fullPattern?.description || candidate.description,
+            components: fullPattern?.components || [],
+            layout: preset?.layout ? preset.layout.layout : "grid"
+          });
         }
         suggestions.sort((a, b) => b.score - a.score);
         return {
           query: args.description,
           suggestions: suggestions.slice(0, 5),
-          total: suggestions.length
+          total: prelimScores.length
         };
       } catch (e) {
         return { error: `Could not fetch patterns: ${e.message}` };
@@ -1746,6 +1782,11 @@ async function handleTool(name, args) {
       }
       return { content: lines.join("\n") };
     }
+    case "decantr_critique": {
+      const { critiqueFile } = await import("./critique-DKY4NB2O.js");
+      const result = await critiqueFile(args.file_path, process.cwd());
+      return result;
+    }
     default:
       return { error: `Unknown tool: ${name}` };
   }

package/dist/critique-DKY4NB2O.js

@@ -0,0 +1,74 @@
+// src/critique.ts
+import { readFile } from "fs/promises";
+import { join } from "path";
+async function critiqueFile(filePath, projectRoot) {
+  const code = await readFile(filePath, "utf-8");
+  const codeLower = code.toLowerCase();
+  let treatments = "";
+  try {
+    treatments = await readFile(join(projectRoot, "src", "styles", "treatments.css"), "utf-8");
+  } catch {
+  }
+  const scores = [];
+  const treatmentClasses = ["d-interactive", "d-surface", "d-data", "d-control", "d-section", "d-annotation", "d-label"];
+  const usedTreatments = treatmentClasses.filter((t) => code.includes(t));
+  scores.push({
+    category: "Treatment Usage",
+    score: Math.min(5, Math.max(1, Math.round(usedTreatments.length / treatmentClasses.length * 5))),
+    details: `${usedTreatments.length}/${treatmentClasses.length} base treatments used: ${usedTreatments.join(", ") || "none"}`,
+    suggestions: treatmentClasses.filter((t) => !code.includes(t)).map((t) => `Consider using \`${t}\` where appropriate`)
+  });
+  const decoratorMatches = treatments.match(/\.([\w-]+)\s*\{/g) || [];
+  const decoratorNames = decoratorMatches.map((m) => m.slice(1).replace(/\s*\{$/, "")).filter((n) => !n.startsWith("d-") && !["neon-glow", "neon-glow-hover", "neon-text-glow", "neon-border-glow", "mono-data", "status-ring", "entrance-fade"].includes(n));
+  const usedDecorators = decoratorNames.filter((d) => code.includes(d));
+  const decTarget = Math.min(decoratorNames.length, 5);
+  scores.push({
+    category: "Decorator Usage",
+    score: decTarget > 0 ? Math.min(5, Math.max(1, Math.round(usedDecorators.length / decTarget * 5))) : 3,
+    details: `${usedDecorators.length}/${decoratorNames.length} theme decorators used`,
+    suggestions: decoratorNames.filter((d) => !code.includes(d)).slice(0, 3).map((d) => `Theme decorator \`${d}\` available but unused`)
+  });
+  const personalityUtils = ["neon-glow", "neon-text-glow", "neon-border-glow", "mono-data", "status-ring", "entrance-fade"];
+  const availableUtils = personalityUtils.filter((u) => treatments.includes(u));
+  const usedUtils = availableUtils.filter((u) => code.includes(u));
+  const utilTarget = Math.min(availableUtils.length, 3);
+  scores.push({
+    category: "Personality Alignment",
+    score: utilTarget > 0 ? Math.min(5, Math.max(1, Math.round(usedUtils.length / utilTarget * 5))) : 3,
+    details: `${usedUtils.length}/${availableUtils.length} personality utilities used`,
+    suggestions: availableUtils.filter((u) => !code.includes(u)).map((u) => `Personality utility \`${u}\` defined but not used`)
+  });
+  const hasTransition = codeLower.includes("transition") || codeLower.includes("animate") || codeLower.includes("keyframe") || codeLower.includes("framer");
+  const hasHover = codeLower.includes(":hover") || codeLower.includes("onmouseenter") || codeLower.includes("hover:");
+  scores.push({
+    category: "Motion & Interaction",
+    score: Math.min(5, (hasTransition ? 3 : 1) + (hasHover ? 1 : 0)),
+    details: `Transitions: ${hasTransition ? "yes" : "no"}, Hover states: ${hasHover ? "yes" : "no"}`,
+    suggestions: hasTransition ? [] : ["Add transition effects for interactive elements"]
+  });
+  const hasAria = codeLower.includes("aria-") || codeLower.includes("role=");
+  const hasFocus = codeLower.includes("focus-visible") || codeLower.includes("focusvisible");
+  const hasKeyboard = codeLower.includes("onkeydown") || codeLower.includes("onkeyup");
+  scores.push({
+    category: "Accessibility",
+    score: Math.min(5, 1 + (hasAria ? 2 : 0) + (hasFocus ? 1 : 0) + (hasKeyboard ? 1 : 0)),
+    details: `ARIA: ${hasAria}, Focus: ${hasFocus}, Keyboard: ${hasKeyboard}`,
+    suggestions: [
+      ...!hasAria ? ["Add ARIA attributes to interactive regions"] : [],
+      ...!hasKeyboard ? ["Add keyboard event handlers"] : []
+    ]
+  });
+  const hasMedia = codeLower.includes("@media") || codeLower.includes("usemediaquery") || codeLower.includes("breakpoint");
+  const hasResponsive = codeLower.includes("sm:") || codeLower.includes("md:") || codeLower.includes("lg:") || codeLower.includes("_sm_") || codeLower.includes("_md_");
+  scores.push({
+    category: "Responsive Design",
+    score: Math.min(5, (hasMedia ? 3 : 1) + (hasResponsive ? 2 : 0)),
+    details: `Media queries: ${hasMedia}, Responsive classes: ${hasResponsive}`,
+    suggestions: !hasMedia && !hasResponsive ? ["Add responsive breakpoint handling"] : []
+  });
+  const overall = Math.round(scores.reduce((s, c) => s + c.score, 0) / scores.length * 10) / 10;
+  return { file: filePath, overall, scores };
+}
+export {
+  critiqueFile
+};

package/dist/index.js

@@ -1 +1 @@
-import "./chunk-ARK7P76H.js";
+import "./chunk-YOFQYTEC.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decantr/mcp-server",
-  "version": "1.0.0-beta.11",
+  "version": "1.0.0-beta.12",
   "description": "MCP server for Decantr — exposes design intelligence tools to AI coding assistants",
   "license": "MIT",
   "repository": {
@@ -15,18 +15,20 @@
   },
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
-  "files": ["dist"],
+  "files": [
+    "dist"
+  ],
   "publishConfig": {
     "access": "public"
   },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "@decantr/essence-spec": "1.0.0-beta.11",
+    "@decantr/registry": "1.0.0-beta.11"
+  },
   "scripts": {
     "build": "tsup",
     "test": "vitest run",
     "test:watch": "vitest"
-  },
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.0.0",
-    "@decantr/essence-spec": "workspace:*",
-    "@decantr/registry": "workspace:*"
   }
-}
+}