bulltrackers-module 1.0.777 → 1.0.779

package/functions/computation-system-v2/computations/BehavioralAnomaly.js

@@ -62,7 +62,7 @@ const AdvancedMath = {
         // Calculate aggregate volatility across the CORE features (indices 0-5)
         const coreIndices = [0, 1, 2, 3, 4, 5];
         const volatilities = [];
-        
+
         for (const f of coreIndices) {
             const values = recentVectors.map(v => v[f]);
             const mean = values.reduce((sum, v) => sum + v, 0) / values.length;
@@ -70,7 +70,7 @@ const AdvancedMath = {
             volatilities.push(Math.sqrt(variance));
         }
         const avgVolatility = volatilities.reduce((sum, v) => sum + v, 0) / volatilities.length;
-        
+
         if (avgVolatility < 0.3) return 'calm';
         if (avgVolatility < 0.8) return 'active';
         return 'stressed';
@@ -93,7 +93,7 @@ const FeatureExtractor = {
             if (!ticker) return 'Unknown';
             return sectorMap.get(ticker) || 'Unknown';
         };
-        
+
         // 1. Sector Concentration (HHI)
         const sectorExposure = {};
         let totalInvestedPct = 0;
@@ -104,7 +104,7 @@ const FeatureExtractor = {
             totalInvestedPct += val;
         });
         const sectorHHI = AdvancedMath.hhi(Object.values(sectorExposure));
-        
+
         // 2. Martingale/Distress Score
         let martingaleScore = 0;
         let martingaleCount = 0;
@@ -116,56 +116,56 @@ const FeatureExtractor = {
                 martingaleCount++;
             }
         });
-        
+
         // 3. Leverage Profile (Lazy Loaded)
         const { avgLeverage, highLevCount } = FeatureExtractor._extractLeverageProfile(day.date, historyBlob);
-        
+
         // 4. Risk Score
         const riskScore = rankingsData.RiskScore || 1;
-        
+
         // 5. Complexity
         const complexity = positions.length;
-        
+
         // 6. Exposure
         const exposure = totalInvestedPct;
-        
+
         // --- EXTENDED FEATURES (Full Spectrum) ---
-        
+
         // 7. Entropy
         const positionSizes = positions.map(p => p.Invested || 0);
         const portfolioEntropy = AdvancedMath.entropy(positionSizes);
-        
+
         // 8. Drawdown
         const drawdownSeverity = Math.abs(rankingsData.PeakToValley || 0);
-        
+
         // 9. Win Rate Deviation
         const winRateDeviation = Math.abs((rankingsData.WinRatio || 50) - 50);
-        
+
         // 10. Skewness
         const sortedSizes = [...positionSizes].sort((a, b) => b - a);
         const top3Share = sortedSizes.slice(0, 3).reduce((sum, v) => sum + v, 0);
         const positionSkewness = totalInvestedPct > 0 ? top3Share / totalInvestedPct : 0;
-        
+
         // 11. Stress Ratio
         const losingCount = positions.filter(p => (p.NetProfit || 0) < 0).length;
         const stressRatio = positions.length > 0 ? losingCount / positions.length : 0;
-        
+
         // 12. Credit Imbalance
         const realizedCredit = portfolio?.CreditByRealizedEquity || 0;
         const unrealizedCredit = portfolio?.CreditByUnrealizedEquity || 0;
         const creditImbalance = Math.abs(realizedCredit - unrealizedCredit);
-        
+
         // 13. High Lev Freq
         const highLevFrequency = highLevCount / Math.max(1, positions.length);
-        
+
         // 14. Copier Momentum
         const copiers = rankingsData.Copiers || 0;
         const baselineCopiers = rankingsData.BaseLineCopiers || copiers;
         const copierMomentum = baselineCopiers > 0 ? (copiers - baselineCopiers) / baselineCopiers : 0;
