snapfail 0.0.26 → 0.0.28

package/dist/index.js

@@ -1692,6 +1692,36 @@ function requireSession() {
 }
 
 // src/api.ts
+async function listSuppressionRules(token, projectKey) {
+  const url = `${DEFAULT_ENDPOINT}/api/cli/suppress?projectKey=${encodeURIComponent(projectKey)}`;
+  const res = await fetch(url, { headers: { Authorization: `Bearer ${token}` } });
+  if (!res.ok)
+    throw new Error(`API error ${res.status}`);
+  const { rules } = await res.json();
+  return rules;
+}
+async function addSuppressionRule(token, projectKey, field, pattern) {
+  const res = await fetch(`${DEFAULT_ENDPOINT}/api/cli/suppress`, {
+    method: "POST",
+    headers: { Authorization: `Bearer ${token}`, "Content-Type": "application/json" },
+    body: JSON.stringify({ projectKey, field, pattern })
+  });
+  if (!res.ok) {
+    const body = await res.text().catch(() => "");
+    throw new Error(`API error ${res.status}: ${body}`);
+  }
+  const { rule } = await res.json();
+  return rule;
+}
+async function removeSuppressionRule(token, projectKey, id) {
+  const url = `${DEFAULT_ENDPOINT}/api/cli/suppress/${id}?projectKey=${encodeURIComponent(projectKey)}`;
+  const res = await fetch(url, {
+    method: "DELETE",
+    headers: { Authorization: `Bearer ${token}` }
+  });
+  if (!res.ok)
+    throw new Error(`API error ${res.status}`);
+}
 async function apiFetch(url, options) {
   let res;
   try {
@@ -1799,10 +1829,11 @@ function formatIncidentList(data, total, status) {
     cyan(truncate(g2.id, 12)),
     truncate(g2.title, 38),
     String(g2.count),
+    g2.affectedUsers > 0 ? String(g2.affectedUsers) : dim("\u2014"),
     g2.environments.join(","),
     relativeTime(g2.lastSeen)
   ]);
-  const table = formatTable(rows, ["ID", "TITLE", "COUNT", "ENV", "LAST SEEN"]);
+  const table = formatTable(rows, ["ID", "TITLE", "COUNT", "USERS", "ENV", "LAST SEEN"]);
   const summary = `
   ${bold(String(total))} ${status ?? "unresolved"} incident${total !== 1 ? "s" : ""}`;
   return table + summary;
@@ -1872,7 +1903,7 @@ function formatLLMContext(group, samples) {
 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("Status:")} ${group.status}  ${dim("\xB7")}  ${group.count} occurrences  ${dim("\xB7")}  ${group.affectedUsers > 0 ? `${group.affectedUsers} users  ${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("");
@@ -2551,6 +2582,163 @@ async function runLogin() {
 Logged in as ${session.email}`);
 }
 
