aiden-shared-calculations-unified 1.0.76 → 1.0.78

package/calculations/{socialPosts → core}/social-word-mentions-trend.js

@@ -14,6 +14,28 @@ class SocialWordMentionsTrend {
         this.keywords = []; 
     }
 
+    // --- NEW ---
+    /**
+     * Statically defines all metadata for the manifest builder.
+     */
+    static getMetadata() {
+        return {
+            type: 'meta',
+            rootDataDependencies: ['social'],
+            isHistorical: false, // Stateful
+            userType: 'n/a',
+            category: 'core_social'
+        };
+    }
+
+    // --- NEW ---
+    /**
+     * Statically declare dependencies.
+     */
+    static getDependencies() {
+        return [];
+    }
+
     /**
      * Defines the output schema for this calculation.
      * @returns {object} JSON Schema object
@@ -50,14 +72,15 @@ class SocialWordMentionsTrend {
         };
     }
 
+    // --- REFACTORED ---
     /**
      * @param {string} dateStr - Today's date.
-     * @param {object} dependencies - db, logger.
+     * @param {object} rootData - The root data object.
+     * @param {object} dependencies - db, logger, calculationUtils
      * @param {object} config - Computation config.
-     * @param {object} fetchedDependencies - (UNUSED) In-memory results.
      */
