@decantr/mcp-server 2.2.0 → 2.3.0

package/README.md

@@ -12,7 +12,7 @@ Design intelligence for AI-generated UI. Make Claude, Cursor, and Windsurf gener
 
 ![Decantr MCP demo](https://raw.githubusercontent.com/decantr-ai/decantr/main/packages/mcp-server/assets/decantr-demo.gif)
 
-- **Structured design context** -- gives your AI assistant patterns, layouts, component specs, and Brownfield task-time context instead of letting it guess
+- **Structured design context** -- gives your AI assistant patterns, layouts, component specs, Brownfield local law, and task-time context instead of letting it guess
 - **Evidence-backed repair loops** -- gives AI agents Project Health, Evidence Bundles, workspace health, and scoped repair prompts without uploading source
 - **Drift detection** -- catches when generated code deviates from your design intent
 - **Zero config** -- run with `npx`, no API keys or accounts required
@@ -136,7 +136,7 @@ The server exposes Decantr registry, context, benchmark, and verification tools.
 | `decantr_suggest_patterns` | Given a page description plus optional route/source excerpt, get ranked pattern suggestions | `{ "description": "recipe feed with avatars and infinite scroll", "route": "/feed" }` |
 | `decantr_check_drift` | Check if generated code violates the design intent in the Essence spec | `{ "page_id": "overview", "components_used": ["Card", "LineChart"], "theme_used": "auradecantism" }` |
 | `decantr_get_execution_pack` | Read compiled scaffold, section, page, review, or mutation execution packs, with hosted fallback when local context is missing | `{ "pack_type": "page", "id": "overview", "format": "json" }` |
-| `decantr_prepare_task_context` | Resolve compact route/task context before editing a Brownfield or Essence route | `{ "route": "/feed", "task": "improve recipe card loading" }` |
+| `decantr_prepare_task_context` | Resolve compact route/task context, local law, evidence, and changed-file impact before editing a Brownfield or Essence route | `{ "route": "/feed", "task": "improve recipe card loading" }` |
 | `decantr_compile_execution_packs` | Compile a hosted execution-pack bundle from a local or inline essence document | `{ "path": "./decantr.essence.json", "namespace": "@official" }` |
 | `decantr_audit_project` | Run the schema-backed Decantr project audit against essence and compiled packs, with hosted fallback when local pack artifacts are missing | `{ "namespace": "@official" }` |
 | `decantr_critique` | Critique a file against the compiled review contract, with hosted fallback when local review packs are missing | `{ "file_path": "./src/pages/Overview.tsx", "namespace": "@official" }` |
@@ -171,7 +171,7 @@ The AI assistant calls these tools behind the scenes:
 3. `decantr_suggest_patterns` -- recommends `kpi-grid`, `chart-grid`, `data-table`, and `form-sections` for the described pages
 4. `decantr_resolve_pattern` -- fetches layout specs and component lists for each pattern
 5. `decantr_get_execution_pack` -- loads the compiled scaffold/page/review packs as the task contract, falling back to hosted compilation when local pack artifacts are missing
-6. `decantr_prepare_task_context` -- resolves route-local Brownfield context, visual evidence, and theme inventory before editing an existing app
+6. `decantr_prepare_task_context` -- resolves route-local Brownfield context, accepted local law, changed-file impact, visual evidence, and theme inventory before editing an existing app
 7. `decantr_compile_execution_packs` -- compiles the hosted pack bundle when the task needs a fresh remote contract from the essence document
 8. `decantr_check_drift` -- validates the generated code against the Essence spec before presenting it
 9. `decantr_critique` -- critiques a specific file, falling back to the hosted verifier when the local review pack is missing

package/dist/bin.js

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

package/dist/{chunk-SVLMT45O.js → chunk-GIVGJE76.js}

@@ -4,6 +4,7 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
 import { CallToolRequestSchema, ListToolsRequestSchema } from "@modelcontextprotocol/sdk/types.js";
 
 // src/tools.ts
+import { execFileSync } from "child_process";
 import { existsSync, readdirSync, readFileSync } from "fs";
 import { readFile as readFile2 } from "fs/promises";
 import { basename as basename2, dirname as dirname2, join as join2, relative as relative2 } from "path";
@@ -137,6 +138,61 @@ function readJsonIfExists(path) {
     return null;
   }
 }
