@nahisaho/katashiro-collector 0.2.2 → 0.2.4

package/dist/index.js

@@ -3,8 +3,8 @@
  * 情報収集パッケージ
  *
  * @requirement REQ-COLLECT-001 ~ REQ-COLLECT-009
- * @design DES-KATASHIRO-001 §2.2 Collector Container
- * @task TSK-010 ~ TSK-015
+ * @design DES-KATASHIRO-001 §2.2 Collector Container, DES-COLLECT-003, DES-COLLECT-008
+ * @task TSK-010 ~ TSK-015, TASK-001, TASK-002
  */
 // 実装
 export { WebSearchClient } from './web-search/index.js';
@@ -17,4 +17,16 @@ export { MediaExtractor } from './media/index.js';
 export { APIClient as ApiClient } from './api/index.js';
 // Source tracking (v0.2.0)
 export { SourceTracker, CredibilityScorer, } from './source/index.js';
+// Document parsing (v0.2.3) - DES-COLLECT-003
+export { DocumentParser, PDFParser, DOCXParser, XLSXParser, DEFAULT_PARSE_OPTIONS, } from './document/index.js';
+// Wide Research (v0.2.3) - DES-COLLECT-008
+export { WideResearchEngine, QueryPlanner, ResultAggregator, CoverageAnalyzer, WebSearchAgent, NewsSearchAgent, AcademicSearchAgent, EncyclopediaAgent, DEFAULT_RESEARCH_CONFIG, } from './research/index.js';
+// Browser Automation (v0.2.3) - DES-COLLECT-009
+export { 
+// Main class
+BrowserAutomation, BrowserAutomationError, 
+// Sub-components
+ActionExecutor, ContentExtractor, SessionManager, 
+// Config
+DEFAULT_BROWSER_CONFIG, } from './browser/index.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAsBH,KAAK;AACL,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAyB,MAAM,gBAAgB,CAAC;AAClE,OAAO,EAAE,cAAc,EAAuB,MAAM,kBAAkB,CAAC;AAEvE,kDAAkD;AAClD,OAAO,EAAE,SAAS,IAAI,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAExD,2BAA2B;AAC3B,OAAO,EACL,aAAa,EAGb,iBAAiB,GAGlB,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAsBH,KAAK;AACL,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAyB,MAAM,gBAAgB,CAAC;AAClE,OAAO,EAAE,cAAc,EAAuB,MAAM,kBAAkB,CAAC;AAEvE,kDAAkD;AAClD,OAAO,EAAE,SAAS,IAAI,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAExD,2BAA2B;AAC3B,OAAO,EACL,aAAa,EAGb,iBAAiB,GAGlB,MAAM,mBAAmB,CAAC;AAE3B,8CAA8C;AAC9C,OAAO,EACL,cAAc,EACd,SAAS,EACT,UAAU,EACV,UAAU,EACV,qBAAqB,GACtB,MAAM,qBAAqB,CAAC;AAyB7B,2CAA2C;AAC3C,OAAO,EACL,kBAAkB,EAClB,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,mBAAmB,EACnB,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,qBAAqB,CAAC;AA4B7B,gDAAgD;AAChD,OAAO;AACL,aAAa;AACb,iBAAiB,EACjB,sBAAsB;AACtB,iBAAiB;AACjB,cAAc,EACd,gBAAgB,EAChB,cAAc;AACd,SAAS;AACT,sBAAsB,GAuCvB,MAAM,oBAAoB,CAAC"}

package/dist/research/CoverageAnalyzer.d.ts

