spectra-cli 4.1.1

package/dist/diff/drift-orchestrator.js

@@ -0,0 +1,248 @@
+/**
+ * 漂移检测编排器
+ * 端到端的 Spec 漂移检测流水线（US3）
+ * 参见 contracts/diff-engine.md
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { CodeSkeletonSchema } from '../models/code-skeleton.js';
+import { analyzeFile, analyzeFiles } from '../core/ast-analyzer.js';
+import { scanFiles } from '../utils/file-scanner.js';
+import { compareSkeletons } from './structural-diff.js';
+import { filterNoise } from './noise-filter.js';
+import { evaluateBehaviorChange } from './semantic-diff.js';
+import { renderDriftReport, initRenderer } from '../generator/spec-renderer.js';
+// ============================================================
+// 基线骨架加载
+// ============================================================
+/**
+ * 从现有 spec 文件内容中提取序列化的基线 CodeSkeleton
+ *
+ * @param specContent - spec 文件的原始文本内容
+ * @returns CodeSkeleton，parserUsed 指示来源
+ */
+export function loadBaselineSkeleton(specContent) {
+    // 尝试从 HTML 注释中提取基线骨架
+    const baselineMatch = /<!-- baseline-skeleton: (.+?) -->/.exec(specContent);
+    if (baselineMatch?.[1]) {
+        try {
+            const parsed = JSON.parse(baselineMatch[1]);
+            const validated = CodeSkeletonSchema.parse(parsed);
+            return validated;
+        }
+        catch {
+            // JSON 解析或 Zod 验证失败，降级
+        }
+    }
+    // 降级：构建最小重建骨架
+    return buildReconstructedSkeleton(specContent);
+}
+/**
+ * 从 spec 的接口定义章节尽力重建部分骨架
+ */
+function buildReconstructedSkeleton(specContent) {
+    const exports = [];
+    // 尝试从接口定义章节提取签名
+    const interfaceSection = extractSection(specContent, '接口定义');
+    if (interfaceSection) {
+        // 匹配 ### `functionName(...)` 或 ### `ClassName` 格式
+        const signatureRe = /###\s+`([^`]+)`/g;
+        let match;
+        while ((match = signatureRe.exec(interfaceSection)) !== null) {
+            const sig = match[1];
+            const name = sig.split('(')[0].split(':')[0].trim();
+            if (name) {
+                exports.push({
+                    name,
+                    kind: sig.includes('(') ? 'function' : 'const',
+                    signature: sig,
+                    startLine: 1,
+                    endLine: 1,
+                    isDefault: false,
+                });
+            }
+        }
+    }
+    return {
+        filePath: 'reconstructed.ts',
+        language: 'typescript',
+        loc: 1,
+        exports,
+        imports: [],
+        hash: '0'.repeat(64),
+        analyzedAt: new Date().toISOString(),
+        parserUsed: 'reconstructed',
+    };
+}
+/**
+ * 从 Markdown 中提取指定章节内容
+ */
+function extractSection(markdown, sectionTitle) {
+    // 匹配 ## 或 # 级别的章节标题
+    const re = new RegExp(`^#{1,3}\\s+${sectionTitle}\\s*$`, 'm');
+    const match = re.exec(markdown);
+    if (!match)
+        return null;
+    const startIdx = match.index + match[0].length;
+    // 找到下一个同级或更高级标题
+    const nextSection = /^#{1,3}\s+/m.exec(markdown.slice(startIdx));
+    const endIdx = nextSection ? startIdx + nextSection.index : markdown.length;
+    return markdown.slice(startIdx, endIdx).trim();
+}
+// ============================================================
+// 漂移检测编排
+// ============================================================
+/**
+ * 端到端漂移检测编排器
+ *
+ * @param specPath - 现有 spec 文件路径
+ * @param sourcePath - 当前源代码文件或目录路径
+ * @param options - 漂移检测选项
+ * @returns 完整的 DriftReport
+ */
+export async function detectDrift(specPath, sourcePath, options = {}) {
+    const { skipSemantic = false, outputDir = 'drift-logs' } = options;
+    // 步骤 1：从 spec 加载基线骨架
+    const specContent = fs.readFileSync(specPath, 'utf-8');
+    const baselineSkeleton = loadBaselineSkeleton(specContent);
+    // 提取 spec 版本
+    const versionMatch = /^version:\s*(.+)$/m.exec(specContent);
+    const specVersion = versionMatch?.[1]?.trim() ?? 'v1';
+    // 步骤 2：对当前源代码进行 AST 分析
+    const currentSkeleton = await buildCurrentSkeleton(sourcePath);
+    // 步骤 3：结构差异
+    const rawItems = compareSkeletons(baselineSkeleton, currentSkeleton);
+    // 步骤 4：噪声过滤
+    const oldContent = serializeSkeleton(baselineSkeleton);
+    const newContent = serializeSkeleton(currentSkeleton);
+    const { substantive, filtered: filteredNoise } = filterNoise(rawItems, oldContent, newContent, currentSkeleton.language);
+    // 步骤 5：语义差异（可选）
+    let allItems = [...substantive];
+    if (!skipSemantic) {
+        // 对签名未变但函数体可能变更的情况进行语义评估
+        const specDescription = extractSection(specContent, '业务逻辑') ?? '';
+        for (const exp of currentSkeleton.exports) {
+            const oldExp = baselineSkeleton.exports.find((e) => e.name === exp.name);
+            if (oldExp && oldExp.signature === exp.signature) {
+                // 签名相同但可能函数体变更 — 委托 LLM
+                try {
+                    const semanticResult = await evaluateBehaviorChange(oldExp.signature, exp.signature, specDescription, currentSkeleton.language);
+                    if (semanticResult) {
+                        allItems.push(semanticResult);
+                    }
+                }
+                catch {
+                    // LLM 不可用时跳过语义检测
+                }
+            }
+        }
+    }
+    // 步骤 6：组装 DriftReport
+    const summary = {
+        totalChanges: allItems.length,
+        high: allItems.filter((i) => i.severity === 'HIGH').length,
+        medium: allItems.filter((i) => i.severity === 'MEDIUM').length,
+        low: allItems.filter((i) => i.severity === 'LOW').length,
+        additions: allItems.filter((i) => i.changeType === 'addition').length,
+        removals: allItems.filter((i) => i.changeType === 'removal').length,
+        modifications: allItems.filter((i) => i.changeType === 'modification').length,
+    };
+    const recommendation = generateRecommendation(summary);
+    // 步骤 7：确定输出路径
+    const moduleName = path.basename(specPath, '.spec.md');
+    const dateStr = new Date().toISOString().slice(0, 10);
+    const outputPath = path.join(outputDir, `${moduleName}-drift-${dateStr}.md`);
+    const report = {
+        specPath,
+        sourcePath,
+        generatedAt: new Date().toISOString(),
+        specVersion,
+        summary,
+        items: allItems,
+        filteredNoise,
+        recommendation,
+        outputPath,
+    };
+    // 步骤 8：渲染并写入漂移报告
+    try {
+        initRenderer();
+        const rendered = renderDriftReport(report);
+        // 确保输出目录存在
+        fs.mkdirSync(outputDir, { recursive: true });
+        fs.writeFileSync(outputPath, rendered, 'utf-8');
+    }
+    catch {
+        // 渲染失败不阻塞报告返回
+    }
+    return report;
+}
+// ============================================================
+// 辅助函数
+// ============================================================
+/**
+ * 构建当前源代码的骨架
+ */
+async function buildCurrentSkeleton(sourcePath) {
+    const stat = fs.statSync(sourcePath);
+    if (stat.isFile()) {
+        return analyzeFile(sourcePath);
+    }
+    // 目录：扫描所有文件并合并骨架
+    const { files } = await scanFiles(sourcePath);
+    if (files.length === 0) {
+        return {
+            filePath: sourcePath.endsWith('.ts') ? sourcePath : `${sourcePath}/index.ts`,
+            language: 'typescript',
+            loc: 0,
+            exports: [],
+            imports: [],
+            hash: '0'.repeat(64),
+            analyzedAt: new Date().toISOString(),
+            parserUsed: 'ts-morph',
+        };
+    }
+    const absoluteFiles = files.map((f) => path.join(sourcePath, f));
+    const skeletons = await analyzeFiles(absoluteFiles);
+    // 合并所有骨架的导出和导入
+    const mergedExports = skeletons.flatMap((s) => s.exports);
+    const mergedImports = skeletons.flatMap((s) => s.imports);
+    const totalLoc = skeletons.reduce((sum, s) => sum + s.loc, 0);
+    return {
+        filePath: absoluteFiles[0],
+        language: 'typescript',
+        loc: totalLoc,
+        exports: mergedExports,
+        imports: mergedImports,
+        hash: skeletons[0]?.hash ?? '0'.repeat(64),
+        analyzedAt: new Date().toISOString(),
+        parserUsed: 'ts-morph',
+    };
+}
+/**
+ * 将骨架序列化为可比较的文本
+ */
+function serializeSkeleton(skeleton) {
+    return skeleton.exports
+        .map((e) => `${e.name}: ${e.signature}`)
+        .join('\n');
+}
+/**
+ * 基于漂移摘要生成建议
+ */
+function generateRecommendation(summary) {
+    if (summary.totalChanges === 0) {
+        return '未检测到漂移，规格与代码保持同步。';
+    }
+    const parts = [];
+    if (summary.high > 0) {
+        parts.push(`检测到 ${summary.high} 项高严重级别变更（Breaking Change），建议立即更新规格。`);
+    }
+    if (summary.medium > 0) {
+        parts.push(`检测到 ${summary.medium} 项中等严重级别变更，建议在下次迭代中更新规格。`);
+    }
+    if (summary.low > 0) {
+        parts.push(`检测到 ${summary.low} 项低严重级别变更，可选择性更新规格。`);
+    }
+    return parts.join(' ');
+}
+//# sourceMappingURL=drift-orchestrator.js.map