-    async process(dateStr, dependencies, config, fetchedDependencies) {
-        const { db, logger, calculationUtils } = dependencies;
+    async process(dateStr, rootData, dependencies, config) {
+        const { calculationUtils } = dependencies;
         
         // 1. Load keywords from config (or another source)
         this.keywords = config.trackedKeywords || ['inflation', 'fed', 'AI', 'crypto', 'recession'];
@@ -67,21 +90,23 @@ class SocialWordMentionsTrend {
 
         // 3. Initialize state for all keywords
         for (const keyword of this.keywords) {
-            this.keywordData.set(keyword, {
+            const normalizedKey = keyword.toLowerCase();
+            this.keywordData.set(normalizedKey, {
                 count: 0,
-                history: yHistoryData?.[keyword]?.history_30d || []
+                history: yHistoryData?.[normalizedKey]?.history_30d || []
             });
         }
         
         // 4. Process today's raw social data
-        const todaySocialPosts = await calculationUtils.loadSocialData(dateStr); 
+        const todaySocialPosts = rootData.todaySocialPostInsights || {}; 
 
-        for (const post of todaySocialPosts) {
-            const text = (post.content || '').toLowerCase();
+        for (const post of Object.values(todaySocialPosts)) {
+            const text = (post.fullText || '').toLowerCase();
             
             for (const keyword of this.keywords) {
-                if (text.includes(keyword.toLowerCase())) {
-                    this.keywordData.get(keyword).count++;
+                const normalizedKey = keyword.toLowerCase();
+                if (text.includes(normalizedKey)) {
+                    this.keywordData.get(normalizedKey).count++;
                 }
             }
         }

package/calculations/{speculators/speculator_asset_sentiment.js → core/speculator-asset-sentiment.js}

@@ -50,6 +50,26 @@ class SpeculatorAssetSentiment {
         };
     }
 
+    /**
+     * Statically defines all metadata for the manifest builder.
+     */
+    static getMetadata() {
+        return {
+            type: 'standard',
+            rootDataDependencies: ['portfolio'],
+            isHistorical: false,
+            userType: 'speculator',
+            category: 'core_speculator'
+        };
+    }
+
+    /**
+     * Statically declare dependencies.
+     */
+    static getDependencies() {
+        return [];
+    }
+
     _initAsset(instrumentId) {
         if (!this.assets.has(instrumentId)) {
             const createSide = () => ({

package/calculations/{speculators/speculator_danger_zone.js → core/speculator-danger-zone.js}

@@ -47,6 +47,26 @@ class SpeculatorDangerZone {
         };
     }
 
+    /**
+     * Statically defines all metadata for the manifest builder.
+     */
+    static getMetadata() {
+        return {
+            type: 'standard',
+            rootDataDependencies: ['portfolio'],
+            isHistorical: false,
+            userType: 'speculator', // This calc only runs for speculators
+            category: 'core_speculator'
+        };
+    }
+
+    /**
+     * Statically declare dependencies.
+     */
+    static getDependencies() {
+        return [];
+    }
+
     _initAsset(instrumentId) {
         if (!this.assets.has(instrumentId)) {
             this.assets.set(instrumentId, {
@@ -59,6 +79,8 @@ class SpeculatorDangerZone {
     }
 
     process(portfolioData) {
+        // This check is now technically redundant due to `userType` in metadata,
+        // but it's good practice to keep it for safety.
         if (portfolioData?.context?.userType !== 'speculator') {
             return;
         }

package/calculations/{speculators/distance_to_stop_loss_per_leverage.js → core/speculator-distance-to-stop-loss-per-leverage.js}

@@ -14,6 +14,28 @@ class DistanceToStopLossPerLeverage {
         this.mappings = null;
     }
 
+    // --- NEW ---
+    /**
+     * Statically defines all metadata for the manifest builder.
+     */
+    static getMetadata() {
+        return {
+            type: 'standard',
+            rootDataDependencies: ['portfolio'],
+            isHistorical: false,
+            userType: 'speculator',
+            category: 'core_speculator'
+        };
+    }
+
+    // --- NEW ---
+    /**
+     * Statically declare dependencies.
+     */
+    static getDependencies() {
+        return [];
+    }
+
     /**
      * Defines the output schema for this calculation.
      * @returns {object} JSON Schema object
@@ -50,6 +72,8 @@ class DistanceToStopLossPerLeverage {
         return key;
     }
 
+    // --- REFACTORED ---
+    // Simplified signature
     process(portfolioData) {
         // This calculation is only for speculators
         if (portfolioData?.context?.userType !== 'speculator') {

package/calculations/{speculators/distance_to_tp_per_leverage.js → core/speculator-distance-to-tp-per-leverage.js}

@@ -14,6 +14,28 @@ class DistanceToTakeProfitPerLeverage {
         this.mappings = null;
     }
 
+    // --- NEW ---
+    /**
+     * Statically defines all metadata for the manifest builder.
+     */
+    static getMetadata() {
+        return {
+            type: 'standard',
+            rootDataDependencies: ['portfolio'],
+            isHistorical: false,
+            userType: 'speculator',
+            category: 'core_speculator'
+        };
+    }
+
+    // --- NEW ---
+    /**
+     * Statically declare dependencies.
+     */
+    static getDependencies() {
+        return [];
+    }
+
     /**
      * Defines the output schema for this calculation.
      * @returns {object} JSON Schema object
@@ -50,6 +72,8 @@ class DistanceToTakeProfitPerLeverage {
         return key;
     }
 
+    // --- REFACTORED ---
+    // Simplified signature
     process(portfolioData) {
         // This calculation is only for speculators
         if (portfolioData?.context?.userType !== 'speculator') {

package/calculations/{speculators/entry_distance_to_sl_per_leverage.js → core/speculator-entry-distance-to-sl-per-leverage.js}

@@ -14,6 +14,28 @@ class EntryDistanceToSlPerLeverage {
         this.mappings = null;
     }
 
+    // --- NEW ---
+    /**
+     * Statically defines all metadata for the manifest builder.
+     */
+    static getMetadata() {
+        return {
+            type: 'standard',
+            rootDataDependencies: ['portfolio'], // Needs portfolio.PublicPositions
+            isHistorical: false, // Only needs today's data
+            userType: 'speculator', // Only runs for speculators
+            category: 'core_speculator'
+        };
+    }
+
+    // --- NEW ---
+    /**
+     * Statically declare dependencies.
+     */
+    static getDependencies() {
+        return []; // Pass 1
+    }
+
     /**
      * Defines the output schema for this calculation.
      * @returns {object} JSON Schema object
@@ -50,6 +72,8 @@ class EntryDistanceToSlPerLeverage {
         return key;
     }
 
+    // --- REFACTORED ---
+    // Simplified signature, as this calc only needs today's portfolio
     process(portfolioData) {
         if (portfolioData?.context?.userType !== 'speculator') {
             return;

package/calculations/{speculators/entry_distance_to_tp_per_leverage.js → core/speculator-entry-distance-to-tp-per-leverage.js}

@@ -14,6 +14,28 @@ class EntryDistanceToTpPerLeverage {
         this.mappings = null;
     }
 
+    // --- NEW ---
+    /**
+     * Statically defines all metadata for the manifest builder.
+     */
+    static getMetadata() {
+        return {
+            type: 'standard',
+            rootDataDependencies: ['portfolio'], // Needs portfolio.PublicPositions
+            isHistorical: false,
+            userType: 'speculator', // Only runs for speculators
+            category: 'core_speculator'
+        };
+    }
+
+    // --- NEW ---
+    /**
+     * Statically declare dependencies.
+     */
+    static getDependencies() {
+        return []; // Pass 1
+    }
+
     /**
      * Defines the output schema for this calculation.
      * @returns {object} JSON Schema object
@@ -50,6 +72,8 @@ class EntryDistanceToTpPerLeverage {
         return key;
     }
 
+    // --- REFACTORED ---
+    // Simplified signature
     process(portfolioData) {
         if (portfolioData?.context?.userType !== 'speculator') {
             return;

package/calculations/{speculators/leverage_per_asset.js → core/speculator-leverage-per-asset.js}

@@ -41,6 +41,26 @@ class LeveragePerAsset {
         };
     }
 
+    /**
+     * Statically defines all metadata for the manifest builder.
+     */
+    static getMetadata() {
+        return {
+            type: 'standard',
+            rootDataDependencies: ['portfolio'],
+            isHistorical: false,
+            userType: 'speculator',
+            category: 'core_speculator'
+        };
+    }
+
+    /**
+     * Statically declare dependencies.
+     */
+    static getDependencies() {
+        return [];
+    }
+
     _initAsset(instrumentId) {
         if (!this.assets.has(instrumentId)) {
             this.assets.set(instrumentId, {});

package/calculations/{speculators/leverage_per_sector.js → core/speculator-leverage-per-sector.js}

@@ -13,6 +13,28 @@ class LeveragePerSector {
         this.mappings = null;
     }
 
+    // --- NEW ---
+    /**
+     * Statically defines all metadata for the manifest builder.
+     */
+    static getMetadata() {
+        return {
+            type: 'standard',
+            rootDataDependencies: ['portfolio'],
+            isHistorical: false,
+            userType: 'speculator',
+            category: 'core_speculator'
+        };
+    }
+
+    // --- NEW ---
+    /**
+     * Statically declare dependencies.
+     */
+    static getDependencies() {
+        return [];
+    }
+
     /**
      * Defines the output schema for this calculation.
      * @returns {object} JSON Schema object

package/calculations/{speculators/risk_reward_ratio_per_asset.js → core/speculator-risk-reward-ratio-per-asset.js}

@@ -43,6 +43,26 @@ class RiskRewardRatioPerAsset {
         };
     }
 
+    /**
+     * Statically defines all metadata for the manifest builder.
+     */
+    static getMetadata() {
+        return {
+            type: 'standard',
+            rootDataDependencies: ['portfolio'],
+            isHistorical: false,
+            userType: 'speculator',
+            category: 'core_speculator'
+        };
+    }
+
+    /**
+     * Statically declare dependencies.
+     */
+    static getDependencies() {
+        return [];
+    }
+
     _initAsset(instrumentId) {
         if (!this.assets.has(instrumentId)) {
             this.assets.set(instrumentId, { sum_rr: 0, count: 0 });

package/calculations/{speculators/stop_loss_distance_by_sector_short_long_breakdown.js → core/speculator-stop-loss-distance-by-sector-short-long-breakdown.js}

@@ -14,6 +14,28 @@ class StopLossDistanceBySectorShortLongBreakdown {
         this.mappings = null;
     }
 
+    // --- NEW ---
+    /**
+     * Statically defines all metadata for the manifest builder.
+     */
+    static getMetadata() {
+        return {
+            type: 'standard',
+            rootDataDependencies: ['portfolio'],
+            isHistorical: false,
+            userType: 'speculator',
+            category: 'core_speculator'
+        };
+    }
+
+    // --- NEW ---
+    /**
+     * Statically declare dependencies.
+     */
+    static getDependencies() {
+        return [];
+    }
+
     /**
      * Defines the output schema for this calculation.
      * @returns {object} JSON Schema object

package/calculations/{speculators/stop_loss_distance_by_ticker_short_long_breakdown.js → core/speculator-stop-loss-distance-by-ticker-short-long-breakdown.js}

@@ -14,6 +14,28 @@ class StopLossDistanceByTickerShortLongBreakdown {
         this.mappings = null;
     }
 
+    // --- NEW ---
+    /**
+     * Statically defines all metadata for the manifest builder.
+     */
+    static getMetadata() {
+        return {
+            type: 'standard',
+            rootDataDependencies: ['portfolio'],
+            isHistorical: false,
+            userType: 'speculator',
+            category: 'core_speculator'
+        };
+    }
+
+    // --- NEW ---
+    /**
+     * Statically declare dependencies.
+     */
+    static getDependencies() {
+        return [];
+    }
+
     /**
      * Defines the output schema for this calculation.
      * @returns {object} JSON Schema object
@@ -55,6 +77,8 @@ class StopLossDistanceByTickerShortLongBreakdown {
         return arr.reduce((a, b) => a + b, 0) / arr.length;
     }
 
+    // --- REFACTORED ---
+    // Simplified signature
     process(portfolioData) {
         if (portfolioData?.context?.userType !== 'speculator') {
             return;

package/calculations/{speculators/stop_loss_per_asset.js → core/speculator-stop-loss-per-asset.js}

@@ -14,6 +14,28 @@ class StopLossPerAsset {
         this.mappings = null;
     }
 
+    // --- NEW ---
+    /**
+     * Statically defines all metadata for the manifest builder.
+     */
+    static getMetadata() {
+        return {
+            type: 'standard',
+            rootDataDependencies: ['portfolio'],
+            isHistorical: false,
+            userType: 'speculator',
+            category: 'core_speculator'
+        };
+    }
+
+    // --- NEW ---
+    /**
+     * Statically declare dependencies.
+     */
+    static getDependencies() {
+        return [];
+    }
+
     /**
      * Defines the output schema for this calculation.
      * @returns {object} JSON Schema object
@@ -61,6 +83,8 @@ class StopLossPerAsset {
         }
     }
 
+    // --- REFACTORED ---
+    // Simplified signature
     process(portfolioData) {
         if (portfolioData?.context?.userType !== 'speculator') {
             return;

package/calculations/{speculators/take_profit_per_asset.js → core/speculator-take-profit-per-asset.js}

@@ -14,6 +14,28 @@ class TakeProfitPerAsset {
         this.mappings = null;
     }
 
+    // --- NEW ---
+    /**
+     * Statically defines all metadata for the manifest builder.
+     */
+    static getMetadata() {
+        return {
+            type: 'standard',
+            rootDataDependencies: ['portfolio'],
+            isHistorical: false,
+            userType: 'speculator',
+            category: 'core_speculator'
+        };
+    }
+
+    // --- NEW ---
+    /**
+     * Statically declare dependencies.
+     */
+    static getDependencies() {
+        return [];
+    }
+
     /**
      * Defines the output schema for this calculation.
      * @returns {object} JSON Schema object
@@ -61,6 +83,8 @@ class TakeProfitPerAsset {
         }
     }
 
+    // --- REFACTORED ---
+    // Simplified signature
     process(portfolioData) {
         if (portfolioData?.context?.userType !== 'speculator') {
             return;

package/calculations/{speculators/tsl_per_asset.js → core/speculator-tsl-per-asset.js}

@@ -14,6 +14,28 @@ class TslPerAsset {
         this.mappings = null;
     }
 
+    // --- NEW ---
+    /**
+     * Statically defines all metadata for the manifest builder.
+     */
+    static getMetadata() {
+        return {
+            type: 'standard',
+            rootDataDependencies: ['portfolio'],
+            isHistorical: false,
+            userType: 'speculator',
+            category: 'core_speculator'
+        };
+    }
+
+    // --- NEW ---
+    /**
+     * Statically declare dependencies.
+     */
+    static getDependencies() {
+        return [];
+    }
+
     /**
      * Defines the output schema for this calculation.
      * @returns {object} JSON Schema object
@@ -51,6 +73,8 @@ class TslPerAsset {
         }
     }
 
+    // --- REFACTORED ---
+    // Simplified signature
     process(portfolioData) {
         if (portfolioData?.context?.userType !== 'speculator') {
             return;

package/calculations/{short_and_long_stats/total_long_figures.js → core/total-long-figures.js}

@@ -9,6 +9,28 @@ class TotalLongFigures {
         this.longCount = 0;
     }
 
+    // --- NEW ---
+    /**
+     * Statically defines all metadata for the manifest builder.
+     */
+    static getMetadata() {
+        return {
+            type: 'standard',
+            rootDataDependencies: ['portfolio'],
+            isHistorical: false,
+            userType: 'all',
+            category: 'core_sentiment'
+        };
+    }
+
+    // --- NEW ---
+    /**
+     * Statically declare dependencies.
+     */
+    static getDependencies() {
+        return [];
+    }
+
     /**
      * Defines the output schema for this calculation.
      * @returns {object} JSON Schema object
@@ -27,6 +49,8 @@ class TotalLongFigures {
         };
     }
 
+    // --- REFACTORED ---
+    // Simplified signature
     process(portfolioData) {
         const positions = portfolioData.PublicPositions || portfolioData.AggregatedPositions;
         if (!positions || !Array.isArray(positions)) {

package/calculations/{sectors/total_long_per_sector.js → core/total-long-per-sector.js}

@@ -13,6 +13,28 @@ class TotalLongPerSector {
         this.mappings = null;
     }
 
+    // --- NEW ---
+    /**
+     * Statically defines all metadata for the manifest builder.
+     */
+    static getMetadata() {
+        return {
+            type: 'standard',
+            rootDataDependencies: ['portfolio'],
+            isHistorical: false,
+            userType: 'all',
+            category: 'core_sentiment'
+        };
+    }
+
+    // --- NEW ---
+    /**
+     * Statically declare dependencies.
+     */
+    static getDependencies() {
+        return [];
+    }
+
     /**
      * Defines the output schema for this calculation.
      * @returns {object} JSON Schema object

package/calculations/{short_and_long_stats/total_short_figures.js → core/total-short-figures.js}

@@ -9,6 +9,28 @@ class TotalShortFigures {
         this.shortCount = 0;
     }
 
+    // --- NEW ---
+    /**
+     * Statically defines all metadata for the manifest builder.
+     */
+    static getMetadata() {
+        return {
+            type: 'standard',
+            rootDataDependencies: ['portfolio'],
+            isHistorical: false,
+            userType: 'all',
+            category: 'core_sentiment'
+        };
+    }
+
+    // --- NEW ---
+    /**
+     * Statically declare dependencies.
+     */
+    static getDependencies() {
+        return [];
+    }
+
     /**
      * Defines the output schema for this calculation.
      * @returns {object} JSON Schema object
@@ -27,6 +49,8 @@ class TotalShortFigures {
         };
     }
 
+    // --- REFACTORED ---
+    // Simplified signature
     process(portfolioData) {
         const positions = portfolioData.PublicPositions || portfolioData.AggregatedPositions;
         if (!positions || !Array.isArray(positions)) {