@decantr/mcp-server 3.1.0 → 3.4.0

package/README.md

@@ -122,53 +122,41 @@ MCP tools are only available in Continue.dev agent mode.
 
 ## Key Tools
 
-The server exposes Decantr vocabulary, context, benchmark, and verification tools. Highlights:
+The server exposes a hard 8-tool MCP surface. Pass an `action` to select the routed behavior:
 
 | Tool | Description | Example Input |
 |------|-------------|---------------|
-| `decantr_create_essence` | Generate an Essence spec skeleton from a project description | `{ "description": "SaaS dashboard with analytics and billing", "framework": "react" }` |
-| `decantr_read_essence` | Read the current `decantr.essence.json` from the working directory | `{}` or `{ "path": "./custom.essence.json" }` |
-| `decantr_validate` | Validate an Essence file against the schema and guard rules | `{ "path": "./decantr.essence.json" }` |
-| `decantr_search_registry` | Search official/community vocabulary for patterns, archetypes, themes, and shells | `{ "query": "kanban", "type": "pattern" }` |
-| `decantr_resolve_pattern` | Get full pattern details: layout spec, components, presets, code examples | `{ "id": "data-table", "preset": "product" }` |
-| `decantr_resolve_archetype` | Get archetype details: default pages, layouts, features, suggested theme | `{ "id": "saas-dashboard" }` |
-| `decantr_resolve_blueprint` | Get a full app composition with page structure and personality traits | `{ "id": "ecommerce" }` |
-| `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_get_project_state` | Read a compact typed summary of Essence, generated packs, graph artifacts, capsule source-handle bounds, source artifacts available for file impact, local snapshot history, typed diff counts, local law, behavior obligations, style bridge, stable diagnostic catalog, and recommended next tools | `{ "project_path": "apps/web" }` |
-| `decantr_prepare_task_context` | Resolve compact route/task context, task-ranked typed route graph, optional graph-shaped changed-file impact, authority lane, local law, behavior obligations, style bridge mappings, and evidence before editing a Brownfield, Hybrid, or Essence route | `{ "project_path": "apps/web", "route": "/feed", "task": "improve recipe card loading" }` |
-| `decantr_get_contract_capsule` | Read the cache-friendly Contract capsule generated by `decantr graph`, including bounded SourceArtifact paths that can be reused as `file_path` handles | `{ "project_path": "apps/web" }` |
-| `decantr_get_graph_snapshot` | Read graph metadata with snapshot-history status and typed diff counts, a compact local history index, a route-scoped graph subgraph, node or source-file impact context, task-aware ranked context, a specific history snapshot, or a typed diff between local snapshots | `{ "project_path": "apps/web", "file_path": "src/app/page.tsx", "task": "edit source" }` |
-| `decantr_query_graph` | Query current or historical graph nodes, source files, payload fields, relations, and optional node-impact context without reading the full snapshot | `{ "project_path": "apps/web", "snapshot_id": "current", "file_path": "src/app/page.tsx", "include_impact": true }` |
-| `decantr_traverse_graph` | Traverse the current or historical typed graph from one or more node IDs or a source file by relation, direction, and depth | `{ "project_path": "apps/web", "snapshot_id": "current", "file_path": "src/app/page.tsx", "direction": "in", "relations": ["NODE_DERIVED_FROM_SOURCE"] }` |
-| `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" }` |
-| `decantr_get_findings` | Return typed Project Health findings with stable codes, repair IDs, graph anchors, and optional repair prompts | `{ "project_path": "apps/web", "code": "TOKEN010" }` |
-| `decantr_get_repair_plan` | Return a structured repair plan for a finding with repair ID, graph anchor, optional impact context, action payload, evidence, read targets, constraints, and rerun commands | `{ "project_path": "apps/web", "code": "TOKEN010" }` |
-| `decantr_get_evidence_bundle` | Generate the local privacy-redacted Evidence Bundle for a project, including graph anchors and graph artifact provenance when `.decantr/graph` exists | `{ "project_path": "apps/web" }` |
-| `decantr_workspace_health` | Discover Decantr projects and return aggregate workspace health | `{ "workspace_root": ".", "max_projects": 100 }` |
-| `decantr_get_repair_prompt` | Return the scoped repair prompt for a health finding | `{ "finding_id": "assertion-contract-context-pack-manifest" }` |
-| `decantr_run_health_loop` | Run health, evidence, and next repair prompt in one local agent loop | `{ "project_path": "apps/web" }` |
-| `decantr_get_showcase_benchmarks` | Read the audited showcase corpus manifest, shortlist, or verification report | `{ "view": "verification" }` |
+| `decantr_project` | Read local project state and workspace health | `{ "action": "state", "project_path": "apps/web" }` |
+| `decantr_contract` | Read Essence, validate, check drift, generate a skeleton, or read the Contract capsule | `{ "action": "validate", "path": "./decantr.essence.json" }` |
+| `decantr_context` | Read scaffold, section, page, task, and execution-pack context | `{ "action": "task", "project_path": "apps/web", "route": "/feed", "task": "improve recipe card loading" }` |
+| `decantr_graph` | Read graph snapshots, query graph nodes/edges, or traverse graph relations | `{ "action": "query", "project_path": "apps/web", "file_path": "src/app/page.tsx", "include_impact": true }` |
+| `decantr_registry` | Search and resolve hosted registry content, benchmarks, and execution packs | `{ "action": "resolve_pattern", "id": "data-table", "preset": "product" }` |
+| `decantr_verify` | Run audit, critique, findings, evidence, or health-loop reads | `{ "action": "critique", "file_path": "./src/pages/Overview.tsx" }` |
+| `decantr_repair` | Return typed findings, repair plans, repair prompts, and repair loop guidance | `{ "action": "repair_plan", "project_path": "apps/web", "code": "TOKEN010" }` |
+| `decantr_contract_write` | Explicit write surface for accepting drift or mutating Essence v4 | `{ "action": "update_essence", "operation": "add_feature", "payload": { "feature": "billing" } }` |
 
 For the broader product surface and support policy, see the root Decantr docs and package support matrix.
 
