haruki-sekai-deck-recommend-cpp 0.3.2__tar.gz → 0.3.5__tar.gz

{haruki_sekai_deck_recommend_cpp-0.3.2 → haruki_sekai_deck_recommend_cpp-0.3.5}/.github/copilot-instructions.md

@@ -27,6 +27,11 @@ recommendation and live calculation. The same engineering rules also live in
 - Do not rewrite scoring, event bonus, support deck, or skill order logic unless
   the task explicitly requires it.
 - Avoid changing static data in `data/` unless the task is about static data.
+  `data/rl_seed_cache.tsv` is a runtime-generated RL warm-start cache
+  (written when `DECK_DATA_DIR` or `DECK_RL_SEED_CACHE_FILE` is set). Only the
+  default `data/rl_seed_cache.tsv` path is gitignored; add any custom
+  in-repository cache path to `.gitignore`, and never commit generated cache
+  files.
 - Prefer clear validation errors for malformed options and missing userdata.
 
 ## Important Paths

{haruki_sekai_deck_recommend_cpp-0.3.2 → haruki_sekai_deck_recommend_cpp-0.3.5}/.github/workflows/build-npm.yml

@@ -15,13 +15,14 @@ jobs:
 
     steps:
       - name: Checkout source
-        uses: actions/checkout@v6.0.2
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
         with:
           ref: ${{ inputs.source_ref || github.ref }}
           submodules: recursive
+          persist-credentials: false
 
       - name: Set up Node.js
-        uses: actions/setup-node@v6.4.0
+        uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6.4.0
         with:
           node-version: "22"
           registry-url: "https://registry.npmjs.org"
@@ -46,7 +47,7 @@ jobs:
         working-directory: npm/haruki-sekai-deck-recommend-cpp
 
       - name: Upload npm package
-        uses: actions/upload-artifact@v7.0.1
+        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
         with:
           name: npm-package
           path: npm/haruki-sekai-deck-recommend-cpp/haruki-sekai-deck-recommend-cpp-*.tgz

{haruki_sekai_deck_recommend_cpp-0.3.2 → haruki_sekai_deck_recommend_cpp-0.3.5}/.github/workflows/build-sdist.yml

@@ -10,29 +10,30 @@ jobs:
 
     steps:
       - name: Checkout repository
-        uses: actions/checkout@v6.0.2
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
         with:
           submodules: recursive
+          persist-credentials: false
 
       - name: Set up Python
-        uses: actions/setup-python@v6.2.0
+        uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405 # v6.2.0
         with:
           python-version: "3.11"
 
       - name: Set up uv
-        uses: astral-sh/setup-uv@v8.1.0
+        uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
         with:
           version: "0.9.18"
           enable-cache: true
 
       - name: Install build package
-        run: uv pip install --system build
+        run: "uv pip install --system --only-binary :all: build==1.6.0"
 
       - name: Build sdist
         run: python -m build --sdist
 
       - name: Upload sdist artifact
