@dommaker/harness 0.8.1 → 0.9.0

package/dist/llm/types.d.ts

@@ -0,0 +1,62 @@
+/**
+ * LLM 适配器类型定义
+ *
+ * harness 核心不硬编码 LLM 依赖，通过接口注入
+ */
+export interface Message {
+    role: 'system' | 'user' | 'assistant' | 'tool';
+    content: string;
+    toolCallId?: string;
+    name?: string;
+}
+export interface LLMOptions {
+    /** 模型名称 */
+    model?: string;
+    /** 温度 */
+    temperature?: number;
+    /** 最大 token 数 */
+    maxTokens?: number;
+    /** 停止序列 */
+    stop?: string[];
+    /** 工具定义（function calling） */
+    tools?: LLMToolSpec[];
+}
+export interface LLMToolSpec {
+    name: string;
+    description: string;
+    parameters: Record<string, unknown>;
+}
+export interface SummarizeConfig {
+    /** 目标 token 数 */
+    maxTokens: number;
+    /** 保留的关键信息 */
+    preserve: Array<'user_goals' | 'tool_calls' | 'errors' | 'decisions'>;
+}
+export interface ExtractConfig {
+    /** 目标 schema */
+    schema: Record<string, unknown>;
+    /** 是否严格模式 */
+    strict?: boolean;
+}
+export interface LLMAdapter {
+    /** 对话补全 */
+    complete(prompt: string, options?: LLMOptions): Promise<string>;
+    /** 多轮对话 */
+    chat(messages: Message[], options?: LLMOptions): Promise<string>;
+    /** 流式对话 */
+    streamChat(messages: Message[], options?: LLMOptions): AsyncIterable<string>;
+    /** 总结 */
+    summarize(messages: Message[], config: SummarizeConfig): Promise<string>;
+    /** 结构化提取 */
+    extract(content: string, schema: Record<string, unknown>): Promise<unknown>;
+}
+export type LLMProvider = 'openai' | 'anthropic' | 'local' | 'custom';
+export interface LLMAdapterConfig {
+    provider: LLMProvider;
+    model?: string;
+    apiKey?: string;
+    baseUrl?: string;
+    /** 自定义适配器实现 */
+    customAdapter?: LLMAdapter;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/llm/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/llm/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAID,MAAM,WAAW,UAAU;IACzB,WAAW;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS;IACT,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW;IACX,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,6BAA6B;IAC7B,KAAK,CAAC,EAAE,WAAW,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAID,MAAM,WAAW,eAAe;IAC9B,iBAAiB;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc;IACd,QAAQ,EAAE,KAAK,CAAC,YAAY,GAAG,YAAY,GAAG,QAAQ,GAAG,WAAW,CAAC,CAAC;CACvE;AAID,MAAM,WAAW,aAAa;IAC5B,gBAAgB;IAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,aAAa;IACb,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAID,MAAM,WAAW,UAAU;IACzB,WAAW;IACX,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAChE,WAAW;IACX,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACjE,WAAW;IACX,UAAU,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IAC7E,SAAS;IACT,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACzE,YAAY;IACZ,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC7E;AAID,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,WAAW,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEtE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,WAAW,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe;IACf,aAAa,CAAC,EAAE,UAAU,CAAC;CAC5B"}

package/dist/llm/types.js

@@ -0,0 +1,8 @@
+"use strict";
+/**
+ * LLM 适配器类型定义
+ *
+ * harness 核心不硬编码 LLM 依赖，通过接口注入
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/llm/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/llm/types.ts"],"names":[],"mappings":";AAAA;;;;GAIG"}

package/dist/monitoring/context-tracker.d.ts

@@ -0,0 +1,38 @@
+/**
+ * 上下文使用追踪
+ *
+ * 记录每次 LLM 调用的上下文使用快照
+ * 存储：.harness/logs/context-tracker.log（JSONL）
+ */
+import type { ContextUsageSnapshot } from '../context/types';
+export interface ContextAverages {
+    avgTokens: number;
+    avgCompactionRate: number;
+    avgToolOutputRatio: number;
+}
+export declare class ContextTracker {
+    private logPath;
+    private maxFileSize;
+    constructor(basePath?: string);
+    /**
+     * 记录上下文使用快照
+     */
+    record(snapshot: ContextUsageSnapshot): void;
+    /**
+     * 获取最近 N 条记录
+     */
+    getRecent(n: number): ContextUsageSnapshot[];
+    /**
+     * 获取统计均值
+     */
+    getAverages(): ContextAverages;
+    /**
+     * 检测上下文问题
+     */
+    detectIssues(): string[];
+    /**
+     * 轮转日志文件
+     */
+    private rotateFile;
+}
+//# sourceMappingURL=context-tracker.d.ts.map

package/dist/monitoring/context-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-tracker.d.ts","sourceRoot":"","sources":["../../src/monitoring/context-tracker.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAE7D,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,WAAW,CAA4B;gBAEnC,QAAQ,CAAC,EAAE,MAAM;IAK7B;;OAEG;IACH,MAAM,CAAC,QAAQ,EAAE,oBAAoB,GAAG,IAAI;IAuB5C;;OAEG;IACH,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,oBAAoB,EAAE;IAsB5C;;OAEG;IACH,WAAW,IAAI,eAAe;IAmB9B;;OAEG;IACH,YAAY,IAAI,MAAM,EAAE;IAiCxB;;OAEG;IACH,OAAO,CAAC,UAAU;CASnB"}

package/dist/monitoring/context-tracker.js

@@ -0,0 +1,162 @@
+"use strict";
+/**
+ * 上下文使用追踪
+ *
+ * 记录每次 LLM 调用的上下文使用快照
+ * 存储：.harness/logs/context-tracker.log（JSONL）
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ContextTracker = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+class ContextTracker {
+    logPath;
+    maxFileSize = 10 * 1024 * 1024; // 10MB
+    constructor(basePath) {
+        const base = basePath || process.cwd();
+        this.logPath = path.join(base, '.harness', 'logs', 'context-tracker.log');
+    }
+    /**
+     * 记录上下文使用快照
+     */
+    record(snapshot) {
+        const dir = path.dirname(this.logPath);
+        try {
+            if (!fs.existsSync(dir)) {
+                fs.mkdirSync(dir, { recursive: true });
+            }
+            // 检查文件大小，超过限制时轮转
+            if (fs.existsSync(this.logPath)) {
+                const stat = fs.statSync(this.logPath);
+                if (stat.size > this.maxFileSize) {
+                    this.rotateFile();
+                }
+            }
+            const line = JSON.stringify(snapshot) + '\n';
+            fs.appendFileSync(this.logPath, line, 'utf-8');
+        }
+        catch {
+            // 静默失败，不影响主流程
+        }
+    }
+    /**
+     * 获取最近 N 条记录
+     */
+    getRecent(n) {
+        try {
+            if (!fs.existsSync(this.logPath)) {
+                return [];
+            }
+            const content = fs.readFileSync(this.logPath, 'utf-8');
+            const lines = content.trim().split('\n').filter(Boolean);
+            const recent = lines.slice(-n);
+            return recent.map(line => {
+                try {
+                    return JSON.parse(line);
+                }
+                catch {
+                    return null;
+                }
+            }).filter((s) => s !== null);
+        }
+        catch {
+            return [];
+        }
+    }
+    /**
+     * 获取统计均值
+     */
+    getAverages() {
+        const snapshots = this.getRecent(100);
+        if (snapshots.length === 0) {
+            return { avgTokens: 0, avgCompactionRate: 0, avgToolOutputRatio: 0 };
+        }
+        const totalTokens = snapshots.reduce((sum, s) => sum + s.totalTokens, 0);
+        const compactionCount = snapshots.filter(s => s.compactionTriggered).length;
+        const toolOutputTokens = snapshots.reduce((sum, s) => sum + s.breakdown.toolOutputs, 0);
+        const totalAllTokens = snapshots.reduce((sum, s) => sum + s.totalTokens, 0);
+        return {
+            avgTokens: Math.round(totalTokens / snapshots.length),
+            avgCompactionRate: compactionCount / snapshots.length,
+            avgToolOutputRatio: totalAllTokens > 0 ? toolOutputTokens / totalAllTokens : 0,
+        };
+    }
+    /**
+     * 检测上下文问题
+     */
+    detectIssues() {
+        const issues = [];
+        const averages = this.getAverages();
+        const recent = this.getRecent(10);
+        // 利用率过高
+        if (averages.avgTokens > 0) {
+            // 假设 128k 窗口，利用率 >90% 警告
+            const utilization = averages.avgTokens / 128000;
+            if (utilization > 0.9) {
+                issues.push(`上下文利用率过高 (${(utilization * 100).toFixed(0)}%)，建议触发压缩`);
+            }
+        }
+        // 工具输出占比过高
+        if (averages.avgToolOutputRatio > 0.4) {
+            issues.push(`工具输出占比过高 (${(averages.avgToolOutputRatio * 100).toFixed(0)}%)，建议增加预算控制`);
+        }
+        // 压缩频率过高
+        if (averages.avgCompactionRate > 0.3) {
+            issues.push(`压缩触发频率过高 (${(averages.avgCompactionRate * 100).toFixed(0)}%)，建议增加预算或优化上下文`);
+        }
+        // 最近有截断
+        const recentTruncations = recent.filter(s => s.truncatedItems.length > 0);
+        if (recentTruncations.length > 5) {
+            issues.push(`最近 ${recentTruncations.length} 次调用有截断，建议优化内容大小`);
+        }
+        return issues;
+    }
+    /**
+     * 轮转日志文件
+     */
+    rotateFile() {
+        try {
+            const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+            const rotatedPath = this.logPath.replace('.log', `-${timestamp}.log`);
+            fs.renameSync(this.logPath, rotatedPath);
+        }
+        catch {
+            // 轮转失败，静默处理
+        }
+    }
+}
+exports.ContextTracker = ContextTracker;
+//# sourceMappingURL=context-tracker.js.map

