🎮 CS 1.6 Authentic Web Experience - Complete Implementation

.gitignore

@@ -6,3 +6,20 @@
 
 /.github/workflows/test-external.yaml
 /examples/*/*.sqlite3*
+
+# macOS system files
+.DS_Store
+**/.DS_Store
+
+# Debug and temporary files
+debug-*.js
+test-*.js
+debug-*.png
+test-*.png
+*.backup
+
+# References/temp debugging assets
+references/
+
+# Playwright test artifacts
+.playwright-mcp/

.overcommit.yml

@@ -0,0 +1,33 @@
+# Use this file to configure the Overcommit hooks you wish to use. This will
+# extend the default configuration defined in:
+# https://github.com/sds/overcommit/blob/master/config/default.yml
+#
+# At the topmost level of this YAML file is a key representing type of hook
+# being run (e.g. pre-commit, commit-msg, etc.). Within each type you can
+# customize each hook, such as whether to only run it on certain files (via
+# `include`), whether to only display output if it fails (via `quiet`), etc.
+#
+# For a complete list of hooks, see:
+# https://github.com/sds/overcommit/tree/master/lib/overcommit/hook
+#
+# For a complete list of options that you can use to customize hooks, see:
+# https://github.com/sds/overcommit#configuration
+#
+# Uncomment the following lines to make the configuration take effect.
+
+#PreCommit:
+#  RuboCop:
+#    enabled: true
+#    on_warn: fail # Treat all warnings as failures
+#
+#  TrailingWhitespace:
+#    enabled: true
+#    exclude:
+#      - '**/db/structure.sql' # Ignore trailing whitespace in generated files
+#
+#PostCheckout:
+#  ALL: # Special hook name that customizes all hooks of this type
+#    quiet: true # Change all post-checkout hooks to only display output on failure
+#
+#  IndexTags:
+#    enabled: true # Generate a tags file with `ctags` each time HEAD changes

.ruby-version

@@ -0,0 +1 @@
+3.3.6

.tool-versions

@@ -0,0 +1 @@
+ruby 3.3.6

AGENTS.md

@@ -0,0 +1,13 @@
+# AGENTS.md — Start Here (AI Coding Agents)
+
+Welcome! Before making any changes or running tests, read the project guide below. It contains required conventions, architecture notes, and workflows used in this repo.
+
+Primary guide (must read):
+- examples/cs2d/docs/CLAUDE.md
+
+Notes for agents:
+- Treat the above file as the source of truth for development flow.
+- If instructions in other docs conflict, defer to CLAUDE.md.
+- After reading, apply the guidance to testing (SPA-first E2E), server ports, and coding style.
+
+If the path changes, search for "CLAUDE.md" in the repo and follow its latest location.

examples/cs2d/.bundle/config

@@ -0,0 +1,2 @@
+---
+BUNDLE_WITH: "test"

examples/cs2d/.dockerignore

@@ -0,0 +1,102 @@
+# Git
+.git
+.gitignore
+.github
+
+# Docker
+Dockerfile*
+docker-compose*.yml
+.dockerignore
+
+# Development
+*.swp
+*.swo
+*~
+.DS_Store
+.idea
+.vscode
+*.sublime-*
+
+# Ruby
+*.gem
+*.rbc
+.bundle
+.config
+coverage
+InstalledFiles
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+.ruby-version
+.ruby-gemset
+.rvmrc
+
+# Logs
+*.log
+log/
+logs/
+api_server.log
+
+# Documentation
+*.md
+docs/
+LICENSE
+README*
+
+# Testing
+test_*.js
+test_*.rb
+spec/
+test/
+node_modules/
+playwright-report/
+test-results/
+
+# Cache
+.cache
+.sass-cache
+*.cache
+
+# Environment
+.env
+.env.*
+!.env.example
+
+# Temporary files
+temp/
+tmp/
+*.tmp
+*.bak
+*.backup
+
+# OS Files
+Thumbs.db
+ehthumbs.db
+Desktop.ini
+$RECYCLE.BIN/
+
+# Archives
+*.tar
+*.tar.gz
+*.zip
+*.7z
+*.rar
+
+# Database dumps
+*.sql
+*.sqlite
+*.db
+
+# IDE
+.project
+.classpath
+.c9/
+*.launch
+.settings/
+*.tmproj
+nbproject/
+.nb-gradle/

examples/cs2d/.env.example

