soloforge 1.2.8 → 1.2.9

package/dist/engine/java_quality_guard.js

@@ -62,6 +62,7 @@ const BUILTIN_RULES = [
  * 项目约定优先于内置规则。
  */
 export function loadProjectRules(conventionsContent) {
+    console.error("[soloForge] Java质量: loadProjectRules() 开始执行");
     if (!conventionsContent)
         return [];
     const rules = [];
@@ -89,11 +90,13 @@ export function loadProjectRules(conventionsContent) {
  * @returns 质量检查报告
  */
 export function checkJavaQuality(filePath, content, projectRules = []) {
+    console.error("[soloForge] Java质量: checkJavaQuality() 开始执行，文件:", filePath);
     const results = [];
     const lines = content.split("\n");
-    // Merge rules: project rules first, then built-in (project takes precedence by ID)
+    // 合并rules: project rules first, then built-in (project takes precedence by ID)
     const projectIds = new Set(projectRules.map((r) => r.id));
     const allRules = [...projectRules, ...BUILTIN_RULES.filter((r) => !projectIds.has(r.id))];
+    console.error("[soloForge] Java质量: 合并规则", allRules.length, "条（内置", BUILTIN_RULES.length, "条，自定义", projectRules.length, "条）");
     for (const rule of allRules) {
         if (rule.id === "JAVA-Q001") {
             // Empty catch block (multi-line handling)
@@ -127,6 +130,7 @@ export function checkJavaQuality(filePath, content, projectRules = []) {
     }
     const hardGateFailures = results.filter((r) => r.severity === "hard_gate").length;
     const advisoryWarnings = results.filter((r) => r.severity === "advisory").length;
+    console.error("[soloForge] Java质量: 检查完成 — hard_gate:", hardGateFailures, "失败，advisory:", advisoryWarnings, "警告，can_proceed:", hardGateFailures === 0);
     return {
         file_path: filePath,
         total_checks: allRules.length,
@@ -146,7 +150,7 @@ function checkEmptyCatch(filePath, lines, rule, results) {
     const emptyCatchPat = /catch\s*\([^)]*\)\s*\{\s*\}/g;
     let match;
     while ((match = emptyCatchPat.exec(fullContent)) !== null) {
-        // Find line number from offset
+        // 查找line number from offset
         const offset = match.index;
         let lineNum = 1;
         for (let i = 0; i < offset; i++) {
@@ -170,7 +174,7 @@ function checkMethodLength(filePath, lines, rule, results) {
     let methodName = "";
     for (let i = 0; i < lines.length; i++) {
         const line = lines[i].trim();
-        // Detect method start
+        // 检测method start
         if (methodStart === -1) {
             const methodMatch = line.match(/\b(public|private|protected|static|\s)+\s+\w+\s+\w+\s*\([^)]*\)\s*\{/);
             if (methodMatch) {
@@ -209,7 +213,7 @@ function checkMethodLength(filePath, lines, rule, results) {
 function checkOverrideAnnotation(filePath, lines, rule, results) {
     for (let i = 0; i < lines.length; i++) {
         const line = lines[i].trim();
-        // Check for method that looks like an override (public/protected, has super-type signature)
+        // 检查method that looks like an override (public/protected, has super-type signature)
         if (/\b(public|protected)\s+\w+\s+\w+\s*\([^)]*\)\s*\{/.test(line) &&
             !lines[Math.max(0, i - 1)].trim().startsWith("@Override") &&
             !lines[Math.max(0, i - 1)].trim().startsWith("@")) {

package/dist/engine/java_quality_guard.js.map

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

package/dist/engine/job_manager.d.ts

@@ -38,35 +38,70 @@ export declare class JobManager {
     constructor(stateDir: string);
     /**
      * 创建新 job，分配 job_id 并写入初始 checkpoint。
+     *
+     * @param taskId - 任务 ID
+     * @param phase - 当前阶段
+     * @param initialSummary - 初始摘要
+     * @returns 初始 job checkpoint
      */
     createJob(taskId: string, phase: string, initialSummary: string): Promise<JobCheckpoint>;
     /**
      * 更新 checkpoint — 记录心跳和阶段进展。
+     *
+     * @param jobId - Job ID
+     * @param taskId - 任务 ID
+     * @param phase - 当前阶段
+     * @param anchor - 认知锚点更新内容
+     * @param stateSnapshot - 可选的状态快照
+     * @returns 更新后的 checkpoint，未找到则返回 null
      */
     updateCheckpoint(jobId: string, taskId: string, phase: string, anchor: Partial<CognitiveAnchor>, stateSnapshot?: Record<string, unknown>): Promise<JobCheckpoint | null>;
     /**
      * 心跳 — 只更新 heartbeat_at 时间戳。
+     *
+     * @param jobId - Job ID
+     * @param taskId - 任务 ID
+     * @returns 是否成功更新心跳
      */
     heartbeat(jobId: string, taskId: string): Promise<boolean>;
     /**
      * 查询 job 状态 — 包括是否活跃、距上次心跳时间。
+     *
+     * @param jobId - Job ID
+     * @param taskId - 任务 ID
+     * @param maxAgeMs - 最大存活时间（毫秒），默认 5 分钟
+     * @returns Job 状态，未找到则返回 null
      */
     getJobStatus(jobId: string, taskId: string, maxAgeMs?: number): Promise<JobStatus | null>;
     /**
      * 从最新 checkpoint 恢复 — 返回 checkpoint 数据供调用方恢复状态。
+     *
+     * @param jobId - Job ID
+     * @param taskId - 任务 ID
+     * @returns 最新的 checkpoint，未找到则返回 null
      */
     resumeFromCheckpoint(jobId: string, taskId: string): Promise<JobCheckpoint | null>;
     /**
      * 取消 job — 删除所有 checkpoint 文件。
+     *
+     * @param jobId - Job ID
+     * @param taskId - 任务 ID
+     * @returns 是否成功删除
      */
     cancelJob(jobId: string, taskId: string): Promise<boolean>;
     /**
      * 列出所有活跃 job。
+     *
+     * @param maxAgeMs - 最大存活时间（毫秒），默认 5 分钟
+     * @returns 活跃的 job 状态列表
      */
     listActiveJobs(maxAgeMs?: number): Promise<JobStatus[]>;
     /**
      * 仅凭 job_id 反查 task_id — 扫描 checkpoint 文件，返回最新一条的 task_id。
      * 用于 sf_status 在不传 task_id 时自动推导。
+     *
+     * @param jobId - Job ID
+     * @returns 对应的 task_id，未找到则返回 null
      */
     resolveTaskId(jobId: string): Promise<string | null>;
     private getJobsDir;

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

@@ -1 +1 @@
-{"version":3,"file":"job_manager.d.ts","sourceRoot":"","sources":["../../src/engine/job_manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAOH,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gBAAgB,EAAE,eAAe,CAAC;IAClC,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACzC;AAED,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;IAClB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,eAAe,GAAG,IAAI,CAAC;CACvC;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAS;gBAEb,QAAQ,EAAE,MAAM;IAK5B;;OAEG;IACG,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAwB9F;;OAEG;IACG,gBAAgB,CACpB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,OAAO,CAAC,eAAe,CAAC,EAChC,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACtC,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAyBhC;;OAEG;IACG,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAShE;;OAEG;IACG,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,SAAgB,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IAkBtG;;OAEG;IACG,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAIxF;;OAEG;IACG,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAgBhE;;OAEG;IACG,cAAc,CAAC,QAAQ,SAAgB,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IA2CpE;;;OAGG;IACG,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAsB1D,OAAO,CAAC,UAAU;YAMJ,eAAe;YASf,oBAAoB;CAoBnC"}
+{"version":3,"file":"job_manager.d.ts","sourceRoot":"","sources":["../../src/engine/job_manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAOH,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gBAAgB,EAAE,eAAe,CAAC;IAClC,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACzC;AAED,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;IAClB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,eAAe,GAAG,IAAI,CAAC;CACvC;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAS;gBAEb,QAAQ,EAAE,MAAM;IAK5B;;;;;;;OAOG;IACG,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAyB9F;;;;;;;;;OASG;IACG,gBAAgB,CACpB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,OAAO,CAAC,eAAe,CAAC,EAChC,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACtC,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAyBhC;;;;;;OAMG;IACG,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAShE;;;;;;;OAOG;IACG,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,SAAgB,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IAkBtG;;;;;;OAMG;IACG,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAUxF;;;;;;OAMG;IACG,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAiBhE;;;;;OAKG;IACG,cAAc,CAAC,QAAQ,SAAgB,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IA2CpE;;;;;;OAMG;IACG,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAsB1D,OAAO,CAAC,UAAU;YAMJ,eAAe;YASf,oBAAoB;CAoBnC"}

package/dist/engine/job_manager.js

@@ -20,6 +20,11 @@ export class JobManager {
     }
     /**
      * 创建新 job，分配 job_id 并写入初始 checkpoint。
+     *
+     * @param taskId - 任务 ID
+     * @param phase - 当前阶段
+     * @param initialSummary - 初始摘要
+     * @returns 初始 job checkpoint
      */
     async createJob(taskId, phase, initialSummary) {
         const jobId = `job-${crypto.randomUUID().slice(0, 8)}`;
@@ -41,9 +46,17 @@ export class JobManager {
         };
         await this.writeCheckpoint(checkpoint);
         return checkpoint;
+        console.error("[soloForge] 任务管理: 创建 job", jobId, "任务:", taskId, "阶段:", phase);
     }
     /**
      * 更新 checkpoint — 记录心跳和阶段进展。
+     *
+     * @param jobId - Job ID
+     * @param taskId - 任务 ID
+     * @param phase - 当前阶段
+     * @param anchor - 认知锚点更新内容
+     * @param stateSnapshot - 可选的状态快照
+     * @returns 更新后的 checkpoint，未找到则返回 null
      */
     async updateCheckpoint(jobId, taskId, phase, anchor, stateSnapshot) {
         const existing = await this.loadLatestCheckpoint(jobId, taskId);
@@ -70,6 +83,10 @@ export class JobManager {
     }
     /**
      * 心跳 — 只更新 heartbeat_at 时间戳。
+     *
+     * @param jobId - Job ID
+     * @param taskId - 任务 ID
+     * @returns 是否成功更新心跳
      */
     async heartbeat(jobId, taskId) {
         const existing = await this.loadLatestCheckpoint(jobId, taskId);
@@ -81,6 +98,11 @@ export class JobManager {
     }
     /**
      * 查询 job 状态 — 包括是否活跃、距上次心跳时间。
+     *
+     * @param jobId - Job ID
+     * @param taskId - 任务 ID
+     * @param maxAgeMs - 最大存活时间（毫秒），默认 5 分钟
+     * @returns Job 状态，未找到则返回 null
      */
     async getJobStatus(jobId, taskId, maxAgeMs = 5 * 60 * 1000) {
         const checkpoint = await this.loadLatestCheckpoint(jobId, taskId);
@@ -100,12 +122,27 @@ export class JobManager {
     }
     /**
      * 从最新 checkpoint 恢复 — 返回 checkpoint 数据供调用方恢复状态。
+     *
+     * @param jobId - Job ID
+     * @param taskId - 任务 ID
+     * @returns 最新的 checkpoint，未找到则返回 null
      */
     async resumeFromCheckpoint(jobId, taskId) {
-        return this.loadLatestCheckpoint(jobId, taskId);
+        const cp = await this.loadLatestCheckpoint(jobId, taskId);
+        if (cp) {
+            console.error("[soloForge] 任务管理: 从 checkpoint 恢复 job", jobId, "阶段:", cp.phase);
+        }
+        else {
+            console.error("[soloForge] 任务管理: 未找到 job", jobId, "的 checkpoint");
+        }
+        return cp;
     }
     /**
      * 取消 job — 删除所有 checkpoint 文件。
+     *
+     * @param jobId - Job ID
+     * @param taskId - 任务 ID
+     * @returns 是否成功删除
      */
     async cancelJob(jobId, taskId) {
         const pattern = `${jobId}`;
@@ -114,6 +151,7 @@ export class JobManager {
             return false;
         const files = await fs.readdir(dir);
         let removed = false;
+        console.error("[soloForge] 任务管理: 取消 job", jobId, "任务:", taskId);
         for (const f of files) {
             if (f.includes(pattern) && f.endsWith(".json")) {
                 await fs.unlink(path.join(dir, f));
@@ -124,6 +162,9 @@ export class JobManager {
     }
     /**
      * 列出所有活跃 job。
+     *
+     * @param maxAgeMs - 最大存活时间（毫秒），默认 5 分钟
+     * @returns 活跃的 job 状态列表
      */
     async listActiveJobs(maxAgeMs = 5 * 60 * 1000) {
         const dir = path.join(this.stateDir, "jobs");
@@ -136,11 +177,11 @@ export class JobManager {
                 const data = await fs.readFile(path.join(dir, f), "utf-8");
                 checkpoints.push(JSON.parse(data));
             }
-            catch {
-                // skip corrupt files
+            catch (e) {
+                console.error("[soloForge] 作业管理器: 读取 checkpoint 文件失败(预期行为: 文件损坏) —", f, e);
             }
         }
-        // Group by job_id, take latest per job
+        // 按 job_id 分组，取每个 job 的最新 checkpoint
         const latest = new Map();
         for (const cp of checkpoints) {
             const existing = latest.get(cp.job_id);
@@ -168,6 +209,9 @@ export class JobManager {
     /**
      * 仅凭 job_id 反查 task_id — 扫描 checkpoint 文件，返回最新一条的 task_id。
      * 用于 sf_status 在不传 task_id 时自动推导。
+     *
+     * @param jobId - Job ID
+     * @returns 对应的 task_id，未找到则返回 null
      */
     async resolveTaskId(jobId) {
         const dir = this.getJobsDir();
@@ -181,13 +225,13 @@ export class JobManager {
                 const data = JSON.parse(await fs.readFile(path.join(dir, f), "utf-8"));
                 return data.task_id;
             }
-            catch {
-                // skip corrupt
+            catch (e) {
+                console.error("[soloForge] 作业管理器: 读取 checkpoint 文件失败(预期行为: 文件损坏) —", f, e);
             }
         }
         return null;
     }
-    // ── Internal ──
+    // ── 内部方法 ──
     getJobsDir() {
         const dir = path.join(this.stateDir, "jobs");
         fss.mkdirSync(dir, { recursive: true });
@@ -215,8 +259,8 @@ export class JobManager {
                 if (cp.task_id === taskId)
                     return cp;
             }
-            catch {
-                // skip corrupt
+            catch (e) {
+                console.error("[soloForge] 作业管理器: 读取 checkpoint 文件失败(预期行为: 文件损坏) —", f, e);
             }
         }
         return null;

package/dist/engine/job_manager.js.map

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

package/dist/engine/knowledge_config_loader.d.ts

@@ -12,17 +12,28 @@ export declare function loadKnowledgeConfig(relativePath: string, projectPath?:
 /**
  * 从知识文件的决策规则中提取指定键的数值。
  * 格式: - 键名 = 数值（如 "Confidence_Threshold = 0.95"）
+ * @param body - 知识文件正文内容
+ * @param key - 要提取的规则键名
+ * @returns 匹配到的数值，未找到时返回 undefined
  */
 export declare function extractNumberRule(body: string, key: string): number | undefined;
 /**
  * 从知识文件的决策规则中提取指定键的字符串值。
+ * @param body - 知识文件正文内容
+ * @param key - 要提取的规则键名
+ * @returns 匹配到的字符串值，未找到时返回 undefined
  */
 export declare function extractStringRule(body: string, key: string): string | undefined;
 /**
  * 从知识文件的决策规则中提取列表值。
  * 格式: - 键名 = 值1 / 值2 / 值3
+ * @param body - 知识文件正文内容
+ * @param key - 要提取的规则键名
+ * @returns 匹配到的字符串列表，未找到时返回空数组
  */
 export declare function extractListRule(body: string, key: string): string[];
-/** 清除缓存（测试用） */
+/**
+ * 清除知识配置缓存（测试用）。
+ */
 export declare function clearConfigCache(): void;
 //# sourceMappingURL=knowledge_config_loader.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"knowledge_config_loader.d.ts","sourceRoot":"","sources":["../../src/engine/knowledge_config_loader.ts"],"names":[],"mappings":"AAkBA;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,YAAY,EAAE,MAAM,EACpB,WAAW,CAAC,EAAE,MAAM,GACnB;IAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAmBxD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAI/E;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAI/E;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAInE;AAED,gBAAgB;AAChB,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC"}
+{"version":3,"file":"knowledge_config_loader.d.ts","sourceRoot":"","sources":["../../src/engine/knowledge_config_loader.ts"],"names":[],"mappings":"AA0BA;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,YAAY,EAAE,MAAM,EACpB,WAAW,CAAC,EAAE,MAAM,GACnB;IAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAuCxD;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAI/E;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAI/E;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAInE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAGvC"}

package/dist/engine/knowledge_config_loader.js

@@ -1,5 +1,6 @@
 import fs from "node:fs";
 import path from "node:path";
+import { fileURLToPath } from "node:url";
 import matter from "gray-matter";
 /**
  * 知识配置读取器 — 从 .md 知识文件中提取决策规则配置。
@@ -7,11 +8,17 @@ import matter from "gray-matter";
  */
 /** 知识配置缓存 */
 const configCache = new Map();
-const CACHE_TTL = 5 * 60 * 1000; // 5 分钟
-/** 默认知识库根目录 */
+const CACHE_TTL = 5 * 60 * 1000; // 缓存有效期：5 分钟
+/** 项目知识库根目录 */
 function getKnowledgeRoot(projectPath) {
     return path.join(projectPath ?? process.cwd(), ".soloforge", "knowledge");
 }
+/** 包内模板知识库根目录 */
+function getTemplatesRoot() {
+    const thisDir = path.dirname(fileURLToPath(import.meta.url));
+    // src/engine/ → 项目根 → templates/knowledge（目录层级映射）
+    return path.resolve(thisDir, "..", "..", "templates", "knowledge");
+}
 /**
  * 从知识库中加载指定 .md 文件的 frontmatter 和 body。
  * 支持缓存，5 分钟内复用。
@@ -20,27 +27,51 @@ function getKnowledgeRoot(projectPath) {
  * @returns frontmatter data + body，文件不存在时返回 null
  */
 export function loadKnowledgeConfig(relativePath, projectPath) {
-    const cacheKey = relativePath;
+    console.error("[soloForge] KnowledgeConfigLoader: 加载知识配置", relativePath);
+    // 缓存 key 必须区分 projectPath，否则不同项目的同名文件会互相污染
+    const projectRoot = projectPath ?? process.cwd();
+    const cacheKey = `${projectRoot}::${relativePath}`;
+    // 优先项目 .soloforge/knowledge，缺失时回退包内 templates/knowledge
+    const projectFile = path.join(getKnowledgeRoot(projectPath), relativePath);
+    const templateFile = path.join(getTemplatesRoot(), relativePath);
+    const useProject = fs.existsSync(projectFile);
+    const filePath = useProject ? projectFile : templateFile;
+    if (!fs.existsSync(filePath)) {
+        console.error("[soloForge] KnowledgeConfigLoader: 知识文件不存在", filePath);
+        return null;
+    }
+    // mtime 检查：项目覆盖文件变更后立即失效，模板文件不可变则用 TTL
+    let mtime = 0;
+    if (useProject) {
+        try {
+            mtime = fs.statSync(filePath).mtimeMs;
+        }
+        catch { /* 忽略 */ }
+    }
     const cached = configCache.get(cacheKey);
-    if (cached && Date.now() - cached.loadedAt < CACHE_TTL) {
-        return { data: cached.data, body: cached.body };
+    if (cached) {
+        const mtimeMatch = !useProject || cached.mtime === mtime;
+        if (mtimeMatch && Date.now() - cached.loadedAt < CACHE_TTL) {
+            return { data: cached.data, body: cached.body };
+        }
     }
-    const filePath = path.join(getKnowledgeRoot(projectPath), relativePath);
-    if (!fs.existsSync(filePath))
-        return null;
     try {
         const raw = fs.readFileSync(filePath, "utf-8");
         const { data, content: body } = matter(raw);
-        configCache.set(cacheKey, { data: data, body, loadedAt: Date.now() });
+        configCache.set(cacheKey, { data: data, body, mtime, loadedAt: Date.now() });
         return { data: data, body };
     }
     catch {
+        console.error("[soloForge] KnowledgeConfigLoader: 读取知识文件失败", filePath);
         return null;
     }
 }
 /**
  * 从知识文件的决策规则中提取指定键的数值。
  * 格式: - 键名 = 数值（如 "Confidence_Threshold = 0.95"）
+ * @param body - 知识文件正文内容
+ * @param key - 要提取的规则键名
+ * @returns 匹配到的数值，未找到时返回 undefined
  */
 export function extractNumberRule(body, key) {
     const regex = new RegExp(`${key.replace(/_/g, "[_ ]")}\\s*=\\s*([\\d.]+)`, "i");
@@ -49,6 +80,9 @@ export function extractNumberRule(body, key) {
 }
 /**
  * 从知识文件的决策规则中提取指定键的字符串值。
+ * @param body - 知识文件正文内容
+ * @param key - 要提取的规则键名
+ * @returns 匹配到的字符串值，未找到时返回 undefined
  */
 export function extractStringRule(body, key) {
     const regex = new RegExp(`${key.replace(/_/g, "[_ ]")}\\s*=\\s*([^\\n,]+)`, "i");
@@ -58,6 +92,9 @@ export function extractStringRule(body, key) {
 /**
  * 从知识文件的决策规则中提取列表值。
  * 格式: - 键名 = 值1 / 值2 / 值3
+ * @param body - 知识文件正文内容
+ * @param key - 要提取的规则键名
+ * @returns 匹配到的字符串列表，未找到时返回空数组
  */
 export function extractListRule(body, key) {
     const value = extractStringRule(body, key);
@@ -65,8 +102,11 @@ export function extractListRule(body, key) {
         return [];
     return value.split(/[/,，、]/).map((v) => v.trim()).filter(Boolean);
 }
-/** 清除缓存（测试用） */
+/**
+ * 清除知识配置缓存（测试用）。
+ */
 export function clearConfigCache() {
+    console.error("[soloForge] KnowledgeConfigLoader: 清除配置缓存");
     configCache.clear();
 }
 //# sourceMappingURL=knowledge_config_loader.js.map

package/dist/engine/knowledge_config_loader.js.map

@@ -1 +1 @@
-{"version":3,"file":"knowledge_config_loader.js","sourceRoot":"","sources":["../../src/engine/knowledge_config_loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,MAAM,MAAM,aAAa,CAAC;AAEjC;;;GAGG;AAEH,aAAa;AACb,MAAM,WAAW,GAAG,IAAI,GAAG,EAA6E,CAAC;AACzG,MAAM,SAAS,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,OAAO;AAExC,eAAe;AACf,SAAS,gBAAgB,CAAC,WAAoB;IAC5C,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,IAAI,OAAO,CAAC,GAAG,EAAE,EAAE,YAAY,EAAE,WAAW,CAAC,CAAC;AAC5E,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CACjC,YAAoB,EACpB,WAAoB;IAEpB,MAAM,QAAQ,GAAG,YAAY,CAAC;IAE9B,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACzC,IAAI,MAAM,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,QAAQ,GAAG,SAAS,EAAE,CAAC;QACvD,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;IAClD,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,WAAW,CAAC,EAAE,YAAY,CAAC,CAAC;IACxE,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,IAAI,CAAC;IAE1C,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC/C,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QAC5C,WAAW,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,IAA+B,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QACjG,OAAO,EAAE,IAAI,EAAE,IAA+B,EAAE,IAAI,EAAE,CAAC;IACzD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAY,EAAE,GAAW;IACzD,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,GAAG,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,oBAAoB,EAAE,GAAG,CAAC,CAAC;IAChF,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAChC,OAAO,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAClD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAY,EAAE,GAAW;IACzD,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,GAAG,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,qBAAqB,EAAE,GAAG,CAAC,CAAC;IACjF,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAChC,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;AAC7C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY,EAAE,GAAW;IACvD,MAAM,KAAK,GAAG,iBAAiB,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAC3C,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAC;IACtB,OAAO,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AACpE,CAAC;AAED,gBAAgB;AAChB,MAAM,UAAU,gBAAgB;IAC9B,WAAW,CAAC,KAAK,EAAE,CAAC;AACtB,CAAC"}
+{"version":3,"file":"knowledge_config_loader.js","sourceRoot":"","sources":["../../src/engine/knowledge_config_loader.ts"],"names":[],"mappings":"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"}

package/dist/engine/knowledge_injection_boundary.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Knowledge Injection Boundary — 知识注入边界三道门
+ *
+ * 将"可索引""可注入""注入优先级"拆成三道门，
+ * 为每次 expand 生成知识注入报告，说明哪些知识被注入、
+ * 哪些只能 advisory、哪些被排除以及排除原因。
+ */
+import type { KnowledgeEntry, KnowledgeInjectionReport, KnowledgeConflict, ExclusionReason } from "../types.js";
+import type { IntentRouteDecision } from "./intent_router.js";
+import { type ConsumableAssetRef } from "./consumable_asset_registry.js";
+export interface InjectionGovernanceFinding {
+    severity: "hard_fail" | "advisory";
+    subject_id: string;
+    field: string;
+    message: string;
+}
+interface GateResult<T> {
+    passed: T[];
+    excluded: Array<{
+        id: string;
+        name: string;
+        reason: ExclusionReason;
+    }>;
+}
+/** 门1: 过滤可索引的知识条目，排除非 active/pending_review 状态 */
+export declare function filterIndexable(entries: KnowledgeEntry[]): GateResult<KnowledgeEntry>;
+/** 门2: 过滤可注入的知识条目，按消费模式、作用域、产品、路由等条件筛选 */
+export declare function filterInjectable(entries: KnowledgeEntry[], routeDecision: IntentRouteDecision | undefined, scopeFilters: string[], assets: ConsumableAssetRef[], productFilters?: string[]): {
+    injectable: KnowledgeEntry[];
+    advisory: KnowledgeEntry[];
+    excluded: Array<{
+        id: string;
+        name: string;
+        reason: ExclusionReason;
+    }>;
+};
+/** 门3: 按优先级排序知识条目，检测冲突，在预算内裁剪 */
+export declare function sortByPriority(entries: KnowledgeEntry[], routeDecision: IntentRouteDecision | undefined, assets: ConsumableAssetRef[], budget: number): {
+    sorted: KnowledgeEntry[];
+    conflicts: KnowledgeConflict[];
+    dropped: Array<{
+        id: string;
+        name: string;
+        reason: ExclusionReason;
+    }>;
+};
+/** 知识注入边界主入口，依次执行三道门并生成注入报告 */
+export declare function enforceKnowledgeInjectionBoundary(entries: KnowledgeEntry[], routeDecision: IntentRouteDecision | undefined, scopeFilters: string[], assets: ConsumableAssetRef[] | undefined, budget?: number, productFilters?: string[]): KnowledgeInjectionReport;
+/** 自治理验证知识注入报告的合规性 */
+export declare function validateInjectionReport(report: KnowledgeInjectionReport): InjectionGovernanceFinding[];
+/**
+ * Get injected entries from a report, filtering back to original KnowledgeEntry objects.
+ */
+export declare function getInjectedEntryIds(report: KnowledgeInjectionReport): string[];
+export {};
+//# sourceMappingURL=knowledge_injection_boundary.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge_injection_boundary.d.ts","sourceRoot":"","sources":["../../src/engine/knowledge_injection_boundary.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,wBAAwB,EAExB,iBAAiB,EAEjB,eAAe,EAEhB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAEL,KAAK,kBAAkB,EAExB,MAAM,gCAAgC,CAAC;AAIxC,MAAM,WAAW,0BAA0B;IACzC,QAAQ,EAAE,WAAW,GAAG,UAAU,CAAC;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,UAAU,UAAU,CAAC,CAAC;IACpB,MAAM,EAAE,CAAC,EAAE,CAAC;IACZ,QAAQ,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,eAAe,CAAA;KAAE,CAAC,CAAC;CACxE;AAoHD,kDAAkD;AAClD,wBAAgB,eAAe,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,UAAU,CAAC,cAAc,CAAC,CAmBrF;AAID,0CAA0C;AAC1C,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,cAAc,EAAE,EACzB,aAAa,EAAE,mBAAmB,GAAG,SAAS,EAC9C,YAAY,EAAE,MAAM,EAAE,EACtB,MAAM,EAAE,kBAAkB,EAAE,EAC5B,cAAc,GAAE,MAAM,EAAO,GAC5B;IACD,UAAU,EAAE,cAAc,EAAE,CAAC;IAC7B,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,QAAQ,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,eAAe,CAAA;KAAE,CAAC,CAAC;CACxE,CA4DA;AA4CD,iCAAiC;AACjC,wBAAgB,cAAc,CAC5B,OAAO,EAAE,cAAc,EAAE,EACzB,aAAa,EAAE,mBAAmB,GAAG,SAAS,EAC9C,MAAM,EAAE,kBAAkB,EAAE,EAC5B,MAAM,EAAE,MAAM,GACb;IACD,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,SAAS,EAAE,iBAAiB,EAAE,CAAC;IAC/B,OAAO,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,eAAe,CAAA;KAAE,CAAC,CAAC;CACvE,CAuEA;AAMD,+BAA+B;AAC/B,wBAAgB,iCAAiC,CAC/C,OAAO,EAAE,cAAc,EAAE,EACzB,aAAa,EAAE,mBAAmB,GAAG,SAAS,EAC9C,YAAY,EAAE,MAAM,EAAE,EACtB,MAAM,EAAE,kBAAkB,EAAE,GAAG,SAAS,EACxC,MAAM,GAAE,MAAuB,EAC/B,cAAc,GAAE,MAAM,EAAO,GAC5B,wBAAwB,CA8E1B;AAmFD,sBAAsB;AACtB,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,wBAAwB,GAAG,0BAA0B,EAAE,CA2HtG;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,wBAAwB,GAAG,MAAM,EAAE,CAO9E"}