@decantr/mcp-server 2.4.0 → 2.5.0

package/README.md

@@ -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, authority lane, local law, evidence, and changed-file impact before editing a Brownfield, Hybrid, or Essence route | `{ "route": "/feed", "task": "improve recipe card loading" }` |
+| `decantr_prepare_task_context` | Resolve compact route/task context, authority lane, local law, style bridge mappings, evidence, and changed-file impact before editing a Brownfield, Hybrid, 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" }` |
@@ -177,7 +177,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/Hybrid context, active authority, accepted local law, changed-file impact, visual evidence, and theme inventory before editing an existing app
+6. `decantr_prepare_task_context` -- resolves route-local Brownfield/Hybrid context, active authority, accepted local law, accepted style bridge mappings, 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-P2K3R43N.js";
+import "./chunk-J2UBHHEI.js";

package/dist/{chunk-P2K3R43N.js → chunk-J2UBHHEI.js}

@@ -191,12 +191,29 @@ function localLawSummary(projectRoot) {
     })) ?? []
   };
 }
+function styleBridgeSummary(projectRoot) {
+  const bridge = readJsonIfExists(join2(projectRoot, ".decantr", "style-bridge.json"));
+  return {
+    path: bridge ? ".decantr/style-bridge.json" : null,
+    status: bridge?.status ?? null,
+    styling_approach: bridge?.styling?.approach ?? null,
+    theme_modes: bridge?.styling?.themeModes ?? [],
+    mappings: bridge?.mappings?.map((mapping) => ({
+      id: mapping.id ?? "unknown",
+      label: mapping.label ?? null,
+      token_hints: mapping.tokenHints?.slice(0, 6) ?? [],
+      class_hints: mapping.classHints?.slice(0, 4) ?? [],
+      guardrails: mapping.guardrails?.slice(0, 3) ?? []
+    })) ?? []
+  };
+}
 function mentionsWord(text, term) {
   const escaped = term.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
   return new RegExp(`\\b${escaped}\\b`, "i").test(text);
 }
 function taskAuthoritySummary(input) {
   const hasLocalLaw = input.localLaw.patterns.length > 0 || input.localLaw.rules.length > 0;
+  const hasStyleBridge = Boolean(input.styleBridge.path) || input.adoptionMode === "style-bridge";
   let lane = "Brownfield contract-only";
   let sourceAuthority = "Existing app is authoritative; Decantr supplies contract context.";
   let styleAuthority = "Use the existing styling system.";
@@ -209,11 +226,11 @@ function taskAuthoritySummary(input) {
     sourceAuthority = "Existing app remains authoritative except where Decantr CSS is explicitly adopted.";
     styleAuthority = "Decantr CSS runtime is active where adopted.";
     activeAuthorities.push("Decantr CSS runtime");
-  } else if (input.workflowMode === "brownfield-attach" && input.adoptionMode === "style-bridge") {
+  } else if (input.workflowMode === "brownfield-attach" && hasStyleBridge) {
     lane = "Hybrid style bridge";
     sourceAuthority = "Existing app remains authoritative; Decantr intent maps through the style bridge.";
     styleAuthority = "Use bridge tokens/classes as a mapping layer onto the app styling system.";
-    activeAuthorities.push("style bridge");
+    activeAuthorities.push("accepted style bridge");
   } else if (input.workflowMode === "brownfield-attach" && hasLocalLaw) {
     lane = "Hybrid local law";
     sourceAuthority = "Existing app plus accepted project-owned UI law are authoritative.";
@@ -2483,6 +2500,7 @@ async function handleTool(name, args) {
         join2(process.cwd(), ".decantr", "theme-inventory.json")
       );
       const localLaw = localLawSummary(process.cwd());
+      const styleBridge = styleBridgeSummary(process.cwd());
       const projectJson = readJsonIfExists(join2(process.cwd(), ".decantr", "project.json"));
       const changedFiles = changedFilesForTask(process.cwd());
       const changedRoutes = impactedRoutesForFiles(process.cwd(), changedFiles);
@@ -2535,10 +2553,12 @@ async function handleTool(name, args) {
           path: ".decantr/theme-inventory.json"
         } : null,
         local_law: localLaw,
+        style_bridge: styleBridge,
         authority: taskAuthoritySummary({
           workflowMode: projectJson?.initialized?.workflowMode ?? null,
           adoptionMode: projectJson?.initialized?.adoptionMode ?? null,
           localLaw,
+          styleBridge,
           hasPackManifest: Boolean(manifest),
           task
         }),
@@ -2554,6 +2574,7 @@ async function handleTool(name, args) {
           section_context: existsSync(sectionContextPath) ? `.decantr/context/section-${section.id}.md` : null,
           local_patterns: localLaw.patterns_path,
           local_rules: localLaw.rules_path,
+          style_bridge: styleBridge.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-P2K3R43N.js";
+import "./chunk-J2UBHHEI.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decantr/mcp-server",
-  "version": "2.4.0",
+  "version": "2.5.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,7 +50,7 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
     "@decantr/essence-spec": "2.0.1",
-    "@decantr/verifier": "2.3.3",
+    "@decantr/verifier": "2.5.0",
     "@decantr/registry": "2.2.0"
   },
   "scripts": {