decharge-scout 4.0.5 → 4.3.0

package/.env.example

@@ -27,3 +27,8 @@ STAKE_AMOUNT=0.01
 
 # Premium Feature Price (in SOL)
 PREMIUM_PRICE=0.001
+
+# Query Cycle Interval (in minutes)
+# How often to fetch weather & submit data (default: 15)
+# For testing, you can set to 2 minutes: CYCLE_INTERVAL_MINUTES=2
+CYCLE_INTERVAL_MINUTES=15

package/index.js

@@ -40,14 +40,15 @@ import { submitToOracle } from './src/oracle.js';
 import { initializePoints, awardPoints, getPoints, savePoints } from './src/points.js';
 import { getLocation } from './src/geolocation.js';
 import { purchasePremiumData } from './src/x402.js';
-import { hasBeenAskedForAlpha, markAskedForAlpha, parseAlphaContribution, saveAlphaContribution, calculateAlphaBonus, getAlphaInsights, verifyContribution, getInformationSources } from './src/local-alpha.js';
+import { parseAlphaContribution, saveAlphaContribution, calculateAlphaBonus, getAlphaInsights, verifyContribution, getInformationSources } from './src/local-alpha.js';
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 
 // Configuration
 const STAKE_AMOUNT = parseFloat(process.env.STAKE_AMOUNT || '0.01');
-const CYCLE_INTERVAL_MS = 15 * 60 * 1000; // 15 minutes
+const CYCLE_INTERVAL_MINUTES = parseInt(process.env.CYCLE_INTERVAL_MINUTES || '15'); // Default: 15 minutes
+const CYCLE_INTERVAL_MS = CYCLE_INTERVAL_MINUTES * 60 * 1000;
 
 // Global state
 let isRunning = true;
@@ -353,17 +354,147 @@ async function runQueryCycle(wallet, agentName, location, options) {
         }
       }
 
