fix: resolve architecture disconnects and codebase weaknesses

- Standardize MessageRecord types — single source of truth from @bete/shared
- Clean up config: remove unused GUILD_ID/TEXT_GUILD_ID/TEXT_CHANNEL_ID, fix WEBSERVER_PORT default (3001), remove default admin password
- Move mascot_chat_messages table to Drizzle schema with proper migration
- Remove runtime DDL (CREATE TABLE IF NOT EXISTS) from mascot-chat repository
- Remove phantom analytics/ module from documentation
- Add better-sqlite3 dependency to root devDependencies
- Replace 'as any' casts with proper type assertions across AI moderation
- Add error logging to silent catch blocks in LLM client
- Apply Biome formatting and import organization

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

services/discord-gateway/src/modules/ai-moderation/aiAnalyzer.ts

@@ -413,7 +413,7 @@ async function processIndividualFallback(
       type: "individual",
       message,
       skipNormalAnalysis: false,
-    } as any)) as
+    } as unknown)) as
       | { ok: true; results: AnalysisResult[] }
       | { ok: false; results: AnalysisResult[]; error: string };
 
@@ -443,7 +443,7 @@ async function processIndividualFallback(
         type: "individual",
         message,
         skipNormalAnalysis: true,
-      } as any)) as
+      } as unknown)) as
         | { ok: true; results: AnalysisResult[] }
         | { ok: false; results: AnalysisResult[]; error: string };
 

services/discord-gateway/src/modules/ai-moderation/autoDeleteManager.ts

@@ -4,6 +4,10 @@ import { config } from "../../shared/config/config.js";
 import { createModerationAction } from "../message-capture/messageStore.js";
 import type { MessageRecord } from "../message-capture/types.js";
 