package/dist/monitoring/context-tracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-tracker.js","sourceRoot":"","sources":["../../src/monitoring/context-tracker.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,uCAAyB;AACzB,2CAA6B;AAS7B,MAAa,cAAc;IACjB,OAAO,CAAS;IAChB,WAAW,GAAW,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,OAAO;IAEvD,YAAY,QAAiB;QAC3B,MAAM,IAAI,GAAG,QAAQ,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;QACvC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,qBAAqB,CAAC,CAAC;IAC5E,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,QAA8B;QACnC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAEvC,IAAI,CAAC;YACH,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBACxB,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACzC,CAAC;YAED,iBAAiB;YACjB,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;gBAChC,MAAM,IAAI,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBACvC,IAAI,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;oBACjC,IAAI,CAAC,UAAU,EAAE,CAAC;gBACpB,CAAC;YACH,CAAC;YAED,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC;YAC7C,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;QACjD,CAAC;QAAC,MAAM,CAAC;YACP,cAAc;QAChB,CAAC;IACH,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,CAAS;QACjB,IAAI,CAAC;YACH,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;gBACjC,OAAO,EAAE,CAAC;YACZ,CAAC;YAED,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YACvD,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YACzD,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YAE/B,OAAO,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE;gBACvB,IAAI,CAAC;oBACH,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAyB,CAAC;gBAClD,CAAC;gBAAC,MAAM,CAAC;oBACP,OAAO,IAAI,CAAC;gBACd,CAAC;YACH,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAA6B,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;QAC1D,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAED;;OAEG;IACH,WAAW;QACT,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QAEtC,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3B,OAAO,EAAE,SAAS,EAAE,CAAC,EAAE,iBAAiB,EAAE,CAAC,EAAE,kBAAkB,EAAE,CAAC,EAAE,CAAC;QACvE,CAAC;QAED,MAAM,WAAW,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;QACzE,MAAM,eAAe,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,MAAM,CAAC;QAC5E,MAAM,gBAAgB,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;QACxF,MAAM,cAAc,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;QAE5E,OAAO;YACL,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,SAAS,CAAC,MAAM,CAAC;YACrD,iBAAiB,EAAE,eAAe,GAAG,SAAS,CAAC,MAAM;YACrD,kBAAkB,EAAE,cAAc,GAAG,CAAC,CAAC,CAAC,CAAC,gBAAgB,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC;SAC/E,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,YAAY;QACV,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QACpC,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QAElC,QAAQ;QACR,IAAI,QAAQ,CAAC,SAAS,GAAG,CAAC,EAAE,CAAC;YAC3B,yBAAyB;YACzB,MAAM,WAAW,GAAG,QAAQ,CAAC,SAAS,GAAG,MAAM,CAAC;YAChD,IAAI,WAAW,GAAG,GAAG,EAAE,CAAC;gBACtB,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,WAAW,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;YACtE,CAAC;QACH,CAAC;QAED,WAAW;QACX,IAAI,QAAQ,CAAC,kBAAkB,GAAG,GAAG,EAAE,CAAC;YACtC,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,kBAAkB,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC;QACxF,CAAC;QAED,SAAS;QACT,IAAI,QAAQ,CAAC,iBAAiB,GAAG,GAAG,EAAE,CAAC;YACrC,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,iBAAiB,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC;QAC3F,CAAC;QAED,QAAQ;QACR,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAC1E,IAAI,iBAAiB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACjC,MAAM,CAAC,IAAI,CAAC,MAAM,iBAAiB,CAAC,MAAM,kBAAkB,CAAC,CAAC;QAChE,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACK,UAAU;QAChB,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;YACjE,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,SAAS,MAAM,CAAC,CAAC;YACtE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;QAC3C,CAAC;QAAC,MAAM,CAAC;YACP,YAAY;QACd,CAAC;IACH,CAAC;CACF;AAlID,wCAkIC"}

