Files
whetstone_DSL/docs/mcp_tool_surface_handoff_2026-02-25.md

5.6 KiB

MCP Tool Surface Handoff (2026-02-25)

Snapshot

  • Defined MCP tools in code (editor/src/mcp/Register*Tools.h): 347
  • Active grammar/schema tool surface (tools/mcp/whetstone_tool_schemas.json): 90
  • Overlap (defined + grammar-covered): 90
  • Defined but not grammar-covered yet: 257
  • Grammar entries not currently found in registration headers: 0

Key Answer For Planning

  • You can start grammar work now on the stable active surface of 90 tools.
  • Backfill work is primarily implementation/runtime wiring of existing names, not broad renaming/removal.
  • If you want full-surface grammar coverage, additional scope is 257 tools beyond the current 90.

Files To Use

  • Active schemas now: tools/mcp/whetstone_tool_schemas.json (90 tools)
  • Grammar generator: tools/mcp/generate_tool_grammars.py
  • Full registered surface source: editor/src/mcp/Register*Tools.h

Defined-Only Gap (First 40 of 257 )

  • whetstone_analyze_data_pipeline_semantics
  • whetstone_analyze_rust_semantics
  • whetstone_apply_best_practice_pack
  • whetstone_apply_patch_packet
  • whetstone_apply_text_ast_merge
  • whetstone_apply_verified_pattern
  • whetstone_assemble_fix_context
  • whetstone_attach_multimodal_evidence
  • whetstone_begin_constructive_transaction
  • whetstone_build_debug_handoff
  • whetstone_capture_distributed_failure
  • whetstone_capture_failure_packet
  • whetstone_capture_handoff_packet
  • whetstone_capture_mcp_execution_trace
  • whetstone_check_runtime_freshness
  • whetstone_check_tool_compatibility
  • whetstone_classify_debug_stop_reason
  • whetstone_cluster_distributed_failures
  • whetstone_cluster_failures
  • whetstone_compare_constructive_replays
  • whetstone_compare_mcp_replays
  • whetstone_compare_tool_surfaces
  • whetstone_configure_hivemind
  • whetstone_debug_until_green
  • whetstone_derive_requirements
  • whetstone_detect_text_ast_conflicts
  • whetstone_diff_environments
  • whetstone_dry_run_patch
  • whetstone_enqueue_pair_upgrade
  • whetstone_estimate_debug_budget
  • whetstone_estimate_porting_cost
  • whetstone_execute_rollout_or_rollback
  • whetstone_explain_transpilation_decision
  • whetstone_export_debug_campaign_bundle
  • whetstone_export_mcp_replay_pack
  • whetstone_export_repro_jsonl
  • whetstone_export_tool_contracts
  • whetstone_export_tool_manifest
  • whetstone_extract_api_abi_contract
  • whetstone_generate_cpp_from_ir

Sprint Buckets With Unmodeled Tools

  • Format: file -> missing_count
  • editor/src/mcp/RegisterSprint100Tools.h -> 2
  • editor/src/mcp/RegisterSprint101Tools.h -> 2
  • editor/src/mcp/RegisterSprint102Tools.h -> 2
  • editor/src/mcp/RegisterSprint103Tools.h -> 2
  • editor/src/mcp/RegisterSprint104Tools.h -> 2
  • editor/src/mcp/RegisterSprint105Tools.h -> 2
  • editor/src/mcp/RegisterSprint106Tools.h -> 2
  • editor/src/mcp/RegisterSprint107Tools.h -> 2
  • editor/src/mcp/RegisterSprint108Tools.h -> 2
  • editor/src/mcp/RegisterSprint109Tools.h -> 2
  • editor/src/mcp/RegisterSprint110Tools.h -> 2
  • editor/src/mcp/RegisterSprint111Tools.h -> 3
  • editor/src/mcp/RegisterSprint112Tools.h -> 2
  • editor/src/mcp/RegisterSprint113Tools.h -> 3
  • editor/src/mcp/RegisterSprint114Tools.h -> 3
  • editor/src/mcp/RegisterSprint115Tools.h -> 3
  • editor/src/mcp/RegisterSprint116Tools.h -> 3
  • editor/src/mcp/RegisterSprint117Tools.h -> 3
  • editor/src/mcp/RegisterSprint118Tools.h -> 3
  • editor/src/mcp/RegisterSprint119Tools.h -> 3
  • editor/src/mcp/RegisterSprint131Tools.h -> 2
  • editor/src/mcp/RegisterSprint132Tools.h -> 2
  • editor/src/mcp/RegisterSprint133Tools.h -> 2
  • editor/src/mcp/RegisterSprint134Tools.h -> 2
  • editor/src/mcp/RegisterSprint135Tools.h -> 3
  • editor/src/mcp/RegisterSprint136Tools.h -> 2
  • editor/src/mcp/RegisterSprint137Tools.h -> 3
  • editor/src/mcp/RegisterSprint138Tools.h -> 3
  • editor/src/mcp/RegisterSprint139Tools.h -> 3
  • editor/src/mcp/RegisterSprint140Tools.h -> 3
  • editor/src/mcp/RegisterSprint141Tools.h -> 3
  • editor/src/mcp/RegisterSprint142Tools.h -> 3
  • editor/src/mcp/RegisterSprint143Tools.h -> 3
  • editor/src/mcp/RegisterSprint144Tools.h -> 3
  • editor/src/mcp/RegisterSprint145Tools.h -> 3
  • editor/src/mcp/RegisterSprint146Tools.h -> 3
  • editor/src/mcp/RegisterSprint147Tools.h -> 3
  • editor/src/mcp/RegisterSprint148Tools.h -> 3
  • editor/src/mcp/RegisterSprint149Tools.h -> 3
  • editor/src/mcp/RegisterSprint150Tools.h -> 3
  • editor/src/mcp/RegisterSprint151Tools.h -> 3
  • editor/src/mcp/RegisterSprint152Tools.h -> 3
  • editor/src/mcp/RegisterSprint153Tools.h -> 3
  • editor/src/mcp/RegisterSprint154Tools.h -> 3
  • editor/src/mcp/RegisterSprint155Tools.h -> 3
  • editor/src/mcp/RegisterSprint93Tools.h -> 2
  • editor/src/mcp/RegisterSprint94Tools.h -> 2
  • editor/src/mcp/RegisterSprint95Tools.h -> 2
  • editor/src/mcp/RegisterSprint96Tools.h -> 2
  • editor/src/mcp/RegisterSprint97Tools.h -> 2
  • editor/src/mcp/RegisterSprint98Tools.h -> 2
  • editor/src/mcp/RegisterSprint99Tools.h -> 2

Suggested Grammar Build Order

  1. Keep using the existing 90-tool schemas for immediate training/inference work.
  2. Add sprint-band expansions in batches (e.g., 131-137, then 138-145, then 146-155).
  3. Regenerate dispatch + per-tool grammars after each batch and run contract validation.

Update (2026-02-25 14:49 local)

  • Promoted healthy MCP binary to stable via tools/mcp/promote_mcp_if_healthy.sh.
  • Stable now points to: editor/build-native/releases/whetstone_mcp_20260225_144947.
  • Direct probe of stable binary tools/list reports: 347 tools.
  • Note: any long-lived client/server process started before promotion may still reflect the old surface until restarted.