feat[notask]: add bci-whispercpp package for BCI neural signal transcription

.github/workflows/integration-test-bci-whispercpp.yml

@@ -0,0 +1,266 @@
+name: "Integration Tests (BCI Whispercpp)"
+
+on:
+  workflow_dispatch:
+    inputs:
+      prebuild_package:
+        description: "NPM package containing prebuilds (e.g. @qvac/bci-whispercpp@0.1.0)"
+        required: false
+        type: string
+  workflow_call:
+    inputs:
+      ref:
+        description: "ref"
+        type: string
+        required: false
+      repository:
+        type: string
+        required: false
+        default: "tetherto/qvac"
+      workdir:
+        description: "Working directory inside the repo (monorepo package path)"
+        type: string
+        required: false
+        default: "packages/bci-whispercpp"
+
+env:
+  PKG_DIR: packages/bci-whispercpp
+
+jobs:
+  run-integration-tests:
+    timeout-minutes: 60
+    continue-on-error: true
+    runs-on: ${{ matrix.os }}
+    name: test-${{ matrix.platform }}-${{ matrix.arch }}
+
+    permissions:
+      contents: read
+      packages: read
+
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - os: ubuntu-22.04
+            platform: linux
+            arch: x64
+          - os: macos-15-xlarge
+            platform: darwin
+            arch: arm64
+          - os: macos-15-large
+            platform: darwin
+            arch: x64
+          - os: windows-2022
+            platform: win32
+            arch: x64
+
+    steps:
+      - name: Setup Node.js
+        uses: actions/setup-node@v6
+        with:
+          node-version: lts/*
+
+      - name: Windows - enable git long paths
+        if: ${{ matrix.platform == 'win32' }}
+        shell: powershell
+        run: git config --system core.longpaths true
+
+      - name: Checkout code
+        uses: actions/checkout@v6
+        with:
+          repository: ${{ inputs.repository || github.repository }}
+          ref: ${{ inputs.ref || github.ref }}
+          token: ${{ secrets.PAT_TOKEN }}
+
+      - name: Configure scoped registry (Unix)
+        if: ${{ matrix.platform != 'win32' }}
+        working-directory: ${{ inputs.workdir || env.PKG_DIR }}
+        env:
+          GPR_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
+          GIT_PAT: ${{ secrets.PAT_TOKEN }}
+        shell: bash
+        run: |
+          set -eu
+          cat > .npmrc <<NPMRC
+          always-auth=true
+          registry=https://registry.npmjs.org/
+          @qvac:registry=https://registry.npmjs.org/
+          @tetherto:registry=https://npm.pkg.github.com/
+          //registry.npmjs.org/:_authToken=${NPM_TOKEN}
+          //npm.pkg.github.com/:_authToken=${GPR_TOKEN}
+          NPMRC
+
+          if [ -n "${GIT_PAT:-}" ]; then
+            git config --global url."https://${GIT_PAT}:@github.com/".insteadOf "https://github.com/"
+          else
+            git config --global url."https://${{ github.token }}:@github.com/".insteadOf "https://github.com/"
+          fi
+
+      - name: Configure scoped registry (Windows)
+        if: ${{ matrix.platform == 'win32' }}
+        working-directory: ${{ inputs.workdir || env.PKG_DIR }}
+        env:
+          GPR_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
+          GIT_PAT: ${{ secrets.PAT_TOKEN }}
+        shell: powershell
+        run: |
+          $npmrc = @"
+          always-auth=true
+          registry=https://registry.npmjs.org/
+          @qvac:registry=https://registry.npmjs.org/
+          @tetherto:registry=https://npm.pkg.github.com/
+          //registry.npmjs.org/:_authToken=$env:NPM_TOKEN
+          //npm.pkg.github.com/:_authToken=$env:GPR_TOKEN
+          "@
+          $npmrc | Out-File -FilePath .npmrc -Encoding utf8
+          if ($env:GIT_PAT) {
+            git config --global url."https://$($env:GIT_PAT):@github.com/".insteadOf "https://github.com/"
+          } else {
+            git config --global url."https://${{ github.token }}:@github.com/".insteadOf "https://github.com/"
+          }
+
+      - name: Install NPM dependencies
+        working-directory: ${{ inputs.workdir || env.PKG_DIR }}
+        run: |
+          npm install
+          npm install -g bare@1.26.0 bare-make
+
+      - name: Download prebuilds from artifact
+        if: ${{ !inputs.prebuild_package }}
+        uses: actions/download-artifact@v7
+        with:
+          path: ${{ inputs.workdir || env.PKG_DIR }}/prebuilds
+          merge-multiple: true
+
+      - name: Download prebuilds from package (Unix)
+        if: ${{ inputs.prebuild_package && matrix.platform != 'win32' }}
+        working-directory: ${{ inputs.workdir || env.PKG_DIR }}
+        shell: bash
+        run: |
+          mkdir -p prebuilds
+          npm pack ${{ inputs.prebuild_package }} --pack-destination /tmp
+          tar -xzf /tmp/*.tgz -C /tmp
+          cp -r /tmp/package/prebuilds/* prebuilds/
+
+      - name: Download prebuilds from package (Windows)
+        if: ${{ inputs.prebuild_package && matrix.platform == 'win32' }}
+        working-directory: ${{ inputs.workdir || env.PKG_DIR }}
+        shell: powershell
+        run: |
+          New-Item -ItemType Directory -Force -Path prebuilds | Out-Null
+          npm pack ${{ inputs.prebuild_package }} --pack-destination $env:TEMP
+          $tgz = Get-ChildItem "$env:TEMP\*.tgz" | Select-Object -First 1
+          tar -xzf $tgz.FullName -C $env:TEMP
+          Copy-Item -Path "$env:TEMP\package\prebuilds\*" -Destination prebuilds -Recurse -Force
+
+      - name: Download BCI models and test fixtures (Unix)
+        if: ${{ matrix.platform != 'win32' }}
+        working-directory: ${{ inputs.workdir || env.PKG_DIR }}
+        shell: bash
+        env:
+          GH_TOKEN: ${{ secrets.PAT_TOKEN }}
+        run: |
+          mkdir -p models test/fixtures
+          gh release download bci-test-assets-v0.1.0 \
+            --repo sharmaraju352/qvac \
+            --pattern "ggml-bci-windowed.bin" --dir models/ \
+            --clobber
+          gh release download bci-test-assets-v0.1.0 \
+            --repo sharmaraju352/qvac \
+            --pattern "bci-embedder.bin" --dir models/ \
+            --clobber
+          gh release download bci-test-assets-v0.1.0 \
+            --repo sharmaraju352/qvac \
+            --pattern "bci-test-fixtures.tar.gz" --dir /tmp \
+            --clobber
+          tar xzf /tmp/bci-test-fixtures.tar.gz -C test/fixtures/
+          echo "Model files:" && ls -la models/
+          echo "Test fixtures:" && ls -la test/fixtures/
+
+      - name: Download BCI models and test fixtures (Windows)
+        if: ${{ matrix.platform == 'win32' }}
+        working-directory: ${{ inputs.workdir || env.PKG_DIR }}
+        shell: powershell
+        env:
+          GH_TOKEN: ${{ secrets.PAT_TOKEN }}
+        run: |
+          New-Item -ItemType Directory -Force -Path models | Out-Null
+          New-Item -ItemType Directory -Force -Path test/fixtures | Out-Null
+          gh release download bci-test-assets-v0.1.0 `
+            --repo sharmaraju352/qvac `
+            --pattern "ggml-bci-windowed.bin" --dir models/ `
+            --clobber
+          gh release download bci-test-assets-v0.1.0 `
+            --repo sharmaraju352/qvac `
+            --pattern "bci-embedder.bin" --dir models/ `
+            --clobber
+          gh release download bci-test-assets-v0.1.0 `
+            --repo sharmaraju352/qvac `
+            --pattern "bci-test-fixtures.tar.gz" --dir $env:TEMP `
+            --clobber
+          tar xzf "$env:TEMP\bci-test-fixtures.tar.gz" -C test/fixtures/
+          Write-Host "Model files:" ; Get-ChildItem models/
+          Write-Host "Test fixtures:" ; Get-ChildItem test/fixtures/
+
+      - name: Linux - install dependencies
+        if: ${{ matrix.platform == 'linux' }}
+        shell: bash
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y mesa-vulkan-drivers
+          sudo apt-get install -y libopenblas-dev liblapack-dev libfftw3-dev
+
+      - name: macOS - install whisper dependencies
+        if: ${{ matrix.platform == 'darwin' }}
+        shell: bash
+        run: brew install --quiet openblas lapack fftw
+
+      - name: Print run state (Unix)
+        if: ${{ matrix.platform != 'win32' }}
+        working-directory: ${{ inputs.workdir || env.PKG_DIR }}
+        shell: bash
+        run: |
+          echo "node version: $(node -v)"
+          echo "npm version: $(npm -v)"
+          echo "bare version: $(bare -v)"
+          echo "bare-make version: $(bare-make --version)"
+          ls -la models/ || true
+          ls -la test/fixtures/ || true
+          ls -la prebuilds/ || true
+          tree prebuilds/ || true
+        continue-on-error: true
+
+      - name: Print run state (Windows)
+        if: ${{ matrix.platform == 'win32' }}
+        working-directory: ${{ inputs.workdir || env.PKG_DIR }}
+        shell: powershell
+        run: |
+          Write-Host "node version: $(node -v)"
+          Write-Host "npm version: $(npm -v)"
+          Write-Host "bare version: $(bare -v)"
+          Write-Host "bare-make version: $(bare-make --version)"
+          Get-ChildItem models/ -ErrorAction SilentlyContinue
+          Get-ChildItem test/fixtures/ -ErrorAction SilentlyContinue
+          Get-ChildItem prebuilds/ -ErrorAction SilentlyContinue
+          tree prebuilds /F 2>$null
+        continue-on-error: true
+
+      - name: Run integration tests (Unix)
+        if: ${{ matrix.platform != 'win32' }}
+        working-directory: ${{ inputs.workdir || env.PKG_DIR }}
+        shell: bash
+        run: npm run test:integration
+        env:
+          WHISPER_MODEL_PATH: models/ggml-bci-windowed.bin
+          GITHUB_TOKEN: ${{ secrets.PAT_TOKEN }}
+
+      - name: Run integration tests (Windows)
+        if: ${{ matrix.platform == 'win32' }}
+        working-directory: ${{ inputs.workdir || env.PKG_DIR }}
+        shell: powershell
+        run: npm run test:integration
+        env:
+          WHISPER_MODEL_PATH: models/ggml-bci-windowed.bin
+          GITHUB_TOKEN: ${{ secrets.PAT_TOKEN }}