Changes

cli/eventdash-debug.mjs

@@ -0,0 +1,122 @@
+#!/usr/bin/env node
+// EventDash Branch Debug CLI
+//
+// Usage (from your repo root, in the VS Code terminal):
+//   node ./cli/eventdash-debug.mjs "API throws 500 on /checkout for Amex cards"
+//   node ./cli/eventdash-debug.mjs --base origin/main "describe the failure here"
+//   node ./cli/eventdash-debug.mjs --editor cursor "..."
+//
+// Flags:
+//   --base <ref>     Diff base. Default: auto-detects merge-base with origin/main, falls back to HEAD~1.
+//   --editor <id>    vscode | cursor. Default: vscode.
+//   --endpoint <url> Override API endpoint.
+//
+// Reads LOVABLE_ENDPOINT from env if --endpoint is not passed.
+
+import { execSync } from "node:child_process";
+import { resolve } from "node:path";
+
+const DEFAULT_ENDPOINT =
+  process.env.LOVABLE_ENDPOINT ||
+  "https://project--bff39f15-1e2d-4d34-8f4b-7070bac6dbae.lovable.app/api/public/branch-debug";
+
+const args = process.argv.slice(2);
+const opts = { base: null, editor: "vscode", endpoint: DEFAULT_ENDPOINT };
+const positional = [];
+for (let i = 0; i < args.length; i++) {
+  const a = args[i];
+  if (a === "--base") opts.base = args[++i];
+  else if (a === "--editor") opts.editor = args[++i];
+  else if (a === "--endpoint") opts.endpoint = args[++i];
+  else if (a === "-h" || a === "--help") {
+    console.log("Usage: node cli/eventdash-debug.mjs [--base <ref>] [--editor vscode|cursor] [--endpoint <url>] \"failure description\"");
+    process.exit(0);
+  } else positional.push(a);
+}
+
+const failureDescription = positional.join(" ").trim();
+if (!failureDescription) {
+  console.error("✗ Provide a failure description as an argument.");
+  console.error('  e.g. node cli/eventdash-debug.mjs "Checkout 500s on Amex cards after deploy"');
+  process.exit(1);
+}
+
+function sh(cmd) {
+  return execSync(cmd, { encoding: "utf8", maxBuffer: 50 * 1024 * 1024 }).trim();
+}
+
+let repoRoot;
+let branch;
+try {
+  repoRoot = sh("git rev-parse --show-toplevel");
+  branch = sh("git rev-parse --abbrev-ref HEAD");
+} catch {
+  console.error("✗ Not inside a git repo. Run this from your project root.");
+  process.exit(1);
+}
+
+// Determine base ref
+let base = opts.base;
+if (!base) {
+  for (const candidate of ["origin/main", "origin/master", "main", "master"]) {
+    try {
+      base = sh(`git merge-base HEAD ${candidate}`);
+      break;
+    } catch { /* try next */ }
+  }
+  if (!base) base = "HEAD~1";
+}
+
+console.log(`▸ Repo:    ${repoRoot}`);
+console.log(`▸ Branch:  ${branch}`);
+console.log(`▸ Base:    ${base}`);
+console.log(`▸ Failure: ${failureDescription}\n`);
+
+let diff;
+try {
+  diff = sh(`git diff ${base}...HEAD`);
+} catch (e) {
+  console.error("✗ git diff failed:", e.message);
+  process.exit(1);
+}
+
+if (!diff) {
+  console.error("✗ Empty diff. Nothing changed between base and HEAD.");
+  process.exit(1);
+}
+
+console.log(`▸ Sending ${(diff.length / 1024).toFixed(1)} KB diff to ${opts.endpoint} ...\n`);
+
+const res = await fetch(opts.endpoint, {
+  method: "POST",
+  headers: { "Content-Type": "application/json" },
+  body: JSON.stringify({ diff, failureDescription, repoRoot, editor: opts.editor }),
+});
+
+if (!res.ok) {
+  const text = await res.text();
+  console.error(`✗ API error ${res.status}: ${text}`);
+  process.exit(1);
+}
+
+const data = await res.json();
+const { summary, suspects, sanitizationStats } = data;
+
+const C = { dim: "\x1b[2m", reset: "\x1b[0m", bold: "\x1b[1m", high: "\x1b[31m", med: "\x1b[33m", low: "\x1b[36m", link: "\x1b[34m" };
+const tag = (c) => ({ high: C.high, medium: C.med, low: C.low }[c] || "");
+
+console.log(`${C.bold}Summary${C.reset}\n  ${summary}\n`);
+console.log(`${C.dim}IP Shield: ${sanitizationStats.identifiersTokenized} identifiers tokenized · ${sanitizationStats.commentsStripped} comments stripped · ${sanitizationStats.secretsBlocked} secrets blocked${C.reset}\n`);
+
+if (!suspects?.length) {
+  console.log("No suspects returned.");
+  process.exit(0);
+}
+
+suspects.forEach((s, i) => {
+  const jump = s.jumpUrl || `${opts.editor}://file/${resolve(repoRoot, s.filePath)}:${s.lineStart}`;
+  console.log(`${tag(s.confidence)}${C.bold}[${i + 1}] ${s.confidence.toUpperCase()}${C.reset}  ${s.filePath}:${s.lineStart}-${s.lineEnd}${s.functionName ? `  ${C.dim}(${s.functionName})${C.reset}` : ""}`);
+  console.log(`    ${C.bold}${s.changeSummary}${C.reset}`);
+  console.log(`    ${s.mechanism}`);
+  console.log(`    ${C.link}${jump}${C.reset}  ${C.dim}← ⌘-click to open in ${opts.editor === "cursor" ? "Cursor" : "VS Code"}${C.reset}\n`);
+});