package/dist/diff/drift-orchestrator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"drift-orchestrator.js","sourceRoot":"","sources":["../../src/diff/drift-orchestrator.ts"],"names":[],"mappings":"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"}

package/dist/diff/noise-filter.d.ts

@@ -0,0 +1,27 @@
+/**
+ * 噪声过滤器
+ * 从漂移结果中移除非实质性变更（FR-021）
+ * 支持多语言注释和 import 模式（FR-026）
+ * 参见 contracts/diff-engine.md
+ */
+import type { DriftItem } from '../models/drift-item.js';
+import type { Language } from '../models/code-skeleton.js';
+export interface FilterResult {
+    /** 需要报告的有意义变更 */
+    substantive: DriftItem[];
+    /** 被移除的噪声项计数 */
+    filtered: number;
+    /** itemId → 过滤原因 */
+    filterReasons: Map<string, string>;
+}
+/**
+ * 从漂移结果中移除非实质性变更
+ *
+ * @param items - 原始漂移项
+ * @param oldContent - 旧版源代码
+ * @param newContent - 新版源代码
+ * @param language - 代码语言（可选，用于语言感知过滤）
+ * @returns 过滤结果
+ */
+export declare function filterNoise(items: DriftItem[], oldContent: string, newContent: string, language?: Language): FilterResult;
+//# sourceMappingURL=noise-filter.d.ts.map

