@knowledgine/core 0.3.0 → 0.4.1

package/dist/agents/index.d.ts

@@ -0,0 +1,7 @@
+export type { KnowledgeVectorCategory, KnowledgeVector, ObserverOutput, ContradictionDetection, DeprecationCandidate, ReflectorOutput, } from "./types.js";
+export { ObserverAgent } from "./observer-agent.js";
+export type { ObserverAgentConfig, ObserverAgentDeps } from "./observer-agent.js";
+export { ReflectorAgent } from "./reflector-agent.js";
+export type { ReflectorAgentConfig, ReflectorAgentDeps } from "./reflector-agent.js";
+export { classifyByRules, parseLLMVectorResponse } from "./vector-classification-rules.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,uBAAuB,EACvB,eAAe,EACf,cAAc,EACd,sBAAsB,EACtB,oBAAoB,EACpB,eAAe,GAChB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,YAAY,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAElF,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,YAAY,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAErF,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAC"}

package/dist/agents/index.js

@@ -0,0 +1,4 @@
+export { ObserverAgent } from "./observer-agent.js";
+export { ReflectorAgent } from "./reflector-agent.js";
+export { classifyByRules, parseLLMVectorResponse } from "./vector-classification-rules.js";
+//# sourceMappingURL=index.js.map

package/dist/agents/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGpD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGtD,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAC"}

package/dist/agents/observer-agent.d.ts

@@ -0,0 +1,31 @@
+import type { KnowledgeNote } from "../storage/knowledge-repository.js";
+import type { LLMProvider } from "../llm/types.js";
+import type { KnowledgeRepository } from "../storage/knowledge-repository.js";
+import { PatternExtractor } from "../extraction/pattern-extractor.js";
+import { EntityExtractor } from "../graph/entity-extractor.js";
+import type { ObserverOutput } from "./types.js";
+export interface ObserverAgentConfig {
+    maxConcurrency?: number;
+    timeoutMs?: number;
+}
+export interface ObserverAgentDeps {
+    patternExtractor: PatternExtractor;
+    entityExtractor: EntityExtractor;
+    llmProvider?: LLMProvider;
+    repository: KnowledgeRepository;
+}
+export declare class ObserverAgent {
+    private readonly deps;
+    private readonly maxConcurrency;
+    constructor(deps: ObserverAgentDeps, config?: ObserverAgentConfig);
+    /**
+     * 単一ノートの6ベクトル分類を実行する
+     */
+    observe(note: KnowledgeNote): Promise<ObserverOutput>;
+    /**
+     * 複数ノートを並列処理して全結果を返す
+     * maxConcurrencyで並列数を制限し、部分失敗はerrorsに記録して返す
+     */
+    observeBatch(notes: KnowledgeNote[]): Promise<ObserverOutput[]>;
+}
+//# sourceMappingURL=observer-agent.d.ts.map

package/dist/agents/observer-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observer-agent.d.ts","sourceRoot":"","sources":["../../src/agents/observer-agent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AACxE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAC9E,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AACtE,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAmB,MAAM,YAAY,CAAC;AAGlE,MAAM,WAAW,mBAAmB;IAClC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,eAAe,EAAE,eAAe,CAAC;IACjC,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,UAAU,EAAE,mBAAmB,CAAC;CACjC;AA+ED,qBAAa,aAAa;IAItB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAHvB,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;gBAGrB,IAAI,EAAE,iBAAiB,EACxC,MAAM,CAAC,EAAE,mBAAmB;IAK9B;;OAEG;IACG,OAAO,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC;IAyE3D;;;OAGG;IACG,YAAY,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;CAsBtE"}

package/dist/agents/observer-agent.js

