openclaw-smartmeter 0.2.0 → 0.2.2

package/README.md

@@ -61,7 +61,26 @@ npm link
 
 ## Quick Start
 
-### 1. Analyze your usage
+### Super Simple - One Command! 🚀
+
+```bash
+# Install globally
+npm install -g openclaw-smartmeter
+
+# Run analysis - dashboard opens automatically in your browser!
+smartmeter analyze
+```
+
+That's it! The dashboard opens automatically with:
+
+- ✅ Cost savings visualization
+- ✅ One-click optimization application
+- ✅ Export reports
+- ✅ Live data updates
+
+### Detailed Workflow
+
+### 1. Analyze your usage (auto-opens dashboard)
 
 ```bash
 # Analyze default OpenClaw data (~/.openclaw)
@@ -84,7 +103,23 @@ Analysis: 2026-02-04 to 2026-02-05 (2 days)
   Confidence                optimistic
 ```
 
-### 2. Evaluate your configuration
+### 2. Use the Dashboard (already open!)
+
+The dashboard automatically opened in step 1, showing:
+
+- Cost savings overview with before/after comparison
+- Model usage breakdown (bar chart)
+- Task classification distribution (doughnut chart)
+- Actionable recommendations with impact estimates
+- Auto-refresh every 5 seconds
+
+**Dashboard Actions:**
+
+- 🎯 **Apply Optimizations** - One click to apply all changes (creates backup)
+- 📄 **Export Report** - Download markdown report
+- ⚙️ **Preview Config** - See exact changes before applying
+
+### 3. Evaluate your configuration
 
 ```bash
 smartmeter evaluate

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openclaw-smartmeter",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "AI cost optimization for OpenClaw - analyze usage and reduce costs by 48%",
   "main": "src/cli/index.js",
   "bin": {

package/src/canvas/api-server.js

@@ -228,7 +228,7 @@ export class ApiServer {
 - **Current Monthly Cost:** $${s.currentMonthlyCost.toFixed(2)}
 - **Optimized Monthly Cost:** $${s.optimizedMonthlyCost.toFixed(2)}
 - **Potential Savings:** $${s.potentialSavings.toFixed(2)}/month (${s.savingsPercentage.toFixed(1)}%)
-- **Confidence Level:** ${analysis.confidence.level}
+- **Confidence Level:** ${s.confidence || 'unknown'}
 
 ## Model Breakdown
 

package/src/cli/commands.js

@@ -66,15 +66,95 @@ export async function cmdAnalyze(opts = {}) {
   const storageDir = opts.storageDir || SMARTMETER_DIR;
   await writeAnalysis(analysis, storageDir);
 
-  // Auto-update dashboard if canvas is deployed
-  const deployer = new CanvasDeployer();
-  if (await deployer.isDeployed()) {
-    await deployer.generatePublicAnalysis(analysis);
-    console.log("✓ Dashboard data updated");
-  }
-
   console.log(formatSummary(analysis));
   console.log(`\nAnalysis saved to ${storageDir}/analysis.json`);
+
+  // Auto-deploy dashboard and open in browser
+  const shouldOpenDashboard = opts.noDashboard !== true;
+  
+  if (shouldOpenDashboard) {
+    console.log("\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━");
+    console.log("🚀 Launching SmartMeter Dashboard...");
+    console.log("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n");
+
+    try {
+      const deployer = new CanvasDeployer();
+      
+      // Deploy dashboard files
+      await deployer.deploy();
+      await deployer.generatePublicAnalysis(analysis);
+      
+      const port = opts.port || 8080;
+      const apiPort = opts.apiPort || 3001;
+      
+      // Start API server in background
+      console.log("✓ Starting API server...");
+      const apiServer = await startApiServer({ port: apiPort });
+      
+      // Start static file server in background
+      console.log("✓ Starting dashboard server...");
+      const staticServer = await startStaticFileServer(deployer.canvasDir, port);
+      
+      const url = `http://localhost:${port}`;
+      
+      console.log(`
+✅ Dashboard is live!
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+🌐 Dashboard URL: ${url}
+📡 API Server:    http://localhost:${apiPort}
+
+💡 Features:
+   • View cost savings and recommendations
+   • Apply optimizations with one click
+   • Export reports
+   • Preview config changes
+
+🔄 Dashboard updates automatically every 5 seconds
+
+Opening in your browser...
+`);
+
+      // Open browser
+      try {
+        await deployer.openDashboard(port);
+        console.log("✓ Browser opened\n");
+      } catch (err) {
+        console.log(`⚠ Could not open browser automatically`);
+        console.log(`  Please open manually: ${url}\n`);
+      }
+
+      console.log("💡 Tip: Press Ctrl+C to stop the servers");
+      console.log("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n");
+
+      // Keep process alive and handle shutdown
+      const shutdownHandler = async () => {
+        console.log("\n\n🛑 Shutting down servers...");
+        try {
+          await staticServer.stop();
+          await apiServer.stop();
+          console.log("✓ Servers stopped");
+        } catch (err) {
+          console.error("Error stopping servers:", err.message);
+        }
+        process.exit(0);
+      };
+
+      process.on("SIGINT", shutdownHandler);
+      process.on("SIGTERM", shutdownHandler);
+
+      // Store server references for cleanup
+      analysis._servers = { staticServer, apiServer };
+      
+    } catch (err) {
+      console.error(`\n⚠ Could not start dashboard: ${err.message}`);
+      console.log(`\nYou can view your analysis by running:`);
+      console.log(`  smartmeter status`);
+      console.log(`\nOr start the dashboard manually:`);
+      console.log(`  smartmeter serve\n`);
+    }
+  }
+
   return analysis;
 }
 
