@nahisaho/katashiro-analyzer 0.2.2 → 0.2.4

package/dist/research/GapAnalyzer.d.ts

@@ -0,0 +1,41 @@
+/**
+ * GapAnalyzer - 知識グラフのギャップを分析
+ *
+ * @requirement REQ-ANALYZE-008
+ * @design DES-ANALYZE-008
+ * @task TASK-003
+ */
+import type { KnowledgeGap, SimpleKnowledgeGraph } from './types.js';
+/**
+ * 知識グラフのギャップを分析するクラス
+ *
+ * @example
+ * ```typescript
+ * const analyzer = new GapAnalyzer();
+ *
+ * const gaps = await analyzer.analyze(graph, 'AI ethics', ['privacy', 'bias']);
+ * for (const gap of gaps) {
+ *   console.log(`[${gap.priority}] ${gap.description}`);
+ *   console.log(`  Suggested queries: ${gap.suggestedQueries.join(', ')}`);
+ * }
+ * ```
+ */
+export declare class GapAnalyzer {
+    /**
+     * 知識グラフのギャップを分析
+     */
+    analyze(graph: SimpleKnowledgeGraph, topic: string, focusAreas?: string[]): Promise<KnowledgeGap[]>;
+    /**
+     * 孤立ノードを検出
+     */
+    private findIsolatedNodes;
+    /**
+     * フォーカスエリアのカバレッジを評価
+     */
+    private assessAreaCoverage;
+    /**
+     * 深掘りが必要なノードを検出
+     */
+    private findNeedsDepth;
+}
+//# sourceMappingURL=GapAnalyzer.d.ts.map

package/dist/research/GapAnalyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GapAnalyzer.d.ts","sourceRoot":"","sources":["../../src/research/GapAnalyzer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAErE;;;;;;;;;;;;;GAaG;AACH,qBAAa,WAAW;IACtB;;OAEG;IACG,OAAO,CACX,KAAK,EAAE,oBAAoB,EAC3B,KAAK,EAAE,MAAM,EACb,UAAU,CAAC,EAAE,MAAM,EAAE,GACpB,OAAO,CAAC,YAAY,EAAE,CAAC;IAkF1B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAWzB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAc1B;;OAEG;IACH,OAAO,CAAC,cAAc;CAiBvB"}

package/dist/research/GapAnalyzer.js