@@ -0,0 +1,164 @@
+import { PatternExtractor } from "../extraction/pattern-extractor.js";
+import { EntityExtractor } from "../graph/entity-extractor.js";
+import { classifyByRules, parseLLMVectorResponse } from "./vector-classification-rules.js";
+const DEFAULT_MAX_CONCURRENCY = 4;
+const LLM_CONTENT_PREVIEW_LENGTH = 500;
+const LLM_SYSTEM_PROMPT = `あなたはナレッジ分類エージェントです。以下のテキストから6つのカテゴリに分類してください。
+各カテゴリについて、該当するコンテンツとconfidence(0-1)をJSON形式で返してください。
+
+カテゴリ:
+- personal_info: 開発者のスキル・経歴
+- preferences: ツール嗜好・コーディングスタイル
+- events: 障害報告・リリース・会議
+- temporal_data: 期限・バージョン変遷
+- updates: 既存知識の更新・修正
+- assistant_info: プロジェクト設定・チーム構成
+
+レスポンスはJSON配列で返してください:
+[{"category": "...", "content": "...", "confidence": 0.0}]`;
+/**
+ * frontmatterのJSONをパースする。失敗時は空オブジェクトを返す。
+ */
+function parseFrontmatter(frontmatterJson) {
+    if (!frontmatterJson)
+        return {};
+    try {
+        const parsed = JSON.parse(frontmatterJson);
+        if (typeof parsed === "object" && parsed !== null && !Array.isArray(parsed)) {
+            return parsed;
+        }
+        return {};
+    }
+    catch {
+        return {};
+    }
+}
+/**
+ * LLMのベクトルをルールベースの結果にマージする。
+ * LLMのconfidenceが高い場合はLLM優先（同一contentの重複を排除）。
+ */
+function mergeVectors(ruleVectors, llmVectors) {
+    if (llmVectors.length === 0)
+        return ruleVectors;
+    // LLMベクトルのcontentセットを構築
+    const llmContentSet = new Set(llmVectors.map((v) => `${v.category}:${v.content}`));
+    // ルールベースで、LLMと重複しないものを残す
+    const filteredRuleVectors = ruleVectors.filter((v) => !llmContentSet.has(`${v.category}:${v.content}`));
+    return [...filteredRuleVectors, ...llmVectors];
+}
+/**
+ * 並列処理をconcurrency数で制限してPromiseを実行する
+ */
+async function runWithConcurrency(tasks, maxConcurrency) {
+    const results = new Array(tasks.length);
+    let nextIndex = 0;
+    async function worker() {
+        while (nextIndex < tasks.length) {
+            const index = nextIndex++;
+            results[index] = await tasks[index]();
+        }
+    }
+    const workers = Array.from({ length: Math.min(maxConcurrency, tasks.length) }, () => worker());
+    await Promise.all(workers);
+    return results;
+}
+export class ObserverAgent {
+    deps;
+    maxConcurrency;
+    constructor(deps, config) {
+        this.deps = deps;
+        this.maxConcurrency = config?.maxConcurrency ?? DEFAULT_MAX_CONCURRENCY;
+    }
+    /**
+     * 単一ノートの6ベクトル分類を実行する
+     */
+    async observe(note) {
+        const startTime = Date.now();
+        const errors = [];
+        const frontmatter = parseFrontmatter(note.frontmatter_json);
+        const content = note.content ?? "";
+        // Step 1: パターン抽出
+        const dailyPatterns = this.deps.patternExtractor.extractDailyPatterns(content);
+        const ticketPatterns = this.deps.patternExtractor.extractTicketPatterns(content);
+        const patterns = [...dailyPatterns, ...ticketPatterns];
+        // Step 2: エンティティ抽出
+        const entities = this.deps.entityExtractor.extract(content, frontmatter);
+        // Step 3: ルールベース分類
+        const ruleVectors = classifyByRules(patterns, entities, frontmatter, content);
+        // Step 4: LLM補完（LLMが利用可能な場合）
+        let llmVectors = [];
+        let usedLLM = false;
+        if (this.deps.llmProvider) {
+            try {
+                const isAvailable = await this.deps.llmProvider.isAvailable();
+                if (isAvailable) {
+                    const preview = content.slice(0, LLM_CONTENT_PREVIEW_LENGTH);
+                    const frontmatterStr = note.frontmatter_json
+                        ? `\nfrontmatter: ${note.frontmatter_json}`
+                        : "";
+                    const result = await this.deps.llmProvider.complete({
+                        messages: [
+                            { role: "system", content: LLM_SYSTEM_PROMPT },
+                            {
+                                role: "user",
+                                content: `テキスト:\n${preview}${frontmatterStr}`,
+                            },
+                        ],
+                        responseFormat: "json",
+                        temperature: 0.0,
+                    });
+                    const parsed = parseLLMVectorResponse(result.content);
+                    if (parsed !== null) {
+                        llmVectors = parsed;
+                        usedLLM = true;
+                    }
+                    // パース失敗時はllmVectors=[]のままフォールバック
+                }
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                errors.push(`LLM error: ${message}`);
+                // フォールバック: ルールベースのみで返却
+            }
+        }
+        // Step 5: マージ
+        const mergedVectors = usedLLM ? mergeVectors(ruleVectors, llmVectors) : ruleVectors;
+        const processingTimeMs = Date.now() - startTime;
+        return {
+            noteId: note.id,
+            vectors: mergedVectors,
+            patterns,
+            entities,
+            processingMode: usedLLM ? "hybrid" : "rule",
+            processingTimeMs,
+            errors: errors.length > 0 ? errors : undefined,
+        };
+    }
+    /**
+     * 複数ノートを並列処理して全結果を返す
+     * maxConcurrencyで並列数を制限し、部分失敗はerrorsに記録して返す
+     */
+    async observeBatch(notes) {
+        if (notes.length === 0)
+            return [];
+        const tasks = notes.map((note) => async () => {
+            try {
+                return await this.observe(note);
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                return {
+                    noteId: note.id,
+                    vectors: [],
+                    patterns: [],
+                    entities: [],
+                    processingMode: "rule",
+                    processingTimeMs: 0,
+                    errors: [`batch processing error: ${message}`],
+                };
+            }
+        });
+        return runWithConcurrency(tasks, this.maxConcurrency);
+    }
+}
+//# sourceMappingURL=observer-agent.js.map

