bulltrackers-module 1.0.327 → 1.0.328

package/functions/generic-api/admin-api/index.js

@@ -2,7 +2,7 @@
  * @fileoverview Admin API Router
  * Sub-module for system observability, debugging, and visualization.
  * Mounted at /admin within the Generic API.
- * UPDATED: Added advanced cost, performance, and live monitoring endpoints.
+ * UPDATED: Added Stale Task Detection, Root Data Health, and SimHash Inspection.
  */
 
 const express = require('express');
@@ -526,6 +526,108 @@ const createAdminRouter = (config, dependencies, unifiedCalculations) => {
         } catch (e) { res.status(500).json({ error: e.message }); }
     });
 
+    // =========================================================================
+    // NEW DEBUGGING ROUTES (Added 2025-12-19)
+    // =========================================================================
+
+    // --- 11. STALE COMPUTATION DETECTOR ("Zombie Hunter") ---
+    router.get('/debug/stale', async (req, res) => {
+        const thresholdMins = parseInt(String(req.query.threshold)) || 15;
+        const cutoffTime = Date.now() - (thresholdMins * 60 * 1000);
+        
+        try {
+            // Scanning collectionGroup 'tasks' is expensive, so we focus on 'IN_PROGRESS'
+            // and filter in memory if necessary, or rely on composite index if available.
+            const snapshot = await db.collectionGroup('tasks')
+                .where('status', '==', 'IN_PROGRESS')
+                .get();
+
+            const zombies = [];
+            snapshot.forEach(doc => {
+                const data = doc.data();
+                
+                // Determine last activity (Heartbeat > StartedAt > 0)
+                const lastActivity = data.telemetry?.lastHeartbeat 
+                    ? new Date(data.telemetry.lastHeartbeat).getTime() 
+                    : (data.startedAt ? new Date(data.startedAt).getTime() : 0);
+
+                if (lastActivity < cutoffTime) {
+                    zombies.push({
+                        computation: data.computation || doc.id,
+                        workerId: data.workerId || 'unknown',
+                        startedAt: data.startedAt,
+                        lastHeartbeat: data.telemetry?.lastHeartbeat,
+                        stagnantMinutes: Math.floor((Date.now() - lastActivity) / 60000),
+                        path: doc.ref.path // Useful for manual deletion
+                    });
+                }
+            });
+
+            // Sort by most stagnant
+            zombies.sort((a, b) => b.stagnantMinutes - a.stagnantMinutes);
+
+            res.json({
+                count: zombies.length,
+                thresholdMins,
+                zombies
+            });
+        } catch (e) {
+            res.status(500).json({ error: e.message });
+        }
+    });
+
+    // --- 12. ROOT DATA HEALTH CHECK ---
+    // Debugs the "Available but marked missing" issue
+    router.get('/debug/root-data-health', async (req, res) => {
+        const { start, end } = req.query;
+        if (!start || !end) return res.status(400).json({ error: "Start and End dates required." });
+
+        try {
+            const startDate = new Date(String(start));
+            const endDate = new Date(String(end));
+            const dates = [];
+            for (let d = new Date(startDate); d <= endDate; d.setDate(d.getDate() + 1)) {
+                dates.push(d.toISOString().slice(0, 10));
+            }
+
+            const report = {};
+            const limit = pLimit(10);
+
+            await Promise.all(dates.map(date => limit(async () => {
+                const rootDoc = await db.collection('system_root_data_index').doc(date).get();
+                if (!rootDoc.exists) {
+                    report[date] = { exists: false, status: 'MISSING_INDEX' };
+                } else {
+                    const data = rootDoc.data();
+                    report[date] = {
+                        exists: true,
+                        status: 'OK',
+                        flags: data.status, // hasHistory, hasPortfolio, etc.
+                        lastUpdated: data.lastUpdated
+                    };
+                }
+            })));
+
+            res.json(report);
+        } catch (e) {
+            res.status(500).json({ error: e.message });
+        }
+    });
+
+    // --- 13. SIMHASH INSPECTOR ---
+    // Debugs "Why did this run? Code Changed?"
+    router.get('/debug/simhash/:hash', async (req, res) => {
+        const { hash } = req.params;
+        try {
+            const doc = await db.collection('system_simhash_registry').doc(hash).get();
+            if (!doc.exists) return res.status(404).json({ error: "Hash not found in registry." });
+            
+            res.json(doc.data());
+        } catch (e) {
+            res.status(500).json({ error: e.message });
+        }
+    });
+
     return router;
 };
 

package/package.json

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