package/dist/diff/noise-filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"noise-filter.d.ts","sourceRoot":"","sources":["../../src/diff/noise-filter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAE3D,MAAM,WAAW,YAAY;IAC3B,iBAAiB;IACjB,WAAW,EAAE,SAAS,EAAE,CAAC;IACzB,gBAAgB;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,oBAAoB;IACpB,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpC;AAwGD;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,SAAS,EAAE,EAClB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,QAAQ,CAAC,EAAE,QAAQ,GAClB,YAAY,CAqCd"}

package/dist/diff/noise-filter.js

@@ -0,0 +1,129 @@
+/**
+ * 移除代码中的注释（根据语言选择模式）
+ */
+function stripComments(text, language) {
+    let result = text;
+    // C 风格注释（JS/TS/Java/Go/Rust/Kotlin/C++/Swift）
+    const cStyleLanguages = new Set([
+        undefined, 'typescript', 'javascript', 'java', 'go', 'rust', 'kotlin', 'cpp', 'swift',
+    ]);
+    // Python/Ruby 使用 # 注释
+    const hashCommentLanguages = new Set(['python', 'ruby']);
+    if (cStyleLanguages.has(language)) {
+        result = result
+            .replace(/\/\/.*$/gm, '')
+            .replace(/\/\*[\s\S]*?\*\//g, '');
+    }
+    if (hashCommentLanguages.has(language)) {
+        // 移除 # 注释（但排除字符串内的 #，此处简化处理行首 #）
+        result = result.replace(/#.*$/gm, '');
+    }
+    return result;
+}
+/**
+ * 规范化文本用于比较（移除噪声差异）
+ *
+ * @param text - 待规范化的代码文本
+ * @param language - 代码语言（可选，影响注释和语法模式）
+ */
+function normalizeForComparison(text, language) {
+    let result = stripComments(text, language);
+    // 规范化空白
+    result = result.replace(/\s+/g, ' ');
+    // 语言特定的语法糖规范化
+    if (!language || language === 'typescript' || language === 'javascript') {
+        // JS/TS: 移除尾逗号和分号（ASI 等价）
+        result = result.replace(/,\s*([}\])])/g, '$1');
+        result = result.replace(/;/g, '');
+    }
+    else if (language === 'go') {
+        // Go: 移除尾逗号
+        result = result.replace(/,\s*([}\])])/g, '$1');
+    }
+    return result.trim();
+}
+/**
+ * 获取语言对应的 import 提取正则
+ */
+function getImportRegex(language) {
+    switch (language) {
+        case 'python':
+            // Python: import xxx 或 from xxx import yyy
+            return /(?:from\s+\S+\s+import\s+.+|import\s+\S+)/g;
+        case 'go':
+            // Go: import "xxx" 或 import (多行)
+            return /import\s+(?:"[^"]+"|[\w.]+)/g;
+        case 'java':
+        case 'kotlin':
+            // Java/Kotlin: import xxx.yyy.zzz
+            return /import\s+(?:static\s+)?[\w.]+\s*;?/g;
+        case 'rust':
+            // Rust: use xxx::yyy
+            return /use\s+[\w:]+(?:::\{[^}]+\})?/g;
+        default:
+            // JS/TS: import { xxx } from 'yyy'
+            return /import\s+(?:type\s+)?(?:\{[^}]+\}|[\w*]+)\s+from\s+['"][^'"]+['"]/g;
+    }
+}
+/**
+ * 检测是否仅为 import 重排序
+ *
+ * @param oldValue - 旧代码片段
+ * @param newValue - 新代码片段
+ * @param language - 代码语言（可选）
+ */
+function isImportReorder(oldValue, newValue, language) {
+    if (!oldValue || !newValue)
+        return false;
+    const importRe = getImportRegex(language);
+    // 每次调用需新建正则实例（避免 /g 状态问题）
+    const oldImports = (oldValue.match(new RegExp(importRe.source, importRe.flags)) ?? []).sort();
+    const newImports = (newValue.match(new RegExp(importRe.source, importRe.flags)) ?? []).sort();
+    if (oldImports.length === 0 || newImports.length === 0)
+        return false;
+    return oldImports.length === newImports.length &&
+        oldImports.every((imp, i) => imp === newImports[i]);
+}
+/**
+ * 从漂移结果中移除非实质性变更
+ *
+ * @param items - 原始漂移项
+ * @param oldContent - 旧版源代码
+ * @param newContent - 新版源代码
+ * @param language - 代码语言（可选，用于语言感知过滤）
+ * @returns 过滤结果
+ */
+export function filterNoise(items, oldContent, newContent, language) {
+    const substantive = [];
+    const filterReasons = new Map();
+    for (const item of items) {
+        let isNoise = false;
+        let reason = '';
+        // 规则 1：仅空白字符变更
+        if (item.oldValue && item.newValue) {
+            const normalizedOld = normalizeForComparison(item.oldValue, language);
+            const normalizedNew = normalizeForComparison(item.newValue, language);
+            if (normalizedOld === normalizedNew) {
+                isNoise = true;
+                reason = '仅空白/注释/分号/尾逗号变更';
+            }
+        }
+        // 规则 2：import 重排序
+        if (!isNoise && isImportReorder(item.oldValue ?? null, item.newValue ?? null, language)) {
+            isNoise = true;
+            reason = 'import 重排序（相同 import，不同顺序）';
+        }
+        if (isNoise) {
+            filterReasons.set(item.id, reason);
+        }
+        else {
+            substantive.push(item);
+        }
+    }
+    return {
+        substantive,
+        filtered: filterReasons.size,
+        filterReasons,
+    };
+}
+//# sourceMappingURL=noise-filter.js.map