@@ -0,0 +1,50 @@
+/**
+ * CoverageAnalyzer - カバレッジ分析
+ *
+ * 検索結果のソースカバレッジと品質を分析する。
+ *
+ * @requirement REQ-COLLECT-008
+ * @design DES-COLLECT-008
+ * @task TASK-002
+ */
+import type { CoverageReport, SourceType } from './types.js';
+import type { AgentExecutionResult } from './agents/types.js';
+/**
+ * カバレッジ分析クラス
+ *
+ * @example
+ * ```typescript
+ * const analyzer = new CoverageAnalyzer();
+ * const coverage = analyzer.analyze(results, ['web', 'news', 'academic']);
+ * ```
+ */
+export declare class CoverageAnalyzer {
+    /**
+     * カバレッジを分析
+     */
+    analyze(results: AgentExecutionResult[], expectedSources: SourceType[]): CoverageReport;
+    /**
+     * 観点の多様性を計算
+     *
+     * ソースタイプの多様性に基づいてスコアを算出。
+     * 異なるカテゴリ（web, news, academic, encyclopedia）をカバーするほど高スコア。
+     */
+    private calculatePerspectiveDiversity;
+    /**
+     * 時間的カバレッジを分析
+     */
+    private analyzeTemporalCoverage;
+    /**
+     * 時間分布を計算
+     */
+    private calculateTimeDistribution;
+    /**
+     * ギャップを識別
+     */
+    private identifyGaps;
+    /**
+     * 追加推奨ソースを提案
+     */
+    private suggestAdditionalSources;
+}
+//# sourceMappingURL=CoverageAnalyzer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CoverageAnalyzer.d.ts","sourceRoot":"","sources":["../../src/research/CoverageAnalyzer.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,UAAU,EAIX,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAE9D;;;;;;;;GAQG;AACH,qBAAa,gBAAgB;IAC3B;;OAEG;IACH,OAAO,CAAC,OAAO,EAAE,oBAAoB,EAAE,EAAE,eAAe,EAAE,UAAU,EAAE,GAAG,cAAc;IAmCvF;;;;;OAKG;IACH,OAAO,CAAC,6BAA6B;IAuBrC;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAuB/B;;OAEG;IACH,OAAO,CAAC,yBAAyB;IA+BjC;;OAEG;IACH,OAAO,CAAC,YAAY;IAuCpB;;OAEG;IACH,OAAO,CAAC,wBAAwB;CAgBjC"}

package/dist/research/CoverageAnalyzer.js

