Build/CI/Docker: add GHCR publish workflow; update README with GHCR usage; add MIT LICENSE; standardize Java 25; keep personal docs uncommitted; add devcontainer and Dockerfile; enable CI and Release workflows

Author: dctabansi

.devcontainer/devcontainer.json

@@ -0,0 +1,24 @@
+{
+  "name": "TerminalChess Dev (Java 25)",
+  "image": "mcr.microsoft.com/devcontainers/base:ubuntu",
+  "features": {
+    "ghcr.io/devcontainers/features/java:1": {
+      "version": "25",
+      "jdkDistro": "temurin"
+    }
+  },
+  "postCreateCommand": "bash -lc 'chmod +x ./gradlew 2>/dev/null || true; ./gradlew --version || true'",
+  "customizations": {
+    "vscode": {
+      "settings": {
+        "java.configuration.runtimes": [
+          { "name": "JavaSE-25", "path": "/usr/lib/jvm/temurin-25-jdk" }
+        ]
+      },
+      "extensions": [
+        "vscjava.vscode-java-pack",
+        "fwcd.kotlin"
+      ]
+    }
+  }
+}

.dockerignore

@@ -0,0 +1,10 @@
+.git
+.gitignore
+.gradle
+build
+out
+.idea
+*.iml
+.DS_Store
+Thumbs.db
+*.log

.github/workflows/ci.yml

@@ -0,0 +1,65 @@
+name: CI
+
+on:
+  push:
+    branches: [ main, master ]
+  pull_request:
+    branches: [ main, master ]
+
+jobs:
+  build:
+    name: Build (JDK 25 on ${{ matrix.os }})
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ windows-latest, ubuntu-latest, macos-latest ]
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set up Temurin JDK 25
+        uses: actions/setup-java@v4
+        with:
+          distribution: 'temurin'
+          java-version: '25'
+
+      # Use wrapper if present; otherwise fall back to provisioned Gradle 9.2.1
+      - name: Make gradlew executable (non-Windows)
+        if: hashFiles('gradlew') != '' && runner.os != 'Windows'
+        run: chmod +x ./gradlew
+
+      - name: Build with Gradle Wrapper (Unix)
+        if: hashFiles('gradlew') != '' && runner.os != 'Windows'
+        run: |
+          ./gradlew --version
+          ./gradlew build --no-daemon
+          ./gradlew shadowJar --no-daemon
+
+      - name: Build with Gradle Wrapper (Windows)
+        if: hashFiles('gradlew.bat') != '' && runner.os == 'Windows'
+        run: |
+          ./gradlew.bat --version
+          ./gradlew.bat build --no-daemon
+          ./gradlew.bat shadowJar --no-daemon
+
+      - name: Set up Gradle 9.2.1 (fallback when no wrapper)
+        if: hashFiles('gradlew') == '' && hashFiles('gradlew.bat') == ''
+        uses: gradle/actions/setup-gradle@v4
+        with:
+          gradle-version: '9.2.1'
+
+      - name: Build with Gradle CLI (fallback)
+        if: hashFiles('gradlew') == '' && hashFiles('gradlew.bat') == ''
+        run: |
+          gradle --version
+          gradle build --no-daemon
+          gradle shadowJar --no-daemon
+
+      - name: Upload runnable JAR
+        uses: actions/upload-artifact@v4
+        with:
+          name: terminalchess-${{ matrix.os }}-jdk25
+          path: |
+            build/libs/*all.jar

.github/workflows/docker-release.yml

@@ -0,0 +1,33 @@
+name: Docker Release (GHCR)
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+permissions:
+  contents: read
+  packages: write
+
+jobs:
+  push-image:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Log in to GHCR
+        uses: docker/login-action@v3
+        with:
+          registry: ghcr.io
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Build and push image
+        uses: docker/build-push-action@v6
+        with:
+          context: .
+          push: true
+          tags: |
+            ghcr.io/${{ github.repository_owner }}/terminalchess:latest
+            ghcr.io/${{ github.repository_owner }}/terminalchess:${{ github.ref_name }}

.github/workflows/release.yml

@@ -0,0 +1,41 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+permissions:
+  contents: write
+
+jobs:
+  build-and-release:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set up Temurin JDK 25
+        uses: actions/setup-java@v4
+        with:
+          distribution: 'temurin'
+          java-version: '25'
+
+      - name: Make gradlew executable
+        run: chmod +x ./gradlew
+
+      - name: Build fat JAR
+        run: |
+          ./gradlew --version
+          ./gradlew clean shadowJar --no-daemon
+
+      - name: Create GitHub Release
+        id: create_release
+        uses: softprops/action-gh-release@v2
+        with:
+          draft: false
+          prerelease: false
+          files: |
+            build/libs/*all.jar
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.gitignore

@@ -1,29 +1,21 @@
-### IntelliJ IDEA ###
-out/
-!**/src/main/**/out/
-!**/src/test/**/out/
+# Gradle
+.gradle/
+build/
 
-### Eclipse ###
-.apt_generated
-.classpath
-.factorypath
-.project
-.settings
-.springBeans
-.sts4-cache
-bin/
-!**/src/main/**/bin/
-!**/src/test/**/bin/
+# IntelliJ / IDEA
+# Keep project files, but ignore volatile ones if added
+.idea/workspace.xml
+.idea/tasks.xml
+.idea/usage.statistics.xml
+.idea/dictionaries/
+.idea/AndroidProjectSystem.xml
 
-### NetBeans ###
-/nbproject/private/
-/nbbuild/
-/dist/
-/nbdist/
-/.nb-gradle/
+# Kotlin/Java outputs
+out/
 
-### VS Code ###
-.vscode/
+# OS
+.DS_Store
+Thumbs.db
 
-### Mac OS ###
-.DS_Store
+# Logs
+*.log