bulltrackers-module 1.0.270 → 1.0.271

package/functions/computation-system/tools/BuildReporter.js

@@ -2,7 +2,7 @@
  * @fileoverview Build Reporter & Auto-Runner.
  * Generates a "Pre-Flight" report of what the computation system WILL do.
  * REFACTORED: Strict 5-category reporting with date-based exclusion logic.
- * UPDATED: Added meta stats to compare Included vs Expected computation counts per date.
+ * UPDATED: Added transactional locking to prevent duplicate reports on concurrent cold starts.
  */
 
 const { analyzeDateExecution }                                             = require('../WorkflowOrchestrator');
@@ -45,24 +45,47 @@ function isDateBeforeAvailability(dateStr, calcManifest) {
 
 /**
  * AUTO-RUN ENTRY POINT
+ * UPDATED: Uses transactional locking to prevent race conditions.
  */
 async function ensureBuildReport(config, dependencies, manifest) {
     const { db, logger } = dependencies;
     const now = new Date();
     const buildId = `v${packageVersion}_${now.getFullYear()}-${String(now.getMonth()+1).padStart(2,'0')}-${String(now.getDate()).padStart(2,'0')}_${String(now.getHours()).padStart(2,'0')}-${String(now.getMinutes()).padStart(2,'0')}-${String(now.getSeconds()).padStart(2,'0')}`;
-    const latestRef = db.collection('computation_build_records').doc('latest');
+    
+    // Lock document specific to this version
+    const lockRef = db.collection('computation_build_records').doc(`init_lock_v${packageVersion}`);
 
     try {
-        const latestDoc = await latestRef.get();
-        const priorVersion = latestDoc.exists ? latestDoc.data().packageVersion : null;
+        // Transaction: "Hey I am deploying" check
+        const shouldRun = await db.runTransaction(async (t) => {
+            const doc = await t.get(lockRef);
+            
+            if (doc.exists) {
+                // Someone else beat us to it
+                return false; 
+            }
+
+            // Claim the lock
+            t.set(lockRef, { 
+                status: 'IN_PROGRESS', 
+                startedAt: new Date(),
+                workerId: process.env.K_REVISION || 'unknown',
+                buildId: buildId
+            });
+            return true;
+        });
 
-        if (priorVersion === packageVersion) {
-            logger.log('INFO', `[BuildReporter] ✅ Version ${packageVersion} already has a report. Skipping.`);
+        if (!shouldRun) {
+            logger.log('INFO', `[BuildReporter] 🔒 Report for v${packageVersion} is already being generated (Locked). Skipping.`);
             return;
         }
 
-        logger.log('INFO', `[BuildReporter] 🚀 New Version Detected (${packageVersion}). Auto-running Pre-flight Report...`);
+        logger.log('INFO', `[BuildReporter] 🚀 Lock Acquired. Running Pre-flight Report for v${packageVersion}...`);
+        
         await generateBuildReport(config, dependencies, manifest, 90, buildId);
+        
+        // Optional: Update lock to completed (fire-and-forget update)
+        lockRef.update({ status: 'COMPLETED', completedAt: new Date() }).catch(() => {});
 
     } catch (e) {
         logger.log('ERROR', `[BuildReporter] Auto-run check failed: ${e.message}`);

package/package.json

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