First agent pass

.github/workflows/cs.yml

@@ -0,0 +1,29 @@
+name: Run CS on pull requests
+
+on:
+  pull_request:
+    types: [opened, synchronize, reopened, ready_for_review]
+
+jobs:
+  cs:
+    name: Run composer cs
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        php-version: ['8.3']
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: shivammathur/setup-php@v2
+        with:
+          php-version: ${{ matrix.php-version }}
+
+      - name: Install dependencies
+        run: composer install --prefer-dist --no-progress --no-suggest
+
+      - name: Run CS script
+        run: composer run-script cs
+
+      - name: Run unit tests
+        run: composer run-script unit

Design Docs/02-backend-architecture.md

@@ -1024,51 +1024,50 @@ backend-php/
 │   └── server.php
 ├── src/
 │   ├── Server/
-│   │   ├── HttpServer.php
-│   │   ├── WebSocketServer.php
-│   │   └── Router.php
+│   │   ├── Http.php
+│   │   ├── WebSocket.php
 │   ├── Auth/
-│   │   ├── AuthHandler.php
+│   │   ├── Handler.php
 │   │   ├── TokenService.php
-│   │   └── AuthMiddleware.php
+│   │   └── Middleware.php
 │   ├── Account/
-│   │   ├── AccountHandler.php
-│   │   ├── AccountService.php
-│   │   └── AccountRepository.php
+│   │   ├── Handler.php
+│   │   ├── Service.php
+│   │   └── Repository.php
 │   ├── Character/
-│   │   ├── CharacterHandler.php
-│   │   ├── CharacterService.php
-│   │   └── CharacterRepository.php
+│   │   ├── Handler.php
+│   │   ├── Service.php
+│   │   └── Repository.php
 │   ├── Contract/
-│   │   ├── ContractHandler.php
-│   │   ├── ContractService.php
-│   │   ├── ContractRepository.php
-│   │   ├── ContractResolver.php
-│   │   └── ContractTypes.php
+│   │   ├── Handler.php
+│   │   ├── Service.php
+│   │   ├── Repository.php
+│   │   ├── Resolver.php
+│   │   └── Types.php
 │   ├── Research/
-│   │   ├── ResearchHandler.php
-│   │   ├── ResearchService.php
+│   │   ├── Handler.php
+│   │   ├── Service.php
 │   │   ├── TrialService.php
-│   │   └── ResearchRepository.php
+│   │   └── Repository.php
 │   ├── World/
-│   │   ├── WorldHandler.php
-│   │   ├── WorldTicker.php
+│   │   ├── Handler.php
+│   │   ├── Ticker.php
 │   │   ├── ZoneService.php
 │   │   ├── BuildingService.php
 │   │   └── ManaService.php
 │   ├── Economy/
 │   │   ├── MarketHandler.php
 │   │   └── MarketService.php
 │   ├── Governance/
-│   │   ├── GovernanceHandler.php
+│   │   ├── Handler.php
 │   │   ├── ElectionService.php
 │   │   └── PolicyService.php
 │   ├── Raid/
-│   │   ├── RaidScheduler.php
-│   │   ├── RaidExecutor.php
-│   │   └── RaidScaling.php
+│   │   ├── Scheduler.php
+│   │   ├── Executor.php
+│   │   └── Scaling.php
 │   ├── Skill/
-│   │   └── SkillCalculator.php
+│   │   └── Calculator.php
 │   └── Database/
 │       ├── ConnectionPool.php
 │       └── TransactionHelper.php

Design Docs/03-frontend-architecture.md

