Summary

Stabilizes MCP tool specs before registration so the DeepSeek prefix cache fingerprint is deterministic across sessions. Tools are sorted by final registered name; schema object keys are recursively stabilized; set-like arrays (required, dependentRequired) are sorted while ordered arrays (enum, oneOf, anyOf, allOf) preserve their original order. Enabled by default with no user-facing config switch.

概述

在注册前稳定化 MCP tool specs，使 DeepSeek 前缀缓存指纹在会话间保持确定性。按最终注册名排序工具；递归稳定化 schema 对象键；排序 set-like 数组（required, dependentRequired），保留有序数组（enum, oneOf, anyOf, allOf）的原始顺序。默认启用，无用户配置开关。

Key Files

• src/mcp/registry.ts — canonicalizeMcpToolForCache(), canonicalizeSchemaForCache()
• tests/mcp-cache-canonicalization.test.ts (new) — unit tests

Depends On / 依赖

This PR is #2 in a 5-PR series:

• PR feat: Allow user to press tab and add aditional context when denying. #1: Cache Diagnostics v1
• PR feat(cli): reasonix events <name> — first user-facing consumer of the event log #3: Reliable Large Delete Primitive (delete_range)
• PR 👋 Welcome to Reasonix · how to get involved #4: AST-Aware Delete (delete_symbol)
• PR log-frame: migrate plan-resumed role from ink to frame #5: SSH Remote Workspace RFC

Test Plan

• Tool sorting by final registered name
• Schema key stabilization with recursive objects
• Set-like array sorting (required, dependentRequired)
• Enum/oneOf/anyOf/allOf order preservation
• dependentRequired inner array sorting

Verification

npm run lint      → 0 errors
npx vitest run tests/mcp-cache-canonicalization.test.ts → 4 passed