danceflow-stemlab 1.4.2__tar.gz → 1.6.1__tar.gz

danceflow_stemlab-1.6.1/.github/dancerudiments-recording-ref

@@ -0,0 +1 @@
+b89d1b80fcd8a8d8e02394ec718b6f4debd97b94

danceflow_stemlab-1.6.1/.github/workflows/arcadians-demo.yml

@@ -0,0 +1,230 @@
+name: Arcadians release demo
+
+on:
+  workflow_call:
+  workflow_dispatch:
+  pull_request:
+    paths:
+      - '.github/workflows/arcadians-demo.yml'
+      - '.github/workflows/release.yml'
+      - '.github/dancerudiments-recording-ref'
+      - 'scripts/build_arcadians_demo.py'
+      - 'scripts/check_arcadians_audio.py'
+      - 'scripts/arcadians_http.py'
+      - '.github/workflows/arcadians-timeline.yml'
+      - 'scripts/build_arcadians_timeline.py'
+      - 'scripts/build_arcadians_pair_demos.py'
+      - 'scripts/build_arcadians_fourier_demo.py'
+      - 'scripts/recording_downloads.py'
+      - 'src/stemlab/analysis/frequency_bands.py'
+      - 'tests/test_arcadians_fourier_demo.py'
+      - 'scripts/check_viewer_build.py'
+      - 'scripts/timeline_display_checks.py'
+      - 'web-client/**'
+      - '.github/viewer-*.json'
+      - 'scripts/viewer_releases.py'
+      - 'package*.json'
+      - 'src/stemlab/analysis/rudiment_pairs.py'
+      - 'src/stemlab/recording_cli.py'
+      - 'tests/test_rudiment_pairs.py'
+      - 'tests/test_arcadians_pair_demos.py'
+      - 'scripts/check_torchaudio_decode.py'
+      - 'scripts/check_semantic_runtime.py'
+      - 'tests/test_arcadians_runtime.py'
+      - 'docker/**'
+      - 'scripts/check_arcadians_timeline.py'
+      - 'scripts/assemble_arcadians_site.py'
+      - 'src/stemlab/static_timeline.py'
+      - 'src/stemlab/web/**'
+      - 'tests/test_static_timeline.py'
+      - 'tests/test_arcadians_timeline.py'
+      - 'tests/test_arcadians_http.py'
+      - 'src/stemlab/analysis/rudiment_recordings.py'
+      - 'src/stemlab/analysis/rudiment_batch.py'
+      - 'src/stemlab/beats/**'
+      - 'src/stemlab/pipeline.py'
+      - 'tests/test_beat_inputs.py'
+      - 'tests/test_arcadians_release_demo.py'
+      - 'examples/arcadians/**'
+
+permissions:
+  contents: read
+
+jobs:
+  static-regressions:
+    name: Check timeline export and combined publication contracts
+    runs-on: ubuntu-24.04
+    timeout-minutes: 15
+    steps:
+      - uses: actions/checkout@v7
+        with:
+          persist-credentials: false
+      - uses: actions/setup-python@v7
+        with:
+          python-version: '3.11'
+      - name: Install lightweight test dependencies, without model downloads
+        run: |
+          python -m pip install numpy scipy soundfile matplotlib fastapi rich 'typer>=0.12' platformdirs pytest pyyaml ruff
+          python -m pip install --no-deps -e .
+      - name: Require latest stable released viewers and rebuilt controls before inference
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: python scripts/check_viewer_build.py --latest
+      - name: Lint before expensive analysis
+        run: python -m ruff check src tests scripts
+      - name: Test static timeline, completeness validation, HTTP and publication
+        run: |
+          python -m pytest tests/test_static_timeline.py tests/test_arcadians_timeline.py tests/test_arcadians_http.py tests/test_arcadians_pages_publish.py tests/test_arcadians_runtime.py tests/test_beat_inputs.py tests/test_beat_consensus.py tests/test_viewer_controls.py
+
+  timeline:
+    if: github.event_name != 'pull_request'
+    needs: static-regressions
+    name: Complete Arcadians analysis and static timeline
+    uses: ./.github/workflows/arcadians-timeline.yml
+    permissions:
+      contents: read
+
+  build:
+    needs: timeline
+    name: Generate and audition full Arcadians batch
+    runs-on: ubuntu-24.04
+    timeout-minutes: 30
+    env:
+      STEMLAB_REQUIRE_RECORDINGS: '1'
+      DANCERUDIMENTS_REQUIRE_NATIVE: '1'
+      PYTHONUNBUFFERED: '1'
+    steps:
+      - uses: actions/checkout@v7
+        with:
+          persist-credentials: false
+      - uses: actions/setup-python@v7
+        with:
+          python-version: '3.11'
+      - name: Read the same verified release snapshot used by the timeline
+        id: companion
+        shell: bash
+        run: python scripts/check_viewer_build.py --outputs "$GITHUB_OUTPUT"
+      - uses: actions/checkout@v7
+        with:
+          repository: kieransimkin/DanceRudiments
+          ref: ${{ steps.companion.outputs.ref }}
+          path: .recording-dancerudiments
+          persist-credentials: false
+      - name: Install published native companion and lightweight recording dependencies
+        run: |
+          sudo apt-get update
+          sudo apt-get install --yes libsndfile1 ffmpeg
+          python -m pip install numpy scipy 'soundfile>=0.12' matplotlib rich 'typer>=0.12' platformdirs pytest pyyaml playwright
+          python scripts/viewer_releases.py install
+          python -m pip install --no-deps -e .
+          python -c "from dancerudiments import SampledRecording; from dancerudiments_authoring.harness import build_recording_harness, HARNESS_DISPLAY_API_VERSION; assert HARNESS_DISPLAY_API_VERSION == 1"
+      - name: Run release-demo and recording regression tests
+        run: python -m pytest tests/test_arcadians_http.py tests/test_arcadians_release_demo.py tests/test_rudiment_recordings.py tests/test_frequency_bands.py tests/test_rudiment_matches.py tests/test_rudiment_pairs.py tests/test_arcadians_pair_demos.py tests/test_arcadians_fourier_demo.py
+      - name: Generate 48 full-song movements with the original MP3 included
+        env:
+          RELEASE_LABEL: ${{ github.ref_name }}
+          COMPANION_SHA: ${{ steps.companion.outputs.ref }}
+        shell: bash
+        run: |
+          # PR refs contain slashes; preview labels are not release claims.
+          LABEL="$RELEASE_LABEL"
+          if [[ "$GITHUB_EVENT_NAME" == 'pull_request' ]]; then LABEL="pr-${{ github.event.number }}"; fi
+          python scripts/build_arcadians_demo.py build \
+            --output dist/arcadians-pages \
+            --source-commit "$(git rev-parse HEAD)" \
+            --companion-commit "$COMPANION_SHA" \
+            --companion-license .recording-dancerudiments/LICENSE \
+            --release-tag "$LABEL"
+      - name: Install Chromium
+        run: python -m playwright install --with-deps chromium
+      - name: Run companion native recording and shared harness regressions
+        run: python -m unittest discover -s .recording-dancerudiments/tests/python -p test_recording.py -v
+      - name: Require audible source data and synchronized playback under the Pages URL prefix
+        run: |
+          python scripts/check_arcadians_audio.py dist/arcadians-pages \
+            --report dist/arcadians-audio-browser.json --screenshot dist/arcadians-comparison.png
+          python scripts/build_arcadians_demo.py verify dist/arcadians-pages
+      - name: Retrieve the same analysis run's exact float stems, outside the public site
+        uses: actions/download-artifact@v5
+        with:
+          name: stemlab-arcadians-recording-sources
+          path: recording-sources
+      - name: Generate stem-pair and average-comparison pages without rerunning separation
+        env:
+          COMPANION_SHA: ${{ steps.companion.outputs.ref }}
+        run: |
+          python scripts/build_arcadians_pair_demos.py --sources recording-sources \
+            --site dist/arcadians-pages --source-commit "$GITHUB_SHA" \
+            --companion-commit "$COMPANION_SHA" --companion-license .recording-dancerudiments/LICENSE
+      - name: Verify both additional galleries with original audio and native samples
+        run: |
+          python scripts/check_arcadians_audio.py dist/arcadians-pages --gallery arcadians-stems \
+            --report dist/arcadians-stems-audio-browser.json --screenshot dist/arcadians-stems-comparison.png
+          python scripts/check_arcadians_audio.py dist/arcadians-pages --gallery arcadians-averages \
+            --report dist/arcadians-averages-audio-browser.json --screenshot dist/arcadians-averages-comparison.png
+      - name: Retrieve the complete browser-validated timeline
+        uses: actions/download-artifact@v5
+        with:
+          name: stemlab-arcadians-timeline-pages
+          path: timeline-site
+      - name: Generate all six full-master Fourier resolutions through the shared recording API
+        env:
+          COMPANION_SHA: ${{ steps.companion.outputs.ref }}
+        run: |
+          python scripts/build_arcadians_fourier_demo.py --site dist/arcadians-pages \
+            --source-commit "$GITHUB_SHA" --companion-commit "$COMPANION_SHA" \
+            --companion-license .recording-dancerudiments/LICENSE
+      - name: Verify every Fourier resolution, full-dimensional native samples, bars and audio transport
+        shell: bash
+        run: |
+          for BANDS in 4 8 16 32 64 128; do
+            python scripts/check_arcadians_audio.py dist/arcadians-pages --gallery arcadians-fourier --channels "$BANDS" \
+              --report "dist/arcadians-fourier-${BANDS}-audio-browser.json" --screenshot "dist/arcadians-fourier-${BANDS}.png"
+          done
+      - name: Retrieve timeline QA separately, never into the public site
+        uses: actions/download-artifact@v5
+        with:
+          name: stemlab-arcadians-timeline-qa
+          path: dist/timeline-qa
+      - name: Assemble all five verified viewers into one Pages site
+        run: |
+          python scripts/assemble_arcadians_site.py --site dist/arcadians-pages \
+            --timeline timeline-site --qa dist/timeline-qa/arcadians-timeline-browser.json \
+            --source-sha "$GITHUB_SHA"
+          cp dist/timeline-qa/arcadians-timeline-browser.json dist/arcadians-timeline-browser.json
+      - name: Require matching HTTP QA for the complete five-viewer site
+        run: |
+          python scripts/publish_arcadians_pages.py verify --site dist/arcadians-pages \
+            --qa dist/arcadians-audio-browser.json --source-sha "$GITHUB_SHA"
+      - name: Freeze the tested public site as release assets
+        run: |
+          python scripts/build_arcadians_demo.py package dist/arcadians-pages --output dist/arcadians-release
+      - name: Upload only the verified public site
+        uses: actions/upload-artifact@v7
+        with:
+          name: stemlab-arcadians-pages
+          path: dist/arcadians-pages/
+          include-hidden-files: true
+          if-no-files-found: error
+      - name: Upload Arcadians release archive and provenance
+        uses: actions/upload-artifact@v7
+        with:
+          name: stemlab-arcadians-release-assets
+          path: dist/arcadians-release/*
+          if-no-files-found: error
+      - name: Retain browser validation evidence separately from the public site
+        if: always()
+        uses: actions/upload-artifact@v7
+        with:
+          name: stemlab-arcadians-browser-qa
+          path: |
+            dist/arcadians-comparison.png
+            dist/arcadians-audio-browser.json
+            dist/arcadians-timeline-browser.json
+            dist/arcadians-stems-audio-browser.json
+            dist/arcadians-averages-audio-browser.json
+            dist/arcadians-stems-comparison.png
+            dist/arcadians-averages-comparison.png
+            dist/arcadians-fourier-*-audio-browser.json
+            dist/arcadians-fourier-*.png
+          if-no-files-found: warn

danceflow_stemlab-1.6.1/.github/workflows/arcadians-pages.yml

@@ -0,0 +1,111 @@
+name: Publish Arcadians demo to Pages
+
+on:
+  workflow_dispatch:
+    inputs:
+      demo_run_id:
+        description: 'Successful Arcadians demo run ID; blank selects the latest on main'
+        type: string
+        required: false
+        default: ''
+  workflow_run:
+    workflows: ['Arcadians release demo']
+    branches: [main]
+    types: [completed]
+
+permissions:
+  contents: read
+
+jobs:
+  publish:
+    # Explicit manual publication needs no package release or opt-in variable.
+    # Automatic publication retains the existing Pages opt-in. Never publish PRs.
+    if: >-
+      github.repository == 'kieransimkin/stemlab' &&
+      ((github.event_name == 'workflow_dispatch' && github.ref == 'refs/heads/main') ||
+       (github.event_name == 'workflow_run' && vars.STEMLAB_PAGES_ENABLED == 'true' &&
+        github.event.workflow_run.conclusion == 'success' &&
+        github.event.workflow_run.event == 'workflow_dispatch' &&
+        github.event.workflow_run.head_branch == 'main' &&
+        github.event.workflow_run.head_repository.full_name == 'kieransimkin/stemlab'))
+    runs-on: ubuntu-24.04
+    timeout-minutes: 15
+    concurrency:
+      group: stemlab-pages
+      cancel-in-progress: false
+    permissions:
+      contents: read
+      actions: read
+      pages: write
+      id-token: write
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      # On workflow_run, github.sha is the trusted default-branch revision,
+      # not the triggering run's code. Artifacts are data, never executed.
+      - uses: actions/checkout@v7
+        with:
+          ref: ${{ github.sha }}
+          persist-credentials: false
+      - uses: actions/setup-python@v7
+        with:
+          python-version: '3.11'
+      - name: Check Pages is enabled and configured for Actions
+        id: pages
+        uses: actions/configure-pages@v5
+        continue-on-error: true
+      - name: Explain missing Pages configuration
+        if: steps.pages.outcome == 'failure'
+        run: |
+          echo '::error::Enable Settings > Pages > Source > GitHub Actions, then run this workflow again. The github-pages environment must permit main. No package release is required.'
+          exit 1
+      - name: Select successful same-repository demo and its exact artifacts
+        id: source
+        env:
+          GH_TOKEN: ${{ github.token }}
+          DEMO_RUN_ID: ${{ github.event_name == 'workflow_run' && github.event.workflow_run.id || inputs.demo_run_id }}
+        run: python scripts/publish_arcadians_pages.py select --run-id "$DEMO_RUN_ID"
+      - name: Download verified public site from selected run
+        uses: actions/download-artifact@v5
+        with:
+          artifact-ids: ${{ steps.source.outputs.site_artifact_id }}
+          merge-multiple: true
+          run-id: ${{ steps.source.outputs.run_id }}
+          github-token: ${{ github.token }}
+          path: public-site
+      - name: Download that run's browser evidence separately
+        uses: actions/download-artifact@v5
+        with:
+          artifact-ids: ${{ steps.source.outputs.qa_artifact_id }}
+          merge-multiple: true
+          run-id: ${{ steps.source.outputs.run_id }}
+          github-token: ${{ github.token }}
+          path: browser-qa
+      - name: Verify source commit, real MP3, public allowlist and successful HTTP browser QA
+        env:
+          SOURCE_SHA: ${{ steps.source.outputs.source_sha }}
+        run: |
+          python scripts/publish_arcadians_pages.py verify \
+            --site public-site --qa browser-qa/arcadians-audio-browser.json --source-sha "$SOURCE_SHA"
+      - name: Upload only the verified public directory to Pages
+        uses: actions/upload-pages-artifact@v4
+        with:
+          path: public-site
+      - name: Deploy Arcadians visualizer and original MP3
+        id: deployment
+        uses: actions/deploy-pages@v4
+      - name: Require the public URL to serve this build and seekable audio
+        env:
+          PAGE_URL: ${{ steps.deployment.outputs.page_url }}
+          SOURCE_SHA: ${{ steps.source.outputs.source_sha }}
+        run: |
+          python scripts/publish_arcadians_pages.py live --url "$PAGE_URL" \
+            --site public-site --source-sha "$SOURCE_SHA"
+          echo "### Published Arcadians timeline and movement demos" >> "$GITHUB_STEP_SUMMARY"
+          echo "${PAGE_URL%/}/timeline/arcadians/" >> "$GITHUB_STEP_SUMMARY"
+          echo "${PAGE_URL%/}/arcadians-stems/" >> "$GITHUB_STEP_SUMMARY"
+          echo "${PAGE_URL%/}/arcadians-averages/" >> "$GITHUB_STEP_SUMMARY"
+          echo "${PAGE_URL%/}/arcadians/" >> "$GITHUB_STEP_SUMMARY"
+          echo "${PAGE_URL%/}/arcadians-fourier/" >> "$GITHUB_STEP_SUMMARY"
+          echo "Source: $SOURCE_SHA. Public HTML and audio range request verified." >> "$GITHUB_STEP_SUMMARY"

danceflow_stemlab-1.6.1/.github/workflows/arcadians-timeline.yml

@@ -0,0 +1,94 @@
+name: Arcadians complete analysis timeline
+
+on:
+  workflow_call:
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    name: Analyse the full song and test the static React timeline
+    runs-on: ubuntu-24.04
+    timeout-minutes: 330
+    env:
+      PYTHONUNBUFFERED: '1'
+    steps:
+      - uses: actions/checkout@v7
+        with:
+          persist-credentials: false
+      - uses: actions/setup-python@v7
+        with:
+          python-version: '3.11'
+      - name: Require the latest released-viewer build before Docker
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: python scripts/check_viewer_build.py --latest
+      - name: Build the existing locked StemLab analysis environment for CPU
+        # The existing Dockerfile installs the verified Sonic Annotator/Vamp stack.
+        # No interactive installers, host GPU or non-commercial MuQ inference.
+        run: |
+          docker build -f docker/Dockerfile \
+            --build-arg TORCH_INDEX_URL=https://download.pytorch.org/whl/cpu \
+            --build-arg STEMLAB_BUILD_REF="$GITHUB_SHA" \
+            -t stemlab-timeline:ci .
+      - name: Run the complete core recipe on the original Arcadians MP3
+        # Model downloads use upstream registries, as in the normal local pipeline.
+        # Music is mounted because .dockerignore intentionally excludes audio.
+        run: |
+          mkdir -p "$RUNNER_TEMP/arcadians-timeline"
+          docker run --rm --entrypoint python \
+            -e OMP_NUM_THREADS=2 -e MKL_NUM_THREADS=2 \
+            -v "$RUNNER_TEMP/arcadians-timeline:/work" \
+            -v "$GITHUB_WORKSPACE/examples/arcadians:/opt/stemlab/examples/arcadians:ro" \
+            stemlab-timeline:ci /opt/stemlab/scripts/build_arcadians_timeline.py \
+              --results /work/analysis --output /work/site --source-commit "$GITHUB_SHA" \
+              --recording-sources /work/recording-sources
+      - name: Restore runner ownership of generated files
+        # Atomic JSON writes use 0600. Docker runs as root; transfer ownership,
+        # not world-readable permissions, even if analysis failed part-way.
+        if: always()
+        shell: bash
+        run: |
+          output="$RUNNER_TEMP/arcadians-timeline"
+          if [ -d "$output" ] && [ ! -L "$output" ]; then
+            sudo chown -R --no-dereference "$(id -u):$(id -g)" "$output"
+          fi
+      - name: Install browser verification tools only
+        run: |
+          python -m pip install numpy scipy soundfile matplotlib fastapi rich 'typer>=0.12' platformdirs pytest playwright
+          python -m pip install --no-deps -e .
+          python -m playwright install --with-deps chromium
+      - name: Require working static lanes, audio clock, seeking, zoom and saved-loop playback
+        run: |
+          python scripts/check_arcadians_timeline.py "$RUNNER_TEMP/arcadians-timeline/site" \
+            --require-core --report "$RUNNER_TEMP/arcadians-timeline/qa/arcadians-timeline-browser.json"
+      - name: Upload the tested timeline for the combined Pages build
+        uses: actions/upload-artifact@v7
+        with:
+          name: stemlab-arcadians-timeline-pages
+          path: ${{ runner.temp }}/arcadians-timeline/site/
+          if-no-files-found: error
+      - name: Share exact master and six float stems with the pair-demo job
+        uses: actions/upload-artifact@v7
+        with:
+          name: stemlab-arcadians-recording-sources
+          path: ${{ runner.temp }}/arcadians-timeline/recording-sources/
+          retention-days: 7
+          if-no-files-found: error
+      - name: Upload separate timeline browser evidence
+        if: always()
+        uses: actions/upload-artifact@v7
+        with:
+          name: stemlab-arcadians-timeline-qa
+          path: ${{ runner.temp }}/arcadians-timeline/qa/
+          if-no-files-found: warn
+      - name: Retain original analysis artifacts, not models or runtime caches
+        if: always()
+        uses: actions/upload-artifact@v7
+        with:
+          name: stemlab-arcadians-complete-analysis
+          path: ${{ runner.temp }}/arcadians-timeline/analysis/
+          retention-days: 7
+          if-no-files-found: warn

danceflow_stemlab-1.6.1/.github/workflows/recordings.yml

@@ -0,0 +1,72 @@
+name: Recording batch and shared visualizer
+on:
+  pull_request:
+  push:
+    branches: [main]
+  workflow_dispatch:
+permissions:
+  contents: read
+jobs:
+  recordings:
+    runs-on: ${{ matrix.os }}
+    timeout-minutes: 25
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - os: ubuntu-latest
+            python: '3.10'
+          - os: windows-latest
+            python: '3.13'
+    env:
+      STEMLAB_REQUIRE_RECORDINGS: '1'
+      DANCERUDIMENTS_REQUIRE_NATIVE: '1'
+    defaults:
+      run:
+        shell: bash
+    steps:
+      - uses: actions/checkout@v7
+      - uses: actions/setup-python@v7
+        with:
+          python-version: ${{ matrix.python }}
+      - name: Require the latest stable published companion releases
+        id: companion
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: python scripts/check_viewer_build.py --latest --outputs "$GITHUB_OUTPUT"
+      - uses: actions/checkout@v7
+        with:
+          repository: kieransimkin/DanceRudiments
+          ref: ${{ steps.companion.outputs.ref }}
+          path: .recording-dancerudiments
+      - name: Report exact companion revision
+        run: git -C .recording-dancerudiments rev-parse HEAD
+      - name: Install the verified published wheel and lightweight test dependencies
+        run: |
+          python -m pip install numpy scipy soundfile matplotlib rich "typer>=0.12" platformdirs pytest pyyaml playwright
+          python scripts/viewer_releases.py install
+          python -m pip install --no-deps -e .
+      - name: Require new shared APIs and native class; no fallback/skip
+        run: python -c "from dancerudiments_authoring.harness import build_recording_harness, HARNESS_DISPLAY_API_VERSION; assert HARNESS_DISPLAY_API_VERSION == 1; from dancerudiments import SampledRecording"
+      - name: DSP, routing, mandatory BPM, native playback and matching regressions
+        run: python -m pytest tests/test_rudiment_recordings.py tests/test_frequency_bands.py tests/test_rudiment_matches.py tests/test_rudiment_pairs.py tests/test_arcadians_pair_demos.py tests/test_arcadians_fourier_demo.py
+      - name: Generate master/stem synthetic examples and a 48-candidate batch
+        run: python examples/recordings/generate_demo.py --output recording-demo
+      - name: Install Chromium
+        run: python -m playwright install --with-deps chromium
+      - name: Verify real local-file comparison, native samples, audio clock and reviews
+        run: python .recording-dancerudiments/tools/test_recording_harness.py recording-demo/batch/index.html --screenshot recording-comparison.png
+      - name: Verify new stem-pair and smoothing comparison harnesses
+        run: |
+          python .recording-dancerudiments/tools/test_recording_harness.py recording-demo/stem-pairs/index.html --screenshot stem-pairs-comparison.png
+          python .recording-dancerudiments/tools/test_recording_harness.py recording-demo/averages/index.html --screenshot averages-comparison.png
+      - uses: actions/upload-artifact@v7
+        if: always()
+        with:
+          name: recordings-${{ matrix.os }}-${{ matrix.python }}
+          path: |
+            recording-demo/
+            recording-comparison.png
+            stem-pairs-comparison.png
+            averages-comparison.png
+          if-no-files-found: warn