tracer-sh 0.2.1 → 0.2.3

package/README.md

@@ -66,9 +66,19 @@ tracer-sh
 
 Open `http://localhost:3579`, go to **Settings** to add your API keys and choose an LLM — done.
 
+## Headless / CLI
+
+Run an investigation from the terminal and get back the final analysis — so other tools and agents (including Claude Code) can drive Tracer:
+
+```bash
+tracer-sh analyze "Why did checkout error rate spike after 14:00 UTC?"
+```
+
+Continue a prior run with `--session <id>`; pass `--json` for the full response (session id, queries, usage). Requires a running server.
+
 ## Supported Providers
 
-**Data:** New Relic (NRQL via NerdGraph), Google Cloud (Logs, Traces, Metrics, Errors)
+**Data:** New Relic (NRQL), Google Cloud (Logs, Traces, Metrics, Errors), PostHog (HogQL)
 
 **LLM:** Anthropic (Claude), Google (Gemini)
 

package/bin/tracer.mjs

@@ -10,6 +10,64 @@ const serverPath = resolve(__dirname, "../packages/server/dist/index.js");
 // Must match RESTART_EXIT_CODE in packages/server/src/updater.ts
 const RESTART_EXIT_CODE = 75;
 
+// `tracer analyze "<message>" [--session <id>] [--provider <name>] [--json]`
+// Runs the investigation agent on the already-running local server and prints
+// the final analysis. Lets other local agents (e.g. Claude Code) drive Tracer.
+if (process.argv[2] === "analyze") {
+  await runAnalyze(process.argv.slice(3));
+  process.exit(0);
+}
+
+async function runAnalyze(args) {
+  let message;
+  let sessionId;
+  let provider;
+  let asJson = false;
+
+  for (let i = 0; i < args.length; i++) {
+    const a = args[i];
+    if (a === "--json") asJson = true;
+    else if (a === "--session" || a === "-s") sessionId = args[++i];
+    else if (a === "--provider" || a === "-p") provider = args[++i];
+    else if (message === undefined) message = a;
+  }
+
+  if (!message) {
+    console.error('Usage: tracer-sh analyze "<message>" [--session <id>] [--provider <name>] [--json]');
+    process.exit(2);
+  }
+
+  const host = process.env.TRACER_HOST || "127.0.0.1";
+  const port = process.env.TRACER_PORT || "3579";
+  const url = `http://${host}:${port}/api/v1/analyze`;
+
+  let res;
+  try {
+    res = await fetch(url, {
+      method: "POST",
+      headers: { "content-type": "application/json" },
+      body: JSON.stringify({ message, sessionId, provider }),
+    });
+  } catch {
+    console.error(`Could not reach Tracer at ${url}. Is the server running? Start it with: tracer-sh`);
+    process.exit(1);
+  }
+
+  const data = await res.json().catch(() => ({}));
+
+  if (!res.ok || data.status === "error") {
+    console.error(`Error: ${data.error || res.statusText}`);
+    process.exit(1);
+  }
+
+  if (asJson) {
+    process.stdout.write(JSON.stringify(data, null, 2) + "\n");
+  } else {
+    process.stdout.write((data.analysis || "") + "\n");
+    console.error(`session ${data.sessionId}${data.model ? ` · ${data.model}` : ""}`);
+  }
+}
+
 const banner = `
   ╔═══════════════════════════════════╗
   ║       Tracer Debug Platform       ║

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tracer-sh",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "type": "module",
   "description": "Local-first debugging & analysis platform",
   "license": "SEE LICENSE IN LICENSE",
@@ -34,7 +34,12 @@
     "onlyBuiltDependencies": [
       "better-sqlite3",
       "esbuild"
-    ]
+    ],
+    "overrides": {
+      "mermaid": "^11.15.0",
+      "postcss": "^8.5.10",
+      "uuid": "^11.1.1"
+    }
   },
   "devDependencies": {
     "concurrently": "^9.2.1",

package/packages/server/dist/{chunk-6QUU7TGZ.js → chunk-IKD3ICQK.js}

@@ -1,3 +1,5 @@
+import { createRequire as __createRequire } from 'module'; const require = __createRequire(import.meta.url);
+
 // src/providers/gcp/domain-knowledge.ts
 var GCP_AUTH_STOP_RULE = `## Authentication Failure \u2014 STOP IMMEDIATELY
 If any tool returns an authentication or permission error (e.g. "unauthenticated", "permission denied", "credentials", "401", "403", "UNAUTHENTICATED", "insufficient permissions"), **STOP ALL FURTHER TOOL CALLS** and report:

