burnwatch 0.3.0 → 0.4.0

package/CHANGELOG.md

@@ -5,6 +5,29 @@ 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.0] - 2026-03-24
+
+### Added
+
+- **Interactive init with plan tiers**: `burnwatch init` now walks through each detected service interactively, grouped by cost risk (LLMs first, then usage-based, infra, flat-rate). Users pick from known plan tiers per service (e.g., Anthropic API Usage, Max $100/mo, Pro $20/mo, or "Don't track").
+- **Plan tiers for all 14 services**: Registry now includes plan options for Anthropic, OpenAI, Google Gemini, Voyage AI, Vercel, Supabase, Stripe, Scrapfly, Browserbase, Upstash, Resend, Inngest, PostHog, and AWS.
+- **Smart defaults**: Each service has a recommended default plan. Flat plans auto-set the budget to the plan cost. API Usage plans prompt for keys and budgets.
+- **Exclude option**: "Don't track for this project" explicitly excludes a service (shows as "excluded", not BLIND).
+- **Auto-detect plan**: Scrapfly plan can be auto-detected from API key via the /account endpoint.
+- **Non-interactive fallback**: `burnwatch init --non-interactive` preserves the original auto-detect behavior for CI/scripted use.
+- **Predictive cost impact analysis**: PostToolUse hook now analyzes file writes for SDK call sites, detects multipliers (loops, .map(), Promise.all, cron schedules, batch sizes), and projects monthly cost ranges using registry pricing data and gotcha-based multipliers.
+- **Cost impact cards**: When a file write contains tracked service SDK calls, a cost impact card is injected into Claude's context with estimated monthly cost, current budget status, and cheaper alternatives.
+- **Cumulative session cost tracking**: Session cost impacts are accumulated across file changes and reported in the Stop hook.
+- **Projected impact in ledger**: The spend ledger now includes a "projected impact" row showing session cost estimates.
+- **New `excluded` confidence tier**: Services explicitly excluded by the user show ⬚ SKIP instead of 🔴 BLIND.
+
+### Changed
+
+- Registry version bumped to 0.2.0 with plan tier data.
+- CLI now parses `--non-interactive` and `--ni` flags.
+- PostToolUse hook expanded from detection-only to detection + cost impact analysis.
+- Stop hook now reads and reports cumulative session cost impacts.
+
 ## [0.1.0] - 2026-03-24
 
 ### Added
@@ -20,4 +43,5 @@ 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.4.0]: https://github.com/RaleighSF/burnwatch/compare/v0.1.0...v0.4.0
 [0.1.0]: https://github.com/RaleighSF/burnwatch/releases/tag/v0.1.0

package/dist/cli.js

@@ -579,7 +579,8 @@ var CONFIDENCE_BADGES = {
   live: "\u2705 LIVE",
   calc: "\u{1F7E1} CALC",
   est: "\u{1F7E0} EST",
-  blind: "\u{1F534} BLIND"
+  blind: "\u{1F534} BLIND",
+  excluded: "\u2B1A SKIP"
 };
 
 // src/core/brief.ts
@@ -744,6 +745,14 @@ function writeLedger(brief, projectRoot) {
       `| ${svc.serviceId} | ${spendStr} | ${badge} | ${budgetStr} | ${svc.statusLabel} |`
     );
   }
+  const impactAlert = brief.alerts.find(
+    (a) => a.serviceId === "_session_impact"
+  );
+  if (impactAlert) {
+    lines.push(
+      `| _projected impact_ | \u2014 | \u{1F4C8} EST | \u2014 | ${impactAlert.message} |`
+    );
+  }
   lines.push("");
   const totalStr = brief.totalIsEstimate ? `~$${brief.totalSpend.toFixed(2)}` : `$${brief.totalSpend.toFixed(2)}`;
   const marginStr = brief.estimateMargin > 0 ? ` (\xB1$${brief.estimateMargin.toFixed(0)} estimated margin)` : "";
@@ -776,9 +785,185 @@ function saveSnapshot(brief, projectRoot) {
   );
 }
 