@@ -0,0 +1,169 @@
+/**
+ * CoverageAnalyzer - カバレッジ分析
+ *
+ * 検索結果のソースカバレッジと品質を分析する。
+ *
+ * @requirement REQ-COLLECT-008
+ * @design DES-COLLECT-008
+ * @task TASK-002
+ */
+/**
+ * カバレッジ分析クラス
+ *
+ * @example
+ * ```typescript
+ * const analyzer = new CoverageAnalyzer();
+ * const coverage = analyzer.analyze(results, ['web', 'news', 'academic']);
+ * ```
+ */
+export class CoverageAnalyzer {
+    /**
+     * カバレッジを分析
+     */
+    analyze(results, expectedSources) {
+        const coveredSources = results
+            .filter((r) => r.result.status === 'success' || r.result.status === 'partial')
+            .map((r) => r.agent.type);
+        const failedSources = results
+            .filter((r) => r.result.status === 'failed' || r.result.status === 'timeout')
+            .map((r) => r.agent.type);
+        // カバレッジ率を計算
+        const coverageRate = coveredSources.length / Math.max(expectedSources.length, 1);
+        // 観点の多様性を計算
+        const perspectiveDiversity = this.calculatePerspectiveDiversity(coveredSources);
+        // 時間的カバレッジを分析
+        const temporalCoverage = this.analyzeTemporalCoverage(results);
+        // ギャップを識別
+        const gaps = this.identifyGaps(expectedSources, coveredSources, results);
+        // 追加推奨ソースを提案
+        const suggestedSources = this.suggestAdditionalSources(coveredSources, expectedSources);
+        return {
+            coveredSources,
+            failedSources,
+            coverageRate,
+            perspectiveDiversity,
+            temporalCoverage,
+            suggestedSources,
+            gaps,
+        };
+    }
+    /**
+     * 観点の多様性を計算
+     *
+     * ソースタイプの多様性に基づいてスコアを算出。
+     * 異なるカテゴリ（web, news, academic, encyclopedia）をカバーするほど高スコア。
+     */
+    calculatePerspectiveDiversity(coveredSources) {
+        // ソースタイプを大カテゴリに分類
+        const categories = {
+            general: ['web'],
+            news: ['news'],
+            academic: ['academic'],
+            reference: ['encyclopedia', 'government'],
+            social: ['social'],
+        };
+        // カバーしているカテゴリ数を計算
+        let coveredCategories = 0;
+        const totalCategories = Object.keys(categories).length;
+        for (const [, sourceTypes] of Object.entries(categories)) {
+            if (sourceTypes.some((st) => coveredSources.includes(st))) {
+                coveredCategories++;
+            }
+        }
+        return coveredCategories / totalCategories;
+    }
+    /**
+     * 時間的カバレッジを分析
+     */
+    analyzeTemporalCoverage(results) {
+        const allFindings = results.flatMap((r) => r.result.findings);
+        const datedFindings = allFindings.filter((f) => f.publishedAt);
+        if (datedFindings.length === 0) {
+            return undefined;
+        }
+        const dates = datedFindings
+            .map((f) => f.publishedAt)
+            .sort((a, b) => a.getTime() - b.getTime());
+        const distribution = this.calculateTimeDistribution(dates);
+        return {
+            oldestResult: dates[0],
+            newestResult: dates[dates.length - 1],
+            distribution,
+        };
+    }
+    /**
+     * 時間分布を計算
+     */
+    calculateTimeDistribution(dates) {
+        const now = new Date();
+        const periods = [
+            { label: 'Last 24h', days: 1 },
+            { label: 'Last week', days: 7 },
+            { label: 'Last month', days: 30 },
+            { label: 'Last year', days: 365 },
+            { label: 'Older', days: Infinity },
+        ];
+        const distribution = [];
+        for (const period of periods) {
+            const cutoff = new Date(now.getTime() - period.days * 24 * 60 * 60 * 1000);
+            const count = dates.filter((d) => {
+                if (period.days === Infinity) {
+                    const yearAgo = new Date(now.getTime() - 365 * 24 * 60 * 60 * 1000);
+                    return d < yearAgo;
+                }
+                const prevCutoff = periods[periods.indexOf(period) - 1]?.days ?? 0;
+                const prevDate = new Date(now.getTime() - prevCutoff * 24 * 60 * 60 * 1000);
+                return d >= cutoff && d < prevDate;
+            }).length;
+            distribution.push({ period: period.label, count });
+        }
+        return distribution;
+    }
+    /**
+     * ギャップを識別
+     */
+    identifyGaps(expectedSources, coveredSources, results) {
+        const gaps = [];
+        // ソースギャップ
+        const missingSources = expectedSources.filter((s) => !coveredSources.includes(s));
+        if (missingSources.length > 0) {
+            gaps.push({
+                type: 'source',
+                description: `Missing sources: ${missingSources.join(', ')}`,
+                suggestion: `Add ${missingSources[0]} agent or retry failed sources`,
+            });
+        }
+        // 結果数が少ない場合
+        const totalResults = results.reduce((sum, r) => sum + r.result.findings.length, 0);
+        if (totalResults < 5) {
+            gaps.push({
+                type: 'perspective',
+                description: 'Very few results found',
+                suggestion: 'Try broadening the search query or using different keywords',
+            });
+        }
+        // 学術ソースがない場合
+        if (!coveredSources.includes('academic') && expectedSources.includes('academic')) {
+            gaps.push({
+                type: 'perspective',
+                description: 'No academic/research perspective',
+                suggestion: 'Consider adding academic sources for authoritative information',
+            });
+        }
+        return gaps;
+    }
+    /**
+     * 追加推奨ソースを提案
+     */
+    suggestAdditionalSources(coveredSources, expectedSources) {
+        const allPossibleSources = [
+            'web',
+            'news',
+            'academic',
+            'encyclopedia',
+        ];
+        // まだカバーしていないソースを提案
+        return allPossibleSources.filter((s) => !coveredSources.includes(s) && !expectedSources.includes(s));
+    }
+}
+//# sourceMappingURL=CoverageAnalyzer.js.map

