snapfail 0.0.20 → 0.0.22

package/dist/index.js

@@ -95,7 +95,9 @@ import { readFileSync, writeFileSync, existsSync } from "fs";
 import { resolve } from "path";
 var DEFAULT_ENDPOINT = "https://app.snapfail.com";
 var ENV_FILE = ".env";
-function loadConfig(cwd = process.cwd()) {
+function loadConfig(cwd = process.cwd(), pk) {
+  if (pk)
+    return { projectKey: pk, endpoint: DEFAULT_ENDPOINT };
   const fromEnv = process.env["SNAPFAIL_PROJECT_KEY"];
   if (fromEnv)
     return { projectKey: fromEnv, endpoint: DEFAULT_ENDPOINT };
@@ -127,6 +129,37 @@ ${line}
   }
 }
 
+// src/session.ts
+import { readFileSync as readFileSync2, writeFileSync as writeFileSync2, mkdirSync, existsSync as existsSync2, rmSync } from "fs";
+import { join } from "path";
+import { homedir } from "os";
+var SESSION_DIR = join(homedir(), ".snapfail");
+var SESSION_FILE = join(SESSION_DIR, "auth.json");
+function readSession() {
+  try {
+    if (!existsSync2(SESSION_FILE))
+      return null;
+    const raw = JSON.parse(readFileSync2(SESSION_FILE, "utf-8"));
+    if (!raw.token || !raw.endpoint)
+      return null;
+    return raw;
+  } catch {
+    return null;
+  }
+}
+function writeSession(session) {
+  mkdirSync(SESSION_DIR, { recursive: true });
+  writeFileSync2(SESSION_FILE, JSON.stringify(session, null, 2) + `
+`, "utf-8");
+}
+function requireSession() {
+  const session = readSession();
+  if (!session) {
+    throw new Error('No active session. Run "snapfail init" to authenticate.');
+  }
+  return session;
+}
+
 // src/api.ts
 async function apiFetch(url, options) {
   let res;
@@ -234,6 +267,68 @@ function formatIncidentList(data, total, status) {
   ${bold(String(total))} ${status ?? "unresolved"} incident${total !== 1 ? "s" : ""}`;
   return table + summary;
 }
+function formatLLMContext(group, samples) {
+  const lines = [];
+  lines.push(`# Incident: ${group.title}`);
+  lines.push(`Group ID: ${group.id}`);
+  lines.push(`Fingerprint: ${group.fingerprint}`);
+  lines.push(`Occurrences: ${group.count}  |  First: ${new Date(group.firstSeen).toISOString()}  |  Last: ${new Date(group.lastSeen).toISOString()}`);
+  lines.push(`Environments: ${group.environments.join(", ")}`);
+  lines.push(`Status: ${group.status}`);
+  lines.push("");
+  lines.push("## Error");
+  lines.push(`Type: ${group.errorType}`);
+  lines.push(`Message: ${samples[0]?.errorMessage ?? group.title}`);
+  lines.push(`Normalized: ${samples[0]?.normalizedMessage ?? group.title}`);
+  if (samples[0] && samples[0].stackFrames.length > 0) {
+    lines.push("");
+    lines.push("## Stack");
+    for (const f of samples[0].stackFrames) {
+      lines.push(`  ${f.fn ?? "(anonymous)"}  ${f.file}:${f.line}${f.col != null ? `:${f.col}` : ""}`);
+    }
+  }
+  for (let i = 0;i < samples.length; i++) {
+    const s = samples[i];
+    lines.push("");
+    lines.push(`## Sample ${i + 1} / ${group.sampleIds.length}`);
+    lines.push(`Device: ${s.device.userAgent}`);
+    if (s.device.viewport) {
+      lines.push(`Viewport: ${s.device.viewport.width}x${s.device.viewport.height}  Language: ${s.device.language ?? "unknown"}`);
+    }
+    lines.push(`URL: ${s.url}`);
+    if (s.route)
+      lines.push(`Route: ${s.route}`);
+    lines.push(`Environment: ${s.environmentMode}`);
+    if (s.consoleEntries.length > 0) {
+      lines.push("");
+      lines.push("### Console");
+      for (const e of s.consoleEntries) {
+        const args = e.args.map((a) => String(a)).join(" ");
+        lines.push(`  [${e.level}] ${args}`);
+      }
+    }
+    if (s.networkEntries.length > 0) {
+      lines.push("");
+      lines.push("### Network");
+      for (const n of s.networkEntries) {
+        const status = n.status ? ` \u2192 ${n.status}` : n.error ? ` \u2192 ERROR` : "";
+        lines.push(`  ${n.method} ${n.url}${status} (${n.durationMs}ms)`);
+      }
+    }
+    if (s.timeline.length > 0) {
+      lines.push("");
+      lines.push("### Timeline");
+      for (const e of s.timeline) {
+        lines.push(`  +${e.t}ms  ${e.kind}: ${e.summary}`);
+      }
+    }
+    if (i < samples.length - 1)
+      lines.push(`
+---`);
+  }
+  return lines.join(`
+`);
+}
 function formatIncidentDetail(group, sample) {
   const lines = [];
   lines.push(bold(`${group.errorType}: ${truncate(group.title, 80)}`));
@@ -285,7 +380,8 @@ function formatIncidentDetail(group, sample) {
 
 // src/commands/incidents.ts
 async function runIncidents(opts) {
-  const config = loadConfig();
+  requireSession();
+  const config = loadConfig(process.cwd(), opts.pk);
   const result = await fetchIncidents(config, {
     status: opts.status ?? "unresolved",
     limit: opts.limit,
@@ -301,7 +397,8 @@ async function runIncidents(opts) {
 
 // src/commands/incident.ts
 async function runIncident(opts) {
-  const config = loadConfig();
+  requireSession();
+  const config = loadConfig(process.cwd(), opts.pk);
   if (opts.delete) {
     const ok = await deleteGroup(config, opts.id);
     if (!ok) {
@@ -1902,30 +1999,6 @@ Config file: \`.snapfail.json\` (gitignored)
 `;
 }
 
-// src/session.ts
-import { readFileSync as readFileSync2, writeFileSync as writeFileSync2, mkdirSync, existsSync as existsSync2, rmSync } from "fs";
-import { join } from "path";
-import { homedir } from "os";
-var SESSION_DIR = join(homedir(), ".snapfail");
-var SESSION_FILE = join(SESSION_DIR, "auth.json");
-function readSession() {
-  try {
-    if (!existsSync2(SESSION_FILE))
-      return null;
-    const raw = JSON.parse(readFileSync2(SESSION_FILE, "utf-8"));
-    if (!raw.token || !raw.endpoint)
-      return null;
-    return raw;
-  } catch {
-    return null;
-  }
-}
-function writeSession(session) {
-  mkdirSync(SESSION_DIR, { recursive: true });
-  writeFileSync2(SESSION_FILE, JSON.stringify(session, null, 2) + `
-`, "utf-8");
-}
-
 // src/auth.ts
 import { execSync } from "child_process";
 function openBrowser(url) {
@@ -2295,69 +2368,28 @@ async function runInit(cwd = process.cwd()) {
 }
 
 // src/commands/explain.ts
-async function fetchDiagnosis(config, id, force) {
-  const url = new URL(`${config.endpoint}/api/diagnose/${id}`);
-  if (force)
-    url.searchParams.set("force", "1");
-  let res;
-  try {
-    res = await fetch(url.toString(), {
-      method: "POST",
-      headers: { "X-Project-Key": config.projectKey, "Content-Type": "application/json" },
-      body: "{}"
-    });
-  } catch (err) {
-    throw new Error(`Network error: ${err instanceof Error ? err.message : String(err)}`);
-  }
-  if (res.status === 401)
-    throw new Error("Unauthorized: check your project key.");
-  if (res.status === 404)
-    return null;
-  if (res.status === 422)
-    throw new Error("No samples available to diagnose this incident.");
-  if (!res.ok) {
-    const body = await res.text().catch(() => "");
-    throw new Error(`API error ${res.status}: ${body}`);
-  }
-  return res.json();
-}
-function confidenceColor(c3) {
-  if (c3 === "high")
-    return green(c3);
-  if (c3 === "medium")
-    return yellow(c3);
-  return red(c3);
-}
-function formatDiagnosis(d) {
-  const lines = [];
-  lines.push(bold("Root cause"));
-  lines.push(`  ${d.rootCause}`);
-  lines.push("");
-  lines.push(bold("In plain language"));
-  lines.push(`  ${d.plainSummary}`);
-  if (d.fixPrompt) {
-    lines.push("");
-    lines.push(bold("Fix prompt") + dim(" (paste into your AI assistant)"));
-    lines.push(`  ${d.fixPrompt}`);
-  }
-  lines.push("");
-  lines.push(dim("Confidence:") + " " + confidenceColor(d.confidence) + dim("  \xB7  analyzed ") + d.analyzedSampleIds.length + dim(" samples  \xB7  model: ") + dim(d.model));
-  return lines.join(`
-`);
-}
 async function runExplain(opts) {
-  const config = loadConfig();
-  const diagnosis = await fetchDiagnosis(config, opts.id, opts.force ?? false);
-  if (!diagnosis) {
+  requireSession();
+  const config = loadConfig(process.cwd(), opts.pk);
+  const result = await fetchIncident(config, opts.id);
+  if (!result) {
     console.error(`Incident ${opts.id} not found.`);
     process.exit(1);
   }
+  const { group, sample } = result;
+  const samples = [sample];
+  for (let i2 = 1;i2 < Math.min(group.sampleIds.length, 3); i2++) {
+    const s = await fetchSample(config, opts.id, i2);
+    if (s)
+      samples.push(s);
+  }
   if (opts.json) {
-    process.stdout.write(JSON.stringify(diagnosis, null, 2) + `
+    process.stdout.write(JSON.stringify({ group, samples }, null, 2) + `
 `);
     return;
   }
-  console.log(formatDiagnosis(diagnosis));
+  process.stdout.write(formatLLMContext(group, samples) + `
+`);
 }
 
 // src/index.ts
@@ -2384,6 +2416,7 @@ var VERSION = "0.0.18";
 async function main() {
   const { command, args, flags } = parseArgs(process.argv);
   const json = flags["json"] === true;
+  const pk = typeof flags["pk"] === "string" ? flags["pk"] : undefined;
   if (command === "--version" || command === "-v" || flags["version"] === true) {
     console.log(VERSION);
     return;
@@ -2396,6 +2429,7 @@ async function main() {
     if (command === "incidents") {
       await runIncidents({
         json,
+        pk,
         status: typeof flags["status"] === "string" ? flags["status"] : undefined,
         limit: typeof flags["limit"] === "string" ? parseInt(flags["limit"]) : undefined,
         offset: typeof flags["offset"] === "string" ? parseInt(flags["offset"]) : undefined
@@ -2410,7 +2444,7 @@ async function main() {
       }
       const sampleFlag = flags["sample"];
       const sample = typeof sampleFlag === "string" ? parseInt(sampleFlag) : undefined;
-      await runIncident({ id, sample, json, delete: flags["delete"] === true });
+      await runIncident({ id, sample, json, pk, delete: flags["delete"] === true });
       return;
     }
     if (command === "explain") {
@@ -2419,7 +2453,7 @@ async function main() {
         console.error("Usage: snapfail explain <id> [--force] [--json]");
         process.exit(1);
       }
-      await runExplain({ id, force: flags["force"] === true, json });
+      await runExplain({ id, json, pk });
       return;
     }
     console.error(`Unknown command: ${command}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "snapfail",
-  "version": "0.0.20",
+  "version": "0.0.22",
   "type": "module",
   "description": "CLI for snapfail — project setup, incident inspection and AI diagnostics",
   "license": "MIT",

package/src/index.ts

@@ -35,6 +35,7 @@ const VERSION = "0.0.18";
 async function main(): Promise<void> {
   const { command, args, flags } = parseArgs(process.argv);
   const json = flags["json"] === true;
+  const pk = typeof flags["pk"] === "string" ? flags["pk"] : undefined;
 
   if (command === "--version" || command === "-v" || flags["version"] === true) {
     console.log(VERSION);
@@ -50,6 +51,7 @@ async function main(): Promise<void> {
     if (command === "incidents") {
       await runIncidents({
         json,
+        pk,
         status: typeof flags["status"] === "string" ? flags["status"] : undefined,
         limit: typeof flags["limit"] === "string" ? parseInt(flags["limit"]) : undefined,
         offset: typeof flags["offset"] === "string" ? parseInt(flags["offset"]) : undefined,
@@ -66,7 +68,7 @@ async function main(): Promise<void> {
       const sampleFlag = flags["sample"];
       const sample =
         typeof sampleFlag === "string" ? parseInt(sampleFlag) : undefined;
-      await runIncident({ id, sample, json, delete: flags["delete"] === true });
+      await runIncident({ id, sample, json, pk, delete: flags["delete"] === true });
       return;
     }
 
@@ -76,7 +78,7 @@ async function main(): Promise<void> {
         console.error("Usage: snapfail explain <id> [--force] [--json]");
         process.exit(1);
       }
-      await runExplain({ id, force: flags["force"] === true, json });
+      await runExplain({ id, json, pk });
       return;
     }