package/dist/monitoring/index.d.ts

@@ -17,4 +17,7 @@ export * from './constraint-doctor';
 export * from './constraint-evolver';
 export * from './performance-collector';
 export * from './performance-analyzer';
+export * from './context-tracker';
+export { KnowledgeDoctor } from './knowledge-doctor';
+export { KnowledgeEvolver } from './knowledge-evolver';
 //# sourceMappingURL=index.d.ts.map

package/dist/monitoring/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/monitoring/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,cAAc,UAAU,CAAC;AACzB,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/monitoring/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,cAAc,UAAU,CAAC;AACzB,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/monitoring/index.js

@@ -27,10 +27,16 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.KnowledgeEvolver = exports.KnowledgeDoctor = void 0;
 __exportStar(require("./traces"), exports);
 __exportStar(require("./trace-analyzer"), exports);
 __exportStar(require("./constraint-doctor"), exports);
 __exportStar(require("./constraint-evolver"), exports);
 __exportStar(require("./performance-collector"), exports);
 __exportStar(require("./performance-analyzer"), exports);
+__exportStar(require("./context-tracker"), exports);
+var knowledge_doctor_1 = require("./knowledge-doctor");
+Object.defineProperty(exports, "KnowledgeDoctor", { enumerable: true, get: function () { return knowledge_doctor_1.KnowledgeDoctor; } });
+var knowledge_evolver_1 = require("./knowledge-evolver");
+Object.defineProperty(exports, "KnowledgeEvolver", { enumerable: true, get: function () { return knowledge_evolver_1.KnowledgeEvolver; } });
 //# sourceMappingURL=index.js.map

