@spotlightjs/spotlight 4.8.0 → 4.9.0

package/dist/_virtual/_sentry-release-injection-file.js

@@ -2,10 +2,10 @@
 !function() {
   try {
     var e = "undefined" != typeof window ? window : "undefined" != typeof global ? global : "undefined" != typeof globalThis ? globalThis : "undefined" != typeof self ? self : {}, n = new e.Error().stack;
-    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "da89f43f-548b-4c7a-91bd-7dfef67bb0b0", e._sentryDebugIdIdentifier = "sentry-dbid-da89f43f-548b-4c7a-91bd-7dfef67bb0b0");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "fb85be00-a205-4b9b-9630-85057f3ff808", e._sentryDebugIdIdentifier = "sentry-dbid-fb85be00-a205-4b9b-9630-85057f3ff808");
   } catch (e2) {
   }
 }();
 var _global = typeof window !== "undefined" ? window : typeof global !== "undefined" ? global : typeof globalThis !== "undefined" ? globalThis : typeof self !== "undefined" ? self : {};
-_global.SENTRY_RELEASE = { id: "4.8.0" };
+_global.SENTRY_RELEASE = { id: "4.9.0" };
 //# sourceMappingURL=_sentry-release-injection-file.js.map

package/dist/sentry-config.js

@@ -2,7 +2,7 @@
 !function() {
   try {
     var e = "undefined" != typeof window ? window : "undefined" != typeof global ? global : "undefined" != typeof globalThis ? globalThis : "undefined" != typeof self ? self : {}, n = new e.Error().stack;
-    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "43a64e2f-af2a-47b2-9c2f-487e3524643e", e._sentryDebugIdIdentifier = "sentry-dbid-43a64e2f-af2a-47b2-9c2f-487e3524643e");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "e3629ce1-8dd0-44cf-b2aa-738f940e100e", e._sentryDebugIdIdentifier = "sentry-dbid-e3629ce1-8dd0-44cf-b2aa-738f940e100e");
   } catch (e2) {
   }
 }();
@@ -11,7 +11,7 @@ const isCI = process.env.CI === "true" || process.env.GITHUB_ACTIONS === "true";
 const sentryBaseConfig = {
   enabled: Boolean("production") && true,
   environment: isCI ? "github-ci" : "production",
-  release: `spotlight@${"4.8.0"}`,
+  release: `spotlight@${"4.9.0"}`,
   tracesSampleRate: 1,
   enableLogs: true
 };

package/dist/server/cli/help.d.ts

@@ -1 +1,2 @@
-export default function showHelp(): void;
+import { CLIHandlerOptions } from '../types/cli.ts';
+export default function showHelp({ cmdArgs }: CLIHandlerOptions): void;

package/dist/server/cli/help.js

@@ -2,24 +2,43 @@
 !function() {
   try {
     var e = "undefined" != typeof window ? window : "undefined" != typeof global ? global : "undefined" != typeof globalThis ? globalThis : "undefined" != typeof self ? self : {}, n = new e.Error().stack;
-    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "ef70cc6d-55c0-47d2-b634-1eb03deda3e3", e._sentryDebugIdIdentifier = "sentry-dbid-ef70cc6d-55c0-47d2-b634-1eb03deda3e3");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "d8378fd8-7267-4573-9c94-cf79105656bb", e._sentryDebugIdIdentifier = "sentry-dbid-d8378fd8-7267-4573-9c94-cf79105656bb");
   } catch (e2) {
   }
 }();
-import { EVERYTHING_MAGIC_WORDS, NAME_TO_TYPE_MAPPING } from "./tail.js";
+import { COMMANDS } from "../cli.js";
 import { AVAILABLE_FORMATTERS } from "../formatters/types.js";
 import "../../_virtual/_sentry-release-injection-file.js";
-function showHelp() {
+function showCommandHelp(commandName) {
+  const command = COMMANDS.find((c) => c.meta.name === commandName);
+  if (!command) {
+    return false;
+  }
+  const { meta } = command;
+  console.log(`
+${meta.name} - ${meta.short}
+
+Usage: ${meta.usage || `spotlight ${meta.name} [options]`}
+${meta.long ? `
+${meta.long}` : ""}
+${meta.examples && meta.examples.length > 0 ? `
+Examples:
+${meta.examples.map((ex) => `  ${ex}`).join("\n")}` : ""}
+`);
+  return true;
+}
+function showMainHelp() {
+  const commandsHelp = COMMANDS.map(({ meta }) => {
+    const name = meta.name.padEnd(20);
+    return `  ${name} ${meta.short}`;
+  }).join("\n");
   console.log(`
 Spotlight Sidecar - Development proxy server for Spotlight
 
 Usage: spotlight [command] [options]
 
 Commands:
-  tail [types...]      Tail Sentry events (default: everything)
-                       Available types: ${[...Object.keys(NAME_TO_TYPE_MAPPING)].join(", ")}
-                       Magic words: ${[...EVERYTHING_MAGIC_WORDS].join(", ")}
-  mcp                  Start in MCP (Model Context Protocol) mode
+${commandsHelp}
   help                 Show this help message
 
 Options:
@@ -37,18 +56,22 @@ Options:
   -h, --help             Show this help message
 
 Examples:
-  spotlight                          # Start on default port 8969
-  spotlight --open                   # Start and open dashboard in browser
-  spotlight tail                     # Tail all event types (human format)
-  spotlight tail errors              # Tail only errors
-  spotlight tail errors logs         # Tail errors and logs
-  spotlight tail --format json       # Explicitly use json format
-  spotlight mcp                      # Start in MCP mode
-  spotlight --port 3000              # Start on port 3000
-  spotlight -p 3000 -d               # Start on port 3000 with debug logging
-  spotlight -A myapp.local           # Allow requests from myapp.local
-  spotlight -A https://tunnel.ngrok.io -A dev.local  # Multiple origins
+${COMMANDS.flatMap(({ meta }) => meta.examples?.slice(0, 2) || []).map((ex) => `  ${ex}`).join("\n")}
+
+Run 'spotlight help <command>' for more information on a specific command.
 `);
+}
+function showHelp({ cmdArgs }) {
+  const targetCmd = cmdArgs?.[0];
+  if (targetCmd) {
+    if (!showCommandHelp(targetCmd)) {
+      console.error(`Unknown command: ${targetCmd}`);
+      console.error(`Run 'spotlight help' to see available commands.`);
+      process.exit(1);
+    }
+  } else {
+    showMainHelp();
+  }
   process.exit(0);
 }
 export {

package/dist/server/cli/help.js.map

@@ -1 +1 @@
-{"version":3,"file":"help.js","sources":["../../../src/server/cli/help.ts"],"sourcesContent":["import { EVERYTHING_MAGIC_WORDS, NAME_TO_TYPE_MAPPING } from \"../cli/tail.ts\";\nimport { AVAILABLE_FORMATTERS } from \"../formatters/types.ts\";\n\nexport default function showHelp() {\n  console.log(`\nSpotlight Sidecar - Development proxy server for Spotlight\n\nUsage: spotlight [command] [options]\n\nCommands:\n  tail [types...]      Tail Sentry events (default: everything)\n                       Available types: ${[...Object.keys(NAME_TO_TYPE_MAPPING)].join(\", \")}\n                       Magic words: ${[...EVERYTHING_MAGIC_WORDS].join(\", \")}\n  mcp                  Start in MCP (Model Context Protocol) mode\n  help                 Show this help message\n\nOptions:\n  -p, --port <port>      Port to listen on (default: 8969, or 0 for random)\n  -o, --open             Open the Spotlight dashboard in your default browser\n  -d, --debug            Enable debug logging\n  -f, --format <format>  Output format for tail command (default: human)\n                         Available formats: ${[...AVAILABLE_FORMATTERS].join(\", \")}\n  -A, --allowed-origin <origin>\n                         Additional origins to allow for CORS requests.\n                         Can be specified multiple times or comma-separated.\n                         Accepts full origins (https://example.com:443) for\n                         strict matching or plain domains (myapp.local) to\n                         allow any protocol/port.\n  -h, --help             Show this help message\n\nExamples:\n  spotlight                          # Start on default port 8969\n  spotlight --open                   # Start and open dashboard in browser\n  spotlight tail                     # Tail all event types (human format)\n  spotlight tail errors              # Tail only errors\n  spotlight tail errors logs         # Tail errors and logs\n  spotlight tail --format json       # Explicitly use json format\n  spotlight mcp                      # Start in MCP mode\n  spotlight --port 3000              # Start on port 3000\n  spotlight -p 3000 -d               # Start on port 3000 with debug logging\n  spotlight -A myapp.local           # Allow requests from myapp.local\n  spotlight -A https://tunnel.ngrok.io -A dev.local  # Multiple origins\n`);\n  process.exit(0);\n}\n"],"names":[],"mappings":";;;;;;;;;;;AAGA,SAAwB,WAAW;AACjC,UAAQ,IAAI;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,0CAO4B,CAAC,GAAG,OAAO,KAAK,oBAAoB,CAAC,EAAE,KAAK,IAAI,CAAC;AAAA,sCACrD,CAAC,GAAG,sBAAsB,EAAE,KAAK,IAAI,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,8CAS9B,CAAC,GAAG,oBAAoB,EAAE,KAAK,IAAI,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,CAqBjF;AACC,UAAQ,KAAK,CAAC;AAChB;"}
+{"version":3,"file":"help.js","sources":["../../../src/server/cli/help.ts"],"sourcesContent":["import { COMMANDS } from \"../cli.ts\";\nimport { AVAILABLE_FORMATTERS } from \"../formatters/types.ts\";\nimport type { CLIHandlerOptions } from \"../types/cli.ts\";\n\nfunction showCommandHelp(commandName: string): boolean {\n  const command = COMMANDS.find(c => c.meta.name === commandName);\n  if (!command) {\n    return false;\n  }\n\n  const { meta } = command;\n  console.log(`\n${meta.name} - ${meta.short}\n\nUsage: ${meta.usage || `spotlight ${meta.name} [options]`}\n${meta.long ? `\\n${meta.long}` : \"\"}\n${\n  meta.examples && meta.examples.length > 0\n    ? `\nExamples:\n${meta.examples.map(ex => `  ${ex}`).join(\"\\n\")}`\n    : \"\"\n}\n`);\n  return true;\n}\n\nfunction showMainHelp() {\n  // Build commands section dynamically from COMMANDS\n  const commandsHelp = COMMANDS.map(({ meta }) => {\n    const name = meta.name.padEnd(20);\n    return `  ${name} ${meta.short}`;\n  }).join(\"\\n\");\n\n  console.log(`\nSpotlight Sidecar - Development proxy server for Spotlight\n\nUsage: spotlight [command] [options]\n\nCommands:\n${commandsHelp}\n  help                 Show this help message\n\nOptions:\n  -p, --port <port>      Port to listen on (default: 8969, or 0 for random)\n  -o, --open             Open the Spotlight dashboard in your default browser\n  -d, --debug            Enable debug logging\n  -f, --format <format>  Output format for tail command (default: human)\n                         Available formats: ${[...AVAILABLE_FORMATTERS].join(\", \")}\n  -A, --allowed-origin <origin>\n                         Additional origins to allow for CORS requests.\n                         Can be specified multiple times or comma-separated.\n                         Accepts full origins (https://example.com:443) for\n                         strict matching or plain domains (myapp.local) to\n                         allow any protocol/port.\n  -h, --help             Show this help message\n\nExamples:\n${COMMANDS.flatMap(({ meta }) => meta.examples?.slice(0, 2) || [])\n  .map(ex => `  ${ex}`)\n  .join(\"\\n\")}\n\nRun 'spotlight help <command>' for more information on a specific command.\n`);\n}\n\nexport default function showHelp({ cmdArgs }: CLIHandlerOptions) {\n  const targetCmd = cmdArgs?.[0];\n\n  if (targetCmd) {\n    // Show detailed help for specific command\n    if (!showCommandHelp(targetCmd)) {\n      console.error(`Unknown command: ${targetCmd}`);\n      console.error(`Run 'spotlight help' to see available commands.`);\n      process.exit(1);\n    }\n  } else {\n    // Show main help\n    showMainHelp();\n  }\n\n  process.exit(0);\n}\n"],"names":[],"mappings":";;;;;;;;;;;AAIA,SAAS,gBAAgB,aAA8B;AACrD,QAAM,UAAU,SAAS,KAAK,OAAK,EAAE,KAAK,SAAS,WAAW;AAC9D,MAAI,CAAC,SAAS;AACZ,WAAO;AAAA,EACT;AAEA,QAAM,EAAE,SAAS;AACjB,UAAQ,IAAI;AAAA,EACZ,KAAK,IAAI,MAAM,KAAK,KAAK;AAAA;AAAA,SAElB,KAAK,SAAS,aAAa,KAAK,IAAI,YAAY;AAAA,EACvD,KAAK,OAAO;AAAA,EAAK,KAAK,IAAI,KAAK,EAAE;AAAA,EAEjC,KAAK,YAAY,KAAK,SAAS,SAAS,IACpC;AAAA;AAAA,EAEJ,KAAK,SAAS,IAAI,CAAA,OAAM,KAAK,EAAE,EAAE,EAAE,KAAK,IAAI,CAAC,KACzC,EACN;AAAA,CACC;AACC,SAAO;AACT;AAEA,SAAS,eAAe;AAEtB,QAAM,eAAe,SAAS,IAAI,CAAC,EAAE,WAAW;AAC9C,UAAM,OAAO,KAAK,KAAK,OAAO,EAAE;AAChC,WAAO,KAAK,IAAI,IAAI,KAAK,KAAK;AAAA,EAChC,CAAC,EAAE,KAAK,IAAI;AAEZ,UAAQ,IAAI;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMZ,YAAY;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,8CAQgC,CAAC,GAAG,oBAAoB,EAAE,KAAK,IAAI,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUhF,SAAS,QAAQ,CAAC,EAAE,WAAW,KAAK,UAAU,MAAM,GAAG,CAAC,KAAK,CAAA,CAAE,EAC9D,IAAI,CAAA,OAAM,KAAK,EAAE,EAAE,EACnB,KAAK,IAAI,CAAC;AAAA;AAAA;AAAA,CAGZ;AACD;AAEA,SAAwB,SAAS,EAAE,WAA8B;AAC/D,QAAM,YAAY,UAAU,CAAC;AAE7B,MAAI,WAAW;AAEb,QAAI,CAAC,gBAAgB,SAAS,GAAG;AAC/B,cAAQ,MAAM,oBAAoB,SAAS,EAAE;AAC7C,cAAQ,MAAM,iDAAiD;AAC/D,cAAQ,KAAK,CAAC;AAAA,IAChB;AAAA,EACF,OAAO;AAEL,iBAAA;AAAA,EACF;AAEA,UAAQ,KAAK,CAAC;AAChB;"}

package/dist/server/cli/mcp.d.ts

@@ -1,2 +1,8 @@
-import { CLIHandlerOptions } from '../types/cli.ts';
-export default function mcp({ port, basePath, filesToServe, allowedOrigins }: CLIHandlerOptions): Promise<import('http').Server<typeof import('http').IncomingMessage, typeof import('http').ServerResponse> | undefined>;
+import { CLIHandlerOptions, CommandMeta } from '../types/cli.ts';
+export declare const meta: CommandMeta;
+export declare function handler({ port, basePath, filesToServe, allowedOrigins }: CLIHandlerOptions): Promise<import('http').Server<typeof import('http').IncomingMessage, typeof import('http').ServerResponse> | undefined>;
+declare const _default: {
+    meta: CommandMeta;
+    handler: typeof handler;
+};
+export default _default;

package/dist/server/cli/mcp.js

@@ -2,7 +2,7 @@
 !function() {
   try {
     var e = "undefined" != typeof window ? window : "undefined" != typeof global ? global : "undefined" != typeof globalThis ? globalThis : "undefined" != typeof self ? self : {}, n = new e.Error().stack;
-    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "bf4b1244-eca3-4038-9d5c-069d5d9fbdc2", e._sentryDebugIdIdentifier = "sentry-dbid-bf4b1244-eca3-4038-9d5c-069d5d9fbdc2");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "f8d2431f-3fab-49ff-a5e2-8a9059a5187e", e._sentryDebugIdIdentifier = "sentry-dbid-f8d2431f-3fab-49ff-a5e2-8a9059a5187e");
   } catch (e2) {
   }
 }();
