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

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

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

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

@@ -0,0 +1,210 @@
+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/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_rudiment_matches.py tests/test_rudiment_pairs.py tests/test_arcadians_pair_demos.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: 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 four 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 four-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
+          if-no-files-found: warn

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

@@ -0,0 +1,110 @@
+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 "Source: $SOURCE_SHA. Public HTML and audio range request verified." >> "$GITHUB_STEP_SUMMARY"

danceflow_stemlab-1.5.0/.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.5.0/.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_rudiment_matches.py tests/test_rudiment_pairs.py tests/test_arcadians_pair_demos.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

{danceflow_stemlab-1.4.2 → danceflow_stemlab-1.5.0}/.github/workflows/release.yml

@@ -9,6 +9,12 @@ permissions:
   contents: read
 
 jobs:
+  arcadians-demo:
+    name: Build Arcadians audio-synchronised movement demo
+    uses: ./.github/workflows/arcadians-demo.yml
+    permissions:
+      contents: read
+
   codex-package:
     name: Validate and package Codex plugin
     uses: ./.github/workflows/codex-plugin.yml
@@ -18,7 +24,7 @@ jobs:
       contents: read
 
   release-build:
-    needs: codex-package
+    needs: [codex-package, arcadians-demo]
     name: Build and validate StemLab release
     runs-on: ubuntu-22.04
     steps:
@@ -29,6 +35,9 @@ jobs:
           python-version: "3.10"
           cache: pip
 
+      - name: Verify rebuilt frontend and released dependency snapshot
+        run: python scripts/check_viewer_build.py
+
       - name: Native build requirements
         run: |
           sudo apt-get update
@@ -42,6 +51,9 @@ jobs:
           python -m pip install -e '.[all,binary,dev]'
           python -m pip install -U build twine
 
+      - name: Install and audit the same published native wheel used by demo CI
+        run: python scripts/viewer_releases.py install
+
       - name: Verify release tag matches StemLab version
         if: startsWith(github.ref, 'refs/tags/v')
         run: |
@@ -104,11 +116,18 @@ jobs:
           name: stemlab-codex-plugin-ubuntu-latest
           path: codex-release
 
+      - name: Retrieve browser-validated Arcadians release assets
+        uses: actions/download-artifact@v5
+        with:
+          name: stemlab-arcadians-release-assets
+          path: arcadians-release
+
       - name: Assemble StemLab release directory and manifest
         run: |
           mkdir -p dist-release
           cp dist/* dist-release/
           cp codex-release/* dist-release/
+          cp arcadians-release/* dist-release/
           if [[ -f build/nuitka/stemlab-linux-x86_64 ]]; then
             cp build/nuitka/stemlab-linux-x86_64 dist-release/
             chmod +x dist-release/stemlab-linux-x86_64
@@ -188,6 +207,59 @@ jobs:
             --repo "$REPOSITORY" \
             --clobber
 
+  arcadians-pages:
+    name: Publish Arcadians timeline and movement comparison to Pages
+    if: startsWith(github.ref, 'refs/tags/v') && github.repository == 'kieransimkin/stemlab' && vars.STEMLAB_PAGES_ENABLED == 'true'
+    needs: [github-release, arcadians-demo]
+    runs-on: ubuntu-24.04
+    concurrency:
+      group: stemlab-pages
+      cancel-in-progress: false
+    permissions:
+      contents: read
+      pages: write
+      id-token: write
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - uses: actions/checkout@v7
+        with:
+          persist-credentials: false
+      - uses: actions/setup-python@v7
+        with:
+          python-version: '3.11'
+      - name: Retrieve only the browser-validated public site
+        uses: actions/download-artifact@v5
+        with:
+          name: stemlab-arcadians-pages
+          path: public-site
+      - name: Configure GitHub Pages
+        uses: actions/configure-pages@v5
+      - name: Upload dedicated site directory, never the repository
+        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: Verify all four public viewers and their seekable audio
+        env:
+          PAGE_URL: ${{ steps.deployment.outputs.page_url }}
+        run: |
+          python scripts/publish_arcadians_pages.py live --url "$PAGE_URL" \
+            --site public-site --source-sha "$GITHUB_SHA"
+      - name: Published demo summary
+        env:
+          PAGE_URL: ${{ steps.deployment.outputs.page_url }}
+        run: |
+          echo "### 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 '48 master movements, 60 stem pairs, 180 averaging comparisons and complete timeline; original MP3, 145 BPM; beat phase unverified.' >> "$GITHUB_STEP_SUMMARY"
+
   container-publish:
     name: Build and publish release container
     if: startsWith(github.ref, 'refs/tags/v')

{danceflow_stemlab-1.4.2 → danceflow_stemlab-1.5.0}/AGENTS.md

@@ -13,3 +13,13 @@
 - Whenever a feature is added or changed, update the relevant README.md in the same change to reflect the resulting behaviour. This applies to every feature addition or modification, including APIs, commands, configuration, defaults, integrations and removals.
 - Update affected feature descriptions, usage instructions, options, examples and limitations. For tools or packages with their own README.md, update that README as well as the repository README when its overview or usage is affected.
 - Check the README against the implemented and verified behaviour before committing, opening or merging a PR, publishing a release or handing off the work. A feature change is incomplete until its README documentation is current; a changelog or other documentation does not replace this requirement.
+
+## Released viewers and coordinated CI/CD
+
+- Read [docs/released-viewers.md](docs/released-viewers.md) before changing dependency, build or release behaviour. The sibling layout is `DanceRudiments/`, `react-timeline-sequence/`, and `stemlab/` under one parent.
+- Release the two companions first (React Timeline Sequence, then DanceRudiments), verify their configured publication workflows and public registries, then synchronize/rebuild/test/release StemLab. A merge or tag alone is not a verified release.
+- StemLab must target the **latest stable official releases**. No unreleased main commit, mutable development override, local `file:` archive or vendor package may substitute for a missing release. Latest is resolved before the build and locked to exact published versions, release commits and registry hashes for that run; fail visibly on stale or incompatible dependencies rather than falling back silently.
+- Use the canonical `stemlab/scripts/Release-DanceFlow.ps1` coordinator from the shared parent directory. Preview first; `-Execute` explicitly performs scoped commits, normal pushes and fresh tags; `-Resume` must preserve source identities and existing tags/assets. Never force-push, move release tags, commit unrelated work, bypass failed checks or change approvals/protections/credentials to manufacture a pass.
+- Update this repository's README.md and AGENTS.md in the same change whenever release policy, dependency rules, automation, commands, controls or validation change. Keep relevant package/feature READMEs current too. A separate guide or changelog does not replace the root README update.
+- Preserve the master-plus-drums/percussion beat-routing contract, 64-pips-per-beat native recording clock, per-dimension bars and combined waveform/spectrogram lanes. New UI features must be supplied by released shared APIs and genuinely rebuilt frontend assets, not copied engines or marker strings.
+- Distinguish source CI, package publication, full-song inference, browser/audio QA, artifact packaging, actual Pages deployment and live URL/audio verification. Keep all four Arcadians pages together; do not report unexecuted, skipped or older-commit checks as success. CI playback evidence is not subjective listening QA.