package/dist/research/CoverageAnalyzer.js.map

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

package/dist/research/QueryPlanner.d.ts

@@ -0,0 +1,57 @@
+/**
+ * QueryPlanner - クエリ計画立案
+ *
+ * 検索クエリを各エージェント向けに最適化し、実行計画を生成する。
+ *
+ * @requirement REQ-COLLECT-008
+ * @design DES-COLLECT-008
+ * @task TASK-002
+ */
+import type { WideResearchQuery, SourceType } from './types.js';
+import type { ISearchAgent, AgentSearchQuery } from './agents/types.js';
+/**
+ * クエリ実行計画
+ */
+export interface QueryPlan {
+    /** 実行するエージェント */
+    agents: ISearchAgent[];
+    /** エージェント別のクエリ */
+    queries: Map<SourceType, AgentSearchQuery>;
+    /** 各エージェントのタイムアウト */
+    timeout: number;
+}
+/**
+ * クエリ計画立案クラス
+ *
+ * @example
+ * ```typescript
+ * const planner = new QueryPlanner();
+ * const plan = planner.plan(query, agents);
+ * ```
+ */
+export declare class QueryPlanner {
+    /**
+     * クエリ計画を生成
+     */
+    plan(query: WideResearchQuery, agents: ISearchAgent[], config?: {
+        agentTimeout: number;
+        maxResultsPerSource: number;
+    }): QueryPlan;
+    /**
+     * エージェント固有のクエリを生成
+     */
+    private createAgentQuery;
+    /**
+     * ソースタイプに応じてクエリを最適化
+     */
+    private optimizeQueryForSource;
+    /**
+     * 学術検索用にクエリをクリーン化
+     */
+    private cleanAcademicQuery;
+    /**
+     * 百科事典用にクエリを簡略化
+     */
+    private simplifyQuery;
+}
+//# sourceMappingURL=QueryPlanner.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"QueryPlanner.d.ts","sourceRoot":"","sources":["../../src/research/QueryPlanner.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAExE;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,iBAAiB;IACjB,MAAM,EAAE,YAAY,EAAE,CAAC;IAEvB,kBAAkB;IAClB,OAAO,EAAE,GAAG,CAAC,UAAU,EAAE,gBAAgB,CAAC,CAAC;IAE3C,qBAAqB;IACrB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;GAQG;AACH,qBAAa,YAAY;IACvB;;OAEG;IACH,IAAI,CACF,KAAK,EAAE,iBAAiB,EACxB,MAAM,EAAE,YAAY,EAAE,EACtB,MAAM,GAAE;QACN,YAAY,EAAE,MAAM,CAAC;QACrB,mBAAmB,EAAE,MAAM,CAAC;KACsB,GACnD,SAAS;IAeZ;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAiBxB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAoB9B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAoB1B;;OAEG;IACH,OAAO,CAAC,aAAa;CAYtB"}

package/dist/research/QueryPlanner.js

