soloforge 1.1.2 → 1.1.30

package/dist/engine/knowledge/knowledge_manager.js

@@ -0,0 +1,934 @@
+import fs from "node:fs/promises";
+import fss from "node:fs";
+import path from "node:path";
+import matter from "gray-matter";
+import { KnowledgeWriter } from "../../knowledge/writer.js";
+import { debug } from "../core/logger.js";
+/**
+ * 审计知识库健康度。
+ * 检查五个维度: 陈旧条目、重复触发词、格式规范、类型覆盖、内容完整度。
+ * @param knowledgeIndex - 知识索引管理器
+ * @param config - 项目配置
+ * @returns 审计结果，包含发现项和统计摘要
+ */
+export async function auditKnowledge(knowledgeIndex, config) {
+    debug("知识审计", "开始审计知识库健康度");
+    const { global: globalEntries, project: projectEntries } = knowledgeIndex.getAllEntries();
+    const all = [...globalEntries, ...projectEntries];
+    const findings = [];
+    const now = Date.now();
+    let findingId = 0;
+    // 1. 陈旧条目: 超过 90 天未使用或从未被匹配
+    for (const entry of all) {
+        if (entry.status === "deprecated")
+            continue;
+        if (entry.usage_count === 0) {
+            findings.push({
+                id: `AUD-${String(++findingId).padStart(3, "0")}`,
+                severity: "info",
+                category: "stale",
+                entry_name: entry.name,
+                message: `从未被匹配使用: ${entry.name}`,
+                suggestion: "检查 when 触发词是否覆盖实际场景，或标记为 deprecated",
+            });
+        }
+        else if (entry.last_used_at) {
+            const daysSinceUse = (now - new Date(entry.last_used_at).getTime()) / (1000 * 60 * 60 * 24);
+            if (daysSinceUse > 90) {
+                findings.push({
+                    id: `AUD-${String(++findingId).padStart(3, "0")}`,
+                    severity: "warning",
+                    category: "stale",
+                    entry_name: entry.name,
+                    message: `超过 ${Math.floor(daysSinceUse)} 天未被使用: ${entry.name}`,
+                    suggestion: "评估是否仍需要，考虑更新触发词或标记为 deprecated",
+                });
+            }
+        }
+    }
+    // 2. 重复检查: 相似触发词
+    for (let i = 0; i < all.length; i++) {
+        for (let j = i + 1; j < all.length; j++) {
+            if (all[i].type !== all[j].type)
+                continue;
+            const overlap = keywordOverlap(all[i].when, all[j].when);
+            if (overlap >= 0.6) {
+                findings.push({
+                    id: `AUD-${String(++findingId).padStart(3, "0")}`,
+                    severity: "info",
+                    category: "duplicate",
+                    entry_name: `${all[i].name} / ${all[j].name}`,
+                    message: `触发词高度重叠 (${Math.round(overlap * 100)}%): "${all[i].name}" 和 "${all[j].name}"`,
+                    suggestion: "考虑合并或区分触发词",
+                });
+            }
+        }
+    }
+    // 3. 格式检查: 缺失必需的 frontmatter 字段 + Schema 验证
+    for (const entry of all) {
+        if (entry.status === "deprecated")
+            continue;
+        const issues = [];
+        if (!entry.when || entry.when.trim().length === 0)
+            issues.push("when");
+        if (!entry.scope || entry.scope.length === 0)
+            issues.push("scope");
+        if (!entry.products || entry.products.length === 0)
+            issues.push("products");
+        if (issues.length > 0) {
+            findings.push({
+                id: `AUD-${String(++findingId).padStart(3, "0")}`,
+                severity: "warning",
+                category: "format",
+                entry_name: entry.name,
+                message: `缺少必需字段: ${issues.join(", ")}`,
+                suggestion: `补充 ${issues.join("、")} 字段`,
+            });
+        }
+        // 3b. Schema 验证: 读取原始文件进行深度检查
+        const schemaIssues = await validateFormatSchema(entry);
+        for (const issue of schemaIssues) {
+            findings.push({
+                id: `AUD-${String(++findingId).padStart(3, "0")}`,
+                severity: "info",
+                category: "format",
+                entry_name: entry.name,
+                message: issue.message,
+                suggestion: issue.suggestion,
+            });
+        }
+    }
+    // 4. 覆盖度检查: 确保各知识类型都有条目
+    const requiredTypes = ["pattern", "procedure", "domain", "review_rule"];
+    for (const type of requiredTypes) {
+        const count = all.filter((e) => e.type === type && e.status !== "deprecated").length;
+        if (count === 0) {
+            findings.push({
+                id: `AUD-${String(++findingId).padStart(3, "0")}`,
+                severity: "warning",
+                category: "coverage",
+                entry_name: `type=${type}`,
+                message: `缺少 ${type} 类型的知识条目`,
+                suggestion: `新增至少一个 ${type} 条目`,
+            });
+        }
+    }
+    // 5. 完整度检查: 检查规则/验收项数量是否达到类型阈值
+    for (const entry of all) {
+        if (entry.status === "deprecated")
+            continue;
+        if (!entry.file_path || !fss.existsSync(entry.file_path))
+            continue;
+        const thresholds = COMPLETENESS_THRESHOLDS[entry.type];
+        if (!thresholds)
+            continue;
+        let raw;
+        try {
+            raw = await fs.readFile(entry.file_path, "utf-8");
+        }
+        catch {
+            continue;
+        }
+        const { content: body } = matter(raw);
+        for (const check of thresholds) {
+            const count = countPattern(body, check.pattern);
+            if (count < check.minimum) {
+                findings.push({
+                    id: `AUD-${String(++findingId).padStart(3, "0")}`,
+                    severity: "info",
+                    category: "completeness",
+                    entry_name: entry.name,
+                    message: `${entry.type} 条目"${entry.name}"的 ${check.field} 不足：实际 ${count} 条，要求 ≥ ${check.minimum} 条`,
+                    suggestion: `运行 sf_knowledge_update 补充 ${check.field}，或调用 sf_knowledge_add 的 auto_enrich 机制自动探索行业最佳实践`,
+                });
+            }
+        }
+    }
+    const summary = {
+        stale: findings.filter((f) => f.category === "stale").length,
+        duplicate: findings.filter((f) => f.category === "duplicate").length,
+        format: findings.filter((f) => f.category === "format").length,
+        coverage: findings.filter((f) => f.category === "coverage").length,
+        completeness: findings.filter((f) => f.category === "completeness").length,
+        design_drift: 0,
+    };
+    debug("知识审计", `完成，共 ${findings.length} 项发现`);
+    return {
+        total_entries: all.filter((e) => e.status !== "deprecated").length,
+        findings,
+        summary,
+        audited_at: new Date().toISOString(),
+    };
+}
+/**
+ * 新增知识条目。
+ * 根据类型生成对应的模板内容，保存到草稿目录或正式目录。
+ * @param input - 新增知识条目输入
+ * @param config - 项目配置
+ * @returns 新增结果，包含文件路径和消息
+ */
+export async function addKnowledge(input, config) {
+    debug("知识管理", `新增知识条目「${input.title}」[${input.type}]`);
+    const knowledgeDir = getProjectKnowledgeDir(config);
+    const fileName = `${path.basename(input.title)}.md`; // basename 防止路径穿越
+    // 确定保存位置
+    const typeDir = getTypeDirectory(input.type);
+    const draftsDir = path.join(knowledgeDir, "drafts");
+    const targetDir = input.save_to_drafts !== false
+        ? draftsDir
+        : path.join(knowledgeDir, typeDir);
+    // 确保目录存在
+    await fs.mkdir(targetDir, { recursive: true });
+    const filePath = path.join(targetDir, fileName);
+    // 检查文件是否已存在
+    if (fss.existsSync(filePath)) {
+        return {
+            success: false,
+            file_path: filePath,
+            is_draft: input.save_to_drafts !== false,
+            message: `文件已存在: ${filePath}，请使用 sf_knowledge_update 更新`,
+        };
+    }
+    // 生成内容
+    const content = generateKnowledgeContent(input);
+    await fs.writeFile(filePath, content, "utf-8");
+    const enrichment_guide = input.auto_enrich !== false
+        ? buildEnrichmentGuide(input)
+        : undefined;
+    debug("知识管理", `知识条目已保存到 ${filePath}`);
+    return {
+        success: true,
+        file_path: filePath,
+        is_draft: input.save_to_drafts !== false,
+        message: input.save_to_drafts !== false
+            ? `知识条目草稿已保存到: ${filePath}\n人工 review 后可移至正式目录: ${path.join(knowledgeDir, typeDir, fileName)}`
+            : `知识条目已保存到: ${filePath}`,
+        enrichment_guide,
+    };
+}
+/**
+ * 更新已有的知识条目。
+ * 更新前自动创建备份，支持修改触发条件、状态、决策规则和验收标准。
+ * @param input - 更新输入参数
+ * @param knowledgeIndex - 知识索引管理器
+ * @param config - 项目配置
+ * @returns 更新结果，包含文件路径和备份路径
+ */
+export async function updateKnowledge(input, knowledgeIndex, config) {
+    debug("知识管理", `更新知识条目「${input.entry_name}」`);
+    const entry = knowledgeIndex.getEntry(input.entry_name)
+        ?? knowledgeIndex.getAllEntries().global.find((e) => e.name === input.entry_name)
+        ?? knowledgeIndex.getAllEntries().project.find((e) => e.name === input.entry_name);
+    if (!entry) {
+        debug("知识管理", `未找到知识条目「${input.entry_name}」`);
+        return {
+            success: false,
+            file_path: "",
+            backup_path: "",
+            message: `未找到知识条目: ${input.entry_name}`,
+        };
+    }
+    const filePath = entry.file_path;
+    // 维度6: 知识目录隔离 — 禁止更新 core/ 只读目录中的条目
+    if (KnowledgeWriter.isCorePath(filePath)) {
+        debug("知识管理", `「${input.entry_name}」位于 core/ 只读目录，禁止自动更新`);
+        return {
+            success: false,
+            file_path: filePath,
+            backup_path: "",
+            message: `知识隔离: "${entry.name}" 位于 core/ 只读目录，禁止自动更新。需人工手动维护`,
+        };
+    }
+    if (!fss.existsSync(filePath)) {
+        return {
+            success: false,
+            file_path: filePath,
+            backup_path: "",
+            message: `文件不存在: ${filePath}`,
+        };
+    }
+    // 读取并解析文件
+    const raw = await fs.readFile(filePath, "utf-8");
+    const { data: frontmatter, content: body } = matter(raw);
+    // 创建备份
+    const backupDir = path.join(path.dirname(filePath), ".backups");
+    await fs.mkdir(backupDir, { recursive: true });
+    const backupPath = path.join(backupDir, `${entry.name}-${Date.now()}.md`);
+    await fs.writeFile(backupPath, raw, "utf-8");
+    // 应用更新
+    let updated = false;
+    if (input.updates.when_triggers) {
+        frontmatter.when = input.updates.when_triggers;
+        updated = true;
+    }
+    if (input.updates.status) {
+        frontmatter.status = input.updates.status;
+        updated = true;
+    }
+    let newBody = body;
+    if (input.updates.add_decision_rules?.length) {
+        const rulesSection = input.updates.add_decision_rules
+            .map((r) => `- ${r}`)
+            .join("\n");
+        if (newBody.includes("## 决策规则")) {
+            newBody = newBody.replace(/## 决策规则\n/, `## 决策规则\n${rulesSection}\n`);
+        }
+        else {
+            newBody += `\n\n## 决策规则\n${rulesSection}\n`;
+        }
+        updated = true;
+    }
+    if (input.updates.add_acceptance_criteria?.length) {
+        const acSection = input.updates.add_acceptance_criteria
+            .map((ac, i) => `- [AC-${String(i + 1).padStart(2, "0")}] ${ac}`)
+            .join("\n");
+        if (newBody.includes("## 验收项")) {
+            newBody = newBody.replace(/## 验收项\n/, `## 验收项\n${acSection}\n`);
+        }
+        else {
+            newBody += `\n\n## 验收项\n${acSection}\n`;
+        }
+        updated = true;
+    }
+    if (!updated) {
+        return {
+            success: false,
+            file_path: filePath,
+            backup_path: backupPath,
+            message: "未提供任何更新内容",
+        };
+    }
+    // 写入更新后的文件
+    const output = matter.stringify(newBody, frontmatter);
+    await fs.writeFile(filePath, output, "utf-8");
+    debug("知识管理", `知识条目「${input.entry_name}」已更新，备份: ${backupPath}`);
+    return {
+        success: true,
+        file_path: filePath,
+        backup_path: backupPath,
+        message: `知识条目已更新: ${filePath}\n备份: ${backupPath}`,
+    };
+}
+// ── 格式 Schema ──
+/** 规范的 frontmatter 字段顺序 */
+const CANONICAL_FM_ORDER = ["name", "type", "when", "scope", "products"];
+/** 各知识类型的格式规范定义 */
+const FORMAT_SCHEMA = {
+    pattern: {
+        required_headings: ["## 决策规则", "## 验收项"],
+    },
+    domain: {
+        required_headings: ["## 业务规则", "## 约束条件", "## 例外情况", "## 关联模式"],
+    },
+    procedure: {
+        required_headings: ["## 适用场景", "## 步骤", "## 检查点", "## 注意事项"],
+    },
+    pipeline_procedure: {
+        required_headings: [],
+        partial_match_headings: ["### 第"],
+    },
+    review_rule: {
+        required_headings: [],
+        partial_match_headings: ["pattern:", "severity:", "description:"],
+    },
+    acceptance_template: {
+        required_headings: [],
+    },
+};
+/** 各知识类型的完整度阈值（字段名、匹配正则、最小数量） */
+const COMPLETENESS_THRESHOLDS = {
+    pattern: [
+        { field: "决策规则", pattern: /^- /gm, minimum: 5 },
+        { field: "验收项", pattern: /^- \[AC-/gm, minimum: 3 },
+    ],
+    domain: [
+        { field: "业务规则", pattern: /^(?:- |\d+\.)/gm, minimum: 6 },
+    ],
+    procedure: [
+        { field: "步骤", pattern: /^\d+\.\s/gm, minimum: 5 },
+        { field: "检查点", pattern: /^- \[ \]/gm, minimum: 3 },
+    ],
+    pipeline_procedure: [
+        { field: "阶段", pattern: /^### 第\d+步/gm, minimum: 3 },
+    ],
+    review_rule: [
+        { field: "规则", pattern: /^## [A-Z]+-\d+/gm, minimum: 5 },
+    ],
+};
+/**
+ * 统计正则匹配数量。
+ * @param body - 文本内容
+ * @param pattern - 正则表达式
+ * @returns 匹配数量
+ */
+function countPattern(body, pattern) {
+    return (body.match(pattern) ?? []).length;
+}
+/**
+ * 验证知识条目的格式 Schema 规范。
+ * 检查 frontmatter 字段顺序、when 字段风格、body 必需标题。
+ * @param entry - 知识条目
+ * @returns 格式问题列表
+ */
+async function validateFormatSchema(entry) {
+    const results = [];
+    if (!entry.file_path || !fss.existsSync(entry.file_path))
+        return results;
+    let raw;
+    try {
+        raw = await fs.readFile(entry.file_path, "utf-8");
+    }
+    catch {
+        return results;
+    }
+    const { data: fm, content: body } = matter(raw);
+    // 检查 frontmatter 字段顺序
+    const fmKeys = Object.keys(fm);
+    const orderIssues = [];
+    for (let i = 0; i < CANONICAL_FM_ORDER.length; i++) {
+        const expected = CANONICAL_FM_ORDER[i];
+        if (i < fmKeys.length && fmKeys[i] !== expected) {
+            orderIssues.push(`期望第 ${i + 1} 个字段为 ${expected}，实际为 ${fmKeys[i]}`);
+            break;
+        }
+    }
+    if (orderIssues.length > 0) {
+        results.push({
+            message: `frontmatter 字段顺序不规范: ${orderIssues[0]}`,
+            suggestion: `标准顺序: ${CANONICAL_FM_ORDER.join(" → ")}`,
+        });
+    }
+    // 检查 when 字段风格: 第一个逗号分隔段应 ≤ 10 个中文字符
+    const whenStr = fm.when ?? "";
+    const firstSegment = whenStr.split(/[,\s，]/)[0] ?? "";
+    const chineseCharCount = (firstSegment.match(/[一-鿿]/g) ?? []).length;
+    if (chineseCharCount > 10 && firstSegment.length > 12) {
+        results.push({
+            message: `when 字段首个触发词过长（${chineseCharCount} 个中文字符），疑似描述性短语: "${firstSegment}"`,
+            suggestion: "when 应为纯关键词逗号分隔，如: 数据导出, CSV, Excel, 批量导出",
+        });
+    }
+    // 检查 body 标题
+    const schema = FORMAT_SCHEMA[entry.type];
+    if (schema) {
+        for (const heading of schema.required_headings) {
+            if (!body.includes(heading)) {
+                results.push({
+                    message: `body 缺少必需标题: ${heading}（type=${entry.type}）`,
+                    suggestion: `按格式规约补充 ${heading} 部分`,
+                });
+            }
+        }
+        if (schema.partial_match_headings) {
+            for (const partial of schema.partial_match_headings) {
+                if (!body.includes(partial)) {
+                    results.push({
+                        message: `body 缺少必需内容: "${partial}"（type=${entry.type}）`,
+                        suggestion: `按格式规约补充包含 "${partial}" 的内容`,
+                    });
+                }
+            }
+        }
+    }
+    return results;
+}
+// ── 辅助函数 ──
+/**
+ * 计算两个关键词字符串的重叠度。
+ * @param a - 第一个关键词字符串
+ * @param b - 第二个关键词字符串
+ * @returns 重叠度（0-1），1 表示完全重叠
+ */
+function keywordOverlap(a, b) {
+    const wordsA = new Set(a.toLowerCase().split(/[,\s，]+/).filter(Boolean));
+    const wordsB = new Set(b.toLowerCase().split(/[,\s，]+/).filter(Boolean));
+    if (wordsA.size === 0 || wordsB.size === 0)
+        return 0;
+    let overlap = 0;
+    for (const w of wordsA) {
+        if (wordsB.has(w))
+            overlap++;
+    }
+    return overlap / Math.min(wordsA.size, wordsB.size);
+}
+/**
+ * 根据知识类型获取存储目录名。
+ * @param type - 知识条目类型
+ * @returns 目录名
+ */
+function getTypeDirectory(type) {
+    const map = {
+        pattern: "patterns/temp",
+        procedure: "procedures",
+        pipeline_procedure: "procedures",
+        domain: "domain",
+        acceptance_template: "acceptance_templates",
+        review_rule: "review_rules",
+    };
+    return map[type] ?? "procedures";
+}
+/**
+ * 生成知识条目的 frontmatter 文本。
+ * @param input - 新增知识条目输入
+ * @returns frontmatter 文本
+ */
+function generateFrontmatter(input) {
+    return `---
+name: ${input.title}
+type: ${input.type}
+when: "${input.when_triggers}"
+scope: [${input.scope.join(", ")}]
+products: ["*"]
+---`;
+}
+/**
+ * 生成知识条目的完整内容（frontmatter + body）。
+ * 根据类型选择对应的 body 生成器。
+ * @param input - 新增知识条目输入
+ * @returns 完整的 Markdown 文件内容
+ */
+function generateKnowledgeContent(input) {
+    const fm = generateFrontmatter(input);
+    const generators = {
+        pattern: () => generatePatternBody(input),
+        domain: () => generateDomainBody(input),
+        procedure: () => generateProcedureBody(input),
+        pipeline_procedure: () => generatePipelineBody(input),
+        review_rule: () => generateReviewRuleBody(input),
+        acceptance_template: () => generateAcceptanceBody(input),
+    };
+    const gen = generators[input.type] ?? generators.pattern;
+    return `${fm}\n\n${gen()}\n`;
+}
+/**
+ * 生成 pattern 类型知识条目的 body 内容。
+ * @param input - 新增知识条目输入
+ * @returns body 文本
+ */
+function generatePatternBody(input) {
+    const rules = input.decision_rules
+        ? input.decision_rules.split("\n").filter(Boolean).map((r) => `- ${r}`).join("\n")
+        : "- (待补充决策规则)";
+    return `## 决策规则
+${rules}
+
+## 验收项
+- [AC-01] (待补充验收标准)`;
+}
+/**
+ * 生成 domain 类型知识条目的 body 内容。
+ * @param input - 新增知识条目输入
+ * @returns body 文本
+ */
+function generateDomainBody(input) {
+    const rules = input.decision_rules
+        ? input.decision_rules.split("\n").filter(Boolean).map((r) => `${r}`).join("\n\n")
+        : "(待补充业务规则)";
+    return `## 业务规则
+${rules}
+
+## 约束条件
+- (待补充约束条件)
+
+## 例外情况
+- (待补充例外情况)
+
+## 关联模式
+- (待补充关联模式)`;
+}
+/**
+ * 生成 procedure 类型知识条目的 body 内容。
+ * @param input - 新增知识条目输入
+ * @returns body 文本
+ */
+function generateProcedureBody(input) {
+    return `## 适用场景
+(待补充适用场景描述)
+
+## 步骤
+1. (待补充步骤)
+
+## 检查点
+- [ ] (待补充检查点)
+
+## 注意事项
+- (待补充注意事项)`;
+}
+/**
+ * 生成 pipeline_procedure 类型知识条目的 body 内容。
+ * @param input - 新增知识条目输入
+ * @returns body 文本
+ */
+function generatePipelineBody(input) {
+    return `# ${input.title}
+
+### 第1步：定义阶段
+(待补充阶段描述)
+产出保存到：.soloforge/output/01-产出.md
+工具：sf_classify, sf_expand
+
+### 第2步：执行阶段
+(待补充阶段描述)
+工具：sf_verify`;
+}
+/**
+ * 生成 review_rule 类型知识条目的 body 内容。
+ * @param input - 新增知识条目输入
+ * @returns body 文本
+ */
+function generateReviewRuleBody(input) {
+    const code = input.title.toUpperCase().replace(/-/g, "").slice(0, 3);
+    return `## ${code}-01: (待补充规则标题)
+pattern: /(待补充正则)/
+severity: warning
+scope: ${input.scope.join(", ")}
+description: (待补充规则描述)`;
+}
+/**
+ * 生成 acceptance_template 类型知识条目的 body 内容。
+ * @param input - 新增知识条目输入
+ * @returns body 文本
+ */
+function generateAcceptanceBody(input) {
+    return `# ${input.title}
+
+## 1. (待补充章节标题)
+(待补充内容)
+
+## 2. (待补充章节标题)
+(待补充内容)`;
+}
+// ── 自动丰富指南 ──
+/**
+ * 从标题中提取可读的主题名称。
+ * @param title - 知识条目标题（含连字符/下划线）
+ * @returns 格式化后的主题名称
+ */
+function extractTopicFromTitle(title) {
+    return title.split(/[-_]/).map((w) => w.charAt(0).toUpperCase() + w.slice(1)).join(" ");
+}
+/**
+ * 根据知识类型构建对应的自动丰富指南。
+ * @param input - 新增知识条目输入
+ * @returns 自动丰富指南
+ */
+function buildEnrichmentGuide(input) {
+    const builders = {
+        pattern: () => buildPatternGuide(input),
+        domain: () => buildDomainGuide(input),
+        procedure: () => buildProcedureGuide(input),
+        pipeline_procedure: () => buildPipelineGuide(input),
+        review_rule: () => buildReviewRuleGuide(input),
+        acceptance_template: () => buildAcceptanceGuide(input),
+    };
+    return builders[input.type]();
+}
+/**
+ * 构建 pattern 类型的自动丰富指南。
+ * @param input - 新增知识条目输入
+ * @returns 丰富指南
+ */
+function buildPatternGuide(input) {
+    const topic = extractTopicFromTitle(input.title);
+    return {
+        entry_name: input.title,
+        type: "pattern",
+        overview: `从行业最佳实践中提取"${topic}"领域的决策规则和验收标准。规则应具体、可操作、可验证，覆盖安全、性能、可维护性等维度。`,
+        steps: [
+            {
+                step_number: 1,
+                action: `搜索"${topic}"的最佳实践、常见陷阱和反模式`,
+                search_queries: [`${topic} best practices software development`, `${topic} common mistakes anti-patterns`, `${topic} production checklist enterprise`],
+                focus_areas: ["常见错误", "性能陷阱", "安全风险", "可维护性"],
+            },
+            {
+                step_number: 2,
+                action: `从搜索结果中提取至少 5 条决策规则`,
+                search_queries: [`${topic} coding guidelines ${input.scope.join(" ")}`, `${topic} design patterns enterprise java`],
+                focus_areas: ["规则具体性", "可操作性", "互斥性"],
+            },
+            {
+                step_number: 3,
+                action: "为每条规则设计可验证的验收标准（AC）",
+                focus_areas: ["可自动化检查", "明确的通过/失败标准"],
+            },
+            {
+                step_number: 4,
+                action: `调用 sf_knowledge_update 将探索到的规则和验收项写入文件`,
+                focus_areas: ["使用 add_decision_rules 和 add_acceptance_criteria 参数"],
+            },
+        ],
+        authoritative_sources: [
+            "OWASP Cheat Sheet Series — 安全相关模式",
+            "Google Engineering Practices (google.github.io/eng-practices) — 代码评审实践",
+            "Alibaba Java Development Manual — Java 开发最佳实践",
+            "Martin Fowler's Patterns Catalog — 设计模式",
+            "Microsoft API Guidelines — API 设计模式",
+        ],
+        completeness_thresholds: [
+            { field: "decision_rules", minimum: 5 },
+            { field: "acceptance_criteria", minimum: 3 },
+        ],
+        update_call_template: `sf_knowledge_update(entry_name="${input.title}", add_decision_rules=[规则1, 规则2, ...], add_acceptance_criteria=[标准1, 标准2, ...])`,
+    };
+}
+/**
+ * 构建 domain 类型的自动丰富指南。
+ * @param input - 新增知识条目输入
+ * @returns 丰富指南
+ */
+function buildDomainGuide(input) {
+    const topic = extractTopicFromTitle(input.title);
+    return {
+        entry_name: input.title,
+        type: "domain",
+        overview: `研究"${topic}"领域的行业标准和监管要求，提取业务规则、约束条件、例外情况和关联模式。`,
+        steps: [
+            {
+                step_number: 1,
+                action: `搜索"${topic}"领域的行业标准和法规要求`,
+                search_queries: [`${topic} business rules industry standard`, `${topic} compliance regulatory requirements`, `${topic} domain driven design`],
+                focus_areas: ["行业法规", "合规要求", "业务约束"],
+            },
+            {
+                step_number: 2,
+                action: "提取核心业务规则（什么必须为真、什么不能发生）",
+                focus_areas: ["业务规则", "状态约束", "数据完整性"],
+            },
+            {
+                step_number: 3,
+                action: "识别技术约束和操作约束",
+                focus_areas: ["性能约束", "安全约束", "容量约束"],
+            },
+            {
+                step_number: 4,
+                action: "列举例外场景和边界条件",
+                focus_areas: ["边缘场景", "特殊条件", "豁免情况"],
+            },
+            {
+                step_number: 5,
+                action: `调用 sf_knowledge_update 将探索到的内容写入文件`,
+                focus_areas: ["使用 add_decision_rules 写入业务规则"],
+            },
+        ],
+        authoritative_sources: [
+            "OWASP — 安全相关领域",
+            "PCI-DSS — 支付相关领域",
+            "GDPR / 个人信息保护法 — 数据隐私领域",
+            "Domain-Driven Design (Eric Evans) — 领域建模",
+            "行业特定标准（HIPAA/SOX/ISO 27001）",
+        ],
+        completeness_thresholds: [
+            { field: "business_rules", minimum: 6 },
+            { field: "constraints", minimum: 4 },
+            { field: "exceptions", minimum: 2 },
+            { field: "related_patterns", minimum: 1 },
+        ],
+        update_call_template: `sf_knowledge_update(entry_name="${input.title}", add_decision_rules=[业务规则1, 业务规则2, ...])`,
+    };
+}
+/**
+ * 构建 procedure 类型的自动丰富指南。
+ * @param input - 新增知识条目输入
+ * @returns 丰富指南
+ */
+function buildProcedureGuide(input) {
+    const topic = extractTopicFromTitle(input.title);
+    return {
+        entry_name: input.title,
+        type: "procedure",
+        overview: `研究"${topic}"的标准操作流程，拆分为有序步骤、检查点和注意事项。`,
+        steps: [
+            {
+                step_number: 1,
+                action: `搜索"${topic}"的标准流程和行业实践`,
+                search_queries: [`${topic} standard procedure workflow`, `${topic} step by step guide`, `${topic} operational best practices`],
+                focus_areas: ["标准流程", "关键步骤", "验证节点"],
+            },
+            {
+                step_number: 2,
+                action: "将流程拆分为有序的原子步骤",
+                focus_areas: ["步骤顺序", "步骤原子性", "输入输出明确"],
+            },
+            {
+                step_number: 3,
+                action: "在关键节点设计检查点（验证门禁）",
+                focus_areas: ["质量门禁", "可验证条件"],
+            },
+            {
+                step_number: 4,
+                action: "识别常见陷阱和注意事项",
+                focus_areas: ["常见错误", "风险点", "最佳实践"],
+            },
+            {
+                step_number: 5,
+                action: `调用 sf_knowledge_update 将步骤内容写入文件`,
+                focus_areas: ["使用 add_decision_rules 写入步骤和注意事项"],
+            },
+        ],
+        authoritative_sources: [
+            "Google SRE Book — 运维流程实践",
+            "CI/CD Pipeline Best Practices — 部署发布流程",
+            "Git Workflow Guides — 代码管理流程",
+            "OWASP Secure Development Lifecycle — 安全开发流程",
+        ],
+        completeness_thresholds: [
+            { field: "steps", minimum: 5 },
+            { field: "checkpoints", minimum: 3 },
+            { field: "notes", minimum: 3 },
+        ],
+        update_call_template: `sf_knowledge_update(entry_name="${input.title}", add_decision_rules=[步骤内容, 注意事项, ...])`,
+    };
+}
+/**
+ * 构建 pipeline_procedure 类型的自动丰富指南。
+ * @param input - 新增知识条目输入
+ * @returns 丰富指南
+ */
+function buildPipelineGuide(input) {
+    const topic = extractTopicFromTitle(input.title);
+    return {
+        entry_name: input.title,
+        type: "pipeline_procedure",
+        overview: `设计"${topic}"的多阶段流水线，明确每个阶段的工具、产出和检查点。`,
+        steps: [
+            {
+                step_number: 1,
+                action: `搜索"${topic}"相关的流水线或工作流设计`,
+                search_queries: [`${topic} pipeline workflow design`, `${topic} multi-phase process`],
+                focus_areas: ["阶段划分", "阶段边界", "入口/出口条件"],
+            },
+            {
+                step_number: 2,
+                action: "为每个阶段映射具体的 SoloForge 工具（sf_classify, sf_expand, sf_verify 等）",
+                focus_areas: ["工具选择", "工具参数"],
+            },
+            {
+                step_number: 3,
+                action: "定义每个阶段的产出物和保存路径",
+                focus_areas: ["产出格式", "路径规范"],
+            },
+            {
+                step_number: 4,
+                action: `调用 sf_knowledge_update 将阶段内容写入文件`,
+                focus_areas: ["使用 add_decision_rules 写入阶段定义"],
+            },
+        ],
+        authoritative_sources: [
+            "CI/CD Pipeline Best Practices",
+            "Google SRE Release Engineering",
+            "GitHub Actions Workflow Patterns",
+        ],
+        completeness_thresholds: [
+            { field: "phases", minimum: 3 },
+            { field: "tools_per_phase", minimum: 1 },
+        ],
+        update_call_template: `sf_knowledge_update(entry_name="${input.title}", add_decision_rules=[阶段定义1, 阶段定义2, ...])`,
+    };
+}
+/**
+ * 构建 review_rule 类型的自动丰富指南。
+ * @param input - 新增知识条目输入
+ * @returns 丰富指南
+ */
+function buildReviewRuleGuide(input) {
+    const topic = extractTopicFromTitle(input.title);
+    return {
+        entry_name: input.title,
+        type: "review_rule",
+        overview: `研究"${topic}"相关的代码质量问题，定义正则匹配规则、严重级别和描述。规则需覆盖安全、性能、质量维度。`,
+        steps: [
+            {
+                step_number: 1,
+                action: `搜索"${topic}"相关的常见代码质量问题和安全漏洞`,
+                search_queries: [`${topic} code review checklist`, `${topic} static analysis rules`, `${topic} common vulnerabilities patterns`],
+                focus_areas: ["代码异味", "安全漏洞模式", "性能反模式"],
+            },
+            {
+                step_number: 2,
+                action: "为每个问题定义可匹配的正则表达式（pattern）",
+                focus_areas: ["正则精确性", "误报率控制", "覆盖变体"],
+            },
+            {
+                step_number: 3,
+                action: "分配严重级别（critical/warning/info）并编写描述",
+                focus_areas: ["严重度合理性", "描述清晰性", "修复建议"],
+            },
+            {
+                step_number: 4,
+                action: `调用 sf_knowledge_update 将规则写入文件`,
+                focus_areas: ["使用 add_decision_rules 写入规则定义"],
+            },
+        ],
+        authoritative_sources: [
+            "OWASP Code Review Guide — 安全审查规则",
+            "ESLint / PMD / Checkstyle Rule Catalogs — 静态分析规则",
+            "Google Style Guides — 代码风格规则",
+            "Alibaba Java Development Manual — Java 规则",
+            "SonarQube Rule Definitions — 质量规则",
+        ],
+        completeness_thresholds: [
+            { field: "rules", minimum: 5 },
+            { field: "critical_rules", minimum: 1 },
+        ],
+        update_call_template: `sf_knowledge_update(entry_name="${input.title}", add_decision_rules=[规则定义1, 规则定义2, ...])`,
+    };
+}
+/**
+ * 构建 acceptance_template 类型的自动丰富指南。
+ * @param input - 新增知识条目输入
+ * @returns 丰富指南
+ */
+function buildAcceptanceGuide(input) {
+    const topic = extractTopicFromTitle(input.title);
+    return {
+        entry_name: input.title,
+        type: "acceptance_template",
+        overview: `研究"${topic}"的行业标准验收门禁，设计覆盖安全、性能、质量维度的验收清单，每个验收项需包含可执行的检查命令。`,
+        steps: [
+            {
+                step_number: 1,
+                action: `搜索"${topic}"的质量门禁和验收标准`,
+                search_queries: [`${topic} acceptance criteria checklist`, `${topic} quality gate verification`, `${topic} production readiness review`],
+                focus_areas: ["安全验收", "性能验收", "功能验收", "合规验收"],
+            },
+            {
+                step_number: 2,
+                action: "为每个验收项设计可执行的检查命令（grep/find/test 命令）",
+                focus_areas: ["命令可执行性", "结果可判定性"],
+            },
+            {
+                step_number: 3,
+                action: "确保验收项覆盖安全（≥2项）和质量（≥2项）维度",
+                focus_areas: ["安全覆盖", "质量覆盖", "独立性"],
+            },
+            {
+                step_number: 4,
+                action: `调用 sf_knowledge_update 将验收项写入文件`,
+                focus_areas: ["使用 add_acceptance_criteria 写入验收项"],
+            },
+        ],
+        authoritative_sources: [
+            "OWASP ASVS (Application Security Verification Standard) — 安全验收",
+            "Microsoft Security Development Lifecycle — 安全开发验收",
+            "Google Engineering Practices — 代码质量验收",
+            "IEEE Software Quality Standards — 软件质量标准",
+        ],
+        completeness_thresholds: [
+            { field: "acceptance_criteria", minimum: 10 },
+            { field: "security_acs", minimum: 2 },
+            { field: "check_commands", minimum: 10 },
+        ],
+        update_call_template: `sf_knowledge_update(entry_name="${input.title}", add_acceptance_criteria=[验收项1, 验收项2, ...])`,
+    };
+}
+/**
+ * 获取项目知识库目录路径。
+ * @param config - 项目配置
+ * @returns 知识库目录的绝对路径
+ */
+function getProjectKnowledgeDir(config) {
+    const projectDir = config._projectPath ?? process.cwd();
+    return path.join(projectDir, ".soloforge", "knowledge");
+}
+//# sourceMappingURL=knowledge_manager.js.map