@@ -292,11 +292,11 @@ export const governance = {
 type EventHandler = (data: any) => void
 
 class WebSocketManager {
-	private ws: WebSocket | null = null
-	private handlers: Map<string, Set<EventHandler>> = new Map()
-	private subscriptions: Set<string> = new Set()
-	private reconnectTimer: number | null = null
-	private url: string
+	protected ws: WebSocket | null = null
+	protected handlers: Map<string, Set<EventHandler>> = new Map()
+	protected subscriptions: Set<string> = new Set()
+	protected reconnectTimer: number | null = null
+	protected url: string
 
 	constructor(url: string) {
 		this.url = url
@@ -345,7 +345,7 @@ class WebSocketManager {
 		return () => this.handlers.get(eventType)?.delete(handler)
 	}
 
-	private scheduleReconnect(token: string) {
+	protected scheduleReconnect(token: string) {
 		if (this.reconnectTimer) return
 		this.reconnectTimer = setTimeout(() => {
 			this.reconnectTimer = null

composer.json

@@ -8,8 +8,11 @@
         }
     ],
     "require": {
-        "php": "^8.2.0",
-        "team-reflex/discord-php": "^10.45.22"
+        "php": "^8.3.0",
+        "team-reflex/discord-php": "^10.45.22",
+        "monolog/monolog": "^3.0",
+        "sharkk/router": "*",
+        "firebase/php-jwt": "^6.8"
     },
     "require-dev": {
         "symfony/var-dumper": "*",
@@ -22,7 +25,7 @@
     },
     "scripts": {
         "cs": ["./vendor/bin/php-cs-fixer fix"],
-        "unit": ["./vendor/bin/phpunit"]
+        "unit": ["./vendor/bin/pest"]
     },
     "minimum-stability": "dev",
     "prefer-stable": true,
@@ -34,7 +37,8 @@
     },
     "autoload": {
         "psr-4": {
-            "IA\\": "src/IA/"
+            "IA\\": "src/IA/",
+            "BackendPhp\\": "src/IA/backend/"
         }
     }
 }

src/IA/backend/Account/Handler.php

@@ -0,0 +1,32 @@
+<?php
+
+declare(strict_types=1);
+
+/*
+ * This file is a part of the In Absentia project.
+ *
+ * Copyright (c) 2026-present Valithor Obsidion <valithor@discordphp.org>
+ *
+ * This file is subject to the MIT license that is bundled
+ * with this source code in the LICENSE.md file.
+ */
+
+namespace BackendPhp\Account;
+
+use Psr\Http\Message\ServerRequestInterface;
+use React\Promise\PromiseInterface;
+
+class Handler
+{
+    protected Service $service;
+
+    public function __construct(Service $service)
+    {
+        $this->service = $service;
+    }
+
+    public function getAccount(ServerRequestInterface $request): PromiseInterface
+    {
+        return $this->service->getAccount($request->getAttribute('auth') ?? null);
+    }
+}

src/IA/backend/Account/Repository.php

@@ -0,0 +1,26 @@
+<?php
+
+declare(strict_types=1);
+
+/*
+ * This file is a part of the In Absentia project.
+ *
+ * Copyright (c) 2026-present Valithor Obsidion <valithor@discordphp.org>
+ *
+ * This file is subject to the MIT license that is bundled
+ * with this source code in the LICENSE.md file.
+ */
+
+namespace BackendPhp\Account;
+
+use React\Promise\PromiseInterface;
+use function React\Promise\resolve;
+
+class Repository
+{
+    public function findById(string $id): PromiseInterface
+    {
+        // Placeholder for async DB lookup.
+        return resolve(null);
+    }
+}

src/IA/backend/Account/Service.php

@@ -0,0 +1,35 @@
+<?php
+
+declare(strict_types=1);
+
+/*
+ * This file is a part of the In Absentia project.
+ *
+ * Copyright (c) 2026-present Valithor Obsidion <valithor@discordphp.org>
+ *
+ * This file is subject to the MIT license that is bundled
+ * with this source code in the LICENSE.md file.
+ */
+
+namespace BackendPhp\Account;
+
+use React\Promise\PromiseInterface;
+use function React\Promise\resolve;
+
+class Service
+{
+    protected Repository $repo;
+
+    public function __construct(Repository $repo)
+    {
+        $this->repo = $repo;
+    }
+
+    public function getAccount(?array $auth): PromiseInterface
+    {
+        // Return account object for authenticated user
+        $res = ['id' => $auth['sub'] ?? null, 'banked' => 0];
+
+        return resolve($res);
+    }
+}