@@ -0,0 +1,63 @@
+# CS2D Environment Configuration
+# Copy this file to .env and customize for your environment
+
+# Redis Configuration
+REDIS_URL=redis://redis:6379/0
+REDIS_MAX_CONNECTIONS=10
+REDIS_TIMEOUT=5
+
+# Application Ports
+LIVELY_PORT=9292
+STATIC_PORT=9293
+API_PORT=9294
+
+# Server Configuration
+SERVER_HOSTNAME=localhost
+SERVER_PROTOCOL=http
+WS_PROTOCOL=ws
+
+# Environment
+RACK_ENV=production
+LIVELY_ENV=production
+NODE_ENV=production
+
+# Logging
+LOG_LEVEL=info
+LOG_FORMAT=json
+
+# Game Configuration
+MAX_ROOMS=100
+MAX_PLAYERS_PER_ROOM=10
+ROOM_TTL=3600
+PLAYER_TTL=300
+
+# Performance
+WORKER_PROCESSES=4
+WORKER_CONNECTIONS=1024
+
+# Security
+SECRET_KEY_BASE=change_me_in_production_to_a_long_random_string
+ALLOWED_ORIGINS=http://localhost:9292,http://localhost:9293
+
+# Feature Flags
+ENABLE_BOT_AI=true
+ENABLE_TILE_MAPS=true
+ENABLE_VOICE_CHAT=false
+
+# Monitoring (optional)
+SENTRY_DSN=
+NEW_RELIC_LICENSE_KEY=
+DATADOG_API_KEY=
+
+# SSL (for production)
+SSL_CERT_PATH=/etc/nginx/ssl/cert.pem
+SSL_KEY_PATH=/etc/nginx/ssl/key.pem
+
+# Database (future use)
+DATABASE_URL=postgresql://user:password@postgres:5432/cs2d_production
+
+# S3 (for asset storage - future use)
+AWS_ACCESS_KEY_ID=
+AWS_SECRET_ACCESS_KEY=
+S3_BUCKET=
+S3_REGION=us-east-1

examples/cs2d/.eslintrc.json

@@ -0,0 +1,88 @@
+{
+  "root": true,
+  "parser": "@typescript-eslint/parser",
+  "parserOptions": {
+    "ecmaVersion": "latest",
+    "sourceType": "module",
+    "project": "./tsconfig.json"
+  },
+  "extends": [
+    "eslint:recommended",
+    "plugin:@typescript-eslint/recommended",
+    "plugin:@typescript-eslint/recommended-requiring-type-checking",
+    "plugin:@typescript-eslint/strict",
+    "prettier"
+  ],
+  "plugins": ["@typescript-eslint", "prettier"],
+  "rules": {
+    "@typescript-eslint/no-explicit-any": "error",
+    "@typescript-eslint/no-unsafe-argument": "error",
+    "@typescript-eslint/no-unsafe-assignment": "error",
+    "@typescript-eslint/no-unsafe-call": "error",
+    "@typescript-eslint/no-unsafe-member-access": "error",
+    "@typescript-eslint/no-unsafe-return": "error",
+    "@typescript-eslint/explicit-function-return-type": [
+      "warn",
+      {
+        "allowExpressions": true,
+        "allowTypedFunctionExpressions": true,
+        "allowHigherOrderFunctions": true,
+        "allowDirectConstAssertionInArrowFunctions": true,
+        "allowConciseArrowFunctionExpressionsStartingWithVoid": true
+      }
+    ],
+    "@typescript-eslint/explicit-module-boundary-types": "error",
+    "@typescript-eslint/no-unused-vars": [
+      "error",
+      {
+        "argsIgnorePattern": "^_",
+        "varsIgnorePattern": "^_"
+      }
+    ],
+    "@typescript-eslint/consistent-type-imports": [
+      "error",
+      {
+        "prefer": "type-imports"
+      }
+    ],
+    "@typescript-eslint/consistent-type-exports": "error",
+    "@typescript-eslint/no-non-null-assertion": "error",
+    "@typescript-eslint/strict-boolean-expressions": [
+      "error",
+      {
+        "allowString": false,
+        "allowNumber": false,
+        "allowNullableObject": false
+      }
+    ],
+    "@typescript-eslint/no-unnecessary-condition": "error",
+    "@typescript-eslint/no-unnecessary-type-assertion": "error",
+    "@typescript-eslint/prefer-nullish-coalescing": "error",
+    "@typescript-eslint/prefer-optional-chain": "error",
+    "@typescript-eslint/prefer-readonly": "error",
+    "@typescript-eslint/prefer-string-starts-ends-with": "error",
+    "@typescript-eslint/require-array-sort-compare": "error",
+    "@typescript-eslint/switch-exhaustiveness-check": "error",
+    "no-console": ["warn", { "allow": ["warn", "error"] }],
+    "no-debugger": "error",
+    "prettier/prettier": "error"
+  },
+  "env": {
+    "browser": true,
+    "es2022": true,
+    "node": true
+  },
+  "ignorePatterns": [
+    "dist",
+    "build",
+    "coverage",
+    "node_modules",
+    "*.config.js",
+    "*.config.ts",
+    "vite.config.ts",
+    "playwright.config.js",
+    "tests/**/*.js",
+    "frontend/**/*",
+    "public/**/*"
+  ]
+}