@@ -0,0 +1,102 @@
+/**
+ * QueryPlanner - クエリ計画立案
+ *
+ * 検索クエリを各エージェント向けに最適化し、実行計画を生成する。
+ *
+ * @requirement REQ-COLLECT-008
+ * @design DES-COLLECT-008
+ * @task TASK-002
+ */
+/**
+ * クエリ計画立案クラス
+ *
+ * @example
+ * ```typescript
+ * const planner = new QueryPlanner();
+ * const plan = planner.plan(query, agents);
+ * ```
+ */
+export class QueryPlanner {
+    /**
+     * クエリ計画を生成
+     */
+    plan(query, agents, config = { agentTimeout: 30000, maxResultsPerSource: 20 }) {
+        const queries = new Map();
+        for (const agent of agents) {
+            const agentQuery = this.createAgentQuery(query, agent.type, config);
+            queries.set(agent.type, agentQuery);
+        }
+        return {
+            agents,
+            queries,
+            timeout: config.agentTimeout,
+        };
+    }
+    /**
+     * エージェント固有のクエリを生成
+     */
+    createAgentQuery(query, sourceType, config) {
+        // ソースタイプに応じてクエリを最適化
+        const optimizedQuery = this.optimizeQueryForSource(query.topic, sourceType);
+        return {
+            query: optimizedQuery,
+            maxResults: query.maxResultsPerSource ?? config.maxResultsPerSource,
+            languages: query.languages,
+            dateRange: query.dateRange,
+            timeout: query.agentTimeout ?? config.agentTimeout,
+        };
+    }
+    /**
+     * ソースタイプに応じてクエリを最適化
+     */
+    optimizeQueryForSource(topic, sourceType) {
+        switch (sourceType) {
+            case 'academic':
+                // 学術検索では専門用語を保持、不要な修飾語を削除
+                return this.cleanAcademicQuery(topic);
+            case 'news':
+                // ニュース検索では最新情報を優先
+                return topic;
+            case 'encyclopedia':
+                // 百科事典では概念的なクエリに
+                return this.simplifyQuery(topic);
+            case 'web':
+            default:
+                return topic;
+        }
+    }
+    /**
+     * 学術検索用にクエリをクリーン化
+     */
+    cleanAcademicQuery(query) {
+        // "最新の", "について", などの修飾語を除去
+        const removePatterns = [
+            /最新の/g,
+            /について/g,
+            /に関する/g,
+            /とは/g,
+            /what is/gi,
+            /latest/gi,
+            /recent/gi,
+        ];
+        let cleaned = query;
+        for (const pattern of removePatterns) {
+            cleaned = cleaned.replace(pattern, '');
+        }
+        return cleaned.trim();
+    }
+    /**
+     * 百科事典用にクエリを簡略化
+     */
+    simplifyQuery(query) {
+        // 最初の主要な名詞句を抽出（シンプルなアプローチ）
+        const words = query.split(/\s+/);
+        // 3語以下ならそのまま
+        if (words.length <= 3) {
+            return query;
+        }
+        // 最初の3語を使用
+        return words.slice(0, 3).join(' ');
+    }
+}
+//# sourceMappingURL=QueryPlanner.js.map

package/dist/research/QueryPlanner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"QueryPlanner.js","sourceRoot":"","sources":["../../src/research/QueryPlanner.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAmBH;;;;;;;;GAQG;AACH,MAAM,OAAO,YAAY;IACvB;;OAEG;IACH,IAAI,CACF,KAAwB,EACxB,MAAsB,EACtB,SAGI,EAAE,YAAY,EAAE,KAAK,EAAE,mBAAmB,EAAE,EAAE,EAAE;QAEpD,MAAM,OAAO,GAAG,IAAI,GAAG,EAAgC,CAAC;QAExD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,MAAM,UAAU,GAAG,IAAI,CAAC,gBAAgB,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YACpE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QACtC,CAAC;QAED,OAAO;YACL,MAAM;YACN,OAAO;YACP,OAAO,EAAE,MAAM,CAAC,YAAY;SAC7B,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,gBAAgB,CACtB,KAAwB,EACxB,UAAsB,EACtB,MAA6D;QAE7D,oBAAoB;QACpB,MAAM,cAAc,GAAG,IAAI,CAAC,sBAAsB,CAAC,KAAK,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;QAE5E,OAAO;YACL,KAAK,EAAE,cAAc;YACrB,UAAU,EAAE,KAAK,CAAC,mBAAmB,IAAI,MAAM,CAAC,mBAAmB;YACnE,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,OAAO,EAAE,KAAK,CAAC,YAAY,IAAI,MAAM,CAAC,YAAY;SACnD,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,sBAAsB,CAAC,KAAa,EAAE,UAAsB;QAClE,QAAQ,UAAU,EAAE,CAAC;YACnB,KAAK,UAAU;gBACb,0BAA0B;gBAC1B,OAAO,IAAI,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC;YAExC,KAAK,MAAM;gBACT,kBAAkB;gBAClB,OAAO,KAAK,CAAC;YAEf,KAAK,cAAc;gBACjB,iBAAiB;gBACjB,OAAO,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;YAEnC,KAAK,KAAK,CAAC;YACX;gBACE,OAAO,KAAK,CAAC;QACjB,CAAC;IACH,CAAC;IAED;;OAEG;IACK,kBAAkB,CAAC,KAAa;QACtC,2BAA2B;QAC3B,MAAM,cAAc,GAAG;YACrB,MAAM;YACN,OAAO;YACP,OAAO;YACP,KAAK;YACL,WAAW;YACX,UAAU;YACV,UAAU;SACX,CAAC;QAEF,IAAI,OAAO,GAAG,KAAK,CAAC;QACpB,KAAK,MAAM,OAAO,IAAI,cAAc,EAAE,CAAC;YACrC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QACzC,CAAC;QAED,OAAO,OAAO,CAAC,IAAI,EAAE,CAAC;IACxB,CAAC;IAED;;OAEG;IACK,aAAa,CAAC,KAAa;QACjC,2BAA2B;QAC3B,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAEjC,aAAa;QACb,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;YACtB,OAAO,KAAK,CAAC;QACf,CAAC;QAED,WAAW;QACX,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACrC,CAAC;CACF"}