-      // Prepare submission data
+      // Ask for special notes before submission (with 10s timeout)
+      console.log(chalk.cyan('\n💬 Add special notes to this submission? (optional)'));
+      console.log(chalk.gray('   Examples: "High AC usage today", "Local festival", "Grid maintenance"\n'));
+      console.log(chalk.gray('   (Will auto-submit in 10 seconds if no input)\n'));
+
+      const specialNotes = await Promise.race([
+        question(chalk.blue('Special notes (or press Enter to skip): ')),
+        new Promise((resolve) => {
+          setTimeout(() => {
+            console.log(chalk.yellow('\n⏱️  Timeout - submitting without notes'));
+            resolve('');
+          }, 10000); // 10 second timeout
+        })
+      ]);
+
+      // Local Alpha Contribution - Ask BEFORE every submission for bonus points
+      console.log(chalk.cyan('\n💡 Bonus Points: Share Local Peak Time Knowledge!'));
+      console.log(chalk.gray('   Help improve global energy data by sharing when electricity is expensive/cheap in your area.\n'));
+
+      console.log(chalk.blue('💬 Examples:'));
+      console.log(chalk.gray('   • "7-9PM peak in Lagos" (evening peak)'));
+      console.log(chalk.gray('   • "1-5AM cheap in Berlin" (off-peak)'));
+      console.log(chalk.gray('   • "5-8PM peak in Mumbai" (dinner time surge)'));
+      console.log(chalk.gray('   • "2-6AM cheap in Texas" (wind energy overnight)'));
+      console.log(chalk.gray('   (Will auto-skip in 15 seconds if no input)\n'));
+
+      const alphaInput = await Promise.race([
+        question(chalk.blue('Share local peak times (or press Enter to skip): ')),
+        new Promise((resolve) => {
+          setTimeout(() => {
+            console.log(chalk.yellow('\n⏱️  Timeout - skipping bonus contribution'));
+            resolve('');
+          }, 15000); // 15 second timeout
+        })
+      ]);
+
+      // Process alpha contribution if provided
+      if (alphaInput.trim()) {
+        const parsed = parseAlphaContribution(alphaInput, location);
+        if (parsed) {
+          // Verify contribution against current pricing data
+          const verification = verifyContribution(parsed, energyData);
+
+          // Save contribution with verification status
+          const contribution = saveAlphaContribution(parsed, agentName, location, verification);
+
+          // Store for dashboard submission
+          pendingAlphaContribution = {
+            type: parsed.type,
+            startHour: parsed.startHour,
+            endHour: parsed.endHour,
+            location: parsed.location,
+            verified: verification.verified,
+            confidence: verification.confidence,
+            verificationReasons: verification.reasons
+          };
+
+          // Calculate bonus (higher for verified contributions)
+          const alphaBonus = calculateAlphaBonus(parsed, verification);
+
+          awardPoints(wallet, alphaBonus);
+
+          console.log(chalk.green(`\n✅ Thanks for contributing! Earned ${alphaBonus} bonus points!`));
+          console.log(chalk.gray(`   Contribution: ${parsed.type} hours ${parsed.startHour}-${parsed.endHour} in ${parsed.location}`));
+
+          // Show verification results
+          if (verification.verified) {
+            console.log(chalk.green(`   🎯 Verified! Confidence: ${(verification.confidence * 100).toFixed(0)}%`));
+            verification.reasons.forEach(reason => {
+              console.log(chalk.gray(`   ${reason}`));
+            });
+            console.log(chalk.green(`   +${alphaBonus - 10} extra points for verified contribution!`));
+          } else {
+            console.log(chalk.yellow(`   ⚠️  Low confidence: ${(verification.confidence * 100).toFixed(0)}%`));
+            verification.reasons.forEach(reason => {
+              console.log(chalk.gray(`   ${reason}`));
+            });
+            console.log(chalk.gray(`   Tip: Contributions that match actual price patterns earn more points!`));
+          }
+        } else {
+          console.log(chalk.yellow('⚠️  Could not parse contribution.'));
+          console.log(chalk.gray('   Accepted formats:'));
+          console.log(chalk.gray('   • "7-9PM peak in Lagos"'));
+          console.log(chalk.gray('   • "1-5AM cheap in Berlin"'));
+          console.log(chalk.gray('   • "19-21 peak Mumbai" (24-hour format also works)'));
+        }
+      }
+
+      // Prepare comprehensive submission data
       const submissionData = {
         agent_name: agentName,
         location: location,
         timestamp: Date.now(),
+
+        // Summary results (for quick display)
         results: {
           cheapest_window: cheapestWindow.timeWindow,
           price: cheapestWindow.price,
           savings: savings,
           data_points: energyData.length
-        }
+        },
+
+        // Full weather data
+        weather: {
+          location: weatherData.location,
+          forecast_summary: {
+            hours: weatherData.forecast.length,
+            temp_range: {
+              min: Math.min(...weatherData.forecast.map(f => f.temperature)),
+              max: Math.max(...weatherData.forecast.map(f => f.temperature))
+            },
+            avg_wind: weatherData.forecast.reduce((sum, f) => sum + f.windSpeed, 0) / weatherData.forecast.length,
+            avg_solar: weatherData.forecast.reduce((sum, f) => sum + f.solarRadiation, 0) / weatherData.forecast.length
+          },
+          optimal_hour_conditions: cheapestHourData?.weather || null
+        },
+
+        // Pricing insights
+        pricing: {
+          region: insights.region,
+          base_price: insights.basePrice,
+          price_range: {
+            min: insights.minPrice,
+            max: insights.maxPrice,
+            variation_percent: insights.priceRange
+          },
+          savings_potential: insights.savingsPotential,
+          country_code: countryCode
+        },
+
+        // Optimization details
+        optimization: {
+          cheapest_hour: cheapestWindow.hour,
+          time_window: cheapestWindow.timeWindow,
+          price: cheapestWindow.price,
+          savings_percent: savings,
+          reasons: cheapestHourData?.reasons || []
+        },
+
+        // Special notes from user
+        notes: specialNotes.trim() || null
       };
 
       // Submit to oracle
