burnwatch 0.10.1 → 0.12.0

package/CHANGELOG.md

@@ -5,6 +5,65 @@ 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.12.0] - 2026-03-25
+
+### Added
+
+- **10 new services in registry** (14 → 24): Firebase, Cloudflare, Neon Postgres, MongoDB Atlas, Twilio, SendGrid, Sentry, Clerk, DeepSeek, Replicate. All with plans, pricing, gotchas, detection patterns, and cost-impact SDK call patterns.
+- **EST tier activated**: BLIND services with accumulated cost-impact data from file change analysis are now upgraded to EST tier in the spend brief. Uses the midpoint of projected cost range. The EST tier was defined since v0.1.0 but never produced — now it is.
+- **Connector and probe tests**: 20 new tests with mocked HTTP covering all 6 billing connectors and 9 service probes. Total test count: 40 → 60.
+- **Registry cache invalidation**: The registry cache now tracks file mtime and auto-invalidates when `registry.json` is modified. Prevents stale data in long-running processes (MCP server).
+- **Community contribution guide**: Rewrote `CONTRIBUTING.md` with tiered contribution path — registry-only (5 min, JSON), billing connector (30 min, TypeScript), and probe (plan auto-detection). Documented `.burnwatch/registry.json` project-local override for custom services.
+
+### Fixed
+
+- **Registry `apiTier` reconciled with actual connectors**: `browserbase` changed from `"est"` to `"live"` (has a working connector). `stripe` changed from `"live"` to `"calc"` (no billing connector — only has a probe for balance checking, not Stripe's fees to you).
+- **MCP server version**: Was hardcoded at `"0.1.2"` since initial release. Now reads dynamically from `package.json`.
+
+### Changed
+
+- Cost-impact SDK call patterns added for Firebase, Twilio, SendGrid, MongoDB, Clerk, and Replicate.
+
+## [0.11.0] - 2026-03-25
+
+### Fixed
+
+- **CALC services showed ~$0.00 in session brief**: Session-start hook was passing raw `planCost` as spend instead of projecting based on day of month. Now correctly calculates `(planCost / daysInMonth) * dayOfMonth`.
+- **envKeysFound always empty**: `.env` file scanning only ran conditionally. Now always scans `.env`, `.env.local`, `.env.development` on disk and populates `envKeysFound` regardless of global key status.
+- **Box-drawing characters render poorly in agent/IDE contexts**: Added `formatBriefMarkdown()` using markdown tables. Session-start hook now uses markdown format.
+- **Excluded services showing as BLIND in brief**: Added `filter(s => s.tier !== "excluded")` to brief display.
+- **`configure --key` silent when LIVE not possible**: Now returns `tierNote` explaining why a key didn't enable LIVE tracking (e.g., no billing connector for that service).
+
+### Added
+
+- **`burnwatch reset` command**: Removes `.burnwatch/`, skills from `.claude/skills/`, and hooks from `.claude/settings.json`. Preserves global API keys in `~/.config/burnwatch/`.
+- **Interview JSON enrichment**: `hasConnector`, `canGoLive`, `envKeysFound[]`, `suggestedAction`, and `instructions{}` fields guide agent behavior during the interview.
+
+## [0.10.0] - 2026-03-25
+
+### Added
+
+- **Supabase billing connector**: Uses Management API via Personal Access Token (PAT). Detects plan tier (free/pro/team), maps to monthly cost, and checks usage endpoint for overages.
+- **Browserbase billing connector**: Uses projects/usage API to track session count and browser minutes. Estimates spend from minutes × rate.
+
+### Changed
+
+- **Interview skill rewritten**: Complete rewrite of `/burnwatch-interview` SKILL.md. Now leads with API key discovery from `.env` files BEFORE asking questions. Enforces one-service-at-a-time pacing. Includes smart inference (e.g., `gpt-4o-mini` → low budget suggestion). Budget philosophy: LIVE → track actual + alert threshold; CALC → budget = plan cost; BLIND → safety net budget.
+- **BLIND services no longer show $0.00**: Shows "—" instead of "$0.00" to avoid false confidence. Status label says "needs API key" instead of "no budget".
+- **Brief footer says "No billing data: N"** instead of "Untracked: N" — because services ARE configured with budgets, they just lack billing API access.
+- **`pollService` returns explicit error context** when LIVE fails instead of silently falling through to CALC/BLIND.
+
+## [0.9.0] - 2026-03-25
+
+### Added
+
+- **Skill auto-installation during init**: `registerHooks()` now copies `/burnwatch-interview`, `/setup-burnwatch`, and `/spend` skills to `.claude/skills/` so agents can discover them.
+- **Non-TTY init suggests `/burnwatch-interview`**: When running in an agent context, init output recommends the conversational interview skill instead of manual CLI commands.
+
+### Changed
+
+- **Terminology update**: All references to "vibe coding" changed to "AI-assisted development" across package description, README, llms.txt, and source files.
+
 ## [0.8.0] - 2026-03-25
 
 ### Added
@@ -133,6 +192,10 @@ 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.12.0]: https://github.com/RaleighSF/burnwatch/compare/v0.11.0...v0.12.0
+[0.11.0]: https://github.com/RaleighSF/burnwatch/compare/v0.10.0...v0.11.0
+[0.10.0]: https://github.com/RaleighSF/burnwatch/compare/v0.9.0...v0.10.0
+[0.9.0]: https://github.com/RaleighSF/burnwatch/compare/v0.8.0...v0.9.0
 [0.8.0]: https://github.com/RaleighSF/burnwatch/compare/v0.7.0...v0.8.0
 [0.7.0]: https://github.com/RaleighSF/burnwatch/compare/v0.6.0...v0.7.0
 [0.6.0]: https://github.com/RaleighSF/burnwatch/compare/v0.5.2...v0.6.0

