feat(gateway): stream release progress logs

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

@@ -46,6 +46,16 @@ const buildCaller = async (
     const session = await sessions.createSession({ ...admin, roles: adminRoles });
     const createdInputs: GatewayOperationCreateInput[] = [];
     const createdReleaseInputs: GatewayReleaseOperationCreateInput[] = [];
+    const releaseLogs = [
+        {
+            cursor: '1',
+            operationId: '44444444-4444-4444-8444-444444444444',
+            level: 'INFO' as const,
+            phase: 'build',
+            message: 'Gateway 구성 요소를 빌드합니다.',
+            createdAt: '2026-08-01T00:00:01.000Z',
+        },
+    ];
     const operationRecords = new Map<string, Awaited<ReturnType<GatewayProfileRepository['createOperation']>>>();
     const createdRuntimeActions: Array<Record<string, unknown>> = [];
     const flushes: Array<{ userId: string; reason?: string; iconRevision?: string }> = [];
@@ -113,7 +123,27 @@ const buildCaller = async (
             updatedAt: '2026-08-01T00:00:00.000Z',
         }),
         listOperations: async () => [],
-        getOperation: async () => null,
+        getOperation: async (id) =>
+            id === '44444444-4444-4444-8444-444444444444'
+                ? {
+                      id,
+                      type: 'DEPLOY',
+                      status: 'RUNNING',
+                      payload: {},
+                      requestedBy: admin.id,
+                      attempts: 1,
+                      createdAt: '2026-08-01T00:00:00.000Z',
+                      updatedAt: '2026-08-01T00:00:00.000Z',
+                  }
+                : null,
+        listOperationLogs: async (_id, afterCursor) =>
+            releaseLogs.filter((entry) => !afterCursor || BigInt(entry.cursor) > BigInt(afterCursor)),
+        appendOperationLog: async (_id, input) => ({
+            cursor: '2',
+            operationId: '44444444-4444-4444-8444-444444444444',
+            createdAt: '2026-08-01T00:00:02.000Z',
+            ...input,
+        }),
         createOperation: async (input) => {
             createdReleaseInputs.push(input);
             return {
@@ -517,6 +547,23 @@ describe('admin operation API', () => {
 });
 
 describe('gateway release API', () => {
+    it('long-polls ordered release logs with the current operation state', async () => {
+        const harness = await buildCaller(async () => {
+            throw new Error('not used');
+        });
+
+        await expect(
+            harness.caller.admin.releases.logs({
+                id: '44444444-4444-4444-8444-444444444444',
+                timeoutMs: 0,
+            })
+        ).resolves.toMatchObject({
+            nextCursor: '1',
+            operation: { status: 'RUNNING' },
+            entries: [{ cursor: '1', phase: 'build', message: 'Gateway 구성 요소를 빌드합니다.' }],
+        });
+    });
+
     it('queues a gateway deployment for the external release controller', async () => {
         const harness = await buildCaller(async () => {
             throw new Error('not used');

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

@@ -40,4 +40,30 @@ describe('PnpmBuildRunner', () => {
         expect(result.output.length).toBe(MAX_BUILD_OUTPUT_CHARS);
         expect(result.output.endsWith('tail-marker')).toBe(true);
     });
+
+    it('streams command boundaries and line-buffered output to an observer', async () => {
+        const runner = new PnpmBuildRunner();
+        const events: Array<{ type: string; message?: string }> = [];
+
+        const result = await runner.run(
+            [
+                {
+                    command: process.execPath,
+                    args: ['-e', "process.stdout.write('first\\npartial');"],
+                    cwd: process.cwd(),
+                },
+            ],
+            async (event) => {
+                events.push({ type: event.type, ...('message' in event ? { message: event.message } : {}) });
+            }
+        );
+
+        expect(result.ok).toBe(true);
+        expect(events).toEqual([
+            { type: 'COMMAND_START' },
+            { type: 'OUTPUT', message: 'first' },
+            { type: 'OUTPUT', message: 'partial' },
+            { type: 'COMMAND_END' },
+        ]);
+    });
 });

app/gateway-api/test/gatewayReleaseRepository.integration.test.ts

@@ -50,6 +50,17 @@ describeDatabase('gateway release operation persistence', () => {
         await expect(repository.pinOperationResolvedCommit(operation.id, 'controller-a', 'a'.repeat(40))).resolves.toBe(
             true
         );
+        const firstLog = await repository.appendOperationLog(operation.id, {
+            level: 'INFO',
+            phase: 'build',
+            message: 'build started',
+        });
+        const secondLog = await repository.appendOperationLog(operation.id, {
+            level: 'OUTPUT',
+            phase: 'build',
+            message: 'gateway-api build complete',
+        });
+        await expect(repository.listOperationLogs(operation.id, firstLog.cursor)).resolves.toEqual([secondLog]);
         await expect(
             repository.publishRelease(operation.id, 'stale-controller', {
                 commitSha: 'a'.repeat(40),