@dommaker/harness 0.8.1 → 0.9.0

package/dist/knowledge/lifecycle-hooks.d.ts

@@ -0,0 +1,62 @@
+/**
+ * 知识生命周期钩子
+ *
+ * 与 Agent 生命周期集成：
+ * - 启动时注入相关知识上下文
+ * - 完成时提取新知识
+ */
+import type { KnowledgeEntry, KnowledgeType } from './types';
+import { KnowledgeStore } from './store';
+import { KnowledgeQuery } from './query';
+import type { ContextSource } from '../context/types';
+export interface LifecycleHookConfig {
+    store: KnowledgeStore;
+    query: KnowledgeQuery;
+    /** 启动时注入的最大 token 数 */
+    injectionBudget?: number;
+    /** 完成时提取的最大条目数 */
+    maxExtractionEntries?: number;
+    /** 当前阶段 */
+    phase?: string;
+}
+export interface ExtractionResult {
+    entries: KnowledgeEntry[];
+    source: 'archive' | 'error' | 'decision';
+}
+export declare class KnowledgeLifecycleHooks {
+    private config;
+    constructor(config: LifecycleHookConfig);
+    /**
+     * 启动钩子：注入相关知识到上下文
+     *
+     * 在 Agent session 启动时调用
+     */
+    onSessionStart(options?: {
+        phase?: string;
+        budget?: number;
+        focusTypes?: KnowledgeType[];
+        exclude?: string[];
+    }): ContextSource[];
+    /**
+     * 完成钩子：从产物中提取新知识
+     *
+     * 在 Agent task 完成时调用（ARCHIVE 阶段）
+     */
+    onTaskComplete(context: {
+        taskDescription: string;
+        changedFiles?: string[];
+        testResults?: string;
+        errors?: string[];
+        decisions?: string[];
+    }): ExtractionResult;
+    /**
+     * 错误钩子：从错误中提取知识
+     */
+    onError(error: Error, context?: {
+        taskDescription?: string;
+        stackTrace?: string;
+    }): ExtractionResult;
+    private formatForContext;
+    private createExtractionEntry;
+}
+//# sourceMappingURL=lifecycle-hooks.d.ts.map

package/dist/knowledge/lifecycle-hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle-hooks.d.ts","sourceRoot":"","sources":["../../src/knowledge/lifecycle-hooks.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAItD,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,cAAc,CAAC;IACtB,KAAK,EAAE,cAAc,CAAC;IACtB,uBAAuB;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,kBAAkB;IAClB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,WAAW;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAID,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,MAAM,EAAE,SAAS,GAAG,OAAO,GAAG,UAAU,CAAC;CAC1C;AAID,qBAAa,uBAAuB;IAClC,OAAO,CAAC,MAAM,CAAsB;gBAExB,MAAM,EAAE,mBAAmB;IAIvC;;;;OAIG;IACH,cAAc,CAAC,OAAO,CAAC,EAAE;QACvB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,UAAU,CAAC,EAAE,aAAa,EAAE,CAAC;QAC7B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;KACpB,GAAG,aAAa,EAAE;IA6BnB;;;;OAIG;IACH,cAAc,CAAC,OAAO,EAAE;QACtB,eAAe,EAAE,MAAM,CAAC;QACxB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;QACxB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;KACtB,GAAG,gBAAgB;IAsCpB;;OAEG;IACH,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE;QAC9B,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,GAAG,gBAAgB;IAwBpB,OAAO,CAAC,gBAAgB;IAYxB,OAAO,CAAC,qBAAqB;CA0B9B"}

package/dist/knowledge/lifecycle-hooks.js

