soloforge 1.0.0 → 1.1.1

package/dist/engine/confidence_scorer.d.ts

@@ -1,4 +1,16 @@
 import type { FailureType } from "../types.js";
+/**
+ * 置信度评分器 — 基于多维加权模型评估任务执行结果的置信度。
+ *
+ * 评分维度（四维加权）：
+ * 1. 执行结果（权重 0.2）：首次成功 > 重试成功 > 失败
+ * 2. 可追溯性（权重 0.3）：是否有明确的根因
+ * 3. 可复用性（权重 0.2）：匹配到的已知模式数量（越多越好，上限 3 个）
+ * 4. 新颖性（权重 0.3）：是否匹配到已有模式（匹配到则置信度更高）
+ *
+ * 特殊规则：降级模式下，最终得分乘以 0.5 的惩罚系数。
+ */
+/** 置信度评分输入参数 */
 export interface ConfidenceInput {
     result: "success" | "failure";
     retryCount: number;
@@ -7,5 +19,14 @@ export interface ConfidenceInput {
     hasClearRootCause: boolean;
     isDegraded: boolean;
 }
+/**
+ * 计算任务执行结果的置信度得分。
+ *
+ * 加权模型：执行结果(0.2) + 可追溯性(0.3) + 可复用性(0.2) + 新颖性(0.3)
+ * 最终得分范围 [0, 1]，保留两位小数。降级模式下得分减半。
+ *
+ * @param input - 置信度评分输入参数
+ * @returns 置信度得分（0 到 1 之间的浮点数）
+ */
 export declare function scoreConfidence(input: ConfidenceInput): number;
 //# sourceMappingURL=confidence_scorer.d.ts.map

package/dist/engine/confidence_scorer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"confidence_scorer.d.ts","sourceRoot":"","sources":["../../src/engine/confidence_scorer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,SAAS,GAAG,SAAS,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CAkC9D"}
+{"version":3,"file":"confidence_scorer.d.ts","sourceRoot":"","sources":["../../src/engine/confidence_scorer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C;;;;;;;;;;GAUG;AAEH,gBAAgB;AAChB,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,SAAS,GAAG,SAAS,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,UAAU,EAAE,OAAO,CAAC;CACrB;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CAsC9D"}

package/dist/engine/confidence_scorer.js

@@ -1,27 +1,40 @@
+/**
+ * 计算任务执行结果的置信度得分。
+ *
+ * 加权模型：执行结果(0.2) + 可追溯性(0.3) + 可复用性(0.2) + 新颖性(0.3)
+ * 最终得分范围 [0, 1]，保留两位小数。降级模式下得分减半。
+ *
+ * @param input - 置信度评分输入参数
+ * @returns 置信度得分（0 到 1 之间的浮点数）
+ */
 export function scoreConfidence(input) {
     let score = 0;
     // 维度 1: 执行结果（权重 0.2）
+    // 首次成功得分最高(1.0)，每次重试递减，失败最低(0.1)
     const resultScore = {
-        success_first_try: 1.0,
-        success_retry1: 0.7,
-        success_retry2: 0.4,
-        failure: 0.1,
+        success_first_try: 1.0, // 首次即成功
+        success_retry1: 0.7, // 第 1 次重试后成功
+        success_retry2: 0.4, // 第 2 次重试后成功
+        failure: 0.1, // 最终失败
     };
     const resultKey = input.result === "success"
         ? (input.retryCount === 0 ? "success_first_try" : input.retryCount === 1 ? "success_retry1" : "success_retry2")
         : "failure";
     score += resultScore[resultKey] * 0.2;
     // 维度 2: 可追溯性（权重 0.3）
+    // 有明确根因 → 高分(1.0)；无根因 → 低分(0.3)
     const traceScore = input.hasClearRootCause ? 1.0 : 0.3;
     score += traceScore * 0.3;
     // 维度 3: 可复用性（权重 0.2）
+    // 已匹配的模式越多 → 可复用性越高，上限 3 个模式即为满分
     const reuseScore = Math.min(input.matchedPatternsCount / 3, 1.0);
     score += reuseScore * 0.2;
     // 维度 4: 新颖性（权重 0.3）
-    // 匹配到的模式越多 = 新颖性越低 = 置信度越高（强化已有模式）
+    // 匹配到已有模式 → 新颖性低 → 强化已有知识 → 高分(0.8)
+    // 无模式匹配 → 新问题 → 知识不确定性高 → 低分(0.4)
     const noveltyScore = input.matchedPatternsCount > 0 ? 0.8 : 0.4;
     score += noveltyScore * 0.3;
-    // 降级模式惩罚
+    // 降级模式惩罚：在受限条件下完成，结果可靠性降低
     if (input.isDegraded) {
         score *= 0.5;
     }

package/dist/engine/confidence_scorer.js.map

@@ -1 +1 @@
-{"version":3,"file":"confidence_scorer.js","sourceRoot":"","sources":["../../src/engine/confidence_scorer.ts"],"names":[],"mappings":"AAWA,MAAM,UAAU,eAAe,CAAC,KAAsB;IACpD,IAAI,KAAK,GAAG,CAAC,CAAC;IAEd,qBAAqB;IACrB,MAAM,WAAW,GAA2B;QAC1C,iBAAiB,EAAE,GAAG;QACtB,cAAc,EAAE,GAAG;QACnB,cAAc,EAAE,GAAG;QACnB,OAAO,EAAE,GAAG;KACb,CAAC;IACF,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,KAAK,SAAS;QAC1C,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,KAAK,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,KAAK,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,gBAAgB,CAAC;QAC/G,CAAC,CAAC,SAAS,CAAC;IACd,KAAK,IAAI,WAAW,CAAC,SAAS,CAAC,GAAG,GAAG,CAAC;IAEtC,qBAAqB;IACrB,MAAM,UAAU,GAAG,KAAK,CAAC,iBAAiB,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;IACvD,KAAK,IAAI,UAAU,GAAG,GAAG,CAAC;IAE1B,qBAAqB;IACrB,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,oBAAoB,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;IACjE,KAAK,IAAI,UAAU,GAAG,GAAG,CAAC;IAE1B,oBAAoB;IACpB,mCAAmC;IACnC,MAAM,YAAY,GAAG,KAAK,CAAC,oBAAoB,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;IAChE,KAAK,IAAI,YAAY,GAAG,GAAG,CAAC;IAE5B,SAAS;IACT,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;QACrB,KAAK,IAAI,GAAG,CAAC;IACf,CAAC;IAED,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;AACvC,CAAC"}
+{"version":3,"file":"confidence_scorer.js","sourceRoot":"","sources":["../../src/engine/confidence_scorer.ts"],"names":[],"mappings":"AAwBA;;;;;;;;GAQG;AACH,MAAM,UAAU,eAAe,CAAC,KAAsB;IACpD,IAAI,KAAK,GAAG,CAAC,CAAC;IAEd,qBAAqB;IACrB,iCAAiC;IACjC,MAAM,WAAW,GAA2B;QAC1C,iBAAiB,EAAE,GAAG,EAAI,QAAQ;QAClC,cAAc,EAAE,GAAG,EAAO,aAAa;QACvC,cAAc,EAAE,GAAG,EAAO,aAAa;QACvC,OAAO,EAAE,GAAG,EAAc,OAAO;KAClC,CAAC;IACF,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,KAAK,SAAS;QAC1C,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,KAAK,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,KAAK,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,gBAAgB,CAAC;QAC/G,CAAC,CAAC,SAAS,CAAC;IACd,KAAK,IAAI,WAAW,CAAC,SAAS,CAAC,GAAG,GAAG,CAAC;IAEtC,qBAAqB;IACrB,gCAAgC;IAChC,MAAM,UAAU,GAAG,KAAK,CAAC,iBAAiB,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;IACvD,KAAK,IAAI,UAAU,GAAG,GAAG,CAAC;IAE1B,qBAAqB;IACrB,iCAAiC;IACjC,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,oBAAoB,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;IACjE,KAAK,IAAI,UAAU,GAAG,GAAG,CAAC;IAE1B,oBAAoB;IACpB,oCAAoC;IACpC,kCAAkC;IAClC,MAAM,YAAY,GAAG,KAAK,CAAC,oBAAoB,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;IAChE,KAAK,IAAI,YAAY,GAAG,GAAG,CAAC;IAE5B,0BAA0B;IAC1B,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;QACrB,KAAK,IAAI,GAAG,CAAC;IACf,CAAC;IAED,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;AACvC,CAAC"}

package/dist/engine/contract_guard.d.ts

@@ -1,10 +1,33 @@
 import type { ProjectConfig, ContractCheckResult } from "../types.js";
 import type { GitOperations } from "./git_deps.js";
+/**
+ * 契约守卫 — 检测代码变更中的 API 契约破坏性变更。
+ *
+ * 通过解析 Git diff，识别以下类型的契约变更：
+ * - API 端点的新增/删除（Spring MVC 注解、Express 路由）
+ * - HTTP 方法的变更（同一路径上方法改变）
+ * - DTO/Entity 字段的新增/删除/类型变更（Java 和 TypeScript）
+ * - 跨服务影响分析（多仓库场景下评估对前端的冲击）
+ */
+/** 契约守卫输入参数 */
 export interface ContractGuardInput {
     changedFiles: string[];
     projectPath: string;
     config: ProjectConfig;
     gitOps: GitOperations;
 }
+/**
+ * 检测变更文件中的 API 契约变更。
+ *
+ * 处理流程：
+ * 1. 筛选出与 API 契约相关的文件
+ * 2. 获取每个文件的 Git diff
+ * 3. 解析 diff 中的端点变更和字段变更
+ * 4. 后处理：将同一路径的删除+新增配对为方法变更
+ * 5. 评估跨服务影响并生成摘要
+ *
+ * @param input - 契约检查输入，包含变更文件列表、项目路径、配置和 Git 操作接口
+ * @returns 契约检查结果，包含变更列表、破坏性/兼容性变更计数和跨服务影响
+ */
 export declare function checkContractChanges(input: ContractGuardInput): Promise<ContractCheckResult>;
 //# sourceMappingURL=contract_guard.d.ts.map

package/dist/engine/contract_guard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"contract_guard.d.ts","sourceRoot":"","sources":["../../src/engine/contract_guard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EAEb,mBAAmB,EACpB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAInD,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,aAAa,CAAC;IACtB,MAAM,EAAE,aAAa,CAAC;CACvB;AAkBD,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,kBAAkB,GACxB,OAAO,CAAC,mBAAmB,CAAC,CA6D9B"}
+{"version":3,"file":"contract_guard.d.ts","sourceRoot":"","sources":["../../src/engine/contract_guard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EAEb,mBAAmB,EACpB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD;;;;;;;;GAQG;AAEH,eAAe;AACf,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,aAAa,CAAC;IACtB,MAAM,EAAE,aAAa,CAAC;CACvB;AAkBD;;;;;;;;;;;;GAYG;AACH,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,kBAAkB,GACxB,OAAO,CAAC,mBAAmB,CAAC,CA6D9B"}

package/dist/engine/contract_guard.js

@@ -1,4 +1,7 @@
-// ── API contract file path keywords ──
+/**
+ * API 契约文件路径关键词。
+ * 文件路径（小写）包含这些关键词的，被视为 API 契约相关文件，需要进行 diff 解析。
+ */
 const API_PATH_KEYWORDS = [
     "controller",
     "route",
@@ -10,16 +13,28 @@ const API_PATH_KEYWORDS = [
     "entity",
     "schema",
 ];
-// ── Main function ──
+/**
+ * 检测变更文件中的 API 契约变更。
+ *
+ * 处理流程：
+ * 1. 筛选出与 API 契约相关的文件
+ * 2. 获取每个文件的 Git diff
+ * 3. 解析 diff 中的端点变更和字段变更
+ * 4. 后处理：将同一路径的删除+新增配对为方法变更
+ * 5. 评估跨服务影响并生成摘要
+ *
+ * @param input - 契约检查输入，包含变更文件列表、项目路径、配置和 Git 操作接口
+ * @returns 契约检查结果，包含变更列表、破坏性/兼容性变更计数和跨服务影响
+ */
 export async function checkContractChanges(input) {
     const { changedFiles, projectPath, config, gitOps } = input;
     const changes = [];
-    // Filter to API-contract-relevant files
+    // 筛选出 API 契约相关文件（controller、dto、route 等）
     const contractFiles = changedFiles.filter((f) => isApiContractFile(f));
     if (contractFiles.length === 0) {
         return emptyResult("No API contract files changed.");
     }
-    // Collect diffs for each contract file
+    // 收集每个契约文件的 diff 内容（仅暂存区的变更）
     const diffs = [];
     for (const file of contractFiles) {
         try {
@@ -37,15 +52,15 @@ export async function checkContractChanges(input) {
     if (diffs.length === 0) {
         return emptyResult("No diff content found in API contract files.");
     }
-    // Parse each diff for contract changes
+    // 解析每个 diff 中的契约变更（端点变更、字段变更等）
     for (const { file, diff } of diffs) {
         const parsed = parseDiffForContractChanges(file, diff);
         changes.push(...parsed);
     }
-    // Tally
+    // 统计破坏性变更和兼容性变更
     const breaking = changes.filter((c) => c.severity === "breaking");
     const compatible = changes.filter((c) => c.severity === "compatible");
-    // Cross-service impact analysis
+    // 跨服务影响分析（仅在多仓库场景下有意义）
     const crossServiceImpact = analyzeCrossServiceImpact(breaking, config);
     const summary = buildSummary(changes.length, breaking.length, compatible.length, crossServiceImpact);
     return {
@@ -57,39 +72,58 @@ export async function checkContractChanges(input) {
         summary,
     };
 }
-// ── File classification ──
+/**
+ * 判断文件是否为 API 契约相关文件。
+ * 通过路径关键词匹配，覆盖 controller、route、dto、schema 等类型。
+ * @param filePath - 文件路径
+ * @returns true 表示该文件属于 API 契约文件
+ */
 function isApiContractFile(filePath) {
     const lower = filePath.toLowerCase();
     return API_PATH_KEYWORDS.some((kw) => lower.includes(kw));
 }
-// ── Diff parsing ──
+/**
+ * 解析 Git diff 内容，识别其中的 API 契约变更。
+ *
+ * 解析策略（按优先级）：
+ * 1. Spring MVC 注解变更（@GetMapping、@PostMapping 等）
+ * 2. Express 路由变更（router.get()、router.post() 等）
+ * 3. DTO/Entity 字段变更（Java 和 TypeScript 字段定义）
+ *
+ * 后处理步骤：将同一路径的 path_removed + path_added 配对为 method_changed。
+ *
+ * @param file - 文件路径
+ * @param diff - Git diff 文本
+ * @returns 契约变更列表
+ */
 function parseDiffForContractChanges(file, diff) {
     const changes = [];
     const lines = diff.split("\n");
+    // 已消费的行索引集合，防止同一行被多个规则重复匹配
     const consumedIndices = new Set();
     for (let i = 0; i < lines.length; i++) {
         if (consumedIndices.has(i))
             continue;
         const line = lines[i];
-        // Only look at added/removed lines (skip diff metadata headers)
+        // 仅处理新增行（+）和删除行（-），跳过 diff 元数据行（+++、---）
         const isAdded = line.startsWith("+") && !line.startsWith("+++");
         const isRemoved = line.startsWith("-") && !line.startsWith("---");
         if (!isAdded && !isRemoved)
             continue;
-        const content = line.slice(1); // strip leading +/- (and the space)
-        // Spring MVC annotations
+        const content = line.slice(1); // 去掉行首的 +/- 和空格，获取实际内容
+        // 检测 1: Spring MVC 注解变更
         const springChange = detectSpringAnnotationChange(content, isAdded, isRemoved, file);
         if (springChange) {
             changes.push(springChange);
             continue;
         }
-        // Express route definitions
+        // 检测 2: Express 路由变更
         const expressChange = detectExpressRouteChange(content, isAdded, isRemoved, file);
         if (expressChange) {
             changes.push(expressChange);
             continue;
         }
-        // DTO/Entity field changes
+        // 检测 3: DTO/Entity 字段变更
         const fieldChange = detectFieldChange(content, isAdded, isRemoved, file, lines, i, consumedIndices);
         if (fieldChange) {
             changes.push(fieldChange);
@@ -99,17 +133,23 @@ function parseDiffForContractChanges(file, diff) {
             }
         }
     }
-    // Post-process: detect HTTP method changes on same path
-    // Pair path_removed + path_added with the same URL path into method_changed
+    // 后处理：检测同一路径上的 HTTP 方法变更
+    // 将 path_removed + path_added 中 URL 路径相同的配对为 method_changed（破坏性变更）
     const methodChanged = detectMethodChanges(changes);
     return methodChanged;
 }
-// ── HTTP method change detection ──
+/**
+ * 检测 HTTP 方法变更。
+ * 将同一路径的 path_removed 和 path_added 配对，
+ * 如果 HTTP 方法不同则合并为一个 method_changed 变更。
+ * @param changes - 原始契约变更列表
+ * @returns 合并后的契约变更列表（method_changed + 未消费的原始变更）
+ */
 function detectMethodChanges(changes) {
     const removed = new Map();
     const added = new Map();
     const consumed = new Set();
-    // Index removed and added path changes by their URL path
+    // 按 URL 路径建立索引，用于快速配对删除和新增的端点
     for (let i = 0; i < changes.length; i++) {
         const change = changes[i];
         if (change.change_type === "path_removed") {
@@ -123,7 +163,7 @@ function detectMethodChanges(changes) {
                 added.set(pathStr, change);
         }
     }
-    // Find matching pairs (same URL path, different HTTP method)
+    // 查找匹配对：同一 URL 路径但不同 HTTP 方法的删除+新增
     const result = [];
     for (const [urlPath, removedChange] of removed) {
         const addedChange = added.get(urlPath);
@@ -153,29 +193,50 @@ function detectMethodChanges(changes) {
     }
     return result;
 }
+/**
+ * 从端点描述字符串中提取 URL 路径。
+ * 支持格式如 "GetMapping /api/v1/users" 或 "GET /api/v1/users"。
+ * @param endpointStr - 端点描述字符串
+ * @returns 提取到的 URL 路径，匹配失败返回 null
+ */
 function extractPath(endpointStr) {
-    // Extract URL path from strings like "GetMapping /api/v1/users" or "GET /api/v1/users"
+    // 匹配以 / 开头的路径，支持字母、数字、连字符、花括号（路径参数）、点和斜杠
     const match = endpointStr.match(/\/[\w\-{}./]+/);
     return match ? match[0] : null;
 }
+/**
+ * 从端点描述字符串中提取 HTTP 方法。
+ * 支持 Spring 注解风格（GetMapping）和标准 HTTP 方法风格（GET）。
+ * @param endpointStr - 端点描述字符串
+ * @returns HTTP 方法字符串，匹配失败返回 null
+ */
 function extractHttpMethod(endpointStr) {
-    // Extract HTTP method from strings like "GetMapping /api/v1/users" or "GET /api/v1/users"
+    // 匹配 Spring 注解风格的方法名（如 GetMapping、PostMapping）
     const match = endpointStr.match(/^(Get|Post|Put|Delete|Patch|Mapping)\w*\s/i);
     if (match) {
         const raw = match[1].toUpperCase();
-        // Map Spring annotation names to HTTP methods
+        // 将 Spring 注解名映射为标准 HTTP 方法
         const methodMap = {
             GET: "GET", POST: "POST", PUT: "PUT", DELETE: "DELETE", PATCH: "PATCH",
-            REQUESTMAPPING: "REQUEST",
+            REQUESTMAPPING: "REQUEST", // 通用映射，不区分方法
         };
         return methodMap[raw] ?? raw;
     }
-    // Try uppercase HTTP method
+    // 回退：匹配标准大写 HTTP 方法（如 GET、POST）
     const httpMatch = endpointStr.match(/^(GET|POST|PUT|DELETE|PATCH)\s/);
     return httpMatch ? httpMatch[1] : null;
 }
-// ── Spring annotation detection ──
+/**
+ * 检测 Spring MVC 注解变更。
+ * 匹配 @GetMapping、@PostMapping、@PutMapping、@DeleteMapping、@RequestMapping。
+ * @param content - diff 行内容（已去除 +/- 前缀）
+ * @param isAdded - 是否为新增行
+ * @param isRemoved - 是否为删除行
+ * @param file - 文件路径
+ * @returns 契约变更对象，未匹配返回 null
+ */
 function detectSpringAnnotationChange(content, isAdded, isRemoved, file) {
+    // Spring MVC 注解正则：匹配 @XxxMapping(value="/path") 或 @XxxMapping("/path") 形式
     const springAnnotationRe = /^\s*@(?<method>RequestMapping|GetMapping|PostMapping|PutMapping|DeleteMapping)\s*\(?\s*(?:value\s*=\s*)?["'`](?<path>\/[^"'`]*)["'`]/;
     const match = content.match(springAnnotationRe);
     if (!match)
@@ -202,8 +263,17 @@ function detectSpringAnnotationChange(content, isAdded, isRemoved, file) {
     }
     return null;
 }
-// ── Express route detection ──
+/**
+ * 检测 Express 路由变更。
+ * 匹配 router.get()、router.post()、router.put()、router.delete()、router.patch() 形式。
+ * @param content - diff 行内容（已去除 +/- 前缀）
+ * @param isAdded - 是否为新增行
+ * @param isRemoved - 是否为删除行
+ * @param file - 文件路径
+ * @returns 契约变更对象，未匹配返回 null
+ */
 function detectExpressRouteChange(content, isAdded, isRemoved, file) {
+    // Express 路由正则：匹配 router.method('/path') 形式
     const expressRouteRe = /router\.(?<method>get|post|put|delete|patch)\s*\(\s*['"`](?<path>\/[^'"`]*)['"`]/;
     const match = content.match(expressRouteRe);
     if (!match)
@@ -230,11 +300,23 @@ function detectExpressRouteChange(content, isAdded, isRemoved, file) {
     }
     return null;
 }
-// ── Field change detection ──
+/**
+ * 检测 DTO/Entity 字段变更。
+ * 支持 Java 字段声明（private Type name）和 TypeScript 字段声明（name: Type）。
+ * 当同一字段名出现删除和新增时，会尝试识别为类型变更。
+ * @param content - diff 行内容（已去除 +/- 前缀）
+ * @param isAdded - 是否为新增行
+ * @param isRemoved - 是否为删除行
+ * @param file - 文件路径
+ * @param lines - diff 全部行（用于向前/向后查找关联行）
+ * @param currentIndex - 当前行索引
+ * @param consumedIndices - 已消费行索引集合（用于避免重复匹配）
+ * @returns 契约变更对象，未匹配返回 null
+ */
 function detectFieldChange(content, isAdded, isRemoved, file, lines, currentIndex, consumedIndices) {
-    // Java: private Type fieldName;
+    // Java 字段正则：匹配 private/protected/public Type fieldName 形式
     const javaFieldRe = /^\s*(private|protected|public)\s+(?<type>[\w<>[\]]+)\s+(?<name>\w+)/;
-    // TypeScript: fieldName: Type; or fieldName?: Type;
+    // TypeScript 字段正则：匹配 fieldName: Type 或 fieldName?: Type 形式
     const tsFieldRe = /^\s*(?<name>\w+)\s*(?<optional>\??):\s*(?<type>[\w<>[\]|.]+)\s*[;=]?/;
     const javaMatch = content.match(javaFieldRe);
     const tsMatch = !javaMatch ? content.match(tsFieldRe) : null;
@@ -242,7 +324,7 @@ function detectFieldChange(content, isAdded, isRemoved, file, lines, currentInde
         const { type, name } = javaMatch.groups;
         const fieldName = `${name}: ${type}`;
         if (isAdded) {
-            // Check if there's a preceding - line with the same field name (type change detection)
+            // 尝试在同一字段名下查找关联的删除行，检测类型变更
             const typeChange = detectTypeChangeForField(name, lines, currentIndex, consumedIndices);
             if (typeChange) {
                 return {
@@ -263,7 +345,7 @@ function detectFieldChange(content, isAdded, isRemoved, file, lines, currentInde
             };
         }
         if (isRemoved) {
-            // Check if the next line is a similar field addition (type change detection)
+            // 尝试在同一字段名下查找关联的新增行，检测类型变更
             const typeChange = detectTypeChangeForField(name, lines, currentIndex, consumedIndices);
             if (typeChange) {
                 return {
@@ -289,7 +371,7 @@ function detectFieldChange(content, isAdded, isRemoved, file, lines, currentInde
         const optional = tsMatch.groups.optional === "?";
         const fieldName = `${name}${optional ? "?" : ""}: ${type}`;
         if (isAdded) {
-            // Check if there's a preceding - line with the same field name (type change detection)
+            // 尝试在同一字段名下查找关联的删除行，检测类型变更
             const typeChange = detectTypeChangeForField(name, lines, currentIndex, consumedIndices);
             if (typeChange) {
                 return {
@@ -332,7 +414,16 @@ function detectFieldChange(content, isAdded, isRemoved, file, lines, currentInde
     }
     return null;
 }
-// ── Type change detection (adjacent -/+ lines with same field name) ──
+/**
+ * 检测字段的类型变更。
+ * 在 diff 的相邻行中查找同名字段但类型不同的删除/新增行对。
+ * 搜索范围限制为前后各 5 行，避免误匹配距离太远的无关行。
+ * @param fieldName - 字段名称
+ * @param lines - diff 全部行
+ * @param currentIndex - 当前行索引
+ * @param consumedIndices - 已消费行索引集合
+ * @returns 类型变更信息（变更前后的类型字符串），未检测到返回 null
+ */
 function detectTypeChangeForField(fieldName, lines, currentIndex, consumedIndices) {
     const javaRe = /^\s*(private|protected|public)\s+(?<type>[\w<>[\]]+)\s+(?<name>\w+)/;
     const tsRe = /^\s*(?<name>\w+)\s*(?<optional>\??):\s*(?<type>[\w<>[\]|.]+)\s*[;=]?/;
@@ -357,9 +448,9 @@ function detectTypeChangeForField(fieldName, lines, currentIndex, consumedIndice
     function getCurrentTypeInfo() {
         return extractTypeInfo(currentIndex);
     }
-    const maxLook = 5;
+    const maxLook = 5; // 最大向前/向后查找行数
     if (isRemoved) {
-        // Look ahead for a + line with the same field name but different type
+        // 删除行：向前查找同名字段的新增行（- 行后面紧跟 + 行）
         for (let j = currentIndex + 1; j < Math.min(currentIndex + maxLook, lines.length); j++) {
             if (consumedIndices.has(j))
                 continue;
@@ -372,7 +463,7 @@ function detectTypeChangeForField(fieldName, lines, currentIndex, consumedIndice
                 }
             }
         }
-        // Also look backward for a + line (when - comes after + in the diff)
+        // 也在后方查找（diff 中 - 行出现在 + 行之后的情况）
         for (let j = currentIndex - 1; j >= Math.max(0, currentIndex - maxLook); j--) {
             if (consumedIndices.has(j))
                 continue;
@@ -387,7 +478,7 @@ function detectTypeChangeForField(fieldName, lines, currentIndex, consumedIndice
         }
     }
     if (isAdded) {
-        // Look backward for a - line with the same field name but different type
+        // 新增行：向后查找同名字段的删除行（+ 行前面是 - 行）
         for (let j = currentIndex - 1; j >= Math.max(0, currentIndex - maxLook); j--) {
             if (consumedIndices.has(j))
                 continue;
@@ -400,7 +491,7 @@ function detectTypeChangeForField(fieldName, lines, currentIndex, consumedIndice
                 }
             }
         }
-        // Also look forward for a - line (when + comes before - in the diff)
+        // 也在前方查找（diff 中 + 行出现在 - 行之前的情况）
         for (let j = currentIndex + 1; j < Math.min(currentIndex + maxLook, lines.length); j++) {
             if (consumedIndices.has(j))
                 continue;
@@ -416,13 +507,20 @@ function detectTypeChangeForField(fieldName, lines, currentIndex, consumedIndice
     }
     return null;
 }
-// ── Cross-service impact analysis ──
+/**
+ * 分析破坏性变更的跨服务影响。
+ * 仅在多仓库（多服务）场景下有效。当前版本将所有破坏性端点
+ * 归类为对前端的潜在影响。
+ * @param breakingChanges - 破坏性变更列表
+ * @param config - 项目配置
+ * @returns 受影响的服务列表及其关联端点
+ */
 function analyzeCrossServiceImpact(breakingChanges, config) {
     const impact = [];
-    // Only relevant if the project has multiple repos (multi-service)
+    // 仅在多仓库（微服务）场景下进行跨服务影响分析
     if (config.repos.length < 2)
         return impact;
-    // Extract impacted endpoint paths from breaking changes
+    // 从破坏性变更中提取受影响的端点路径
     const affectedEndpoints = [];
     for (const change of breakingChanges) {
         if (change.change_type === "path_removed" ||
@@ -441,7 +539,14 @@ function analyzeCrossServiceImpact(breakingChanges, config) {
     }
     return impact;
 }
-// ── Summary builder ──
+/**
+ * 构建契约检查的人类可读摘要。
+ * @param total - 变更总数
+ * @param breaking - 破坏性变更数
+ * @param compatible - 兼容性变更数
+ * @param crossService - 跨服务影响列表
+ * @returns 摘要文本
+ */
 function buildSummary(total, breaking, compatible, crossService) {
     const parts = [];
     if (total === 0) {
@@ -457,7 +562,11 @@ function buildSummary(total, breaking, compatible, crossService) {
     }
     return parts.join(" ");
 }
-// ── Empty result helper ──
+/**
+ * 创建空的契约检查结果。
+ * @param summary - 摘要说明（通常描述为何无变更）
+ * @returns 所有计数为零的空契约检查结果
+ */
 function emptyResult(summary) {
     return {
         changes: [],

package/dist/engine/contract_guard.js.map

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

package/dist/engine/convention_detector.d.ts

@@ -1,7 +1,27 @@
+/**
+ * 代码惯例检测模块。
+ * @description 通过分析源代码文件内容和项目惯例配置文件，自动识别项目的编码规范和模式。
+ *              支持 Spring/Java 和 React/TypeScript 两种技术栈的惯例检测。
+ */
+/**
+ * 检测到的代码惯例条目。
+ */
 export interface Convention {
+    /** 文件匹配模式（glob 或具体文件路径） */
     file_pattern: string;
+    /** 惯例描述文本 */
     convention: string;
+    /** 惯例示例代码（可选） */
     example?: string;
 }
+/**
+ * 检测项目代码惯例。
+ * @description 优先加载项目中配置的惯例文件（支持 YAML front-matter 格式），
+ *              然后逐个分析源文件，识别特定的编码模式。最多返回 10 条惯例。
+ * @param filePaths - 待分析的文件路径列表
+ * @param projectPath - 项目根目录路径（用于解析相对路径）
+ * @param conventionsFile - 惯例配置文件路径（可选）
+ * @returns 检测到的惯例列表
+ */
 export declare function detectConventions(filePaths: string[], projectPath: string, conventionsFile?: string): Promise<Convention[]>;
 //# sourceMappingURL=convention_detector.d.ts.map

package/dist/engine/convention_detector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"convention_detector.d.ts","sourceRoot":"","sources":["../../src/engine/convention_detector.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,UAAU;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAsB,iBAAiB,CACrC,SAAS,EAAE,MAAM,EAAE,EACnB,WAAW,EAAE,MAAM,EACnB,eAAe,CAAC,EAAE,MAAM,GACvB,OAAO,CAAC,UAAU,EAAE,CAAC,CA0CvB"}
+{"version":3,"file":"convention_detector.d.ts","sourceRoot":"","sources":["../../src/engine/convention_detector.ts"],"names":[],"mappings":"AAKA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,2BAA2B;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;GAQG;AACH,wBAAsB,iBAAiB,CACrC,SAAS,EAAE,MAAM,EAAE,EACnB,WAAW,EAAE,MAAM,EACnB,eAAe,CAAC,EAAE,MAAM,GACvB,OAAO,CAAC,UAAU,EAAE,CAAC,CA0CvB"}