haruki-sekai-deck-recommend-cpp 0.2.22__tar.gz

haruki_sekai_deck_recommend_cpp-0.2.22/.github/copilot-instructions.md

@@ -0,0 +1,117 @@
+# Copilot Instructions
+
+Treat this repository as production C++ scoring code for Project Sekai deck
+recommendation and live calculation. The same engineering rules also live in
+`AGENTS.md` and `CLAUDE.md` — keep all three in sync when changing guidance.
+
+## Project Context
+
+- Core language: C++20.
+- Bindings: Python extension via pybind11 and WebAssembly via Embind.
+- Package names: PyPI and npm both use `haruki-sekai-deck-recommend-cpp`.
+- JSON: nlohmann/json from `3rdparty/json`.
+- Downstream runtime: Team Haruki `deck-service` builds this repository and
+  calls it through a C/Rust FFI bridge.
+
+## Work Safely
+
+- Keep changes narrow and calculation-focused.
+- Treat production userdata as object/dictionary shaped. Compact arrays can
+  appear in Mongo-exported local fixtures, but they are not the runtime API
+  contract.
+- 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.
+- Prefer clear validation errors for malformed options and missing userdata.
+
+## Important Paths
+
+- `src/live-score/`: live score, skill order, and timing calculations.
+- `src/deck-recommend/`: deck recommendation algorithms and result updates.
+- `src/deck-information/`: fixed deck services and deck detail calculation.
+- `src/card-information/`: card power, skill, and image state calculation.
+- `src/data-provider/`: masterdata/music meta/userdata loading.
+- `src/user-data/`: userdata parsers used by downstream services.
+- `sekai_deck_recommend.cpp`: Python binding entry point.
+
+## Build Checks
+
+```bash
+pip install -e . -v
+python -c "import sekai_deck_recommend_cpp"
+```
+
+For deck-service integration changes, also run from the sibling repo:
+
+```bash
+cd ../deck-service
+cargo check
+cargo build
+```
+
+For the WebAssembly target (Embind binding, browser/Worker), with `emsdk`
+activated:
+
+```bash
+mkdir build_wasm && cd build_wasm
+emcmake cmake .. -DCMAKE_BUILD_TYPE=Release
+cmake --build . -j
+```
+
+Two parallel binding files live in `src/`: `sekai_deck_recommend.cpp`
+(pybind11) and `sekai_deck_recommend_wasm.cpp` (Embind, JSON-in / JSON-out).
+Option validation is duplicated; keep both in sync when adding a field.
+
+The npm package scaffold lives in `npm/haruki-sekai-deck-recommend-cpp`. Do not
+bundle masterdata, music metas, or user data into the npm package; the
+application provides them at runtime. Local benchmark fixtures may live beside
+this repository as `../haruki-sekai-master`, `../music_metas.json`, and
+`../collections.suite.json`; do not commit those fixture files.
+
+Release workflows build PyPI wheels, PyPI sdist, and the npm wasm package. PyPI
+and npm publishing use Trusted Publishing/OIDC through the `pypi-publish` and
+`npm-publish` environments. PyPI publishing should only download artifacts
+prefixed with `pypi-`.
+
+## Git Commits
+
+All commit subjects must follow:
+
+```text
+[Type] Short description starting with capital letter
+```
+
+Allowed types: `[Feat]`, `[Fix]`, `[Chore]`, `[Docs]`.
+
+Rules:
+
+- Description starts with a capital letter.
+- Use imperative mood: `Add ...`, not `Added ...`.
+- No trailing period.
+- Keep the subject at or below roughly 70 characters.
+- Agent attribution uses a standard `Co-authored-by:` trailer in the commit
+  body, separated from the subject by a blank line.
+- Before creating any commit, ask the user whether this commit should publish a
+  new version.
+- If the user wants a new version, bump the relevant package versions according
+  to the user's requested release level. Versions must use `major.minor.patch`
+  format.
+- If the user does not want a new version, create the commit without changing
+  package versions.
+
+Project examples:
+
+```text
+[Feat] Add MySekai bonus target support
+[Fix] Parse compact runtime user cards
+[Chore] Update pybind11 build metadata
+[Docs] Document deck recommend options
+```
+
+Agent-authored commit example:
+
+```text
+[Docs] Add agent commit guidelines
+
+Co-authored-by: Codex <noreply@openai.com>
+```