@@ -0,0 +1,145 @@
+/**
+ * GapAnalyzer - 知識グラフのギャップを分析
+ *
+ * @requirement REQ-ANALYZE-008
+ * @design DES-ANALYZE-008
+ * @task TASK-003
+ */
+/**
+ * 知識グラフのギャップを分析するクラス
+ *
+ * @example
+ * ```typescript
+ * const analyzer = new GapAnalyzer();
+ *
+ * const gaps = await analyzer.analyze(graph, 'AI ethics', ['privacy', 'bias']);
+ * for (const gap of gaps) {
+ *   console.log(`[${gap.priority}] ${gap.description}`);
+ *   console.log(`  Suggested queries: ${gap.suggestedQueries.join(', ')}`);
+ * }
+ * ```
+ */
+export class GapAnalyzer {
+    /**
+     * 知識グラフのギャップを分析
+     */
+    async analyze(graph, topic, focusAreas) {
+        const gaps = [];
+        // 1. 孤立ノードの検出（未探索の側面）
+        const isolatedNodes = this.findIsolatedNodes(graph);
+        for (const node of isolatedNodes) {
+            const nodeName = node.properties.name || node.label;
+            gaps.push({
+                id: `gap-isolated-${node.id}`,
+                description: `"${nodeName}" has no connections - may need deeper exploration`,
+                type: 'unexplored_aspect',
+                relatedTopics: [nodeName],
+                suggestedQueries: [
+                    `${nodeName} ${topic}`,
+                    `${nodeName} applications`,
+                    `${nodeName} research`,
+                ],
+                priority: 'medium',
+            });
+        }
+        // 2. フォーカスエリアのカバレッジ不足
+        if (focusAreas) {
+            for (const area of focusAreas) {
+                const coverage = this.assessAreaCoverage(graph, area);
+                if (coverage < 0.3) {
+                    gaps.push({
+                        id: `gap-coverage-${area.replace(/\s+/g, '-')}`,
+                        description: `Focus area "${area}" has low coverage (${(coverage * 100).toFixed(0)}%)`,
+                        type: 'unexplored_aspect',
+                        relatedTopics: [area],
+                        suggestedQueries: [
+                            `${topic} ${area}`,
+                            `${area} latest research`,
+                            `${area} case studies`,
+                        ],
+                        priority: 'high',
+                    });
+                }
+            }
+        }
+        // 3. 深掘りが必要なノード
+        const needsDepth = this.findNeedsDepth(graph);
+        for (const node of needsDepth) {
+            const nodeName = node.properties.name || node.label;
+            gaps.push({
+                id: `gap-depth-${node.id}`,
+                description: `"${nodeName}" is mentioned frequently but lacks detailed information`,
+                type: 'depth_needed',
+                relatedTopics: [nodeName],
+                suggestedQueries: [
+                    `${nodeName} detailed analysis`,
+                    `${nodeName} comprehensive guide`,
+                    `${nodeName} in depth`,
+                ],
+                priority: 'medium',
+            });
+        }
+        // 4. 全体的なカバレッジが少ない場合
+        if (graph.nodes.length < 5) {
+            gaps.push({
+                id: 'gap-general-coverage',
+                description: 'Overall knowledge coverage is low',
+                type: 'unexplored_aspect',
+                relatedTopics: [topic],
+                suggestedQueries: [
+                    `${topic} fundamentals`,
+                    `${topic} key concepts`,
+                    `${topic} overview comprehensive`,
+                ],
+                priority: 'high',
+            });
+        }
+        return gaps.sort((a, b) => {
+            const priorityOrder = { high: 0, medium: 1, low: 2 };
+            return priorityOrder[a.priority] - priorityOrder[b.priority];
+        });
+    }
+    /**
+     * 孤立ノードを検出
+     */
+    findIsolatedNodes(graph) {
+        const connectedIds = new Set();
+        for (const edge of graph.edges) {
+            connectedIds.add(edge.source);
+            connectedIds.add(edge.target);
+        }
+        return graph.nodes.filter((node) => !connectedIds.has(node.id) && node.type !== 'topic');
+    }
+    /**
+     * フォーカスエリアのカバレッジを評価
+     */
+    assessAreaCoverage(graph, area) {
+        const areaLower = area.toLowerCase();
+        const relevantNodes = graph.nodes.filter((node) => {
+            const name = (node.properties.name || '').toLowerCase();
+            const desc = (node.properties.description || '').toLowerCase();
+            const label = (node.label || '').toLowerCase();
+            return name.includes(areaLower) || desc.includes(areaLower) || label.includes(areaLower);
+        });
+        // カバレッジスコア（最大10ノードで100%）
+        return Math.min(relevantNodes.length / 10, 1);
+    }
+    /**
+     * 深掘りが必要なノードを検出
+     */
+    findNeedsDepth(graph) {
+        const mentionCounts = new Map();
+        for (const edge of graph.edges) {
+            mentionCounts.set(edge.source, (mentionCounts.get(edge.source) || 0) + 1);
+            mentionCounts.set(edge.target, (mentionCounts.get(edge.target) || 0) + 1);
+        }
+        // 多く言及されているが詳細情報が少ないノード
+        return graph.nodes.filter((node) => {
+            const mentions = mentionCounts.get(node.id) || 0;
+            const hasDescription = !!node.properties.description;
+            const descLength = (node.properties.description || '').length;
+            return mentions >= 3 && (!hasDescription || descLength < 100);
+        });
+    }
+}
+//# sourceMappingURL=GapAnalyzer.js.map

package/dist/research/GapAnalyzer.js.map

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

package/dist/research/QueryGenerator.d.ts

