snapfail 0.0.25 → 0.0.26

package/dist/index.js

@@ -34,8 +34,8 @@ var __commonJS = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports,
 
 // ../../node_modules/.bun/sisteransi@1.0.5/node_modules/sisteransi/src/index.js
 var require_src = __commonJS((exports, module) => {
-  var ESC3 = "\x1B";
-  var CSI2 = `${ESC3}[`;
+  var ESC2 = "\x1B";
+  var CSI2 = `${ESC2}[`;
   var beep = "\x07";
   var cursor = {
     to(x, y) {
@@ -64,8 +64,8 @@ var require_src = __commonJS((exports, module) => {
     left: `${CSI2}G`,
     hide: `${CSI2}?25l`,
     show: `${CSI2}?25h`,
-    save: `${ESC3}7`,
-    restore: `${ESC3}8`
+    save: `${ESC2}7`,
+    restore: `${ESC2}8`
   };
   var scroll = {
     up: (count = 1) => `${CSI2}S`.repeat(count),
@@ -93,368 +93,6 @@ var require_src = __commonJS((exports, module) => {
 // src/config.ts
 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(), pk) {
-  if (pk)
-    return { projectKey: pk, endpoint: DEFAULT_ENDPOINT };
-  const fromEnv = process.env["SNAPFAIL_PROJECT_KEY"];
-  if (fromEnv)
-    return { projectKey: fromEnv, endpoint: DEFAULT_ENDPOINT };
-  const envPath = resolve(cwd, ENV_FILE);
-  if (existsSync(envPath)) {
-    const match = readFileSync(envPath, "utf-8").match(/^SNAPFAIL_PROJECT_KEY=(.+)$/m);
-    if (match)
-      return { projectKey: match[1].trim(), endpoint: DEFAULT_ENDPOINT };
-  }
-  throw new Error('No project key found. Run "snapfail init" or set SNAPFAIL_PROJECT_KEY.');
-}
-function writeProjectKey(projectKey, cwd = process.cwd(), keyName = "SNAPFAIL_PROJECT_KEY") {
-  const envPath = resolve(cwd, ENV_FILE);
-  const line = `${keyName}=${projectKey}`;
-  const pattern = new RegExp(`^${keyName}=.*`, "m");
-  if (existsSync(envPath)) {
-    let content = readFileSync(envPath, "utf-8");
-    if (pattern.test(content)) {
-      content = content.replace(pattern, line);
-    } else {
-      content = content.trimEnd() + `
-${line}
-`;
-    }
-    writeFileSync(envPath, content, "utf-8");
-  } else {
-    writeFileSync(envPath, `${line}
-`, "utf-8");
-  }
-}
-
-// 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 clearSession() {
-  try {
-    if (existsSync2(SESSION_FILE))
-      rmSync(SESSION_FILE);
-  } catch {}
-}
-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;
-  try {
-    res = await fetch(url, options);
-  } 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.ok) {
-    const body = await res.text().catch(() => "");
-    throw new Error(`API error ${res.status}: ${body}`);
-  }
-  return res.json();
-}
-async function fetchIncidents(config, opts = {}) {
-  const url = new URL(`${config.endpoint}/api/incidents`);
-  url.searchParams.set("projectKey", config.projectKey);
-  if (opts.status)
-    url.searchParams.set("status", opts.status);
-  if (opts.limit != null)
-    url.searchParams.set("limit", String(opts.limit));
-  if (opts.offset != null)
-    url.searchParams.set("offset", String(opts.offset));
-  const data = await apiFetch(url.toString());
-  return data;
-}
-async function fetchIncident(config, id) {
-  const url = `${config.endpoint}/api/incidents/${id}`;
-  const data = await apiFetch(url, {
-    headers: { "X-Project-Key": config.projectKey }
-  });
-  return data;
-}
-async function deleteGroup(config, id) {
-  const url = `${config.endpoint}/api/incidents/${id}`;
-  const data = await apiFetch(url, {
-    method: "DELETE",
-    headers: { "X-Project-Key": config.projectKey }
-  });
-  return data !== null;
-}
-async function fetchSample(config, groupId, sampleIndex) {
-  const url = `${config.endpoint}/api/incidents/${groupId}/samples/${sampleIndex}`;
-  const data = await apiFetch(url, {
-    headers: { "X-Project-Key": config.projectKey }
-  });
-  return data;
-}
-
-// src/format.ts
-var ESC = "\x1B[";
-var bold = (s) => `${ESC}1m${s}${ESC}0m`;
-var dim = (s) => `${ESC}2m${s}${ESC}0m`;
-var red = (s) => `${ESC}31m${s}${ESC}0m`;
-var green = (s) => `${ESC}32m${s}${ESC}0m`;
-var yellow = (s) => `${ESC}33m${s}${ESC}0m`;
-var cyan = (s) => `${ESC}36m${s}${ESC}0m`;
-function truncate(s, n) {
-  if (s.length <= n)
-    return s;
-  return s.slice(0, n - 1) + "\u2026";
-}
-function relativeTime(ts) {
-  const diff = Date.now() - ts;
-  const s = Math.floor(diff / 1000);
-  if (s < 60)
-    return `${s}s ago`;
-  const m = Math.floor(s / 60);
-  if (m < 60)
-    return `${m}m ago`;
-  const h = Math.floor(m / 60);
-  if (h < 24)
-    return `${h}h ago`;
-  const d = Math.floor(h / 24);
-  return `${d}d ago`;
-}
-function formatTable(rows, headers) {
-  const allRows = [headers, ...rows];
-  const widths = headers.map((_, i) => Math.max(...allRows.map((r) => (r[i] ?? "").length)));
-  const pad = (s, w) => s + " ".repeat(Math.max(0, w - s.length));
-  const header = "  " + headers.map((h, i) => bold(pad(h, widths[i]))).join("  ");
-  const divider = "  " + widths.map((w) => dim("\u2500".repeat(w))).join("  ");
-  const body = rows.map((r) => "  " + r.map((cell, i) => pad(cell, widths[i])).join("  ")).join(`
-`);
-  return [header, divider, body].join(`
-`);
-}
-function formatIncidentList(data, total, status) {
-  if (data.length === 0) {
-    return dim(`No ${status ?? "unresolved"} incidents found.`);
-  }
-  const rows = data.map((g) => [
-    cyan(truncate(g.id, 12)),
-    truncate(g.title, 38),
-    String(g.count),
-    g.environments.join(","),
-    relativeTime(g.lastSeen)
-  ]);
-  const table = formatTable(rows, ["ID", "TITLE", "COUNT", "ENV", "LAST SEEN"]);
-  const summary = `
-  ${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)}`));
-  lines.push(`${dim("Status:")} ${group.status}  ${dim("\xB7")}  ${group.count} occurrences  ${dim("\xB7")}  ${group.environments.join(", ")}`);
-  lines.push(`${dim("First seen:")} ${new Date(group.firstSeen).toISOString().slice(0, 10)}  ${dim("\xB7")}  ${dim("Last seen:")} ${relativeTime(group.lastSeen)}`);
-  if (sample.stackFrames.length > 0) {
-    lines.push("");
-    lines.push(bold("Stack"));
-    for (const f of sample.stackFrames.slice(0, 6)) {
-      const fn = f.fn ? `${cyan(f.fn)}  ` : "";
-      lines.push(`  ${fn}${dim(f.file + ":" + f.line)}`);
-      if (f.codeSnippet) {
-        for (const snippetLine of f.codeSnippet.split(`
-`)) {
-          const isError = snippetLine.startsWith("\u25BA");
-          lines.push(isError ? `    ${bold(snippetLine)}` : `    ${dim(snippetLine)}`);
-        }
-      }
-    }
-  }
-  if (sample.consoleEntries.length > 0) {
-    lines.push("");
-    lines.push(bold("Console"));
-    for (const e of sample.consoleEntries.slice(-5)) {
-      const level = e.level === "error" ? red(`[${e.level}]`) : yellow(`[${e.level}]`);
-      const args = e.args.map((a) => truncate(String(a), 60)).join(" ");
-      lines.push(`  ${level} ${args}`);
-    }
-  }
-  if (sample.networkEntries.length > 0) {
-    lines.push("");
-    lines.push(bold("Network"));
-    for (const n of sample.networkEntries.slice(-5)) {
-      const status = n.status ? n.status >= 400 ? red(String(n.status)) : green(String(n.status)) : dim("???");
-      lines.push(`  ${dim(n.method)}  ${truncate(n.url, 50)}  ${dim("\u2192")} ${status}  ${dim(`(${n.durationMs}ms)`)}`);
-    }
-  }
-  if (sample.timeline.length > 0) {
-    lines.push("");
-    lines.push(bold("Timeline"));
-    for (const e of sample.timeline.slice(0, 10)) {
-      const t = String(e.t).padStart(5);
-      lines.push(`  ${dim(t + "ms")}  ${e.summary}`);
-    }
-  }
-  return lines.join(`
-`);
-}
-
-// src/commands/incidents.ts
-async function runIncidents(opts) {
-  requireSession();
-  const config = loadConfig(process.cwd(), opts.pk);
-  const result = await fetchIncidents(config, {
-    status: opts.status ?? "unresolved",
-    limit: opts.limit,
-    offset: opts.offset
-  });
-  if (opts.json) {
-    process.stdout.write(JSON.stringify(result, null, 2) + `
-`);
-    return;
-  }
-  console.log(formatIncidentList(result.data, result.total, opts.status));
-}
-
-// src/commands/incident.ts
-async function runIncident(opts) {
-  requireSession();
-  const config = loadConfig(process.cwd(), opts.pk);
-  if (opts.delete) {
-    const ok = await deleteGroup(config, opts.id);
-    if (!ok) {
-      console.error(`Incident group ${opts.id} not found.`);
-      process.exit(1);
-    }
-    if (opts.json) {
-      process.stdout.write(JSON.stringify({ ok: true, deleted: opts.id }) + `
-`);
-    } else {
-      console.log(`Deleted incident group ${opts.id} and all related data.`);
-    }
-    return;
-  }
-  if (opts.sample != null) {
-    const s = await fetchSample(config, opts.id, opts.sample);
-    if (!s) {
-      console.error(`Sample ${opts.sample} not found for incident ${opts.id}`);
-      process.exit(1);
-    }
-    if (opts.json) {
-      process.stdout.write(JSON.stringify(s, null, 2) + `
-`);
-      return;
-    }
-    const detail = await fetchIncident(config, opts.id);
-    if (!detail) {
-      console.error(`Incident ${opts.id} not found.`);
-      process.exit(1);
-    }
-    console.log(formatIncidentDetail(detail.group, s));
-    return;
-  }
-  const result = await fetchIncident(config, opts.id);
-  if (!result) {
-    console.error(`Incident ${opts.id} not found.`);
-    process.exit(1);
-  }
-  if (opts.json) {
-    process.stdout.write(JSON.stringify(result, null, 2) + `
-`);
-    return;
-  }
-  console.log(formatIncidentDetail(result.group, result.sample));
-}
-
-// src/commands/init.ts
-import { existsSync as existsSync3, readFileSync as readFileSync3, writeFileSync as writeFileSync3, mkdirSync as mkdirSync2 } from "fs";
-import { resolve as resolve2, join as join2 } from "path";
-import { execSync as execSync2 } from "child_process";
 
 // ../../node_modules/.bun/@clack+core@1.4.1/node_modules/@clack/core/dist/index.mjs
 import { styleText } from "util";
@@ -592,7 +230,7 @@ var fastStringWidth = (input, options = {}) => {
 var dist_default2 = fastStringWidth;
 
 // ../../node_modules/.bun/fast-wrap-ansi@0.2.2/node_modules/fast-wrap-ansi/lib/main.js
-var ESC2 = "\x1B";
+var ESC = "\x1B";
 var CSI = "\x9B";
 var END_CODE = 39;
 var ANSI_ESCAPE_BELL = "\x07";
@@ -626,8 +264,8 @@ var getClosingCode = (openingCode) => {
     return 0;
   return;
 };
-var wrapAnsiCode = (code) => `${ESC2}${ANSI_CSI}${code}${ANSI_SGR_TERMINATOR}`;
-var wrapAnsiHyperlink = (url) => `${ESC2}${ANSI_ESCAPE_LINK}${url}${ANSI_ESCAPE_BELL}`;
+var wrapAnsiCode = (code) => `${ESC}${ANSI_CSI}${code}${ANSI_SGR_TERMINATOR}`;
+var wrapAnsiHyperlink = (url) => `${ESC}${ANSI_ESCAPE_LINK}${url}${ANSI_ESCAPE_BELL}`;
 var wrapWord = (rows, word, columns) => {
   const characters = word[Symbol.iterator]();
   let isInsideEscape = false;
@@ -646,7 +284,7 @@ var wrapWord = (rows, word, columns) => {
       rows.push(character);
       visible = 0;
     }
-    if (character === ESC2 || character === CSI) {
+    if (character === ESC || character === CSI) {
       isInsideEscape = true;
       isInsideLinkEscape = word.startsWith(ANSI_ESCAPE_LINK, rawCharacterIndex + 1);
     }
@@ -765,7 +403,7 @@ var exec = (string, columns, options = {}) => {
     } else {
       inSurrogate = false;
     }
-    if (character === ESC2 || character === CSI) {
+    if (character === ESC || character === CSI) {
       GROUP_REGEX.lastIndex = i + 1;
       const groupsResult = GROUP_REGEX.exec(preString);
       const groups = groupsResult?.groups;
@@ -1901,47 +1539,511 @@ ${l2}
         }
       }
     }
-  }).prompt();
-};
-var i = `${styleText2("gray", S_BAR)}  `;
-var text = (t2) => new n({
-  validate: t2.validate,
-  placeholder: t2.placeholder,
-  defaultValue: t2.defaultValue,
-  initialValue: t2.initialValue,
-  output: t2.output,
-  signal: t2.signal,
-  input: t2.input,
-  render() {
-    const i2 = t2?.withGuide ?? settings.withGuide, s = `${`${i2 ? `${styleText2("gray", S_BAR)}
-` : ""}${symbol(this.state)}  `}${t2.message}
-`, c3 = t2.placeholder ? styleText2("inverse", t2.placeholder[0]) + styleText2("dim", t2.placeholder.slice(1)) : styleText2(["inverse", "hidden"], "_"), o2 = this.userInput ? this.userInputWithCursor : c3, a2 = this.value ?? "";
-    switch (this.state) {
-      case "error": {
-        const n2 = this.error ? `  ${styleText2("yellow", this.error)}` : "", r2 = i2 ? `${styleText2("yellow", S_BAR)}  ` : "", d = i2 ? styleText2("yellow", S_BAR_END) : "";
-        return `${s.trim()}
-${r2}${o2}
-${d}${n2}
-`;
+  }).prompt();
+};
+var i = `${styleText2("gray", S_BAR)}  `;
+var text = (t2) => new n({
+  validate: t2.validate,
+  placeholder: t2.placeholder,
+  defaultValue: t2.defaultValue,
+  initialValue: t2.initialValue,
+  output: t2.output,
+  signal: t2.signal,
+  input: t2.input,
+  render() {
+    const i2 = t2?.withGuide ?? settings.withGuide, s = `${`${i2 ? `${styleText2("gray", S_BAR)}
+` : ""}${symbol(this.state)}  `}${t2.message}
+`, c3 = t2.placeholder ? styleText2("inverse", t2.placeholder[0]) + styleText2("dim", t2.placeholder.slice(1)) : styleText2(["inverse", "hidden"], "_"), o2 = this.userInput ? this.userInputWithCursor : c3, a2 = this.value ?? "";
+    switch (this.state) {
+      case "error": {
+        const n2 = this.error ? `  ${styleText2("yellow", this.error)}` : "", r2 = i2 ? `${styleText2("yellow", S_BAR)}  ` : "", d = i2 ? styleText2("yellow", S_BAR_END) : "";
+        return `${s.trim()}
+${r2}${o2}
+${d}${n2}
+`;
+      }
+      case "submit": {
+        const n2 = a2 ? `  ${styleText2("dim", a2)}` : "", r2 = i2 ? styleText2("gray", S_BAR) : "";
+        return `${s}${r2}${n2}`;
+      }
+      case "cancel": {
+        const n2 = a2 ? `  ${styleText2(["strikethrough", "dim"], a2)}` : "", r2 = i2 ? styleText2("gray", S_BAR) : "";
+        return `${s}${r2}${n2}${a2.trim() ? `
+${r2}` : ""}`;
+      }
+      default: {
+        const n2 = i2 ? `${styleText2("cyan", S_BAR)}  ` : "", r2 = i2 ? styleText2("cyan", S_BAR_END) : "";
+        return `${s}${n2}${o2}
+${r2}
+`;
+      }
+    }
+  }
+}).prompt();
+
+// src/config.ts
+var DEFAULT_ENDPOINT = "https://app.snapfail.com";
+var ENV_FILE = ".env";
+function tryLoadProjectKey(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 };
+  const envPath = resolve(cwd, ENV_FILE);
+  if (existsSync(envPath)) {
+    const match = readFileSync(envPath, "utf-8").match(/^SNAPFAIL_PROJECT_KEY=(.+)$/m);
+    if (match)
+      return { projectKey: match[1].trim(), endpoint: DEFAULT_ENDPOINT };
+  }
+  return null;
+}
+function loadConfig(cwd = process.cwd(), pk) {
+  const key = tryLoadProjectKey(cwd, pk);
+  if (key)
+    return key;
+  throw new Error('No project key found. Run "snapfail init" or set SNAPFAIL_PROJECT_KEY.');
+}
+async function resolveProjectKey(pk, interactive, sessionToken) {
+  const config = tryLoadProjectKey(process.cwd(), pk);
+  if (config)
+    return config.projectKey;
+  if (!interactive || !sessionToken) {
+    throw new Error('No project key found. Run "snapfail init" or pass --pk.');
+  }
+  const res = await fetch(`${DEFAULT_ENDPOINT}/api/cli/projects`, {
+    headers: { Authorization: `Bearer ${sessionToken}` }
+  });
+  if (!res.ok)
+    throw new Error(`Failed to fetch projects (${res.status})`);
+  const { projects } = await res.json();
+  if (projects.length === 0) {
+    throw new Error('No projects found. Run "snapfail init" to create one.');
+  }
+  if (projects.length === 1) {
+    console.log(`Using project: ${projects[0].name}`);
+    return projects[0].key;
+  }
+  const pick = await select({
+    message: "Select a project",
+    options: projects.map((proj) => ({ value: proj.key, label: proj.name, hint: proj.key }))
+  });
+  if (isCancel(pick)) {
+    cancel("Cancelled.");
+    process.exit(0);
+  }
+  return pick;
+}
+function writeProjectKey(projectKey, cwd = process.cwd(), keyName = "SNAPFAIL_PROJECT_KEY") {
+  const envPath = resolve(cwd, ENV_FILE);
+  const line = `${keyName}=${projectKey}`;
+  const pattern = new RegExp(`^${keyName}=.*`, "m");
+  if (existsSync(envPath)) {
+    let content = readFileSync(envPath, "utf-8");
+    if (pattern.test(content)) {
+      content = content.replace(pattern, line);
+    } else {
+      content = content.trimEnd() + `
+${line}
+`;
+    }
+    writeFileSync(envPath, content, "utf-8");
+  } else {
+    writeFileSync(envPath, `${line}
+`, "utf-8");
+  }
+}
+
+// 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 clearSession() {
+  try {
+    if (existsSync2(SESSION_FILE))
+      rmSync(SESSION_FILE);
+  } catch {}
+}
+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;
+  try {
+    res = await fetch(url, options);
+  } 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.ok) {
+    const body = await res.text().catch(() => "");
+    throw new Error(`API error ${res.status}: ${body}`);
+  }
+  return res.json();
+}
+async function fetchIncidents(config, opts = {}) {
+  const url = new URL(`${config.endpoint}/api/incidents`);
+  url.searchParams.set("projectKey", config.projectKey);
+  if (opts.status)
+    url.searchParams.set("status", opts.status);
+  if (opts.limit != null)
+    url.searchParams.set("limit", String(opts.limit));
+  if (opts.offset != null)
+    url.searchParams.set("offset", String(opts.offset));
+  const data = await apiFetch(url.toString());
+  return data;
+}
+async function fetchIncident(config, id) {
+  const url = `${config.endpoint}/api/incidents/${id}`;
+  const data = await apiFetch(url, {
+    headers: { "X-Project-Key": config.projectKey }
+  });
+  return data;
+}
+async function deleteGroup(config, id) {
+  const url = `${config.endpoint}/api/incidents/${id}`;
+  const data = await apiFetch(url, {
+    method: "DELETE",
+    headers: { "X-Project-Key": config.projectKey }
+  });
+  return data !== null;
+}
+async function updateIncidentStatus(config, id, status) {
+  const url = `${config.endpoint}/api/incidents/${id}`;
+  const data = await apiFetch(url, {
+    method: "PATCH",
+    headers: { "X-Project-Key": config.projectKey, "Content-Type": "application/json" },
+    body: JSON.stringify({ status })
+  });
+  return data !== null;
+}
+async function fetchSample(config, groupId, sampleIndex) {
+  const url = `${config.endpoint}/api/incidents/${groupId}/samples/${sampleIndex}`;
+  const data = await apiFetch(url, {
+    headers: { "X-Project-Key": config.projectKey }
+  });
+  return data;
+}
+
+// src/format.ts
+var ESC2 = "\x1B[";
+var bold = (s) => `${ESC2}1m${s}${ESC2}0m`;
+var dim = (s) => `${ESC2}2m${s}${ESC2}0m`;
+var red = (s) => `${ESC2}31m${s}${ESC2}0m`;
+var green = (s) => `${ESC2}32m${s}${ESC2}0m`;
+var yellow = (s) => `${ESC2}33m${s}${ESC2}0m`;
+var cyan = (s) => `${ESC2}36m${s}${ESC2}0m`;
+function truncate(s, n2) {
+  if (s.length <= n2)
+    return s;
+  return s.slice(0, n2 - 1) + "\u2026";
+}
+function relativeTime(ts) {
+  const diff = Date.now() - ts;
+  const s = Math.floor(diff / 1000);
+  if (s < 60)
+    return `${s}s ago`;
+  const m2 = Math.floor(s / 60);
+  if (m2 < 60)
+    return `${m2}m ago`;
+  const h2 = Math.floor(m2 / 60);
+  if (h2 < 24)
+    return `${h2}h ago`;
+  const d = Math.floor(h2 / 24);
+  return `${d}d ago`;
+}
+function formatTable(rows, headers) {
+  const allRows = [headers, ...rows];
+  const widths = headers.map((_2, i2) => Math.max(...allRows.map((r2) => (r2[i2] ?? "").length)));
+  const pad = (s, w) => s + " ".repeat(Math.max(0, w - s.length));
+  const header = "  " + headers.map((h2, i2) => bold(pad(h2, widths[i2]))).join("  ");
+  const divider = "  " + widths.map((w) => dim("\u2500".repeat(w))).join("  ");
+  const body = rows.map((r2) => "  " + r2.map((cell, i2) => pad(cell, widths[i2])).join("  ")).join(`
+`);
+  return [header, divider, body].join(`
+`);
+}
+function formatIncidentList(data, total, status) {
+  if (data.length === 0) {
+    return dim(`No ${status ?? "unresolved"} incidents found.`);
+  }
+  const rows = data.map((g2) => [
+    cyan(truncate(g2.id, 12)),
+    truncate(g2.title, 38),
+    String(g2.count),
+    g2.environments.join(","),
+    relativeTime(g2.lastSeen)
+  ]);
+  const table = formatTable(rows, ["ID", "TITLE", "COUNT", "ENV", "LAST SEEN"]);
+  const summary = `
+  ${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 f2 of samples[0].stackFrames) {
+      lines.push(`  ${f2.fn ?? "(anonymous)"}  ${f2.file}:${f2.line}${f2.col != null ? `:${f2.col}` : ""}`);
+    }
+  }
+  for (let i2 = 0;i2 < samples.length; i2++) {
+    const s = samples[i2];
+    lines.push("");
+    lines.push(`## Sample ${i2 + 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((a2) => String(a2)).join(" ");
+        lines.push(`  [${e.level}] ${args}`);
       }