-        
+
         // 15. AUM Tier
         const aumTier = (rankingsData.AUMTier || 0);
-        
+
         // 16. Exposure Velocity
         let exposureVelocity = 0;
         if (prevDay && prevDay.portfolio) {
@@ -173,7 +173,7 @@ const FeatureExtractor = {
             const prevExposure = prevPositions.reduce((sum, p) => sum + (p.Invested || 0), 0);
             exposureVelocity = exposure - prevExposure;
         }
-        
+
         // 17. Risk Acceleration
         let riskAcceleration = 0;
         if (prevDay && prevDay.rankings && prevPrevDay && prevPrevDay.rankings) {
@@ -182,33 +182,33 @@ const FeatureExtractor = {
             const r2 = riskScore;
             riskAcceleration = AdvancedMath.acceleration(r2, r1, r0, 1);
         }
-        
+
         // 18. Behavioral Momentum
         const behavioralMomentum = Math.abs(exposureVelocity) + Math.abs(riskAcceleration);
-        
+
         return {
             vector: [
                 // CORE (0-5)
-                sectorHHI,              
-                Math.log(martingaleScore + 1),  
-                avgLeverage,                
-                riskScore,                 
-                complexity,                
-                exposure,  
-                
+                sectorHHI,
+                Math.log(martingaleScore + 1),
+                avgLeverage,
+                riskScore,
+                complexity,
+                exposure,
+
                 // EXTENDED (6-17)
-                portfolioEntropy,           
-                drawdownSeverity,         
-                winRateDeviation,          
-                positionSkewness,               
-                stressRatio,                    
-                creditImbalance,          
-                highLevFrequency,               
-                copierMomentum,                 
-                aumTier,                        
-                exposureVelocity,          
-                riskAcceleration,           
-                behavioralMomentum         
+                portfolioEntropy,
+                drawdownSeverity,
+                winRateDeviation,
+                positionSkewness,
+                stressRatio,
+                creditImbalance,
+                highLevFrequency,
+                copierMomentum,
+                aumTier,
+                exposureVelocity,
+                riskAcceleration,
+                behavioralMomentum
             ],
             metadata: {
                 martingaleCount,
@@ -270,7 +270,7 @@ const AnomalyEngine = {
         // 5. VELOCITY
         const velocityScore = (Math.abs(zVector[15]) + Math.abs(zVector[16]) + Math.abs(zVector[17])) / 3;
 
-        const ensembleScore = 
+        const ensembleScore =
             0.40 * mahalanobisScore +
             0.30 * percentileScore +
             0.15 * regimeScore +
@@ -285,7 +285,7 @@ const AnomalyEngine = {
                 velocity: velocityScore
             },
             // EXPORT Z-SCORES FOR INTERPRETER
-            zScores: zVector 
+            zScores: zVector
         };
     },
 
@@ -302,7 +302,7 @@ const AnomalyEngine = {
         for (const v of vectors) for (let i = 0; i < dim; i++) stdDevs[i] += Math.pow(v[i] - means[i], 2);
         for (let i = 0; i < dim; i++) {
             stdDevs[i] = Math.sqrt(stdDevs[i] / n);
-            if (stdDevs[i] === 0) stdDevs[i] = 1; 
+            if (stdDevs[i] === 0) stdDevs[i] = 1;
         }
 
         const zVector = todayVec.map((v, i) => (v - means[i]) / stdDevs[i]);
@@ -315,9 +315,9 @@ const AnomalyEngine = {
         const means = new Array(todayZVec.length).fill(0);
         const cov = AnomalyEngine._covariance(histZVectors, means);
         const invCov = AnomalyEngine._invert(cov);
-        
+
         if (!invCov) return 0;
-        
+
         let sum = 0;
         for (let i = 0; i < todayZVec.length; i++) {
             for (let j = 0; j < todayZVec.length; j++) {
@@ -385,14 +385,14 @@ const AnomalyEngine = {
 // =============================================================================
 const PredictiveEngine = {
     forecastRisk: (todayFeatures, historicalFeatures, anomalyScore) => {
-        const momentum = todayFeatures.vector[17]; 
+        const momentum = todayFeatures.vector[17];
         const riskAccel = todayFeatures.vector[16];
-        
-        let baseProbability = 1 / (1 + Math.exp(-(anomalyScore - 3))); 
-        
+
+        let baseProbability = 1 / (1 + Math.exp(-(anomalyScore - 3)));
+
         if (momentum > 1.0) baseProbability = Math.min(0.99, baseProbability * 1.2);
         if (riskAccel > 1.0) baseProbability = Math.min(0.99, baseProbability * 1.15);
-        
+
         return {
             probability7d: baseProbability,
             confidence: historicalFeatures.length >= 25 ? 'high' : 'medium',
@@ -405,10 +405,10 @@ const SemanticInterpreter = {
     interpret: (scores, features, prediction, regime, featureNames) => {
         // ROBUST LOGIC: Use the Z-Scores passed from AnomalyEngine.
         const zScores = scores.zScores || [];
-        
+
         let maxIdx = 0;
         let maxZ = 0;
-        
+
         // Find feature with highest ABSOLUTE Z-score (Statistically most significant)
         zScores.forEach((z, i) => {
             if (Math.abs(z) > maxZ) {
@@ -416,26 +416,26 @@ const SemanticInterpreter = {
                 maxIdx = i;
             }
         });
-        
+
         const primaryDriver = featureNames[maxIdx];
         const driverZ = zScores[maxIdx];
         const rawValue = features.vector[maxIdx];
-        
+
         let description = '';
         let severity = 'low';
-        
+
         if (scores.overall > 5.0) { severity = 'critical'; description = `🚨 CRITICAL: Severe anomaly in ${regime} regime. `; }
         else if (scores.overall > 4.0) { severity = 'high'; description = `⚠️ HIGH RISK: Significant deviation. `; }
         else if (scores.overall > 3.0) { severity = 'medium'; description = `⚡ MODERATE: Unusual pattern. `; }
         else { description = `ℹ️ NOTICE: Minor shift. `; }
-        
+
         const direction = driverZ > 0 ? "increased" : "decreased";
-        
+
         description += `Driven by ${primaryDriver}. `;
         description += `Value ${direction} to ${rawValue.toFixed(2)} (${driverZ > 0 ? '+' : ''}${maxZ.toFixed(1)}σ). `;
-        
-        if (prediction.probability7d > 0.7) description += `High escalation risk (${(prediction.probability7d*100).toFixed(0)}%).`;
-        
+
+        if (prediction.probability7d > 0.7) description += `High escalation risk (${(prediction.probability7d * 100).toFixed(0)}%).`;
+
         return {
             description,
             severity,
@@ -458,17 +458,17 @@ class BehavioralAnomaly extends Computation {
             type: 'per-entity',
             category: 'alerts',
             isHistorical: true,
-            
+
             requires: {
                 // COST CONTROL: 30-day limit
                 'portfolio_snapshots': {
-                    lookback: 30, 
+                    lookback: 30,
                     mandatory: true,
                     fields: ['user_id', 'portfolio_data', 'date']
                 },
                 'pi_rankings': {
                     lookback: 30,
-                    mandatory: true, 
+                    mandatory: true,
                     fields: ['pi_id', 'rankings_data', 'date']
                 },
                 'trade_history_snapshots': {
@@ -483,19 +483,42 @@ class BehavioralAnomaly extends Computation {
 
             storage: {
                 bigquery: true,
-                firestore: { 
-                    enabled: true, 
-                    path: 'alerts/{date}/BehavioralAnomaly/{entityId}', 
-                    merge: true 
+                firestore: {
+                    enabled: true,
+                    path: 'alerts/{date}/BehavioralAnomaly/{entityId}',
+                    merge: true
                 }
             },
-            
+
             userType: 'POPULAR_INVESTOR',
             alert: {
                 id: 'behavioral_anomaly_v4',
                 frontendName: 'Behavioral Risk Intelligence',
-                severity: 'high', 
-                isDynamic: true
+                description: 'Alert when a Popular Investor shows elevated behavioral risk',
+                messageTemplate: '{piUsername} shows behavioral risk: {primaryDriver} (score: {anomalyScore})',
+                severity: 'high',
+                configKey: 'behavioralAnomaly',
+                isDynamic: true,
+                dynamicConfig: {
+                    thresholds: [
+                        {
+                            key: 'minScore',
+                            type: 'number',
+                            label: 'Minimum anomaly score',
+                            description: 'Only alert if anomaly score is above this level',
+                            default: 3.5,
+                            min: 0,
+                            max: 10,
+                            step: 0.5,
+                            unit: 'score'
+                        }
+                    ],
+                    resultFields: {
+                        primaryDriver: 'driver',
+                        anomalyScore: 'score',
+                        driverSignificance: 'driverValue'
+                    }
+                }
             }
         };
     }
@@ -547,15 +570,15 @@ class BehavioralAnomaly extends Computation {
         // 3. Historical Extraction (30 days)
         const historicalFeatures = [];
         const lookbackDate = new Date(date);
-        lookbackDate.setDate(lookbackDate.getDate() - 30); 
+        lookbackDate.setDate(lookbackDate.getDate() - 30);
 
         let prevDay = null;
         let prevPrevDay = null;
-        
+
         for (let d = new Date(lookbackDate); d < new Date(date); d.setDate(d.getDate() + 1)) {
             const dStr = d.toISOString().slice(0, 10);
             const dayData = dailyData.get(dStr);
-            
+
             if (dayData && dayData.portfolio) {
                 const features = FeatureExtractor.extract(dayData, prevDay, prevPrevDay, currentHistoryBlob, dayData.rankings, rules, maps);
                 historicalFeatures.push(features);
@@ -565,8 +588,8 @@ class BehavioralAnomaly extends Computation {
         }
 
         if (historicalFeatures.length < 15) {
-             this.setResult(entityId, { triggered: false, status: 'INSUFFICIENT_HISTORY' });
-             return;
+            this.setResult(entityId, { triggered: false, status: 'INSUFFICIENT_HISTORY' });
+            return;
         }
 
         // 4. Today's Features
@@ -576,19 +599,19 @@ class BehavioralAnomaly extends Computation {
         // 5. Detection & Scoring
         const recentVectors = historicalFeatures.slice(-5).map(f => f.vector);
         const regime = AdvancedMath.detectRegime(recentVectors);
-        historicalFeatures.forEach(f => f.metadata.regime = regime); 
-        
+        historicalFeatures.forEach(f => f.metadata.regime = regime);
+
         const scores = AnomalyEngine.score(todayFeatures, historicalFeatures, regime);
         const prediction = PredictiveEngine.forecastRisk(todayFeatures, historicalFeatures, scores.overall);
 
         const featureNames = [
-            'Sector HHI', 'Martingale', 'Avg Leverage', 'Risk Score', 'Complexity', 'Exposure', 
-            'Entropy', 'Drawdown', 'Win Rate Dev', 'Skewness', 'Stress Ratio', 'Credit Imbal', 
+            'Sector HHI', 'Martingale', 'Avg Leverage', 'Risk Score', 'Complexity', 'Exposure',
+            'Entropy', 'Drawdown', 'Win Rate Dev', 'Skewness', 'Stress Ratio', 'Credit Imbal',
             'High Lev Freq', 'Copier Mom', 'AUM Tier', 'Exp Velocity', 'Risk Accel', 'Behav Mom'
         ];
 
         const interpretation = SemanticInterpreter.interpret(scores, todayFeatures, prediction, regime, featureNames);
-        
+
         const THRESHOLD = 3.5;
         const triggered = scores.overall > THRESHOLD || prediction.probability7d > 0.75;
 

package/functions/computation-system-v2/computations/NewSectorExposure.js

@@ -7,7 +7,7 @@
 const { Computation } = require('../framework');
 
 class NewSectorExposure extends Computation {
-    
+
     constructor() {
         super();
     }
@@ -18,7 +18,7 @@ class NewSectorExposure extends Computation {
             type: 'per-entity',
             category: 'alerts',
             isHistorical: true,
-            
+
             requires: {
                 'portfolio_snapshots': {
                     lookback: 14, // INCREASED: Look back 2 weeks to find last known state
@@ -116,7 +116,7 @@ class NewSectorExposure extends Computation {
         });
 
         const todayRow = history.find(d => toDateStr(d.date) === date);
-        
+
         // Find the first row where date is strictly less than target date
         // Since we sorted descending, this is the "Last Known" date
         const previousRow = history.find(d => toDateStr(d.date) < date);
@@ -131,11 +131,11 @@ class NewSectorExposure extends Computation {
         const getSectorMap = (pData) => {
             const map = new Map();
             const positions = rules.portfolio.extractPositions(pData);
-            
+
             positions.forEach(pos => {
                 const instrumentId = rules.portfolio.getInstrumentId(pos);
-                const invested = rules.portfolio.getInvested(pos); 
-                
+                const invested = rules.portfolio.getInvested(pos);
+
                 if (instrumentId && invested > 0) {
                     const sectorName = resolveSector(instrumentId);
                     if (sectorName) {
@@ -167,7 +167,7 @@ class NewSectorExposure extends Computation {
             currentSectors: Array.from(todaySectors.keys()),
             previousSectors: isBaselineReset ? [] : Array.from(previousSectors.keys()),
             newExposures,
-            sectorName: newExposures.join(', '), 
+            sectorName: newExposures.join(', '),
             isBaselineReset,
             triggered: newExposures.length > 0,
             _metadata: {

package/functions/computation-system-v2/computations/NewSocialPost.js

@@ -13,7 +13,7 @@ class NewSocialPost extends Computation {
             type: 'per-entity',
             category: 'alerts',
             isHistorical: true,
-            
+
             requires: {
                 'social_post_snapshots': {
                     lookback: 5, // Short lookback just to ensure we catch the specific row
@@ -49,7 +49,7 @@ class NewSocialPost extends Computation {
 
         // 1. Get History
         const history = data['social_post_snapshots'] || [];
-        
+
         // Helper: Handle BigQuery Date Objects
         const toDateStr = (d) => {
             if (!d) return null;
@@ -63,10 +63,10 @@ class NewSocialPost extends Computation {
 
         if (!todayRow) {
             // No snapshot exists for this date yet, so we can't determine if they posted.
-            this.setResult(entityId, { 
-                hasNewPost: false, 
+            this.setResult(entityId, {
+                hasNewPost: false,
                 triggered: false,
-                reason: "No snapshot found for date" 
+                reason: "No snapshot found for date"
             });
             return;
         }
@@ -88,7 +88,7 @@ class NewSocialPost extends Computation {
 
             if (postDateStr === date) {
                 hasNewPost = true;
-                
+
                 // Track the latest one for the alert title
                 if (!latestPost || postDateObj > rules.social.getPostDate(latestPost)) {
                     latestPost = post;

package/functions/computation-system-v2/computations/PositionInvestedIncrease.js

@@ -1,7 +1,7 @@
 const { Computation } = require('../framework');
 
 class PositionInvestedIncrease extends Computation {
-    
+
     constructor() {
         super();
         this.THRESHOLD_PP = 5.0; // Percentage Points
@@ -13,7 +13,7 @@ class PositionInvestedIncrease extends Computation {
             type: 'per-entity',
             category: 'alerts',
             isHistorical: true,
-            
+
             requires: {
                 'portfolio_snapshots': {
                     lookback: 1, // Today + Yesterday
@@ -53,9 +53,9 @@ class PositionInvestedIncrease extends Computation {
                         }
                     ],
                     resultFields: {
-                        matchValue: 'diff', 
-                        currentValue: 'moveCount', 
-                        metadata: ['symbol', 'prev', 'curr'] 
+                        matchValue: 'diff',
+                        currentValue: 'moveCount',
+                        metadata: ['symbol', 'prev', 'curr']
                     }
                 }
             }
@@ -72,7 +72,7 @@ class PositionInvestedIncrease extends Computation {
         // 2. Get Data
         const history = data['portfolio_snapshots'] || [];
         const todayRow = history.find(d => d.date === date);
-        
+
         const yDate = new Date(date);
         yDate.setDate(yDate.getDate() - 1);
         const yDateStr = yDate.toISOString().split('T')[0];
@@ -82,8 +82,8 @@ class PositionInvestedIncrease extends Computation {
 
         // 3. Extract Positions
         const currentPositions = rules.portfolio.extractPositions(rules.portfolio.extractPortfolioData(todayRow));
-        const previousPositions = yesterdayRow 
-            ? rules.portfolio.extractPositions(rules.portfolio.extractPortfolioData(yesterdayRow)) 
+        const previousPositions = yesterdayRow
+            ? rules.portfolio.extractPositions(rules.portfolio.extractPortfolioData(yesterdayRow))
             : [];
 
         // Map previous for O(1) lookup
@@ -97,12 +97,12 @@ class PositionInvestedIncrease extends Computation {
 
         for (const currPos of currentPositions) {
             const id = String(rules.portfolio.getInstrumentId(currPos));
-            
+
             // Resolve Ticker using Rules (Instruments) or fallback
             let ticker = rules.instruments.getTickerById(tickerMap, id) || currPos.Symbol || `ID:${id}`;
 
             const currInvested = Number(rules.portfolio.getInvested(currPos)) || 0;
-            
+
             // Get previous
             const prevPos = prevMap.get(id);
             const prevInvested = prevPos ? (Number(rules.portfolio.getInvested(prevPos)) || 0) : 0;
@@ -132,7 +132,7 @@ class PositionInvestedIncrease extends Computation {
             moves: significantMoves,
             isBaselineReset: (!yesterdayRow),
             triggered: significantMoves.length > 0,
-            
+
             // Hoisted fields
             symbol: topMove.symbol || null,
             diff: topMove.diff || null,

package/functions/computation-system-v2/computations/SignedInUserPIProfileMetrics.js

@@ -32,7 +32,7 @@ class SignedInUserPIProfileMetrics extends Computation {
                 bigquery: true,
                 firestore: {
                     enabled: true,
-                    path: 'users/{entityId}/pi_profile_metrics/{date}',
+                    path: 'users/{entityId}/signed_in_user_pi_profile_metrics/{date}',
                     merge: true
                 }
             }

package/functions/computation-system-v2/config/bulltrackers.config.js

@@ -162,6 +162,14 @@ module.exports = {
             description: 'Daily alert trigger history'
         },
 
+        // User Alert Settings (watchlist and alert config snapshot per day)
+        'user_alert_settings': {
+            dateField: 'date',
+            entityField: 'user_id',
+            clusterFields: ['user_id', 'watchlist_id'],
+            description: 'Daily user watchlist and alert configuration'
+        },
+
         // Instrument Insights
         'instrument_insights': {
             dateField: 'date',

package/functions/computation-system-v2/framework/core/Manifest.js

@@ -126,6 +126,7 @@ class ManifestBuilder {
             
             outputTable: config.outputTable || null,
             // --------------------------------------
+            alert: config.alert || null,
 
             requires: config.requires || {},
             dependencies: (config.dependencies || []).map(d => this._normalize(d)),