@@ -0,0 +1,38 @@
+/**
+ * QueryGenerator - リサーチクエリを生成
+ *
+ * @requirement REQ-ANALYZE-008
+ * @design DES-ANALYZE-008
+ * @task TASK-003
+ */
+import type { KnowledgeGap, SimpleKnowledgeGraph } from './types.js';
+/**
+ * リサーチクエリを生成するクラス
+ *
+ * @example
+ * ```typescript
+ * const generator = new QueryGenerator();
+ *
+ * // 初期クエリを生成
+ * const initial = generator.generateInitialQueries('AI ethics', ['privacy', 'bias']);
+ * // => ['AI ethics', 'AI ethics privacy', 'AI ethics bias', 'AI ethics overview', ...]
+ *
+ * // ギャップからクエリを生成
+ * const fromGaps = generator.generateFromGaps(gaps, graph, ['politics']);
+ * ```
+ */
+export declare class QueryGenerator {
+    /**
+     * 初期クエリを生成
+     */
+    generateInitialQueries(topic: string, focusAreas?: string[], _context?: string): string[];
+    /**
+     * 知識ギャップからクエリを生成
+     */
+    generateFromGaps(gaps: KnowledgeGap[], graph: SimpleKnowledgeGraph, excludeAreas?: string[]): string[];
+    /**
+     * クエリを拡張（同義語・関連語を追加）
+     */
+    expandQuery(query: string): string[];
+}
+//# sourceMappingURL=QueryGenerator.d.ts.map

package/dist/research/QueryGenerator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"QueryGenerator.d.ts","sourceRoot":"","sources":["../../src/research/QueryGenerator.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAErE;;;;;;;;;;;;;;GAcG;AACH,qBAAa,cAAc;IACzB;;OAEG;IACH,sBAAsB,CACpB,KAAK,EAAE,MAAM,EACb,UAAU,CAAC,EAAE,MAAM,EAAE,EACrB,QAAQ,CAAC,EAAE,MAAM,GAChB,MAAM,EAAE;IAgBX;;OAEG;IACH,gBAAgB,CACd,IAAI,EAAE,YAAY,EAAE,EACpB,KAAK,EAAE,oBAAoB,EAC3B,YAAY,CAAC,EAAE,MAAM,EAAE,GACtB,MAAM,EAAE;IAgCX;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE;CAarC"}

package/dist/research/QueryGenerator.js

@@ -0,0 +1,79 @@
+/**
+ * QueryGenerator - リサーチクエリを生成
+ *
+ * @requirement REQ-ANALYZE-008
+ * @design DES-ANALYZE-008
+ * @task TASK-003
+ */
+/**
+ * リサーチクエリを生成するクラス
+ *
+ * @example
+ * ```typescript
+ * const generator = new QueryGenerator();
+ *
+ * // 初期クエリを生成
+ * const initial = generator.generateInitialQueries('AI ethics', ['privacy', 'bias']);
+ * // => ['AI ethics', 'AI ethics privacy', 'AI ethics bias', 'AI ethics overview', ...]
+ *
+ * // ギャップからクエリを生成
+ * const fromGaps = generator.generateFromGaps(gaps, graph, ['politics']);
+ * ```
+ */
+export class QueryGenerator {
+    /**
+     * 初期クエリを生成
+     */
+    generateInitialQueries(topic, focusAreas, _context) {
+        const queries = [topic];
+        // フォーカスエリアを追加
+        if (focusAreas) {
+            for (const area of focusAreas) {
+                queries.push(`${topic} ${area}`);
+            }
+        }
+        // 一般的な拡張クエリ
+        queries.push(`${topic} overview`, `${topic} research`, `${topic} latest developments`);
+        return [...new Set(queries)]; // 重複除去
+    }
+    /**
+     * 知識ギャップからクエリを生成
+     */
+    generateFromGaps(gaps, graph, excludeAreas) {
+        const queries = [];
+        // 優先度順にギャップを処理
+        for (const gap of gaps) {
+            // 除外エリアに該当するかチェック
+            if (excludeAreas?.some((area) => gap.relatedTopics.some((t) => t.toLowerCase().includes(area.toLowerCase())))) {
+                continue;
+            }
+            queries.push(...gap.suggestedQueries);
+        }
+        // 既存ノードとの関連クエリ
+        const highValueNodes = graph.nodes
+            .filter((n) => n.type === 'concept' && n.properties.importance === 'high')
+            .slice(0, 3);
+        for (const node of highValueNodes) {
+            const nodeName = node.properties.name;
+            if (nodeName) {
+                queries.push(`${nodeName} detailed analysis`);
+            }
+        }
+        return [...new Set(queries)].slice(0, 10); // 重複除去、最大10クエリ
+    }
+    /**
+     * クエリを拡張（同義語・関連語を追加）
+     */
+    expandQuery(query) {
+        const expanded = [query];
+        // シンプルな拡張（将来的にはNLPベースの拡張を実装）
+        const variations = [
+            `${query} definition`,
+            `${query} examples`,
+            `${query} applications`,
+            `what is ${query}`,
+        ];
+        return [...expanded, ...variations];
+    }
+}
+//# sourceMappingURL=QueryGenerator.js.map

