studio: introduce studio device UX

.github/workflows/deploy-pages-channel.yml

@@ -0,0 +1,130 @@
+name: Deploy Pages Channel
+
+on:
+  workflow_dispatch:
+    inputs:
+      channel:
+        description: Static site channel to deploy
+        required: true
+        type: choice
+        options:
+          - beta
+          - demo
+      ref:
+        description: Git ref to build
+        required: true
+        default: main
+      dry_run:
+        description: Build and smoke-check without pushing to the Pages repo
+        required: true
+        type: boolean
+        default: false
+
+concurrency:
+  group: pages-channel-${{ inputs.channel }}
+  cancel-in-progress: false
+
+permissions:
+  contents: read
+
+env:
+  RUST_BACKTRACE: 1
+  RISC_V_TARGET: riscv32imac-unknown-none-elf
+  RUSTUP_PERMIT_COPY_RENAME: 1
+
+jobs:
+  deploy:
+    name: Build and deploy ${{ inputs.channel }}
+    runs-on: ubuntu-latest
+    steps:
+      - name: Install system deps
+        run: sudo apt-get update && sudo apt-get install -y libudev-dev pkg-config
+
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          ref: ${{ inputs.ref }}
+          fetch-depth: 0
+
+      - name: Install Rust toolchain
+        uses: dtolnay/rust-toolchain@stable
+        with:
+          toolchain: nightly-2026-04-27
+          components: rust-src
+
+      - name: Install Rust targets
+        run: |
+          rustup target add wasm32-unknown-unknown
+          rustup target add ${{ env.RISC_V_TARGET }}
+
+      - name: Cache cargo
+        uses: actions/cache@v4
+        with:
+          path: |
+            ~/.cargo/bin/
+            ~/.cargo/registry/index/
+            ~/.cargo/registry/cache/
+            ~/.cargo/git/db/
+            target/
+          key: ${{ runner.os }}-${{ runner.arch }}-pages-cargo-${{ hashFiles('**/Cargo.lock') }}
+          restore-keys: |
+            ${{ runner.os }}-${{ runner.arch }}-pages-cargo-
+
+      - name: Install just
+        uses: extractions/setup-just@v3
+
+      - name: Install wasm-bindgen-cli
+        run: cargo install wasm-bindgen-cli --version 0.2.114 --locked
+
+      - name: Install espflash
+        if: inputs.channel == 'beta'
+        run: cargo install espflash --version 3.3.0 --locked
+
+      - name: Build beta artifact
+        if: inputs.channel == 'beta'
+        run: just studio-web-deploy-dir beta target/pages/channel beta.lightplayer.app
+
+      - name: Smoke-check beta artifact
+        if: inputs.channel == 'beta'
+        run: just studio-web-smoke target/pages/channel
+
+      - name: Build demo artifact
+        if: inputs.channel == 'demo'
+        run: just web-demo-deploy-dir demo target/pages/channel demo.lightplayer.app
+
+      - name: Smoke-check demo artifact
+        if: inputs.channel == 'demo'
+        run: just web-demo-smoke target/pages/channel
+
+      - name: Create Pages App token
+        if: ${{ inputs.dry_run == false }}
+        id: pages-app-token
+        uses: actions/create-github-app-token@v3
+        with:
+          app-id: ${{ secrets.LIGHTPLAYER_PAGES_APP_ID }}
+          private-key: ${{ secrets.LIGHTPLAYER_PAGES_PRIVATE_KEY }}
+          owner: light-player
+          repositories: |
+            lightplayer-beta-pages
+            lightplayer-demo-pages
+          permission-contents: write
+
+      - name: Publish channel artifact
+        env:
+          LIGHTPLAYER_PAGES_TOKEN: ${{ steps.pages-app-token.outputs.token }}
+          CHANNEL: ${{ inputs.channel }}
+          DRY_RUN: ${{ inputs.dry_run }}
+        run: |
+          set -euo pipefail
+          target_repo=""
+          case "$CHANNEL" in
+            beta) target_repo="light-player/lightplayer-beta-pages" ;;
+            demo) target_repo="light-player/lightplayer-demo-pages" ;;
+            *) echo "unknown channel: $CHANNEL" >&2; exit 2 ;;
+          esac
+
+          args=(--repo "$target_repo" --dir target/pages/channel --message "deploy: ${CHANNEL} ${GITHUB_SHA::12}")
+          if [[ "$DRY_RUN" == "true" ]]; then
+            args+=(--dry-run)
+          fi
+          scripts/pages/publish-static-repo.sh "${args[@]}"

.github/workflows/deploy-studio-pages.yml