package/dist/cli.js

@@ -363,9 +363,22 @@ import * as path2 from "path";
 import * as url from "url";
 var __dirname = path2.dirname(url.fileURLToPath(import.meta.url));
 var cachedRegistry = null;
+var cachedRegistryPath = null;
+var cachedRegistryMtime = null;
 function loadRegistry(projectRoot) {
+  if (cachedRegistry && cachedRegistryPath && cachedRegistryMtime !== null) {
+    try {
+      const stat = fs2.statSync(cachedRegistryPath);
+      if (stat.mtimeMs !== cachedRegistryMtime) {
+        cachedRegistry = null;
+      }
+    } catch {
+      cachedRegistry = null;
+    }
+  }
   if (cachedRegistry) return cachedRegistry;
   const registry = /* @__PURE__ */ new Map();
+  let resolvedPath = null;
   const candidates = [
     path2.resolve(__dirname, "../../registry.json"),
     // from src/core/
@@ -375,6 +388,7 @@ function loadRegistry(projectRoot) {
   for (const candidate of candidates) {
     if (fs2.existsSync(candidate)) {
       loadRegistryFile(candidate, registry);
+      resolvedPath = candidate;
       break;
     }
   }
@@ -382,9 +396,19 @@ function loadRegistry(projectRoot) {
     const localPath = path2.join(projectRoot, ".burnwatch", "registry.json");
     if (fs2.existsSync(localPath)) {
       loadRegistryFile(localPath, registry);
+      resolvedPath = localPath;
     }
   }
   cachedRegistry = registry;
+  if (resolvedPath) {
+    try {
+      cachedRegistryPath = resolvedPath;
+      cachedRegistryMtime = fs2.statSync(resolvedPath).mtimeMs;
+    } catch {
+      cachedRegistryPath = null;
+      cachedRegistryMtime = null;
+    }
+  }
   return registry;
 }
 function loadRegistryFile(filePath, registry) {
@@ -925,9 +949,37 @@ async function pollService(tracked) {
         serviceConfig
       );
       if (!result.error) return result;
-    } catch {
+      return {
+        serviceId: tracked.serviceId,
+        spend: tracked.planCost ?? 0,
+        isEstimate: true,
+        tier: tracked.planCost !== void 0 ? "calc" : "blind",
+        error: `LIVE failed (${result.error}) \u2014 showing ${tracked.planCost !== void 0 ? "CALC" : "BLIND"} fallback`
+      };
+    } catch (err) {
+      return {
+        serviceId: tracked.serviceId,
+        spend: tracked.planCost ?? 0,
+        isEstimate: true,
+        tier: tracked.planCost !== void 0 ? "calc" : "blind",
+        error: `LIVE failed (${err instanceof Error ? err.message : "unknown"}) \u2014 showing ${tracked.planCost !== void 0 ? "CALC" : "BLIND"} fallback`
+      };
     }
   }
+  if (connector && tracked.hasApiKey && !serviceConfig?.apiKey) {
+    const projectedSpend = tracked.planCost !== void 0 ? (() => {
+      const now = /* @__PURE__ */ new Date();
+      const daysInMonth = new Date(now.getFullYear(), now.getMonth() + 1, 0).getDate();
+      return tracked.planCost / daysInMonth * now.getDate();
+    })() : 0;
+    return {
+      serviceId: tracked.serviceId,
+      spend: projectedSpend,
+      isEstimate: true,
+      tier: tracked.planCost !== void 0 ? "calc" : "blind",
+      error: "API key marked as configured but not found in ~/.config/burnwatch/ \u2014 re-run configure with --key"
+    };
+  }
   if (tracked.planCost !== void 0) {
     const now = /* @__PURE__ */ new Date();
     const daysInMonth = new Date(
@@ -999,7 +1051,7 @@ function formatBrief(brief) {
     formatRow("Service", "Spend", "Conf", "Budget", "Left", width)
   );
   lines.push(`\u2551  ${hrSingle}  \u2551`);
-  for (const svc of brief.services) {
+  for (const svc of brief.services.filter((s) => s.tier !== "excluded")) {
     const spendStr = svc.tier === "blind" && svc.spend === 0 ? "\u2014" : svc.isEstimate ? `~$${svc.spend.toFixed(2)}` : `$${svc.spend.toFixed(2)}`;
     const badge = CONFIDENCE_BADGES[svc.tier];
     const budgetStr = svc.budget ? `$${svc.budget}` : "\u2014";
@@ -1568,6 +1620,9 @@ async function main() {
     case "configure":
       await cmdConfigure();
       break;
+    case "reset":
+      cmdReset();
+      break;
     case "help":
     case "--help":
     case "-h":
@@ -1693,37 +1748,32 @@ async function cmdInterview() {
     let keySource = null;
     const envKeysFound = [];
     const globalKey = globalConfig.services[serviceId]?.apiKey;
-    if (globalKey) {
-      keySource = "global_config";
-    } else {
-      for (const pattern of definition.envPatterns) {
-        if (process.env[pattern]) {
-          keySource = `env:${pattern}`;
-          envKeysFound.push(pattern);
-          break;
-        }
+    for (const pattern of definition.envPatterns) {
+      if (process.env[pattern]) {
+        envKeysFound.push(pattern);
+        if (!keySource && !globalKey) keySource = `env:${pattern}`;
       }
-      if (!keySource) {
-        const envFiles = [".env", ".env.local", ".env.development"];
-        for (const envFile of envFiles) {
-          try {
-            const envPath = path5.join(projectRoot, envFile);
-            const envContent = fs5.readFileSync(envPath, "utf-8");
-            for (const pattern of definition.envPatterns) {
-              const regex = new RegExp(`^${pattern}=(.+)$`, "m");
-              const match = envContent.match(regex);
-              if (match?.[1]) {
-                keySource = `file:${envFile}:${pattern}`;
-                envKeysFound.push(`${pattern} (in ${envFile})`);
-                break;
-              }
+    }
+    const envFiles = [".env", ".env.local", ".env.development"];
+    for (const envFile of envFiles) {
+      try {
+        const envPath = path5.join(projectRoot, envFile);
+        const envContent = fs5.readFileSync(envPath, "utf-8");
+        for (const pattern of definition.envPatterns) {
+          const regex = new RegExp(`^${pattern}=(.+)$`, "m");
+          const match = envContent.match(regex);
+          if (match?.[1]) {
+            const label = `${pattern} (in ${envFile})`;
+            if (!envKeysFound.some((k) => k.startsWith(pattern))) {
+              envKeysFound.push(label);
             }
-            if (keySource) break;
-          } catch {
+            if (!keySource && !globalKey) keySource = `file:${envFile}:${pattern}`;
           }
         }
+      } catch {
       }
     }
+    if (globalKey) keySource = "global_config";
     let apiKey = globalKey;
     if (!apiKey && keySource?.startsWith("env:")) {
       apiKey = process.env[keySource.slice(4)];
@@ -2132,6 +2182,47 @@ async function cmdReconcile() {
   }
   console.log("");
 }
+function cmdReset() {
+  const projectRoot = process.cwd();
+  const burnwatchDir = path5.join(projectRoot, ".burnwatch");
+  const claudeSkillsDir = path5.join(projectRoot, ".claude", "skills");
+  if (!fs5.existsSync(burnwatchDir)) {
+    console.log("burnwatch is not initialized in this project.");
+    return;
+  }
+  fs5.rmSync(burnwatchDir, { recursive: true, force: true });
+  console.log(`\u{1F5D1}\uFE0F  Removed ${burnwatchDir}`);
+  const skillNames = ["setup-burnwatch", "burnwatch-interview", "spend"];
+  for (const skill of skillNames) {
+    const skillDir = path5.join(claudeSkillsDir, skill);
+    if (fs5.existsSync(skillDir)) {
+      fs5.rmSync(skillDir, { recursive: true, force: true });
+    }
+  }
+  console.log("\u{1F5D1}\uFE0F  Removed burnwatch skills from .claude/skills/");
+  const settingsPath = path5.join(projectRoot, ".claude", "settings.json");
+  if (fs5.existsSync(settingsPath)) {
+    try {
+      const settings = JSON.parse(fs5.readFileSync(settingsPath, "utf-8"));
+      const hooks = settings["hooks"];
+      if (hooks) {
+        for (const [event, hookList] of Object.entries(hooks)) {
+          hooks[event] = hookList.filter(
+            (h) => !h.hooks?.some((inner) => inner.command?.includes("burnwatch"))
+          );
+          if (hooks[event].length === 0) delete hooks[event];
+        }
+        if (Object.keys(hooks).length === 0) delete settings["hooks"];
+        fs5.writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + "\n", "utf-8");
+        console.log("\u{1F5D1}\uFE0F  Removed burnwatch hooks from .claude/settings.json");
+      }
+    } catch {
+      console.log("\u26A0\uFE0F  Could not clean .claude/settings.json \u2014 remove burnwatch hooks manually");
+    }
+  }
+  console.log("\n\u2705 burnwatch fully reset. Global API keys in ~/.config/burnwatch/ were preserved.");
+  console.log("   Run 'burnwatch init' to set up again.\n");
+}
 function cmdHelp() {
   console.log(`
 burnwatch \u2014 Passive cost memory for AI-assisted development
@@ -2146,6 +2237,7 @@ Usage:
   burnwatch reconcile                         Scan for untracked services
   burnwatch interview --json                  Export state for agent-driven interview
   burnwatch configure --service <id> [opts]   Agent writes back interview answers
+  burnwatch reset                             Remove all burnwatch config from this project
 
 Options for 'configure':
   --service <ID>         Service to configure (required)