package/dist/research/QueryGenerator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"QueryGenerator.js","sourceRoot":"","sources":["../../src/research/QueryGenerator.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,cAAc;IACzB;;OAEG;IACH,sBAAsB,CACpB,KAAa,EACb,UAAqB,EACrB,QAAiB;QAEjB,MAAM,OAAO,GAAa,CAAC,KAAK,CAAC,CAAC;QAElC,cAAc;QACd,IAAI,UAAU,EAAE,CAAC;YACf,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;gBAC9B,OAAO,CAAC,IAAI,CAAC,GAAG,KAAK,IAAI,IAAI,EAAE,CAAC,CAAC;YACnC,CAAC;QACH,CAAC;QAED,YAAY;QACZ,OAAO,CAAC,IAAI,CAAC,GAAG,KAAK,WAAW,EAAE,GAAG,KAAK,WAAW,EAAE,GAAG,KAAK,sBAAsB,CAAC,CAAC;QAEvF,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO;IACvC,CAAC;IAED;;OAEG;IACH,gBAAgB,CACd,IAAoB,EACpB,KAA2B,EAC3B,YAAuB;QAEvB,MAAM,OAAO,GAAa,EAAE,CAAC;QAE7B,eAAe;QACf,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,kBAAkB;YAClB,IACE,YAAY,EAAE,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAC1B,GAAG,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAC5E,EACD,CAAC;gBACD,SAAS;YACX,CAAC;YAED,OAAO,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,gBAAgB,CAAC,CAAC;QACxC,CAAC;QAED,eAAe;QACf,MAAM,cAAc,GAAG,KAAK,CAAC,KAAK;aAC/B,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,IAAI,CAAC,CAAC,UAAU,CAAC,UAAU,KAAK,MAAM,CAAC;aACzE,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAEf,KAAK,MAAM,IAAI,IAAI,cAAc,EAAE,CAAC;YAClC,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,IAAc,CAAC;YAChD,IAAI,QAAQ,EAAE,CAAC;gBACb,OAAO,CAAC,IAAI,CAAC,GAAG,QAAQ,oBAAoB,CAAC,CAAC;YAChD,CAAC;QACH,CAAC;QAED,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,eAAe;IAC5D,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,KAAa;QACvB,MAAM,QAAQ,GAAa,CAAC,KAAK,CAAC,CAAC;QAEnC,6BAA6B;QAC7B,MAAM,UAAU,GAAG;YACjB,GAAG,KAAK,aAAa;YACrB,GAAG,KAAK,WAAW;YACnB,GAAG,KAAK,eAAe;YACvB,WAAW,KAAK,EAAE;SACnB,CAAC;QAEF,OAAO,CAAC,GAAG,QAAQ,EAAE,GAAG,UAAU,CAAC,CAAC;IACtC,CAAC;CACF"}