@@ -0,0 +1,88 @@
+name: Deploy Studio Pages
+
+on:
+  push:
+    branches:
+      - main
+  workflow_dispatch:
+
+concurrency:
+  group: pages-production
+  cancel-in-progress: false
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+env:
+  RUST_BACKTRACE: 1
+  RISC_V_TARGET: riscv32imac-unknown-none-elf
+  RUSTUP_PERMIT_COPY_RENAME: 1
+
+jobs:
+  deploy:
+    name: Build and deploy Studio
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - name: Install system deps
+        run: sudo apt-get update && sudo apt-get install -y libudev-dev pkg-config
+
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Install Rust toolchain
+        uses: dtolnay/rust-toolchain@stable
+        with:
+          toolchain: nightly-2026-04-27
+          components: rust-src
+
+      - name: Install Rust targets
+        run: |
+          rustup target add wasm32-unknown-unknown
+          rustup target add ${{ env.RISC_V_TARGET }}
+
+      - name: Cache cargo
+        uses: actions/cache@v4
+        with:
+          path: |
+            ~/.cargo/bin/
+            ~/.cargo/registry/index/
+            ~/.cargo/registry/cache/
+            ~/.cargo/git/db/
+            target/
+          key: ${{ runner.os }}-${{ runner.arch }}-pages-cargo-${{ hashFiles('**/Cargo.lock') }}
+          restore-keys: |
+            ${{ runner.os }}-${{ runner.arch }}-pages-cargo-
+
+      - name: Install just
+        uses: extractions/setup-just@v3
+
+      - name: Install wasm-bindgen-cli
+        run: cargo install wasm-bindgen-cli --version 0.2.114 --locked
+
+      - name: Install espflash
+        run: cargo install espflash --version 3.3.0 --locked
+
+      - name: Build Pages artifact
+        run: just studio-web-deploy-dir production target/pages/studio lightplayer.app
+
+      - name: Smoke-check Pages artifact
+        run: just studio-web-smoke target/pages/studio
+
+      - name: Configure Pages
+        uses: actions/configure-pages@v5
+
+      - name: Upload Pages artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: target/pages/studio
+
+      - name: Deploy Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

.gitignore

@@ -33,4 +33,10 @@ perf.data*
 .DS_Store
 .builtins-source-hash
 traces/
-profiles/
+profiles/
+lp-app/lpa-studio-web/public/pkg/
+lp-app/lpa-studio-web/public/fw-browser-worker.js
+lp-app/lpa-studio-web/public/firmware/
+lp-app/lpa-studio-web/dist/
+lp-app/lpa-studio-web/story-images/.new/
+lp-app/lpa-studio-web/story-images/.scratch/

AGENTS.md

@@ -222,6 +222,58 @@ deprecated. Do not adopt it in new code. If a plan file you are executing
 asks for "tests at the top", treat that as a stale instruction and put the
 test module at the bottom anyway.
 
+## Personal planning workflow
+
+New agent planning work uses the Photomancer personal planning workspace, not
+new repo-local plan or roadmap directories.
+
+- Use `pm-plan` for new planning, roadmap, and investigation artifacts.
+- Use `pm-implement` to execute an existing shared `plan.md`.
+- Use `pm-review` for durable review artifacts.
+- Resolve context from `agent-context.toml`; the repo slug is `lightplayer`.
+- Resolve the workspace from `PHOTOMANCER_PLANNING_ROOT`, or from the default
+  `~/.photomancer/planning` link.
+- Store new active artifacts under
+  `<planning-root>/lightplayer/<YYYY-MM-DD>-<name>/`.
+- Store completed artifacts under `<planning-root>/lightplayer/_archive/`.
+- Store review artifacts under `<planning-root>/lightplayer/_reviews/`.
+
+Durable decisions belong in repo ADRs under `docs/adr/`. Intermediate plans,
+phase prompts, review notes, scratch reports, and implementation logs belong in
+the shared planning workspace. Existing `docs/plans`, `docs/plans-old`,
+`docs/roadmaps`, and `docs/roadmaps-old` content is historical and should not
+be migrated unless a separate migration plan asks for it.
+
+## Studio UI visual baselines
+
+When a change touches non-generated files under `lp-app/lp-studio-web/`, run the
+Studio story baseline helper before committing:
+
+```bash
+just studio-story-baselines-if-needed
+```
+
+If it updates files under `lp-app/lp-studio-web/story-images/`, include those
+PNG changes in the same commit and mention the affected story baselines in the
+final summary. The helper intentionally ignores generated web artifacts,
+scratch PNGs, fresh check PNGs, and the baseline PNGs themselves.
+
+Useful related commands:
+
+```bash
+just studio-story-pngs        # ignored scratch PNGs for quick local review
+just studio-story-baselines   # update committed story baselines
+just studio-story-check       # compare fresh PNGs to committed baselines
+```
+
+`studio-story-baselines` and `studio-story-check` require `oxipng`; run
+`scripts/dev-init.sh` or install it with `cargo install oxipng` /
+`brew install oxipng`.
+
+Do not add an auto-mutating Git hook for this workflow unless the user asks for
+one explicitly. Hooks that rewrite the working tree during commit are annoying
+during rebases, merges, and partial commits.
+
 ## Validation Commands
 
 These commands must pass for any change touching the shader pipeline: