soloforge 1.1.2 → 1.1.30

package/dist/engine/convention_detector.js

@@ -2,6 +2,7 @@ import fs from "node:fs/promises";
 import fss from "node:fs";
 import path from "node:path";
 import matter from "gray-matter";
+import { debug } from "./core/logger.js";
 /**
  * 检测项目代码惯例。
  * @description 优先加载项目中配置的惯例文件（支持 YAML front-matter 格式），
@@ -12,6 +13,7 @@ import matter from "gray-matter";
  * @returns 检测到的惯例列表
  */
 export async function detectConventions(filePaths, projectPath, conventionsFile) {
+    debug("convention_detector", "detectConventions() 开始执行");
     const conventions = [];
     // 优先加载项目中配置的惯例文件（YAML front-matter 格式，conventions 字段为数组）
     if (conventionsFile) {
@@ -30,7 +32,8 @@ export async function detectConventions(filePaths, projectPath, conventionsFile)
                     }
                 }
             }
-            catch {
+            catch (e) {
+                debug("惯例检测", "惯例文件解析失败 —", e);
                 // 惯例文件解析失败，跳过
             }
         }
@@ -45,7 +48,8 @@ export async function detectConventions(filePaths, projectPath, conventionsFile)
             const detected = analyzeFile(content, filePath);
             conventions.push(...detected);
         }