package/dist/research/ResultAggregator.d.ts

@@ -0,0 +1,39 @@
+/**
+ * ResultAggregator - 結果集約
+ *
+ * 複数エージェントの結果を集約・重複排除・ランキングする。
+ *
+ * @requirement REQ-COLLECT-008
+ * @design DES-COLLECT-008
+ * @task TASK-002
+ */
+import type { Finding } from './types.js';
+import type { AgentSearchResult } from './agents/types.js';
+/**
+ * 結果集約クラス
+ *
+ * @example
+ * ```typescript
+ * const aggregator = new ResultAggregator();
+ * const findings = aggregator.aggregate(results, 'AI ethics');
+ * ```
+ */
+export declare class ResultAggregator {
+    /**
+     * 結果を集約
+     */
+    aggregate(results: AgentSearchResult[], originalQuery: string): Finding[];
+    /**
+     * URL/タイトルベースで重複排除
+     */
+    private deduplicate;
+    /**
+     * URLを正規化
+     */
+    private normalizeUrl;
+    /**
+     * 関連性でランキング
+     */
+    private rankByRelevance;
+}
+//# sourceMappingURL=ResultAggregator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ResultAggregator.d.ts","sourceRoot":"","sources":["../../src/research/ResultAggregator.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAE3D;;;;;;;;GAQG;AACH,qBAAa,gBAAgB;IAC3B;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,iBAAiB,EAAE,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,EAAE;IAazE;;OAEG;IACH,OAAO,CAAC,WAAW;IA0BnB;;OAEG;IACH,OAAO,CAAC,YAAY;IAUpB;;OAEG;IACH,OAAO,CAAC,eAAe;CAUxB"}

package/dist/research/ResultAggregator.js