@@ -0,0 +1,140 @@
+"use strict";
+/**
+ * 知识生命周期钩子
+ *
+ * 与 Agent 生命周期集成：
+ * - 启动时注入相关知识上下文
+ * - 完成时提取新知识
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KnowledgeLifecycleHooks = void 0;
+// ── 生命周期钩子 ─────────────────────────────────────────
+class KnowledgeLifecycleHooks {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    /**
+     * 启动钩子：注入相关知识到上下文
+     *
+     * 在 Agent session 启动时调用
+     */
+    onSessionStart(options) {
+        const budget = options?.budget ?? this.config.injectionBudget ?? 800;
+        const phase = options?.phase ?? this.config.phase ?? 'default';
+        const queryResult = this.config.query.query({
+            phase,
+            maxTokens: budget,
+            maxEntries: 10,
+            focusTypes: options?.focusTypes ?? [],
+        });
+        const sources = [];
+        const excludeSet = new Set(options?.exclude ?? []);
+        for (const entry of queryResult.entries) {
+            if (excludeSet.has(entry.id))
+                continue;
+            sources.push({
+                type: 'knowledge',
+                id: `knowledge-${entry.id}`,
+                content: this.formatForContext(entry),
+                priority: 3,
+                metadata: { entryId: entry.id, maturity: entry.maturity },
+            });
+        }
+        return sources;
+    }
+    /**
+     * 完成钩子：从产物中提取新知识
+     *
+     * 在 Agent task 完成时调用（ARCHIVE 阶段）
+     */
+    onTaskComplete(context) {
+        const entries = [];
+        // 从错误中提取 pitfall
+        if (context.errors && context.errors.length > 0) {
+            for (const error of context.errors.slice(0, 3)) {
+                entries.push(this.createExtractionEntry({
+                    title: `踩坑: ${error.slice(0, 100)}`,
+                    content: error,
+                    type: 'pitfall',
+                    tags: ['auto-extract', 'error'],
+                }));
+            }
+        }
+        // 从决策中提取 decision
+        if (context.decisions && context.decisions.length > 0) {
+            for (const decision of context.decisions.slice(0, 3)) {
+                entries.push(this.createExtractionEntry({
+                    title: `决策: ${decision.slice(0, 100)}`,
+                    content: decision,
+                    type: 'decision',
+                    tags: ['auto-extract', 'decision'],
+                }));
+            }
+        }
+        // 保存到知识库
+        for (const entry of entries) {
+            this.config.store.save(entry);
+        }
+        return {
+            entries,
+            source: 'archive',
+        };
+    }
+    /**
+     * 错误钩子：从错误中提取知识
+     */
+    onError(error, context) {
+        const content = [
+            `错误: ${error.message}`,
+            context?.stackTrace ? `\n堆栈:\n${context.stackTrace}` : '',
+            context?.taskDescription ? `\n任务: ${context.taskDescription}` : '',
+        ].filter(Boolean).join('\n');
+        const entry = this.createExtractionEntry({
+            title: `踩坑: ${error.message.slice(0, 100)}`,
+            content,
+            type: 'pitfall',
+            tags: ['auto-extract', 'error', 'runtime'],
+        });
+        this.config.store.save(entry);
+        return {
+            entries: [entry],
+            source: 'error',
+        };
+    }
+    // ── 辅助方法 ───────────────────────────────────────────
+    formatForContext(entry) {
+        const parts = [];
+        parts.push(`## [${entry.type.toUpperCase()}] ${entry.title}`);
+        parts.push(`成熟度: ${entry.maturity}`);
+        if (entry.tags.length > 0) {
+            parts.push(`标签: ${entry.tags.join(', ')}`);
+        }
+        parts.push('');
+        parts.push(entry.content);
+        return parts.join('\n');
+    }
+    createExtractionEntry(params) {
+        return {
+            id: `extract-${Date.now()}-${Math.random().toString(36).slice(2, 6)}`,
+            type: params.type,
+            title: params.title,
+            content: params.content,
+            maturity: 'draft',
+            layer: 'project',
+            created: new Date().toISOString(),
+            lastReferenced: '',
+            contributors: [],
+            projects: [],
+            tags: params.tags,
+            applicablePhases: [],
+            sourceReferences: [{
+                    workflow: 'lifecycle-hook',
+                    timestamp: new Date().toISOString(),
+                }],
+            referencedBy: [],
+        };
+    }
+}
+exports.KnowledgeLifecycleHooks = KnowledgeLifecycleHooks;
+//# sourceMappingURL=lifecycle-hooks.js.map

package/dist/knowledge/lifecycle-hooks.js.map

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

package/dist/knowledge/lifecycle.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Knowledge Lifecycle Manager
+ *
+ * Handles maturity promotion, auto-decay, and reference tracking
+ * for the knowledge flywheel.
+ */
+import type { KnowledgeEntry, MaturityLevel, MaturityChange, DecayConfig } from './types';
+import { KnowledgeStore } from './store';
+export declare class KnowledgeLifecycle {
+    private store;
+    private config;
+    constructor(store: KnowledgeStore, config?: Partial<DecayConfig>);
+    /**
+     * Record that an entry was referenced.
+     * Updates lastReferenced timestamp and contributors.
+     */
+    recordReference(entryId: string, contributor?: string): KnowledgeEntry | undefined;
+    /**
+     * Check if an entry meets promotion criteria.
+     * Returns the target maturity level if promotion is warranted, otherwise undefined.
+     *
+     * Rules:
+     * - draft → verified: lastReferenced is set (referenced at least once)
+     * - verified → proven: referenced ≥3 times (contributors count as proxy) + ≥2 projects
+     */
+    checkPromotion(entryId: string): MaturityLevel | undefined;
+    /**
+     * Check if an entry should decay based on time since last reference.
+     * Returns the target maturity level if decay is warranted, otherwise undefined.
+     */
+    checkEntryDecay(entryId: string): MaturityLevel | undefined;
+    /**
+     * Run a full decay cycle across all entries.
+     * Returns a list of maturity changes that were applied.
+     */
+    runDecayCycle(): MaturityChange[];
+    /**
+     * Promote an entry if it meets criteria. Returns the change if applied.
+     */
+    tryPromote(entryId: string): MaturityChange | undefined;
+    private monthsSince;
+}
+//# sourceMappingURL=lifecycle.d.ts.map

