burnwatch 0.4.3 → 0.5.0

package/CHANGELOG.md

@@ -5,13 +5,20 @@ All notable changes to burnwatch will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [0.4.3] - 2026-03-24
+## [0.5.0] - 2026-03-24
+
+### Changed
+
+- **Interactive init rewritten as proper interview**: Each service gets a structured conversation - plan selection, API key collection with hints on where to find them, and budget. Budgets are never skipped - pressing Enter applies the plan cost (or $0 for free tiers) instead of leaving budget undefined. Summary table at the end shows total monthly budget across all services.
+- **Env var auto-detection for API keys**: Init checks `process.env` for known key patterns (e.g., `ANTHROPIC_ADMIN_KEY`, `SCRAPFLY_KEY`) and auto-imports them to global config. No need to re-enter keys that are already in your environment.
+- **API key prompts for all LIVE services**: Previously only fired when the chosen plan had `requiresKey: true`. Now any LIVE-capable service gets the key prompt regardless of plan, with a hint about where to find the key (e.g., "Admin key: console.anthropic.com -> Settings -> Admin API Keys").
+- **Non-interactive init always sets budget**: Every service gets `budget: 0` at minimum (flat-rate services get budget = plan cost). No more undefined budgets showing as "-" in status output.
+- **Non-interactive env var key detection**: Checks environment for API keys matching service patterns, auto-saves to global config for LIVE tracking.
 
 ### Fixed
 
-- **Non-interactive init auto-applies default plans**: `burnwatch init` (non-interactive or re-run) now picks each service's default plan from the registry. Flat-rate services with a cost (e.g., Scrapfly Scale at $80/mo) get budget auto-set to plan cost. Services with existing API keys in global config are auto-detected as LIVE.
-- **Init output shows tier and budget per service**: Non-interactive init now prints each service with its confidence tier, plan name, and budget (if set), plus a clear list of which services still need budgets with the exact `burnwatch add` commands.
-- **Untracked message is actionable**: Changed circular "run burnwatch status" message to "run burnwatch init to configure".
+- **13/14 services had no budget after init**: Root cause was budget prompt saying "press Enter to skip". Now pressing Enter applies the default budget instead of skipping.
+- **Untracked message was circular**: Changed "run burnwatch status" to "run burnwatch init to configure".
 
 ## [0.4.2] - 2026-03-24
 
@@ -59,6 +66,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Snapshot system for delta computation across sessions
 - Claude Code skills: `/spend` (on-demand brief), `/setup-burnwatch` (guided onboarding)
 
+[0.5.0]: https://github.com/RaleighSF/burnwatch/compare/v0.4.3...v0.5.0
 [0.4.3]: https://github.com/RaleighSF/burnwatch/compare/v0.4.2...v0.4.3
 [0.4.2]: https://github.com/RaleighSF/burnwatch/compare/v0.4.0...v0.4.2
 [0.4.0]: https://github.com/RaleighSF/burnwatch/compare/v0.1.0...v0.4.0

package/dist/cli.js

