aiden-shared-calculations-unified 1.0.76 → 1.0.77

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)) {

package/calculations/{sectors/total_short_per_sector.js → core/total-short-per-sector.js}

@@ -13,6 +13,28 @@ class TotalShortPerSector {
         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/{sanity/users_processed.js → core/users-processed.js}

@@ -7,6 +7,28 @@ class UsersProcessed {
         this.userCount = 0;
     }
 
+    // --- NEW ---
+    /**
+     * Statically defines all metadata for the manifest builder.
+     */
+    static getMetadata() {
+        return {
+            type: 'standard',
+            rootDataDependencies: ['portfolio'], // Needs at least one doc to run
+            isHistorical: false,
+            userType: 'all',
+            category: 'core_sanity' // Based on Computation_documentation.md
+        };
+    }
+
+    // --- NEW ---
+    /**
+     * Statically declare dependencies.
+     */
+    static getDependencies() {
+        return [];
+    }
+
     /**
      * Defines the output schema for this calculation.
      * @returns {object} JSON Schema object