chore: update SDKs, transport layer, and CI workflows

- SDK updates: cpp, csharp, go, java, js, python
- Transport layer: mux_conn improvements and tests
- CI: workflow updates
- Documentation: SDK guides and feature matrix
- Scripts: dashboard E2E guard updates

Author: cuihairu

.github/workflows/ci.yml

@@ -2,9 +2,9 @@ name: CI - Core
 
 on:
   push:
-    branches: [ main ]
+    branches: [main]
   pull_request:
-    branches: [ main ]
+    branches: [main]
 
 env:
   FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
@@ -20,7 +20,7 @@ jobs:
       - timeout-minutes: 5
         uses: actions/setup-go@v7
         with:
-          go-version-file: 'go.mod'
+          go-version-file: "go.mod"
       - name: Install ripgrep
         timeout-minutes: 2
         run: |
@@ -59,7 +59,7 @@ jobs:
         timeout-minutes: 5
         shell: bash
         env:
-          BUF_VERSION: '1.47.2'
+          BUF_VERSION: "1.47.2"
         run: |
           set -euo pipefail
           mkdir -p "$RUNNER_TEMP/bin"
@@ -106,7 +106,7 @@ jobs:
       - timeout-minutes: 5
         uses: actions/setup-go@v7
         with:
-          go-version-file: 'go.mod'
+          go-version-file: "go.mod"
       - name: Normalize Go toolchain env
         timeout-minutes: 2
         shell: bash
@@ -146,7 +146,7 @@ jobs:
       - timeout-minutes: 5
         uses: actions/setup-go@v7
         with:
-          go-version-file: 'go.mod'
+          go-version-file: "go.mod"
       - name: Normalize Go toolchain env
         timeout-minutes: 2
         shell: bash
@@ -207,7 +207,7 @@ jobs:
       - timeout-minutes: 5
         uses: actions/setup-go@v7
         with:
-          go-version-file: 'go.mod'
+          go-version-file: "go.mod"
       - name: Normalize Go toolchain env
         timeout-minutes: 2
         shell: bash
@@ -225,6 +225,7 @@ jobs:
       - name: Start Server (SQLite, no external DB)
         timeout-minutes: 15
         run: |
+          set -euo pipefail
           go build -o bin/croupier-server ./cmd/server
           # Build the agent registration probe so happy-path.sh can exercise
           # the Agent→Server TCP handshake (Register + Heartbeat). Without it,
@@ -233,17 +234,23 @@ jobs:
           # Function-seed helper: inserts the function metadata row that the
           # task-lifecycle E2E's POST /tasks requires (no create API exists).
           go build -o bin/e2e-function-seed ./examples/cmd/e2e-function-seed
-          # Fresh DB every run: a stale test-data/croupier.db with an older
-          # schema makes AutoMigrate fail (sqlite cannot ALTER ADD a NOT NULL
-          # column). Remove any leftover state before booting.
-          rm -rf data test-data
-          mkdir -p data/uploads test-data
+          # Each run owns an isolated directory under RUNNER_TEMP. Never
+          # delete repository data/ or test-data/: CI may run in a worktree
+          # containing useful local SQLite fixtures.
+          E2E_DIR="$RUNNER_TEMP/croupier-e2e-${{ github.run_id }}-${{ github.run_attempt }}"
+          mkdir -p "$E2E_DIR/uploads"
+          echo "E2E_DIR=$E2E_DIR" >> "$GITHUB_ENV"
+          echo "E2E_DSN=$E2E_DIR/croupier.db" >> "$GITHUB_ENV"
           # Use the SQLite test config so the server boots without a database
           # service. Admin/games are seeded from configs/*.json. Redirect
           # output to a log file so failures (panic/migrate errors) are
           # visible in the failed step instead of being lost to the background.
-          : > server.log
-          ./bin/croupier-server --config configs/test-sqlite.yaml >> server.log 2>&1 &
+          : > "$E2E_DIR/server.log"
+          DB_DRIVER=sqlite \
+          DATABASE_URL="$E2E_DIR/croupier.db" \
+          STORAGE_DRIVER=file \
+          STORAGE_BASE_DIR="$E2E_DIR/uploads" \
+          ./bin/croupier-server --config configs/test-sqlite.yaml >> "$E2E_DIR/server.log" 2>&1 &
           SERVER_PID=$!
           echo "SERVER_PID=$SERVER_PID" >> $GITHUB_ENV
           # Wait for server REST to be ready (deterministic readiness probe).
@@ -263,14 +270,14 @@ jobs:
           done
           if [ "$ready" -ne 1 ]; then
             echo "::error::server did not become ready within 60s; server log:"
-            cat server.log
+            cat "$E2E_DIR/server.log"
             exit 1
           fi
       - name: Run E2E tests
         timeout-minutes: 10
         env:
           SERVER_URL: http://localhost:18780
-          DSN: test-data/croupier.db
+          DSN: ${{ env.E2E_DSN }}
         run: |
           bash scripts/e2e/happy-path.sh
           bash scripts/e2e/task-lifecycle.sh
@@ -279,6 +286,5 @@ jobs:
         if: always()
         run: |
           if [ -n "${SERVER_PID:-}" ]; then