haruki_sekai_deck_recommend_cpp-0.2.22/.github/workflows/build-npm.yml

@@ -0,0 +1,46 @@
+name: Build npm package
+
+on:
+  workflow_call:
+
+jobs:
+  npm:
+    name: npm package
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout source
+        uses: actions/checkout@v6.0.2
+        with:
+          submodules: recursive
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v6.4.0
+        with:
+          node-version: "22"
+          registry-url: "https://registry.npmjs.org"
+
+      - name: Install build tools
+        run: sudo apt-get update && sudo apt-get install -y ninja-build
+
+      - name: Install emsdk
+        run: |
+          git clone https://github.com/emscripten-core/emsdk.git "$HOME/emsdk"
+          "$HOME/emsdk/emsdk" install 5.0.7
+          "$HOME/emsdk/emsdk" activate 5.0.7
+
+      - name: Build WebAssembly artifacts
+        run: |
+          source "$HOME/emsdk/emsdk_env.sh"
+          emcmake cmake -S . -B build_wasm -G Ninja -DCMAKE_BUILD_TYPE=Release
+          cmake --build build_wasm -j
+
+      - name: Pack npm package
+        run: npm pack
+        working-directory: npm/haruki-sekai-deck-recommend-cpp
+
+      - name: Upload npm package
+        uses: actions/upload-artifact@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.2.22/.github/workflows/build-sdist.yml

