aiden-shared-calculations-unified 1.0.75 → 1.0.76

package/calculations/socialPosts/gem_social_sentiment_aggregation.js

@@ -0,0 +1,146 @@
+/**
+ * @fileoverview Social Calculation (Pass 1)
+ *
+ * This metric answers: "What is the aggregated social media
+ * sentiment (bullish, bearish, neutral) globally and
+ * for each ticker?"
+ * 
+ * THIS IS THE GEM ITERATION, PRACITCALLY IDENTICAL TO SOCIAL SENTIMENT AGGREGATION ORIGINAL, BUT DUPLICATED FOR CLARITY OF THE GEM PRODUCT LINE
+ */
+class GemSocialSentimentAggregation {
+    constructor() {
+        this.global = {
+            bullish: 0,
+            bearish: 0,
+            neutral: 0
+        };
+        // { [ticker]: { bullish: 0, bearish: 0, neutral: 0 } }
+        this.perTicker = new Map();
+    }
+
+    /**
+     * Defines the output schema for this calculation.
+     * @returns {object} JSON Schema object
+     */
+    static getSchema() {
+        const sentimentSchema = {
+            "type": "object",
+            "properties": {
+                "bullish": { "type": "number" },
+                "bearish": { "type": "number" },
+                "neutral": { "type": "number" },
+                "total_posts": { "type": "number" },
+                "net_sentiment": { "type": "number" },
+                "net_sentiment_pct": { "type": "number" }
+            },
+            "required": ["bullish", "bearish", "neutral", "total_posts", "net_sentiment", "net_sentiment_pct"]
+        };
+
+        return {
+            "type": "object",
+            "description": "Aggregates social sentiment (bullish, bearish) globally and per ticker.",
+            "properties": {
+                "global_sentiment": {
+                    ...sentimentSchema,
+                    "description": "Aggregated sentiment across all posts."
+                },
+                "per_ticker": {
+                    "type": "object",
+                    "description": "Aggregated sentiment broken down by asset ticker.",
+                    "patternProperties": {
+                        "^.*$": {
+                            ...sentimentSchema,
+                            "description": "Aggregated sentiment for a specific ticker."
+                        } // Ticker
+                    },
+                    "additionalProperties": sentimentSchema
+                }
+            },
+            "required": ["global_sentiment", "per_ticker"]
+        };
+    }
+
+    _initTicker(ticker) {
+        if (!this.perTicker.has(ticker)) {
+            this.perTicker.set(ticker, {
+                bullish: 0,
+                bearish: 0,
+                neutral: 0
+            });
+        }
+    }
+
+    /**
+     * @param {string} dateStr - Today's date.
+     * @param {object} dependencies - db, logger.
+     * @param {object} config - Computation config.
+     * @param {object} fetchedDependencies - (UNUSED) In-memory results.
+     */
+    async process(dateStr, dependencies, config, fetchedDependencies) {
+        const { calculationUtils } = dependencies;
+        const todaySocialPosts = await calculationUtils.loadSocialData(dateStr); 
+
+        for (const post of todaySocialPosts) {
+            const sentiment = post.sentiment || 'neutral'; // 'bullish', 'bearish', 'neutral'
+            
+            // 1. Aggregate global sentiment
+            if (sentiment === 'bullish') {
+                this.global.bullish++;
+            } else if (sentiment === 'bearish') {
+                this.global.bearish++;
+            } else {
+                this.global.neutral++;
+            }
+            
+            // 2. Aggregate per-ticker sentiment
+            const tickers = post.tickers || [];
+            for (const ticker of tickers) {
+                this._initTicker(ticker);
+                const data = this.perTicker.get(ticker);
+                
+                if (sentiment === 'bullish') {
+                    data.bullish++;
+                } else if (sentiment === 'bearish') {
+                    data.bearish++;
+                } else {
+                    data.neutral++;
+                }
+            }
+        }
+    }
+    
+    _calculateSentiment(data) {
+        const total = data.bullish + data.bearish + data.neutral;
+        const net = data.bullish - data.bearish;
+        return {
+            ...data,
+            total_posts: total,
+            net_sentiment: net,
+            // Net sentiment as a percentage of *all* posts (bullish, bearish, neutral)
+            net_sentiment_pct: (total > 0) ? (net / total) * 100 : 0
+        };
+    }
+
+    async getResult() {
+        // Calculate stats for global
+        const global_sentiment = this._calculateSentiment(this.global);
+        
+        // Calculate stats for per-ticker
+        const per_ticker = {};
+        for (const [ticker, data] of this.perTicker.entries()) {
+            per_ticker[ticker] = this._calculateSentiment(data);
+        }
+        
+        return {
+            global_sentiment,
+            per_ticker
+        };
+    }
+
+    reset() {
+        this.global = { bullish: 0, bearish: 0, neutral: 0 };
+        this.perTicker.clear();
+    }
+}
+
+module.exports = GemSocialSentimentAggregation;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aiden-shared-calculations-unified",
-  "version": "1.0.75",
+  "version": "1.0.76",
   "description": "Shared calculation modules for the BullTrackers Computation System.",
   "main": "index.js",
   "files": [