+For Decantr 3 assistant prompt migration, see the MCP migration guide: https://decantr.ai/reference/mcp-migration.md.
+
 ## Security And Permissions
 
-The MCP server reads Decantr files, including `.decantr/graph` typed graph artifacts, and selected project files from the active workspace. Write access is limited to explicit write tools such as `decantr_update_essence` and `decantr_accept_drift`, and paths are contained to the active workspace root.
+The MCP server reads Decantr files, including `.decantr/graph` typed graph artifacts, and selected project files from the active workspace. Write access is limited to the explicit `decantr_contract_write` tool with `accept_drift` and `update_essence` actions, and paths are contained to the active workspace root.
 
 Registry and pack-resolution tools may call the configured Decantr API. Source upload fallbacks for hosted critique/audit are disabled unless the tool call explicitly passes `allow_hosted_upload: true`. The MCP server does not emit Decantr telemetry. See [security permissions](https://decantr.ai/reference/security-permissions.md).
 
 ## Compatibility
 
-`@decantr/mcp-server` is stable in the `2.x` line for the documented MCP tool surface.
+`@decantr/mcp-server` is stable in the Decantr 3 line for the documented MCP tool surface.
 
 - new tools may be added in compatible releases
 - existing documented tool names and envelopes should not break without a major version
 - breaking changes to established tool contracts require a major version and migration note
 
+### 3.4 Tool Surface Migration
+
+Decantr 3.4 consolidates legacy MCP tool names into the eight action-based tools above. For example, `decantr_get_project_state` becomes `decantr_project` with `{ "action": "state" }`, `decantr_get_graph_snapshot` becomes `decantr_graph` with `{ "action": "snapshot" }`, and the legacy write tools become `decantr_contract_write` with `{ "action": "accept_drift" }` or `{ "action": "update_essence" }`.
+
 ## How It Works
 
 An Essence spec (`decantr.essence.json`) captures your design intent -- archetype, theme, page structure, patterns, and guard rules -- in a single declarative file. The MCP server exposes this spec and the Decantr registry to your AI assistant, giving it concrete layout specs, component lists, and visual treatments instead of relying on the model's generic training data. The result is generated code that follows a coherent design system, and drift detection that catches deviations before they ship.
@@ -179,24 +167,13 @@ An Essence spec (`decantr.essence.json`) captures your design intent -- archetyp
 
 The AI assistant calls these tools behind the scenes:
 
-1. `decantr_create_essence` -- generates a spec skeleton matched to the `saas-dashboard` archetype
-2. `decantr_resolve_archetype` -- pulls default pages, layouts, and features for a SaaS dashboard
-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_get_project_state` -- checks Essence, packs, graph readiness, capsule source-handle bounds, source artifacts available for file impact, local snapshot history, typed diff counts, local law, accepted behavior obligations, stable diagnostic codes, and the next useful tool calls
-7. `decantr_prepare_task_context` -- resolves route-local Brownfield/Hybrid context, task-ranked typed route graph context, graph-shaped changed-file impact when changed files resolve to SourceArtifact nodes, active authority, accepted local law, accepted behavior obligations, accepted style bridge mappings, visual evidence, and theme inventory before editing an existing app
-8. `decantr_get_contract_capsule` -- loads the compact Contract graph capsule, including the bounded SourceArtifact path index, when `.decantr/graph` exists
-9. `decantr_get_graph_snapshot` -- reads graph metadata, snapshot-history status, optional compact history, typed diff counts, route-scoped graph nodes/edges with optional task-aware ranking, impact graph nodes/edges through `node_id` or `file_path`, specific history snapshots through `snapshot_id`, and local snapshot diffs through `compare_to`
-10. `decantr_query_graph` and `decantr_traverse_graph` -- answer typed follow-up questions against current or historical snapshots, such as which pages use a route, component, token, source file, rule, or diagnostic code; `decantr_query_graph` can include an impact subgraph for matched node IDs or a `file_path` SourceArtifact so agents can inspect blast radius before changing a component, token, rule, finding, or source artifact, and `decantr_traverse_graph` can resolve `file_path` into the SourceArtifact start node for relation walks
-11. `decantr_compile_execution_packs` -- compiles the hosted pack bundle when the task needs a fresh remote contract from the essence document
-12. `decantr_check_drift` -- validates the generated code against the Essence spec before presenting it
-13. `decantr_critique` -- critiques a specific file, falling back to the hosted verifier when the local review pack is missing
-14. `decantr_audit_project` -- runs the stronger project-level audit once the implementation is in place
-15. `decantr_get_findings` -- returns compact typed findings with diagnostic codes, repair IDs, and optional prompts
-16. `decantr_get_repair_plan` -- returns typed repair actions, graph anchors, optional graph impact context, evidence, read targets, preserve/avoid constraints, and rerun commands
-17. `decantr_get_evidence_bundle` -- returns the local evidence bundle, graph anchors, and graph artifact provenance for the AI repair loop
-18. `decantr_get_repair_prompt` -- gives the assistant exact finding evidence, constraints to preserve, and commands to rerun
+1. `decantr_contract` with `create_essence`, `validate`, or `check_drift` actions to generate and verify the contract
+2. `decantr_registry` with `resolve_archetype`, `suggest_patterns`, `resolve_pattern`, or `compile_execution_packs` actions to fetch vocabulary and packs
+3. `decantr_context` with `execution_pack` or `task` actions to load the compact task contract before editing
+4. `decantr_project` with `state` to check Essence, packs, graph readiness, local law, diagnostics, and next useful action calls
+5. `decantr_contract` with `capsule` and `decantr_graph` with `snapshot`, `query`, or `traverse` to read typed graph context
+6. `decantr_verify` with `critique`, `audit_project`, or `evidence_bundle` to produce local evidence; hosted upload remains opt-in with `allow_hosted_upload: true`
+7. `decantr_repair` with `findings`, `repair_plan`, or `repair_prompt` to enter a scoped evidence-backed repair loop
 
 The AI now generates code with the right layout structure, correct components, and consistent styling, then gets a scoped evidence-backed repair loop instead of a generic guess.
 

package/dist/bin.js

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

package/dist/{chunk-JGU5VKY7.js → chunk-BXY4AIGA.js}

@@ -1813,894 +1813,152 @@ async function getMcpWorkspaceHealth(args) {
     projects
   };
 }
-var TOOLS = [
-  // 1. decantr_read_essence — local read
-  {
-    name: "decantr_read_essence",
-    title: "Read Essence",
-    description: "Read and return the current Essence v4 decantr.essence.json file from the working directory. 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 Essence v4 files: return only the specified layer. Defaults to full."
-        }
-      }
-    },
-    annotations: READ_ONLY
+var CONSOLIDATED_TOOL_ACTIONS = {
+  decantr_project: {
+    state: "decantr_get_project_state",
+    workspace_health: "decantr_workspace_health"
   },
-  // 2. decantr_validate — local read
-  {
-    name: "decantr_validate",
-    title: "Validate Essence",
-    description: "Validate an Essence v4 decantr.essence.json file against the schema and guard rules, reporting 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
+  decantr_contract: {
+    read_essence: "decantr_read_essence",
+    validate: "decantr_validate",
+    check_drift: "decantr_check_drift",
+    create_essence: "decantr_create_essence",
+    capsule: "decantr_get_contract_capsule"
   },
-  // 3. decantr_search_registry — network
-  {
-    name: "decantr_search_registry",
-    title: "Search Vocabulary",
-    description: "Search Decantr official/community vocabulary 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
+  decantr_context: {
+    scaffold: "decantr_get_scaffold_context",
+    section: "decantr_get_section_context",
+    page: "decantr_get_page_context",
+    task: "decantr_prepare_task_context",
+    execution_pack: "decantr_get_execution_pack"
   },
-  // 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")'
-        },
-        route: {
-          type: "string",
-          description: 'Optional route context, for example "/feed" or "/settings".'
-        },
-        source_code: {
-          type: "string",
-          description: "Optional local source excerpt to rank against actual code evidence."
-        }
-      },
-      required: ["description"]
-    },
-    annotations: READ_ONLY_NETWORK
+  decantr_graph: {
+    snapshot: "decantr_get_graph_snapshot",
+    query: "decantr_query_graph",
+    traverse: "decantr_traverse_graph"
   },
-  // 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 v4 spec. 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
+  decantr_registry: {
+    search: "decantr_search_registry",
+    resolve_pattern: "decantr_resolve_pattern",
+    resolve_archetype: "decantr_resolve_archetype",
+    resolve_blueprint: "decantr_resolve_blueprint",
+    suggest_patterns: "decantr_suggest_patterns",
+    showcase_benchmarks: "decantr_get_showcase_benchmarks",
+    intelligence_summary: "decantr_get_registry_intelligence_summary",
+    compile_execution_packs: "decantr_compile_execution_packs"
   },
-  // 10. decantr_create_essence — network (fetches archetype)
-  {
-    name: "decantr_create_essence",
-    title: "Create Essence",
-    description: "Generate a valid Essence v4 skeleton from a project description. Returns a sectioned decantr.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
+  decantr_verify: {
+    audit_project: "decantr_audit_project",
+    critique: "decantr_critique",
+    findings: "decantr_get_findings",
+    evidence_bundle: "decantr_get_evidence_bundle",
+    health_loop: "decantr_run_health_loop"
   },
-  // 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
+  decantr_repair: {
+    findings: "decantr_get_findings",
+    repair_plan: "decantr_get_repair_plan",
+    repair_prompt: "decantr_get_repair_prompt",
+    health_loop: "decantr_run_health_loop"
   },
-  // 12. decantr_update_essence — WRITE tool (NEW)
-  {
-    name: "decantr_update_essence",
-    title: "Update Essence",
-    description: "Mutate an Essence v4 file: add/remove/update pages, update DNA or blueprint fields, add/remove features. Older projects must run `decantr migrate --to v4` first.",
-    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_project_state — local read
-  {
-    name: "decantr_get_project_state",
-    title: "Get Project State",
-    description: "Read a compact typed summary of the active Decantr project: Essence version, routes, generated packs, typed graph artifacts, local law, style bridge, diagnostic catalog, and recommended next MCP tools.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        project_path: {
-          type: "string",
-          description: "Optional relative project path inside the active workspace. Defaults to the current working directory."
-        }
-      }
-    },
-    annotations: READ_ONLY
-  },
-  // 17. decantr_prepare_task_context — local read
-  {
-    name: "decantr_prepare_task_context",
-    title: "Prepare Task Context",
-    description: "Resolve compact Brownfield/Essence task-time context for a route or page before editing. Returns route, section, page pack, directives, local law, behavior obligations, style bridge mappings, typed graph context, health evidence, and local screenshot references when available.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        project_path: {
-          type: "string",
-          description: "Optional relative project path inside the active workspace. Defaults to the current working directory."
-        },
-        route: {
-          type: "string",
-          description: 'Route being edited, for example "/feed". Preferred when known.'
-        },
-        page_id: {
-          type: "string",
-          description: "Page ID when route is unknown."
-        },
-        task: {
-          type: "string",
-          description: "Short task description used to rank relevant patterns and context."
-        }
-      }
-    },
-    annotations: READ_ONLY
-  },
-  // 17. decantr_get_contract_capsule — local typed graph read
-  {
-    name: "decantr_get_contract_capsule",
-    title: "Get Contract Capsule",
-    description: "Read the Decantr typed Contract capsule generated by `decantr graph`. This is the compact, cache-friendly Contract summary agents should load near session start.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        project_path: {
-          type: "string",
-          description: "Optional relative project path inside the active workspace. Defaults to the current working directory."
-        }
-      }
-    },
-    annotations: READ_ONLY
-  },
-  // 18. decantr_get_graph_snapshot — local typed graph read
-  {
-    name: "decantr_get_graph_snapshot",
-    title: "Get Graph Snapshot",
-    description: "Read the Decantr typed graph snapshot generated by `decantr graph`. By default returns snapshot metadata and available routes; pass route for a scoped route subgraph, include_history for a compact local timeline, or include_full for the full snapshot.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        project_path: {
-          type: "string",
-          description: "Optional relative project path inside the active workspace. Defaults to the current working directory."
-        },
-        route: {
-          type: "string",
-          description: 'Optional route path, for example "/settings", to return a scoped subgraph.'
-        },
-        node_id: {
-          type: "string",
-          description: 'Optional graph node ID, for example "cmp:button" or "tkn:surface", to return dependency impact context.'
-        },
-        file_path: {
-          type: "string",
-          description: 'Optional project-relative source file path, for example "src/app/page.tsx", to return dependency impact context for its SourceArtifact node.'
-        },
-        snapshot_id: {
-          type: "string",
-          description: 'Optional graph snapshot id to read from .decantr/graph/snapshots. Use "current" or omit for graph.snapshot.json.'
-        },
-        compare_to: {
-          type: "string",
-          description: 'Optional snapshot id to diff against the selected snapshot. Use "current" for graph.snapshot.json.'
-        },
-        include_diff_ops: {
-          type: "boolean",
-          description: "Include diff operation details when compare_to is provided. Defaults to false."
-        },
-        limit: {
-          type: "number",
-          description: "Maximum diff operations or impact nodes to return. Defaults to 200, maximum 500."
-        },
-        include_full: {
-          type: "boolean",
-          description: "Return the full graph snapshot instead of metadata. Defaults to false."
-        },
-        include_history: {
-          type: "boolean",
-          description: "Include a compact index of local snapshot history entries from .decantr/graph/snapshots. Defaults to false."
-        },
-        task: {
-          type: "string",
-          description: "Optional task description used to boost matching nodes in route-scoped or impact ranked context."
-        }
-      }
-    },
-    annotations: READ_ONLY
-  },
-  // 19. decantr_query_graph — local typed graph read
-  {
-    name: "decantr_query_graph",
-    title: "Query Graph",
-    description: "Run a narrow typed query against the local Decantr graph snapshot generated by `decantr graph`. Use for direct node/type/relation lookups instead of reading the full graph.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        project_path: {
-          type: "string",
-          description: "Optional relative project path inside the active workspace. Defaults to the current working directory."
-        },
-        snapshot_id: {
-          type: "string",
-          description: 'Optional snapshot id from local graph history, or "current". Defaults to current.'
-        },
-        node_ids: {
-          type: "array",
-          items: { type: "string" },
-          description: 'Optional exact graph node IDs to return, for example ["rt:/feed"].'
-        },
-        file_path: {
-          type: "string",
-          description: 'Optional project-relative source file path, for example "src/app/page.tsx", resolved to a SourceArtifact node selector.'
-        },
-        node_type: {
-          type: "string",
-          enum: [...GRAPH_NODE_TYPES],
-          description: 'Optional single node type selector, for example "Route" or "Component".'
-        },
-        node_types: {
-          type: "array",
-          items: { type: "string", enum: [...GRAPH_NODE_TYPES] },
-          description: "Optional node type selectors."
-        },
-        payload_key: {
-          type: "string",
-          description: 'Optional node payload key or dotted path filter, for example "code" for Finding nodes.'
-        },
-        payload_value: {
-          type: "string",
-          description: 'Optional exact stringified payload value used with payload_key, for example "COMP010".'
-        },
-        payload_contains: {
-          type: "string",
-          description: "Optional case-insensitive substring filter over the node payload JSON."
-        },
-        edge_src: {
-          type: "string",
-          description: "Optional edge source node ID selector."
-        },
-        edge_dst: {
-          type: "string",
-          description: "Optional edge destination node ID selector."
-        },
-        relation: {
-          type: "string",
-          enum: [...GRAPH_RELATIONS],
-          description: 'Optional single edge relation selector, for example "PAGE_COMPOSES_PATTERN".'
-        },
-        relations: {
-          type: "array",
-          items: { type: "string", enum: [...GRAPH_RELATIONS] },
-          description: "Optional edge relation selectors."
-        },
-        include_edges: {
-          type: "boolean",
-          description: "When querying nodes, include incident edges and their opposite endpoint nodes. Defaults to false unless edge selectors are present."
-        },
-        include_impact: {
-          type: "boolean",
-          description: "When querying nodes, also return the dependency impact context for the matched node IDs."
-        },
-        task: {
-          type: "string",
-          description: "Optional task description used to boost matching nodes in the impact ranking when include_impact is true."
-        },
-        limit: {
-          type: "number",
-          description: "Maximum nodes and edges to return. Defaults to 200, maximum 500."
-        }
-      }
-    },
-    annotations: READ_ONLY
-  },
-  // 20. decantr_traverse_graph — local typed graph read
-  {
-    name: "decantr_traverse_graph",
-    title: "Traverse Graph",
-    description: "Traverse the local Decantr graph from one or more node IDs or a source file by relation, direction, and depth. Use for questions like which pages use this token or which graph nodes point at this source file.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        project_path: {
-          type: "string",
-          description: "Optional relative project path inside the active workspace. Defaults to the current working directory."
-        },
-        snapshot_id: {
-          type: "string",
-          description: 'Optional snapshot id from local graph history, or "current". Defaults to current.'
-        },
-        from: {
-          type: "string",
-          description: 'Start node ID, for example "rt:/feed" or "tkn:color.primary".'
-        },
-        from_ids: {
-          type: "array",
-          items: { type: "string" },
-          description: "Optional start node IDs. Used when traversing from multiple anchors."
-        },
-        file_path: {
-          type: "string",
-          description: 'Optional project-relative source file path, for example "src/app/page.tsx", resolved to a SourceArtifact start node.'
-        },
-        relations: {
-          type: "array",
-          items: { type: "string", enum: [...GRAPH_RELATIONS] },
-          description: "Optional relation allow-list. When omitted, all relations are traversed."
-        },
-        direction: {
-          type: "string",
-          enum: ["out", "in", "both"],
-          description: "Traversal direction. Defaults to out."
-        },
-        depth: {
-          type: "number",
-          description: "Traversal depth. Defaults to 1, maximum 4."
-        },
-        limit: {
-          type: "number",
-          description: "Maximum nodes and edges to return. Defaults to 200, maximum 500."
-        }
-      }
-    },
-    annotations: READ_ONLY
-  },
-  // 21. 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. Can fall back to the hosted verifier when local compiled pack artifacts are missing only when allow_hosted_upload is true. 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`."
-        },
-        allow_hosted_upload: {
-          type: "boolean",
-          description: "Explicitly opt in to uploading local dist/source snapshots to the hosted verifier when local packs are missing. Defaults to false."
-        }
-      }
-    },
-    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. Can fall back to the hosted verifier when local review packs are missing only when allow_hosted_upload is true. Returns a schema-backed file critique report with scores, findings, and focus areas.",
+  decantr_contract_write: {
+    accept_drift: "decantr_accept_drift",
+    update_essence: "decantr_update_essence"
+  }
+};
+function consolidatedActionNames(name) {
+  return Object.keys(CONSOLIDATED_TOOL_ACTIONS[name]);
+}
+function consolidatedTool(name, title, description, annotations) {
+  return {
+    name,
+    title,
+    description,
     inputSchema: {
       type: "object",
       properties: {
-        file_path: {
-          type: "string",
-          description: "Path to the component file to critique"
-        },
-        path: {
+        action: {
           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."
-        },
-        allow_hosted_upload: {
-          type: "boolean",
-          description: "Explicitly opt in to uploading the target source file to the hosted verifier when local review packs are missing. Defaults to false."
+          enum: consolidatedActionNames(name),
+          description: "Action to run through this consolidated Decantr MCP tool."
         }
       },
-      required: ["file_path"]
+      required: ["action"],
+      additionalProperties: true
     },
-    annotations: READ_ONLY_NETWORK
-  },
-  // 24. decantr_get_findings — local typed findings read
-  {
-    name: "decantr_get_findings",
-    title: "Get Findings",
-    description: "Return typed Project Health findings for the current Decantr project, with stable codes, repair IDs, graph anchors when available, and optional repair prompts.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        project_path: {
-          type: "string",
-          description: "Optional relative project path inside the active workspace. Defaults to the current working directory."
-        },
-        severity: {
-          type: "string",
-          enum: ["error", "warn", "info"],
-          description: "Optional severity filter."
-        },
-        source: {
-          type: "string",
-          enum: [
-            "audit",
-            "assertion",
-            "browser",
-            "check",
-            "brownfield",
-            "design-token",
-            "style-bridge",
-            "graph",
-            "runtime",
-            "pack",
-            "interaction"
-          ],
-          description: "Optional finding source filter."
-        },
-        code: {
-          type: "string",
-          description: 'Optional stable diagnostic code filter, for example "TOKEN010".'
-        },
-        include_prompts: {
-          type: "boolean",
-          description: "Include full repair prompts on each finding. Defaults to false to keep context compact."
-        },
-        limit: {
-          type: "number",
-          description: "Maximum findings to return. Defaults to 50, maximum 200."
-        }
-      }
-    },
-    annotations: READ_ONLY
-  },
-  // 25. decantr_get_repair_plan — local structured repair loop
-  {
-    name: "decantr_get_repair_plan",
-    title: "Get Repair Plan",
-    description: "Return a typed repair plan for one Project Health finding: diagnostic code, repair ID, graph anchor, action payload, evidence, read targets, preserve/avoid constraints, rerun commands, and optional prompt text.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        project_path: {
-          type: "string",
-          description: "Optional relative project path inside the active workspace. Defaults to the current working directory."
-        },
-        finding_id: {
-          type: "string",
-          description: "Optional finding id. Defaults to the first error or warning, then the first finding."
-        },
-        code: {
-          type: "string",
-          description: 'Optional stable diagnostic code selector, for example "GRAPH001".'
-        },
-        include_prompt: {
-          type: "boolean",
-          description: "Include the human-readable repair prompt alongside the typed plan."
-        }
-      }
-    },
-    annotations: READ_ONLY
-  },
-  // 26. decantr_get_evidence_bundle — local reliability artifact
-  {
-    name: "decantr_get_evidence_bundle",
-    title: "Get Evidence Bundle",
-    description: "Generate a local Evidence Bundle for the current Decantr project. The bundle redacts source, prompts, secrets, absolute paths, repo names, and screenshots by default.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        project_path: {
-          type: "string",
-          description: "Optional relative project path inside the active workspace. Defaults to the current working directory."
-        }
-      }
-    },
-    annotations: READ_ONLY
-  },
-  // 23. decantr_workspace_health — local workspace reliability scan
-  {
-    name: "decantr_workspace_health",
-    title: "Workspace Health",
-    description: "Discover Decantr projects in the active workspace and return deterministic aggregate health for monorepos with many Decantr apps.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        workspace_root: {
-          type: "string",
-          description: "Optional relative workspace root inside the active workspace. Defaults to the current working directory."
-        },
-        max_projects: {
-          type: "number",
-          description: "Optional cap on discovered projects. Defaults to 500."
-        }
-      }
-    },
-    annotations: READ_ONLY
-  },
-  // 24. decantr_get_repair_prompt — local AI repair loop
-  {
-    name: "decantr_get_repair_prompt",
-    title: "Get Repair Prompt",
-    description: "Return an AI-ready repair prompt for a Project Health finding, including exact finding evidence, preserved constraints, do-not-change guidance, and rerun commands.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        project_path: {
-          type: "string",
-          description: "Optional relative project path inside the active workspace. Defaults to the current working directory."
-        },
-        finding_id: {
-          type: "string",
-          description: "Optional finding id. Defaults to the first error or warning, then the first finding."
-        }
-      }
-    },
-    annotations: READ_ONLY
-  },
-  // 25. decantr_run_health_loop — local evidence + repair loop
-  {
-    name: "decantr_run_health_loop",
-    title: "Run Health Loop",
-    description: "Run Project Health, produce evidence, and return the next repair prompt for AI agents without uploading project source.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        project_path: {
-          type: "string",
-          description: "Optional relative project path inside the active workspace. Defaults to the current working directory."
-        },
-        finding_id: {
-          type: "string",
-          description: "Optional finding id to target. Defaults to the first error or warning, then the first finding."
-        }
-      }
-    },
-    annotations: READ_ONLY
-  }
+    annotations
+  };
+}
+var TOOLS = [
+  consolidatedTool(
+    "decantr_project",
+    "Decantr Project",
+    "Read local project state and workspace health without uploading source.",
+    READ_ONLY
+  ),
+  consolidatedTool(
+    "decantr_contract",
+    "Decantr Contract",
+    "Read, validate, drift-check, generate, or summarize the active Decantr contract.",
+    READ_ONLY_NETWORK
+  ),
+  consolidatedTool(
+    "decantr_context",
+    "Decantr Context",
+    "Read scaffold, section, page, task, and execution-pack context for agent work.",
+    READ_ONLY_NETWORK
+  ),
+  consolidatedTool(
+    "decantr_graph",
+    "Decantr Graph",
+    "Read, query, and traverse local typed Contract graph artifacts.",
+    READ_ONLY
+  ),
+  consolidatedTool(
+    "decantr_registry",
+    "Decantr Registry",
+    "Search and resolve hosted registry content, benchmark metadata, and execution packs.",
+    READ_ONLY_NETWORK
+  ),
+  consolidatedTool(
+    "decantr_verify",
+    "Decantr Verify",
+    "Run local verification reads, critique files, and return evidence or health findings.",
+    READ_ONLY_NETWORK
+  ),
+  consolidatedTool(
+    "decantr_repair",
+    "Decantr Repair",
+    "Read typed findings, repair plans, repair prompts, and health-loop guidance.",
+    READ_ONLY
+  ),
+  consolidatedTool(
+    "decantr_contract_write",
+    "Decantr Contract Write",
+    "Explicit write surface for accepting drift or mutating Essence v4 inside the workspace.",
+    WRITE_TOOL
+  )
 ];
 async function handleTool(name, args) {
+  if (!(name in CONSOLIDATED_TOOL_ACTIONS)) {
+    return { error: `Unknown tool: ${name}` };
+  }
+  const actionMap = CONSOLIDATED_TOOL_ACTIONS[name];
+  if (typeof args.action !== "string" || !args.action.trim()) {
+    return {
+      error: `Required parameter "action" must be one of: ${Object.keys(actionMap).join(", ")}.`
+    };
+  }
+  const action = args.action.trim();
+  const legacyName = actionMap[action];
+  if (!legacyName) {
+    return {
+      error: `Unsupported action "${action}" for ${name}. Must be one of: ${Object.keys(actionMap).join(", ")}.`
+    };
+  }
+  const { action: _action, ...routedArgs } = args;
+  return handleLegacyTool(legacyName, routedArgs);
+}
+async function handleLegacyTool(name, args) {
   const apiClient = getAPIClient();
   switch (name) {
     case "decantr_read_essence": {
@@ -3224,7 +2482,7 @@ async function handleTool(name, args) {
         };
       }
       try {
-        const { essence, path } = await mutateEssenceFile(args.path, (v4) => {
+        const { path } = await mutateEssenceFile(args.path, (v4) => {
           for (const v of violations) {
             applyDriftAcceptance(v4, v, resolution, args.scope);
           }
@@ -3264,7 +2522,7 @@ async function handleTool(name, args) {
         };
       }
       try {
-        const { essence, path } = await mutateEssenceFile(args.path, (v4) => {
+        const { path } = await mutateEssenceFile(args.path, (v4) => {
           return applyEssenceUpdate(v4, operation, payload);
         });
         return {
@@ -3386,13 +2644,21 @@ async function handleTool(name, args) {
             })).sort((a, b) => a.code.localeCompare(b.code) || a.rule.localeCompare(b.rule))
           },
           recommended_next_tools: [
-            graphReady ? "decantr_get_contract_capsule" : "decantr_get_findings",
-            graphReady ? null : "decantr_get_repair_plan",
-            snapshot ? "decantr_get_graph_snapshot" : null,
-            "decantr_prepare_task_context",
-            "decantr_get_findings",
-            "decantr_get_evidence_bundle"
-          ].filter((tool) => Boolean(tool))
+            graphReady ? "decantr_contract" : "decantr_repair",
+            graphReady ? null : "decantr_repair",
+            snapshot ? "decantr_graph" : null,
+            "decantr_context",
+            "decantr_repair",
+            "decantr_verify"
+          ].filter((tool) => Boolean(tool)).filter((tool, index, tools) => tools.indexOf(tool) === index),
+          recommended_next_actions: [
+            graphReady ? { tool: "decantr_contract", action: "capsule" } : { tool: "decantr_repair", action: "findings" },
+            graphReady ? null : { tool: "decantr_repair", action: "repair_plan" },
+            snapshot ? { tool: "decantr_graph", action: "snapshot" } : null,
+            { tool: "decantr_context", action: "task" },
+            { tool: "decantr_repair", action: "findings" },
+            { tool: "decantr_verify", action: "evidence_bundle" }
+          ].filter((action) => Boolean(action))
         };
       } catch (e) {
         return { error: `Could not read project state: ${e.message}` };
@@ -4329,7 +3595,6 @@ async function handleTool(name, args) {
       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";
@@ -4349,7 +3614,6 @@ async function handleTool(name, args) {
           manifestSource = "hosted_fallback";
         } else {
           const hosted = await loadHostedExecutionPackBundleFallback(args);
-          hostedBundle = hosted.bundle;
           hostedFallbackError = hosted.error;
           if (!hosted.bundle) {
             return {
@@ -4924,7 +4188,7 @@ function describeUpdate(operation, payload) {
 }
 
 // src/index.ts
-var VERSION = "3.1.0";
+var VERSION = "3.4.0";
 var server = new Server({ name: "decantr", version: VERSION }, { capabilities: { tools: {} } });
 server.setRequestHandler(ListToolsRequestSchema, async () => {
   return { tools: TOOLS };

package/dist/index.js

@@ -1 +1 @@
-import "./chunk-JGU5VKY7.js";
+import "./chunk-BXY4AIGA.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decantr/mcp-server",
-  "version": "3.1.0",
+  "version": "3.4.0",
   "mcpName": "io.github.decantr-ai/mcp-server",
   "description": "MCP server for Decantr — exposes Contract context, typed graph artifacts, and verification evidence to AI coding assistants",
   "keywords": [
@@ -51,10 +51,10 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
-    "@decantr/registry": "3.1.0",
-    "@decantr/core": "3.1.0",
-    "@decantr/essence-spec": "3.1.0",
-    "@decantr/verifier": "3.1.0"
+    "@decantr/core": "3.4.0",
+    "@decantr/verifier": "3.4.0",
+    "@decantr/essence-spec": "3.4.0",
+    "@decantr/registry": "3.4.0"
   },
   "scripts": {
     "build": "tsup",