burnwatch 0.4.0 → 0.4.2

package/CHANGELOG.md

@@ -5,6 +5,14 @@ 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.2] - 2026-03-24
+
+### Fixed
+
+- **Init is re-runnable**: `burnwatch init` no longer early-returns on already-initialized projects. Re-running init re-detects services and walks through interactive setup again, so users who initialized before v0.4.0 can configure budgets without manually running `burnwatch add` 14 times.
+- **Budget prompt fires for all services**: Budget prompt was gated inside the `requiresKey` block - services without API key requirements never got asked. Now every non-excluded service gets a budget prompt during interactive init.
+- **Untracked message is actionable**: Changed circular "run burnwatch status" message to "run burnwatch init to configure" so users know what to do next.
+
 ## [0.4.0] - 2026-03-24
 
 ### Added
@@ -43,5 +51,6 @@ 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.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
 [0.1.0]: https://github.com/RaleighSF/burnwatch/releases/tag/v0.1.0

package/README.md

@@ -12,24 +12,24 @@
 
 <br>
 
-burnwatch detects every paid service in your project, tracks what you're spending, and injects budget context directly into your AI coding sessions — so the agent knows what things cost before it recommends burning more money.
+burnwatch detects every paid service in your project, tracks what you're spending, and injects budget context directly into your AI coding sessions - so the agent knows what things cost before it recommends burning more money.
 
 ```
-╔══════════════════════════════════════════════════════════════╗
-║  BURNWATCH — hullscore — March 2026                          ║
-╠══════════════════════════════════════════════════════════════╣
-║  Service        Spend       Conf    Budget  Left             ║
-║  ──────────────────────────────────────────────────────────  ║
-║  Anthropic      $47.20      ✅ LIVE  $100    53%             ║
-║  Vercel         $23.00      ✅ LIVE  $50     54%             ║
-║  Scrapfly       $127.00     ✅ LIVE  $50     ⚠️ OVR          ║
-║  Browserbase    ~$63.00     🟠 EST   $75     16%             ║
-║  Supabase       $25.00      ✅ LIVE  $100    75%             ║
-║  PostHog        ~$49.00     🟡 CALC  $49     0%              ║
-╠══════════════════════════════════════════════════════════════╣
-║  TOTAL: ~$334.20   Untracked: 0 ✅   Est margin: ±$20       ║
-║  🚨  SCRAPFLY 254% OVER BUDGET — review before use          ║
-╚══════════════════════════════════════════════════════════════╝
+╔══════════════════════════════════════════════════════════════
+║  BURNWATCH - your-app - March 2026
+╠══════════════════════════════════════════════════════════════
+║  Service        Spend       Conf      Budget  Left
+║  ──────────────────────────────────────────────────────────
+║  Anthropic      $47.20      ✅ LIVE    $100    53%
+║  Vercel         $23.00      ✅ LIVE    $50     54%
+║  Scrapfly       $127.00     ✅ LIVE    $50     ⚠️ OVR
+║  Browserbase    ~$63.00     🟠 EST     $75     16%
+║  Supabase       $25.00      ✅ LIVE    $100    75%
+║  PostHog        ~$49.00     🟡 CALC    $49     0%
+╠══════════════════════════════════════════════════════════════
+║  TOTAL: ~$334.20   Untracked: 0 ✅   Est margin: ±$20
+║  🚨 SCRAPFLY 254% OVER BUDGET - review before use
+╚══════════════════════════════════════════════════════════════
 ```
 
 This brief appears automatically at the start of every [Claude Code](https://claude.ai/code) session. You don't open a dashboard. You don't remember to check anything. You just see what you're spending.
@@ -38,7 +38,7 @@ This brief appears automatically at the start of every [Claude Code](https://cla
 
 ## Why
 
-Agentic development lets you ship 10x faster. It also lets you burn through $400 in Scrapfly credits, rack up unexpected Browserbase bills, and discover PostHog overages three weeks after the code that caused them was written — by an agent, in a session you barely remember.
+Agentic development lets you ship 10x faster. It also lets you burn through $400 in Scrapfly credits, rack up unexpected Browserbase bills, and discover PostHog overages three weeks after the code that caused them was written - by an agent, in a session you barely remember.
 
 **78% of IT leaders experienced unexpected charges** tied to consumption-based or AI pricing in the past 12 months ([Zylo 2026 SaaS Management Index](https://zylo.com/research/saas-management-index/)).
 
@@ -56,7 +56,7 @@ npx burnwatch init
 
 That's it. burnwatch scans your project, detects paid services, creates a `.burnwatch/` directory, and registers Claude Code hooks. Next time you start a session, you see your spend.
 
-> **Requirements:** Node.js 18+ &mdash; Zero dependencies &mdash; Works with or without Claude Code
+> **Requirements:** Node.js 18+ · Zero dependencies · Works with or without Claude Code
 
 <br>
 
@@ -91,12 +91,12 @@ npx burnwatch init
 ### 2. Add API keys and budgets
 
 ```bash
-# LIVE tracking — real billing API data
+# LIVE tracking - real billing API data
 burnwatch add anthropic --key $ANTHROPIC_ADMIN_KEY --budget 100
 burnwatch add scrapfly --key $SCRAPFLY_KEY --budget 50
 burnwatch add vercel --token $VERCEL_TOKEN --budget 50
 
-# CALC tracking — flat-rate services
+# CALC tracking - flat-rate services
 burnwatch add posthog --plan-cost 0 --budget 0
 burnwatch add inngest --plan-cost 25 --budget 25
 
@@ -119,13 +119,13 @@ Start a Claude Code session. The spend brief appears automatically. When you men
 ```
 You: "Use Scrapfly to scrape the competitor pricing pages"
 
-[BURNWATCH] scrapfly — current period
+[BURNWATCH] scrapfly - current period
   Spend: $127.00  |  Budget: $50  |  ⚠️ 254% over
   Confidence: ✅ LIVE
   ⚠️ 254% of budget consumed
 ```
 
-Claude factors this into its response — it might suggest Cheerio instead, or warn you before proceeding.
+Claude factors this into its response - it might suggest Cheerio instead, or warn you before proceeding.
 
 When a new paid service enters your project (new dependency, new env var, new import), burnwatch alerts immediately:
 
@@ -138,7 +138,7 @@ When a new paid service enters your project (new dependency, new env var, new im
 
 ## How It Works
 
-burnwatch runs as [Claude Code hooks](https://docs.anthropic.com/en/docs/claude-code/hooks) — background scripts that fire on session lifecycle events. It never proxies your traffic. It never intercepts API calls. It watches the exhaust of your sessions silently, completely, and without interrupting the work.
+burnwatch runs as [Claude Code hooks](https://docs.anthropic.com/en/docs/claude-code/hooks) - background scripts that fire on session lifecycle events. It never proxies your traffic. It never intercepts API calls. It watches the exhaust of your sessions silently, completely, and without interrupting the work.
 
 ### Four Detection Surfaces
 
@@ -172,18 +172,18 @@ If burnwatch can't track a service accurately, it says so. The ledger always sho
 
 ### The Ledger
 
-burnwatch writes `.burnwatch/spend-ledger.md` at the end of every session — human-readable, git-committable, designed to be read in 10 seconds:
+burnwatch writes `.burnwatch/spend-ledger.md` at the end of every session - human-readable, git-committable, designed to be read in 10 seconds:
 
 ```markdown
-# Burnwatch Ledger — hullscore
+# Burnwatch Ledger - your-app
 Last updated: 2026-03-24T14:32:11Z
 
 ## This Month (March 2026)
 | Service | Spend | Conf | Budget | Status |
 |---------|-------|------|--------|--------|
-| Anthropic | $47.20 | ✅ LIVE | $100 | 53% — healthy |
+| Anthropic | $47.20 | ✅ LIVE | $100 | 53% - healthy |
 | Scrapfly | $127.00 | ✅ LIVE | $50 | ⚠️ 254% over |
-| Vercel | $23.00 | ✅ LIVE | $50 | 54% — healthy |
+| Vercel | $23.00 | ✅ LIVE | $50 | 54% - healthy |
 
 ## TOTAL: ~$209.70 (±$2 estimated margin)
 ## Untracked services: 0
@@ -216,7 +216,7 @@ Last updated: 2026-03-24T14:32:11Z
 
 ## How the Agent Changes Behavior
 
-The real power isn't showing _you_ what you spent — it's telling _the agent_ what everything costs, in context, so cost becomes a factor in every recommendation.
+The real power isn't showing _you_ what you spent - it's telling _the agent_ what everything costs, in context, so cost becomes a factor in every recommendation.
 
 When Claude sees `Scrapfly: $127 / $50 budget, 254% over` in its context, it:
 
@@ -281,7 +281,7 @@ burnwatch doesn't need to run in every session. It takes snapshots when present
 burnwatch reconcile
 ```
 
-Re-scans your project for services introduced in sessions where burnwatch wasn't active. For billing APIs that expose cumulative usage (like Scrapfly's credit counter), it computes the delta between snapshots — attributing spend across the gap.
+Re-scans your project for services introduced in sessions where burnwatch wasn't active. For billing APIs that expose cumulative usage (like Scrapfly's credit counter), it computes the delta between snapshots - attributing spend across the gap.
 
 <br>
 
@@ -304,7 +304,7 @@ Re-scans your project for services introduced in sessions where burnwatch wasn't
 }
 ```
 
-The `gotchas` and `alternatives` fields aren't just metadata — the agent reads them and uses them to make better recommendations. Every PR that adds a service makes burnwatch smarter for every user.
+The `gotchas` and `alternatives` fields aren't just metadata - the agent reads them and uses them to make better recommendations. Every PR that adds a service makes burnwatch smarter for every user.
 
 <br>
 

package/dist/cli.js

@@ -661,7 +661,7 @@ function buildBrief(projectName, snapshots, blindCount) {
     alerts.push({
       serviceId: "_blind",
       type: "blind_service",
-      message: `${blindCount} service${blindCount > 1 ? "s" : ""} detected but untracked \u2014 run 'burnwatch status' to see`,
+      message: `${blindCount} service${blindCount > 1 ? "s" : ""} detected but untracked - run 'burnwatch init' to configure`,
       severity: "warning"
     });
   }
@@ -897,10 +897,12 @@ ${RISK_LABELS[category]}`);
         planName: chosen.name
       };
       if (chosen.type === "flat" && chosen.monthlyBase !== void 0) {
-        tracked.budget = chosen.monthlyBase;
         tracked.planCost = chosen.monthlyBase;
+        if (chosen.monthlyBase > 0) {
+          tracked.budget = chosen.monthlyBase;
+        }
       }
-      if (chosen.requiresKey) {
+      if (service.apiTier === "live" || chosen.requiresKey) {
         const existingKey = globalConfig.services[service.id]?.apiKey;
         if (existingKey) {
           console.log(`  \u{1F510} Using existing API key from global config`);
@@ -913,7 +915,7 @@ ${RISK_LABELS[category]}`);
               tracked.planName = planName;
             }
           }
-        } else {
+        } else if (chosen.requiresKey) {
           const keyAnswer = await ask(
             rl,
             `  Enter API key (or press Enter to skip): `
@@ -934,16 +936,17 @@ ${RISK_LABELS[category]}`);
             }
           }
         }
-        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;
-            }
+      }
+      if (tracked.budget === void 0 || tracked.budget === 0) {
+        const suggestion = chosen.monthlyBase && chosen.monthlyBase > 0 ? ` [${chosen.monthlyBase}]` : "";
+        const budgetAnswer = await ask(
+          rl,
+          `  Monthly budget in USD${suggestion} (or press Enter to skip): $`
+        );
+        if (budgetAnswer) {
+          const budget = parseFloat(budgetAnswer);
+          if (!isNaN(budget)) {
+            tracked.budget = budget;
           }
         }
       }
@@ -1004,11 +1007,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`);
-    return;
-  }
+  const alreadyInitialized = isInitialized(projectRoot);
   let projectName = path5.basename(projectRoot);
   try {
     const pkgPath = path5.join(projectRoot, "package.json");
@@ -1019,10 +1018,11 @@ async function cmdInit() {
   ensureProjectDirs(projectRoot);
   console.log("\u{1F50D} Scanning project for paid services...\n");
   const detected = detectServices(projectRoot);
+  const existingConfig = alreadyInitialized ? readProjectConfig(projectRoot) : null;
   const config = {
-    projectName,
-    services: {},
-    createdAt: (/* @__PURE__ */ new Date()).toISOString(),
+    projectName: existingConfig?.projectName ?? projectName,
+    services: existingConfig?.services ?? {},
+    createdAt: existingConfig?.createdAt ?? (/* @__PURE__ */ new Date()).toISOString(),
     updatedAt: (/* @__PURE__ */ new Date()).toISOString()
   };
   if (!nonInteractive && detected.length > 0 && process.stdin.isTTY) {
@@ -1030,13 +1030,15 @@ async function cmdInit() {
     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 (!config.services[det.service.id]) {
+        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.");
@@ -1193,11 +1195,11 @@ async function cmdStatus() {
   if (blindCount > 0) {
     console.log(`\u26A0\uFE0F  ${blindCount} service${blindCount > 1 ? "s" : ""} untracked:`);
     for (const snap of snapshots.filter((s) => s.tier === "blind")) {
-      console.log(
-        `   \u2022 ${snap.serviceId} \u2014 run 'burnwatch add ${snap.serviceId} --key YOUR_KEY --budget N'`
-      );
+      console.log(`   \u2022 ${snap.serviceId}`);
     }
-    console.log("");
+    console.log(`
+   Run 'burnwatch init' to configure budgets and API keys.
+`);
   }
 }
 function cmdServices() {