burnwatch 0.3.0 → 0.4.0

package/dist/cost-impact.js

@@ -0,0 +1,281 @@
+// src/core/registry.ts
+import * as fs from "fs";
+import * as path from "path";
+import * as url from "url";
+var __dirname = path.dirname(url.fileURLToPath(import.meta.url));
+var cachedRegistry = null;
+function loadRegistry(projectRoot) {
+  if (cachedRegistry) return cachedRegistry;
+  const registry = /* @__PURE__ */ new Map();
+  const candidates = [
+    path.resolve(__dirname, "../../registry.json"),
+    // from src/core/
+    path.resolve(__dirname, "../registry.json")
+    // from dist/
+  ];
+  for (const candidate of candidates) {
+    if (fs.existsSync(candidate)) {
+      loadRegistryFile(candidate, registry);
+      break;
+    }
+  }
+  if (projectRoot) {
+    const localPath = path.join(projectRoot, ".burnwatch", "registry.json");
+    if (fs.existsSync(localPath)) {
+      loadRegistryFile(localPath, registry);
+    }
+  }
+  cachedRegistry = registry;
+  return registry;
+}
+function loadRegistryFile(filePath, registry) {
+  try {
+    const raw = fs.readFileSync(filePath, "utf-8");
+    const data = JSON.parse(raw);
+    for (const [id, service] of Object.entries(data.services)) {
+      registry.set(id, { ...service, id });
+    }
+  } catch {
+  }
+}
+
+// src/cost-impact.ts
+var SERVICE_CALL_PATTERNS = {
+  anthropic: [
+    /\.messages\.create\s*\(/g,
+    /\.completions\.create\s*\(/g,
+    /anthropic\.\w+\.create\s*\(/g
+  ],
+  openai: [
+    /\.chat\.completions\.create\s*\(/g,
+    /\.completions\.create\s*\(/g,
+    /\.images\.generate\s*\(/g,
+    /\.embeddings\.create\s*\(/g,
+    /openai\.\w+\.create\s*\(/g
+  ],
+  "google-gemini": [
+    /\.generateContent\s*\(/g,
+    /\.generateContentStream\s*\(/g,
+    /model\.generate\w*\s*\(/g
+  ],
+  "voyage-ai": [
+    /\.embed\s*\(/g,
+    /voyageai\.embed\s*\(/g
+  ],
+  scrapfly: [
+    /\.scrape\s*\(/g,
+    /scrapfly\.scrape\s*\(/g,
+    /\.async_scrape\s*\(/g,
+    /ScrapeConfig\s*\(/g
+  ],
+  browserbase: [
+    /\.createSession\s*\(/g,
+    /\.sessions\.create\s*\(/g,
+    /stagehand\.act\s*\(/g,
+    /stagehand\.extract\s*\(/g
+  ],
+  upstash: [
+    /redis\.\w+\s*\(/g,
+    /\.set\s*\(/g,
+    /\.get\s*\(/g,
+    /\.incr\s*\(/g,
+    /\.hset\s*\(/g
+  ],
+  resend: [
+    /resend\.emails\.send\s*\(/g,
+    /\.emails\.send\s*\(/g
+  ],
+  stripe: [
+    /stripe\.charges\.create\s*\(/g,
+    /stripe\.paymentIntents\.create\s*\(/g,
+    /stripe\.checkout\.sessions\.create\s*\(/g
+  ],
+  supabase: [
+    /supabase\.from\s*\(/g,
+    /\.rpc\s*\(/g,
+    /supabase\.storage/g
+  ],
+  inngest: [
+    /inngest\.send\s*\(/g,
+    /\.createFunction\s*\(/g
+  ],
+  posthog: [
+    /posthog\.capture\s*\(/g,
+    /\.capture\s*\(/g
+  ],
+  aws: [
+    /\.send\s*\(new\s+\w+Command/g,
+    /s3Client\.send\s*\(/g,
+    /lambdaClient\.send\s*\(/g
+  ]
+};
+function detectMultipliers(content) {
+  const multipliers = [];
+  if (/for\s*\(.*;\s*\w+\s*<\s*(\w+)/g.test(content)) {
+    const loopMatch = content.match(/for\s*\(.*;\s*\w+\s*<\s*(\d+)/);
+    if (loopMatch) {
+      const bound = parseInt(loopMatch[1]);
+      if (bound > 1) {
+        multipliers.push({ label: `for loop (${bound} iterations)`, factor: bound });
+      }
+    } else {
+      multipliers.push({ label: "for loop (variable bound)", factor: 10 });
+    }
+  }
+  if (/\.\s*map\s*\(\s*(async\s*)?\(/g.test(content)) {
+    multipliers.push({ label: ".map() iteration", factor: 10 });
+  }
+  if (/\.\s*forEach\s*\(\s*(async\s*)?\(/g.test(content)) {
+    multipliers.push({ label: ".forEach() iteration", factor: 10 });
+  }
+  if (/for\s*\(\s*(const|let|var)\s+\w+\s+(of|in)\s+/g.test(content)) {
+    multipliers.push({ label: "for...of/in loop", factor: 10 });
+  }
+  if (/Promise\.all\s*\(/g.test(content)) {
+    multipliers.push({ label: "Promise.all (parallel batch)", factor: 10 });
+  }
+  if (/cron|schedule|interval|setInterval|every\s+\d+\s*(min|hour|day|sec)/gi.test(content)) {
+    if (/every\s+5\s*min/gi.test(content) || /\*\/5\s+\*\s+\*/g.test(content)) {
+      multipliers.push({ label: "cron: every 5 minutes", factor: 8640 });
+    } else if (/every\s+1?\s*hour/gi.test(content) || /0\s+\*\s+\*\s+\*/g.test(content)) {
+      multipliers.push({ label: "cron: hourly", factor: 720 });
+    } else if (/every\s+1?\s*day/gi.test(content) || /0\s+0\s+\*\s+\*/g.test(content)) {
+      multipliers.push({ label: "cron: daily", factor: 30 });
+    } else {
+      multipliers.push({ label: "scheduled execution", factor: 30 });
+    }
+  }
+  const batchMatch = content.match(/batch[_\s]?size\s*[=:]\s*(\d+)/i);
+  if (batchMatch) {
+    const batchSize = parseInt(batchMatch[1]);
+    if (batchSize > 1) {
+      multipliers.push({ label: `batch size: ${batchSize}`, factor: batchSize });
+    }
+  }
+  return multipliers;
+}
+var GOTCHA_MULTIPLIERS = {
+  scrapfly: {
+    low: 1,
+    high: 25,
+    explanation: "anti-bot bypass consumes 5-25x base credits"
+  },
+  browserbase: {
+    low: 1,
+    high: 5,
+    explanation: "session duration affects cost \u2014 long sessions burn more"
+  },
+  anthropic: {
+    low: 1,
+    high: 60,
+    explanation: "Haiku ~$0.25/MTok vs Opus ~$15/MTok (60x range)"
+  },
+  openai: {
+    low: 1,
+    high: 30,
+    explanation: "GPT-4 mini vs GPT-5 (30x cost range)"
+  },
+  stripe: {
+    low: 1,
+    high: 1.5,
+    explanation: "international cards add 1-1.5% extra"
+  }
+};
+function analyzeCostImpact(filePath, content, projectRoot) {
+  if (!/\.(ts|tsx|js|jsx|mjs|cjs)$/.test(filePath)) {
+    return [];
+  }
+  const registry = loadRegistry(projectRoot);
+  const impacts = [];
+  const multipliers = detectMultipliers(content);
+  for (const [serviceId, patterns] of Object.entries(SERVICE_CALL_PATTERNS)) {
+    let totalCalls = 0;
+    for (const pattern of patterns) {
+      pattern.lastIndex = 0;
+      const matches = content.match(pattern);
+      if (matches) {
+        totalCalls += matches.length;
+      }
+    }
+    if (totalCalls === 0) continue;
+    const service = registry.get(serviceId);
+    if (!service) continue;
+    const multiplierFactor = multipliers.length > 0 ? multipliers.reduce((max, m) => Math.max(max, m.factor), 1) : 1;
+    const baseMonthlyRuns = multipliers.some((m) => m.label.startsWith("cron")) ? 1 : 50;
+    const monthlyInvocations = totalCalls * multiplierFactor * baseMonthlyRuns;
+    const gotcha = GOTCHA_MULTIPLIERS[serviceId];
+    const unitRate = service.pricing?.unitRate ?? 0;
+    let costLow;
+    let costHigh;
+    if (unitRate > 0) {
+      costLow = monthlyInvocations * unitRate * (gotcha?.low ?? 1);
+      costHigh = monthlyInvocations * unitRate * (gotcha?.high ?? 1);
+    } else if (service.pricing?.monthlyBase !== void 0) {
+      costLow = 0;
+      costHigh = 0;
+    } else {
+      const typicalCallCosts = {
+        anthropic: 3e-3,
+        // ~$3/MTok * ~1K tokens average
+        openai: 2e-3,
+        "google-gemini": 1e-3,
+        scrapfly: 15e-5,
+        browserbase: 0.01,
+        resend: 1e-3,
+        stripe: 0.3
+      };
+      const perCall = typicalCallCosts[serviceId] ?? 1e-3;
+      costLow = monthlyInvocations * perCall * (gotcha?.low ?? 1);
+      costHigh = monthlyInvocations * perCall * (gotcha?.high ?? 1);
+    }
+    if (costLow === 0 && costHigh === 0) continue;
+    impacts.push({
+      serviceId,
+      serviceName: service.name,
+      filePath,
+      callCount: totalCalls,
+      multipliers: multipliers.map((m) => m.label),
+      multiplierFactor,
+      monthlyInvocations,
+      costLow,
+      costHigh,
+      rangeExplanation: gotcha?.explanation
+    });
+  }
+  return impacts;
+}
+function formatCostImpactCard(impacts, currentBudgets) {
+  const fileName = impacts[0]?.filePath.split("/").pop() ?? "unknown";
+  const lines = [];
+  lines.push(`[BURNWATCH] \u26A0\uFE0F Cost impact estimate for ${fileName}`);
+  for (const impact of impacts) {
+    const lowStr = impact.costLow < 1 ? `$${impact.costLow.toFixed(2)}` : `$${impact.costLow.toFixed(0)}`;
+    const highStr = impact.costHigh < 1 ? `$${impact.costHigh.toFixed(2)}` : `$${impact.costHigh.toFixed(0)}`;
+    const rangeStr = impact.costLow === impact.costHigh ? lowStr : `${lowStr}-${highStr}`;
+    lines.push(
+      `  ${impact.serviceName}: ~${impact.monthlyInvocations.toLocaleString()} calls/mo \u2192 ${rangeStr}/mo` + (impact.rangeExplanation ? ` (${impact.rangeExplanation})` : "")
+    );
+    const current = currentBudgets[impact.serviceId];
+    if (current) {
+      const budgetStr = current.budget ? `$${current.spend.toFixed(0)}/$${current.budget} budget` : `$${current.spend.toFixed(0)} (no budget set)`;
+      const pctStr = current.budget && current.budget > 0 ? ` (${(current.spend / current.budget * 100).toFixed(0)}%)` : "";
+      lines.push(`  Current: ${budgetStr}${pctStr}`);
+    }
+    const registry = loadRegistry();
+    const service = registry.get(impact.serviceId);
+    if (service?.alternatives && service.alternatives.length > 0 && impact.costHigh > 10) {
+      const freeAlts = service.alternatives.filter(
+        (a) => a.includes("free") || a.includes("cheerio") || a.includes("playwright") || a.includes("self-hosted")
+      );
+      if (freeAlts.length > 0) {
+        lines.push(`  Consider: ${freeAlts.join(", ")} for lower-cost alternative`);
+      }
+    }
+  }
+  return lines.join("\n");
+}
+export {
+  analyzeCostImpact,
+  formatCostImpactCard
+};
+//# sourceMappingURL=cost-impact.js.map

package/dist/cost-impact.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/registry.ts","../src/cost-impact.ts"],"sourcesContent":["import * as fs from \"node:fs\";\nimport * as path from \"node:path\";\nimport * as url from \"node:url\";\nimport type { ServiceDefinition } from \"./types.js\";\n\nconst __dirname = path.dirname(url.fileURLToPath(import.meta.url));\n\ninterface RegistryFile {\n  version: string;\n  lastUpdated: string;\n  services: Record<string, ServiceDefinition>;\n}\n\nlet cachedRegistry: Map<string, ServiceDefinition> | null = null;\n\n/**\n * Load the service registry.\n * Checks project-local override first, then falls back to bundled registry.\n */\nexport function loadRegistry(projectRoot?: string): Map<string, ServiceDefinition> {\n  if (cachedRegistry) return cachedRegistry;\n\n  const registry = new Map<string, ServiceDefinition>();\n\n  // Load bundled registry (shipped with package)\n  // Try multiple possible locations — depends on whether running from src/ or dist/\n  const candidates = [\n    path.resolve(__dirname, \"../../registry.json\"),  // from src/core/\n    path.resolve(__dirname, \"../registry.json\"),      // from dist/\n  ];\n  for (const candidate of candidates) {\n    if (fs.existsSync(candidate)) {\n      loadRegistryFile(candidate, registry);\n      break;\n    }\n  }\n\n  // Load project-local override (if exists)\n  if (projectRoot) {\n    const localPath = path.join(projectRoot, \".burnwatch\", \"registry.json\");\n    if (fs.existsSync(localPath)) {\n      loadRegistryFile(localPath, registry);\n    }\n  }\n\n  cachedRegistry = registry;\n  return registry;\n}\n\nfunction loadRegistryFile(\n  filePath: string,\n  registry: Map<string, ServiceDefinition>,\n): void {\n  try {\n    const raw = fs.readFileSync(filePath, \"utf-8\");\n    const data = JSON.parse(raw) as RegistryFile;\n    for (const [id, service] of Object.entries(data.services)) {\n      registry.set(id, { ...service, id });\n    }\n  } catch {\n    // Silently skip missing or malformed registry files\n  }\n}\n\n/** Clear the cached registry (for testing). */\nexport function clearRegistryCache(): void {\n  cachedRegistry = null;\n}\n\n/** Get a single service definition by ID. */\nexport function getService(\n  id: string,\n  projectRoot?: string,\n): ServiceDefinition | undefined {\n  return loadRegistry(projectRoot).get(id);\n}\n\n/** Get all service definitions. */\nexport function getAllServices(\n  projectRoot?: string,\n): ServiceDefinition[] {\n  return Array.from(loadRegistry(projectRoot).values());\n}\n","/**\n * Predictive cost impact analysis.\n *\n * Scans file content for SDK call sites, detects multipliers (loops, .map(), etc.),\n * and projects monthly cost using registry pricing data.\n */\n\nimport type {\n  CostImpact,\n  ServiceDefinition,\n} from \"./core/types.js\";\nimport { loadRegistry } from \"./core/registry.js\";\n\n/** SDK call patterns per service — maps serviceId to regex patterns for call sites */\nconst SERVICE_CALL_PATTERNS: Record<string, RegExp[]> = {\n  anthropic: [\n    /\\.messages\\.create\\s*\\(/g,\n    /\\.completions\\.create\\s*\\(/g,\n    /anthropic\\.\\w+\\.create\\s*\\(/g,\n  ],\n  openai: [\n    /\\.chat\\.completions\\.create\\s*\\(/g,\n    /\\.completions\\.create\\s*\\(/g,\n    /\\.images\\.generate\\s*\\(/g,\n    /\\.embeddings\\.create\\s*\\(/g,\n    /openai\\.\\w+\\.create\\s*\\(/g,\n  ],\n  \"google-gemini\": [\n    /\\.generateContent\\s*\\(/g,\n    /\\.generateContentStream\\s*\\(/g,\n    /model\\.generate\\w*\\s*\\(/g,\n  ],\n  \"voyage-ai\": [\n    /\\.embed\\s*\\(/g,\n    /voyageai\\.embed\\s*\\(/g,\n  ],\n  scrapfly: [\n    /\\.scrape\\s*\\(/g,\n    /scrapfly\\.scrape\\s*\\(/g,\n    /\\.async_scrape\\s*\\(/g,\n    /ScrapeConfig\\s*\\(/g,\n  ],\n  browserbase: [\n    /\\.createSession\\s*\\(/g,\n    /\\.sessions\\.create\\s*\\(/g,\n    /stagehand\\.act\\s*\\(/g,\n    /stagehand\\.extract\\s*\\(/g,\n  ],\n  upstash: [\n    /redis\\.\\w+\\s*\\(/g,\n    /\\.set\\s*\\(/g,\n    /\\.get\\s*\\(/g,\n    /\\.incr\\s*\\(/g,\n    /\\.hset\\s*\\(/g,\n  ],\n  resend: [\n    /resend\\.emails\\.send\\s*\\(/g,\n    /\\.emails\\.send\\s*\\(/g,\n  ],\n  stripe: [\n    /stripe\\.charges\\.create\\s*\\(/g,\n    /stripe\\.paymentIntents\\.create\\s*\\(/g,\n    /stripe\\.checkout\\.sessions\\.create\\s*\\(/g,\n  ],\n  supabase: [\n    /supabase\\.from\\s*\\(/g,\n    /\\.rpc\\s*\\(/g,\n    /supabase\\.storage/g,\n  ],\n  inngest: [\n    /inngest\\.send\\s*\\(/g,\n    /\\.createFunction\\s*\\(/g,\n  ],\n  posthog: [\n    /posthog\\.capture\\s*\\(/g,\n    /\\.capture\\s*\\(/g,\n  ],\n  aws: [\n    /\\.send\\s*\\(new\\s+\\w+Command/g,\n    /s3Client\\.send\\s*\\(/g,\n    /lambdaClient\\.send\\s*\\(/g,\n  ],\n};\n\n/** Multiplier patterns — things that make calls happen more than once */\ninterface MultiplierMatch {\n  label: string;\n  factor: number;\n}\n\nfunction detectMultipliers(content: string): MultiplierMatch[] {\n  const multipliers: MultiplierMatch[] = [];\n\n  // for loops — assume 10x as conservative estimate\n  if (/for\\s*\\(.*;\\s*\\w+\\s*<\\s*(\\w+)/g.test(content)) {\n    // Try to extract the loop bound\n    const loopMatch = content.match(/for\\s*\\(.*;\\s*\\w+\\s*<\\s*(\\d+)/);\n    if (loopMatch) {\n      const bound = parseInt(loopMatch[1]!);\n      if (bound > 1) {\n        multipliers.push({ label: `for loop (${bound} iterations)`, factor: bound });\n      }\n    } else {\n      multipliers.push({ label: \"for loop (variable bound)\", factor: 10 });\n    }\n  }\n\n  // .map() calls\n  if (/\\.\\s*map\\s*\\(\\s*(async\\s*)?\\(/g.test(content)) {\n    multipliers.push({ label: \".map() iteration\", factor: 10 });\n  }\n\n  // .forEach() calls\n  if (/\\.\\s*forEach\\s*\\(\\s*(async\\s*)?\\(/g.test(content)) {\n    multipliers.push({ label: \".forEach() iteration\", factor: 10 });\n  }\n\n  // for...of / for...in\n  if (/for\\s*\\(\\s*(const|let|var)\\s+\\w+\\s+(of|in)\\s+/g.test(content)) {\n    multipliers.push({ label: \"for...of/in loop\", factor: 10 });\n  }\n\n  // Promise.all with array\n  if (/Promise\\.all\\s*\\(/g.test(content)) {\n    multipliers.push({ label: \"Promise.all (parallel batch)\", factor: 10 });\n  }\n\n  // Cron patterns in comments or configuration\n  if (/cron|schedule|interval|setInterval|every\\s+\\d+\\s*(min|hour|day|sec)/gi.test(content)) {\n    // Estimate: if hourly = 720/mo, daily = 30/mo, every 5 min = 8640/mo\n    if (/every\\s+5\\s*min/gi.test(content) || /\\*\\/5\\s+\\*\\s+\\*/g.test(content)) {\n      multipliers.push({ label: \"cron: every 5 minutes\", factor: 8640 });\n    } else if (/every\\s+1?\\s*hour/gi.test(content) || /0\\s+\\*\\s+\\*\\s+\\*/g.test(content)) {\n      multipliers.push({ label: \"cron: hourly\", factor: 720 });\n    } else if (/every\\s+1?\\s*day/gi.test(content) || /0\\s+0\\s+\\*\\s+\\*/g.test(content)) {\n      multipliers.push({ label: \"cron: daily\", factor: 30 });\n    } else {\n      multipliers.push({ label: \"scheduled execution\", factor: 30 });\n    }\n  }\n\n  // Batch size hints\n  const batchMatch = content.match(/batch[_\\s]?size\\s*[=:]\\s*(\\d+)/i);\n  if (batchMatch) {\n    const batchSize = parseInt(batchMatch[1]!);\n    if (batchSize > 1) {\n      multipliers.push({ label: `batch size: ${batchSize}`, factor: batchSize });\n    }\n  }\n\n  return multipliers;\n}\n\n/** Gotcha-based cost multipliers per service */\nconst GOTCHA_MULTIPLIERS: Record<string, { low: number; high: number; explanation: string }> = {\n  scrapfly: {\n    low: 1,\n    high: 25,\n    explanation: \"anti-bot bypass consumes 5-25x base credits\",\n  },\n  browserbase: {\n    low: 1,\n    high: 5,\n    explanation: \"session duration affects cost — long sessions burn more\",\n  },\n  anthropic: {\n    low: 1,\n    high: 60,\n    explanation: \"Haiku ~$0.25/MTok vs Opus ~$15/MTok (60x range)\",\n  },\n  openai: {\n    low: 1,\n    high: 30,\n    explanation: \"GPT-4 mini vs GPT-5 (30x cost range)\",\n  },\n  stripe: {\n    low: 1,\n    high: 1.5,\n    explanation: \"international cards add 1-1.5% extra\",\n  },\n};\n\n/**\n * Analyze a file's content for cost-impacting SDK calls.\n * Returns cost impact estimates for each detected service.\n */\nexport function analyzeCostImpact(\n  filePath: string,\n  content: string,\n  projectRoot?: string,\n): CostImpact[] {\n  // Only analyze source files\n  if (!/\\.(ts|tsx|js|jsx|mjs|cjs)$/.test(filePath)) {\n    return [];\n  }\n\n  const registry = loadRegistry(projectRoot);\n  const impacts: CostImpact[] = [];\n  const multipliers = detectMultipliers(content);\n\n  for (const [serviceId, patterns] of Object.entries(SERVICE_CALL_PATTERNS)) {\n    let totalCalls = 0;\n\n    for (const pattern of patterns) {\n      // Reset lastIndex for global regexes\n      pattern.lastIndex = 0;\n      const matches = content.match(pattern);\n      if (matches) {\n        totalCalls += matches.length;\n      }\n    }\n\n    if (totalCalls === 0) continue;\n\n    const service = registry.get(serviceId);\n    if (!service) continue;\n\n    // Calculate effective multiplier\n    const multiplierFactor = multipliers.length > 0\n      ? multipliers.reduce((max, m) => Math.max(max, m.factor), 1)\n      : 1;\n\n    // Assume ~30 working days, ~8 dev hours/day as baseline for monthly projections\n    // If no cron detected, assume the code runs during dev sessions: ~50 times/month\n    const baseMonthlyRuns = multipliers.some((m) => m.label.startsWith(\"cron\"))\n      ? 1 // cron multiplier already encodes frequency\n      : 50; // ~2 dev runs per working day\n\n    const monthlyInvocations = totalCalls * multiplierFactor * baseMonthlyRuns;\n\n    // Get cost estimates\n    const gotcha = GOTCHA_MULTIPLIERS[serviceId];\n    const unitRate = service.pricing?.unitRate ?? 0;\n\n    let costLow: number;\n    let costHigh: number;\n\n    if (unitRate > 0) {\n      costLow = monthlyInvocations * unitRate * (gotcha?.low ?? 1);\n      costHigh = monthlyInvocations * unitRate * (gotcha?.high ?? 1);\n    } else if (service.pricing?.monthlyBase !== undefined) {\n      // Flat-rate services — cost is the plan, not per-invocation\n      costLow = 0;\n      costHigh = 0;\n    } else {\n      // Estimate based on typical per-call costs\n      const typicalCallCosts: Record<string, number> = {\n        anthropic: 0.003, // ~$3/MTok * ~1K tokens average\n        openai: 0.002,\n        \"google-gemini\": 0.001,\n        scrapfly: 0.00015,\n        browserbase: 0.01,\n        resend: 0.001,\n        stripe: 0.30,\n      };\n      const perCall = typicalCallCosts[serviceId] ?? 0.001;\n      costLow = monthlyInvocations * perCall * (gotcha?.low ?? 1);\n      costHigh = monthlyInvocations * perCall * (gotcha?.high ?? 1);\n    }\n\n    // Skip if no meaningful cost\n    if (costLow === 0 && costHigh === 0) continue;\n\n    impacts.push({\n      serviceId,\n      serviceName: service.name,\n      filePath,\n      callCount: totalCalls,\n      multipliers: multipliers.map((m) => m.label),\n      multiplierFactor,\n      monthlyInvocations,\n      costLow,\n      costHigh,\n      rangeExplanation: gotcha?.explanation,\n    });\n  }\n\n  return impacts;\n}\n\n/**\n * Format a cost impact card for injection into Claude's context.\n */\nexport function formatCostImpactCard(\n  impacts: CostImpact[],\n  currentBudgets: Record<string, { spend: number; budget?: number }>,\n): string {\n  const fileName = impacts[0]?.filePath.split(\"/\").pop() ?? \"unknown\";\n  const lines: string[] = [];\n\n  lines.push(`[BURNWATCH] ⚠️ Cost impact estimate for ${fileName}`);\n\n  for (const impact of impacts) {\n    const lowStr = impact.costLow < 1\n      ? `$${impact.costLow.toFixed(2)}`\n      : `$${impact.costLow.toFixed(0)}`;\n    const highStr = impact.costHigh < 1\n      ? `$${impact.costHigh.toFixed(2)}`\n      : `$${impact.costHigh.toFixed(0)}`;\n\n    const rangeStr = impact.costLow === impact.costHigh\n      ? lowStr\n      : `${lowStr}-${highStr}`;\n\n    lines.push(\n      `  ${impact.serviceName}: ~${impact.monthlyInvocations.toLocaleString()} calls/mo → ${rangeStr}/mo` +\n        (impact.rangeExplanation ? ` (${impact.rangeExplanation})` : \"\"),\n    );\n\n    // Show current budget status if available\n    const current = currentBudgets[impact.serviceId];\n    if (current) {\n      const budgetStr = current.budget\n        ? `$${current.spend.toFixed(0)}/$${current.budget} budget`\n        : `$${current.spend.toFixed(0)} (no budget set)`;\n      const pctStr = current.budget && current.budget > 0\n        ? ` (${((current.spend / current.budget) * 100).toFixed(0)}%)`\n        : \"\";\n      lines.push(`  Current: ${budgetStr}${pctStr}`);\n    }\n\n    // Suggest alternatives from registry\n    const registry = loadRegistry();\n    const service = registry.get(impact.serviceId);\n    if (service?.alternatives && service.alternatives.length > 0 && impact.costHigh > 10) {\n      const freeAlts = service.alternatives.filter(\n        (a) => a.includes(\"free\") || a.includes(\"cheerio\") || a.includes(\"playwright\") || a.includes(\"self-hosted\"),\n      );\n      if (freeAlts.length > 0) {\n        lines.push(`  Consider: ${freeAlts.join(\", \")} for lower-cost alternative`);\n      }\n    }\n  }\n\n  return lines.join(\"\\n\");\n}\n"],"mappings":"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","names":[]}

package/dist/detector-C4LnLT-O.d.ts

@@ -0,0 +1,28 @@
+import { S as ServiceDefinition, D as DetectionSource } from './types-fDMu4rOd.js';
+
+interface DetectionResult {
+    service: ServiceDefinition;
+    sources: DetectionSource[];
+    details: string[];
+}
+/**
+ * Run all detection surfaces against the current project.
+ * Returns services detected via any combination of:
+ * - package.json dependencies (recursive — finds monorepo subdirectories)
+ * - environment variable patterns (process.env + .env* files recursive)
+ * - import statement scanning (recursive from project root)
+ * - (prompt mention scanning is handled separately in hooks)
+ */
+declare function detectServices(projectRoot: string): DetectionResult[];
+/**
+ * Detect services mentioned in a prompt string.
+ * Used by the UserPromptSubmit hook.
+ */
+declare function detectMentions(prompt: string, projectRoot?: string): DetectionResult[];
+/**
+ * Detect new services introduced in a file change.
+ * Used by the PostToolUse hook for Write/Edit events.
+ */
+declare function detectInFileChange(filePath: string, content: string, projectRoot?: string): DetectionResult[];
+
+export { type DetectionResult as D, detectMentions as a, detectServices as b, detectInFileChange as d };