inboxctl 0.3.0 → 0.4.0

package/dist/cli.js

@@ -31,6 +31,7 @@ import {
   getLabelDistribution,
   getMessage,
   getNewsletters,
+  getNoiseSenders,
   getOAuthReadiness,
   getRecentEmails,
   getRecentRuns,
@@ -39,7 +40,10 @@ import {
   getSenderStats,
   getSqlite,
   getSyncStatus,
+  getThread,
   getTopSenders,
+  getUncategorizedSenders,
+  getUnsubscribeSuggestions,
   getVolumeByPeriod,
   incrementalSync,
   initializeDb,
@@ -53,7 +57,9 @@ import {
   loadTokens,
   markRead,
   markUnread,
+  queryEmails,
   reconcileCacheForAuthenticatedAccount,
+  reviewCategorized,
   runAllRules,
   runRule,
   saveTokens,
@@ -61,8 +67,9 @@ import {
   startMcpServer,
   startOAuthFlow,
   syncLabels,
-  undoRun
-} from "./chunk-OLL3OA5B.js";
+  undoRun,
+  unsubscribe
+} from "./chunk-2PN3TSVQ.js";
 
 // src/cli.ts
 import { Command } from "commander";
@@ -254,7 +261,7 @@ function getScreenGuide(screen, focus) {
     case "email":
       return "Esc back  \u2022  j/k scroll  \u2022  a archive  \u2022  l label  \u2022  r toggle read";
     case "stats":
-      return "Esc back  \u2022  s senders  \u2022  l labels  \u2022  n newsletters";
+      return "Esc back  \u2022  s senders  \u2022  l labels  \u2022  n newsletters  \u2022  o noise  \u2022  c uncategorized  \u2022  u unsubscribe";
     case "rules":
       return `Esc back  \u2022  Tab switch ${focus === "history" ? "history" : "rules"} focus  \u2022  d deploy  \u2022  e toggle  \u2022  r dry-run  \u2022  R apply  \u2022  u undo`;
     case "search":
@@ -525,6 +532,9 @@ function App({ initialSync = true }) {
   const [statsSenders, setStatsSenders] = useState([]);
   const [statsLabels, setStatsLabels] = useState([]);
   const [statsNewsletters, setStatsNewsletters] = useState([]);
+  const [statsNoise, setStatsNoise] = useState([]);
+  const [statsUncategorized, setStatsUncategorized] = useState(null);
+  const [statsUnsubscribe, setStatsUnsubscribe] = useState([]);
   const [statsVolume, setStatsVolume] = useState([]);
   const [rulesLoading, setRulesLoading] = useState(false);
   const [rulesFocus, setRulesFocus] = useState("rules");
@@ -582,17 +592,23 @@ function App({ initialSync = true }) {
   async function loadStats() {
     setStatsLoading(true);
     try {
-      const [overview, senders, labels2, newsletters, volume] = await Promise.all([
+      const [overview, senders, labels2, newsletters, noise, uncategorized, unsubscribe2, volume] = await Promise.all([
         getInboxOverview(),
         getTopSenders({ limit: 10 }),
         getLabelDistribution(),
         getNewsletters({ minMessages: 1 }),
+        getNoiseSenders({ limit: 10 }),
+        getUncategorizedSenders({ limit: 10 }),
+        getUnsubscribeSuggestions({ limit: 10 }),
         getVolumeByPeriod("day", { start: Date.now() - 30 * 24 * 60 * 60 * 1e3, end: Date.now() })
       ]);
       setStatsOverview(overview);
       setStatsSenders(senders);
       setStatsLabels(labels2.slice(0, 10));
       setStatsNewsletters(newsletters.slice(0, 10));
+      setStatsNoise(noise.senders);
+      setStatsUncategorized(uncategorized);
+      setStatsUnsubscribe(unsubscribe2.suggestions);
       setStatsVolume(volume.slice(-7));
     } catch (error) {
       pushFlash("error", error instanceof Error ? error.message : String(error));
@@ -1023,6 +1039,18 @@ function App({ initialSync = true }) {
       }
       if (input2 === "n") {
         setStatsTab("newsletters");
+        return;
+      }
+      if (input2 === "o") {
+        setStatsTab("noise");
+        return;
+      }
+      if (input2 === "c") {
+        setStatsTab("uncategorized");
+        return;
+      }
+      if (input2 === "u") {
+        setStatsTab("unsubscribe");
       }
       return;
     }
@@ -1261,7 +1289,7 @@ function App({ initialSync = true }) {
         Panel,
         {
           title: "Stats Dashboard",
-          subtitle: "s senders  \u2022  l labels  \u2022  n newsletters  \u2022  Esc back",
+          subtitle: "s senders  \u2022  l labels  \u2022  n newsletters  \u2022  o noise  \u2022  c uncategorized  \u2022  u unsubscribe  \u2022  Esc back",
           accent: "yellow",
           children: statsLoading ? /* @__PURE__ */ jsxs(Text, { color: "cyan", children: [
             /* @__PURE__ */ jsx(Spinner, { type: "dots" }),
@@ -1307,7 +1335,13 @@ function App({ initialSync = true }) {
               /* @__PURE__ */ jsx(Text, { children: " " }),
               /* @__PURE__ */ jsx(Text, { color: statsTab === "labels" ? "cyan" : "gray", children: "[Labels]" }),
               /* @__PURE__ */ jsx(Text, { children: " " }),
-              /* @__PURE__ */ jsx(Text, { color: statsTab === "newsletters" ? "cyan" : "gray", children: "[Newsletters]" })
+              /* @__PURE__ */ jsx(Text, { color: statsTab === "newsletters" ? "cyan" : "gray", children: "[Newsletters]" }),
+              /* @__PURE__ */ jsx(Text, { children: " " }),
+              /* @__PURE__ */ jsx(Text, { color: statsTab === "noise" ? "cyan" : "gray", children: "[Noise]" }),
+              /* @__PURE__ */ jsx(Text, { children: " " }),
+              /* @__PURE__ */ jsx(Text, { color: statsTab === "uncategorized" ? "cyan" : "gray", children: "[Uncategorized]" }),
+              /* @__PURE__ */ jsx(Text, { children: " " }),
+              /* @__PURE__ */ jsx(Text, { color: statsTab === "unsubscribe" ? "cyan" : "gray", children: "[Unsubscribe]" })
             ] }),
             statsTab === "senders" ? /* @__PURE__ */ jsx(
               Table,
@@ -1349,6 +1383,70 @@ function App({ initialSync = true }) {
                 emptyMessage: "No newsletters detected."
               }
             ) : null,
+            statsTab === "noise" ? /* @__PURE__ */ jsx(
+              Table,
+              {
+                title: "Noise Senders",
+                headers: ["SENDER", "EMAILS", "UNREAD%", "SCORE", "UNSUB"],
+                rows: statsNoise.map((sender) => [
+                  truncate(sender.name || sender.email, 24),
+                  String(sender.messageCount),
+                  formatPercent(sender.unreadRate),
+                  String(sender.noiseScore),
+                  sender.hasUnsubscribeLink ? "Yes" : "No"
+                ]),
+                emptyMessage: "No noisy senders detected."
+              }
+            ) : null,
+            statsTab === "uncategorized" ? /* @__PURE__ */ jsxs(Fragment, { children: [
+              /* @__PURE__ */ jsxs(Box, { marginTop: 1, flexDirection: "column", children: [
+                /* @__PURE__ */ jsxs(Text, { children: [
+                  "Uncategorized: ",
+                  statsUncategorized?.totalEmails ?? 0,
+                  " emails from ",
+                  statsUncategorized?.totalSenders ?? 0,
+                  " senders"
+                ] }),
+                /* @__PURE__ */ jsxs(Text, { color: "gray", children: [
+                  "High ",
+                  statsUncategorized?.summary.byConfidence.high.senders ?? 0,
+                  "  \u2022  Medium ",
+                  statsUncategorized?.summary.byConfidence.medium.senders ?? 0,
+                  "  \u2022  Low ",
+                  statsUncategorized?.summary.byConfidence.low.senders ?? 0
+                ] })
+              ] }),
+              /* @__PURE__ */ jsx(
+                Table,
+                {
+                  title: "Uncategorized Senders",
+                  headers: ["SENDER", "EMAILS", "UNREAD%", "CONF", "SIGNALS"],
+                  rows: (statsUncategorized?.senders || []).map((sender) => [
+                    truncate(sender.name || sender.sender, 20),
+                    String(sender.emailCount),
+                    formatPercent(sender.unreadRate),
+                    sender.confidence.toUpperCase(),
+                    truncate(sender.signals.join(","), 22)
+                  ]),
+                  emptyMessage: "No uncategorized senders detected."
+                }
+              )
+            ] }) : null,
+            statsTab === "unsubscribe" ? /* @__PURE__ */ jsx(
+              Table,
+              {
+                title: "Unsubscribe Candidates",
+                headers: ["SENDER", "EMAILS", "UNREAD%", "IMPACT", "METHOD"],
+                rows: statsUnsubscribe.map((sender) => [
+                  truncate(sender.name || sender.email, 24),
+                  String(sender.allTimeMessageCount),
+                  formatPercent(sender.unreadRate),
+                  String(sender.impactScore),
+                  sender.unsubscribeMethod
+                ]),
+                emptyMessage: "No unsubscribe candidates detected."
+              }
+            ) : null,
             /* @__PURE__ */ jsx(
               Table,
               {
@@ -3383,6 +3481,22 @@ function pad2(value, width) {
 function printSection(title) {
   console.log(ui.bold(title));
 }
+function printSimpleTable(headers, rows) {
+  const widths = headers.map(
+    (header, index) => Math.max(
+      header.length,
+      ...rows.map((row) => stripAnsi2(row[index] || "").length)
+    )
+  );
+  console.log(
+    headers.map((header, index) => pad2(ui.dim(header), widths[index] || header.length)).join("  ")
+  );
+  for (const row of rows) {
+    console.log(
+      row.map((cell, index) => pad2(cell, widths[index] || cell.length)).join("  ")
+    );
+  }
+}
 function printKeyValue(label, value) {
   console.log(`${ui.dim(`${label}:`)} ${value}`);
 }
@@ -3559,6 +3673,13 @@ function formatPercent2(value) {
   const normalized = Number.isInteger(value) ? String(value) : value.toFixed(1).replace(/\.0$/, "");
   return `${normalized}%`;
 }
+function maybePrintJson(enabled, value) {
+  if (!enabled) {
+    return false;
+  }
+  console.log(JSON.stringify(value, null, 2));
+  return true;
+}
 function formatSenderIdentity(name, email, width) {
   const identity = name && name !== email ? `${name} <${email}>` : email;
   return pad2(truncate2(identity, width), width);
@@ -3697,6 +3818,149 @@ function printVolumeTable(label, points) {
     );
   }
 }
+function formatConfidence(confidence) {
+  const upper = confidence.toUpperCase();
+  switch (confidence) {
+    case "high":
+      return ui.green(upper);
+    case "medium":
+      return ui.yellow(upper);
+    case "low":
+      return ui.red(upper);
+  }
+}
+function formatSeverity(severity) {
+  return severity === "high" ? ui.red(severity.toUpperCase()) : ui.yellow(severity.toUpperCase());
+}
+function formatYesNo(value) {
+  return value ? ui.green("Yes") : ui.dim("No");
+}
+function formatImpactLevel(score) {
+  if (score >= 25) {
+    return ui.red("HIGH");
+  }
+  if (score >= 10) {
+    return ui.yellow("MEDIUM");
+  }
+  return ui.green("LOW");
+}
+function formatGenericCell(value) {
+  if (value === null || value === void 0) {
+    return "-";
+  }
+  if (typeof value === "boolean") {
+    return value ? "true" : "false";
+  }
+  if (typeof value === "number") {
+    return Number.isInteger(value) ? String(value) : value.toFixed(1).replace(/\.0$/, "");
+  }
+  return String(value);
+}
+function printNoiseSendersTable(result) {
+  printSection(`Noise Senders (${result.senders.length})`);
+  printSimpleTable(
+    ["SENDER", "EMAILS", "UNREAD", "SCORE", "UNSUB?"],
+    result.senders.map((sender) => [
+      truncate2(sender.name || sender.email, 34),
+      String(sender.messageCount),
+      formatPercent2(sender.unreadRate),
+      String(sender.noiseScore),
+      formatYesNo(sender.hasUnsubscribeLink)
+    ])
+  );
+}
+function printUncategorizedSendersTable(result) {
+  printSection(`Uncategorized: ${result.totalEmails} emails from ${result.totalSenders} senders`);
+  console.log("");
+  printSimpleTable(
+    ["CONFIDENCE", "SENDERS", "EMAILS"],
+    [
+      ["HIGH", String(result.summary.byConfidence.high.senders), String(result.summary.byConfidence.high.emails)],
+      ["MEDIUM", String(result.summary.byConfidence.medium.senders), String(result.summary.byConfidence.medium.emails)],
+      ["LOW", String(result.summary.byConfidence.low.senders), String(result.summary.byConfidence.low.emails)]
+    ]
+  );
+  if (result.summary.topDomains.length > 0) {
+    console.log("");
+    printSection("Top Domains");
+    printSimpleTable(
+      ["DOMAIN", "EMAILS", "SENDERS"],
+      result.summary.topDomains.map((domain) => [
+        domain.domain,
+        String(domain.emails),
+        String(domain.senders)
+      ])
+    );
+  }
+  console.log("");
+  printSection("Top Senders");
+  printSimpleTable(
+    ["SENDER", "EMAILS", "UNREAD", "CONFIDENCE", "SIGNALS"],
+    result.senders.map((sender) => [
+      truncate2(sender.name && sender.name !== sender.sender ? `${sender.name} <${sender.sender}>` : sender.sender, 36),
+      String(sender.emailCount),
+      formatPercent2(sender.unreadRate),
+      formatConfidence(sender.confidence),
+      truncate2(sender.signals.join(", "), 40)
+    ])
+  );
+}
+function printUnsubscribeSuggestionsTable(result) {
+  printSection(`Unsubscribe Suggestions (${result.suggestions.length} candidates)`);
+  printSimpleTable(
+    ["SENDER", "EMAILS", "UNREAD", "IMPACT", "METHOD"],
+    result.suggestions.map((sender) => [
+      truncate2(sender.name || sender.email, 34),
+      String(sender.allTimeMessageCount),
+      formatPercent2(sender.unreadRate),
+      formatImpactLevel(sender.impactScore),
+      sender.unsubscribeMethod
+    ])
+  );
+}
+function printAnomaliesTable(result) {
+  printSection(result.summary);
+  if (result.anomalies.length === 0) {
+    return;
+  }
+  console.log("");
+  printSimpleTable(
+    ["SEVERITY", "SENDER", "SUBJECT", "LABEL", "RULE"],
+    result.anomalies.map((anomaly) => [
+      formatSeverity(anomaly.severity),
+      truncate2(anomaly.from, 24),
+      truncate2(anomaly.subject || "(no subject)", 32),
+      truncate2(anomaly.assignedLabel, 14),
+      anomaly.rule
+    ])
+  );
+}
+function printQueryResult(result) {
+  printSection(`Query Results (${result.rows.length} of ${result.totalRows})`);
+  if (result.rows.length === 0) {
+    console.log("No rows matched that query.");
+    return;
+  }
+  const headers = Object.keys(result.rows[0] || {});
+  printSimpleTable(
+    headers.map((header) => header.toUpperCase()),
+    result.rows.map((row) => headers.map((header) => formatGenericCell(row[header])))
+  );
+}
+function printThreadResult(result) {
+  printSection(`Thread ${ui.dim(result.id)}`);
+  printKeyValue("messages", String(result.messages.length));
+  for (const message of result.messages) {
+    console.log("");
+    printSection(message.subject || "(no subject)");
+    printKeyValue("from", message.fromAddress);
+    printKeyValue("to", message.toAddresses.join(", "));
+    printKeyValue("date", new Date(message.date).toISOString());
+    printKeyValue("labels", message.labelIds.join(", ") || "-");
+    console.log("");
+    console.log(message.textPlain || message.body || message.snippet);
+  }
+}
 function printSenderDetail(detail) {
   printSection(detail.query);
   printKeyValue("type", detail.type);
@@ -4027,7 +4291,7 @@ function printDriftReport(result) {
     );
   }
 }
-program.name("inboxctl").description("CLI email management with MCP server, rules-as-code, and TUI").version("0.3.0").option("--demo", "Launch the seeded demo mailbox").option("--no-sync", "Launch the TUI without running the initial background sync");
+program.name("inboxctl").description("CLI email management with MCP server, rules-as-code, and TUI").version("0.4.0").option("--demo", "Launch the seeded demo mailbox").option("--no-sync", "Launch the TUI without running the initial background sync");
 program.command("setup").description("Run the interactive Google Cloud and OAuth setup wizard").option("--skip-gcloud", "Skip gcloud detection and API enablement").option("--project <id>", "Pre-set the Google Cloud project ID").action(async (options) => {
   try {
     await runSetupWizard({
@@ -4141,6 +4405,20 @@ program.command("email <id>").description("View a single email").action(async (i
   console.log("");
   console.log(email.textPlain || email.body || email.snippet);
 });
+program.command("thread <id>").description("View a full email thread").action(async (id) => {
+  const status = await loadRuntimeStatus();
+  if (!status.gmailReady) {
+    await requireLiveGmailReadiness("thread");
+    return;
+  }
+  try {
+    const thread = await getThread(id);
+    printThreadResult(thread);
+  } catch (error) {
+    console.log(error instanceof Error ? error.message : String(error));
+    process.exitCode = 1;
+  }
+});
 program.command("archive [id]").description("Archive email(s)").option("-q, --query <query>", "Archive all emails matching query").action(async (id, options) => {
   const status = await loadRuntimeStatus();
   if (!status.gmailReady) {
@@ -4270,6 +4548,100 @@ program.command("history").description("Show recent run history").option("-n, --
   }
   printHistoryTable(runs);
 });
+program.command("query").description("Run structured analytics queries over the cached inbox").option("--group-by <dimension>", "Group by sender|domain|label|year_month|year_week|day_of_week|is_read|is_newsletter").option("--aggregate <values...>", "Aggregates to return (count, unread_count, unread_rate, newest, oldest, sender_count)").option("--from <address>", "Exact sender email").option("--from-contains <text>", "Partial sender match").option("--domain <domain>", "Exact sender domain").option("--domain-contains <text>", "Partial sender domain match").option("--subject-contains <text>", "Partial subject match").option("--since <date>", "Filter to emails on or after this ISO date").option("--before <date>", "Filter to emails on or before this ISO date").option("--read", "Only read emails").option("--unread", "Only unread emails").option("--newsletter", "Only newsletter senders").option("--without-newsletter", "Exclude newsletter senders").option("--label <name>", "Only emails with a specific label").option("--has-label", "Only emails with any user label").option("--without-label", "Only emails with no user labels").option("--has-unsubscribe", "Only emails with a List-Unsubscribe header").option("--min-sender-messages <number>", "Only senders with at least this many total emails").option("--having-count-gte <number>", "Require grouped count to be >= this value").option("--having-count-lte <number>", "Require grouped count to be <= this value").option("--having-unread-rate-gte <number>", "Require grouped unread_rate to be >= this value").option("--sort <value>", 'Sort expression, for example: "count desc"').option("--limit <number>", "Maximum rows to return", "50").option("--json", "Output raw JSON").action(async (options) => {
+  try {
+    if (options.read && options.unread) {
+      throw new Error("Use only one of --read or --unread.");
+    }
+    if (options.newsletter && options.withoutNewsletter) {
+      throw new Error("Use only one of --newsletter or --without-newsletter.");
+    }
+    if (options.hasLabel && options.withoutLabel) {
+      throw new Error("Use only one of --has-label or --without-label.");
+    }
+    const result = await queryEmails({
+      filters: {
+        ...options.from ? { from: options.from } : {},
+        ...options.fromContains ? { from_contains: options.fromContains } : {},
+        ...options.domain ? { domain: options.domain } : {},
+        ...options.domainContains ? { domain_contains: options.domainContains } : {},
+        ...options.subjectContains ? { subject_contains: options.subjectContains } : {},
+        ...options.since ? { date_after: options.since } : {},
+        ...options.before ? { date_before: options.before } : {},
+        ...options.read ? { is_read: true } : {},
+        ...options.unread ? { is_read: false } : {},
+        ...options.newsletter ? { is_newsletter: true } : {},
+        ...options.withoutNewsletter ? { is_newsletter: false } : {},
+        ...options.label ? { label: options.label } : {},
+        ...options.hasLabel ? { has_label: true } : {},
+        ...options.withoutLabel ? { has_label: false } : {},
+        ...options.hasUnsubscribe ? { has_unsubscribe: true } : {},
+        ...options.minSenderMessages ? { min_sender_messages: parseIntegerOption(options.minSenderMessages, "min-sender-messages") } : {}
+      },
+      ...options.groupBy ? { group_by: options.groupBy } : {},
+      ...options.aggregate ? { aggregates: options.aggregate } : {},
+      ...options.sort ? { order_by: options.sort } : {},
+      ...options.havingCountGte || options.havingCountLte || options.havingUnreadRateGte ? {
+        having: {
+          ...options.havingCountGte || options.havingCountLte ? {
+            count: {
+              ...options.havingCountGte ? { gte: parseIntegerOption(options.havingCountGte, "having-count-gte") } : {},
+              ...options.havingCountLte ? { lte: parseIntegerOption(options.havingCountLte, "having-count-lte") } : {}
+            }
+          } : {},
+          ...options.havingUnreadRateGte ? {
+            unread_rate: {
+              gte: parsePercentOption(options.havingUnreadRateGte, "having-unread-rate-gte")
+            }
+          } : {}
+        }
+      } : {},
+      limit: parseIntegerOption(options.limit, "limit")
+    });
+    if (maybePrintJson(options.json, result)) {
+      return;
+    }
+    printQueryResult(result);
+  } catch (error) {
+    console.log(error instanceof Error ? error.message : String(error));
+    process.exitCode = 1;
+  }
+});
+program.command("unsubscribe <sender>").description("Return an unsubscribe target for a sender and optionally archive or label existing mail").option("--no-archive", "Only return the unsubscribe link, do not archive existing mail").option("--label <name>", "Label existing emails while unsubscribing").action(async (sender, options) => {
+  if (options.archive || options.label) {
+    const status = await loadRuntimeStatus();
+    if (!status.gmailReady) {
+      await requireLiveGmailReadiness("unsubscribe");
+      return;
+    }
+  }
+  try {
+    const result = await unsubscribe({
+      senderEmail: sender,
+      alsoArchive: options.archive,
+      alsoLabel: options.label
+    });
+    printSection(`Unsubscribing from ${result.sender}`);
+    printKeyValue("messages", String(result.messageCount));
+    printKeyValue("archived", String(result.archivedCount));
+    printKeyValue("labeled", String(result.labeledCount));
+    if (result.runId) {
+      printKeyValue("runId", `${ui.dim(result.runId)} (undo with: inboxctl undo ${result.runId})`);
+    }
+    printKeyValue("method", result.unsubscribeMethod);
+    console.log("");
+    console.log(result.instruction);
+    console.log("");
+    console.log(result.unsubscribeLink);
+    if (options.archive) {
+      console.log("");
+      console.log(`Tip: Create a Gmail filter to auto-archive future mail: inboxctl filters create --from ${result.sender} --archive`);
+    }
+  } catch (error) {
+    console.log(error instanceof Error ? error.message : String(error));
+    process.exitCode = 1;
+  }
+});
 var labels = program.command("labels").description("Manage Gmail labels");
 labels.command("list").description("List all Gmail labels").action(async () => {
   const status = await loadRuntimeStatus();
@@ -4348,6 +4720,90 @@ stats.command("senders").description("Top senders by volume").option("--top <num
     process.exitCode = 1;
   }
 });
+stats.command("noise").description("High-noise senders ranked by noise score").option("--top <number>", "Number of senders", "20").option("--sort <mode>", "Sort by noise_score|all_time_noise_score|message_count|unread_rate", "noise_score").option("--min-score <number>", "Minimum noise score", "5").option("--active-days <number>", "Only consider recent activity within this many days", "90").option("--json", "Output raw JSON").action(async (options) => {
+  try {
+    const result = await getNoiseSenders({
+      limit: parseIntegerOption(options.top, "top"),
+      sortBy: options.sort,
+      minNoiseScore: Number(options.minScore),
+      activeDays: parseIntegerOption(options.activeDays, "active-days")
+    });
+    if (maybePrintJson(options.json, result)) {
+      return;
+    }
+    if (result.senders.length === 0) {
+      console.log("No noisy senders matched that filter.");
+      return;
+    }
+    printNoiseSendersTable(result);
+  } catch (error) {
+    console.log(error instanceof Error ? error.message : String(error));
+    process.exitCode = 1;
+  }
+});
+stats.command("uncategorized").description("Summarize uncategorized emails by sender").option("--top <number>", "Number of senders", "20").option("--confidence <level>", "Filter by confidence: high|medium|low").option("--min-emails <number>", "Minimum uncategorized emails per sender", "1").option("--since <date>", "Only include uncategorized emails on or after this ISO date").option("--sort <mode>", "Sort by email_count|newest|unread_rate", "email_count").option("--json", "Output raw JSON").action(async (options) => {
+  try {
+    const result = await getUncategorizedSenders({
+      limit: parseIntegerOption(options.top, "top"),
+      confidence: options.confidence,
+      minEmails: parseIntegerOption(options.minEmails, "min-emails"),
+      since: options.since,
+      sortBy: options.sort
+    });
+    if (maybePrintJson(options.json, result)) {
+      return;
+    }
+    if (result.totalSenders === 0) {
+      console.log("No uncategorized senders matched that filter.");
+      return;
+    }
+    printUncategorizedSendersTable(result);
+  } catch (error) {
+    console.log(error instanceof Error ? error.message : String(error));
+    process.exitCode = 1;
+  }
+});
+stats.command("unsubscribe").description("Rank unsubscribe candidates by impact").option("--top <number>", "Number of senders", "20").option("--min-emails <number>", "Minimum emails from a sender", "5").option("--unread-only-senders", "Only show senders where every email is unread").option("--json", "Output raw JSON").action(async (options) => {
+  try {
+    const result = await getUnsubscribeSuggestions({
+      limit: parseIntegerOption(options.top, "top"),
+      minMessages: parseIntegerOption(options.minEmails, "min-emails"),
+      unreadOnlySenders: options.unreadOnlySenders
+    });
+    if (maybePrintJson(options.json, result)) {
+      return;
+    }
+    if (result.suggestions.length === 0) {
+      console.log("No unsubscribe suggestions matched that filter.");
+      return;
+    }
+    printUnsubscribeSuggestionsTable(result);
+    console.log("");
+    console.log("Run `inboxctl unsubscribe <sender>` to process a specific sender.");
+  } catch (error) {
+    console.log(error instanceof Error ? error.message : String(error));
+    process.exitCode = 1;
+  }
+});
+stats.command("anomalies").description("Review recently categorized emails for potential misclassifications").option("--since <date>", "Only review items on or after this ISO date").option("--limit <number>", "Maximum anomalies to return", "20").option("--json", "Output raw JSON").action(async (options) => {
+  try {
+    const result = await reviewCategorized({
+      ...options.since ? { since: options.since } : {},
+      limit: parseIntegerOption(options.limit, "limit")
+    });
+    if (maybePrintJson(options.json, result)) {
+      return;
+    }
+    printAnomaliesTable(result);
+    if (result.anomalies.length > 0) {
+      console.log("");
+      console.log("Undo a run with `inboxctl undo <run-id>`.");
+    }
+  } catch (error) {
+    console.log(error instanceof Error ? error.message : String(error));
+    process.exitCode = 1;
+  }
+});
 stats.command("newsletters").description("Detected newsletters and mailing lists").option("--min-unread <percent>", "Minimum unread rate filter").action(async (options) => {
   try {
     const minUnread = parsePercentOption(options.minUnread, "min-unread");