@@ -0,0 +1,85 @@
+/**
+ * ResultAggregator - 結果集約
+ *
+ * 複数エージェントの結果を集約・重複排除・ランキングする。
+ *
+ * @requirement REQ-COLLECT-008
+ * @design DES-COLLECT-008
+ * @task TASK-002
+ */
+/**
+ * 結果集約クラス
+ *
+ * @example
+ * ```typescript
+ * const aggregator = new ResultAggregator();
+ * const findings = aggregator.aggregate(results, 'AI ethics');
+ * ```
+ */
+export class ResultAggregator {
+    /**
+     * 結果を集約
+     */
+    aggregate(results, originalQuery) {
+        // 全結果をフラット化
+        const allFindings = results.flatMap((r) => r.findings);
+        // 重複排除
+        const deduplicated = this.deduplicate(allFindings);
+        // 関連性でソート
+        const sorted = this.rankByRelevance(deduplicated, originalQuery);
+        return sorted;
+    }
+    /**
+     * URL/タイトルベースで重複排除
+     */
+    deduplicate(findings) {
+        const seen = new Map();
+        for (const finding of findings) {
+            const key = this.normalizeUrl(finding.url);
+            if (!seen.has(key)) {
+                seen.set(key, finding);
+            }
+            else {
+                // 既存の結果とマージ（より高いスコアを採用）
+                const existing = seen.get(key);
+                if (finding.relevanceScore > existing.relevanceScore) {
+                    seen.set(key, {
+                        ...existing,
+                        ...finding,
+                        // 最高スコアを維持
+                        relevanceScore: Math.max(existing.relevanceScore, finding.relevanceScore),
+                        credibilityScore: Math.max(existing.credibilityScore, finding.credibilityScore),
+                    });
+                }
+            }
+        }
+        return Array.from(seen.values());
+    }
+    /**
+     * URLを正規化
+     */
+    normalizeUrl(url) {
+        try {
+            const parsed = new URL(url);
+            // クエリパラメータとフラグメントを除去
+            return `${parsed.protocol}//${parsed.host}${parsed.pathname}`.toLowerCase();
+        }
+        catch {
+            return url.toLowerCase();
+        }
+    }
+    /**
+     * 関連性でランキング
+     */
+    rankByRelevance(findings, _query) {
+        return findings
+            .map((f) => ({
+            ...f,
+            // 複合スコアを計算
+            _compositeScore: f.relevanceScore * 0.6 + f.credibilityScore * 0.4,
+        }))
+            .sort((a, b) => b._compositeScore - a._compositeScore)
+            .map(({ _compositeScore, ...finding }) => finding);
+    }
+}
+//# sourceMappingURL=ResultAggregator.js.map

package/dist/research/ResultAggregator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResultAggregator.js","sourceRoot":"","sources":["../../src/research/ResultAggregator.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH;;;;;;;;GAQG;AACH,MAAM,OAAO,gBAAgB;IAC3B;;OAEG;IACH,SAAS,CAAC,OAA4B,EAAE,aAAqB;QAC3D,YAAY;QACZ,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;QAEvD,OAAO;QACP,MAAM,YAAY,GAAG,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;QAEnD,UAAU;QACV,MAAM,MAAM,GAAG,IAAI,CAAC,eAAe,CAAC,YAAY,EAAE,aAAa,CAAC,CAAC;QAEjE,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACK,WAAW,CAAC,QAAmB;QACrC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAmB,CAAC;QAExC,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,MAAM,GAAG,GAAG,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YAE3C,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBACnB,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;YACzB,CAAC;iBAAM,CAAC;gBACN,wBAAwB;gBACxB,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAE,CAAC;gBAChC,IAAI,OAAO,CAAC,cAAc,GAAG,QAAQ,CAAC,cAAc,EAAE,CAAC;oBACrD,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE;wBACZ,GAAG,QAAQ;wBACX,GAAG,OAAO;wBACV,WAAW;wBACX,cAAc,EAAE,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC,cAAc,CAAC;wBACzE,gBAAgB,EAAE,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC,gBAAgB,CAAC;qBAChF,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IACnC,CAAC;IAED;;OAEG;IACK,YAAY,CAAC,GAAW;QAC9B,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;YAC5B,qBAAqB;YACrB,OAAO,GAAG,MAAM,CAAC,QAAQ,KAAK,MAAM,CAAC,IAAI,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC,WAAW,EAAE,CAAC;QAC9E,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,GAAG,CAAC,WAAW,EAAE,CAAC;QAC3B,CAAC;IACH,CAAC;IAED;;OAEG;IACK,eAAe,CAAC,QAAmB,EAAE,MAAc;QACzD,OAAO,QAAQ;aACZ,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACX,GAAG,CAAC;YACJ,WAAW;YACX,eAAe,EAAE,CAAC,CAAC,cAAc,GAAG,GAAG,GAAG,CAAC,CAAC,gBAAgB,GAAG,GAAG;SACnE,CAAC,CAAC;aACF,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,eAAe,GAAG,CAAC,CAAC,eAAe,CAAC;aACrD,GAAG,CAAC,CAAC,EAAE,eAAe,EAAE,GAAG,OAAO,EAAE,EAAE,EAAE,CAAC,OAAkB,CAAC,CAAC;IAClE,CAAC;CACF"}