feat: add durable release controller and admin deploy modes

2026-08-01 03:27:38 +00:00
parent 395b60cdbe
commit 7b466de0a6
37 changed files with 2778 additions and 35 deletions
@@ -0,0 +1,51 @@
+import fs from 'node:fs/promises';
+import os from 'node:os';
+import path from 'node:path';
+
+import { afterEach, describe, expect, it } from 'vitest';
+
+import { readReleaseManifest } from '../src/orchestrator/releaseManifest.js';
+
+const temporaryDirectories: string[] = [];
+
+const createWorkspace = async (gatewayHead: string, gameHead: string): Promise<string> => {
+    const workspace = await fs.mkdtemp(path.join(os.tmpdir(), 'sammo-release-manifest-'));
+    temporaryDirectories.push(workspace);
+    await fs.mkdir(path.join(workspace, 'packages/infra/prisma/gateway-migrations', gatewayHead), {
+        recursive: true,
+    });
+    await fs.mkdir(path.join(workspace, 'packages/infra/prisma/migrations', gameHead), { recursive: true });
+    await fs.writeFile(
+        path.join(workspace, 'release-manifest.json'),
+        JSON.stringify({
+            formatVersion: 1,
+            controllerProtocol: 1,
+            gatewaySchemaHead: gatewayHead,
+            gameSchemaHead: gameHead,
+            components: ['gateway-api', 'gateway-frontend', 'game-api', 'game-engine', 'game-frontend'],
+        })
+    );
+    return workspace;
+};
+
+afterEach(async () => {
+    await Promise.all(temporaryDirectories.splice(0).map((directory) => fs.rm(directory, { recursive: true })));
+});
+
+describe('readReleaseManifest', () => {
+    it('accepts a manifest whose schema heads match the selected workspace', async () => {
+        const workspace = await createWorkspace('20260801000000_gateway', '20260801000000_game');
+
+        await expect(readReleaseManifest(workspace)).resolves.toMatchObject({
+            gatewaySchemaHead: '20260801000000_gateway',
+            gameSchemaHead: '20260801000000_game',
+        });
+    });
+
+    it('rejects a stale schema head before any deployment command runs', async () => {
+        const workspace = await createWorkspace('20260801000000_gateway', '20260801000000_game');
+        await fs.mkdir(path.join(workspace, 'packages/infra/prisma/migrations/20260802000000_newer'));
+
+        await expect(readReleaseManifest(workspace)).rejects.toThrow('does not match workspace head');
+    });
+});