-        catch {
+        catch (e) {
+            debug("惯例检测", "文件分析失败 —", e);
             // 文件无法访问，跳过
         }
         if (conventions.length >= 10)

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/core/debug_log.d.ts

@@ -0,0 +1,5 @@
+/**
+ * @deprecated 使用 logger.ts 中的 debug() 或 debugLog()
+ */
+export { debugLog } from "./logger.js";
+//# sourceMappingURL=debug_log.d.ts.map

package/dist/engine/core/debug_log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug_log.d.ts","sourceRoot":"","sources":["../../../src/engine/core/debug_log.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC"}

package/dist/engine/core/debug_log.js

@@ -0,0 +1,5 @@
+/**
+ * @deprecated 使用 logger.ts 中的 debug() 或 debugLog()
+ */
+export { debugLog } from "./logger.js";
+//# sourceMappingURL=debug_log.js.map

package/dist/engine/core/debug_log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug_log.js","sourceRoot":"","sources":["../../../src/engine/core/debug_log.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC"}

package/dist/engine/core/git_deps.d.ts

@@ -0,0 +1,69 @@
+import type { GitFileStatus, GitLogEntry, GitDiffHunk, GitBlameLine } from "../../git/operations.js";
+/**
+ * Git 操作依赖注入模块。
+ * @description 定义 GitOperations 接口作为抽象层，并导出基于真实 Git 命令的实现（realGitOps）。
+ *              使用依赖注入模式，便于测试时替换为 mock 实现。
+ */
+/**
+ * Git 操作抽象接口。
+ * @description 封装所有项目需要的 Git 操作，包括仓库查询、状态检查、日志查看、
+ *              差异比较、分支管理和远程操作等。
+ */
+export interface GitOperations {
+    /** 检查指定目录是否为 Git 仓库 */
+    isGitRepo(cwd: string): Promise<boolean>;
+    /** 获取 Git 仓库根目录路径 */
+    getRootDir(cwd: string): Promise<string>;
+    /** 获取当前分支名称 */
+    getCurrentBranch(cwd: string): Promise<string>;
+    /** 检查工作区是否干净（无未提交变更） */
+    isClean(cwd: string): Promise<boolean>;
+    /** 获取工作区文件状态列表 */
+    getStatus(cwd: string): Promise<GitFileStatus[]>;
+    /** 获取提交日志，支持按数量、时间、作者和路径过滤 */
+    getLog(cwd: string, options?: {
+        maxCount?: number;
+        since?: string;
+        author?: string;
+        path?: string;
+    }): Promise<GitLogEntry[]>;
+    /** 获取简短日志摘要（按作者分组统计提交数） */
+    getShortlog(cwd: string, since?: string): Promise<Array<{
+        author: string;
+        count: number;
+    }>>;
+    /** 获取差异信息（结构化 Hunk 列表） */
+    getDiff(cwd: string, options?: {
+        cached?: boolean;
+        path?: string;
+    }): Promise<GitDiffHunk[]>;
+    /** 获取指定文件的差异补丁文本 */
+    getDiffPatch(cwd: string, filePath: string, options?: {
+        cached?: boolean;
+    }): Promise<string>;
+    /** 获取指定文件的逐行 Blame 信息 */
+    getBlame(cwd: string, filePath: string): Promise<GitBlameLine[]>;
+    /** 列出所有本地分支及其当前标记 */
+    listBranches(cwd: string): Promise<Array<{
+        name: string;
+        isCurrent: boolean;
+    }>>;
+    /** 将文件添加到暂存区 */
+    add(cwd: string, paths: string[]): Promise<void>;
+    /** 创建提交，返回提交 SHA */
+    commit(cwd: string, message: string): Promise<string>;
+    /** 推送到远程仓库，返回推送结果 */
+    push(cwd: string, remote?: string, branch?: string): Promise<string>;
+    /** 获取两个分支的最新公共祖先提交 SHA */
+    getMergeBase(cwd: string, branchA: string, branchB: string): Promise<string>;
+    /** 获取远程仓库 URL，不存在则返回 null */
+    getRemoteUrl(cwd: string, remote?: string): Promise<string | null>;
+    /** 获取 HEAD 的短 commit hash */
+    getHeadCommitHash(cwd: string): Promise<string>;
+}
+/**
+ * 基于真实 Git 命令的 GitOperations 实现。
+ * @description 导出 realGitOps 实例，将所有 Git 操作委托给真实的 git 命令行工具。
+ */
+export declare const realGitOps: GitOperations;
+//# sourceMappingURL=git_deps.d.ts.map

package/dist/engine/core/git_deps.d.ts.map

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

package/dist/engine/core/git_deps.js

@@ -0,0 +1,9 @@
+import * as ops from "../../git/operations.js";
+import { debug } from "./logger.js";
+/**
+ * 基于真实 Git 命令的 GitOperations 实现。
+ * @description 导出 realGitOps 实例，将所有 Git 操作委托给真实的 git 命令行工具。
+ */
+export const realGitOps = ops;
+debug("GitDeps", "已加载真实 Git 操作实现");
+//# sourceMappingURL=git_deps.js.map

package/dist/engine/core/git_deps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git_deps.js","sourceRoot":"","sources":["../../../src/engine/core/git_deps.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,GAAG,MAAM,yBAAyB,CAAC;AAC/C,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAkDpC;;;GAGG;AACH,MAAM,CAAC,MAAM,UAAU,GAAkB,GAAG,CAAC;AAE7C,KAAK,CAAC,SAAS,EAAE,gBAAgB,CAAC,CAAC"}

package/dist/engine/core/helpers.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Safe replacement for `match.index!` — returns 0 as fallback instead of throwing.
+ */
+export declare function safeMatchIndex(m: RegExpMatchArray): number;
+/**
+ * Safe replacement for `match.groups!.xxx` — returns empty object as fallback.
+ */
+export declare function safeMatchGroups(m: RegExpMatchArray): Record<string, string>;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/engine/core/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../src/engine/core/helpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,gBAAgB,GAAG,MAAM,CAE1D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAE3E"}

package/dist/engine/core/helpers.js

@@ -0,0 +1,13 @@
+/**
+ * Safe replacement for `match.index!` — returns 0 as fallback instead of throwing.
+ */
+export function safeMatchIndex(m) {
+    return typeof m.index === "number" ? m.index : 0;
+}
+/**
+ * Safe replacement for `match.groups!.xxx` — returns empty object as fallback.
+ */
+export function safeMatchGroups(m) {
+    return (m.groups ?? {});
+}
+//# sourceMappingURL=helpers.js.map

package/dist/engine/core/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../../src/engine/core/helpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,CAAmB;IAChD,OAAO,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AACnD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,CAAmB;IACjD,OAAO,CAAC,CAAC,CAAC,MAAM,IAAI,EAAE,CAA2B,CAAC;AACpD,CAAC"}

package/dist/engine/core/io_controller.d.ts

@@ -0,0 +1,87 @@
+/**
+ * 极化工作区锁 — 防止人类在 AI 长耗时推演期间手动修改代码导致静默覆盖。
+ *
+ * 机制:
+ * 1. 长耗时任务开始时生成 .soloforge.lock，记录 Git 工作树 Hash + 文件修改时间
+ * 2. 任务完成准备写入前，校验当前 Git 工作树 Hash 和文件 mtime
+ * 3. 若检测到外部变更 → 抛出 DirtyWorkspaceError，中断覆盖，要求 Diff 合并
+ *
+ * 锁文件格式 (JSON):
+ * {
+ *   "task_id": "task-xxx",
+ *   "acquired_at": "ISO timestamp",
+ *   "git_tree_hash": "sha256 of git diff HEAD output",
+ *   "file_snapshots": { "path": { "mtime_ms": 123, "size": 456, "hash": "sha256" } }
+ * }
+ */
+/** 文件快照 */
+interface FileSnapshot {
+    mtime_ms: number;
+    size: number;
+    hash: string;
+}
+/** 校验结果 */
+export interface WorkspaceIntegrityResult {
+    /** 是否一致（无外部变更） */
+    clean: boolean;
+    /** 被外部修改的文件列表 */
+    dirty_files: string[];
+    /** Git 工作树是否变化 */
+    git_changed: boolean;
+    /** 诊断消息 */
+    message: string;
+}
+/**
+ * 工作区脏数据异常 — 检测到外部修改时抛出。
+ * 调用方必须捕获此异常并启动 Diff 合并流程。
+ */
+export declare class DirtyWorkspaceError extends Error {
+    /** 被修改的文件列表 */
+    readonly dirtyFiles: string[];
+    /** 锁文件中的原始快照 */
+    readonly originalSnapshots: Record<string, FileSnapshot>;
+    /** 任务 ID */
+    readonly taskId: string;
+    constructor(dirtyFiles: string[], snapshots: Record<string, FileSnapshot>, taskId: string);
+}
+export declare class IOController {
+    private projectPath;
+    private lockPath;
+    constructor(projectPath: string);
+    /**
+     * 获取工作区锁。
+     * 扫描目标文件并生成快照，写入锁文件。
+     * @param taskId - 任务 ID
+     * @param targetFiles - 目标文件列表（将要修改的文件）
+     * @param reason - 加锁原因
+     */
+    acquire(taskId: string, targetFiles: string[], reason: string): Promise<void>;
+    /**
+     * 校验工作区完整性 — 写入前必须调用。
+     * @returns 校验结果
+     * @throws DirtyWorkspaceError 当检测到外部修改时
+     */
+    verify(): Promise<WorkspaceIntegrityResult>;
+    /**
+     * 写入前强制校验 — 不通过则抛出 DirtyWorkspaceError。
+     * @throws DirtyWorkspaceError
+     */
+    assertClean(): Promise<void>;
+    /**
+     * 释放工作区锁 — 任务完成或取消后调用。
+     */
+    release(): Promise<void>;
+    /**
+     * 检查工作区是否被锁定。
+     */
+    isLocked(): Promise<{
+        locked: boolean;
+        task_id?: string;
+        reason?: string;
+    }>;
+    private readLock;
+    private snapshotFiles;
+    private computeGitTreeHash;
+}
+export {};
+//# sourceMappingURL=io_controller.d.ts.map

package/dist/engine/core/io_controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"io_controller.d.ts","sourceRoot":"","sources":["../../../src/engine/core/io_controller.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;;;;;;GAeG;AAIH,WAAW;AACX,UAAU,YAAY;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAWD,WAAW;AACX,MAAM,WAAW,wBAAwB;IACvC,kBAAkB;IAClB,KAAK,EAAE,OAAO,CAAC;IACf,iBAAiB;IACjB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,kBAAkB;IAClB,WAAW,EAAE,OAAO,CAAC;IACrB,WAAW;IACX,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,eAAe;IACf,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC;IAC9B,gBAAgB;IAChB,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACzD,YAAY;IACZ,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBAGtB,UAAU,EAAE,MAAM,EAAE,EACpB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,EACvC,MAAM,EAAE,MAAM;CAajB;AAID,qBAAa,YAAY;IACvB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,QAAQ,CAAS;gBAEb,WAAW,EAAE,MAAM;IAK/B;;;;;;OAMG;IACG,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiCnF;;;;OAIG;IACG,MAAM,IAAI,OAAO,CAAC,wBAAwB,CAAC;IAiDjD;;;OAGG;IACG,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAclC;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAS9B;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC;QAAE,MAAM,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;YASnE,QAAQ;YASR,aAAa;YAmBb,kBAAkB;CAejC"}

package/dist/engine/core/io_controller.js

@@ -0,0 +1,203 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import crypto from "node:crypto";
+import { debug } from "./logger.js";
+/**
+ * 工作区脏数据异常 — 检测到外部修改时抛出。
+ * 调用方必须捕获此异常并启动 Diff 合并流程。
+ */
+export class DirtyWorkspaceError extends Error {
+    /** 被修改的文件列表 */
+    dirtyFiles;
+    /** 锁文件中的原始快照 */
+    originalSnapshots;
+    /** 任务 ID */
+    taskId;
+    constructor(dirtyFiles, snapshots, taskId) {
+        const fileList = dirtyFiles.length <= 5
+            ? dirtyFiles.join(", ")
+            : `${dirtyFiles.slice(0, 5).join(", ")} 等 ${dirtyFiles.length} 个文件`;
+        super(`⚠ 工作区已被外部修改: ${fileList}。禁止静默覆盖，必须启动 Diff 合并流程`);
+        this.name = "DirtyWorkspaceError";
+        this.dirtyFiles = dirtyFiles;
+        this.originalSnapshots = snapshots;
+        this.taskId = taskId;
+    }
+}
+// ── 核心实现 ──
+export class IOController {
+    projectPath;
+    lockPath;
+    constructor(projectPath) {
+        this.projectPath = projectPath;
+        this.lockPath = path.join(projectPath, ".soloforge.lock");
+    }
+    /**
+     * 获取工作区锁。
+     * 扫描目标文件并生成快照，写入锁文件。
+     * @param taskId - 任务 ID
+     * @param targetFiles - 目标文件列表（将要修改的文件）
+     * @param reason - 加锁原因
+     */
+    async acquire(taskId, targetFiles, reason) {
+        debug("IOController", "获取工作区锁", { taskId, reason, targetFileCount: targetFiles.length });
+        // 原子获取锁：直接尝试创建锁文件（O_EXCL），避免 TOCTOU 竞态
+        // 先准备锁数据
+        const gitHash = await this.computeGitTreeHash();
+        const snapshots = await this.snapshotFiles(targetFiles);
+        const lock = {
+            task_id: taskId,
+            acquired_at: new Date().toISOString(),
+            reason,
+            git_tree_hash: gitHash,
+            file_snapshots: snapshots,
+        };
+        try {
+            // O_EXCL (wx): 原子创建锁文件 — 文件已存在时抛出 EEXIST，消除 check-then-create 竞态窗口
+            const handle = await fs.open(this.lockPath, "wx");
+            await handle.writeFile(JSON.stringify(lock, null, 2));
+            await handle.close();
+        }
+        catch (e) {
+            if (e instanceof Error && "code" in e && e.code === "EEXIST") {
+                // 锁文件已存在 — 读取现有锁信息给出友好提示
+                const existing = await this.readLock();
+                debug("IOController", "工作区已被锁定", { existingTaskId: existing?.task_id });
+                throw new Error(`工作区已被任务 ${existing?.task_id} 锁定（原因: ${existing?.reason}，时间: ${existing?.acquired_at}）。请等待完成或手动删除 ${this.lockPath}`);
+            }
+            throw e;
+        }
+    }
+    /**
+     * 校验工作区完整性 — 写入前必须调用。
+     * @returns 校验结果
+     * @throws DirtyWorkspaceError 当检测到外部修改时
+     */
+    async verify() {
+        debug("IOController", "校验工作区完整性");
+        const lock = await this.readLock();
+        if (!lock) {
+            return { clean: true, dirty_files: [], git_changed: false, message: "无活跃锁" };
+        }
+        const dirtyFiles = [];
+        // 校验每个文件快照
+        for (const [filePath, snapshot] of Object.entries(lock.file_snapshots)) {
+            const fullPath = path.join(this.projectPath, filePath);
+            try {
+                const stat = await fs.stat(fullPath);
+                const content = await fs.readFile(fullPath);
+                const hash = computeHash(content);
+                if (stat.mtimeMs !== snapshot.mtime_ms || hash !== snapshot.hash) {
+                    dirtyFiles.push(filePath);
+                }
+            }
+            catch {
+                // 文件被删除也算脏
+                dirtyFiles.push(filePath);
+            }
+        }
+        // 校验 Git 工作树
+        const currentGitHash = await this.computeGitTreeHash();
+        const gitChanged = currentGitHash !== lock.git_tree_hash;
+        const clean = dirtyFiles.length === 0 && !gitChanged;
+        let message;
+        if (clean) {
+            message = "工作区一致，可安全写入";
+        }
+        else {
+            const parts = [];
+            if (dirtyFiles.length > 0) {
+                parts.push(`${dirtyFiles.length} 个文件被外部修改`);
+            }
+            if (gitChanged) {
+                parts.push("Git 工作树发生变化");
+            }
+            message = `⚠ 工作区不一致: ${parts.join("，")}。禁止覆盖，需 Diff 合并`;
+        }
+        return { clean, dirty_files: dirtyFiles, git_changed: gitChanged, message };
+    }
+    /**
+     * 写入前强制校验 — 不通过则抛出 DirtyWorkspaceError。
+     * @throws DirtyWorkspaceError
+     */
+    async assertClean() {
+        debug("IOController", "写入前强制校验工作区");
+        const result = await this.verify();
+        if (!result.clean) {
+            debug("IOController", "工作区不干净，抛出 DirtyWorkspaceError", { dirtyFiles: result.dirty_files });
+            const lock = await this.readLock();
+            throw new DirtyWorkspaceError(result.dirty_files, lock?.file_snapshots ?? {}, lock?.task_id ?? "unknown");
+        }
+    }
+    /**
+     * 释放工作区锁 — 任务完成或取消后调用。
+     */
+    async release() {
+        debug("IOController", "释放工作区锁");
+        try {
+            await fs.unlink(this.lockPath);
+        }
+        catch {
+            // 锁文件不存在，忽略
+        }
+    }
+    /**
+     * 检查工作区是否被锁定。
+     */
+    async isLocked() {
+        debug("IOController", "检查工作区锁定状态");
+        const lock = await this.readLock();
+        if (!lock)
+            return { locked: false };
+        return { locked: true, task_id: lock.task_id, reason: lock.reason };
+    }
+    // ── 内部方法 ──
+    async readLock() {
+        try {
+            const data = await fs.readFile(this.lockPath, "utf-8");
+            return JSON.parse(data);
+        }
+        catch {
+            return null;
+        }
+    }
+    async snapshotFiles(files) {
+        const snapshots = {};
+        for (const filePath of files) {
+            const fullPath = path.join(this.projectPath, filePath);
+            try {
+                const stat = await fs.stat(fullPath);
+                const content = await fs.readFile(fullPath);
+                snapshots[filePath] = {
+                    mtime_ms: stat.mtimeMs,
+                    size: stat.size,
+                    hash: computeHash(content),
+                };
+            }
+            catch {
+                // 文件不存在，跳过（新建文件的场景）
+            }
+        }
+        return snapshots;
+    }
+    async computeGitTreeHash() {
+        try {
+            const { execFileSync } = await import("node:child_process");
+            const diff = execFileSync("git", ["diff", "HEAD", "--stat"], {
+                cwd: this.projectPath,
+                encoding: "utf-8",
+                timeout: 5000,
+                stdio: ["pipe", "pipe", "pipe"],
+            });
+            return computeHash(Buffer.from(diff));
+        }
+        catch {
+            // 非 Git 仓库或 git 不可用 — 用时间戳作为哈希
+            return computeHash(Buffer.from(new Date().toISOString().split("T")[0]));
+        }
+    }
+}
+function computeHash(data) {
+    return crypto.createHash("sha256").update(data).digest("hex").slice(0, 16);
+}
+//# sourceMappingURL=io_controller.js.map

package/dist/engine/core/io_controller.js.map

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

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

@@ -0,0 +1,28 @@
+/**
+ * 知识配置读取器（core/ 内部副本）。
+ *
+ * 此文件是 knowledge/knowledge_config_loader.ts 的精简版本，
+ * 仅供 core/ 模块使用，避免 core/ 反向依赖 knowledge/。
+ *
+ * knowledge/ 子目录的完整版本包含缓存、路径重映射等高级功能。
+ * core/ 版本仅保留 loadKnowledgeConfig + extractNumberRule 两个核心函数。
+ */
+/**
+ * 从知识库中加载指定 .md 文件的 frontmatter 和 body。
+ * @param relativePath - 相对于 knowledge/ 的路径
+ * @param projectPath - 项目根目录
+ * @returns frontmatter data + body，文件不存在时返回 null
+ */
+export declare function loadKnowledgeConfig(relativePath: string, projectPath?: string): {
+    data: Record<string, unknown>;
+    body: string;
+} | null;
+/**
+ * 从知识文件的决策规则中提取指定键的数值。
+ */
+export declare function extractNumberRule(body: string, key: string): number | undefined;
+/**
+ * 清除知识配置缓存（测试用）。
+ */
+export declare function clearConfigCache(): void;
+//# sourceMappingURL=knowledge_config_loader.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge_config_loader.d.ts","sourceRoot":"","sources":["../../../src/engine/core/knowledge_config_loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAyCH;;;;;GAKG;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,CAoCxD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAI/E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAGvC"}

package/dist/engine/core/knowledge_config_loader.js

@@ -0,0 +1,102 @@
+/**
+ * 知识配置读取器（core/ 内部副本）。
+ *
+ * 此文件是 knowledge/knowledge_config_loader.ts 的精简版本，
+ * 仅供 core/ 模块使用，避免 core/ 反向依赖 knowledge/。
+ *
+ * knowledge/ 子目录的完整版本包含缓存、路径重映射等高级功能。
+ * core/ 版本仅保留 loadKnowledgeConfig + extractNumberRule 两个核心函数。
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import matter from "gray-matter";
+import { debug } from "./logger.js";
+/** 知识配置缓存 */
+const configCache = new Map();
+const CACHE_TTL = 5 * 60 * 1000; // 缓存有效期：5 分钟
+/** 包内模板知识库根目录 */
+function getTemplatesRoot() {
+    const thisDir = path.dirname(fileURLToPath(import.meta.url));
+    // src/engine/core/ → ../../../ → 项目根 → templates
+    return path.resolve(thisDir, "..", "..", "..", "templates");
+}
+/** 项目知识库根目录 */
+function getKnowledgeRoot(projectPath) {
+    return path.join(projectPath ?? process.cwd(), ".soloforge", "knowledge");
+}
+/**
+ * 将旧的知识路径映射到新的类型优先路径。
+ */
+function remapLegacyPath(relativePath) {
+    let mapped = relativePath.replace(/^patterns\/core\//, "internal/patterns/");
+    if (!mapped.startsWith("patterns/core/")) {
+        mapped = mapped.replace(/^patterns\/(?!core)/, "patterns/");
+    }
+    if (mapped.startsWith("rules/") && !mapped.startsWith("rules/shared/")) {
+        mapped = mapped.replace(/^rules\//, "internal/rules/");
+    }
+    mapped = mapped.replace(/^review_rules\//, "rules/shared/");
+    mapped = mapped.replace(/^acceptance_templates\//, "artifacts/shared/");
+    mapped = mapped.replace(/^product_profiles\//, "profiles/");
+    return mapped;
+}
+/**
+ * 从知识库中加载指定 .md 文件的 frontmatter 和 body。
+ * @param relativePath - 相对于 knowledge/ 的路径
+ * @param projectPath - 项目根目录
+ * @returns frontmatter data + body，文件不存在时返回 null
+ */
+export function loadKnowledgeConfig(relativePath, projectPath) {
+    debug("CoreKnowledgeConfigLoader", "加载知识配置", relativePath);
+    const projectRoot = projectPath ?? process.cwd();
+    const cacheKey = `${projectRoot}::${relativePath}`;
+    const projectFile = path.join(getKnowledgeRoot(projectPath), relativePath);
+    const templateFile = path.join(getTemplatesRoot(), remapLegacyPath(relativePath));
+    const useProject = fs.existsSync(projectFile);
+    const filePath = useProject ? projectFile : templateFile;
+    if (!fs.existsSync(filePath)) {
+        debug("CoreKnowledgeConfigLoader", "知识文件不存在", filePath);
+        return null;
+    }
+    let mtime = 0;
+    if (useProject) {
+        try {
+            mtime = fs.statSync(filePath).mtimeMs;
+        }
+        catch { /* 忽略 */ }
+    }
+    const cached = configCache.get(cacheKey);
+    if (cached) {
+        const mtimeMatch = !useProject || cached.mtime === mtime;
+        if (mtimeMatch && Date.now() - cached.loadedAt < CACHE_TTL) {
+            return { data: cached.data, body: cached.body };
+        }
+    }
+    try {
+        const raw = fs.readFileSync(filePath, "utf-8");
+        const { data, content: body } = matter(raw);
+        configCache.set(cacheKey, { data: data, body, mtime, loadedAt: Date.now() });
+        return { data: data, body };
+    }
+    catch {
+        debug("CoreKnowledgeConfigLoader", "读取知识文件失败", filePath);
+        return null;
+    }
+}
+/**
+ * 从知识文件的决策规则中提取指定键的数值。
+ */
+export function extractNumberRule(body, key) {
+    const regex = new RegExp(`${key.replace(/_/g, "[_ ]")}\\s*=\\s*([\\d.]+)`, "i");
+    const match = body.match(regex);
+    return match ? parseFloat(match[1]) : undefined;
+}
+/**
+ * 清除知识配置缓存（测试用）。
+ */
+export function clearConfigCache() {
+    debug("CoreKnowledgeConfigLoader", "清除配置缓存");
+    configCache.clear();
+}
+//# sourceMappingURL=knowledge_config_loader.js.map

package/dist/engine/core/knowledge_config_loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge_config_loader.js","sourceRoot":"","sources":["../../../src/engine/core/knowledge_config_loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEpC,aAAa;AACb,MAAM,WAAW,GAAG,IAAI,GAAG,EAA4F,CAAC;AACxH,MAAM,SAAS,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,aAAa;AAE9C,iBAAiB;AACjB,SAAS,gBAAgB;IACvB,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAC7D,iDAAiD;IACjD,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;AAC9D,CAAC;AAED,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;;GAEG;AACH,SAAS,eAAe,CAAC,YAAoB;IAC3C,IAAI,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC,mBAAmB,EAAE,oBAAoB,CAAC,CAAC;IAC7E,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,gBAAgB,CAAC,EAAE,CAAC;QACzC,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,qBAAqB,EAAE,WAAW,CAAC,CAAC;IAC9D,CAAC;IACD,IAAI,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;QACvE,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,UAAU,EAAE,iBAAiB,CAAC,CAAC;IACzD,CAAC;IACD,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,iBAAiB,EAAE,eAAe,CAAC,CAAC;IAC5D,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,yBAAyB,EAAE,mBAAmB,CAAC,CAAC;IACxE,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,qBAAqB,EAAE,WAAW,CAAC,CAAC;IAC5D,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CACjC,YAAoB,EACpB,WAAoB;IAEpB,KAAK,CAAC,2BAA2B,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC;IAE3D,MAAM,WAAW,GAAG,WAAW,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IACjD,MAAM,QAAQ,GAAG,GAAG,WAAW,KAAK,YAAY,EAAE,CAAC;IAEnD,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,WAAW,CAAC,EAAE,YAAY,CAAC,CAAC;IAC3E,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,EAAE,eAAe,CAAC,YAAY,CAAC,CAAC,CAAC;IAClF,MAAM,UAAU,GAAG,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;IAC9C,MAAM,QAAQ,GAAG,UAAU,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,YAAY,CAAC;IACzD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7B,KAAK,CAAC,2BAA2B,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;QACxD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,UAAU,EAAE,CAAC;QACf,IAAI,CAAC;YAAC,KAAK,GAAG,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,CAAC;IACnE,CAAC;IACD,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACzC,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,UAAU,GAAG,CAAC,UAAU,IAAI,MAAM,CAAC,KAAK,KAAK,KAAK,CAAC;QACzD,IAAI,UAAU,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,QAAQ,GAAG,SAAS,EAAE,CAAC;YAC3D,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;QAClD,CAAC;IACH,CAAC;IAED,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,KAAK,EAAE,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QACxG,OAAO,EAAE,IAAI,EAAE,IAA+B,EAAE,IAAI,EAAE,CAAC;IACzD,CAAC;IAAC,MAAM,CAAC;QACP,KAAK,CAAC,2BAA2B,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC;QACzD,OAAO,IAAI,CAAC;IACd,CAAC;AACH,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,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,gBAAgB;IAC9B,KAAK,CAAC,2BAA2B,EAAE,QAAQ,CAAC,CAAC;IAC7C,WAAW,CAAC,KAAK,EAAE,CAAC;AACtB,CAAC"}