@@ -16,6 +16,27 @@ import { createMCPInstance } from "../mcp/mcp.js";
 import { normalizeAllowedOrigins } from "../utils/cors.js";
 import { isSidecarRunning } from "../utils/extras.js";
 import "../../_virtual/_sentry-release-injection-file.js";
+const meta = {
+  name: "mcp",
+  short: "Start in MCP (Model Context Protocol) mode",
+  usage: "spotlight mcp [options]",
+  long: `Start Spotlight in MCP (Model Context Protocol) stdio server mode for
+integration with AI coding assistants like Cursor, Claude, etc.
+
+Connects to existing sidecar if running, otherwise starts a new one.
+Provides MCP tools for AI assistants to query errors, logs, and traces.
+
+Available MCP Tools:
+  - search_errors: Search for errors
+  - search_logs: Search for logs
+  - search_traces: List traces
+  - get_traces: Get trace details`,
+  examples: [
+    "spotlight mcp                      # Start MCP server on default port",
+    "spotlight mcp -p 3000              # Start on custom port",
+    "spotlight mcp -d                   # Start with debug logging"
+  ]
+};
 async function startServerWithStdioMCP(port, basePath, filesToServe, normalizedAllowedOrigins) {
   const serverInstance = await startServer({
     port,
@@ -101,7 +122,7 @@ async function startMCPStdioHTTPProxy(port, basePath, filesToServe, normalizedAl
     }
   };
 }
-async function mcp({ port, basePath, filesToServe, allowedOrigins }) {
+async function handler({ port, basePath, filesToServe, allowedOrigins }) {
   const normalizedAllowedOrigins = allowedOrigins ? normalizeAllowedOrigins(allowedOrigins) : void 0;
   if (port > 0 && await isSidecarRunning(port)) {
     logger.info("Connecting to existing MCP instance with stdio proxy...");
@@ -111,7 +132,10 @@ async function mcp({ port, basePath, filesToServe, allowedOrigins }) {
     return await startServerWithStdioMCP(port, basePath, filesToServe, normalizedAllowedOrigins);
   }
 }
+const mcp = { meta, handler };
 export {
-  mcp as default
+  mcp as default,
+  handler,
+  meta
 };
 //# sourceMappingURL=mcp.js.map

package/dist/server/cli/mcp.js.map

@@ -1 +1 @@
-{"version":3,"file":"mcp.js","sources":["../../../src/server/cli/mcp.ts"],"sourcesContent":["import { Client } from \"@modelcontextprotocol/sdk/client/index.js\";\nimport { StdioServerTransport } from \"@modelcontextprotocol/sdk/server/stdio.js\";\nimport { captureException } from \"@sentry/node\";\nimport { ServerType as ProxyServerType, startStdioServer } from \"mcp-proxy\";\nimport { logger } from \"../logger.ts\";\nimport { setShutdownHandlers, startServer } from \"../main.ts\";\nimport { createMCPInstance } from \"../mcp/mcp.ts\";\nimport type { CLIHandlerOptions } from \"../types/cli.ts\";\nimport type { NormalizedAllowedOrigins } from \"../utils/cors.ts\";\nimport { normalizeAllowedOrigins } from \"../utils/cors.ts\";\nimport { isSidecarRunning } from \"../utils/extras.ts\";\n\nasync function startServerWithStdioMCP(\n  port: CLIHandlerOptions[\"port\"],\n  basePath: CLIHandlerOptions[\"basePath\"],\n  filesToServe: CLIHandlerOptions[\"filesToServe\"],\n  normalizedAllowedOrigins: NormalizedAllowedOrigins | undefined,\n) {\n  const serverInstance = await startServer({\n    port,\n    basePath,\n    filesToServe,\n    normalizedAllowedOrigins,\n  });\n  setShutdownHandlers(serverInstance);\n\n  logger.info(\"Starting MCP over stdio too...\");\n  const mcpInstance = createMCPInstance();\n  await mcpInstance.connect(new StdioServerTransport());\n\n  const shutdownMcp = () => {\n    mcpInstance.close();\n  };\n\n  process.on(\"SIGINT\", shutdownMcp);\n  process.on(\"SIGTERM\", shutdownMcp);\n\n  return serverInstance;\n}\n\nasync function startMCPStdioHTTPProxy(\n  port: CLIHandlerOptions[\"port\"],\n  basePath: CLIHandlerOptions[\"basePath\"],\n  filesToServe: CLIHandlerOptions[\"filesToServe\"],\n  normalizedAllowedOrigins: NormalizedAllowedOrigins | undefined,\n) {\n  let intentionalShutdown = false;\n  let client: Client | null = null;\n  let server: Awaited<ReturnType<typeof startStdioServer>> | null = null;\n\n  const shutdown = async () => {\n    if (intentionalShutdown) {\n      // If we get the signal again, exit immediately\n      logger.info(\"Bye.\");\n      process.exit(0);\n    }\n\n    intentionalShutdown = true;\n    logger.info(\"Shutting down MCP stdio proxy...\");\n\n    if (client) {\n      await client.close();\n    }\n    if (server) {\n      await server.close();\n    }\n  };\n\n  // Set up signal handlers for graceful shutdown\n  process.on(\"SIGINT\", shutdown);\n  process.on(\"SIGTERM\", shutdown);\n\n  server = await startStdioServer({\n    // We need to hook into `initStreamClient` as the returned object from startStdioServer\n    // is not a meta proxy object giving access to both the server and the client. It just\n    // returns the StdioServerTransport instance without a way to access the client or its errors.\n    // TODO: We should probably upstream a fix for this to close the server or bubble the errors\n    initStreamClient: () => {\n      client = new Client({\n        name: \"Spotlight Sidecar (stdio proxy)\",\n        version: \"1.0.0\",\n      });\n      client.onerror = async (err: Error) => {\n        if (\n          err.message.startsWith(\"Maximum reconnection attempts\") ||\n          /disconnected|fetch failed|connection closed/i.test(err.message)\n        ) {\n          if (client) await client.close();\n          if (server) await server.close();\n        } else if (!/conflict/i.test(err.message)) {\n          captureException(err);\n          logger.error(`MCP stdio proxy error: ${err.name}: ${err.message}`);\n        }\n      };\n      return Promise.resolve(client);\n    },\n    serverType: ProxyServerType.HTTPStream,\n    url: `http://localhost:${port}/mcp`,\n  });\n  server.onclose = async () => {\n    // If this is an intentional shutdown, don't restart\n    if (intentionalShutdown) {\n      logger.info(\"MCP stdio proxy server closed.\");\n      return;\n    }\n\n    logger.info(\"MCP stdio proxy server closed unexpectedly. Attempting to restart...\");\n    process.off(\"SIGINT\", shutdown);\n    process.off(\"SIGTERM\", shutdown);\n    // We need to manually resume stdin as `StdioServerTransport` pauses it on\n    // close but does not `resume` it when a new instance is created. Probably\n    // a bug in https://github.com/modelcontextprotocol/typescript-sdk/blob/main/src/server/stdio.ts\n    process.stdin.resume();\n\n    try {\n      await startMCPStdioHTTPProxy(port, basePath, filesToServe, normalizedAllowedOrigins);\n      logger.info(\"Connection restored\");\n    } catch (_err) {\n      try {\n        return await startServerWithStdioMCP(port, basePath, filesToServe, normalizedAllowedOrigins);\n      } catch (_err2) {\n        logger.error(\"Failed to restart sidecar server after MCP stdio proxy closed.\");\n        captureException(_err2);\n        await startMCPStdioHTTPProxy(port, basePath, filesToServe, normalizedAllowedOrigins);\n      }\n    }\n  };\n}\n\nexport default async function mcp({ port, basePath, filesToServe, allowedOrigins }: CLIHandlerOptions) {\n  // Normalize allowed origins once at startup\n  const normalizedAllowedOrigins = allowedOrigins ? normalizeAllowedOrigins(allowedOrigins) : undefined;\n\n  if (port > 0 && (await isSidecarRunning(port))) {\n    logger.info(\"Connecting to existing MCP instance with stdio proxy...\");\n    await startMCPStdioHTTPProxy(port, basePath, filesToServe, normalizedAllowedOrigins);\n    logger.info(`Connected to existing MCP instance on port ${port}`);\n  } else {\n    return await startServerWithStdioMCP(port, basePath, filesToServe, normalizedAllowedOrigins);\n  }\n}\n"],"names":["ProxyServerType"],"mappings":";;;;;;;;;;;;;;;;;;AAYA,eAAe,wBACb,MACA,UACA,cACA,0BACA;AACA,QAAM,iBAAiB,MAAM,YAAY;AAAA,IACvC;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EAAA,CACD;AACD,sBAAoB,cAAc;AAElC,SAAO,KAAK,gCAAgC;AAC5C,QAAM,cAAc,kBAAA;AACpB,QAAM,YAAY,QAAQ,IAAI,sBAAsB;AAEpD,QAAM,cAAc,MAAM;AACxB,gBAAY,MAAA;AAAA,EACd;AAEA,UAAQ,GAAG,UAAU,WAAW;AAChC,UAAQ,GAAG,WAAW,WAAW;AAEjC,SAAO;AACT;AAEA,eAAe,uBACb,MACA,UACA,cACA,0BACA;AACA,MAAI,sBAAsB;AAC1B,MAAI,SAAwB;AAC5B,MAAI,SAA8D;AAElE,QAAM,WAAW,YAAY;AAC3B,QAAI,qBAAqB;AAEvB,aAAO,KAAK,MAAM;AAClB,cAAQ,KAAK,CAAC;AAAA,IAChB;AAEA,0BAAsB;AACtB,WAAO,KAAK,kCAAkC;AAE9C,QAAI,QAAQ;AACV,YAAM,OAAO,MAAA;AAAA,IACf;AACA,QAAI,QAAQ;AACV,YAAM,OAAO,MAAA;AAAA,IACf;AAAA,EACF;AAGA,UAAQ,GAAG,UAAU,QAAQ;AAC7B,UAAQ,GAAG,WAAW,QAAQ;AAE9B,WAAS,MAAM,iBAAiB;AAAA;AAAA;AAAA;AAAA;AAAA,IAK9B,kBAAkB,MAAM;AACtB,eAAS,IAAI,OAAO;AAAA,QAClB,MAAM;AAAA,QACN,SAAS;AAAA,MAAA,CACV;AACD,aAAO,UAAU,OAAO,QAAe;AACrC,YACE,IAAI,QAAQ,WAAW,+BAA+B,KACtD,+CAA+C,KAAK,IAAI,OAAO,GAC/D;AACA,cAAI,OAAQ,OAAM,OAAO,MAAA;AACzB,cAAI,OAAQ,OAAM,OAAO,MAAA;AAAA,QAC3B,WAAW,CAAC,YAAY,KAAK,IAAI,OAAO,GAAG;AACzC,2BAAiB,GAAG;AACpB,iBAAO,MAAM,0BAA0B,IAAI,IAAI,KAAK,IAAI,OAAO,EAAE;AAAA,QACnE;AAAA,MACF;AACA,aAAO,QAAQ,QAAQ,MAAM;AAAA,IAC/B;AAAA,IACA,YAAYA,WAAgB;AAAA,IAC5B,KAAK,oBAAoB,IAAI;AAAA,EAAA,CAC9B;AACD,SAAO,UAAU,YAAY;AAE3B,QAAI,qBAAqB;AACvB,aAAO,KAAK,gCAAgC;AAC5C;AAAA,IACF;AAEA,WAAO,KAAK,sEAAsE;AAClF,YAAQ,IAAI,UAAU,QAAQ;AAC9B,YAAQ,IAAI,WAAW,QAAQ;AAI/B,YAAQ,MAAM,OAAA;AAEd,QAAI;AACF,YAAM,uBAAuB,MAAM,UAAU,cAAc,wBAAwB;AACnF,aAAO,KAAK,qBAAqB;AAAA,IACnC,SAAS,MAAM;AACb,UAAI;AACF,eAAO,MAAM,wBAAwB,MAAM,UAAU,cAAc,wBAAwB;AAAA,MAC7F,SAAS,OAAO;AACd,eAAO,MAAM,gEAAgE;AAC7E,yBAAiB,KAAK;AACtB,cAAM,uBAAuB,MAAM,UAAU,cAAc,wBAAwB;AAAA,MACrF;AAAA,IACF;AAAA,EACF;AACF;AAEA,eAA8B,IAAI,EAAE,MAAM,UAAU,cAAc,kBAAqC;AAErG,QAAM,2BAA2B,iBAAiB,wBAAwB,cAAc,IAAI;AAE5F,MAAI,OAAO,KAAM,MAAM,iBAAiB,IAAI,GAAI;AAC9C,WAAO,KAAK,yDAAyD;AACrE,UAAM,uBAAuB,MAAM,UAAU,cAAc,wBAAwB;AACnF,WAAO,KAAK,8CAA8C,IAAI,EAAE;AAAA,EAClE,OAAO;AACL,WAAO,MAAM,wBAAwB,MAAM,UAAU,cAAc,wBAAwB;AAAA,EAC7F;AACF;"}
+{"version":3,"file":"mcp.js","sources":["../../../src/server/cli/mcp.ts"],"sourcesContent":["import { Client } from \"@modelcontextprotocol/sdk/client/index.js\";\nimport { StdioServerTransport } from \"@modelcontextprotocol/sdk/server/stdio.js\";\nimport { captureException } from \"@sentry/node\";\nimport { ServerType as ProxyServerType, startStdioServer } from \"mcp-proxy\";\nimport { logger } from \"../logger.ts\";\nimport { setShutdownHandlers, startServer } from \"../main.ts\";\nimport { createMCPInstance } from \"../mcp/mcp.ts\";\nimport type { CLIHandlerOptions, Command, CommandMeta } from \"../types/cli.ts\";\nimport type { NormalizedAllowedOrigins } from \"../utils/cors.ts\";\nimport { normalizeAllowedOrigins } from \"../utils/cors.ts\";\nimport { isSidecarRunning } from \"../utils/extras.ts\";\n\nexport const meta: CommandMeta = {\n  name: \"mcp\",\n  short: \"Start in MCP (Model Context Protocol) mode\",\n  usage: \"spotlight mcp [options]\",\n  long: `Start Spotlight in MCP (Model Context Protocol) stdio server mode for\nintegration with AI coding assistants like Cursor, Claude, etc.\n\nConnects to existing sidecar if running, otherwise starts a new one.\nProvides MCP tools for AI assistants to query errors, logs, and traces.\n\nAvailable MCP Tools:\n  - search_errors: Search for errors\n  - search_logs: Search for logs\n  - search_traces: List traces\n  - get_traces: Get trace details`,\n  examples: [\n    \"spotlight mcp                      # Start MCP server on default port\",\n    \"spotlight mcp -p 3000              # Start on custom port\",\n    \"spotlight mcp -d                   # Start with debug logging\",\n  ],\n};\n\nasync function startServerWithStdioMCP(\n  port: CLIHandlerOptions[\"port\"],\n  basePath: CLIHandlerOptions[\"basePath\"],\n  filesToServe: CLIHandlerOptions[\"filesToServe\"],\n  normalizedAllowedOrigins: NormalizedAllowedOrigins | undefined,\n) {\n  const serverInstance = await startServer({\n    port,\n    basePath,\n    filesToServe,\n    normalizedAllowedOrigins,\n  });\n  setShutdownHandlers(serverInstance);\n\n  logger.info(\"Starting MCP over stdio too...\");\n  const mcpInstance = createMCPInstance();\n  await mcpInstance.connect(new StdioServerTransport());\n\n  const shutdownMcp = () => {\n    mcpInstance.close();\n  };\n\n  process.on(\"SIGINT\", shutdownMcp);\n  process.on(\"SIGTERM\", shutdownMcp);\n\n  return serverInstance;\n}\n\nasync function startMCPStdioHTTPProxy(\n  port: CLIHandlerOptions[\"port\"],\n  basePath: CLIHandlerOptions[\"basePath\"],\n  filesToServe: CLIHandlerOptions[\"filesToServe\"],\n  normalizedAllowedOrigins: NormalizedAllowedOrigins | undefined,\n) {\n  let intentionalShutdown = false;\n  let client: Client | null = null;\n  let server: Awaited<ReturnType<typeof startStdioServer>> | null = null;\n\n  const shutdown = async () => {\n    if (intentionalShutdown) {\n      // If we get the signal again, exit immediately\n      logger.info(\"Bye.\");\n      process.exit(0);\n    }\n\n    intentionalShutdown = true;\n    logger.info(\"Shutting down MCP stdio proxy...\");\n\n    if (client) {\n      await client.close();\n    }\n    if (server) {\n      await server.close();\n    }\n  };\n\n  // Set up signal handlers for graceful shutdown\n  process.on(\"SIGINT\", shutdown);\n  process.on(\"SIGTERM\", shutdown);\n\n  server = await startStdioServer({\n    // We need to hook into `initStreamClient` as the returned object from startStdioServer\n    // is not a meta proxy object giving access to both the server and the client. It just\n    // returns the StdioServerTransport instance without a way to access the client or its errors.\n    // TODO: We should probably upstream a fix for this to close the server or bubble the errors\n    initStreamClient: () => {\n      client = new Client({\n        name: \"Spotlight Sidecar (stdio proxy)\",\n        version: \"1.0.0\",\n      });\n      client.onerror = async (err: Error) => {\n        if (\n          err.message.startsWith(\"Maximum reconnection attempts\") ||\n          /disconnected|fetch failed|connection closed/i.test(err.message)\n        ) {\n          if (client) await client.close();\n          if (server) await server.close();\n        } else if (!/conflict/i.test(err.message)) {\n          captureException(err);\n          logger.error(`MCP stdio proxy error: ${err.name}: ${err.message}`);\n        }\n      };\n      return Promise.resolve(client);\n    },\n    serverType: ProxyServerType.HTTPStream,\n    url: `http://localhost:${port}/mcp`,\n  });\n  server.onclose = async () => {\n    // If this is an intentional shutdown, don't restart\n    if (intentionalShutdown) {\n      logger.info(\"MCP stdio proxy server closed.\");\n      return;\n    }\n\n    logger.info(\"MCP stdio proxy server closed unexpectedly. Attempting to restart...\");\n    process.off(\"SIGINT\", shutdown);\n    process.off(\"SIGTERM\", shutdown);\n    // We need to manually resume stdin as `StdioServerTransport` pauses it on\n    // close but does not `resume` it when a new instance is created. Probably\n    // a bug in https://github.com/modelcontextprotocol/typescript-sdk/blob/main/src/server/stdio.ts\n    process.stdin.resume();\n\n    try {\n      await startMCPStdioHTTPProxy(port, basePath, filesToServe, normalizedAllowedOrigins);\n      logger.info(\"Connection restored\");\n    } catch (_err) {\n      try {\n        return await startServerWithStdioMCP(port, basePath, filesToServe, normalizedAllowedOrigins);\n      } catch (_err2) {\n        logger.error(\"Failed to restart sidecar server after MCP stdio proxy closed.\");\n        captureException(_err2);\n        await startMCPStdioHTTPProxy(port, basePath, filesToServe, normalizedAllowedOrigins);\n      }\n    }\n  };\n}\n\nexport async function handler({ port, basePath, filesToServe, allowedOrigins }: CLIHandlerOptions) {\n  // Normalize allowed origins once at startup\n  const normalizedAllowedOrigins = allowedOrigins ? normalizeAllowedOrigins(allowedOrigins) : undefined;\n\n  if (port > 0 && (await isSidecarRunning(port))) {\n    logger.info(\"Connecting to existing MCP instance with stdio proxy...\");\n    await startMCPStdioHTTPProxy(port, basePath, filesToServe, normalizedAllowedOrigins);\n    logger.info(`Connected to existing MCP instance on port ${port}`);\n  } else {\n    return await startServerWithStdioMCP(port, basePath, filesToServe, normalizedAllowedOrigins);\n  }\n}\n\nexport default { meta, handler } satisfies Command;\n"],"names":["ProxyServerType"],"mappings":"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"}

package/dist/server/cli/run.d.ts

@@ -1,2 +1,8 @@
-import { CLIHandlerOptions } from '../types/cli.ts';
-export default function run({ port, cmdArgs, basePath, filesToServe, format, allowedOrigins, open, }: CLIHandlerOptions): Promise<void>;
+import { CLIHandlerOptions, CommandMeta } from '../types/cli.ts';
+export declare const meta: CommandMeta;
+export declare function handler({ port, cmdArgs, basePath, filesToServe, format, allowedOrigins, open, }: CLIHandlerOptions): Promise<void>;
+declare const _default: {
+    meta: CommandMeta;
+    handler: typeof handler;
+};
+export default _default;

package/dist/server/cli/run.js

@@ -2,7 +2,7 @@
 !function() {
   try {
     var e = "undefined" != typeof window ? window : "undefined" != typeof global ? global : "undefined" != typeof globalThis ? globalThis : "undefined" != typeof self ? self : {}, n = new e.Error().stack;
-    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "cf2fc95b-4830-431c-b121-542d3b72686e", e._sentryDebugIdIdentifier = "sentry-dbid-cf2fc95b-4830-431c-b121-542d3b72686e");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "e59232d7-48d8-4dfe-907e-19a2d2b3cd58", e._sentryDebugIdIdentifier = "sentry-dbid-e59232d7-48d8-4dfe-907e-19a2d2b3cd58");
   } catch (e2) {
   }
 }();
@@ -23,8 +23,33 @@ import { EventContainer } from "../utils/eventContainer.js";
 import "node:dns/promises";
 import "node:net";
 import "node:os";
-import tail from "./tail.js";
-const SPOTLIGHT_VERSION = "4.8.0";
+import { handler as handler$1 } from "./tail.js";
+const meta = {
+  name: "run",
+  short: "Run your app with automatic Spotlight instrumentation",
+  usage: "spotlight run [options] [command...]",
+  long: `Run your application with Spotlight, automatically setting up the necessary
+environment variables and capturing telemetry data.
+
+If no command is provided, Spotlight auto-detects:
+  - Docker Compose projects (docker-compose.yml, compose.yml, etc.)
+  - package.json scripts (dev, develop, serve, start)
+
+Environment variables set automatically:
+  - SENTRY_SPOTLIGHT=http://localhost:<port>/stream
+  - NEXT_PUBLIC_SENTRY_SPOTLIGHT=http://localhost:<port>/stream
+  - SENTRY_TRACES_SAMPLE_RATE=1
+
+stdout/stderr are captured and sent to Spotlight as log events.`,
+  examples: [
+    "spotlight run                      # Auto-detect and run (package.json or docker-compose)",
+    "spotlight run node server.js       # Run a specific command with Spotlight",
+    "spotlight run -p 3000 npm start    # Run with custom port",
+    "spotlight run python manage.py runserver  # Run Python app",
+    "spotlight run docker compose up    # Run Docker Compose with Spotlight injection"
+  ]
+};
+const SPOTLIGHT_VERSION = "4.9.0";
 const LOCALHOST_HOST = "localhost";
 function detectPackageJson() {
   try {
@@ -97,7 +122,7 @@ function createLogEnvelope(level, body, timestamp) {
   return Buffer.from(`${parts.join("\n")}
 `, "utf-8");
 }
-async function run({
+async function handler({
   port,
   cmdArgs,
   basePath,
@@ -135,7 +160,7 @@ async function run({
     }
     return true;
   };
-  const serverInstance = await tail({ port, cmdArgs: [], basePath, filesToServe, format, allowedOrigins }, logChecker);
+  const serverInstance = await handler$1({ port, cmdArgs: [], basePath, filesToServe, format, allowedOrigins }, logChecker);
   if (!serverInstance) {
     logger.error("Failed to start Spotlight sidecar server.");
     logger.error(`The port ${port} might already be in use — most likely by another Spotlight instance.`);
@@ -299,7 +324,10 @@ async function run({
     process.on("beforeExit", killRunCmd);
   });
 }
+const run = { meta, handler };
 export {
-  run as default
+  run as default,
+  handler,
+  meta
 };
 //# sourceMappingURL=run.js.map

package/dist/server/cli/run.js.map

@@ -1 +1 @@
-{"version":3,"file":"run.js","sources":["../../../src/server/cli/run.ts"],"sourcesContent":["import { spawn } from \"node:child_process\";\nimport { readFileSync } from \"node:fs\";\nimport type { AddressInfo } from \"node:net\";\nimport * as path from \"node:path\";\nimport * as readline from \"node:readline\";\nimport type { SerializedLog } from \"@sentry/core\";\nimport { metrics } from \"@sentry/node\";\nimport { Searcher } from \"fast-fuzzy\";\nimport { uuidv7 } from \"uuidv7\";\nimport { SENTRY_CONTENT_TYPE } from \"../constants.ts\";\nimport { logger } from \"../logger.ts\";\nimport type { SentryLogEvent } from \"../parser/types.ts\";\nimport type { CLIHandlerOptions } from \"../types/cli.ts\";\nimport { detectDockerCompose, parseExplicitDockerCompose, prepareDockerComposeRun } from \"../utils/docker-compose.ts\";\nimport { getSpotlightURL, openInBrowser } from \"../utils/extras.ts\";\nimport { EventContainer, getBuffer } from \"../utils/index.ts\";\nimport tail, { type OnItemCallback } from \"./tail.ts\";\n\nconst SPOTLIGHT_VERSION = process.env.npm_package_version || \"unknown\";\n\n// Environment variable host configurations\nconst LOCALHOST_HOST = \"localhost\";\n\n/**\n * Detect if there's a package.json with runnable scripts\n */\nfunction detectPackageJson(): { scriptName: string; scriptCommand: string } | null {\n  try {\n    const scripts = JSON.parse(readFileSync(\"./package.json\", \"utf-8\")).scripts;\n    const scriptName = [\"dev\", \"develop\", \"serve\", \"start\"].find(name => scripts[name]);\n    if (!scriptName || !scripts[scriptName]) {\n      return null;\n    }\n    return { scriptName, scriptCommand: scripts[scriptName] };\n  } catch {\n    // pass\n  }\n  return null;\n}\n\n/**\n * Prompt the user to choose between Docker Compose and package.json\n */\nasync function promptUserChoice(): Promise<\"docker\" | \"package\"> {\n  const rl = readline.createInterface({\n    input: process.stdin,\n    output: process.stdout,\n  });\n\n  return new Promise(resolve => {\n    console.log(\"\\n⚠️  Both Docker Compose and package.json detected!\");\n    console.log(\"\\nWhich would you like to use?\");\n    console.log(\"  1) docker compose\");\n    console.log(\"  2) package.json\");\n\n    rl.question(\"Enter your choice (1 or 2): \", answer => {\n      rl.close();\n      const choice = answer.trim();\n      const selected = choice === \"2\" ? \"package\" : \"docker\";\n      logger.info(`Selected: ${selected === \"docker\" ? \"Docker compose\" : \"package.json\"}`);\n      resolve(selected);\n    });\n  });\n}\n\nfunction createLogEnvelope(level: \"info\" | \"error\", body: string, timestamp: number): Buffer {\n  const envelopeHeader = {\n    sdk: {\n      name: \"sentry.spotlight.stdio\",\n      version: SPOTLIGHT_VERSION,\n    },\n  };\n\n  const logItem: SerializedLog = {\n    timestamp,\n    level,\n    body,\n    attributes: {},\n  };\n\n  const logPayload: SentryLogEvent = {\n    type: \"log\",\n    event_id: uuidv7(),\n    timestamp,\n    items: [\n      {\n        ...logItem,\n        id: uuidv7(),\n        severity_number: level === \"error\" ? 17 : 9, // ERROR=17, INFO=9 per OpenTelemetry spec\n        sdk: undefined,\n      },\n    ],\n  };\n\n  const payloadJson = JSON.stringify(logPayload);\n  const payloadBuffer = Buffer.from(payloadJson, \"utf-8\");\n\n  const itemHeader = {\n    type: \"log\",\n    length: payloadBuffer.length, // Use byte length, not string length\n    item_count: 1,\n    content_type: \"application/json\",\n  };\n\n  const parts = [JSON.stringify(envelopeHeader), JSON.stringify(itemHeader), payloadJson];\n\n  return Buffer.from(`${parts.join(\"\\n\")}\\n`, \"utf-8\");\n}\n\nexport default async function run({\n  port,\n  cmdArgs,\n  basePath,\n  filesToServe,\n  format,\n  allowedOrigins,\n  open,\n}: CLIHandlerOptions) {\n  let relayStdioAsLogs = true;\n\n  const fuzzySearcher = new Searcher([] as string[], {\n    threshold: 0.8,\n    ignoreCase: false,\n  });\n\n  const logChecker: OnItemCallback = (type, item, envelopeHeader) => {\n    if (type !== \"log\") return true;\n\n    const [, payload] = item;\n    const logEvent = payload as SentryLogEvent;\n\n    if (logEvent.items && logEvent.items.length > 0) {\n      for (const logItem of logEvent.items) {\n        // Check if this is a stdio log from Spotlight itself\n        if (envelopeHeader.sdk?.name === \"sentry.spotlight.stdio\") {\n          continue;\n        }\n\n        if (!relayStdioAsLogs) continue;\n\n        const logBody = typeof logItem.body === \"string\" ? logItem.body : String(logItem.body);\n        const trimmedBody = logBody.trim();\n\n        if (trimmedBody) {\n          const matches = fuzzySearcher.search(trimmedBody);\n          if (matches.length > 0) {\n            logger.debug(\"Detected Sentry logging in the process, disabling stdio relay\");\n            relayStdioAsLogs = false;\n            return false;\n          }\n        }\n      }\n    }\n\n    return true;\n  };\n\n  const serverInstance = await tail({ port, cmdArgs: [], basePath, filesToServe, format, allowedOrigins }, logChecker);\n  if (!serverInstance) {\n    logger.error(\"Failed to start Spotlight sidecar server.\");\n    logger.error(`The port ${port} might already be in use — most likely by another Spotlight instance.`);\n    process.exit(1);\n  }\n\n  // We *MUST* have an instance address and a port here\n  // as not having that indicates either the server did not start\n  // or started in a weird manner (like over a unix socket)\n  const actualServerPort = (serverInstance.address() as AddressInfo).port;\n  const spotlightUrl = getSpotlightURL(actualServerPort, LOCALHOST_HOST);\n\n  if (open) {\n    openInBrowser(actualServerPort);\n  }\n  let shell = false;\n  let stdin: string | undefined = undefined;\n  const env = {\n    ...process.env,\n    SENTRY_SPOTLIGHT: spotlightUrl,\n    // We need the one below for Next.js projects -- they only allow NEXT_PUBLIC_ prefixed env vars\n    // on frontend code\n    NEXT_PUBLIC_SENTRY_SPOTLIGHT: spotlightUrl,\n    // This is not supported in all SDKs but worth adding\n    // for the ones that support it\n    SENTRY_TRACES_SAMPLE_RATE: \"1\",\n  } as {\n    PATH: string;\n    SENTRY_SPOTLIGHT: string;\n    NEXT_PUBLIC_SENTRY_SPOTLIGHT: string;\n    SENTRY_TRACES_SAMPLE_RATE: string;\n    [key: string]: string;\n  };\n  if (cmdArgs.length === 0) {\n    const dockerCompose = detectDockerCompose();\n    const packageJson = detectPackageJson();\n\n    // If both Docker Compose and package.json are detected, ask the user which one to use\n    if (dockerCompose && packageJson) {\n      if (!process.stdin.isTTY) {\n        logger.error(\"Both Docker Compose and package.json detected, but cannot prompt in non-interactive mode.\");\n        logger.error(\"Please specify a command explicitly or run in an interactive terminal.\");\n        process.exit(1);\n      }\n      const choice = await promptUserChoice();\n      metrics.count(\"cli.run.prompt_choice\", 1, { attributes: { choice } });\n\n      if (choice === \"docker\") {\n        logger.info(\n          `Detected Docker Compose project with ${dockerCompose.serviceNames.length} service(s): ${dockerCompose.serviceNames.join(\", \")}`,\n        );\n        metrics.count(\"cli.run.autodetect\", 1, { attributes: { type: \"docker-compose\" } });\n        ({ cmdArgs, stdin } = prepareDockerComposeRun(dockerCompose, actualServerPort, env));\n      } else {\n        logger.info(`Using package.json script: ${packageJson.scriptName}`);\n        metrics.count(\"cli.run.autodetect\", 1, { attributes: { type: \"package-json\" } });\n        cmdArgs = [packageJson.scriptCommand];\n        shell = true;\n        env.PATH = path.resolve(\"./node_modules/.bin\") + path.delimiter + env.PATH;\n      }\n    } else if (dockerCompose) {\n      logger.info(\n        `Detected Docker Compose project with ${dockerCompose.serviceNames.length} service(s): ${dockerCompose.serviceNames.join(\", \")}`,\n      );\n      metrics.count(\"cli.run.autodetect\", 1, { attributes: { type: \"docker-compose\" } });\n      ({ cmdArgs, stdin } = prepareDockerComposeRun(dockerCompose, actualServerPort, env));\n    } else if (packageJson) {\n      logger.info(`Using package.json script: ${packageJson.scriptName}`);\n      metrics.count(\"cli.run.autodetect\", 1, { attributes: { type: \"package-json\" } });\n      cmdArgs = [packageJson.scriptCommand];\n      shell = true;\n      env.PATH = path.resolve(\"./node_modules/.bin\") + path.delimiter + env.PATH;\n    }\n  } else {\n    // Handle explicit docker compose commands (e.g., \"spotlight run docker compose up\")\n    const explicitDockerConfig = parseExplicitDockerCompose(cmdArgs);\n    if (explicitDockerConfig) {\n      logger.info(\n        `Detected explicit Docker Compose command with ${explicitDockerConfig.serviceNames.length} service(s): ${explicitDockerConfig.serviceNames.join(\", \")}`,\n      );\n      metrics.count(\"cli.run.docker_compose.explicit\", 1, {\n        attributes: {\n          services: explicitDockerConfig.serviceNames.length,\n          subcommand: explicitDockerConfig.subcommandArgs.join(\" \"),\n        },\n      });\n      ({ cmdArgs, stdin } = prepareDockerComposeRun(explicitDockerConfig, actualServerPort, env));\n    }\n  }\n  if (cmdArgs.length === 0) {\n    logger.error(\"Error: No command specified to run and could not infer the command automatically.\");\n    process.exit(1);\n  }\n  const cmdStr = cmdArgs.join(\" \");\n  logger.info(`Starting command: ${cmdStr}`);\n  // When we have Docker Compose override YAML (for -f -), we need to pipe stdin\n  // Otherwise, inherit stdin to relay user input to the downstream process\n  const stdinMode: \"pipe\" | \"inherit\" = stdin ? \"pipe\" : \"inherit\";\n  const runCmd = spawn(cmdArgs[0], cmdArgs.slice(1), {\n    cwd: process.cwd(),\n    env,\n    shell,\n    windowsVerbatimArguments: true,\n    windowsHide: true,\n    stdio: [stdinMode, \"pipe\", \"pipe\"],\n  });\n\n  const { stdout, stderr } = runCmd;\n  if (!stdout || !stderr) {\n    logger.error(\"Failed to create process streams\");\n    process.exit(1);\n  }\n\n  // If our command has a stdin input _and_ we can send to stdin, write and close\n  if (stdin) {\n    if (!runCmd.stdin) {\n      logger.error(\"Failed to pipe Docker Compose override: stdin is not available\");\n      process.exit(1);\n    }\n    runCmd.stdin.write(stdin);\n    runCmd.stdin.end();\n  }\n\n  const processLogLine = (line: string, level: \"info\" | \"error\") => {\n    if (!relayStdioAsLogs) return;\n    const trimmedLine = line.trim();\n    if (!trimmedLine) return;\n\n    fuzzySearcher.add(trimmedLine);\n\n    const timestamp = Date.now() / 1000;\n    const envelopeBuffer = createLogEnvelope(level, trimmedLine, timestamp);\n\n    const container = new EventContainer(SENTRY_CONTENT_TYPE, envelopeBuffer);\n    // Add to buffer - this will automatically trigger all subscribers\n    // including the onEnvelope callback registered in tail()\n    getBuffer().put(container);\n  };\n\n  let stdoutBuffer = \"\";\n  let stderrBuffer = \"\";\n\n  // Stream stdout as info-level logs\n  stdout.on(\"data\", (data: Buffer) => {\n    stdoutBuffer += data.toString();\n    const lines = stdoutBuffer.split(\"\\n\");\n    // Keep the last partial line in the buffer\n    stdoutBuffer = lines.pop() || \"\";\n\n    for (const line of lines) {\n      processLogLine(line, \"info\");\n    }\n  });\n\n  // Stream stderr as error-level logs\n  stderr.on(\"data\", (data: Buffer) => {\n    stderrBuffer += data.toString();\n    const lines = stderrBuffer.split(\"\\n\");\n    // Keep the last partial line in the buffer\n    stderrBuffer = lines.pop() || \"\";\n\n    for (const line of lines) {\n      processLogLine(line, \"error\");\n    }\n  });\n\n  runCmd.on(\"error\", err => {\n    logger.error(`Failed to run ${cmdStr}:`);\n    logger.error(err);\n    process.exit(1);\n  });\n\n  runCmd.on(\"close\", code => {\n    // Handle any remaining buffered lines\n    if (stdoutBuffer.trim()) {\n      processLogLine(stdoutBuffer, \"info\");\n    }\n    if (stderrBuffer.trim()) {\n      processLogLine(stderrBuffer, \"error\");\n    }\n\n    if (!code) {\n      logger.error(`${cmdStr} exited, terminating.`);\n    } else {\n      logger.error(`${cmdStr} exited with code ${code}.`);\n    }\n    process.exit(code);\n  });\n  const killRunCmd = () => {\n    if (runCmd.killed) return;\n    stdout.destroy();\n    stderr.destroy();\n    runCmd.kill();\n  };\n  runCmd.on(\"spawn\", () => {\n    runCmd.removeAllListeners(\"spawn\");\n    runCmd.removeAllListeners(\"error\");\n    process.on(\"SIGINT\", killRunCmd);\n    process.on(\"SIGTERM\", killRunCmd);\n    process.on(\"beforeExit\", killRunCmd);\n  });\n}\n"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAkBA,MAAM,oBAAoB;AAG1B,MAAM,iBAAiB;AAKvB,SAAS,oBAA0E;AACjF,MAAI;AACF,UAAM,UAAU,KAAK,MAAM,aAAa,kBAAkB,OAAO,CAAC,EAAE;AACpE,UAAM,aAAa,CAAC,OAAO,WAAW,SAAS,OAAO,EAAE,KAAK,CAAA,SAAQ,QAAQ,IAAI,CAAC;AAClF,QAAI,CAAC,cAAc,CAAC,QAAQ,UAAU,GAAG;AACvC,aAAO;AAAA,IACT;AACA,WAAO,EAAE,YAAY,eAAe,QAAQ,UAAU,EAAA;AAAA,EACxD,QAAQ;AAAA,EAER;AACA,SAAO;AACT;AAKA,eAAe,mBAAkD;AAC/D,QAAM,KAAK,SAAS,gBAAgB;AAAA,IAClC,OAAO,QAAQ;AAAA,IACf,QAAQ,QAAQ;AAAA,EAAA,CACjB;AAED,SAAO,IAAI,QAAQ,CAAA,YAAW;AAC5B,YAAQ,IAAI,sDAAsD;AAClE,YAAQ,IAAI,gCAAgC;AAC5C,YAAQ,IAAI,qBAAqB;AACjC,YAAQ,IAAI,mBAAmB;AAE/B,OAAG,SAAS,gCAAgC,CAAA,WAAU;AACpD,SAAG,MAAA;AACH,YAAM,SAAS,OAAO,KAAA;AACtB,YAAM,WAAW,WAAW,MAAM,YAAY;AAC9C,aAAO,KAAK,aAAa,aAAa,WAAW,mBAAmB,cAAc,EAAE;AACpF,cAAQ,QAAQ;AAAA,IAClB,CAAC;AAAA,EACH,CAAC;AACH;AAEA,SAAS,kBAAkB,OAAyB,MAAc,WAA2B;AAC3F,QAAM,iBAAiB;AAAA,IACrB,KAAK;AAAA,MACH,MAAM;AAAA,MACN,SAAS;AAAA,IAAA;AAAA,EACX;AAGF,QAAM,UAAyB;AAAA,IAC7B;AAAA,IACA;AAAA,IACA;AAAA,IACA,YAAY,CAAA;AAAA,EAAC;AAGf,QAAM,aAA6B;AAAA,IACjC,MAAM;AAAA,IACN,UAAU,OAAA;AAAA,IACV;AAAA,IACA,OAAO;AAAA,MACL;AAAA,QACE,GAAG;AAAA,QACH,IAAI,OAAA;AAAA,QACJ,iBAAiB,UAAU,UAAU,KAAK;AAAA;AAAA,QAC1C,KAAK;AAAA,MAAA;AAAA,IACP;AAAA,EACF;AAGF,QAAM,cAAc,KAAK,UAAU,UAAU;AAC7C,QAAM,gBAAgB,OAAO,KAAK,aAAa,OAAO;AAEtD,QAAM,aAAa;AAAA,IACjB,MAAM;AAAA,IACN,QAAQ,cAAc;AAAA;AAAA,IACtB,YAAY;AAAA,IACZ,cAAc;AAAA,EAAA;AAGhB,QAAM,QAAQ,CAAC,KAAK,UAAU,cAAc,GAAG,KAAK,UAAU,UAAU,GAAG,WAAW;AAEtF,SAAO,OAAO,KAAK,GAAG,MAAM,KAAK,IAAI,CAAC;AAAA,GAAM,OAAO;AACrD;AAEA,eAA8B,IAAI;AAAA,EAChC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAAsB;AACpB,MAAI,mBAAmB;AAEvB,QAAM,gBAAgB,IAAI,SAAS,IAAgB;AAAA,IACjD,WAAW;AAAA,IACX,YAAY;AAAA,EAAA,CACb;AAED,QAAM,aAA6B,CAAC,MAAM,MAAM,mBAAmB;AACjE,QAAI,SAAS,MAAO,QAAO;AAE3B,UAAM,CAAA,EAAG,OAAO,IAAI;AACpB,UAAM,WAAW;AAEjB,QAAI,SAAS,SAAS,SAAS,MAAM,SAAS,GAAG;AAC/C,iBAAW,WAAW,SAAS,OAAO;AAEpC,YAAI,eAAe,KAAK,SAAS,0BAA0B;AACzD;AAAA,QACF;AAEA,YAAI,CAAC,iBAAkB;AAEvB,cAAM,UAAU,OAAO,QAAQ,SAAS,WAAW,QAAQ,OAAO,OAAO,QAAQ,IAAI;AACrF,cAAM,cAAc,QAAQ,KAAA;AAE5B,YAAI,aAAa;AACf,gBAAM,UAAU,cAAc,OAAO,WAAW;AAChD,cAAI,QAAQ,SAAS,GAAG;AACtB,mBAAO,MAAM,+DAA+D;AAC5E,+BAAmB;AACnB,mBAAO;AAAA,UACT;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAEA,WAAO;AAAA,EACT;AAEA,QAAM,iBAAiB,MAAM,KAAK,EAAE,MAAM,SAAS,IAAI,UAAU,cAAc,QAAQ,eAAA,GAAkB,UAAU;AACnH,MAAI,CAAC,gBAAgB;AACnB,WAAO,MAAM,2CAA2C;AACxD,WAAO,MAAM,YAAY,IAAI,uEAAuE;AACpG,YAAQ,KAAK,CAAC;AAAA,EAChB;AAKA,QAAM,mBAAoB,eAAe,QAAA,EAA0B;AACnE,QAAM,eAAe,gBAAgB,kBAAkB,cAAc;AAErE,MAAI,MAAM;AACR,kBAAc,gBAAgB;AAAA,EAChC;AACA,MAAI,QAAQ;AACZ,MAAI,QAA4B;AAChC,QAAM,MAAM;AAAA,IACV,GAAG,QAAQ;AAAA,IACX,kBAAkB;AAAA;AAAA;AAAA,IAGlB,8BAA8B;AAAA;AAAA;AAAA,IAG9B,2BAA2B;AAAA,EAAA;AAQ7B,MAAI,QAAQ,WAAW,GAAG;AACxB,UAAM,gBAAgB,oBAAA;AACtB,UAAM,cAAc,kBAAA;AAGpB,QAAI,iBAAiB,aAAa;AAChC,UAAI,CAAC,QAAQ,MAAM,OAAO;AACxB,eAAO,MAAM,2FAA2F;AACxG,eAAO,MAAM,wEAAwE;AACrF,gBAAQ,KAAK,CAAC;AAAA,MAChB;AACA,YAAM,SAAS,MAAM,iBAAA;AACrB,cAAQ,MAAM,yBAAyB,GAAG,EAAE,YAAY,EAAE,OAAA,GAAU;AAEpE,UAAI,WAAW,UAAU;AACvB,eAAO;AAAA,UACL,wCAAwC,cAAc,aAAa,MAAM,gBAAgB,cAAc,aAAa,KAAK,IAAI,CAAC;AAAA,QAAA;AAEhI,gBAAQ,MAAM,sBAAsB,GAAG,EAAE,YAAY,EAAE,MAAM,iBAAA,GAAoB;AACjF,SAAC,EAAE,SAAS,MAAA,IAAU,wBAAwB,eAAe,kBAAkB,GAAG;AAAA,MACpF,OAAO;AACL,eAAO,KAAK,8BAA8B,YAAY,UAAU,EAAE;AAClE,gBAAQ,MAAM,sBAAsB,GAAG,EAAE,YAAY,EAAE,MAAM,eAAA,GAAkB;AAC/E,kBAAU,CAAC,YAAY,aAAa;AACpC,gBAAQ;AACR,YAAI,OAAO,KAAK,QAAQ,qBAAqB,IAAI,KAAK,YAAY,IAAI;AAAA,MACxE;AAAA,IACF,WAAW,eAAe;AACxB,aAAO;AAAA,QACL,wCAAwC,cAAc,aAAa,MAAM,gBAAgB,cAAc,aAAa,KAAK,IAAI,CAAC;AAAA,MAAA;AAEhI,cAAQ,MAAM,sBAAsB,GAAG,EAAE,YAAY,EAAE,MAAM,iBAAA,GAAoB;AACjF,OAAC,EAAE,SAAS,MAAA,IAAU,wBAAwB,eAAe,kBAAkB,GAAG;AAAA,IACpF,WAAW,aAAa;AACtB,aAAO,KAAK,8BAA8B,YAAY,UAAU,EAAE;AAClE,cAAQ,MAAM,sBAAsB,GAAG,EAAE,YAAY,EAAE,MAAM,eAAA,GAAkB;AAC/E,gBAAU,CAAC,YAAY,aAAa;AACpC,cAAQ;AACR,UAAI,OAAO,KAAK,QAAQ,qBAAqB,IAAI,KAAK,YAAY,IAAI;AAAA,IACxE;AAAA,EACF,OAAO;AAEL,UAAM,uBAAuB,2BAA2B,OAAO;AAC/D,QAAI,sBAAsB;AACxB,aAAO;AAAA,QACL,iDAAiD,qBAAqB,aAAa,MAAM,gBAAgB,qBAAqB,aAAa,KAAK,IAAI,CAAC;AAAA,MAAA;AAEvJ,cAAQ,MAAM,mCAAmC,GAAG;AAAA,QAClD,YAAY;AAAA,UACV,UAAU,qBAAqB,aAAa;AAAA,UAC5C,YAAY,qBAAqB,eAAe,KAAK,GAAG;AAAA,QAAA;AAAA,MAC1D,CACD;AACD,OAAC,EAAE,SAAS,MAAA,IAAU,wBAAwB,sBAAsB,kBAAkB,GAAG;AAAA,IAC3F;AAAA,EACF;AACA,MAAI,QAAQ,WAAW,GAAG;AACxB,WAAO,MAAM,mFAAmF;AAChG,YAAQ,KAAK,CAAC;AAAA,EAChB;AACA,QAAM,SAAS,QAAQ,KAAK,GAAG;AAC/B,SAAO,KAAK,qBAAqB,MAAM,EAAE;AAGzC,QAAM,YAAgC,QAAQ,SAAS;AACvD,QAAM,SAAS,MAAM,QAAQ,CAAC,GAAG,QAAQ,MAAM,CAAC,GAAG;AAAA,IACjD,KAAK,QAAQ,IAAA;AAAA,IACb;AAAA,IACA;AAAA,IACA,0BAA0B;AAAA,IAC1B,aAAa;AAAA,IACb,OAAO,CAAC,WAAW,QAAQ,MAAM;AAAA,EAAA,CAClC;AAED,QAAM,EAAE,QAAQ,OAAA,IAAW;AAC3B,MAAI,CAAC,UAAU,CAAC,QAAQ;AACtB,WAAO,MAAM,kCAAkC;AAC/C,YAAQ,KAAK,CAAC;AAAA,EAChB;AAGA,MAAI,OAAO;AACT,QAAI,CAAC,OAAO,OAAO;AACjB,aAAO,MAAM,gEAAgE;AAC7E,cAAQ,KAAK,CAAC;AAAA,IAChB;AACA,WAAO,MAAM,MAAM,KAAK;AACxB,WAAO,MAAM,IAAA;AAAA,EACf;AAEA,QAAM,iBAAiB,CAAC,MAAc,UAA4B;AAChE,QAAI,CAAC,iBAAkB;AACvB,UAAM,cAAc,KAAK,KAAA;AACzB,QAAI,CAAC,YAAa;AAElB,kBAAc,IAAI,WAAW;AAE7B,UAAM,YAAY,KAAK,IAAA,IAAQ;AAC/B,UAAM,iBAAiB,kBAAkB,OAAO,aAAa,SAAS;AAEtE,UAAM,YAAY,IAAI,eAAe,qBAAqB,cAAc;AAGxE,cAAA,EAAY,IAAI,SAAS;AAAA,EAC3B;AAEA,MAAI,eAAe;AACnB,MAAI,eAAe;AAGnB,SAAO,GAAG,QAAQ,CAAC,SAAiB;AAClC,oBAAgB,KAAK,SAAA;AACrB,UAAM,QAAQ,aAAa,MAAM,IAAI;AAErC,mBAAe,MAAM,SAAS;AAE9B,eAAW,QAAQ,OAAO;AACxB,qBAAe,MAAM,MAAM;AAAA,IAC7B;AAAA,EACF,CAAC;AAGD,SAAO,GAAG,QAAQ,CAAC,SAAiB;AAClC,oBAAgB,KAAK,SAAA;AACrB,UAAM,QAAQ,aAAa,MAAM,IAAI;AAErC,mBAAe,MAAM,SAAS;AAE9B,eAAW,QAAQ,OAAO;AACxB,qBAAe,MAAM,OAAO;AAAA,IAC9B;AAAA,EACF,CAAC;AAED,SAAO,GAAG,SAAS,CAAA,QAAO;AACxB,WAAO,MAAM,iBAAiB,MAAM,GAAG;AACvC,WAAO,MAAM,GAAG;AAChB,YAAQ,KAAK,CAAC;AAAA,EAChB,CAAC;AAED,SAAO,GAAG,SAAS,CAAA,SAAQ;AAEzB,QAAI,aAAa,QAAQ;AACvB,qBAAe,cAAc,MAAM;AAAA,IACrC;AACA,QAAI,aAAa,QAAQ;AACvB,qBAAe,cAAc,OAAO;AAAA,IACtC;AAEA,QAAI,CAAC,MAAM;AACT,aAAO,MAAM,GAAG,MAAM,uBAAuB;AAAA,IAC/C,OAAO;AACL,aAAO,MAAM,GAAG,MAAM,qBAAqB,IAAI,GAAG;AAAA,IACpD;AACA,YAAQ,KAAK,IAAI;AAAA,EACnB,CAAC;AACD,QAAM,aAAa,MAAM;AACvB,QAAI,OAAO,OAAQ;AACnB,WAAO,QAAA;AACP,WAAO,QAAA;AACP,WAAO,KAAA;AAAA,EACT;AACA,SAAO,GAAG,SAAS,MAAM;AACvB,WAAO,mBAAmB,OAAO;AACjC,WAAO,mBAAmB,OAAO;AACjC,YAAQ,GAAG,UAAU,UAAU;AAC/B,YAAQ,GAAG,WAAW,UAAU;AAChC,YAAQ,GAAG,cAAc,UAAU;AAAA,EACrC,CAAC;AACH;"}
+{"version":3,"file":"run.js","sources":["../../../src/server/cli/run.ts"],"sourcesContent":["import { spawn } from \"node:child_process\";\nimport { readFileSync } from \"node:fs\";\nimport type { AddressInfo } from \"node:net\";\nimport * as path from \"node:path\";\nimport * as readline from \"node:readline\";\nimport type { SerializedLog } from \"@sentry/core\";\nimport { metrics } from \"@sentry/node\";\nimport { Searcher } from \"fast-fuzzy\";\nimport { uuidv7 } from \"uuidv7\";\nimport { SENTRY_CONTENT_TYPE } from \"../constants.ts\";\nimport { logger } from \"../logger.ts\";\nimport type { SentryLogEvent } from \"../parser/types.ts\";\nimport type { CLIHandlerOptions, Command, CommandMeta } from \"../types/cli.ts\";\nimport { detectDockerCompose, parseExplicitDockerCompose, prepareDockerComposeRun } from \"../utils/docker-compose.ts\";\nimport { getSpotlightURL, openInBrowser } from \"../utils/extras.ts\";\nimport { EventContainer, getBuffer } from \"../utils/index.ts\";\nimport { type OnItemCallback, handler as tail } from \"./tail.ts\";\n\nexport const meta: CommandMeta = {\n  name: \"run\",\n  short: \"Run your app with automatic Spotlight instrumentation\",\n  usage: \"spotlight run [options] [command...]\",\n  long: `Run your application with Spotlight, automatically setting up the necessary\nenvironment variables and capturing telemetry data.\n\nIf no command is provided, Spotlight auto-detects:\n  - Docker Compose projects (docker-compose.yml, compose.yml, etc.)\n  - package.json scripts (dev, develop, serve, start)\n\nEnvironment variables set automatically:\n  - SENTRY_SPOTLIGHT=http://localhost:<port>/stream\n  - NEXT_PUBLIC_SENTRY_SPOTLIGHT=http://localhost:<port>/stream\n  - SENTRY_TRACES_SAMPLE_RATE=1\n\nstdout/stderr are captured and sent to Spotlight as log events.`,\n  examples: [\n    \"spotlight run                      # Auto-detect and run (package.json or docker-compose)\",\n    \"spotlight run node server.js       # Run a specific command with Spotlight\",\n    \"spotlight run -p 3000 npm start    # Run with custom port\",\n    \"spotlight run python manage.py runserver  # Run Python app\",\n    \"spotlight run docker compose up    # Run Docker Compose with Spotlight injection\",\n  ],\n};\n\nconst SPOTLIGHT_VERSION = process.env.npm_package_version || \"unknown\";\n\n// Environment variable host configurations\nconst LOCALHOST_HOST = \"localhost\";\n\n/**\n * Detect if there's a package.json with runnable scripts\n */\nfunction detectPackageJson(): { scriptName: string; scriptCommand: string } | null {\n  try {\n    const scripts = JSON.parse(readFileSync(\"./package.json\", \"utf-8\")).scripts;\n    const scriptName = [\"dev\", \"develop\", \"serve\", \"start\"].find(name => scripts[name]);\n    if (!scriptName || !scripts[scriptName]) {\n      return null;\n    }\n    return { scriptName, scriptCommand: scripts[scriptName] };\n  } catch {\n    // pass\n  }\n  return null;\n}\n\n/**\n * Prompt the user to choose between Docker Compose and package.json\n */\nasync function promptUserChoice(): Promise<\"docker\" | \"package\"> {\n  const rl = readline.createInterface({\n    input: process.stdin,\n    output: process.stdout,\n  });\n\n  return new Promise(resolve => {\n    console.log(\"\\n⚠️  Both Docker Compose and package.json detected!\");\n    console.log(\"\\nWhich would you like to use?\");\n    console.log(\"  1) docker compose\");\n    console.log(\"  2) package.json\");\n\n    rl.question(\"Enter your choice (1 or 2): \", answer => {\n      rl.close();\n      const choice = answer.trim();\n      const selected = choice === \"2\" ? \"package\" : \"docker\";\n      logger.info(`Selected: ${selected === \"docker\" ? \"Docker compose\" : \"package.json\"}`);\n      resolve(selected);\n    });\n  });\n}\n\nfunction createLogEnvelope(level: \"info\" | \"error\", body: string, timestamp: number): Buffer {\n  const envelopeHeader = {\n    sdk: {\n      name: \"sentry.spotlight.stdio\",\n      version: SPOTLIGHT_VERSION,\n    },\n  };\n\n  const logItem: SerializedLog = {\n    timestamp,\n    level,\n    body,\n    attributes: {},\n  };\n\n  const logPayload: SentryLogEvent = {\n    type: \"log\",\n    event_id: uuidv7(),\n    timestamp,\n    items: [\n      {\n        ...logItem,\n        id: uuidv7(),\n        severity_number: level === \"error\" ? 17 : 9, // ERROR=17, INFO=9 per OpenTelemetry spec\n        sdk: undefined,\n      },\n    ],\n  };\n\n  const payloadJson = JSON.stringify(logPayload);\n  const payloadBuffer = Buffer.from(payloadJson, \"utf-8\");\n\n  const itemHeader = {\n    type: \"log\",\n    length: payloadBuffer.length, // Use byte length, not string length\n    item_count: 1,\n    content_type: \"application/json\",\n  };\n\n  const parts = [JSON.stringify(envelopeHeader), JSON.stringify(itemHeader), payloadJson];\n\n  return Buffer.from(`${parts.join(\"\\n\")}\\n`, \"utf-8\");\n}\n\nexport async function handler({\n  port,\n  cmdArgs,\n  basePath,\n  filesToServe,\n  format,\n  allowedOrigins,\n  open,\n}: CLIHandlerOptions) {\n  let relayStdioAsLogs = true;\n\n  const fuzzySearcher = new Searcher([] as string[], {\n    threshold: 0.8,\n    ignoreCase: false,\n  });\n\n  const logChecker: OnItemCallback = (type, item, envelopeHeader) => {\n    if (type !== \"log\") return true;\n\n    const [, payload] = item;\n    const logEvent = payload as SentryLogEvent;\n\n    if (logEvent.items && logEvent.items.length > 0) {\n      for (const logItem of logEvent.items) {\n        // Check if this is a stdio log from Spotlight itself\n        if (envelopeHeader.sdk?.name === \"sentry.spotlight.stdio\") {\n          continue;\n        }\n\n        if (!relayStdioAsLogs) continue;\n\n        const logBody = typeof logItem.body === \"string\" ? logItem.body : String(logItem.body);\n        const trimmedBody = logBody.trim();\n\n        if (trimmedBody) {\n          const matches = fuzzySearcher.search(trimmedBody);\n          if (matches.length > 0) {\n            logger.debug(\"Detected Sentry logging in the process, disabling stdio relay\");\n            relayStdioAsLogs = false;\n            return false;\n          }\n        }\n      }\n    }\n\n    return true;\n  };\n\n  const serverInstance = await tail({ port, cmdArgs: [], basePath, filesToServe, format, allowedOrigins }, logChecker);\n  if (!serverInstance) {\n    logger.error(\"Failed to start Spotlight sidecar server.\");\n    logger.error(`The port ${port} might already be in use — most likely by another Spotlight instance.`);\n    process.exit(1);\n  }\n\n  // We *MUST* have an instance address and a port here\n  // as not having that indicates either the server did not start\n  // or started in a weird manner (like over a unix socket)\n  const actualServerPort = (serverInstance.address() as AddressInfo).port;\n  const spotlightUrl = getSpotlightURL(actualServerPort, LOCALHOST_HOST);\n\n  if (open) {\n    openInBrowser(actualServerPort);\n  }\n  let shell = false;\n  let stdin: string | undefined = undefined;\n  const env = {\n    ...process.env,\n    SENTRY_SPOTLIGHT: spotlightUrl,\n    // We need the one below for Next.js projects -- they only allow NEXT_PUBLIC_ prefixed env vars\n    // on frontend code\n    NEXT_PUBLIC_SENTRY_SPOTLIGHT: spotlightUrl,\n    // This is not supported in all SDKs but worth adding\n    // for the ones that support it\n    SENTRY_TRACES_SAMPLE_RATE: \"1\",\n  } as {\n    PATH: string;\n    SENTRY_SPOTLIGHT: string;\n    NEXT_PUBLIC_SENTRY_SPOTLIGHT: string;\n    SENTRY_TRACES_SAMPLE_RATE: string;\n    [key: string]: string;\n  };\n  if (cmdArgs.length === 0) {\n    const dockerCompose = detectDockerCompose();\n    const packageJson = detectPackageJson();\n\n    // If both Docker Compose and package.json are detected, ask the user which one to use\n    if (dockerCompose && packageJson) {\n      if (!process.stdin.isTTY) {\n        logger.error(\"Both Docker Compose and package.json detected, but cannot prompt in non-interactive mode.\");\n        logger.error(\"Please specify a command explicitly or run in an interactive terminal.\");\n        process.exit(1);\n      }\n      const choice = await promptUserChoice();\n      metrics.count(\"cli.run.prompt_choice\", 1, { attributes: { choice } });\n\n      if (choice === \"docker\") {\n        logger.info(\n          `Detected Docker Compose project with ${dockerCompose.serviceNames.length} service(s): ${dockerCompose.serviceNames.join(\", \")}`,\n        );\n        metrics.count(\"cli.run.autodetect\", 1, { attributes: { type: \"docker-compose\" } });\n        ({ cmdArgs, stdin } = prepareDockerComposeRun(dockerCompose, actualServerPort, env));\n      } else {\n        logger.info(`Using package.json script: ${packageJson.scriptName}`);\n        metrics.count(\"cli.run.autodetect\", 1, { attributes: { type: \"package-json\" } });\n        cmdArgs = [packageJson.scriptCommand];\n        shell = true;\n        env.PATH = path.resolve(\"./node_modules/.bin\") + path.delimiter + env.PATH;\n      }\n    } else if (dockerCompose) {\n      logger.info(\n        `Detected Docker Compose project with ${dockerCompose.serviceNames.length} service(s): ${dockerCompose.serviceNames.join(\", \")}`,\n      );\n      metrics.count(\"cli.run.autodetect\", 1, { attributes: { type: \"docker-compose\" } });\n      ({ cmdArgs, stdin } = prepareDockerComposeRun(dockerCompose, actualServerPort, env));\n    } else if (packageJson) {\n      logger.info(`Using package.json script: ${packageJson.scriptName}`);\n      metrics.count(\"cli.run.autodetect\", 1, { attributes: { type: \"package-json\" } });\n      cmdArgs = [packageJson.scriptCommand];\n      shell = true;\n      env.PATH = path.resolve(\"./node_modules/.bin\") + path.delimiter + env.PATH;\n    }\n  } else {\n    // Handle explicit docker compose commands (e.g., \"spotlight run docker compose up\")\n    const explicitDockerConfig = parseExplicitDockerCompose(cmdArgs);\n    if (explicitDockerConfig) {\n      logger.info(\n        `Detected explicit Docker Compose command with ${explicitDockerConfig.serviceNames.length} service(s): ${explicitDockerConfig.serviceNames.join(\", \")}`,\n      );\n      metrics.count(\"cli.run.docker_compose.explicit\", 1, {\n        attributes: {\n          services: explicitDockerConfig.serviceNames.length,\n          subcommand: explicitDockerConfig.subcommandArgs.join(\" \"),\n        },\n      });\n      ({ cmdArgs, stdin } = prepareDockerComposeRun(explicitDockerConfig, actualServerPort, env));\n    }\n  }\n  if (cmdArgs.length === 0) {\n    logger.error(\"Error: No command specified to run and could not infer the command automatically.\");\n    process.exit(1);\n  }\n  const cmdStr = cmdArgs.join(\" \");\n  logger.info(`Starting command: ${cmdStr}`);\n  // When we have Docker Compose override YAML (for -f -), we need to pipe stdin\n  // Otherwise, inherit stdin to relay user input to the downstream process\n  const stdinMode: \"pipe\" | \"inherit\" = stdin ? \"pipe\" : \"inherit\";\n  const runCmd = spawn(cmdArgs[0], cmdArgs.slice(1), {\n    cwd: process.cwd(),\n    env,\n    shell,\n    windowsVerbatimArguments: true,\n    windowsHide: true,\n    stdio: [stdinMode, \"pipe\", \"pipe\"],\n  });\n\n  const { stdout, stderr } = runCmd;\n  if (!stdout || !stderr) {\n    logger.error(\"Failed to create process streams\");\n    process.exit(1);\n  }\n\n  // If our command has a stdin input _and_ we can send to stdin, write and close\n  if (stdin) {\n    if (!runCmd.stdin) {\n      logger.error(\"Failed to pipe Docker Compose override: stdin is not available\");\n      process.exit(1);\n    }\n    runCmd.stdin.write(stdin);\n    runCmd.stdin.end();\n  }\n\n  const processLogLine = (line: string, level: \"info\" | \"error\") => {\n    if (!relayStdioAsLogs) return;\n    const trimmedLine = line.trim();\n    if (!trimmedLine) return;\n\n    fuzzySearcher.add(trimmedLine);\n\n    const timestamp = Date.now() / 1000;\n    const envelopeBuffer = createLogEnvelope(level, trimmedLine, timestamp);\n\n    const container = new EventContainer(SENTRY_CONTENT_TYPE, envelopeBuffer);\n    // Add to buffer - this will automatically trigger all subscribers\n    // including the onEnvelope callback registered in tail()\n    getBuffer().put(container);\n  };\n\n  let stdoutBuffer = \"\";\n  let stderrBuffer = \"\";\n\n  // Stream stdout as info-level logs\n  stdout.on(\"data\", (data: Buffer) => {\n    stdoutBuffer += data.toString();\n    const lines = stdoutBuffer.split(\"\\n\");\n    // Keep the last partial line in the buffer\n    stdoutBuffer = lines.pop() || \"\";\n\n    for (const line of lines) {\n      processLogLine(line, \"info\");\n    }\n  });\n\n  // Stream stderr as error-level logs\n  stderr.on(\"data\", (data: Buffer) => {\n    stderrBuffer += data.toString();\n    const lines = stderrBuffer.split(\"\\n\");\n    // Keep the last partial line in the buffer\n    stderrBuffer = lines.pop() || \"\";\n\n    for (const line of lines) {\n      processLogLine(line, \"error\");\n    }\n  });\n\n  runCmd.on(\"error\", err => {\n    logger.error(`Failed to run ${cmdStr}:`);\n    logger.error(err);\n    process.exit(1);\n  });\n\n  runCmd.on(\"close\", code => {\n    // Handle any remaining buffered lines\n    if (stdoutBuffer.trim()) {\n      processLogLine(stdoutBuffer, \"info\");\n    }\n    if (stderrBuffer.trim()) {\n      processLogLine(stderrBuffer, \"error\");\n    }\n\n    if (!code) {\n      logger.error(`${cmdStr} exited, terminating.`);\n    } else {\n      logger.error(`${cmdStr} exited with code ${code}.`);\n    }\n    process.exit(code);\n  });\n  const killRunCmd = () => {\n    if (runCmd.killed) return;\n    stdout.destroy();\n    stderr.destroy();\n    runCmd.kill();\n  };\n  runCmd.on(\"spawn\", () => {\n    runCmd.removeAllListeners(\"spawn\");\n    runCmd.removeAllListeners(\"error\");\n    process.on(\"SIGINT\", killRunCmd);\n    process.on(\"SIGTERM\", killRunCmd);\n    process.on(\"beforeExit\", killRunCmd);\n  });\n}\n\nexport default { meta, handler } satisfies Command;\n"],"names":["tail"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAkBO,MAAM,OAAoB;AAAA,EAC/B,MAAM;AAAA,EACN,OAAO;AAAA,EACP,OAAO;AAAA,EACP,MAAM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAaN,UAAU;AAAA,IACR;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EAAA;AAEJ;AAEA,MAAM,oBAAoB;AAG1B,MAAM,iBAAiB;AAKvB,SAAS,oBAA0E;AACjF,MAAI;AACF,UAAM,UAAU,KAAK,MAAM,aAAa,kBAAkB,OAAO,CAAC,EAAE;AACpE,UAAM,aAAa,CAAC,OAAO,WAAW,SAAS,OAAO,EAAE,KAAK,CAAA,SAAQ,QAAQ,IAAI,CAAC;AAClF,QAAI,CAAC,cAAc,CAAC,QAAQ,UAAU,GAAG;AACvC,aAAO;AAAA,IACT;AACA,WAAO,EAAE,YAAY,eAAe,QAAQ,UAAU,EAAA;AAAA,EACxD,QAAQ;AAAA,EAER;AACA,SAAO;AACT;AAKA,eAAe,mBAAkD;AAC/D,QAAM,KAAK,SAAS,gBAAgB;AAAA,IAClC,OAAO,QAAQ;AAAA,IACf,QAAQ,QAAQ;AAAA,EAAA,CACjB;AAED,SAAO,IAAI,QAAQ,CAAA,YAAW;AAC5B,YAAQ,IAAI,sDAAsD;AAClE,YAAQ,IAAI,gCAAgC;AAC5C,YAAQ,IAAI,qBAAqB;AACjC,YAAQ,IAAI,mBAAmB;AAE/B,OAAG,SAAS,gCAAgC,CAAA,WAAU;AACpD,SAAG,MAAA;AACH,YAAM,SAAS,OAAO,KAAA;AACtB,YAAM,WAAW,WAAW,MAAM,YAAY;AAC9C,aAAO,KAAK,aAAa,aAAa,WAAW,mBAAmB,cAAc,EAAE;AACpF,cAAQ,QAAQ;AAAA,IAClB,CAAC;AAAA,EACH,CAAC;AACH;AAEA,SAAS,kBAAkB,OAAyB,MAAc,WAA2B;AAC3F,QAAM,iBAAiB;AAAA,IACrB,KAAK;AAAA,MACH,MAAM;AAAA,MACN,SAAS;AAAA,IAAA;AAAA,EACX;AAGF,QAAM,UAAyB;AAAA,IAC7B;AAAA,IACA;AAAA,IACA;AAAA,IACA,YAAY,CAAA;AAAA,EAAC;AAGf,QAAM,aAA6B;AAAA,IACjC,MAAM;AAAA,IACN,UAAU,OAAA;AAAA,IACV;AAAA,IACA,OAAO;AAAA,MACL;AAAA,QACE,GAAG;AAAA,QACH,IAAI,OAAA;AAAA,QACJ,iBAAiB,UAAU,UAAU,KAAK;AAAA;AAAA,QAC1C,KAAK;AAAA,MAAA;AAAA,IACP;AAAA,EACF;AAGF,QAAM,cAAc,KAAK,UAAU,UAAU;AAC7C,QAAM,gBAAgB,OAAO,KAAK,aAAa,OAAO;AAEtD,QAAM,aAAa;AAAA,IACjB,MAAM;AAAA,IACN,QAAQ,cAAc;AAAA;AAAA,IACtB,YAAY;AAAA,IACZ,cAAc;AAAA,EAAA;AAGhB,QAAM,QAAQ,CAAC,KAAK,UAAU,cAAc,GAAG,KAAK,UAAU,UAAU,GAAG,WAAW;AAEtF,SAAO,OAAO,KAAK,GAAG,MAAM,KAAK,IAAI,CAAC;AAAA,GAAM,OAAO;AACrD;AAEA,eAAsB,QAAQ;AAAA,EAC5B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAAsB;AACpB,MAAI,mBAAmB;AAEvB,QAAM,gBAAgB,IAAI,SAAS,IAAgB;AAAA,IACjD,WAAW;AAAA,IACX,YAAY;AAAA,EAAA,CACb;AAED,QAAM,aAA6B,CAAC,MAAM,MAAM,mBAAmB;AACjE,QAAI,SAAS,MAAO,QAAO;AAE3B,UAAM,CAAA,EAAG,OAAO,IAAI;AACpB,UAAM,WAAW;AAEjB,QAAI,SAAS,SAAS,SAAS,MAAM,SAAS,GAAG;AAC/C,iBAAW,WAAW,SAAS,OAAO;AAEpC,YAAI,eAAe,KAAK,SAAS,0BAA0B;AACzD;AAAA,QACF;AAEA,YAAI,CAAC,iBAAkB;AAEvB,cAAM,UAAU,OAAO,QAAQ,SAAS,WAAW,QAAQ,OAAO,OAAO,QAAQ,IAAI;AACrF,cAAM,cAAc,QAAQ,KAAA;AAE5B,YAAI,aAAa;AACf,gBAAM,UAAU,cAAc,OAAO,WAAW;AAChD,cAAI,QAAQ,SAAS,GAAG;AACtB,mBAAO,MAAM,+DAA+D;AAC5E,+BAAmB;AACnB,mBAAO;AAAA,UACT;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAEA,WAAO;AAAA,EACT;AAEA,QAAM,iBAAiB,MAAMA,UAAK,EAAE,MAAM,SAAS,IAAI,UAAU,cAAc,QAAQ,eAAA,GAAkB,UAAU;AACnH,MAAI,CAAC,gBAAgB;AACnB,WAAO,MAAM,2CAA2C;AACxD,WAAO,MAAM,YAAY,IAAI,uEAAuE;AACpG,YAAQ,KAAK,CAAC;AAAA,EAChB;AAKA,QAAM,mBAAoB,eAAe,QAAA,EAA0B;AACnE,QAAM,eAAe,gBAAgB,kBAAkB,cAAc;AAErE,MAAI,MAAM;AACR,kBAAc,gBAAgB;AAAA,EAChC;AACA,MAAI,QAAQ;AACZ,MAAI,QAA4B;AAChC,QAAM,MAAM;AAAA,IACV,GAAG,QAAQ;AAAA,IACX,kBAAkB;AAAA;AAAA;AAAA,IAGlB,8BAA8B;AAAA;AAAA;AAAA,IAG9B,2BAA2B;AAAA,EAAA;AAQ7B,MAAI,QAAQ,WAAW,GAAG;AACxB,UAAM,gBAAgB,oBAAA;AACtB,UAAM,cAAc,kBAAA;AAGpB,QAAI,iBAAiB,aAAa;AAChC,UAAI,CAAC,QAAQ,MAAM,OAAO;AACxB,eAAO,MAAM,2FAA2F;AACxG,eAAO,MAAM,wEAAwE;AACrF,gBAAQ,KAAK,CAAC;AAAA,MAChB;AACA,YAAM,SAAS,MAAM,iBAAA;AACrB,cAAQ,MAAM,yBAAyB,GAAG,EAAE,YAAY,EAAE,OAAA,GAAU;AAEpE,UAAI,WAAW,UAAU;AACvB,eAAO;AAAA,UACL,wCAAwC,cAAc,aAAa,MAAM,gBAAgB,cAAc,aAAa,KAAK,IAAI,CAAC;AAAA,QAAA;AAEhI,gBAAQ,MAAM,sBAAsB,GAAG,EAAE,YAAY,EAAE,MAAM,iBAAA,GAAoB;AACjF,SAAC,EAAE,SAAS,MAAA,IAAU,wBAAwB,eAAe,kBAAkB,GAAG;AAAA,MACpF,OAAO;AACL,eAAO,KAAK,8BAA8B,YAAY,UAAU,EAAE;AAClE,gBAAQ,MAAM,sBAAsB,GAAG,EAAE,YAAY,EAAE,MAAM,eAAA,GAAkB;AAC/E,kBAAU,CAAC,YAAY,aAAa;AACpC,gBAAQ;AACR,YAAI,OAAO,KAAK,QAAQ,qBAAqB,IAAI,KAAK,YAAY,IAAI;AAAA,MACxE;AAAA,IACF,WAAW,eAAe;AACxB,aAAO;AAAA,QACL,wCAAwC,cAAc,aAAa,MAAM,gBAAgB,cAAc,aAAa,KAAK,IAAI,CAAC;AAAA,MAAA;AAEhI,cAAQ,MAAM,sBAAsB,GAAG,EAAE,YAAY,EAAE,MAAM,iBAAA,GAAoB;AACjF,OAAC,EAAE,SAAS,MAAA,IAAU,wBAAwB,eAAe,kBAAkB,GAAG;AAAA,IACpF,WAAW,aAAa;AACtB,aAAO,KAAK,8BAA8B,YAAY,UAAU,EAAE;AAClE,cAAQ,MAAM,sBAAsB,GAAG,EAAE,YAAY,EAAE,MAAM,eAAA,GAAkB;AAC/E,gBAAU,CAAC,YAAY,aAAa;AACpC,cAAQ;AACR,UAAI,OAAO,KAAK,QAAQ,qBAAqB,IAAI,KAAK,YAAY,IAAI;AAAA,IACxE;AAAA,EACF,OAAO;AAEL,UAAM,uBAAuB,2BAA2B,OAAO;AAC/D,QAAI,sBAAsB;AACxB,aAAO;AAAA,QACL,iDAAiD,qBAAqB,aAAa,MAAM,gBAAgB,qBAAqB,aAAa,KAAK,IAAI,CAAC;AAAA,MAAA;AAEvJ,cAAQ,MAAM,mCAAmC,GAAG;AAAA,QAClD,YAAY;AAAA,UACV,UAAU,qBAAqB,aAAa;AAAA,UAC5C,YAAY,qBAAqB,eAAe,KAAK,GAAG;AAAA,QAAA;AAAA,MAC1D,CACD;AACD,OAAC,EAAE,SAAS,MAAA,IAAU,wBAAwB,sBAAsB,kBAAkB,GAAG;AAAA,IAC3F;AAAA,EACF;AACA,MAAI,QAAQ,WAAW,GAAG;AACxB,WAAO,MAAM,mFAAmF;AAChG,YAAQ,KAAK,CAAC;AAAA,EAChB;AACA,QAAM,SAAS,QAAQ,KAAK,GAAG;AAC/B,SAAO,KAAK,qBAAqB,MAAM,EAAE;AAGzC,QAAM,YAAgC,QAAQ,SAAS;AACvD,QAAM,SAAS,MAAM,QAAQ,CAAC,GAAG,QAAQ,MAAM,CAAC,GAAG;AAAA,IACjD,KAAK,QAAQ,IAAA;AAAA,IACb;AAAA,IACA;AAAA,IACA,0BAA0B;AAAA,IAC1B,aAAa;AAAA,IACb,OAAO,CAAC,WAAW,QAAQ,MAAM;AAAA,EAAA,CAClC;AAED,QAAM,EAAE,QAAQ,OAAA,IAAW;AAC3B,MAAI,CAAC,UAAU,CAAC,QAAQ;AACtB,WAAO,MAAM,kCAAkC;AAC/C,YAAQ,KAAK,CAAC;AAAA,EAChB;AAGA,MAAI,OAAO;AACT,QAAI,CAAC,OAAO,OAAO;AACjB,aAAO,MAAM,gEAAgE;AAC7E,cAAQ,KAAK,CAAC;AAAA,IAChB;AACA,WAAO,MAAM,MAAM,KAAK;AACxB,WAAO,MAAM,IAAA;AAAA,EACf;AAEA,QAAM,iBAAiB,CAAC,MAAc,UAA4B;AAChE,QAAI,CAAC,iBAAkB;AACvB,UAAM,cAAc,KAAK,KAAA;AACzB,QAAI,CAAC,YAAa;AAElB,kBAAc,IAAI,WAAW;AAE7B,UAAM,YAAY,KAAK,IAAA,IAAQ;AAC/B,UAAM,iBAAiB,kBAAkB,OAAO,aAAa,SAAS;AAEtE,UAAM,YAAY,IAAI,eAAe,qBAAqB,cAAc;AAGxE,cAAA,EAAY,IAAI,SAAS;AAAA,EAC3B;AAEA,MAAI,eAAe;AACnB,MAAI,eAAe;AAGnB,SAAO,GAAG,QAAQ,CAAC,SAAiB;AAClC,oBAAgB,KAAK,SAAA;AACrB,UAAM,QAAQ,aAAa,MAAM,IAAI;AAErC,mBAAe,MAAM,SAAS;AAE9B,eAAW,QAAQ,OAAO;AACxB,qBAAe,MAAM,MAAM;AAAA,IAC7B;AAAA,EACF,CAAC;AAGD,SAAO,GAAG,QAAQ,CAAC,SAAiB;AAClC,oBAAgB,KAAK,SAAA;AACrB,UAAM,QAAQ,aAAa,MAAM,IAAI;AAErC,mBAAe,MAAM,SAAS;AAE9B,eAAW,QAAQ,OAAO;AACxB,qBAAe,MAAM,OAAO;AAAA,IAC9B;AAAA,EACF,CAAC;AAED,SAAO,GAAG,SAAS,CAAA,QAAO;AACxB,WAAO,MAAM,iBAAiB,MAAM,GAAG;AACvC,WAAO,MAAM,GAAG;AAChB,YAAQ,KAAK,CAAC;AAAA,EAChB,CAAC;AAED,SAAO,GAAG,SAAS,CAAA,SAAQ;AAEzB,QAAI,aAAa,QAAQ;AACvB,qBAAe,cAAc,MAAM;AAAA,IACrC;AACA,QAAI,aAAa,QAAQ;AACvB,qBAAe,cAAc,OAAO;AAAA,IACtC;AAEA,QAAI,CAAC,MAAM;AACT,aAAO,MAAM,GAAG,MAAM,uBAAuB;AAAA,IAC/C,OAAO;AACL,aAAO,MAAM,GAAG,MAAM,qBAAqB,IAAI,GAAG;AAAA,IACpD;AACA,YAAQ,KAAK,IAAI;AAAA,EACnB,CAAC;AACD,QAAM,aAAa,MAAM;AACvB,QAAI,OAAO,OAAQ;AACnB,WAAO,QAAA;AACP,WAAO,QAAA;AACP,WAAO,KAAA;AAAA,EACT;AACA,SAAO,GAAG,SAAS,MAAM;AACvB,WAAO,mBAAmB,OAAO;AACjC,WAAO,mBAAmB,OAAO;AACjC,YAAQ,GAAG,UAAU,UAAU;AAC/B,YAAQ,GAAG,WAAW,UAAU;AAChC,YAAQ,GAAG,cAAc,UAAU;AAAA,EACrC,CAAC;AACH;AAEA,MAAA,MAAe,EAAE,MAAM,QAAA;"}

package/dist/server/cli/server.d.ts

@@ -1,2 +1,8 @@
-import { CLIHandlerOptions } from '../types/cli.ts';
-export default function server({ port, basePath, filesToServe, allowedOrigins, open }: CLIHandlerOptions): Promise<import('http').Server<typeof import('http').IncomingMessage, typeof import('http').ServerResponse> | undefined>;
+import { CLIHandlerOptions, CommandMeta } from '../types/cli.ts';
+export declare const meta: CommandMeta;
+export declare function handler({ port, basePath, filesToServe, allowedOrigins, open }: CLIHandlerOptions): Promise<import('http').Server<typeof import('http').IncomingMessage, typeof import('http').ServerResponse> | undefined>;
+declare const _default: {
+    meta: CommandMeta;
+    handler: typeof handler;
+};
+export default _default;

package/dist/server/cli/server.js

@@ -2,14 +2,35 @@
 !function() {
   try {
     var e = "undefined" != typeof window ? window : "undefined" != typeof global ? global : "undefined" != typeof globalThis ? globalThis : "undefined" != typeof self ? self : {}, n = new e.Error().stack;
-    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "1a9ea3ae-07f6-4bc5-bad0-6e4e8f4aaa3f", e._sentryDebugIdIdentifier = "sentry-dbid-1a9ea3ae-07f6-4bc5-bad0-6e4e8f4aaa3f");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "ce0912cd-6bc9-403e-885e-b9e4cee0c3a4", e._sentryDebugIdIdentifier = "sentry-dbid-ce0912cd-6bc9-403e-885e-b9e4cee0c3a4");
   } catch (e2) {
   }
 }();
 import { setupSpotlight } from "../main.js";
 import { openInBrowser } from "../utils/extras.js";
 import "../../_virtual/_sentry-release-injection-file.js";
-async function server({ port, basePath, filesToServe, allowedOrigins, open }) {
+const meta = {
+  name: "server",
+  short: "Start the Spotlight sidecar server (default command)",
+  usage: "spotlight [server] [options]",
+  long: `Start the Spotlight sidecar HTTP server.
+
+This is the default command when running 'spotlight' without arguments.
+The server listens for events from Sentry SDKs and serves the Spotlight UI.
+
+The server provides:
+  - HTTP endpoint for receiving Sentry envelopes
+  - Server-Sent Events (SSE) stream for real-time updates
+  - Web UI at http://localhost:PORT`,
+  examples: [
+    "spotlight                          # Start on default port 8969",
+    "spotlight server                   # Explicit server command",
+    "spotlight --open                   # Start and open dashboard in browser",
+    "spotlight --port 3000              # Start on port 3000",
+    "spotlight -p 3000 -d               # Start on port 3000 with debug logging"
+  ]
+};
+async function handler({ port, basePath, filesToServe, allowedOrigins, open }) {
   const serverInstance = await setupSpotlight({
     port,
     basePath,
@@ -23,7 +44,10 @@ async function server({ port, basePath, filesToServe, allowedOrigins, open }) {
   }
   return serverInstance;
 }
+const server = { meta, handler };
 export {
-  server as default
+  server as default,
+  handler,
+  meta
 };
 //# sourceMappingURL=server.js.map

package/dist/server/cli/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","sources":["../../../src/server/cli/server.ts"],"sourcesContent":["import type { AddressInfo } from \"node:net\";\nimport { setupSpotlight } from \"../main.ts\";\nimport type { CLIHandlerOptions } from \"../types/cli.ts\";\nimport { openInBrowser } from \"../utils/extras.ts\";\n\nexport default async function server({ port, basePath, filesToServe, allowedOrigins, open }: CLIHandlerOptions) {\n  const serverInstance = await setupSpotlight({\n    port,\n    basePath,\n    filesToServe,\n    isStandalone: true,\n    allowedOrigins,\n  });\n\n  if (open) {\n    // Use actual port from server instance, or fall back to requested port\n    // (when serverInstance is undefined, a server is already running on the requested port)\n    const actualPort = serverInstance ? (serverInstance.address() as AddressInfo).port : port;\n    openInBrowser(actualPort);\n  }\n\n  return serverInstance;\n}\n"],"names":[],"mappings":";;;;;;;;;;;AAKA,eAA8B,OAAO,EAAE,MAAM,UAAU,cAAc,gBAAgB,QAA2B;AAC9G,QAAM,iBAAiB,MAAM,eAAe;AAAA,IAC1C;AAAA,IACA;AAAA,IACA;AAAA,IACA,cAAc;AAAA,IACd;AAAA,EAAA,CACD;AAED,MAAI,MAAM;AAGR,UAAM,aAAa,iBAAkB,eAAe,QAAA,EAA0B,OAAO;AACrF,kBAAc,UAAU;AAAA,EAC1B;AAEA,SAAO;AACT;"}
+{"version":3,"file":"server.js","sources":["../../../src/server/cli/server.ts"],"sourcesContent":["import type { AddressInfo } from \"node:net\";\nimport { setupSpotlight } from \"../main.ts\";\nimport type { CLIHandlerOptions, Command, CommandMeta } from \"../types/cli.ts\";\nimport { openInBrowser } from \"../utils/extras.ts\";\n\nexport const meta: CommandMeta = {\n  name: \"server\",\n  short: \"Start the Spotlight sidecar server (default command)\",\n  usage: \"spotlight [server] [options]\",\n  long: `Start the Spotlight sidecar HTTP server.\n\nThis is the default command when running 'spotlight' without arguments.\nThe server listens for events from Sentry SDKs and serves the Spotlight UI.\n\nThe server provides:\n  - HTTP endpoint for receiving Sentry envelopes\n  - Server-Sent Events (SSE) stream for real-time updates\n  - Web UI at http://localhost:PORT`,\n  examples: [\n    \"spotlight                          # Start on default port 8969\",\n    \"spotlight server                   # Explicit server command\",\n    \"spotlight --open                   # Start and open dashboard in browser\",\n    \"spotlight --port 3000              # Start on port 3000\",\n    \"spotlight -p 3000 -d               # Start on port 3000 with debug logging\",\n  ],\n};\n\nexport async function handler({ port, basePath, filesToServe, allowedOrigins, open }: CLIHandlerOptions) {\n  const serverInstance = await setupSpotlight({\n    port,\n    basePath,\n    filesToServe,\n    isStandalone: true,\n    allowedOrigins,\n  });\n\n  if (open) {\n    // Use actual port from server instance, or fall back to requested port\n    // (when serverInstance is undefined, a server is already running on the requested port)\n    const actualPort = serverInstance ? (serverInstance.address() as AddressInfo).port : port;\n    openInBrowser(actualPort);\n  }\n\n  return serverInstance;\n}\n\nexport default { meta, handler } satisfies Command;\n"],"names":[],"mappings":";;;;;;;;;;;AAKO,MAAM,OAAoB;AAAA,EAC/B,MAAM;AAAA,EACN,OAAO;AAAA,EACP,OAAO;AAAA,EACP,MAAM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASN,UAAU;AAAA,IACR;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EAAA;AAEJ;AAEA,eAAsB,QAAQ,EAAE,MAAM,UAAU,cAAc,gBAAgB,QAA2B;AACvG,QAAM,iBAAiB,MAAM,eAAe;AAAA,IAC1C;AAAA,IACA;AAAA,IACA;AAAA,IACA,cAAc;AAAA,IACd;AAAA,EAAA,CACD;AAED,MAAI,MAAM;AAGR,UAAM,aAAa,iBAAkB,eAAe,QAAA,EAA0B,OAAO;AACrF,kBAAc,UAAU;AAAA,EAC1B;AAEA,SAAO;AACT;AAEA,MAAA,SAAe,EAAE,MAAM,QAAA;"}

package/dist/server/cli/tail.d.ts

@@ -1,8 +1,14 @@
 import { ServerType } from '@hono/node-server';
 import { ParsedEnvelope } from '../parser/index.ts';
-import { CLIHandlerOptions } from '../types/cli.ts';
+import { CLIHandlerOptions, CommandMeta } from '../types/cli.ts';
 export type OnItemCallback = (type: string, item: ParsedEnvelope["envelope"][1][number], envelopeHeader: ParsedEnvelope["envelope"][0]) => boolean;
 export declare const NAME_TO_TYPE_MAPPING: Record<string, string[]>;
 export declare const EVERYTHING_MAGIC_WORDS: Set<string>;
 export declare const SUPPORTED_TAIL_ARGS: Set<string>;
-export default function tail({ port, cmdArgs, basePath, filesToServe, format, allowedOrigins }: CLIHandlerOptions, onItem?: OnItemCallback): Promise<ServerType | undefined>;
+export declare const meta: CommandMeta;
+export declare function handler({ port, cmdArgs, basePath, filesToServe, format, allowedOrigins }: CLIHandlerOptions, onItem?: OnItemCallback): Promise<ServerType | undefined>;
+declare const _default: {
+    meta: CommandMeta;
+    handler: typeof handler;
+};
+export default _default;

package/dist/server/cli/tail.js

@@ -2,7 +2,7 @@
 !function() {
   try {
     var e = "undefined" != typeof window ? window : "undefined" != typeof global ? global : "undefined" != typeof globalThis ? globalThis : "undefined" != typeof self ? self : {}, n = new e.Error().stack;
-    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "f35053fc-26c9-45cd-b2da-1b59b921e9cb", e._sentryDebugIdIdentifier = "sentry-dbid-f35053fc-26c9-45cd-b2da-1b59b921e9cb");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "22ba8cd6-fd16-4260-968d-aa7a00ac6ae6", e._sentryDebugIdIdentifier = "sentry-dbid-22ba8cd6-fd16-4260-968d-aa7a00ac6ae6");
   } catch (e2) {
   }
 }();
@@ -38,6 +38,28 @@ const NAME_TO_TYPE_MAPPING = Object.freeze({
 const SUPPORTED_ENVELOPE_TYPES = new Set(Object.values(NAME_TO_TYPE_MAPPING).flat());
 const EVERYTHING_MAGIC_WORDS = /* @__PURE__ */ new Set(["everything", "all", "*"]);
 const SUPPORTED_TAIL_ARGS = /* @__PURE__ */ new Set([...Object.keys(NAME_TO_TYPE_MAPPING), ...EVERYTHING_MAGIC_WORDS]);
+const meta = {
+  name: "tail",
+  short: `Tail Sentry events (types: ${Object.keys(NAME_TO_TYPE_MAPPING).join(", ")})`,
+  usage: "spotlight tail [types...] [options]",
+  long: `Stream Sentry events to your terminal in real-time.
+
+Available event types:
+  ${Object.keys(NAME_TO_TYPE_MAPPING).join(", ")}
+
+Magic words (to tail everything):
+  ${[...EVERYTHING_MAGIC_WORDS].join(", ")}
+
+Use -f/--format to change output format (human, logfmt, json, md).
+Connects to existing sidecar if running, otherwise starts a new one.`,
+  examples: [
+    "spotlight tail                     # Tail all event types (human format)",
+    "spotlight tail errors              # Tail only errors",
+    "spotlight tail errors logs         # Tail errors and logs",
+    "spotlight tail --format json       # Use JSON output format",
+    "spotlight tail traces -f logfmt    # Tail traces with logfmt format"
+  ]
+};
 const FORMATTERS = {
   md: formatters$3,
   logfmt: formatters$2,
@@ -49,7 +71,7 @@ const connectUpstream = async (port) => new Promise((resolve, reject) => {
   client.onerror = reject;
   client.onopen = () => resolve(client);
 });
-async function tail({ port, cmdArgs, basePath, filesToServe, format = "logfmt", allowedOrigins }, onItem) {
+async function handler({ port, cmdArgs, basePath, filesToServe, format = "logfmt", allowedOrigins }, onItem) {
   const eventTypes = cmdArgs.length > 0 ? cmdArgs.map((arg) => arg.toLowerCase()) : ["everything"];
   for (const eventType of eventTypes) {
     if (!SUPPORTED_TAIL_ARGS.has(eventType)) {
@@ -104,10 +126,13 @@ async function tail({ port, cmdArgs, basePath, filesToServe, format = "logfmt",
   });
   return serverInstance;
 }
+const tail = { meta, handler };
 export {
   EVERYTHING_MAGIC_WORDS,
   NAME_TO_TYPE_MAPPING,
   SUPPORTED_TAIL_ARGS,
-  tail as default
+  tail as default,
+  handler,
+  meta
 };
 //# sourceMappingURL=tail.js.map