chore: remove em dashes from text and comments

.env.example

@@ -1,5 +1,5 @@
 # =================================================================
-# ChessKernel — Environment Variables
+# ChessKernel: Environment Variables
 # Copy this file to .env and fill in your values before starting.
 # =================================================================
 

CONTRIBUTING.md

@@ -11,15 +11,15 @@ Thank you for considering a contribution!
 ## What to Work On
 
 - Check open [GitHub Issues](https://github.com/mateuseap/chesskernel/issues).
-- Feature requests are welcome — open an issue to discuss before implementing.
+- Feature requests are welcome: open an issue to discuss before implementing.
 - Bug reports: please include steps to reproduce, expected vs. actual behaviour, and browser/OS.
 
 ## Code Style
 
-- TypeScript strict mode — no `any` unless absolutely necessary.
+- TypeScript strict mode, no `any` unless absolutely necessary.
 - No `console.log` in production paths.
 - Keep files under 800 lines; prefer many focused modules.
-- No mutation — use spread / immutable patterns.
+- No mutation: use spread / immutable patterns.
 - Conventional Commits format for all commit messages.
 
 ## Pull Request Process

client/src/app/globals.css

@@ -4,7 +4,7 @@
 
 @layer base {
   :root {
-    /* Light — warm cream, chess.com-inspired */
+    /* Light: warm cream, chess.com-inspired */
     --background: 40 25% 93%;
     --foreground: 225 25% 13%;
     --card: 0 0% 100%;
@@ -28,7 +28,7 @@
   }
 
   .dark {
-    /* Dark — deep navy, chess.com dark-inspired */
+    /* Dark: deep navy, chess.com dark-inspired */
     --background: 225 16% 12%;
     --foreground: 220 14% 90%;
     --card: 224 16% 17%;
@@ -70,7 +70,7 @@
   }
 }
 
-/* Illegal move — chess.com-style shake + red glow */
+/* Illegal move: chess.com-style shake + red glow */
 @keyframes illegal-shake {
   0%   { transform: translateX(0); }
   14%  { transform: translateX(-6px); }
@@ -99,7 +99,7 @@
   100% { opacity: 0; }
 }
 
-/* Feature carousel — infinite horizontal scroll, pauses on hover */
+/* Feature carousel: infinite horizontal scroll, pauses on hover */
 @keyframes carousel-scroll {
   from { transform: translateX(0); }
   to   { transform: translateX(-50%); }

client/src/components/chess/ChessBoard.tsx

@@ -17,7 +17,7 @@ const CLS: Record<string, { bg: string; text: string; icon: string; sqColor: str
   miss:       { bg: '#ca3431', text: '#fff', icon: '×',   sqColor: 'rgba(202,52,49,0.45)' },
 };
 
-// Standalone classification badge — its own SVG overlay, independent of arrows
+// Standalone classification badge: its own SVG overlay, independent of arrows
 function ClassificationBadge({
   square, cls, orientation,
 }: {
@@ -277,7 +277,7 @@ export function ChessBoard({
     return `${'abcdefgh'[col]}${row + 1}`;
   }, [orientation]);
 
-  // Right-click arrow drawing — capture phase so react-chessboard doesn't see right-clicks
+  // Right-click arrow drawing: capture phase so react-chessboard doesn't see right-clicks
   useEffect(() => {
     const el = boardRef.current;
     if (!el) return;
@@ -408,7 +408,7 @@ export function ChessBoard({
         orientation={orientation}
       />
 
-      {/* Classification badge — standalone SVG, not coupled to arrows */}
+      {/* Classification badge: standalone SVG, not coupled to arrows */}
       {lastMove?.to && moveClassification && (
         <ClassificationBadge
           square={lastMove.to}

client/src/components/chess/MaterialCount.tsx

@@ -3,7 +3,7 @@ import { PieceIcon } from './PieceIcon';
 const PIECE_VALUES: Record<string, number> = { p: 1, n: 3, b: 3, r: 5, q: 9 };
 const STARTING: Record<string, number>     = { p: 8, n: 2, b: 2, r: 2, q: 1 };
 
-// Highest-value pieces first — chess.com display order
+// Highest-value pieces first, chess.com display order
 const ORDER = ['q', 'r', 'b', 'n', 'p'] as const;
 
 export interface MaterialInfo {

client/src/components/chess/PieceIcon.tsx

@@ -1,4 +1,4 @@
-// Cburnett chess pieces (CC BY-SA 3.0, Wikimedia) — same set as react-chessboard.
+// Cburnett chess pieces (CC BY-SA 3.0, Wikimedia), same set as react-chessboard.
 // Extracted from the react-chessboard bundle and rendered as inline SVG at any size.
 
 type PieceType = 'p' | 'n' | 'b' | 'r' | 'q';

client/src/pages/AnalysisPage.tsx

@@ -102,7 +102,7 @@ function EvalBar({ cp, mate }: { cp: number | null; mate: number | null }) {
         }}
       />
 
-      {/* Score — vertical text, pinned to the far end of the winning colour */}
+      {/* Score: vertical text, pinned to the far end of the winning colour */}
       <div
         className="absolute left-0 right-0 flex justify-center items-center pointer-events-none z-10"
         style={whiteWinning ? { bottom: 5 } : { top: 5 }}
@@ -266,7 +266,7 @@ export function AnalysisPage() {
         </button>
         <div className="min-w-0">
           <h1 className="font-bold text-lg leading-tight truncate">{white} vs {black}</h1>
-          <p className="text-xs text-muted-foreground">{game.result ?? '—'} · {game.timeControl ?? t('analysis.title')}</p>
+          <p className="text-xs text-muted-foreground">{game.result ?? '-'} · {game.timeControl ?? t('analysis.title')}</p>
         </div>
       </div>
 
@@ -408,7 +408,7 @@ export function AnalysisPage() {
             </div>
           </div>
 
-          {/* Move list — chess.com style */}
+          {/* Move list: chess.com style */}
           <div className="bg-card border border-border rounded-xl overflow-hidden">
             <div className="px-4 py-2.5 border-b border-border bg-muted/30 flex items-center gap-2">
               <span className="font-semibold text-sm">{t('analysis.moves')}</span>

client/src/pages/GamePage.tsx

@@ -112,7 +112,7 @@ export function GamePage() {
   }, [gameId, chess, applyMoveOptimistic, revertOptimistic, triggerIllegalFlash]);
 
   // When king is selected and user clicks/drops on own rook, remap to castling destination.
-  // chess.com supports this "king captures rook" convention; chess.js does not — we handle it.
+  // chess.com supports this "king captures rook" convention; chess.js does not, so we handle it.
   const resolveCastleTarget = useCallback((from: Sq, to: Sq): Sq => {
     const movingPiece = chess.get(from as Square);
     const targetPiece = chess.get(to as Square);

client/src/pages/HomePage.tsx

@@ -70,7 +70,7 @@ export function HomePage() {
             </div>
           </div>
 
-          {/* Chess board — real piece images via react-chessboard */}
+          {/* Chess board: real piece images via react-chessboard */}
           <div className="shrink-0 relative" style={{ pointerEvents: 'none', userSelect: 'none', width: 300 }}>
             <div
               className="absolute rounded-3xl opacity-20 blur-3xl"
@@ -94,7 +94,7 @@ export function HomePage() {
         </div>
       </section>
 
-      {/* Features — infinite-scroll carousel, pauses on hover */}
+      {/* Features: infinite-scroll carousel, pauses on hover */}
       <section className="py-20 border-t border-border">
         <div className="px-4 max-w-5xl mx-auto text-center mb-12">
           <h2 className="text-3xl font-black tracking-tight mb-3">{t('home.featuresTitle')}</h2>

docs/adr/001-technology-stack.md

@@ -11,15 +11,15 @@ ChessKernel must be fully self-hosted with no paid third-party dependencies. The
 
 ### Backend: NestJS over Express/Fastify
 
-NestJS provides dependency injection, module isolation, built-in WebSocket gateway, Swagger integration, and class-validator — all of which map directly to our feature set. The structure enforces the modular architecture we require.
+NestJS provides dependency injection, module isolation, built-in WebSocket gateway, Swagger integration, and class-validator, all of which map directly to our feature set. The structure enforces the modular architecture we require.
 
 ### ORM: Prisma over TypeORM/Drizzle
 
 Prisma's type-safe client, excellent migration tooling, and schema-first approach reduce runtime errors. TypeORM has well-known N+1 issues and weaker type inference.
 
 ### Realtime: Socket.IO over raw WebSocket
 
-Socket.IO provides rooms, namespaces, automatic reconnection, and a Redis adapter for horizontal scaling — all needed without additional infrastructure.
+Socket.IO provides rooms, namespaces, automatic reconnection, and a Redis adapter for horizontal scaling, all needed without additional infrastructure.
 
 ### Chess Rules: chess.js (no alternatives)
 

docs/adr/002-game-state-authority.md

@@ -25,7 +25,7 @@ The server manages both clocks. Clock state is stored in Redis with millisecond
 
 ## Consequences
 
-- Every move requires a round-trip — no purely local game progression
+- Every move requires a round-trip, with no purely local game progression
 - Server must handle move validation at WebSocket message rate
 - Reconnecting clients receive full game state from Redis/DB
 - Spectators see the same authoritative state as players

docs/api/api-contracts.md

@@ -34,7 +34,7 @@ Create a new account.
 ```json
 { "email": "alice@example.com", "password": "s3cr3t!" }
 ```
-**Response 200** — same shape as register.
+**Response 200**: same shape as register.
 
 ---
 
@@ -45,14 +45,14 @@ Rotate token pair. Send current refresh token.
 ```json
 { "refreshToken": "<opaque>" }
 ```
-**Response 200** — new `accessToken` + `refreshToken`.
+**Response 200**: new `accessToken` + `refreshToken`.
 
 ---
 
 ### `POST /auth/logout` 🔒
 Revoke current refresh token.
 
-**Response 204** — no body.
+**Response 204**: no body.
 
 ---
 
@@ -98,7 +98,7 @@ Update own profile.
 ```json
 { "bio": "Chess enthusiast", "avatarUrl": "https://...", "country": "BR" }
 ```
-**Response 200** — updated user object.
+**Response 200**: updated user object.
 
 ---
 
@@ -256,14 +256,14 @@ Send a friend request.
 ```json
 { "username": "bob" }
 ```
-**Response 201** — friendship record.
+**Response 201**: friendship record.
 
 ---
 
 ### `POST /friends/:id/accept` 🔒
 Accept a pending request.
 
-**Response 200** — updated friendship.
+**Response 200**: updated friendship.
 
 ---
 
@@ -296,7 +296,7 @@ Create an open invite (generates a shareable token).
 ---
 
 ### `GET /invitations/:token`
-Get invite details (public — no auth required).
+Get invite details (public, no auth required).
 
 ---
 
@@ -380,7 +380,7 @@ io('https://<host>', { auth: { token: '<access_token>' } })
 
 | Event | Payload | Description |
 |-------|---------|-------------|
-| `queue:matched` | `{ gameId }` | Match found — navigate to game |
+| `queue:matched` | `{ gameId }` | Match found, navigate to game |
 | `game:start` | `{ gameId, white, black, timeControl, ... }` | Game started |
 | `game:move:broadcast` | `{ move, fen, clock }` | Opponent played a move |
 | `game:move:rejected` | `{ reason }` | Server rejected your move |

docs/architecture/system-design.md

@@ -41,7 +41,7 @@ ZADD matchmaking:{timeControl} {rating} {userId}
 ```
 
 - One sorted set per time control (bullet_1_0, blitz_3_2, rapid_10_0, etc.)
-- Rating is the Z-score — enables O(log n) range queries
+- Rating is the Z-score, which enables O(log n) range queries
 - Polling interval: 500ms worker checks for compatible players
 
 ### Match Algorithm
@@ -141,26 +141,26 @@ Move classification thresholds (centipawn drop from best move):
 | Classification | CP Drop |
 |----------------|---------|
 | Brilliant | engine says sub-optimal but tactically sharp |
-| Best / Excellent | 0–10 |
-| Good | 10–25 |
-| Inaccuracy | 25–100 |
-| Mistake | 100–300 |
+| Best / Excellent | 0-10 |
+| Good | 10-25 |
+| Inaccuracy | 25-100 |
+| Mistake | 100-300 |
 | Blunder | >300 |
 | Book | matches opening book |
 
 ## WebSocket Event System
 
 ### Namespaces
 
-- `/game` — active game events
-- `/matchmaking` — queue and match events
-- `/notifications` — friend requests, invitations, alerts
+- `/game`: active game events
+- `/matchmaking`: queue and match events
+- `/notifications`: friend requests, invitations, alerts
 
 ### Room Structure
 
-- `game:{gameId}` — players and spectators of a game
-- `user:{userId}` — private user channel
-- `leaderboard` — live leaderboard updates
+- `game:{gameId}`: players and spectators of a game
+- `user:{userId}`: private user channel
+- `leaderboard`: live leaderboard updates
 
 ### Key Events
 
@@ -183,7 +183,7 @@ Move classification thresholds (centipawn drop from best move):
 | `game:{id}:state` | Hash | 2h | Active game FEN + clocks |
 | `game:{id}:players` | Hash | 2h | Player socket IDs |
 | `user:{id}:session` | String | 7d | JWT refresh token |
-| `matchmaking:{tc}` | ZSet | — | Matchmaking queue |
+| `matchmaking:{tc}` | ZSet | - | Matchmaking queue |
 | `leaderboard:{tc}` | ZSet | 5m | Cached ranking |
 | `user:{id}:online` | String | 30s | Online presence (heartbeat) |
 

docs/backend/backend-architecture.md

@@ -4,7 +4,7 @@
 
 ```
 server/src/
-├── app.module.ts          # Root module — wires everything together
+├── app.module.ts          # Root module: wires everything together
 ├── main.ts                # Bootstrap: NestJS app, Prisma hooks, validation pipe
 ├── common/                # Guards, decorators, interceptors, filters
 │   ├── guards/            # JwtAuthGuard, WsAuthGuard
@@ -110,7 +110,7 @@ stateDiagram-v2
     ABANDONED --> [*]
 ```
 
-Active game state is cached in Redis (`game:{id}`) for O(1) reconnect. PostgreSQL is authoritative — Redis is repopulated from DB on cache miss.
+Active game state is cached in Redis (`game:{id}`) for O(1) reconnect. PostgreSQL is authoritative; Redis is repopulated from DB on cache miss.
 
 ## Matchmaking
 
@@ -153,10 +153,10 @@ Move classification thresholds (centipawn eval drop from best move):
 | Classification | CP Drop |
 |----------------|---------|
 | Brilliant | sub-optimal but tactically sharp (heuristic) |
-| Best / Excellent | 0–10 |
-| Good | 10–25 |
-| Inaccuracy | 25–100 |
-| Mistake | 100–300 |
+| Best / Excellent | 0-10 |
+| Good | 10-25 |
+| Inaccuracy | 25-100 |
+| Mistake | 100-300 |
 | Blunder | >300 |
 | Book | matches opening book |