/** * Knowledge Health — 知识层模块。 * * 职责边界: * - 负责:AuditFinding 等 知识层职责 * - 不负责:不属于本模块的职责由对应模块承担 * * 被谁调用:管线知识阶段、知识注入 * 调用谁:promises、node:fs、gray-matter、index_manager、index、logger * * 数据流:项目文件 → 知识提取 → 结构化数据 → 注入管线 * 持久化:读写本地文件(详见代码内路径) */ import type { KnowledgeIndexManager } from "./index_manager.js"; import type { ProjectConfig } from "../../types/index.js"; /** 审计发现项 */ interface AuditFinding { /** 发现项 ID */ id: string; /** 严重程度 */ severity: "info" | "warning" | "critical"; /** 问题类别: stale=陈旧, duplicate=重复, format=格式, coverage=覆盖, completeness=完整度, chain=修订链 */ category: "stale" | "duplicate" | "format" | "coverage" | "completeness" | "chain"; /** 关联的知识条目名称 */ entry_name: string; /** 问题描述 */ message: string; /** 修复建议 */ suggestion: string; } /** 审计结果 */ export interface AuditResult { /** 非废弃且非被取代状态的条目总数 */ total_entries: number; /** 审计发现列表 */ findings: AuditFinding[]; /** 各类别发现数量统计 */ summary: { stale: number; duplicate: number; format: number; coverage: number; completeness: number; chain: number; }; /** 审计时间 */ audited_at: string; } /** * 审计知识库健康度。 * 检查五个维度: 陈旧条目、重复触发词、格式规范、类型覆盖、内容完整度。 * @param knowledgeIndex - 知识索引管理器 * @param config - 项目配置 * @returns 审计结果,包含发现项和统计摘要 */ export declare function auditKnowledge(knowledgeIndex: KnowledgeIndexManager, _config: ProjectConfig): Promise; export {};