snapfail 0.0.21 → 0.0.22

package/dist/index.js

@@ -267,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)}`));
@@ -2306,70 +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) {
   requireSession();
   const config = loadConfig(process.cwd(), opts.pk);
-  const diagnosis = await fetchDiagnosis(config, opts.id, opts.force ?? false);
-  if (!diagnosis) {
+  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
@@ -2433,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, pk });
+      await runExplain({ id, json, pk });
       return;
     }
     console.error(`Unknown command: ${command}`);

package/package.json

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

package/src/index.ts

@@ -78,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, pk });
+      await runExplain({ id, json, pk });
       return;
     }