import type { SecurityLevel, ToolCapability } from './schema.js'; /** 漂移报告:对比基线与当前矩阵的差异。 * L-28(2026-10-22 审查第二轮):原五维不查描述/可选参数/size——description 措辞 * 随 npm 分发(docs/tools),optionalParams 与 requiredParams 同为契约面,inputSchema * 内部变化(enum/default 等,params 集合不变时)唯一可观测信号是 size。扩三维补齐。 */ export interface DriftReport { added: string[]; removed: string[]; contractChanges: string[]; securityLevelDowngrades: { name: string; from: SecurityLevel; to: SecurityLevel; }[]; annotationChanges: { name: string; field: 'readOnlyHint' | 'destructiveHint' | 'idempotentHint'; from: boolean; to: boolean; }[]; /** L-28: description 文本变化(随 npm 分发,措辞漂移即发布物漂移) */ descriptionChanges: string[]; /** L-28: optionalParams 集合变化(与 requiredParams 同为契约面) */ optionalParamChanges: string[]; /** L-28: totalBytes 变化——兜住 inputSchema 内部变化(enum/default/嵌套 description, * params 集合不变时其余维度不可见,唯一信号是 size) */ sizeChanges: { name: string; from: number; to: number; }[]; hasDrift: boolean; } /** * 纯函数:对比两份能力矩阵,产出漂移报告。 * 查 5 维:added / removed / contractChanges / securityLevelDowngrades / annotationChanges。 * 不查 gdScriptImpl(editor 实现路径属元数据,非契约字段,不参与 drift)。 */ export declare function diffMatrices(prev: ToolCapability[], curr: ToolCapability[]): DriftReport;