tracer-sh 0.2.0 → 0.2.2

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.0",
+  "version": "0.2.2",
   "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-ANVLQIEK.js → chunk-OTYSD6PF.js}

@@ -12,6 +12,7 @@ HogQL is PostHog's SQL dialect (ClickHouse SQL under the hood). Queries read fro
 - \`SELECT ... FROM events\` \u2014 the main table. Standard SQL: \`WHERE\`, \`GROUP BY\`, \`HAVING\`, \`ORDER BY\`, \`LIMIT\`. Unlike NRQL, HogQL HAS \`GROUP BY\` and \`DISTINCT\`.
 - **LIMIT:** the API applies \`LIMIT 100\` when you omit one. For exploration set an explicit small \`LIMIT\` (10); increase to 20-50 only when needed; never start with 100+. Max for a personal-API-key request is 50,000. **OFFSET pagination is rejected** for personal API keys \u2014 paginate with a \`timestamp\` keyset filter instead.
 - Time filtering uses \`timestamp\` with ClickHouse intervals: \`WHERE timestamp >= now() - interval 24 hour\`. Also \`toStartOfDay(now())\`, \`toDateTime('2024-01-15 14:00:00')\`.
+- **Trends over time render as a line chart.** For any "over time" / "trend" / "by hour|day" question, \`GROUP BY\` a time bucket \u2014 \`toStartOfMinute|Hour|Day(timestamp)\` \u2014 select it as the FIRST column alongside your metric(s), and \`ORDER BY\` it. One numeric metric (optionally one breakdown column for multiple lines) plots as a timeseries; otherwise results show as a table. Example: \`SELECT toStartOfHour(timestamp) AS t, count() AS events FROM events WHERE timestamp >= now() - interval 24 hour GROUP BY t ORDER BY t\`.
 
 ### Properties
 - Event properties: \`properties.$current_url\`, \`properties.$browser\`, or custom \`properties.my_prop\`. PostHog auto-captured properties are prefixed with \`$\`.

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

@@ -2,7 +2,7 @@ import {
   POSTHOG_AUTH_STOP_RULE,
   POSTHOG_DOMAIN_KNOWLEDGE,
   POSTHOG_INSIDE_OUT_DEBUGGING
-} from "./chunk-ANVLQIEK.js";
+} from "./chunk-OTYSD6PF.js";
 import "./chunk-4VNS5WPM.js";
 export {
   POSTHOG_AUTH_STOP_RULE,