@nahisaho/katashiro-analyzer 0.2.2 → 0.2.4

package/dist/trend/TrendAnalyzer.js

@@ -0,0 +1,291 @@
+/**
+ * TrendAnalyzer - トレンド分析オーケストレータ
+ *
+ * 時系列データの収集、トレンド検出、予測、可視化を統合的に実行する
+ *
+ * @requirement REQ-ANALYZE-004
+ * @design DES-ANALYZE-004
+ * @task TASK-004
+ */
+import { ok, err, isOk } from '@nahisaho/katashiro-core';
+import { TimeSeriesCollector } from './TimeSeriesCollector.js';
+import { TrendDetector } from './TrendDetector.js';
+import { ForecastEngine } from './ForecastEngine.js';
+import { VisualizationGenerator } from './VisualizationGenerator.js';
+/**
+ * トレンド分析を統合的に実行するメインクラス
+ *
+ * @example
+ * ```typescript
+ * const analyzer = new TrendAnalyzer();
+ *
+ * const result = await analyzer.analyze({
+ *   topic: 'AI',
+ *   dateRange: {
+ *     start: new Date('2025-01-01'),
+ *     end: new Date('2025-12-31'),
+ *   },
+ *   options: {
+ *     granularity: 'weekly',
+ *     sources: ['news', 'web'],
+ *     includeForecast: true,
+ *   },
+ * });
+ *
+ * if (isOk(result)) {
+ *   console.log(result.value.summary);
+ * }
+ * ```
+ */
+export class TrendAnalyzer {
+    collector;
+    detector;
+    forecaster;
+    visualizer;
+    config;
+    constructor(config) {
+        this.config = {
+            maxSources: config?.maxSources ?? 5,
+            defaultGranularity: config?.defaultGranularity ?? 'weekly',
+            forecastPeriods: config?.forecastPeriods ?? 7,
+            enableCaching: config?.enableCaching ?? false,
+        };
+        this.collector = new TimeSeriesCollector();
+        this.detector = new TrendDetector({
+            sensitivityThreshold: 0.1,
+            minDataPoints: 3,
+            detectSeasonality: true,
+        });
+        this.forecaster = new ForecastEngine();
+        this.visualizer = new VisualizationGenerator();
+    }
+    /**
+     * トレンド分析を実行
+     */
+    async analyze(query) {
+        const startTime = Date.now();
+        try {
+            // 入力検証
+            const validationError = this.validateQuery(query);
+            if (validationError) {
+                return err(validationError);
+            }
+            // デフォルト値を適用
+            const granularity = query.options?.granularity ?? this.config.defaultGranularity;
+            const sources = query.options?.sources ?? ['news', 'web'];
+            const includeForecast = query.options?.includeForecast ?? true;
+            const forecastPeriods = query.options?.forecastPeriods ?? this.config.forecastPeriods;
+            // 時系列データを収集
+            const collectionResult = await this.collector.collect({
+                topic: query.topic,
+                startDate: query.dateRange.start,
+                endDate: query.dateRange.end,
+                granularity,
+                sources,
+            });
+            if (!isOk(collectionResult)) {
+                return err(collectionResult.error);
+            }
+            const timeSeries = collectionResult.value;
+            // トレンドを検出
+            const trends = this.detector.detect(timeSeries);
+            // サマリーを生成
+            const summary = this.detector.generateSummary(timeSeries, trends);
+            // 予測を生成（オプション）
+            let forecast = undefined;
+            if (includeForecast && timeSeries.length >= 3) {
+                forecast = this.forecaster.forecast(timeSeries, {
+                    periods: forecastPeriods,
+                    method: 'linear',
+                    confidenceLevel: 0.95,
+                });
+            }
+            // 可視化データを生成
+            const visualization = this.visualizer.generate({
+                timeSeries,
+                trends,
+                forecast,
+            });
+            const processingTime = Date.now() - startTime;
+            return ok({
+                topic: query.topic,
+                dateRange: query.dateRange,
+                timeSeries,
+                trends,
+                summary,
+                forecast,
+                visualization,
+                metadata: {
+                    sources,
+                    granularity,
+                    dataPoints: timeSeries.length,
+                    analysisTimestamp: new Date(),
+                    processingTimeMs: processingTime,
+                },
+            });
+        }
+        catch (error) {
+            return err({
+                code: 'ANALYSIS_FAILED',
+                message: error instanceof Error ? error.message : 'Unknown analysis error',
+                details: error,
+            });
+        }
+    }
+    /**
+     * 複数トピックを比較分析
+     */
+    async compare(topics, dateRange, options) {
+        try {
+            if (topics.length < 2) {
+                return err({
+                    code: 'INVALID_INPUT',
+                    message: 'At least 2 topics are required for comparison',
+                });
+            }
+            if (topics.length > 5) {
+                return err({
+                    code: 'INVALID_INPUT',
+                    message: 'Maximum 5 topics can be compared at once',
+                });
+            }
+            const granularity = options?.granularity ?? this.config.defaultGranularity;
+            const sources = options?.sources ?? ['news', 'web'];
+            // 各トピックのデータを収集
+            const topicsData = await Promise.all(topics.map(async (topic) => {
+                const result = await this.collector.collect({
+                    topic,
+                    startDate: dateRange.start,
+                    endDate: dateRange.end,
+                    granularity,
+                    sources,
+                });
+                return {
+                    topic,
+                    data: isOk(result) ? result.value : [],
+                };
+            }));
+            // 相関分析
+            const correlations = this.calculateTopicCorrelations(topicsData);
+            // 比較サマリーを生成
+            const comparisonSummary = this.generateComparisonSummary(topicsData, correlations);
+            // 比較用の可視化データ
+            const comparison = {
+                topics: topicsData,
+                correlations,
+                comparisonSummary,
+            };
+            return ok(comparison);
+        }
+        catch (error) {
+            return err({
+                code: 'COMPARISON_FAILED',
+                message: error instanceof Error ? error.message : 'Unknown comparison error',
+                details: error,
+            });
+        }
+    }
+    /**
+     * クエリの検証
+     */
+    validateQuery(query) {
+        if (!query.topic || query.topic.trim().length === 0) {
+            return {
+                code: 'INVALID_INPUT',
+                message: 'Topic is required',
+            };
+        }
+        if (!query.dateRange?.start || !query.dateRange?.end) {
+            return {
+                code: 'INVALID_INPUT',
+                message: 'Date range is required',
+            };
+        }
+        if (query.dateRange.start >= query.dateRange.end) {
+            return {
+                code: 'INVALID_INPUT',
+                message: 'Start date must be before end date',
+            };
+        }
+        // 1年以上の範囲は制限
+        const oneYear = 365 * 24 * 60 * 60 * 1000;
+        if (query.dateRange.end.getTime() - query.dateRange.start.getTime() > oneYear * 2) {
+            return {
+                code: 'INVALID_INPUT',
+                message: 'Date range cannot exceed 2 years',
+            };
+        }
+        return null;
+    }
+    /**
+     * トピック間の相関を計算
+     */
+    calculateTopicCorrelations(topicsData) {
+        const correlations = [];
+        for (let i = 0; i < topicsData.length; i++) {
+            for (let j = i + 1; j < topicsData.length; j++) {
+                const topicI = topicsData[i];
+                const topicJ = topicsData[j];
+                if (!topicI || !topicJ)
+                    continue;
+                const correlation = this.calculateCorrelation(topicI.data.map((d) => d.normalizedScore), topicJ.data.map((d) => d.normalizedScore));
+                correlations.push({
+                    topic1: topicI.topic,
+                    topic2: topicJ.topic,
+                    correlation,
+                });
+            }
+        }
+        return correlations;
+    }
+    /**
+     * 相関係数を計算
+     */
+    calculateCorrelation(x, y) {
+        const n = Math.min(x.length, y.length);
+        if (n === 0)
+            return 0;
+        const xSlice = x.slice(0, n);
+        const ySlice = y.slice(0, n);
+        const xMean = xSlice.reduce((a, b) => a + b, 0) / n;
+        const yMean = ySlice.reduce((a, b) => a + b, 0) / n;
+        let numerator = 0;
+        let xSumSq = 0;
+        let ySumSq = 0;
+        for (let i = 0; i < n; i++) {
+            const xVal = xSlice[i] ?? 0;
+            const yVal = ySlice[i] ?? 0;
+            const xDiff = xVal - xMean;
+            const yDiff = yVal - yMean;
+            numerator += xDiff * yDiff;
+            xSumSq += xDiff * xDiff;
+            ySumSq += yDiff * yDiff;
+        }
+        const denominator = Math.sqrt(xSumSq * ySumSq);
+        return denominator === 0 ? 0 : numerator / denominator;
+    }
+    /**
+     * 比較サマリーを生成
+     */
+    generateComparisonSummary(topicsData, correlations) {
+        const parts = [];
+        // トピックごとの総ボリューム
+        const topicVolumes = topicsData.map((t) => ({
+            topic: t.topic,
+            volume: t.data.reduce((sum, d) => sum + d.volume, 0),
+        }));
+        topicVolumes.sort((a, b) => b.volume - a.volume);
+        const topTopic = topicVolumes[0];
+        if (topTopic) {
+            parts.push(`最も関心が高いトピック: ${topTopic.topic}`);
+        }
+        // 強い相関があるペア
+        const strongCorrelations = correlations.filter((c) => Math.abs(c.correlation) > 0.7);
+        const pair = strongCorrelations[0];
+        if (pair) {
+            parts.push(`${pair.topic1}と${pair.topic2}は強い相関（${pair.correlation.toFixed(2)}）があります`);
+        }
+        return parts.join('。');
+    }
+}
+//# sourceMappingURL=TrendAnalyzer.js.map