-      case "submit": {
-        const n2 = a2 ? `  ${styleText2("dim", a2)}` : "", r2 = i2 ? styleText2("gray", S_BAR) : "";
-        return `${s}${r2}${n2}`;
+    }
+    if (s.networkEntries.length > 0) {
+      lines.push("");
+      lines.push("### Network");
+      for (const n2 of s.networkEntries) {
+        const status = n2.status ? ` \u2192 ${n2.status}` : n2.error ? ` \u2192 ERROR` : "";
+        lines.push(`  ${n2.method} ${n2.url}${status} (${n2.durationMs}ms)`);
       }
-      case "cancel": {
-        const n2 = a2 ? `  ${styleText2(["strikethrough", "dim"], a2)}` : "", r2 = i2 ? styleText2("gray", S_BAR) : "";
-        return `${s}${r2}${n2}${a2.trim() ? `
-${r2}` : ""}`;
+    }
+    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}`);
       }
-      default: {
-        const n2 = i2 ? `${styleText2("cyan", S_BAR)}  ` : "", r2 = i2 ? styleText2("cyan", S_BAR_END) : "";
-        return `${s}${n2}${o2}
-${r2}
-`;
+    }
+    if (i2 < samples.length - 1)
+      lines.push(`
+---`);
+  }
+  return lines.join(`
+`);
+}
+function formatIncidentDetail(group, sample) {
+  const lines = [];
+  lines.push(bold(`${group.errorType}: ${truncate(group.title, 80)}`));
+  lines.push(`${dim("Status:")} ${group.status}  ${dim("\xB7")}  ${group.count} occurrences  ${dim("\xB7")}  ${group.environments.join(", ")}`);
+  lines.push(`${dim("First seen:")} ${new Date(group.firstSeen).toISOString().slice(0, 10)}  ${dim("\xB7")}  ${dim("Last seen:")} ${relativeTime(group.lastSeen)}`);
+  if (sample.stackFrames.length > 0) {
+    lines.push("");
+    lines.push(bold("Stack"));
+    for (const f2 of sample.stackFrames.slice(0, 6)) {
+      const fn = f2.fn ? `${cyan(f2.fn)}  ` : "";
+      lines.push(`  ${fn}${dim(f2.file + ":" + f2.line)}`);
+      if (f2.codeSnippet) {
+        for (const snippetLine of f2.codeSnippet.split(`
+`)) {
+          const isError = snippetLine.startsWith("\u25BA");
+          lines.push(isError ? `    ${bold(snippetLine)}` : `    ${dim(snippetLine)}`);
+        }
       }
     }
   }
-}).prompt();
+  if (sample.consoleEntries.length > 0) {
+    lines.push("");
+    lines.push(bold("Console"));
+    for (const e of sample.consoleEntries.slice(-5)) {
+      const level = e.level === "error" ? red(`[${e.level}]`) : yellow(`[${e.level}]`);
+      const args = e.args.map((a2) => truncate(String(a2), 60)).join(" ");
+      lines.push(`  ${level} ${args}`);
+    }
+  }
+  if (sample.networkEntries.length > 0) {
+    lines.push("");
+    lines.push(bold("Network"));
+    for (const n2 of sample.networkEntries.slice(-5)) {
+      const status = n2.status ? n2.status >= 400 ? red(String(n2.status)) : green(String(n2.status)) : dim("???");
+      lines.push(`  ${dim(n2.method)}  ${truncate(n2.url, 50)}  ${dim("\u2192")} ${status}  ${dim(`(${n2.durationMs}ms)`)}`);
+    }
+  }
+  if (sample.timeline.length > 0) {
+    lines.push("");
+    lines.push(bold("Timeline"));
+    for (const e of sample.timeline.slice(0, 10)) {
+      const t2 = String(e.t).padStart(5);
+      lines.push(`  ${dim(t2 + "ms")}  ${e.summary}`);
+    }
+  }
+  return lines.join(`
+`);
+}
+
+// src/commands/incidents.ts
+var DEFAULT_LIMIT = 5;
+async function runIncidents(opts) {
+  const session = requireSession();
+  let projectKey;
+  try {
+    projectKey = await resolveProjectKey(opts.pk, !opts.json, session.token);
+  } catch (err) {
+    if (!opts.json) {
+      console.error(err.message);
+      console.error('Run "snapfail init" to set up a project.');
+    } else {
+      process.stdout.write(JSON.stringify({ error: err.message }) + `
+`);
+    }
+    process.exit(1);
+  }
+  const config = loadConfig(process.cwd(), projectKey);
+  const limit = opts.limit ?? DEFAULT_LIMIT;
+  const result = await fetchIncidents(config, {
+    status: opts.status ?? "unresolved",
+    limit,
+    offset: opts.offset
+  });
+  if (opts.json) {
+    process.stdout.write(JSON.stringify(result, null, 2) + `
+`);
+    return;
+  }
+  const statusLabel = opts.status ?? "unresolved";
+  const offset = opts.offset ?? 0;
+  const showing = result.data.length;
+  const total = result.total;
+  console.log(`
+Incidents (${statusLabel}) \u2014 showing ${offset + 1}\u2013${offset + showing} of ${total} groups`);
+  if (total > offset + showing) {
+    console.log(`  Use --limit ${limit * 2} or --offset ${offset + showing} to see more.
+`);
+  } else {
+    console.log("");
+  }
+  console.log(formatIncidentList(result.data, result.total, opts.status));
+}
+
+// src/commands/incident.ts
+async function runIncident(opts) {
+  const session = requireSession();
+  let projectKey;
+  try {
+    projectKey = await resolveProjectKey(opts.pk, !opts.json, session.token);
+  } catch (err) {
+    if (!opts.json) {
+      console.error(err.message);
+    } else {
+      process.stdout.write(JSON.stringify({ error: err.message }) + `
+`);
+    }
+    process.exit(1);
+  }
+  const config = loadConfig(process.cwd(), projectKey);
+  if (opts.delete) {
+    const ok = await deleteGroup(config, opts.id);
+    if (!ok) {
+      console.error(`Incident group ${opts.id} not found.`);
+      process.exit(1);
+    }
+    if (opts.json) {
+      process.stdout.write(JSON.stringify({ ok: true, deleted: opts.id }) + `
+`);
+    } else {
+      console.log(`Deleted incident group ${opts.id} and all related data.`);
+    }
+    return;
+  }
+  const statusAction = opts.resolve ? "resolved" : opts.ignore ? "ignored" : opts.reopen ? "unresolved" : null;
+  if (statusAction) {
+    const ok = await updateIncidentStatus(config, opts.id, statusAction);
+    if (!ok) {
+      console.error(`Incident ${opts.id} not found.`);
+      process.exit(1);
+    }
+    if (opts.json) {
+      process.stdout.write(JSON.stringify({ ok: true, id: opts.id, status: statusAction }) + `
+`);
+    } else {
+      const label = statusAction === "resolved" ? "resolved" : statusAction === "ignored" ? "ignored" : "reopened";
+      console.log(`Incident ${opts.id} marked as ${label}.`);
+    }
+    return;
+  }
+  if (opts.sample != null) {
+    const s = await fetchSample(config, opts.id, opts.sample);
+    if (!s) {
+      console.error(`Sample ${opts.sample} not found for incident ${opts.id}`);
+      process.exit(1);
+    }
+    if (opts.json) {
+      process.stdout.write(JSON.stringify(s, null, 2) + `
+`);
+      return;
+    }
+    const detail = await fetchIncident(config, opts.id);
+    if (!detail) {
+      console.error(`Incident ${opts.id} not found.`);
+      process.exit(1);
+    }
+    console.log(formatIncidentDetail(detail.group, s));
+    return;
+  }
+  const result = await fetchIncident(config, opts.id);
+  if (!result) {
+    console.error(`Incident ${opts.id} not found.`);
+    process.exit(1);
+  }
+  if (opts.json) {
+    process.stdout.write(JSON.stringify(result, null, 2) + `
+`);
+    return;
+  }
+  console.log(formatIncidentDetail(result.group, result.sample));
+}
+
+// src/commands/init.ts
+import { existsSync as existsSync3, readFileSync as readFileSync3, writeFileSync as writeFileSync3, mkdirSync as mkdirSync2 } from "fs";
+import { resolve as resolve2, join as join2 } from "path";
+import { execSync as execSync2 } from "child_process";
 
 // src/skill.ts
 var SKILL_BODY = `