@@ -789,10 +789,18 @@ function saveSnapshot(brief, projectRoot) {
 import * as readline from "readline";
 var RISK_ORDER = ["llm", "usage", "infra", "flat"];
 var RISK_LABELS = {
-  llm: "\u{1F916} LLM / AI Services (highest variable cost)",
-  usage: "\u{1F4CA} Usage-Based Services",
-  infra: "\u{1F3D7}\uFE0F  Infrastructure & Compute",
-  flat: "\u{1F4E6} Flat-Rate / Free Tier Services"
+  llm: "LLM / AI Services (highest variable cost)",
+  usage: "Usage-Based Services",
+  infra: "Infrastructure & Compute",
+  flat: "Flat-Rate / Free Tier Services"
+};
+var API_KEY_HINTS = {
+  anthropic: "Admin key: console.anthropic.com -> Settings -> Admin API Keys",
+  openai: "Org key: platform.openai.com -> Settings -> API Keys",
+  vercel: "Token: vercel.com/account/tokens",
+  supabase: "Service role key: supabase.com/dashboard -> Settings -> API",
+  stripe: "Secret key: dashboard.stripe.com -> Developers -> API Keys",
+  scrapfly: "API key: scrapfly.io/dashboard"
 };
 function classifyRisk(service) {
   if (service.billingModel === "token_usage") return "llm";
@@ -829,6 +837,13 @@ async function autoDetectScrapflyPlan(apiKey) {
   }
   return null;
 }
+function findEnvKey(service) {
+  for (const pattern of service.envPatterns) {
+    const val = process.env[pattern];
+    if (val && val.length > 0) return val;
+  }
+  return void 0;
+}
 async function runInteractiveInit(detected) {
   const rl = readline.createInterface({
     input: process.stdin,
@@ -838,14 +853,16 @@ async function runInteractiveInit(detected) {
   const groups = groupByRisk(detected);
   const globalConfig = readGlobalConfig();
   console.log(
-    "\n\u{1F4CB} Let's configure each detected service. Services are grouped by cost risk.\n"
+    `
+  Found ${detected.length} paid service${detected.length !== 1 ? "s" : ""}. Let's configure each one.
+`
   );
   for (const category of RISK_ORDER) {
     const group = groups.get(category);
     if (group.length === 0) continue;
     console.log(`
-${RISK_LABELS[category]}`);
-    console.log("\u2500".repeat(50));
+  ${RISK_LABELS[category]}`);
+    console.log("  " + "-".repeat(48));
     for (const det of group) {
       const service = det.service;
       const plans = service.plans;
@@ -857,23 +874,24 @@ ${RISK_LABELS[category]}`);
           serviceId: service.id,
           detectedVia: det.sources,
           hasApiKey: false,
-          firstDetected: (/* @__PURE__ */ new Date()).toISOString()
+          firstDetected: (/* @__PURE__ */ new Date()).toISOString(),
+          budget: 0
         };
-        console.log("  \u2192 Auto-configured (no plan tiers available)");
+        console.log("  -> Configured (no plan tiers in registry, budget: $0)");
         continue;
       }
       const defaultIndex = plans.findIndex((p) => p.default);
       console.log("");
       for (let i = 0; i < plans.length; i++) {
         const plan = plans[i];
-        const marker = i === defaultIndex ? " (recommended)" : "";
-        const costStr = plan.type === "exclude" ? "" : plan.monthlyBase !== void 0 ? ` \u2014 $${plan.monthlyBase}/mo` : " \u2014 variable";
+        const marker = i === defaultIndex ? " *" : "";
+        const costStr = plan.type === "exclude" ? "" : plan.monthlyBase !== void 0 ? ` - $${plan.monthlyBase}/mo` : " - variable";
         console.log(`    ${i + 1}) ${plan.name}${costStr}${marker}`);
       }
       const defaultChoice = defaultIndex >= 0 ? String(defaultIndex + 1) : "1";
       const answer = await ask(
         rl,
-        `  Choose [${defaultChoice}]: `
+        `  Which plan? [${defaultChoice}]: `
       );
       const choiceIndex = (answer === "" ? parseInt(defaultChoice) : parseInt(answer)) - 1;
       const chosen = plans[choiceIndex] ?? plans[defaultIndex >= 0 ? defaultIndex : 0];
@@ -886,10 +904,10 @@ ${RISK_LABELS[category]}`);
           excluded: true,
           planName: chosen.name
         };
-        console.log(`  \u2192 ${service.name}: excluded from tracking`);
+        console.log(`  -> ${service.name}: excluded`);
         continue;
       }
-      const tracked = {
+      const tracked2 = {
         serviceId: service.id,
         detectedVia: det.sources,
         hasApiKey: false,
@@ -897,67 +915,86 @@ ${RISK_LABELS[category]}`);
         planName: chosen.name
       };
       if (chosen.type === "flat" && chosen.monthlyBase !== void 0) {
-        tracked.planCost = chosen.monthlyBase;
-        if (chosen.monthlyBase > 0) {
-          tracked.budget = chosen.monthlyBase;
-        }
+        tracked2.planCost = chosen.monthlyBase;
       }
-      if (service.apiTier === "live" || chosen.requiresKey) {
+      if (service.apiTier === "live") {
         const existingKey = globalConfig.services[service.id]?.apiKey;
+        const envKey = findEnvKey(service);
         if (existingKey) {
-          console.log(`  \u{1F510} Using existing API key from global config`);
-          tracked.hasApiKey = true;
-          if (service.autoDetectPlan && service.id === "scrapfly") {
-            console.log("  \u{1F50D} Auto-detecting plan from API...");
-            const planName = await autoDetectScrapflyPlan(existingKey);
-            if (planName) {
-              console.log(`  \u2192 Detected plan: ${planName}`);
-              tracked.planName = planName;
-            }
+          console.log(`  API key: found in global config`);
+          tracked2.hasApiKey = true;
+        } else if (envKey) {
+          console.log(`  API key: found in environment (${service.envPatterns[0]})`);
+          tracked2.hasApiKey = true;
+          if (!globalConfig.services[service.id]) {
+            globalConfig.services[service.id] = {};
           }
-        } else if (chosen.requiresKey) {
+          globalConfig.services[service.id].apiKey = envKey;
+        } else {
+          const hint = API_KEY_HINTS[service.id];
+          if (hint) console.log(`  ${hint}`);
           const keyAnswer = await ask(
             rl,
-            `  Enter API key (or press Enter to skip): `
+            `  API key for real-time tracking (Enter to skip): `
           );
           if (keyAnswer) {
-            tracked.hasApiKey = true;
+            tracked2.hasApiKey = true;
             if (!globalConfig.services[service.id]) {
               globalConfig.services[service.id] = {};
             }
             globalConfig.services[service.id].apiKey = keyAnswer;
-            if (service.autoDetectPlan && service.id === "scrapfly") {
-              console.log("  \u{1F50D} Auto-detecting plan from API...");
-              const planName = await autoDetectScrapflyPlan(keyAnswer);
-              if (planName) {
-                console.log(`  \u2192 Detected plan: ${planName}`);
-                tracked.planName = planName;
-              }
+          }
+        }
+        if (service.autoDetectPlan && service.id === "scrapfly" && tracked2.hasApiKey) {
+          const key = globalConfig.services[service.id]?.apiKey;
+          if (key) {
+            console.log("  Detecting plan from API...");
+            const planName = await autoDetectScrapflyPlan(key);
+            if (planName) {
+              console.log(`  -> Detected plan: ${planName}`);
+              tracked2.planName = planName;
             }
           }
         }
       }
-      if (tracked.budget === void 0 || tracked.budget === 0) {
-        const suggestion = chosen.monthlyBase && chosen.monthlyBase > 0 ? ` [${chosen.monthlyBase}]` : "";
+      const planCost = chosen.monthlyBase ?? 0;
+      if (chosen.type === "usage" && planCost === 0) {
+        const budgetAnswer = await ask(
+          rl,
+          `  Monthly budget: $`
+        );
+        const parsed = parseFloat(budgetAnswer);
+        tracked2.budget = !isNaN(parsed) ? parsed : 0;
+      } else {
         const budgetAnswer = await ask(
           rl,
-          `  Monthly budget in USD${suggestion} (or press Enter to skip): $`
+          `  Monthly budget [$${planCost}]: $`
         );
         if (budgetAnswer) {
-          const budget = parseFloat(budgetAnswer);
-          if (!isNaN(budget)) {
-            tracked.budget = budget;
-          }
+          const parsed = parseFloat(budgetAnswer);
+          tracked2.budget = !isNaN(parsed) ? parsed : planCost;
+        } else {
+          tracked2.budget = planCost;
         }
       }
-      services[service.id] = tracked;
-      const tierLabel = tracked.hasApiKey ? "\u2705 LIVE" : tracked.planCost !== void 0 ? "\u{1F7E1} CALC" : "\u{1F534} BLIND";
-      const budgetStr = tracked.budget !== void 0 ? ` | Budget: $${tracked.budget}/mo` : "";
+      services[service.id] = tracked2;
+      const tierLabel = tracked2.hasApiKey ? "LIVE" : tracked2.planCost !== void 0 ? "CALC" : "BLIND";
       console.log(
-        `  \u2192 ${service.name}: ${chosen.name} (${tierLabel}${budgetStr})`
+        `  -> ${service.name}: ${tracked2.planName} | ${tierLabel} | $${tracked2.budget}/mo`
       );
     }
   }
+  const tracked = Object.values(services).filter((s) => !s.excluded);
+  const excluded = Object.values(services).filter((s) => s.excluded);
+  const liveCount = tracked.filter((s) => s.hasApiKey).length;
+  const totalBudget = tracked.reduce((sum, s) => sum + (s.budget ?? 0), 0);
+  console.log("\n  " + "=".repeat(48));
+  console.log(`  ${tracked.length} services configured`);
+  if (liveCount > 0) console.log(`    ${liveCount} with real-time billing (LIVE)`);
+  if (tracked.length - liveCount > 0) console.log(`    ${tracked.length - liveCount} estimated/calculated`);
+  if (excluded.length > 0) console.log(`    ${excluded.length} excluded`);
+  console.log(`  Total monthly budget: $${totalBudget}`);
+  console.log("  " + "=".repeat(48));
   writeGlobalConfig(globalConfig);
   rl.close();
   return { services };
@@ -1036,27 +1073,39 @@ async function cmdInit() {
       const plans = service.plans ?? [];
       const defaultPlan = plans.find((p) => p.default) ?? plans[0];
       if (existing?.budget !== void 0 && existing.budget > 0) continue;
-      const tracked2 = {
+      const tracked = {
         serviceId: service.id,
         detectedVia: existing?.detectedVia ?? det.sources,
         hasApiKey: existing?.hasApiKey ?? false,
-        firstDetected: existing?.firstDetected ?? (/* @__PURE__ */ new Date()).toISOString()
+        firstDetected: existing?.firstDetected ?? (/* @__PURE__ */ new Date()).toISOString(),
+        budget: 0
+        // Always set — $0 is intentional, not missing
       };
       if (defaultPlan && defaultPlan.type !== "exclude") {
-        tracked2.planName = defaultPlan.name;
+        tracked.planName = defaultPlan.name;
         if (defaultPlan.type === "flat" && defaultPlan.monthlyBase !== void 0) {
-          tracked2.planCost = defaultPlan.monthlyBase;
-          if (defaultPlan.monthlyBase > 0) {
-            tracked2.budget = defaultPlan.monthlyBase;
-          }
+          tracked.planCost = defaultPlan.monthlyBase;
+          tracked.budget = defaultPlan.monthlyBase;
         }
       }
       const existingKey = globalConfig.services[service.id]?.apiKey;
       if (existingKey) {
-        tracked2.hasApiKey = true;
+        tracked.hasApiKey = true;
+      } else {
+        for (const pattern of service.envPatterns) {
+          if (process.env[pattern]) {
+            tracked.hasApiKey = true;
+            if (!globalConfig.services[service.id]) {
+              globalConfig.services[service.id] = {};
+            }
+            globalConfig.services[service.id].apiKey = process.env[pattern];
+            break;
+          }
+        }
       }
-      config.services[service.id] = tracked2;
+      config.services[service.id] = tracked;
     }
+    writeGlobalConfig(globalConfig);
     if (detected.length === 0) {
       console.log("   No paid services detected yet.");
       console.log("   Services will be detected as they enter your project.\n");
@@ -1066,11 +1115,11 @@ async function cmdInit() {
       const needBudget = [];
       for (const det of detected) {
         const svc = config.services[det.service.id];
-        const tierBadge = det.service.apiTier === "live" ? svc?.hasApiKey ? "\u2705 LIVE" : "\u{1F534} BLIND" : det.service.apiTier === "calc" ? "\u{1F7E1} CALC" : det.service.apiTier === "est" ? "\u{1F7E0} EST" : "\u{1F534} BLIND";
+        const tierBadge = det.service.apiTier === "live" ? svc?.hasApiKey ? "LIVE" : "BLIND" : det.service.apiTier === "calc" ? "CALC" : det.service.apiTier === "est" ? "EST" : "BLIND";
         const planStr = svc?.planName ? ` (${svc.planName})` : "";
-        const budgetStr = svc?.budget ? ` - $${svc.budget}/mo budget` : "";
-        console.log(`   \u2022 ${det.service.name}${planStr} ${tierBadge}${budgetStr}`);
-        if (!svc?.budget) {
+        const budgetStr = svc?.budget !== void 0 ? ` $${svc.budget}/mo` : "";
+        console.log(`   ${det.service.name}${planStr} [${tierBadge}]${budgetStr}`);
+        if (svc?.budget === 0 && det.service.apiTier !== "calc") {
           needBudget.push(det.service.id);
         }
       }
@@ -1099,27 +1148,11 @@ async function cmdInit() {
   );
   console.log("\n\u{1F517} Registering Claude Code hooks...\n");
   registerHooks(projectRoot);
-  const excluded = Object.values(config.services).filter((s) => s.excluded);
-  const tracked = Object.values(config.services).filter((s) => !s.excluded);
-  console.log("\u2705 burnwatch initialized!\n");
-  if (tracked.length > 0) {
-    console.log(`   Tracking ${tracked.length} service${tracked.length > 1 ? "s" : ""}`);
-    for (const svc of tracked) {
-      const planStr = svc.planName ? ` (${svc.planName})` : "";
-      const budgetStr = svc.budget !== void 0 ? ` \u2014 $${svc.budget}/mo budget` : "";
-      console.log(`   \u2022 ${svc.serviceId}${planStr}${budgetStr}`);
-    }
-  }
-  if (excluded.length > 0) {
-    console.log(`
-   Excluded ${excluded.length} service${excluded.length > 1 ? "s" : ""}:`);
-    for (const svc of excluded) {
-      console.log(`   \u2022 ${svc.serviceId}`);
-    }
-  }
-  console.log("\nNext steps:");
-  console.log("  burnwatch status     \u2014 Check your spend");
-  console.log("  burnwatch add <svc>  \u2014 Configure additional services\n");
+  console.log("\nburnwatch initialized.\n");
+  console.log("Next steps:");
+  console.log("  burnwatch status        Show current spend");
+  console.log("  burnwatch add <svc>     Update a service's budget or API key");
+  console.log("  burnwatch init          Re-run this setup anytime\n");
 }
 async function cmdAdd() {
   const projectRoot = process.cwd();