package/dist/diff/noise-filter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"noise-filter.js","sourceRoot":"","sources":["../../src/diff/noise-filter.ts"],"names":[],"mappings":"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"}

package/dist/diff/semantic-diff.d.ts

@@ -0,0 +1,12 @@
+import type { DriftItem } from '../models/drift-item.js';
+/**
+ * 委托 LLM 评估函数体变更是否导致行为漂移
+ *
+ * @param oldCode - 之前的函数体
+ * @param newCode - 当前的函数体
+ * @param specDescription - 规格中的相关描述
+ * @param language - 代码语言（默认 'typescript'）
+ * @returns DriftItem（如检测到漂移），否则 null
+ */
+export declare function evaluateBehaviorChange(oldCode: string, newCode: string, specDescription: string, language?: string): Promise<DriftItem | null>;
+//# sourceMappingURL=semantic-diff.d.ts.map

package/dist/diff/semantic-diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic-diff.d.ts","sourceRoot":"","sources":["../../src/diff/semantic-diff.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAGzD;;;;;;;;GAQG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,eAAe,EAAE,MAAM,EACvB,QAAQ,SAAe,GACtB,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CA+E3B"}

package/dist/diff/semantic-diff.js

@@ -0,0 +1,94 @@
+/**
+ * 基于 LLM 的语义 Diff
+ * 评估函数体变更是否违反规格中声明的意图（FR-020）
+ * 参见 contracts/diff-engine.md
+ */
+import { callLLM, buildSystemPrompt } from '../core/llm-client.js';
+import { assembleContext } from '../core/context-assembler.js';
+/**
+ * 委托 LLM 评估函数体变更是否导致行为漂移
+ *
+ * @param oldCode - 之前的函数体
+ * @param newCode - 当前的函数体
+ * @param specDescription - 规格中的相关描述
+ * @param language - 代码语言（默认 'typescript'）
+ * @returns DriftItem（如检测到漂移），否则 null
+ */
+export async function evaluateBehaviorChange(oldCode, newCode, specDescription, language = 'typescript') {
+    const prompt = `请评估以下代码变更是否导致了行为漂移。
+
+## 旧代码
+\`\`\`${language}
+${oldCode}
+\`\`\`
+
+## 新代码
+\`\`\`${language}
+${newCode}
+\`\`\`
+
+## 规格描述
+${specDescription}
+
+## 输出要求
+如果代码变更改变了外部可观察行为，请回复以下 JSON：
+\`\`\`json
+{
+  "hasDrift": true,
+  "severity": "MEDIUM",
+  "description": "变更描述",
+  "proposedUpdate": "建议的规格更新"
+}
+\`\`\`
+
+如果变更不影响外部行为（仅内部优化），请回复：
+\`\`\`json
+{
+  "hasDrift": false
+}
+\`\`\``;
+    // 构建一个简单的骨架用于 assembleContext
+    const skeleton = {
+        filePath: 'semantic-diff-context',
+        language: language,
+        loc: prompt.split('\n').length,
+        exports: [],
+        imports: [],
+        hash: '0'.repeat(64),
+        analyzedAt: new Date().toISOString(),
+        parserUsed: 'ts-morph',
+    };
+    const systemPrompt = buildSystemPrompt('semantic-diff');
+    const context = await assembleContext(skeleton, {
+        templateInstructions: systemPrompt,
+        codeSnippets: [prompt],
+    });
+    try {
+        const response = await callLLM(context);
+        // 解析 LLM 响应中的 JSON
+        const jsonMatch = /```json\s*([\s\S]*?)\s*```/.exec(response.content);
+        if (!jsonMatch?.[1])
+            return null;
+        const parsed = JSON.parse(jsonMatch[1]);
+        if (!parsed.hasDrift)
+            return null;
+        return {
+            id: `semantic-${Date.now()}`,
+            severity: parsed.severity ?? 'MEDIUM',
+            category: 'Behavior',
+            changeType: 'modification',
+            location: 'semantic-diff',
+            symbolName: null,
+            description: parsed.description ?? '检测到行为漂移',
+            oldValue: oldCode.slice(0, 200),
+            newValue: newCode.slice(0, 200),
+            proposedUpdate: parsed.proposedUpdate ?? '请审查规格描述',
+            detectedBy: 'semantic',
+        };
+    }
+    catch {
+        // LLM 不可用时返回 null（不阻塞漂移检测）
+        return null;
+    }
+}
+//# sourceMappingURL=semantic-diff.js.map

