bot performance improvements use as reference point

.gitignore

@@ -42,4 +42,7 @@ Thumbs.db
 
 node_modules
 .sass-cache
-.idea
+.idea
+
+dist
+build

.prettierignore

@@ -0,0 +1,7 @@
+old
+
+# Ignore artifacts:
+build
+coverage
+
+pnpm-lock.yaml

CLAUDE.md

@@ -0,0 +1,73 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+Astriarch is a space strategy game built as a TypeScript monorepo using pnpm workspaces. The game features real-time multiplayer gameplay with a Node.js backend and multiple frontend implementations.
+
+## Architecture
+The project follows a monorepo structure with clear separation of concerns:
+
+- **packages/astriarch-engine**: Core game engine with business logic, game state management, and turn-based mechanics. Provides TypeScript types and game controllers used across all applications.
+- **apps/astriarch-backend**: Express.js server with WebSocket support, MongoDB integration, and session management. Handles multiplayer game state and real-time communication.
+- **apps/astriarch-frontend-sveltekit**: Primary SvelteKit frontend with component library, game canvas using Konva, and real-time multiplayer UI.
+- **packages/astriarch-ui**: Shared React component library using Chakra UI for consistent styling across frontends.
+
+The engine exports game models, controllers, and messaging types that are consumed by both frontend and backend applications. The backend maintains authoritative game state while clients receive filtered views through the ClientGameModel.
+
+## Development Commands
+
+### Root Level (run from project root)
+- `pnpm build` - Build all packages and apps
+- `pnpm test` - Run tests across all workspaces  
+- `pnpm lint` - Lint all packages
+- `pnpm format` - Format code across all packages
+- `docker-compose up -d mongodb` - Start local MongoDB for development
+
+### Backend Development
+- `pnpm --filter astriarch-backend dev` - Start backend in development mode with hot reload
+- `pnpm --filter astriarch-backend build` - Build backend TypeScript to JavaScript
+- `pnpm --filter astriarch-backend test` - Run backend tests
+- `pnpm --filter astriarch-backend lint` - Lint backend code
+- `pnpm --filter astriarch-backend type-check` - Run TypeScript type checking
+
+### SvelteKit Frontend Development  
+- `pnpm --filter astriarch-frontend-sveltekit dev` - Start SvelteKit dev server
+- `pnpm --filter astriarch-frontend-sveltekit build` - Build SvelteKit app
+- `pnpm --filter astriarch-frontend-sveltekit test` - Run Vitest unit tests
+- `pnpm --filter astriarch-frontend-sveltekit lint` - Lint and format check
+- `pnpm --filter astriarch-frontend-sveltekit storybook` - Start Storybook component development
+
+### Engine Package Development
+- `pnpm --filter astriarch-engine build` - Build engine package  
+- `pnpm --filter astriarch-engine test` - Run engine unit tests
+- `pnpm --filter astriarch-engine lint` - Lint engine code
+
+## Key Technical Details
+
+### Game State Management
+- Game state is managed centrally in the astriarch-engine package
+- Backend maintains authoritative GameModel, clients receive filtered ClientGameModel
+- Real-time updates flow through WebSocket connections managed by the backend
+- Game timing: MS_PER_TICK (200ms) for client updates, MS_PER_CYCLE (30s) for game turns
+
+### Database
+- MongoDB is used for persistent game state and session management
+- Start local MongoDB with `docker-compose up -d mongodb` for development
+- Connection configuration in backend's config/ directory
+
+### WebSocket Communication
+- Real-time multiplayer uses WebSocket connections through the backend's WebSocketServer
+- Message types are defined in packages/astriarch-engine/src/messaging/MessageTypes
+- Frontend websocket service handles connection management and message routing
+
+### Testing
+- Backend uses Jest for unit testing
+- SvelteKit frontend uses Vitest for component and unit testing  
+- Engine package has comprehensive Jest test suite
+- Run individual package tests with `pnpm --filter <package-name> test`
+
+## Current Branch Status
+- Working on v2.x-svelte branch (SvelteKit migration)
+- Main branch for PRs: master
+- Recent development focuses on WebSocket multiplayer implementation and SvelteKit frontend

Dockerfile