package/dist/knowledge/lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../src/knowledge/lifecycle.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACb,cAAc,EACd,WAAW,EACZ,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAIzC,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,KAAK,CAAiB;IAC9B,OAAO,CAAC,MAAM,CAAc;gBAEhB,KAAK,EAAE,cAAc,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC;IAKhE;;;OAGG;IACH,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAelF;;;;;;;OAOG;IACH,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAqB1D;;;OAGG;IACH,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IA2B3D;;;OAGG;IACH,aAAa,IAAI,cAAc,EAAE;IAqBjC;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAmBvD,OAAO,CAAC,WAAW;CAKpB"}

package/dist/knowledge/lifecycle.js

@@ -0,0 +1,141 @@
+"use strict";
+/**
+ * Knowledge Lifecycle Manager
+ *
+ * Handles maturity promotion, auto-decay, and reference tracking
+ * for the knowledge flywheel.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KnowledgeLifecycle = void 0;
+const types_1 = require("./types");
+// ── Lifecycle ──────────────────────────────────────────────
+class KnowledgeLifecycle {
+    store;
+    config;
+    constructor(store, config) {
+        this.store = store;
+        this.config = { ...types_1.DEFAULT_DECAY_CONFIG, ...config };
+    }
+    /**
+     * Record that an entry was referenced.
+     * Updates lastReferenced timestamp and contributors.
+     */
+    recordReference(entryId, contributor) {
+        const entry = this.store.get(entryId);
+        if (!entry)
+            return undefined;
+        const now = new Date().toISOString();
+        const contributors = contributor && !entry.contributors.includes(contributor)
+            ? [...entry.contributors, contributor]
+            : entry.contributors;
+        return this.store.update(entryId, {
+            lastReferenced: now,
+            contributors,
+        });
+    }
+    /**
+     * Check if an entry meets promotion criteria.
+     * Returns the target maturity level if promotion is warranted, otherwise undefined.
+     *
+     * Rules:
+     * - draft → verified: lastReferenced is set (referenced at least once)
+     * - verified → proven: referenced ≥3 times (contributors count as proxy) + ≥2 projects
+     */
+    checkPromotion(entryId) {
+        const entry = this.store.get(entryId);
+        if (!entry)
+            return undefined;
+        switch (entry.maturity) {
+            case 'draft':
+                if (entry.lastReferenced)
+                    return 'verified';
+                return undefined;
+            case 'verified':
+                if (entry.contributors.length >= 3 && entry.projects.length >= 2) {
+                    return 'proven';
+                }
+                return undefined;
+            case 'proven':
+            case 'archived':
+                return undefined;
+        }
+    }
+    /**
+     * Check if an entry should decay based on time since last reference.
+     * Returns the target maturity level if decay is warranted, otherwise undefined.
+     */
+    checkEntryDecay(entryId) {
+        const entry = this.store.get(entryId);
+        if (!entry)
+            return undefined;
+        const lastRef = entry.lastReferenced || entry.created;
+        if (!lastRef)
+            return undefined;
+        const monthsSinceRef = this.monthsSince(lastRef);
+        switch (entry.maturity) {
+            case 'proven':
+                if (monthsSinceRef >= this.config.provenDecayMonths)
+                    return 'verified';
+                return undefined;
+            case 'verified':
+                if (monthsSinceRef >= this.config.verifiedDecayMonths)
+                    return 'draft';
+                return undefined;
+            case 'draft':
+                if (monthsSinceRef >= this.config.draftDecayMonths)
+                    return 'archived';
+                return undefined;
+            case 'archived':
+                return undefined;
+        }
+    }
+    /**
+     * Run a full decay cycle across all entries.
+     * Returns a list of maturity changes that were applied.
+     */
+    runDecayCycle() {
+        const entries = this.store.list({ excludeArchived: false });
+        const changes = [];
+        for (const entry of entries) {
+            const targetMaturity = this.checkEntryDecay(entry.id);
+            if (targetMaturity && targetMaturity !== entry.maturity) {
+                const change = {
+                    entryId: entry.id,
+                    from: entry.maturity,
+                    to: targetMaturity,
+                    reason: `Auto-decay: ${entry.maturity} → ${targetMaturity} (unreferenced for threshold)`,
+                };
+                this.store.update(entry.id, { maturity: targetMaturity });
+                changes.push(change);
+            }
+        }
+        return changes;
+    }
+    /**
+     * Promote an entry if it meets criteria. Returns the change if applied.
+     */
+    tryPromote(entryId) {
+        const entry = this.store.get(entryId);
+        if (!entry)
+            return undefined;
+        const target = this.checkPromotion(entryId);
+        if (!target || target === entry.maturity)
+            return undefined;
+        const change = {
+            entryId,
+            from: entry.maturity,
+            to: target,
+            reason: `Promotion: ${entry.maturity} → ${target}`,
+        };
+        this.store.update(entryId, { maturity: target });
+        return change;
+    }
+    // ── Internal ───────────────────────────────────────────────
+    monthsSince(dateStr) {
+        const then = new Date(dateStr);
+        const now = new Date();
+        return (now.getFullYear() - then.getFullYear()) * 12 + (now.getMonth() - then.getMonth());
+    }
+}
+exports.KnowledgeLifecycle = KnowledgeLifecycle;
+//# sourceMappingURL=lifecycle.js.map

