soloforge 1.0.0 → 1.1.1

package/dist/engine/convention_detector.js

@@ -2,9 +2,18 @@ import fs from "node:fs/promises";
 import fss from "node:fs";
 import path from "node:path";
 import matter from "gray-matter";
+/**
+ * 检测项目代码惯例。
+ * @description 优先加载项目中配置的惯例文件（支持 YAML front-matter 格式），
+ *              然后逐个分析源文件，识别特定的编码模式。最多返回 10 条惯例。
+ * @param filePaths - 待分析的文件路径列表
+ * @param projectPath - 项目根目录路径（用于解析相对路径）
+ * @param conventionsFile - 惯例配置文件路径（可选）
+ * @returns 检测到的惯例列表
+ */
 export async function detectConventions(filePaths, projectPath, conventionsFile) {
     const conventions = [];
-    // 优先加载项目约定的惯例文件
+    // 优先加载项目中配置的惯例文件（YAML front-matter 格式，conventions 字段为数组）
     if (conventionsFile) {
         const convPath = path.resolve(projectPath, conventionsFile);
         if (fss.existsSync(convPath)) {
@@ -44,6 +53,15 @@ export async function detectConventions(filePaths, projectPath, conventionsFile)
     }
     return conventions;
 }
+/**
+ * 分析单个文件，检测其中的编码惯例。
+ * @description 根据文件类型使用不同的检测策略：
+ *              - Java 文件：检测缓存字段模式、事务注解用法、ServiceImpl 命名规范
+ *              - TypeScript/React 文件：检测默认导出、Props interface、CSS-in-JS 方案
+ * @param content - 文件内容文本
+ * @param filePath - 文件路径（用于判断文件类型）
+ * @returns 从该文件中检测到的惯例列表
+ */
 function analyzeFile(content, filePath) {
     const conventions = [];
     // 检测 Spring 惯例

package/dist/engine/convention_detector.js.map

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

package/dist/engine/debt_reporter.d.ts

@@ -1,4 +1,9 @@
 import type { DebtTracker } from "./debt_tracker.js";
 import type { DebtReport } from "../types.js";
+/**
+ * 生成完整的技术债务报告，包含分组统计、趋势数据和优先级排序。
+ * @param tracker - 技术债务追踪器实例
+ * @returns 债务报告，包含总数、分类统计、严重程度分布、最久未解决天数、趋势和中文摘要
+ */
 export declare function generateDebtReport(tracker: DebtTracker): Promise<DebtReport>;
 //# sourceMappingURL=debt_reporter.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"debt_reporter.d.ts","sourceRoot":"","sources":["../../src/engine/debt_reporter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,UAAU,EAAY,MAAM,aAAa,CAAC;AAyBxD,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAyDlF"}
+{"version":3,"file":"debt_reporter.d.ts","sourceRoot":"","sources":["../../src/engine/debt_reporter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,UAAU,EAAY,MAAM,aAAa,CAAC;AA4CxD;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CA0DlF"}

package/dist/engine/debt_reporter.js

@@ -1,38 +1,61 @@
+/**
+ * 技术债务报告生成模块 — 基于债务追踪器数据，生成聚合统计报告。
+ * 包括按类别/严重程度分组、最久未解决天数、趋势分析和优先级排序。
+ */
+/** 严重程度权重映射，用于优先级评分 */
 const SEVERITY_SCORE = {
     critical: 4,
     warning: 3,
     info: 1,
 };
+/** 影响程度权重映射，用于优先级评分 */
 const IMPACT_SCORE = {
     high: 3,
     medium: 2,
     low: 1,
 };
+/**
+ * 计算两个 ISO 日期字符串之间的天数差。
+ * @param a - 起始日期字符串（ISO 格式）
+ * @param b - 结束日期字符串（ISO 格式）
+ * @returns 间隔天数，最小值为 0
+ */
 function daysBetween(a, b) {
     const msPerDay = 86400_000;
+    // 向下取整并确保不返回负值
     return Math.max(0, Math.floor((Date.parse(b) - Date.parse(a)) / msPerDay));
 }
+/**
+ * 计算单条债务的优先级评分。分数 = 严重程度权重 x 影响程度权重。
+ * @param item - 债务条目
+ * @returns 优先级评分（1~12，越高越紧急）
+ */
 function computePriorityScore(item) {
     const sev = SEVERITY_SCORE[item.severity] ?? 1;
     const imp = IMPACT_SCORE[item.impact ?? "medium"];
     return sev * imp;
 }
+/**
+ * 生成完整的技术债务报告，包含分组统计、趋势数据和优先级排序。
+ * @param tracker - 技术债务追踪器实例
+ * @returns 债务报告，包含总数、分类统计、严重程度分布、最久未解决天数、趋势和中文摘要
+ */
 export async function generateDebtReport(tracker) {
     const openItems = await tracker.listOpen();
-    // Total open count
+    // 未解决的债务总数
     const total_open = openItems.length;
-    // Group by category
+    // 按类别分组统计
     const by_category = {};
     for (const item of openItems) {
         const cat = item.category ?? "other";
         by_category[cat] = (by_category[cat] ?? 0) + 1;
     }
-    // Group by severity
+    // 按严重程度分组统计
     const by_severity = {};
     for (const item of openItems) {
         by_severity[item.severity] = (by_severity[item.severity] ?? 0) + 1;
     }
-    // Oldest debt in days
+    // 计算最久未解决的债务天数
     let oldest_debt_days = 0;
     const now = new Date().toISOString();
     for (const item of openItems) {
@@ -40,12 +63,13 @@ export async function generateDebtReport(tracker) {
         if (days > oldest_debt_days)
             oldest_debt_days = days;
     }
-    // Trend over last 30 days
+    // 获取近 30 天的债务增减趋势
     const trend_30d = await tracker.getTrend(30);
+    // 按优先级评分降序排列，取前 5 条作为最高优先级条目
     // Top priority items (sorted by severity * impact, top 5)
     const sorted = [...openItems].sort((a, b) => computePriorityScore(b) - computePriorityScore(a));
     const top_priority = sorted.slice(0, 5);
-    // Summary in Chinese
+    // 生成中文摘要
     const criticalCount = by_severity["critical"] ?? 0;
     const warningCount = by_severity["warning"] ?? 0;
     const infoCount = by_severity["info"] ?? 0;

package/dist/engine/debt_reporter.js.map

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

package/dist/engine/debt_tracker.d.ts

@@ -1,20 +1,72 @@
 import type { ReviewFinding, DebtItem } from "../types.js";
+/**
+ * 技术债务追踪器 — 负责债务的增删改查、统计聚合与过期清理。
+ * 债务数据存储在 `{projectPath}/.soloforge/state/debt/` 目录下。
+ */
 export declare class DebtTracker {
     private debtDir;
+    /**
+     * 初始化债务追踪器。
+     * @param projectPath - 项目根目录路径
+     */
     constructor(projectPath: string);
+    /** 确保债务存储目录存在，不存在则递归创建 */
     ensureDir(): Promise<void>;
+    /**
+     * 将代码审查发现记录为一条新的技术债务。
+     * 使用原子写入（先写临时文件再 rename）保证数据一致性。
+     * @param finding - 代码审查发现结果
+     * @param taskId - 关联的任务 ID
+     * @returns 新创建的债务条目 ID
+     */
     recordDebt(finding: ReviewFinding, taskId: string): Promise<string>;
+    /**
+     * 列出所有状态为 open 的债务条目，按发现时间升序排列。
+     * @returns 未解决的债务条目列表
+     */
     listOpen(): Promise<DebtItem[]>;
+    /** 将指定债务标记为「已确认」（acknowledged）。
+     * @param debtId - 债务条目 ID
+     */
     acknowledge(debtId: string): Promise<void>;
+    /** 将指定债务标记为「已解决」（resolved），同时记录解决时间。
+     * @param debtId - 债务条目 ID
+     */
     resolve(debtId: string): Promise<void>;
+    /**
+     * 按债务类别统计未解决的条目数量。
+     * @returns 以类别名为键、数量为值的统计对象
+     */
     getStats(): Promise<Record<string, number>>;
+    /**
+     * 计算指定天数内债务的增减趋势。
+     * @param sinceDays - 统计回溯天数
+     * @returns 包含新增数（created）、已解决数（resolved）和净增量（net）的趋势数据
+     */
     getTrend(sinceDays: number): Promise<{
         created: number;
         resolved: number;
         net: number;
     }>;
+    /**
+     * 按优先级对未解决债务排序。优先级 = 严重程度分 x 影响程度分。
+     * severity: critical=4, warning=3, info=1
+     * impact: high=3, medium=2, low=1
+     * @returns 按优先级降序排列的债务列表（最高优先在前）
+     */
     prioritize(): Promise<DebtItem[]>;
+    /**
+     * 清理已过期且已解决的债务条目。
+     * 超过 MAX_DEBT_AGE_DAYS（30 天）的已解决条目将被删除。
+     * @returns 本次清理删除的条目数量
+     */
     cleanup(): Promise<number>;
+    /**
+     * 更新指定债务条目的状态。使用原子写入保证数据一致性。
+     * @param debtId - 债务条目 ID
+     * @param status - 新状态（acknowledged 或 resolved）
+     * @param resolvedAt - 解决时间（仅当 status 为 resolved 时有效）
+     */
     private updateStatus;
 }
 //# sourceMappingURL=debt_tracker.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"debt_tracker.d.ts","sourceRoot":"","sources":["../../src/engine/debt_tracker.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAkB,MAAM,aAAa,CAAC;AAI3E,qBAAa,WAAW;IACtB,OAAO,CAAC,OAAO,CAAS;gBAEZ,WAAW,EAAE,MAAM;IAIzB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAI1B,UAAU,CAAC,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAgCnE,QAAQ,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IAiB/B,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI1C,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAItC,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAU3C,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAuBxF,UAAU,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IAWjC,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC;YA4BlB,YAAY;CAe3B"}
+{"version":3,"file":"debt_tracker.d.ts","sourceRoot":"","sources":["../../src/engine/debt_tracker.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAkB,MAAM,aAAa,CAAC;AAW3E;;;GAGG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,OAAO,CAAS;IAExB;;;OAGG;gBACS,WAAW,EAAE,MAAM;IAI/B,0BAA0B;IACpB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAIhC;;;;;;OAMG;IACG,UAAU,CAAC,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAiCzE;;;OAGG;IACG,QAAQ,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IAkBrC;;OAEG;IACG,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIhD;;OAEG;IACG,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5C;;;OAGG;IACG,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAUjD;;;;OAIG;IACG,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAyB9F;;;;;OAKG;IACG,UAAU,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IAavC;;;;OAIG;IACG,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC;IA4BhC;;;;;OAKG;YACW,YAAY;CAgB3B"}

package/dist/engine/debt_tracker.js

@@ -2,19 +2,41 @@ import fs from "node:fs/promises";
 import fss from "node:fs";
 import path from "node:path";
 import crypto from "node:crypto";
+/**
+ * 技术债务追踪模块 — 持久化存储、查询、统计和清理技术债务条目。
+ * 基于文件系统实现（JSON 单文件存储），零外部依赖。
+ * 每条债务对应一个 `.json` 文件，以 `debt-<short-uuid>.json` 命名。
+ */
+/** 已解决债务的默认保留天数，超过后将被 cleanup 自动清理 */
 const MAX_DEBT_AGE_DAYS = 30;
+/**
+ * 技术债务追踪器 — 负责债务的增删改查、统计聚合与过期清理。
+ * 债务数据存储在 `{projectPath}/.soloforge/state/debt/` 目录下。
+ */
 export class DebtTracker {
     debtDir;
+    /**
+     * 初始化债务追踪器。
+     * @param projectPath - 项目根目录路径
+     */
     constructor(projectPath) {
         this.debtDir = path.join(projectPath, ".soloforge", "state", "debt");
     }
+    /** 确保债务存储目录存在，不存在则递归创建 */
     async ensureDir() {
         await fs.mkdir(this.debtDir, { recursive: true });
     }
+    /**
+     * 将代码审查发现记录为一条新的技术债务。
+     * 使用原子写入（先写临时文件再 rename）保证数据一致性。
+     * @param finding - 代码审查发现结果
+     * @param taskId - 关联的任务 ID
+     * @returns 新创建的债务条目 ID
+     */
     async recordDebt(finding, taskId) {
         await this.ensureDir();
         const id = `debt-${crypto.randomUUID().slice(0, 8)}`;
-        // Map ReviewFinding.dimension to DebtItem.category
+        // 审查维度到债务类别的映射表
         const dimensionToCategory = {
             quality: "other",
             security: "security",
@@ -36,10 +58,15 @@ export class DebtTracker {
         };
         const filePath = path.join(this.debtDir, `${id}.json`);
         const tmpPath = `${filePath}.tmp`;
+        // 原子写入：先写入临时文件，再重命名为目标文件，防止写入中断导致数据损坏
         await fs.writeFile(tmpPath, JSON.stringify(item, null, 2));
         await fs.rename(tmpPath, filePath);
         return id;
     }
+    /**
+     * 列出所有状态为 open 的债务条目，按发现时间升序排列。
+     * @returns 未解决的债务条目列表
+     */
     async listOpen() {
         await this.ensureDir();
         const files = await fs.readdir(this.debtDir);
@@ -57,14 +84,25 @@ export class DebtTracker {
                 console.debug("[soloforge]", e);
             }
         }
+        // 按发现时间升序排列，最早的债务排在前面
         return items.sort((a, b) => a.discovered_at.localeCompare(b.discovered_at));
     }
+    /** 将指定债务标记为「已确认」（acknowledged）。
+     * @param debtId - 债务条目 ID
+     */
     async acknowledge(debtId) {
         await this.updateStatus(debtId, "acknowledged");
     }
+    /** 将指定债务标记为「已解决」（resolved），同时记录解决时间。
+     * @param debtId - 债务条目 ID
+     */
     async resolve(debtId) {
         await this.updateStatus(debtId, "resolved", new Date().toISOString());
     }
+    /**
+     * 按债务类别统计未解决的条目数量。
+     * @returns 以类别名为键、数量为值的统计对象
+     */
     async getStats() {
         const openItems = await this.listOpen();
         const stats = {};
@@ -74,6 +112,11 @@ export class DebtTracker {
         }
         return stats;
     }
+    /**
+     * 计算指定天数内债务的增减趋势。
+     * @param sinceDays - 统计回溯天数
+     * @returns 包含新增数（created）、已解决数（resolved）和净增量（net）的趋势数据
+     */
     async getTrend(sinceDays) {
         await this.ensureDir();
         const cutoff = new Date();
@@ -90,6 +133,7 @@ export class DebtTracker {
                 const item = JSON.parse(content);
                 if (item.discovered_at >= cutoffStr)
                     created++;
+                // 仅统计在时间窗口内解决的条目
                 if (item.status === "resolved" && item.resolved_at && item.resolved_at >= cutoffStr)
                     resolved++;
             }
@@ -97,11 +141,20 @@ export class DebtTracker {
                 console.debug("[soloforge]", e);
             }
         }
+        // 净增量 = 新增 - 已解决；正值表示债务在增长
         return { created, resolved, net: created - resolved };
     }
+    /**
+     * 按优先级对未解决债务排序。优先级 = 严重程度分 x 影响程度分。
+     * severity: critical=4, warning=3, info=1
+     * impact: high=3, medium=2, low=1
+     * @returns 按优先级降序排列的债务列表（最高优先在前）
+     */
     async prioritize() {
         const openItems = await this.listOpen();
+        // 严重程度权重：critical 最重，info 最轻
         const sevScore = { critical: 4, warning: 3, info: 1 };
+        // 影响程度权重：high 最重，low 最轻
         const impScore = { high: 3, medium: 2, low: 1 };
         return [...openItems].sort((a, b) => {
             const sa = (sevScore[a.severity] ?? 1) * (impScore[a.impact ?? "medium"] ?? 2);
@@ -109,6 +162,11 @@ export class DebtTracker {
             return sb - sa;
         });
     }
+    /**
+     * 清理已过期且已解决的债务条目。
+     * 超过 MAX_DEBT_AGE_DAYS（30 天）的已解决条目将被删除。
+     * @returns 本次清理删除的条目数量
+     */
     async cleanup() {
         await this.ensureDir();
         const files = await fs.readdir(this.debtDir);
@@ -135,8 +193,15 @@ export class DebtTracker {
         }
         return removed;
     }
+    /**
+     * 更新指定债务条目的状态。使用原子写入保证数据一致性。
+     * @param debtId - 债务条目 ID
+     * @param status - 新状态（acknowledged 或 resolved）
+     * @param resolvedAt - 解决时间（仅当 status 为 resolved 时有效）
+     */
     async updateStatus(debtId, status, resolvedAt) {
         const filePath = path.join(this.debtDir, `${debtId}.json`);
+        // 债务文件不存在则静默返回，避免重复操作的报错
         if (!fss.existsSync(filePath))
             return;
         const content = await fs.readFile(filePath, "utf-8");

package/dist/engine/debt_tracker.js.map

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

package/dist/engine/debugger.d.ts

@@ -1,3 +1,12 @@
 import type { DebugSession } from "../types.js";
+/**
+ * 执行完整的六步调试流水线。
+ * 依次执行错误解析、调用链提取、根因分析、修复建议和测试补充，
+ * 将结果组装为完整的调试会话对象。
+ * @param errorOutput - 原始错误输出文本
+ * @param taskId - 关联的任务 ID
+ * @param projectScope - 可选的项目路径范围（用于过滤调用链帧）
+ * @returns 完整的调试会话对象
+ */
 export declare function debugError(errorOutput: string, taskId: string, projectScope?: string[]): DebugSession;
 //# sourceMappingURL=debugger.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"debugger.d.ts","sourceRoot":"","sources":["../../src/engine/debugger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAQV,YAAY,EACb,MAAM,aAAa,CAAC;AAgVrB,wBAAgB,UAAU,CACxB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,YAAY,CAAC,EAAE,MAAM,EAAE,GACtB,YAAY,CAgBd"}
+{"version":3,"file":"debugger.d.ts","sourceRoot":"","sources":["../../src/engine/debugger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAQV,YAAY,EACb,MAAM,aAAa,CAAC;AAmarB;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CACxB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,YAAY,CAAC,EAAE,MAAM,EAAE,GACtB,YAAY,CAgBd"}