-            kill $SERVER_PID 2>/dev/null || true
+            kill "$SERVER_PID" 2>/dev/null || true
           fi
-

cmd/server/root.go

@@ -446,6 +446,7 @@ func applyRuntimeDefaults(c *config.Config) {
 
 	// ✅ Auto-adjust timeout based on SSE configuration to prevent premature disconnection
 	validateAndAdjustTimeout(c)
+	applyStorageEnvironmentOverrides(c)
 
 	if strings.EqualFold(strings.TrimSpace(c.Storage.Driver), "file") {
 		if strings.TrimSpace(c.Storage.BaseDir) == "" {
@@ -454,6 +455,21 @@ func applyRuntimeDefaults(c *config.Config) {
 	}
 }
 
+// applyStorageEnvironmentOverrides makes file storage relocatable in CI and
+// ephemeral deployments. Database overrides are resolved in svc; storage must
+// be applied here before ServiceContext initializes the object store.
+func applyStorageEnvironmentOverrides(c *config.Config) {
+	if c == nil {
+		return
+	}
+	if driver := strings.TrimSpace(os.Getenv("STORAGE_DRIVER")); driver != "" {
+		c.Storage.Driver = driver
+	}
+	if baseDir := strings.TrimSpace(os.Getenv("STORAGE_BASE_DIR")); baseDir != "" {
+		c.Storage.BaseDir = baseDir
+	}
+}
+
 func wrapHTTPHandler(svcCtx *svc.ServiceContext, handler http.Handler) http.Handler {
 	if svcCtx == nil || svcCtx.Telemetry == nil {
 		return handler

cmd/server/server_test.go

@@ -181,6 +181,17 @@ func TestApplyRuntimeDefaults_NonFileStorage(t *testing.T) {
 	assert.Equal(t, "", c.Storage.BaseDir)
 }
 
+func TestApplyRuntimeDefaults_StorageEnvironmentOverrides(t *testing.T) {
+	t.Setenv("STORAGE_DRIVER", "file")
+	t.Setenv("STORAGE_BASE_DIR", "/tmp/croupier-e2e/uploads")
+	c := &config.Config{Storage: config.StorageConfig{Driver: "s3", BaseDir: "bucket-prefix"}}
+
+	applyRuntimeDefaults(c)
+
+	assert.Equal(t, "file", c.Storage.Driver)
+	assert.Equal(t, "/tmp/croupier-e2e/uploads", c.Storage.BaseDir)
+}
+
 // ---------------------------------------------------------------------------
 // PrintVersionInfo
 // ---------------------------------------------------------------------------

docs/sdks/cpp/guide/quick-start.md

@@ -7,7 +7,7 @@ int main() {
     croupier::sdk::ClientConfig config;
     config.game_id = "my-game";
     config.env = "development";
-    config.agent_addr = "127.0.0.1:19090";
+    config.agent_addr = "127.0.0.1:19091";
 
     croupier::sdk::CroupierClient client(config);
     client.Connect();

docs/sdks/csharp/guide/quick-start.md

@@ -11,7 +11,7 @@
 using Croupier.Sdk;
 
 var client = new CroupierClient(new ClientConfig {
-    AgentAddr = "127.0.0.1:19090",
+    AgentAddr = "127.0.0.1:19091",
     ServiceId = "my-service",
     GameId = "my-game",
     Env = "dev"

docs/sdks/csharp/index.md

@@ -28,7 +28,7 @@ dotnet add package Croupier.Sdk
 using Croupier.Sdk;
 
 var client = new CroupierClient(new ClientConfig {
-    AgentAddr = "127.0.0.1:19090",
+    AgentAddr = "127.0.0.1:19091",
     ServiceId = "my-service",
     GameId = "my-game"
 });

docs/sdks/go/guide/integration.md

@@ -18,7 +18,7 @@ import (
 
 func main() {
     client := croupier.NewClient(&croupier.ClientConfig{
-        AgentAddr: "localhost:19090",
+        AgentAddr: "localhost:19091",
         GameID:    "demo-game",
         Env:       "development",
         Insecure:  true,

docs/sdks/go/index.md

@@ -31,7 +31,7 @@ import "github.com/cuihairu/croupier/sdks/go/pkg/croupier"
 
 func main() {
 	cfg := &croupier.ClientConfig{
-		AgentAddr: "127.0.0.1:19090",
+        AgentAddr: "127.0.0.1:19091",
 		GameID:    "my-game",
 		Env:       "development",
 	}

docs/sdks/js/guide/integration.md

@@ -17,7 +17,7 @@ import {
 
 async function main() {
   const config: ClientConfig = {
-    agentAddr: "127.0.0.1:19090",
+    agentAddr: "127.0.0.1:19091",
     serviceId: "my-service",
   };
 

docs/sdks/js/index.md

@@ -29,7 +29,7 @@ npm install @croupier/sdk
 import { CroupierClient } from "@croupier/sdk";
 
 const client = new CroupierClient({
-  agentAddr: "127.0.0.1:19090",
+  agentAddr: "127.0.0.1:19091",
   gameId: "my-game",
   env: "development",
   insecure: true,