src/routeTree.gen.ts

@@ -17,6 +17,7 @@ import { Route as DashboardReportsRouteImport } from './routes/dashboard.reports
 import { Route as DashboardComplianceRouteImport } from './routes/dashboard.compliance'
 import { Route as DashboardCoachingRouteImport } from './routes/dashboard.coaching'
 import { Route as DashboardBranchDebugRouteImport } from './routes/dashboard.branch-debug'
+import { Route as ApiPublicBranchDebugRouteImport } from './routes/api/public/branch-debug'
 
 const DashboardRoute = DashboardRouteImport.update({
   id: '/dashboard',
@@ -58,6 +59,11 @@ const DashboardBranchDebugRoute = DashboardBranchDebugRouteImport.update({
   path: '/branch-debug',
   getParentRoute: () => DashboardRoute,
 } as any)
+const ApiPublicBranchDebugRoute = ApiPublicBranchDebugRouteImport.update({
+  id: '/api/public/branch-debug',
+  path: '/api/public/branch-debug',
+  getParentRoute: () => rootRouteImport,
+} as any)
 
 export interface FileRoutesByFullPath {
   '/': typeof IndexRoute
@@ -68,6 +74,7 @@ export interface FileRoutesByFullPath {
   '/dashboard/compliance': typeof DashboardComplianceRoute
   '/dashboard/reports': typeof DashboardReportsRoute
   '/dashboard/': typeof DashboardIndexRoute
+  '/api/public/branch-debug': typeof ApiPublicBranchDebugRoute
 }
 export interface FileRoutesByTo {
   '/': typeof IndexRoute
@@ -77,6 +84,7 @@ export interface FileRoutesByTo {
   '/dashboard/compliance': typeof DashboardComplianceRoute
   '/dashboard/reports': typeof DashboardReportsRoute
   '/dashboard': typeof DashboardIndexRoute
+  '/api/public/branch-debug': typeof ApiPublicBranchDebugRoute
 }
 export interface FileRoutesById {
   __root__: typeof rootRouteImport
@@ -88,6 +96,7 @@ export interface FileRoutesById {
   '/dashboard/compliance': typeof DashboardComplianceRoute
   '/dashboard/reports': typeof DashboardReportsRoute
   '/dashboard/': typeof DashboardIndexRoute
+  '/api/public/branch-debug': typeof ApiPublicBranchDebugRoute
 }
 export interface FileRouteTypes {
   fileRoutesByFullPath: FileRoutesByFullPath
@@ -100,6 +109,7 @@ export interface FileRouteTypes {
     | '/dashboard/compliance'
     | '/dashboard/reports'
     | '/dashboard/'
+    | '/api/public/branch-debug'
   fileRoutesByTo: FileRoutesByTo
   to:
     | '/'
@@ -109,6 +119,7 @@ export interface FileRouteTypes {
     | '/dashboard/compliance'
     | '/dashboard/reports'
     | '/dashboard'
+    | '/api/public/branch-debug'
   id:
     | '__root__'
     | '/'
@@ -119,12 +130,14 @@ export interface FileRouteTypes {
     | '/dashboard/compliance'
     | '/dashboard/reports'
     | '/dashboard/'
+    | '/api/public/branch-debug'
   fileRoutesById: FileRoutesById
 }
 export interface RootRouteChildren {
   IndexRoute: typeof IndexRoute
   AuthRoute: typeof AuthRoute
   DashboardRoute: typeof DashboardRouteWithChildren
+  ApiPublicBranchDebugRoute: typeof ApiPublicBranchDebugRoute
 }
 
 declare module '@tanstack/react-router' {
@@ -185,6 +198,13 @@ declare module '@tanstack/react-router' {
       preLoaderRoute: typeof DashboardBranchDebugRouteImport
       parentRoute: typeof DashboardRoute
     }
+    '/api/public/branch-debug': {
+      id: '/api/public/branch-debug'
+      path: '/api/public/branch-debug'
+      fullPath: '/api/public/branch-debug'
+      preLoaderRoute: typeof ApiPublicBranchDebugRouteImport
+      parentRoute: typeof rootRouteImport
+    }
   }
 }
 
@@ -212,6 +232,7 @@ const rootRouteChildren: RootRouteChildren = {
   IndexRoute: IndexRoute,
   AuthRoute: AuthRoute,
   DashboardRoute: DashboardRouteWithChildren,
+  ApiPublicBranchDebugRoute: ApiPublicBranchDebugRoute,
 }
 export const routeTree = rootRouteImport
   ._addFileChildren(rootRouteChildren)