Game analysis scripts + improved env config

.gitignore

@@ -48,3 +48,4 @@ dist
 build
 .env
 **/ai-decision-debugging/data/*
+apps/astriarch-backend/analysis/*

README.md

@@ -3,6 +3,24 @@
 Astriarch Ruler of the Stars, Space Strategy Game
 http://www.astriarch.com/
 
+
+## Overview
+
+Astriarch - Ruler of the Stars is a real-time, Multi-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
+
+Development started in 2010 by [Mastered Software](http://www.masteredsoftware.com/), Astriarch combines aspects of other classic space strategy games such as [Master of Orion 2](http://en.wikipedia.org/wiki/Master_of_Orion_II:_Battle_at_Antares) (MOO2), [Stellar Conflict](http://hol.abime.net/3427) (1987 Amiga), and [Star Control](http://en.wikipedia.org/wiki/Star_Control).
+
+
+Currently Astriarch is realeased as a free casual web game. Planned future enhancements include the ability to research Carriers and planetary improvements like warp gates, defensive cannons, as well as galaxy special items and events.
+
+
+The name Astriarch comes from the Ancient Greek words for star ([ắstron](http://en.wiktionary.org/wiki/%E1%BC%84%CF%83%CF%84%CF%81%CE%BF%CE%BD#Ancient_Greek)) and ruler ([arkhos](http://en.wiktionary.org/wiki/%E1%BC%80%CF%81%CF%87%CF%8C%CF%82))
+
+
 ## Quickstart
 
 `docker-compose up`
@@ -47,26 +65,21 @@ Notes:
 - Add new scenarios under `apps/astriarch-frontend/e2e/scenarios` and reuse fixtures/helpers from `apps/astriarch-frontend/e2e/fixtures` and `apps/astriarch-frontend/e2e/helpers`.
 
 
-## Overview
+## DevOps Notes
 
-Astriarch - Ruler of the Stars is a real-time, Multi-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>)
+Backup and restore:
+```bash
+mongodump --uri="mongodb+srv://<full-connection-string>" --out="./production_dump"
+```
 
+```bash
+mongorestore --uri="mongodb://localhost:27017" ./production_dump
+```
 
 ## 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 - Ruler of the Stars, space strategy game designed and developed by [Mastered Software](http://www.masteredsoftware.com/), music by Resonant.
 
 ## License
 
 This version of Astriarch - Ruler of the Stars is released under the MIT License.
-

apps/astriarch-backend/.env.example

@@ -5,14 +5,23 @@ MONGODB_PORT=27017
 MONGODB_USERNAME=astriarch
 MONGODB_PASSWORD=astriarch_password
 MONGODB_DATABASE=astriarch_v2
+SESSION_DATABASE=astriarch_v2
 
 # Server Configuration
 NODE_ENV=development
 HOST=localhost
 PORT=8001
 WS_PORT=8001
 WS_PROTOCOL=ws
+WS_PING_FREQUENCY_MS=30000
 COOKIE_SECRET=astriarch-v2-node-secret
+LOGLEVEL=INFO
 
 # CORS Configuration
 CORS_ORIGIN_LIST=http://localhost:5173,http://localhost:3000
+CORS_CREDENTIALS=true
+
+# Game cleanup configuration
+GAME_CLEANUP_ENABLED=true
+GAME_CLEANUP_INTERVAL_SECONDS=7200
+GAME_CLEANUP_MAX_AGE_HOURS=24

apps/astriarch-backend/package.json

@@ -7,6 +7,11 @@
     "build": "tsc",
     "dev": "tsx watch src/app.ts",
     "start": "node --enable-source-maps dist/app.js",
+    "analyze:history": "node scripts/analyze-production-history.js",
+    "analyze:production-failures": "node scripts/analyze-production-failures.js",
+    "analyze:replay": "node scripts/export-replay-timeline.js",
+    "analyze:ai-human-strategy": "node scripts/analyze-ai-human-strategy.js",
+    "repair:orphaned-game-logs": "node scripts/repair-orphaned-game-logs.js",
     "format": "prettier --write \"src/**/*.ts\"",
     "format:check": "prettier --check \"src/**/*.ts\"",
     "lint": "eslint src/**/*.ts",
@@ -19,7 +24,6 @@
   "dependencies": {
     "astriarch-engine": "workspace:*",
     "async": "^3.2.4",
-    "config": "^3.3.9",
     "connect-mongo": "^5.1.0",
     "cookie": "^1.0.2",
     "cookie-parser": "^1.4.6",
@@ -36,7 +40,6 @@
   },
   "devDependencies": {
     "@types/async": "^3.2.24",
-    "@types/config": "^3.3.3",
     "@types/cookie": "^1.0.0",
     "@types/cookie-parser": "^1.4.6",
     "@types/cookie-signature": "^1.1.2",