@@ -0,0 +1,38 @@
+name: Build sdist
+
+on:
+  workflow_call:
+
+jobs:
+  sdist:
+    name: sdist
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v6.0.2
+        with:
+          submodules: recursive
+
+      - name: Set up Python
+        uses: actions/setup-python@v6.2.0
+        with:
+          python-version: "3.11"
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v8.1.0
+        with:
+          version: "0.9.18"
+          enable-cache: true
+
+      - name: Install build package
+        run: uv pip install --system build
+
+      - name: Build sdist
+        run: python -m build --sdist
+
+      - name: Upload sdist artifact
+        uses: actions/upload-artifact@v7.0.1
+        with:
+          name: pypi-sdist
+          path: dist/*.tar.gz

haruki_sekai_deck_recommend_cpp-0.2.22/.github/workflows/build-wheels.yml

@@ -0,0 +1,257 @@
+name: Build wheels
+
+on:
+  workflow_call:
+
+jobs:
+  # ============================================================
+  # Linux x86_64 manylinux
+  # ============================================================
+  linux_x64_many:
+    name: Linux x64 manylinux
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout source
+        uses: actions/checkout@v6.0.2
+        with:
+          submodules: recursive
+
+      - name: Set up Python
+        uses: actions/setup-python@v6.2.0
+        with:
+          python-version: "3.11"
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v8.1.0
+        with:
+          version: "0.9.18"
+          enable-cache: true
+
+      - name: Install cibuildwheel
+        run: uv pip install --system cibuildwheel
+
+      - name: Build wheels
+        run: python -m cibuildwheel --output-dir wheelhouse
+        env:
+          CIBW_BUILD: "cp31*-manylinux*"
+          CIBW_ARCHS_LINUX: "x86_64"
+          CIBW_BUILD_FRONTEND: "build[uv]"
+          CIBW_BUILD_VERBOSITY: "1"
+
+      - name: Upload wheels
+        uses: actions/upload-artifact@v7.0.1
+        with:
+          name: pypi-wheels-linux-x64-many
+          path: wheelhouse/*.whl
+
+  # ============================================================
+  # Linux x86_64 musllinux
+  # ============================================================
+  linux_x64_musl:
+    name: Linux x64 musllinux
+    runs-on: ubuntu-latest
+    continue-on-error: true
+
+    steps:
+      - name: Checkout source
+        uses: actions/checkout@v6.0.2
+        with:
+          submodules: recursive
+
+      - name: Set up Python
+        uses: actions/setup-python@v6.2.0
+        with:
+          python-version: "3.11"
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v8.1.0
+        with:
+          version: "0.9.18"
+          enable-cache: true
+
+      - name: Install cibuildwheel
+        run: uv pip install --system cibuildwheel
+
+      - name: Build wheels
+        run: python -m cibuildwheel --output-dir wheelhouse
+        env:
+          CIBW_BUILD: "cp31*-musllinux*"
+          CIBW_ARCHS_LINUX: "x86_64"
+          CIBW_BUILD_FRONTEND: "build[uv]"
+          CIBW_BUILD_VERBOSITY: "1"
+
+      - name: Upload wheels
+        uses: actions/upload-artifact@v7.0.1
+        with:
+          name: pypi-wheels-linux-x64-musl
+          path: wheelhouse/*.whl
+
+  # ============================================================
+  # Linux arm64 manylinux
+  # ============================================================
+  linux_arm64_many:
+    name: Linux arm64 manylinux
+    runs-on: ubuntu-24.04-arm
+
+    steps:
+      - name: Checkout source
+        uses: actions/checkout@v6.0.2
+        with:
+          submodules: recursive
+
+      - name: Set up Python
+        uses: actions/setup-python@v6.2.0
+        with:
+          python-version: "3.11"
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v8.1.0
+        with:
+          version: "0.9.18"
+          enable-cache: true
+
+      - name: Install cibuildwheel
+        run: uv pip install --system cibuildwheel
+
+      - name: Build wheels
+        run: python -m cibuildwheel --output-dir wheelhouse
+        env:
+          CIBW_BUILD: "cp31*-manylinux*"
+          CIBW_ARCHS_LINUX: "aarch64"
+          CIBW_BUILD_FRONTEND: "build[uv]"
+          CIBW_BUILD_VERBOSITY: "1"
+
+      - name: Upload wheels
+        uses: actions/upload-artifact@v7.0.1
+        with:
+          name: pypi-wheels-linux-arm64-many
+          path: wheelhouse/*.whl
+
+  # ============================================================
+  # Linux arm64 musllinux
+  # ============================================================
+  linux_arm64_musl:
+    name: Linux arm64 musllinux
+    runs-on: ubuntu-24.04-arm
+    continue-on-error: true
+
+    steps:
+      - name: Checkout source
+        uses: actions/checkout@v6.0.2
+        with:
+          submodules: recursive
+
+      - name: Set up Python
+        uses: actions/setup-python@v6.2.0
+        with:
+          python-version: "3.11"
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v8.1.0
+        with:
+          version: "0.9.18"
+          enable-cache: true
+
+      - name: Install cibuildwheel
+        run: uv pip install --system cibuildwheel
+
+      - name: Build wheels
+        run: python -m cibuildwheel --output-dir wheelhouse
+        env:
+          CIBW_BUILD: "cp31*-musllinux*"
+          CIBW_ARCHS_LINUX: "aarch64"
+          CIBW_BUILD_FRONTEND: "build[uv]"
+          CIBW_BUILD_VERBOSITY: "1"
+
+      - name: Upload wheels
+        uses: actions/upload-artifact@v7.0.1
+        with:
+          name: pypi-wheels-linux-arm64-musl
+          path: wheelhouse/*.whl
+
+  # ============================================================
+  # Windows x64
+  # ============================================================
+  windows_x64:
+    name: Windows x64
+    runs-on: windows-latest
+
+    steps:
+      - name: Checkout source
+        uses: actions/checkout@v6.0.2
+        with:
+          submodules: recursive
+
+      - name: Set up Python
+        uses: actions/setup-python@v6.2.0
+        with:
+          python-version: "3.11"
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v8.1.0
+        with:
+          version: "0.9.18"
+          enable-cache: true
+
+      - name: Install cibuildwheel
+        run: uv pip install --system cibuildwheel
+
+      - name: Build wheels
+        run: python -m cibuildwheel --output-dir wheelhouse
+        env:
+          CIBW_BUILD: "cp31*-*"
+          CIBW_ARCHS_WINDOWS: "AMD64"
+          CIBW_CMAKE_GENERATOR: "Ninja"
+          CIBW_ENVIRONMENT_WINDOWS: >
+            CC=clang-cl
+            CXX=clang-cl
+          CIBW_BUILD_FRONTEND: "build[uv]"
+          CIBW_BUILD_VERBOSITY: "1"
+
+      - name: Upload wheels
+        uses: actions/upload-artifact@v7.0.1
+        with:
+          name: pypi-wheels-windows-x64
+          path: wheelhouse/*.whl
+
+  # ============================================================
+  # macOS arm64
+  # ============================================================
+  macos_arm64:
+    name: macOS arm64
+    runs-on: macos-latest
+
+    steps:
+      - name: Checkout source
+        uses: actions/checkout@v6.0.2
+        with:
+          submodules: recursive
+
+      - name: Set up Python
+        uses: actions/setup-python@v6.2.0
+        with:
+          python-version: "3.11"
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v8.1.0
+        with:
+          version: "0.9.18"
+          enable-cache: true
+
+      - name: Install cibuildwheel
+        run: uv pip install --system cibuildwheel
+
+      - name: Build wheels
+        run: python -m cibuildwheel --output-dir wheelhouse
+        env:
+          CIBW_BUILD: "cp31*-*"
+          CIBW_ARCHS_MACOS: "arm64"
+          CIBW_BUILD_FRONTEND: "build[uv]"
+          CIBW_BUILD_VERBOSITY: "1"
+
+      - name: Upload wheels
+        uses: actions/upload-artifact@v7.0.1
+        with:
+          name: pypi-wheels-macos-arm64
+          path: wheelhouse/*.whl

haruki_sekai_deck_recommend_cpp-0.2.22/.github/workflows/release.yml

@@ -0,0 +1,101 @@
+name: Build and publish packages
+
+on:
+  push:
+    tags:
+      - "v*"
+
+jobs:
+  build_wheels:
+    name: Build wheels
+    uses: ./.github/workflows/build-wheels.yml
+
+  build_sdist:
+    name: Build sdist
+    uses: ./.github/workflows/build-sdist.yml
+
+  build_npm:
+    name: Build npm package
+    uses: ./.github/workflows/build-npm.yml
+
+  github_release:
+    name: Create GitHub Release
+    needs:
+      - build_wheels
+      - build_sdist
+      - build_npm
+    runs-on: ubuntu-latest
+
+    permissions:
+      contents: write
+
+    steps:
+      - name: Download release artifacts
+        uses: actions/download-artifact@v8.0.1
+        with:
+          path: dist
+          merge-multiple: true
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v3.0.0
+        with:
+          files: dist/*
+          generate_release_notes: true
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+  publish_pypi:
+    name: Publish to PyPI
+    needs:
+      - build_wheels
+      - build_sdist
+    runs-on: ubuntu-latest
+
+    environment:
+      name: pypi-publish
+      url: https://pypi.org/p/haruki-sekai-deck-recommend-cpp
+
+    permissions:
+      id-token: write
+
+    steps:
+      - name: Download PyPI artifacts
+        uses: actions/download-artifact@v8.0.1
+        with:
+          path: dist
+          pattern: pypi-*
+          merge-multiple: true
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@v1.14.0
+        with:
+          packages-dir: dist/
+
+  publish_npm:
+    name: Publish to npm
+    needs:
+      - build_npm
+    runs-on: ubuntu-latest
+
+    environment:
+      name: npm-publish
+      url: https://www.npmjs.com/package/haruki-sekai-deck-recommend-cpp
+
+    permissions:
+      id-token: write
+
+    steps:
+      - name: Set up Node.js
+        uses: actions/setup-node@v6.4.0
+        with:
+          node-version: "22"
+          registry-url: "https://registry.npmjs.org"
+
+      - name: Download npm package
+        uses: actions/download-artifact@v8.0.1
+        with:
+          name: npm-package
+          path: dist
+
+      - name: Publish to npm
+        run: npm publish dist/haruki-sekai-deck-recommend-cpp-*.tgz --provenance

haruki_sekai_deck_recommend_cpp-0.2.22/.gitignore

@@ -0,0 +1,6 @@
+build/
+build_wasm/
+sandbox/
+.vscode/
+npm/haruki-sekai-deck-recommend-cpp/sekai_deck_recommend.js
+npm/haruki-sekai-deck-recommend-cpp/sekai_deck_recommend.wasm

haruki_sekai_deck_recommend_cpp-0.2.22/.gitmodules

@@ -0,0 +1,6 @@
+[submodule "3rdparty/pybind11"]
+	path = 3rdparty/pybind11
+	url = https://github.com/pybind/pybind11
+[submodule "3rdparty/json"]
+	path = 3rdparty/json
+	url = https://github.com/nlohmann/json

haruki_sekai_deck_recommend_cpp-0.2.22/3rdparty/json/.cirrus.yml

@@ -0,0 +1,17 @@
+arm_container:
+  image: gcc:latest
+
+check_task:
+  check_script:
+  - wget https://github.com/Kitware/CMake/releases/download/v3.20.2/cmake-3.20.2.tar.gz
+  - tar xfz cmake-3.20.2.tar.gz
+  - cd cmake-3.20.2
+  - ./configure
+  - make cmake ctest -j4
+  - cd ..
+  - mkdir build
+  - cd build
+  - ../cmake-3.20.2/bin/cmake .. -DJSON_FastTests=ON
+  - make -j4
+  - cd tests
+  - ../../cmake-3.20.2/bin/ctest -j4

haruki_sekai_deck_recommend_cpp-0.2.22/3rdparty/json/.clang-tidy

@@ -0,0 +1,77 @@
+# TODO: The first three checks are only removed to get the CI going. They have to be addressed at some point.
+
+Checks: '*,
+
+         -portability-template-virtual-member-function,
+         -bugprone-use-after-move,
+         -hicpp-invalid-access-moved,
+
+         -altera-id-dependent-backward-branch,
+         -altera-struct-pack-align,
+         -altera-unroll-loops,
+         -android-cloexec-fopen,
+         -boost-use-ranges,
+         -bugprone-easily-swappable-parameters,
+         -cert-err58-cpp,
+         -clang-analyzer-webkit.NoUncountedMemberChecker,
+         -concurrency-mt-unsafe,
+         -cppcoreguidelines-avoid-const-or-ref-data-members,
+         -cppcoreguidelines-avoid-do-while,
+         -cppcoreguidelines-avoid-goto,
+         -cppcoreguidelines-avoid-magic-numbers,
+         -cppcoreguidelines-avoid-non-const-global-variables,
+         -cppcoreguidelines-macro-usage,
+         -cppcoreguidelines-pro-bounds-array-to-pointer-decay,
+         -cppcoreguidelines-pro-bounds-constant-array-index,
+         -cppcoreguidelines-pro-bounds-pointer-arithmetic,
+         -cppcoreguidelines-pro-type-reinterpret-cast,
+         -cppcoreguidelines-pro-type-union-access,
+         -cppcoreguidelines-rvalue-reference-param-not-moved,
+         -cppcoreguidelines-virtual-class-destructor,
+         -fuchsia-default-arguments-calls,
+         -fuchsia-default-arguments-declarations,
+         -fuchsia-overloaded-operator,
+         -google-explicit-constructor,
+         -google-readability-function-size,
+         -google-runtime-int,
+         -google-runtime-references,
+         -hicpp-avoid-goto,
+         -hicpp-explicit-conversions,
+         -hicpp-function-size,
+         -hicpp-no-array-decay,
+         -hicpp-no-assembler,
+         -hicpp-signed-bitwise,
+         -hicpp-uppercase-literal-suffix,
+         -llvm-header-guard,
+         -llvm-include-order,
+         -llvmlibc-*,
+         -misc-use-anonymous-namespace,
+         -misc-confusable-identifiers,
+         -misc-include-cleaner,
+         -misc-no-recursion,
+         -misc-non-private-member-variables-in-classes,
+         -modernize-concat-nested-namespaces,
+         -modernize-type-traits,
+         -modernize-use-constraints,
+         -modernize-use-designated-initializers,
+         -modernize-use-nodiscard,
+         -modernize-use-ranges,
+         -modernize-use-std-numbers,
+         -modernize-use-trailing-return-type,
+         -performance-enum-size,
+         -readability-function-cognitive-complexity,
+         -readability-function-size,
+         -readability-identifier-length,
+         -readability-magic-numbers,
+         -readability-redundant-access-specifiers,
+         -readability-simplify-boolean-expr,
+         -readability-uppercase-literal-suffix'
+
+CheckOptions:
+  - key: hicpp-special-member-functions.AllowSoleDefaultDtor
+    value: 1
+
+WarningsAsErrors: '*'
+
+#HeaderFilterRegex: '.*nlohmann.*'
+HeaderFilterRegex: '.*hpp$'

haruki_sekai_deck_recommend_cpp-0.2.22/3rdparty/json/.github/CODEOWNERS

@@ -0,0 +1,6 @@
+# JSON for Modern C++ was originally written by Niels Lohmann.
+# Since 2013, over 250 contributors have helped to improve the library.
+# This CODEOWNERS file is only to make sure that @nlohmann is requested
+# for a code review in case of a pull request.
+
+* @nlohmann