package/dist/research/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Deep Research モジュール
+ *
+ * @requirement REQ-ANALYZE-008
+ * @design DES-ANALYZE-008
+ * @task TASK-003
+ */
+export { DeepResearchOrchestrator } from './DeepResearchOrchestrator.js';
+export { GapAnalyzer } from './GapAnalyzer.js';
+export { ConvergenceDetector } from './ConvergenceDetector.js';
+export { QueryGenerator } from './QueryGenerator.js';
+export { FindingIntegrator } from './FindingIntegrator.js';
+export type { DeepResearchQuery, DeepResearchResult, ResearchProgress, ResearchPhase, SimpleKnowledgeGraph, KeyFinding, ImportanceLevel, SourceReference, IterationRecord, KnowledgeGap, GapType, GapPriority, UserGuidance, IntegrationResult, DeepResearchStatistics, CompletionReason, DepthPriority, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/research/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE3D,YAAY,EACV,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,EACb,oBAAoB,EACpB,UAAU,EACV,eAAe,EACf,eAAe,EACf,eAAe,EACf,YAAY,EACZ,OAAO,EACP,WAAW,EACX,YAAY,EACZ,iBAAiB,EACjB,sBAAsB,EACtB,gBAAgB,EAChB,aAAa,GACd,MAAM,YAAY,CAAC"}

package/dist/research/index.js

@@ -0,0 +1,13 @@
+/**
+ * Deep Research モジュール
+ *
+ * @requirement REQ-ANALYZE-008
+ * @design DES-ANALYZE-008
+ * @task TASK-003
+ */
+export { DeepResearchOrchestrator } from './DeepResearchOrchestrator.js';
+export { GapAnalyzer } from './GapAnalyzer.js';
+export { ConvergenceDetector } from './ConvergenceDetector.js';
+export { QueryGenerator } from './QueryGenerator.js';
+export { FindingIntegrator } from './FindingIntegrator.js';
+//# sourceMappingURL=index.js.map

package/dist/research/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/research/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/research/types.d.ts

@@ -0,0 +1,215 @@
+/**
+ * Deep Research Orchestrator - 型定義
+ *
+ * @requirement REQ-ANALYZE-008
+ * @design DES-ANALYZE-008
+ * @task TASK-003
+ */
+import type { GraphNode, GraphEdge } from '@nahisaho/katashiro-knowledge';
+/**
+ * Deep Research クエリ
+ */
+export interface DeepResearchQuery {
+    /** 調査トピック */
+    topic: string;
+    /** 初期コンテキスト（背景情報など） */
+    context?: string;
+    /** 最大イテレーション数 */
+    maxIterations?: number;
+    /** 収束閾値 (0-1) - 新規情報率がこれ以下で収束と判定 */
+    convergenceThreshold?: number;
+    /** ユーザーガイダンスを有効にするか */
+    userGuidance?: boolean;
+    /** 各イテレーションのタイムアウト（ミリ秒） */
+    iterationTimeout?: number;
+    /** 全体のタイムアウト（ミリ秒） */
+    totalTimeout?: number;
+    /** 重点的に調査する観点 */
+    focusAreas?: string[];
+    /** 除外する観点 */
+    excludeAreas?: string[];
+    /** 深さの優先度設定 */
+    depthPriority?: DepthPriority;
+}
+export type DepthPriority = 'breadth-first' | 'depth-first' | 'balanced';
+/**
+ * Deep Research 最終結果
+ */
+export interface DeepResearchResult {
+    /** 調査トピック */
+    topic: string;
+    /** 構築された知識グラフ（シリアライズ形式） */
+    knowledgeGraph: SimpleKnowledgeGraph;
+    /** エグゼクティブサマリー */
+    summary: string;
+    /** 主要な発見事項 */
+    keyFindings: KeyFinding[];
+    /** 全ての参照ソース */
+    sources: SourceReference[];
+    /** イテレーション履歴 */
+    iterations: IterationRecord[];
+    /** 残存する知識ギャップ */
+    remainingGaps: KnowledgeGap[];
+    /** 統計情報 */
+    statistics: DeepResearchStatistics;
+    /** 完了理由 */
+    completionReason: CompletionReason;
+}
+/**
+ * シンプルな知識グラフ構造（AsyncGenerator用）
+ */
+export interface SimpleKnowledgeGraph {
+    nodes: GraphNode[];
+    edges: GraphEdge[];
+}
+export type CompletionReason = 'converged' | 'max_iterations' | 'timeout' | 'user_stopped' | 'no_new_queries';
+/**
+ * 進捗情報（AsyncGenerator の yield 値）
+ */
+export interface ResearchProgress {
+    /** 現在のイテレーション番号 */
+    iteration: number;
+    /** 現在のフェーズ */
+    phase: ResearchPhase;
+    /** 現在実行中のクエリ */
+    currentQuery: string;
+    /** 累計発見数 */
+    totalFindingsCount: number;
+    /** 新規情報率 (0-1) */
+    noveltyRate: number;
+    /** 収束スコア (0-1) */
+    convergenceScore: number;
+    /** 識別された知識ギャップ */
+    gaps: KnowledgeGap[];
+    /** 経過時間（ミリ秒） */
+    elapsedTime: number;
+}
+export type ResearchPhase = 'searching' | 'integrating' | 'analyzing' | 'waiting_guidance' | 'completed';
+/**
+ * 主要な発見事項
+ */
+export interface KeyFinding {
+    /** 発見事項ID */
+    id: string;
+    /** タイトル */
+    title: string;
+    /** 要約 */
+    summary: string;
+    /** 重要度 */
+    importance: ImportanceLevel;
+    /** 発見元ソースURL */
+    sources: string[];
+    /** 関連コンセプト */
+    relatedConcepts: string[];
+}
+export type ImportanceLevel = 'high' | 'medium' | 'low';
+/**
+ * 知識ギャップ
+ */
+export interface KnowledgeGap {
+    /** ギャップID */
+    id: string;
+    /** ギャップの説明 */
+    description: string;
+    /** ギャップのタイプ */
+    type: GapType;
+    /** 関連するトピック/ノード */
+    relatedTopics: string[];
+    /** 推奨される調査方向 */
+    suggestedQueries: string[];
+    /** 優先度 */
+    priority: 'high' | 'medium' | 'low';
+}
+export type GapType = 'missing_evidence' | 'contradictory_info' | 'unexplored_aspect' | 'outdated_info' | 'depth_needed';
+export type GapPriority = 'high' | 'medium' | 'low';
+/**
+ * イテレーション記録
+ */
+export interface IterationRecord {
+    /** イテレーション番号 */
+    iterationNumber: number;
+    /** 使用したクエリ */
+    queries: string[];
+    /** 取得した発見数 */
+    findingsCount: number;
+    /** 追加したノード数 */
+    newNodesCount: number;
+    /** 追加したエッジ数 */
+    newEdgesCount: number;
+    /** 新規情報率 (0-1) */
+    noveltyRate: number;
+    /** 処理時間（ミリ秒） */
+    duration: number;
+}
+/**
+ * 参照ソース
+ */
+export interface SourceReference {
+    /** URL */
+    url: string;
+    /** タイトル */
+    title: string;
+    /** ソースタイプ */
+    type: string;
+    /** アクセス日時 */
+    accessedAt: Date;
+}
+/**
+ * 統計情報
+ */
+export interface DeepResearchStatistics {
+    /** 総イテレーション数 */
+    totalIterations: number;
+    /** 総処理発見数 */
+    totalFindingsProcessed: number;
+    /** 作成したノード数 */
+    totalNodesCreated: number;
+    /** 作成したエッジ数 */
+    totalEdgesCreated: number;
+    /** 平均新規情報率 */
+    averageNoveltyRate: number;
+    /** 総処理時間（ミリ秒） */
+    totalDuration: number;
+}
+/**
+ * ユーザーガイダンス入力
+ */
+export interface UserGuidance {
+    /** アクション */
+    action: 'continue' | 'stop' | 'focus' | 'exclude';
+    /** フォーカスする方向（オプション） */
+    focusDirection?: string;
+    /** 除外する方向（オプション） */
+    excludeDirection?: string;
+    /** 追加クエリ（オプション） */
+    additionalQueries?: string[];
+}
+/**
+ * エラー型
+ */
+export interface DeepResearchError {
+    code: DeepResearchErrorCode;
+    message: string;
+    iteration?: number;
+    details?: unknown;
+}
+export type DeepResearchErrorCode = 'INVALID_QUERY' | 'INITIALIZATION_FAILED' | 'ITERATION_FAILED' | 'TIMEOUT' | 'USER_CANCELLED' | 'UNKNOWN_ERROR';
+/**
+ * Finding統合結果
+ */
+export interface IntegrationResult {
+    newNodesCount: number;
+    newEdgesCount: number;
+    updatedNodesCount: number;
+}
+/**
+ * デフォルト設定
+ */
+export declare const DEFAULT_DEEP_RESEARCH_CONFIG: {
+    readonly maxIterations: 10;
+    readonly convergenceThreshold: 0.15;
+    readonly iterationTimeout: 60000;
+    readonly totalTimeout: 600000;
+    readonly depthPriority: DepthPriority;
+};
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/research/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAK1E;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,aAAa;IACb,KAAK,EAAE,MAAM,CAAC;IAEd,uBAAuB;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,iBAAiB;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,oCAAoC;IACpC,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAE9B,uBAAuB;IACvB,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB,2BAA2B;IAC3B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B,qBAAqB;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,iBAAiB;IACjB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IAEtB,aAAa;IACb,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IAExB,eAAe;IACf,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B;AAED,MAAM,MAAM,aAAa,GAAG,eAAe,GAAG,aAAa,GAAG,UAAU,CAAC;AAEzE;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,aAAa;IACb,KAAK,EAAE,MAAM,CAAC;IAEd,2BAA2B;IAC3B,cAAc,EAAE,oBAAoB,CAAC;IAErC,kBAAkB;IAClB,OAAO,EAAE,MAAM,CAAC;IAEhB,cAAc;IACd,WAAW,EAAE,UAAU,EAAE,CAAC;IAE1B,eAAe;IACf,OAAO,EAAE,eAAe,EAAE,CAAC;IAE3B,gBAAgB;IAChB,UAAU,EAAE,eAAe,EAAE,CAAC;IAE9B,iBAAiB;IACjB,aAAa,EAAE,YAAY,EAAE,CAAC;IAE9B,WAAW;IACX,UAAU,EAAE,sBAAsB,CAAC;IAEnC,WAAW;IACX,gBAAgB,EAAE,gBAAgB,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,KAAK,EAAE,SAAS,EAAE,CAAC;CACpB;AAED,MAAM,MAAM,gBAAgB,GACxB,WAAW,GACX,gBAAgB,GAChB,SAAS,GACT,cAAc,GACd,gBAAgB,CAAC;AAErB;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,mBAAmB;IACnB,SAAS,EAAE,MAAM,CAAC;IAElB,cAAc;IACd,KAAK,EAAE,aAAa,CAAC;IAErB,gBAAgB;IAChB,YAAY,EAAE,MAAM,CAAC;IAErB,YAAY;IACZ,kBAAkB,EAAE,MAAM,CAAC;IAE3B,kBAAkB;IAClB,WAAW,EAAE,MAAM,CAAC;IAEpB,kBAAkB;IAClB,gBAAgB,EAAE,MAAM,CAAC;IAEzB,kBAAkB;IAClB,IAAI,EAAE,YAAY,EAAE,CAAC;IAErB,gBAAgB;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,aAAa,GACrB,WAAW,GACX,aAAa,GACb,WAAW,GACX,kBAAkB,GAClB,WAAW,CAAC;AAEhB;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,aAAa;IACb,EAAE,EAAE,MAAM,CAAC;IAEX,WAAW;IACX,KAAK,EAAE,MAAM,CAAC;IAEd,SAAS;IACT,OAAO,EAAE,MAAM,CAAC;IAEhB,UAAU;IACV,UAAU,EAAE,eAAe,CAAC;IAE5B,gBAAgB;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;IAElB,cAAc;IACd,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;AAExD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,aAAa;IACb,EAAE,EAAE,MAAM,CAAC;IAEX,cAAc;IACd,WAAW,EAAE,MAAM,CAAC;IAEpB,eAAe;IACf,IAAI,EAAE,OAAO,CAAC;IAEd,mBAAmB;IACnB,aAAa,EAAE,MAAM,EAAE,CAAC;IAExB,gBAAgB;IAChB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAE3B,UAAU;IACV,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;CACrC;AAED,MAAM,MAAM,OAAO,GACf,kBAAkB,GAClB,oBAAoB,GACpB,mBAAmB,GACnB,eAAe,GACf,cAAc,CAAC;AAEnB,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;AAEpD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,gBAAgB;IAChB,eAAe,EAAE,MAAM,CAAC;IAExB,cAAc;IACd,OAAO,EAAE,MAAM,EAAE,CAAC;IAElB,cAAc;IACd,aAAa,EAAE,MAAM,CAAC;IAEtB,eAAe;IACf,aAAa,EAAE,MAAM,CAAC;IAEtB,eAAe;IACf,aAAa,EAAE,MAAM,CAAC;IAEtB,kBAAkB;IAClB,WAAW,EAAE,MAAM,CAAC;IAEpB,gBAAgB;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,UAAU;IACV,GAAG,EAAE,MAAM,CAAC;IAEZ,WAAW;IACX,KAAK,EAAE,MAAM,CAAC;IAEd,aAAa;IACb,IAAI,EAAE,MAAM,CAAC;IAEb,aAAa;IACb,UAAU,EAAE,IAAI,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,gBAAgB;IAChB,eAAe,EAAE,MAAM,CAAC;IAExB,aAAa;IACb,sBAAsB,EAAE,MAAM,CAAC;IAE/B,eAAe;IACf,iBAAiB,EAAE,MAAM,CAAC;IAE1B,eAAe;IACf,iBAAiB,EAAE,MAAM,CAAC;IAE1B,cAAc;IACd,kBAAkB,EAAE,MAAM,CAAC;IAE3B,iBAAiB;IACjB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,YAAY;IACZ,MAAM,EAAE,UAAU,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;IAElD,uBAAuB;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,oBAAoB;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B,mBAAmB;IACnB,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,qBAAqB,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,MAAM,qBAAqB,GAC7B,eAAe,GACf,uBAAuB,GACvB,kBAAkB,GAClB,SAAS,GACT,gBAAgB,GAChB,eAAe,CAAC;AAEpB;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,eAAO,MAAM,4BAA4B;;;;;4BAKV,aAAa;CAClC,CAAC"}

package/dist/research/types.js

@@ -0,0 +1,18 @@
+/**
+ * Deep Research Orchestrator - 型定義
+ *
+ * @requirement REQ-ANALYZE-008
+ * @design DES-ANALYZE-008
+ * @task TASK-003
+ */
+/**
+ * デフォルト設定
+ */
+export const DEFAULT_DEEP_RESEARCH_CONFIG = {
+    maxIterations: 10,
+    convergenceThreshold: 0.15, // 新規情報率15%以下で収束
+    iterationTimeout: 60000, // 1分
+    totalTimeout: 600000, // 10分
+    depthPriority: 'balanced',
+};
+//# sourceMappingURL=types.js.map

package/dist/research/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/research/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAsSH;;GAEG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG;IAC1C,aAAa,EAAE,EAAE;IACjB,oBAAoB,EAAE,IAAI,EAAE,gBAAgB;IAC5C,gBAAgB,EAAE,KAAK,EAAE,KAAK;IAC9B,YAAY,EAAE,MAAM,EAAE,MAAM;IAC5B,aAAa,EAAE,UAA2B;CAClC,CAAC"}