ci: bump version with Build-111

Co-authored-by: Janis <janis-e@gmx.de>
Reviewed-on: #59

.claude/commands/create-defect.md

@@ -1,88 +0,0 @@
-# Create Defect in YouTrack
-
-Automated defect creation workflow. Topic/hint: `$ARGUMENTS`
-
-## Step 1 — Gather Context
-
-Use `AskUserQuestion` tool to ask the user (max 4 questions at once):
-
-1. **Component** — Where does the bug occur? (e.g. move generation, FEN parsing, castling, UI, API)
-2. **What breaks** — What is the actual (broken) behavior?
-3. **Expected** — What should happen instead?
-4. **Reproducibility** — Is it always reproducible? Any known trigger conditions?
-
-If `$ARGUMENTS` already answers some of these, skip those questions.
-
-## Step 2 — Research (if needed)
-
-If the bug involves domain logic or rules:
-- Search repo for relevant code (`Grep`/`Bash`).
-- Check test files for existing coverage of the broken area.
-- Do NOT guess at root cause. Surface findings before drafting.
-
-## Step 3 — Draft Defect
-
-Compose the full defect report using this template:
-
-```
-Summary
-
-[One-sentence description of what is broken.]
-
-
-Steps to Reproduce
-
-1. Step one
-2. Step two
-3. Step three
-
-
-Expected Behavior
-
-[What should happen.]
-
-
-Actual Behavior
-
-[What actually happens.]
-
-
-Environment / Notes
-
-[Any relevant context: FEN positions, game conditions, config, browser, OS — only if applicable.]
-```
-
-Rules:
-- Steps must be minimal and reproducible.
-- Expected vs actual: concrete and unambiguous.
-- Omit "Environment / Notes" section if not relevant.
-
-## Step 4 — Clarify
-
-Show the draft to the user.
-**Use `AskUserQuestion` tool to ask:**
-- Are steps to reproduce complete and accurate?
-- Severity: Blocker / Critical / Major / Minor / Trivial?
-- Any related tickets or recent changes to link?
-
-Incorporate feedback. Repeat until user approves.
-
-## Step 5 — Determine Project
-
-- Frontend / UI / UX → project: `NCWF`
-- Backend / coordinator / systems / bot / engine → project: `NCS`
-
-If ambiguous, ask the user.
-
-## Step 6 — Create Issue
-
-Call `mcp__youtrack__create_issue` with:
-- `project`: determined in Step 5
-- `summary`: concise title describing what is broken (≤72 chars, sentence case)
-- `description`: full formatted defect report from Step 3 (Markdown)
-- `type`: `Bug`
-
-## Step 7 — Report
-
-Display the created issue ID and URL.
-Ask if a linked investigation or fix task is needed.

.claude/commands/create-story.md

@@ -66,17 +66,10 @@ Incorporate feedback. Repeat until user approves.
 
 ## Step 5 — Determine Project
 
-> **Project routing rules (always apply these):**
-> - Backend code (game engine, bots, API, services, coordinator) → `NCS`
-> - Frontend code (UI, UX, web app) → `NCWF`
-> - Infrastructure (Kubernetes, pipelines, CI/CD, DB setup, cloud infra) → `NCI`
-> - If ambiguous, ask the user.
-
 - Frontend / UI / UX → project: `NCWF`
 - Backend / coordinator / systems / bot / engine → project: `NCS`
-- Kubernetes, pipelines, CI/CD, DB setup, infrastructure → project: `NCI`
 
-If still ambiguous, ask the user.
+If ambiguous, ask the user.
 
 ## Step 6 — Create Issue
 
@@ -86,27 +79,7 @@ Call `mcp__youtrack__create_issue` with:
 - `description`: full formatted story from Step 3 (Markdown)
 - `type`: `Feature` (or `Task` if purely technical with no user-facing value)
 
-## Step 7 — Link Issues
-
-After creation, **automatically** ask the user (use `AskUserQuestion` if interactive, otherwise infer from context):
-
-> Are there related issues to link? (skip if none)
-
-Collect any issue IDs the user mentions. For each, determine the correct relation and call `mcp__youtrack__link_issues`:
-
-| Situation | Relation to use |
-|-----------|----------------|
-| This story must be done before another | `blocks` |
-| Another story must be done before this | `is blocked by` |
-| Stories share domain or are related | `relates to` |
-| This is a child of an epic/story | `subtask of` |
-| This is a parent grouping subtasks | `parent for` |
-| This depends on another ticket's output | `depends on` |
-
-If the user mentions an issue in the story description or implementation notes (e.g. "see NCS-42", "after NCS-12 is done"), auto-detect and suggest linking it — confirm before creating the link.
-
-## Step 8 — Report
+## Step 7 — Report
 
 Display the created issue ID and URL.
-List any links created (relation type + linked issue ID).
 Ask if a linked sub-task or implementation ticket is needed.

.claude/commands/fix-defect.md

@@ -39,16 +39,12 @@ After root cause confirmed, assess scope:
 To create subtasks:
 1. Break fix into discrete, independently-completable tasks (e.g. "Fix validation in RuleSet", "Add regression test for castling edge case", "Update FenParser to handle X").
 2. For each subtask call `mcp__youtrack__create_issue` with:
-   - `project`: based on subtask content — do **not** inherit from parent. Backend code → `NCS`; frontend/UI → `NCWF`; Kubernetes/pipelines/CI-CD/DB setup/infrastructure → `NCI`. If ambiguous, ask user.
+   - `project`: same project as parent ticket
    - `summary`: concise action-oriented title
    - `type`: `Task`
    - `description`: what to do and why
 3. Call `mcp__youtrack__link_issues` to link each subtask to `$ARGUMENTS` with relation `subtask of`.
-4. Check if the ticket description or comments mention other issue IDs. For each mentioned ID, suggest a link and confirm with user:
-   - Fix depends on another fix finishing first → `is blocked by`
-   - This fix blocks another ticket → `blocks`
-   - Logically related but independent → `relates to`
-5. List created subtask IDs and any additional links to user.
+4. List created subtask IDs to user.
 
 Then proceed to Step 4, implementing subtasks in order.
 
@@ -57,10 +53,7 @@ Then proceed to Step 4, implementing subtasks in order.
 1. Implement fix (use `scala-implementer` agent for non-trivial changes; inline edits for small ones).
 2. Run `./compile` — must be green.
 3. Run `./test` — must be green.
-4. Run `./gradlew spotlessScalaApply` — **blocking, foreground only**. Wait for completion before continuing.
-5. Run `./lint` — **blocking, foreground only** (never `run_in_background`). Wait for exit code 0. Must be green.
-   - If lint fails, fix all issues and re-run until exit code 0.
-   - **Do NOT proceed to Step 5 until `./lint` has completed and returned exit code 0.**
+4. Run `./lint` — must be green.
 If any step fails, iterate until all pass.
 
 ## Step 5 — Review
@@ -68,19 +61,6 @@ If any step fails, iterate until all pass.
 Spawn `cavecrew-reviewer` on the full diff.
 Display findings grouped by severity.
 
-## Step 5b — Apply Review Findings
-
-If the review produced any findings (any severity):
-1. Implement all agreed fixes.
-2. Run `./compile` — must be green.
-3. Run `./test` — must be green.
-4. Run `./gradlew spotlessScalaApply` — **blocking, foreground only**. Wait for completion.
-5. Run `./lint` — **blocking, foreground only**. Wait for exit code 0.
-   - If lint fails, fix all issues and re-run until exit code 0.
-6. Re-spawn `cavecrew-reviewer` on the updated diff to confirm all findings are resolved.
-
-Repeat until review is clean or user explicitly accepts remaining findings.
-
 ## Step 6 — Confirm + Push
 
 Show summary: ticket, branch, files changed, review findings.
@@ -118,23 +98,7 @@ Files changed:
 - <file2>
 ```
 
-## Step 7b — Additional Links
-
-After commenting, ask the user if `$ARGUMENTS` should be linked to any other issues not already linked:
-
-| Situation | Relation |
-|-----------|---------|
-| This fix blocks another open ticket | `blocks` |
-| Another ticket must ship first | `is blocked by` |
-| Related defect or story | `relates to` |
-| Duplicate of another defect | `duplicates` |
-
-Scan the ticket description and comments for any issue IDs that were mentioned but not yet linked. Suggest those automatically.
-
-Call `mcp__youtrack__link_issues` for each confirmed link.
-
 ## Step 8 — Cleanup
 
-Call `ExitWorktree` with `discard_changes: true` to delete the worktree.
-(Branch was pushed in step 6 — commits are safe on remote; `discard_changes: true` bypasses the local-ahead guard.)
-Report: branch pushed, ticket commented, links created, worktree deleted, done.
+Call `ExitWorktree` to delete the worktree.
+Report: branch pushed, ticket commented, worktree deleted, done.

.claude/commands/implement-feature.md

@@ -33,10 +33,7 @@ All subsequent file work happens inside this worktree.
 1. Implement feature (use `scala-implementer` agent for non-trivial changes; inline edits for small ones).
 2. Run `./compile` — must be green.
 3. Run `./test` — must be green (add new tests for new behaviour; do not modify existing tests unless requirements changed).
-4. Run `./gradlew spotlessScalaApply` — **blocking, foreground only**. Wait for completion before continuing.
-5. Run `./lint` — **blocking, foreground only** (never `run_in_background`). Wait for exit code 0. Must be green.
-   - If lint fails, fix all issues and re-run until exit code 0.
-   - **Do NOT proceed to Step 5 until `./lint` has completed and returned exit code 0.**
+4. Run `./lint` — must be green.
 If any step fails, iterate until all pass.
 
 ## Step 5 — Review
@@ -44,19 +41,6 @@ If any step fails, iterate until all pass.
 Spawn `cavecrew-reviewer` on the full diff.
 Display findings grouped by severity.
 
-## Step 5b — Apply Review Findings
-
-If the review produced any findings (any severity):
-1. Implement all agreed fixes.
-2. Run `./compile` — must be green.
-3. Run `./test` — must be green.
-4. Run `./gradlew spotlessScalaApply` — **blocking, foreground only**. Wait for completion.
-5. Run `./lint` — **blocking, foreground only**. Wait for exit code 0.
-   - If lint fails, fix all issues and re-run until exit code 0.
-6. Re-spawn `cavecrew-reviewer` on the updated diff to confirm all findings are resolved.
-
-Repeat until review is clean or user explicitly accepts remaining findings.
-
 ## Step 6 — Confirm + Push
 
 Show summary: ticket, branch, files changed, review findings.
@@ -96,6 +80,5 @@ Files changed:
 
 ## Step 8 — Cleanup
 
-Call `ExitWorktree` with `discard_changes: true` to delete the worktree.
-(Branch was pushed in step 6 — commits are safe on remote; `discard_changes: true` bypasses the local-ahead guard.)
+Call `ExitWorktree` to delete the worktree.
 Report: branch pushed, ticket commented, worktree deleted, done.

.claude/commands/split-story.md

@@ -59,15 +59,11 @@ Rules:
 - Definition of Done: adjust per subtask — not all subtasks need the same criteria (e.g. a research spike has different DoD than an implementation task).
 - Keep description short — one paragraph max.
 
-## Step 5 — Determine Project per Subtask
+## Step 5 — Determine Project
 
-Assign each subtask's project based on its content — do **not** inherit blindly from parent:
-
-- Backend code (game engine, bots, API, services, coordinator) → `NCS`
-- Frontend code (UI, UX, web app) → `NCWF`
-- Kubernetes, pipelines, CI/CD, DB setup, infrastructure → `NCI`
-
-If a subtask's project is ambiguous, ask the user before creating it.
+Inherit project from parent story (`$ARGUMENTS`):
+- If parent is `NCWF-*` → subtasks go in `NCWF`
+- If parent is `NCS-*` → subtasks go in `NCS`
 
 ## Step 6 — Create Subtasks
 
@@ -79,31 +75,8 @@ For each subtask call `mcp__youtrack__create_issue` with:
 
 Then call `mcp__youtrack__link_issues` to link each created subtask to `$ARGUMENTS` with relation `subtask of`.
 
-## Step 6b — Inter-Subtask Links
-
-If subtasks must be done in sequence (one depends on output of another), add ordering links:
-- For each dependency pair call `mcp__youtrack__link_issues` with relation `is blocked by` (subtask B is blocked by subtask A).
-
-Ask the user to confirm sequencing before adding these links:
-
-> Do any subtasks have ordering dependencies? (e.g. "Implement X must come before Add tests for X")
-
-## Step 6c — External Links
-
-Scan `$ARGUMENTS` description and implementation notes for any referenced issue IDs not already linked. For each:
-
-| Situation | Relation |
-|-----------|---------|
-| Parent story blocks another epic/story | `blocks` |
-| Story depends on another epic completing | `is blocked by` |
-| Related story in same domain | `relates to` |
-| This story duplicates or supersedes | `duplicates` |
-
-Suggest links to the user and call `mcp__youtrack__link_issues` on confirmation.
-
 ## Step 7 — Report
 
 List all created subtask IDs and summaries.
-List all links created (subtask-of, blocking chains, external).
 Display parent story link.
 Ask if any subtask needs further splitting.

.github/workflows/analytics-image.yml

@@ -1,130 +0,0 @@
-name: Build & Push Analytics Image
-
-on:
-  push:
-    branches:
-      - main
-    paths:
-      - 'modules/analytics/**'
-  workflow_dispatch:
-
-jobs:
-  check-actor:
-    runs-on: ubuntu-latest
-    outputs:
-      allowed: ${{ steps.check.outputs.allowed }}
-    steps:
-      - uses: actions/checkout@v4
-        with:
-          fetch-depth: 1
-
-      - id: check
-        run: |
-          if [[ "${{ github.event_name }}" == "workflow_dispatch" ]]; then
-            echo "Triggered manually — allowing build"
-            echo "allowed=true" >> "$GITHUB_OUTPUT"
-          else
-            COMMIT_AUTHOR=$(git log -1 --format='%an')
-            COMMIT_SHA=$(git log -1 --format='%H')
-            COMMIT_MSG=$(git log -1 --format='%s')
-            echo "Commit: ${COMMIT_SHA}"
-            echo "Author: ${COMMIT_AUTHOR}"
-            echo "Message: ${COMMIT_MSG}"
-            if [[ "$COMMIT_AUTHOR" == "TeamCity" ]]; then
-              echo "Author is TeamCity — allowing build"
-              echo "allowed=true" >> "$GITHUB_OUTPUT"
-            else
-              echo "Author is not TeamCity — skipping build"
-              echo "allowed=false" >> "$GITHUB_OUTPUT"
-            fi
-          fi
-
-  build-and-push:
-    needs: check-actor
-    if: needs.check-actor.outputs.allowed == 'true'
-    runs-on: ubuntu-latest
-    permissions:
-      contents: read
-      packages: write
-
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Read version from versions.env
-        id: version
-        run: |
-          source modules/analytics/versions.env
-          echo "version=${MAJOR}.${MINOR}.${PATCH}" >> "$GITHUB_OUTPUT"
-
-      - name: Check if image exists in GHCR
-        id: image-check
-        env:
-          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        run: |
-          PACKAGE="now-chess-systems%2Fanalytics"
-          VERSION="${{ steps.version.outputs.version }}"
-          EXISTING_TAGS=$(gh api "orgs/now-chess/packages/container/${PACKAGE}/versions" \
-            --jq '.[].metadata.container.tags[]' 2>/dev/null || echo "")
-          echo "Existing tags: $(echo "${EXISTING_TAGS}" | tr '\n' ' ' | xargs)"
-          if echo "${EXISTING_TAGS}" | grep -qx "${VERSION}"; then
-            echo "Image ${VERSION} already exists — skipping build"
-            echo "exists=true" >> "$GITHUB_OUTPUT"
-          else
-            echo "Image ${VERSION} not found — will build"
-            echo "exists=false" >> "$GITHUB_OUTPUT"
-          fi
-
-      - name: Set up JDK 17
-        if: steps.image-check.outputs.exists == 'false'
-        uses: actions/setup-java@v4
-        with:
-          java-version: '17'
-          distribution: 'temurin'
-
-      - name: Cache Gradle packages
-        if: steps.image-check.outputs.exists == 'false'
-        uses: actions/cache@v4
-        with:
-          path: |
-            ~/.gradle/caches
-            ~/.gradle/wrapper
-          key: gradle-${{ runner.os }}-${{ hashFiles('**/*.gradle*', '**/gradle-wrapper.properties') }}
-          restore-keys: gradle-${{ runner.os }}-
-
-      - name: Build fat jar
-        if: steps.image-check.outputs.exists == 'false'
-        run: ./gradlew :modules:analytics:jar --no-daemon
-
-      - name: Set up Docker Buildx
-        if: steps.image-check.outputs.exists == 'false'
-        uses: docker/setup-buildx-action@v3
-
-      - name: Log in to GitHub Container Registry
-        if: steps.image-check.outputs.exists == 'false'
-        uses: docker/login-action@v3
-        with:
-          registry: ghcr.io
-          username: ${{ github.actor }}
-          password: ${{ secrets.GITHUB_TOKEN }}
-
-      - name: Extract metadata
-        if: steps.image-check.outputs.exists == 'false'
-        id: meta
-        uses: docker/metadata-action@v5
-        with:
-          images: ghcr.io/now-chess/now-chess-systems/analytics
-          tags: |
-            type=raw,value=${{ steps.version.outputs.version }}
-            type=raw,value=latest
-
-      - name: Build and push
-        if: steps.image-check.outputs.exists == 'false'
-        uses: docker/build-push-action@v6
-        with:
-          context: modules/analytics
-          file: modules/analytics/src/main/docker/Dockerfile
-          push: true
-          tags: ${{ steps.meta.outputs.tags }}
-          labels: ${{ steps.meta.outputs.labels }}
-          cache-from: type=gha
-          cache-to: type=gha,mode=max

.github/workflows/native-image.yml

@@ -49,7 +49,6 @@ jobs:
       matrix:
         module:
           - account
-          - analysis
           - bot-platform
           - coordinator
           - core
@@ -57,7 +56,6 @@ jobs:
           - official-bots
           - rule
           - store
-          - tournament
           - ws
         arch:
           - name: default
@@ -127,7 +125,7 @@ jobs:
           if [ -n "$MARCH" ]; then
             MARCH_ARG="-Dquarkus.native.additional-build-args=$MARCH"
           fi
-          ./gradlew :modules:${{ matrix.module }}:build -x test -x spotlessScalaCheck -x checkScalafix -Dquarkus.native.enabled=true -Dquarkus.package.jar.enabled=false -Dquarkus.profile=deployed $MARCH_ARG --no-daemon
+          ./gradlew :modules:${{ matrix.module }}:build -x test -Dquarkus.native.enabled=true -Dquarkus.package.jar.enabled=false -Dquarkus.profile=deployed $MARCH_ARG --no-daemon
 
       - name: Set up Docker Buildx
         if: steps.image-check.outputs.exists == 'false'

.gitignore

@@ -48,13 +48,8 @@ graphify-out/
 .DS_Store
 /jacoco-reporter/.venv/
 /.claude/settings.local.json
-/.claude/worktrees/
 modules/tournament/src/main/resources/keys/dev-public.pem
 modules/account/src/main/resources/keys/dev-private.pem
 modules/account/src/main/resources/keys/dev-public.pem
 modules/core/src/main/resources/keys/dev-public.pem
-*.hprof
-
-### Embedded repos (not submodules) ###
-GitOps/
-frontend/
+java_pid2736.hprof

CLAUDE.md

@@ -57,14 +57,6 @@ Use consistently.
 - **Tests are the spec.** Don't modify to pass. Fix requirements/code. Update only if requirements change.
 - Never read build folders. Ask permission if needed.
 - Keep file current with decisions + conventions.
-- **NativeReflectionConfig (mandatory):** Every new type (class, case class, enum, sealed trait — anything serialized) must be registered in the `NativeReflectionConfig` of **every module that interacts with it**. Configs live at:
-  - `modules/account/src/main/scala/de/nowchess/account/config/NativeReflectionConfig.scala`
-  - `modules/coordinator/src/main/scala/de/nowchess/coordinator/config/NativeReflectionConfig.scala`
-  - `modules/core/src/main/scala/de/nowchess/chess/config/NativeReflectionConfig.scala`
-  - `modules/io/src/main/scala/de/nowchess/io/service/config/NativeReflectionConfig.scala`
-  - `modules/rule/src/main/scala/de/nowchess/rules/config/NativeReflectionConfig.scala`
-  - `modules/store/src/main/scala/de/nowchess/store/config/NativeReflectionConfig.scala`
-  - `modules/ws/src/main/scala/de/nowchess/ws/config/NativeReflectionConfig.scala`
 
 ---
 

build.gradle.kts

@@ -53,8 +53,6 @@ val coverageExclusions = listOf(
     "**/core/src/main/scala/de/nowchess/chess/resource/GameWebSocketResource.scala",
     // Coordinator infrastructure — gRPC, microservice orchestration
     "**/coordinator/src/main/scala/**",
-    // Analytics module — standalone Spark batch jobs; coverage not applicable (no Quarkus, no scoverage plugin)
-    "modules/analytics/**",
 )
 
 // Converts a Sonar-style glob to a scoverage regex (matched against full source path).

modules/account/CHANGELOG.md

@@ -382,273 +382,3 @@
 
 * Revert "feat: add authentication permissions for metrics endpoints in application.yml" ([a298417](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/a298417b9e4d68dc73bbf40be63d9484536e9f83))
 * Revert "refactor: update metrics paths formatting in application.yml for clarity" ([3870566](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/38705663498d5f47c40dafe2f26198589ede8656))
-##  (2026-06-05)
-
-### Features
-
-* **account:** implement token pair handling for login and refresh endpoints ([9296db8](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/9296db88b7131bbda9b9b0da65c327ef9063ee31))
-* add authentication permissions for metrics endpoints in application.yml ([04edd4d](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/04edd4d6fd8a63196c36f6d67992832febc9bebb))
-* add initialization metrics for various services ([d438e97](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/d438e97f32bdde0bfc63c1b4a8cc810cdd093166))
-* add OpenTelemetry trace configuration with parentbased sampler ([3904d5a](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/3904d5ad8ad4930ddee65287a7bfab785a6148f5))
-* **api:** define shared EventEnvelope and EventType for Redis EventBus ([#61](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/61)) ([595c172](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/595c172900da99de367c274488c3ccbeaef55882))
-* **config:** add H2 database configuration for testing environment ([39c9e49](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/39c9e492cef2515368c074da9406f95e9c0c9e64))
-* **config:** update application.yml for PostgreSQL and remove staging/production configurations ([2404e61](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/2404e6164c3b50ffccbea5238d636060d6abe4d6))
-* **config:** update application.yml for staging and production environments ([6113432](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/6113432a14c476a3a0dfc0d449e17d023697f2ba))
-* configure logging and add OpenTelemetry support ([#49](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/49)) ([d57c488](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/d57c4886612d1d92da0e1b79209fc83e6ef537a1))
-* **docker:** add .dockerignore and .gitignore files for build exclusions ([c987d8e](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/c987d8e258c0e6c4cfbdaa8381c64c410d7a2b83))
-* **docker:** add Dockerfiles for building Quarkus application in native and JVM modes ([3f2d2bb](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/3f2d2bb4c97fa8cddba66e1da4427c54236dfeed))
-* **docker:** add Dockerfiles for Quarkus application in JVM and native modes ([34b9933](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/34b993304670cf2aa62cd2f6460cee7b9864b08e))
-* **logging:** add DEBUG/INFO/WARN logging across services (NCS-72) ([#41](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/41)) ([804a4bf](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/804a4bf179e3dfb19e2be4390e7e543caf5237c6))
-* NCS-78 Add Traceability to the Applications ([#46](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/46)) ([649566e](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/649566eb3fcf38f91c8896a739f74ea318af312d))
-* NCS-78 Add Traceability to the Applications ([#47](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/47)) ([87dfc6c](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/87dfc6c2bcce7f7d58fc641bd8d468a2e584c108))
-* true-microservices ([#40](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/40)) ([5909242](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/590924254e8a2754de661a57a03e43f89ceb6299))
-* update application.yml with new API root paths and add Micrometer and OpenTelemetry dependencies ([72ce262](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/72ce262bc491f94297700e6002fb5d0812e2cc2a))
-
-### Bug Fixes
-
-* **account:** configure JDBC connection pool size to prevent exhaustion under load ([29072ef](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/29072efbfb1cfa1c3b1a85b4c1a587c971d245f9))
-* **auth:** add InternalClientHeadersFactory for custom client headers management ([e279c39](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/e279c39246470156bf11e745ee72204018d4229d))
-* NCS-84 More Verbose Logging ([#51](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/51)) ([4ad92ab](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/4ad92ab23698267f8faa59c4e18388d4a0042cca))
-* **official-bots:** NCS-70-auto-register official bots with account service ([#59](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/59)) ([7117a93](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/7117a93376272094d0b1a6abf2121254ce396684))
-* remove unused HTTP root-path configurations from application.yml ([3ed3e59](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/3ed3e59ee456d54cd3d65ece4f36623e256b9736))
-* **tests:** update token path to accessToken in ChallengeResourceTest ([354db11](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/354db11972342c47a1034303c11bccfb92e60109))
-
-### Reverts
-
-* Revert "feat: add authentication permissions for metrics endpoints in application.yml" ([a298417](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/a298417b9e4d68dc73bbf40be63d9484536e9f83))
-* Revert "refactor: update metrics paths formatting in application.yml for clarity" ([3870566](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/38705663498d5f47c40dafe2f26198589ede8656))
-##  (2026-06-09)
-
-### Features
-
-* **account:** implement token pair handling for login and refresh endpoints ([9296db8](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/9296db88b7131bbda9b9b0da65c327ef9063ee31))
-* add authentication permissions for metrics endpoints in application.yml ([04edd4d](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/04edd4d6fd8a63196c36f6d67992832febc9bebb))
-* add initialization metrics for various services ([d438e97](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/d438e97f32bdde0bfc63c1b4a8cc810cdd093166))
-* add OpenTelemetry trace configuration with parentbased sampler ([3904d5a](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/3904d5ad8ad4930ddee65287a7bfab785a6148f5))
-* **api:** define shared EventEnvelope and EventType for Redis EventBus ([#61](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/61)) ([595c172](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/595c172900da99de367c274488c3ccbeaef55882))
-* **config:** add H2 database configuration for testing environment ([39c9e49](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/39c9e492cef2515368c074da9406f95e9c0c9e64))
-* **config:** update application.yml for PostgreSQL and remove staging/production configurations ([2404e61](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/2404e6164c3b50ffccbea5238d636060d6abe4d6))
-* **config:** update application.yml for staging and production environments ([6113432](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/6113432a14c476a3a0dfc0d449e17d023697f2ba))
-* configure logging and add OpenTelemetry support ([#49](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/49)) ([d57c488](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/d57c4886612d1d92da0e1b79209fc83e6ef537a1))
-* **docker:** add .dockerignore and .gitignore files for build exclusions ([c987d8e](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/c987d8e258c0e6c4cfbdaa8381c64c410d7a2b83))
-* **docker:** add Dockerfiles for building Quarkus application in native and JVM modes ([3f2d2bb](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/3f2d2bb4c97fa8cddba66e1da4427c54236dfeed))
-* **docker:** add Dockerfiles for Quarkus application in JVM and native modes ([34b9933](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/34b993304670cf2aa62cd2f6460cee7b9864b08e))
-* **events:** migrate game-creation and bot flows to Redis Streams NCS-89 ([#62](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/62)) ([a24924c](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/a24924c23057db3d700a75dbc4333557789cd991))
-* **logging:** add DEBUG/INFO/WARN logging across services (NCS-72) ([#41](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/41)) ([804a4bf](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/804a4bf179e3dfb19e2be4390e7e543caf5237c6))
-* NCS-78 Add Traceability to the Applications ([#46](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/46)) ([649566e](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/649566eb3fcf38f91c8896a739f74ea318af312d))
-* NCS-78 Add Traceability to the Applications ([#47](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/47)) ([87dfc6c](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/87dfc6c2bcce7f7d58fc641bd8d468a2e584c108))
-* true-microservices ([#40](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/40)) ([5909242](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/590924254e8a2754de661a57a03e43f89ceb6299))
-* update application.yml with new API root paths and add Micrometer and OpenTelemetry dependencies ([72ce262](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/72ce262bc491f94297700e6002fb5d0812e2cc2a))
-
-### Bug Fixes
-
-* **account:** configure JDBC connection pool size to prevent exhaustion under load ([29072ef](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/29072efbfb1cfa1c3b1a85b4c1a587c971d245f9))
-* **auth:** add InternalClientHeadersFactory for custom client headers management ([e279c39](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/e279c39246470156bf11e745ee72204018d4229d))
-* NCS-84 More Verbose Logging ([#51](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/51)) ([4ad92ab](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/4ad92ab23698267f8faa59c4e18388d4a0042cca))
-* **official-bots:** NCS-70-auto-register official bots with account service ([#59](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/59)) ([7117a93](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/7117a93376272094d0b1a6abf2121254ce396684))
-* remove unused HTTP root-path configurations from application.yml ([3ed3e59](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/3ed3e59ee456d54cd3d65ece4f36623e256b9736))
-* **tests:** update token path to accessToken in ChallengeResourceTest ([354db11](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/354db11972342c47a1034303c11bccfb92e60109))
-
-### Reverts
-
-* Revert "feat: add authentication permissions for metrics endpoints in application.yml" ([a298417](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/a298417b9e4d68dc73bbf40be63d9484536e9f83))
-* Revert "refactor: update metrics paths formatting in application.yml for clarity" ([3870566](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/38705663498d5f47c40dafe2f26198589ede8656))
-##  (2026-06-09)
-
-### Features
-
-* **account:** implement token pair handling for login and refresh endpoints ([9296db8](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/9296db88b7131bbda9b9b0da65c327ef9063ee31))
-* add authentication permissions for metrics endpoints in application.yml ([04edd4d](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/04edd4d6fd8a63196c36f6d67992832febc9bebb))
-* add initialization metrics for various services ([d438e97](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/d438e97f32bdde0bfc63c1b4a8cc810cdd093166))
-* add OpenTelemetry trace configuration with parentbased sampler ([3904d5a](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/3904d5ad8ad4930ddee65287a7bfab785a6148f5))
-* **api:** define shared EventEnvelope and EventType for Redis EventBus ([#61](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/61)) ([595c172](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/595c172900da99de367c274488c3ccbeaef55882))
-* **config:** add H2 database configuration for testing environment ([39c9e49](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/39c9e492cef2515368c074da9406f95e9c0c9e64))
-* **config:** update application.yml for PostgreSQL and remove staging/production configurations ([2404e61](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/2404e6164c3b50ffccbea5238d636060d6abe4d6))
-* **config:** update application.yml for staging and production environments ([6113432](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/6113432a14c476a3a0dfc0d449e17d023697f2ba))
-* configure logging and add OpenTelemetry support ([#49](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/49)) ([d57c488](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/d57c4886612d1d92da0e1b79209fc83e6ef537a1))
-* **docker:** add .dockerignore and .gitignore files for build exclusions ([c987d8e](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/c987d8e258c0e6c4cfbdaa8381c64c410d7a2b83))
-* **docker:** add Dockerfiles for building Quarkus application in native and JVM modes ([3f2d2bb](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/3f2d2bb4c97fa8cddba66e1da4427c54236dfeed))
-* **docker:** add Dockerfiles for Quarkus application in JVM and native modes ([34b9933](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/34b993304670cf2aa62cd2f6460cee7b9864b08e))
-* **events:** migrate game-creation and bot flows to Redis Streams NCS-89 ([#62](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/62)) ([a24924c](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/a24924c23057db3d700a75dbc4333557789cd991))
-* **logging:** add DEBUG/INFO/WARN logging across services (NCS-72) ([#41](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/41)) ([804a4bf](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/804a4bf179e3dfb19e2be4390e7e543caf5237c6))
-* NCS-78 Add Traceability to the Applications ([#46](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/46)) ([649566e](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/649566eb3fcf38f91c8896a739f74ea318af312d))
-* NCS-78 Add Traceability to the Applications ([#47](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/47)) ([87dfc6c](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/87dfc6c2bcce7f7d58fc641bd8d468a2e584c108))
-* NCS-82 add Swiss-system tournament module ([#55](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/55)) ([c5661de](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/c5661de4a0ebf4b33211f5a391840dcf744656b7))
-* true-microservices ([#40](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/40)) ([5909242](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/590924254e8a2754de661a57a03e43f89ceb6299))
-* update application.yml with new API root paths and add Micrometer and OpenTelemetry dependencies ([72ce262](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/72ce262bc491f94297700e6002fb5d0812e2cc2a))
-
-### Bug Fixes
-
-* **account:** configure JDBC connection pool size to prevent exhaustion under load ([29072ef](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/29072efbfb1cfa1c3b1a85b4c1a587c971d245f9))
-* **auth:** add InternalClientHeadersFactory for custom client headers management ([e279c39](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/e279c39246470156bf11e745ee72204018d4229d))
-* NCS-84 More Verbose Logging ([#51](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/51)) ([4ad92ab](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/4ad92ab23698267f8faa59c4e18388d4a0042cca))
-* **official-bots:** NCS-70-auto-register official bots with account service ([#59](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/59)) ([7117a93](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/7117a93376272094d0b1a6abf2121254ce396684))
-* remove unused HTTP root-path configurations from application.yml ([3ed3e59](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/3ed3e59ee456d54cd3d65ece4f36623e256b9736))
-* **tests:** update token path to accessToken in ChallengeResourceTest ([354db11](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/354db11972342c47a1034303c11bccfb92e60109))
-
-### Reverts
-
-* Revert "feat: add authentication permissions for metrics endpoints in application.yml" ([a298417](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/a298417b9e4d68dc73bbf40be63d9484536e9f83))
-* Revert "refactor: update metrics paths formatting in application.yml for clarity" ([3870566](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/38705663498d5f47c40dafe2f26198589ede8656))
-##  (2026-06-09)
-
-### Features
-
-* **account:** implement token pair handling for login and refresh endpoints ([9296db8](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/9296db88b7131bbda9b9b0da65c327ef9063ee31))
-* add authentication permissions for metrics endpoints in application.yml ([04edd4d](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/04edd4d6fd8a63196c36f6d67992832febc9bebb))
-* add initialization metrics for various services ([d438e97](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/d438e97f32bdde0bfc63c1b4a8cc810cdd093166))
-* add OpenTelemetry trace configuration with parentbased sampler ([3904d5a](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/3904d5ad8ad4930ddee65287a7bfab785a6148f5))
-* **api:** define shared EventEnvelope and EventType for Redis EventBus ([#61](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/61)) ([595c172](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/595c172900da99de367c274488c3ccbeaef55882))
-* **bot-platform:** migrate BotRegistry to Redis Streams consumer group ([#63](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/63)) ([0ad2e10](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/0ad2e10999213df6dd00f0c31a088c28a4dc0083))
-* **config:** add H2 database configuration for testing environment ([39c9e49](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/39c9e492cef2515368c074da9406f95e9c0c9e64))
-* **config:** update application.yml for PostgreSQL and remove staging/production configurations ([2404e61](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/2404e6164c3b50ffccbea5238d636060d6abe4d6))
-* **config:** update application.yml for staging and production environments ([6113432](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/6113432a14c476a3a0dfc0d449e17d023697f2ba))
-* configure logging and add OpenTelemetry support ([#49](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/49)) ([d57c488](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/d57c4886612d1d92da0e1b79209fc83e6ef537a1))
-* **docker:** add .dockerignore and .gitignore files for build exclusions ([c987d8e](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/c987d8e258c0e6c4cfbdaa8381c64c410d7a2b83))
-* **docker:** add Dockerfiles for building Quarkus application in native and JVM modes ([3f2d2bb](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/3f2d2bb4c97fa8cddba66e1da4427c54236dfeed))
-* **docker:** add Dockerfiles for Quarkus application in JVM and native modes ([34b9933](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/34b993304670cf2aa62cd2f6460cee7b9864b08e))
-* **events:** migrate game-creation and bot flows to Redis Streams NCS-89 ([#62](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/62)) ([a24924c](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/a24924c23057db3d700a75dbc4333557789cd991))
-* **logging:** add DEBUG/INFO/WARN logging across services (NCS-72) ([#41](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/41)) ([804a4bf](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/804a4bf179e3dfb19e2be4390e7e543caf5237c6))
-* NCS-78 Add Traceability to the Applications ([#46](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/46)) ([649566e](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/649566eb3fcf38f91c8896a739f74ea318af312d))
-* NCS-78 Add Traceability to the Applications ([#47](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/47)) ([87dfc6c](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/87dfc6c2bcce7f7d58fc641bd8d468a2e584c108))
-* NCS-82 add Swiss-system tournament module ([#55](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/55)) ([c5661de](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/c5661de4a0ebf4b33211f5a391840dcf744656b7))
-* true-microservices ([#40](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/40)) ([5909242](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/590924254e8a2754de661a57a03e43f89ceb6299))
-* update application.yml with new API root paths and add Micrometer and OpenTelemetry dependencies ([72ce262](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/72ce262bc491f94297700e6002fb5d0812e2cc2a))
-* **ws:** migrate challenge notifications to Redis Streams ([#66](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/66)) ([55f102c](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/55f102cbaa684be94a158b16aaa42a50b36afaf3))
-
-### Bug Fixes
-
-* **account:** configure JDBC connection pool size to prevent exhaustion under load ([29072ef](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/29072efbfb1cfa1c3b1a85b4c1a587c971d245f9))
-* **auth:** add InternalClientHeadersFactory for custom client headers management ([e279c39](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/e279c39246470156bf11e745ee72204018d4229d))
-* NCS-84 More Verbose Logging ([#51](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/51)) ([4ad92ab](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/4ad92ab23698267f8faa59c4e18388d4a0042cca))
-* **official-bots:** NCS-70-auto-register official bots with account service ([#59](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/59)) ([7117a93](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/7117a93376272094d0b1a6abf2121254ce396684))
-* remove unused HTTP root-path configurations from application.yml ([3ed3e59](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/3ed3e59ee456d54cd3d65ece4f36623e256b9736))
-* **tests:** update token path to accessToken in ChallengeResourceTest ([354db11](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/354db11972342c47a1034303c11bccfb92e60109))
-
-### Reverts
-
-* Revert "feat: add authentication permissions for metrics endpoints in application.yml" ([a298417](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/a298417b9e4d68dc73bbf40be63d9484536e9f83))
-* Revert "refactor: update metrics paths formatting in application.yml for clarity" ([3870566](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/38705663498d5f47c40dafe2f26198589ede8656))
-##  (2026-06-10)
-
-### Features
-
-* **account:** implement token pair handling for login and refresh endpoints ([9296db8](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/9296db88b7131bbda9b9b0da65c327ef9063ee31))
-* add authentication permissions for metrics endpoints in application.yml ([04edd4d](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/04edd4d6fd8a63196c36f6d67992832febc9bebb))
-* add initialization metrics for various services ([d438e97](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/d438e97f32bdde0bfc63c1b4a8cc810cdd093166))
-* add OpenTelemetry trace configuration with parentbased sampler ([3904d5a](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/3904d5ad8ad4930ddee65287a7bfab785a6148f5))
-* **api:** define shared EventEnvelope and EventType for Redis EventBus ([#61](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/61)) ([595c172](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/595c172900da99de367c274488c3ccbeaef55882))
-* **bot-platform:** migrate BotRegistry to Redis Streams consumer group ([#63](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/63)) ([0ad2e10](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/0ad2e10999213df6dd00f0c31a088c28a4dc0083))
-* **config:** add H2 database configuration for testing environment ([39c9e49](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/39c9e492cef2515368c074da9406f95e9c0c9e64))
-* **config:** update application.yml for PostgreSQL and remove staging/production configurations ([2404e61](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/2404e6164c3b50ffccbea5238d636060d6abe4d6))
-* **config:** update application.yml for staging and production environments ([6113432](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/6113432a14c476a3a0dfc0d449e17d023697f2ba))
-* configure logging and add OpenTelemetry support ([#49](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/49)) ([d57c488](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/d57c4886612d1d92da0e1b79209fc83e6ef537a1))
-* **docker:** add .dockerignore and .gitignore files for build exclusions ([c987d8e](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/c987d8e258c0e6c4cfbdaa8381c64c410d7a2b83))
-* **docker:** add Dockerfiles for building Quarkus application in native and JVM modes ([3f2d2bb](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/3f2d2bb4c97fa8cddba66e1da4427c54236dfeed))
-* **docker:** add Dockerfiles for Quarkus application in JVM and native modes ([34b9933](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/34b993304670cf2aa62cd2f6460cee7b9864b08e))
-* **events:** migrate game-creation and bot flows to Redis Streams NCS-89 ([#62](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/62)) ([a24924c](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/a24924c23057db3d700a75dbc4333557789cd991))
-* **logging:** add DEBUG/INFO/WARN logging across services (NCS-72) ([#41](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/41)) ([804a4bf](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/804a4bf179e3dfb19e2be4390e7e543caf5237c6))
-* NCS-78 Add Traceability to the Applications ([#46](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/46)) ([649566e](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/649566eb3fcf38f91c8896a739f74ea318af312d))
-* NCS-78 Add Traceability to the Applications ([#47](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/47)) ([87dfc6c](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/87dfc6c2bcce7f7d58fc641bd8d468a2e584c108))
-* NCS-82 add Swiss-system tournament module ([#55](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/55)) ([c5661de](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/c5661de4a0ebf4b33211f5a391840dcf744656b7))
-* **reflection:** add native reflection configuration for tournament classes ([65bc6a7](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/65bc6a759937543df2d29905688bfa9e68d0c9d4))
-* true-microservices ([#40](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/40)) ([5909242](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/590924254e8a2754de661a57a03e43f89ceb6299))
-* update application.yml with new API root paths and add Micrometer and OpenTelemetry dependencies ([72ce262](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/72ce262bc491f94297700e6002fb5d0812e2cc2a))
-* **ws:** migrate challenge notifications to Redis Streams ([#66](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/66)) ([55f102c](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/55f102cbaa684be94a158b16aaa42a50b36afaf3))
-
-### Bug Fixes
-
-* **account:** configure JDBC connection pool size to prevent exhaustion under load ([29072ef](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/29072efbfb1cfa1c3b1a85b4c1a587c971d245f9))
-* **auth:** add InternalClientHeadersFactory for custom client headers management ([e279c39](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/e279c39246470156bf11e745ee72204018d4229d))
-* NCS-84 More Verbose Logging ([#51](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/51)) ([4ad92ab](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/4ad92ab23698267f8faa59c4e18388d4a0042cca))
-* **official-bots:** NCS-70-auto-register official bots with account service ([#59](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/59)) ([7117a93](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/7117a93376272094d0b1a6abf2121254ce396684))
-* remove unused HTTP root-path configurations from application.yml ([3ed3e59](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/3ed3e59ee456d54cd3d65ece4f36623e256b9736))
-* **tests:** update token path to accessToken in ChallengeResourceTest ([354db11](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/354db11972342c47a1034303c11bccfb92e60109))
-
-### Reverts
-
-* Revert "feat: add authentication permissions for metrics endpoints in application.yml" ([a298417](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/a298417b9e4d68dc73bbf40be63d9484536e9f83))
-* Revert "refactor: update metrics paths formatting in application.yml for clarity" ([3870566](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/38705663498d5f47c40dafe2f26198589ede8656))
-##  (2026-06-17)
-
-### Features
-
-* **account:** implement token pair handling for login and refresh endpoints ([9296db8](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/9296db88b7131bbda9b9b0da65c327ef9063ee31))
-* add authentication permissions for metrics endpoints in application.yml ([04edd4d](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/04edd4d6fd8a63196c36f6d67992832febc9bebb))
-* add initialization metrics for various services ([d438e97](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/d438e97f32bdde0bfc63c1b4a8cc810cdd093166))
-* add OpenTelemetry trace configuration with parentbased sampler ([3904d5a](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/3904d5ad8ad4930ddee65287a7bfab785a6148f5))
-* **api:** define shared EventEnvelope and EventType for Redis EventBus ([#61](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/61)) ([595c172](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/595c172900da99de367c274488c3ccbeaef55882))
-* **bot-platform:** migrate BotRegistry to Redis Streams consumer group ([#63](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/63)) ([0ad2e10](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/0ad2e10999213df6dd00f0c31a088c28a4dc0083))
-* **config:** add H2 database configuration for testing environment ([39c9e49](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/39c9e492cef2515368c074da9406f95e9c0c9e64))
-* **config:** update application.yml for PostgreSQL and remove staging/production configurations ([2404e61](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/2404e6164c3b50ffccbea5238d636060d6abe4d6))
-* **config:** update application.yml for staging and production environments ([6113432](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/6113432a14c476a3a0dfc0d449e17d023697f2ba))
-* configure logging and add OpenTelemetry support ([#49](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/49)) ([d57c488](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/d57c4886612d1d92da0e1b79209fc83e6ef537a1))
-* **docker:** add .dockerignore and .gitignore files for build exclusions ([c987d8e](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/c987d8e258c0e6c4cfbdaa8381c64c410d7a2b83))
-* **docker:** add Dockerfiles for building Quarkus application in native and JVM modes ([3f2d2bb](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/3f2d2bb4c97fa8cddba66e1da4427c54236dfeed))
-* **docker:** add Dockerfiles for Quarkus application in JVM and native modes ([34b9933](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/34b993304670cf2aa62cd2f6460cee7b9864b08e))
-* **events:** migrate game-creation and bot flows to Redis Streams NCS-89 ([#62](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/62)) ([a24924c](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/a24924c23057db3d700a75dbc4333557789cd991))
-* **logging:** add DEBUG/INFO/WARN logging across services (NCS-72) ([#41](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/41)) ([804a4bf](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/804a4bf179e3dfb19e2be4390e7e543caf5237c6))
-* NCS-78 Add Traceability to the Applications ([#46](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/46)) ([649566e](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/649566eb3fcf38f91c8896a739f74ea318af312d))
-* NCS-78 Add Traceability to the Applications ([#47](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/47)) ([87dfc6c](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/87dfc6c2bcce7f7d58fc641bd8d468a2e584c108))
-* NCS-82 add Swiss-system tournament module ([#55](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/55)) ([c5661de](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/c5661de4a0ebf4b33211f5a391840dcf744656b7))
-* **reflection:** add native reflection configuration for tournament classes ([65bc6a7](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/65bc6a759937543df2d29905688bfa9e68d0c9d4))
-* true-microservices ([#40](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/40)) ([5909242](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/590924254e8a2754de661a57a03e43f89ceb6299))
-* update application.yml with new API root paths and add Micrometer and OpenTelemetry dependencies ([72ce262](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/72ce262bc491f94297700e6002fb5d0812e2cc2a))
-* **ws:** migrate challenge notifications to Redis Streams ([#66](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/66)) ([55f102c](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/55f102cbaa684be94a158b16aaa42a50b36afaf3))
-
-### Bug Fixes
-
-* **account:** configure JDBC connection pool size to prevent exhaustion under load ([29072ef](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/29072efbfb1cfa1c3b1a85b4c1a587c971d245f9))
-* **auth:** add InternalClientHeadersFactory for custom client headers management ([e279c39](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/e279c39246470156bf11e745ee72204018d4229d))
-* enable official bots to connect to external tournament server ([#71](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/71)) ([688d30e](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/688d30e2b10026923372be5fca3c63eaaee2de2a))
-* NCS-84 More Verbose Logging ([#51](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/51)) ([4ad92ab](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/4ad92ab23698267f8faa59c4e18388d4a0042cca))
-* **official-bots:** NCS-70-auto-register official bots with account service ([#59](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/59)) ([7117a93](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/7117a93376272094d0b1a6abf2121254ce396684))
-* remove unused HTTP root-path configurations from application.yml ([3ed3e59](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/3ed3e59ee456d54cd3d65ece4f36623e256b9736))
-* **tests:** update token path to accessToken in ChallengeResourceTest ([354db11](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/354db11972342c47a1034303c11bccfb92e60109))
-
-### Reverts
-
-* Revert "feat: add authentication permissions for metrics endpoints in application.yml" ([a298417](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/a298417b9e4d68dc73bbf40be63d9484536e9f83))
-* Revert "refactor: update metrics paths formatting in application.yml for clarity" ([3870566](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/38705663498d5f47c40dafe2f26198589ede8656))
-##  (2026-06-22)
-
-### Features
-
-* **account:** implement token pair handling for login and refresh endpoints ([9296db8](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/9296db88b7131bbda9b9b0da65c327ef9063ee31))
-* add authentication permissions for metrics endpoints in application.yml ([04edd4d](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/04edd4d6fd8a63196c36f6d67992832febc9bebb))
-* add initialization metrics for various services ([d438e97](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/d438e97f32bdde0bfc63c1b4a8cc810cdd093166))
-* add OpenTelemetry trace configuration with parentbased sampler ([3904d5a](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/3904d5ad8ad4930ddee65287a7bfab785a6148f5))
-* **api:** define shared EventEnvelope and EventType for Redis EventBus ([#61](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/61)) ([595c172](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/595c172900da99de367c274488c3ccbeaef55882))
-* **bot-platform:** migrate BotRegistry to Redis Streams consumer group ([#63](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/63)) ([0ad2e10](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/0ad2e10999213df6dd00f0c31a088c28a4dc0083))
-* **config:** add H2 database configuration for testing environment ([39c9e49](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/39c9e492cef2515368c074da9406f95e9c0c9e64))
-* **config:** update application.yml for PostgreSQL and remove staging/production configurations ([2404e61](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/2404e6164c3b50ffccbea5238d636060d6abe4d6))
-* **config:** update application.yml for staging and production environments ([6113432](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/6113432a14c476a3a0dfc0d449e17d023697f2ba))
-* configure logging and add OpenTelemetry support ([#49](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/49)) ([d57c488](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/d57c4886612d1d92da0e1b79209fc83e6ef537a1))
-* **docker:** add .dockerignore and .gitignore files for build exclusions ([c987d8e](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/c987d8e258c0e6c4cfbdaa8381c64c410d7a2b83))
-* **docker:** add Dockerfiles for building Quarkus application in native and JVM modes ([3f2d2bb](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/3f2d2bb4c97fa8cddba66e1da4427c54236dfeed))
-* **docker:** add Dockerfiles for Quarkus application in JVM and native modes ([34b9933](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/34b993304670cf2aa62cd2f6460cee7b9864b08e))
-* **events:** migrate game-creation and bot flows to Redis Streams NCS-89 ([#62](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/62)) ([a24924c](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/a24924c23057db3d700a75dbc4333557789cd991))
-* **logging:** add DEBUG/INFO/WARN logging across services (NCS-72) ([#41](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/41)) ([804a4bf](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/804a4bf179e3dfb19e2be4390e7e543caf5237c6))
-* NCS-78 Add Traceability to the Applications ([#46](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/46)) ([649566e](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/649566eb3fcf38f91c8896a739f74ea318af312d))
-* NCS-78 Add Traceability to the Applications ([#47](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/47)) ([87dfc6c](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/87dfc6c2bcce7f7d58fc641bd8d468a2e584c108))
-* NCS-82 add Swiss-system tournament module ([#55](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/55)) ([c5661de](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/c5661de4a0ebf4b33211f5a391840dcf744656b7))
-* **official-bots:** resolve tournament bot token from Redis and account service ([386ddc5](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/386ddc5c19f8f893b16c6422aa5393b54c872e45))
-* **reflection:** add native reflection configuration for tournament classes ([65bc6a7](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/65bc6a759937543df2d29905688bfa9e68d0c9d4))
-* true-microservices ([#40](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/40)) ([5909242](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/590924254e8a2754de661a57a03e43f89ceb6299))
-* update application.yml with new API root paths and add Micrometer and OpenTelemetry dependencies ([72ce262](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/72ce262bc491f94297700e6002fb5d0812e2cc2a))
-* **ws:** migrate challenge notifications to Redis Streams ([#66](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/66)) ([55f102c](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/55f102cbaa684be94a158b16aaa42a50b36afaf3))
-
-### Bug Fixes
-
-* **account:** configure JDBC connection pool size to prevent exhaustion under load ([29072ef](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/29072efbfb1cfa1c3b1a85b4c1a587c971d245f9))
-* **auth:** add InternalClientHeadersFactory for custom client headers management ([e279c39](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/e279c39246470156bf11e745ee72204018d4229d))
-* enable official bots to connect to external tournament server ([#71](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/71)) ([688d30e](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/688d30e2b10026923372be5fca3c63eaaee2de2a))
-* NCS-84 More Verbose Logging ([#51](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/51)) ([4ad92ab](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/4ad92ab23698267f8faa59c4e18388d4a0042cca))
-* **official-bots:** NCS-70-auto-register official bots with account service ([#59](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/59)) ([7117a93](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/7117a93376272094d0b1a6abf2121254ce396684))
-* remove unused HTTP root-path configurations from application.yml ([3ed3e59](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/3ed3e59ee456d54cd3d65ece4f36623e256b9736))
-* **tests:** update token path to accessToken in ChallengeResourceTest ([354db11](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/354db11972342c47a1034303c11bccfb92e60109))
-
-### Reverts
-
-* Revert "feat: add authentication permissions for metrics endpoints in application.yml" ([a298417](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/a298417b9e4d68dc73bbf40be63d9484536e9f83))
-* Revert "refactor: update metrics paths formatting in application.yml for clarity" ([3870566](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/38705663498d5f47c40dafe2f26198589ede8656))

modules/account/build.gradle.kts

@@ -45,7 +45,6 @@ dependencies {
         }
     }
 
-    implementation(project(":modules:api"))
     implementation(project(":modules:security"))
 
     implementation(platform("${quarkusPlatformGroupId}:${quarkusPlatformArtifactId}:${quarkusPlatformVersion}"))

modules/account/src/main/scala/de/nowchess/account/client/CoreGameClient.scala

@@ -0,0 +1,28 @@
+package de.nowchess.account.client
+
+import de.nowchess.security.{InternalClientHeadersFactory, InternalSecretClientFilter}
+import jakarta.ws.rs.*
+import jakarta.ws.rs.core.MediaType
+import org.eclipse.microprofile.rest.client.annotation.{RegisterClientHeaders, RegisterProvider}
+import org.eclipse.microprofile.rest.client.inject.RegisterRestClient
+
+case class CorePlayerInfo(id: String, displayName: String)
+case class CoreTimeControl(limitSeconds: Option[Int], incrementSeconds: Option[Int], daysPerMove: Option[Int])
+case class CoreCreateGameRequest(
+    white: Option[CorePlayerInfo],
+    black: Option[CorePlayerInfo],
+    timeControl: Option[CoreTimeControl],
+    mode: Option[String],
+)
+case class CoreGameResponse(gameId: String)
+
+@Path("/api/board/game")
+@RegisterRestClient(configKey = "core-service")
+@RegisterProvider(classOf[InternalSecretClientFilter])
+@RegisterClientHeaders(classOf[InternalClientHeadersFactory])
+trait CoreGameClient:
+
+  @POST
+  @Consumes(Array(MediaType.APPLICATION_JSON))
+  @Produces(Array(MediaType.APPLICATION_JSON))
+  def createGame(req: CoreCreateGameRequest): CoreGameResponse

modules/account/src/main/scala/de/nowchess/account/client/CoreGameDtos.scala

@@ -1,10 +0,0 @@
-package de.nowchess.account.client
-
-case class CorePlayerInfo(id: String, displayName: String)
-case class CoreTimeControl(limitSeconds: Option[Int], incrementSeconds: Option[Int], daysPerMove: Option[Int])
-case class CoreCreateGameRequest(
-    white: Option[CorePlayerInfo],
-    black: Option[CorePlayerInfo],
-    timeControl: Option[CoreTimeControl],
-    mode: Option[String],
-)

modules/account/src/main/scala/de/nowchess/account/client/GameCreationStreamClient.scala

@@ -1,133 +0,0 @@
-package de.nowchess.account.client
-
-import com.fasterxml.jackson.databind.ObjectMapper
-import de.nowchess.account.config.RedisConfig
-import de.nowchess.api.dto.{GameCreationRequestDto, GameCreationResponseDto, PlayerInfoDto, TimeControlDto}
-import de.nowchess.api.game.GameMode
-import de.nowchess.api.player.PlayerType
-import de.nowchess.api.event.{EventEnvelope, EventType}
-import io.quarkus.redis.datasource.RedisDataSource
-import io.quarkus.redis.datasource.stream.{StreamMessage, XAddArgs, XGroupCreateArgs, XReadGroupArgs}
-import io.quarkus.runtime.StartupEvent
-import jakarta.enterprise.context.ApplicationScoped
-import jakarta.enterprise.event.Observes
-import jakarta.inject.Inject
-import org.eclipse.microprofile.config.inject.ConfigProperty
-import org.eclipse.microprofile.context.ManagedExecutor
-import org.jboss.logging.Logger
-import scala.compiletime.uninitialized
-import scala.jdk.CollectionConverters.*
-import scala.util.{Failure, Success, Try}
-import java.time.Duration
-import java.util.UUID
-import java.util.concurrent.{CompletableFuture, ConcurrentHashMap, TimeUnit}
-
-@ApplicationScoped
-class GameCreationStreamClient:
-
-  // scalafix:off DisableSyntax.var
-  @Inject var redis: RedisDataSource     = uninitialized
-  @Inject var redisConfig: RedisConfig   = uninitialized
-  @Inject var objectMapper: ObjectMapper = uninitialized
-  @Inject var executor: ManagedExecutor  = uninitialized
-  @ConfigProperty(name = "nowchess.game-creation-stream.enabled", defaultValue = "true")
-  private var streamEnabled: Boolean = true
-  // scalafix:on DisableSyntax.var
-
-  private val log          = Logger.getLogger(classOf[GameCreationStreamClient])
-  private val instanceId   = UUID.randomUUID().toString
-  private val groupName    = "account-game-creation"
-  private val consumerId   = instanceId
-  private val maxStreamLen = 1000L
-  private val timeout      = Duration.ofSeconds(10)
-
-  private val pending = new ConcurrentHashMap[String, CompletableFuture[GameCreationResponseDto]]()
-
-  private def requestStream: String  = s"${redisConfig.prefix}:game-creation"
-  private def responseStream: String = s"${redisConfig.prefix}:game-creation-response"
-
-  def start(@Observes _ev: StartupEvent): Unit =
-    if streamEnabled then
-      createGroupIfAbsent()
-      executor.submit(
-        new Runnable:
-          def run(): Unit = pollLoop(),
-      )
-      log.infof("Game-creation response listener started (consumer=%s)", consumerId)
-
-  def createGame(req: CoreCreateGameRequest): GameCreationResponseDto =
-    val correlationId = UUID.randomUUID().toString
-    val future        = new CompletableFuture[GameCreationResponseDto]()
-    pending.put(correlationId, future)
-    Try {
-      val payload  = objectMapper.valueToTree[com.fasterxml.jackson.databind.JsonNode](toDto(req))
-      val envelope = EventEnvelope.of(EventType.GameCreationRequest, payload, Some(correlationId))
-      publish(requestStream, envelope)
-      future.get(timeout.toMillis, TimeUnit.MILLISECONDS)
-    } match
-      case Success(resp) =>
-        pending.remove(correlationId)
-        resp
-      case Failure(ex) =>
-        pending.remove(correlationId)
-        log.errorf(ex, "Game creation request %s failed", correlationId)
-        GameCreationResponseDto(None, Some("Game creation request timed out or failed"))
-
-  private def toDto(req: CoreCreateGameRequest): GameCreationRequestDto =
-    GameCreationRequestDto(
-      white = req.white.map(p => PlayerInfoDto(p.id, p.displayName, PlayerType.Human)),
-      black = req.black.map(p => PlayerInfoDto(p.id, p.displayName, PlayerType.Human)),
-      timeControl = req.timeControl.map(t => TimeControlDto(t.limitSeconds, t.incrementSeconds, t.daysPerMove)),
-      mode = req.mode.map(_ => GameMode.Authenticated),
-    )
-
-  private def createGroupIfAbsent(): Unit =
-    Try(
-      redis
-        .stream(classOf[String])
-        .xgroupCreate(responseStream, groupName, "0", new XGroupCreateArgs().mkstream()),
-    ) match
-      case Failure(ex) if Option(ex.getMessage).exists(_.contains("BUSYGROUP")) => ()
-      case Failure(ex) => log.warnf(ex, "Failed to create response consumer group")
-      case Success(_)  => ()
-
-  private def pollLoop(): Unit =
-    while true do
-      Try {
-        val messages = redis
-          .stream(classOf[String])
-          .xreadgroup(
-            groupName,
-            consumerId,
-            responseStream,
-            ">",
-            new XReadGroupArgs().count(10).block(Duration.ofSeconds(2)),
-          )
-        Option(messages).foreach(_.forEach(handleResponse))
-      } match
-        case Failure(ex) => log.warnf(ex, "Error in game-creation response poll loop")
-        case Success(_)  => ()
-
-  private def handleResponse(msg: StreamMessage[String, String, String]): Unit =
-    val json = msg.payload().get("data")
-    Try(objectMapper.readValue(json, classOf[EventEnvelope])) match
-      case Success(envelope) =>
-        envelope.correlationId.flatMap(id => Option(pending.remove(id))).foreach { future =>
-          Try(objectMapper.treeToValue(envelope.payload, classOf[GameCreationResponseDto])) match
-            case Success(resp) => future.complete(resp)
-            case Failure(ex)   => future.completeExceptionally(ex)
-        }
-      case Failure(ex) => log.warnf(ex, "Unparseable game-creation response: %s", json)
-    ack(msg.id())
-
-  private def ack(id: String): Unit =
-    Try(redis.stream(classOf[String]).xack(responseStream, groupName, id)) match
-      case Failure(ex) => log.warnf(ex, "Failed to ack response %s", id)
-      case Success(_)  => ()
-
-  private def publish(key: String, envelope: EventEnvelope): Unit =
-    val json = objectMapper.writeValueAsString(envelope)
-    redis
-      .stream(classOf[String])
-      .xadd(key, new XAddArgs().maxlen(maxStreamLen).nearlyExactTrimming(), Map("data" -> json).asJava)
-    ()

modules/account/src/main/scala/de/nowchess/account/config/NativeReflectionConfig.scala

@@ -1,6 +1,6 @@
 package de.nowchess.account.config
 
-import de.nowchess.account.client.{CoreCreateGameRequest, CorePlayerInfo, CoreTimeControl}
+import de.nowchess.account.client.{CoreCreateGameRequest, CoreGameResponse, CorePlayerInfo, CoreTimeControl}
 import de.nowchess.account.domain.{
   BotAccount,
   Challenge,
@@ -12,19 +12,10 @@ import de.nowchess.account.domain.{
   UserAccount,
 }
 import de.nowchess.account.dto.*
-import de.nowchess.api.dto.{
-  GameCreationRequestDto,
-  GameCreationResponseDto,
-  PlayerInfoDto as ApiPlayerInfoDto,
-  TimeControlDto as ApiTimeControlDto,
-}
-import de.nowchess.api.event.{EventEnvelope, EventType}
 import io.quarkus.runtime.annotations.RegisterForReflection
 
 @RegisterForReflection(
   targets = Array(
-    classOf[EventEnvelope],
-    classOf[EventType],
     classOf[UserAccount],
     classOf[BotAccount],
     classOf[OfficialBotAccount],
@@ -53,11 +44,8 @@ import io.quarkus.runtime.annotations.RegisterForReflection
     classOf[CorePlayerInfo],
     classOf[CoreTimeControl],
     classOf[CoreCreateGameRequest],
+    classOf[CoreGameResponse],
     classOf[OfficialChallengeResponse],
-    classOf[GameCreationRequestDto],
-    classOf[GameCreationResponseDto],
-    classOf[ApiPlayerInfoDto],
-    classOf[ApiTimeControlDto],
   ),
 )
 class NativeReflectionConfig

modules/account/src/main/scala/de/nowchess/account/resource/AccountResource.scala

@@ -193,17 +193,9 @@ class AccountResource:
     val bots = accountService.getOfficialBotAccounts()
     Response.ok(bots.map(toOfficialBotDto)).build()
 
-  @GET
-  @Path("/official-bots/{name}/token")
-  @InternalOnly
-  def getOfficialBotToken(@PathParam("name") name: String): Response =
-    accountService.getOfficialBotTokenByName(name) match
-      case None        => Response.status(Response.Status.NOT_FOUND).build()
-      case Some(token) => Response.ok(RotatedTokenDto(token)).build()
-
   @POST
   @Path("/official-bots")
-  @RolesAllowed(Array("Admin"))
+  @RolesAllowed(Array("**"))
   def createOfficialBot(req: CreateBotAccountRequest): Response =
     accountService.createOfficialBotAccount(req.name) match
       case Right(bot) =>

modules/account/src/main/scala/de/nowchess/account/resource/OfficialChallengeResource.scala

@@ -1,6 +1,6 @@
 package de.nowchess.account.resource
 
-import de.nowchess.account.client.{CoreCreateGameRequest, CorePlayerInfo, GameCreationStreamClient}
+import de.nowchess.account.client.{CoreCreateGameRequest, CoreGameClient, CorePlayerInfo}
 import de.nowchess.account.dto.{ErrorDto, OfficialChallengeResponse}
 import de.nowchess.account.service.{AccountService, EventPublisher}
 import jakarta.annotation.security.RolesAllowed
@@ -9,6 +9,7 @@ import jakarta.inject.Inject
 import jakarta.ws.rs.*
 import jakarta.ws.rs.core.{MediaType, Response}
 import org.eclipse.microprofile.jwt.JsonWebToken
+import org.eclipse.microprofile.rest.client.inject.RestClient
 import org.jboss.logging.Logger
 import scala.compiletime.uninitialized
 
@@ -28,7 +29,8 @@ class OfficialChallengeResource:
   @Inject var botEventPublisher: EventPublisher = uninitialized
 
   @Inject
-  var gameCreationClient: GameCreationStreamClient = uninitialized
+  @RestClient
+  var coreGameClient: CoreGameClient = uninitialized
   // scalafix:on
 
   private val log = Logger.getLogger(classOf[OfficialChallengeResource])
@@ -70,7 +72,7 @@ class OfficialChallengeResource:
                   (CorePlayerInfo(bot.id.toString, bot.name), CorePlayerInfo(user.id.toString, user.username), "white")
               val req = CoreCreateGameRequest(Some(white), Some(black), None, Some("Authenticated"))
               val gameId =
-                try gameCreationClient.createGame(req).gameId.toRight("Failed to create game")
+                try Right(coreGameClient.createGame(req).gameId)
                 catch case _ => Left("Failed to create game")
               gameId match
                 case Left(err) =>

modules/account/src/main/scala/de/nowchess/account/service/AccountService.scala

@@ -217,17 +217,12 @@ class AccountService:
         bot.name = name
         bot.createdAt = Instant.now()
         officialBotAccountRepository.persist(bot)
-        bot.token = generateBotToken(bot.id, bot.name)
-        officialBotAccountRepository.persist(bot)
         log.infof("Auto-registered official bot: %s", name)
     }
 
   def getOfficialBotAccounts(): List[OfficialBotAccount] =
     officialBotAccountRepository.findAll()
 
-  def getOfficialBotTokenByName(name: String): Option[String] =
-    officialBotAccountRepository.findByName(name).map(_.token)
-
   @Transactional
   def deleteOfficialBotAccount(botId: UUID): Either[AccountError, Unit] =
     officialBotAccountRepository.findById(botId) match
@@ -242,7 +237,6 @@ class AccountService:
       .subject(botId.toString)
       .expiresAt(Long.MaxValue)
       .claim("type", "bot")
-      .claim("isBot", true)
       .claim("name", botName)
       .sign()
 

modules/account/src/main/scala/de/nowchess/account/service/ChallengeService.scala

@@ -1,6 +1,12 @@
 package de.nowchess.account.service
 
-import de.nowchess.account.client.{CoreCreateGameRequest, CorePlayerInfo, CoreTimeControl, GameCreationStreamClient}
+import de.nowchess.account.client.{
+  CoreCreateGameRequest,
+  CoreGameClient,
+  CoreGameResponse,
+  CorePlayerInfo,
+  CoreTimeControl,
+}
 import de.nowchess.account.domain.{Challenge, ChallengeColor, ChallengeStatus, DeclineReason}
 import de.nowchess.account.dto.{
   ChallengeDto,
@@ -17,6 +23,7 @@ import jakarta.annotation.PostConstruct
 import jakarta.enterprise.context.ApplicationScoped
 import jakarta.inject.Inject
 import jakarta.transaction.Transactional
+import org.eclipse.microprofile.rest.client.inject.RestClient
 import org.jboss.logging.Logger
 import scala.compiletime.uninitialized
 
@@ -38,7 +45,8 @@ class ChallengeService:
   var challengeRepository: ChallengeRepository = uninitialized
 
   @Inject
-  var gameCreationClient: GameCreationStreamClient = uninitialized
+  @RestClient
+  var coreGameClient: CoreGameClient = uninitialized
 
   @Inject
   var eventPublisher: EventPublisher = uninitialized
@@ -179,7 +187,7 @@ class ChallengeService:
       val (white, black) = assignColors(challenge)
       val tc             = buildTimeControl(challenge)
       val req            = CoreCreateGameRequest(Some(white), Some(black), tc, Some("Authenticated"))
-      gameCreationClient.createGame(req).gameId.toRight(ChallengeError.GameCreationFailed)
+      Right(coreGameClient.createGame(req).gameId)
     catch case _ => Left(ChallengeError.GameCreationFailed)
 
   private def assignColors(challenge: Challenge): (CorePlayerInfo, CorePlayerInfo) =

modules/account/src/main/scala/de/nowchess/account/service/EventPublisher.scala

@@ -1,67 +1,31 @@
 package de.nowchess.account.service
 
-import com.fasterxml.jackson.databind.ObjectMapper
 import de.nowchess.account.config.RedisConfig
-import de.nowchess.api.event.{EventEnvelope, EventType}
 import io.quarkus.redis.datasource.RedisDataSource
-import io.quarkus.redis.datasource.stream.XAddArgs
 import jakarta.enterprise.context.ApplicationScoped
 import jakarta.inject.Inject
 import scala.compiletime.uninitialized
-import scala.jdk.CollectionConverters.*
 
 @ApplicationScoped
 class EventPublisher:
 
   // scalafix:off DisableSyntax.var
-  @Inject var redis: RedisDataSource     = uninitialized
-  @Inject var redisConfig: RedisConfig   = uninitialized
-  @Inject var objectMapper: ObjectMapper = uninitialized
+  @Inject var redis: RedisDataSource   = uninitialized
+  @Inject var redisConfig: RedisConfig = uninitialized
   // scalafix:on DisableSyntax.var
 
-  private val maxStreamLen = 1000L
-
   def publishGameStart(botId: String, gameId: String, playingAs: String, difficulty: Int, botAccountId: String): Unit =
-    val payload = objectMapper.createObjectNode()
-    payload.put("gameId", gameId)
-    payload.put("playingAs", playingAs)
-    payload.put("difficulty", difficulty)
-    payload.put("botAccountId", botAccountId)
-    val envelope = EventEnvelope.of(EventType.BotGameStart, payload)
-    val json     = objectMapper.writeValueAsString(envelope)
-    redis
-      .stream(classOf[String])
-      .xadd(
-        s"${redisConfig.prefix}:bot:$botId:events:stream",
-        new XAddArgs().maxlen(maxStreamLen).nearlyExactTrimming(),
-        Map("data" -> json).asJava,
-      )
+    val event =
+      s"""{"type":"gameStart","gameId":"$gameId","playingAs":"$playingAs","difficulty":$difficulty,"botAccountId":"$botAccountId"}"""
+    redis.pubsub(classOf[String]).publish(s"${redisConfig.prefix}:bot:$botId:events", event)
     ()
 
   def publishChallengeCreated(destUserId: String, challengeId: String, challengerName: String): Unit =
-    val payload = objectMapper.createObjectNode()
-    payload.put("challengeId", challengeId)
-    payload.put("challengerName", challengerName)
-    publishToUserStream(destUserId, EventType.ChallengeCreated, payload)
+    val event = s"""{"type":"challengeCreated","challengeId":"$challengeId","challengerName":"$challengerName"}"""
+    redis.pubsub(classOf[String]).publish(s"${redisConfig.prefix}:user:$destUserId:events", event)
+    ()
 
   def publishChallengeAccepted(challengerId: String, challengeId: String, gameId: String): Unit =
-    val payload = objectMapper.createObjectNode()
-    payload.put("challengeId", challengeId)
-    payload.put("gameId", gameId)
-    publishToUserStream(challengerId, EventType.ChallengeAccepted, payload)
-
-  private def publishToUserStream(
-      userId: String,
-      eventType: EventType,
-      payload: com.fasterxml.jackson.databind.node.ObjectNode,
-  ): Unit =
-    val envelope = EventEnvelope.of(eventType, payload)
-    val json     = objectMapper.writeValueAsString(envelope)
-    redis
-      .stream(classOf[String])
-      .xadd(
-        s"${redisConfig.prefix}:user:$userId:events:stream",
-        new XAddArgs().maxlen(maxStreamLen).nearlyExactTrimming(),
-        Map("data" -> json).asJava,
-      )
+    val event = s"""{"type":"challengeAccepted","challengeId":"$challengeId","gameId":"$gameId"}"""
+    redis.pubsub(classOf[String]).publish(s"${redisConfig.prefix}:user:$challengerId:events", event)
     ()

modules/account/src/test/resources/application.yml

@@ -34,5 +34,3 @@ nowchess:
     secret: test-secret
     auth:
       enabled: false
-  game-creation-stream:
-    enabled: false

modules/account/src/test/scala/de/nowchess/account/resource/ChallengeResourceTest.scala

@@ -1,11 +1,11 @@
 package de.nowchess.account.resource
 
-import de.nowchess.account.client.GameCreationStreamClient
-import de.nowchess.api.dto.GameCreationResponseDto
+import de.nowchess.account.client.{CoreGameClient, CoreGameResponse}
 import io.quarkus.test.InjectMock
 import io.quarkus.test.junit.QuarkusTest
 import io.restassured.RestAssured
 import io.restassured.http.ContentType
+import org.eclipse.microprofile.rest.client.inject.RestClient
 import org.hamcrest.Matchers.*
 import org.junit.jupiter.api.{BeforeEach, Test}
 import org.mockito.{ArgumentMatchers, Mockito}
@@ -14,15 +14,14 @@ import org.mockito.{ArgumentMatchers, Mockito}
 class ChallengeResourceTest:
 
   @InjectMock
+  @RestClient
   // scalafix:off DisableSyntax.var
-  var gameCreationClient: GameCreationStreamClient = scala.compiletime.uninitialized
+  var coreGameClient: CoreGameClient = scala.compiletime.uninitialized
   // scalafix:on
 
   @BeforeEach
   def setup(): Unit =
-    Mockito
-      .when(gameCreationClient.createGame(ArgumentMatchers.any()))
-      .thenReturn(GameCreationResponseDto(Some("test-game-id")))
+    Mockito.when(coreGameClient.createGame(ArgumentMatchers.any())).thenReturn(CoreGameResponse("test-game-id"))
 
   private def givenRequest() = RestAssured.`given`().contentType(ContentType.JSON)
 

modules/account/src/test/scala/de/nowchess/account/service/EventPublisherTest.scala

@@ -1,56 +0,0 @@
-package de.nowchess.account.service
-
-import com.fasterxml.jackson.databind.ObjectMapper
-import com.fasterxml.jackson.datatype.jsr310.JavaTimeModule
-import de.nowchess.account.config.RedisConfig
-import io.quarkus.redis.datasource.RedisDataSource
-import io.quarkus.redis.datasource.stream.{StreamCommands, XAddArgs}
-import org.junit.jupiter.api.{BeforeEach, Test}
-import org.mockito.ArgumentMatchers.*
-import org.mockito.Mockito.*
-import scala.compiletime.uninitialized
-
-class EventPublisherTest:
-
-  // scalafix:off DisableSyntax.var
-  private var redis: RedisDataSource                              = uninitialized
-  private var streamCmds: StreamCommands[String, String, Nothing] = uninitialized
-  private var redisConfig: RedisConfig                            = uninitialized
-  // scalafix:on DisableSyntax.var
-
-  private val objectMapper = new ObjectMapper().registerModule(new JavaTimeModule())
-
-  @BeforeEach
-  def setup(): Unit =
-    redis = mock(classOf[RedisDataSource])
-    streamCmds = mock(classOf[StreamCommands[String, String, Nothing]])
-    redisConfig = mock(classOf[RedisConfig])
-    when(redis.stream(classOf[String])).thenReturn(streamCmds)
-    when(redisConfig.prefix).thenReturn("nowchess")
-
-  private def publisher: EventPublisher =
-    val p = new EventPublisher
-    p.redis = redis
-    p.redisConfig = redisConfig
-    p.objectMapper = objectMapper
-    p
-
-  @Test
-  def publishChallengeCreatedWritesToUserStream(): Unit =
-    publisher.publishChallengeCreated("user1", "ch1", "Alice")
-    verify(streamCmds).xadd(
-      org.mockito.ArgumentMatchers.eq("nowchess:user:user1:events:stream"),
-      any(classOf[XAddArgs]),
-      any(),
-    )
-    verify(redis, never()).pubsub(any(classOf[Class[?]]))
-
-  @Test
-  def publishChallengeAcceptedWritesToUserStream(): Unit =
-    publisher.publishChallengeAccepted("user2", "ch1", "game42")
-    verify(streamCmds).xadd(
-      org.mockito.ArgumentMatchers.eq("nowchess:user:user2:events:stream"),
-      any(classOf[XAddArgs]),
-      any(),
-    )
-    verify(redis, never()).pubsub(any(classOf[Class[?]]))

modules/account/versions.env

@@ -1,3 +1,3 @@
 MAJOR=0
-MINOR=26
+MINOR=19
 PATCH=0

modules/analysis/CHANGELOG.md

@@ -1,16 +0,0 @@
-# Changelog — analysis
-
-## 0.1.0 (NCS-71)
-
-- Initial scaffold: chess analysis microservice
-- REST endpoint `POST /api/analysis/position` wrapping chess-api.com
-- REST endpoint `GET /api/analysis/health`
-##  (2026-06-15)
-
-### Features
-
-* **analysis:** scaffold chess analysis microservice (NCS-71) NCI-10 ([#69](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/69)) ([0bdf72b](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/0bdf72bddcd3e4cb7f731504c064633f76eade94))
-
-### Bug Fixes
-
-* **version:** Wrong version file ([b1c9e96](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/b1c9e962e74f35f6b1e2a074e1d3acbe2e2fb5e9))

modules/analysis/build.gradle.kts

@@ -1,111 +0,0 @@
-plugins {
-    id("scala")
-    id("org.scoverage") version "8.1"
-    id("io.quarkus")
-}
-
-group = "de.nowchess"
-version = "1.0-SNAPSHOT"
-
-@Suppress("UNCHECKED_CAST")
-val versions = rootProject.extra["VERSIONS"] as Map<String, String>
-@Suppress("UNCHECKED_CAST")
-val scoverageExcluded = rootProject.extra["SCOVERAGE_EXCLUDED"] as List<String>
-
-repositories {
-    mavenCentral()
-}
-
-scala {
-    scalaVersion = versions["SCALA3"]!!
-}
-
-scoverage {
-    scoverageVersion.set(versions["SCOVERAGE"]!!)
-    excludedFiles.set(scoverageExcluded)
-}
-
-tasks.withType<ScalaCompile> {
-    scalaCompileOptions.additionalParameters = listOf("-encoding", "UTF-8")
-}
-
-val quarkusPlatformGroupId: String by project
-val quarkusPlatformArtifactId: String by project
-val quarkusPlatformVersion: String by project
-
-dependencies {
-    compileOnly("org.scala-lang:scala3-compiler_3") {
-        version {
-            strictly(versions["SCALA3"]!!)
-        }
-    }
-    implementation("org.scala-lang:scala3-library_3") {
-        version {
-            strictly(versions["SCALA3"]!!)
-        }
-    }
-
-    implementation(enforcedPlatform("${quarkusPlatformGroupId}:${quarkusPlatformArtifactId}:${quarkusPlatformVersion}"))
-    implementation("io.quarkus:quarkus-rest")
-    implementation("io.quarkus:quarkus-rest-client")
-    implementation("io.quarkus:quarkus-rest-client-jackson")
-    implementation("io.quarkus:quarkus-rest-jackson")
-    implementation("io.quarkus:quarkus-config-yaml")
-    implementation("io.quarkus:quarkus-smallrye-fault-tolerance")
-    implementation("io.quarkus:quarkus-smallrye-health")
-    implementation("io.quarkus:quarkus-logging-json")
-    implementation("io.quarkus:quarkus-micrometer")
-    implementation("io.quarkus:quarkus-micrometer-registry-prometheus")
-    implementation("io.quarkus:quarkus-opentelemetry")
-    implementation("io.quarkus:quarkus-arc")
-
-    implementation("com.fasterxml.jackson.module:jackson-module-scala_3:${versions["JACKSON_SCALA"]!!}")
-
-    testImplementation(platform("org.junit:junit-bom:5.13.4"))
-    testImplementation("org.junit.jupiter:junit-jupiter")
-    testImplementation("org.scalatest:scalatest_3:${versions["SCALATEST"]!!}")
-    testImplementation("co.helmethair:scalatest-junit-runner:${versions["SCALATEST_JUNIT"]!!}")
-    testImplementation("io.quarkus:quarkus-junit5")
-    testImplementation("io.quarkus:quarkus-junit5-mockito")
-    testImplementation("io.rest-assured:rest-assured")
-
-    testRuntimeOnly("org.junit.platform:junit-platform-launcher")
-    testRuntimeOnly("org.junit.jupiter:junit-jupiter-engine")
-}
-
-configurations.matching { !it.name.startsWith("scoverage") }.configureEach {
-    resolutionStrategy.force("org.scala-lang:scala-library:${versions["SCALA_LIBRARY"]!!}")
-}
-configurations.scoverage {
-    resolutionStrategy.eachDependency {
-        if (requested.group == "org.scoverage" && requested.name.startsWith("scalac-scoverage-plugin_")) {
-            useTarget("${requested.group}:scalac-scoverage-plugin_2.13.16:2.3.0")
-        }
-    }
-}
-
-tasks.withType<JavaCompile> {
-    options.encoding = "UTF-8"
-    options.compilerArgs.add("-parameters")
-}
-
-tasks.withType<Jar>().configureEach {
-    duplicatesStrategy = DuplicatesStrategy.EXCLUDE
-}
-
-tasks.test {
-    useJUnitPlatform {
-        includeEngines("scalatest", "junit-jupiter")
-        testLogging {
-            events("passed", "skipped", "failed")
-        }
-    }
-    finalizedBy(tasks.reportScoverage)
-}
-tasks.reportScoverage {
-    dependsOn(tasks.test)
-}
-
-tasks.jar {
-    duplicatesStrategy = DuplicatesStrategy.EXCLUDE
-}

modules/analysis/src/main/docker/Dockerfile.native

@@ -1,29 +0,0 @@
-####
-# This Dockerfile is used in order to build a container that runs the Quarkus application in native (no JVM) mode.
-#
-# Before building the container image run:
-#
-# ./gradlew :modules:analysis:build -Dquarkus.native.enabled=true
-#
-# Then, build the image with:
-#
-# docker build -f src/main/docker/Dockerfile.native -t quarkus/backcore .
-#
-# Then run the container using:
-#
-# docker run -i --rm -p 8087:8087 quarkus/backcore
-#
-# The `registry.access.redhat.com/ubi9/ubi-minimal:9.7` base image is based on UBI 9.
-# To use UBI 8, switch to `quay.io/ubi8/ubi-minimal:8.10`.
-###
-FROM registry.access.redhat.com/ubi9/ubi-minimal:9.7
-WORKDIR /work/
-RUN chown 1001 /work \
-    && chmod "g+rwX" /work \
-    && chown 1001:root /work
-COPY --chown=1001:root --chmod=0755 modules/analysis/build/*-runner /work/application
-
-EXPOSE 8087
-USER 1001
-
-ENTRYPOINT ["./application", "-Dquarkus.http.host=0.0.0.0"]

modules/analysis/src/main/resources/application.yml

@@ -1,40 +0,0 @@
-quarkus:
-  http:
-    port: 8087
-  application:
-    name: nowchess-analysis
-  config:
-    yaml:
-      enabled: true
-
-nowchess:
-  analysis:
-    chess-api:
-      base-url: ${CHESS_API_URL:https://chess-api.com/v1}
-      timeout-ms: ${CHESS_API_TIMEOUT_MS:5000}
-
-"%dev":
-  quarkus:
-    rest-client:
-      chess-api:
-        url: https://chess-api.com/v1
-        connect-timeout: 5000
-        read-timeout: 5000
-
-"%deployed":
-  quarkus:
-    log:
-      console:
-        json: true
-    otel:
-      traces:
-        sampler: parentbased_traceidratio
-        sampler-arg: 0.1
-      exporter:
-        otlp:
-          endpoint: ${OTEL_EXPORTER_OTLP_ENDPOINT:http://localhost:4317}
-    rest-client:
-      chess-api:
-        url: ${CHESS_API_URL:https://chess-api.com/v1}
-        connect-timeout: ${CHESS_API_CONNECT_TIMEOUT_MS:5000}
-        read-timeout: ${CHESS_API_TIMEOUT_MS:5000}

modules/analysis/src/main/scala/de/nowchess/analysis/client/ChessApiClient.scala

@@ -1,18 +0,0 @@
-package de.nowchess.analysis.client
-
-import jakarta.ws.rs.*
-import jakarta.ws.rs.core.MediaType
-import org.eclipse.microprofile.rest.client.inject.RegisterRestClient
-
-/** MicroProfile REST client for chess-api.com v1.
-  *
-  * Base URL is resolved from `quarkus.rest-client.chess-api.url` in application.yml.
-  */
-@Path("/")
-@RegisterRestClient(configKey = "chess-api")
-trait ChessApiClient:
-
-  @POST
-  @Consumes(Array(MediaType.APPLICATION_JSON))
-  @Produces(Array(MediaType.APPLICATION_JSON))
-  def analyse(body: ChessApiRequestDto): ChessApiResponseDto

modules/analysis/src/main/scala/de/nowchess/analysis/client/ChessApiRequestDto.scala

@@ -1,4 +0,0 @@
-package de.nowchess.analysis.client
-
-/** Request body sent to chess-api.com v1 `/` endpoint. */
-case class ChessApiRequestDto(fen: String, depth: Int)

modules/analysis/src/main/scala/de/nowchess/analysis/client/ChessApiResponseDto.scala

@@ -1,23 +0,0 @@
-package de.nowchess.analysis.client
-
-import com.fasterxml.jackson.annotation.JsonIgnoreProperties
-
-/** Response from chess-api.com v1 analysis endpoint.
-  *
-  * The API returns a JSON object. Fields not listed here are ignored.
-  */
-@JsonIgnoreProperties(ignoreUnknown = true)
-case class ChessApiResponseDto(
-    /** Best move in UCI format (e.g. "e2e4"). */
-    move: Option[String] = None,
-    /** Centipawn evaluation (from white's perspective). */
-    centipawns: Option[Double] = None,
-    /** Mate-in-N (positive = white wins, negative = black wins). */
-    mate: Option[Int] = None,
-    /** Principal variation: space-separated UCI moves. */
-    pv: Option[String] = None,
-    /** Actual depth searched. */
-    depth: Option[Int] = None,
-    /** Text description of the position/move quality. */
-    text: Option[String] = None,
-)

modules/analysis/src/main/scala/de/nowchess/analysis/config/JacksonConfig.scala

@@ -1,17 +0,0 @@
-package de.nowchess.analysis.config
-
-import com.fasterxml.jackson.core.Version
-import com.fasterxml.jackson.databind.ObjectMapper
-import com.fasterxml.jackson.module.scala.DefaultScalaModule
-import io.quarkus.jackson.ObjectMapperCustomizer
-import jakarta.inject.Singleton
-
-@Singleton
-class JacksonConfig extends ObjectMapperCustomizer:
-  def customize(mapper: ObjectMapper): Unit =
-    mapper.registerModule(new DefaultScalaModule() {
-      override def version(): Version =
-        // scalafix:off DisableSyntax.null
-        new Version(2, 21, 1, null, "com.fasterxml.jackson.module", "jackson-module-scala")
-        // scalafix:on DisableSyntax.null
-    })

modules/analysis/src/main/scala/de/nowchess/analysis/config/NativeReflectionConfig.scala

@@ -1,18 +0,0 @@
-package de.nowchess.analysis.config
-
-import de.nowchess.analysis.client.{ChessApiRequestDto, ChessApiResponseDto}
-import de.nowchess.analysis.dto.{AnalysisRequestDto, AnalysisResponseDto}
-import de.nowchess.analysis.error.AnalysisErrorDto
-import io.quarkus.runtime.annotations.RegisterForReflection
-
-@RegisterForReflection(
-  targets = Array(
-    classOf[AnalysisRequestDto],
-    classOf[AnalysisResponseDto],
-    classOf[ChessApiRequestDto],
-    classOf[ChessApiResponseDto],
-    classOf[AnalysisErrorDto],
-  ),
-  registerFullHierarchy = true,
-)
-class NativeReflectionConfig

modules/analysis/src/main/scala/de/nowchess/analysis/dto/AnalysisRequestDto.scala

@@ -1,10 +0,0 @@
-package de.nowchess.analysis.dto
-
-/** Request body for the analysis endpoint.
-  *
-  * @param fen
-  *   FEN string representing the position to analyse.
-  * @param depth
-  *   Engine search depth (1-99). Defaults to 12 when absent.
-  */
-case class AnalysisRequestDto(fen: String, depth: Option[Int] = None)

modules/analysis/src/main/scala/de/nowchess/analysis/dto/AnalysisResponseDto.scala

@@ -1,25 +0,0 @@
-package de.nowchess.analysis.dto
-
-/** Response from the analysis endpoint.
-  *
-  * @param fen
-  *   The analysed FEN.
-  * @param depth
-  *   The search depth used.
-  * @param bestMove
-  *   Best move in UCI notation (e.g. "e2e4"), or None if not available.
-  * @param evaluation
-  *   Centipawn evaluation from white's perspective, or None.
-  * @param mate
-  *   Mate-in-N value (positive = white wins, negative = black wins), or None.
-  * @param continuationMoves
-  *   Principal variation as list of UCI moves.
-  */
-case class AnalysisResponseDto(
-    fen: String,
-    depth: Int,
-    bestMove: Option[String],
-    evaluation: Option[Double],
-    mate: Option[Int],
-    continuationMoves: List[String],
-)

modules/analysis/src/main/scala/de/nowchess/analysis/error/AnalysisErrorDto.scala

@@ -1,3 +0,0 @@
-package de.nowchess.analysis.error
-
-case class AnalysisErrorDto(code: String, message: String)

modules/analysis/src/main/scala/de/nowchess/analysis/error/AnalysisException.scala

@@ -1,8 +0,0 @@
-package de.nowchess.analysis.error
-
-sealed class AnalysisException(val status: Int, val code: String, message: String) extends RuntimeException(message)
-
-class InvalidFenException(fen: String) extends AnalysisException(400, "INVALID_FEN", s"Invalid FEN string: $fen")
-
-class AnalysisUpstreamException(cause: Throwable)
-    extends AnalysisException(502, "UPSTREAM_ERROR", s"Chess API unavailable: ${cause.getMessage}")

modules/analysis/src/main/scala/de/nowchess/analysis/error/AnalysisExceptionMapper.scala

@@ -1,13 +0,0 @@
-package de.nowchess.analysis.error
-
-import jakarta.ws.rs.core.{MediaType, Response}
-import jakarta.ws.rs.ext.{ExceptionMapper, Provider}
-
-@Provider
-class AnalysisExceptionMapper extends ExceptionMapper[AnalysisException]:
-  def toResponse(ex: AnalysisException): Response =
-    Response
-      .status(ex.status)
-      .entity(AnalysisErrorDto(ex.code, ex.getMessage))
-      .`type`(MediaType.APPLICATION_JSON)
-      .build()

modules/analysis/src/main/scala/de/nowchess/analysis/resource/AnalysisResource.scala

@@ -1,33 +0,0 @@
-package de.nowchess.analysis.resource
-
-import de.nowchess.analysis.dto.{AnalysisRequestDto, AnalysisResponseDto}
-import de.nowchess.analysis.service.AnalysisService
-import jakarta.annotation.security.PermitAll
-import jakarta.enterprise.context.ApplicationScoped
-import jakarta.inject.Inject
-import jakarta.ws.rs.*
-import jakarta.ws.rs.core.{MediaType, Response}
-
-import scala.compiletime.uninitialized
-
-@Path("/api/analysis")
-@ApplicationScoped
-class AnalysisResource:
-
-  // scalafix:off DisableSyntax.var
-  @Inject
-  var analysisService: AnalysisService = uninitialized
-  // scalafix:on DisableSyntax.var
-
-  /** Analyse a chess position.
-    *
-    * Accepts a FEN string and optional depth, proxies to chess-api.com, and returns structured analysis data.
-    */
-  @POST
-  @Path("/position")
-  @PermitAll
-  @Consumes(Array(MediaType.APPLICATION_JSON))
-  @Produces(Array(MediaType.APPLICATION_JSON))
-  def analysePosition(body: AnalysisRequestDto): Response =
-    val result = analysisService.analyse(body)
-    Response.ok(result).build()

modules/analysis/src/main/scala/de/nowchess/analysis/service/AnalysisService.scala

@@ -1,68 +0,0 @@
-package de.nowchess.analysis.service
-
-import de.nowchess.analysis.client.{ChessApiClient, ChessApiRequestDto}
-import de.nowchess.analysis.dto.{AnalysisRequestDto, AnalysisResponseDto}
-import de.nowchess.analysis.error.{AnalysisUpstreamException, InvalidFenException}
-import jakarta.enterprise.context.ApplicationScoped
-import jakarta.inject.Inject
-import org.eclipse.microprofile.rest.client.inject.RestClient
-import org.jboss.logging.Logger
-
-import scala.compiletime.uninitialized
-
-@ApplicationScoped
-class AnalysisService:
-
-  private val log = Logger.getLogger(classOf[AnalysisService])
-
-  private val DefaultDepth = 12
-  private val MinDepth     = 1
-  private val MaxDepth     = 99
-
-  // scalafix:off DisableSyntax.var
-  @Inject
-  @RestClient
-  var chessApiClient: ChessApiClient = uninitialized
-  // scalafix:on DisableSyntax.var
-
-  // scalafix:off DisableSyntax.throw
-  def analyse(request: AnalysisRequestDto): AnalysisResponseDto =
-    val fen = request.fen.trim
-    if fen.isEmpty then throw InvalidFenException(fen)
-    validateFen(fen)
-
-    val depth = request.depth
-      .map(d => d.max(MinDepth).min(MaxDepth))
-      .getOrElse(DefaultDepth)
-
-    log.debugf("Analysing FEN '%s' at depth %d", fen, depth)
-
-    val apiResponse =
-      try chessApiClient.analyse(ChessApiRequestDto(fen, depth))
-      catch
-        case ex: Exception =>
-          log.warnf(ex, "Chess API call failed for FEN '%s'", fen)
-          throw AnalysisUpstreamException(ex)
-
-    val continuationMoves = apiResponse.pv
-      .map(_.split(" ").toList.filter(_.nonEmpty))
-      .getOrElse(List.empty)
-
-    AnalysisResponseDto(
-      fen = fen,
-      depth = apiResponse.depth.getOrElse(depth),
-      bestMove = apiResponse.move,
-      evaluation = apiResponse.centipawns,
-      mate = apiResponse.mate,
-      continuationMoves = continuationMoves,
-    )
-  // scalafix:on DisableSyntax.throw
-
-  /** Rudimentary FEN structure validation — checks the board part has 8 ranks. */
-  // scalafix:off DisableSyntax.throw
-  private def validateFen(fen: String): Unit =
-    val parts = fen.split(" ")
-    if parts.length < 1 then throw InvalidFenException(fen)
-    val ranks = parts(0).split("/")
-    if ranks.length != 8 then throw InvalidFenException(fen)
-  // scalafix:on DisableSyntax.throw

modules/analysis/src/test/resources/application.yml

@@ -1,4 +0,0 @@
-quarkus:
-  rest-client:
-    chess-api:
-      url: http://localhost:9999

modules/analysis/src/test/scala/de/nowchess/analysis/resource/AnalysisResourceTest.scala

@@ -1,106 +0,0 @@
-package de.nowchess.analysis.resource
-
-import de.nowchess.analysis.dto.{AnalysisRequestDto, AnalysisResponseDto}
-import de.nowchess.analysis.error.{AnalysisUpstreamException, InvalidFenException}
-import de.nowchess.analysis.service.AnalysisService
-import io.quarkus.test.InjectMock
-import io.quarkus.test.junit.QuarkusTest
-import io.restassured.RestAssured
-import io.restassured.http.ContentType
-import org.hamcrest.Matchers.*
-import org.junit.jupiter.api.{DisplayName, Test}
-import org.mockito.ArgumentMatchers.any
-import org.mockito.Mockito.when
-
-import scala.compiletime.uninitialized
-
-// scalafix:off
-@QuarkusTest
-@DisplayName("AnalysisResource")
-class AnalysisResourceTest:
-
-  @InjectMock
-  var analysisService: AnalysisService = uninitialized
-
-  private val validFen = "rnbqkbnr/pppppppp/8/8/8/8/PPPPPPPP/RNBQKBNR w KQkq - 0 1"
-
-  private def givenJson() = RestAssured.`given`().contentType(ContentType.JSON)
-
-  @Test
-  @DisplayName("POST /api/analysis/position returns 200 with analysis data")
-  def testAnalysePositionOk(): Unit =
-    when(analysisService.analyse(any()))
-      .thenReturn(
-        AnalysisResponseDto(
-          fen = validFen,
-          depth = 12,
-          bestMove = Some("e2e4"),
-          evaluation = Some(0.3),
-          mate = None,
-          continuationMoves = List("e2e4", "e7e5"),
-        ),
-      )
-
-    givenJson()
-      .body(s"""{"fen": "$validFen"}""")
-      .when()
-      .post("/api/analysis/position")
-      .`then`()
-      .statusCode(200)
-      .body("fen", equalTo(validFen))
-      .body("depth", equalTo(12))
-      .body("bestMove", equalTo("e2e4"))
-      .body("evaluation", equalTo(0.3f))
-      .body("continuationMoves", hasItems("e2e4", "e7e5"))
-
-  @Test
-  @DisplayName("POST /api/analysis/position returns 400 for invalid FEN")
-  def testAnalysePositionInvalidFen(): Unit =
-    when(analysisService.analyse(any()))
-      .thenThrow(new InvalidFenException("bad-fen"))
-
-    givenJson()
-      .body("""{"fen": "bad-fen"}""")
-      .when()
-      .post("/api/analysis/position")
-      .`then`()
-      .statusCode(400)
-      .body("code", equalTo("INVALID_FEN"))
-
-  @Test
-  @DisplayName("POST /api/analysis/position returns 502 on upstream failure")
-  def testAnalysePositionUpstreamError(): Unit =
-    when(analysisService.analyse(any()))
-      .thenThrow(new AnalysisUpstreamException(new RuntimeException("timeout")))
-
-    givenJson()
-      .body(s"""{"fen": "$validFen"}""")
-      .when()
-      .post("/api/analysis/position")
-      .`then`()
-      .statusCode(502)
-      .body("code", equalTo("UPSTREAM_ERROR"))
-
-  @Test
-  @DisplayName("POST /api/analysis/position accepts custom depth")
-  def testAnalysePositionCustomDepth(): Unit =
-    when(analysisService.analyse(any()))
-      .thenReturn(
-        AnalysisResponseDto(
-          fen = validFen,
-          depth = 20,
-          bestMove = Some("d2d4"),
-          evaluation = Some(0.15),
-          mate = None,
-          continuationMoves = List.empty,
-        ),
-      )
-
-    givenJson()
-      .body(s"""{"fen": "$validFen", "depth": 20}""")
-      .when()
-      .post("/api/analysis/position")
-      .`then`()
-      .statusCode(200)
-      .body("depth", equalTo(20))
-// scalafix:on

modules/analysis/src/test/scala/de/nowchess/analysis/service/AnalysisServiceTest.scala

@@ -1,139 +0,0 @@
-package de.nowchess.analysis.service
-
-import de.nowchess.analysis.client.{ChessApiClient, ChessApiRequestDto, ChessApiResponseDto}
-import de.nowchess.analysis.dto.AnalysisRequestDto
-import de.nowchess.analysis.error.{AnalysisUpstreamException, InvalidFenException}
-import io.quarkus.test.InjectMock
-import io.quarkus.test.junit.QuarkusTest
-import jakarta.inject.Inject
-import org.eclipse.microprofile.rest.client.inject.RestClient
-import org.junit.jupiter.api.Assertions.*
-import org.junit.jupiter.api.{DisplayName, Test}
-import org.mockito.ArgumentMatchers.any
-import org.mockito.Mockito.{verify, when}
-
-import scala.compiletime.uninitialized
-
-// scalafix:off
-@QuarkusTest
-@DisplayName("AnalysisService")
-class AnalysisServiceTest:
-
-  @Inject
-  var service: AnalysisService = uninitialized
-
-  @InjectMock
-  @RestClient
-  var chessApiClient: ChessApiClient = uninitialized
-
-  private val validFen = "rnbqkbnr/pppppppp/8/8/8/8/PPPPPPPP/RNBQKBNR w KQkq - 0 1"
-
-  @Test
-  @DisplayName("analyse returns response with best move from chess-api.com")
-  def testAnalyseReturnsBestMove(): Unit =
-    when(chessApiClient.analyse(any()))
-      .thenReturn(
-        ChessApiResponseDto(
-          move = Some("e2e4"),
-          centipawns = Some(0.3),
-          mate = None,
-          pv = Some("e2e4 e7e5 g1f3"),
-          depth = Some(12),
-        ),
-      )
-
-    val response = service.analyse(AnalysisRequestDto(validFen, Some(12)))
-
-    assertEquals(validFen, response.fen)
-    assertEquals(12, response.depth)
-    assertEquals(Some("e2e4"), response.bestMove)
-    assertEquals(Some(0.3), response.evaluation)
-    assertEquals(None, response.mate)
-    assertEquals(List("e2e4", "e7e5", "g1f3"), response.continuationMoves)
-
-  @Test
-  @DisplayName("analyse uses default depth 12 when not specified")
-  def testAnalyseUsesDefaultDepth(): Unit =
-    when(chessApiClient.analyse(any()))
-      .thenReturn(ChessApiResponseDto(move = Some("d2d4"), depth = Some(12)))
-
-    val response = service.analyse(AnalysisRequestDto(validFen))
-
-    verify(chessApiClient).analyse(ChessApiRequestDto(validFen, 12))
-    assertEquals(12, response.depth)
-
-  @Test
-  @DisplayName("analyse clamps depth to [1, 99]")
-  def testAnalyseClampsDepth(): Unit =
-    when(chessApiClient.analyse(any()))
-      .thenReturn(ChessApiResponseDto(move = Some("e2e4"), depth = Some(99)))
-
-    service.analyse(AnalysisRequestDto(validFen, Some(200)))
-
-    verify(chessApiClient).analyse(ChessApiRequestDto(validFen, 99))
-
-  @Test
-  @DisplayName("analyse clamps depth minimum to 1")
-  def testAnalyseClampsDepthMin(): Unit =
-    when(chessApiClient.analyse(any()))
-      .thenReturn(ChessApiResponseDto(move = Some("e2e4"), depth = Some(1)))
-
-    service.analyse(AnalysisRequestDto(validFen, Some(0)))
-
-    verify(chessApiClient).analyse(ChessApiRequestDto(validFen, 1))
-
-  @Test
-  @DisplayName("analyse handles empty pv gracefully")
-  def testAnalyseEmptyPv(): Unit =
-    when(chessApiClient.analyse(any()))
-      .thenReturn(ChessApiResponseDto(move = Some("e2e4"), pv = None, depth = Some(5)))
-
-    val response = service.analyse(AnalysisRequestDto(validFen, Some(5)))
-
-    assertEquals(List.empty, response.continuationMoves)
-
-  @Test
-  @DisplayName("analyse throws InvalidFenException for empty FEN")
-  def testAnalyseThrowsOnEmptyFen(): Unit =
-    assertThrows(
-      classOf[InvalidFenException],
-      () => service.analyse(AnalysisRequestDto("")),
-    )
-
-  @Test
-  @DisplayName("analyse throws InvalidFenException for malformed FEN")
-  def testAnalyseThrowsOnMalformedFen(): Unit =
-    assertThrows(
-      classOf[InvalidFenException],
-      () => service.analyse(AnalysisRequestDto("not/a/valid/fen")),
-    )
-
-  @Test
-  @DisplayName("analyse wraps chess-api.com exception in AnalysisUpstreamException")
-  def testAnalyseWrapsUpstreamException(): Unit =
-    when(chessApiClient.analyse(any()))
-      .thenThrow(new RuntimeException("connection refused"))
-
-    assertThrows(
-      classOf[AnalysisUpstreamException],
-      () => service.analyse(AnalysisRequestDto(validFen)),
-    )
-
-  @Test
-  @DisplayName("analyse returns mate value from chess-api.com response")
-  def testAnalyseReturnsMate(): Unit =
-    when(chessApiClient.analyse(any()))
-      .thenReturn(
-        ChessApiResponseDto(
-          move = Some("d1h5"),
-          centipawns = None,
-          mate = Some(3),
-          depth = Some(10),
-        ),
-      )
-
-    val response = service.analyse(AnalysisRequestDto(validFen, Some(10)))
-
-    assertEquals(Some(3), response.mate)
-    assertEquals(None, response.evaluation)
-// scalafix:on

modules/analysis/versions.env

@@ -1,3 +0,0 @@
-MAJOR=0
-MINOR=2
-PATCH=0

modules/analytics/CHANGELOG.md

@@ -1,100 +0,0 @@
-##  (2026-06-16)
-
-### Features
-
-* **analytics:** add Dockerfile, CI workflow, and stable jar name for K8s deployment ([95215b6](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/95215b6a420fd526df1aa395f9b087556c8ad03b))
-* **analytics:** add PostgreSQL JDBC write-back to all four batch jobs ([0e0ea4c](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/0e0ea4c9893c6efed52e633e55d05ab3ed004502))
-* **analytics:** add Spark batch analytics module ([259b3bb](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/259b3bbb24c0f23326269b93f4b3c84012f727cd))
-* **analytics:** add Structured Streaming, MLlib clustering, GraphX jobs ([e1d80b9](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/e1d80b9331666feea191b1fd08aa762f3581c918))
-
-### Bug Fixes
-
-* **analytics:** upgrade Spark to 4.0.3 — 3.5.x has no official Docker image ([46af115](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/46af1154de34a8596cb6cb28c6fad7aba90f597c))
-##  (2026-06-19)
-
-### Features
-
-* **analytics:** add Dockerfile, CI workflow, and stable jar name for K8s deployment ([95215b6](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/95215b6a420fd526df1aa395f9b087556c8ad03b))
-* **analytics:** add PostgreSQL JDBC write-back to all four batch jobs ([0e0ea4c](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/0e0ea4c9893c6efed52e633e55d05ab3ed004502))
-* **analytics:** add Spark batch analytics module ([259b3bb](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/259b3bbb24c0f23326269b93f4b3c84012f727cd))
-* **analytics:** add Structured Streaming, MLlib clustering, GraphX jobs ([e1d80b9](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/e1d80b9331666feea191b1fd08aa762f3581c918))
-* **official-bots:** park expert bot on tournament server at startup ([#76](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/76)) ([751a58b](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/751a58b6061f7434115e229a7661894c76768bc2))
-
-### Bug Fixes
-
-* **analytics:** upgrade Spark to 4.0.3 — 3.5.x has no official Docker image ([46af115](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/46af1154de34a8596cb6cb28c6fad7aba90f597c))
-##  (2026-06-21)
-
-### Features
-
-* **analytics:** add Dockerfile, CI workflow, and stable jar name for K8s deployment ([95215b6](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/95215b6a420fd526df1aa395f9b087556c8ad03b))
-* **analytics:** add PostgreSQL JDBC write-back to all four batch jobs ([0e0ea4c](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/0e0ea4c9893c6efed52e633e55d05ab3ed004502))
-* **analytics:** add Spark batch analytics module ([259b3bb](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/259b3bbb24c0f23326269b93f4b3c84012f727cd))
-* **analytics:** add Structured Streaming, MLlib clustering, GraphX jobs ([e1d80b9](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/e1d80b9331666feea191b1fd08aa762f3581c918))
-* **official-bots:** park expert bot on tournament server at startup ([#76](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/76)) ([751a58b](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/751a58b6061f7434115e229a7661894c76768bc2))
-
-### Bug Fixes
-
-* **analytics:** upgrade Spark to 4.0.3 — 3.5.x has no official Docker image ([46af115](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/46af1154de34a8596cb6cb28c6fad7aba90f597c))
-##  (2026-06-21)
-
-### Features
-
-* **analytics:** add 7 new Spark analytics jobs and extend GameSource ([8e17c14](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/8e17c14dff740cd115011dfbf17de35083b8fe46))
-* **analytics:** add Dockerfile, CI workflow, and stable jar name for K8s deployment ([95215b6](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/95215b6a420fd526df1aa395f9b087556c8ad03b))
-* **analytics:** add PostgreSQL JDBC write-back to all four batch jobs ([0e0ea4c](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/0e0ea4c9893c6efed52e633e55d05ab3ed004502))
-* **analytics:** add Spark batch analytics module ([259b3bb](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/259b3bbb24c0f23326269b93f4b3c84012f727cd))
-* **analytics:** add Structured Streaming, MLlib clustering, GraphX jobs ([e1d80b9](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/e1d80b9331666feea191b1fd08aa762f3581c918))
-* **official-bots:** park expert bot on tournament server at startup ([#76](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/76)) ([751a58b](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/751a58b6061f7434115e229a7661894c76768bc2))
-
-### Bug Fixes
-
-* **analytics:** upgrade Spark to 4.0.3 — 3.5.x has no official Docker image ([46af115](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/46af1154de34a8596cb6cb28c6fad7aba90f597c))
-##  (2026-06-21)
-
-### Features
-
-* **analytics:** add 7 new Spark analytics jobs and extend GameSource ([8e17c14](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/8e17c14dff740cd115011dfbf17de35083b8fe46))
-* **analytics:** add Dockerfile, CI workflow, and stable jar name for K8s deployment ([95215b6](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/95215b6a420fd526df1aa395f9b087556c8ad03b))
-* **analytics:** add PostgreSQL JDBC write-back to all four batch jobs ([0e0ea4c](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/0e0ea4c9893c6efed52e633e55d05ab3ed004502))
-* **analytics:** add Spark batch analytics module ([259b3bb](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/259b3bbb24c0f23326269b93f4b3c84012f727cd))
-* **analytics:** add Structured Streaming, MLlib clustering, GraphX jobs ([e1d80b9](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/e1d80b9331666feea191b1fd08aa762f3581c918))
-* **analytics:** always write results to PostgreSQL regardless of input source ([da0e6d1](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/da0e6d1ee2d391ecb6291396f82471eb51b1b25e))
-* **official-bots:** park expert bot on tournament server at startup ([#76](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/76)) ([751a58b](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/751a58b6061f7434115e229a7661894c76768bc2))
-
-### Bug Fixes
-
-* **analytics:** upgrade Spark to 4.0.3 — 3.5.x has no official Docker image ([46af115](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/46af1154de34a8596cb6cb28c6fad7aba90f597c))
-##  (2026-06-21)
-
-### Features
-
-* **analytics:** add 7 new Spark analytics jobs and extend GameSource ([8e17c14](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/8e17c14dff740cd115011dfbf17de35083b8fe46))
-* **analytics:** add Dockerfile, CI workflow, and stable jar name for K8s deployment ([95215b6](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/95215b6a420fd526df1aa395f9b087556c8ad03b))
-* **analytics:** add PostgreSQL JDBC write-back to all four batch jobs ([0e0ea4c](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/0e0ea4c9893c6efed52e633e55d05ab3ed004502))
-* **analytics:** add Spark batch analytics module ([259b3bb](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/259b3bbb24c0f23326269b93f4b3c84012f727cd))
-* **analytics:** add Structured Streaming, MLlib clustering, GraphX jobs ([e1d80b9](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/e1d80b9331666feea191b1fd08aa762f3581c918))
-* **analytics:** always write results to PostgreSQL regardless of input source ([da0e6d1](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/da0e6d1ee2d391ecb6291396f82471eb51b1b25e))
-* **official-bots:** park expert bot on tournament server at startup ([#76](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/76)) ([751a58b](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/751a58b6061f7434115e229a7661894c76768bc2))
-
-### Bug Fixes
-
-* **analytics:** upgrade Spark to 4.0.3 — 3.5.x has no official Docker image ([46af115](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/46af1154de34a8596cb6cb28c6fad7aba90f597c))
-* **analytics:** write decompressed PGN to shared PVC path for executor access ([a268a9a](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/a268a9acb7ba190c76e996ccf3ea3bd00e5cec92))
-##  (2026-06-23)
-
-### Features
-
-* **analytics:** add 7 new Spark analytics jobs and extend GameSource ([8e17c14](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/8e17c14dff740cd115011dfbf17de35083b8fe46))
-* **analytics:** add accuracy and blunder analysis job for Lichess data ([c3e7b82](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/c3e7b82ae806adf5713ce4d267c1155e73a40ff5))
-* **analytics:** add Dockerfile, CI workflow, and stable jar name for K8s deployment ([95215b6](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/95215b6a420fd526df1aa395f9b087556c8ad03b))
-* **analytics:** add PostgreSQL JDBC write-back to all four batch jobs ([0e0ea4c](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/0e0ea4c9893c6efed52e633e55d05ab3ed004502))
-* **analytics:** add Spark batch analytics module ([259b3bb](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/259b3bbb24c0f23326269b93f4b3c84012f727cd))
-* **analytics:** add Structured Streaming, MLlib clustering, GraphX jobs ([e1d80b9](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/e1d80b9331666feea191b1fd08aa762f3581c918))
-* **analytics:** always write results to PostgreSQL regardless of input source ([da0e6d1](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/da0e6d1ee2d391ecb6291396f82471eb51b1b25e))
-* **official-bots:** park expert bot on tournament server at startup ([#76](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/76)) ([751a58b](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/751a58b6061f7434115e229a7661894c76768bc2))
-
-### Bug Fixes
-
-* **analytics:** upgrade Spark to 4.0.3 — 3.5.x has no official Docker image ([46af115](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/46af1154de34a8596cb6cb28c6fad7aba90f597c))
-* **analytics:** write decompressed PGN to shared PVC path for executor access ([a268a9a](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/a268a9acb7ba190c76e996ccf3ea3bd00e5cec92))

modules/analytics/build.gradle.kts

@@ -1,103 +0,0 @@
-// Standalone Spark batch-analytics module.
-//
-// Spark 3.5.x ships only Scala 2.12/2.13 artifacts; Scala 3 code can consume
-// them via JVM binary compatibility so long as we avoid macro-expanded APIs
-// (spark.implicits._, typed Dataset[T]).  We use the untyped DataFrame API
-// exclusively, which is safe to call from Scala 3.
-//
-// Spark is declared compileOnly — the cluster provides it at runtime via
-// spark-submit.  Only the PostgreSQL driver and the Scala 3 runtime are
-// bundled into the fat jar produced by the "jar" task.
-//
-// Build the submission jar:
-//   ./gradlew :modules:analytics:jar
-//
-// Run a job:
-//   spark-submit \
-//     --class de.nowchess.analytics.OpeningBookJob \
-//     modules/analytics/build/libs/analytics-<version>.jar \
-//     [outputDir] [maxPlies]
-//
-// Environment variables consumed:
-//   NOWCHESS_JDBC_URL  (default: jdbc:postgresql://localhost:5432/nowchess)
-//   NOWCHESS_DB_USER   (default: nowchess)
-//   NOWCHESS_DB_PASS   (default: nowchess)
-//   NOWCHESS_PGN_PATH  (optional) — file or http(s) URL of a Lichess PGN dump (.pgn or .pgn.zst).
-//                      When set, all batch jobs read games from the dump instead of PostgreSQL and
-//                      skip JDBC write-back (Parquet/CSV output only). Demo data source.
-
-plugins {
-    id("scala")
-    application
-}
-
-group = "de.nowchess"
-version = "1.0-SNAPSHOT"
-
-@Suppress("UNCHECKED_CAST")
-val versions = rootProject.extra["VERSIONS"] as Map<String, String>
-
-repositories {
-    mavenCentral()
-}
-
-scala {
-    scalaVersion = versions["SCALA3"]!!
-}
-
-val sparkVersion = "4.0.3"
-
-dependencies {
-    compileOnly("org.scala-lang:scala3-compiler_3") {
-        version { strictly(versions["SCALA3"]!!) }
-    }
-    implementation("org.scala-lang:scala3-library_3") {
-        version { strictly(versions["SCALA3"]!!) }
-    }
-    implementation("org.scala-lang:scala-library") {
-        version { strictly(versions["SCALA_LIBRARY"]!!) }
-    }
-
-    // Spark is provided by the cluster — compile-only, not bundled.
-    compileOnly("org.apache.spark:spark-sql_2.13:$sparkVersion") {
-        exclude(group = "org.slf4j", module = "slf4j-log4j12")
-    }
-    compileOnly("org.apache.spark:spark-core_2.13:$sparkVersion") {
-        exclude(group = "org.slf4j", module = "slf4j-log4j12")
-    }
-    compileOnly("org.apache.spark:spark-mllib_2.13:$sparkVersion") {
-        exclude(group = "org.slf4j", module = "slf4j-log4j12")
-    }
-    compileOnly("org.apache.spark:spark-graphx_2.13:$sparkVersion") {
-        exclude(group = "org.slf4j", module = "slf4j-log4j12")
-    }
-
-    // PostgreSQL JDBC driver bundled so it is available on executor classpath.
-    implementation("org.postgresql:postgresql:42.7.4")
-
-    // zstd-jni: decompress Lichess .pgn.zst dumps in-process. Provided at runtime by Spark
-    // (it uses zstd-jni internally for shuffle/event-log compression), so compile-only here.
-    compileOnly("com.github.luben:zstd-jni:1.5.6-9")
-}
-
-application {
-    mainClass.set("de.nowchess.analytics.OpeningBookJob")
-}
-
-// Fat jar: includes runtimeClasspath (our code + pg driver + scala3-library)
-// but NOT compileOnly Spark jars.
-// archiveVersion is cleared so the output is always "analytics.jar" — stable
-// name required by the Dockerfile COPY instruction.
-tasks.jar {
-    archiveBaseName.set("analytics")
-    archiveVersion.set("")
-    manifest {
-        attributes["Main-Class"] = "de.nowchess.analytics.OpeningBookJob"
-    }
-    from(configurations.runtimeClasspath.get().map { if (it.isDirectory) it else zipTree(it) })
-    duplicatesStrategy = DuplicatesStrategy.EXCLUDE
-}
-
-tasks.withType<ScalaCompile> {
-    scalaCompileOptions.additionalParameters = listOf("-encoding", "UTF-8")
-}

modules/analytics/src/main/docker/Dockerfile

@@ -1,9 +0,0 @@
-FROM apache/spark:4.0.3-scala2.13-java17-ubuntu
-
-USER root
-
-# analytics.jar = fat jar containing app code + PostgreSQL JDBC driver + Scala 3 runtime.
-# Spark itself is provided by the base image at /opt/spark — it is NOT included in the jar.
-COPY build/libs/analytics.jar /app/analytics.jar
-
-USER spark

modules/analytics/src/main/scala/de/nowchess/analytics/AccuracyBlunderJob.scala

@@ -1,191 +0,0 @@
-package de.nowchess.analytics
-
-import org.apache.spark.sql.SparkSession
-import org.apache.spark.sql.expressions.Window
-import org.apache.spark.sql.functions as F
-
-/** Per-move accuracy & blunder analysis mined from Lichess `[%eval ...]` move annotations.
-  *
-  * Unlike the flat single-`groupBy` summaries (opening rates, colour advantage), this job reconstructs the *quality of
-  * every move* from the engine evaluations Lichess embeds in the movetext (`{ [%eval 0.24] }`, mate scores `[%eval
-  * #-3]`) and turns them into the same accuracy signals lichess.com surfaces: average centipawn loss (ACPL), and counts
-  * of inaccuracies / mistakes / blunders.
-  *
-  * Pipeline (all Spark SQL string/array functions + window funcs — no UDFs, Catalyst-friendly):
-  *   1. Keep only games carrying `[%eval` comments.
-  *   2. `regexp_extract_all` pulls every eval in ply order; mate scores collapse to ±10 pawns, normal evals are clamped
-  *      to ±10 so a single huge swing cannot dominate the mean. All evals are White-POV pawns.
-  *   3. `posexplode` → one row per ply; a per-game window `lag` gives the eval *before* the move.
-  *   4. Centipawn loss for the side that moved = how much the eval moved against them (white wants it up, black down),
-  *      floored at 0 and scaled to centipawns.
-  *   5. Roll up to (game, side): ACPL + inaccuracy(≥50cp) / mistake(≥100cp) / blunder(≥200cp) counts, tagged with that
-  *      side's Elo and whether they won.
-  *
-  * Outputs (Parquet + CSV + JDBC):
-  *   - `accuracy_by_rating` — ACPL, avg blunders/mistakes/inaccuracies per game and win-rate, per Elo band. Shows how
-  *     move quality scales with rating.
-  *   - `blunder_outcome` — win-rate bucketed by number of blunders in the game. Quantifies "one blunder costs you the
-  *     game".
-  *
-  * Requires the eval-annotated Lichess dump (`NOWCHESS_PGN_PATH` → an evals dump); JDBC games carry no per-move evals.
-  */
-object AccuracyBlunderJob:
-
-  def main(args: Array[String]): Unit =
-    val jdbcUrl   = sys.env.getOrElse("NOWCHESS_JDBC_URL", "jdbc:postgresql://localhost:5432/nowchess")
-    val dbUser    = sys.env.getOrElse("NOWCHESS_DB_USER", "nowchess")
-    val dbPass    = sys.env.getOrElse("NOWCHESS_DB_PASS", "nowchess")
-    val outputDir = if args.length > 0 then args(0) else "/tmp/nowchess-accuracy"
-
-    val spark = SparkSession
-      .builder()
-      .appName("NowChess Accuracy & Blunders")
-      .getOrCreate()
-
-    run(spark, jdbcUrl, dbUser, dbPass, outputDir)
-    spark.stop()
-
-  def run(spark: SparkSession, jdbcUrl: String, dbUser: String, dbPass: String, outputDir: String): Unit =
-    val games = GameSource
-      .loadExtended(spark, jdbcUrl, dbUser, dbPass)
-      .select("pgn", "result", "white_elo", "black_elo")
-      .filter(F.col("result").isNotNull.and(F.col("pgn").contains("[%eval")))
-      .withColumn("game_id", F.monotonically_increasing_id())
-
-    // White-POV pawn evals in ply order; mate → ±10, normal evals clamped to ±10.
-    val evalStrs = F.expr("""regexp_extract_all(pgn, '\\[%eval ([^\\]]+)\\]', 1)""")
-    val evalCps = F.expr(
-      "transform(eval_strs, x -> CASE " +
-        "WHEN x LIKE '#-%' THEN -10.0 " +
-        "WHEN x LIKE '#%' THEN 10.0 " +
-        "ELSE greatest(-10.0, least(10.0, cast(x as double))) END)",
-    )
-
-    val withEvals = games
-      .withColumn("eval_strs", evalStrs)
-      .withColumn("eval_cp", evalCps)
-      .filter(F.size(F.col("eval_cp")) >= 2)
-
-    val plies = withEvals.select(
-      F.col("game_id"),
-      F.col("result"),
-      F.col("white_elo"),
-      F.col("black_elo"),
-      F.posexplode(F.col("eval_cp")).as(Seq("ply", "eval_after")),
-    )
-
-    val byGame     = Window.partitionBy("game_id").orderBy("ply")
-    val mover      = F.when(F.col("ply") % 2 === 0, "white").otherwise("black")
-    val evalBefore = F.coalesce(F.lag("eval_after", 1).over(byGame), F.lit(0.15))
-    val cpl = F.greatest(
-      F.lit(0.0),
-      F.when(F.col("mover") === "white", evalBefore - F.col("eval_after"))
-        .otherwise(F.col("eval_after") - evalBefore),
-    ) * 100
-
-    val moves = plies
-      .withColumn("mover", mover)
-      .withColumn("cpl", cpl)
-
-    val perSide = moves
-      .groupBy("game_id", "mover", "result", "white_elo", "black_elo")
-      .agg(
-        F.round(F.avg("cpl"), 1).as("acpl"),
-        F.sum(F.when(F.col("cpl") >= 200, 1).otherwise(0)).as("blunders"),
-        F.sum(F.when(F.col("cpl") >= 100 && F.col("cpl") < 200, 1).otherwise(0)).as("mistakes"),
-        F.sum(F.when(F.col("cpl") >= 50 && F.col("cpl") < 100, 1).otherwise(0)).as("inaccuracies"),
-      )
-      .withColumn(
-        "self_elo",
-        F.when(F.col("mover") === "white", F.col("white_elo")).otherwise(F.col("black_elo")),
-      )
-      .withColumn("won", F.when(F.col("mover") === F.col("result"), 1).otherwise(0))
-
-    writeAccuracyByRating(perSide, jdbcUrl, dbUser, dbPass, outputDir)
-    writeBlunderOutcome(perSide, jdbcUrl, dbUser, dbPass, outputDir)
-
-  private def writeAccuracyByRating(
-      perSide: org.apache.spark.sql.DataFrame,
-      jdbcUrl: String,
-      dbUser: String,
-      dbPass: String,
-      outputDir: String,
-  ): Unit =
-    val elo = F.col("self_elo")
-    val band = F
-      .when(elo < 1200, "<1200")
-      .when(elo < 1500, "1200–1499")
-      .when(elo < 1800, "1500–1799")
-      .when(elo < 2100, "1800–2099")
-      .otherwise("2100+")
-    val bandOrder = F
-      .when(elo < 1200, 1)
-      .when(elo < 1500, 2)
-      .when(elo < 1800, 3)
-      .when(elo < 2100, 4)
-      .otherwise(5)
-
-    val stats = perSide
-      .filter(elo.isNotNull)
-      .withColumn("band", band)
-      .withColumn("band_order", bandOrder)
-      .groupBy("band", "band_order")
-      .agg(
-        F.count("*").as("player_games"),
-        F.round(F.avg("acpl"), 1).as("avg_acpl"),
-        F.round(F.avg("blunders"), 2).as("avg_blunders"),
-        F.round(F.avg("mistakes"), 2).as("avg_mistakes"),
-        F.round(F.avg("inaccuracies"), 2).as("avg_inaccuracies"),
-        F.round(F.avg("won"), 3).as("win_rate"),
-      )
-      .orderBy(F.asc("band_order"))
-      .drop("band_order")
-
-    write(stats, outputDir, "accuracy_by_rating", jdbcUrl, dbUser, dbPass, "analytics_accuracy_by_rating")
-
-  private def writeBlunderOutcome(
-      perSide: org.apache.spark.sql.DataFrame,
-      jdbcUrl: String,
-      dbUser: String,
-      dbPass: String,
-      outputDir: String,
-  ): Unit =
-    val b      = F.col("blunders")
-    val bucket = F.when(b === 0, "0").when(b === 1, "1").when(b === 2, "2").otherwise("3+")
-    val order  = F.when(b === 0, 0).when(b === 1, 1).when(b === 2, 2).otherwise(3)
-
-    val stats = perSide
-      .withColumn("blunder_bucket", bucket)
-      .withColumn("bucket_order", order)
-      .groupBy("blunder_bucket", "bucket_order")
-      .agg(
-        F.count("*").as("player_games"),
-        F.round(F.avg("won"), 3).as("win_rate"),
-        F.round(F.avg("acpl"), 1).as("avg_acpl"),
-      )
-      .orderBy(F.asc("bucket_order"))
-      .drop("bucket_order")
-
-    write(stats, outputDir, "blunder_outcome", jdbcUrl, dbUser, dbPass, "analytics_blunder_outcome")
-
-  private def write(
-      df: org.apache.spark.sql.DataFrame,
-      outputDir: String,
-      name: String,
-      jdbcUrl: String,
-      dbUser: String,
-      dbPass: String,
-      table: String,
-  ): Unit =
-    df.write.mode("overwrite").parquet(s"$outputDir/$name")
-    df.write.mode("overwrite").option("header", "true").csv(s"$outputDir/${name}_csv")
-    if !GameSource.isPgnMode then
-      df.write
-        .mode("overwrite")
-        .format("jdbc")
-        .option("url", jdbcUrl)
-        .option("dbtable", table)
-        .option("user", dbUser)
-        .option("password", dbPass)
-        .option("driver", "org.postgresql.Driver")
-        .save()

modules/analytics/src/main/scala/de/nowchess/analytics/ClockPressureJob.scala

@@ -1,199 +0,0 @@
-package de.nowchess.analytics
-
-import org.apache.spark.sql.SparkSession
-import org.apache.spark.sql.expressions.Window
-import org.apache.spark.sql.functions as F
-
-/** Time-management & clock-pressure analysis mined from Lichess `[%clk ...]` move annotations.
-  *
-  * Lichess records each player's remaining clock after every move (`{ [%clk 0:02:31] }`). This job reconstructs
-  * per-move thinking time and remaining-time from those stamps to answer questions the existing time-control summary
-  * cannot: how long do players actually think, how often do they fall into time scrambles (<10 s left), how often do
-  * they flag (lose on time), and does burning the clock correlate with winning?
-  *
-  * Pipeline (Spark SQL string/array funcs + window funcs — no UDFs):
-  *   1. `regexp_extract_all` pulls every `h:mm:ss` clock in ply order, converted to seconds.
-  *   2. `posexplode` → one row per ply; even plies are White's clock, odd plies Black's.
-  *   3. A per-(game,side) window `lag` gives the same side's previous clock; the difference is that move's thinking time.
-  *      Remaining clock <10 s marks a time-scramble move.
-  *   4. Roll up to (game, side): avg move time, scramble fraction, min clock, Elo, win flag, and whether the side lost on
-  *      time (`Termination "Time forfeit"`).
-  *
-  * Outputs (Parquet + CSV + JDBC):
-  *   - `clock_by_rating` — avg move time, scramble fraction, flag-loss rate and win-rate per Elo band.
-  *   - `scramble_outcome` — win-rate bucketed by how much of the game was played in time-scramble. Quantifies the cost of
-  *     time trouble.
-  *
-  * Requires a clock-annotated Lichess dump (`NOWCHESS_PGN_PATH`).
-  */
-object ClockPressureJob:
-
-  def main(args: Array[String]): Unit =
-    val jdbcUrl   = sys.env.getOrElse("NOWCHESS_JDBC_URL", "jdbc:postgresql://localhost:5432/nowchess")
-    val dbUser    = sys.env.getOrElse("NOWCHESS_DB_USER", "nowchess")
-    val dbPass    = sys.env.getOrElse("NOWCHESS_DB_PASS", "nowchess")
-    val outputDir = if args.length > 0 then args(0) else "/tmp/nowchess-clock-pressure"
-
-    val spark = SparkSession
-      .builder()
-      .appName("NowChess Clock Pressure")
-      .getOrCreate()
-
-    run(spark, jdbcUrl, dbUser, dbPass, outputDir)
-    spark.stop()
-
-  def run(spark: SparkSession, jdbcUrl: String, dbUser: String, dbPass: String, outputDir: String): Unit =
-    val games = GameSource
-      .loadExtended(spark, jdbcUrl, dbUser, dbPass)
-      .select("pgn", "result", "white_elo", "black_elo", "termination")
-      .filter(F.col("result").isNotNull.and(F.col("pgn").contains("[%clk")))
-      .withColumn("game_id", F.monotonically_increasing_id())
-
-    val clkStrs = F.expr("""regexp_extract_all(pgn, '\\[%clk ([^\\]]+)\\]', 1)""")
-    // "h:mm:ss" → seconds.
-    val clkSecs = F.expr(
-      "transform(clk_strs, x -> " +
-        "cast(split(x, ':')[0] as double) * 3600 + " +
-        "cast(split(x, ':')[1] as double) * 60 + " +
-        "cast(split(x, ':')[2] as double))",
-    )
-
-    val withClk = games
-      .withColumn("clk_strs", clkStrs)
-      .withColumn("clk_sec", clkSecs)
-      .filter(F.size(F.col("clk_sec")) >= 4)
-
-    val plies = withClk.select(
-      F.col("game_id"),
-      F.col("result"),
-      F.col("white_elo"),
-      F.col("black_elo"),
-      F.col("termination"),
-      F.posexplode(F.col("clk_sec")).as(Seq("ply", "clk_after")),
-    )
-
-    val mover    = F.when(F.col("ply") % 2 === 0, "white").otherwise("black")
-    val bySide   = Window.partitionBy("game_id", "mover").orderBy("ply")
-    val moveTime = F.lag("clk_after", 1).over(bySide) - F.col("clk_after")
-
-    val moves = plies
-      .withColumn("mover", mover)
-      .withColumn("move_time", moveTime)
-
-    val perSide = moves
-      .groupBy("game_id", "mover", "result", "white_elo", "black_elo", "termination")
-      .agg(
-        F.round(F.avg("move_time"), 1).as("avg_move_time"),
-        F.count("*").as("moves"),
-        F.round(F.min("clk_after"), 1).as("min_clk"),
-        F.sum(F.when(F.col("clk_after") < 10, 1).otherwise(0)).as("scramble_moves"),
-      )
-      .withColumn("scramble_fraction", F.round(F.col("scramble_moves") / F.col("moves"), 3))
-      .withColumn(
-        "self_elo",
-        F.when(F.col("mover") === "white", F.col("white_elo")).otherwise(F.col("black_elo")),
-      )
-      .withColumn("won", F.when(F.col("mover") === F.col("result"), 1).otherwise(0))
-      .withColumn(
-        "flag_loss",
-        F.when(
-          F.coalesce(F.col("termination"), F.lit("")).contains("Time forfeit") && F.col("won") === 0,
-          1,
-        ).otherwise(0),
-      )
-
-    writeClockByRating(perSide, jdbcUrl, dbUser, dbPass, outputDir)
-    writeScrambleOutcome(perSide, jdbcUrl, dbUser, dbPass, outputDir)
-
-  private def writeClockByRating(
-      perSide: org.apache.spark.sql.DataFrame,
-      jdbcUrl: String,
-      dbUser: String,
-      dbPass: String,
-      outputDir: String,
-  ): Unit =
-    val elo = F.col("self_elo")
-    val band = F
-      .when(elo < 1200, "<1200")
-      .when(elo < 1500, "1200–1499")
-      .when(elo < 1800, "1500–1799")
-      .when(elo < 2100, "1800–2099")
-      .otherwise("2100+")
-    val bandOrder = F
-      .when(elo < 1200, 1)
-      .when(elo < 1500, 2)
-      .when(elo < 1800, 3)
-      .when(elo < 2100, 4)
-      .otherwise(5)
-
-    val stats = perSide
-      .filter(elo.isNotNull)
-      .withColumn("band", band)
-      .withColumn("band_order", bandOrder)
-      .groupBy("band", "band_order")
-      .agg(
-        F.count("*").as("player_games"),
-        F.round(F.avg("avg_move_time"), 1).as("avg_move_time_s"),
-        F.round(F.avg("scramble_fraction"), 3).as("avg_scramble_fraction"),
-        F.round(F.avg("flag_loss"), 3).as("flag_loss_rate"),
-        F.round(F.avg("won"), 3).as("win_rate"),
-      )
-      .orderBy(F.asc("band_order"))
-      .drop("band_order")
-
-    write(stats, outputDir, "clock_by_rating", jdbcUrl, dbUser, dbPass, "analytics_clock_by_rating")
-
-  private def writeScrambleOutcome(
-      perSide: org.apache.spark.sql.DataFrame,
-      jdbcUrl: String,
-      dbUser: String,
-      dbPass: String,
-      outputDir: String,
-  ): Unit =
-    val sf = F.col("scramble_fraction")
-    val bucket = F
-      .when(sf === 0, "none")
-      .when(sf < 0.05, "<5%")
-      .when(sf < 0.20, "5–20%")
-      .otherwise(">20%")
-    val order = F
-      .when(sf === 0, 0)
-      .when(sf < 0.05, 1)
-      .when(sf < 0.20, 2)
-      .otherwise(3)
-
-    val stats = perSide
-      .withColumn("scramble_bucket", bucket)
-      .withColumn("bucket_order", order)
-      .groupBy("scramble_bucket", "bucket_order")
-      .agg(
-        F.count("*").as("player_games"),
-        F.round(F.avg("won"), 3).as("win_rate"),
-        F.round(F.avg("flag_loss"), 3).as("flag_loss_rate"),
-      )
-      .orderBy(F.asc("bucket_order"))
-      .drop("bucket_order")
-
-    write(stats, outputDir, "scramble_outcome", jdbcUrl, dbUser, dbPass, "analytics_scramble_outcome")
-
-  private def write(
-      df: org.apache.spark.sql.DataFrame,
-      outputDir: String,
-      name: String,
-      jdbcUrl: String,
-      dbUser: String,
-      dbPass: String,
-      table: String,
-  ): Unit =
-    df.write.mode("overwrite").parquet(s"$outputDir/$name")
-    df.write.mode("overwrite").option("header", "true").csv(s"$outputDir/${name}_csv")
-    if !GameSource.isPgnMode then
-      df.write
-        .mode("overwrite")
-        .format("jdbc")
-        .option("url", jdbcUrl)
-        .option("dbtable", table)
-        .option("user", dbUser)
-        .option("password", dbPass)
-        .option("driver", "org.postgresql.Driver")
-        .save()

modules/analytics/src/main/scala/de/nowchess/analytics/ColorAdvantageJob.scala

@@ -1,72 +0,0 @@
-package de.nowchess.analytics
-
-import org.apache.spark.sql.Row
-import org.apache.spark.sql.SparkSession
-import org.apache.spark.sql.functions as F
-import org.apache.spark.sql.types.DataTypes
-import org.apache.spark.sql.types.StructField
-import org.apache.spark.sql.types.StructType
-
-import scala.jdk.CollectionConverters.*
-
-object ColorAdvantageJob:
-
-  def main(args: Array[String]): Unit =
-    val jdbcUrl   = sys.env.getOrElse("NOWCHESS_JDBC_URL", "jdbc:postgresql://localhost:5432/nowchess")
-    val dbUser    = sys.env.getOrElse("NOWCHESS_DB_USER", "nowchess")
-    val dbPass    = sys.env.getOrElse("NOWCHESS_DB_PASS", "nowchess")
-    val outputDir = if args.length > 0 then args(0) else "/tmp/nowchess-color-advantage"
-
-    val spark = SparkSession
-      .builder()
-      .appName("NowChess Color Advantage")
-      .getOrCreate()
-
-    run(spark, jdbcUrl, dbUser, dbPass, outputDir)
-    spark.stop()
-
-  def run(spark: SparkSession, jdbcUrl: String, dbUser: String, dbPass: String, outputDir: String): Unit =
-    val games = GameSource
-      .load(spark, jdbcUrl, dbUser, dbPass)
-      .select("result")
-      .filter(F.col("result").isNotNull)
-
-    val totalGames = games.count()
-    val whiteWins  = games.filter(F.col("result") === "white").count()
-    val blackWins  = games.filter(F.col("result") === "black").count()
-    val draws      = games.filter(F.col("result") === "draw").count()
-
-    val schema = StructType(
-      Seq(
-        StructField("color", DataTypes.StringType, false),
-        StructField("total_games", DataTypes.LongType, false),
-        StructField("wins", DataTypes.LongType, false),
-        StructField("losses", DataTypes.LongType, false),
-        StructField("draws", DataTypes.LongType, false),
-      ),
-    )
-
-    val rows = List(
-      Row("white", totalGames, whiteWins, blackWins, draws),
-      Row("black", totalGames, blackWins, whiteWins, draws),
-    )
-
-    val stats = spark
-      .createDataFrame(rows.asJava, schema)
-      .withColumn("win_rate", F.round(F.col("wins") / F.col("total_games").cast("double"), 3))
-      .orderBy(F.asc("color"))
-
-    stats.write
-      .mode("overwrite")
-      .option("header", "true")
-      .csv(s"$outputDir/color_advantage")
-
-    stats.write
-      .mode("overwrite")
-      .format("jdbc")
-      .option("url", jdbcUrl)
-      .option("dbtable", "analytics_color_advantage")
-      .option("user", dbUser)
-      .option("password", dbPass)
-      .option("driver", "org.postgresql.Driver")
-      .save()

modules/analytics/src/main/scala/de/nowchess/analytics/DailyActivityJob.scala

@@ -1,99 +0,0 @@
-package de.nowchess.analytics
-
-import org.apache.spark.sql.SparkSession
-import org.apache.spark.sql.functions as F
-
-object DailyActivityJob:
-
-  def main(args: Array[String]): Unit =
-    val jdbcUrl   = sys.env.getOrElse("NOWCHESS_JDBC_URL", "jdbc:postgresql://localhost:5432/nowchess")
-    val dbUser    = sys.env.getOrElse("NOWCHESS_DB_USER", "nowchess")
-    val dbPass    = sys.env.getOrElse("NOWCHESS_DB_PASS", "nowchess")
-    val outputDir = if args.length > 0 then args(0) else "/tmp/nowchess-daily-activity"
-
-    val spark = SparkSession
-      .builder()
-      .appName("NowChess Daily Activity")
-      .getOrCreate()
-
-    run(spark, jdbcUrl, dbUser, dbPass, outputDir)
-    spark.stop()
-
-  def run(spark: SparkSession, jdbcUrl: String, dbUser: String, dbPass: String, outputDir: String): Unit =
-    val games = GameSource
-      .loadExtended(spark, jdbcUrl, dbUser, dbPass)
-      .select("result", "utc_date", "utc_time")
-      .filter(F.col("utc_time").isNotNull.and(F.col("utc_date").isNotNull))
-
-    val hourOfDay = F.regexp_extract(F.col("utc_time"), "^(\\d{2})", 1).cast("int")
-    val dow       = F.dayofweek(F.to_date(F.col("utc_date"), "yyyy.MM.dd"))
-
-    val tagged = games
-      .withColumn("hour_of_day", hourOfDay)
-      .withColumn("dow", dow)
-
-    val hourly = tagged
-      .groupBy("hour_of_day")
-      .agg(
-        F.count("*").as("total_games"),
-        F.sum(F.when(F.col("result") === "white", 1).otherwise(0)).as("white_wins"),
-        F.sum(F.when(F.col("result") === "black", 1).otherwise(0)).as("black_wins"),
-        F.sum(F.when(F.col("result") === "draw", 1).otherwise(0)).as("draws"),
-      )
-      .withColumn("white_win_rate", F.round(F.col("white_wins") / F.col("total_games").cast("double"), 3))
-      .orderBy(F.asc("hour_of_day"))
-      .select("hour_of_day", "total_games", "white_wins", "black_wins", "draws", "white_win_rate")
-
-    hourly.write
-      .mode("overwrite")
-      .option("header", "true")
-      .csv(s"$outputDir/hourly_activity")
-
-    hourly.write
-      .mode("overwrite")
-      .format("jdbc")
-      .option("url", jdbcUrl)
-      .option("dbtable", "analytics_hourly_activity")
-      .option("user", dbUser)
-      .option("password", dbPass)
-      .option("driver", "org.postgresql.Driver")
-      .save()
-
-    val dayName = F
-      .when(F.col("dow") === 1, "Sunday")
-      .when(F.col("dow") === 2, "Monday")
-      .when(F.col("dow") === 3, "Tuesday")
-      .when(F.col("dow") === 4, "Wednesday")
-      .when(F.col("dow") === 5, "Thursday")
-      .when(F.col("dow") === 6, "Friday")
-      .otherwise("Saturday")
-
-    val weekly = tagged
-      .withColumn("day_of_week", dayName)
-      .withColumn("day_order", F.col("dow"))
-      .groupBy("day_of_week", "day_order")
-      .agg(
-        F.count("*").as("total_games"),
-        F.sum(F.when(F.col("result") === "white", 1).otherwise(0)).as("white_wins"),
-        F.sum(F.when(F.col("result") === "black", 1).otherwise(0)).as("black_wins"),
-        F.sum(F.when(F.col("result") === "draw", 1).otherwise(0)).as("draws"),
-      )
-      .withColumn("white_win_rate", F.round(F.col("white_wins") / F.col("total_games").cast("double"), 3))
-      .orderBy(F.asc("day_order"))
-      .drop("day_order")
-      .select("day_of_week", "total_games", "white_wins", "black_wins", "draws", "white_win_rate")
-
-    weekly.write
-      .mode("overwrite")
-      .option("header", "true")
-      .csv(s"$outputDir/weekly_activity")
-
-    weekly.write
-      .mode("overwrite")
-      .format("jdbc")
-      .option("url", jdbcUrl)
-      .option("dbtable", "analytics_weekly_activity")
-      .option("user", dbUser)
-      .option("password", dbPass)
-      .option("driver", "org.postgresql.Driver")
-      .save()

modules/analytics/src/main/scala/de/nowchess/analytics/EloDistributionJob.scala

@@ -1,58 +0,0 @@
-package de.nowchess.analytics
-
-import org.apache.spark.sql.SparkSession
-import org.apache.spark.sql.functions as F
-
-object EloDistributionJob:
-
-  def main(args: Array[String]): Unit =
-    val jdbcUrl   = sys.env.getOrElse("NOWCHESS_JDBC_URL", "jdbc:postgresql://localhost:5432/nowchess")
-    val dbUser    = sys.env.getOrElse("NOWCHESS_DB_USER", "nowchess")
-    val dbPass    = sys.env.getOrElse("NOWCHESS_DB_PASS", "nowchess")
-    val outputDir = if args.length > 0 then args(0) else "/tmp/nowchess-elo-distribution"
-
-    val spark = SparkSession
-      .builder()
-      .appName("NowChess Elo Distribution")
-      .getOrCreate()
-
-    run(spark, jdbcUrl, dbUser, dbPass, outputDir)
-    spark.stop()
-
-  def run(spark: SparkSession, jdbcUrl: String, dbUser: String, dbPass: String, outputDir: String): Unit =
-    val games = GameSource
-      .loadExtended(spark, jdbcUrl, dbUser, dbPass)
-      .filter(F.col("white_elo").isNotNull)
-
-    val whiteElo = games.select(F.col("white_elo").as("elo"))
-    val blackElo = games.select(F.col("black_elo").as("elo"))
-    val allElo   = whiteElo.union(blackElo).filter(F.col("elo").isNotNull)
-
-    val bucketMin = (F.floor(F.col("elo") / 200) * 200).cast("int")
-    val bucketLabel = F.when(
-      F.col("elo") >= 2800,
-      F.lit("2800+"),
-    ).otherwise(F.concat(bucketMin.cast("string"), F.lit("-"), (bucketMin + 199).cast("string")))
-
-    val distribution = allElo
-      .withColumn("elo_bucket", bucketLabel)
-      .withColumn("bucket_order", F.when(F.col("elo") >= 2800, 2800).otherwise(bucketMin))
-      .groupBy("elo_bucket", "bucket_order")
-      .agg(F.count("*").as("player_count"))
-      .orderBy(F.asc("bucket_order"))
-      .select("elo_bucket", "player_count")
-
-    distribution.write
-      .mode("overwrite")
-      .option("header", "true")
-      .csv(s"$outputDir/elo_distribution")
-
-    distribution.write
-      .mode("overwrite")
-      .format("jdbc")
-      .option("url", jdbcUrl)
-      .option("dbtable", "analytics_elo_distribution")
-      .option("user", dbUser)
-      .option("password", dbPass)
-      .option("driver", "org.postgresql.Driver")
-      .save()

modules/analytics/src/main/scala/de/nowchess/analytics/GameLengthJob.scala

@@ -1,111 +0,0 @@
-package de.nowchess.analytics
-
-import org.apache.spark.sql.SparkSession
-import org.apache.spark.sql.functions as F
-
-object GameLengthJob:
-
-  def main(args: Array[String]): Unit =
-    val jdbcUrl   = sys.env.getOrElse("NOWCHESS_JDBC_URL", "jdbc:postgresql://localhost:5432/nowchess")
-    val dbUser    = sys.env.getOrElse("NOWCHESS_DB_USER", "nowchess")
-    val dbPass    = sys.env.getOrElse("NOWCHESS_DB_PASS", "nowchess")
-    val outputDir = if args.length > 0 then args(0) else "/tmp/nowchess-game-length"
-
-    val spark = SparkSession
-      .builder()
-      .appName("NowChess Game Length")
-      .getOrCreate()
-
-    run(spark, jdbcUrl, dbUser, dbPass, outputDir)
-    spark.stop()
-
-  def run(spark: SparkSession, jdbcUrl: String, dbUser: String, dbPass: String, outputDir: String): Unit =
-    val games = GameSource
-      .load(spark, jdbcUrl, dbUser, dbPass)
-      .select("result", "move_count")
-      .filter(F.col("result").isNotNull.and(F.col("move_count").isNotNull))
-
-    val moves = F.col("move_count")
-    val bucket = F
-      .when(moves <= 10, "1-10")
-      .when(moves <= 20, "11-20")
-      .when(moves <= 30, "21-30")
-      .when(moves <= 40, "31-40")
-      .when(moves <= 60, "41-60")
-      .when(moves <= 100, "61-100")
-      .otherwise("101+")
-    val bucketOrder = F
-      .when(moves <= 10, 1)
-      .when(moves <= 20, 2)
-      .when(moves <= 30, 3)
-      .when(moves <= 40, 4)
-      .when(moves <= 60, 5)
-      .when(moves <= 100, 6)
-      .otherwise(7)
-
-    val tagged = games
-      .withColumn("move_bucket", bucket)
-      .withColumn("bucket_order", bucketOrder)
-
-    val distribution = tagged
-      .groupBy("move_bucket", "bucket_order")
-      .agg(
-        F.count("*").as("total_games"),
-        F.sum(F.when(F.col("result") === "white", 1).otherwise(0)).as("white_wins"),
-        F.sum(F.when(F.col("result") === "black", 1).otherwise(0)).as("black_wins"),
-        F.sum(F.when(F.col("result") === "draw", 1).otherwise(0)).as("draws"),
-      )
-      .withColumn("white_win_rate", F.round(F.col("white_wins") / F.col("total_games").cast("double"), 3))
-      .withColumn("black_win_rate", F.round(F.col("black_wins") / F.col("total_games").cast("double"), 3))
-      .withColumn("draw_rate", F.round(F.col("draws") / F.col("total_games").cast("double"), 3))
-      .orderBy(F.asc("bucket_order"))
-      .drop("bucket_order")
-      .select(
-        "move_bucket",
-        "total_games",
-        "white_wins",
-        "black_wins",
-        "draws",
-        "white_win_rate",
-        "black_win_rate",
-        "draw_rate",
-      )
-
-    distribution.write
-      .mode("overwrite")
-      .option("header", "true")
-      .csv(s"$outputDir/game_length_distribution")
-
-    distribution.write
-      .mode("overwrite")
-      .format("jdbc")
-      .option("url", jdbcUrl)
-      .option("dbtable", "analytics_game_length_distribution")
-      .option("user", dbUser)
-      .option("password", dbPass)
-      .option("driver", "org.postgresql.Driver")
-      .save()
-
-    val byResult = games
-      .groupBy("result")
-      .agg(
-        F.round(F.avg("move_count"), 1).as("avg_move_count"),
-        F.min("move_count").as("min_moves"),
-        F.max("move_count").as("max_moves"),
-      )
-      .orderBy(F.asc("result"))
-
-    byResult.write
-      .mode("overwrite")
-      .option("header", "true")
-      .csv(s"$outputDir/game_length_by_result")
-
-    byResult.write
-      .mode("overwrite")
-      .format("jdbc")
-      .option("url", jdbcUrl)
-      .option("dbtable", "analytics_game_length_by_result")
-      .option("user", dbUser)
-      .option("password", dbPass)
-      .option("driver", "org.postgresql.Driver")
-      .save()

modules/analytics/src/main/scala/de/nowchess/analytics/GameSource.scala

@@ -1,186 +0,0 @@
-package de.nowchess.analytics
-
-import org.apache.spark.SparkFiles
-import org.apache.spark.sql.DataFrame
-import org.apache.spark.sql.SparkSession
-import org.apache.spark.sql.functions as F
-
-/** Normalised game-record source for the batch jobs.
-  *
-  * Every batch job consumes the same five-column shape:
-  *   - white_id, black_id : player identifiers
-  *   - result : one of "white", "black", "draw"
-  *   - move_count : number of plies
-  *   - pgn : full PGN ("[Event …]…\n\n1. e4 …"), header and movetext separated by a blank line
-  *
-  * Two backends, selected by the `NOWCHESS_PGN_PATH` environment variable:
-  *   - unset → PostgreSQL `game_records` table (production)
-  *   - set → a Lichess PGN dump file/URL (demo). Point it at a `lichess_db_standard_rated_*.pgn[.zst]` to drive every
-  *     batch job from real Lichess games.
-  *
-  * Lichess parsing uses only Spark SQL string functions — no UDFs — so Catalyst can push predicates, matching the
-  * no-UDF approach already used in OpeningBookJob.
-  */
-object GameSource:
-
-  private val PgnPathEnv = "NOWCHESS_PGN_PATH"
-
-  /** True when a Lichess PGN dump is configured; jobs use this to skip JDBC write-back. */
-  def isPgnMode: Boolean = sys.env.contains(PgnPathEnv)
-
-  def load(spark: SparkSession, jdbcUrl: String, dbUser: String, dbPass: String): DataFrame =
-    sys.env.get(PgnPathEnv) match
-      case Some(path) => fromLichessPgn(spark, path)
-      case None       => fromJdbc(spark, jdbcUrl, dbUser, dbPass)
-
-  def loadExtended(spark: SparkSession, jdbcUrl: String, dbUser: String, dbPass: String): DataFrame =
-    sys.env.get(PgnPathEnv) match
-      case Some(path) => fromLichessPgnExtended(spark, path)
-      case None =>
-        fromJdbc(spark, jdbcUrl, dbUser, dbPass)
-          .withColumn("white_elo", F.lit(null).cast("int"))
-          .withColumn("black_elo", F.lit(null).cast("int"))
-          .withColumn("time_control", F.lit(null).cast("string"))
-          .withColumn("utc_date", F.lit(null).cast("string"))
-          .withColumn("utc_time", F.lit(null).cast("string"))
-          .withColumn("termination", F.lit(null).cast("string"))
-          .withColumn("eco", F.lit(null).cast("string"))
-
-  def fromJdbc(spark: SparkSession, jdbcUrl: String, dbUser: String, dbPass: String): DataFrame =
-    spark.read
-      .format("jdbc")
-      .option("url", jdbcUrl)
-      .option("dbtable", "game_records")
-      .option("user", dbUser)
-      .option("password", dbPass)
-      .option("driver", "org.postgresql.Driver")
-      .option("fetchsize", "10000")
-      .load()
-      .select("white_id", "black_id", "result", "move_count", "pgn")
-
-  /** Parses a Lichess PGN dump into the normalised game shape.
-    *
-    * `path` may be:
-    *   - an http(s)/ftp URL — fetched once via SparkContext.addFile and distributed to executors, then read from the
-    *     local replica (no S3/PVC needed; handy for a staging demo)
-    *   - any Hadoop-readable path (file://, hdfs://, s3a://, …)
-    *
-    * `.zst` dumps (Lichess' native format) are decompressed in-process via zstd-jni; `.gz`/`.bz2` are handled by
-    * Spark's text reader codecs.
-    *
-    * Records are split on the "[Event " tag that opens every game, so each row holds one complete game (the empty
-    * fragment before the first game is filtered out). Header tags are read with regexp_extract; the movetext (after the
-    * blank line) is cleaned of clock/eval comments and move numbers to count plies.
-    */
-  def fromLichessPgn(spark: SparkSession, path: String): DataFrame =
-    val resolved = resolvePath(spark, path)
-    val record   = F.col("value")
-
-    val resultTag = F.regexp_extract(record, "Result \"([^\"]*)\"", 1)
-    val result = F
-      .when(resultTag === "1-0", "white")
-      .when(resultTag === "0-1", "black")
-      .when(resultTag === "1/2-1/2", "draw")
-      .otherwise(F.lit(null).cast("string"))
-
-    val moveText  = F.coalesce(F.split(record, "\n\n").getItem(1), F.lit(""))
-    val noComment = F.regexp_replace(moveText, "\\{[^}]*\\}", "")
-    val noResult  = F.regexp_replace(noComment, "(1-0|0-1|1/2-1/2|\\*)", "")
-    val noNumbers = F.regexp_replace(noResult, "\\d+\\.+", " ")
-    val plies     = F.size(F.filter(F.split(F.trim(noNumbers), "\\s+"), tok => F.length(tok) > 0))
-
-    spark.read
-      .option("lineSep", "[Event ")
-      .text(resolved)
-      .filter(F.length(F.trim(record)) > 0)
-      .select(
-        F.regexp_extract(record, "White \"([^\"]*)\"", 1).as("white_id"),
-        F.regexp_extract(record, "Black \"([^\"]*)\"", 1).as("black_id"),
-        result.as("result"),
-        plies.as("move_count"),
-        F.concat(F.lit("[Event "), record).as("pgn"),
-      )
-      .filter((F.col("white_id") =!= "").and(F.col("black_id") =!= ""))
-
-  private def fromLichessPgnExtended(spark: SparkSession, path: String): DataFrame =
-    val resolved = resolvePath(spark, path)
-    val record   = F.col("value")
-
-    val resultTag = F.regexp_extract(record, "Result \"([^\"]*)\"", 1)
-    val result = F
-      .when(resultTag === "1-0", "white")
-      .when(resultTag === "0-1", "black")
-      .when(resultTag === "1/2-1/2", "draw")
-      .otherwise(F.lit(null).cast("string"))
-
-    val moveText  = F.coalesce(F.split(record, "\n\n").getItem(1), F.lit(""))
-    val noComment = F.regexp_replace(moveText, "\\{[^}]*\\}", "")
-    val noResult  = F.regexp_replace(noComment, "(1-0|0-1|1/2-1/2|\\*)", "")
-    val noNumbers = F.regexp_replace(noResult, "\\d+\\.+", " ")
-    val plies     = F.size(F.filter(F.split(F.trim(noNumbers), "\\s+"), tok => F.length(tok) > 0))
-
-    def nullable(extracted: org.apache.spark.sql.Column): org.apache.spark.sql.Column =
-      F.when(F.length(extracted) > 0, extracted).otherwise(F.lit(null).cast("string"))
-
-    val whiteElo = nullable(F.regexp_extract(record, "WhiteElo \"([^\"]*)\"", 1)).cast("int")
-    val blackElo = nullable(F.regexp_extract(record, "BlackElo \"([^\"]*)\"", 1)).cast("int")
-
-    spark.read
-      .option("lineSep", "[Event ")
-      .text(resolved)
-      .filter(F.length(F.trim(record)) > 0)
-      .select(
-        F.regexp_extract(record, "White \"([^\"]*)\"", 1).as("white_id"),
-        F.regexp_extract(record, "Black \"([^\"]*)\"", 1).as("black_id"),
-        result.as("result"),
-        plies.as("move_count"),
-        F.concat(F.lit("[Event "), record).as("pgn"),
-        whiteElo.as("white_elo"),
-        blackElo.as("black_elo"),
-        nullable(F.regexp_extract(record, "TimeControl \"([^\"]*)\"", 1)).as("time_control"),
-        nullable(F.regexp_extract(record, "UTCDate \"([^\"]*)\"", 1)).as("utc_date"),
-        nullable(F.regexp_extract(record, "UTCTime \"([^\"]*)\"", 1)).as("utc_time"),
-        nullable(F.regexp_extract(record, "Termination \"([^\"]*)\"", 1)).as("termination"),
-        nullable(F.regexp_extract(record, "ECO \"([^\"]*)\"", 1)).as("eco"),
-      )
-      .filter((F.col("white_id") =!= "").and(F.col("black_id") =!= ""))
-
-  /** Turns an http(s)/ftp URL into a path readable by all executors.
-    *
-    * Downloads the file once on the driver, decompresses `.zst` if needed, then writes the result to
-    * `NOWCHESS_PGN_CACHE_DIR` (default `/tmp`). That directory must be on a filesystem shared between the driver pod
-    * and all executor pods — in the k8s deployment this is the `spark-analytics-output` PVC mounted at
-    * `/spark-output`, so set `NOWCHESS_PGN_CACHE_DIR=/spark-output/.pgn-cache`.
-    *
-    * Skips download if the destination file already exists (cache-friendly for repeated runs).
-    * Non-URL paths are returned unchanged.
-    */
-  private def resolvePath(spark: SparkSession, path: String): String =
-    if !path.matches("^(https?|ftp)://.*") then path
-    else
-      val cacheDir = sys.env.getOrElse("NOWCHESS_PGN_CACHE_DIR", "/tmp")
-      val destName = baseName(path).stripSuffix(".zst")
-      val destPath = s"$cacheDir/$destName"
-      if !java.io.File(destPath).exists() then
-        spark.sparkContext.addFile(path)
-        val downloaded = SparkFiles.get(baseName(path))
-        if downloaded.endsWith(".zst") then decompressZstd(downloaded, destPath)
-        else
-          java.io.File(destPath).getParentFile.mkdirs()
-          java.nio.file.Files.copy(
-            java.nio.file.Paths.get(downloaded),
-            java.io.File(destPath).toPath,
-            java.nio.file.StandardCopyOption.REPLACE_EXISTING,
-          )
-      "file://" + destPath
-
-  private def baseName(path: String): String = path.substring(path.lastIndexOf('/') + 1)
-
-  /** Decompresses a `.zst` file to `destPath` using zstd-jni (bundled with Spark at runtime). */
-  private def decompressZstd(srcPath: String, destPath: String): Unit =
-    java.io.File(destPath).getParentFile.mkdirs()
-    val in = com.github.luben.zstd.ZstdInputStream(
-      java.io.BufferedInputStream(java.io.FileInputStream(srcPath)),
-    )
-    try java.nio.file.Files.copy(in, java.io.File(destPath).toPath, java.nio.file.StandardCopyOption.REPLACE_EXISTING)
-    finally in.close()

modules/analytics/src/main/scala/de/nowchess/analytics/LiveDashboardJob.scala

@@ -1,138 +0,0 @@
-package de.nowchess.analytics
-
-import org.apache.spark.sql.SparkSession
-import org.apache.spark.sql.functions as F
-import org.apache.spark.sql.streaming.Trigger
-
-/** Demonstrates Spark Structured Streaming on NowChess game-over events.
-  *
-  * Spark concepts shown:
-  *   - Continuous micro-batch processing (`readStream`)
-  *   - Watermarking for late-data tolerance (events up to 45 s late are accepted)
-  *   - Tumbling window aggregations — fixed 1-minute buckets, zero overlap
-  *   - Sliding window aggregations — 5-minute window, 1-minute slide
-  *   - Append vs Update output modes and when each is valid
-  *   - Exactly-once fault tolerance via checkpointing
-  *   - Multiple concurrent streaming queries on the same session
-  *
-  * Production wiring: NowChess already publishes game-over events to a Redis Stream (`nowchess:game-over`, see
-  * GameRedisPublisher). Swap the `rate` source below for one of the production sources shown in the comment block.
-  */
-object LiveDashboardJob:
-
-  def main(args: Array[String]): Unit =
-    val outputDir = if args.length > 0 then args(0) else "/tmp/nowchess-live-dashboard"
-
-    val spark = SparkSession
-      .builder()
-      .appName("NowChess Live Dashboard")
-      .getOrCreate()
-
-    run(spark, outputDir)
-
-  def run(spark: SparkSession, outputDir: String): Unit =
-
-    // ── Production sources (replace rate source with one of these) ─────────
-    //
-    // Kafka (via a Redis → Kafka bridge):
-    //   spark.readStream
-    //     .format("kafka")
-    //     .option("kafka.bootstrap.servers", sys.env("KAFKA_BROKERS"))
-    //     .option("subscribe", "nowchess.game-over")
-    //     .load()
-    //     .select(F.from_json(F.col("value").cast("string"), gameOverSchema).as("e"))
-    //     .select("e.*")
-    //
-    // spark-redis (com.redislabs:spark-redis:3.1.0):
-    //   spark.readStream
-    //     .format("redis")
-    //     .option("stream.keys", "nowchess:game-over")
-    //     .schema(gameOverSchema)
-    //     .load()
-    // ─────────────────────────────────────────────────────────────────────
-
-    // Simulated stream: 10 game-over events / second.
-    // `rate` source emits (timestamp: Timestamp, value: Long) — Spark built-in, no deps.
-    val rawStream = spark.readStream
-      .format("rate")
-      .option("rowsPerSecond", "10")
-      .load()
-
-    // Derive game-outcome columns from the monotonic counter.
-    // In production these come directly from the event payload.
-    val events = rawStream
-      .withColumn(
-        "result",
-        F.when(F.col("value") % 3 === 0L, "white")
-          .when(F.col("value") % 3 === 1L, "black")
-          .otherwise("draw"),
-      )
-      .withColumn(
-        "termination",
-        F.when(F.col("value") % 4 === 0L, "checkmate")
-          .when(F.col("value") % 4 === 1L, "resignation")
-          .when(F.col("value") % 4 === 2L, "timeout")
-          .otherwise("agreement"),
-      )
-      // Watermark: accept events up to 45 seconds late.
-      // Spark will not emit a window result until the watermark passes its end time.
-      .withWatermark("timestamp", "45 seconds")
-
-    // ── Query 1: tumbling 1-minute windows ────────────────────────────────
-    // Each window is a non-overlapping 60-second bucket.
-    // outputMode("append") only emits a window after the watermark seals it —
-    // guarantees that late arrivals were already counted before output.
-    val gamesByWindow = events
-      .groupBy(F.window(F.col("timestamp"), "1 minute"), F.col("result"))
-      .agg(F.count("*").as("games"))
-      .select(
-        F.col("window.start").as("window_start"),
-        F.col("window.end").as("window_end"),
-        F.col("result"),
-        F.col("games"),
-      )
-
-    // ── Query 2: sliding 5-minute / 1-minute windows ──────────────────────
-    // Each window covers 5 minutes of data, and a new window opens every minute.
-    // outputMode("update") emits a row whenever an existing window changes —
-    // gives a live rolling view of termination patterns.
-    val terminationTrend = events
-      .groupBy(F.window(F.col("timestamp"), "5 minutes", "1 minute"))
-      .agg(
-        F.count("*").as("total"),
-        F.sum(F.when(F.col("termination") === "checkmate", 1).otherwise(0)).as("checkmates"),
-        F.sum(F.when(F.col("termination") === "resignation", 1).otherwise(0)).as("resignations"),
-        F.sum(F.when(F.col("termination") === "timeout", 1).otherwise(0)).as("timeouts"),
-      )
-      .withColumn(
-        "checkmate_pct",
-        F.round(F.col("checkmates") / F.col("total").cast("double") * 100, 1),
-      )
-      .select(
-        F.col("window.start").as("window_start"),
-        F.col("total"),
-        F.col("checkmate_pct"),
-        F.col("resignations"),
-        F.col("timeouts"),
-      )
-
-    // Write sealed windows to Parquet — safe to query with any SQL engine.
-    gamesByWindow.writeStream
-      .outputMode("append")
-      .format("parquet")
-      .option("path", s"$outputDir/game_counts_by_window")
-      .option("checkpointLocation", s"$outputDir/_checkpoints/game_counts")
-      .trigger(Trigger.ProcessingTime("30 seconds"))
-      .start()
-
-    // Print live rolling stats to the console every 10 seconds.
-    terminationTrend.writeStream
-      .outputMode("update")
-      .format("console")
-      .option("truncate", "false")
-      .option("numRows", "10")
-      .trigger(Trigger.ProcessingTime("10 seconds"))
-      .start()
-
-    // Block until any query fails or the process is killed.
-    spark.streams.awaitAnyTermination()

modules/analytics/src/main/scala/de/nowchess/analytics/OpeningBookJob.scala

@@ -1,100 +0,0 @@
-package de.nowchess.analytics
-
-import org.apache.spark.sql.SparkSession
-import org.apache.spark.sql.functions as F
-
-/** Reads completed games from the game_records table and produces an opening-book statistics table: for each unique
-  * opening (first N plies), it reports total games played and win/draw/loss rates from each side.
-  *
-  * Output is written as Parquet to `outputDir/opening_book` and a human-readable CSV summary (top-1000 openings by
-  * popularity) to `outputDir/opening_book_top1000`.
-  *
-  * PGN parsing is done entirely with Spark SQL string functions — no UDFs — so the Catalyst optimizer can push
-  * predicates and the job scales to any cluster size.
-  */
-object OpeningBookJob:
-
-  def main(args: Array[String]): Unit =
-    val jdbcUrl   = sys.env.getOrElse("NOWCHESS_JDBC_URL", "jdbc:postgresql://localhost:5432/nowchess")
-    val dbUser    = sys.env.getOrElse("NOWCHESS_DB_USER", "nowchess")
-    val dbPass    = sys.env.getOrElse("NOWCHESS_DB_PASS", "nowchess")
-    val outputDir = if args.length > 0 then args(0) else "/tmp/nowchess-opening-book"
-    val maxPlies  = if args.length > 1 then args(1).toInt else 10
-
-    val spark = SparkSession
-      .builder()
-      .appName("NowChess Opening Book Generator")
-      .getOrCreate()
-
-    run(spark, jdbcUrl, dbUser, dbPass, outputDir, maxPlies)
-    spark.stop()
-
-  def run(
-      spark: SparkSession,
-      jdbcUrl: String,
-      dbUser: String,
-      dbPass: String,
-      outputDir: String,
-      maxPlies: Int,
-  ): Unit =
-    val games = GameSource
-      .load(spark, jdbcUrl, dbUser, dbPass)
-      .select("pgn", "result")
-      .filter(F.col("result").isNotNull.and(F.col("pgn").isNotNull))
-
-    val openingCol = extractOpening(F.col("pgn"), maxPlies)
-
-    val withOpening = games
-      .withColumn("opening", openingCol)
-      .filter(F.col("opening").isNotNull.and(F.length(F.col("opening")) > 0))
-
-    val stats = withOpening
-      .groupBy("opening")
-      .agg(
-        F.count("*").as("total"),
-        F.sum(F.when(F.col("result") === "white", 1).otherwise(0)).as("white_wins"),
-        F.sum(F.when(F.col("result") === "black", 1).otherwise(0)).as("black_wins"),
-        F.sum(F.when(F.col("result") === "draw", 1).otherwise(0)).as("draws"),
-      )
-      .withColumn("white_win_rate", F.round(F.col("white_wins") / F.col("total").cast("double"), 3))
-      .withColumn("black_win_rate", F.round(F.col("black_wins") / F.col("total").cast("double"), 3))
-      .withColumn("draw_rate", F.round(F.col("draws") / F.col("total").cast("double"), 3))
-      .orderBy(F.desc("total"))
-
-    stats.write
-      .mode("overwrite")
-      .parquet(s"$outputDir/opening_book")
-
-    val top1000 = stats.limit(1000)
-
-    top1000.write
-      .mode("overwrite")
-      .option("header", "true")
-      .csv(s"$outputDir/opening_book_top1000")
-
-    top1000.write
-      .mode("overwrite")
-      .format("jdbc")
-      .option("url", jdbcUrl)
-      .option("dbtable", "analytics_opening_stats")
-      .option("user", dbUser)
-      .option("password", dbPass)
-      .option("driver", "org.postgresql.Driver")
-      .save()
-
-  /** Extracts the first `maxPlies` moves from a PGN column as a space-separated string.
-    *
-    * PGN format produced by PgnExporter: [Event "?"]\n[White "?"]\n...\n\n1. e4 e5 2. Nf3 Nc6 *
-    *
-    * Steps:
-    *   1. Split on double-newline; take the moves section (index 1). 2. Strip the terminal result token (*, 1-0, 0-1,
-    *      1/2-1/2). 3. Strip move numbers (e.g., "1. ", "12. "). 4. Strip check/checkmate suffixes (+ #) for
-    *      position-independent lookup. 5. Tokenize on whitespace, take first maxPlies tokens, rejoin with spaces.
-    */
-  private def extractOpening(pgnCol: org.apache.spark.sql.Column, maxPlies: Int): org.apache.spark.sql.Column =
-    val moveSection   = F.coalesce(F.split(pgnCol, "\n\n").getItem(1), pgnCol)
-    val noResult      = F.regexp_replace(moveSection, "(1-0|0-1|1/2-1/2|\\*)\\s*$", "")
-    val noMoveNumbers = F.regexp_replace(noResult, "\\d+\\.+\\s*", " ")
-    val noAnnotations = F.regexp_replace(noMoveNumbers, "[+#]", "")
-    val moveArray     = F.split(F.trim(noAnnotations), "\\s+")
-    F.array_join(F.slice(moveArray, 1, maxPlies), " ")

modules/analytics/src/main/scala/de/nowchess/analytics/PlayerClusteringJob.scala

@@ -1,167 +0,0 @@
-package de.nowchess.analytics
-
-import org.apache.spark.ml.Pipeline
-import org.apache.spark.ml.clustering.KMeans
-import org.apache.spark.ml.evaluation.ClusteringEvaluator
-import org.apache.spark.ml.feature.StandardScaler
-import org.apache.spark.ml.feature.VectorAssembler
-import org.apache.spark.sql.SparkSession
-import org.apache.spark.sql.functions as F
-
-/** Clusters NowChess players into skill tiers using K-Means via MLlib.
-  *
-  * Spark / MLlib concepts shown:
-  *   - Feature engineering from raw relational data (JDBC → DataFrame)
-  *   - VectorAssembler — combine scalar columns into a dense feature vector
-  *   - StandardScaler — zero-mean / unit-variance normalisation so that total_games (can be 1000+) does not dominate
-  *     win_rate (0–1)
-  *   - KMeans clustering — unsupervised partitioning into k skill tiers
-  *   - Pipeline — compose transformers + estimator into a single reusable object
-  *   - ClusteringEvaluator — silhouette score to assess cluster quality
-  *
-  * Features per player (all derived from game_records): total_games — how active the player is win_rate — overall
-  * strength avg_move_count — game-length preference (tactical vs positional) games_as_white_ratio — colour bias
-  *
-  * Output: Parquet: player_id + cluster (0..k-1) + feature values CSV: per-cluster archetype averages (interpret what
-  * each tier means)
-  */
-object PlayerClusteringJob:
-
-  def main(args: Array[String]): Unit =
-    val jdbcUrl   = sys.env.getOrElse("NOWCHESS_JDBC_URL", "jdbc:postgresql://localhost:5432/nowchess")
-    val dbUser    = sys.env.getOrElse("NOWCHESS_DB_USER", "nowchess")
-    val dbPass    = sys.env.getOrElse("NOWCHESS_DB_PASS", "nowchess")
-    val outputDir = if args.length > 0 then args(0) else "/tmp/nowchess-player-clusters"
-    val k         = if args.length > 1 then args(1).toInt else 4
-
-    val spark = SparkSession
-      .builder()
-      .appName("NowChess Player Clustering")
-      .getOrCreate()
-
-    run(spark, jdbcUrl, dbUser, dbPass, outputDir, k)
-    spark.stop()
-
-  def run(
-      spark: SparkSession,
-      jdbcUrl: String,
-      dbUser: String,
-      dbPass: String,
-      outputDir: String,
-      k: Int,
-  ): Unit =
-    val games = GameSource
-      .load(spark, jdbcUrl, dbUser, dbPass)
-      .select("white_id", "black_id", "result", "move_count")
-      .filter(F.col("result").isNotNull)
-
-    val playerStats = buildPlayerStats(games)
-      .filter(F.col("total_games") >= 5)
-
-    val featureCols = Array("total_games", "win_rate", "avg_move_count", "games_as_white_ratio")
-
-    val assembler = new VectorAssembler()
-      .setInputCols(featureCols)
-      .setOutputCol("raw_features")
-      .setHandleInvalid("skip")
-
-    val scaler = new StandardScaler()
-      .setInputCol("raw_features")
-      .setOutputCol("features")
-      .setWithStd(true)
-      .setWithMean(true)
-
-    val kmeans = new KMeans()
-      .setK(k)
-      .setSeed(42L)
-      .setFeaturesCol("features")
-      .setPredictionCol("cluster")
-
-    val pipeline = new Pipeline().setStages(Array(assembler, scaler, kmeans))
-
-    val model       = pipeline.fit(playerStats)
-    val predictions = model.transform(playerStats)
-
-    val silhouette = new ClusteringEvaluator()
-      .setFeaturesCol("features")
-      .setPredictionCol("cluster")
-      .evaluate(predictions)
-
-    println(s"[Clustering] k=$k  silhouette=$silhouette")
-
-    // Average feature values per cluster reveal what each tier represents.
-    // Example interpretation for k=4:
-    //   Cluster 0: high total_games + high win_rate  → experienced strong players
-    //   Cluster 1: low total_games + low win_rate    → beginners / casual
-    //   Cluster 2: high total_games + mid win_rate   → active intermediate
-    //   Cluster 3: low total_games + high win_rate   → strong but infrequent
-    val archetypes = predictions
-      .groupBy("cluster")
-      .agg(
-        F.count("*").as("player_count"),
-        F.round(F.avg("total_games"), 1).as("avg_total_games"),
-        F.round(F.avg("win_rate"), 3).as("avg_win_rate"),
-        F.round(F.avg("avg_move_count"), 1).as("avg_move_count"),
-        F.round(F.avg("games_as_white_ratio"), 3).as("avg_white_ratio"),
-      )
-      .orderBy("cluster")
-
-    archetypes.show(20, false)
-
-    val clustersDf = predictions.select("player_id", "total_games", "win_rate", "avg_move_count", "cluster")
-
-    clustersDf.write
-      .mode("overwrite")
-      .parquet(s"$outputDir/player_clusters")
-
-    archetypes.write
-      .mode("overwrite")
-      .option("header", "true")
-      .csv(s"$outputDir/cluster_archetypes")
-
-    clustersDf.write
-      .mode("overwrite")
-      .format("jdbc")
-      .option("url", jdbcUrl)
-      .option("dbtable", "analytics_player_clusters")
-      .option("user", dbUser)
-      .option("password", dbPass)
-      .option("driver", "org.postgresql.Driver")
-      .save()
-
-    archetypes.write
-      .mode("overwrite")
-      .format("jdbc")
-      .option("url", jdbcUrl)
-      .option("dbtable", "analytics_cluster_archetypes")
-      .option("user", dbUser)
-      .option("password", dbPass)
-      .option("driver", "org.postgresql.Driver")
-      .save()
-
-  private def buildPlayerStats(games: org.apache.spark.sql.DataFrame): org.apache.spark.sql.DataFrame =
-    val asWhite = games.select(
-      F.col("white_id").as("player_id"),
-      F.col("result"),
-      F.col("move_count"),
-      F.lit(1).as("is_white"),
-    )
-    val asBlack = games.select(
-      F.col("black_id").as("player_id"),
-      F.col("result"),
-      F.col("move_count"),
-      F.lit(0).as("is_white"),
-    )
-
-    val won = (F.col("is_white") === 1 && F.col("result") === "white")
-      .or(F.col("is_white") === 0 && F.col("result") === "black")
-
-    asWhite
-      .union(asBlack)
-      .groupBy("player_id")
-      .agg(
-        F.count("*").as("total_games"),
-        F.round(F.sum(F.when(won, 1.0).otherwise(0.0)) / F.count("*"), 3).as("win_rate"),
-        F.round(F.avg(F.col("move_count")), 1).as("avg_move_count"),
-        F.round(F.avg(F.col("is_white").cast("double")), 3).as("games_as_white_ratio"),
-      )

modules/analytics/src/main/scala/de/nowchess/analytics/PlayerGraphJob.scala

@@ -1,164 +0,0 @@
-package de.nowchess.analytics
-
-import org.apache.spark.graphx.Edge
-import org.apache.spark.graphx.Graph
-import org.apache.spark.graphx.VertexId
-import org.apache.spark.rdd.RDD
-import org.apache.spark.sql.Row
-import org.apache.spark.sql.SparkSession
-import org.apache.spark.sql.functions as F
-import org.apache.spark.sql.types.DataType
-import org.apache.spark.sql.types.DoubleType
-import org.apache.spark.sql.types.LongType
-import org.apache.spark.sql.types.StringType
-import org.apache.spark.sql.types.StructField
-import org.apache.spark.sql.types.StructType
-
-/** Models the NowChess player network as a directed graph and runs GraphX analytics.
-  *
-  * Spark / GraphX concepts shown:
-  *   - Building a Graph from RDDs derived from a JDBC DataFrame
-  *   - PageRank — measures a player's "influence"; high score = many games against other high-ranked players (analogous
-  *     to web link authority)
-  *   - Connected Components — finds isolated player communities; players who have never played anyone from another
-  *     component cannot be linked
-  *   - Converting GraphX results back to DataFrames for SQL-style joins and output
-  *
-  * Graph model: Vertices: one per unique player (vertex ID = hashCode of player UUID string) Edges: one per completed
-  * game (white → black), attributed with result
-  *
-  * Note: hashCode gives a 32-bit → 64-bit vertex ID; collision probability is negligible for typical player counts. For
-  * millions of players, replace with MLlib StringIndexer to generate collision-free Long IDs.
-  */
-object PlayerGraphJob:
-
-  def main(args: Array[String]): Unit =
-    val jdbcUrl   = sys.env.getOrElse("NOWCHESS_JDBC_URL", "jdbc:postgresql://localhost:5432/nowchess")
-    val dbUser    = sys.env.getOrElse("NOWCHESS_DB_USER", "nowchess")
-    val dbPass    = sys.env.getOrElse("NOWCHESS_DB_PASS", "nowchess")
-    val outputDir = if args.length > 0 then args(0) else "/tmp/nowchess-player-graph"
-
-    val spark = SparkSession
-      .builder()
-      .appName("NowChess Player Graph Analytics")
-      .getOrCreate()
-
-    run(spark, jdbcUrl, dbUser, dbPass, outputDir)
-    spark.stop()
-
-  def run(
-      spark: SparkSession,
-      jdbcUrl: String,
-      dbUser: String,
-      dbPass: String,
-      outputDir: String,
-  ): Unit =
-    val gamesRdd: RDD[Row] = GameSource
-      .load(spark, jdbcUrl, dbUser, dbPass)
-      .select("white_id", "black_id", "result")
-      .filter(F.col("result").isNotNull)
-      .rdd
-
-    val toVid: String => VertexId = s => s.hashCode.toLong
-
-    // Each row contributes two vertex entries (white and black player).
-    val vertices: RDD[(VertexId, String)] = gamesRdd
-      .flatMap { row =>
-        Seq(
-          (toVid(row.getString(0)), row.getString(0)),
-          (toVid(row.getString(1)), row.getString(1)),
-        )
-      }
-      .distinct()
-
-    // Directed edge white → black, labelled with the game result.
-    val edges: RDD[Edge[String]] = gamesRdd.map { row =>
-      Edge(toVid(row.getString(0)), toVid(row.getString(1)), row.getString(2))
-    }
-
-    val graph: Graph[String, String] = Graph(vertices, edges)
-
-    println(s"[Graph] vertices=${graph.numVertices}  edges=${graph.numEdges}")
-
-    // ── PageRank ────────────────────────────────────────────────────────────
-    // Convergence tolerance 0.01 — lower = more iterations = more accurate.
-    // Returns Graph[Double, Double]; vertex attribute = PageRank score.
-    val pageRanks: RDD[(VertexId, Double)] = graph.pageRank(0.01).vertices
-
-    // ── Connected Components ────────────────────────────────────────────────
-    // Returns Graph[VertexId, ED]; vertex attribute = minimum vertex ID in
-    // the component (serves as a stable component label).
-    val components: RDD[(VertexId, VertexId)] = graph.connectedComponents().vertices
-
-    // Convert each RDD result to a DataFrame so we can join with SQL semantics.
-    val vertexDf    = rddToFrame(spark, vertices, "player_id", StringType)
-    val pageRankDf  = rddToFrame(spark, pageRanks, "page_rank", DoubleType)
-    val componentDf = rddToFrame(spark, components, "component_id", LongType)
-
-    val result = vertexDf
-      .join(pageRankDf, "vertex_id")
-      .join(componentDf, "vertex_id")
-      .drop("vertex_id")
-      .withColumn("page_rank", F.round(F.col("page_rank"), 4))
-      .orderBy(F.desc("page_rank"))
-
-    println("[Graph] Top 20 players by PageRank:")
-    result.show(20, false)
-
-    result.write
-      .mode("overwrite")
-      .parquet(s"$outputDir/player_graph")
-
-    result.write
-      .mode("overwrite")
-      .format("jdbc")
-      .option("url", jdbcUrl)
-      .option("dbtable", "analytics_player_graph")
-      .option("user", dbUser)
-      .option("password", dbPass)
-      .option("driver", "org.postgresql.Driver")
-      .save()
-
-    // How many players belong to each connected component?
-    // A large dominant component + many singletons is the expected shape.
-    val componentSizes = result
-      .groupBy("component_id")
-      .agg(F.count("*").as("player_count"))
-      .orderBy(F.desc("player_count"))
-
-    println("[Graph] Connected component sizes:")
-    componentSizes.show(10, false)
-
-    componentSizes.write
-      .mode("overwrite")
-      .option("header", "true")
-      .csv(s"$outputDir/component_sizes")
-
-    componentSizes.write
-      .mode("overwrite")
-      .format("jdbc")
-      .option("url", jdbcUrl)
-      .option("dbtable", "analytics_component_sizes")
-      .option("user", dbUser)
-      .option("password", dbPass)
-      .option("driver", "org.postgresql.Driver")
-      .save()
-
-  // Build a two-column DataFrame (vertex_id: Long, valueCol: valueType) from an RDD.
-  // Used to bridge GraphX RDD results into the DataFrame API without implicits.
-  private def rddToFrame[T](
-      spark: SparkSession,
-      rdd: RDD[(VertexId, T)],
-      valueCol: String,
-      valueType: DataType,
-  ): org.apache.spark.sql.DataFrame =
-    val schema = StructType(
-      List(
-        StructField("vertex_id", LongType, nullable = false),
-        StructField(valueCol, valueType, nullable = false),
-      ),
-    )
-    spark.createDataFrame(
-      rdd.map { case (vid, v) => Row.fromSeq(Seq[Any](vid, v)) },
-      schema,
-    )

modules/analytics/src/main/scala/de/nowchess/analytics/PlayerStatsJob.scala

@@ -1,93 +0,0 @@
-package de.nowchess.analytics
-
-import org.apache.spark.sql.SparkSession
-import org.apache.spark.sql.functions as F
-
-/** Aggregates per-player statistics from completed games.
-  *
-  * Each game contributes one row per player (as white and as black), so the dataset is first unioned into a
-  * player-centric view before grouping. Output columns: player_id, total_games, wins, losses, draws, games_as_white,
-  * games_as_black, avg_move_count, win_rate
-  *
-  * Output is written as Parquet to `outputDir/player_stats`.
-  */
-object PlayerStatsJob:
-
-  def main(args: Array[String]): Unit =
-    val jdbcUrl   = sys.env.getOrElse("NOWCHESS_JDBC_URL", "jdbc:postgresql://localhost:5432/nowchess")
-    val dbUser    = sys.env.getOrElse("NOWCHESS_DB_USER", "nowchess")
-    val dbPass    = sys.env.getOrElse("NOWCHESS_DB_PASS", "nowchess")
-    val outputDir = if args.length > 0 then args(0) else "/tmp/nowchess-player-stats"
-
-    val spark = SparkSession
-      .builder()
-      .appName("NowChess Player Stats")
-      .getOrCreate()
-
-    run(spark, jdbcUrl, dbUser, dbPass, outputDir)
-    spark.stop()
-
-  def run(
-      spark: SparkSession,
-      jdbcUrl: String,
-      dbUser: String,
-      dbPass: String,
-      outputDir: String,
-  ): Unit =
-    val games = GameSource
-      .load(spark, jdbcUrl, dbUser, dbPass)
-      .select("white_id", "black_id", "result", "move_count")
-      .filter(F.col("result").isNotNull)
-
-    // Flatten each game into two rows: one per player, tagged with their side.
-    val asWhite = games.select(
-      F.col("white_id").as("player_id"),
-      F.col("result"),
-      F.col("move_count"),
-      F.lit("white").as("color"),
-    )
-    val asBlack = games.select(
-      F.col("black_id").as("player_id"),
-      F.col("result"),
-      F.col("move_count"),
-      F.lit("black").as("color"),
-    )
-
-    val playerGames = asWhite.union(asBlack)
-
-    val wonGame = F.col("color") === F.col("result")
-    val lostGame = (F.col("color") === "white" && F.col("result") === "black")
-      .or(F.col("color") === "black" && F.col("result") === "white")
-
-    val stats = playerGames
-      .groupBy("player_id")
-      .agg(
-        F.count("*").as("total_games"),
-        F.sum(F.when(wonGame, 1).otherwise(0)).as("wins"),
-        F.sum(F.when(lostGame, 1).otherwise(0)).as("losses"),
-        F.sum(F.when(F.col("result") === "draw", 1).otherwise(0)).as("draws"),
-        F.sum(F.when(F.col("color") === "white", 1).otherwise(0)).as("games_as_white"),
-        F.sum(F.when(F.col("color") === "black", 1).otherwise(0)).as("games_as_black"),
-        F.round(F.avg(F.col("move_count")), 1).as("avg_move_count"),
-      )
-      .withColumn("win_rate", F.round(F.col("wins") / F.col("total_games").cast("double"), 3))
-      .orderBy(F.desc("total_games"))
-
-    stats.write
-      .mode("overwrite")
-      .parquet(s"$outputDir/player_stats")
-
-    stats.write
-      .mode("overwrite")
-      .option("header", "true")
-      .csv(s"$outputDir/player_stats_csv")
-
-    stats.write
-      .mode("overwrite")
-      .format("jdbc")
-      .option("url", jdbcUrl)
-      .option("dbtable", "analytics_player_stats")
-      .option("user", dbUser)
-      .option("password", dbPass)
-      .option("driver", "org.postgresql.Driver")
-      .save()

modules/analytics/src/main/scala/de/nowchess/analytics/RatingMismatchJob.scala

@@ -1,75 +0,0 @@
-package de.nowchess.analytics
-
-import org.apache.spark.sql.SparkSession
-import org.apache.spark.sql.functions as F
-
-object RatingMismatchJob:
-
-  def main(args: Array[String]): Unit =
-    val jdbcUrl   = sys.env.getOrElse("NOWCHESS_JDBC_URL", "jdbc:postgresql://localhost:5432/nowchess")
-    val dbUser    = sys.env.getOrElse("NOWCHESS_DB_USER", "nowchess")
-    val dbPass    = sys.env.getOrElse("NOWCHESS_DB_PASS", "nowchess")
-    val outputDir = if args.length > 0 then args(0) else "/tmp/nowchess-rating-mismatch"
-
-    val spark = SparkSession
-      .builder()
-      .appName("NowChess Rating Mismatch")
-      .getOrCreate()
-
-    run(spark, jdbcUrl, dbUser, dbPass, outputDir)
-    spark.stop()
-
-  def run(spark: SparkSession, jdbcUrl: String, dbUser: String, dbPass: String, outputDir: String): Unit =
-    val games = GameSource
-      .loadExtended(spark, jdbcUrl, dbUser, dbPass)
-      .select("result", "white_elo", "black_elo")
-      .filter(F.col("white_elo").isNotNull.and(F.col("black_elo").isNotNull))
-
-    val eloDiff = F.col("white_elo") - F.col("black_elo")
-    val bracket = F
-      .when(eloDiff < -200, "Black +200")
-      .when(eloDiff < -100, "Black +100–200")
-      .when(eloDiff < -50, "Black +50–100")
-      .when(eloDiff <= 50, "Even (±50)")
-      .when(eloDiff <= 100, "White +50–100")
-      .when(eloDiff <= 200, "White +100–200")
-      .otherwise("White +200")
-    val bracketOrder = F
-      .when(eloDiff < -200, 1)
-      .when(eloDiff < -100, 2)
-      .when(eloDiff < -50, 3)
-      .when(eloDiff <= 50, 4)
-      .when(eloDiff <= 100, 5)
-      .when(eloDiff <= 200, 6)
-      .otherwise(7)
-
-    val stats = games
-      .withColumn("elo_diff", eloDiff)
-      .withColumn("bracket", bracket)
-      .withColumn("bracket_order", bracketOrder)
-      .groupBy("bracket", "bracket_order")
-      .agg(
-        F.count("*").as("total_games"),
-        F.sum(F.when(F.col("result") === "white", 1).otherwise(0)).as("white_wins"),
-        F.sum(F.when(F.col("result") === "black", 1).otherwise(0)).as("black_wins"),
-        F.sum(F.when(F.col("result") === "draw", 1).otherwise(0)).as("draws"),
-      )
-      .withColumn("white_win_rate", F.round(F.col("white_wins") / F.col("total_games").cast("double"), 3))
-      .orderBy(F.asc("bracket_order"))
-      .drop("bracket_order")
-      .select("bracket", "total_games", "white_wins", "black_wins", "draws", "white_win_rate")
-
-    stats.write
-      .mode("overwrite")
-      .option("header", "true")
-      .csv(s"$outputDir/rating_mismatch")
-
-    stats.write
-      .mode("overwrite")
-      .format("jdbc")
-      .option("url", jdbcUrl)
-      .option("dbtable", "analytics_rating_mismatch")
-      .option("user", dbUser)
-      .option("password", dbPass)
-      .option("driver", "org.postgresql.Driver")
-      .save()

modules/analytics/src/main/scala/de/nowchess/analytics/SmurfAnomalyJob.scala

@@ -1,154 +0,0 @@
-package de.nowchess.analytics
-
-import org.apache.spark.sql.SparkSession
-import org.apache.spark.sql.expressions.Window
-import org.apache.spark.sql.functions as F
-
-/** Smurf / sandbagging anomaly detection via population z-scores.
-  *
-  * Smurfs (strong players on fresh accounts) and sandbaggers leave a statistical signature: a win-rate, an upset-rate
-  * (beating higher-rated opponents) and a self-Elo climb that sit far above the population norm. This job builds those
-  * three features per player, standardises each against the whole player base, and flags the players whose combined
-  * deviation is extreme.
-  *
-  * Features per player (from each game's own/opponent Elo):
-  *   - win_rate — fraction of decisive results won
-  *   - upset_rate — wins vs higher-rated opponents / games vs higher-rated opponents
-  *   - elo_climb — max self-Elo − min self-Elo across their games (rapid rating gain)
-  *
-  * Standardisation uses a single unbounded window (`Window.partitionBy()`), i.e. mean/stddev over every qualifying
-  * player, so z = (x − μ) / σ. The composite anomaly score sums the three z-scores. No UDFs — pure SQL aggregates +
-  * window functions, so Catalyst plans the whole job.
-  *
-  * Outputs (Parquet + CSV + JDBC):
-  *   - `anomaly_scores` — every qualifying player with features, z-scores and composite, ranked most-anomalous first.
-  *   - `flagged_smurfs` — the suspicious subset (high composite, or the classic high-winrate / few-games / steep-climb
-  *     profile).
-  *
-  * Meaningful only when Elo is present (Lichess dump); requires `minGames` (arg 1, default 15) to avoid small-sample
-  * noise.
-  */
-object SmurfAnomalyJob:
-
-  def main(args: Array[String]): Unit =
-    val jdbcUrl   = sys.env.getOrElse("NOWCHESS_JDBC_URL", "jdbc:postgresql://localhost:5432/nowchess")
-    val dbUser    = sys.env.getOrElse("NOWCHESS_DB_USER", "nowchess")
-    val dbPass    = sys.env.getOrElse("NOWCHESS_DB_PASS", "nowchess")
-    val outputDir = if args.length > 0 then args(0) else "/tmp/nowchess-smurf-anomaly"
-    val minGames  = if args.length > 1 then args(1).toInt else 15
-
-    val spark = SparkSession
-      .builder()
-      .appName("NowChess Smurf Anomaly Detection")
-      .getOrCreate()
-
-    run(spark, jdbcUrl, dbUser, dbPass, outputDir, minGames)
-    spark.stop()
-
-  def run(
-      spark: SparkSession,
-      jdbcUrl: String,
-      dbUser: String,
-      dbPass: String,
-      outputDir: String,
-      minGames: Int,
-  ): Unit =
-    val games = GameSource
-      .loadExtended(spark, jdbcUrl, dbUser, dbPass)
-      .select("white_id", "black_id", "result", "white_elo", "black_elo")
-      .filter(F.col("result").isNotNull)
-
-    val asWhite = games.select(
-      F.col("white_id").as("player_id"),
-      F.col("white_elo").as("self_elo"),
-      F.col("black_elo").as("opp_elo"),
-      F.when(F.col("result") === "white", 1).otherwise(0).as("won"),
-    )
-    val asBlack = games.select(
-      F.col("black_id").as("player_id"),
-      F.col("black_elo").as("self_elo"),
-      F.col("white_elo").as("opp_elo"),
-      F.when(F.col("result") === "black", 1).otherwise(0).as("won"),
-    )
-
-    val playerGames = asWhite
-      .union(asBlack)
-      .filter(F.col("self_elo").isNotNull.and(F.col("opp_elo").isNotNull))
-
-    val higher = F.col("opp_elo") > F.col("self_elo")
-
-    val features = playerGames
-      .groupBy("player_id")
-      .agg(
-        F.count("*").as("total_games"),
-        F.round(F.avg("won"), 3).as("win_rate"),
-        F.round(F.avg("self_elo"), 0).as("avg_self_elo"),
-        (F.max("self_elo") - F.min("self_elo")).as("elo_climb"),
-        F.sum(F.when(higher, 1).otherwise(0)).as("vs_higher"),
-        F.sum(F.when(higher && F.col("won") === 1, 1).otherwise(0)).as("upsets"),
-      )
-      .filter(F.col("total_games") >= minGames)
-      .withColumn("upset_rate", F.round(F.col("upsets") / F.greatest(F.col("vs_higher"), F.lit(1)), 3))
-
-    val all = Window.partitionBy()
-    def z(col: String): org.apache.spark.sql.Column =
-      val mean = F.avg(col).over(all)
-      val std  = F.stddev(col).over(all)
-      F.round((F.col(col) - mean) / F.when(std === 0 || std.isNull, F.lit(1.0)).otherwise(std), 2)
-
-    val scored = features
-      .withColumn("z_win_rate", z("win_rate"))
-      .withColumn("z_upset_rate", z("upset_rate"))
-      .withColumn("z_elo_climb", z("elo_climb"))
-      .withColumn(
-        "anomaly_score",
-        F.round(F.col("z_win_rate") + F.col("z_upset_rate") + F.col("z_elo_climb"), 2),
-      )
-      .withColumn(
-        "flagged",
-        (F.col("anomaly_score") >= 4.0)
-          .or(F.col("win_rate") >= 0.8 && F.col("total_games") < 50 && F.col("elo_climb") >= 300),
-      )
-
-    val ordered = scored
-      .select(
-        "player_id",
-        "total_games",
-        "win_rate",
-        "avg_self_elo",
-        "elo_climb",
-        "upset_rate",
-        "z_win_rate",
-        "z_upset_rate",
-        "z_elo_climb",
-        "anomaly_score",
-        "flagged",
-      )
-      .orderBy(F.desc("anomaly_score"))
-
-    write(ordered, outputDir, "anomaly_scores", jdbcUrl, dbUser, dbPass, "analytics_smurf_anomaly")
-
-    val flagged = ordered.filter(F.col("flagged") === true)
-    write(flagged, outputDir, "flagged_smurfs", jdbcUrl, dbUser, dbPass, "analytics_flagged_smurfs")
-
-  private def write(
-      df: org.apache.spark.sql.DataFrame,
-      outputDir: String,
-      name: String,
-      jdbcUrl: String,
-      dbUser: String,
-      dbPass: String,
-      table: String,
-  ): Unit =
-    df.write.mode("overwrite").parquet(s"$outputDir/$name")
-    df.write.mode("overwrite").option("header", "true").csv(s"$outputDir/${name}_csv")
-    if !GameSource.isPgnMode then
-      df.write
-        .mode("overwrite")
-        .format("jdbc")
-        .option("url", jdbcUrl)
-        .option("dbtable", table)
-        .option("user", dbUser)
-        .option("password", dbPass)
-        .option("driver", "org.postgresql.Driver")
-        .save()

modules/analytics/src/main/scala/de/nowchess/analytics/TerminationStatsJob.scala

@@ -1,54 +0,0 @@
-package de.nowchess.analytics
-
-import org.apache.spark.sql.SparkSession
-import org.apache.spark.sql.functions as F
-
-object TerminationStatsJob:
-
-  def main(args: Array[String]): Unit =
-    val jdbcUrl   = sys.env.getOrElse("NOWCHESS_JDBC_URL", "jdbc:postgresql://localhost:5432/nowchess")
-    val dbUser    = sys.env.getOrElse("NOWCHESS_DB_USER", "nowchess")
-    val dbPass    = sys.env.getOrElse("NOWCHESS_DB_PASS", "nowchess")
-    val outputDir = if args.length > 0 then args(0) else "/tmp/nowchess-termination-stats"
-
-    val spark = SparkSession
-      .builder()
-      .appName("NowChess Termination Stats")
-      .getOrCreate()
-
-    run(spark, jdbcUrl, dbUser, dbPass, outputDir)
-    spark.stop()
-
-  def run(spark: SparkSession, jdbcUrl: String, dbUser: String, dbPass: String, outputDir: String): Unit =
-    val games = GameSource
-      .loadExtended(spark, jdbcUrl, dbUser, dbPass)
-      .select("result", "termination")
-      .filter(F.col("termination").isNotNull.and(F.col("termination") =!= ""))
-
-    val stats = games
-      .groupBy("termination")
-      .agg(
-        F.count("*").as("total_games"),
-        F.sum(F.when(F.col("result") === "white", 1).otherwise(0)).as("white_wins"),
-        F.sum(F.when(F.col("result") === "black", 1).otherwise(0)).as("black_wins"),
-        F.sum(F.when(F.col("result") === "draw", 1).otherwise(0)).as("draws"),
-      )
-      .withColumn("draw_rate", F.round(F.col("draws") / F.col("total_games").cast("double"), 3))
-      .withColumnRenamed("termination", "termination_type")
-      .orderBy(F.desc("total_games"))
-      .select("termination_type", "total_games", "white_wins", "black_wins", "draws", "draw_rate")
-
-    stats.write
-      .mode("overwrite")
-      .option("header", "true")
-      .csv(s"$outputDir/termination_stats")
-
-    stats.write
-      .mode("overwrite")
-      .format("jdbc")
-      .option("url", jdbcUrl)
-      .option("dbtable", "analytics_termination_stats")
-      .option("user", dbUser)
-      .option("password", dbPass)
-      .option("driver", "org.postgresql.Driver")
-      .save()

modules/analytics/src/main/scala/de/nowchess/analytics/TimeControlJob.scala

@@ -1,68 +0,0 @@
-package de.nowchess.analytics
-
-import org.apache.spark.sql.SparkSession
-import org.apache.spark.sql.functions as F
-
-object TimeControlJob:
-
-  def main(args: Array[String]): Unit =
-    val jdbcUrl   = sys.env.getOrElse("NOWCHESS_JDBC_URL", "jdbc:postgresql://localhost:5432/nowchess")
-    val dbUser    = sys.env.getOrElse("NOWCHESS_DB_USER", "nowchess")
-    val dbPass    = sys.env.getOrElse("NOWCHESS_DB_PASS", "nowchess")
-    val outputDir = if args.length > 0 then args(0) else "/tmp/nowchess-time-control"
-
-    val spark = SparkSession
-      .builder()
-      .appName("NowChess Time Control")
-      .getOrCreate()
-
-    run(spark, jdbcUrl, dbUser, dbPass, outputDir)
-    spark.stop()
-
-  def run(spark: SparkSession, jdbcUrl: String, dbUser: String, dbPass: String, outputDir: String): Unit =
-    val games = GameSource
-      .loadExtended(spark, jdbcUrl, dbUser, dbPass)
-      .select("result", "time_control")
-      .filter(
-        F.col("time_control").isNotNull
-          .and(F.col("time_control") =!= "")
-          .and(F.col("time_control") =!= "-"),
-      )
-
-    val baseSeconds = F.regexp_extract(F.col("time_control"), "^(?:\\d+/)?(\\d+)", 1).cast("int")
-    val category = F
-      .when(baseSeconds < 30, "UltraBullet")
-      .when(baseSeconds < 180, "Bullet")
-      .when(baseSeconds < 480, "Blitz")
-      .when(baseSeconds < 1500, "Rapid")
-      .when(baseSeconds < 86400, "Classical")
-      .otherwise("Correspondence")
-
-    val stats = games
-      .withColumn("category", category)
-      .groupBy("category")
-      .agg(
-        F.count("*").as("total_games"),
-        F.sum(F.when(F.col("result") === "white", 1).otherwise(0)).as("white_wins"),
-        F.sum(F.when(F.col("result") === "black", 1).otherwise(0)).as("black_wins"),
-        F.sum(F.when(F.col("result") === "draw", 1).otherwise(0)).as("draws"),
-      )
-      .withColumn("white_win_rate", F.round(F.col("white_wins") / F.col("total_games").cast("double"), 3))
-      .withColumn("draw_rate", F.round(F.col("draws") / F.col("total_games").cast("double"), 3))
-      .orderBy(F.desc("total_games"))
-      .select("category", "total_games", "white_wins", "black_wins", "draws", "white_win_rate", "draw_rate")
-
-    stats.write
-      .mode("overwrite")
-      .option("header", "true")
-      .csv(s"$outputDir/time_control_stats")
-
-    stats.write
-      .mode("overwrite")
-      .format("jdbc")
-      .option("url", jdbcUrl)
-      .option("dbtable", "analytics_time_control_stats")
-      .option("user", dbUser)
-      .option("password", dbPass)
-      .option("driver", "org.postgresql.Driver")
-      .save()

modules/analytics/versions.env

@@ -1,3 +0,0 @@
-MAJOR=0
-MINOR=8
-PATCH=0

modules/api/CHANGELOG.md

@@ -145,85 +145,3 @@
 
 * **dependencies:** correct Jackson databind dependency group ID ([008d72d](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/008d72d826707c04205bac7de25170fae5fed861))
 * IO microservice ([#38](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/38)) ([a386f57](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/a386f57c21d34ead6cc6f92836c52b714597e289))
-##  (2026-06-05)
-
-### Features
-
-* **api:** define shared EventEnvelope and EventType for Redis EventBus ([#61](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/61)) ([595c172](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/595c172900da99de367c274488c3ccbeaef55882))
-* **dto:** update GameWritebackEventDto for JSON deserialization and remove unused mixin ([576e3fe](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/576e3fea9bf1082549ea53efd3288474c42be93d))
-* NCS-13 Implement Threefold Repetition ([#31](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/31)) ([767d305](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/767d3051a76c266050b6335774d66e2db2273c16))
-* NCS-14 implemented insufficient moves rule ([#30](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/30)) ([b0399a4](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/b0399a4e489950083066c9538df9a84dcc7a4613))
-* NCS-21 Write Scripts to automate certain tasks ([#15](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/15)) ([8051871](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/80518719d536a087d339fe02530825dc07f8b388))
-* NCS-25 Add linters to keep quality up ([#27](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/27)) ([fd4e67d](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/fd4e67d4f782a7e955822d90cb909d0a81676fb2))
-* NCS-37 Quarkus integration ([#35](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/35)) ([f088c4e](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/f088c4e9ffcc498d3d1b6f01e8f50042d5830d55))
-* NCS-41 Bot Platform ([#33](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/33)) ([8744bee](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/8744bee2dd20966dae90a09c21a43d5b06f59e00))
-* **rule:** Rules as a microservice ([#39](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/39)) ([093134d](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/093134d36c6844ba02a36a28d5d044f09291cd1d))
-* true-microservices ([#40](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/40)) ([5909242](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/590924254e8a2754de661a57a03e43f89ceb6299))
-
-### Bug Fixes
-
-* **dependencies:** correct Jackson databind dependency group ID ([008d72d](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/008d72d826707c04205bac7de25170fae5fed861))
-* IO microservice ([#38](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/38)) ([a386f57](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/a386f57c21d34ead6cc6f92836c52b714597e289))
-##  (2026-06-09)
-
-### Features
-
-* **api:** define shared EventEnvelope and EventType for Redis EventBus ([#61](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/61)) ([595c172](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/595c172900da99de367c274488c3ccbeaef55882))
-* **dto:** update GameWritebackEventDto for JSON deserialization and remove unused mixin ([576e3fe](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/576e3fea9bf1082549ea53efd3288474c42be93d))
-* **events:** migrate game-creation and bot flows to Redis Streams NCS-89 ([#62](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/62)) ([a24924c](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/a24924c23057db3d700a75dbc4333557789cd991))
-* NCS-13 Implement Threefold Repetition ([#31](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/31)) ([767d305](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/767d3051a76c266050b6335774d66e2db2273c16))
-* NCS-14 implemented insufficient moves rule ([#30](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/30)) ([b0399a4](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/b0399a4e489950083066c9538df9a84dcc7a4613))
-* NCS-21 Write Scripts to automate certain tasks ([#15](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/15)) ([8051871](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/80518719d536a087d339fe02530825dc07f8b388))
-* NCS-25 Add linters to keep quality up ([#27](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/27)) ([fd4e67d](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/fd4e67d4f782a7e955822d90cb909d0a81676fb2))
-* NCS-37 Quarkus integration ([#35](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/35)) ([f088c4e](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/f088c4e9ffcc498d3d1b6f01e8f50042d5830d55))
-* NCS-41 Bot Platform ([#33](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/33)) ([8744bee](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/8744bee2dd20966dae90a09c21a43d5b06f59e00))
-* **rule:** Rules as a microservice ([#39](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/39)) ([093134d](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/093134d36c6844ba02a36a28d5d044f09291cd1d))
-* true-microservices ([#40](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/40)) ([5909242](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/590924254e8a2754de661a57a03e43f89ceb6299))
-
-### Bug Fixes
-
-* **dependencies:** correct Jackson databind dependency group ID ([008d72d](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/008d72d826707c04205bac7de25170fae5fed861))
-* IO microservice ([#38](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/38)) ([a386f57](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/a386f57c21d34ead6cc6f92836c52b714597e289))
-##  (2026-06-09)
-
-### Features
-
-* **api:** define shared EventEnvelope and EventType for Redis EventBus ([#61](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/61)) ([595c172](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/595c172900da99de367c274488c3ccbeaef55882))
-* **core:** publish GameOver event to Redis Streams ([#64](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/64)) ([676e411](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/676e4110c0893917d8bc7f836db6a19c69c5e9a5))
-* **dto:** update GameWritebackEventDto for JSON deserialization and remove unused mixin ([576e3fe](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/576e3fea9bf1082549ea53efd3288474c42be93d))
-* **events:** migrate game-creation and bot flows to Redis Streams NCS-89 ([#62](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/62)) ([a24924c](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/a24924c23057db3d700a75dbc4333557789cd991))
-* NCS-13 Implement Threefold Repetition ([#31](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/31)) ([767d305](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/767d3051a76c266050b6335774d66e2db2273c16))
-* NCS-14 implemented insufficient moves rule ([#30](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/30)) ([b0399a4](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/b0399a4e489950083066c9538df9a84dcc7a4613))
-* NCS-21 Write Scripts to automate certain tasks ([#15](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/15)) ([8051871](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/80518719d536a087d339fe02530825dc07f8b388))
-* NCS-25 Add linters to keep quality up ([#27](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/27)) ([fd4e67d](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/fd4e67d4f782a7e955822d90cb909d0a81676fb2))
-* NCS-37 Quarkus integration ([#35](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/35)) ([f088c4e](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/f088c4e9ffcc498d3d1b6f01e8f50042d5830d55))
-* NCS-41 Bot Platform ([#33](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/33)) ([8744bee](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/8744bee2dd20966dae90a09c21a43d5b06f59e00))
-* **rule:** Rules as a microservice ([#39](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/39)) ([093134d](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/093134d36c6844ba02a36a28d5d044f09291cd1d))
-* true-microservices ([#40](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/40)) ([5909242](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/590924254e8a2754de661a57a03e43f89ceb6299))
-
-### Bug Fixes
-
-* **dependencies:** correct Jackson databind dependency group ID ([008d72d](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/008d72d826707c04205bac7de25170fae5fed861))
-* IO microservice ([#38](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/38)) ([a386f57](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/a386f57c21d34ead6cc6f92836c52b714597e289))
-##  (2026-06-21)
-
-### Features
-
-* **api:** define shared EventEnvelope and EventType for Redis EventBus ([#61](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/61)) ([595c172](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/595c172900da99de367c274488c3ccbeaef55882))
-* **core:** publish GameOver event to Redis Streams ([#64](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/64)) ([676e411](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/676e4110c0893917d8bc7f836db6a19c69c5e9a5))
-* **dto:** update GameWritebackEventDto for JSON deserialization and remove unused mixin ([576e3fe](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/576e3fea9bf1082549ea53efd3288474c42be93d))
-* **events:** migrate game-creation and bot flows to Redis Streams NCS-89 ([#62](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/62)) ([a24924c](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/a24924c23057db3d700a75dbc4333557789cd991))
-* **game:** add GET /{gameId}/fen-history endpoint ([fba324a](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/fba324a5b01c23f97e28621ad8b72265701e0f11))
-* NCS-13 Implement Threefold Repetition ([#31](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/31)) ([767d305](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/767d3051a76c266050b6335774d66e2db2273c16))
-* NCS-14 implemented insufficient moves rule ([#30](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/30)) ([b0399a4](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/b0399a4e489950083066c9538df9a84dcc7a4613))
-* NCS-21 Write Scripts to automate certain tasks ([#15](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/15)) ([8051871](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/80518719d536a087d339fe02530825dc07f8b388))
-* NCS-25 Add linters to keep quality up ([#27](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/27)) ([fd4e67d](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/fd4e67d4f782a7e955822d90cb909d0a81676fb2))
-* NCS-37 Quarkus integration ([#35](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/35)) ([f088c4e](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/f088c4e9ffcc498d3d1b6f01e8f50042d5830d55))
-* NCS-41 Bot Platform ([#33](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/33)) ([8744bee](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/8744bee2dd20966dae90a09c21a43d5b06f59e00))
-* **rule:** Rules as a microservice ([#39](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/39)) ([093134d](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/093134d36c6844ba02a36a28d5d044f09291cd1d))
-* true-microservices ([#40](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/40)) ([5909242](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/590924254e8a2754de661a57a03e43f89ceb6299))
-
-### Bug Fixes
-
-* **dependencies:** correct Jackson databind dependency group ID ([008d72d](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/008d72d826707c04205bac7de25170fae5fed861))
-* IO microservice ([#38](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/38)) ([a386f57](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/a386f57c21d34ead6cc6f92836c52b714597e289))

modules/api/build.gradle.kts

@@ -50,8 +50,6 @@ dependencies {
         }
     }
     implementation("com.fasterxml.jackson.core:jackson-databind:${versions["JACKSON"]!!}")
-    implementation("com.fasterxml.jackson.module:jackson-module-scala_3:${versions["JACKSON_SCALA"]!!}")
-    implementation("com.fasterxml.jackson.datatype:jackson-datatype-jsr310:${versions["JACKSON"]!!}")
 
     testImplementation(platform("org.junit:junit-bom:5.13.4"))
     testImplementation("org.junit.jupiter:junit-jupiter")

modules/api/src/main/scala/de/nowchess/api/dto/FenHistoryDto.scala

@@ -1,3 +0,0 @@
-package de.nowchess.api.dto
-
-final case class FenHistoryDto(fens: List[String])

modules/api/src/main/scala/de/nowchess/api/dto/GameCreationRequestDto.scala

@@ -1,10 +0,0 @@
-package de.nowchess.api.dto
-
-import de.nowchess.api.game.GameMode
-
-final case class GameCreationRequestDto(
-    white: Option[PlayerInfoDto],
-    black: Option[PlayerInfoDto],
-    timeControl: Option[TimeControlDto],
-    mode: Option[GameMode] = None,
-)

modules/api/src/main/scala/de/nowchess/api/dto/GameCreationResponseDto.scala

@@ -1,6 +0,0 @@
-package de.nowchess.api.dto
-
-final case class GameCreationResponseDto(
-    gameId: Option[String],
-    error: Option[String] = None,
-)

modules/api/src/main/scala/de/nowchess/api/event/EventEnvelope.scala

@@ -1,27 +0,0 @@
-package de.nowchess.api.event
-
-import com.fasterxml.jackson.databind.JsonNode
-import java.time.Instant
-import java.util.UUID
-
-final case class EventEnvelope(
-    eventId: UUID,
-    `type`: EventType,
-    payload: JsonNode,
-    timestamp: Instant,
-    correlationId: Option[String],
-)
-
-object EventEnvelope:
-  def of(
-      `type`: EventType,
-      payload: JsonNode,
-      correlationId: Option[String] = None,
-  ): EventEnvelope =
-    EventEnvelope(
-      eventId = UUID.randomUUID(),
-      `type` = `type`,
-      payload = payload,
-      timestamp = Instant.now(),
-      correlationId = correlationId,
-    )

modules/api/src/main/scala/de/nowchess/api/event/EventType.scala

@@ -1,4 +0,0 @@
-package de.nowchess.api.event
-
-enum EventType:
-  case GameStart, GameCreationRequest, GameCreationResponse, BotGameStart, ChallengeCreated, ChallengeAccepted, GameOver

modules/api/src/main/scala/de/nowchess/api/event/GameOverPayload.scala

@@ -1,9 +0,0 @@
-package de.nowchess.api.event
-
-final case class GameOverPayload(
-    gameId: String,
-    result: String,
-    terminationReason: String,
-    whiteId: String,
-    blackId: String,
-)

modules/api/src/test/scala/de/nowchess/api/event/EventEnvelopeTest.scala

@@ -1,50 +0,0 @@
-package de.nowchess.api.event
-
-import com.fasterxml.jackson.databind.ObjectMapper
-import com.fasterxml.jackson.module.scala.DefaultScalaModule
-import org.scalatest.funsuite.AnyFunSuite
-import org.scalatest.matchers.should.Matchers
-
-class EventEnvelopeTest extends AnyFunSuite with Matchers:
-
-  private val mapper =
-    val m = new ObjectMapper()
-    m.registerModule(DefaultScalaModule)
-    m.findAndRegisterModules()
-    m
-
-  test("EventEnvelope round-trips through JSON") {
-    val payload = mapper.createObjectNode()
-    payload.put("gameId", "game-123")
-    payload.put("difficulty", 3)
-
-    val original = EventEnvelope.of(EventType.GameStart, payload, Some("corr-abc"))
-
-    val json    = mapper.writeValueAsString(original)
-    val decoded = mapper.readValue(json, classOf[EventEnvelope])
-
-    decoded.eventId shouldBe original.eventId
-    decoded.`type` shouldBe original.`type`
-    decoded.payload shouldBe original.payload
-    decoded.timestamp shouldBe original.timestamp
-    decoded.correlationId shouldBe Some("corr-abc")
-  }
-
-  test("EventEnvelope serializes without correlationId") {
-    val payload = mapper.createObjectNode()
-    payload.put("challengeId", "ch-1")
-
-    val envelope = EventEnvelope.of(EventType.ChallengeCreated, payload)
-    val json     = mapper.writeValueAsString(envelope)
-    val decoded  = mapper.readValue(json, classOf[EventEnvelope])
-
-    decoded.`type` shouldBe EventType.ChallengeCreated
-    decoded.correlationId shouldBe None
-  }
-
-  test("EventEnvelope.of generates unique eventIds") {
-    val payload = mapper.createObjectNode()
-    val e1      = EventEnvelope.of(EventType.BotGameStart, payload)
-    val e2      = EventEnvelope.of(EventType.BotGameStart, payload)
-    e1.eventId should not equal e2.eventId
-  }

modules/api/versions.env

@@ -1,3 +1,3 @@
 MAJOR=0
-MINOR=18
+MINOR=14
 PATCH=0

modules/bot-platform/CHANGELOG.md

@@ -129,22 +129,3 @@
 ### Reverts
 
 * Revert "refactor: update metrics paths formatting in application.yml for clarity" ([3870566](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/38705663498d5f47c40dafe2f26198589ede8656))
-##  (2026-06-09)
-
-### Features
-
-* add OpenTelemetry trace configuration with parentbased sampler ([3904d5a](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/3904d5ad8ad4930ddee65287a7bfab785a6148f5))
-* **bot-platform:** migrate BotRegistry to Redis Streams consumer group ([#63](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/63)) ([0ad2e10](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/0ad2e10999213df6dd00f0c31a088c28a4dc0083))
-* **config:** update application.yml for PostgreSQL and remove staging/production configurations ([2404e61](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/2404e6164c3b50ffccbea5238d636060d6abe4d6))
-* **config:** update application.yml for staging and production environments ([6113432](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/6113432a14c476a3a0dfc0d449e17d023697f2ba))
-* **docker:** add .dockerignore and .gitignore files for build exclusions ([c987d8e](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/c987d8e258c0e6c4cfbdaa8381c64c410d7a2b83))
-* **docker:** add Dockerfiles for building Quarkus application in native and JVM modes ([3f2d2bb](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/3f2d2bb4c97fa8cddba66e1da4427c54236dfeed))
-* **docker:** add Dockerfiles for Quarkus application in JVM and native modes ([34b9933](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/34b993304670cf2aa62cd2f6460cee7b9864b08e))
-* **logging:** add DEBUG/INFO/WARN logging across services (NCS-72) ([#41](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/41)) ([804a4bf](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/804a4bf179e3dfb19e2be4390e7e543caf5237c6))
-* NCS-78 Add Traceability to the Applications ([#46](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/46)) ([649566e](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/649566eb3fcf38f91c8896a739f74ea318af312d))
-* NCS-78 Add Traceability to the Applications ([#47](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/47)) ([87dfc6c](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/87dfc6c2bcce7f7d58fc641bd8d468a2e584c108))
-* true-microservices ([#40](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/40)) ([5909242](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/590924254e8a2754de661a57a03e43f89ceb6299))
-
-### Reverts
-
-* Revert "refactor: update metrics paths formatting in application.yml for clarity" ([3870566](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/38705663498d5f47c40dafe2f26198589ede8656))

modules/bot-platform/build.gradle.kts

@@ -73,7 +73,6 @@ dependencies {
     testImplementation(platform("org.junit:junit-bom:5.13.4"))
     testImplementation("org.junit.jupiter:junit-jupiter")
     testImplementation("io.quarkus:quarkus-junit")
-    testImplementation("io.quarkus:quarkus-junit5-mockito")
     testImplementation("io.rest-assured:rest-assured")
     testImplementation("io.quarkus:quarkus-test-security")
 

modules/bot-platform/src/main/scala/de/nowchess/botplatform/registry/BotRegistry.scala

@@ -2,18 +2,14 @@ package de.nowchess.botplatform.registry
 
 import de.nowchess.botplatform.config.RedisConfig
 import io.quarkus.redis.datasource.RedisDataSource
-import io.quarkus.redis.datasource.stream.{XGroupCreateArgs, XReadGroupArgs}
+import io.quarkus.redis.datasource.pubsub.PubSubCommands
 import io.smallrye.mutiny.subscription.MultiEmitter
 import jakarta.enterprise.context.ApplicationScoped
 import jakarta.inject.Inject
-import org.eclipse.microprofile.context.ManagedExecutor
 import org.jboss.logging.Logger
 import scala.compiletime.uninitialized
-import scala.jdk.CollectionConverters.*
-import scala.util.{Failure, Success, Try}
-import java.time.Duration
-import java.util.UUID
 import java.util.concurrent.ConcurrentHashMap
+import java.util.function.Consumer
 
 @ApplicationScoped
 class BotRegistry:
@@ -21,68 +17,31 @@ class BotRegistry:
   private val log = Logger.getLogger(classOf[BotRegistry])
 
   // scalafix:off DisableSyntax.var
-  @Inject var redis: RedisDataSource    = uninitialized
-  @Inject var redisConfig: RedisConfig  = uninitialized
-  @Inject var executor: ManagedExecutor = uninitialized
+  @Inject var redis: RedisDataSource   = uninitialized
+  @Inject var redisConfig: RedisConfig = uninitialized
   // scalafix:on DisableSyntax.var
 
-  private val groupName  = "bot-platform-consumer"
-  private val consumerId = UUID.randomUUID().toString
-
-  private val emitters = ConcurrentHashMap[String, MultiEmitter[? >: String]]()
+  private val connections = ConcurrentHashMap[String, (MultiEmitter[? >: String], PubSubCommands.RedisSubscriber)]()
 
   def register(botId: String, emitter: MultiEmitter[? >: String]): Unit =
-    createGroupIfAbsent(botId)
-    emitters.put(botId, emitter)
-    executor.submit(
-      new Runnable:
-        def run(): Unit = pollLoop(botId, emitter),
-    )
-    log.infof("Bot %s registered on stream consumer group", botId)
+    val channel                   = s"${redisConfig.prefix}:bot:$botId:events"
+    val handler: Consumer[String] = msg => emitter.emit(msg)
+    val subscriber                = redis.pubsub(classOf[String]).subscribe(channel, handler)
+    connections.put(botId, (emitter, subscriber))
+    log.infof("Bot %s registered", botId)
     ()
 
   def unregister(botId: String): Unit =
-    emitters.remove(botId)
+    Option(connections.remove(botId)).foreach { (_, subscriber) =>
+      subscriber.unsubscribe(s"${redisConfig.prefix}:bot:$botId:events")
+    }
     log.infof("Bot %s unregistered", botId)
 
+  def dispatch(botId: String, event: String): Unit =
+    log.debugf("Dispatching event to bot %s", botId)
+    redis.pubsub(classOf[String]).publish(s"${redisConfig.prefix}:bot:$botId:events", event)
+    ()
+
   def registeredBots: List[String] =
-    emitters.keys().asScala.toList
-
-  private def streamKey(botId: String): String =
-    s"${redisConfig.prefix}:bot:$botId:events:stream"
-
-  private def createGroupIfAbsent(botId: String): Unit =
-    Try(
-      redis
-        .stream(classOf[String])
-        .xgroupCreate(streamKey(botId), groupName, "$", new XGroupCreateArgs().mkstream()),
-    ) match
-      case Failure(ex) if Option(ex.getMessage).exists(_.contains("BUSYGROUP")) => ()
-      case Failure(ex) => log.warnf(ex, "Failed to create consumer group for bot %s", botId)
-      case Success(_)  => ()
-
-  private def pollLoop(botId: String, myEmitter: MultiEmitter[? >: String]): Unit =
-    while emitters.get(botId) eq myEmitter do
-      Try {
-        val messages = redis
-          .stream(classOf[String])
-          .xreadgroup(
-            groupName,
-            consumerId,
-            streamKey(botId),
-            ">",
-            new XReadGroupArgs().count(10).block(Duration.ofSeconds(2)),
-          )
-        Option(messages).foreach(_.forEach { msg =>
-          if emitters.get(botId) eq myEmitter then
-            myEmitter.emit(msg.payload().get("data"))
-            ack(botId, msg.id())
-        })
-      } match
-        case Failure(ex) => log.warnf(ex, "Error in poll loop for bot %s", botId)
-        case Success(_)  => ()
-
-  private def ack(botId: String, id: String): Unit =
-    Try(redis.stream(classOf[String]).xack(streamKey(botId), groupName, id)) match
-      case Failure(ex) => log.warnf(ex, "Failed to ack message %s for bot %s", id, botId)
-      case Success(_)  => ()
+    import scala.jdk.CollectionConverters.*
+    connections.keys().asScala.toList

modules/bot-platform/src/test/scala/de/nowchess/botplatform/registry/BotRegistryTest.scala

@@ -1,83 +0,0 @@
-package de.nowchess.botplatform.registry
-
-import de.nowchess.botplatform.config.RedisConfig
-import io.quarkus.redis.datasource.RedisDataSource
-import io.quarkus.redis.datasource.stream.{StreamCommands, XGroupCreateArgs}
-import io.smallrye.mutiny.subscription.MultiEmitter
-import org.eclipse.microprofile.context.ManagedExecutor
-import org.junit.jupiter.api.Assertions.*
-import org.junit.jupiter.api.function.Executable
-import org.junit.jupiter.api.{BeforeEach, Test}
-import org.mockito.ArgumentMatchers.*
-import org.mockito.Mockito.*
-
-class BotRegistryTest:
-
-  // scalafix:off DisableSyntax.var
-  private var registry: BotRegistry  = scala.compiletime.uninitialized
-  private var redis: RedisDataSource = scala.compiletime.uninitialized
-  private var streamCmds: StreamCommands[String, String, Nothing] =
-    scala.compiletime.uninitialized
-  private var redisConfig: RedisConfig  = scala.compiletime.uninitialized
-  private var executor: ManagedExecutor = scala.compiletime.uninitialized
-  // scalafix:on DisableSyntax.var
-
-  @BeforeEach
-  def setup(): Unit =
-    redis = mock(classOf[RedisDataSource])
-    streamCmds = mock(classOf[StreamCommands[String, String, Nothing]])
-    redisConfig = mock(classOf[RedisConfig])
-    executor = mock(classOf[ManagedExecutor])
-
-    when(redis.stream(classOf[String])).thenReturn(streamCmds)
-    when(redisConfig.prefix).thenReturn("nowchess")
-
-    registry = new BotRegistry
-    registry.redis = redis
-    registry.redisConfig = redisConfig
-    registry.executor = executor
-
-  @Test
-  def registerStartsPollThread(): Unit =
-    val emitter = mock(classOf[MultiEmitter[String]])
-    registry.register("bot1", emitter)
-    verify(executor).submit(any(classOf[Runnable]))
-
-  @Test
-  def registerCreatesConsumerGroupWithMkstream(): Unit =
-    val emitter = mock(classOf[MultiEmitter[String]])
-    registry.register("bot1", emitter)
-    verify(streamCmds)
-      .xgroupCreate(
-        org.mockito.ArgumentMatchers.eq("nowchess:bot:bot1:events:stream"),
-        org.mockito.ArgumentMatchers.eq("bot-platform-consumer"),
-        org.mockito.ArgumentMatchers.eq("$"),
-        any(classOf[XGroupCreateArgs]),
-      )
-
-  @Test
-  def registerTracksBot(): Unit =
-    val emitter = mock(classOf[MultiEmitter[String]])
-    registry.register("bot42", emitter)
-    assertTrue(registry.registeredBots.contains("bot42"))
-
-  @Test
-  def unregisterRemovesBot(): Unit =
-    val emitter = mock(classOf[MultiEmitter[String]])
-    registry.register("botX", emitter)
-    registry.unregister("botX")
-    assertFalse(registry.registeredBots.contains("botX"))
-
-  @Test
-  def busyGroupExceptionIsIgnoredOnRegister(): Unit =
-    val emitter = mock(classOf[MultiEmitter[String]])
-    when(streamCmds.xgroupCreate(any(), any(), any(), any()))
-      .thenThrow(new RuntimeException("BUSYGROUP Consumer Group name already exists"))
-    val exec: Executable = () => registry.register("botBusy", emitter)
-    assertDoesNotThrow(exec)
-
-  @Test
-  def registerDoesNotInteractWithPubSub(): Unit =
-    val emitter = mock(classOf[MultiEmitter[String]])
-    registry.register("botNoPubSub", emitter)
-    verify(redis, never()).pubsub(any(classOf[Class[?]]))

modules/bot-platform/versions.env

@@ -1,3 +1,3 @@
 MAJOR=0
-MINOR=12
+MINOR=11
 PATCH=0

modules/core/CHANGELOG.md

@@ -1827,431 +1827,3 @@
 
 * Revert "feat: add authentication permissions for metrics endpoints in application.yml" ([a298417](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/a298417b9e4d68dc73bbf40be63d9484536e9f83))
 * Revert "refactor: update metrics paths formatting in application.yml for clarity" ([3870566](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/38705663498d5f47c40dafe2f26198589ede8656))
-##  (2026-06-09)
-
-### Features
-
-* add authentication permissions for metrics endpoints in application.yml ([04edd4d](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/04edd4d6fd8a63196c36f6d67992832febc9bebb))
-* add CORS configuration and reorder JWT settings in application.yml ([a49f9be](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/a49f9be146f04c14561c305d980846a92f8c12b2))
-* add GameRules stub with PositionStatus enum ([76d4168](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/76d4168038de23e5d6083d4e8f0504fbf31d15a3))
-* add initialization metrics for various services ([d438e97](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/d438e97f32bdde0bfc63c1b4a8cc810cdd093166))
-* add MovedInCheck/Checkmate/Stalemate MoveResult variants (stub dispatch) ([8b7ec57](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/8b7ec57e5ea6ee1615a1883848a426dc07d26364))
-* add OpenTelemetry trace configuration with parentbased sampler ([3904d5a](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/3904d5ad8ad4930ddee65287a7bfab785a6148f5))
-* **config:** add GameWritebackEventDto to reflection targets ([87f29a7](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/87f29a720422f538ef70699533500e060337b8ea))
-* **config:** update application.yml for PostgreSQL and remove staging/production configurations ([2404e61](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/2404e6164c3b50ffccbea5238d636060d6abe4d6))
-* **config:** update application.yml for staging and production environments ([6113432](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/6113432a14c476a3a0dfc0d449e17d023697f2ba))
-* configure logging and add OpenTelemetry support ([#49](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/49)) ([d57c488](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/d57c4886612d1d92da0e1b79209fc83e6ef537a1))
-* **events:** migrate game-creation and bot flows to Redis Streams NCS-89 ([#62](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/62)) ([a24924c](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/a24924c23057db3d700a75dbc4333557789cd991))
-* implement clock expiry scanning and handling for game records ([#53](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/53)) ([8f9eb12](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/8f9eb12f663efabe4dc72b94394438652ad0ef02))
-* implement GameRules with isInCheck, legalMoves, gameStatus ([94a02ff](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/94a02ff6849436d9496c70a0f16c21666dae8e4e))
-* implement legal castling ([#1](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/1)) ([00d326c](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/00d326c1ba67711fbe180f04e1100c3f01dd0254))
-* implement periodic scaling checks and enhance instance management in AutoScaler ([3f12f69](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/3f12f695f132b92f634d98df2c037292498b6e86))
-* **logging:** add DEBUG/INFO/WARN logging across services (NCS-72) ([#41](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/41)) ([804a4bf](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/804a4bf179e3dfb19e2be4390e7e543caf5237c6))
-* NCS-10 Implement Pawn Promotion ([#12](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/12)) ([13bfc16](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/13bfc16cfe25db78ec607db523ca6d993c13430c))
-* NCS-11 50-move rule ([#9](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/9)) ([412ed98](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/412ed986a95703a3b282276540153480ceed229d))
-* NCS-13 Implement Threefold Repetition ([#31](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/31)) ([767d305](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/767d3051a76c266050b6335774d66e2db2273c16))
-* NCS-14 implemented insufficient moves rule ([#30](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/30)) ([b0399a4](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/b0399a4e489950083066c9538df9a84dcc7a4613))
-* NCS-16 Core Separation via Patterns ([#10](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/10)) ([1361dfc](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/1361dfc89553b146864fb8ff3526cf12cf3f293a))
-* NCS-17 Implement basic ScalaFX UI ([#14](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/14)) ([3ff8031](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/3ff80318b4f16c59733a46498581a5c27f048287))
-* NCS-21 Write Scripts to automate certain tasks ([#15](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/15)) ([8051871](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/80518719d536a087d339fe02530825dc07f8b388))
-* NCS-25 Add linters to keep quality up ([#27](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/27)) ([fd4e67d](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/fd4e67d4f782a7e955822d90cb909d0a81676fb2))
-* NCS-37 Quarkus integration ([#35](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/35)) ([f088c4e](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/f088c4e9ffcc498d3d1b6f01e8f50042d5830d55))
-* NCS-40 Rework Draw System ([#34](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/34)) ([33e785d](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/33e785d22af87724839b62ae91dfe74a05b398c3))
-* NCS-41 Bot Platform ([#33](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/33)) ([8744bee](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/8744bee2dd20966dae90a09c21a43d5b06f59e00))
-* NCS-53 changed IO to MicroService for easier scaling ([#37](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/37)) ([b5a2966](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/b5a2966adafa9650f0f7d601bdeb8fdd13710327))
-* NCS-6 Implementing FEN & PGN ([#7](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/7)) ([f28e69d](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/f28e69dc181416aa2f221fdc4b45c2cda5efbf07))
-* NCS-78 Add Traceability to the Applications ([#48](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/48)) ([c96a09b](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/c96a09bb5cee59fc23205bb63baa8b217a7e1b00))
-* NCS-9 En passant implementation ([#8](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/8)) ([919beb3](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/919beb3b4bfa8caf2f90976a415fe9b19b7e9747))
-* **redis:** implement game writeback stream processing with error handling and retries ([ae3ef76](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/ae3ef766e8b7596a09e466cd4fb386119f17ca5c))
-* **rule:** Rules as a microservice ([#39](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/39)) ([093134d](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/093134d36c6844ba02a36a28d5d044f09291cd1d))
-* true-microservices ([#40](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/40)) ([5909242](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/590924254e8a2754de661a57a03e43f89ceb6299))
-* update application.yml with new API root paths and add Micrometer and OpenTelemetry dependencies ([72ce262](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/72ce262bc491f94297700e6002fb5d0812e2cc2a))
-* wire check/checkmate/stalemate into processMove and gameLoop ([5264a22](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/5264a225418b885c5e6ea6411b96f85e38837f6c))
-
-### Bug Fixes
-
-* add missing kings to gameLoop capture test board ([aedd787](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/aedd787b77203c2af934751dba7b784eaf165032))
-* **auth:** change InternalAuthFilter to use @Singleton and add HTTP tests for secret validation ([c08d530](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/c08d5303eb9e70d36c8eebf6a061ccb71e118fe5))
-* **auth:** update InternalAuthFilter to use @ApplicationScoped and add index-dependency configuration ([6e0fd95](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/6e0fd9523e001756ce7109e639ebb54be4fcdabf))
-* **core:** add logs to trace subscribeGame call in createGame ([f5614c3](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/f5614c358255598ba1230e42a56b22934d79183c))
-* correct test board positions and captureOutput/withInput interaction ([f0481e2](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/f0481e2561b779df00925b46ee281dc36a795150))
-* **heartbeat:** inject ObjectMapper into InstanceHeartbeatService ([#42](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/42)) ([0c98151](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/0c981517da1f94cd10ae396e47bde2b35d0b3ba0))
-* IO microservice ([#38](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/38)) ([a386f57](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/a386f57c21d34ead6cc6f92836c52b714597e289))
-* Lints ([dc224ab](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/dc224abe26acf5361c56956006e1cc51b75b0b7e))
-* NCS-84 More Verbose Logging ([#51](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/51)) ([4ad92ab](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/4ad92ab23698267f8faa59c4e18388d4a0042cca))
-* NCS-85 Database Writeback fails without Logs ([#52](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/52)) ([7323908](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/73239088d985f01aa6b1067ed9097a845e471d4f))
-* **pgn:** add SAN disambiguation and check/checkmate suffixes [NCS-42] ([#56](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/56)) ([2579539](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/2579539084152178f4482ddb7b84b7f1162f10da))
-* **redis:** add max pool wait time and switch to ReactiveRedisDataSource for heartbeat updates ([33e5017](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/33e5017f51a998327b180f778f73964cc10c05d3))
-* **redis:** enhance GameRedisSubscriberManager to use ReactiveRedisDataSource and improve subscription handling ([0eb752d](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/0eb752d4935377f75aab710b7f4eda4b29098e6a))
-* **redis:** prevent concurrent Redis heartbeat refreshes using AtomicBoolean ([847b132](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/847b13202cb909d18ca3304c27ebe17ce2312b8e))
-* **redis:** simplify refreshRedisHeartbeat logic and ensure proper error handling ([1813ea1](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/1813ea1d2d5d093f7925f87371b5e29820bf1136))
-* **redis:** update Redis configuration with max pool size and waiting parameters ([5baf6a7](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/5baf6a7cdbea484fc49c02e2b5a1c3919b7fa2c4))
-* remove unused HTTP root-path configurations from application.yml ([3ed3e59](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/3ed3e59ee456d54cd3d65ece4f36623e256b9736))
-* resolve 6 coordinator bugs (cache eviction, rebalance race, pod matching, lookup inefficiency) ([5619c82](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/5619c8223ad7091706909eda8c907a29d215fd30))
-* update documentation to reflect new functions in CoordinatorGrpcServer and InstanceRegistry ([f7ce4df](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/f7ce4df595cbdc2ef84122781f4851ff140c0f44))
-* update main class path in build configuration and adjust VCS directory mapping ([7b1f8b1](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/7b1f8b117623d327232a1a92a8a44d18582e0189))
-* update move validation to check for king safety ([#13](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/13)) ([e5e20c5](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/e5e20c566e368b12ca1dc59680c34e9112bf6762))
-
-### Reverts
-
-* Revert "feat: add authentication permissions for metrics endpoints in application.yml" ([a298417](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/a298417b9e4d68dc73bbf40be63d9484536e9f83))
-* Revert "refactor: update metrics paths formatting in application.yml for clarity" ([3870566](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/38705663498d5f47c40dafe2f26198589ede8656))
-##  (2026-06-09)
-
-### Features
-
-* add authentication permissions for metrics endpoints in application.yml ([04edd4d](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/04edd4d6fd8a63196c36f6d67992832febc9bebb))
-* add CORS configuration and reorder JWT settings in application.yml ([a49f9be](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/a49f9be146f04c14561c305d980846a92f8c12b2))
-* add GameRules stub with PositionStatus enum ([76d4168](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/76d4168038de23e5d6083d4e8f0504fbf31d15a3))
-* add initialization metrics for various services ([d438e97](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/d438e97f32bdde0bfc63c1b4a8cc810cdd093166))
-* add MovedInCheck/Checkmate/Stalemate MoveResult variants (stub dispatch) ([8b7ec57](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/8b7ec57e5ea6ee1615a1883848a426dc07d26364))
-* add OpenTelemetry trace configuration with parentbased sampler ([3904d5a](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/3904d5ad8ad4930ddee65287a7bfab785a6148f5))
-* **config:** add GameWritebackEventDto to reflection targets ([87f29a7](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/87f29a720422f538ef70699533500e060337b8ea))
-* **config:** update application.yml for PostgreSQL and remove staging/production configurations ([2404e61](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/2404e6164c3b50ffccbea5238d636060d6abe4d6))
-* **config:** update application.yml for staging and production environments ([6113432](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/6113432a14c476a3a0dfc0d449e17d023697f2ba))
-* configure logging and add OpenTelemetry support ([#49](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/49)) ([d57c488](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/d57c4886612d1d92da0e1b79209fc83e6ef537a1))
-* **events:** migrate game-creation and bot flows to Redis Streams NCS-89 ([#62](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/62)) ([a24924c](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/a24924c23057db3d700a75dbc4333557789cd991))
-* implement clock expiry scanning and handling for game records ([#53](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/53)) ([8f9eb12](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/8f9eb12f663efabe4dc72b94394438652ad0ef02))
-* implement GameRules with isInCheck, legalMoves, gameStatus ([94a02ff](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/94a02ff6849436d9496c70a0f16c21666dae8e4e))
-* implement legal castling ([#1](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/1)) ([00d326c](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/00d326c1ba67711fbe180f04e1100c3f01dd0254))
-* implement periodic scaling checks and enhance instance management in AutoScaler ([3f12f69](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/3f12f695f132b92f634d98df2c037292498b6e86))
-* **logging:** add DEBUG/INFO/WARN logging across services (NCS-72) ([#41](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/41)) ([804a4bf](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/804a4bf179e3dfb19e2be4390e7e543caf5237c6))
-* NCS-10 Implement Pawn Promotion ([#12](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/12)) ([13bfc16](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/13bfc16cfe25db78ec607db523ca6d993c13430c))
-* NCS-11 50-move rule ([#9](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/9)) ([412ed98](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/412ed986a95703a3b282276540153480ceed229d))
-* NCS-13 Implement Threefold Repetition ([#31](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/31)) ([767d305](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/767d3051a76c266050b6335774d66e2db2273c16))
-* NCS-14 implemented insufficient moves rule ([#30](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/30)) ([b0399a4](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/b0399a4e489950083066c9538df9a84dcc7a4613))
-* NCS-16 Core Separation via Patterns ([#10](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/10)) ([1361dfc](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/1361dfc89553b146864fb8ff3526cf12cf3f293a))
-* NCS-17 Implement basic ScalaFX UI ([#14](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/14)) ([3ff8031](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/3ff80318b4f16c59733a46498581a5c27f048287))
-* NCS-21 Write Scripts to automate certain tasks ([#15](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/15)) ([8051871](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/80518719d536a087d339fe02530825dc07f8b388))
-* NCS-25 Add linters to keep quality up ([#27](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/27)) ([fd4e67d](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/fd4e67d4f782a7e955822d90cb909d0a81676fb2))
-* NCS-37 Quarkus integration ([#35](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/35)) ([f088c4e](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/f088c4e9ffcc498d3d1b6f01e8f50042d5830d55))
-* NCS-40 Rework Draw System ([#34](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/34)) ([33e785d](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/33e785d22af87724839b62ae91dfe74a05b398c3))
-* NCS-41 Bot Platform ([#33](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/33)) ([8744bee](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/8744bee2dd20966dae90a09c21a43d5b06f59e00))
-* NCS-53 changed IO to MicroService for easier scaling ([#37](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/37)) ([b5a2966](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/b5a2966adafa9650f0f7d601bdeb8fdd13710327))
-* NCS-6 Implementing FEN & PGN ([#7](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/7)) ([f28e69d](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/f28e69dc181416aa2f221fdc4b45c2cda5efbf07))
-* NCS-78 Add Traceability to the Applications ([#48](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/48)) ([c96a09b](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/c96a09bb5cee59fc23205bb63baa8b217a7e1b00))
-* NCS-82 add Swiss-system tournament module ([#55](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/55)) ([c5661de](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/c5661de4a0ebf4b33211f5a391840dcf744656b7))
-* NCS-9 En passant implementation ([#8](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/8)) ([919beb3](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/919beb3b4bfa8caf2f90976a415fe9b19b7e9747))
-* **redis:** implement game writeback stream processing with error handling and retries ([ae3ef76](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/ae3ef766e8b7596a09e466cd4fb386119f17ca5c))
-* **rule:** Rules as a microservice ([#39](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/39)) ([093134d](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/093134d36c6844ba02a36a28d5d044f09291cd1d))
-* true-microservices ([#40](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/40)) ([5909242](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/590924254e8a2754de661a57a03e43f89ceb6299))
-* update application.yml with new API root paths and add Micrometer and OpenTelemetry dependencies ([72ce262](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/72ce262bc491f94297700e6002fb5d0812e2cc2a))
-* wire check/checkmate/stalemate into processMove and gameLoop ([5264a22](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/5264a225418b885c5e6ea6411b96f85e38837f6c))
-
-### Bug Fixes
-
-* add missing kings to gameLoop capture test board ([aedd787](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/aedd787b77203c2af934751dba7b784eaf165032))
-* **auth:** change InternalAuthFilter to use @Singleton and add HTTP tests for secret validation ([c08d530](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/c08d5303eb9e70d36c8eebf6a061ccb71e118fe5))
-* **auth:** update InternalAuthFilter to use @ApplicationScoped and add index-dependency configuration ([6e0fd95](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/6e0fd9523e001756ce7109e639ebb54be4fcdabf))
-* **core:** add logs to trace subscribeGame call in createGame ([f5614c3](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/f5614c358255598ba1230e42a56b22934d79183c))
-* correct test board positions and captureOutput/withInput interaction ([f0481e2](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/f0481e2561b779df00925b46ee281dc36a795150))
-* **heartbeat:** inject ObjectMapper into InstanceHeartbeatService ([#42](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/42)) ([0c98151](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/0c981517da1f94cd10ae396e47bde2b35d0b3ba0))
-* IO microservice ([#38](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/38)) ([a386f57](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/a386f57c21d34ead6cc6f92836c52b714597e289))
-* Lints ([dc224ab](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/dc224abe26acf5361c56956006e1cc51b75b0b7e))
-* NCS-84 More Verbose Logging ([#51](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/51)) ([4ad92ab](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/4ad92ab23698267f8faa59c4e18388d4a0042cca))
-* NCS-85 Database Writeback fails without Logs ([#52](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/52)) ([7323908](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/73239088d985f01aa6b1067ed9097a845e471d4f))
-* **pgn:** add SAN disambiguation and check/checkmate suffixes [NCS-42] ([#56](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/56)) ([2579539](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/2579539084152178f4482ddb7b84b7f1162f10da))
-* **redis:** add max pool wait time and switch to ReactiveRedisDataSource for heartbeat updates ([33e5017](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/33e5017f51a998327b180f778f73964cc10c05d3))
-* **redis:** enhance GameRedisSubscriberManager to use ReactiveRedisDataSource and improve subscription handling ([0eb752d](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/0eb752d4935377f75aab710b7f4eda4b29098e6a))
-* **redis:** prevent concurrent Redis heartbeat refreshes using AtomicBoolean ([847b132](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/847b13202cb909d18ca3304c27ebe17ce2312b8e))
-* **redis:** simplify refreshRedisHeartbeat logic and ensure proper error handling ([1813ea1](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/1813ea1d2d5d093f7925f87371b5e29820bf1136))
-* **redis:** update Redis configuration with max pool size and waiting parameters ([5baf6a7](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/5baf6a7cdbea484fc49c02e2b5a1c3919b7fa2c4))
-* remove unused HTTP root-path configurations from application.yml ([3ed3e59](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/3ed3e59ee456d54cd3d65ece4f36623e256b9736))
-* resolve 6 coordinator bugs (cache eviction, rebalance race, pod matching, lookup inefficiency) ([5619c82](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/5619c8223ad7091706909eda8c907a29d215fd30))
-* update documentation to reflect new functions in CoordinatorGrpcServer and InstanceRegistry ([f7ce4df](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/f7ce4df595cbdc2ef84122781f4851ff140c0f44))
-* update main class path in build configuration and adjust VCS directory mapping ([7b1f8b1](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/7b1f8b117623d327232a1a92a8a44d18582e0189))
-* update move validation to check for king safety ([#13](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/13)) ([e5e20c5](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/e5e20c566e368b12ca1dc59680c34e9112bf6762))
-
-### Reverts
-
-* Revert "feat: add authentication permissions for metrics endpoints in application.yml" ([a298417](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/a298417b9e4d68dc73bbf40be63d9484536e9f83))
-* Revert "refactor: update metrics paths formatting in application.yml for clarity" ([3870566](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/38705663498d5f47c40dafe2f26198589ede8656))
-##  (2026-06-09)
-
-### Features
-
-* add authentication permissions for metrics endpoints in application.yml ([04edd4d](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/04edd4d6fd8a63196c36f6d67992832febc9bebb))
-* add CORS configuration and reorder JWT settings in application.yml ([a49f9be](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/a49f9be146f04c14561c305d980846a92f8c12b2))
-* add GameRules stub with PositionStatus enum ([76d4168](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/76d4168038de23e5d6083d4e8f0504fbf31d15a3))
-* add initialization metrics for various services ([d438e97](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/d438e97f32bdde0bfc63c1b4a8cc810cdd093166))
-* add MovedInCheck/Checkmate/Stalemate MoveResult variants (stub dispatch) ([8b7ec57](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/8b7ec57e5ea6ee1615a1883848a426dc07d26364))
-* add OpenTelemetry trace configuration with parentbased sampler ([3904d5a](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/3904d5ad8ad4930ddee65287a7bfab785a6148f5))
-* **config:** add GameWritebackEventDto to reflection targets ([87f29a7](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/87f29a720422f538ef70699533500e060337b8ea))
-* **config:** update application.yml for PostgreSQL and remove staging/production configurations ([2404e61](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/2404e6164c3b50ffccbea5238d636060d6abe4d6))
-* **config:** update application.yml for staging and production environments ([6113432](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/6113432a14c476a3a0dfc0d449e17d023697f2ba))
-* configure logging and add OpenTelemetry support ([#49](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/49)) ([d57c488](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/d57c4886612d1d92da0e1b79209fc83e6ef537a1))
-* **core:** publish GameOver event to Redis Streams ([#64](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/64)) ([676e411](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/676e4110c0893917d8bc7f836db6a19c69c5e9a5))
-* **events:** migrate game-creation and bot flows to Redis Streams NCS-89 ([#62](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/62)) ([a24924c](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/a24924c23057db3d700a75dbc4333557789cd991))
-* implement clock expiry scanning and handling for game records ([#53](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/53)) ([8f9eb12](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/8f9eb12f663efabe4dc72b94394438652ad0ef02))
-* implement GameRules with isInCheck, legalMoves, gameStatus ([94a02ff](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/94a02ff6849436d9496c70a0f16c21666dae8e4e))
-* implement legal castling ([#1](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/1)) ([00d326c](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/00d326c1ba67711fbe180f04e1100c3f01dd0254))
-* implement periodic scaling checks and enhance instance management in AutoScaler ([3f12f69](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/3f12f695f132b92f634d98df2c037292498b6e86))
-* **logging:** add DEBUG/INFO/WARN logging across services (NCS-72) ([#41](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/41)) ([804a4bf](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/804a4bf179e3dfb19e2be4390e7e543caf5237c6))
-* NCS-10 Implement Pawn Promotion ([#12](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/12)) ([13bfc16](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/13bfc16cfe25db78ec607db523ca6d993c13430c))
-* NCS-11 50-move rule ([#9](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/9)) ([412ed98](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/412ed986a95703a3b282276540153480ceed229d))
-* NCS-13 Implement Threefold Repetition ([#31](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/31)) ([767d305](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/767d3051a76c266050b6335774d66e2db2273c16))
-* NCS-14 implemented insufficient moves rule ([#30](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/30)) ([b0399a4](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/b0399a4e489950083066c9538df9a84dcc7a4613))
-* NCS-16 Core Separation via Patterns ([#10](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/10)) ([1361dfc](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/1361dfc89553b146864fb8ff3526cf12cf3f293a))
-* NCS-17 Implement basic ScalaFX UI ([#14](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/14)) ([3ff8031](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/3ff80318b4f16c59733a46498581a5c27f048287))
-* NCS-21 Write Scripts to automate certain tasks ([#15](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/15)) ([8051871](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/80518719d536a087d339fe02530825dc07f8b388))
-* NCS-25 Add linters to keep quality up ([#27](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/27)) ([fd4e67d](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/fd4e67d4f782a7e955822d90cb909d0a81676fb2))
-* NCS-37 Quarkus integration ([#35](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/35)) ([f088c4e](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/f088c4e9ffcc498d3d1b6f01e8f50042d5830d55))
-* NCS-40 Rework Draw System ([#34](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/34)) ([33e785d](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/33e785d22af87724839b62ae91dfe74a05b398c3))
-* NCS-41 Bot Platform ([#33](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/33)) ([8744bee](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/8744bee2dd20966dae90a09c21a43d5b06f59e00))
-* NCS-53 changed IO to MicroService for easier scaling ([#37](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/37)) ([b5a2966](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/b5a2966adafa9650f0f7d601bdeb8fdd13710327))
-* NCS-6 Implementing FEN & PGN ([#7](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/7)) ([f28e69d](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/f28e69dc181416aa2f221fdc4b45c2cda5efbf07))
-* NCS-78 Add Traceability to the Applications ([#48](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/48)) ([c96a09b](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/c96a09bb5cee59fc23205bb63baa8b217a7e1b00))
-* NCS-82 add Swiss-system tournament module ([#55](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/55)) ([c5661de](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/c5661de4a0ebf4b33211f5a391840dcf744656b7))
-* NCS-9 En passant implementation ([#8](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/8)) ([919beb3](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/919beb3b4bfa8caf2f90976a415fe9b19b7e9747))
-* **redis:** implement game writeback stream processing with error handling and retries ([ae3ef76](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/ae3ef766e8b7596a09e466cd4fb386119f17ca5c))
-* **rule:** Rules as a microservice ([#39](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/39)) ([093134d](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/093134d36c6844ba02a36a28d5d044f09291cd1d))
-* true-microservices ([#40](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/40)) ([5909242](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/590924254e8a2754de661a57a03e43f89ceb6299))
-* update application.yml with new API root paths and add Micrometer and OpenTelemetry dependencies ([72ce262](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/72ce262bc491f94297700e6002fb5d0812e2cc2a))
-* wire check/checkmate/stalemate into processMove and gameLoop ([5264a22](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/5264a225418b885c5e6ea6411b96f85e38837f6c))
-
-### Bug Fixes
-
-* add missing kings to gameLoop capture test board ([aedd787](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/aedd787b77203c2af934751dba7b784eaf165032))
-* **auth:** change InternalAuthFilter to use @Singleton and add HTTP tests for secret validation ([c08d530](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/c08d5303eb9e70d36c8eebf6a061ccb71e118fe5))
-* **auth:** update InternalAuthFilter to use @ApplicationScoped and add index-dependency configuration ([6e0fd95](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/6e0fd9523e001756ce7109e639ebb54be4fcdabf))
-* **core:** add logs to trace subscribeGame call in createGame ([f5614c3](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/f5614c358255598ba1230e42a56b22934d79183c))
-* correct test board positions and captureOutput/withInput interaction ([f0481e2](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/f0481e2561b779df00925b46ee281dc36a795150))
-* **heartbeat:** inject ObjectMapper into InstanceHeartbeatService ([#42](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/42)) ([0c98151](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/0c981517da1f94cd10ae396e47bde2b35d0b3ba0))
-* IO microservice ([#38](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/38)) ([a386f57](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/a386f57c21d34ead6cc6f92836c52b714597e289))
-* Lints ([dc224ab](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/dc224abe26acf5361c56956006e1cc51b75b0b7e))
-* NCS-84 More Verbose Logging ([#51](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/51)) ([4ad92ab](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/4ad92ab23698267f8faa59c4e18388d4a0042cca))
-* NCS-85 Database Writeback fails without Logs ([#52](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/52)) ([7323908](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/73239088d985f01aa6b1067ed9097a845e471d4f))
-* **pgn:** add SAN disambiguation and check/checkmate suffixes [NCS-42] ([#56](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/56)) ([2579539](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/2579539084152178f4482ddb7b84b7f1162f10da))
-* **redis:** add max pool wait time and switch to ReactiveRedisDataSource for heartbeat updates ([33e5017](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/33e5017f51a998327b180f778f73964cc10c05d3))
-* **redis:** enhance GameRedisSubscriberManager to use ReactiveRedisDataSource and improve subscription handling ([0eb752d](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/0eb752d4935377f75aab710b7f4eda4b29098e6a))
-* **redis:** prevent concurrent Redis heartbeat refreshes using AtomicBoolean ([847b132](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/847b13202cb909d18ca3304c27ebe17ce2312b8e))
-* **redis:** simplify refreshRedisHeartbeat logic and ensure proper error handling ([1813ea1](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/1813ea1d2d5d093f7925f87371b5e29820bf1136))
-* **redis:** update Redis configuration with max pool size and waiting parameters ([5baf6a7](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/5baf6a7cdbea484fc49c02e2b5a1c3919b7fa2c4))
-* remove unused HTTP root-path configurations from application.yml ([3ed3e59](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/3ed3e59ee456d54cd3d65ece4f36623e256b9736))
-* resolve 6 coordinator bugs (cache eviction, rebalance race, pod matching, lookup inefficiency) ([5619c82](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/5619c8223ad7091706909eda8c907a29d215fd30))
-* update documentation to reflect new functions in CoordinatorGrpcServer and InstanceRegistry ([f7ce4df](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/f7ce4df595cbdc2ef84122781f4851ff140c0f44))
-* update main class path in build configuration and adjust VCS directory mapping ([7b1f8b1](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/7b1f8b117623d327232a1a92a8a44d18582e0189))
-* update move validation to check for king safety ([#13](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/13)) ([e5e20c5](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/e5e20c566e368b12ca1dc59680c34e9112bf6762))
-
-### Reverts
-
-* Revert "feat: add authentication permissions for metrics endpoints in application.yml" ([a298417](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/a298417b9e4d68dc73bbf40be63d9484536e9f83))
-* Revert "refactor: update metrics paths formatting in application.yml for clarity" ([3870566](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/38705663498d5f47c40dafe2f26198589ede8656))
-##  (2026-06-10)
-
-### Features
-
-* add authentication permissions for metrics endpoints in application.yml ([04edd4d](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/04edd4d6fd8a63196c36f6d67992832febc9bebb))
-* add CORS configuration and reorder JWT settings in application.yml ([a49f9be](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/a49f9be146f04c14561c305d980846a92f8c12b2))
-* add GameRules stub with PositionStatus enum ([76d4168](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/76d4168038de23e5d6083d4e8f0504fbf31d15a3))
-* add initialization metrics for various services ([d438e97](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/d438e97f32bdde0bfc63c1b4a8cc810cdd093166))
-* add MovedInCheck/Checkmate/Stalemate MoveResult variants (stub dispatch) ([8b7ec57](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/8b7ec57e5ea6ee1615a1883848a426dc07d26364))
-* add OpenTelemetry trace configuration with parentbased sampler ([3904d5a](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/3904d5ad8ad4930ddee65287a7bfab785a6148f5))
-* **config:** add GameWritebackEventDto to reflection targets ([87f29a7](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/87f29a720422f538ef70699533500e060337b8ea))
-* **config:** update application.yml for PostgreSQL and remove staging/production configurations ([2404e61](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/2404e6164c3b50ffccbea5238d636060d6abe4d6))
-* **config:** update application.yml for staging and production environments ([6113432](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/6113432a14c476a3a0dfc0d449e17d023697f2ba))
-* configure logging and add OpenTelemetry support ([#49](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/49)) ([d57c488](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/d57c4886612d1d92da0e1b79209fc83e6ef537a1))
-* **core:** publish GameOver event to Redis Streams ([#64](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/64)) ([676e411](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/676e4110c0893917d8bc7f836db6a19c69c5e9a5))
-* **events:** migrate game-creation and bot flows to Redis Streams NCS-89 ([#62](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/62)) ([a24924c](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/a24924c23057db3d700a75dbc4333557789cd991))
-* implement clock expiry scanning and handling for game records ([#53](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/53)) ([8f9eb12](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/8f9eb12f663efabe4dc72b94394438652ad0ef02))
-* implement GameRules with isInCheck, legalMoves, gameStatus ([94a02ff](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/94a02ff6849436d9496c70a0f16c21666dae8e4e))
-* implement legal castling ([#1](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/1)) ([00d326c](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/00d326c1ba67711fbe180f04e1100c3f01dd0254))
-* implement periodic scaling checks and enhance instance management in AutoScaler ([3f12f69](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/3f12f695f132b92f634d98df2c037292498b6e86))
-* **logging:** add DEBUG/INFO/WARN logging across services (NCS-72) ([#41](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/41)) ([804a4bf](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/804a4bf179e3dfb19e2be4390e7e543caf5237c6))
-* NCS-10 Implement Pawn Promotion ([#12](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/12)) ([13bfc16](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/13bfc16cfe25db78ec607db523ca6d993c13430c))
-* NCS-11 50-move rule ([#9](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/9)) ([412ed98](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/412ed986a95703a3b282276540153480ceed229d))
-* NCS-13 Implement Threefold Repetition ([#31](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/31)) ([767d305](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/767d3051a76c266050b6335774d66e2db2273c16))
-* NCS-14 implemented insufficient moves rule ([#30](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/30)) ([b0399a4](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/b0399a4e489950083066c9538df9a84dcc7a4613))
-* NCS-16 Core Separation via Patterns ([#10](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/10)) ([1361dfc](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/1361dfc89553b146864fb8ff3526cf12cf3f293a))
-* NCS-17 Implement basic ScalaFX UI ([#14](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/14)) ([3ff8031](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/3ff80318b4f16c59733a46498581a5c27f048287))
-* NCS-21 Write Scripts to automate certain tasks ([#15](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/15)) ([8051871](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/80518719d536a087d339fe02530825dc07f8b388))
-* NCS-25 Add linters to keep quality up ([#27](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/27)) ([fd4e67d](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/fd4e67d4f782a7e955822d90cb909d0a81676fb2))
-* NCS-37 Quarkus integration ([#35](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/35)) ([f088c4e](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/f088c4e9ffcc498d3d1b6f01e8f50042d5830d55))
-* NCS-40 Rework Draw System ([#34](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/34)) ([33e785d](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/33e785d22af87724839b62ae91dfe74a05b398c3))
-* NCS-41 Bot Platform ([#33](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/33)) ([8744bee](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/8744bee2dd20966dae90a09c21a43d5b06f59e00))
-* NCS-53 changed IO to MicroService for easier scaling ([#37](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/37)) ([b5a2966](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/b5a2966adafa9650f0f7d601bdeb8fdd13710327))
-* NCS-6 Implementing FEN & PGN ([#7](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/7)) ([f28e69d](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/f28e69dc181416aa2f221fdc4b45c2cda5efbf07))
-* NCS-78 Add Traceability to the Applications ([#48](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/48)) ([c96a09b](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/c96a09bb5cee59fc23205bb63baa8b217a7e1b00))
-* NCS-82 add Swiss-system tournament module ([#55](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/55)) ([c5661de](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/c5661de4a0ebf4b33211f5a391840dcf744656b7))
-* NCS-9 En passant implementation ([#8](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/8)) ([919beb3](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/919beb3b4bfa8caf2f90976a415fe9b19b7e9747))
-* **redis:** implement game writeback stream processing with error handling and retries ([ae3ef76](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/ae3ef766e8b7596a09e466cd4fb386119f17ca5c))
-* **reflection:** add native reflection configuration for tournament classes ([e318250](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/e31825021c0fca7cbe7d9f85755646114c83cf0c))
-* **rule:** Rules as a microservice ([#39](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/39)) ([093134d](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/093134d36c6844ba02a36a28d5d044f09291cd1d))
-* true-microservices ([#40](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/40)) ([5909242](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/590924254e8a2754de661a57a03e43f89ceb6299))
-* update application.yml with new API root paths and add Micrometer and OpenTelemetry dependencies ([72ce262](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/72ce262bc491f94297700e6002fb5d0812e2cc2a))
-* wire check/checkmate/stalemate into processMove and gameLoop ([5264a22](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/5264a225418b885c5e6ea6411b96f85e38837f6c))
-
-### Bug Fixes
-
-* add missing kings to gameLoop capture test board ([aedd787](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/aedd787b77203c2af934751dba7b784eaf165032))
-* **auth:** change InternalAuthFilter to use @Singleton and add HTTP tests for secret validation ([c08d530](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/c08d5303eb9e70d36c8eebf6a061ccb71e118fe5))
-* **auth:** update InternalAuthFilter to use @ApplicationScoped and add index-dependency configuration ([6e0fd95](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/6e0fd9523e001756ce7109e639ebb54be4fcdabf))
-* **core:** add logs to trace subscribeGame call in createGame ([f5614c3](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/f5614c358255598ba1230e42a56b22934d79183c))
-* correct test board positions and captureOutput/withInput interaction ([f0481e2](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/f0481e2561b779df00925b46ee281dc36a795150))
-* **heartbeat:** inject ObjectMapper into InstanceHeartbeatService ([#42](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/42)) ([0c98151](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/0c981517da1f94cd10ae396e47bde2b35d0b3ba0))
-* IO microservice ([#38](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/38)) ([a386f57](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/a386f57c21d34ead6cc6f92836c52b714597e289))
-* Lints ([dc224ab](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/dc224abe26acf5361c56956006e1cc51b75b0b7e))
-* NCS-84 More Verbose Logging ([#51](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/51)) ([4ad92ab](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/4ad92ab23698267f8faa59c4e18388d4a0042cca))
-* NCS-85 Database Writeback fails without Logs ([#52](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/52)) ([7323908](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/73239088d985f01aa6b1067ed9097a845e471d4f))
-* **pgn:** add SAN disambiguation and check/checkmate suffixes [NCS-42] ([#56](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/56)) ([2579539](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/2579539084152178f4482ddb7b84b7f1162f10da))
-* **redis:** add max pool wait time and switch to ReactiveRedisDataSource for heartbeat updates ([33e5017](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/33e5017f51a998327b180f778f73964cc10c05d3))
-* **redis:** enhance GameRedisSubscriberManager to use ReactiveRedisDataSource and improve subscription handling ([0eb752d](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/0eb752d4935377f75aab710b7f4eda4b29098e6a))
-* **redis:** prevent concurrent Redis heartbeat refreshes using AtomicBoolean ([847b132](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/847b13202cb909d18ca3304c27ebe17ce2312b8e))
-* **redis:** simplify refreshRedisHeartbeat logic and ensure proper error handling ([1813ea1](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/1813ea1d2d5d093f7925f87371b5e29820bf1136))
-* **redis:** update Redis configuration with max pool size and waiting parameters ([5baf6a7](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/5baf6a7cdbea484fc49c02e2b5a1c3919b7fa2c4))
-* remove unused HTTP root-path configurations from application.yml ([3ed3e59](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/3ed3e59ee456d54cd3d65ece4f36623e256b9736))
-* resolve 6 coordinator bugs (cache eviction, rebalance race, pod matching, lookup inefficiency) ([5619c82](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/5619c8223ad7091706909eda8c907a29d215fd30))
-* update documentation to reflect new functions in CoordinatorGrpcServer and InstanceRegistry ([f7ce4df](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/f7ce4df595cbdc2ef84122781f4851ff140c0f44))
-* update main class path in build configuration and adjust VCS directory mapping ([7b1f8b1](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/7b1f8b117623d327232a1a92a8a44d18582e0189))
-* update move validation to check for king safety ([#13](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/13)) ([e5e20c5](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/e5e20c566e368b12ca1dc59680c34e9112bf6762))
-
-### Reverts
-
-* Revert "feat: add authentication permissions for metrics endpoints in application.yml" ([a298417](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/a298417b9e4d68dc73bbf40be63d9484536e9f83))
-* Revert "refactor: update metrics paths formatting in application.yml for clarity" ([3870566](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/38705663498d5f47c40dafe2f26198589ede8656))
-##  (2026-06-21)
-
-### Features
-
-* add authentication permissions for metrics endpoints in application.yml ([04edd4d](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/04edd4d6fd8a63196c36f6d67992832febc9bebb))
-* add CORS configuration and reorder JWT settings in application.yml ([a49f9be](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/a49f9be146f04c14561c305d980846a92f8c12b2))
-* add GameRules stub with PositionStatus enum ([76d4168](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/76d4168038de23e5d6083d4e8f0504fbf31d15a3))
-* add initialization metrics for various services ([d438e97](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/d438e97f32bdde0bfc63c1b4a8cc810cdd093166))
-* add MovedInCheck/Checkmate/Stalemate MoveResult variants (stub dispatch) ([8b7ec57](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/8b7ec57e5ea6ee1615a1883848a426dc07d26364))
-* add OpenTelemetry trace configuration with parentbased sampler ([3904d5a](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/3904d5ad8ad4930ddee65287a7bfab785a6148f5))
-* **config:** add GameWritebackEventDto to reflection targets ([87f29a7](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/87f29a720422f538ef70699533500e060337b8ea))
-* **config:** update application.yml for PostgreSQL and remove staging/production configurations ([2404e61](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/2404e6164c3b50ffccbea5238d636060d6abe4d6))
-* **config:** update application.yml for staging and production environments ([6113432](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/6113432a14c476a3a0dfc0d449e17d023697f2ba))
-* configure logging and add OpenTelemetry support ([#49](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/49)) ([d57c488](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/d57c4886612d1d92da0e1b79209fc83e6ef537a1))
-* **core:** publish GameOver event to Redis Streams ([#64](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/64)) ([676e411](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/676e4110c0893917d8bc7f836db6a19c69c5e9a5))
-* **events:** migrate game-creation and bot flows to Redis Streams NCS-89 ([#62](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/62)) ([a24924c](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/a24924c23057db3d700a75dbc4333557789cd991))
-* **game:** add GET /{gameId}/fen-history endpoint ([fba324a](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/fba324a5b01c23f97e28621ad8b72265701e0f11))
-* implement clock expiry scanning and handling for game records ([#53](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/53)) ([8f9eb12](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/8f9eb12f663efabe4dc72b94394438652ad0ef02))
-* implement GameRules with isInCheck, legalMoves, gameStatus ([94a02ff](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/94a02ff6849436d9496c70a0f16c21666dae8e4e))
-* implement legal castling ([#1](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/1)) ([00d326c](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/00d326c1ba67711fbe180f04e1100c3f01dd0254))
-* implement periodic scaling checks and enhance instance management in AutoScaler ([3f12f69](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/3f12f695f132b92f634d98df2c037292498b6e86))
-* **logging:** add DEBUG/INFO/WARN logging across services (NCS-72) ([#41](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/41)) ([804a4bf](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/804a4bf179e3dfb19e2be4390e7e543caf5237c6))
-* NCS-10 Implement Pawn Promotion ([#12](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/12)) ([13bfc16](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/13bfc16cfe25db78ec607db523ca6d993c13430c))
-* NCS-11 50-move rule ([#9](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/9)) ([412ed98](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/412ed986a95703a3b282276540153480ceed229d))
-* NCS-13 Implement Threefold Repetition ([#31](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/31)) ([767d305](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/767d3051a76c266050b6335774d66e2db2273c16))
-* NCS-14 implemented insufficient moves rule ([#30](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/30)) ([b0399a4](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/b0399a4e489950083066c9538df9a84dcc7a4613))
-* NCS-16 Core Separation via Patterns ([#10](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/10)) ([1361dfc](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/1361dfc89553b146864fb8ff3526cf12cf3f293a))
-* NCS-17 Implement basic ScalaFX UI ([#14](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/14)) ([3ff8031](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/3ff80318b4f16c59733a46498581a5c27f048287))
-* NCS-21 Write Scripts to automate certain tasks ([#15](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/15)) ([8051871](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/80518719d536a087d339fe02530825dc07f8b388))
-* NCS-25 Add linters to keep quality up ([#27](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/27)) ([fd4e67d](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/fd4e67d4f782a7e955822d90cb909d0a81676fb2))
-* NCS-37 Quarkus integration ([#35](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/35)) ([f088c4e](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/f088c4e9ffcc498d3d1b6f01e8f50042d5830d55))
-* NCS-40 Rework Draw System ([#34](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/34)) ([33e785d](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/33e785d22af87724839b62ae91dfe74a05b398c3))
-* NCS-41 Bot Platform ([#33](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/33)) ([8744bee](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/8744bee2dd20966dae90a09c21a43d5b06f59e00))
-* NCS-53 changed IO to MicroService for easier scaling ([#37](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/37)) ([b5a2966](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/b5a2966adafa9650f0f7d601bdeb8fdd13710327))
-* NCS-6 Implementing FEN & PGN ([#7](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/7)) ([f28e69d](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/f28e69dc181416aa2f221fdc4b45c2cda5efbf07))
-* NCS-78 Add Traceability to the Applications ([#48](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/48)) ([c96a09b](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/c96a09bb5cee59fc23205bb63baa8b217a7e1b00))
-* NCS-82 add Swiss-system tournament module ([#55](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/55)) ([c5661de](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/c5661de4a0ebf4b33211f5a391840dcf744656b7))
-* NCS-9 En passant implementation ([#8](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/8)) ([919beb3](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/919beb3b4bfa8caf2f90976a415fe9b19b7e9747))
-* **redis:** implement game writeback stream processing with error handling and retries ([ae3ef76](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/ae3ef766e8b7596a09e466cd4fb386119f17ca5c))
-* **reflection:** add native reflection configuration for tournament classes ([e318250](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/e31825021c0fca7cbe7d9f85755646114c83cf0c))
-* **rule:** Rules as a microservice ([#39](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/39)) ([093134d](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/093134d36c6844ba02a36a28d5d044f09291cd1d))
-* true-microservices ([#40](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/40)) ([5909242](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/590924254e8a2754de661a57a03e43f89ceb6299))
-* update application.yml with new API root paths and add Micrometer and OpenTelemetry dependencies ([72ce262](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/72ce262bc491f94297700e6002fb5d0812e2cc2a))
-* wire check/checkmate/stalemate into processMove and gameLoop ([5264a22](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/5264a225418b885c5e6ea6411b96f85e38837f6c))
-
-### Bug Fixes
-
-* add missing kings to gameLoop capture test board ([aedd787](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/aedd787b77203c2af934751dba7b784eaf165032))
-* **auth:** change InternalAuthFilter to use @Singleton and add HTTP tests for secret validation ([c08d530](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/c08d5303eb9e70d36c8eebf6a061ccb71e118fe5))
-* **auth:** update InternalAuthFilter to use @ApplicationScoped and add index-dependency configuration ([6e0fd95](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/6e0fd9523e001756ce7109e639ebb54be4fcdabf))
-* **core:** add logs to trace subscribeGame call in createGame ([f5614c3](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/f5614c358255598ba1230e42a56b22934d79183c))
-* correct test board positions and captureOutput/withInput interaction ([f0481e2](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/f0481e2561b779df00925b46ee281dc36a795150))
-* **heartbeat:** inject ObjectMapper into InstanceHeartbeatService ([#42](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/42)) ([0c98151](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/0c981517da1f94cd10ae396e47bde2b35d0b3ba0))
-* IO microservice ([#38](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/38)) ([a386f57](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/a386f57c21d34ead6cc6f92836c52b714597e289))
-* Lints ([dc224ab](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/dc224abe26acf5361c56956006e1cc51b75b0b7e))
-* NCS-84 More Verbose Logging ([#51](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/51)) ([4ad92ab](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/4ad92ab23698267f8faa59c4e18388d4a0042cca))
-* NCS-85 Database Writeback fails without Logs ([#52](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/52)) ([7323908](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/73239088d985f01aa6b1067ed9097a845e471d4f))
-* **pgn:** add SAN disambiguation and check/checkmate suffixes [NCS-42] ([#56](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/56)) ([2579539](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/2579539084152178f4482ddb7b84b7f1162f10da))
-* **redis:** add max pool wait time and switch to ReactiveRedisDataSource for heartbeat updates ([33e5017](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/33e5017f51a998327b180f778f73964cc10c05d3))
-* **redis:** enhance GameRedisSubscriberManager to use ReactiveRedisDataSource and improve subscription handling ([0eb752d](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/0eb752d4935377f75aab710b7f4eda4b29098e6a))
-* **redis:** prevent concurrent Redis heartbeat refreshes using AtomicBoolean ([847b132](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/847b13202cb909d18ca3304c27ebe17ce2312b8e))
-* **redis:** simplify refreshRedisHeartbeat logic and ensure proper error handling ([1813ea1](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/1813ea1d2d5d093f7925f87371b5e29820bf1136))
-* **redis:** update Redis configuration with max pool size and waiting parameters ([5baf6a7](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/5baf6a7cdbea484fc49c02e2b5a1c3919b7fa2c4))
-* remove unused HTTP root-path configurations from application.yml ([3ed3e59](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/3ed3e59ee456d54cd3d65ece4f36623e256b9736))
-* resolve 6 coordinator bugs (cache eviction, rebalance race, pod matching, lookup inefficiency) ([5619c82](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/5619c8223ad7091706909eda8c907a29d215fd30))
-* update documentation to reflect new functions in CoordinatorGrpcServer and InstanceRegistry ([f7ce4df](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/f7ce4df595cbdc2ef84122781f4851ff140c0f44))
-* update main class path in build configuration and adjust VCS directory mapping ([7b1f8b1](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/7b1f8b117623d327232a1a92a8a44d18582e0189))
-* update move validation to check for king safety ([#13](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/13)) ([e5e20c5](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/e5e20c566e368b12ca1dc59680c34e9112bf6762))
-
-### Reverts
-
-* Revert "feat: add authentication permissions for metrics endpoints in application.yml" ([a298417](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/a298417b9e4d68dc73bbf40be63d9484536e9f83))
-* Revert "refactor: update metrics paths formatting in application.yml for clarity" ([3870566](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/38705663498d5f47c40dafe2f26198589ede8656))
-##  (2026-06-21)
-
-### Features
-
-* add authentication permissions for metrics endpoints in application.yml ([04edd4d](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/04edd4d6fd8a63196c36f6d67992832febc9bebb))
-* add CORS configuration and reorder JWT settings in application.yml ([a49f9be](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/a49f9be146f04c14561c305d980846a92f8c12b2))
-* add GameRules stub with PositionStatus enum ([76d4168](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/76d4168038de23e5d6083d4e8f0504fbf31d15a3))
-* add initialization metrics for various services ([d438e97](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/d438e97f32bdde0bfc63c1b4a8cc810cdd093166))
-* add MovedInCheck/Checkmate/Stalemate MoveResult variants (stub dispatch) ([8b7ec57](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/8b7ec57e5ea6ee1615a1883848a426dc07d26364))
-* add OpenTelemetry trace configuration with parentbased sampler ([3904d5a](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/3904d5ad8ad4930ddee65287a7bfab785a6148f5))
-* **config:** add GameWritebackEventDto to reflection targets ([87f29a7](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/87f29a720422f538ef70699533500e060337b8ea))
-* **config:** update application.yml for PostgreSQL and remove staging/production configurations ([2404e61](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/2404e6164c3b50ffccbea5238d636060d6abe4d6))
-* **config:** update application.yml for staging and production environments ([6113432](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/6113432a14c476a3a0dfc0d449e17d023697f2ba))
-* configure logging and add OpenTelemetry support ([#49](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/49)) ([d57c488](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/d57c4886612d1d92da0e1b79209fc83e6ef537a1))
-* **core:** publish GameOver event to Redis Streams ([#64](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/64)) ([676e411](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/676e4110c0893917d8bc7f836db6a19c69c5e9a5))
-* **events:** migrate game-creation and bot flows to Redis Streams NCS-89 ([#62](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/62)) ([a24924c](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/a24924c23057db3d700a75dbc4333557789cd991))
-* **game:** add GET /{gameId}/fen-history endpoint ([fba324a](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/fba324a5b01c23f97e28621ad8b72265701e0f11))
-* implement clock expiry scanning and handling for game records ([#53](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/53)) ([8f9eb12](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/8f9eb12f663efabe4dc72b94394438652ad0ef02))
-* implement GameRules with isInCheck, legalMoves, gameStatus ([94a02ff](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/94a02ff6849436d9496c70a0f16c21666dae8e4e))
-* implement legal castling ([#1](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/1)) ([00d326c](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/00d326c1ba67711fbe180f04e1100c3f01dd0254))
-* implement periodic scaling checks and enhance instance management in AutoScaler ([3f12f69](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/3f12f695f132b92f634d98df2c037292498b6e86))
-* **logging:** add DEBUG/INFO/WARN logging across services (NCS-72) ([#41](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/41)) ([804a4bf](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/804a4bf179e3dfb19e2be4390e7e543caf5237c6))
-* NCS-10 Implement Pawn Promotion ([#12](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/12)) ([13bfc16](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/13bfc16cfe25db78ec607db523ca6d993c13430c))
-* NCS-11 50-move rule ([#9](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/9)) ([412ed98](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/412ed986a95703a3b282276540153480ceed229d))
-* NCS-13 Implement Threefold Repetition ([#31](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/31)) ([767d305](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/767d3051a76c266050b6335774d66e2db2273c16))
-* NCS-14 implemented insufficient moves rule ([#30](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/30)) ([b0399a4](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/b0399a4e489950083066c9538df9a84dcc7a4613))
-* NCS-16 Core Separation via Patterns ([#10](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/10)) ([1361dfc](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/1361dfc89553b146864fb8ff3526cf12cf3f293a))
-* NCS-17 Implement basic ScalaFX UI ([#14](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/14)) ([3ff8031](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/3ff80318b4f16c59733a46498581a5c27f048287))
-* NCS-21 Write Scripts to automate certain tasks ([#15](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/15)) ([8051871](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/80518719d536a087d339fe02530825dc07f8b388))
-* NCS-25 Add linters to keep quality up ([#27](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/27)) ([fd4e67d](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/fd4e67d4f782a7e955822d90cb909d0a81676fb2))
-* NCS-37 Quarkus integration ([#35](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/35)) ([f088c4e](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/f088c4e9ffcc498d3d1b6f01e8f50042d5830d55))
-* NCS-40 Rework Draw System ([#34](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/34)) ([33e785d](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/33e785d22af87724839b62ae91dfe74a05b398c3))
-* NCS-41 Bot Platform ([#33](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/33)) ([8744bee](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/8744bee2dd20966dae90a09c21a43d5b06f59e00))
-* NCS-53 changed IO to MicroService for easier scaling ([#37](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/37)) ([b5a2966](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/b5a2966adafa9650f0f7d601bdeb8fdd13710327))
-* NCS-6 Implementing FEN & PGN ([#7](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/7)) ([f28e69d](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/f28e69dc181416aa2f221fdc4b45c2cda5efbf07))
-* NCS-78 Add Traceability to the Applications ([#48](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/48)) ([c96a09b](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/c96a09bb5cee59fc23205bb63baa8b217a7e1b00))
-* NCS-82 add Swiss-system tournament module ([#55](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/55)) ([c5661de](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/c5661de4a0ebf4b33211f5a391840dcf744656b7))
-* NCS-9 En passant implementation ([#8](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/8)) ([919beb3](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/919beb3b4bfa8caf2f90976a415fe9b19b7e9747))
-* **redis:** implement game writeback stream processing with error handling and retries ([ae3ef76](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/ae3ef766e8b7596a09e466cd4fb386119f17ca5c))
-* **reflection:** add native reflection configuration for tournament classes ([e318250](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/e31825021c0fca7cbe7d9f85755646114c83cf0c))
-* **rule:** Rules as a microservice ([#39](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/39)) ([093134d](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/093134d36c6844ba02a36a28d5d044f09291cd1d))
-* true-microservices ([#40](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/40)) ([5909242](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/590924254e8a2754de661a57a03e43f89ceb6299))
-* update application.yml with new API root paths and add Micrometer and OpenTelemetry dependencies ([72ce262](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/72ce262bc491f94297700e6002fb5d0812e2cc2a))
-* wire check/checkmate/stalemate into processMove and gameLoop ([5264a22](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/5264a225418b885c5e6ea6411b96f85e38837f6c))
-
-### Bug Fixes
-
-* add missing kings to gameLoop capture test board ([aedd787](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/aedd787b77203c2af934751dba7b784eaf165032))
-* **auth:** change InternalAuthFilter to use @Singleton and add HTTP tests for secret validation ([c08d530](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/c08d5303eb9e70d36c8eebf6a061ccb71e118fe5))
-* **auth:** update InternalAuthFilter to use @ApplicationScoped and add index-dependency configuration ([6e0fd95](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/6e0fd9523e001756ce7109e639ebb54be4fcdabf))
-* **core:** add logs to trace subscribeGame call in createGame ([f5614c3](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/f5614c358255598ba1230e42a56b22934d79183c))
-* correct test board positions and captureOutput/withInput interaction ([f0481e2](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/f0481e2561b779df00925b46ee281dc36a795150))
-* **heartbeat:** inject ObjectMapper into InstanceHeartbeatService ([#42](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/42)) ([0c98151](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/0c981517da1f94cd10ae396e47bde2b35d0b3ba0))
-* IO microservice ([#38](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/38)) ([a386f57](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/a386f57c21d34ead6cc6f92836c52b714597e289))
-* Lints ([dc224ab](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/dc224abe26acf5361c56956006e1cc51b75b0b7e))
-* NCS-84 More Verbose Logging ([#51](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/51)) ([4ad92ab](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/4ad92ab23698267f8faa59c4e18388d4a0042cca))
-* NCS-85 Database Writeback fails without Logs ([#52](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/52)) ([7323908](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/73239088d985f01aa6b1067ed9097a845e471d4f))
-* **pgn:** add SAN disambiguation and check/checkmate suffixes [NCS-42] ([#56](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/56)) ([2579539](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/2579539084152178f4482ddb7b84b7f1162f10da))
-* **redis:** add max pool wait time and switch to ReactiveRedisDataSource for heartbeat updates ([33e5017](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/33e5017f51a998327b180f778f73964cc10c05d3))
-* **redis:** enhance GameRedisSubscriberManager to use ReactiveRedisDataSource and improve subscription handling ([0eb752d](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/0eb752d4935377f75aab710b7f4eda4b29098e6a))
-* **redis:** prevent concurrent Redis heartbeat refreshes using AtomicBoolean ([847b132](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/847b13202cb909d18ca3304c27ebe17ce2312b8e))
-* **redis:** simplify refreshRedisHeartbeat logic and ensure proper error handling ([1813ea1](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/1813ea1d2d5d093f7925f87371b5e29820bf1136))
-* **redis:** update Redis configuration with max pool size and waiting parameters ([5baf6a7](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/5baf6a7cdbea484fc49c02e2b5a1c3919b7fa2c4))
-* remove unused HTTP root-path configurations from application.yml ([3ed3e59](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/3ed3e59ee456d54cd3d65ece4f36623e256b9736))
-* resolve 6 coordinator bugs (cache eviction, rebalance race, pod matching, lookup inefficiency) ([5619c82](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/5619c8223ad7091706909eda8c907a29d215fd30))
-* update documentation to reflect new functions in CoordinatorGrpcServer and InstanceRegistry ([f7ce4df](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/f7ce4df595cbdc2ef84122781f4851ff140c0f44))
-* update main class path in build configuration and adjust VCS directory mapping ([7b1f8b1](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/7b1f8b117623d327232a1a92a8a44d18582e0189))
-* update move validation to check for king safety ([#13](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/13)) ([e5e20c5](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/e5e20c566e368b12ca1dc59680c34e9112bf6762))
-
-### Reverts
-
-* Revert "feat: add authentication permissions for metrics endpoints in application.yml" ([a298417](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/a298417b9e4d68dc73bbf40be63d9484536e9f83))
-* Revert "refactor: update metrics paths formatting in application.yml for clarity" ([3870566](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/38705663498d5f47c40dafe2f26198589ede8656))

modules/core/build.gradle.kts

@@ -138,25 +138,6 @@ tasks.withType(org.gradle.api.tasks.scala.ScalaCompile::class).configureEach {
             exclude("**/resource/GameDtoMapper.scala")
             exclude("**/resource/GameResource.scala")
             exclude("**/redis/GameRedis*.scala")
-            exclude("**/redis/GameCreationStreamListener.scala")
-            exclude("**/service/GameCreationService.scala")
-        }
-    }
-}
-
-// GraalVM CE javac fails type inference for asyncUnaryCall when request/response types are
-// both different and when the response type appears as a request type elsewhere in the service.
-// Patching the generated stub to add explicit type witnesses is the minimal targeted fix.
-tasks.named("quarkusGenerateCode") {
-    doLast {
-        val grpcDir = file("build/classes/java/quarkus-generated-sources/grpc/de/nowchess/core/proto")
-        grpcDir.walkTopDown().filter { it.name.endsWith("Grpc.java") }.forEach { f ->
-            val original = f.readText()
-            val patched = original.replace(
-                "io.grpc.stub.ClientCalls.asyncUnaryCall(getChannel().newCall(getApplyMoveMethod(), getCallOptions()), request, responseObserver);",
-                "io.grpc.stub.ClientCalls.<de.nowchess.core.proto.ProtoMoveRequest, de.nowchess.core.proto.ProtoGameContext>asyncUnaryCall(getChannel().newCall(getApplyMoveMethod(), getCallOptions()), request, responseObserver);"
-            )
-            if (patched != original) f.writeText(patched)
         }
     }
 }

modules/core/src/main/scala/de/nowchess/chess/config/NativeReflectionConfig.scala

@@ -2,7 +2,6 @@ package de.nowchess.chess.config
 
 import de.nowchess.api.board.{CastlingRights, Color, File, Piece, PieceType, Rank, Square}
 import de.nowchess.api.dto.*
-import de.nowchess.api.event.{EventEnvelope, EventType, GameOverPayload}
 import de.nowchess.api.game.{DrawReason, GameContext, GameMode, GameResult}
 import de.nowchess.api.move.{Move, MoveType, PromotionPiece}
 import de.nowchess.chess.registry.GameCacheDto
@@ -14,11 +13,6 @@ import io.quarkus.runtime.annotations.RegisterForReflection
     classOf[GameCacheDto],
     classOf[ClockDto],
     classOf[CreateGameRequestDto],
-    classOf[GameCreationRequestDto],
-    classOf[GameCreationResponseDto],
-    classOf[EventEnvelope],
-    classOf[EventType],
-    classOf[GameOverPayload],
     classOf[ErrorEventDto],
     classOf[GameWritebackEventDto],
     classOf[GameFullDto],

modules/core/src/main/scala/de/nowchess/chess/redis/GameCreationStreamListener.scala

@@ -1,146 +0,0 @@
-package de.nowchess.chess.redis
-
-import com.fasterxml.jackson.databind.ObjectMapper
-import de.nowchess.api.dto.{GameCreationRequestDto, GameCreationResponseDto}
-import de.nowchess.api.event.{EventEnvelope, EventType}
-import de.nowchess.chess.config.RedisConfig
-import de.nowchess.chess.service.GameCreationService
-import io.quarkus.redis.datasource.RedisDataSource
-import io.quarkus.redis.datasource.stream.{StreamMessage, XAddArgs, XGroupCreateArgs, XReadGroupArgs}
-import io.quarkus.runtime.StartupEvent
-import jakarta.enterprise.context.ApplicationScoped
-import jakarta.enterprise.event.Observes
-import jakarta.inject.Inject
-import org.eclipse.microprofile.config.inject.ConfigProperty
-import org.eclipse.microprofile.context.ManagedExecutor
-import org.jboss.logging.Logger
-import scala.compiletime.uninitialized
-import scala.jdk.CollectionConverters.*
-import scala.util.{Failure, Success, Try}
-import java.time.Duration
-import java.util.UUID
-
-@ApplicationScoped
-class GameCreationStreamListener:
-
-  // scalafix:off DisableSyntax.var
-  @Inject var redis: RedisDataSource               = uninitialized
-  @Inject var objectMapper: ObjectMapper           = uninitialized
-  @Inject var creationService: GameCreationService = uninitialized
-  @Inject var executor: ManagedExecutor            = uninitialized
-  @Inject var redisConfig: RedisConfig             = uninitialized
-  @ConfigProperty(name = "nowchess.game-creation-stream.enabled", defaultValue = "true")
-  private var streamEnabled: Boolean = true
-  // scalafix:on DisableSyntax.var
-
-  private val log          = Logger.getLogger(classOf[GameCreationStreamListener])
-  private val groupName    = "core-game-creation"
-  private val consumerId   = UUID.randomUUID().toString
-  private val maxRetries   = 3
-  private val maxStreamLen = 1000L
-
-  private def requestStream: String  = s"${redisConfig.prefix}:game-creation"
-  private def responseStream: String = s"${redisConfig.prefix}:game-creation-response"
-  private def dlqStream: String      = s"${redisConfig.prefix}:dlq"
-
-  def start(@Observes _ev: StartupEvent): Unit =
-    if streamEnabled then
-      createGroupIfAbsent()
-      executor.submit(
-        new Runnable:
-          def run(): Unit = pollLoop(),
-      )
-      log.infof("Game-creation request listener started (consumer=%s)", consumerId)
-
-  private def createGroupIfAbsent(): Unit =
-    Try(
-      redis
-        .stream(classOf[String])
-        .xgroupCreate(requestStream, groupName, "0", new XGroupCreateArgs().mkstream()),
-    ) match
-      case Failure(ex) if Option(ex.getMessage).exists(_.contains("BUSYGROUP")) => ()
-      case Failure(ex) => log.warnf(ex, "Failed to create game-creation consumer group")
-      case Success(_)  => ()
-
-  private def pollLoop(): Unit =
-    while true do
-      Try {
-        val messages = redis
-          .stream(classOf[String])
-          .xreadgroup(
-            groupName,
-            consumerId,
-            requestStream,
-            ">",
-            new XReadGroupArgs().count(10).block(Duration.ofSeconds(2)),
-          )
-        Option(messages).foreach(_.forEach(handleMessage))
-      } match
-        case Failure(ex) => log.warnf(ex, "Error in game-creation poll loop")
-        case Success(_)  => ()
-
-  private def handleMessage(msg: StreamMessage[String, String, String]): Unit =
-    val json    = msg.payload().get("data")
-    val attempt = Option(msg.payload().get("attempt")).flatMap(_.toIntOption).getOrElse(0)
-    Try(objectMapper.readValue(json, classOf[EventEnvelope])) match
-      case Failure(ex) =>
-        log.errorf(ex, "Unparseable game-creation event, sending to DLQ: %s", json)
-        toDlq(EventType.GameCreationRequest.toString, json, ex, attempt)
-        ack(msg.id())
-      case Success(envelope) =>
-        processEnvelope(msg, envelope, json, attempt)
-
-  private def processEnvelope(
-      msg: StreamMessage[String, String, String],
-      envelope: EventEnvelope,
-      json: String,
-      attempt: Int,
-  ): Unit =
-    Try {
-      val req   = objectMapper.treeToValue(envelope.payload, classOf[GameCreationRequestDto])
-      val entry = creationService.createGame(req)
-      publishResponse(envelope.correlationId, GameCreationResponseDto(Some(entry.gameId)))
-    } match
-      case Success(_) => ack(msg.id())
-      case Failure(ex) if attempt + 1 < maxRetries =>
-        log.warnf(ex, "Game creation failed (attempt %d), retrying", attempt)
-        retry(json, attempt + 1)
-        ack(msg.id())
-      case Failure(ex) =>
-        log.errorf(ex, "Game creation failed after %d attempts, sending to DLQ", maxRetries)
-        publishResponse(envelope.correlationId, GameCreationResponseDto(None, Some("Game creation failed")))
-        toDlq(envelope.`type`.toString, json, ex, attempt)
-        ack(msg.id())
-
-  private def publishResponse(correlationId: Option[String], resp: GameCreationResponseDto): Unit =
-    val payload  = objectMapper.valueToTree[com.fasterxml.jackson.databind.JsonNode](resp)
-    val envelope = EventEnvelope.of(EventType.GameCreationResponse, payload, correlationId)
-    xadd(responseStream, Map("data" -> objectMapper.writeValueAsString(envelope)))
-
-  private def retry(json: String, attempt: Int): Unit =
-    xadd(requestStream, Map("data" -> json, "attempt" -> attempt.toString))
-
-  private def toDlq(eventType: String, json: String, error: Throwable, attempt: Int): Unit =
-    xadd(
-      dlqStream,
-      Map(
-        "data"      -> json,
-        "eventType" -> eventType,
-        "error"     -> Option(error.getMessage).getOrElse(error.getClass.getName),
-        "attempt"   -> (attempt + 1).toString,
-      ),
-    )
-
-  private def ack(id: String): Unit =
-    Try(redis.stream(classOf[String]).xack(requestStream, groupName, id)) match
-      case Failure(ex) => log.warnf(ex, "Failed to ack message %s", id)
-      case Success(_)  => ()
-
-  private def xadd(key: String, fields: Map[String, String]): Unit =
-    Try(
-      redis
-        .stream(classOf[String])
-        .xadd(key, new XAddArgs().maxlen(maxStreamLen).nearlyExactTrimming(), fields.asJava),
-    ) match
-      case Failure(ex) => log.errorf(ex, "Failed to publish to stream %s", key)
-      case Success(_)  => ()

modules/core/src/main/scala/de/nowchess/chess/redis/GameRedisPublisher.scala

@@ -1,18 +1,15 @@
 package de.nowchess.chess.redis
 
-import com.fasterxml.jackson.databind.{JsonNode, ObjectMapper}
-import de.nowchess.api.board.Color
+import com.fasterxml.jackson.databind.ObjectMapper
 import de.nowchess.api.dto.{GameStateDto, GameStateEventDto, GameWritebackEventDto}
-import de.nowchess.api.event.{EventEnvelope, EventType, GameOverPayload}
 import de.nowchess.api.game.{CorrespondenceClockState, DrawReason, GameResult, LiveClockState, TimeControl, WinReason}
+import de.nowchess.api.board.Color
 import de.nowchess.chess.grpc.IoGrpcClientWrapper
 import de.nowchess.chess.observer.{GameEvent, Observer}
 import de.nowchess.chess.registry.{GameEntry, GameRegistry}
 import de.nowchess.chess.resource.GameDtoMapper
 import io.quarkus.redis.datasource.RedisDataSource
-import io.quarkus.redis.datasource.stream.XAddArgs
 import org.jboss.logging.Logger
-import scala.jdk.CollectionConverters.*
 
 object GameRedisPublisher:
   private val log = Logger.getLogger(classOf[GameRedisPublisher])
@@ -26,11 +23,8 @@ class GameRedisPublisher(
     writebackEmit: String => Unit,
     ioClient: IoGrpcClientWrapper,
     onGameOver: String => Unit,
-    redisPrefix: String,
 ) extends Observer:
 
-  private val maxStreamLen = 1000L
-
   def emitInitialWriteback(): Unit =
     try
       registry.get(gameId).foreach { entry =>
@@ -46,39 +40,10 @@ class GameRedisPublisher(
         val dto = GameDtoMapper.toGameStateDto(entry, ioClient)
         redis.pubsub(classOf[String]).publish(s2cTopicName, objectMapper.writeValueAsString(GameStateEventDto(dto)))
         writebackEmit(objectMapper.writeValueAsString(buildWriteback(entry, dto)))
-        entry.engine.context.result.foreach { result =>
-          publishGameOver(entry, result)
-          onGameOver(gameId)
-        }
+        if entry.engine.context.result.isDefined then onGameOver(gameId)
       }
     catch case ex: Exception => GameRedisPublisher.log.warnf(ex, "Failed to publish game event for game %s", gameId)
 
-  private def publishGameOver(entry: GameEntry, result: GameResult): Unit =
-    val resultStr = result match
-      case GameResult.Win(Color.White, _) => "white"
-      case GameResult.Win(Color.Black, _) => "black"
-      case GameResult.Draw(_)             => "draw"
-    val terminationReason = result match
-      case GameResult.Win(_, WinReason.Checkmate)           => "checkmate"
-      case GameResult.Win(_, WinReason.Resignation)         => "resignation"
-      case GameResult.Win(_, WinReason.TimeControl)         => "timeout"
-      case GameResult.Draw(DrawReason.Stalemate)            => "stalemate"
-      case GameResult.Draw(DrawReason.InsufficientMaterial) => "insufficient_material"
-      case GameResult.Draw(DrawReason.FiftyMoveRule)        => "fifty_move"
-      case GameResult.Draw(DrawReason.ThreefoldRepetition)  => "repetition"
-      case GameResult.Draw(DrawReason.Agreement)            => "agreement"
-    val payload = objectMapper.valueToTree[JsonNode](
-      GameOverPayload(gameId, resultStr, terminationReason, entry.white.id.value, entry.black.id.value),
-    )
-    val envelope = EventEnvelope.of(EventType.GameOver, payload)
-    redis
-      .stream(classOf[String])
-      .xadd(
-        s"$redisPrefix:game-over",
-        new XAddArgs().maxlen(maxStreamLen).nearlyExactTrimming(),
-        Map("data" -> objectMapper.writeValueAsString(envelope)).asJava,
-      )
-
   private def buildWriteback(entry: GameEntry, dto: GameStateDto): GameWritebackEventDto =
     val clock = entry.engine.currentClockState
     GameWritebackEventDto(

modules/core/src/main/scala/de/nowchess/chess/redis/GameRedisSubscriberManager.scala

@@ -22,7 +22,7 @@ import org.jboss.logging.Logger
 import scala.compiletime.uninitialized
 import scala.jdk.CollectionConverters.*
 import scala.util.Try
-import java.util.concurrent.{ConcurrentHashMap, ExecutorService, Executors}
+import java.util.concurrent.ConcurrentHashMap
 import java.util.function.Consumer
 
 @ApplicationScoped
@@ -46,10 +46,6 @@ class GameRedisSubscriberManager:
 
   private val c2sListeners = new ConcurrentHashMap[String, ReactivePubSubCommands.ReactiveRedisSubscriber]()
   private val s2cObservers = new ConcurrentHashMap[String, Observer]()
-  // Per-game single-thread executor so c2s messages are handled off the Vert.x
-  // event loop (handleConnected/handleMove make blocking gRPC + Redis calls) while
-  // staying ordered per game.
-  private val c2sExecutors = new ConcurrentHashMap[String, ExecutorService]()
 
   // scalafix:off DisableSyntax.var
   private var clockExpireSubscriber: Option[ReactivePubSubCommands.ReactiveRedisSubscriber] = None
@@ -93,21 +89,13 @@ class GameRedisSubscriberManager:
       writebackFn,
       ioClient,
       unsubscribeGame,
-      redisConfig.prefix,
     )
     s2cObservers.put(gameId, obs)
     registry.get(gameId).foreach(_.engine.subscribe(obs))
     obs.emitInitialWriteback()
     heartbeatServiceOpt.foreach(_.addGameSubscription(gameId))
 
-    val executor = c2sExecutors.computeIfAbsent(gameId, _ => Executors.newSingleThreadExecutor())
-    val handler: Consumer[String] = msg =>
-      val task = new Runnable:
-        def run(): Unit =
-          try handleC2sMessage(gameId, msg)
-          catch case ex: Exception => log.warnf(ex, "Error handling c2s message for game %s", gameId)
-      Try(executor.execute(task))
-      ()
+    val handler: Consumer[String] = msg => handleC2sMessage(gameId, msg)
     try
       val subscriber = reactiveRedis
         .pubsub(classOf[String])
@@ -118,16 +106,6 @@ class GameRedisSubscriberManager:
       log.debugf("Subscribed to game %s", gameId)
     catch case ex: Exception => log.warnf(ex, "Redis subscription failed for game %s", gameId)
 
-  // Notify the official-bots service to start playing a side of a game. Mirrors
-  // the event the tournament service publishes; official-bots subscribes to
-  // "<prefix>:bot:*:events".
-  def publishBotGameStart(gameId: String, botId: String, playingAs: String): Unit =
-    val channel = s"${redisConfig.prefix}:bot:$botId:events"
-    val payload = s"""{"type":"gameStart","gameId":"$gameId","playingAs":"$playingAs","botAccountId":"$botId"}"""
-    Try(redis.pubsub(classOf[String]).publish(channel, payload)) match
-      case scala.util.Failure(ex) => log.warnf(ex, "Failed to publish bot gameStart for game %s", gameId)
-      case scala.util.Success(_)  => ()
-
   def unsubscribeGame(gameId: String): Unit =
     Option(c2sListeners.remove(gameId)).foreach { subscriber =>
       subscriber.unsubscribe(c2sTopic(gameId)).subscribe().`with`(_ => (), _ => ())
@@ -135,7 +113,6 @@ class GameRedisSubscriberManager:
     Option(s2cObservers.remove(gameId)).foreach { obs =>
       registry.get(gameId).foreach(_.engine.unsubscribe(obs))
     }
-    Option(c2sExecutors.remove(gameId)).foreach(_.shutdownNow())
 
     heartbeatServiceOpt.foreach(_.removeGameSubscription(gameId))
     log.debugf("Unsubscribed from game %s", gameId)
@@ -210,4 +187,3 @@ class GameRedisSubscriberManager:
     clockExpireSubscriber.foreach(_.unsubscribe(clockExpireChannel).await().indefinitely())
     c2sListeners.forEach((gameId, subscriber) => subscriber.unsubscribe(c2sTopic(gameId)).await().indefinitely())
     s2cObservers.forEach((gameId, obs) => registry.get(gameId).foreach(_.engine.unsubscribe(obs)))
-    c2sExecutors.forEach((_, executor) => executor.shutdownNow())

modules/core/src/main/scala/de/nowchess/chess/resource/GameResource.scala

@@ -25,7 +25,6 @@ import de.nowchess.chess.observer.*
 import de.nowchess.chess.redis.GameRedisSubscriberManager
 import de.nowchess.chess.registry.{GameEntry, GameRegistry}
 import de.nowchess.security.InternalOnly
-import jakarta.annotation.security.PermitAll
 import jakarta.enterprise.context.ApplicationScoped
 import jakarta.inject.Inject
 import jakarta.ws.rs.*
@@ -180,32 +179,6 @@ class GameResource:
     )
     created(GameDtoMapper.toGameFullDto(entry, ioClient))
 
-  // Player-facing game creation for "play vs bot". Unlike createGame this is not
-  // internal-only: a logged-in (or anonymous) player creates the game directly,
-  // and core notifies the official-bots service to play the bot side.
-  @POST
-  @Path("/vs-bot")
-  @PermitAll
-  @Consumes(Array(MediaType.APPLICATION_JSON))
-  @Produces(Array(MediaType.APPLICATION_JSON))
-  def createBotGame(body: CreateGameRequestDto): Response =
-    val req   = Option(body).getOrElse(CreateGameRequestDto(None, None, None, None))
-    val white = playerInfoFrom(req.white, DefaultWhite)
-    val black = playerInfoFrom(req.black, DefaultBlack)
-    val tc    = toTimeControl(req.timeControl)
-    val entry = newEntry(GameContext.initial, white, black, tc, GameMode.Open)
-    registry.store(entry)
-    subscriberManager.subscribeGame(entry.gameId)
-    notifyBotSide(entry)
-    log.infof("Bot game %s created — white=%s black=%s", entry.gameId, white.displayName, black.displayName)
-    created(GameDtoMapper.toGameFullDto(entry, ioClient))
-
-  private def notifyBotSide(entry: GameEntry): Unit =
-    if entry.black.id.value.startsWith("bot-") then
-      subscriberManager.publishBotGameStart(entry.gameId, entry.black.id.value, "black")
-    else if entry.white.id.value.startsWith("bot-") then
-      subscriberManager.publishBotGameStart(entry.gameId, entry.white.id.value, "white")
-
   @GET
   @Path("/{gameId}")
   @Produces(Array(MediaType.APPLICATION_JSON))
@@ -339,18 +312,6 @@ class GameResource:
     log.infof("Imported PGN game %s", entry.gameId)
     created(GameDtoMapper.toGameFullDto(entry, ioClient))
 
-  @GET
-  @Path("/{gameId}/fen-history")
-  @Produces(Array(MediaType.APPLICATION_JSON))
-  def getFenHistory(@PathParam("gameId") gameId: String): Response =
-    val entry    = registry.get(gameId).getOrElse(throw GameNotFoundException(gameId))
-    val engine   = entry.engine
-    val initial  = engine.initialContext
-    val moves    = engine.context.moves
-    val contexts = moves.scanLeft(initial)((ctx, move) => engine.ruleSet.applyMove(ctx)(move))
-    val fens     = contexts.map(ctx => ioClient.exportFen(ctx))
-    ok(FenHistoryDto(fens))
-
   @GET
   @Path("/{gameId}/export/fen")
   @Produces(Array(MediaType.TEXT_PLAIN))

modules/core/src/main/scala/de/nowchess/chess/service/GameCreationService.scala

@@ -1,71 +0,0 @@
-package de.nowchess.chess.service
-
-import de.nowchess.api.dto.{GameCreationRequestDto, PlayerInfoDto, TimeControlDto}
-import de.nowchess.api.game.{GameContext, GameMode, TimeControl}
-import de.nowchess.api.player.{PlayerId, PlayerInfo}
-import de.nowchess.chess.engine.GameEngine
-import de.nowchess.chess.grpc.RuleSetGrpcAdapter
-import de.nowchess.chess.redis.GameRedisSubscriberManager
-import de.nowchess.chess.registry.{GameEntry, GameRegistry}
-import jakarta.enterprise.context.ApplicationScoped
-import jakarta.inject.Inject
-import org.jboss.logging.Logger
-import scala.compiletime.uninitialized
-
-@ApplicationScoped
-class GameCreationService:
-
-  private val log = Logger.getLogger(classOf[GameCreationService])
-
-  // scalafix:off DisableSyntax.var
-  @Inject var registry: GameRegistry                        = uninitialized
-  @Inject var ruleSetAdapter: RuleSetGrpcAdapter            = uninitialized
-  @Inject var subscriberManager: GameRedisSubscriberManager = uninitialized
-  // scalafix:on DisableSyntax.var
-
-  private val DefaultWhite = PlayerInfo(PlayerId("p1"), "Player 1")
-  private val DefaultBlack = PlayerInfo(PlayerId("p2"), "Player 2")
-
-  def createGame(req: GameCreationRequestDto): GameEntry =
-    val white = playerInfoFrom(req.white, DefaultWhite)
-    val black = playerInfoFrom(req.black, DefaultBlack)
-    val tc    = toTimeControl(req.timeControl)
-    val mode  = req.mode.getOrElse(GameMode.Open)
-    val entry = newEntry(GameContext.initial, white, black, tc, mode)
-    registry.store(entry)
-    subscriberManager.subscribeGame(entry.gameId)
-    log.infof(
-      "Game %s created — white=%s black=%s mode=%s",
-      entry.gameId,
-      white.displayName,
-      black.displayName,
-      mode.toString,
-    )
-    entry
-
-  private def playerInfoFrom(dto: Option[PlayerInfoDto], default: PlayerInfo): PlayerInfo =
-    dto.fold(default)(d => PlayerInfo(PlayerId(d.id), d.displayName))
-
-  private def toTimeControl(dto: Option[TimeControlDto]): TimeControl =
-    dto match
-      case None => TimeControl.Unlimited
-      case Some(tc) =>
-        tc.daysPerMove match
-          case Some(d) => TimeControl.Correspondence(d)
-          case None =>
-            tc.limitSeconds.fold(TimeControl.Unlimited)(l => TimeControl.Clock(l, tc.incrementSeconds.getOrElse(0)))
-
-  private def newEntry(
-      ctx: GameContext,
-      white: PlayerInfo,
-      black: PlayerInfo,
-      tc: TimeControl,
-      mode: GameMode,
-  ): GameEntry =
-    GameEntry(
-      registry.generateId(),
-      GameEngine(initialContext = ctx, ruleSet = ruleSetAdapter, timeControl = tc),
-      white,
-      black,
-      mode = mode,
-    )

modules/core/src/test/resources/application.yml

@@ -18,8 +18,6 @@ nowchess:
       enabled: false
   coordinator:
     enabled: false
-  game-creation-stream:
-    enabled: false
   redis:
     host: localhost
     port: 6379

modules/core/src/test/scala/de/nowchess/chess/redis/GameRedisPublisherTest.scala

@@ -1,123 +0,0 @@
-package de.nowchess.chess.redis
-
-import com.fasterxml.jackson.databind.ObjectMapper
-import com.fasterxml.jackson.datatype.jsr310.JavaTimeModule
-import de.nowchess.api.board.Color
-import de.nowchess.api.game.{DrawReason, GameContext, GameResult, WinReason}
-import de.nowchess.api.player.{PlayerId, PlayerInfo}
-import de.nowchess.chess.client.CombinedExportResponse
-import de.nowchess.chess.engine.GameEngine
-import de.nowchess.chess.grpc.IoGrpcClientWrapper
-import de.nowchess.chess.observer.GameEvent
-import de.nowchess.chess.registry.{GameEntry, GameRegistry}
-import de.nowchess.rules.sets.DefaultRules
-import io.quarkus.redis.datasource.RedisDataSource
-import io.quarkus.redis.datasource.pubsub.PubSubCommands
-import io.quarkus.redis.datasource.stream.{StreamCommands, XAddArgs}
-import org.junit.jupiter.api.Assertions.*
-import org.junit.jupiter.api.{BeforeEach, Test}
-import org.mockito.ArgumentMatchers.*
-import org.mockito.Mockito.*
-import scala.compiletime.uninitialized
-
-class GameRedisPublisherTest:
-
-  // scalafix:off DisableSyntax.var
-  private var redis: RedisDataSource                              = uninitialized
-  private var streamCmds: StreamCommands[String, String, Nothing] = uninitialized
-  private var pubsubCmds: PubSubCommands[String]                  = uninitialized
-  private var registry: GameRegistry                              = uninitialized
-  private var ioClient: IoGrpcClientWrapper                       = uninitialized
-  private var onGameOverCalled: Boolean                           = false
-  // scalafix:on DisableSyntax.var
-
-  private val objectMapper = new ObjectMapper().registerModule(new JavaTimeModule())
-  private val gameId       = "game1"
-  private val whitePlayer  = PlayerInfo(PlayerId("white1"), "Alice")
-  private val blackPlayer  = PlayerInfo(PlayerId("black1"), "Bob")
-
-  @BeforeEach
-  def setup(): Unit =
-    redis = mock(classOf[RedisDataSource])
-    streamCmds = mock(classOf[StreamCommands[String, String, Nothing]])
-    pubsubCmds = mock(classOf[PubSubCommands[String]])
-    registry = mock(classOf[GameRegistry])
-    ioClient = mock(classOf[IoGrpcClientWrapper])
-    when(redis.stream(classOf[String])).thenReturn(streamCmds)
-    when(redis.pubsub(classOf[String])).thenReturn(pubsubCmds)
-    when(ioClient.exportCombined(any()))
-      .thenReturn(CombinedExportResponse("rnbqkbnr/pppppppp/8/8/8/8/PPPPPPPP/RNBQKBNR w KQkq - 0 1", ""))
-    onGameOverCalled = false
-
-  private def publisherWithResult(result: GameResult): GameRedisPublisher =
-    val ctx    = GameContext.initial.copy(result = Some(result))
-    val engine = new GameEngine(initialContext = ctx, ruleSet = DefaultRules)
-    val entry  = GameEntry(gameId, engine, whitePlayer, blackPlayer)
-    when(registry.get(gameId)).thenReturn(Some(entry))
-    new GameRedisPublisher(
-      gameId,
-      registry,
-      redis,
-      objectMapper,
-      s"nowchess:game:$gameId:s2c",
-      _ => (),
-      ioClient,
-      _ => onGameOverCalled = true,
-      "nowchess",
-    )
-
-  @Test
-  def publishesGameOverOnCheckmate(): Unit =
-    val publisher = publisherWithResult(GameResult.Win(Color.White, WinReason.Checkmate))
-    publisher.onGameEvent(mock(classOf[GameEvent]))
-    verify(streamCmds).xadd(
-      org.mockito.ArgumentMatchers.eq("nowchess:game-over"),
-      any(classOf[XAddArgs]),
-      any(),
-    )
-    assertTrue(onGameOverCalled)
-
-  @Test
-  def publishesGameOverOnResignation(): Unit =
-    val publisher = publisherWithResult(GameResult.Win(Color.Black, WinReason.Resignation))
-    publisher.onGameEvent(mock(classOf[GameEvent]))
-    verify(streamCmds).xadd(
-      org.mockito.ArgumentMatchers.eq("nowchess:game-over"),
-      any(classOf[XAddArgs]),
-      any(),
-    )
-
-  @Test
-  def publishesGameOverOnDraw(): Unit =
-    val publisher = publisherWithResult(GameResult.Draw(DrawReason.Agreement))
-    publisher.onGameEvent(mock(classOf[GameEvent]))
-    verify(streamCmds).xadd(
-      org.mockito.ArgumentMatchers.eq("nowchess:game-over"),
-      any(classOf[XAddArgs]),
-      any(),
-    )
-
-  @Test
-  def doesNotPublishGameOverWhenNoResult(): Unit =
-    val ctx    = GameContext.initial
-    val engine = new GameEngine(initialContext = ctx, ruleSet = DefaultRules)
-    val entry  = GameEntry(gameId, engine, whitePlayer, blackPlayer)
-    when(registry.get(gameId)).thenReturn(Some(entry))
-    val publisher = new GameRedisPublisher(
-      gameId,
-      registry,
-      redis,
-      objectMapper,
-      s"nowchess:game:$gameId:s2c",
-      _ => (),
-      ioClient,
-      _ => onGameOverCalled = true,
-      "nowchess",
-    )
-    publisher.onGameEvent(mock(classOf[GameEvent]))
-    verify(streamCmds, never()).xadd(
-      org.mockito.ArgumentMatchers.eq("nowchess:game-over"),
-      any(classOf[XAddArgs]),
-      any(),
-    )
-    assertFalse(onGameOverCalled)

modules/core/src/test/scala/de/nowchess/chess/service/GameCreationServiceTest.scala

@@ -1,68 +0,0 @@
-package de.nowchess.chess.service
-
-import de.nowchess.api.dto.{GameCreationRequestDto, PlayerInfoDto, TimeControlDto}
-import de.nowchess.api.game.{GameMode, TimeControl}
-import de.nowchess.api.player.PlayerType
-import de.nowchess.chess.client.CombinedExportResponse
-import de.nowchess.chess.grpc.IoGrpcClientWrapper
-import de.nowchess.chess.redis.GameRedisSubscriberManager
-import io.quarkus.test.InjectMock
-import io.quarkus.test.junit.QuarkusTest
-import jakarta.inject.Inject
-import org.junit.jupiter.api.Assertions.*
-import org.junit.jupiter.api.{BeforeEach, DisplayName, Test}
-import org.mockito.ArgumentMatchers.any
-import org.mockito.Mockito.{verify, when}
-import scala.compiletime.uninitialized
-
-// scalafix:off
-@QuarkusTest
-@DisplayName("GameCreationService")
-class GameCreationServiceTest:
-
-  @Inject
-  var service: GameCreationService = uninitialized
-
-  @InjectMock
-  var subscriberManager: GameRedisSubscriberManager = uninitialized
-
-  @InjectMock
-  var ioWrapper: IoGrpcClientWrapper = uninitialized
-
-  @BeforeEach
-  def setup(): Unit =
-    when(ioWrapper.exportCombined(any()))
-      .thenReturn(CombinedExportResponse("rnbqkbnr/pppppppp/8/8/8/8/PPPPPPPP/RNBQKBNR w KQkq - 0 1", ""))
-
-  private def player(id: String, name: String): PlayerInfoDto =
-    PlayerInfoDto(id, name, PlayerType.Human)
-
-  @Test
-  def createsGameAndSubscribes(): Unit =
-    val req =
-      GameCreationRequestDto(Some(player("w", "White")), Some(player("b", "Black")), None, Some(GameMode.Authenticated))
-    val entry = service.createGame(req)
-    assertNotNull(entry.gameId)
-    assertEquals("White", entry.white.displayName)
-    assertEquals("Black", entry.black.displayName)
-    assertEquals(GameMode.Authenticated, entry.mode)
-    verify(subscriberManager).subscribeGame(entry.gameId)
-
-  @Test
-  def defaultsToOpenModeAndDefaultPlayers(): Unit =
-    val entry = service.createGame(GameCreationRequestDto(None, None, None, None))
-    assertEquals(GameMode.Open, entry.mode)
-    assertEquals("Player 1", entry.white.displayName)
-    assertEquals("Player 2", entry.black.displayName)
-
-  @Test
-  def mapsClockTimeControl(): Unit =
-    val tc    = TimeControlDto(Some(300), Some(5), None)
-    val entry = service.createGame(GameCreationRequestDto(None, None, Some(tc), None))
-    assertEquals(TimeControl.Clock(300, 5), entry.engine.timeControl)
-
-  @Test
-  def mapsCorrespondenceTimeControl(): Unit =
-    val tc    = TimeControlDto(None, None, Some(3))
-    val entry = service.createGame(GameCreationRequestDto(None, None, Some(tc), None))
-    assertEquals(TimeControl.Correspondence(3), entry.engine.timeControl)

modules/core/versions.env

@@ -1,3 +1,3 @@
 MAJOR=0
-MINOR=53
+MINOR=47
 PATCH=0

modules/official-bots/build.gradle.kts

@@ -47,14 +47,6 @@ tasks.withType<JavaCompile> {
     options.compilerArgs.add("-parameters")
 }
 
-tasks.register<JavaExec>("selfPlay") {
-    group = "nnue"
-    description = "Run standalone NNUEBot self-play and write FENs for labeling."
-    mainClass.set("de.nowchess.bot.selfplay.SelfPlayMain")
-    classpath = sourceSets["main"].runtimeClasspath
-    args((project.findProperty("spArgs")?.toString() ?: "").split(" ").filter { it.isNotBlank() })
-}
-
 dependencies {
 
     compileOnly("org.scala-lang:scala3-compiler_3") {

modules/official-bots/python/COLAB_TRAINING_CONCEPT.md

@@ -1,212 +0,0 @@
-# Concept: NNUE Training Data — Quality, Scale, and Transfer to Colab
-
-Local generation + labeling is **not** a constraint (Ryzen 9800X3D / RTX 5070 / 32 GB).
-So the design splits cleanly:
-
-- **Data plane = local box.** Generate, label, shard, publish. Cheap, fast, no limits.
-- **Train plane = Colab.** Pull a dataset version, GPU-train, export `.nbai`.
-
-Colab never runs Stockfish and never sees a browser upload. Three problems below:
-**(1) good data, (2) growing it over time, (3) getting it there easily** — (3) is the priority.
-
----
-
-## 1. Generating *good* training sets
-
-### The current weak spot
-
-`generate.py` plays **fully random games** (`random.choice(legal_moves)`). Random play
-produces positions that never occur in real games — material chaos, nonsense pawn
-structures. An NNUE trained on that learns to evaluate a distribution it will never
-face. Fine as filler, wrong as the backbone.
-
-### What a good NNUE dataset needs
-
-1. **Realistic position distribution.** Positions should resemble what the bot actually
-   reaches in search — from real games and engine play, not coin-flip moves.
-2. **Phase coverage.** Openings, middlegames, endgames all represented. Endgames are
-   under-sampled by random play and matter most for precise eval.
-3. **Eval balance.** Real game data is dominated by near-equal positions. If 80% of
-   labels sit in `[-0.5, +0.5]`, the net learns "everything is roughly equal." Resample
-   to flatten the eval histogram (cap per-bucket counts).
-4. **Accurate labels.** Deeper Stockfish = better target. Locally you can afford
-   depth 16–20. Or skip labeling entirely with the Lichess eval DB (below).
-5. **Clean positions.** Dedup by FEN; drop terminal/checkmate/stalemate; the side to
-   move should not already be in check unless intended; tag the game phase.
-
-### Recommended source mix (per dataset version)
-
-| Source | Role | How | Weight |
-|---|---|---|---|
-| **Lichess eval DB** | Backbone | `lichess_importer.py` — millions of FENs **pre-labeled** by deep Stockfish, real human positions, correct sign convention | 50–70% |
-| **Engine self-play** | Bot's own distribution | NNUEBot (or vs Stockfish) plays games; sample positions; label with local Stockfish | 20–40% |
-| **Tactical puzzles** | Sharp/critical positions | `tactical_positions_extractor.py` (Lichess puzzle DB) | 5–15% |
-| **Random play** | Cheap diversity filler | existing `generate.py`, capped low | ≤10% |
-
-The backbone is real, pre-labeled data — so labeling cost is near zero and quality is
-high. Self-play is the part that adapts data to *your* bot. Random play stays only as
-a thin diversity sprinkle.
-
-### Self-play flywheel (the quality engine over time)
-
-The strongest lever: **net N generates the games that train net N+1.**
-
-```
-net_vN  ──play self-play games──►  sample positions  ──label (Stockfish)──►
-   ▲                                                                        │
-   └──────────────── train on (backbone + new self-play) ◄─────────────────┘
-                                  net_v(N+1)
-```
-
-Each generation, the bot reaches positions closer to its real playing distribution,
-labels them with a stronger-than-bot oracle (Stockfish), and learns the gap. Standard
-modern NNUE practice. Keep the Lichess backbone mixed in every round so the net does
-not overfit to its own blind spots.
-
----
-
-## 2. Scaling datasets over time — append-only shards
-
-Do **not** maintain one growing `labeled.jsonl` and re-copy it. Make a dataset an
-**immutable set of shards plus a manifest**:
-
-```
-datasets/
-  shards/
-    lichess_000001.jsonl.zst      # ~50–100k positions each, ~5–10 MB compressed
-    lichess_000002.jsonl.zst
-    selfplay_v7_000001.jsonl.zst
-    tactical_000001.jsonl.zst
-    ...
-  manifest.json
-```
-
-`manifest.json`:
-
-```json
-{
-  "dataset_version": 7,
-  "created": "2026-06-24T...",
-  "total_positions": 4200000,
-  "scale": 300.0,
-  "shards": [
-    {"file": "lichess_000001.jsonl.zst", "positions": 100000,
-     "sha256": "...", "source": "lichess_eval", "stockfish_depth": 0},
-    {"file": "selfplay_v7_000001.jsonl.zst", "positions": 80000,
-     "sha256": "...", "source": "selfplay", "net": "v7", "stockfish_depth": 18}
-  ]
-}
-```
-
-Properties this buys:
-
-- **Growth = add shards.** Generate a new batch, label it, write one new shard, append
-  one manifest entry. Never touch existing shards. O(new data), not O(total).
-- **Provenance.** Each shard records source + net + depth. You can later down-weight or
-  drop a bad batch by editing the manifest, no relabeling.
-- **Dedup across shards** by FEN hash at build time; record dropped counts in metadata.
-- **Reproducible mixes.** A "dataset version" is just a manifest selecting shards +
-  per-source sampling weights. Cheap to define many mixes over the same shard pool.
-- **Resumable, cache-friendly transfer** (next section) — the whole reason for shards.
-
-`dataset.py`'s existing `ds_vN` + `metadata.json` scheme generalizes to this directly:
-the dataset dir holds `shards/` + `manifest.json` instead of one `labeled.jsonl`.
-
----
-
-## 3. Getting data to Colab easily  ← top priority
-
-Shards make this trivial: **incremental sync, never a full re-upload.**
-
-### Recommended: rclone → Google Drive, read from mounted Drive
-
-Colab mounts Drive natively, so the cheapest path is to make Drive the shard store and
-sync into it with `rclone` (only uploads new/changed shards):
-
-```bash
-# Local, after building shards:
-rclone copy datasets/ gdrive:NowChess/datasets --progress
-#   ^ uploads only shards Drive doesn't have yet. Adding 80k positions = one small file.
-```
-
-Colab side, one cell:
-
-```python
-SRC = '/content/drive/MyDrive/NowChess/datasets'   # mounted, no download
-import json, shutil, pathlib
-manifest = json.load(open(f'{SRC}/manifest.json'))
-local = pathlib.Path('/content/datasets'); local.mkdir(exist_ok=True)
-for sh in manifest['shards']:                       # copy Drive→local SSD (fast seq read)
-    dst = local / sh['file']
-    if not dst.exists():                            # cache: only copy missing shards
-        shutil.copy(f"{SRC}/shards/{sh['file']}", dst)
-```
-
-Why this wins on "easy":
-- **No browser upload, ever.** One `rclone copy` from your PC.
-- **Incremental both directions.** Add a shard locally → next `rclone copy` ships only
-  that shard. Colab copies only shards it doesn't already have on `/content`.
-- **Zero new infra.** Drive is already mounted in the notebook.
-
-### Alternative: Gitea release per dataset version (if Drive quota hurts)
-
-You self-host `git.janis-eccarius.de`. Tag `ds_v7`, attach shards + `manifest.json` as
-release assets. Colab reads the manifest, then parallel-`wget` only the shards it lacks
-(checksum-verified). Versioned, immutable, no Drive quota, token-gated. Slightly more
-wiring than rclone→Drive.
-
-Pick rclone→Drive for minimum friction; Gitea releases if you want hard versioning and
-to keep Drive small.
-
-### Notebook changes either way
-
-- Clone repo to **ephemeral `/content`** (fast), not Drive. Persist only datasets +
-  checkpoints.
-- Drop Option A (no Colab generation) and Option B (no browser upload). One "sync
-  dataset version" cell instead.
-- Train reads shards via a streaming `.jsonl.zst` loader (apply per-source sampling
-  weights + eval-bucket balancing here). Keep burst-train + Drive checkpoints + `.nbai`
-  export.
-
----
-
-## Resulting workflow
-
-```
-LOCAL (9800X3D / RTX5070)                         COLAB (GPU)
-─────────────────────────                         ───────────
-import Lichess eval DB ─┐
-self-play with net_vN  ─┼─► label ─► dedup ─► write new shard(s) ─► manifest++
-tactical / random      ─┘                                  │
-                                       rclone copy ────────┘
-                                       datasets/ → Drive
-                                                              │  (only new shards move)
-                                                              ▼
-                                    sync version → copy missing shards → train (GPU)
-                                                              │
-                                                       export .nbai
-                                                              ▼
-                              place in src/main/resources/, rebuild native image
-```
-
-## Build order
-
-1. **Shard format + manifest** in `dataset.py`: write/read `shards/*.jsonl.zst` +
-   `manifest.json`; dedup-across-shards on build; provenance per shard.
-2. **Streaming `.zst` dataloader** in `train.py`: read shards, apply per-source weights
-   and eval-bucket balancing.
-3. **Self-play generator** in `src/`: NNUEBot/Stockfish self-play → positions → local
-   Stockfish label → new shard. This is the scaling engine.
-4. **`dataset_sync.py`**: `push` (rclone→Drive or Gitea upload) / `pull` (cache-aware).
-5. **Notebook rewrite**: ephemeral clone, single sync cell, weighted streaming loader.
-6. Wire `lichess_importer.py` as the backbone shard source.
-
-## Open decisions
-
-- **Transfer backend** — rclone→Drive (easiest, recommended) vs Gitea releases (hard
-  versioning).
-- **Self-play opponent** — NNUEBot vs itself (own distribution) vs vs-Stockfish
-  (stronger, more decisive games). Likely a mix.
-- **Backbone/self-play ratio** — start ~60/30/10 (lichess/selfplay/tactical), tune by
-  measured strength.
-- **Shard size** — 50k vs 100k positions/shard (transfer granularity vs file count).

modules/official-bots/python/IMPLEMENTATION_PLAN.md

@@ -1,180 +0,0 @@
-# Implementation Plan: Two One-Liner Tools (self-play + dataset)
-
-Goal: **two tools, two start scripts, minimal params.**
-
-```
-./selfplay.sh      # bot plays games against itself, writes selfplay FENs       (Scala, standalone)
-./dataset.sh       # builds the ENTIRE training dataset + rclone push to Drive   (Python, one script)
-```
-
-Both default-everything. Optional first positional arg only when you want to override
-the one number that matters.
-
----
-
-## Tool 1 — `selfplay.sh` (standalone bot, no microservices)
-
-### Why it can be standalone
-
-`Bot` is just `GameContext => Option[Move]` (`Bot.scala`). `NNUEBot.apply` needs only
-`DefaultRules` (rule module) + `EvaluationNNUE` (loads the bundled `.nbai`). No Quarkus,
-no coordinator/account/ws. The bot module already depends on `api, rule, io`, and `io`
-has `FenExporter` + `GameContext.initial` exists. So a plain JVM `main` can run games
-with zero service wiring.
-
-### New file: `SelfPlayMain.scala`
-
-`modules/official-bots/src/main/scala/de/nowchess/bot/selfplay/SelfPlayMain.scala`
-
-Loop per game:
-
-1. Start from `GameContext.initial`.
-2. **Opening diversity** — play `R` random legal plies (default 8). Without this,
-   NNUEBot vs itself is deterministic → the *same game every time*. Random openings are
-   what make the games diverse. (Optional later: seed from polyglot book instead.)
-3. Then both sides = `NNUEBot(difficulty)`. Apply moves via `DefaultRules.applyMove`.
-4. Stop on `isCheckmate / isStalemate / isInsufficientMaterial / isFiftyMoveRule /
-   isThreefoldRepetition`, or ply cap (default 200).
-5. Emit one **FEN per ply** (via `FenExporter`), skipping positions where side-to-move
-   is in check and terminal positions — same filter philosophy the labeler wants.
-6. Append FENs to the output file (one per line) — exactly the format `label.py` reads.
-
-Config = a small `case class` with defaults; read from env/args. Defaults:
-`games=2000`, `randomOpeningPlies=8`, `maxPlies=200`, `out=python/data/selfplay.txt`,
-`threads = availableProcessors`. Parallelize games across threads (each game is
-independent; bot is pure).
-
-Output is **FENs only** — labeling happens in Tool 2 with Stockfish. Keeps the bot tool
-single-responsibility and fast.
-
-### Gradle: a plain run task (not Quarkus)
-
-Add to `modules/official-bots/build.gradle.kts`:
-
-```kotlin
-tasks.register<JavaExec>("selfPlay") {
-    group = "nnue"
-    mainClass.set("de.nowchess.bot.selfplay.SelfPlayMain")
-    classpath = sourceSets["main"].runtimeClasspath
-    args(project.findProperty("spArgs")?.toString()?.split(" ") ?: emptyList())
-}
-```
-
-### `selfplay.sh` (repo `python/` dir)
-
-```bash
-#!/usr/bin/env bash
-set -euo pipefail
-GAMES="${1:-2000}"
-cd "$(dirname "$0")/../../.."        # repo root
-./gradlew -q :official-bots:selfPlay -PspArgs="--games $GAMES --out modules/official-bots/python/data/selfplay.txt"
-echo "Self-play FENs -> modules/official-bots/python/data/selfplay.txt"
-```
-
-Usage:
-
-```bash
-./selfplay.sh          # 2000 games, bundled net
-./selfplay.sh 8000     # more games
-```
-
----
-
-## Tool 2 — `dataset.sh` → `build_dataset.py` (builds EVERYTHING)
-
-One Python script that produces a complete, sharded, pushed dataset. No TUI, no
-multi-step menus. It runs the whole data plane end to end:
-
-```
-lichess eval DB ─┐
-selfplay.txt    ─┼─► label (local Stockfish, skip already-labeled) ─► dedup ─►
-tactical        ─┤                                                   eval-bucket
-random filler   ─┘                                                   balance ─►
-                                              write shards/*.jsonl.zst + manifest.json ─► rclone push
-```
-
-### New file: `build_dataset.py` (top-level `python/`)
-
-Reuses existing modules — orchestrates, doesn't reinvent:
-
-- **Backbone:** `lichess_importer.py` — download + sample N pre-labeled positions from
-  the Lichess eval DB (no Stockfish cost).
-- **Self-play:** read `data/selfplay.txt` FENs → `label.py` with local Stockfish
-  (depth 18, all cores — your box eats this).
-- **Tactical:** `tactical_positions_extractor.py` → `label.py`.
-- **Random filler:** `generate.py` (small cap) → `label.py`.
-- **Merge:** dedup by FEN across all sources; **eval-bucket balancing** (cap positions
-  per eval bin so near-equal positions don't dominate).
-- **Shard + manifest:** split into `shards/*.jsonl.zst` (~100k positions each) + write
-  `manifest.json` (positions, sha256, source, net, depth per shard). Append-only:
-  existing shards untouched, new run adds shards + entries (the scaling story from the
-  concept).
-- **Push:** `rclone copy datasets/ gdrive:NowChess/datasets` — ships only new shards.
-
-### One config block, sane defaults
-
-Top of the script — the *only* thing you ever touch:
-
-```python
-LICHESS_POSITIONS = 2_000_000   # backbone
-USE_SELFPLAY      = True        # reads data/selfplay.txt if present
-TACTICAL_PUZZLES  = 200_000
-RANDOM_FILLER     = 100_000
-STOCKFISH_DEPTH   = 18
-RCLONE_REMOTE     = "gdrive:NowChess/datasets"
-```
-
-Everything else (paths, workers=all cores, shard size, balancing bins) is internal.
-
-### `dataset.sh`
-
-```bash
-#!/usr/bin/env bash
-set -euo pipefail
-cd "$(dirname "$0")"
-python build_dataset.py "$@"
-```
-
-Usage:
-
-```bash
-./dataset.sh          # full dataset (lichess + selfplay + tactical + filler) -> Drive
-```
-
-That single command: downloads backbone, labels self-play/tactical/filler, dedups,
-balances, shards, and rclone-pushes to Drive. Colab then syncs (concept doc §3).
-
----
-
-## End-to-end loop (the flywheel)
-
-```
-./selfplay.sh        # bot generates games with the current net
-./dataset.sh         # fold them into a new dataset version, push to Drive
-# (Colab) sync + train -> export nnue_weights.nbai
-# drop .nbai into modules/official-bots/src/main/resources/, rebuild
-./selfplay.sh        # next net plays stronger, better games... repeat
-```
-
----
-
-## Build order
-
-1. `SelfPlayMain.scala` — standalone game loop, random openings, parallel games, FEN out.
-2. `selfPlay` Gradle `JavaExec` task + `selfplay.sh`.
-3. `build_dataset.py` — orchestrate existing importer/label/tactical/generate into
-   shards + manifest; rclone push.
-4. `dataset.sh`.
-5. Shard/manifest read support in `dataset.py` + zstd streaming loader in `train.py`
-   (consumed on Colab).
-6. Notebook: single "sync dataset version" cell, ephemeral `/content` clone.
-
-## Decisions to confirm
-
-- **Self-play opponent:** NNUEBot vs itself + random openings (planned). Add vs-Stockfish
-  later if more decisive games wanted.
-- **Self-play net source:** use the `.nbai` bundled in `resources` (simplest), or accept
-  a `--weights path`? Plan = bundled by default.
-- **rclone remote name:** confirm `gdrive` is your configured rclone remote, and the
-  target folder `NowChess/datasets`.
-- **Stockfish path on your box:** `$STOCKFISH_PATH` or `/usr/games/stockfish`?

modules/official-bots/python/NNUETraining.ipynb

@@ -1,190 +0,0 @@
-{
- "nbformat": 4,
- "nbformat_minor": 5,
- "metadata": {
-  "kernelspec": {
-   "display_name": "Python 3",
-   "language": "python",
-   "name": "python3"
-  },
-  "language_info": {
-   "name": "python",
-   "version": "3.10.0"
-  },
-  "colab": {
-   "provenance": [],
-   "gpuType": "T4"
-  },
-  "accelerator": "GPU"
- },
- "cells": [
-  {
-   "cell_type": "markdown",
-   "metadata": {},
-   "source": "# NNUE Training Pipeline\n\nGPU training on Colab. Data is built **locally** (`./dataset.sh` → sharded, pushed to\nDrive via rclone); this notebook only **syncs shards → trains → exports `.nbai`**.\nNo generation, no Stockfish labeling, no browser uploads here.\n\n**Runtime:** GPU (T4 or better). Runtime → Change runtime type → T4 GPU.\n\n**Persistence:** Datasets and checkpoints live on Google Drive, so training resumes\nafter a session timeout. The repo is cloned to ephemeral `/content` for speed.",
-   "id": "intro-md"
-  },
-  {
-   "cell_type": "markdown",
-   "metadata": {},
-   "source": [
-    "---\n",
-    "## ⚙️ 1 — Setup"
-   ],
-   "id": "setup-md"
-  },
-  {
-   "cell_type": "code",
-   "execution_count": null,
-   "metadata": {},
-   "outputs": [],
-   "source": [
-    "# Mount Google Drive for checkpoint persistence\n",
-    "from google.colab import drive\n",
-    "drive.mount('/content/drive')"
-   ],
-   "id": "mount-drive"
-  },
-  {
-   "cell_type": "code",
-   "execution_count": null,
-   "metadata": {},
-   "outputs": [],
-   "source": "import os\n\n# ── Configure these paths once ───────────────────────────────────────────────\nREPO_URL   = 'https://git.janis-eccarius.de/NowChess/NowChessSystems.git'\nDRIVE_ROOT = '/content/drive/MyDrive/NowChess'   # datasets + weights persist here\nREPO_DIR   = '/content/NowChessSystems'          # ephemeral, fast local clone\nPYTHON_DIR = f'{REPO_DIR}/modules/official-bots/python'\n# ─────────────────────────────────────────────────────────────────────────────\n\nos.makedirs(DRIVE_ROOT, exist_ok=True)\n\n# Clone to ephemeral /content (NOT Drive) — fast checkout, no Drive bloat.\nif not os.path.isdir(REPO_DIR):\n    !git clone --depth=1 \"{REPO_URL}\" \"{REPO_DIR}\"\n    print('Repo cloned to /content.')\nelse:\n    !git -C \"{REPO_DIR}\" pull --ff-only\n    print('Repo updated.')",
-   "id": "clone-repo"
-  },
-  {
-   "cell_type": "code",
-   "execution_count": null,
-   "metadata": {},
-   "outputs": [],
-   "source": "# Install Python dependencies. No Stockfish — labeling happens on the local box,\n# this notebook only trains on already-labeled shards.\n!pip install -q chess tqdm rich zstandard\n\nimport sys\nsys.path.insert(0, f'{PYTHON_DIR}/src')\nsys.path.insert(0, PYTHON_DIR)\nprint('Python path configured.')",
-   "id": "install-deps"
-  },
-  {
-   "cell_type": "markdown",
-   "metadata": {},
-   "source": "---\n## 🗄️ 2 — Data\n\nDatasets are built **locally** (`./dataset.sh`) and pushed to Drive with rclone as\ncompressed shards under `MyDrive/NowChess/datasets/`. Here we just sync those shards\nto the fast local disk — no generation, no labeling, no browser uploads.\n\nThe cell reads `manifest.json` and copies only shards not already cached on `/content`.",
-   "id": "data-md"
-  },
-  {
-   "cell_type": "code",
-   "execution_count": null,
-   "metadata": {},
-   "outputs": [],
-   "source": "import json, shutil\nfrom pathlib import Path\n\n# Source: shards synced from the local box via `rclone copy datasets/ gdrive:NowChess/datasets`\nDRIVE_DATASETS = Path(DRIVE_ROOT) / 'datasets'\nLOCAL_DATASETS = Path('/content/datasets')\n(LOCAL_DATASETS / 'shards').mkdir(parents=True, exist_ok=True)\n\nmanifest = json.load(open(DRIVE_DATASETS / 'manifest.json'))\nprint(f\"Dataset v{manifest['dataset_version']}: \"\n      f\"{manifest['total_positions']:,} positions across {len(manifest['shards'])} shards\")\n\ncopied = 0\nfor sh in manifest['shards']:\n    dst = LOCAL_DATASETS / 'shards' / sh['file']\n    if not dst.exists():                      # cache: only copy shards we don't already have\n        shutil.copy(DRIVE_DATASETS / 'shards' / sh['file'], dst)\n        copied += 1\nshutil.copy(DRIVE_DATASETS / 'manifest.json', LOCAL_DATASETS / 'manifest.json')\n\nDATA_PATH = str(LOCAL_DATASETS)               # train_nnue / burst_train read this dir of shards directly\nprint(f\"Synced {copied} new shard(s). Dataset ready at {DATA_PATH}\")",
-   "id": "data-paths"
-  },
-  {
-   "cell_type": "markdown",
-   "metadata": {},
-   "source": [
-    "---\n",
-    "## 🏋️ 3 — Train\n",
-    "\n",
-    "Standard training runs a fixed number of epochs.  \n",
-    "**Burst mode** is better for Colab: it repeatedly restarts from the best checkpoint within a time budget, surviving session disconnects gracefully."
-   ],
-   "id": "train-md"
-  },
-  {
-   "cell_type": "code",
-   "execution_count": null,
-   "metadata": {},
-   "outputs": [],
-   "source": "from train import train_nnue, burst_train, DEFAULT_HIDDEN_SIZES\n\nWEIGHTS_DIR = Path(DRIVE_ROOT) / 'weights'\nWEIGHTS_DIR.mkdir(parents=True, exist_ok=True)\nOUTPUT_FILE = str(WEIGHTS_DIR / 'nnue_weights.pt')\n\n# ── Training hyperparameters ──────────────────────────────────────────────────\nHIDDEN_SIZES      = DEFAULT_HIDDEN_SIZES\n# Features are streamed as sparse indices and densified on the GPU per batch, so\n# host RAM is no longer the limit — GPU memory is. A dense batch is\n# batch_size * 98304 * 4 bytes on the GPU (~3.2 GB at 8192 on a 16 GB T4).\nBATCH_SIZE        = 8192\nEPOCHS            = 100\nEARLY_STOPPING    = 10                     # None to disable\nSUBSAMPLE_RATIO   = 1.0\n\n# Resume from latest checkpoint if one exists\ncheckpoints = sorted(WEIGHTS_DIR.glob('nnue_weights_v*.pt'))\nCHECKPOINT = str(checkpoints[-1]) if checkpoints else None\nif CHECKPOINT:\n    print(f'Resuming from checkpoint: {CHECKPOINT}')\nelse:\n    print('Starting training from scratch.')",
-   "id": "train-config"
-  },
-  {
-   "cell_type": "code",
-   "execution_count": null,
-   "metadata": {},
-   "outputs": [],
-   "source": "# ── Standard training ─────────────────────────────────────────────────────────\n# Use this when you have a reliable long-running session.\n\ntrain_nnue(\n    data_file=DATA_PATH,\n    output_file=OUTPUT_FILE,\n    epochs=EPOCHS,\n    batch_size=BATCH_SIZE,\n    checkpoint=CHECKPOINT,\n    use_versioning=True,\n    early_stopping_patience=EARLY_STOPPING,\n    subsample_ratio=SUBSAMPLE_RATIO,\n    hidden_sizes=HIDDEN_SIZES,\n)",
-   "id": "standard-train"
-  },
-  {
-   "cell_type": "code",
-   "execution_count": null,
-   "metadata": {},
-   "outputs": [],
-   "source": "# ── Burst training (recommended for Colab free tier) ─────────────────────────\n# Restarts from the global best each time early stopping fires.\n# Set BURST_MINUTES to slightly less than the Colab session limit (~70 min).\n\nBURST_MINUTES      = 70\nEPOCHS_PER_SEASON  = 30\nBURST_PATIENCE     = 8\n\nburst_train(\n    data_file=DATA_PATH,\n    output_file=OUTPUT_FILE,\n    duration_minutes=BURST_MINUTES,\n    epochs_per_season=EPOCHS_PER_SEASON,\n    early_stopping_patience=BURST_PATIENCE,\n    batch_size=BATCH_SIZE,\n    initial_checkpoint=CHECKPOINT,\n    use_versioning=True,\n    subsample_ratio=SUBSAMPLE_RATIO,\n    hidden_sizes=HIDDEN_SIZES,\n)",
-   "id": "burst-train"
-  },
-  {
-   "cell_type": "markdown",
-   "metadata": {},
-   "source": [
-    "---\n",
-    "## 📦 4 — Export\n",
-    "\n",
-    "Convert the best `.pt` checkpoint to the `.nbai` binary format read by `NbaiLoader` in Scala."
-   ],
-   "id": "export-md"
-  },
-  {
-   "cell_type": "code",
-   "execution_count": null,
-   "metadata": {},
-   "outputs": [],
-   "source": [
-    "from export import export_to_nbai\n",
-    "\n",
-    "NBAI_FILE = Path(DRIVE_ROOT) / 'nnue_weights.nbai'\n",
-    "\n",
-    "# Pick the latest versioned checkpoint\n",
-    "checkpoints = sorted(WEIGHTS_DIR.glob('nnue_weights_v*.pt'))\n",
-    "if not checkpoints:\n",
-    "    raise FileNotFoundError('No checkpoints found in ' + str(WEIGHTS_DIR))\n",
-    "\n",
-    "latest = checkpoints[-1]\n",
-    "print(f'Exporting {latest.name} → {NBAI_FILE.name}')\n",
-    "\n",
-    "export_to_nbai(\n",
-    "    weights_file=str(latest),\n",
-    "    output_file=str(NBAI_FILE),\n",
-    "    trained_by='colab',\n",
-    ")\n",
-    "print('Export complete.')"
-   ],
-   "id": "export-cell"
-  },
-  {
-   "cell_type": "markdown",
-   "metadata": {},
-   "source": [
-    "---\n",
-    "## ⬇️ 5 — Download\n",
-    "\n",
-    "Download the `.nbai` weights file and the latest `.pt` checkpoint to your local machine.\n",
-    "\n",
-    "Place `nnue_weights.nbai` in `modules/official-bots/src/main/resources/` and rebuild the native image."
-   ],
-   "id": "download-md"
-  },
-  {
-   "cell_type": "code",
-   "execution_count": null,
-   "metadata": {},
-   "outputs": [],
-   "source": [
-    "from google.colab import files\n",
-    "\n",
-    "if NBAI_FILE.exists():\n",
-    "    files.download(str(NBAI_FILE))\n",
-    "    print(f'Downloading {NBAI_FILE.name}')\n",
-    "else:\n",
-    "    print('No .nbai file found — run the Export cell first.')\n",
-    "\n",
-    "checkpoints = sorted(WEIGHTS_DIR.glob('nnue_weights_v*.pt'))\n",
-    "if checkpoints:\n",
-    "    latest = checkpoints[-1]\n",
-    "    files.download(str(latest))\n",
-    "    print(f'Downloading checkpoint {latest.name}')\n",
-    "else:\n",
-    "    print('No .pt checkpoint found.')"
-   ],
-   "id": "download-cell"
-  }
- ]
-}

modules/official-bots/python/build_dataset.py

@@ -1,281 +0,0 @@
-#!/usr/bin/env python3
-"""Build the ENTIRE NNUE training dataset with one command.
-
-Orchestrates the existing source modules (Lichess eval DB, self-play, tactical puzzles,
-random filler), labels what needs labeling with local Stockfish, deduplicates, balances
-the eval distribution, writes append-only compressed shards + a manifest, and pushes to
-Google Drive with rclone.
-
-    ./dataset.sh                 # build everything + push
-    ./dataset.sh --no-push       # build only
-    ./dataset.sh --no-lichess    # skip the (large) Lichess backbone
-
-Tune the CONFIG block below — that is the only thing you normally touch.
-"""
-
-import argparse
-import hashlib
-import json
-import os
-import random
-import subprocess
-import sys
-import urllib.request
-from datetime import datetime, timezone
-from pathlib import Path
-
-import zstandard as zstd
-
-HERE = Path(__file__).resolve().parent
-sys.path.insert(0, str(HERE / "src"))
-
-from generate import play_random_game_and_collect_positions
-from label import label_positions_with_stockfish
-from lichess_importer import import_lichess_evals
-from tactical_positions_extractor import download_and_extract_puzzle_db, extract_tactical_only
-
-# ── CONFIG — the only knobs you normally touch ───────────────────────────────
-LICHESS_POSITIONS = 2_000_000      # backbone positions from the Lichess eval DB
-USE_SELFPLAY      = True           # label data/selfplay.txt if present
-TACTICAL_PUZZLES  = 200_000        # tactical positions from the Lichess puzzle DB
-RANDOM_FILLER     = 100_000        # cheap random-play positions
-STOCKFISH_DEPTH   = 14             # local labeling depth (selfplay/tactical/random)
-RCLONE_REMOTE     = "gdrive:NowChess/datasets"
-# ─────────────────────────────────────────────────────────────────────────────
-
-LABEL_BATCH       = 64             # positions per Stockfish task (small = smooth progress + load balance)
-SHARD_SIZE        = 100_000        # positions per shard
-BALANCE_BINS      = 64             # eval histogram bins over [-1, 1]
-BALANCE_FACTOR    = 2.0            # cap each bin at FACTOR x the uniform bin size
-LICHESS_EVAL_URL  = "https://database.lichess.org/lichess_db_eval.jsonl.zst"
-
-STOCKFISH_PATH = os.environ.get("STOCKFISH_PATH", "/usr/games/stockfish")
-WORKERS        = os.cpu_count() or 4
-
-DATA_DIR     = HERE / "data"
-WORK_DIR     = HERE / "data" / "_build"
-DATASETS_DIR = HERE / "datasets"
-SHARDS_DIR   = DATASETS_DIR / "shards"
-MANIFEST     = DATASETS_DIR / "manifest.json"
-LICHESS_DB   = HERE / "trainingdata" / "lichess_db_eval.jsonl.zst"
-
-
-def label(fens_file: Path, out: Path) -> int:
-    """Label a FEN file with local Stockfish. Returns positions written."""
-    if not fens_file.exists():
-        return 0
-    label_positions_with_stockfish(
-        str(fens_file), str(out), STOCKFISH_PATH,
-        batch_size=LABEL_BATCH, depth=STOCKFISH_DEPTH, num_workers=WORKERS,
-    )
-    return count_lines(out)
-
-
-def count_lines(path: Path) -> int:
-    if not path.exists():
-        return 0
-    with open(path) as f:
-        return sum(1 for _ in f)
-
-
-def source_lichess(out: Path) -> int:
-    if not LICHESS_DB.exists():
-        print(f"Downloading Lichess eval DB → {LICHESS_DB} (large, one-time)...")
-        LICHESS_DB.parent.mkdir(parents=True, exist_ok=True)
-        urllib.request.urlretrieve(LICHESS_EVAL_URL, LICHESS_DB)
-    return import_lichess_evals(str(LICHESS_DB), str(out), max_positions=LICHESS_POSITIONS)
-
-
-def source_selfplay(out: Path) -> int:
-    return label(DATA_DIR / "selfplay.txt", out)
-
-
-def source_tactical(out: Path) -> int:
-    puzzle_csv = download_and_extract_puzzle_db(output_dir=str(HERE / "tactical_data"))
-    if puzzle_csv is None:
-        return 0
-    fens = WORK_DIR / "tactical_fens.txt"
-    extract_tactical_only(str(puzzle_csv), str(fens), max_puzzles=TACTICAL_PUZZLES)
-    return label(fens, out)
-
-
-def source_random(out: Path) -> int:
-    fens = WORK_DIR / "random_fens.txt"
-    play_random_game_and_collect_positions(
-        str(fens), total_positions=RANDOM_FILLER, num_workers=WORKERS,
-    )
-    return label(fens, out)
-
-
-def build_sources(args) -> dict[str, Path]:
-    """Run each enabled source into its own labeled jsonl. Returns {name: path}."""
-    WORK_DIR.mkdir(parents=True, exist_ok=True)
-    plan = [
-        ("lichess", args.lichess, source_lichess),
-        ("selfplay", args.selfplay, source_selfplay),
-        ("tactical", args.tactical, source_tactical),
-        ("random", args.random, source_random),
-    ]
-    outputs: dict[str, Path] = {}
-    for name, enabled, fn in plan:
-        if not enabled:
-            continue
-        out = WORK_DIR / f"{name}_labeled.jsonl"
-        out.unlink(missing_ok=True)
-        print(f"\n=== Source: {name} ===")
-        written = fn(out)
-        print(f"{name}: {written:,} labeled positions")
-        if written:
-            outputs[name] = out
-    return outputs
-
-
-def existing_fens() -> set[str]:
-    """FENs already present in the dataset, so growth stays deduplicated."""
-    seen: set[str] = set()
-    if not MANIFEST.exists():
-        return seen
-    manifest = json.loads(MANIFEST.read_text())
-    for shard in manifest.get("shards", []):
-        for rec in read_shard(SHARDS_DIR / shard["file"]):
-            seen.add(rec["fen"])
-    return seen
-
-
-def read_shard(path: Path):
-    dctx = zstd.ZstdDecompressor()
-    with open(path, "rb") as fh, dctx.stream_reader(fh) as reader:
-        for line in iter_text(reader):
-            yield json.loads(line)
-
-
-def iter_text(reader):
-    import io
-    yield from io.TextIOWrapper(reader, encoding="utf-8")
-
-
-def merge_dedup(outputs: dict[str, Path], skip: set[str]):
-    """Merge all source jsonl, drop dupes (within batch + vs existing dataset)."""
-    seen = set(skip)
-    records, per_source = [], {}
-    for name, path in outputs.items():
-        kept = 0
-        with open(path) as f:
-            for line in f:
-                rec = json.loads(line)
-                fen = rec["fen"]
-                if fen in seen:
-                    continue
-                seen.add(fen)
-                rec["source"] = name
-                records.append(rec)
-                kept += 1
-        per_source[name] = kept
-    return records, per_source
-
-
-def balance(records: list) -> list:
-    """Flatten the eval histogram: cap each bin at FACTOR x the uniform bin size."""
-    if not records:
-        return records
-    cap = max(1, int(BALANCE_FACTOR * len(records) / BALANCE_BINS))
-    bins: dict[int, int] = {}
-    kept = []
-    random.shuffle(records)
-    for rec in records:
-        b = min(BALANCE_BINS - 1, int((rec["eval"] + 1.0) / 2.0 * BALANCE_BINS))
-        if bins.get(b, 0) < cap:
-            bins[b] = bins.get(b, 0) + 1
-            kept.append(rec)
-    return kept
-
-
-def sha256(path: Path) -> str:
-    h = hashlib.sha256()
-    with open(path, "rb") as f:
-        for chunk in iter(lambda: f.read(1 << 20), b""):
-            h.update(chunk)
-    return h.hexdigest()
-
-
-def write_shards(records: list, build_id: str) -> list[dict]:
-    SHARDS_DIR.mkdir(parents=True, exist_ok=True)
-    cctx = zstd.ZstdCompressor(level=10)
-    entries = []
-    for i in range(0, len(records), SHARD_SIZE):
-        chunk = records[i : i + SHARD_SIZE]
-        name = f"{build_id}_{i // SHARD_SIZE:05d}.jsonl.zst"
-        path = SHARDS_DIR / name
-        with open(path, "wb") as fh, cctx.stream_writer(fh) as w:
-            for rec in chunk:
-                w.write((json.dumps(rec) + "\n").encode("utf-8"))
-        entries.append({"file": name, "positions": len(chunk),
-                        "sha256": sha256(path), "build_id": build_id})
-        print(f"  wrote {name} ({len(chunk):,} positions)")
-    return entries
-
-
-def update_manifest(new_shards: list[dict], build: dict) -> None:
-    manifest = json.loads(MANIFEST.read_text()) if MANIFEST.exists() else {
-        "dataset_version": 0, "scale": 300.0, "builds": [], "shards": [],
-    }
-    manifest["dataset_version"] += 1
-    manifest["created"] = build["created"]
-    manifest["builds"].append(build)
-    manifest["shards"].extend(new_shards)
-    manifest["total_positions"] = sum(s["positions"] for s in manifest["shards"])
-    MANIFEST.write_text(json.dumps(manifest, indent=2))
-    print(f"\nDataset version {manifest['dataset_version']}: "
-          f"{manifest['total_positions']:,} total positions across {len(manifest['shards'])} shards")
-
-
-def push() -> None:
-    if not subprocess.run(["which", "rclone"], capture_output=True).stdout:
-        print("rclone not found — skipping push.")
-        return
-    print(f"\nPushing {DATASETS_DIR} → {RCLONE_REMOTE} ...")
-    subprocess.run(["rclone", "copy", str(DATASETS_DIR), RCLONE_REMOTE, "--progress"], check=True)
-
-
-def parse_args():
-    p = argparse.ArgumentParser(description="Build the entire NNUE dataset.")
-    for name in ("lichess", "selfplay", "tactical", "random", "push"):
-        p.add_argument(f"--no-{name}", dest=name, action="store_false")
-    p.add_argument("--push-only", action="store_true", help="Push the existing dataset, build nothing.")
-    return p.parse_args()
-
-
-def main() -> None:
-    args = parse_args()
-    if args.push_only:
-        push()
-        return
-    build_id = datetime.now(timezone.utc).strftime("%Y%m%dT%H%M%SZ")
-
-    outputs = build_sources(args)
-    if not outputs:
-        print("No sources produced data — nothing to build.")
-        return
-
-    print("\n=== Merge / dedup / balance ===")
-    records, per_source = merge_dedup(outputs, existing_fens())
-    print(f"merged unique (new): {len(records):,}")
-    records = balance(records)
-    print(f"after balancing: {len(records):,}")
-
-    new_shards = write_shards(records, build_id)
-    update_manifest(new_shards, {
-        "build_id": build_id,
-        "created": datetime.now(timezone.utc).isoformat(),
-        "stockfish_depth": STOCKFISH_DEPTH,
-        "sources": per_source,
-        "kept_after_balance": len(records),
-    })
-
-    if args.push:
-        push()
-    print("\nDone.")
-
-
-if __name__ == "__main__":
-    main()

modules/official-bots/python/dataset.sh

@@ -1,17 +0,0 @@
-#!/usr/bin/env bash
-# Build the ENTIRE NNUE training dataset + push to Drive. One command.
-#
-#   ./dataset.sh                 # build everything + rclone push
-#   ./dataset.sh --no-push       # build only
-#   ./dataset.sh --no-lichess    # skip the large Lichess backbone
-set -euo pipefail
-
-SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
-cd "$SCRIPT_DIR"
-
-PY="python3"
-if [[ -x "$SCRIPT_DIR/.venv/bin/python" ]]; then
-  PY="$SCRIPT_DIR/.venv/bin/python"
-fi
-
-exec "$PY" build_dataset.py "$@"