@decantr/mcp-server 1.0.0-beta.9 → 1.0.0

package/dist/chunk-WN4I3BY6.js

@@ -0,0 +1,2063 @@
+// src/index.ts
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import {
+  ListToolsRequestSchema,
+  CallToolRequestSchema
+} from "@modelcontextprotocol/sdk/types.js";
+
+// src/tools.ts
+import { existsSync, readdirSync, readFileSync } from "fs";
+import { readFile as readFile2 } from "fs/promises";
+import { basename, join as join2, dirname as dirname2, isAbsolute, resolve } from "path";
+import { validateEssence, evaluateGuard, isV3 as isV32 } from "@decantr/essence-spec";
+import { isContentIntelligenceSource, resolvePatternPreset } from "@decantr/registry";
+
+// src/helpers.ts
+import { readFile, writeFile, mkdir } from "fs/promises";
+import { join, dirname } from "path";
+import { RegistryAPIClient } from "@decantr/registry";
+import { isV3, migrateV2ToV3 } from "@decantr/essence-spec";
+var MAX_INPUT_LENGTH = 1e3;
+function validateStringArg(args, field) {
+  const val = args[field];
+  if (!val || typeof val !== "string") {
+    return `Required parameter "${field}" must be a non-empty string.`;
+  }
+  if (val.length > MAX_INPUT_LENGTH) {
+    return `Parameter "${field}" exceeds maximum length of ${MAX_INPUT_LENGTH} characters.`;
+  }
+  return null;
+}
+function fuzzyScore(query, text) {
+  const q = query.toLowerCase();
+  const t = text.toLowerCase();
+  if (t === q) return 100;
+  if (t.startsWith(q)) return 90;
+  if (t.includes(q)) return 80;
+  let qi = 0;
+  for (let ti = 0; ti < t.length && qi < q.length; ti++) {
+    if (t[ti] === q[qi]) qi++;
+  }
+  return qi === q.length ? 60 : 0;
+}
+var _apiClient = null;
+var _publicApiClient = null;
+function getAPIClient() {
+  if (!_apiClient) {
+    _apiClient = new RegistryAPIClient({
+      baseUrl: process.env.DECANTR_API_URL || void 0,
+      apiKey: process.env.DECANTR_API_KEY || void 0
+    });
+  }
+  return _apiClient;
+}
+function getPublicAPIClient() {
+  if (!_publicApiClient) {
+    _publicApiClient = new RegistryAPIClient({
+      baseUrl: process.env.DECANTR_API_URL || void 0
+    });
+  }
+  return _publicApiClient;
+}
+async function readEssenceFile(essencePath) {
+  const resolvedPath = essencePath || join(process.cwd(), "decantr.essence.json");
+  const raw = await readFile(resolvedPath, "utf-8");
+  const essence = JSON.parse(raw);
+  return { essence, raw, path: resolvedPath };
+}
+async function writeEssenceFile(essencePath, essence) {
+  const dir = dirname(essencePath);
+  await mkdir(dir, { recursive: true });
+  await writeFile(essencePath, JSON.stringify(essence, null, 2) + "\n", "utf-8");
+}
+async function mutateEssenceFile(essencePath, mutate) {
+  const { essence, path } = await readEssenceFile(essencePath);
+  const v3 = isV3(essence) ? structuredClone(essence) : migrateV2ToV3(essence);
+  const updated = mutate(v3);
+  await writeEssenceFile(path, updated);
+  return { essence: updated, path };
+}
+async function readDriftLog(projectRoot) {
+  const root = projectRoot || process.cwd();
+  const logPath = join(root, ".decantr", "drift-log.json");
+  try {
+    const raw = await readFile(logPath, "utf-8");
+    return JSON.parse(raw);
+  } catch {
+    return [];
+  }
+}
+async function writeDriftLog(entries, projectRoot) {
+  const root = projectRoot || process.cwd();
+  const logPath = join(root, ".decantr", "drift-log.json");
+  await mkdir(dirname(logPath), { recursive: true });
+  await writeFile(logPath, JSON.stringify(entries, null, 2) + "\n", "utf-8");
+  return logPath;
+}
+
+// src/tools.ts
+async function getShowcaseBenchmarkPayload(view) {
+  const client = getPublicAPIClient();
+  if (view === "manifest") {
+    return client.getShowcaseManifest();
+  }
+  if (view === "verification") {
+    return client.getShowcaseShortlistVerification();
+  }
+  return client.getShowcaseShortlist();
+}
+async function getRegistryIntelligenceSummaryPayload(namespace) {
+  const client = getPublicAPIClient();
+  return client.getRegistryIntelligenceSummary(namespace ? { namespace } : void 0);
+}
+async function getHostedExecutionPackBundlePayload(args) {
+  const client = getPublicAPIClient();
+  const essence = (() => {
+    if (typeof args.essence === "object" && args.essence !== null && !Array.isArray(args.essence)) {
+      return args.essence;
+    }
+    return readEssenceFile(args.path);
+  })();
+  return client.compileExecutionPacks(
+    essence,
+    typeof args.namespace === "string" ? { namespace: args.namespace } : void 0
+  );
+}
+async function getHostedSelectedExecutionPackPayload(args) {
+  const client = getPublicAPIClient();
+  const essence = (() => {
+    if (typeof args.essence === "object" && args.essence !== null && !Array.isArray(args.essence)) {
+      return args.essence;
+    }
+    return readEssenceFile(args.path);
+  })();
+  return client.selectExecutionPack(
+    {
+      essence,
+      pack_type: args.pack_type,
+      ...typeof args.id === "string" ? { id: args.id } : {}
+    },
+    typeof args.namespace === "string" ? { namespace: args.namespace } : void 0
+  );
+}
+async function getHostedExecutionPackManifestPayload(args) {
+  const client = getPublicAPIClient();
+  const essence = (() => {
+    if (typeof args.essence === "object" && args.essence !== null && !Array.isArray(args.essence)) {
+      return args.essence;
+    }
+    return readEssenceFile(args.path);
+  })();
+  return client.getExecutionPackManifest(
+    essence,
+    typeof args.namespace === "string" ? { namespace: args.namespace } : void 0
+  );
+}
+async function getHostedFileCritiquePayload(args) {
+  const client = getPublicAPIClient();
+  const filePath = args.file_path;
+  const resolvedFilePath = isAbsolute(filePath) ? filePath : resolve(process.cwd(), filePath);
+  const code = await readFile2(resolvedFilePath, "utf-8");
+  const { essence } = await readEssenceFile(args.path);
+  const treatmentsPath = typeof args.treatments_path === "string" ? isAbsolute(args.treatments_path) ? args.treatments_path : resolve(process.cwd(), args.treatments_path) : join2(process.cwd(), "src", "styles", "treatments.css");
+  const treatmentsCss = existsSync(treatmentsPath) ? readFileSync(treatmentsPath, "utf-8") : void 0;
+  return client.critiqueFile(
+    {
+      essence,
+      filePath,
+      code,
+      treatmentsCss
+    },
+    typeof args.namespace === "string" ? { namespace: args.namespace } : void 0
+  );
+}
+function extractHostedAssetPaths(indexHtml) {
+  const assetPaths = /* @__PURE__ */ new Set();
+  for (const match of indexHtml.matchAll(/<(?:script|link)[^>]+(?:src|href)="([^"]+)"/g)) {
+    const assetPath = match[1];
+    const assetsIndex = assetPath.indexOf("/assets/");
+    if (assetsIndex === -1) continue;
+    assetPaths.add(assetPath.slice(assetsIndex));
+  }
+  return [...assetPaths];
+}
+async function captureHostedDistSnapshot(projectRoot, distPathArg) {
+  const distRoot = distPathArg ? isAbsolute(distPathArg) ? distPathArg : resolve(projectRoot, distPathArg) : join2(projectRoot, "dist");
+  const indexPath = join2(distRoot, "index.html");
+  if (!existsSync(indexPath)) {
+    return void 0;
+  }
+  const indexHtml = readFileSync(indexPath, "utf-8");
+  const assets = {};
+  for (const assetPath of extractHostedAssetPaths(indexHtml)) {
+    const assetFilePath = join2(distRoot, assetPath.replace(/^[/\\]+/, ""));
+    if (existsSync(assetFilePath)) {
+      assets[assetPath] = readFileSync(assetFilePath, "utf-8");
+    }
+  }
+  return {
+    indexHtml,
+    assets
+  };
+}
+function isHostedSourceSnapshotFile(path) {
+  if (/\.d\.ts$/i.test(path)) return false;
+  return /\.(?:[cm]?[jt]sx?)$/i.test(path);
+}
+async function captureHostedSourceSnapshot(projectRoot, sourcesPathArg) {
+  if (!sourcesPathArg) {
+    return void 0;
+  }
+  const sourcesRoot = isAbsolute(sourcesPathArg) ? sourcesPathArg : resolve(projectRoot, sourcesPathArg);
+  if (!existsSync(sourcesRoot)) {
+    return void 0;
+  }
+  const files = {};
+  const ignoredDirNames = /* @__PURE__ */ new Set(["node_modules", ".git", ".decantr", "dist", "build", "coverage"]);
+  const rootPrefix = basename(sourcesRoot);
+  const walk = (absoluteDir, relativeDir) => {
+    for (const entry of readdirSync(absoluteDir, { withFileTypes: true })) {
+      if (ignoredDirNames.has(entry.name)) continue;
+      const absolutePath = join2(absoluteDir, entry.name);
+      const relativePath = join2(relativeDir, entry.name).replace(/\\/g, "/");
+      if (entry.isDirectory()) {
+        walk(absolutePath, relativePath);
+        continue;
+      }
+      if (!entry.isFile()) continue;
+      if (!isHostedSourceSnapshotFile(relativePath)) continue;
+      files[relativePath] = readFileSync(absolutePath, "utf-8");
+    }
+  };
+  walk(sourcesRoot, rootPrefix);
+  return Object.keys(files).length > 0 ? { files } : void 0;
+}
+async function getHostedProjectAuditPayload(args) {
+  const client = getPublicAPIClient();
+  const { essence } = await readEssenceFile(args.path);
+  const dist = await captureHostedDistSnapshot(process.cwd(), args.dist_path);
+  const sources = await captureHostedSourceSnapshot(process.cwd(), args.sources_path);
+  return client.auditProject(
+    {
+      essence,
+      dist,
+      sources
+    },
+    typeof args.namespace === "string" ? { namespace: args.namespace } : void 0
+  );
+}
+async function loadHostedExecutionPackBundleFallback(args) {
+  try {
+    return {
+      bundle: await getHostedExecutionPackBundlePayload(args),
+      error: null
+    };
+  } catch (error) {
+    return {
+      bundle: null,
+      error: error.message
+    };
+  }
+}
+async function loadHostedExecutionPackManifestFallback(args) {
+  try {
+    return {
+      manifest: await getHostedExecutionPackManifestPayload(args),
+      error: null
+    };
+  } catch (error) {
+    return {
+      manifest: null,
+      error: error.message
+    };
+  }
+}
+async function loadHostedSelectedExecutionPackFallback(args) {
+  try {
+    return {
+      selected: await getHostedSelectedExecutionPackPayload(args),
+      error: null
+    };
+  } catch (error) {
+    return {
+      selected: null,
+      error: error.message
+    };
+  }
+}
+async function loadHostedFileCritiqueFallback(args) {
+  try {
+    return {
+      report: await getHostedFileCritiquePayload(args),
+      error: null
+    };
+  } catch (error) {
+    return {
+      report: null,
+      error: error.message
+    };
+  }
+}
+async function loadHostedProjectAuditFallback(args) {
+  try {
+    return {
+      report: await getHostedProjectAuditPayload(args),
+      error: null
+    };
+  } catch (error) {
+    return {
+      report: null,
+      error: error.message
+    };
+  }
+}
+function hasExecutionPackPayload(payload) {
+  return payload.markdown !== null || payload.json !== null;
+}
+function toHostedExecutionPackPayload(pack) {
+  return {
+    markdown: pack && typeof pack.renderedMarkdown === "string" ? pack.renderedMarkdown : null,
+    json: pack ?? null
+  };
+}
+function findManifestEntryForPack(manifest, packType, id) {
+  switch (packType) {
+    case "scaffold":
+      return manifest.scaffold;
+    case "review":
+      return manifest.review ?? null;
+    case "section":
+      return id ? manifest.sections.find((section) => section.id === id) ?? null : null;
+    case "page":
+      return id ? manifest.pages.find((page) => page.id === id) ?? null : null;
+    case "mutation":
+      return id ? (manifest.mutations ?? []).find((mutation) => mutation.id === id) ?? null : null;
+    default:
+      return null;
+  }
+}
+var ZONE_ORDER = ["public", "gateway", "primary", "auxiliary"];
+function deriveZones(inputs) {
+  const zoneMap = /* @__PURE__ */ new Map();
+  for (const input of inputs) {
+    const existing = zoneMap.get(input.role);
+    if (existing) {
+      existing.archetypes.push(input.archetypeId);
+      existing.features.push(...input.features);
+      existing.descriptions.push(input.description);
+    } else {
+      zoneMap.set(input.role, {
+        role: input.role,
+        archetypes: [input.archetypeId],
+        shell: input.shell,
+        features: [...input.features],
+        descriptions: [input.description]
+      });
+    }
+  }
+  for (const zone of zoneMap.values()) {
+    zone.features = [...new Set(zone.features)];
+  }
+  return ZONE_ORDER.filter((role) => zoneMap.has(role)).map((role) => zoneMap.get(role));
+}
+var GATEWAY_TRIGGER_MAP = {
+  auth: "authentication",
+  login: "authentication",
+  mfa: "authentication",
+  payment: "payment",
+  subscription: "payment",
+  checkout: "payment",
+  onboarding: "onboarding",
+  "setup-wizard": "onboarding",
+  welcome: "onboarding",
+  invite: "invitation",
+  "access-code": "invitation"
+};
+function resolveGatewayTrigger(features) {
+  for (const feature of features) {
+    const trigger = GATEWAY_TRIGGER_MAP[feature];
+    if (trigger) return trigger;
+  }
+  return "authentication";
+}
+function deriveTransitions(zones) {
+  const transitions = [];
+  const roles = new Set(zones.map((z) => z.role));
+  const gateway = zones.find((z) => z.role === "gateway");
+  const gatewayTrigger = gateway ? resolveGatewayTrigger(gateway.features) : "authentication";
+  const hasApp = roles.has("primary") || roles.has("auxiliary");
+  const hasGateway = roles.has("gateway");
+  const hasPublic = roles.has("public");
+  if (hasPublic && hasGateway) {
+    transitions.push({ from: "public", to: "gateway", type: "conversion", trigger: gatewayTrigger });
+  }
+  if (hasPublic && hasApp && !hasGateway) {
+    transitions.push({ from: "public", to: "app", type: "conversion", trigger: "navigation" });
+  }
+  if (hasGateway && hasApp) {
+    transitions.push({ from: "gateway", to: "app", type: "gate-pass", trigger: gatewayTrigger });
+    transitions.push({ from: "app", to: "gateway", type: "gate-return", trigger: gatewayTrigger });
+  }
+  if (hasApp && hasPublic) {
+    transitions.push({ from: "app", to: "public", type: "navigation", trigger: "external" });
+  }
+  return transitions;
+}
+var READ_ONLY = {
+  readOnlyHint: true,
+  destructiveHint: false,
+  idempotentHint: true,
+  openWorldHint: false
+};
+var READ_ONLY_NETWORK = {
+  readOnlyHint: true,
+  destructiveHint: false,
+  idempotentHint: true,
+  openWorldHint: true
+};
+var WRITE_TOOL = {
+  readOnlyHint: false,
+  destructiveHint: false,
+  idempotentHint: false,
+  openWorldHint: false
+};
+var TOOLS = [
+  // 1. decantr_read_essence — local read
+  {
+    name: "decantr_read_essence",
+    title: "Read Essence",
+    description: "Read and return the current decantr.essence.json file from the working directory. For v3 files, optionally filter by layer (dna, blueprint, or full).",
+    inputSchema: {
+      type: "object",
+      properties: {
+        path: { type: "string", description: "Optional path to essence file. Defaults to ./decantr.essence.json." },
+        layer: { type: "string", enum: ["dna", "blueprint", "full"], description: "For v3 essences: return only the specified layer. Defaults to full." }
+      }
+    },
+    annotations: READ_ONLY
+  },
+  // 2. decantr_validate — local read
+  {
+    name: "decantr_validate",
+    title: "Validate Essence",
+    description: "Validate a decantr.essence.json file against the schema and guard rules. For v3, reports DNA vs Blueprint violations separately.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        path: { type: "string", description: "Path to essence file. Defaults to ./decantr.essence.json." }
+      }
+    },
+    annotations: READ_ONLY
+  },
+  // 3. decantr_search_registry — network
+  {
+    name: "decantr_search_registry",
+    title: "Search Registry",
+    description: "Search the Decantr community content registry for patterns, archetypes, themes, and shells.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        query: { type: "string", description: 'Search query (e.g. "kanban", "neon", "dashboard")' },
+        type: { type: "string", description: "Filter by type: pattern, archetype, theme, shell" },
+        sort: { type: "string", description: "Optional sort: recommended, recent, or name." },
+        recommended: { type: "boolean", description: "When true, only return recommended items." },
+        source: { type: "string", description: "Optional intelligence source filter: authored, benchmark, or hybrid." }
+      },
+      required: ["query"]
+    },
+    annotations: READ_ONLY_NETWORK
+  },
+  // 4. decantr_resolve_pattern — network
+  {
+    name: "decantr_resolve_pattern",
+    title: "Resolve Pattern",
+    description: "Get full pattern details including layout spec, components, presets, and code examples.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        id: { type: "string", description: 'Pattern ID (e.g. "hero", "data-table", "kpi-grid")' },
+        preset: { type: "string", description: 'Optional preset name (e.g. "product", "content")' },
+        namespace: { type: "string", description: 'Namespace (default: "@official")' }
+      },
+      required: ["id"]
+    },
+    annotations: READ_ONLY_NETWORK
+  },
+  // 5. decantr_resolve_archetype — network
+  {
+    name: "decantr_resolve_archetype",
+    title: "Resolve Archetype",
+    description: "Get archetype details including default pages, layouts, features, and suggested theme.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        id: { type: "string", description: 'Archetype ID (e.g. "saas-dashboard", "ecommerce")' },
+        namespace: { type: "string", description: 'Namespace (default: "@official")' }
+      },
+      required: ["id"]
+    },
+    annotations: READ_ONLY_NETWORK
+  },
+  // 6. decantr_resolve_blueprint — network
+  {
+    name: "decantr_resolve_blueprint",
+    title: "Resolve Blueprint",
+    description: "Get a blueprint (app composition) with its archetype list, suggested theme, personality traits, and full page structure.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        id: { type: "string", description: 'Blueprint ID (e.g. "saas-dashboard", "ecommerce", "portfolio")' },
+        namespace: { type: "string", description: 'Namespace (default: "@official")' }
+      },
+      required: ["id"]
+    },
+    annotations: READ_ONLY_NETWORK
+  },
+  // 8. decantr_suggest_patterns — network
+  {
+    name: "decantr_suggest_patterns",
+    title: "Suggest Patterns",
+    description: "Given a page description, suggest appropriate patterns from the registry. Returns ranked pattern matches with layout specs and component lists.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        description: { type: "string", description: 'Description of the page or section (e.g. "dashboard with metrics and charts", "settings form with toggles")' }
+      },
+      required: ["description"]
+    },
+    annotations: READ_ONLY_NETWORK
+  },
+  // 9. decantr_check_drift — local read
+  {
+    name: "decantr_check_drift",
+    title: "Check Drift",
+    description: "Check if code changes violate the design intent captured in the Essence spec. For v3, returns separate dna_violations and blueprint_drift with autoFixable flags.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        path: { type: "string", description: "Path to essence file. Defaults to ./decantr.essence.json." },
+        page_id: { type: "string", description: 'Page ID being modified (e.g. "overview", "settings")' },
+        components_used: {
+          type: "array",
+          items: { type: "string" },
+          description: "List of component names used in the generated code. Checked against page layout patterns."
+        },
+        theme_used: { type: "string", description: "Theme id used in the generated code" }
+      }
+    },
+    annotations: READ_ONLY
+  },
+  // 10. decantr_create_essence — network (fetches archetype)
+  {
+    name: "decantr_create_essence",
+    title: "Create Essence",
+    description: "Generate a valid v3 Essence spec skeleton from a project description. Returns a structured essence.json template based on the closest matching archetype and blueprint.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        description: { type: "string", description: 'Natural language project description (e.g. "SaaS dashboard with analytics, user management, and billing")' },
+        framework: { type: "string", description: 'Target framework (e.g. "react", "vue", "svelte"). Defaults to "react".' }
+      },
+      required: ["description"]
+    },
+    annotations: READ_ONLY_NETWORK
+  },
+  // 11. decantr_accept_drift — WRITE tool (NEW)
+  {
+    name: "decantr_accept_drift",
+    title: "Accept Drift",
+    description: "Resolve guard violations by accepting, scoping, rejecting, or deferring drift. For DNA violations, requires explicit confirmation. Updates the essence file or drift log.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        violations: {
+          type: "array",
+          items: {
+            type: "object",
+            properties: {
+              rule: { type: "string" },
+              page_id: { type: "string" },
+              details: { type: "string" }
+            },
+            required: ["rule"]
+          },
+          description: "The violations to resolve."
+        },
+        resolution: {
+          type: "string",
+          enum: ["accept", "accept_scoped", "reject", "defer"],
+          description: "How to resolve: accept updates the essence, accept_scoped limits to a page, reject is a no-op, defer logs for later."
+        },
+        scope: { type: "string", description: "For accept_scoped: the page or section scope." },
+        path: { type: "string", description: "Path to essence file. Defaults to ./decantr.essence.json." },
+        confirm_dna: { type: "boolean", description: "Required to be true when accepting DNA-layer violations." }
+      },
+      required: ["violations", "resolution"]
+    },
+    annotations: WRITE_TOOL
+  },
+  // 12. decantr_update_essence — WRITE tool (NEW)
+  {
+    name: "decantr_update_essence",
+    title: "Update Essence",
+    description: "Mutate the essence file: add/remove/update pages, update DNA or blueprint fields, add/remove features. Operates on v3 format (auto-migrates v2).",
+    inputSchema: {
+      type: "object",
+      properties: {
+        operation: {
+          type: "string",
+          enum: ["add_page", "remove_page", "update_page_layout", "update_dna", "update_blueprint", "add_feature", "remove_feature"],
+          description: "The mutation operation to perform."
+        },
+        payload: {
+          type: "object",
+          description: "Operation-specific payload. See tool docs for each operation."
+        },
+        path: { type: "string", description: "Path to essence file. Defaults to ./decantr.essence.json." }
+      },
+      required: ["operation", "payload"]
+    },
+    annotations: WRITE_TOOL
+  },
+  // 13. decantr_get_scaffold_context — local read
+  {
+    name: "decantr_get_scaffold_context",
+    title: "Get Scaffold Context",
+    description: "Get the top-level scaffold context for the current project. Returns the scaffold task brief, scaffold overview, compiled scaffold execution pack, compiled review pack, and pack manifest when available. Falls back to hosted execution-pack compilation when local context artifacts are missing.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        path: {
+          type: "string",
+          description: "Optional path to an essence file when using hosted fallback compilation. Defaults to ./decantr.essence.json."
+        },
+        namespace: {
+          type: "string",
+          description: 'Optional preferred public namespace for hosted fallback compilation. Defaults to "@official".'
+        }
+      }
+    },
+    annotations: READ_ONLY
+  },
+  // 14. decantr_get_section_context — local read
+  {
+    name: "decantr_get_section_context",
+    title: "Get Section Context",
+    description: "Get the self-contained context for a specific section of the project. Returns the richer section context file and, when available, the compiled section execution pack for a more compact contract-first view. Falls back to hosted execution-pack compilation when local pack artifacts are missing.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        section_id: { type: "string", description: 'Section ID (archetype ID, e.g., "ai-chatbot", "auth-full", "settings-full")' },
+        path: {
+          type: "string",
+          description: "Optional path to an essence file when using hosted fallback compilation. Defaults to ./decantr.essence.json."
+        },
+        namespace: {
+          type: "string",
+          description: 'Optional preferred public namespace for hosted fallback compilation. Defaults to "@official".'
+        }
+      },
+      required: ["section_id"]
+    },
+    annotations: READ_ONLY
+  },
+  // 15. decantr_get_page_context — local read
+  {
+    name: "decantr_get_page_context",
+    title: "Get Page Context",
+    description: "Get the route-local context for a specific page. Returns the compiled page execution pack plus its parent section pack and section context when available. Falls back to hosted execution-pack compilation when local pack artifacts are missing.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        page_id: { type: "string", description: 'Page ID (for example "overview", "settings", or "home").' },
+        path: {
+          type: "string",
+          description: "Optional path to an essence file when using hosted fallback compilation. Defaults to ./decantr.essence.json."
+        },
+        namespace: {
+          type: "string",
+          description: 'Optional preferred public namespace for hosted fallback compilation. Defaults to "@official".'
+        }
+      },
+      required: ["page_id"]
+    },
+    annotations: READ_ONLY
+  },
+  // 16. decantr_get_execution_pack — local read
+  {
+    name: "decantr_get_execution_pack",
+    title: "Get Execution Pack",
+    description: "Read compiled execution packs from .decantr/context. Returns the pack manifest by default, or a specific scaffold, review, mutation, section, or page pack in markdown, JSON, or both. Falls back to the hosted selected-pack surface for targeted reads when local pack artifacts are missing.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        pack_type: {
+          type: "string",
+          enum: ["manifest", "scaffold", "review", "mutation", "section", "page"],
+          description: "Pack type to fetch. Defaults to manifest."
+        },
+        id: {
+          type: "string",
+          description: 'Required for section/page/mutation packs (for example "dashboard", "overview", or "modify").'
+        },
+        format: {
+          type: "string",
+          enum: ["json", "markdown", "both"],
+          description: "Return format for a specific pack. Defaults to both."
+        },
+        path: {
+          type: "string",
+          description: "Optional path to an essence file when using hosted fallback compilation. Defaults to ./decantr.essence.json."
+        },
+        namespace: {
+          type: "string",
+          description: 'Optional preferred public namespace for hosted fallback compilation. Defaults to "@official".'
+        }
+      }
+    },
+    annotations: READ_ONLY
+  },
+  // 17. decantr_get_showcase_benchmarks — network read
+  {
+    name: "decantr_get_showcase_benchmarks",
+    title: "Get Showcase Benchmarks",
+    description: "Read the audited Decantr showcase corpus metadata. Returns the active manifest, shortlisted benchmark set, or the schema-backed shortlist verification report.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        view: {
+          type: "string",
+          enum: ["manifest", "shortlist", "verification"],
+          description: "Which showcase benchmark view to return. Defaults to shortlist."
+        }
+      }
+    },
+    annotations: READ_ONLY_NETWORK
+  },
+  // 18. decantr_get_registry_intelligence_summary — network read
+  {
+    name: "decantr_get_registry_intelligence_summary",
+    title: "Get Registry Intelligence Summary",
+    description: "Read the hosted schema-backed registry intelligence summary. Useful for checking overall intelligence/recommendation coverage without crawling every item.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        namespace: {
+          type: "string",
+          description: 'Optional namespace to scope the summary to, for example "@official".'
+        }
+      }
+    },
+    annotations: READ_ONLY_NETWORK
+  },
+  // 19. decantr_compile_execution_packs — network read
+  {
+    name: "decantr_compile_execution_packs",
+    title: "Compile Execution Packs",
+    description: "Compile a hosted execution-pack bundle from an essence document using the public Decantr API. Reads the local essence file by default, or accepts an inline essence object.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        path: {
+          type: "string",
+          description: "Optional path to an essence file. Defaults to ./decantr.essence.json when essence is not provided."
+        },
+        essence: {
+          type: "object",
+          description: "Optional inline essence document to compile instead of reading from disk."
+        },
+        namespace: {
+          type: "string",
+          description: 'Optional preferred public namespace for content resolution. Defaults to "@official".'
+        }
+      }
+    },
+    annotations: READ_ONLY_NETWORK
+  },
+  // 20. decantr_audit_project — local read with hosted fallback
+  {
+    name: "decantr_audit_project",
+    title: "Audit Project",
+    description: "Audit the current project against the essence contract, guard rules, and compiled execution packs. Falls back to the hosted verifier when local compiled pack artifacts are missing. Returns a schema-backed project audit report.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        path: { type: "string", description: "Optional path to the essence file for hosted fallback. Defaults to ./decantr.essence.json." },
+        namespace: { type: "string", description: 'Optional preferred public namespace for hosted fallback. Defaults to "@official".' },
+        dist_path: { type: "string", description: "Optional path to a local dist directory to snapshot for hosted runtime verification. Defaults to ./dist." },
+        sources_path: { type: "string", description: "Optional path to a local source directory to snapshot for hosted source-level verification. For example `src` or `app`." }
+      }
+    },
+    annotations: READ_ONLY_NETWORK
+  },
+  // 21. decantr_critique — local read with hosted fallback
+  {
+    name: "decantr_critique",
+    title: "Design Critique",
+    description: "Critique a file against the compiled review contract and Decantr verification heuristics. Falls back to the hosted verifier when local review packs are missing. Returns a schema-backed file critique report with scores, findings, and focus areas.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        file_path: { type: "string", description: "Path to the component file to critique" },
+        path: { type: "string", description: "Optional path to the essence file when using hosted fallback. Defaults to ./decantr.essence.json." },
+        namespace: { type: "string", description: 'Optional preferred public namespace for hosted fallback. Defaults to "@official".' },
+        treatments_path: { type: "string", description: "Optional path to treatments.css when using hosted fallback. Defaults to ./src/styles/treatments.css." }
+      },
+      required: ["file_path"]
+    },
+    annotations: READ_ONLY_NETWORK
+  }
+];
+async function handleTool(name, args) {
+  const apiClient = getAPIClient();
+  switch (name) {
+    case "decantr_read_essence": {
+      const essencePath = args.path || join2(process.cwd(), "decantr.essence.json");
+      try {
+        const raw = await readFile2(essencePath, "utf-8");
+        const essence = JSON.parse(raw);
+        const layer = args.layer;
+        if (layer && isV32(essence)) {
+          if (layer === "dna") return essence.dna;
+          if (layer === "blueprint") return essence.blueprint;
+        }
+        return essence;
+      } catch (e) {
+        return { error: `Could not read essence file: ${e.message}` };
+      }
+    }
+    case "decantr_validate": {
+      const essencePath = args.path || join2(process.cwd(), "decantr.essence.json");
+      let essence;
+      try {
+        essence = JSON.parse(await readFile2(essencePath, "utf-8"));
+      } catch (e) {
+        return { valid: false, errors: [`Could not read: ${e.message}`], guardViolations: [] };
+      }
+      const result = validateEssence(essence);
+      let guardViolations = [];
+      if (result.valid && typeof essence === "object" && essence !== null) {
+        try {
+          guardViolations = evaluateGuard(essence, {});
+        } catch {
+        }
+      }
+      if (result.valid && typeof essence === "object" && essence !== null && isV32(essence)) {
+        const dnaViolations = guardViolations.filter((v) => v.layer === "dna");
+        const blueprintViolations = guardViolations.filter((v) => v.layer === "blueprint");
+        const otherViolations = guardViolations.filter((v) => !v.layer);
+        return {
+          ...result,
+          format: "v3",
+          dna_violations: dnaViolations,
+          blueprint_violations: blueprintViolations,
+          guardViolations: otherViolations
+        };
+      }
+      return { ...result, guardViolations };
+    }
+    case "decantr_search_registry": {
+      const err = validateStringArg(args, "query");
+      if (err) return { error: err };
+      if (args.source && (typeof args.source !== "string" || !isContentIntelligenceSource(args.source))) {
+        return { error: "Invalid source. Must be one of: authored, benchmark, hybrid." };
+      }
+      try {
+        const response = await apiClient.search({
+          q: args.query,
+          type: args.type,
+          sort: args.sort,
+          recommended: args.recommended === true,
+          intelligenceSource: args.source
+        });
+        return {
+          total: response.total,
+          results: response.results.map((r) => ({
+            type: r.type,
+            id: r.slug,
+            namespace: r.namespace,
+            name: r.name,
+            description: r.description,
+            install: `decantr get ${r.type} ${r.slug}`,
+            intelligence: r.intelligence ?? null
+          }))
+        };
+      } catch (e) {
+        return { error: `Search failed: ${e.message}` };
+      }
+    }
+    case "decantr_resolve_pattern": {
+      const err = validateStringArg(args, "id");
+      if (err) return { error: err };
+      const namespace = args.namespace || "@official";
+      try {
+        const pattern = await apiClient.getPattern(namespace, args.id);
+        const result = { found: true, ...pattern };
+        if (args.preset && typeof args.preset === "string") {
+          const preset = resolvePatternPreset(pattern, args.preset);
+          if (preset) result.resolvedPreset = preset;
+        }
+        return result;
+      } catch {
+        return { found: false, message: `Pattern "${args.id}" not found in ${namespace}.` };
+      }
+    }
+    case "decantr_resolve_archetype": {
+      const err = validateStringArg(args, "id");
+      if (err) return { error: err };
+      const namespace = args.namespace || "@official";
+      try {
+        const archetype = await apiClient.getArchetype(namespace, args.id);
+        return { found: true, ...archetype };
+      } catch {
+        return { found: false, message: `Archetype "${args.id}" not found in ${namespace}.` };
+      }
+    }
+    case "decantr_resolve_blueprint": {
+      const err = validateStringArg(args, "id");
+      if (err) return { error: err };
+      const namespace = args.namespace || "@official";
+      try {
+        const blueprint = await apiClient.getBlueprint(namespace, args.id);
+        let topology = null;
+        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 archData = await apiClient.getArchetype(namespace, arcId);
+              const explicitRole = typeof entry === "string" ? void 0 : entry.role;
+              zoneInputs.push({
+                archetypeId: arcId,
+                role: explicitRole || archData.role || "auxiliary",
+                shell: archData.pages?.[0]?.shell || "sidebar-main",
+                features: archData.features || [],
+                description: archData.description || ""
+              });
+            } catch {
+            }
+          });
+          await Promise.all(archetypePromises);
+          if (zoneInputs.length > 0) {
+            const zones = deriveZones(zoneInputs);
+            const transitions = deriveTransitions(zones);
+            const primaryArchetype = zoneInputs.find((z) => z.role === "primary");
+            topology = {
+              zones: zones.map((z) => ({
+                role: z.role,
+                archetypes: z.archetypes,
+                shell: z.shell,
+                features: z.features,
+                purpose: z.descriptions.join(" ")
+              })),
+              transitions,
+              entryPoints: {
+                anonymous: "/",
+                authenticated: primaryArchetype ? `/${primaryArchetype.archetypeId}` : "/home"
+              }
+            };
+          }
+        }
+        return { found: true, ...blueprint, ...topology ? { topology } : {} };
+      } catch {
+        return { found: false, message: `Blueprint "${args.id}" not found in ${namespace}.` };
+      }
+    }
+    case "decantr_suggest_patterns": {
+      const err = validateStringArg(args, "description");
+      if (err) return { error: err };
+      const desc = args.description.toLowerCase();
+      try {
+        const patternsResponse = await apiClient.listContent("patterns", {
+          namespace: "@official",
+          limit: 100
+        });
+        const prelimScores = [];
+        for (const p of patternsResponse.items) {
+          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(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) {
+            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: prelimScores.length
+        };
+      } catch (e) {
+        return { error: `Could not fetch patterns: ${e.message}` };
+      }
+    }
+    case "decantr_check_drift": {
+      const essencePath = args.path || join2(process.cwd(), "decantr.essence.json");
+      let essence;
+      try {
+        essence = JSON.parse(await readFile2(essencePath, "utf-8"));
+      } catch (e) {
+        return { error: `Could not read essence: ${e.message}` };
+      }
+      const validation = validateEssence(essence);
+      if (!validation.valid) {
+        return { drifted: true, reason: "invalid_essence", errors: validation.errors };
+      }
+      const violations = [];
+      if (args.theme_used && typeof args.theme_used === "string") {
+        let expectedThemeId;
+        if (isV32(essence)) {
+          expectedThemeId = essence.dna.theme.id;
+        } else {
+          const expectedTheme = essence.theme;
+          expectedThemeId = expectedTheme?.id ?? expectedTheme?.style;
+        }
+        if (expectedThemeId && args.theme_used !== expectedThemeId) {
+          violations.push({
+            rule: "theme-match",
+            severity: "critical",
+            message: `Theme drift: code uses "${args.theme_used}" but Essence specifies "${expectedThemeId}". Do not switch themes.`,
+            ...isV32(essence) ? { layer: "dna", autoFixable: false } : {}
+          });
+        }
+      }
+      if (args.page_id && typeof args.page_id === "string") {
+        let pages;
+        if (isV32(essence)) {
+          pages = essence.blueprint.pages;
+        } else {
+          pages = essence.structure || [];
+        }
+        if (!pages.find((p) => p.id === args.page_id)) {
+          violations.push({
+            rule: "page-exists",
+            severity: "critical",
+            message: `Page "${args.page_id}" not found in Essence structure. Add it to the Essence before generating code for it.`,
+            ...isV32(essence) ? {
+              layer: "blueprint",
+              autoFixable: true,
+              autoFix: { type: "add_page", patch: { id: args.page_id } }
+            } : {}
+          });
+        }
+      }
+      if (args.components_used && Array.isArray(args.components_used) && args.page_id && typeof args.page_id === "string") {
+        let pages;
+        if (isV32(essence)) {
+          pages = essence.blueprint.pages;
+        } else {
+          pages = essence.structure || [];
+        }
+        const page = pages.find((p) => p.id === args.page_id);
+        if (page && page.layout) {
+          const expectedPatterns = /* @__PURE__ */ new Set();
+          for (const item of page.layout) {
+            if (typeof item === "string") {
+              expectedPatterns.add(item);
+            } else if (typeof item === "object" && item !== null && "pattern" in item) {
+              expectedPatterns.add(item.pattern);
+            }
+          }
+          const componentsUsed = args.components_used;
+          const unmatchedComponents = [];
+          for (const comp of componentsUsed) {
+            const compLower = comp.toLowerCase().replace(/[_\s]/g, "-");
+            let matched = false;
+            for (const pattern of expectedPatterns) {
+              const patternLower = pattern.toLowerCase();
+              if (compLower.includes(patternLower) || patternLower.includes(compLower) || fuzzyScore(compLower, patternLower) >= 60) {
+                matched = true;
+                break;
+              }
+            }
+            if (!matched) {
+              unmatchedComponents.push(comp);
+            }
+          }
+          if (unmatchedComponents.length > 0) {
+            violations.push({
+              rule: "component-pattern-match",
+              severity: "warning",
+              message: `Components [${unmatchedComponents.join(", ")}] do not match any pattern in page "${args.page_id}" layout. Expected patterns: [${[...expectedPatterns].join(", ")}].`,
+              ...isV32(essence) ? { layer: "blueprint", autoFixable: false } : {}
+            });
+          }
+        }
+      }
+      try {
+        const guardViolations = evaluateGuard(essence, {
+          pageId: args.page_id
+        });
+        for (const gv of guardViolations) {
+          violations.push({
+            rule: gv.rule || "guard",
+            severity: gv.severity || "warning",
+            message: gv.message || "Guard violation",
+            ...gv.layer ? { layer: gv.layer } : {},
+            ...gv.autoFixable !== void 0 ? { autoFixable: gv.autoFixable } : {},
+            ...gv.autoFix ? { autoFix: gv.autoFix } : {}
+          });
+        }
+      } catch {
+      }
+      if (isV32(essence)) {
+        const dnaViolations = violations.filter((v) => v.layer === "dna");
+        const blueprintDrift = violations.filter((v) => v.layer === "blueprint");
+        const other = violations.filter((v) => !v.layer);
+        return {
+          drifted: violations.length > 0,
+          dna_violations: dnaViolations,
+          blueprint_drift: blueprintDrift,
+          other_violations: other,
+          checkedAgainst: essencePath
+        };
+      }
+      return {
+        drifted: violations.length > 0,
+        violations,
+        checkedAgainst: essencePath
+      };
+    }
+    case "decantr_create_essence": {
+      const err = validateStringArg(args, "description");
+      if (err) return { error: err };
+      const desc = args.description.toLowerCase();
+      const framework = args.framework || "react";
+      const archetypeScores = [];
+      const archetypeIds = [
+        "saas-dashboard",
+        "ecommerce",
+        "portfolio",
+        "content-site",
+        "financial-dashboard",
+        "cloud-platform",
+        "gaming-platform",
+        "ecommerce-admin"
+      ];
+      for (const id of archetypeIds) {
+        let score = 0;
+        if (desc.includes("dashboard") && id.includes("dashboard")) score += 20;
+        if (desc.includes("saas") && id.includes("saas")) score += 20;
+        if (desc.includes("ecommerce") && id.includes("ecommerce")) score += 20;
+        if (desc.includes("shop") && id.includes("ecommerce")) score += 15;
+        if (desc.includes("portfolio") && id.includes("portfolio")) score += 20;
+        if (desc.includes("blog") && id.includes("content")) score += 15;
+        if (desc.includes("content") && id.includes("content")) score += 15;
+        if (desc.includes("finance") && id.includes("financial")) score += 20;
+        if (desc.includes("cloud") && id.includes("cloud")) score += 15;
+        if (desc.includes("game") && id.includes("gaming")) score += 15;
+        if (desc.includes("admin") && id.includes("admin")) score += 15;
+        if (desc.includes("analytics") && id.includes("dashboard")) score += 10;
+        if (score > 0) archetypeScores.push({ id, score });
+      }
+      archetypeScores.sort((a, b) => b.score - a.score);
+      const bestMatch = archetypeScores[0]?.id || "saas-dashboard";
+      let pages;
+      let features = [];
+      try {
+        const archetype = await apiClient.getArchetype("@official", bestMatch);
+        pages = archetype.pages;
+        features = archetype.features || [];
+      } catch {
+      }
+      const rawPages = pages || [{ id: "home", shell: "full-bleed", default_layout: ["hero"] }];
+      const defaultShell = rawPages[0]?.shell || "sidebar-main";
+      const essence = {
+        version: "3.0.0",
+        dna: {
+          theme: {
+            id: "auradecantism",
+            mode: "dark",
+            shape: "rounded"
+          },
+          spacing: {
+            base_unit: 4,
+            scale: "linear",
+            density: "comfortable",
+            content_gap: "4"
+          },
+          typography: {
+            scale: "modular",
+            heading_weight: 600,
+            body_weight: 400
+          },
+          color: {
+            palette: "semantic",
+            accent_count: 1,
+            cvd_preference: "auto"
+          },
+          radius: {
+            philosophy: "rounded",
+            base: 8
+          },
+          elevation: {
+            system: "layered",
+            max_levels: 3
+          },
+          motion: {
+            preference: "subtle",
+            duration_scale: 1,
+            reduce_motion: true
+          },
+          accessibility: {
+            wcag_level: "AA",
+            focus_visible: true,
+            skip_nav: true
+          },
+          personality: ["professional"]
+        },
+        blueprint: {
+          shell: defaultShell,
+          pages: rawPages.map((p) => ({
+            id: p.id,
+            ...p.shell !== defaultShell ? { shell_override: p.shell } : {},
+            layout: p.default_layout || []
+          })),
+          features
+        },
+        meta: {
+          archetype: bestMatch,
+          target: framework,
+          platform: { type: "spa", routing: "hash" },
+          guard: { mode: "strict", dna_enforcement: "error", blueprint_enforcement: "warn" }
+        }
+      };
+      return {
+        essence,
+        archetype: bestMatch,
+        format: "v3",
+        instructions: `Save this as decantr.essence.json in your project root. Review the dna (design tokens), blueprint (pages/features), and meta (project config) sections and adjust to match your needs. The guard rules will validate your code against this spec.`,
+        _generated: {
+          matched_archetype: bestMatch,
+          confidence: archetypeScores[0]?.score || 0,
+          alternatives: archetypeScores.slice(1, 4).map((a) => a.id),
+          description: args.description
+        }
+      };
+    }
+    case "decantr_accept_drift": {
+      const violations = args.violations;
+      const resolution = args.resolution;
+      if (!violations || !Array.isArray(violations) || violations.length === 0) {
+        return { error: 'Required parameter "violations" must be a non-empty array.' };
+      }
+      if (!resolution || !["accept", "accept_scoped", "reject", "defer"].includes(resolution)) {
+        return { error: 'Required parameter "resolution" must be one of: accept, accept_scoped, reject, defer.' };
+      }
+      const hasDnaViolation = violations.some((v) => {
+        const rule = v.rule;
+        return ["theme", "style", "density", "theme-mode", "accessibility", "theme-match"].includes(rule);
+      });
+      if (hasDnaViolation && resolution !== "reject" && resolution !== "defer" && !args.confirm_dna) {
+        return {
+          error: "DNA-layer violations detected. Set confirm_dna: true to accept changes to design axioms (theme, density, accessibility, etc.).",
+          requires_confirmation: true,
+          dna_rules_affected: violations.filter(
+            (v) => ["theme", "style", "density", "theme-mode", "accessibility", "theme-match"].includes(v.rule)
+          ).map((v) => v.rule)
+        };
+      }
+      if (resolution === "reject") {
+        return {
+          status: "rejected",
+          message: "Violations rejected. No changes made. Revert the code to match the essence spec.",
+          violations_count: violations.length
+        };
+      }
+      if (resolution === "defer") {
+        const projectRoot = args.path ? dirname2(args.path) : void 0;
+        const existingLog = await readDriftLog(projectRoot);
+        const newEntries = violations.map((v) => ({
+          rule: v.rule,
+          page_id: v.page_id,
+          details: v.details,
+          resolution: "deferred",
+          scope: args.scope || void 0,
+          timestamp: (/* @__PURE__ */ new Date()).toISOString()
+        }));
+        const updatedLog = [...existingLog, ...newEntries];
+        const logPath = await writeDriftLog(updatedLog, projectRoot);
+        return {
+          status: "deferred",
+          message: `${violations.length} violation(s) deferred to drift log.`,
+          log_path: logPath,
+          total_deferred: updatedLog.length
+        };
+      }
+      try {
+        const { essence, path } = await mutateEssenceFile(args.path, (v3) => {
+          for (const v of violations) {
+            applyDriftAcceptance(v3, v, resolution, args.scope);
+          }
+          return v3;
+        });
+        return {
+          status: resolution === "accept_scoped" ? "accepted_scoped" : "accepted",
+          message: `${violations.length} violation(s) resolved. Essence updated.`,
+          path,
+          scope: resolution === "accept_scoped" ? args.scope || "unscoped" : void 0
+        };
+      } catch (e) {
+        return { error: `Failed to update essence: ${e.message}` };
+      }
+    }
+    case "decantr_update_essence": {
+      const operation = args.operation;
+      const payload = args.payload;
+      if (!operation) {
+        return { error: 'Required parameter "operation" is missing.' };
+      }
+      if (!payload || typeof payload !== "object") {
+        return { error: 'Required parameter "payload" must be an object.' };
+      }
+      const validOps = ["add_page", "remove_page", "update_page_layout", "update_dna", "update_blueprint", "add_feature", "remove_feature"];
+      if (!validOps.includes(operation)) {
+        return { error: `Invalid operation "${operation}". Must be one of: ${validOps.join(", ")}` };
+      }
+      try {
+        const { essence, path } = await mutateEssenceFile(args.path, (v3) => {
+          return applyEssenceUpdate(v3, operation, payload);
+        });
+        return {
+          status: "updated",
+          operation,
+          path,
+          summary: describeUpdate(operation, payload)
+        };
+      } catch (e) {
+        return { error: `Failed to update essence: ${e.message}` };
+      }
+    }
+    case "decantr_get_scaffold_context": {
+      const contextDir = join2(process.cwd(), ".decantr", "context");
+      const manifestPath = join2(contextDir, "pack-manifest.json");
+      const scaffoldContextPath = join2(contextDir, "scaffold.md");
+      const taskContextPath = join2(contextDir, "task-scaffold.md");
+      const packMarkdownPath = join2(contextDir, "scaffold-pack.md");
+      const packJsonPath = join2(contextDir, "scaffold-pack.json");
+      const hasAnyContext = existsSync(scaffoldContextPath) || existsSync(taskContextPath) || existsSync(packMarkdownPath) || existsSync(packJsonPath) || existsSync(manifestPath);
+      if (!hasAnyContext) {
+        const [hostedScaffold, hostedReview] = await Promise.all([
+          loadHostedSelectedExecutionPackFallback({
+            ...args,
+            pack_type: "scaffold"
+          }),
+          loadHostedSelectedExecutionPackFallback({
+            ...args,
+            pack_type: "review"
+          })
+        ]);
+        const scaffoldSelected = hostedScaffold.selected;
+        const reviewSelected = hostedReview.selected;
+        if (scaffoldSelected && reviewSelected) {
+          const scaffoldPayload2 = toHostedExecutionPackPayload(scaffoldSelected.pack);
+          const reviewPayload2 = toHostedExecutionPackPayload(reviewSelected.pack);
+          return {
+            source: "hosted_fallback",
+            task_context: null,
+            scaffold_context: scaffoldPayload2.markdown,
+            execution_pack: scaffoldPayload2,
+            review_pack: reviewPayload2,
+            pack_manifest: scaffoldSelected.manifest,
+            available_sections: scaffoldSelected.manifest.sections.map((section) => ({ id: section.id, page_ids: section.pageIds })),
+            available_pages: scaffoldSelected.manifest.pages.map((page) => ({ id: page.id, section_id: page.sectionId })),
+            available_mutations: (scaffoldSelected.manifest.mutations ?? []).map((mutation) => ({ id: mutation.id, mutation_type: mutation.mutationType })),
+            note: "Using hosted selected execution packs because local scaffold context artifacts were not found; scaffold pack markdown is being reused as readable scaffold context."
+          };
+        }
+        const hosted = await loadHostedExecutionPackBundleFallback(args);
+        if (!hosted.bundle) {
+          return {
+            error: "Scaffold context not found. Run `decantr refresh` or `decantr registry compile-packs --write-context` to materialize scaffold context and execution packs.",
+            hosted_fallback_error: hosted.error ?? hostedScaffold.error ?? hostedReview.error
+          };
+        }
+        const scaffoldPayload = toHostedExecutionPackPayload(hosted.bundle.scaffold);
+        const reviewPayload = toHostedExecutionPackPayload(hosted.bundle.review);
+        return {
+          source: "hosted_fallback",
+          task_context: null,
+          scaffold_context: scaffoldPayload.markdown,
+          execution_pack: scaffoldPayload,
+          review_pack: reviewPayload,
+          pack_manifest: hosted.bundle.manifest,
+          available_sections: hosted.bundle.manifest.sections.map((section) => ({ id: section.id, page_ids: section.pageIds })),
+          available_pages: hosted.bundle.manifest.pages.map((page) => ({ id: page.id, section_id: page.sectionId })),
+          available_mutations: (hosted.bundle.manifest.mutations ?? []).map((mutation) => ({ id: mutation.id, mutation_type: mutation.mutationType })),
+          note: "Using hosted compiled execution packs because local scaffold context artifacts were not found; scaffold pack markdown is being reused as readable scaffold context."
+        };
+      }
+      let manifest = null;
+      if (existsSync(manifestPath)) {
+        try {
+          manifest = JSON.parse(readFileSync(manifestPath, "utf-8"));
+        } catch (e) {
+          return { error: `Failed to read pack manifest: ${e.message}` };
+        }
+      }
+      return {
+        source: "local",
+        task_context: existsSync(taskContextPath) ? readFileSync(taskContextPath, "utf-8") : null,
+        scaffold_context: existsSync(scaffoldContextPath) ? readFileSync(scaffoldContextPath, "utf-8") : existsSync(packMarkdownPath) ? readFileSync(packMarkdownPath, "utf-8") : null,
+        execution_pack: {
+          markdown: existsSync(packMarkdownPath) ? readFileSync(packMarkdownPath, "utf-8") : null,
+          json: existsSync(packJsonPath) ? JSON.parse(readFileSync(packJsonPath, "utf-8")) : null
+        },
+        review_pack: {
+          markdown: existsSync(join2(contextDir, "review-pack.md")) ? readFileSync(join2(contextDir, "review-pack.md"), "utf-8") : null,
+          json: existsSync(join2(contextDir, "review-pack.json")) ? JSON.parse(readFileSync(join2(contextDir, "review-pack.json"), "utf-8")) : null
+        },
+        pack_manifest: manifest,
+        available_sections: manifest?.sections.map((section) => ({ id: section.id, page_ids: section.pageIds })) ?? [],
+        available_pages: manifest?.pages.map((page) => ({ id: page.id, section_id: page.sectionId })) ?? [],
+        available_mutations: manifest?.mutations?.map((mutation) => ({ id: mutation.id, mutation_type: mutation.mutationType })) ?? []
+      };
+    }
+    case "decantr_get_section_context": {
+      const err = validateStringArg(args, "section_id");
+      if (err) return { error: err };
+      const sectionId = args.section_id;
+      let essence;
+      try {
+        const result = await readEssenceFile();
+        essence = result.essence;
+      } catch {
+        return { error: "No valid essence file found. Run decantr init first." };
+      }
+      if (!isV32(essence)) {
+        return { error: "Section context requires a v3 essence file. Run decantr migrate first." };
+      }
+      const sections = essence.blueprint.sections || [];
+      const section = sections.find((s) => s.id === sectionId);
+      if (!section) {
+        return {
+          error: `Section "${sectionId}" not found.`,
+          available_sections: sections.map((s) => ({ id: s.id, role: s.role, pages: s.pages.length }))
+        };
+      }
+      const packBasePath = join2(process.cwd(), ".decantr", "context", `section-${sectionId}-pack`);
+      const packMarkdownPath = `${packBasePath}.md`;
+      const packJsonPath = `${packBasePath}.json`;
+      const localExecutionPack = {
+        markdown: existsSync(packMarkdownPath) ? readFileSync(packMarkdownPath, "utf-8") : null,
+        json: existsSync(packJsonPath) ? JSON.parse(readFileSync(packJsonPath, "utf-8")) : null
+      };
+      let executionPack = localExecutionPack;
+      let executionPackSource = hasExecutionPackPayload(localExecutionPack) ? "local" : null;
+      let hostedFallbackError = null;
+      if (!executionPackSource) {
+        const hosted = await loadHostedSelectedExecutionPackFallback({
+          ...args,
+          pack_type: "section",
+          id: sectionId
+        });
+        hostedFallbackError = hosted.error;
+        if (hosted.selected) {
+          executionPack = toHostedExecutionPackPayload(hosted.selected.pack);
+          executionPackSource = "hosted_fallback";
+        }
+      }
+      const contextPath = join2(process.cwd(), ".decantr", "context", `section-${sectionId}.md`);
+      if (existsSync(contextPath)) {
+        return {
+          section_id: sectionId,
+          role: section.role,
+          shell: section.shell,
+          features: section.features,
+          pages: section.pages.map((p) => ({ id: p.id, route: p.route, layout: p.layout })),
+          context: readFileSync(contextPath, "utf-8"),
+          execution_pack_source: executionPackSource,
+          execution_pack: executionPack
+        };
+      }
+      const derivedContext = executionPack.markdown;
+      return {
+        section_id: sectionId,
+        role: section.role,
+        shell: section.shell,
+        features: section.features,
+        description: section.description,
+        pages: section.pages.map((p) => ({ id: p.id, route: p.route, layout: p.layout })),
+        context: derivedContext,
+        execution_pack_source: executionPackSource,
+        execution_pack: executionPack,
+        note: executionPackSource === "hosted_fallback" ? "Section context file not found. Using hosted compiled execution pack fallback as the readable section context." : `Section context file not found. Run \`decantr refresh\` or \`decantr registry get-pack section ${sectionId} --write-context\` to generate it.`,
+        hosted_fallback_error: executionPackSource ? void 0 : hostedFallbackError
+      };
+    }
+    case "decantr_get_page_context": {
+      const err = validateStringArg(args, "page_id");
+      if (err) return { error: err };
+      const pageId = args.page_id;
+      const contextDir = join2(process.cwd(), ".decantr", "context");
+      const manifestPath = join2(contextDir, "pack-manifest.json");
+      let manifest = null;
+      let manifestSource = null;
+      let hostedPageSelection = null;
+      let hostedSectionSelection = null;
+      let hostedFallbackError = null;
+      const loadHostedPageSelection = async () => {
+        if (hostedPageSelection) {
+          return hostedPageSelection;
+        }
+        const hosted = await loadHostedSelectedExecutionPackFallback({
+          ...args,
+          pack_type: "page",
+          id: pageId
+        });
+        hostedFallbackError = hosted.error;
+        hostedPageSelection = hosted.selected;
+        return hostedPageSelection;
+      };
+      const loadHostedSectionSelection = async (sectionId) => {
+        if (hostedSectionSelection && hostedSectionSelection.selector.id === sectionId) {
+          return hostedSectionSelection;
+        }
+        const hosted = await loadHostedSelectedExecutionPackFallback({
+          ...args,
+          pack_type: "section",
+          id: sectionId
+        });
+        hostedFallbackError = hosted.error;
+        hostedSectionSelection = hosted.selected;
+        return hostedSectionSelection;
+      };
+      if (existsSync(manifestPath)) {
+        try {
+          manifest = JSON.parse(readFileSync(manifestPath, "utf-8"));
+          manifestSource = "local";
+        } catch (e) {
+          return { error: `Failed to read pack manifest: ${e.message}` };
+        }
+      }
+      if (!manifest) {
+        const hosted = await loadHostedPageSelection();
+        if (!hosted) {
+          return {
+            error: "Execution pack manifest not found. Run `decantr refresh` or `decantr registry get-pack manifest --write-context` to generate compiled packs.",
+            hosted_fallback_error: hostedFallbackError
+          };
+        }
+        manifest = hosted.manifest;
+        manifestSource = "hosted_fallback";
+      }
+      let pageEntry = manifest.pages.find((page) => page.id === pageId) ?? null;
+      if (!pageEntry) {
+        if (manifestSource === "local") {
+          const hosted = await loadHostedPageSelection();
+          if (hosted) {
+            manifest = hosted.manifest;
+            manifestSource = "hosted_fallback";
+            pageEntry = manifest.pages.find((page) => page.id === pageId) ?? null;
+          }
+        }
+        if (!pageEntry) {
+          return {
+            error: `Page "${pageId}" not found in execution pack manifest.`,
+            available_pages: manifest.pages.map((page) => ({ id: page.id, section_id: page.sectionId })),
+            hosted_fallback_error: manifestSource === "hosted_fallback" ? void 0 : hostedFallbackError
+          };
+        }
+      }
+      let resolvedPageEntry = pageEntry;
+      let sectionEntry = resolvedPageEntry.sectionId ? manifest.sections.find((section) => section.id === resolvedPageEntry.sectionId) ?? null : null;
+      const pageMarkdownPath = join2(contextDir, resolvedPageEntry.markdown);
+      const pageJsonPath = join2(contextDir, resolvedPageEntry.json);
+      const sectionMarkdownPath = sectionEntry ? join2(contextDir, sectionEntry.markdown) : null;
+      const sectionJsonPath = sectionEntry ? join2(contextDir, sectionEntry.json) : null;
+      const sectionContextPath = resolvedPageEntry.sectionId ? join2(contextDir, `section-${resolvedPageEntry.sectionId}.md`) : null;
+      const localPagePack = {
+        markdown: existsSync(pageMarkdownPath) ? readFileSync(pageMarkdownPath, "utf-8") : null,
+        json: existsSync(pageJsonPath) ? JSON.parse(readFileSync(pageJsonPath, "utf-8")) : null
+      };
+      let executionPack = localPagePack;
+      let executionPackSource = hasExecutionPackPayload(localPagePack) ? "local" : null;
+      if (!executionPackSource) {
+        const hosted = await loadHostedPageSelection();
+        if (hosted) {
+          manifest = hosted.manifest;
+          manifestSource = "hosted_fallback";
+          resolvedPageEntry = manifest.pages.find((page) => page.id === pageId) ?? resolvedPageEntry;
+          sectionEntry = resolvedPageEntry.sectionId ? manifest.sections.find((section) => section.id === resolvedPageEntry.sectionId) ?? sectionEntry : null;
+          executionPack = toHostedExecutionPackPayload(hosted.pack);
+          executionPackSource = "hosted_fallback";
+        }
+      }
+      const localSectionPack = sectionEntry ? {
+        markdown: sectionMarkdownPath && existsSync(sectionMarkdownPath) ? readFileSync(sectionMarkdownPath, "utf-8") : null,
+        json: sectionJsonPath && existsSync(sectionJsonPath) ? JSON.parse(readFileSync(sectionJsonPath, "utf-8")) : null
+      } : null;
+      let sectionExecutionPack = localSectionPack;
+      let sectionExecutionPackSource = localSectionPack && hasExecutionPackPayload(localSectionPack) ? "local" : null;
+      if (sectionEntry && !sectionExecutionPackSource) {
+        const hosted = await loadHostedSectionSelection(sectionEntry.id);
+        if (hosted) {
+          sectionExecutionPack = toHostedExecutionPackPayload(hosted.pack);
+          sectionExecutionPackSource = "hosted_fallback";
+        }
+      }
+      return {
+        page_id: pageId,
+        page_context: executionPack.markdown,
+        section_id: resolvedPageEntry.sectionId,
+        section_role: resolvedPageEntry.sectionRole,
+        manifest_source: manifestSource,
+        execution_pack_source: executionPackSource,
+        section_execution_pack_source: sectionExecutionPackSource,
+        execution_pack: executionPack,
+        section_execution_pack: sectionExecutionPack,
+        section_context: sectionContextPath && existsSync(sectionContextPath) ? readFileSync(sectionContextPath, "utf-8") : sectionExecutionPack?.markdown ?? null,
+        manifest: {
+          page: resolvedPageEntry,
+          section: sectionEntry
+        },
+        note: manifestSource === "hosted_fallback" ? "Using hosted compiled execution-pack data because local page pack artifacts were missing or incomplete." : void 0,
+        hosted_fallback_error: hostedFallbackError ?? void 0
+      };
+    }
+    case "decantr_get_execution_pack": {
+      const contextDir = join2(process.cwd(), ".decantr", "context");
+      const manifestPath = join2(contextDir, "pack-manifest.json");
+      let manifest = null;
+      let manifestSource = null;
+      let hostedBundle = null;
+      let hostedSelectedPack = null;
+      let hostedFallbackError = null;
+      const packType = args.pack_type ?? "manifest";
+      if (existsSync(manifestPath)) {
+        try {
+          manifest = JSON.parse(readFileSync(manifestPath, "utf-8"));
+          manifestSource = "local";
+        } catch (e) {
+          return { error: `Failed to read pack manifest: ${e.message}` };
+        }
+      }
+      if (!manifest && packType === "manifest") {
+        const hostedManifest = await loadHostedExecutionPackManifestFallback(args);
+        hostedFallbackError = hostedManifest.error;
+        if (hostedManifest.manifest) {
+          manifest = hostedManifest.manifest;
+          manifestSource = "hosted_fallback";
+        } else {
+          const hosted = await loadHostedExecutionPackBundleFallback(args);
+          hostedBundle = hosted.bundle;
+          hostedFallbackError = hosted.error;
+          if (!hosted.bundle) {
+            return {
+              error: "Execution pack manifest not found. Run `decantr refresh` or `decantr registry get-pack manifest --write-context` to generate compiled packs.",
+              hosted_fallback_error: hosted.error
+            };
+          }
+          manifest = hosted.bundle.manifest;
+          manifestSource = "hosted_fallback";
+        }
+      }
+      if (packType === "manifest") {
+        return {
+          ...manifest,
+          source: manifestSource
+        };
+      }
+      if (!manifest) {
+        const hosted = await loadHostedSelectedExecutionPackFallback(args);
+        hostedSelectedPack = hosted.selected;
+        hostedFallbackError = hosted.error;
+        if (!hosted.selected) {
+          return {
+            error: "Execution pack manifest not found. Run `decantr refresh` or `decantr registry get-pack manifest --write-context` to generate compiled packs.",
+            hosted_fallback_error: hosted.error
+          };
+        }
+        manifest = hosted.selected.manifest;
+        manifestSource = "hosted_fallback";
+      }
+      const format = args.format ?? "both";
+      let entry = null;
+      let availableIds = [];
+      if (packType === "scaffold") {
+        entry = manifest.scaffold;
+      } else if (packType === "review") {
+        entry = manifest.review ?? null;
+      } else if (packType === "mutation") {
+        availableIds = (manifest.mutations ?? []).map((mutation) => mutation.id);
+        const idErr = validateStringArg(args, "id");
+        if (idErr) return { error: idErr, available_ids: availableIds };
+        entry = (manifest.mutations ?? []).find((mutation) => mutation.id === args.id) ?? null;
+      } else if (packType === "section") {
+        availableIds = manifest.sections.map((section) => section.id);
+        const idErr = validateStringArg(args, "id");
+        if (idErr) return { error: idErr, available_ids: availableIds };
+        entry = manifest.sections.find((section) => section.id === args.id) ?? null;
+      } else if (packType === "page") {
+        availableIds = manifest.pages.map((page) => page.id);
+        const idErr = validateStringArg(args, "id");
+        if (idErr) return { error: idErr, available_ids: availableIds };
+        entry = manifest.pages.find((page) => page.id === args.id) ?? null;
+      } else {
+        return { error: `Unsupported pack type: ${packType}` };
+      }
+      if (!entry) {
+        if (manifestSource === "local") {
+          const hosted = await loadHostedSelectedExecutionPackFallback(args);
+          hostedSelectedPack = hosted.selected;
+          hostedFallbackError = hosted.error;
+          if (hosted.selected) {
+            manifest = hosted.selected.manifest;
+            manifestSource = "hosted_fallback";
+            entry = findManifestEntryForPack(
+              manifest,
+              packType,
+              args.id
+            );
+          }
+        }
+        if (!entry) {
+          return {
+            error: `Execution pack not found for type "${packType}"${args.id ? ` and id "${args.id}"` : ""}.`,
+            available_ids: availableIds,
+            hosted_fallback_error: hostedFallbackError ?? void 0
+          };
+        }
+      }
+      const result = {
+        pack_type: packType,
+        id: entry.id,
+        manifest: entry,
+        source: manifestSource
+      };
+      const localPayload = {
+        markdown: null,
+        json: null
+      };
+      if (manifestSource === "local") {
+        if (format === "markdown" || format === "both") {
+          const markdownPath = join2(contextDir, entry.markdown);
+          if (existsSync(markdownPath)) {
+            localPayload.markdown = readFileSync(markdownPath, "utf-8");
+          }
+        }
+        if (format === "json" || format === "both") {
+          const jsonPath = join2(contextDir, entry.json);
+          if (existsSync(jsonPath)) {
+            localPayload.json = JSON.parse(readFileSync(jsonPath, "utf-8"));
+          }
+        }
+      }
+      if (hasExecutionPackPayload(localPayload)) {
+        if (format === "markdown" || format === "both") {
+          result.markdown = localPayload.markdown;
+        }
+        if (format === "json" || format === "both") {
+          result.json = localPayload.json;
+        }
+        return result;
+      }
+      if (!hostedSelectedPack) {
+        const hosted = await loadHostedSelectedExecutionPackFallback(args);
+        hostedSelectedPack = hosted.selected;
+        hostedFallbackError = hosted.error;
+      }
+      if (!hostedSelectedPack) {
+        return {
+          ...result,
+          hosted_fallback_error: hostedFallbackError ?? void 0
+        };
+      }
+      manifest = hostedSelectedPack.manifest;
+      manifestSource = "hosted_fallback";
+      const hostedPayload = toHostedExecutionPackPayload(hostedSelectedPack.pack);
+      if (format === "markdown" || format === "both") {
+        result.markdown = hostedPayload.markdown;
+      }
+      if (format === "json" || format === "both") {
+        result.json = hostedPayload.json;
+      }
+      return result;
+    }
+    case "decantr_get_showcase_benchmarks": {
+      const view = args.view ?? "shortlist";
+      if (!["manifest", "shortlist", "verification"].includes(view)) {
+        return { error: `Unsupported showcase benchmark view: ${view}` };
+      }
+      return getShowcaseBenchmarkPayload(view);
+    }
+    case "decantr_get_registry_intelligence_summary": {
+      if (args.namespace != null && typeof args.namespace !== "string") {
+        return { error: "Invalid namespace. Must be a string when provided." };
+      }
+      return getRegistryIntelligenceSummaryPayload(args.namespace);
+    }
+    case "decantr_compile_execution_packs": {
+      if (args.path != null && typeof args.path !== "string") {
+        return { error: "Invalid path. Must be a string when provided." };
+      }
+      if (args.namespace != null && typeof args.namespace !== "string") {
+        return { error: "Invalid namespace. Must be a string when provided." };
+      }
+      if (args.essence != null && (typeof args.essence !== "object" || Array.isArray(args.essence))) {
+        return { error: "Invalid essence. Must be an object when provided." };
+      }
+      return getHostedExecutionPackBundlePayload(args);
+    }
+    case "decantr_critique": {
+      const err = validateStringArg(args, "file_path");
+      if (err) return { error: err };
+      if (args.path != null && typeof args.path !== "string") {
+        return { error: "Invalid path. Must be a string when provided." };
+      }
+      if (args.namespace != null && typeof args.namespace !== "string") {
+        return { error: "Invalid namespace. Must be a string when provided." };
+      }
+      if (args.treatments_path != null && typeof args.treatments_path !== "string") {
+        return { error: "Invalid treatments_path. Must be a string when provided." };
+      }
+      const { critiqueFile } = await import("./critique-VEROHUF4.js");
+      const localReviewPackPath = join2(process.cwd(), ".decantr", "context", "review-pack.json");
+      if (existsSync(localReviewPackPath)) {
+        return critiqueFile(args.file_path, process.cwd());
+      }
+      const hosted = await loadHostedFileCritiqueFallback(args);
+      if (hosted.report) {
+        return hosted.report;
+      }
+      return critiqueFile(args.file_path, process.cwd());
+    }
+    case "decantr_audit_project": {
+      if (args.path != null && typeof args.path !== "string") {
+        return { error: "Invalid path. Must be a string when provided." };
+      }
+      if (args.namespace != null && typeof args.namespace !== "string") {
+        return { error: "Invalid namespace. Must be a string when provided." };
+      }
+      if (args.dist_path != null && typeof args.dist_path !== "string") {
+        return { error: "Invalid dist_path. Must be a string when provided." };
+      }
+      if (args.sources_path != null && typeof args.sources_path !== "string") {
+        return { error: "Invalid sources_path. Must be a string when provided." };
+      }
+      const { auditProject } = await import("@decantr/verifier");
+      const projectRoot = process.cwd();
+      const hasReviewPack = existsSync(join2(projectRoot, ".decantr", "context", "review-pack.json"));
+      const hasPackManifest = existsSync(join2(projectRoot, ".decantr", "context", "pack-manifest.json"));
+      if (hasReviewPack && hasPackManifest) {
+        return auditProject(projectRoot);
+      }
+      const hosted = await loadHostedProjectAuditFallback(args);
+      if (hosted.report) {
+        return hosted.report;
+      }
+      return auditProject(projectRoot);
+    }
+    default:
+      return { error: `Unknown tool: ${name}` };
+  }
+}
+function applyDriftAcceptance(essence, violation, resolution, scope) {
+  switch (violation.rule) {
+    case "theme-match":
+    case "theme":
+    case "style": {
+      if (violation.details) {
+        essence.dna.theme.id = violation.details;
+      }
+      break;
+    }
+    case "page-exists":
+    case "structure": {
+      if (violation.page_id) {
+        const existing = essence.blueprint.pages.find((p) => p.id === violation.page_id);
+        if (!existing) {
+          essence.blueprint.pages.push({
+            id: violation.page_id,
+            layout: []
+          });
+        }
+      }
+      break;
+    }
+    case "layout": {
+      break;
+    }
+    case "density": {
+      break;
+    }
+    default:
+      break;
+  }
+}
+function applyEssenceUpdate(essence, operation, payload) {
+  switch (operation) {
+    case "add_page": {
+      const id = payload.id;
+      if (!id) throw new Error('Payload must include "id" for add_page.');
+      const existing = essence.blueprint.pages.find((p) => p.id === id);
+      if (existing) throw new Error(`Page "${id}" already exists.`);
+      essence.blueprint.pages.push({
+        id,
+        layout: payload.layout || [],
+        ...payload.shell_override ? { shell_override: payload.shell_override } : {},
+        ...payload.surface ? { surface: payload.surface } : {}
+      });
+      break;
+    }
+    case "remove_page": {
+      const id = payload.id;
+      if (!id) throw new Error('Payload must include "id" for remove_page.');
+      const idx = essence.blueprint.pages.findIndex((p) => p.id === id);
+      if (idx === -1) throw new Error(`Page "${id}" not found.`);
+      essence.blueprint.pages.splice(idx, 1);
+      break;
+    }
+    case "update_page_layout": {
+      const id = payload.id;
+      const layout = payload.layout;
+      if (!id) throw new Error('Payload must include "id" for update_page_layout.');
+      if (!layout || !Array.isArray(layout)) throw new Error('Payload must include "layout" array for update_page_layout.');
+      const page = essence.blueprint.pages.find((p) => p.id === id);
+      if (!page) throw new Error(`Page "${id}" not found.`);
+      page.layout = layout;
+      break;
+    }
+    case "update_dna": {
+      for (const [key, value] of Object.entries(payload)) {
+        if (key in essence.dna && typeof value === "object" && value !== null && !Array.isArray(value)) {
+          essence.dna[key] = {
+            ...essence.dna[key],
+            ...value
+          };
+        } else {
+          essence.dna[key] = value;
+        }
+      }
+      break;
+    }
+    case "update_blueprint": {
+      for (const [key, value] of Object.entries(payload)) {
+        if (key === "pages") continue;
+        essence.blueprint[key] = value;
+      }
+      break;
+    }
+    case "add_feature": {
+      const feature = payload.feature;
+      if (!feature) throw new Error('Payload must include "feature" for add_feature.');
+      if (!essence.blueprint.features.includes(feature)) {
+        essence.blueprint.features.push(feature);
+      }
+      break;
+    }
+    case "remove_feature": {
+      const feature = payload.feature;
+      if (!feature) throw new Error('Payload must include "feature" for remove_feature.');
+      const idx = essence.blueprint.features.indexOf(feature);
+      if (idx === -1) throw new Error(`Feature "${feature}" not found.`);
+      essence.blueprint.features.splice(idx, 1);
+      break;
+    }
+  }
+  return essence;
+}
+function describeUpdate(operation, payload) {
+  switch (operation) {
+    case "add_page":
+      return `Added page "${payload.id}".`;
+    case "remove_page":
+      return `Removed page "${payload.id}".`;
+    case "update_page_layout":
+      return `Updated layout for page "${payload.id}".`;
+    case "update_dna":
+      return `Updated DNA: ${Object.keys(payload).join(", ")}.`;
+    case "update_blueprint":
+      return `Updated blueprint: ${Object.keys(payload).join(", ")}.`;
+    case "add_feature":
+      return `Added feature "${payload.feature}".`;
+    case "remove_feature":
+      return `Removed feature "${payload.feature}".`;
+    default:
+      return `Performed ${operation}.`;
+  }
+}
+
+// src/index.ts
+var VERSION = "0.2.0";
+var server = new Server(
+  { name: "decantr", version: VERSION },
+  { capabilities: { tools: {} } }
+);
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+  return { tools: TOOLS };
+});
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+  const { name, arguments: args } = request.params;
+  try {
+    const result = await handleTool(name, args ?? {});
+    const response = {
+      content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
+    };
+    if (result && typeof result === "object" && "error" in result) {
+      response.isError = true;
+    }
+    return response;
+  } catch (err) {
+    return {
+      content: [{ type: "text", text: JSON.stringify({ error: err.message }) }],
+      isError: true
+    };
+  }
+});
+var transport = new StdioServerTransport();
+await server.connect(transport);