package/dist/agents/observer-agent.js.map

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

package/dist/agents/reflector-agent.d.ts

@@ -0,0 +1,66 @@
+import type { KnowledgeRepository } from "../storage/knowledge-repository.js";
+import type { GraphRepository } from "../graph/graph-repository.js";
+import type { LLMProvider } from "../llm/types.js";
+import type { ObserverOutput, ReflectorOutput, DeprecationCandidate } from "./types.js";
+export interface ReflectorAgentConfig {
+    maxConcurrency?: number;
+    timeoutMs?: number;
+    similarityThreshold?: number;
+}
+export interface ReflectorAgentDeps {
+    repository: KnowledgeRepository;
+    graphRepository: GraphRepository;
+    llmProvider?: LLMProvider;
+}
+export declare class ReflectorAgent {
+    private readonly deps;
+    private readonly maxConcurrency;
+    private readonly similarityThreshold;
+    constructor(deps: ReflectorAgentDeps, config?: ReflectorAgentConfig);
+    /**
+     * 矛盾検出 + deprecation候補提示（実行はしない）
+     */
+    reflect(observerOutput: ObserverOutput): Promise<ReflectorOutput>;
+    /**
+     * バッチ処理: 複数のObserverOutputを並列で処理する
+     */
+    reflectBatch(outputs: ObserverOutput[]): Promise<ReflectorOutput[]>;
+    /**
+     * ユーザー承認後にdeprecationを実行する（best-effort方式）
+     */
+    applyApprovedDeprecations(candidates: DeprecationCandidate[]): void;
+    /**
+     * ルールベースの矛盾検出を実行する。
+     * 4種類の矛盾タイプを検出する。
+     */
+    private detectContradictions;
+    /**
+     * supersede検出: 類似ノートをJaccard類似度で判定する
+     */
+    private detectSupersede;
+    /**
+     * factual矛盾検出: updatesカテゴリのベクトルと既存ノートのentityを照合する
+     */
+    private detectFactual;
+    /**
+     * temporal矛盾検出: 新ノートのvalid_fromが既存ノートより前の場合
+     */
+    private detectTemporal;
+    /**
+     * preference変更検出: preferencesカテゴリの同ツール/技術に対する異なる評価
+     */
+    private detectPreferenceChange;
+    /**
+     * LLMでresolutionを補完する（矛盾配列を直接変更する）
+     */
+    private enrichWithLLM;
+    /**
+     * 矛盾からdeprecation候補を生成する
+     */
+    private buildDeprecationCandidates;
+    /**
+     * supersedeタイプの矛盾からversionUpdates情報を生成する
+     */
+    private buildVersionUpdates;
+}
+//# sourceMappingURL=reflector-agent.d.ts.map

package/dist/agents/reflector-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reflector-agent.d.ts","sourceRoot":"","sources":["../../src/agents/reflector-agent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAiB,MAAM,oCAAoC,CAAC;AAC7F,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,KAAK,EACV,cAAc,EACd,eAAe,EAEf,oBAAoB,EACrB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,oBAAoB;IACnC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,mBAAmB,CAAC;IAChC,eAAe,EAAE,eAAe,CAAC;IACjC,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B;AA0GD,qBAAa,cAAc;IAKvB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAJvB,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAS;gBAG1B,IAAI,EAAE,kBAAkB,EACzC,MAAM,CAAC,EAAE,oBAAoB;IAM/B;;OAEG;IACG,OAAO,CAAC,cAAc,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC;IAuDvE;;OAEG;IACG,YAAY,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAuBzE;;OAEG;IACH,yBAAyB,CAAC,UAAU,EAAE,oBAAoB,EAAE,GAAG,IAAI;IAWnE;;;OAGG;YACW,oBAAoB;IA0BlC;;OAEG;IACH,OAAO,CAAC,eAAe;IA6BvB;;OAEG;YACW,aAAa;IAmD3B;;OAEG;IACH,OAAO,CAAC,cAAc;IAoCtB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAiD9B;;OAEG;YACW,aAAa;IAqC3B;;OAEG;IACH,OAAO,CAAC,0BAA0B;IA0BlC;;OAEG;IACH,OAAO,CAAC,mBAAmB;CAc5B"}