package/dist/knowledge/lifecycle.js.map

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

package/dist/knowledge/lint.d.ts

@@ -0,0 +1,57 @@
+/**
+ * 知识库 Lint（健康检查）
+ *
+ * 检查项：
+ * - 索引不一致（自动修复）
+ * - 孤儿条目（无引用、无验证）
+ * - 矛盾检测（同主题相反结论）
+ * - 过时检测（6 月未引用的 draft）
+ * - 重复/相似条目
+ * - 成熟度衰减
+ */
+import { KnowledgeStore } from './store';
+import { ReferenceTracker } from './reference-tracker';
+import type { KnowledgeEntry, LintIssue, LintIssueType } from './types';
+export interface LintReport {
+    timestamp: string;
+    totalEntries: number;
+    issues: LintIssue[];
+    fixed: number;
+    summary: Record<LintIssueType, number>;
+}
+export declare class KnowledgeLinter {
+    private store;
+    private tracker;
+    constructor(store: KnowledgeStore, tracker: ReferenceTracker);
+    /**
+     * 执行完整 Lint 检查
+     */
+    run(autoFix?: boolean): LintReport;
+    /**
+     * 检查索引一致性
+     */
+    checkIndexConsistency(entries: KnowledgeEntry[]): LintIssue[];
+    /**
+     * 检查孤儿条目（无引用、无验证）
+     */
+    checkOrphans(entries: KnowledgeEntry[]): LintIssue[];
+    /**
+     * 检查过时条目（6 月未引用的 draft）
+     */
+    checkOutdated(entries: KnowledgeEntry[]): LintIssue[];
+    /**
+     * 检查重复/相似条目
+     */
+    checkDuplicates(entries: KnowledgeEntry[]): LintIssue[];
+    /**
+     * 检查矛盾（同主题相反结论）
+     *
+     * 简单实现：同 tag 组合下成熟度冲突
+     */
+    checkContradictions(entries: KnowledgeEntry[]): LintIssue[];
+    /**
+     * 自动修复可修复的问题
+     */
+    private autoFix;
+}
+//# sourceMappingURL=lint.d.ts.map

package/dist/knowledge/lint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lint.d.ts","sourceRoot":"","sources":["../../src/knowledge/lint.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,aAAa,EAAiB,MAAM,SAAS,CAAC;AAEvF,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;CACxC;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,KAAK,CAAiB;IAC9B,OAAO,CAAC,OAAO,CAAmB;gBAEtB,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,gBAAgB;IAK5D;;OAEG;IACH,GAAG,CAAC,OAAO,GAAE,OAAe,GAAG,UAAU;IAsCzC;;OAEG;IACH,qBAAqB,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,SAAS,EAAE;IAoC7D;;OAEG;IACH,YAAY,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,SAAS,EAAE;IAyBpD;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,SAAS,EAAE;IA0BrD;;OAEG;IACH,eAAe,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,SAAS,EAAE;IA+BvD;;;;OAIG;IACH,mBAAmB,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,SAAS,EAAE;IA0C3D;;OAEG;IACH,OAAO,CAAC,OAAO;CAkBhB"}