+// src/interactive-init.ts
+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"
+};
+function classifyRisk(service) {
+  if (service.billingModel === "token_usage") return "llm";
+  if (service.billingModel === "credit_pool" || service.billingModel === "percentage" || service.billingModel === "per_unit")
+    return "usage";
+  if (service.billingModel === "compute") return "infra";
+  return "flat";
+}
+function groupByRisk(detected) {
+  const groups = /* @__PURE__ */ new Map();
+  for (const cat of RISK_ORDER) {
+    groups.set(cat, []);
+  }
+  for (const det of detected) {
+    const cat = classifyRisk(det.service);
+    groups.get(cat).push(det);
+  }
+  return groups;
+}
+function ask(rl, question) {
+  return new Promise((resolve3) => {
+    rl.question(question, (answer) => {
+      resolve3(answer.trim());
+    });
+  });
+}
+async function autoDetectScrapflyPlan(apiKey) {
+  try {
+    const result = await fetchJson(`https://api.scrapfly.io/account?key=${apiKey}`);
+    if (result.ok && result.data?.subscription?.plan?.name) {
+      return result.data.subscription.plan.name;
+    }
+  } catch {
+  }
+  return null;
+}
+async function runInteractiveInit(detected) {
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout
+  });
+  const services = {};
+  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"
+  );
+  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));
+    for (const det of group) {
+      const service = det.service;
+      const plans = service.plans;
+      console.log(`
+  ${service.name}`);
+      console.log(`  Detected via: ${det.details.join(", ")}`);
+      if (!plans || plans.length === 0) {
+        services[service.id] = {
+          serviceId: service.id,
+          detectedVia: det.sources,
+          hasApiKey: false,
+          firstDetected: (/* @__PURE__ */ new Date()).toISOString()
+        };
+        console.log("  \u2192 Auto-configured (no plan tiers available)");
+        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";
+        console.log(`    ${i + 1}) ${plan.name}${costStr}${marker}`);
+      }
+      const defaultChoice = defaultIndex >= 0 ? String(defaultIndex + 1) : "1";
+      const answer = await ask(
+        rl,
+        `  Choose [${defaultChoice}]: `
+      );
+      const choiceIndex = (answer === "" ? parseInt(defaultChoice) : parseInt(answer)) - 1;
+      const chosen = plans[choiceIndex] ?? plans[defaultIndex >= 0 ? defaultIndex : 0];
+      if (chosen.type === "exclude") {
+        services[service.id] = {
+          serviceId: service.id,
+          detectedVia: det.sources,
+          hasApiKey: false,
+          firstDetected: (/* @__PURE__ */ new Date()).toISOString(),
+          excluded: true,
+          planName: chosen.name
+        };
+        console.log(`  \u2192 ${service.name}: excluded from tracking`);
+        continue;
+      }
+      const tracked = {
+        serviceId: service.id,
+        detectedVia: det.sources,
+        hasApiKey: false,
+        firstDetected: (/* @__PURE__ */ new Date()).toISOString(),
+        planName: chosen.name
+      };
+      if (chosen.type === "flat" && chosen.monthlyBase !== void 0) {
+        tracked.budget = chosen.monthlyBase;
+        tracked.planCost = chosen.monthlyBase;
+      }
+      if (chosen.requiresKey) {
+        const existingKey = globalConfig.services[service.id]?.apiKey;
+        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;
+            }
+          }
+        } else {
+          const keyAnswer = await ask(
+            rl,
+            `  Enter API key (or press Enter to skip): `
+          );
+          if (keyAnswer) {
+            tracked.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 (tracked.budget === void 0) {
+          const budgetAnswer = await ask(
+            rl,
+            `  Monthly budget in USD (or press Enter to skip): $`
+          );
+          if (budgetAnswer) {
+            const budget = parseFloat(budgetAnswer);
+            if (!isNaN(budget)) {
+              tracked.budget = budget;
+            }
+          }
+        }
+      }
+      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` : "";
+      console.log(
+        `  \u2192 ${service.name}: ${chosen.name} (${tierLabel}${budgetStr})`
+      );
+    }
+  }
+  writeGlobalConfig(globalConfig);
+  rl.close();
+  return { services };
+}
+
 // src/cli.ts
 var args = process.argv.slice(2);
 var command = args[0];
+var flags = new Set(args.slice(1));
 async function main() {
   switch (command) {
     case "init":
@@ -818,6 +1003,7 @@ async function main() {
 }
 async function cmdInit() {
   const projectRoot = process.cwd();
+  const nonInteractive = flags.has("--non-interactive") || flags.has("--ni");
   if (isInitialized(projectRoot)) {
     console.log("\u2705 burnwatch is already initialized in this project.");
     console.log(`   Config: ${projectConfigDir(projectRoot)}/config.json`);
@@ -839,14 +1025,32 @@ async function cmdInit() {
     createdAt: (/* @__PURE__ */ new Date()).toISOString(),
     updatedAt: (/* @__PURE__ */ new Date()).toISOString()
   };
-  for (const det of detected) {
-    const tracked = {
-      serviceId: det.service.id,
-      detectedVia: det.sources,
-      hasApiKey: false,
-      firstDetected: (/* @__PURE__ */ new Date()).toISOString()
-    };
-    config.services[det.service.id] = tracked;
+  if (!nonInteractive && detected.length > 0 && process.stdin.isTTY) {
+    const result = await runInteractiveInit(detected);
+    config.services = result.services;
+  } else {
+    for (const det of detected) {
+      const tracked2 = {
+        serviceId: det.service.id,
+        detectedVia: det.sources,
+        hasApiKey: false,
+        firstDetected: (/* @__PURE__ */ new Date()).toISOString()
+      };
+      config.services[det.service.id] = tracked2;
+    }
+    if (detected.length === 0) {
+      console.log("   No paid services detected yet.");
+      console.log("   Services will be detected as they enter your project.\n");
+    } else {
+      console.log(`   Found ${detected.length} paid service${detected.length > 1 ? "s" : ""}:
+`);
+      for (const det of detected) {
+        const tierBadge = det.service.apiTier === "live" ? "\u2705 LIVE API available" : det.service.apiTier === "calc" ? "\u{1F7E1} Flat-rate tracking" : det.service.apiTier === "est" ? "\u{1F7E0} Estimate tracking" : "\u{1F534} Detection only";
+        console.log(`   \u2022 ${det.service.name} (${tierBadge})`);
+        console.log(`     Detected via: ${det.details.join(", ")}`);
+      }
+      console.log("");
+    }
   }
   writeProjectConfig(config, projectRoot);
   const gitignorePath = path5.join(projectConfigDir(projectRoot), ".gitignore");
@@ -861,29 +1065,29 @@ async function cmdInit() {
     ].join("\n"),
     "utf-8"
   );
-  if (detected.length === 0) {
-    console.log("   No paid services detected yet.");
-    console.log("   Services will be detected as they enter your project.\n");
-  } else {
-    console.log(`   Found ${detected.length} paid service${detected.length > 1 ? "s" : ""}:
-`);
-    for (const det of detected) {
-      const tierBadge = det.service.apiTier === "live" ? "\u2705 LIVE API available" : det.service.apiTier === "calc" ? "\u{1F7E1} Flat-rate tracking" : det.service.apiTier === "est" ? "\u{1F7E0} Estimate tracking" : "\u{1F534} Detection only";
-      console.log(`   \u2022 ${det.service.name} (${tierBadge})`);
-      console.log(`     Detected via: ${det.details.join(", ")}`);
-    }
-    console.log("");
-  }
-  console.log("\u{1F517} Registering Claude Code hooks...\n");
+  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");
-  console.log("Next steps:");
-  console.log("  1. Add API keys for LIVE tracking:");
-  console.log("     burnwatch add anthropic --key $ANTHROPIC_ADMIN_KEY --budget 100");
-  console.log("  2. Set budgets for detected services:");
-  console.log("     burnwatch add scrapfly --key $SCRAPFLY_KEY --budget 50");
-  console.log("  3. Check your spend:");
-  console.log("     burnwatch status\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");
 }
 async function cmdAdd() {
   const projectRoot = process.cwd();
@@ -1045,7 +1249,8 @@ function cmdHelp() {
 burnwatch \u2014 Passive cost memory for vibe coding
 
 Usage:
-  burnwatch init                              Initialize in current project
+  burnwatch init                              Interactive setup \u2014 pick plans per service
+  burnwatch init --non-interactive            Auto-detect services, no prompts
   burnwatch setup                             Init + auto-configure all detected services
   burnwatch add <service> [options]           Register a service for tracking
   burnwatch status                            Show current spend brief
@@ -1060,6 +1265,7 @@ Options for 'add':
 
 Examples:
   burnwatch init
+  burnwatch init --non-interactive
   burnwatch add anthropic --key sk-ant-admin-xxx --budget 100
   burnwatch add scrapfly --key scp-xxx --budget 50
   burnwatch add posthog --plan-cost 0 --budget 0