feat(automation): implement NODE_ENV-based automation mode with fixture server

tests/unit/infrastructure/AutomationConfig.test.ts

@@ -1,5 +1,5 @@
-import { describe, it, expect, beforeEach, afterEach } from 'vitest';
-import { loadAutomationConfig, AutomationMode } from '../../../packages/infrastructure/config/AutomationConfig';
+import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
+import { loadAutomationConfig, getAutomationMode, AutomationMode } from '../../../packages/infrastructure/config/AutomationConfig';
 
 describe('AutomationConfig', () => {
   const originalEnv = process.env;
@@ -14,14 +14,114 @@ describe('AutomationConfig', () => {
     process.env = originalEnv;
   });
 
+  describe('getAutomationMode', () => {
+    describe('NODE_ENV-based mode detection', () => {
+      it('should return development mode when NODE_ENV=development', () => {
+        process.env.NODE_ENV = 'development';
+        delete process.env.AUTOMATION_MODE;
+        
+        const mode = getAutomationMode();
+        
+        expect(mode).toBe('development');
+      });
+
+      it('should return production mode when NODE_ENV=production', () => {
+        process.env.NODE_ENV = 'production';
+        delete process.env.AUTOMATION_MODE;
+        
+        const mode = getAutomationMode();
+        
+        expect(mode).toBe('production');
+      });
+
+      it('should return test mode when NODE_ENV=test', () => {
+        process.env.NODE_ENV = 'test';
+        delete process.env.AUTOMATION_MODE;
+        
+        const mode = getAutomationMode();
+        
+        expect(mode).toBe('test');
+      });
+
+      it('should return development mode when NODE_ENV is not set', () => {
+        delete process.env.NODE_ENV;
+        delete process.env.AUTOMATION_MODE;
+        
+        const mode = getAutomationMode();
+        
+        expect(mode).toBe('development');
+      });
+
+      it('should return development mode for unknown NODE_ENV values', () => {
+        process.env.NODE_ENV = 'staging';
+        delete process.env.AUTOMATION_MODE;
+        
+        const mode = getAutomationMode();
+        
+        expect(mode).toBe('development');
+      });
+    });
+
+    describe('legacy AUTOMATION_MODE support', () => {
+      it('should map legacy dev mode to development with deprecation warning', () => {
+        process.env.AUTOMATION_MODE = 'dev';
+        const consoleSpy = vi.spyOn(console, 'warn').mockImplementation(() => {});
+        
+        const mode = getAutomationMode();
+        
+        expect(mode).toBe('development');
+        expect(consoleSpy).toHaveBeenCalledWith(
+          expect.stringContaining('[DEPRECATED] AUTOMATION_MODE')
+        );
+        consoleSpy.mockRestore();
+      });
+
+      it('should map legacy mock mode to test with deprecation warning', () => {
+        process.env.AUTOMATION_MODE = 'mock';
+        const consoleSpy = vi.spyOn(console, 'warn').mockImplementation(() => {});
+        
+        const mode = getAutomationMode();
+        
+        expect(mode).toBe('test');
+        expect(consoleSpy).toHaveBeenCalledWith(
+          expect.stringContaining('[DEPRECATED] AUTOMATION_MODE')
+        );
+        consoleSpy.mockRestore();
+      });
+
+      it('should map legacy production mode to production with deprecation warning', () => {
+        process.env.AUTOMATION_MODE = 'production';
+        const consoleSpy = vi.spyOn(console, 'warn').mockImplementation(() => {});
+        
+        const mode = getAutomationMode();
+        
+        expect(mode).toBe('production');
+        expect(consoleSpy).toHaveBeenCalledWith(
+          expect.stringContaining('[DEPRECATED] AUTOMATION_MODE')
+        );
+        consoleSpy.mockRestore();
+      });
+
+      it('should ignore invalid AUTOMATION_MODE and use NODE_ENV', () => {
+        process.env.AUTOMATION_MODE = 'invalid-mode';
+        process.env.NODE_ENV = 'production';
+        
+        const mode = getAutomationMode();
+        
+        expect(mode).toBe('production');
+      });
+    });
+  });
+
   describe('loadAutomationConfig', () => {
     describe('default configuration', () => {
-      it('should return mock mode when AUTOMATION_MODE is not set', () => {
+      it('should return development mode when NODE_ENV is not set', () => {
+        delete process.env.NODE_ENV;
         delete process.env.AUTOMATION_MODE;
         
         const config = loadAutomationConfig();
         
-        expect(config.mode).toBe('mock');
+        expect(config.mode).toBe('development');
       });
 
       it('should return default devTools configuration', () => {
@@ -46,15 +146,27 @@ describe('AutomationConfig', () => {
         expect(config.retryAttempts).toBe(3);
         expect(config.screenshotOnError).toBe(true);
       });
-    });
 
-    describe('dev mode configuration', () => {
-      it('should return dev mode when AUTOMATION_MODE=dev', () => {
-        process.env.AUTOMATION_MODE = 'dev';
+      it('should return default fixture server configuration', () => {
+        delete process.env.NODE_ENV;
+        delete process.env.AUTOMATION_MODE;
         
         const config = loadAutomationConfig();
         
-        expect(config.mode).toBe('dev');
+        expect(config.fixtureServer?.port).toBe(3456);
+        expect(config.fixtureServer?.autoStart).toBe(true);
+        expect(config.fixtureServer?.fixturesPath).toBe('./resources/iracing-hosted-sessions');
+      });
+    });
+
+    describe('development mode configuration', () => {
+      it('should return development mode when NODE_ENV=development', () => {
+        process.env.NODE_ENV = 'development';
+        delete process.env.AUTOMATION_MODE;
+        
+        const config = loadAutomationConfig();
+        
+        expect(config.mode).toBe('development');
       });
 
       it('should parse CHROME_DEBUG_PORT', () => {
@@ -75,8 +187,9 @@ describe('AutomationConfig', () => {
     });
 
     describe('production mode configuration', () => {
-      it('should return production mode when AUTOMATION_MODE=production', () => {
-        process.env.AUTOMATION_MODE = 'production';
+      it('should return production mode when NODE_ENV=production', () => {
+        process.env.NODE_ENV = 'production';
+        delete process.env.AUTOMATION_MODE;
         
         const config = loadAutomationConfig();
         
@@ -161,28 +274,87 @@ describe('AutomationConfig', () => {
         expect(config.nutJs?.confidence).toBe(0.9);
       });
 
-      it('should fallback to mock mode for invalid AUTOMATION_MODE', () => {
-        process.env.AUTOMATION_MODE = 'invalid-mode';
+      it('should fallback to development mode for invalid NODE_ENV', () => {
+        process.env.NODE_ENV = 'invalid-env';
+        delete process.env.AUTOMATION_MODE;
         
         const config = loadAutomationConfig();
         
-        expect(config.mode).toBe('mock');
+        expect(config.mode).toBe('development');
+      });
+    });
+
+    describe('fixture server configuration', () => {
+      it('should auto-start fixture server in development mode', () => {
+        process.env.NODE_ENV = 'development';
+        delete process.env.AUTOMATION_MODE;
+        
+        const config = loadAutomationConfig();
+        
+        expect(config.fixtureServer?.autoStart).toBe(true);
+      });
+
+      it('should not auto-start fixture server in production mode', () => {
+        process.env.NODE_ENV = 'production';
+        delete process.env.AUTOMATION_MODE;
+        
+        const config = loadAutomationConfig();
+        
+        expect(config.fixtureServer?.autoStart).toBe(false);
+      });
+
+      it('should not auto-start fixture server in test mode', () => {
+        process.env.NODE_ENV = 'test';
+        delete process.env.AUTOMATION_MODE;
+        
+        const config = loadAutomationConfig();
+        
+        expect(config.fixtureServer?.autoStart).toBe(false);
+      });
+
+      it('should parse FIXTURE_SERVER_PORT', () => {
+        process.env.FIXTURE_SERVER_PORT = '4567';
+        
+        const config = loadAutomationConfig();
+        
+        expect(config.fixtureServer?.port).toBe(4567);
+      });
+
+      it('should parse FIXTURE_SERVER_PATH', () => {
+        process.env.FIXTURE_SERVER_PATH = '/custom/fixtures';
+        
+        const config = loadAutomationConfig();
+        
+        expect(config.fixtureServer?.fixturesPath).toBe('/custom/fixtures');
+      });
+
+      it('should respect FIXTURE_SERVER_AUTO_START=false', () => {
+        process.env.NODE_ENV = 'development';
+        process.env.FIXTURE_SERVER_AUTO_START = 'false';
+        delete process.env.AUTOMATION_MODE;
+        
+        const config = loadAutomationConfig();
+        
+        expect(config.fixtureServer?.autoStart).toBe(false);
       });
     });
 
     describe('full configuration scenario', () => {
-      it('should load complete dev environment configuration', () => {
-        process.env.AUTOMATION_MODE = 'dev';
+      it('should load complete development environment configuration', () => {
+        process.env.NODE_ENV = 'development';
+        delete process.env.AUTOMATION_MODE;
         process.env.CHROME_DEBUG_PORT = '9222';
         process.env.CHROME_WS_ENDPOINT = 'ws://localhost:9222/devtools/browser/test';
         process.env.AUTOMATION_TIMEOUT = '45000';
         process.env.RETRY_ATTEMPTS = '2';
         process.env.SCREENSHOT_ON_ERROR = 'true';
+        process.env.FIXTURE_SERVER_PORT = '3456';
+        process.env.FIXTURE_SERVER_PATH = './resources/iracing-hosted-sessions';
         
         const config = loadAutomationConfig();
         
         expect(config).toEqual({
-          mode: 'dev',
+          mode: 'development',
           devTools: {
             debuggingPort: 9222,
             browserWSEndpoint: 'ws://localhost:9222/devtools/browser/test',
@@ -194,20 +366,41 @@ describe('AutomationConfig', () => {
             templatePath: './resources/templates',
             confidence: 0.9,
           },
+          fixtureServer: {
+            port: 3456,
+            autoStart: true,
+            fixturesPath: './resources/iracing-hosted-sessions',
+          },
           defaultTimeout: 45000,
           retryAttempts: 2,
           screenshotOnError: true,
         });
       });
 
-      it('should load complete mock environment configuration', () => {
-        process.env.AUTOMATION_MODE = 'mock';
+      it('should load complete test environment configuration', () => {
+        process.env.NODE_ENV = 'test';
+        delete process.env.AUTOMATION_MODE;
         
         const config = loadAutomationConfig();
         
-        expect(config.mode).toBe('mock');
+        expect(config.mode).toBe('test');
         expect(config.devTools).toBeDefined();
         expect(config.nutJs).toBeDefined();
+        expect(config.fixtureServer).toBeDefined();
+        expect(config.fixtureServer?.autoStart).toBe(false);
+      });
+
+      it('should load complete production environment configuration', () => {
+        process.env.NODE_ENV = 'production';
+        delete process.env.AUTOMATION_MODE;
+        
+        const config = loadAutomationConfig();
+        
+        expect(config.mode).toBe('production');
+        expect(config.devTools).toBeDefined();
+        expect(config.nutJs).toBeDefined();
+        expect(config.fixtureServer).toBeDefined();
+        expect(config.fixtureServer?.autoStart).toBe(false);
       });
     });
   });