package/dist/monitoring/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/monitoring/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;GAYG;;;;;;;;;;;;;;;;AAEH,2CAAyB;AACzB,mDAAiC;AACjC,sDAAoC;AACpC,uDAAqC;AACrC,0DAAwC;AACxC,yDAAuC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/monitoring/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;GAYG;;;;;;;;;;;;;;;;;AAEH,2CAAyB;AACzB,mDAAiC;AACjC,sDAAoC;AACpC,uDAAqC;AACrC,0DAAwC;AACxC,yDAAuC;AACvC,oDAAkC;AAClC,uDAAqD;AAA5C,mHAAA,eAAe,OAAA;AACxB,yDAAuD;AAA9C,qHAAA,gBAAgB,OAAA"}

package/dist/monitoring/knowledge-doctor.d.ts

@@ -0,0 +1,78 @@
+/**
+ * 知识库健康诊断
+ *
+ * 从 ConstraintDoctor 转型，聚焦知识库健康：
+ * - 孤儿条目检测
+ * - 矛盾检测
+ * - 过时检测
+ * - 成熟度异常
+ * - 引用健康度
+ */
+import type { KnowledgeEntry, LintIssue } from '../knowledge/types';
+export type DiagnosisSeverity = 'low' | 'medium' | 'high' | 'critical';
+export interface KnowledgeDiagnosis {
+    id: string;
+    type: 'orphan' | 'contradiction' | 'outdated' | 'decay' | 'low_reference' | 'stale_index';
+    severity: DiagnosisSeverity;
+    entryId?: string;
+    title: string;
+    description: string;
+    rootCause: string;
+    impact: string;
+    recommendations: string[];
+    timestamp: string;
+}
+export interface DiagnosisReport {
+    timestamp: string;
+    totalEntries: number;
+    healthScore: number;
+    diagnoses: KnowledgeDiagnosis[];
+    summary: Record<DiagnosisSeverity, number>;
+}
+export interface KnowledgeDoctorConfig {
+    /** 低引用阈值（低于此值标记为 low_reference） */
+    lowReferenceThreshold?: number;
+    /** 过时天数（超过此天数未引用标记为 outdated） */
+    outdatedDays?: number;
+    /** 衰减预警天数 */
+    decayWarningDays?: number;
+}
+export declare class KnowledgeDoctor {
+    private config;
+    constructor(config?: KnowledgeDoctorConfig);
+    /**
+     * 诊断知识库健康
+     */
+    diagnose(entries: KnowledgeEntry[], lintIssues?: LintIssue[]): DiagnosisReport;
+    /**
+     * 从 Lint issues 生成诊断
+     */
+    private fromLintIssues;
+    /**
+     * 检查孤儿条目
+     */
+    private checkOrphans;
+    /**
+     * 检查过时条目
+     */
+    private checkOutdated;
+    /**
+     * 检查衰减预警
+     */
+    private checkDecay;
+    /**
+     * 检查低引用条目
+     */
+    private checkLowReference;
+    /**
+     * 计算健康分数（0-100）
+     */
+    private calculateHealthScore;
+    private inferRootCause;
+    private inferImpact;
+    /**
+     * 生成诊断报告（Markdown）
+     */
+    generateReport(report: DiagnosisReport): string;
+}
+//# sourceMappingURL=knowledge-doctor.d.ts.map

