brakit 0.10.1 → 0.10.2

package/dist/bin/brakit.js

@@ -10,7 +10,7 @@ var __export = (target, all) => {
 };
 
 // src/constants/config.ts
-var PROJECT_HASH_LENGTH, SECRET_SCAN_ARRAY_LIMIT, PII_SCAN_ARRAY_LIMIT, MIN_SECRET_VALUE_LENGTH, FULL_RECORD_MIN_FIELDS, LIST_PII_MIN_ITEMS, MAX_OBJECT_SCAN_DEPTH, ISSUE_PRUNE_TTL_MS, OVERFETCH_UNWRAP_MIN_SIZE, STALE_ISSUE_TTL_MS, METRICS_DIR, PORT_FILE, VALID_ISSUE_STATES, VALID_AI_FIX_STATUSES, VALID_SECURITY_SEVERITIES, TELEMETRY_EVENT_CLI_INVOKED, TELEMETRY_EVENT_CLI_UNINSTALL, DETAIL_PREVIEW_LENGTH;
+var PROJECT_HASH_LENGTH, SECRET_SCAN_ARRAY_LIMIT, PII_SCAN_ARRAY_LIMIT, MIN_SECRET_VALUE_LENGTH, FULL_RECORD_MIN_FIELDS, LIST_PII_MIN_ITEMS, MAX_OBJECT_SCAN_DEPTH, ISSUE_PRUNE_TTL_MS, OVERFETCH_UNWRAP_MIN_SIZE, STALE_ISSUE_TTL_MS, METRICS_DIR, PORT_FILE, VALID_ISSUE_STATES, VALID_AI_FIX_STATUSES, VALID_SECURITY_SEVERITIES, DETAIL_PREVIEW_LENGTH;
 var init_config = __esm({
   "src/constants/config.ts"() {
     "use strict";
@@ -29,8 +29,6 @@ var init_config = __esm({
     VALID_ISSUE_STATES = /* @__PURE__ */ new Set(["open", "fixing", "resolved", "stale", "regressed"]);
     VALID_AI_FIX_STATUSES = /* @__PURE__ */ new Set(["fixed", "wont_fix"]);
     VALID_SECURITY_SEVERITIES = /* @__PURE__ */ new Set(["critical", "warning"]);
-    TELEMETRY_EVENT_CLI_INVOKED = "cli_invoked";
-    TELEMETRY_EVENT_CLI_UNINSTALL = "cli_uninstall";
     DETAIL_PREVIEW_LENGTH = 120;
   }
 });
@@ -72,8 +70,91 @@ var init_type_guards = __esm({
   }
 });
 
+// src/constants/detection.ts
+var KNOWN_DEPENDENCY_NAMES, KNOWN_DEPENDENCY_SET;
+var init_detection = __esm({
+  "src/constants/detection.ts"() {
+    "use strict";
+    KNOWN_DEPENDENCY_NAMES = [
+      // -- Frameworks (meta) --
+      "next",
+      "@remix-run/dev",
+      "nuxt",
+      "astro",
+      // -- Frameworks (backend) --
+      "@nestjs/core",
+      "@adonisjs/core",
+      "sails",
+      "express",
+      "fastify",
+      "hono",
+      "koa",
+      "@hapi/hapi",
+      "elysia",
+      "h3",
+      "nitro",
+      "@trpc/server",
+      // -- Bundlers --
+      "vite",
+      // -- ORM / query builders --
+      "prisma",
+      "@prisma/client",
+      "drizzle-orm",
+      "typeorm",
+      "sequelize",
+      "mongoose",
+      "kysely",
+      "knex",
+      "@mikro-orm/core",
+      "objection",
+      // -- DB drivers --
+      "pg",
+      "mysql2",
+      "mongodb",
+      "better-sqlite3",
+      "@libsql/client",
+      "@planetscale/database",
+      "ioredis",
+      "redis",
+      // -- Auth --
+      "lucia",
+      "next-auth",
+      "@auth/core",
+      "passport",
+      // -- Queues / messaging --
+      "bullmq",
+      "amqplib",
+      "kafkajs",
+      // -- Validation --
+      "zod",
+      "joi",
+      "yup",
+      "arktype",
+      "valibot",
+      // -- HTTP clients --
+      "axios",
+      "got",
+      "ky",
+      "undici",
+      // -- Realtime --
+      "socket.io",
+      "ws",
+      // -- CSS / styling --
+      "tailwindcss",
+      // -- Testing --
+      "vitest",
+      "jest",
+      "mocha",
+      // -- Runtime indicators --
+      "bun-types",
+      "@types/bun"
+    ];
+    KNOWN_DEPENDENCY_SET = new Set(KNOWN_DEPENDENCY_NAMES);
+  }
+});
+
 // src/constants/labels.ts
-var DASHBOARD_PREFIX, DASHBOARD_API_REQUESTS, DASHBOARD_API_EVENTS, DASHBOARD_API_FLOWS, DASHBOARD_API_CLEAR, DASHBOARD_API_LOGS, DASHBOARD_API_FETCHES, DASHBOARD_API_ERRORS, DASHBOARD_API_QUERIES, DASHBOARD_API_INGEST, DASHBOARD_API_METRICS, DASHBOARD_API_ACTIVITY, DASHBOARD_API_METRICS_LIVE, DASHBOARD_API_INSIGHTS, DASHBOARD_API_SECURITY, DASHBOARD_API_TAB, DASHBOARD_API_FINDINGS, DASHBOARD_API_FINDINGS_REPORT, DASHBOARD_API_GRAPH, VALID_TABS_TUPLE, VALID_TABS, POSTHOG_HOST, POSTHOG_CAPTURE_PATH, POSTHOG_REQUEST_TIMEOUT_MS;
+var DASHBOARD_PREFIX, DASHBOARD_API_REQUESTS, DASHBOARD_API_EVENTS, DASHBOARD_API_FLOWS, DASHBOARD_API_CLEAR, DASHBOARD_API_LOGS, DASHBOARD_API_FETCHES, DASHBOARD_API_ERRORS, DASHBOARD_API_QUERIES, DASHBOARD_API_INGEST, DASHBOARD_API_METRICS, DASHBOARD_API_ACTIVITY, DASHBOARD_API_METRICS_LIVE, DASHBOARD_API_INSIGHTS, DASHBOARD_API_SECURITY, DASHBOARD_API_TAB, DASHBOARD_API_FINDINGS, DASHBOARD_API_FINDINGS_REPORT, DASHBOARD_API_GRAPH, VALID_TABS_TUPLE, VALID_TABS;
 var init_labels = __esm({
   "src/constants/labels.ts"() {
     "use strict";
@@ -105,9 +186,6 @@ var init_labels = __esm({
       "explorer"
     ];
     VALID_TABS = new Set(VALID_TABS_TUPLE);
-    POSTHOG_HOST = "https://us.i.posthog.com";
-    POSTHOG_CAPTURE_PATH = "/i/v0/e/";
-    POSTHOG_REQUEST_TIMEOUT_MS = 3e3;
   }
 });
 
@@ -136,7 +214,7 @@ var init_features = __esm({
     MAX_TIMELINE_EVENTS = 20;
     MAX_RESOLVED_DISPLAY = 5;
     ENRICHMENT_SEVERITY_FILTER = ["critical", "warning"];
-    MCP_SERVER_VERSION = "0.10.1";
+    MCP_SERVER_VERSION = "0.10.2";
     RECOVERY_WINDOW_MS = 5 * 60 * 1e3;
     PORT_MIN = 1;
     PORT_MAX = 65535;
@@ -145,13 +223,32 @@ var init_features = __esm({
   }
 });
 
+// src/constants/telemetry.ts
+var POSTHOG_HOST, POSTHOG_CAPTURE_PATH, POSTHOG_REQUEST_TIMEOUT_MS, TELEMETRY_EVENT_CLI_INVOKED, TELEMETRY_EVENT_CLI_UNINSTALL, TELEMETRY_EVENT_DASHBOARD_VIEWED, TELEMETRY_EVENT_SESSION, TELEMETRY_SDK_NAME, SPEED_BUCKET_THRESHOLDS;
+var init_telemetry = __esm({
+  "src/constants/telemetry.ts"() {
+    "use strict";
+    POSTHOG_HOST = "https://us.i.posthog.com";
+    POSTHOG_CAPTURE_PATH = "/i/v0/e/";
+    POSTHOG_REQUEST_TIMEOUT_MS = 3e3;
+    TELEMETRY_EVENT_CLI_INVOKED = "cli_invoked";
+    TELEMETRY_EVENT_CLI_UNINSTALL = "cli_uninstall";
+    TELEMETRY_EVENT_DASHBOARD_VIEWED = "dashboard_viewed";
+    TELEMETRY_EVENT_SESSION = "session";
+    TELEMETRY_SDK_NAME = "node";
+    SPEED_BUCKET_THRESHOLDS = [200, 500, 1e3, 2e3, 5e3];
+  }
+});
+
 // src/constants/index.ts
 var init_constants = __esm({
   "src/constants/index.ts"() {
     "use strict";
     init_config();
+    init_detection();
     init_labels();
     init_features();
+    init_telemetry();
   }
 });
 
@@ -1206,6 +1303,7 @@ import { createHash as createHash2 } from "crypto";
 import { readFile as readFile3, readdir } from "fs/promises";
 import { existsSync as existsSync4 } from "fs";
 import { join as join2, relative } from "path";
+init_detection();
 var FRAMEWORKS = [
   // Meta-frameworks first (they bundle Express/Vite internally)
   { name: "nextjs", dep: "next", devCmd: "next dev", bin: "next", defaultPort: 3e3, devArgs: ["dev", "--port"] },
@@ -1234,23 +1332,22 @@ async function detectProject(rootDir) {
   const devCommand = matched?.devCmd ?? "";
   const devBin = matched ? join2(rootDir, "node_modules", ".bin", matched.bin) : "";
   const defaultPort = matched?.defaultPort ?? 3e3;
-  const packageManager = await detectPackageManager(rootDir);
+  const packageManager = detectPackageManager(rootDir);
   return { framework, devCommand, devBin, defaultPort, packageManager };
 }
-async function detectPackageManager(rootDir) {
-  if (await fileExists(join2(rootDir, "bun.lockb"))) return "bun";
-  if (await fileExists(join2(rootDir, "bun.lock"))) return "bun";
-  if (await fileExists(join2(rootDir, "pnpm-lock.yaml"))) return "pnpm";
-  if (await fileExists(join2(rootDir, "yarn.lock"))) return "yarn";
-  if (await fileExists(join2(rootDir, "package-lock.json"))) return "npm";
-  return "unknown";
-}
 function detectFrameworkFromDeps(allDeps) {
   for (const f of FRAMEWORKS) {
     if (allDeps[f.dep]) return f.name;
   }
   return "unknown";
 }
+function detectPackageManager(rootDir) {
+  if (existsSync4(join2(rootDir, "bun.lockb")) || existsSync4(join2(rootDir, "bun.lock"))) return "bun";
+  if (existsSync4(join2(rootDir, "pnpm-lock.yaml"))) return "pnpm";
+  if (existsSync4(join2(rootDir, "yarn.lock"))) return "yarn";
+  if (existsSync4(join2(rootDir, "package-lock.json"))) return "npm";
+  return "unknown";
+}
 var PYTHON_ENTRY_CANDIDATES = [
   "app.py",
   "main.py",
@@ -2005,7 +2102,7 @@ init_constants();
 init_endpoint();
 
 // src/index.ts
-var VERSION = "0.10.1";
+var VERSION = "0.10.2";
 
 // src/cli/commands/install.ts
 init_constants();
@@ -2346,10 +2443,6 @@ init_constants();
 init_log();
 init_type_guards();
 
-// src/telemetry/index.ts
-import { platform as platform2, release, arch } from "os";
-import { spawn } from "child_process";
-
 // src/telemetry/config.ts
 init_features();
 import { homedir as homedir2, platform } from "os";
@@ -2359,10 +2452,14 @@ import { randomUUID as randomUUID2 } from "crypto";
 var IS_WINDOWS = platform() === "win32";
 var CONFIG_DIR = join4(homedir2(), ".brakit");
 var CONFIG_PATH = join4(CONFIG_DIR, "config.json");
+function isValidTelemetryConfig(value) {
+  return typeof value === "object" && value !== null && typeof value.telemetry === "boolean" && typeof value.anonymousId === "string" && value.anonymousId.length > 0;
+}
 function readConfig() {
   try {
     if (!existsSync6(CONFIG_PATH)) return null;
-    return JSON.parse(readFileSync4(CONFIG_PATH, "utf-8"));
+    const parsed = JSON.parse(readFileSync4(CONFIG_PATH, "utf-8"));
+    return isValidTelemetryConfig(parsed) ? parsed : null;
   } catch {
     return null;
   }
@@ -2385,9 +2482,7 @@ function writeConfig(config) {
 }
 function getOrCreateConfig() {
   const existing = readConfig();
-  if (existing && typeof existing.telemetry === "boolean" && existing.anonymousId) {
-    return existing;
-  }
+  if (existing) return existing;
   const config = { telemetry: true, anonymousId: randomUUID2() };
   writeConfig(config);
   return config;
@@ -2397,16 +2492,19 @@ function isTelemetryEnabled() {
   if (cachedEnabled !== null) return cachedEnabled;
   const env = process.env.BRAKIT_TELEMETRY;
   if (env !== void 0) {
-    cachedEnabled = env !== "false" && env !== "0" && env !== "off";
+    const normalized = env.toLowerCase().trim();
+    cachedEnabled = normalized !== "false" && normalized !== "0" && normalized !== "off";
     return cachedEnabled;
   }
   cachedEnabled = readConfig()?.telemetry ?? true;
   return cachedEnabled;
 }
 
-// src/telemetry/index.ts
-init_labels();
-init_config();
+// src/telemetry/transport.ts
+import { platform as platform2, release, arch } from "os";
+import { spawn } from "child_process";
+init_telemetry();
+init_log();
 var POSTHOG_KEY = "phc_E9TwydCGnSfPLIUhNxChpeg32TSowjk31KiPhnLPP0x";
 function commonProperties() {
   return {
@@ -2420,7 +2518,7 @@ function commonProperties() {
   };
 }
 function sendToPosthog(event, properties) {
-  if (!isTelemetryEnabled()) return;
+  if (!isTelemetryEnabled() || !POSTHOG_KEY) return;
   const config = getOrCreateConfig();
   const payload = {
     api_key: POSTHOG_KEY,
@@ -2430,26 +2528,198 @@ function sendToPosthog(event, properties) {
     properties: { ...commonProperties(), ...properties }
   };
   try {
-    const body = JSON.stringify(payload);
+    const serializedPayload = JSON.stringify(payload);
     const url = `${POSTHOG_HOST}${POSTHOG_CAPTURE_PATH}`;
     const child = spawn(
       process.execPath,
       [
         "-e",
-        `fetch(${JSON.stringify(url)},{method:"POST",headers:{"content-type":"application/json"},body:${JSON.stringify(body)},signal:AbortSignal.timeout(${POSTHOG_REQUEST_TIMEOUT_MS})}).catch(()=>{})`
+        `fetch(${JSON.stringify(url)},{method:"POST",headers:{"content-type":"application/json"},body:${JSON.stringify(serializedPayload)},signal:AbortSignal.timeout(${POSTHOG_REQUEST_TIMEOUT_MS})}).catch(()=>{})`
       ],
       { detached: true, stdio: "ignore" }
     );
     child.unref();
-  } catch {
+  } catch (err) {
+    brakitDebug(`telemetry send failed: ${err}`);
   }
 }
 function trackEvent(event, properties) {
-  sendToPosthog(event, { sdk: "node", ...properties });
+  sendToPosthog(event, { sdk: TELEMETRY_SDK_NAME, ...properties });
 }
 
+// src/telemetry/session.ts
+init_telemetry();
+var defaultTransport = { send: sendToPosthog, track: trackEvent };
+var Session = class {
+  constructor(transport = defaultTransport) {
+    // ── Setup phase ──
+    this.startTime = 0;
+    this.framework = "unknown";
+    this.packageManager = "";
+    this.isCustomCommand = false;
+    this.adapters = [];
+    this.setupDurationMs = 0;
+    this.setupSucceeded = false;
+    // ── Detection ──
+    this.detectedDependencies = [];
+    this.adaptersFailed = [];
+    this.configFilesDetected = [];
+    this.jsRuntime = "node";
+    this.loadedPackages = [];
+    // ── Python SDK ──
+    this.pythonConnected = false;
+    this.pythonFramework = "unknown";
+    this.pythonAdapters = [];
+    this.pythonVersion = "";
+    // ── Runtime accumulation ──
+    this.requestCount = 0;
+    this.insightTypes = /* @__PURE__ */ new Set();
+    this.rulesTriggered = /* @__PURE__ */ new Set();
+    this.tabsViewed = /* @__PURE__ */ new Set();
+    this.dashboardOpened = false;
+    this.explainUsed = false;
+    this.firstRequestAt = 0;
+    this.dashboardOpenedAt = 0;
+    this.exitReason = "unknown";
+    this.transport = transport;
+  }
+  // ── Setup phase ──
+  init(framework, packageManager, isCustomCommand, adapters) {
+    getOrCreateConfig();
+    this.startTime = Date.now();
+    this.framework = framework;
+    this.packageManager = packageManager;
+    this.isCustomCommand = isCustomCommand;
+    this.adapters = adapters;
+  }
+  recordSetup(detection, durationMs) {
+    this.detectedDependencies = detection.detectedDependencies;
+    this.adaptersFailed = detection.adaptersFailed;
+    this.configFilesDetected = detection.configFilesDetected;
+    this.jsRuntime = detection.jsRuntime;
+    this.setupDurationMs = durationMs;
+    this.setupSucceeded = true;
+  }
+  // ── Runtime events ──
+  recordFirstRequest(loadedPackages) {
+    if (!this.firstRequestAt) this.firstRequestAt = Date.now();
+    this.loadedPackages = loadedPackages;
+  }
+  recordPythonStack(info) {
+    this.pythonConnected = true;
+    this.pythonFramework = info.framework;
+    this.pythonAdapters = info.adapters;
+    this.pythonVersion = info.pythonVersion;
+  }
+  recordDashboardOpened() {
+    if (this.dashboardOpened) return;
+    this.dashboardOpened = true;
+    this.dashboardOpenedAt = Date.now();
+    this.transport.track(TELEMETRY_EVENT_DASHBOARD_VIEWED, {
+      time_to_dashboard_ms: this.startTime > 0 ? Date.now() - this.startTime : null,
+      request_count_at_open: this.requestCount
+    });
+  }
+  recordTabViewed(tab) {
+    this.tabsViewed.add(tab);
+  }
+  recordExplainUsed() {
+    this.explainUsed = true;
+  }
+  recordExitReason(reason) {
+    if (this.exitReason === "unknown") this.exitReason = reason;
+  }
+  // ── Pre-flush snapshot from services ──
+  recordCounts(requestCount, insightTypes, rulesTriggered) {
+    this.requestCount = requestCount;
+    for (const t of insightTypes) this.insightTypes.add(t);
+    for (const r of rulesTriggered) this.rulesTriggered.add(r);
+  }
+  // ── Serialization ──
+  /** Build the full PostHog session payload. Single source of truth for all fields. */
+  toPostHogPayload(services) {
+    const metricsStore = services.metricsStore;
+    const analysisEngine = services.analysisEngine;
+    const live = metricsStore.getLiveEndpoints();
+    const insights = analysisEngine.getInsights();
+    const findings = analysisEngine.getFindings();
+    let totalRequests = 0;
+    let totalDuration = 0;
+    let slowestP95 = 0;
+    for (const ep of live) {
+      totalRequests += ep.summary.totalRequests;
+      totalDuration += ep.summary.p95Ms * ep.summary.totalRequests;
+      if (ep.summary.p95Ms > slowestP95) slowestP95 = ep.summary.p95Ms;
+    }
+    const now = Date.now();
+    return {
+      sdk: TELEMETRY_SDK_NAME,
+      // Stack detection
+      framework: this.framework,
+      package_manager: this.packageManager,
+      js_runtime: this.jsRuntime,
+      framework_detection_candidates: this.detectedDependencies,
+      config_files_detected: this.configFilesDetected,
+      loaded_packages: this.loadedPackages,
+      loaded_package_count: this.loadedPackages.length,
+      adapters_detected: this.adapters,
+      adapters_failed: this.adaptersFailed,
+      // Python SDK
+      python_connected: this.pythonConnected,
+      python_framework: this.pythonFramework,
+      python_adapters: this.pythonAdapters,
+      python_version: this.pythonVersion,
+      // Session metadata
+      is_custom_command: this.isCustomCommand,
+      first_session: readConfig() === null,
+      setup_succeeded: this.setupSucceeded,
+      setup_duration_ms: this.setupDurationMs,
+      session_duration_s: Math.ceil((now - this.startTime) / 1e3),
+      session_duration_ms: now - this.startTime,
+      exit_reason: this.exitReason,
+      // Usage
+      request_count: this.requestCount,
+      error_count: services.errorStore.getAll().length,
+      query_count: services.queryStore.getAll().length,
+      fetch_count: services.fetchStore.getAll().length,
+      endpoint_count: live.length,
+      avg_duration_ms: totalRequests > 0 ? Math.round(totalDuration / totalRequests) : 0,
+      slowest_endpoint_bucket: speedBucket(slowestP95),
+      // Analysis
+      insight_count: insights.length,
+      finding_count: findings.length,
+      insight_types: [...this.insightTypes],
+      rules_triggered: [...this.rulesTriggered],
+      // Dashboard engagement
+      tabs_viewed: [...this.tabsViewed],
+      dashboard_opened: this.dashboardOpened,
+      explain_used: this.explainUsed,
+      // Timing
+      time_to_first_request_ms: this.firstRequestAt ? this.firstRequestAt - this.startTime : null,
+      time_to_dashboard_ms: this.dashboardOpenedAt ? this.dashboardOpenedAt - this.startTime : null
+    };
+  }
+  flush(services) {
+    this.transport.send(TELEMETRY_EVENT_SESSION, this.toPostHogPayload(services));
+    getOrCreateConfig();
+  }
+};
+function speedBucket(ms) {
+  if (ms === 0) return "none";
+  const t = SPEED_BUCKET_THRESHOLDS;
+  if (ms < t[0]) return `<${t[0]}ms`;
+  for (let i = 1; i < t.length; i++) {
+    if (ms < t[i]) return `${t[i - 1]}-${t[i]}ms`;
+  }
+  return `>${t[t.length - 1]}ms`;
+}
+
+// src/telemetry/index.ts
+init_telemetry();
+var session = new Session();
+
 // src/cli/commands/uninstall.ts
-init_config();
+init_telemetry();
 var PREPENDED_FILES = [
   "app/entry.server.tsx",
   "app/entry.server.ts",
@@ -2708,7 +2978,7 @@ async function clearBuildCaches(rootDir) {
 }
 
 // bin/brakit.ts
-init_config();
+init_telemetry();
 var sub = process.argv[2];
 var command = sub === "uninstall" ? "uninstall" : sub === "mcp" ? "mcp" : "install";
 var cwd = process.cwd();