feat: AI conversations viewer with search and replay

migrations/012_flagged_messages.cjs

@@ -0,0 +1,42 @@
+/**
+ * Migration 012 — Flagged Messages
+ * Creates the flagged_messages table for tracking problematic AI responses
+ * within conversation threads.
+ *
+ * @see https://github.com/VolvoxLLC/volvox-bot/issues/34
+ */
+
+'use strict';
+
+/**
+ * @param {import('pg').Pool} pool
+ */
+async function up(pool) {
+  await pool.query(`
+    CREATE TABLE IF NOT EXISTS flagged_messages (
+      id SERIAL PRIMARY KEY,
+      guild_id TEXT NOT NULL,
+      conversation_first_id INTEGER NOT NULL,
+      message_id INTEGER NOT NULL REFERENCES conversations(id),
+      flagged_by TEXT NOT NULL,
+      reason TEXT NOT NULL,
+      notes TEXT,
+      status TEXT DEFAULT 'open' CHECK (status IN ('open', 'resolved', 'dismissed')),
+      resolved_by TEXT,
+      resolved_at TIMESTAMPTZ,
+      created_at TIMESTAMPTZ DEFAULT NOW()
+    );
+  `);
+
+  await pool.query(`
+    CREATE INDEX IF NOT EXISTS idx_flagged_messages_guild
+      ON flagged_messages(guild_id);
+  `);
+
+  await pool.query(`
+    CREATE INDEX IF NOT EXISTS idx_flagged_messages_status
+      ON flagged_messages(guild_id, status);
+  `);
+}
+
+module.exports = { up };

src/api/index.js

@@ -11,6 +11,7 @@
 import healthRouter from './routes/health.js';
 import membersRouter from './routes/members.js';
 import moderationRouter from './routes/moderation.js';
+import conversationsRouter from './routes/conversations.js';
 import webhooksRouter from './routes/webhooks.js';
 
 const router = Router();
@@ -28,6 +29,10 @@
 // (mounted before guilds to handle /:id/members/* before the basic guilds endpoint)
 router.use('/guilds', requireAuth(), membersRouter);
 
+// Conversation routes — require API secret or OAuth2 JWT
+// (mounted before guilds to handle /:id/conversations/* before the catch-all guild endpoint)
+router.use('/guilds/:id/conversations', requireAuth(), conversationsRouter);
+
 // Guild routes — require API secret or OAuth2 JWT
 router.use('/guilds', requireAuth(), guildsRouter);