+function changedFilesForTask(projectRoot) {
+  const changed = /* @__PURE__ */ new Set();
+  try {
+    for (const args of [
+      ["diff", "--name-only"],
+      ["diff", "--name-only", "--cached"]
+    ]) {
+      const output = execFileSync("git", args, {
+        cwd: projectRoot,
+        encoding: "utf-8",
+        stdio: ["ignore", "pipe", "ignore"]
+      });
+      for (const entry of output.split(/\r?\n/)) {
+        const file = entry.trim();
+        if (file) changed.add(file);
+      }
+    }
+  } catch {
+  }
+  return [...changed].sort();
+}
+function impactedRoutesForFiles(projectRoot, files) {
+  const analysis = readJsonIfExists(
+    join2(projectRoot, ".decantr", "analysis.json")
+  );
+  const routeEntries = analysis?.routes?.routes ?? [];
+  const impacted = /* @__PURE__ */ new Set();
+  for (const file of files) {
+    for (const route of routeEntries) {
+      if (route.file && (file === route.file || file.endsWith(route.file))) {
+        if (route.path) impacted.add(route.path);
+      }
+    }
+  }
+  return [...impacted].sort();
+}
+function localLawSummary(projectRoot) {
+  const patterns = readJsonIfExists(join2(projectRoot, ".decantr", "local-patterns.json"));
+  const rules = readJsonIfExists(join2(projectRoot, ".decantr", "rules.json"));
+  return {
+    patterns_path: patterns ? ".decantr/local-patterns.json" : null,
+    rules_path: rules ? ".decantr/rules.json" : null,
+    patterns: patterns?.patterns?.map((pattern) => ({
+      id: pattern.id ?? "unknown",
+      role: pattern.role ?? null,
+      component_paths: pattern.componentPaths ?? []
+    })) ?? [],
+    rules: rules?.rules?.map((rule) => ({
+      id: rule.id ?? "unknown",
+      enabled: rule.enabled ?? false,
+      severity: rule.severity ?? "warn",
+      description: rule.description ?? null
+    })) ?? []
+  };
+}
 function extractPatternIdsFromLayoutItem(item, ids) {
   if (typeof item === "string") {
     ids.add(item);
@@ -2371,6 +2427,9 @@ async function handleTool(name, args) {
       const themeInventory = readJsonIfExists(
         join2(process.cwd(), ".decantr", "theme-inventory.json")
       );
+      const localLaw = localLawSummary(process.cwd());
+      const changedFiles = changedFilesForTask(process.cwd());
+      const changedRoutes = impactedRoutesForFiles(process.cwd(), changedFiles);
       const patternIds = extractPagePatternIds(page);
       const ranked = rankPatternCandidates(
         {
@@ -2419,10 +2478,19 @@ async function handleTool(name, args) {
           variants: themeInventory.variants,
           path: ".decantr/theme-inventory.json"
         } : null,
+        local_law: localLaw,
+        change_impact: {
+          changed_files: changedFiles.slice(0, 40),
+          changed_file_count: changedFiles.length,
+          impacted_routes: changedRoutes
+        },
+        verify_command: "decantr verify --brownfield --local-patterns",
         local_files: {
           page_pack: pageManifest?.markdown ?? null,
           section_pack: sectionManifest?.markdown ?? null,
           section_context: existsSync(sectionContextPath) ? `.decantr/context/section-${section.id}.md` : null,
+          local_patterns: localLaw.patterns_path,
+          local_rules: localLaw.rules_path,
           visual_manifest: existsSync(
             join2(process.cwd(), ".decantr", "evidence", "visual-manifest.json")
           ) ? ".decantr/evidence/visual-manifest.json" : null

package/dist/index.js

@@ -1 +1 @@
-import "./chunk-SVLMT45O.js";
+import "./chunk-GIVGJE76.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decantr/mcp-server",
-  "version": "2.2.0",
+  "version": "2.3.0",
   "mcpName": "io.github.decantr-ai/mcp-server",
   "description": "MCP server for Decantr — exposes design intelligence, packs, and verification to AI coding assistants",
   "keywords": [
@@ -50,8 +50,8 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
     "@decantr/essence-spec": "2.0.1",
-    "@decantr/verifier": "2.2.0",
-    "@decantr/registry": "2.2.0"
+    "@decantr/registry": "2.2.0",
+    "@decantr/verifier": "2.2.0"
   },
   "scripts": {
     "build": "tsup",