wip: optimizations

server/AGENTS.md

@@ -0,0 +1,25 @@
+# Server Guidelines
+
+This directory contains the Node/TypeScript signaling server, server-directory API, and websocket runtime.
+
+## Workflow
+
+- Use `cd server && npm run dev`, `cd server && npm run build`, and `cd server && npm run start`, or the root aliases `npm run server:dev` and `npm run server:build`.
+- Start tracing behavior from `src/index.ts`, then follow into `src/app/`, `src/websocket/`, and the config or CQRS modules involved.
+- See `../doc/typescript.md` for shared TypeScript rules.
+
+## Boundaries
+
+- Keep bootstrap concerns in `src/index.ts` small and move request, websocket, or data behavior into focused modules.
+- Keep configuration and runtime path handling separate from transport or business logic.
+- Prefer explicit modules for HTTP, websocket, database, and configuration responsibilities instead of growing god files.
+
+## Config And Output
+
+- Server runtime config comes from the repository root `.env` and `server/data/variables.json`.
+- If `serverProtocol` is `https`, certificate files must exist before startup.
+- Treat `server/dist/` and bundled output under `dist-server/` as generated.
+
+## Before You Finish
+
+- Validate whether relevant markdown docs or `AGENTS.md` files need updates. If behavior, workflows, commands, or architecture changed, update those docs in the same task.