package/dist/diff/semantic-diff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic-diff.js","sourceRoot":"","sources":["../../src/diff/semantic-diff.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,OAAO,EAAE,iBAAiB,EAAkB,MAAM,uBAAuB,CAAC;AACnF,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAI/D;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,OAAe,EACf,OAAe,EACf,eAAuB,EACvB,QAAQ,GAAG,YAAY;IAEvB,MAAM,MAAM,GAAG;;;QAGT,QAAQ;EACd,OAAO;;;;QAID,QAAQ;EACd,OAAO;;;;EAIP,eAAe;;;;;;;;;;;;;;;;;;OAkBV,CAAC;IAEN,8BAA8B;IAC9B,MAAM,QAAQ,GAAiB;QAC7B,QAAQ,EAAE,uBAAuB;QACjC,QAAQ,EAAE,QAAoC;QAC9C,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM;QAC9B,OAAO,EAAE,EAAE;QACX,OAAO,EAAE,EAAE;QACX,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;QACpB,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACpC,UAAU,EAAE,UAAU;KACvB,CAAC;IAEF,MAAM,YAAY,GAAG,iBAAiB,CAAC,eAAe,CAAC,CAAC;IACxD,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC,QAAQ,EAAE;QAC9C,oBAAoB,EAAE,YAAY;QAClC,YAAY,EAAE,CAAC,MAAM,CAAC;KACvB,CAAC,CAAC;IAEH,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;QAExC,mBAAmB;QACnB,MAAM,SAAS,GAAG,4BAA4B,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QACtE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;YAAE,OAAO,IAAI,CAAC;QAEjC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;QACxC,IAAI,CAAC,MAAM,CAAC,QAAQ;YAAE,OAAO,IAAI,CAAC;QAElC,OAAO;YACL,EAAE,EAAE,YAAY,IAAI,CAAC,GAAG,EAAE,EAAE;YAC5B,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,QAAQ;YACrC,QAAQ,EAAE,UAAU;YACpB,UAAU,EAAE,cAAc;YAC1B,QAAQ,EAAE,eAAe;YACzB,UAAU,EAAE,IAAI;YAChB,WAAW,EAAE,MAAM,CAAC,WAAW,IAAI,SAAS;YAC5C,QAAQ,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;YAC/B,QAAQ,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;YAC/B,cAAc,EAAE,MAAM,CAAC,cAAc,IAAI,SAAS;YAClD,UAAU,EAAE,UAAU;SACvB,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,2BAA2B;QAC3B,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/diff/structural-diff.d.ts