@@ -286,7 +366,7 @@ export async function cmdEvaluate(opts = {}) {
 📊 Current Analysis:
    Period: ${analysis.period.days} days (${analysis.period.start} to ${analysis.period.end})
    Tasks Analyzed: ${analysis.period.totalTasks}
-   Confidence: ${analysis.confidence.level}
+   Confidence: ${s.confidence || 'unknown'}
 
 💰 Cost Analysis:
    Current Monthly Cost:   $${s.currentMonthlyCost.toFixed(2)}
@@ -342,6 +422,8 @@ ${Object.entries(analysis.categories || {})
   .map(([name, c]) => `  • ${name}: ${c.count} tasks`)
   .join("\n")}
 
+**Confidence Level:** ${analysis.summary.confidence || 'unknown'}
+
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
 ## 💰 Optimization Opportunities

package/src/cli/index.js

@@ -29,7 +29,46 @@ const program = new Command();
 program
   .name("smartmeter")
   .description("Analyze OpenClaw usage and generate optimized configs to reduce AI costs")
-  .version(packageJson.version);
+  .version(packageJson.version)
+  .action(() => {
+    console.log(`
+╔════════════════════════════════════════════════════════╗
+║              Welcome to SmartMeter! 🎯                ║
+╚════════════════════════════════════════════════════════╝
+
+AI Cost Optimization for OpenClaw
+
+📊 Quick Start:
+
+  1️⃣  Analyze your usage and launch dashboard:
+     $ smartmeter analyze
+
+  2️⃣  Dashboard opens automatically in your browser
+     • View cost savings
+     • Apply optimizations
+     • Export reports
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+📚 Other Commands:
+
+  evaluate  - Quick cost evaluation
+  guide     - Step-by-step optimization guide
+  preview   - Preview config changes
+  apply     - Apply optimizations
+  serve     - Start dashboard server
+  status    - Show current analysis
+  report    - Detailed cost breakdown
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+💡 Need help with a specific command?
+   $ smartmeter <command> --help
+
+📖 Full documentation:
+   https://github.com/vajih/openclaw-smartmeter
+`);
+  });
 
 function dataDirOpts(cmdOpts) {
   if (!cmdOpts.dataDir) return {};
@@ -38,9 +77,12 @@ function dataDirOpts(cmdOpts) {
 
 program
   .command("analyze")
-  .description("Analyze usage patterns and generate report")
+  .description("Analyze usage patterns and launch interactive dashboard")
   .option("-d, --data-dir <path>", "OpenClaw data directory (default: ~/.openclaw)")
-  .action((opts) => cmdAnalyze(dataDirOpts(opts)));
+  .option("-p, --port <number>", "Dashboard port (default: 8080)")
+  .option("--api-port <number>", "API server port (default: 3001)")
+  .option("--no-dashboard", "Skip launching dashboard (analysis only)")
+  .action((opts) => cmdAnalyze({ ...dataDirOpts(opts), port: opts.port ? Number(opts.port) : undefined, apiPort: opts.apiPort ? Number(opts.apiPort) : undefined, noDashboard: opts.noDashboard }));
 
 program
   .command("show")