@@ -0,0 +1,26 @@
+FROM node:18-alpine AS build
+
+WORKDIR /usr/src/app
+
+# Install pnpm globally
+RUN npm install -g pnpm
+
+# Copy source code
+COPY . .
+
+RUN pnpm install --frozen-lockfile
+
+RUN pnpm run --filter=astriarch-backend... build
+
+RUN pnpm deploy --filter=astriarch-backend --prod /prod/astriarch-backend
+
+FROM node:18-alpine AS backend
+
+COPY --from=build /prod/astriarch-backend /prod/astriarch-backend
+WORKDIR /prod/astriarch-backend
+
+# Expose port
+EXPOSE 8001
+
+# Start the application
+CMD ["pnpm", "start"]

README.md

@@ -1,55 +1,22 @@
-Astriarch
-=========
+# Astriarch - Ruler of the stars
 
-Astriarch Ruler of the Stars, Space Strategy Game
-http://www.astriarch.com/
+## Quickstart
 
-This is the Open Source Multiplayer version of Astriarch.
+`docker-compose up -d mongodb`
 
-It uses NodeJS and MongoDB on the server and leverages WebSockets for communication to the client
 
-Running the Server
-==================
-You'll need to install Node.js 0.10+ and MongoDB
-Run `npm install` then `npm start` and then visit `http://localhost:8000`
 