package/packages/server/dist/{chunk-OTYSD6PF.js → chunk-L7TO4UJ4.js}

@@ -1,3 +1,5 @@
+import { createRequire as __createRequire } from 'module'; const require = __createRequire(import.meta.url);
+
 // src/providers/posthog/domain-knowledge.ts
 var POSTHOG_AUTH_STOP_RULE = `## Authentication Failure \u2014 STOP IMMEDIATELY
 If any query returns an authentication or permission error (e.g. "Invalid personal API key", "401", "403", "Unauthorized", "Forbidden"), **STOP ALL FURTHER TOOL CALLS** and report:

package/packages/server/dist/{chunk-4VNS5WPM.js → chunk-WOL2ZWU7.js}

@@ -1,3 +1,4 @@
+import { createRequire as __createRequire } from 'module'; const require = __createRequire(import.meta.url);
 var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;

package/packages/server/dist/{chunk-7J2BYJNR.js → chunk-WUFQGSGW.js}

@@ -1,7 +1,8 @@
+import { createRequire as __createRequire } from 'module'; const require = __createRequire(import.meta.url);
 import {
   __commonJS,
   __require
-} from "./chunk-4VNS5WPM.js";
+} from "./chunk-WOL2ZWU7.js";
 
 // ../../node_modules/.pnpm/@vercel+oidc@3.2.0/node_modules/@vercel/oidc/dist/token-error.js
 var require_token_error = __commonJS({

package/packages/server/dist/{chunk-5IQ4TST5.js → chunk-XFJVNMJI.js}

@@ -1,3 +1,5 @@
+import { createRequire as __createRequire } from 'module'; const require = __createRequire(import.meta.url);
+
 // src/providers/newrelic/domain-knowledge.ts
 var NR_AUTH_STOP_RULE = `## Authentication Failure \u2014 STOP IMMEDIATELY
 If any query returns an authentication or permission error (e.g. "Invalid API key", "401", "403", "Unauthorized"), **STOP ALL FURTHER TOOL CALLS** and report:

package/packages/server/dist/{domain-knowledge-WHIEZOOH.js → domain-knowledge-4AAER546.js}

@@ -1,10 +1,11 @@
+import { createRequire as __createRequire } from 'module'; const require = __createRequire(import.meta.url);
 import {
   NR_AUTH_STOP_RULE,
   NR_DOMAIN_KNOWLEDGE,
   NR_INSIDE_OUT_DEBUGGING,
   NR_SERVICE_HEALTH_RUNBOOK
-} from "./chunk-5IQ4TST5.js";
-import "./chunk-4VNS5WPM.js";
+} from "./chunk-XFJVNMJI.js";
+import "./chunk-WOL2ZWU7.js";
 export {
   NR_AUTH_STOP_RULE,
   NR_DOMAIN_KNOWLEDGE,

package/packages/server/dist/{domain-knowledge-V6AENXZV.js → domain-knowledge-A3WXZ55R.js}

@@ -1,3 +1,4 @@
+import { createRequire as __createRequire } from 'module'; const require = __createRequire(import.meta.url);
 import {
   GCP_AUTH_STOP_RULE,
   GCP_CROSS_SIGNAL,
@@ -5,8 +6,8 @@ import {
   GCP_INSIDE_OUT_DEBUGGING,
   GCP_PAGE_SIZE_RULE,
   GCP_TOOL_REFERENCE
-} from "./chunk-6QUU7TGZ.js";
-import "./chunk-4VNS5WPM.js";
+} from "./chunk-IKD3ICQK.js";
+import "./chunk-WOL2ZWU7.js";
 export {
   GCP_AUTH_STOP_RULE,
   GCP_CROSS_SIGNAL,

package/packages/server/dist/{domain-knowledge-5ZUPRLNB.js → domain-knowledge-CAD7MDFJ.js}

@@ -1,9 +1,10 @@
+import { createRequire as __createRequire } from 'module'; const require = __createRequire(import.meta.url);
 import {
   POSTHOG_AUTH_STOP_RULE,
   POSTHOG_DOMAIN_KNOWLEDGE,
   POSTHOG_INSIDE_OUT_DEBUGGING
-} from "./chunk-OTYSD6PF.js";
-import "./chunk-4VNS5WPM.js";
+} from "./chunk-L7TO4UJ4.js";
+import "./chunk-WOL2ZWU7.js";
 export {
   POSTHOG_AUTH_STOP_RULE,
   POSTHOG_DOMAIN_KNOWLEDGE,