package/dist/trend/TrendAnalyzer.js.map

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

package/dist/trend/TrendDetector.d.ts

@@ -0,0 +1,67 @@
+/**
+ * TrendDetector - トレンド検出エンジン
+ *
+ * @requirement REQ-ANALYZE-004
+ * @design DES-ANALYZE-004
+ * @task TASK-004
+ */
+import type { TimeSeriesData, DetectedTrend, TrendDetectorConfig, TrendSummary } from './types.js';
+/**
+ * 時系列データからトレンドを検出するクラス
+ *
+ * @example
+ * ```typescript
+ * const detector = new TrendDetector();
+ *
+ * const trends = detector.detect(timeSeriesData, {
+ *   sensitivityThreshold: 0.1,
+ *   minDataPoints: 3,
+ *   detectSeasonality: true,
+ * });
+ * ```
+ */
+export declare class TrendDetector {
+    private config;
+    constructor(config?: Partial<TrendDetectorConfig>);
+    /**
+     * 時系列データからトレンドを検出
+     */
+    detect(data: TimeSeriesData[]): DetectedTrend[];
+    /**
+     * トレンドサマリーを生成
+     */
+    generateSummary(data: TimeSeriesData[], trends: DetectedTrend[]): TrendSummary;
+    /**
+     * 全体的なトレンドを検出
+     */
+    private detectOverallTrend;
+    /**
+     * スパイク（急上昇）を検出
+     */
+    private detectSpikes;
+    /**
+     * 季節性を検出
+     */
+    private detectSeasonality;
+    /**
+     * 新興トレンドを検出
+     */
+    private detectEmerging;
+    /**
+     * 線形回帰を計算
+     */
+    private linearRegression;
+    /**
+     * 自己相関を計算
+     */
+    private autocorrelation;
+    /**
+     * ナラティブを生成
+     */
+    private generateNarrative;
+    /**
+     * キーインサイトを生成
+     */
+    private generateKeyInsights;
+}
+//# sourceMappingURL=TrendDetector.d.ts.map

package/dist/trend/TrendDetector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TrendDetector.d.ts","sourceRoot":"","sources":["../../src/trend/TrendDetector.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EAEb,mBAAmB,EACnB,YAAY,EACb,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;;;;;GAaG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAgC;gBAElC,MAAM,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC;IAQjD;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,cAAc,EAAE,GAAG,aAAa,EAAE;IAqC/C;;OAEG;IACH,eAAe,CAAC,IAAI,EAAE,cAAc,EAAE,EAAE,MAAM,EAAE,aAAa,EAAE,GAAG,YAAY;IA8B9E;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA6C1B;;OAEG;IACH,OAAO,CAAC,YAAY;IAgCpB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA4BzB;;OAEG;IACH,OAAO,CAAC,cAAc;IAgCtB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAqBxB;;OAEG;IACH,OAAO,CAAC,eAAe;IAsBvB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA+BzB;;OAEG;IACH,OAAO,CAAC,mBAAmB;CAmC5B"}