@@ -0,0 +1,16 @@
+/**
+ * 结构化 Diff 引擎
+ * 比较两个 CodeSkeleton，按严重级别分类差异（FR-019）
+ * 参见 contracts/diff-engine.md
+ */
+import type { CodeSkeleton } from '../models/code-skeleton.js';
+import type { DriftItem } from '../models/drift-item.js';
+/**
+ * 比较两个 CodeSkeleton，识别导出符号中的结构差异
+ *
+ * @param oldSkeleton - 基线骨架（spec 生成时）
+ * @param newSkeleton - 当前源代码骨架
+ * @returns DriftItem[]
+ */
+export declare function compareSkeletons(oldSkeleton: CodeSkeleton, newSkeleton: CodeSkeleton): DriftItem[];
+//# sourceMappingURL=structural-diff.d.ts.map

package/dist/diff/structural-diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"structural-diff.d.ts","sourceRoot":"","sources":["../../src/diff/structural-diff.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,YAAY,EAAgB,MAAM,4BAA4B,CAAC;AAC7E,OAAO,KAAK,EAAE,SAAS,EAAuC,MAAM,yBAAyB,CAAC;AAQ9F;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,YAAY,EACzB,WAAW,EAAE,YAAY,GACxB,SAAS,EAAE,CA4Gb"}