+interface ChannelWithSend {
+  send: (content: string | object, options?: unknown) => Promise<unknown>;
+}
+
 const logger = createChildLogger("auto-delete-manager");
 
 const parseStringList = (value?: string | null): string[] => {
@@ -353,7 +357,7 @@ export async function attemptAutoDeleteFlaggedMessage(
         if (
           logChannel &&
           "send" in logChannel &&
-          typeof (logChannel as any).send === "function"
+          typeof (logChannel as ChannelWithSend).send === "function"
         ) {
           const severity = message.ai_severity ?? "none";
           const categories =
@@ -362,7 +366,7 @@ export async function attemptAutoDeleteFlaggedMessage(
             0,
             200,
           );
-          await (logChannel as any).send(
+          await (logChannel as ChannelWithSend).send(
             `**🧹 Auto-Delete** — Pesan dari <@${message.user_id}> di <#${channelId}>\n` +
               `**Status:** ${message.ai_status}\n` +
               `**Severitas:** ${severity}\n` +

services/discord-gateway/src/modules/ai-moderation/llmClient.ts

@@ -14,6 +14,24 @@ import { withLlmConcurrency } from "./concurrencyLimiter.js";
 
 const log = createChildLogger("llm-client");
 
+/**
+ * Covers all LLM response chunk shapes the streaming handler supports.
+ * Different providers (OpenAI, Anthropic-compatible, local LLMs) may return
+ * content in different fields — we try them all via optional chaining.
+ */
+type LLMResponseChunk = {
+  choices?: Array<{
+    delta?: { content?: string | null };
+    message?: { content?: string | null };
+    finish_reason?: string | null;
+    text?: string;
+  }>;
+  message?: { content?: string | null };
+  content?: string;
+  response?: string;
+  finish_reason?: string;
+};
+
 // ---------------------------------------------------------------------------
 // Lazy singleton — created on first use so that config is always resolved.
 // ---------------------------------------------------------------------------
@@ -112,7 +130,7 @@ export async function llmChat(
           if (currentParams.stream) {
             let content = "";
             let finishReason = "stop";
-            for await (const chunk of response as any) {
+            for await (const chunk of response as unknown as AsyncIterable<LLMResponseChunk>) {
               const choice = chunk?.choices?.[0];
               const textChunk =
                 choice?.delta?.content ||

services/discord-gateway/src/modules/ai-moderation/llmModerationClient.ts

@@ -179,7 +179,12 @@ export function extractJson(content: string): unknown {
       if (parsed && typeof parsed === "object") {
         return parsed;
       }
-    } catch (_) {}
+    } catch (err) {
+      log.debug(
+        { err: err instanceof Error ? err.message : String(err) },
+        "Failed to parse JSON from code block — trying next block",
+      );
+    }
   }
 
   for (let start = 0; start < content.length; start++) {
@@ -224,7 +229,12 @@ export function extractJson(content: string): unknown {
             if (parsed && typeof parsed === "object") {
               return parsed;
             }
-          } catch (_) {}
+          } catch (err) {
+            log.debug(
+              { err: err instanceof Error ? err.message : String(err) },
+              "Failed to parse JSON candidate — trying next position",
+            );
+          }
           break;
         }
       }
@@ -266,7 +276,7 @@ export function parseModerationResponse(
       parsed = { results: [parsed] };
     } else {
       const arrayKey = Object.keys(parsed).find((key) => {
-        const val = (parsed as any)[key];
+        const val = parsed[key];
         return (
           Array.isArray(val) &&
           val.length > 0 &&
@@ -274,12 +284,12 @@ export function parseModerationResponse(
             (item: unknown) =>
               typeof item === "object" &&
               item !== null &&
-              "message_id" in (item as any),
+              "message_id" in (item as Record<string, unknown>),
           )
         );
       });
       if (arrayKey) {
-        parsed.results = (parsed as any)[arrayKey];
+        parsed.results = parsed[arrayKey];
       } else {
         parsed = { results: [parsed] };
       }

services/discord-gateway/src/modules/ai-moderation/textCacheStore.ts

@@ -100,7 +100,7 @@ export async function pruneExpiredTexts(): Promise<number> {
       `DELETE FROM text_analysis_cache WHERE expires_at < $1`,
       [Date.now()],
     );
-    return (result as any).rowCount ?? 0;
+    return (result as unknown as { rowCount?: number }).rowCount ?? 0;
   } catch (error) {
     logger.error(
       { error: error instanceof Error ? error.message : String(error) },

services/discord-gateway/src/modules/message-capture/types.ts

@@ -1,42 +1,42 @@
 import type fs from "node:fs";
-import type prism from "prism-media";
 import type {
-  AIStatus,
-  AISeverity,
   AIRecommendedAction,
+  AISeverity,
+  AIStatus,
+  AnalysisQueueStatus,
+  AttachmentRecord,
   BroadcasterClient,
+  MessageRecord,
   ModerationBroadcaster,
   RoleMetadata,
   UserMetadata,
-  MessageRecord,
-  AttachmentRecord,
   VoiceRecordingUploadData,
-  AnalysisQueueStatus,
 } from "@bete/shared";
+import type prism from "prism-media";
 
 // Re-export all shared types for backward compatibility
 export type {
-  AIStatus,
-  AISeverity,
   AIRecommendedAction,
-  BroadcasterClient,
-  ModerationBroadcaster,
-  RoleMetadata,
-  UserMetadata,
-  MessageRecord,
+  AISeverity,
+  AIStatus,
+  AnalysisQueueStatus,
+  AnalysisResult,
   AttachmentRecord,
-  VoiceSegmentRecord,
+  BroadcasterClient,
   DashboardMessage,
   MessageQuery,
-  PageResult,
-  AnalysisResult,
-  VoiceRecordingUploadData,
-  AnalysisQueueStatus,
+  MessageRecord,
   MessageReview,
   ModerationAction,
+  ModerationActionType,
+  ModerationBroadcaster,
+  PageResult,
   RetentionPolicy,
   ReviewStatus,
-  ModerationActionType,
+  RoleMetadata,
+  UserMetadata,
+  VoiceRecordingUploadData,
+  VoiceSegmentRecord,
 } from "@bete/shared";
 
 // Types that are LOCAL ONLY (not in shared) — keep here

services/discord-gateway/src/shared/config/config.ts

@@ -1,6 +1,9 @@
 import "dotenv/config";
 import type { AppConfig as SharedAppConfig } from "@bete/shared/config";
-import { config as sharedConfig, loadConfig as sharedLoadConfig } from "@bete/shared/config";
+import {
+  config as sharedConfig,
+  loadConfig as sharedLoadConfig,
+} from "@bete/shared/config";
 
 // Re-export the unified config with EFFECTIVE_* fields added
 export type AppConfig = SharedAppConfig & {

services/discord-gateway/src/shared/database/schema.ts

@@ -4,9 +4,12 @@ import {
   foreignKey as pgForeignKey,
   index as pgIndex,
   integer as pgInteger,
+  jsonb as pgJsonb,
   real as pgReal,
   pgTable,
   text as pgText,
+  timestamp as pgTimestamp,
+  uuid as pgUuid,
 } from "drizzle-orm/pg-core";
 
 // PostgreSQL Schema
@@ -492,6 +495,30 @@ export const pgCorrectedModerationsTable = pgTable(
   }),
 );
 
+/**
+ * Mascot Chat Messages Table (PostgreSQL)
+ * Stores AI mascot chat conversation history
+ */
+export const pgMascotChatMessagesTable = pgTable(
+  "mascot_chat_messages",
+  {
+    id: pgUuid("id").defaultRandom().primaryKey(),
+    user_id: pgText("user_id").notNull(),
+    user_message: pgText("user_message").notNull(),
+    mascot_response: pgText("mascot_response").notNull(),
+    context: pgJsonb("context").notNull().default("{}"),
+    created_at: pgTimestamp("created_at", { withTimezone: true, mode: "date" })
+      .notNull()
+      .defaultNow(),
+  },
+  (table) => ({
+    userCreatedIdx: pgIndex("idx_mascot_chat_messages_user_created").on(
+      table.user_id,
+      table.created_at.desc(),
+    ),
+  }),
+);
+
 // Runtime table exports
 // =====================
 
@@ -509,6 +536,7 @@ export const stickerCacheTable = pgStickerCacheTable;
 export const correctedModerationsTable = pgCorrectedModerationsTable;
 export const userReputationsTable = pgUserReputationsTable;
 export const channelCulturesTable = pgChannelCulturesTable;
+export const mascotChatMessagesTable = pgMascotChatMessagesTable;
 
 // Export table types for use in queries
 export type MuxerJob = typeof muxerJobsTable.$inferSelect;
@@ -550,3 +578,7 @@ export type UserReputationInsert = typeof userReputationsTable.$inferInsert;
 
 export type ChannelCulture = typeof channelCulturesTable.$inferSelect;
 export type ChannelCultureInsert = typeof channelCulturesTable.$inferInsert;
+
+export type MascotChatMessage = typeof mascotChatMessagesTable.$inferSelect;
+export type MascotChatMessageInsert =
+  typeof mascotChatMessagesTable.$inferInsert;