diff --git a/tools/integration-tests/scripts/live-ten-user-lifecycle.ts b/tools/integration-tests/scripts/live-ten-user-lifecycle.ts
new file mode 100644
index 00000000..462ab873
--- /dev/null
+++ b/tools/integration-tests/scripts/live-ten-user-lifecycle.ts
@@ -0,0 +1,1127 @@
+///
+
+import { constants, publicEncrypt, randomUUID } from 'node:crypto';
+import { appendFile, mkdir, readFile, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+
+import { chromium, type BrowserContext, type Page } from '@playwright/test';
+import { createTRPCProxyClient, httpBatchLink } from '@trpc/client';
+import type { AppRouter as GatewayAppRouter } from '@sammo-ts/gateway-api';
+import type { AppRouter as GameAppRouter } from '@sammo-ts/game-api';
+import { createGamePostgresConnector, createRedisConnector } from '@sammo-ts/infra';
+import { createTurnDaemonRuntime } from '../../../app/game-engine/src/turn/turnDaemon.js';
+
+const gatewayUrl = process.env.SAMMO_LIVE_GATEWAY_URL ?? 'http://caddy/gateway/api/trpc';
+const webOrigin = process.env.SAMMO_LIVE_WEB_ORIGIN ?? 'http://caddy';
+const profileName = process.env.SAMMO_LIVE_PROFILE ?? 'hwe:default';
+const sourceRef = process.env.SAMMO_LIVE_SOURCE_REF ?? 'test/game-clock-reconciliation-20260903';
+const artifactDir = path.resolve(
+ process.env.SAMMO_LIVE_ARTIFACT_DIR ??
+ path.resolve(import.meta.dirname, '../../../test-results/live-ten-user-lifecycle-20260903')
+);
+const statePath = path.join(artifactDir, 'state.json');
+
+type State = {
+ runId: string;
+ requestedAt: string;
+ preopenAt: string;
+ openAt: string;
+ resetOperationId: string;
+ users?: Array<{
+ username: string;
+ displayName: string;
+ gatewayToken: string;
+ gameToken: string;
+ generalName: string;
+ }>;
+ preopenMessages?: Array<{ index: number; text: string; wallSentAt: string; wallObservedAt: string }>;
+ verifiedPreopenMessages?: Array<{ index: number; text: string; wallSentAt: string; wallObservedAt: string }>;
+ pausedBettingId?: number;
+};
+
+const log = (event: string, detail: Record = {}): void => {
+ process.stdout.write(`${JSON.stringify({ at: new Date().toISOString(), event, ...detail })}\n`);
+};
+
+const requiredEnv = (name: string): string => {
+ const value = process.env[name]?.trim();
+ if (!value) throw new Error(`${name} is required`);
+ return value;
+};
+
+const createGateway = (session: { token?: string }) =>
+ createTRPCProxyClient({
+ links: [
+ httpBatchLink({
+ url: gatewayUrl,
+ headers: () => (session.token ? { 'x-session-token': session.token } : {}),
+ }),
+ ],
+ });
+
+const createGame = (token?: string) =>
+ createTRPCProxyClient({
+ links: [
+ httpBatchLink({
+ url: `${webOrigin}/hwe/api/trpc`,
+ headers: token ? { authorization: `Bearer ${token}` } : {},
+ }),
+ ],
+ });
+
+const loginAdminWithToken = async () => {
+ const session: { token?: string } = {};
+ const gateway = createGateway(session);
+ const passwordKey = await gateway.auth.passwordKey.query();
+ const credential = {
+ keyId: passwordKey.keyId,
+ ciphertext: publicEncrypt(
+ {
+ key: passwordKey.publicKeyPem,
+ padding: constants.RSA_PKCS1_OAEP_PADDING,
+ oaepHash: 'sha256',
+ },
+ Buffer.from(requiredEnv('INITIAL_ADMIN_PASSWORD'), 'utf8')
+ ).toString('base64'),
+ };
+ const result = await gateway.auth.login.mutate({
+ username: requiredEnv('INITIAL_ADMIN_USERNAME'),
+ credential,
+ });
+ if (result.status === 'otp') throw new Error('Admin login unexpectedly requires OTP.');
+ session.token = result.sessionToken;
+ return { gateway, sessionToken: result.sessionToken };
+};
+
+const loginAdmin = async () => (await loginAdminWithToken()).gateway;
+
+const createAdminGame = async () => {
+ const { gateway, sessionToken } = await loginAdminWithToken();
+ const issued = await gateway.auth.issueGameSession.mutate({ sessionToken, profile: profileName });
+ const exchanged = await createGame().auth.exchangeGatewayToken.mutate({ gatewayToken: issued.gameToken });
+ return createGame(exchanged.accessToken);
+};
+
+const readState = async (): Promise => JSON.parse(await readFile(statePath, 'utf8')) as State;
+const writeState = async (state: State): Promise => {
+ await writeFile(statePath, `${JSON.stringify(state, null, 2)}\n`, { mode: 0o600 });
+};
+
+const gameDatabaseUrl = (): string => {
+ const url = process.env.DATABASE_URL
+ ? new URL(process.env.DATABASE_URL)
+ : new URL(
+ `postgresql://${encodeURIComponent(process.env.POSTGRES_USER ?? 'sammo')}:${encodeURIComponent(requiredEnv('POSTGRES_PASSWORD'))}@${process.env.POSTGRES_HOST ?? 'postgres'}:${process.env.POSTGRES_PORT ?? '5432'}/${process.env.POSTGRES_DB ?? 'sammo'}`
+ );
+ url.searchParams.set('schema', profileName.split(':', 1)[0] ?? 'hwe');
+ return url.toString();
+};
+
+const redisUrl = (): string => {
+ const url = new URL('redis://redis/0');
+ url.hostname = process.env.REDIS_HOST ?? 'redis';
+ url.port = process.env.REDIS_PORT ?? '6379';
+ url.password = requiredEnv('REDIS_PASSWORD');
+ return url.toString();
+};
+
+const reset = async (): Promise => {
+ await mkdir(artifactDir, { recursive: true });
+ const gateway = await loginAdmin();
+ const requestedAt = new Date();
+ const preopenAt = new Date(requestedAt.getTime() + 30_000);
+ const openAt = new Date(requestedAt.getTime() + 15 * 60_000);
+ const operation = await gateway.admin.operations.requestReset.mutate({
+ profileName,
+ sourceMode: 'BRANCH',
+ sourceRef,
+ install: {
+ scenarioId: 2601,
+ turnTermMinutes: 1,
+ sync: true,
+ fiction: 1,
+ extend: true,
+ blockGeneralCreate: 0,
+ npcMode: 2,
+ showImgLevel: 3,
+ tournamentTrig: true,
+ joinMode: 'full',
+ autorunUser: null,
+ preopenAt: preopenAt.toISOString(),
+ openAt: openAt.toISOString(),
+ },
+ publishSchedule: false,
+ reason: 'isolated ten-user PREOPEN lifecycle integration',
+ });
+ const state: State = {
+ runId: randomUUID(),
+ requestedAt: requestedAt.toISOString(),
+ preopenAt: preopenAt.toISOString(),
+ openAt: openAt.toISOString(),
+ resetOperationId: operation.id,
+ };
+ await writeFile(statePath, `${JSON.stringify(state, null, 2)}\n`, { mode: 0o600, flag: 'wx' });
+ log('reset-requested', {
+ operationId: operation.id,
+ profileName,
+ scenarioId: 2601,
+ turnTermMinutes: 1,
+ preopenAt: state.preopenAt,
+ openAt: state.openAt,
+ });
+};
+
+const waitReset = async (): Promise => {
+ const state = await readState();
+ const gateway = await loginAdmin();
+ let cursor: string | undefined;
+ let lastHeartbeatAt = 0;
+ while (true) {
+ const result = await gateway.admin.operations.logs.query({
+ id: state.resetOperationId,
+ afterCursor: cursor,
+ limit: 200,
+ timeoutMs: 20_000,
+ });
+ cursor = result.nextCursor;
+ const notable = result.entries.filter((entry) => entry.level !== 'OUTPUT');
+ if (notable.length > 0 || Date.now() - lastHeartbeatAt >= 20_000) {
+ lastHeartbeatAt = Date.now();
+ log('reset-progress', {
+ status: result.operation.status,
+ receivedLogEntries: result.entries.length,
+ phases: notable.map((entry) => `${entry.level}:${entry.phase}`),
+ });
+ }
+ if (['SUCCEEDED', 'FAILED', 'CANCELLED'].includes(result.operation.status)) {
+ log('reset-terminal', {
+ status: result.operation.status,
+ error: result.operation.error ?? null,
+ completedAt: result.operation.completedAt ?? null,
+ });
+ if (result.operation.status !== 'SUCCEEDED') process.exitCode = 1;
+ return;
+ }
+ }
+};
+
+const status = async (): Promise => {
+ const gateway = await loginAdmin();
+ const profiles = (await gateway.admin.profiles.list.query()) as unknown as Array<
+ { profileName: string } & Record
+ >;
+ const profile = profiles.find((entry) => entry.profileName === profileName);
+ if (!profile) throw new Error(`Profile not found: ${profileName}`);
+ log('profile-status', profile);
+};
+
+const prepareUsers = async (): Promise => {
+ const state = await readState();
+ if (state.users?.length) throw new Error('Lifecycle users are already recorded.');
+ const browser = await chromium.launch({ headless: true });
+ const runSlug = state.runId.replaceAll('-', '').slice(0, 8);
+ const password = `Live-${state.runId}`;
+ const users: NonNullable = [];
+ let browserErrors = 0;
+ let applicationHttpErrors = 0;
+ try {
+ for (let index = 1; index <= 10; index += 1) {
+ const context = await browser.newContext({ viewport: { width: 1280, height: 900 } });
+ const page = await context.newPage();
+ page.setDefaultTimeout(30_000);
+ page.on('pageerror', () => {
+ browserErrors += 1;
+ });
+ page.on('response', (response) => {
+ if (response.status() >= 400 && !new URL(response.url()).pathname.startsWith('/image/')) {
+ applicationHttpErrors += 1;
+ }
+ });
+ const suffix = String(index).padStart(2, '0');
+ const username = `live${runSlug}${suffix}`;
+ const displayName = `통합사용자${suffix}`;
+ const generalName = `통합장수${suffix}`;
+ await page.goto(`${webOrigin}/gateway/signup`, { waitUntil: 'networkidle' });
+ await page.locator('#signup-username').fill(username);
+ await page.locator('#signup-password').fill(password);
+ await page.locator('#signup-confirm-password').fill(password);
+ await page.locator('#signup-display-name').fill(displayName);
+ await page.locator('#signup-form input[type="checkbox"]').nth(0).check();
+ await page.locator('#signup-form input[type="checkbox"]').nth(1).check();
+ await page.getByRole('button', { name: '가입', exact: true }).click();
+ await page.waitForURL(/\/gateway\/lobby/u);
+ const gatewayToken = await page.evaluate(() => window.localStorage.getItem('sammo-session-token'));
+ if (!gatewayToken) throw new Error(`Gateway session was not persisted for viewer ${index}.`);
+
+ const createButton = page.getByRole('button', { name: '장수생성', exact: true });
+ await createButton.waitFor({ state: 'visible' });
+ await createButton.click();
+ await page.waitForURL(/\/hwe\/join/u);
+ await page.getByLabel('장수명').fill(generalName);
+ await page.getByRole('button', { name: '능력치 초기화', exact: true }).click();
+ await page.locator('.create-form').getByRole('button', { name: '장수 생성', exact: true }).click();
+ const dialog = page.getByTestId('game-notice-dialog');
+ await dialog.waitFor({ state: 'visible' });
+ const dialogText = await dialog.innerText();
+ if (!dialogText.includes('장수를 생성했습니다')) {
+ throw new Error(`General creation failed for viewer ${index}: ${dialogText}`);
+ }
+ await dialog.getByRole('button', { name: '확인', exact: true }).click();
+ await page.waitForURL(/\/hwe\/(?:$|\?)/u);
+ const gameToken = await page.evaluate(() => window.localStorage.getItem('sammo-game-token'));
+ if (!gameToken?.startsWith('ga_')) throw new Error(`Game access token is missing for viewer ${index}.`);
+ if (index === 1) {
+ await page.screenshot({ path: path.join(artifactDir, 'preopen-user-01-main.png'), fullPage: true });
+ }
+ users.push({ username, displayName, gatewayToken, gameToken, generalName });
+ log('user-created', { index, username, displayName, generalName });
+ await context.close();
+ }
+ } finally {
+ await browser.close();
+ }
+ state.users = users;
+ await writeState(state);
+ if (!process.env.DATABASE_URL) {
+ log('users-prepared', {
+ users: users.length,
+ browserErrors,
+ applicationHttpErrors,
+ databaseSnapshot: 'deferred-to-runtime',
+ });
+ if (browserErrors || applicationHttpErrors || users.length !== 10) process.exitCode = 1;
+ return;
+ }
+ const db = createGamePostgresConnector({ url: gameDatabaseUrl() });
+ await db.connect();
+ try {
+ const [world, humanGenerals, allGenerals] = await Promise.all([
+ db.prisma.worldState.findFirstOrThrow({
+ select: {
+ scenarioCode: true,
+ currentYear: true,
+ currentMonth: true,
+ tickSeconds: true,
+ clockPhase: true,
+ clockTick: true,
+ clockWallAnchor: true,
+ },
+ }),
+ db.prisma.general.count({ where: { userId: { not: null }, npcState: 0 } }),
+ db.prisma.general.count(),
+ ]);
+ log('users-prepared', {
+ users: users.length,
+ browserErrors,
+ applicationHttpErrors,
+ humanGenerals,
+ allGenerals,
+ world: { ...world, clockTick: world.clockTick?.toString() ?? null },
+ });
+ if (browserErrors || applicationHttpErrors || users.length !== 10 || humanGenerals !== 10) process.exitCode = 1;
+ } finally {
+ await db.disconnect();
+ }
+};
+
+const openUserPages = async () => {
+ const state = await readState();
+ if (state.users?.length !== 10) throw new Error('Exactly ten lifecycle users are required.');
+ const browser = await chromium.launch({ headless: true });
+ const records: Array<{
+ index: number;
+ context: BrowserContext;
+ page: Page;
+ }> = [];
+ let browserErrors = 0;
+ let applicationHttpErrors = 0;
+ for (const [offset, user] of state.users.entries()) {
+ const index = offset + 1;
+ const context = await browser.newContext({
+ viewport: index === 10 ? { width: 390, height: 844 } : { width: 1280, height: 900 },
+ });
+ await context.addInitScript(
+ ({ gatewayToken, gameToken, profile }) => {
+ window.localStorage.setItem('sammo-session-token', gatewayToken);
+ window.localStorage.setItem('sammo-game-token', gameToken);
+ window.localStorage.setItem('sammo-game-profile', profile);
+ },
+ { gatewayToken: user.gatewayToken, gameToken: user.gameToken, profile: profileName }
+ );
+ const page = await context.newPage();
+ page.setDefaultTimeout(30_000);
+ page.on('pageerror', () => {
+ browserErrors += 1;
+ });
+ page.on('response', (response) => {
+ if (response.status() >= 400 && !new URL(response.url()).pathname.startsWith('/image/')) {
+ applicationHttpErrors += 1;
+ }
+ });
+ await page.goto(`${webOrigin}/hwe/`, { waitUntil: 'domcontentloaded' });
+ await page.locator('.MessagePanel').waitFor({ state: 'visible' });
+ records.push({ index, context, page });
+ }
+ return {
+ state,
+ browser,
+ records,
+ errors: () => ({ browserErrors, applicationHttpErrors }),
+ };
+};
+
+const preopenMessages = async (verifiedPhase = false): Promise => {
+ const opened = await openUserPages();
+ const prefix = `PREOPEN${verifiedPhase ? '-VERIFIED' : ''}-${opened.state.runId.replaceAll('-', '').slice(0, 8)}`;
+ const messages: NonNullable = [];
+ try {
+ for (const { index, page } of opened.records) {
+ const text = `${prefix}-${String(index).padStart(2, '0')}`;
+ const wallSentAt = new Date().toISOString();
+ await page.locator('.PublicTalk').getByRole('button', { name: '↩ 여기로', exact: true }).click();
+ await page.locator('.message-text').fill(text);
+ await page.getByRole('button', { name: '서신전달&갱신', exact: true }).click();
+ await page.locator('.PublicTalk').getByText(text, { exact: true }).waitFor({ state: 'visible' });
+ const wallObservedAt = new Date().toISOString();
+ messages.push({ index, text, wallSentAt, wallObservedAt });
+ log('preopen-message-sent', { index, text, wallSentAt, wallObservedAt });
+ }
+ for (const { index, page } of opened.records) {
+ await page.waitForFunction(
+ ({ selector, expected }) => {
+ const text = document.querySelector(selector)?.textContent ?? '';
+ return expected.every((entry) => text.includes(entry));
+ },
+ { selector: '.PublicTalk', expected: messages.map((message) => message.text) },
+ { timeout: 30_000 }
+ );
+ log('preopen-message-fanout', { viewer: index, observed: messages.length });
+ }
+ await opened.records[0]!.page.screenshot({
+ path: path.join(artifactDir, 'preopen-public-messages-desktop.png'),
+ fullPage: true,
+ });
+ await opened.records[9]!.page.screenshot({
+ path: path.join(artifactDir, 'preopen-public-messages-mobile.png'),
+ fullPage: true,
+ });
+ if (verifiedPhase) opened.state.verifiedPreopenMessages = messages;
+ else opened.state.preopenMessages = messages;
+ await writeState(opened.state);
+ const errors = opened.errors();
+ log('preopen-messages-complete', { sent: messages.length, fanoutChecks: 100, ...errors });
+ if (errors.browserErrors || errors.applicationHttpErrors) process.exitCode = 1;
+ } finally {
+ await Promise.all(opened.records.map(({ context }) => context.close()));
+ await opened.browser.close();
+ }
+};
+
+const repairPreopenFixture = async (): Promise => {
+ const state = await readState();
+ if (Date.now() >= new Date(state.openAt).getTime()) throw new Error('Formal opening has already passed.');
+ const db = createGamePostgresConnector({ url: gameDatabaseUrl() });
+ const redis = createRedisConnector({ url: redisUrl() });
+ await db.connect();
+ await redis.connect();
+ try {
+ const world = await db.prisma.worldState.findFirstOrThrow({ orderBy: { id: 'asc' } });
+ if (world.clockTick !== 0n || world.clockWallAnchor?.toISOString() !== state.openAt) {
+ throw new Error('Refusing PREOPEN repair because tick zero or opening anchor differs.');
+ }
+ await db.prisma.worldState.update({ where: { id: world.id }, data: { clockPhase: 'PREOPEN' } });
+ await redis.client.set(`sammo:${profileName}:clock:phase`, 'PREOPEN');
+ log('preopen-fixture-repaired', {
+ previousPhase: world.clockPhase,
+ nextPhase: 'PREOPEN',
+ clockTick: world.clockTick.toString(),
+ openAt: state.openAt,
+ reason: 'reset seeded with openAt as seed wall time and persisted RUNNING before Gateway promotion',
+ });
+ } finally {
+ await redis.disconnect();
+ await db.disconnect();
+ }
+};
+
+const databaseStatus = async (): Promise => {
+ const state = await readState();
+ const db = createGamePostgresConnector({ url: gameDatabaseUrl() });
+ await db.connect();
+ try {
+ const [
+ world,
+ humanGenerals,
+ humanGeneralDetails,
+ allGenerals,
+ nations,
+ cities,
+ messages,
+ monitorMessages,
+ betting,
+ unification,
+ suspensions,
+ ] = await Promise.all([
+ db.prisma.worldState.findFirstOrThrow({
+ select: {
+ scenarioCode: true,
+ currentYear: true,
+ currentMonth: true,
+ tickSeconds: true,
+ clockPhase: true,
+ clockTick: true,
+ lastTurnTick: true,
+ clockWallAnchor: true,
+ clockRevision: true,
+ },
+ }),
+ db.prisma.general.count({ where: { userId: { not: null }, npcState: 0 } }),
+ db.prisma.general.findMany({
+ where: { userId: { not: null }, npcState: 0 },
+ orderBy: { id: 'asc' },
+ select: { id: true, name: true, nationId: true, officerLevel: true, turnTime: true, turnTick: true },
+ }),
+ db.prisma.general.count(),
+ db.prisma.nation.count({ where: { id: { gt: 0 }, level: { gt: 0 } } }),
+ db.prisma.city.count(),
+ db.prisma.$queryRaw>`
+ SELECT id, time, time_tick AS "timeTick", message->>'text' AS text
+ FROM message
+ WHERE message->>'text' LIKE ${`PREOPEN%${state.runId.replaceAll('-', '').slice(0, 8)}%`}
+ ORDER BY id
+ `,
+ db.prisma.$queryRaw>`
+ SELECT id, time, time_tick AS "timeTick", message->>'text' AS text
+ FROM message
+ WHERE message->>'text' LIKE ${`MONITOR-${state.runId.replaceAll('-', '').slice(0, 8)}-%`}
+ ORDER BY id DESC
+ LIMIT 20
+ `,
+ db.prisma.nationBetting.findMany({
+ orderBy: { id: 'asc' },
+ select: { id: true, name: true, finished: true, openYearMonth: true, closeYearMonth: true, bets: true },
+ }),
+ db.prisma.unificationFinalization.findMany({ orderBy: { createdAt: 'asc' } }),
+ db.prisma.clockSuspension.findMany({
+ orderBy: { createdAt: 'asc' },
+ select: {
+ id: true,
+ status: true,
+ sourceRevision: true,
+ targetRevision: true,
+ cutTick: true,
+ cutWallAt: true,
+ resumeWallAt: true,
+ shiftTicks: true,
+ alignedTick: true,
+ },
+ }),
+ ]);
+ log('database-status', {
+ world: {
+ ...world,
+ clockTick: world.clockTick?.toString() ?? null,
+ lastTurnTick: world.lastTurnTick?.toString() ?? null,
+ clockRevision: world.clockRevision.toString(),
+ },
+ humanGenerals,
+ humanGeneralDetails: humanGeneralDetails.map((general) => ({
+ ...general,
+ turnTime: general.turnTime.toISOString(),
+ turnTick: general.turnTick?.toString() ?? null,
+ })),
+ allGenerals,
+ nations,
+ cities,
+ messages: messages.map((message) => ({
+ id: message.id,
+ time: message.time.toISOString(),
+ timeTick: message.timeTick?.toString() ?? null,
+ text: message.text,
+ })),
+ monitorMessages: monitorMessages.reverse().map((message) => ({
+ id: message.id,
+ time: message.time.toISOString(),
+ timeTick: message.timeTick?.toString() ?? null,
+ text: message.text,
+ })),
+ betting: betting.map((row) => ({
+ id: row.id,
+ name: row.name,
+ finished: row.finished,
+ openYearMonth: row.openYearMonth,
+ closeYearMonth: row.closeYearMonth,
+ bets: row.bets.length,
+ })),
+ unification: unification.length,
+ suspensions: suspensions.map((row) => ({
+ ...row,
+ sourceRevision: row.sourceRevision.toString(),
+ targetRevision: row.targetRevision.toString(),
+ cutTick: row.cutTick.toString(),
+ cutWallAt: row.cutWallAt.toISOString(),
+ resumeWallAt: row.resumeWallAt?.toISOString() ?? null,
+ shiftTicks: row.shiftTicks?.toString() ?? null,
+ alignedTick: row.alignedTick?.toString() ?? null,
+ })),
+ });
+ } finally {
+ await db.disconnect();
+ }
+};
+
+const preparePausedBetting = async (): Promise => {
+ const state = await readState();
+ if (state.pausedBettingId) throw new Error(`Paused betting fixture already exists: ${state.pausedBettingId}`);
+ if (state.users?.length !== 10) throw new Error('Exactly ten lifecycle users are required.');
+ const db = createGamePostgresConnector({ url: gameDatabaseUrl() });
+ await db.connect();
+ try {
+ const world = await db.prisma.worldState.findFirstOrThrow({ orderBy: { id: 'asc' } });
+ if (world.clockPhase !== 'SUSPENDED') {
+ throw new Error(`Refusing paused betting fixture while clock phase is ${world.clockPhase}.`);
+ }
+ const nations = await db.prisma.nation.findMany({
+ where: { id: { gt: 0 }, level: { gt: 0 } },
+ orderBy: [{ level: 'desc' }, { id: 'asc' }],
+ take: 3,
+ });
+ if (nations.length < 2) throw new Error(`At least two active nations are required, found ${nations.length}.`);
+ const general = await db.prisma.general.findFirstOrThrow({
+ where: { name: state.users[0]!.generalName, userId: { not: null } },
+ });
+ if (!general.userId) throw new Error('Lifecycle user general has no user ID.');
+ const aggregate = await db.prisma.nationBetting.aggregate({ _max: { id: true } });
+ const bettingId = Math.max(900_000_000, (aggregate._max.id ?? 0) + 1);
+ const openYearMonth = world.currentYear * 12 + world.currentMonth - 1;
+ const candidates = await Promise.all(
+ nations.map(async (nation) => {
+ const [generalCount, cityCount] = await Promise.all([
+ db.prisma.general.count({ where: { nationId: nation.id } }),
+ db.prisma.city.count({ where: { nationId: nation.id } }),
+ ]);
+ return {
+ title: nation.name,
+ info: `국력: ${nation.level}
장수 수: ${generalCount}
도시 수: ${cityCount}`,
+ isHtml: true,
+ aux: {
+ nation: nation.id,
+ name: nation.name,
+ color: nation.color,
+ type: nation.typeCode,
+ level: nation.level,
+ capital: nation.capitalCityId,
+ gennum: generalCount,
+ power: nation.level,
+ city_cnt: cityCount,
+ },
+ };
+ })
+ );
+ await db.prisma.$transaction([
+ db.prisma.nationBetting.create({
+ data: {
+ id: bettingId,
+ type: 'bettingNation',
+ name: `일시 중지 실제 제출 검증 ${state.runId.slice(0, 8)}`,
+ finished: false,
+ selectCount: 1,
+ isExclusive: null,
+ requiresInheritancePoint: true,
+ openYearMonth,
+ closeYearMonth: openYearMonth + 12,
+ candidates,
+ },
+ }),
+ db.prisma.inheritancePoint.upsert({
+ where: { userId_key: { userId: general.userId, key: 'previous' } },
+ update: { value: 1000 },
+ create: { userId: general.userId, key: 'previous', value: 1000 },
+ }),
+ ]);
+ state.pausedBettingId = bettingId;
+ await writeState(state);
+ log('paused-betting-fixture-prepared', {
+ bettingId,
+ clockPhase: world.clockPhase,
+ year: world.currentYear,
+ month: world.currentMonth,
+ candidates: candidates.map((candidate) => candidate.title),
+ userGeneral: general.name,
+ fixtureOnly: ['nation_betting', 'inheritance_point'],
+ });
+ } finally {
+ await db.disconnect();
+ }
+};
+
+const submitPausedBetting = async (): Promise => {
+ const state = await readState();
+ const bettingId = state.pausedBettingId;
+ if (!bettingId || state.users?.length !== 10) throw new Error('Paused betting fixture and users are required.');
+ const browser = await chromium.launch({ headless: true });
+ const context = await browser.newContext({ viewport: { width: 500, height: 844 } });
+ const user = state.users[0]!;
+ await context.addInitScript(
+ ({ gatewayToken, gameToken, profile }) => {
+ window.localStorage.setItem('sammo-session-token', gatewayToken);
+ window.localStorage.setItem('sammo-game-token', gameToken);
+ window.localStorage.setItem('sammo-game-profile', profile);
+ },
+ { gatewayToken: user.gatewayToken, gameToken: user.gameToken, profile: profileName }
+ );
+ const page = await context.newPage();
+ let browserErrors = 0;
+ let applicationHttpErrors = 0;
+ page.on('pageerror', () => {
+ browserErrors += 1;
+ });
+ page.on('response', (response) => {
+ if (response.status() >= 400 && !new URL(response.url()).pathname.startsWith('/image/')) {
+ applicationHttpErrors += 1;
+ }
+ });
+ try {
+ const before = await createGame(user.gameToken).betting.getDetail.query({ bettingId });
+ await page.goto(`${webOrigin}/hwe/nation-betting`, { waitUntil: 'networkidle' });
+ await page
+ .getByRole('button', { name: new RegExp(`일시 중지 실제 제출 검증 ${state.runId.slice(0, 8)}`) })
+ .click();
+ await page.locator('.betting-candidate').first().click();
+ await page.getByRole('spinbutton', { name: '베팅 금액' }).fill('100');
+ const wallSubmittedAt = new Date().toISOString();
+ await page.getByRole('button', { name: '베팅', exact: true }).click();
+ await page.getByTestId('game-toast').getByText('베팅했습니다', { exact: true }).waitFor({ state: 'visible' });
+ await page.screenshot({ path: path.join(artifactDir, 'paused-betting-submitted.png'), fullPage: true });
+ const after = await createGame(user.gameToken).betting.getDetail.query({ bettingId });
+ log('paused-betting-submitted', {
+ bettingId,
+ wallSubmittedAt,
+ before: { remainPoint: before.remainPoint, myBetting: before.myBetting },
+ after: { remainPoint: after.remainPoint, myBetting: after.myBetting },
+ browserErrors,
+ applicationHttpErrors,
+ });
+ if (
+ after.remainPoint !== before.remainPoint - 100 ||
+ !after.myBetting.some(([selection, amount]) => selection === '[0]' && amount === 100) ||
+ browserErrors ||
+ applicationHttpErrors
+ ) {
+ process.exitCode = 1;
+ }
+ } finally {
+ await context.close();
+ await browser.close();
+ }
+};
+
+const reserveUserEnlistments = async (): Promise => {
+ const state = await readState();
+ if (state.users?.length !== 10) throw new Error('Exactly ten lifecycle users are required.');
+ const nations = (await createGame(state.users[0]!.gameToken).public.getNationList.query()).filter(
+ (nation) => nation.id > 0 && nation.level > 0
+ );
+ if (nations.length === 0) throw new Error('No active nation exists for enlistment.');
+ const reservations: Array<{ index: number; generalId: number; nationId: number; nationName: string }> = [];
+ for (const [offset, user] of state.users.entries()) {
+ const game = createGame(user.gameToken);
+ const generalResult = await game.general.me.query();
+ if (!generalResult?.general) throw new Error(`Lifecycle user ${offset + 1} has no general.`);
+ if (generalResult.general.nationId > 0) {
+ log('user-enlistment-already-complete', {
+ index: offset + 1,
+ generalId: generalResult.general.id,
+ nationId: generalResult.general.nationId,
+ });
+ continue;
+ }
+ const target = nations[0]!;
+ let snapshot = await game.turns.reserved.getGeneral.query({ generalId: generalResult.general.id });
+ for (let turnIndex = 0; turnIndex < 10; turnIndex += 1) {
+ snapshot = await game.turns.reserved.setGeneral.mutate({
+ generalId: generalResult.general.id,
+ turnIndex,
+ action: 'che_임관',
+ args: { destNationId: target.id },
+ expectedRevision: snapshot.revision,
+ });
+ }
+ reservations.push({
+ index: offset + 1,
+ generalId: generalResult.general.id,
+ nationId: target.id,
+ nationName: target.name,
+ });
+ }
+ log('user-enlistments-reserved', { reservations });
+};
+
+const verifyExistingMonitorMessage = async (): Promise => {
+ const opened = await openUserPages();
+ const sequence = Number(process.argv[3] ?? '22');
+ if (!Number.isInteger(sequence) || sequence < 1) throw new Error('Monitor message sequence must be positive.');
+ const text = `MONITOR-${opened.state.runId.replaceAll('-', '').slice(0, 8)}-${String(sequence).padStart(2, '0')}`;
+ try {
+ await Promise.all(
+ opened.records.map(({ page }) =>
+ page
+ .locator('.PublicTalk')
+ .getByText(text, { exact: true })
+ .waitFor({ state: 'visible', timeout: 60_000 })
+ )
+ );
+ await opened.records[0]!.page.screenshot({
+ path: path.join(artifactDir, `monitor-recovered-${String(sequence).padStart(2, '0')}.png`),
+ fullPage: true,
+ });
+ log('monitor-message-recovered-fanout', { text, viewersObserved: 10, ...opened.errors() });
+ } finally {
+ await Promise.all(opened.records.map(({ context }) => context.close()));
+ await opened.browser.close();
+ }
+};
+
+const resumeDaemon = async (): Promise => {
+ const game = await createAdminGame();
+ const result = await game.turnDaemon.resume.mutate({
+ reason: 'isolated lifecycle recovery after failed paused DELAY',
+ });
+ await new Promise((resolve) => setTimeout(resolve, 500));
+ const after = await game.turnDaemon.status.query({ timeoutMs: 1000 });
+ log('turn-daemon-resumed-directly', { requestId: result.requestId, after });
+};
+
+const fastForward = async (): Promise => {
+ const state = await readState();
+ const maxMonths = Number(process.argv[3] ?? '1200');
+ const stopNationCount = Number(process.env.SAMMO_FAST_FORWARD_STOP_NATIONS ?? '0');
+ if (!Number.isInteger(maxMonths) || maxMonths < 1) throw new Error('fast-forward months must be positive.');
+ if (!Number.isInteger(stopNationCount) || stopNationCount < 0) {
+ throw new Error('SAMMO_FAST_FORWARD_STOP_NATIONS must be a non-negative integer.');
+ }
+ const runtime = await createTurnDaemonRuntime({
+ profile: profileName.split(':', 1)[0] ?? 'hwe',
+ databaseUrl: gameDatabaseUrl(),
+ gameClockMode: 'manual',
+ leaseOwnerId: `lifecycle-fast-forward-${state.runId.slice(0, 8)}`,
+ enableLeaseHeartbeat: true,
+ leaseDurationMs: 300_000,
+ exclusiveFastForward: true,
+ databaseTransactionTimeoutMs: 300_000,
+ });
+ const startedAt = Date.now();
+ let months = 0;
+ try {
+ while (months < maxMonths) {
+ const before = runtime.world.getState();
+ const targetTime = new Date(before.lastTurnTime.getTime() + before.tickSeconds * 1000);
+ let checkpoint;
+ do {
+ const result = await runtime.processor.run(
+ targetTime,
+ { budgetMs: 300_000, maxGenerals: 10_000, catchUpCap: 1 },
+ checkpoint
+ );
+ await runtime.hooks?.flushChanges?.(result);
+ checkpoint = result.checkpoint;
+ if (result.partial && result.processedGenerals === 0 && result.processedTurns === 0) {
+ throw new Error('Fast-forward made no progress within its budget.');
+ }
+ } while (checkpoint);
+ months += 1;
+ const state = runtime.world.getState();
+ const activeNations = runtime.world.listNations().filter((nation) => nation.id > 0 && nation.level > 0);
+ const rawUnited = Reflect.get(state.meta, 'isunited') ?? Reflect.get(state.meta, 'isUnited') ?? 0;
+ const isUnited = typeof rawUnited === 'number' ? rawUnited : Number(rawUnited);
+ if (
+ months === 1 ||
+ months % 12 === 0 ||
+ activeNations.length <= Math.max(stopNationCount, 5) ||
+ isUnited >= 2
+ ) {
+ log('fast-forward-progress', {
+ months,
+ year: state.currentYear,
+ month: state.currentMonth,
+ activeNations: activeNations.length,
+ generals: runtime.world.listGenerals().length,
+ isUnited,
+ elapsedSeconds: Math.round((Date.now() - startedAt) / 1000),
+ });
+ }
+ if (isUnited >= 2 || (stopNationCount > 0 && activeNations.length <= stopNationCount)) break;
+ }
+ const state = runtime.world.getState();
+ log('fast-forward-complete', {
+ months,
+ year: state.currentYear,
+ month: state.currentMonth,
+ activeNations: runtime.world.listNations().filter((nation) => nation.id > 0 && nation.level > 0).length,
+ elapsedSeconds: Math.round((Date.now() - startedAt) / 1000),
+ });
+ } finally {
+ await runtime.close();
+ }
+};
+
+const placeInvaderRecipients = async (): Promise => {
+ const state = await readState();
+ if (state.users?.length !== 10) throw new Error('Exactly ten lifecycle users are required.');
+ const db = createGamePostgresConnector({ url: gameDatabaseUrl() });
+ await db.connect();
+ try {
+ const nations = await db.prisma.nation.findMany({
+ where: { id: { gt: 0 }, level: { gt: 0 } },
+ orderBy: [{ level: 'desc' }, { id: 'asc' }],
+ take: 5,
+ });
+ if (nations.length < 2 || nations.length > 5) {
+ throw new Error(`Recipient fixture requires two to five active nations, found ${nations.length}.`);
+ }
+ const placements = [];
+ for (const [index, user] of state.users.entries()) {
+ const nation = nations[index % nations.length]!;
+ const city = nation.capitalCityId
+ ? { id: nation.capitalCityId }
+ : await db.prisma.city.findFirstOrThrow({ where: { nationId: nation.id }, orderBy: { id: 'asc' } });
+ const officerLevel = 5 + Math.floor(index / nations.length);
+ const general = await db.prisma.general.update({
+ where: { id: (await db.prisma.general.findFirstOrThrow({ where: { name: user.generalName } })).id },
+ data: { nationId: nation.id, cityId: city.id, officerLevel },
+ select: { id: true, name: true, nationId: true, officerLevel: true, cityId: true },
+ });
+ placements.push({ ...general, nationName: nation.name });
+ }
+ log('invader-recipient-fixture-placed', {
+ activeNations: nations.map((nation) => ({ id: nation.id, name: nation.name, level: nation.level })),
+ placements,
+ fixtureOnly: ['general.nation_id', 'general.city_id', 'general.officer_level'],
+ });
+ } finally {
+ await db.disconnect();
+ }
+};
+
+const respondToInvaderMessageInBrowser = async (): Promise => {
+ const state = await readState();
+ if (state.users?.length !== 10) throw new Error('Exactly ten lifecycle users are required.');
+ const messageId = Number(requiredEnv('SAMMO_INVADER_MESSAGE_ID'));
+ const userIndex = Number(requiredEnv('SAMMO_INVADER_USER_INDEX'));
+ if (!Number.isInteger(messageId) || messageId < 1) throw new Error('SAMMO_INVADER_MESSAGE_ID must be positive.');
+ if (!Number.isInteger(userIndex) || userIndex < 1 || userIndex > state.users.length) {
+ throw new Error('SAMMO_INVADER_USER_INDEX must identify a lifecycle user.');
+ }
+ const user = state.users[userIndex - 1]!;
+ const browser = await chromium.launch({ headless: true });
+ const context = await browser.newContext({ viewport: { width: 1280, height: 900 } });
+ try {
+ await context.addInitScript(
+ ({ gatewayToken, gameToken, profile }) => {
+ window.localStorage.setItem('sammo-session-token', gatewayToken);
+ window.localStorage.setItem('sammo-game-token', gameToken);
+ window.localStorage.setItem('sammo-game-profile', profile);
+ },
+ { gatewayToken: user.gatewayToken, gameToken: user.gameToken, profile: profileName }
+ );
+ const page = await context.newPage();
+ page.setDefaultTimeout(30_000);
+ let browserErrors = 0;
+ let applicationHttpErrors = 0;
+ page.on('pageerror', () => {
+ browserErrors += 1;
+ });
+ page.on('response', (response) => {
+ if (response.status() >= 400 && !new URL(response.url()).pathname.startsWith('/image/')) {
+ applicationHttpErrors += 1;
+ }
+ });
+ await page.goto(`${webOrigin}/hwe/`, { waitUntil: 'domcontentloaded' });
+ const plate = page.locator(`#msg_${messageId}`);
+ await plate.waitFor({ state: 'visible' });
+ const beforeText = (await plate.locator('.msg-content').textContent())?.trim() ?? '';
+ await page.screenshot({ path: path.join(artifactDir, 'invader-message-before-response.png'), fullPage: true });
+ const responsePromise = page.waitForResponse(
+ (response) =>
+ response.url().includes('/api/trpc/messages.respond') && response.request().method() === 'POST'
+ );
+ page.once('dialog', (dialog) => dialog.accept());
+ await plate.locator('.prompt-yes').click();
+ const response = await responsePromise;
+ await page.waitForTimeout(2_000);
+ await page.screenshot({ path: path.join(artifactDir, 'invader-message-after-response.png'), fullPage: true });
+ log('invader-message-browser-response', {
+ messageId,
+ userIndex,
+ generalName: user.generalName,
+ beforeText,
+ responseStatus: response.status(),
+ browserErrors,
+ applicationHttpErrors,
+ });
+ if (response.status() !== 200 || browserErrors || applicationHttpErrors) process.exitCode = 1;
+ } finally {
+ await context.close();
+ await browser.close();
+ }
+};
+
+const requestAction = async (): Promise => {
+ const action = process.argv[3];
+ if (!['PAUSE', 'RESUME', 'DELAY', 'ACCELERATE'].includes(action ?? '')) {
+ throw new Error('action must be PAUSE, RESUME, DELAY, or ACCELERATE');
+ }
+ const durationMinutes = process.argv[4] ? Number(process.argv[4]) : undefined;
+ if (
+ (action === 'DELAY' || action === 'ACCELERATE') &&
+ (!Number.isInteger(durationMinutes) || durationMinutes! < 1)
+ ) {
+ throw new Error('DELAY and ACCELERATE require a positive integer minute duration.');
+ }
+ const gateway = await loginAdmin();
+ const result = await gateway.admin.profiles.requestAction.mutate({
+ profileName,
+ action: action as 'PAUSE' | 'RESUME' | 'DELAY' | 'ACCELERATE',
+ ...(durationMinutes ? { durationMinutes } : {}),
+ reason: `isolated lifecycle integration ${action.toLowerCase()}`,
+ });
+ log('admin-action-requested', {
+ action,
+ durationMinutes: durationMinutes ?? null,
+ accepted: result.ok,
+ runtimeActionId: result.action && 'id' in result.action ? result.action.id : null,
+ });
+};
+
+const monitorUsers = async (): Promise => {
+ const opened = await openUserPages();
+ const durationMinutes = Number(process.env.SAMMO_LIVE_MONITOR_MINUTES ?? '30');
+ if (!Number.isFinite(durationMinutes) || durationMinutes < 10 || durationMinutes > 120) {
+ throw new Error('SAMMO_LIVE_MONITOR_MINUTES must be from 10 to 120.');
+ }
+ const outputPath = path.join(artifactDir, 'user-monitor.ndjson');
+ const startedAt = Date.now();
+ const deadline = startedAt + durationMinutes * 60_000;
+ let sampleIndex = 0;
+ let messageIndex = Number(process.env.SAMMO_LIVE_MONITOR_START_INDEX ?? '0');
+ if (!Number.isInteger(messageIndex) || messageIndex < 0) {
+ throw new Error('SAMMO_LIVE_MONITOR_START_INDEX must be a non-negative integer.');
+ }
+ let fanoutFailures = 0;
+ try {
+ await appendFile(
+ outputPath,
+ `${JSON.stringify({ at: new Date().toISOString(), event: 'monitor-started', viewers: 10, durationMinutes })}\n`,
+ { mode: 0o600 }
+ );
+ while (Date.now() < deadline) {
+ sampleIndex += 1;
+ const info = await createGame(opened.state.users![0]!.gameToken).lobby.info.query();
+ const visiblePanels = (
+ await Promise.all(opened.records.map(({ page }) => page.locator('.MessagePanel').isVisible()))
+ ).filter(Boolean).length;
+ const sample = {
+ at: new Date().toISOString(),
+ event: 'user-monitor-sample',
+ sampleIndex,
+ visiblePanels,
+ year: info.year,
+ month: info.month,
+ turnTerm: info.turnTerm,
+ userCnt: info.userCnt,
+ npcCnt: info.npcCnt,
+ nationCnt: info.nationCnt,
+ wallElapsedSeconds: Math.round((Date.now() - startedAt) / 1000),
+ };
+ log('user-monitor-sample', sample);
+ await appendFile(outputPath, `${JSON.stringify(sample)}\n`);
+
+ if (sampleIndex % 2 === 0) {
+ messageIndex += 1;
+ const sender = opened.records[(messageIndex - 1) % opened.records.length]!;
+ const text = `MONITOR-${opened.state.runId.replaceAll('-', '').slice(0, 8)}-${String(messageIndex).padStart(2, '0')}`;
+ await sender.page.locator('.PublicTalk').getByRole('button', { name: '↩ 여기로', exact: true }).click();
+ await sender.page.locator('.message-text').fill(text);
+ const wallSentAt = new Date().toISOString();
+ await sender.page.getByRole('button', { name: '서신전달&갱신', exact: true }).click();
+ const fanout = await Promise.all(
+ opened.records.map(({ page }) =>
+ page
+ .locator('.PublicTalk')
+ .getByText(text, { exact: true })
+ .waitFor({ state: 'visible', timeout: 30_000 })
+ .then(() => true)
+ .catch(() => false)
+ )
+ );
+ const viewersObserved = fanout.filter(Boolean).length;
+ if (viewersObserved !== 10) fanoutFailures += 1;
+ const messageEvent = {
+ at: new Date().toISOString(),
+ event: 'monitor-message-fanout',
+ sender: sender.index,
+ text,
+ wallSentAt,
+ viewersObserved,
+ };
+ log('monitor-message-fanout', messageEvent);
+ await appendFile(outputPath, `${JSON.stringify(messageEvent)}\n`);
+ }
+ if (sampleIndex % 10 === 0) {
+ await opened.records[0]!.page.screenshot({
+ path: path.join(artifactDir, `monitor-${String(sampleIndex).padStart(3, '0')}.png`),
+ fullPage: true,
+ });
+ }
+ const remaining = deadline - Date.now();
+ if (remaining > 0) await new Promise((resolve) => setTimeout(resolve, Math.min(30_000, remaining)));
+ }
+ const errors = opened.errors();
+ log('user-monitor-complete', {
+ durationMinutes,
+ samples: sampleIndex,
+ messages: messageIndex,
+ fanoutFailures,
+ ...errors,
+ });
+ await appendFile(
+ outputPath,
+ `${JSON.stringify({ at: new Date().toISOString(), event: 'monitor-complete', samples: sampleIndex, messages: messageIndex, fanoutFailures, ...errors })}\n`
+ );
+ if (
+ errors.browserErrors ||
+ errors.applicationHttpErrors ||
+ fanoutFailures ||
+ sampleIndex < durationMinutes * 2 - 2
+ ) {
+ process.exitCode = 1;
+ }
+ } finally {
+ await Promise.all(opened.records.map(({ context }) => context.close()));
+ await opened.browser.close();
+ }
+};
+
+const command = process.argv[2];
+if (command === 'reset') await reset();
+else if (command === 'wait-reset') await waitReset();
+else if (command === 'status') await status();
+else if (command === 'prepare-users') await prepareUsers();
+else if (command === 'preopen-messages') await preopenMessages();
+else if (command === 'verified-preopen-messages') await preopenMessages(true);
+else if (command === 'repair-preopen-fixture') await repairPreopenFixture();
+else if (command === 'database-status') await databaseStatus();
+else if (command === 'prepare-paused-betting') await preparePausedBetting();
+else if (command === 'submit-paused-betting') await submitPausedBetting();
+else if (command === 'reserve-user-enlistments') await reserveUserEnlistments();
+else if (command === 'verify-monitor-message') await verifyExistingMonitorMessage();
+else if (command === 'resume-daemon') await resumeDaemon();
+else if (command === 'fast-forward') await fastForward();
+else if (command === 'place-invader-recipients') await placeInvaderRecipients();
+else if (command === 'respond-invader-browser') await respondToInvaderMessageInBrowser();
+else if (command === 'action') await requestAction();
+else if (command === 'monitor-users') await monitorUsers();
+else
+ throw new Error(
+ 'usage: live-ten-user-lifecycle.ts '
+ );
diff --git a/tools/integration-tests/tsconfig.json b/tools/integration-tests/tsconfig.json
index c9b8d733..631e1714 100644
--- a/tools/integration-tests/tsconfig.json
+++ b/tools/integration-tests/tsconfig.json
@@ -4,5 +4,5 @@
"types": ["node"],
"noEmit": true
},
- "include": ["src/**/*.ts", "test/**/*.ts"]
+ "include": ["src/**/*.ts", "test/**/*.ts", "scripts/**/*.ts"]
}