refactor: atomic, DRY, and logging improvements

- Shared Redis channel constants as single source of truth (redis-channels.ts)
- commandHandler.ts split into VoiceHandler, MediaHandler, GuildHandler,
  ModerationHandler with handler-registry.ts dispatch
- messageStore.ts (1322 lines) split into domain-specific DB files:
  messages.db.ts, attachments.db.ts, reviews.db.ts,
  moderation-actions.db.ts, retention.db.ts
- recorder.ts startSpeaking callback extracted into speakingHandler.ts,
  streamSetup.ts, segmentFinalizer.ts
- autoDeleteManager.ts split into autoDeleteEligibility.ts,
  autoDeleteNotify.ts, autoDeleteLogger.ts
- Added createChildLogger() logging across 8 service files
- Backend messages.repository.ts migrated from raw SQL to Drizzle ORM
- Fixed biome.json to exclude packages/**/dist/* from lint
- Fixed config.ts GUILD_ID pre-existing type error

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

services/discord-gateway/src/modules/message-capture/reviews.db.ts

@@ -0,0 +1,165 @@
+import { createChildLogger, type Logger } from "@bete/shared/logger";
+import { and, desc, eq, type SQL, sql } from "drizzle-orm";
+import type { NodePgDatabase } from "drizzle-orm/node-postgres";
+import type * as schema from "../../shared/database/schema.js";
+import { messageReviewsTable } from "../../shared/database/schema.js";
+import { decodeCursor, encodeCursor } from "../message-capture/pagination.js";
+import type { MessageReview, PageResult } from "../message-capture/types.js";
+
+// ─── Helpers ────────────────────────────────────────────────────────────────
+
+function pageRows<T extends { created_at: number; id: string }>(
+  rows: unknown[],
+  limit: number,
+): PageResult<T> {
+  const hasMore = rows.length > limit;
+  const data = rows.slice(0, limit) as T[];
+  const lastItem = data[data.length - 1];
+  const nextCursor =
+    hasMore && lastItem
+      ? encodeCursor({ created_at: lastItem.created_at, id: lastItem.id })
+      : null;
+
+  return { data, nextCursor };
+}
+
+// ─── ReviewsDb Class ────────────────────────────────────────────────────────
+
+export class ReviewsDb {
+  private logger: Logger;
+
+  constructor(
+    private db: NodePgDatabase<typeof schema>,
+    _parentLogger?: Logger,
+  ) {
+    this.logger = createChildLogger("reviews-db");
+  }
+
+  async createMessageReview(
+    review: Omit<MessageReview, "id" | "created_at">,
+  ): Promise<MessageReview> {
+    this.logger.debug(
+      { messageId: review.message_id },
+      "createMessageReview entry",
+    );
+    try {
+      const id = `review-${Date.now()}-${Math.random().toString(36).slice(2, 9)}`;
+      const created_at = Date.now();
+
+      const rows = await this.db
+        .insert(messageReviewsTable)
+        .values({
+          ...review,
+          id,
+          created_at,
+        })
+        .returning();
+
+      return rows[0] as MessageReview;
+    } catch (error) {
+      this.logger.error(
+        {
+          messageId: review.message_id,
+          error: error instanceof Error ? error.message : String(error),
+        },
+        "Failed to create message review",
+      );
+      throw error;
+    }
+  }
+
+  async getMessageReview(id: string): Promise<MessageReview | null> {
+    this.logger.debug({ reviewId: id }, "getMessageReview entry");
+    try {
+      const rows = await this.db
+        .select()
+        .from(messageReviewsTable)
+        .where(eq(messageReviewsTable.id, id));
+
+      return (rows[0] as MessageReview) || null;
+    } catch (error) {
+      this.logger.error(
+        {
+          reviewId: id,
+          error: error instanceof Error ? error.message : String(error),
+        },
+        "Failed to get message review",
+      );
+      throw error;
+    }
+  }
+
+  async listMessageReviews(query: {
+    guildId?: string;
+    channelId?: string;
+    status?: string[];
+    cursor?: string;
+    limit: number;
+  }): Promise<PageResult<MessageReview>> {
+    this.logger.debug({ query }, "listMessageReviews entry");
+    try {
+      const limit = Math.max(1, Math.min(query.limit || 50, 100));
+      const conditions: SQL[] = [];
+
+      if (query.guildId) {
+        conditions.push(eq(messageReviewsTable.guild_id, query.guildId));
+      }
+      if (query.channelId) {
+        conditions.push(eq(messageReviewsTable.channel_id, query.channelId));
+      }
+      if (query.status && query.status.length > 0) {
+        conditions.push(sql`${messageReviewsTable.status} in ${query.status}`);
+      }
+
+      const cursorData = decodeCursor(query.cursor);
+      if (cursorData) {
+        conditions.push(
+          sql`(${messageReviewsTable.created_at} < ${cursorData.created_at} or (${messageReviewsTable.created_at} = ${cursorData.created_at} and ${messageReviewsTable.id} < ${cursorData.id}))`,
+        );
+      }
+
+      const rows = await this.db
+        .select()
+        .from(messageReviewsTable)
+        .where(conditions.length > 0 ? and(...conditions) : undefined)
+        .orderBy(
+          desc(messageReviewsTable.created_at),
+          desc(messageReviewsTable.id),
+        )
+        .limit(limit + 1);
+
+      return pageRows<MessageReview>(rows, limit);
+    } catch (error) {
+      this.logger.error(
+        { error: error instanceof Error ? error.message : String(error) },
+        "Failed to list message reviews",
+      );
+      throw error;
+    }
+  }
+
+  async updateMessageReview(
+    id: string,
+    updates: Partial<Omit<MessageReview, "id" | "created_at">>,
+  ): Promise<MessageReview | null> {
+    this.logger.debug({ reviewId: id }, "updateMessageReview entry");
+    try {
+      const rows = (await this.db
+        .update(messageReviewsTable)
+        .set(updates)
+        .where(eq(messageReviewsTable.id, id))
+        .returning()) as MessageReview[];
+
+      return rows[0] || null;
+    } catch (error) {
+      this.logger.error(
+        {
+          reviewId: id,
+          error: error instanceof Error ? error.message : String(error),
+        },
+        "Failed to update message review",
+      );
+      throw error;
+    }
+  }
+}