merge: 최신 main을 커맨드 입력값 보존 브랜치에 통합

app/gateway-api/src/orchestrator/gatewayOrchestrator.ts

@@ -512,13 +512,15 @@ const sanitizeArtifactName = (value: string): string => value.replace(/[^0-9A-Za
 const buildProfileFrontendOutDir = (workspaceRoot: string, profileName: string): string =>
     path.join(workspaceRoot, '.release-dist', sanitizeArtifactName(profileName), 'game-frontend');
 
-const buildProfileFrontendCommands = (
+export const buildProfileFrontendCommands = (
     workspaceRoot: string,
     profile: Pick<GatewayProfileRecord, 'profileName' | 'profile' | 'apiPort'>,
     env?: Record<string, string>
 ): BuildCommand[] => {
+    const profileFrontendBuildNodeOptions = env?.PROFILE_FRONTEND_BUILD_NODE_OPTIONS?.trim();
     const buildEnv = {
         ...(env ?? {}),
+        ...(profileFrontendBuildNodeOptions ? { NODE_OPTIONS: profileFrontendBuildNodeOptions } : {}),
         VITE_APP_BASE_PATH: `/${profile.profile}`,
         VITE_GAME_API_URL: `/${profile.profile}/api/trpc`,
         VITE_GAME_SSE_URL: `/${profile.profile}/api/events`,

app/gateway-api/test/orchestratorPlan.test.ts

@@ -3,6 +3,7 @@ import { describe, expect, it } from 'vitest';
 import path from 'node:path';
 
 import {
+    buildProfileFrontendCommands,
     buildProfileMigrationCommand,
     buildProcessDefinitions,
     buildWorkspaceCommands,
@@ -330,3 +331,30 @@ describe('buildWorkspaceCommands', () => {
         });
     });
 });
+
+describe('buildProfileFrontendCommands', () => {
+    it('uses a profile frontend build-only Node heap without changing the shared runtime heap', () => {
+        const workspaceRoot = '/srv/sammo/worktrees/0123456789abcdef';
+        const commands = buildProfileFrontendCommands(workspaceRoot, buildProfile(), {
+            NODE_OPTIONS: '--max-old-space-size=1536',
+            PROFILE_FRONTEND_BUILD_NODE_OPTIONS: '--max-old-space-size=2048',
+        });
+
+        expect(commands).toHaveLength(2);
+        expect(commands.every((command) => command.env?.NODE_OPTIONS === '--max-old-space-size=2048')).toBe(true);
+        expect(
+            commands.every(
+                (command) => command.env?.PROFILE_FRONTEND_BUILD_NODE_OPTIONS === '--max-old-space-size=2048'
+            )
+        ).toBe(true);
+    });
+
+    it('keeps the shared Node heap when no frontend build override is configured', () => {
+        const workspaceRoot = '/srv/sammo/worktrees/0123456789abcdef';
+        const commands = buildProfileFrontendCommands(workspaceRoot, buildProfile(), {
+            NODE_OPTIONS: '--max-old-space-size=1536',
+        });
+
+        expect(commands.every((command) => command.env?.NODE_OPTIONS === '--max-old-space-size=1536')).toBe(true);
+    });
+});