-Or the easiest way to get started is to use [Docker](https://www.docker.com/):
-create a file `./config/local.json`:
+https://blog.nrwl.io/setup-a-monorepo-with-pnpm-workspaces-and-speed-it-up-with-nx-bc5d97258a7e
+
 ```
-   {
-     "mongodb":{
-       "host":"astriarch_mongo"
-     }
-   }
+npx nx run-many --target=build --all
 ```
-Run `docker-compose build` then `docker-compose up` and then visit `http://localhost:8000`
-
-Overview
-========
-Astriarch - Ruler of the Stars is a Turn-based, Single Player Space Strategy Game.
-Build planetary improvements and star ships to capture planets and defeat your enemies.
-Your ultimate goal is to become the master of the known universe, and earn the title of Astriarch!
-
-Background
-==========
-Developed in 2010 by <a href="http://www.masteredsoftware.com/" target="_blank">Mastered Software</a>, Astriarch combines aspects of other classic space strategy games such as <a href="http://en.wikipedia.org/wiki/Master_of_Orion_II:_Battle_at_Antares" target="_blank" rel="nofollow">Master of Orion 2</a> (MOO2), <a href="http://hol.abime.net/3427" target="_blank" rel="nofollow">Stellar Conflict</a> (1987 Amiga), and <a href="http://en.wikipedia.org/wiki/Star_Control" target="_blank" rel="nofollow">Star Control</a>.
-<br /><br />
-Currently Astriarch is realeased as a free casual web game.&nbsp; Planned future enhancements include the ability to research and develop improvements, as well as galaxy special items and events.
-<br /><br />
-The name Astriarch comes from the Ancient Greek words for star (<a href="http://en.wiktionary.org/wiki/%E1%BC%84%CF%83%CF%84%CF%81%CE%BF%CE%BD#Ancient_Greek" target="_blank" rel="nofollow">�stron</a>) and ruler (<a href="http://en.wiktionary.org/wiki/%E1%BC%80%CF%81%CF%87%CF%8C%CF%82" target="_blank" rel="nofollow">arkhos</a>)
 
-Other Versions
-==============
-Single Player Open Source Versions:
+```
+pnpm --filter astriarch-frontend dev
+```
 
-HTML5: https://github.com/mpalmerlee/Astriarch/tree/HTML5
+https://chakra-ui.com/getting-started/remix-guide
 
-Silverlight: https://github.com/mpalmerlee/Astriarch/tree/Silverlight
 
-Credits
-=======
-Astriarch - Ruler of the Stars, space strategy game designed and developed by <a href="http://www.masteredsoftware.com/" target="_blank">Mastered Software</a>, music by Resonant. Astriarch HTML 5/JavaScript version uses <a href="https://github.com/mpalmerlee/Stratiscape" target="_blank">Stratiscape</a> JavaScript Canvas Library and the <a href="https://github.com/mpalmerlee/jQuery-UI-Listbox" target="_blank">jQuery Listbox plugin</a>.
 
-License
-=======
-This version of Astriarch - Ruler of the Stars is released under the MIT License.

apps/astriarch-backend/.env.example

@@ -0,0 +1,20 @@
+# MongoDB Configuration
+MONGODB_CONNECTION_STRING=mongodb://astriarch:astriarch_password@localhost:27017/astriarch_v2
+MONGODB_HOST=localhost
+MONGODB_PORT=27017
+MONGODB_USERNAME=astriarch
+MONGODB_PASSWORD=astriarch_password
+MONGODB_DATABASE=astriarch_v2
+
+# Server Configuration
+NODE_ENV=development
+HOST=localhost
+PORT=8001
+WS_PORT=8001
+WS_PROTOCOL=ws
+
+# Session Configuration
+SESSION_SECRET=astriarch-v2-development-secret
+
+# CORS Configuration
+CORS_ORIGIN=http://localhost:5173,http://localhost:3000

apps/astriarch-backend/config/default.json

@@ -0,0 +1,34 @@
+{
+  "loglevel": "INFO",
+  "mongodb": {
+    "gamedb_name": "astriarch_v2",
+    "sessiondb_name": "astriarch_v2",
+    "host": "127.0.0.1",
+    "port": "27017",
+    "username": null,
+    "password": null
+  },
+  "cookie": {
+    "secret": "astriarch-v2-node-secret"
+  },
+  "server": {
+    "port": 8001,
+    "host": "localhost"
+  },
+  "websocket": {
+    "port": 8001,
+    "protocol": "ws",
+    "ping_frequency": 30000
+  },
+  "game": {
+    "client_timeout": 120000,
+    "cleanup_old_games": {
+      "enabled": true,
+      "check_interval_seconds": 7200
+    }
+  },
+  "cors": {
+    "origin": ["http://localhost:5173", "http://localhost:3000"],
+    "credentials": true
+  }
+}

apps/astriarch-backend/config/development.json

@@ -0,0 +1,10 @@
+{
+  "loglevel": "DEBUG",
+  "mongodb": {
+    "gamedb_name": "astriarch_v2_dev",
+    "sessiondb_name": "astriarch_v2_dev"
+  },
+  "server": {
+    "port": 8001
+  }
+}

apps/astriarch-backend/eslint.config.js

@@ -0,0 +1,17 @@
+module.exports = {
+  parser: '@typescript-eslint/parser',
+  extends: [
+    'eslint:recommended',
+    '@typescript-eslint/recommended',
+  ],
+  parserOptions: {
+    ecmaVersion: 2022,
+    sourceType: 'module',
+  },
+  rules: {
+    '@typescript-eslint/no-unused-vars': 'error',
+    '@typescript-eslint/no-explicit-any': 'warn',
+    '@typescript-eslint/explicit-function-return-type': 'off',
+    '@typescript-eslint/explicit-module-boundary-types': 'off',
+  },
+};

apps/astriarch-backend/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "astriarch-backend",
+  "version": "2.0.0",
+  "description": "Astriarch game server backend with TypeScript, Express, MongoDB, and WebSockets",
+  "main": "dist/app.js",
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx watch src/app.ts",
+    "start": "node --enable-source-maps dist/app.js",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "format:check": "prettier --check \"src/**/*.ts\"",
+    "lint": "eslint src/**/*.ts",
+    "type-check": "tsc --noEmit",
+    "test": "jest",
+    "test:watch": "jest --watch"
+  },
+  "dependencies": {
+    "astriarch-engine": "workspace:*",
+    "async": "^3.2.4",
+    "config": "^3.3.9",
+    "connect-mongo": "^5.1.0",
+    "cookie-parser": "^1.4.6",
+    "cors": "^2.8.5",
+    "express": "^4.18.2",
+    "express-session": "^1.17.3",
+    "helmet": "^7.1.0",
+    "mongoose": "^8.0.3",
+    "morgan": "^1.10.0",
+    "uuid": "^11.1.0",
+    "ws": "^8.14.2"
+  },
+  "devDependencies": {
+    "@types/async": "^3.2.24",
+    "@types/config": "^3.3.3",
+    "@types/cookie-parser": "^1.4.6",
+    "@types/cors": "^2.8.17",
+    "@types/express": "^4.17.21",
+    "@types/express-session": "^1.17.10",
+    "@types/morgan": "^1.9.9",
+    "@types/node": "^20.10.4",
+    "@types/uuid": "^10.0.0",
+    "@types/ws": "^8.5.9",
+    "@typescript-eslint/eslint-plugin": "^6.13.1",
+    "@typescript-eslint/parser": "^6.13.1",
+    "@types/jest": "^29.5.8",
+    "eslint": "^8.55.0",
+    "jest": "^29.7.0",
+    "prettier": "^3.6.2",
+    "ts-jest": "^29.1.1",
+    "tsx": "^4.6.2",
+    "typescript": "^5.3.3"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}