bulltrackers-module 1.0.330 → 1.0.332

package/functions/computation-system/executors/StandardExecutor.js

@@ -1,8 +1,9 @@
 /**
  * @fileoverview Executor for "Standard" (per-user) calculations.
  * UPDATED: Tracks IO Operations (Reads/Writes) for Cost Analysis.
+ * UPDATED: Supports System Context Injection (requiresEarliestDataDate).
  */
-const { normalizeName }                                                = require('../utils/utils');
+const { normalizeName, getEarliestDataDates }                          = require('../utils/utils');
 const { streamPortfolioData, streamHistoryData, getPortfolioPartRefs } = require('../utils/data_loader');
 const { CachedDataLoader }                                             = require('../data/CachedDataLoader');
 const { ContextFactory }                                               = require('../context/ContextFactory');
@@ -78,6 +79,13 @@ class StandardExecutor {
         const prevDate    = new Date(dateStr + 'T00:00:00Z'); prevDate.setUTCDate(prevDate.getUTCDate() - 1);
         const prevDateStr = prevDate.toISOString().slice(0, 10);
         
+        // [NEW] Check if any calculation requires System Context Injection (e.g. Earliest Date)
+        let earliestDates = null;
+        if (streamingCalcs.some(c => c.manifest.requiresEarliestDataDate)) {
+            // Fetch once per batch, not per user
+            earliestDates = await getEarliestDataDates(config, deps);
+        }
+
         const tP_iter = streamPortfolioData(config, deps, dateStr, portfolioRefs);
         const needsYesterdayPortfolio = streamingCalcs.some(c => c.manifest.isHistorical);
         const yP_iter = (needsYesterdayPortfolio && rootData.yesterdayPortfolioRefs)  ? streamPortfolioData(config, deps, prevDateStr, rootData.yesterdayPortfolioRefs) : null;
@@ -102,7 +110,8 @@ class StandardExecutor {
                     StandardExecutor.executePerUser(
                         calc, calc.manifest, dateStr, tP_chunk, yP_chunk, tH_chunk, 
                         fetchedDeps, previousFetchedDeps, config, deps, cachedLoader,
-                        executionStats[normalizeName(calc.manifest.name)]
+                        executionStats[normalizeName(calc.manifest.name)],
+                        earliestDates // [NEW] Pass system context data
                     ) 
                 ));
                 
@@ -208,7 +217,7 @@ class StandardExecutor {
         if (newResult.failureReport) failureAcc.push(...newResult.failureReport);
     }
     
-    static async executePerUser(calcInstance, metadata, dateStr, portfolioData, yesterdayPortfolioData, historyData, computedDeps, prevDeps, config, deps, loader, stats) {
+    static async executePerUser(calcInstance, metadata, dateStr, portfolioData, yesterdayPortfolioData, historyData, computedDeps, prevDeps, config, deps, loader, stats, earliestDates) {
         const { logger } = deps;
         const targetUserType = metadata.userType; 
         const mappings = await loader.loadMappings();
@@ -237,6 +246,12 @@ class StandardExecutor {
                 computedDependencies: computedDeps, previousComputedDependencies: prevDeps, 
                 config, deps 
             });
+
+            // [NEW] Inject System Context if requested by Metadata
+            if (metadata.requiresEarliestDataDate && earliestDates) {
+                if (!context.system) context.system = {};
+                context.system.earliestHistoryDate = earliestDates.history;
+            }
             
             try { 
                 await calcInstance.process(context); 

package/functions/computation-system/helpers/computation_dispatcher.js

@@ -357,7 +357,7 @@ async function handleStandardDispatch(config, dependencies, computationManifest,
 
     const taskDetails = selectedTasks.map(t => `${t.name} (${t.reason})`);
     logger.log('INFO', `[Dispatcher] ✅ Dispatching ${selectedTasks.length} tasks for ${selectedDate}.`, {
-        date: selectedDate, pass: passToRun, dispatchedCount: selectedTasks.length, etaSeconds, dispatchId: currentDispatchId
+        date: selectedDate, pass: passToRun, dispatchedCount: selectedTasks.length, etaSeconds, dispatchId: currentDispatchId, details: taskDetails
     });
 
     const mapToTaskPayload = (t) => ({

package/functions/computation-system/persistence/ResultCommitter.js

@@ -1,6 +1,7 @@
 /**
  * @fileoverview Handles saving computation results with observability and Smart Cleanup.
  * UPDATED: Tracks specific Firestore Ops (Writes/Deletes) for cost analysis.
+ * UPDATED: Added Dynamic Circuit Breaker Bypass for Price-Only calculations.
  */
 const { commitBatchInChunks, generateDataHash } = require('../utils/utils');
 const { updateComputationStatus }          = require('./StatusRepository');
@@ -54,12 +55,23 @@ async function commitResults(stateObj, dStr, passName, config, deps, skipStatusW
         try {
             const result = await calc.getResult();
             const configOverrides = validationOverrides[calc.manifest.name] || {};
+            
+            // --- [DYNAMIC OVERRIDE LOGIC START] ---
             const dataDeps = calc.manifest.rootDataDependencies || [];
             const isPriceOnly = (dataDeps.length === 1 && dataDeps[0] === 'price');
             let effectiveOverrides = { ...configOverrides };
-            if (isPriceOnly && !effectiveOverrides.weekend) {
-                effectiveOverrides.weekend = { maxZeroPct: 100, maxFlatlinePct: 100, maxNullPct: 100 };
+
+            // If a calculation relies solely on price, we strictly bypass the circuit breaker.
+            // This handles Holidays (Weekday 0s), Weekends (Scheduler Gaps), and Crypto/Stock mix.
+            if (isPriceOnly) {
+                effectiveOverrides.maxZeroPct = 100;
+                effectiveOverrides.maxFlatlinePct = 100;
+                effectiveOverrides.maxNullPct = 100;
+                effectiveOverrides.maxNanPct = 100;
+                // Remove specific weekend config to ensure these permissive global limits apply 7 days/week
+                delete effectiveOverrides.weekend; 
             }
+            // --- [DYNAMIC OVERRIDE LOGIC END] ---
 
             const contract = contractMap[name];
             if (contract) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bulltrackers-module",
-  "version": "1.0.330",
+  "version": "1.0.332",
   "description": "Helper Functions for Bulltrackers.",
   "main": "index.js",
   "files": [