@@ -434,103 +565,6 @@ async function runQueryCycle(wallet, agentName, location, options) {
       console.log(chalk.magenta(`\n⭐ Earned ${totalPointsEarned} points! (${basePoints} base${bonusPoints > 0 ? ` + ${bonusPoints} bonus` : ''})`));
       console.log(chalk.magenta(`⭐ Total Points: ${currentPoints}`));
 
-      // Local Alpha Contribution (ask once after first run)
-      if (totalRuns === 1 && !hasBeenAskedForAlpha()) {
-        console.log(chalk.cyan('\n💡 Local Alpha Contribution - Help Improve Global Energy Data!'));
-        console.log(chalk.gray('   Share your local electricity peak time knowledge for bonus points.\n'));
-
-        // Show where to find this information
-        console.log(chalk.blue('📚 Where to find peak time information:'));
-        const sources = getInformationSources(location);
-
-        // General sources
-        sources.general.forEach(source => {
-          console.log(chalk.gray(`   ${source}`));
-        });
-
-        // Region-specific sources
-        const regionKeys = Object.keys(sources.byRegion);
-        if (regionKeys.length > 0) {
-          console.log(chalk.blue('\n📍 For your region:'));
-          regionKeys.forEach(region => {
-            sources.byRegion[region].forEach(source => {
-              console.log(chalk.gray(`   ${source}`));
-            });
-          });
-        }
-
-        console.log(chalk.blue('\n💬 Examples of good contributions:'));
-        console.log(chalk.gray('   • "7-9PM peak in Lagos" (evening peak)'));
-        console.log(chalk.gray('   • "1-5AM cheap in Berlin" (off-peak)'));
-        console.log(chalk.gray('   • "5-8PM peak in Mumbai" (dinner time surge)'));
-        console.log(chalk.gray('   • "2-6AM cheap in Texas" (wind energy overnight)'));
-        console.log(chalk.gray('   (Will auto-skip in 15 seconds if no input)\n'));
-
-        // Add timeout to prevent hanging
-        const alphaInput = await Promise.race([
-          question(chalk.blue('Share local peak times (or press Enter to skip): ')),
-          new Promise((resolve) => {
-            setTimeout(() => {
-              console.log(chalk.yellow('\n⏱️  Timeout - skipping alpha contribution'));
-              resolve('');
-            }, 15000); // 15 second timeout
-          })
-        ]);
-
-        if (alphaInput.trim()) {
-          const parsed = parseAlphaContribution(alphaInput, location);
-          if (parsed) {
-            // Verify contribution against current pricing data
-            const verification = verifyContribution(parsed, energyData);
-
-            // Save contribution with verification status
-            const contribution = saveAlphaContribution(parsed, agentName, location, verification);
-
-            // Store for dashboard submission
-            pendingAlphaContribution = {
-              type: parsed.type,
-              startHour: parsed.startHour,
-              endHour: parsed.endHour,
-              location: parsed.location,
-              verified: verification.verified,
-              confidence: verification.confidence,
-              verificationReasons: verification.reasons
-            };
-
-            // Calculate bonus (higher for verified contributions)
-            const alphaBonus = calculateAlphaBonus(parsed, verification);
-
-            awardPoints(wallet, alphaBonus);
-
-            console.log(chalk.green(`\n✅ Thanks for contributing! Earned ${alphaBonus} bonus points!`));
-            console.log(chalk.gray(`   Contribution: ${parsed.type} hours ${parsed.startHour}-${parsed.endHour} in ${parsed.location}`));
-
-            // Show verification results
-            if (verification.verified) {
-              console.log(chalk.green(`   🎯 Verified! Confidence: ${(verification.confidence * 100).toFixed(0)}%`));
-              verification.reasons.forEach(reason => {
-                console.log(chalk.gray(`   ${reason}`));
-              });
-              console.log(chalk.green(`   +${alphaBonus - 10} extra points for verified contribution!`));
-            } else {
-              console.log(chalk.yellow(`   ⚠️  Low confidence: ${(verification.confidence * 100).toFixed(0)}%`));
-              verification.reasons.forEach(reason => {
-                console.log(chalk.gray(`   ${reason}`));
-              });
-              console.log(chalk.gray(`   Tip: Contributions that match actual price patterns earn more points!`));
-            }
-          } else {
-            console.log(chalk.yellow('⚠️  Could not parse contribution.'));
-            console.log(chalk.gray('   Accepted formats:'));
-            console.log(chalk.gray('   • "7-9PM peak in Lagos"'));
-            console.log(chalk.gray('   • "1-5AM cheap in Berlin"'));
-            console.log(chalk.gray('   • "19-21 peak Mumbai" (24-hour format also works)'));
-          }
-        }
-
-        markAskedForAlpha();
-      }
-
       // Show alpha insights if available
       if (totalRuns === 1) {
         const alphaInsights = getAlphaInsights(location);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "decharge-scout",
-  "version": "4.0.5",
+  "version": "4.3.0",
   "description": "Global Energy Scout - Weather-powered intelligent energy price forecasting with Solana integration",
   "main": "index.js",
   "type": "module",