feat: add management server command and prometheus metrics support

Author: Slashmsu

DEPLOYMENT.md

@@ -1,5 +1,5 @@
 {
-  "timestamp": "2025-10-08T20:22:54.660Z",
+  "timestamp": "2025-10-11T16:56:56.846Z",
   "total": 34,
   "working": 34,
   "partial": 0,

TODO.md

@@ -838,6 +838,22 @@ export function createProgram(): Command {
       }
     });
 
+  // Serve command for management server
+  program
+    .command('serve')
+    .description('Start the management server for health checks and metrics')
+    .option('-p, --port <port>', 'Port to listen on', '8080')
+    .option('-c, --config <file>', 'Path to configuration file')
+    .option('--production', 'Enable production mode with all safety features')
+    .option('--json', 'Use structured JSON logging')
+    .action(async _options => {
+      const { createServeCommand } = await import('./serve');
+      const serveCommand = createServeCommand();
+      await serveCommand.parseAsync([process.argv[0], process.argv[1], ...process.argv.slice(3)], {
+        from: 'user',
+      });
+    });
+
   return program;
 }
 

example-audit-report.json

@@ -0,0 +1,101 @@
+#!/usr/bin/env node
+/**
+ * CLI command to start the management server for health checks and metrics
+ */
+import { Command } from 'commander';
+import { ModuleSystem } from '../module-system';
+import { loadConfig } from '../config';
+import { StructuredLoggerFactory } from '../module-system/structured-logger';
+import * as path from 'path';
+import * as fs from 'fs';
+
+const logger = StructuredLoggerFactory.getLogger('serve-command');
+
+export function createServeCommand(): Command {
+  const cmd = new Command('serve');
+
+  cmd
+    .description('Start the management server for health checks and metrics')
+    .option('-p, --port <port>', 'Port to listen on', '8080')
+    .option('-c, --config <file>', 'Path to configuration file')
+    .option('--production', 'Enable production mode with all safety features')
+    .option('--json', 'Use structured JSON logging')
+    .action(async options => {
+      try {
+        // Load configuration
+        const config = options.config
+          ? JSON.parse(fs.readFileSync(path.resolve(options.config), 'utf8'))
+          : loadConfig(process.cwd());
+
+        const port = parseInt(options.port, 10);
+        const isProduction = options.production || process.env.NODE_ENV === 'production';
+
+        // Configure structured logging if requested
+        if (options.json) {
+          StructuredLoggerFactory.configure({ format: 'json' });
+        }
+
+        logger.info('Starting management server', {
+          port,
+          production: isProduction,
+          jsonLogging: options.json,
+        });
+
+        // Create module system with production features
+        const moduleSystem = new ModuleSystem({
+          resolution: {
+            baseUrl: process.cwd(),
+            ...config.moduleSystem?.resolution,
+          },
+          metrics: true,
+          circuitBreakers: true,
+          logger: true,
+          managementServer: true,
+          managementPort: port,
+          resourceLimits: {
+            maxMemoryBytes: 1024 * 1024 * 1024, // 1GB
+            maxFileHandles: 1000,
+            maxCachedModules: 10000,
+            ...config.moduleSystem?.resourceLimits,
+          },
+        });
+
+        // Start the management server
+        const actualPort = await moduleSystem.startManagementServer(port);
+
+        if (actualPort) {
+          logger.info(`Management server started successfully`, {
+            port: actualPort,
+            endpoints: {
+              health: `http://localhost:${actualPort}/health`,
+              ready: `http://localhost:${actualPort}/health/ready`,
+              metrics: `http://localhost:${actualPort}/metrics`,
+              prometheus: `http://localhost:${actualPort}/metrics/prometheus`,
+            },
+          });
+
+          // Handle graceful shutdown
+          const shutdown = async () => {
+            logger.info('Shutting down management server...');
+            await moduleSystem.shutdown();
+            process.exit(0);
+          };
+
+          process.on('SIGTERM', shutdown);
+          process.on('SIGINT', shutdown);
+          process.on('SIGHUP', shutdown);
+
+          // Keep the process alive
+          process.stdin.resume();
+        } else {
+          logger.error('Failed to start management server');
+          process.exit(1);
+        }
+      } catch (error) {
+        logger.error('Error starting management server', error as Error);
+        process.exit(1);
+      }
+    });
+
+  return cmd;
+}

src/cli/program.ts

@@ -74,7 +74,7 @@ export class ModuleLoader {
       circularDependencyStrategy: options.circularDependencyStrategy || 'warn',
       externals: options.externals ?? [],
       maxCacheSize: options.maxCacheSize ?? 1000, // Default 1000 modules
-      maxCacheMemory: options.maxCacheMemory ?? 100 * 1024 * 1024, // Default 100MB
+      maxCacheMemory: options.maxCacheMemory ?? 512 * 1024 * 1024, // Default 512MB
     };
 
     // Initialize production systems only when explicitly provided