feat(system): implement graceful shutdown and expand websocket events

Improve system reliability and real-time capabilities by implementing a robust lifecycle management system and adding new broadcast events for attachments and voice recordings.

- Implement asynchronous graceful shutdown in backend to close HTTP, WebSocket, Redis, and database connections.
- Add new WebSocket broadcast events: `attachment_created`, `voice_recording_started`, `voice_recording_stopped`, `voice_recording_uploaded`, and `analysis_queue_status`.
- Refactor media status handling to use boolean `playing` state instead of string-based status.
- Centralize `PageResult` and `VoiceRecording` types to improve consistency between frontend and backend.
- Update frontend API client to include `listRecordings` and handle new WebSocket event types.
- Fix type mismatches in voice command handling and media status reporting.

services/backend/src/modules/media/media.service.ts

@@ -47,8 +47,14 @@ export async function getStatus(): Promise<MediaState> {
   const cached = await readRedisStatus("media:status");
 
   if (cached) {
+    const rawPlaying = cached.playing;
+    // Handle both boolean (new) and string (legacy from String(discordPlayer.getStatus()))
+    const playing =
+      rawPlaying === true ||
+      rawPlaying === "playing" ||
+      rawPlaying === "buffering";
     return {
-      playing: Boolean(cached.playing),
+      playing,
       musicVolume: Number(cached.musicVolume ?? 1.0),
       current: (cached.current as MediaItem | null) ?? null,
       queue: (cached.queue as MediaItem[]) ?? [],

services/backend/src/modules/messages/messages.repository.ts

@@ -1,3 +1,4 @@
+import type { PageResult } from "@bete/shared";
 import { createChildLogger } from "@bete/shared/logger";
 import { getPool } from "../../shared/database/index.js";
 import type {
@@ -8,11 +9,6 @@ import type {
 
 const logger = createChildLogger("messages.repository");
 
-export interface PageResult<T> {
-  data: T[];
-  nextCursor: string | null;
-}
-
 export interface AttachmentResult {
   id: string;
   message_id: string;

services/backend/src/modules/voice/voice.controller.ts

@@ -12,13 +12,15 @@ export async function handleGetVoiceStatus(_req: Request, res: Response) {
   res.json(status);
 }
 
+/** Safely extract a string value that may be a single string or string array. */
+function asString(val: unknown): string {
+  if (Array.isArray(val)) return String(val[0] ?? "");
+  return String(val ?? "");
+}
+
 export async function handleConnectVoice(req: Request, res: Response) {
-  const guildId = Array.isArray(req.body.guildId)
-    ? req.body.guildId[0]
-    : req.body.guildId;
-  const channelId = Array.isArray(req.body.channelId)
-    ? req.body.channelId[0]
-    : req.body.channelId;
+  const guildId = asString(req.body.guildId);
+  const channelId = asString(req.body.channelId);
   if (!guildId || !channelId) {
     return res.status(400).json({
       error: "VALIDATION_ERROR",
@@ -35,17 +37,13 @@ export async function handleDisconnectVoice(_req: Request, res: Response) {
 }
 
 export async function handleGetVoiceChannels(req: Request, res: Response) {
-  const guildId = Array.isArray(req.params.guildId)
-    ? req.params.guildId[0]
-    : req.params.guildId;
+  const guildId = asString(req.params.guildId);
   const channels = await getVoiceChannels(guildId);
   res.json(channels);
 }
 
 export async function handleVoiceCommand(req: Request, res: Response) {
-  const command = Array.isArray(req.body.command)
-    ? req.body.command[0]
-    : req.body.command;
+  const command = asString(req.body.command);
 
   if (!command) {
     return res.status(400).json({
@@ -55,7 +53,7 @@ export async function handleVoiceCommand(req: Request, res: Response) {
   }
 
   try {
-    await publishCommandNoReply(command as string);
+    await publishCommandNoReply(command);
     res.json({ success: true, command });
   } catch (err) {
     res.status(500).json({