package/dist/monitoring/knowledge-doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-doctor.d.ts","sourceRoot":"","sources":["../../src/monitoring/knowledge-doctor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAKpE,MAAM,MAAM,iBAAiB,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;AAEvE,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,QAAQ,GAAG,eAAe,GAAG,UAAU,GAAG,OAAO,GAAG,eAAe,GAAG,aAAa,CAAC;IAC1F,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,kBAAkB,EAAE,CAAC;IAChC,OAAO,EAAE,MAAM,CAAC,iBAAiB,EAAE,MAAM,CAAC,CAAC;CAC5C;AAID,MAAM,WAAW,qBAAqB;IACpC,mCAAmC;IACnC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,iCAAiC;IACjC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa;IACb,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAUD,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAkC;gBAEpC,MAAM,CAAC,EAAE,qBAAqB;IAI1C;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,cAAc,EAAE,EAAE,UAAU,GAAE,SAAS,EAAO,GAAG,eAAe;IAmClF;;OAEG;IACH,OAAO,CAAC,cAAc;IAetB;;OAEG;IACH,OAAO,CAAC,YAAY;IA6BpB;;OAEG;IACH,OAAO,CAAC,aAAa;IA6BrB;;OAEG;IACH,OAAO,CAAC,UAAU;IA4BlB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA0BzB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAmB5B,OAAO,CAAC,cAAc;IAWtB,OAAO,CAAC,WAAW;IAWnB;;OAEG;IACH,cAAc,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM;CA8BhD"}