+// src/commands/suppress.ts
+var FIELD_LABELS = {
+  message: "Error message contains",
+  useragent: "User-agent contains",
+  url: "URL contains",
+  script_origin: "Script origin contains"
+};
+async function runSuppress(opts) {
+  const session = requireSession();
+  const projectKey = await resolveProjectKey(opts.pk, !opts.json, session.token);
+  const config = loadConfig(process.cwd(), projectKey);
+  const sub = opts.subcommand;
+  if (!sub || sub === "list") {
+    const rules = await listSuppressionRules(session.token, projectKey);
+    if (opts.json) {
+      process.stdout.write(JSON.stringify({ rules }, null, 2) + `
+`);
+      return;
+    }
+    if (rules.length === 0) {
+      console.log("No suppression rules configured.");
+      console.log("Add one with: snapfail suppress add  or  snapfail suppress <incident-id>");
+      return;
+    }
+    console.log(`
+Suppression rules for ${projectKey}
+`);
+    for (const rule2 of rules) {
+      const label = FIELD_LABELS[rule2.field] ?? rule2.field;
+      console.log(`  [${rule2.id.slice(0, 8)}]  ${label}: "${rule2.pattern}"`);
+    }
+    console.log(`
+Remove a rule: snapfail suppress delete <id-prefix>`);
+    return;
+  }
+  if (sub === "delete") {
+    const id = opts.args[0];
+    if (!id) {
+      console.error("Usage: snapfail suppress delete <rule-id>");
+      process.exit(1);
+    }
+    const rules = await listSuppressionRules(session.token, projectKey);
+    const match = rules.find((r2) => r2.id.startsWith(id));
+    if (!match) {
+      console.error(`No rule found with id starting with "${id}"`);
+      process.exit(1);
+    }
+    await removeSuppressionRule(session.token, projectKey, match.id);
+    if (opts.json) {
+      process.stdout.write(JSON.stringify({ ok: true, deleted: match.id }) + `
+`);
+    } else {
+      const label = FIELD_LABELS[match.field] ?? match.field;
+      console.log(`Deleted rule: ${label} "${match.pattern}"`);
+    }
+    return;
+  }
+  if (sub === "add") {
+    const field = await select({
+      message: "What field should the rule match on?",
+      options: Object.entries(FIELD_LABELS).map(([value, label]) => ({
+        value,
+        label
+      }))
+    });
+    if (isCancel(field)) {
+      cancel("Cancelled.");
+      process.exit(0);
+    }
+    const pattern = await text({
+      message: "Pattern (case-insensitive substring)",
+      placeholder: "e.g. Instagram",
+      validate: (v) => (v ?? "").trim() ? undefined : "Pattern is required."
+    });
+    if (isCancel(pattern)) {
+      cancel("Cancelled.");
+      process.exit(0);
+    }
+    const rule2 = await addSuppressionRule(session.token, projectKey, field, pattern.trim());
+    console.log(`
+Rule added: ${FIELD_LABELS[rule2.field]} "${rule2.pattern}"`);
+    console.log("Future incidents matching this pattern will be silently dropped at ingest.");
+    return;
+  }
+  const incidentId = sub;
+  const result = await fetchIncident(config, incidentId);
+  if (!result) {
+    console.error(`Incident ${incidentId} not found.`);
+    process.exit(1);
+  }
+  const { group, sample } = result;
+  const suggestions = [];
+  const msgPattern = group.title.replace(/\[.*?\]/g, "").trim().slice(0, 60);
+  if (msgPattern.length > 5) {
+    suggestions.push({
+      field: "message",
+      pattern: msgPattern,
+      reason: `matches "${group.title}"`
+    });
+  }
+  const ua = sample.device?.userAgent ?? "";
+  const uaMatch = ua.match(/\b(Instagram|FBAN|FBAV|Twitter|TikTok|LinkedInApp|Snapchat|Pinterest)\b/i);
+  if (uaMatch) {
+    suggestions.push({
+      field: "useragent",
+      pattern: uaMatch[1],
+      reason: `this error only appears from the ${uaMatch[1]} in-app browser`
+    });
+  }
+  const firstFrame = sample.stackFrames?.[0];
+  const ownDomain = new URL(sample.url ?? "https://example.com").hostname;
+  if (firstFrame?.source) {
+    try {
+      const frameDomain = new URL(firstFrame.source).hostname;
+      if (frameDomain && frameDomain !== ownDomain) {
+        suggestions.push({
+          field: "script_origin",
+          pattern: frameDomain,
+          reason: `error originates from third-party script at ${frameDomain}`
+        });
+      }
+    } catch {}
+  }
+  if (suggestions.length === 0) {
+    console.log(`No automatic suppression suggestions for incident ${incidentId}.`);
+    console.log("Use `snapfail suppress add` to create a rule manually.");
+    return;
+  }
+  console.log(`
+Suppression suggestions for: ${group.title}
+`);
+  for (const s of suggestions) {
+    console.log(`  ${FIELD_LABELS[s.field]}: "${s.pattern}"`);
+    console.log(`  Reason: ${s.reason}
+`);
+  }
+  const chosen = await select({
+    message: "Create a suppression rule?",
+    options: [
+      ...suggestions.map((s, i2) => ({
+        value: String(i2),
+        label: `${FIELD_LABELS[s.field]}: "${s.pattern}"`
+      })),
+      { value: "none", label: "Don't create a rule" }
+    ]
+  });
+  if (isCancel(chosen) || chosen === "none") {
+    console.log("No rule created.");
+    return;
+  }
+  const selected = suggestions[Number(chosen)];
+  const rule = await addSuppressionRule(session.token, projectKey, selected.field, selected.pattern);
+  console.log(`
+Rule added: ${FIELD_LABELS[rule.field]} "${rule.pattern}"`);
+  console.log("Future incidents matching this pattern will be silently dropped at ingest.");
+}
+
 // src/help.ts
 var GLOBAL_HELP = `
 snapfail \u2014 browser error capture for AI-assisted debugging
@@ -2565,6 +2753,7 @@ COMMANDS
   incidents   List incident groups for your project
   incident    View or update a single incident group
   explain     Output raw evidence context for LLM analysis
+  suppress    Manage suppression rules to filter out noise
   help        Show this help, or help for a specific command
 
 OPTIONS
@@ -2683,6 +2872,42 @@ EXAMPLES
   snapfail incident abc123 --resolve
   snapfail incident abc123 --json --pk proj_abc123
 
+EXIT CODES
+  0  Success
+  1  Not found or API error
+`.trimStart(),
+  suppress: `
+snapfail suppress \u2014 Manage suppression rules to filter out noise
+
+USAGE
+  snapfail suppress [list]                  List active rules
+  snapfail suppress add                     Create a rule interactively
+  snapfail suppress delete <id-prefix>      Remove a rule by ID prefix
+  snapfail suppress <incident-id>           Suggest rules based on an incident
+
+OPTIONS
+  --pk <key>   Project key (overrides .env / SNAPFAIL_PROJECT_KEY)
+  --json       Output raw JSON (for list/delete)
+
+DESCRIPTION
+  Suppression rules filter out errors at ingest time \u2014 matching incidents are
+  silently dropped before being grouped or stored.
+
+  Rules match by case-insensitive substring on one of four fields:
+    message        The error message text
+    useragent      The browser/app user-agent string
+    url            The page URL where the error occurred
+    script_origin  The URL of the script file that threw the error
+
+  Pass an incident ID instead of a subcommand to get automatic suggestions
+  based on that incident's data (user-agent, error message, script origin).
+
+EXAMPLES
+  snapfail suppress
+  snapfail suppress ba7b555c                         (auto-suggest from incident)
+  snapfail suppress add
+  snapfail suppress delete a1b2c3
+
 EXIT CODES
   0  Success
   1  Not found or API error
@@ -2735,7 +2960,7 @@ function printHelp(command) {
 // package.json
 var package_default = {
   name: "snapfail",
-  version: "0.0.26",
+  version: "0.0.28",
   type: "module",
   description: "CLI for snapfail \u2014 project setup, incident inspection and AI diagnostics",
   license: "MIT",
@@ -2760,13 +2985,21 @@ function parseArgs(argv) {
   const command = rawCommand;
   const args = [];
   const flags = {};
-  for (const token of rest) {
+  for (let i2 = 0;i2 < rest.length; i2++) {
+    const token = rest[i2];
     if (token.startsWith("--")) {
       const eq = token.indexOf("=");
       if (eq !== -1) {
         flags[token.slice(2, eq)] = token.slice(eq + 1);
       } else {
-        flags[token.slice(2)] = true;
+        const key = token.slice(2);
+        const next = rest[i2 + 1];
+        if (next !== undefined && !next.startsWith("--")) {
+          flags[key] = next;
+          i2++;
+        } else {
+          flags[key] = true;
+        }
       }
     } else {
       args.push(token);
@@ -2805,6 +3038,11 @@ async function main() {
       await runSkill();
       return;
     }
+    if (command === "suppress") {
+      const [subcommand, ...rest] = args;
+      await runSuppress({ subcommand, args: rest, json, pk });
+      return;
+    }
     if (command === "incidents") {
       await runIncidents({
         json,

package/package.json

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