-        uses: actions/upload-artifact@v7.0.1
+        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
         with:
           name: pypi-sdist
           path: dist/*.tar.gz

{haruki_sekai_deck_recommend_cpp-0.3.2 → haruki_sekai_deck_recommend_cpp-0.3.5}/.github/workflows/build-wheels.yml

@@ -13,23 +13,24 @@ jobs:
 
     steps:
       - name: Checkout source
-        uses: actions/checkout@v6.0.2
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
         with:
           submodules: recursive
+          persist-credentials: false
 
       - name: Set up Python
-        uses: actions/setup-python@v6.2.0
+        uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405 # v6.2.0
         with:
           python-version: "3.11"
 
       - name: Set up uv
-        uses: astral-sh/setup-uv@v8.1.0
+        uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
         with:
           version: "0.9.18"
           enable-cache: true
 
       - name: Install cibuildwheel
-        run: uv pip install --system cibuildwheel
+        run: "uv pip install --system --only-binary :all: cibuildwheel==4.2.0"
 
       - name: Build wheels
         run: python -m cibuildwheel --output-dir wheelhouse
@@ -40,7 +41,7 @@ jobs:
           CIBW_BUILD_VERBOSITY: "1"
 
       - name: Upload wheels
-        uses: actions/upload-artifact@v7.0.1
+        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
         with:
           name: pypi-wheels-linux-x64-many
           path: wheelhouse/*.whl
@@ -55,23 +56,24 @@ jobs:
 
     steps:
       - name: Checkout source
-        uses: actions/checkout@v6.0.2
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
         with:
           submodules: recursive
+          persist-credentials: false
 
       - name: Set up Python
-        uses: actions/setup-python@v6.2.0
+        uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405 # v6.2.0
         with:
           python-version: "3.11"
 
       - name: Set up uv
-        uses: astral-sh/setup-uv@v8.1.0
+        uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
         with:
           version: "0.9.18"
           enable-cache: true
 
       - name: Install cibuildwheel
-        run: uv pip install --system cibuildwheel
+        run: "uv pip install --system --only-binary :all: cibuildwheel==4.2.0"
 
       - name: Build wheels
         run: python -m cibuildwheel --output-dir wheelhouse
@@ -82,7 +84,7 @@ jobs:
           CIBW_BUILD_VERBOSITY: "1"
 
       - name: Upload wheels
-        uses: actions/upload-artifact@v7.0.1
+        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
         with:
           name: pypi-wheels-linux-x64-musl
           path: wheelhouse/*.whl
@@ -96,23 +98,24 @@ jobs:
 
     steps:
       - name: Checkout source
-        uses: actions/checkout@v6.0.2
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
         with:
           submodules: recursive
+          persist-credentials: false
 
       - name: Set up Python
-        uses: actions/setup-python@v6.2.0
+        uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405 # v6.2.0
         with:
           python-version: "3.11"
 
       - name: Set up uv
-        uses: astral-sh/setup-uv@v8.1.0
+        uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
         with:
           version: "0.9.18"
           enable-cache: true
 
       - name: Install cibuildwheel
-        run: uv pip install --system cibuildwheel
+        run: "uv pip install --system --only-binary :all: cibuildwheel==4.2.0"
 
       - name: Build wheels
         run: python -m cibuildwheel --output-dir wheelhouse
@@ -123,7 +126,7 @@ jobs:
           CIBW_BUILD_VERBOSITY: "1"
 
       - name: Upload wheels
-        uses: actions/upload-artifact@v7.0.1
+        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
         with:
           name: pypi-wheels-linux-arm64-many
           path: wheelhouse/*.whl
@@ -138,23 +141,24 @@ jobs:
 
     steps:
       - name: Checkout source
-        uses: actions/checkout@v6.0.2
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
         with:
           submodules: recursive
+          persist-credentials: false
 
       - name: Set up Python
-        uses: actions/setup-python@v6.2.0
+        uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405 # v6.2.0
         with:
           python-version: "3.11"
 
       - name: Set up uv
-        uses: astral-sh/setup-uv@v8.1.0
+        uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
         with:
           version: "0.9.18"
           enable-cache: true
 
       - name: Install cibuildwheel
-        run: uv pip install --system cibuildwheel
+        run: "uv pip install --system --only-binary :all: cibuildwheel==4.2.0"
 
       - name: Build wheels
         run: python -m cibuildwheel --output-dir wheelhouse
@@ -165,7 +169,7 @@ jobs:
           CIBW_BUILD_VERBOSITY: "1"
 
       - name: Upload wheels
-        uses: actions/upload-artifact@v7.0.1
+        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
         with:
           name: pypi-wheels-linux-arm64-musl
           path: wheelhouse/*.whl
@@ -179,23 +183,24 @@ jobs:
 
     steps:
       - name: Checkout source
-        uses: actions/checkout@v6.0.2
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
         with:
           submodules: recursive
+          persist-credentials: false
 
       - name: Set up Python
-        uses: actions/setup-python@v6.2.0
+        uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405 # v6.2.0
         with:
           python-version: "3.11"
 
       - name: Set up uv
-        uses: astral-sh/setup-uv@v8.1.0
+        uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
         with:
           version: "0.9.18"
           enable-cache: true
 
       - name: Install cibuildwheel
-        run: uv pip install --system cibuildwheel
+        run: "uv pip install --system --only-binary :all: cibuildwheel==4.2.0"
 
       - name: Build wheels
         run: python -m cibuildwheel --output-dir wheelhouse
@@ -210,7 +215,7 @@ jobs:
           CIBW_BUILD_VERBOSITY: "1"
 
       - name: Upload wheels
-        uses: actions/upload-artifact@v7.0.1
+        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
         with:
           name: pypi-wheels-windows-x64
           path: wheelhouse/*.whl
@@ -224,23 +229,24 @@ jobs:
 
     steps:
       - name: Checkout source
-        uses: actions/checkout@v6.0.2
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
         with:
           submodules: recursive
+          persist-credentials: false
 
       - name: Set up Python
-        uses: actions/setup-python@v6.2.0
+        uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405 # v6.2.0
         with:
           python-version: "3.11"
 
       - name: Set up uv
-        uses: astral-sh/setup-uv@v8.1.0
+        uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
         with:
           version: "0.9.18"
           enable-cache: true
 
       - name: Install cibuildwheel
-        run: uv pip install --system cibuildwheel
+        run: "uv pip install --system --only-binary :all: cibuildwheel==4.2.0"
 
       - name: Build wheels
         run: python -m cibuildwheel --output-dir wheelhouse
@@ -251,7 +257,7 @@ jobs:
           CIBW_BUILD_VERBOSITY: "1"
 
       - name: Upload wheels
-        uses: actions/upload-artifact@v7.0.1
+        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
         with:
           name: pypi-wheels-macos-arm64
           path: wheelhouse/*.whl

{haruki_sekai_deck_recommend_cpp-0.3.2 → haruki_sekai_deck_recommend_cpp-0.3.5}/.github/workflows/release.yml

@@ -48,13 +48,13 @@ jobs:
 
     steps:
       - name: Download release artifacts
-        uses: actions/download-artifact@v8.0.1
+        uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
         with:
           path: dist
           merge-multiple: true
 
       - name: Create GitHub Release
-        uses: softprops/action-gh-release@v3.0.0
+        uses: softprops/action-gh-release@b4309332981a82ec1c5618f44dd2e27cc8bfbfda # v3.0.0
         with:
           files: dist/*
           generate_release_notes: true
@@ -78,14 +78,14 @@ jobs:
 
     steps:
       - name: Download PyPI artifacts
-        uses: actions/download-artifact@v8.0.1
+        uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
         with:
           path: dist
           pattern: pypi-*
           merge-multiple: true
 
       - name: Publish to PyPI
-        uses: pypa/gh-action-pypi-publish@v1.14.0
+        uses: pypa/gh-action-pypi-publish@cef221092ed1bacb1cc03d23a2d87d1d172e277b # v1.14.0
         with:
           packages-dir: dist/
 
@@ -104,16 +104,16 @@ jobs:
 
     steps:
       - name: Set up Node.js
-        uses: actions/setup-node@v6.4.0
+        uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6.4.0
         with:
           node-version: "24"
           registry-url: "https://registry.npmjs.org"
 
       - name: Update npm
-        run: npm install -g npm@latest
+        run: npm install -g --ignore-scripts npm@12.0.2
 
       - name: Download npm package
-        uses: actions/download-artifact@v8.0.1
+        uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
         with:
           name: npm-package
           path: dist

haruki_sekai_deck_recommend_cpp-0.3.5/.github/workflows/sonar.yml

@@ -0,0 +1,71 @@
+name: SonarQube
+
+on:
+  push:
+    branches: [master]
+  pull_request:
+    branches: [master]
+    types: [opened, synchronize, reopened]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  analyze:
+    name: Analyze
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout source
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
+        with:
+          fetch-depth: 0
+          submodules: recursive
+          persist-credentials: false
+
+      - name: Set up Python
+        uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405 # v6.2.0
+        with:
+          python-version: "3.11"
+
+      - name: Install coverage tools
+        run: "python -m pip install --only-binary :all: coverage==7.15.3 gcovr==8.6"
+
+      - name: Build instrumented native module
+        run: |
+          cmake -S . -B build-sonar \
+            -DCMAKE_BUILD_TYPE=Debug \
+            -DSEKAI_ENABLE_COVERAGE=ON
+          cmake --build build-sonar --parallel 2
+
+      - name: Run tests and collect coverage
+        env:
+          SEKAI_BINDING_DIR: ${{ github.workspace }}/build-sonar
+        run: |
+          mkdir -p coverage-reports
+          python -m coverage run --source=tools/bench \
+            -m unittest discover -s tests -p 'test_bench_tools.py'
+          python -m coverage xml -o coverage-reports/python-coverage.xml
+          python -m unittest discover -s tests -p 'test_binding_smoke.py'
+          gcovr --root . --filter 'src/' \
+            --exclude 'src/sekai_deck_recommend_wasm.cpp' \
+            --lcov coverage-reports/lcov.info \
+            --sonarqube-metric line \
+            --sonarqube coverage-reports/cpp-coverage.xml \
+            --print-summary build-sonar
+
+      - name: Upload coverage reports
+        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
+        with:
+          name: coverage-reports
+          path: coverage-reports
+          if-no-files-found: error
+
+      - name: SonarQube scan
+        uses: SonarSource/sonarqube-scan-action@7006c4492b2e0ee0f816d36501671557c97f5995 # v8.1.0
+        env:
+          SONAR_TOKEN: ${{ secrets.SONAR_TOKEN }}

{haruki_sekai_deck_recommend_cpp-0.3.2 → haruki_sekai_deck_recommend_cpp-0.3.5}/.gitignore

@@ -1,5 +1,8 @@
 build/
+build-sonar/
 build_wasm/
+coverage-reports/
+.coverage
 sandbox/
 .vscode/
 npm/haruki-sekai-deck-recommend-cpp/sekai_deck_recommend.js
@@ -9,6 +12,7 @@ __pycache__/
 .idea/
 collections.suite.json
 suite.json
+data/rl_seed_cache.tsv
 uv.lock
 haruki-sekai-master/
 haruki-sekai-sc-master/

{haruki_sekai_deck_recommend_cpp-0.3.2 → haruki_sekai_deck_recommend_cpp-0.3.5}/AGENTS.md

@@ -24,10 +24,11 @@ change live automation behavior downstream.
 
 - `src/`: core C++ engine sources.
 - `src/deck-recommend/`: event, challenge live, MySekai, and base deck
-  recommendation logic.
+  recommendation logic; result ordering for emitted detail fields.
 - `src/deck-information/`: fixed deck lookup and deck power aggregation.
 - `src/card-information/`: card detail, power, skill, and image state logic.
-- `src/live-score/`: live score and skill order calculations.
+- `src/live-score/`: live score, skill ordering, multi-live active bonus,
+  and fixed-live timing calculations.
 - `src/event-point/`: event point and event bonus calculations.
 - `src/data-provider/`: static data, masterdata, music metas, and userdata
   loading.
@@ -38,10 +39,17 @@ change live automation behavior downstream.
 - `3rdparty/yyjson/`: vendored yyjson dependency for masterdata, music metas,
   userdata parsing, and wasm JSON-in / JSON-out binding payloads.
 - `sekai_deck_recommend.cpp` and `.pyi`: Python binding surface.
-- `data/`: static data required by the engine.
+- `data/`: static data required by the engine. `data/rl_seed_cache.tsv` is a
+  runtime-generated RL warm-start cache (written when `DECK_DATA_DIR` or
+  `DECK_RL_SEED_CACHE_FILE` is set). Only the default
+  `data/rl_seed_cache.tsv` path is gitignored; add any custom in-repository
+  cache path to `.gitignore`, and never commit generated cache files.
 
 ## Build And Test
 
+Prerequisites: CMake ≥ 3.15, C++20 compiler (GCC/Clang/MSVC), Python 3.10+
+with development headers.
+
 Common local checks:
 
 ```bash
@@ -139,10 +147,14 @@ and keep their schemas identical.
 
 ## High-Risk Areas
 
+These spots have produced production-visible regressions in the past — read
+the surrounding code before changing them, and prefer adding tests or running
+the deck-service integration build:
+
 - `src/live-score/live-calculator.cpp`: skill ordering, multi-live active bonus,
   and fixed live score timing.
-- `src/deck-recommend/base-deck-recommend.h`: card filtering and shared deck
-  recommendation config.
+- `src/deck-recommend/base-deck-recommend.{h,cpp}`: card filtering and the
+  shared deck recommendation config used by every recommender.
 - `src/deck-recommend/deck-result-update.*`: result ordering and emitted detail
   fields consumed by deck-service.
 - `src/data-provider/user-data.cpp` and `src/user-data/*`: downstream runtime
@@ -205,8 +217,9 @@ Rules:
 
 Suggested values per agent:
 
-- Claude (any 4.x): `Co-authored-by: Claude Opus 4.7 <noreply@anthropic.com>`
-  (substitute the actual model, e.g. `Claude Sonnet 4.6`)
+- Claude: `Co-authored-by: Claude <Model> <noreply@anthropic.com>` with the
+  actual model name (e.g. `Claude Fable 5`, `Claude Opus 4.7`,
+  `Claude Haiku 4.5`)
 - Codex: `Co-authored-by: Codex <noreply@openai.com>`
 - Copilot: `Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>`
 

{haruki_sekai_deck_recommend_cpp-0.3.2 → haruki_sekai_deck_recommend_cpp-0.3.5}/CLAUDE.md

@@ -45,7 +45,11 @@ live automation behavior downstream.
   userdata parsing, and wasm JSON-in / JSON-out binding payloads.
 - `sekai_deck_recommend.cpp` / `.pyi`: Python binding surface.
 - `data/`: static data required by the engine. Do not change unless the task
-  is explicitly about static data.
+  is explicitly about static data. `data/rl_seed_cache.tsv` is a
+  runtime-generated RL warm-start cache (written when `DECK_DATA_DIR` or
+  `DECK_RL_SEED_CACHE_FILE` is set). Only the default
+  `data/rl_seed_cache.tsv` path is gitignored; add any custom in-repository
+  cache path to `.gitignore`, and never commit generated cache files.
 
 ## Build & Run
 
@@ -208,8 +212,9 @@ Rules:
 
 Suggested values per agent:
 
-- Claude (any 4.x): `Co-authored-by: Claude Opus 4.7 <noreply@anthropic.com>`
-  (substitute the actual model, e.g. `Claude Sonnet 4.6`, `Claude Haiku 4.5`)
+- Claude: `Co-authored-by: Claude <Model> <noreply@anthropic.com>` with the
+  actual model name (e.g. `Claude Fable 5`, `Claude Opus 4.7`,
+  `Claude Haiku 4.5`)
 - Codex: `Co-authored-by: Codex <noreply@openai.com>`
 - Copilot: `Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>`
 
@@ -227,5 +232,5 @@ Agent-authored commit example:
 ```text
 [Docs] Add agent commit guidelines
 
-Co-authored-by: Claude Opus 4.7 <noreply@anthropic.com>
+Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
 ```

{haruki_sekai_deck_recommend_cpp-0.3.2 → haruki_sekai_deck_recommend_cpp-0.3.5}/CMakeLists.txt

@@ -1,6 +1,6 @@
 cmake_minimum_required(VERSION 3.15)
 
-project(sekai-deck-recommend-cpp VERSION 0.3.2 LANGUAGES C CXX)
+project(sekai-deck-recommend-cpp VERSION 0.3.5 LANGUAGES C CXX)
 
 set(CMAKE_CXX_STANDARD 20)
 set(CMAKE_CXX_STANDARD_REQUIRED ON)
@@ -22,6 +22,7 @@ list(REMOVE_ITEM SRC_FILES
 # 浏览器端引擎内并行（需要站点开启COOP/COEP以获得SharedArrayBuffer）；
 # 默认OFF，产物与历史一致
 option(SEKAI_WASM_THREADS "Build wasm with pthreads for in-engine parallelism" OFF)
+option(SEKAI_ENABLE_COVERAGE "Instrument the native Python module for coverage" OFF)
 
 if (EMSCRIPTEN)
     add_executable(sekai_deck_recommend
@@ -69,6 +70,15 @@ else()
         "${PROJECT_SOURCE_DIR}/src/sekai_deck_recommend.cpp"
     )
 
+    if (SEKAI_ENABLE_COVERAGE)
+        if (CMAKE_CXX_COMPILER_ID MATCHES "GNU|Clang")
+            target_compile_options(sekai_deck_recommend PRIVATE --coverage -O0 -g)
+            target_link_options(sekai_deck_recommend PRIVATE --coverage)
+        else()
+            message(FATAL_ERROR "SEKAI_ENABLE_COVERAGE requires GCC or Clang")
+        endif()
+    endif()
+
     if (MSVC)
         target_compile_options(sekai_deck_recommend PRIVATE
             /W4

{haruki_sekai_deck_recommend_cpp-0.3.2 → haruki_sekai_deck_recommend_cpp-0.3.5}/PKG-INFO

@@ -1,4 +1,5 @@
 Metadata-Version: 2.2
 Name: haruki-sekai-deck-recommend-cpp
-Version: 0.3.2
+Version: 0.3.5
+Requires-Python: >=3.10
 

{haruki_sekai_deck_recommend_cpp-0.3.2 → haruki_sekai_deck_recommend_cpp-0.3.5}/README.md

@@ -142,6 +142,11 @@ npm pack
   environment variable or `set_engine_thread_count()` (default is fully
   serial and bit-identical to historical behavior). The Python `recommend`
   releases the GIL, so calls can also run concurrently from Python threads.
+- The RL algorithm keeps cross-request warm starts in memory and can persist
+  them across processes: set `DECK_RL_SEED_CACHE_FILE=<path>` (or
+  `DECK_DATA_DIR=<dir>`, which stores `rl_seed_cache.tsv` inside it) to
+  enable the on-disk cache, and `DECK_RL_SEED_CACHE_DISABLE=1` to turn the
+  cache off entirely (used by the quality benchmarks).
 - A pthreads wasm variant can be built with `-DSEKAI_WASM_THREADS=ON`
   (requires COOP/COEP headers for SharedArrayBuffer).
 - Local benchmark / regression tooling lives in `tools/bench/` (see its

{haruki_sekai_deck_recommend_cpp-0.3.2 → haruki_sekai_deck_recommend_cpp-0.3.5}/npm/haruki-sekai-deck-recommend-cpp/README.md

@@ -32,6 +32,7 @@ const engine = await createSekaiDeckRecommend({ wasmUrl })
 engine.loadMasterData("jp", masterData)
 engine.loadMusicMetas("jp", musicMetasText)
 
+const userData = engine.createUserData("jp", suiteData)
 const result = engine.recommend({
   region: "jp",
   live_type: "multi",
@@ -41,7 +42,6 @@ const result = engine.recommend({
   algorithm: "ga",
   music_id: 1,
   music_diff: "easy",
-  user_data: suiteData,
   single_card_configs: [{
     card_id: 12345,
     level: 60,
@@ -52,11 +52,18 @@ const result = engine.recommend({
   }],
   limit: 10,
   timeout_ms: 15000,
-})
+}, userData)
 
+userData.dispose()
 engine.dispose()
 ```
 
+For repeated recommendations, `createUserData` parses an immutable user-data
+snapshot once and the optional second argument reuses it in both `recommend`
+and `recommendBatch`. Passing `user_data` inline remains supported. Recreate
+the snapshot after reloading master data for its region; disposing the engine
+also disposes its remaining snapshots.
+
 Run recommendation calls in a Web Worker for production UI usage. Master data can
 be tens of MiB after JSON encoding, and long-running algorithms should not block
 the main thread.