Build an extensible multiplayer game platform

.dockerignore

@@ -0,0 +1,11 @@
+.git
+node_modules
+dist
+.data
+.env
+.env.*
+*.sqlite
+*.sqlite-*
+client
+agents
+games

.github/workflows/integration.yml

@@ -0,0 +1,61 @@
+name: Cross-service integration
+on:
+  pull_request:
+  workflow_dispatch:
+permissions:
+  contents: read
+concurrency:
+  group: integration-${{ github.ref }}
+  cancel-in-progress: true
+jobs:
+  client:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 24.14.1
+      - run: npm ci --ignore-scripts && npm run build
+      - run: node scripts/prepare-sdk.mjs
+        working-directory: client
+      - run: npm ci --ignore-scripts && npm run check && npm run dev:dry-run && npm run check:artifact
+        working-directory: client
+        env:
+          GAME_ROOM_SERVER_MODULE: ${{ github.workspace }}/dist/server/http.js
+  games-and-agents:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 24.14.1
+      - run: npm ci --ignore-scripts && npm run build
+      - run: npm ci --ignore-scripts && npm run check
+        working-directory: games
+      - run: npm ci --ignore-scripts && npm run check && npm run check:consumer
+        working-directory: agents
+        env:
+          GAME_ROOM_SERVER_SOURCE: ${{ github.workspace }}
+          GAME_ROOM_PACKAGES: ${{ github.workspace }}/games/dist
+  economy:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          path: game
+      - uses: actions/checkout@v4
+        with:
+          repository: cordisx/plugin-economy
+          ref: ce058c9ed530277897b7c0bcaa7c9d433f946908
+          path: economy
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 24.14.1
+      - run: npm ci --ignore-scripts && npm run build
+        working-directory: economy
+      - run: npm ci --ignore-scripts && npm run build
+        working-directory: game
+      - run: node --test integration/economy.test.mjs
+        working-directory: game
+        env:
+          ECONOMY_REPOSITORY: ${{ github.workspace }}/economy

.github/workflows/server.yml

@@ -0,0 +1,29 @@
+name: Game server
+on:
+  pull_request:
+    paths: ['server/**', 'sdk/**', 'tests/server/**', 'deploy/**', 'docs/server*.md', 'package*.json', 'tsconfig.json', 'dprint.json', 'eslint.config.mjs', '.github/workflows/server.yml']
+  push:
+    branches: [main, codex/game-server]
+permissions:
+  contents: read
+jobs:
+  check:
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    steps:
+      - uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262
+      - uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020
+        with:
+          node-version: '24.14.1'
+          cache: npm
+      - run: npm ci
+      - run: npm run check
+      - run: docker compose -f deploy/compose.yaml config --quiet
+      - run: docker build -f deploy/Dockerfile -t game-room-ci .
+      - name: Run constrained container smoke
+        run: >-
+          docker run --rm --read-only --tmpfs /tmp:rw,nosuid
+          --tmpfs /data:rw,uid=1000,gid=1000 --cap-drop ALL
+          --security-opt no-new-privileges
+          --mount type=bind,source="$PWD/deploy/container-smoke.mjs",target=/app/container-smoke.mjs,readonly
+          --entrypoint node game-room-ci /app/container-smoke.mjs

.gitignore

@@ -1,9 +1,6 @@
 node_modules/
 dist/
 .env
-.env.*
-!.env.example
-*.sqlite*
+*.sqlite
+*.sqlite-*
 .data/
-coverage/
-.development/

README.md

@@ -1,7 +1,52 @@
-# plugin-game-room
+# CordisX Game Room
 
-Extensible multiplayer games for CordisX: plugin, authoritative server and game SDK.
+A multiplayer game platform with a CordisX client, self-hosted authoritative
+server, uploadable game packages and personal Agent dispatch.
 
-Status: initial development, not a released or verified product.
+The lobby brings rooms from multiple servers together. A room pins its author's
+game package: the server executes its rules and players receive their own seat's
+view. Gomoku and Texas Hold'em are the first example packages; new games use the
+same publishing and room APIs.
 
-See [development scope](docs/architecture.md).
+This repository is under active development. Server and economic integration
+have executable checks; the complete native client and uploaded UI runtime are
+still being integrated. See the [integration evidence](docs/integration.md) for
+the distinction between component tests and a complete application.
+
+## Run a server
+
+With Node.js 24.14 or newer:
+
+```sh
+npm ci
+npm run build
+npm run dev:server
+```
+
+The default address is `http://127.0.0.1:8787`. Follow
+[self-hosting](docs/server-development.md) for persistent storage, deployment
+configuration, TLS and recovery. Each deployment is an independent data source.
+
+Score-only and match-local chips work without an economic service. Shared
+entertainment Token coins use the separate
+[Economy service](https://github.com/cordisx/plugin-economy), with explicit
+stake consent and conserved settlement. These are virtual game coins.
+
+## Develop and extend
+
+| Component | Guide |
+| --- | --- |
+| CordisX client | [Client development](docs/client.md) |
+| HTTP and rule runtime | [Server API and GamePackage v1](docs/server-api.md) |
+| Gomoku and Hold'em | [Example games](docs/games.md) |
+| Your own game | [Authoring and publishing](docs/games-authoring.md) |
+| Personal Agent seats | [Dispatch service](docs/agents.md) |
+| Cross-service verification | [Integration checks](docs/integration.md) |
+
+The server, `client/`, `games/` and `agents/` have independent package locks.
+Install and build each component from its own directory. The server never
+imports uploaded rules as trusted Node modules; resource isolation and game
+fairness are separate properties. An author's review status is displayed and
+does not prove the rules are fair.
+
+Licensed under [MIT](LICENSE).

agents/.gitignore

@@ -0,0 +1,3 @@
+node_modules/
+dist/
+*.tsbuildinfo