@@ -2059,8 +2161,8 @@ async function waitForCliToken(endpoint) {
         resolved = true;
         const session = { token, email, name: name ?? email, endpoint };
         writeSession(session);
-        setTimeout(() => server.stop(), 200);
         resolve2(session);
+        setTimeout(() => server.stop(true), 50);
         return new Response(`<!doctype html><html><head><meta charset="utf-8"><title>snapfail</title>
 <style>
   body{background:#0a0a0a;color:#f5f5f5;font-family:system-ui,sans-serif;
@@ -2390,8 +2492,20 @@ async function runInit(cwd = process.cwd()) {
 
 // src/commands/explain.ts
 async function runExplain(opts) {
-  requireSession();
-  const config = loadConfig(process.cwd(), opts.pk);
+  const session = requireSession();
+  let projectKey;
+  try {
+    projectKey = await resolveProjectKey(opts.pk, !opts.json, session.token);
+  } catch (err) {
+    if (!opts.json) {
+      console.error(err.message);
+    } else {
+      process.stdout.write(JSON.stringify({ error: err.message }) + `
+`);
+    }
+    process.exit(1);
+  }
+  const config = loadConfig(process.cwd(), projectKey);
   const result = await fetchIncident(config, opts.id);
   if (!result) {
     console.error(`Incident ${opts.id} not found.`);
@@ -2436,10 +2550,192 @@ async function runLogin() {
   console.log(`
 Logged in as ${session.email}`);
 }
+
+// src/help.ts
+var GLOBAL_HELP = `
+snapfail \u2014 browser error capture for AI-assisted debugging
+
+USAGE
+  snapfail <command> [options]
+
+COMMANDS
+  init        Set up snapfail in a project (detects framework, authenticates, writes .env)
+  login       Authenticate with your snapfail account
+  skill       Install the snapfail skill globally for Claude Code (~/.claude/skills/)
+  incidents   List incident groups for your project
+  incident    View or update a single incident group
+  explain     Output raw evidence context for LLM analysis
+  help        Show this help, or help for a specific command
+
+OPTIONS
+  --version   Print the CLI version
+  --help      Show help for the current command
+
+Run \`snapfail help <command>\` for detailed usage of any command.
+`.trimStart();
+var COMMAND_HELP = {
+  init: `
+snapfail init \u2014 Set up snapfail in the current project
+
+USAGE
+  snapfail init
+
+DESCRIPTION
+  Authenticates your account, selects or creates a project, writes the
+  project key to .env, injects the browser SDK into your framework config,
+  and generates .claude/skills/snapfail/SKILL.md for AI agents.
+
+  Supported frameworks: astro, vite, next
+  Run once per project. Idempotent \u2014 safe to run again.
+
+EXIT CODES
+  0  Success
+  1  Cancelled or error
+`.trimStart(),
+  login: `
+snapfail login \u2014 Authenticate with your snapfail account
+
+USAGE
+  snapfail login
+
+DESCRIPTION
+  Opens a browser window for OAuth authentication. Saves the session to
+  ~/.snapfail/auth.json. Clears any existing session for the default
+  endpoint first.
+
+EXIT CODES
+  0  Authenticated successfully
+  1  Authentication timed out or failed
+`.trimStart(),
+  skill: `
+snapfail skill \u2014 Install the snapfail skill globally for Claude Code
+
+USAGE
+  snapfail skill
+
+DESCRIPTION
+  Writes the snapfail skill definition to ~/.claude/skills/snapfail/SKILL.md.
+  Claude Code picks this up automatically \u2014 no project configuration needed.
+
+  Use this when you want snapfail available in all your Claude Code sessions,
+  not just projects where you ran \`snapfail init\`.
+
+EXIT CODES
+  0  Skill installed or updated
+`.trimStart(),
+  incidents: `
+snapfail incidents \u2014 List incident groups for your project
+
+USAGE
+  snapfail incidents [options]
+
+OPTIONS
+  --pk <key>       Project key (overrides .env / SNAPFAIL_PROJECT_KEY)
+  --status <s>     Filter by status: unresolved (default), resolved, ignored, all
+  --limit <n>      Number of results to show (default: 5)
+  --offset <n>     Pagination offset (default: 0)
+  --json           Output raw JSON for LLM consumption
+
+DESCRIPTION
+  Lists grouped incident summaries. Each group aggregates all occurrences of
+  the same error fingerprint. Use \`snapfail incident <id>\` to drill in.
+
+  When running interactively (no --json), prompts for project selection if
+  no project key is configured.
+
+EXAMPLES
+  snapfail incidents
+  snapfail incidents --limit 20 --status resolved
+  snapfail incidents --json --pk proj_abc123
+
+EXIT CODES
+  0  Success
+  1  Auth or API error
+`.trimStart(),
+  incident: `
+snapfail incident \u2014 View or update a single incident group
+
+USAGE
+  snapfail incident <id> [options]
+
+OPTIONS
+  --pk <key>       Project key (overrides .env / SNAPFAIL_PROJECT_KEY)
+  --sample <n>     Show the Nth raw sample (0-based index)
+  --resolve        Mark the incident as resolved
+  --ignore         Mark the incident as ignored
+  --reopen         Reopen a resolved or ignored incident (sets to unresolved)
+  --delete         Permanently delete the group and all its samples
+  --json           Output raw JSON for LLM consumption
+
+DESCRIPTION
+  Without status flags: displays the incident group summary and a
+  representative timeline sample.
+
+  With --sample <n>: shows the full raw event data for that specific sample,
+  useful for comparing across different occurrences.
+
+  Status flags (--resolve, --ignore, --reopen) update the group on the server
+  and print confirmation. Use --json to get machine-readable output.
+
+EXAMPLES
+  snapfail incident abc123
+  snapfail incident abc123 --sample 2
+  snapfail incident abc123 --resolve
+  snapfail incident abc123 --json --pk proj_abc123
+
+EXIT CODES
+  0  Success
+  1  Not found or API error
+`.trimStart(),
+  explain: `
+snapfail explain \u2014 Output raw evidence context for LLM analysis
+
+USAGE
+  snapfail explain <id> [options]
+
+OPTIONS
+  --pk <key>   Project key (overrides .env / SNAPFAIL_PROJECT_KEY)
+  --json       Output raw JSON ({ group, samples }) instead of formatted markdown
+
+DESCRIPTION
+  Fetches the incident group and up to 3 representative samples, then outputs
+  structured evidence (error, stack, console, network, timeline) formatted for
+  an LLM to reason about root cause.
+
+  This command does NOT pre-diagnose. Pipe the output to a frontier model
+  (Claude, GPT-4, etc.) and ask it to identify the root cause.
+
+  The --json flag outputs the raw data objects, useful when you want to
+  process the evidence programmatically.
+
+EXAMPLES
+  snapfail explain abc123
+  snapfail explain abc123 --json | claude --print "What caused this error?"
+
+EXIT CODES
+  0  Success
+  1  Not found or API error
+`.trimStart()
+};
+function printHelp(command) {
+  if (!command) {
+    process.stdout.write(GLOBAL_HELP);
+    return;
+  }
+  const text2 = COMMAND_HELP[command];
+  if (text2) {
+    process.stdout.write(text2);
+  } else {
+    process.stdout.write(`No help found for command: ${command}
+
+`);
+    process.stdout.write(GLOBAL_HELP);
+  }
+}
 // package.json
 var package_default = {
   name: "snapfail",
-  version: "0.0.25",
+  version: "0.0.26",
   type: "module",
   description: "CLI for snapfail \u2014 project setup, incident inspection and AI diagnostics",
   license: "MIT",
@@ -2483,10 +2779,19 @@ async function main() {
   const { command, args, flags } = parseArgs(process.argv);
   const json = flags["json"] === true;
   const pk = typeof flags["pk"] === "string" ? flags["pk"] : undefined;
+  const helpFlag = flags["help"] === true || flags["h"] === true;
   if (command === "--version" || command === "-v" || flags["version"] === true) {
     console.log(VERSION);
     return;
   }
+  if (command === "help") {
+    printHelp(args[0]);
+    return;
+  }
+  if (helpFlag) {
+    printHelp(command);
+    return;
+  }
   try {
     if (command === "init") {
       await runInit();
@@ -2513,25 +2818,35 @@ async function main() {
     if (command === "incident") {
       const id = args[0];
       if (!id) {
-        console.error("Usage: snapfail incident <id> [--sample <n>] [--json]");
+        printHelp("incident");
         process.exit(1);
       }
       const sampleFlag = flags["sample"];
       const sample = typeof sampleFlag === "string" ? parseInt(sampleFlag) : undefined;
-      await runIncident({ id, sample, json, pk, delete: flags["delete"] === true });
+      await runIncident({
+        id,
+        sample,
+        json,
+        pk,
+        delete: flags["delete"] === true,
+        resolve: flags["resolve"] === true,
+        ignore: flags["ignore"] === true,
+        reopen: flags["reopen"] === true
+      });
       return;
     }
     if (command === "explain") {
       const id = args[0];
       if (!id) {
-        console.error("Usage: snapfail explain <id> [--force] [--json]");
+        printHelp("explain");
         process.exit(1);
       }
       await runExplain({ id, json, pk });
       return;
     }
-    console.error(`Unknown command: ${command}`);
-    console.error(`snapfail v${VERSION} \u2014 Usage: snapfail [init|login|incidents|incident|explain|skill] [--version]`);
+    console.error(`Unknown command: ${command}
+`);
+    printHelp();
     process.exit(1);
   } catch (err) {
     const message = err instanceof Error ? err.message : String(err);

package/package.json

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