SB-0MN77JYZ513EIHHI: Extract LifecycleManager module from src/index.ts

- Create LifecycleManager class with comprehensive startup/shutdown lifecycle management
- Move startup notifications, recovery, and status restoration into dedicated module
- Implement graceful shutdown handling with SIGTERM/SIGINT signal handlers
- Add status message cleanup and lost item recovery on shutdown
- Add STARTUP_NOTIFICATION_CHANNEL_ID config option to bot.ts
- Replace inline startup/shutdown logic in index.ts with LifecycleManager integration
- Create comprehensive unit tests (30 test cases) for LifecycleManager
- Maintain backward compatibility through legacy exports

All 162 tests passing.

Author: Sorra

src/config/bot.ts

@@ -42,6 +42,9 @@ export const botConfigSchema = z.object({
 
   // File URL configuration
   ALLOWED_FILE_URL_USERS: z.string().optional().transform(v => v ? v.split(',').map(id => id.trim()) : []),
+  
+  // Lifecycle configuration
+  STARTUP_NOTIFICATION_CHANNEL_ID: z.string().optional(),
 });
 
 const parsed = botConfigSchema.safeParse(process.env);

src/index.ts

@@ -9,8 +9,7 @@ import { postCliErrorReport } from "./discord/cli-error-report.js";
 import { CrawlCommandHandler } from "./handlers/CrawlCommandHandler.js";
 import { StatsCommandHandler } from "./handlers/StatsCommandHandler.js";
 import { RecentCommandHandler } from "./handlers/RecentCommandHandler.js";
-import { startBot } from "./lifecycle/startup.js";
-import { createShutdownController } from "./lifecycle/shutdown.js";
+import { LifecycleManager } from "./lifecycle/LifecycleManager.js";
 import {
   formatMissingCrawlSeedMessage,
   formatQueueFailureMessage,
@@ -2139,8 +2138,50 @@ const bot = new DiscordBot({
 // Startup and Shutdown
 // ============================================================================
 
-createShutdownController(logger);
-void startBot(() => bot.start(), logger);
+// Create lifecycle manager for comprehensive startup/shutdown management
+const lifecycleManager = new LifecycleManager({
+  logger,
+  client: bot.client,
+  startupNotification: config.STARTUP_NOTIFICATION_CHANNEL_ID
+    ? {
+        channelId: config.STARTUP_NOTIFICATION_CHANNEL_ID,
+        includeTimestamp: true,
+      }
+    : undefined,
+  shutdownConfig: {
+    timeoutMs: 30000,
+    cleanupStatusMessages: true,
+    performLostItemRecovery: true,
+  },
+  eventListeners: {
+    onStartupBegin: () => {
+      logger.info("Bot startup sequence beginning");
+    },
+    onStartupComplete: () => {
+      logger.info("Bot startup sequence completed");
+    },
+    onShutdownBegin: (signal: string) => {
+      logger.info(`Bot shutdown initiated by ${signal}`);
+    },
+    onShutdownComplete: () => {
+      logger.info("Bot shutdown sequence completed");
+    },
+  },
+});
+
+// Start the bot with lifecycle management
+void (async () => {
+  try {
+    await bot.start();
+    await lifecycleManager.performStartup();
+  } catch (error) {
+    logger.error("Failed to start bot", {
+      error: error instanceof Error ? error.message : String(error),
+    });
+    process.exit(1);
+  }
+})();
 
 // Export internals for testing
 export { processUrlWithProgress };
+export { lifecycleManager };