Add manual outreach funnel clearing

src/database/candidate-queue-repository.ts

@@ -55,6 +55,15 @@ export interface PhysiqueTargetingReconciliation {
   retained: number;
 }
 
+export interface CandidateQueueClearResult {
+  discovered: number;
+  screening: number;
+  ready: number;
+  retryable: number;
+  total: number;
+  retainedSending: number;
+}
+
 const ACTIVE_STATUSES: CandidateStatus[] = ['discovered', 'screening', 'ready', 'sending', 'retryable'];
 
 /** Global, durable funnel from Reddit listing discovery through outbound delivery. */
@@ -251,6 +260,34 @@ export class CandidateQueueRepository {
     `).run(now, now + sendingDelayMs, now).changes;
   }
 
+  /**
+   * Cancels every candidate that cannot already be crossing the remote-send
+   * boundary. Sending leases are deliberately retained because their Matrix
+   * outcome may be unknown while this transaction runs.
+   */
+  clearUnsent(now: number = Date.now()): CandidateQueueClearResult {
+    return this.db.transaction(() => {
+      const statuses = ['discovered', 'screening', 'ready', 'retryable'] as const;
+      const counts = Object.fromEntries(statuses.map((status) => [status, 0])) as Record<(typeof statuses)[number], number>;
+      const rows = this.db.prepare(`
+        SELECT status, COUNT(*) AS count FROM candidate_queue
+        WHERE status IN (${statuses.map(() => '?').join(', ')})
+        GROUP BY status
+      `).all(...statuses) as Array<{ status: (typeof statuses)[number]; count: number }>;
+      for (const row of rows) counts[row.status] = row.count;
+      const retainedSending = (this.db.prepare(
+        `SELECT COUNT(*) AS count FROM candidate_queue WHERE status = 'sending'`,
+      ).get() as { count: number }).count;
+      const changed = this.db.prepare(`
+        UPDATE candidate_queue
+        SET status = 'rejected', last_error = 'Cleared manually by operator', updated_at = ?,
+          lease_owner = NULL, lease_expires_at = NULL, assigned_account_id = NULL
+        WHERE status IN (${statuses.map(() => '?').join(', ')})
+      `).run(now, ...statuses).changes;
+      return { ...counts, total: changed, retainedSending };
+    })();
+  }
+
   /** Re-evaluates prepared image candidates that have not yet been leased for sending. */
   reconcilePhysiqueTargeting(
     targeting: PhysiqueTargeting,