Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
24 commits
Select commit Hold shift + click to select a range
28de0df
feat(changelog): backfill native release films and screenshots
maximebrmd Nov 1, 2026
8c534c4
fix(pip): avoid granting page activation for automatic opening
maximebrmd Nov 1, 2026
e1b599c
test(extensions): handle cookie requests after fixture teardown
maximebrmd Nov 1, 2026
5e3927b
feat(changelog): smooth native release films and verify encoded motion
maximebrmd Nov 1, 2026
efe0b8a
fix(ci): stage native media when archiving cached UI
maximebrmd Nov 1, 2026
9af7afc
test(changelog): cover native MP4 controls and keyboard playback
maximebrmd Nov 1, 2026
abf8bfa
test(site): update appearance flow and isolate playback checks
maximebrmd Nov 1, 2026
afd2b5a
test(media): keep trace screenshots out of playback timings
maximebrmd Nov 1, 2026
10c4ba0
feat(changelog): automate native HyperFrames release media
maximebrmd Nov 2, 2026
912d6f9
fix(media): bound muxed sound to the storyboard duration
maximebrmd Nov 2, 2026
2aab64d
refactor(changelog): remove retired media paths and share release sou…
maximebrmd Nov 2, 2026
4fa63fe
refactor(release-media): simplify capture setup and canonical metadata
maximebrmd Nov 2, 2026
d844b88
fix(media): keep native capture windows visible across Spaces
maximebrmd Nov 2, 2026
6905252
fix(media): preserve visible windows during native capture
maximebrmd Nov 2, 2026
993c2d0
fix(pip): preserve cancellation of late automatic opening
maximebrmd Nov 2, 2026
5153405
refactor(media): use canonical entry points and shared source checks
maximebrmd Nov 2, 2026
352dca1
chore(media): refresh verified native sources after cleanup
maximebrmd Nov 2, 2026
a748e91
test(media): cover visual notes that mention performance
maximebrmd Nov 2, 2026
f366689
fix(media): keep visual performance notes in the refusal gate
maximebrmd Nov 2, 2026
83d6da0
fix(media): preserve routine performance-only release notes
maximebrmd Nov 2, 2026
7b720c1
ci(media): scope archive rendering to authoring changes
maximebrmd Nov 2, 2026
2310536
fix(media): refuse explicit new interfaces in optimization notes
maximebrmd Nov 2, 2026
187d788
fix(media): isolate fixture registry changes from media receipts
maximebrmd Nov 2, 2026
41d8db0
fix(changelog): label English media with localized captions
maximebrmd Nov 2, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
31 changes: 31 additions & 0 deletions .agents/skills/lilo-release-media/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,31 @@
---
name: lilo-release-media
description: Author and quality-gate HyperFrames announcements or screenshots from genuine native Lilo captures.
---

# Lilo release media

Use the exact release notes and changed implementation to choose the story. An interaction gets a HyperFrames film; a finished visual state gets a screenshot; routine fixes stay text-only. Never substitute a screenshot for a failed required film. `make release-media-author` checks known capture capabilities and exact source notes, including pending changes. Unknown visual work fails closed: add its native capture and storyboard in the feature pull request, so release preparation needs no editorial work after merge.

Capture the compiled native app with a disposable profile, owned example.com pages and synthetic call handlers. Extend concrete cases in `LiloTests/Window/ReleaseMediaCaptureTests.swift`. Keep actual app version/build/source commit in every receipt, separately from the release being illustrated. Never recreate browser controls or use the website demo as evidence.

Author literal editable HTML scenes under `release-media/hyperframes/`, with one paused GSAP timeline per composition, registered after synchronous construction. Use local assets, stable timed clip IDs, explicit durations and native state changes. No timers, unseeded randomness or network-fetched UI. Follow the approved 0.8.0 film for readable typography, deliberate transitions and pointer actions. Its share-only variant avoids announcing the address-bar feature in an unrelated release.

Use real source geometry for pointer targets and transparent PNG cutouts. Preserve captured RGB bytes and canvas sizes; change only alpha outside the native interface. Keep the UI’s own surfaces and complete window/page content. Check physical pixel density before enlargement. No CSS blur or 3D tilt on native UI. Titles settle while the product acts; do not add idle motion to satisfy a gate.

Use Make:

1. `make release-media-author`
2. `make release-media-capture RELEASE=x.y.z FIXTURE=a.b.c`
3. `make release-media-import release-media-render RELEASE=x.y.z`
4. `make release-media-check release-media-test release-media-inspect`
5. Review encoded frames at 342px, play the English/French changelog at desktop/mobile widths, and check native What’s New using `make release-media-review RELEASE=x.y.z`. Restore `make ui-build` after the native preview.
6. `make validate` and the release-media CI job must pass.

`make release-media-ci RELEASE=x.y.z` runs selection, fresh native capture, import, render, inspection, bundled What’s New playback and publication checks. Tagged CI captures the exact source commit and app version before signing; deployment uses that run’s validated website artifact. A failed audit, missing capability, broken capture, stale hash or failed media check blocks publication. Preserve a catalog publication kill switch; never re-enable it merely to make a workflow green.

Films use lossless PNG capture and 1080p60 H.264/AAC. Strict HyperFrames checks cover structure, runtime, layout, contrast, motion and audio. Encoded checks verify frame count, decode, sound, bounded motion, native/recipe/output hashes, cutout RGB preservation and poster similarity. Announcement reading holds may last up to three seconds; signal checks complement visual review rather than judging artistic quality.

Use the committed CC0 soundtrack and licensed editorial Foley. Music rights and hashes live in `release-media/public/audio/music.license.json`; attribution is optional, so no music credit overlay is needed. Never remove a required credit from a different track. Keep sound controls, explicit play, keyboard access and offscreen pause in both compact players.

See `release-media/README.md` and `docs/RELEASING.md` for production commands and Alexays’s one-time Cloudflare release-environment setup.
3 changes: 3 additions & 0 deletions .changes/unreleased/Changed-20261101-125840.670751.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
kind: Changed
body: Release highlights use focused native videos with sound, screenshots when motion adds little, and text alone for routine fixes.
time: 2026-11-01T12:58:40.670751+02:00
3 changes: 3 additions & 0 deletions .changes/unreleased/Fixed-20261101-134845.757200.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
kind: Fixed
body: Returning to a call cancels its automatic Picture-in-Picture opening, including a delayed response from the page.
time: 2026-11-01T13:48:45.7572+02:00
3 changes: 3 additions & 0 deletions .changes/unreleased/Fixed-20261102-213555.701648.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
kind: Fixed
body: Release illustrations show localized captions and identify their English text.
time: 2026-11-02T21:35:55.701648+02:00
2 changes: 2 additions & 0 deletions .gitattributes
Original file line number Diff line number Diff line change
@@ -0,0 +1,2 @@
# Preserve the creator's original license bytes and checksum.
release-media/public/audio/music.LICENSE.txt -text whitespace=cr-at-eol
51 changes: 48 additions & 3 deletions .github/workflows/build.yml
Original file line number Diff line number Diff line change
Expand Up @@ -22,6 +22,8 @@ jobs:
timeout-minutes: 5
outputs:
code: ${{ steps.diff.outputs.code }}
media: ${{ steps.diff.outputs.media }}
media-render: ${{ steps.diff.outputs.media-render }}
steps:
- uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
with:
Expand All @@ -33,12 +35,26 @@ jobs:
BASE: ${{ github.event.pull_request.base.sha || github.event.before }}
run: |
code=true
media=true
media_render=true
if git cat-file -e "$BASE^{commit}" 2>/dev/null; then
files=$(git diff --name-only "$BASE" "$GITHUB_SHA")
printf '%s\n' "$files" | grep -qvE '^(docs/|\.changes/)|\.md$' \
|| printf '%s\n' "$files" | grep -qx COMPATIBILITY.md || code=false
media=false
media_render=false
inputs=$(printf '%s\n' "$files" | grep -vE '\.md$|^docs/' || true)
if printf '%s\n' "$inputs" | grep -qE '^(release-media/|LiloTests/(Support/ReleaseMediaCapture\.swift|Support/TestRunCleanup\.swift|Window/ReleaseMediaCaptureTests\.swift)$|Makefile$|\.github/workflows/(build|release)\.yml$)'; then
media_render=true
media=true
fi
if printf '%s\n' "$inputs" | grep -qE '^(site/|lilo-ui/|Lilo/Bridge/ChromeUISchemeHandler\.swift$|LiloTests/Bridge/ChromeUISchemeHandlerTests\.swift$)'; then
media=true
fi
fi
echo "code=$code" >> "$GITHUB_OUTPUT"
echo "media=$media" >> "$GITHUB_OUTPUT"
echo "media-render=$media_render" >> "$GITHUB_OUTPUT"

release-tooling:
name: Release tooling and website
Expand All @@ -51,7 +67,37 @@ jobs:
node-version-file: 'site/.nvmrc'
cache: 'npm'
cache-dependency-path: site/package-lock.json
- run: make release-status release-test site-check site-test site-deploy-check
- run: make release-status release-test release-media-author release-media-test release-media-publish-check site-check site-test site-deploy-check

release-media:
name: Release media quality
needs: changes
if: needs.changes.outputs.media == 'true'
runs-on: ubuntu-latest
timeout-minutes: 30
steps:
- uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
- uses: actions/setup-node@949feb2413d6458794dcd2491c4babbbce0c15c1 # v7.1.0
with:
node-version-file: '.nvmrc'
- if: needs.changes.outputs.media-render == 'true'
run: sudo apt-get update && sudo apt-get install -y ffmpeg
- if: needs.changes.outputs.media-render == 'true'
run: make release-media-audit
- name: Author and render the native changelog archive
if: needs.changes.outputs.media-render == 'true'
run: make release-media-author release-media-render release-media-check release-media-test release-media-inspect
# Measure playback without competing software decoders on the hosted runner.
- run: make site-e2e SITE_E2E_ARGS='tests/changelog.spec.ts tests/release-media.spec.ts --workers=1'
- uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7.0.2
if: always()
with:
name: release-media-review-${{ github.sha }}
path: |
release-media/assets/
build/release-media/inspection/
site/test-results/
if-no-files-found: ignore

ui:
name: UI (lint, test, build, end-to-end)
Expand Down Expand Up @@ -197,9 +243,8 @@ jobs:
path: |
Lilo/Generated/ChromeUIAssets.swift
Lilo/Generated/NativeStrings.swift
key: ui-${{ steps.ui-lock.outputs.hash }}-${{ hashFiles('lilo-ui/src/**', 'lilo-ui/index.html', 'lilo-ui/svelte.config.js', 'lilo-ui/tsconfig.json', 'lilo-ui/vite.config.ts', 'scripts/embed_chrome_ui.py', 'scripts/generate_native_strings.py') }}
key: ui-${{ steps.ui-lock.outputs.hash }}-${{ hashFiles('release-media/backlog.json', 'release-media/catalog.ts', 'release-media/assets/**/*.png', 'release-media/assets/**/*.mp4', '.changes/v*.md', 'lilo-ui/package.json', 'lilo-ui/releaseNotesPlugin.ts', 'lilo-ui/src/**', 'lilo-ui/index.html', 'lilo-ui/svelte.config.js', 'lilo-ui/tsconfig.json', 'lilo-ui/vite.config.ts', 'scripts/embed_chrome_ui.py', 'scripts/generate_native_strings.py') }}
- uses: actions/setup-node@949feb2413d6458794dcd2491c4babbbce0c15c1 # v7.1.0
if: steps.ui-cache.outputs.cache-hit != 'true'
with:
node-version-file: '.nvmrc'
cache: 'npm'
Expand Down
132 changes: 103 additions & 29 deletions .github/workflows/release.yml
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,8 @@
# APPLE_NOTARY_APPLE_ID - Apple ID for notarytool
# APPLE_NOTARY_PASSWORD - app-specific password for notarytool
# SPARKLE_ED_PRIVATE_KEY - Sparkle EdDSA private key (generate_keys -x) that signs the appcast
# CLOUDFLARE_API_TOKEN - scoped Workers deployment token for lilo-site
# CLOUDFLARE_ACCOUNT_ID - Cloudflare account that owns getlilo.app

name: Release

Expand All @@ -23,7 +25,52 @@ concurrency:
cancel-in-progress: false

jobs:
release-media:
name: Native release media
if: github.repository == 'Alexays/Lilo'
runs-on: xcode-27
timeout-minutes: 60
steps:
- name: Checkout
uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
with:
persist-credentials: false
- name: Setup Node
uses: actions/setup-node@949feb2413d6458794dcd2491c4babbbce0c15c1 # v7.1.0
with:
node-version-file: '.nvmrc'
- name: Check the tag is a prepared release
run: make release-tag-check TAG="$GITHUB_REF_NAME"
- name: Install native capture and video tools
run: |
xcodebuild -downloadComponent MetalToolchain
brew install ffmpeg
- name: Capture, author, render and check the release
run: make release-media-ci RELEASE="${GITHUB_REF_NAME#v}"
- name: Build the website from the same verified media
run: make site-generate
- name: Preserve the verified native and website inputs
uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7.0.2
with:
name: release-media-${{ github.sha }}
overwrite: true
path: |
release-media/
!release-media/node_modules/
site/dist/
if-no-files-found: error
- name: Preserve failed capture and quality diagnostics
if: failure()
uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7.0.2
with:
name: release-media-failure-${{ github.sha }}
path: |
build/release-media/
release-media/assets/
if-no-files-found: ignore

build-and-sign:
needs: release-media
if: github.repository == 'Alexays/Lilo'
# The signing and notarization secrets live in this environment, which only v* tags may deploy to:
# a workflow pushed on any other branch cannot read them.
Expand All @@ -40,43 +87,28 @@ jobs:
with:
persist-credentials: false

# Fails in seconds what would otherwise fail after an hour of notarization, or ship a build Sparkle never offers.
- name: Check the tag is a prepared release
- name: Setup Node
uses: actions/setup-node@949feb2413d6458794dcd2491c4babbbce0c15c1 # v7.1.0
with:
node-version-file: '.nvmrc'
- name: Download this run's verified native media
uses: actions/download-artifact@018cc2cf5baa6db3ef3c5f8a56943fffe632ef53 # v6.0.0
with:
name: release-media-${{ github.sha }}
path: .
- name: Recheck the tag and media before signing
run: |
test -f ".changes/$GITHUB_REF_NAME.md" \
|| { echo "::error::.changes/$GITHUB_REF_NAME.md is missing: run make release-version and commit it before tagging."; exit 1; }
grep -qx "MARKETING_VERSION = ${GITHUB_REF_NAME#v}" Xcode/Configs/Base.xcconfig \
|| { echo "::error::Xcode/Configs/Base.xcconfig is not at ${GITHUB_REF_NAME#v}."; exit 1; }
make release-status
make release-tag-check TAG="$GITHUB_REF_NAME"
make release-media-publish-check RELEASE="${GITHUB_REF_NAME#v}"

- name: Show selected Xcode
run: xcodebuild -version

- name: Install Metal Toolchain
run: xcodebuild -downloadComponent MetalToolchain

# The generated UI sources, also saved by build.yml's release-build job. The key leaves out the lockfile's
# version lines, which a release bumps: a dependency change still shows in its resolved and integrity lines.
- name: Hash the UI lockfile
id: ui-lock
run: echo "hash=$(grep -v '"version":' lilo-ui/package-lock.json | shasum -a 256 | cut -c1-16)" >> "$GITHUB_OUTPUT"
- name: Restore the UI build
id: ui-cache
uses: actions/cache/restore@55cc8345863c7cc4c66a329aec7e433d2d1c52a9 # v6.1.0
with:
path: |
Lilo/Generated/ChromeUIAssets.swift
Lilo/Generated/NativeStrings.swift
key: ui-${{ steps.ui-lock.outputs.hash }}-${{ hashFiles('lilo-ui/src/**', 'lilo-ui/index.html', 'lilo-ui/svelte.config.js', 'lilo-ui/tsconfig.json', 'lilo-ui/vite.config.ts', 'scripts/embed_chrome_ui.py', 'scripts/generate_native_strings.py') }}
- name: Setup Node
if: steps.ui-cache.outputs.cache-hit != 'true'
uses: actions/setup-node@949feb2413d6458794dcd2491c4babbbce0c15c1 # v7.1.0
with:
node-version-file: '.nvmrc'
# Before any secret is in reach: no install script runs. The bridge bundles are committed, and checked against
# bridge-src by CI on main.
- name: Build the UI
if: steps.ui-cache.outputs.cache-hit != 'true'
# Native What's New must embed the just-verified media, not an earlier main build's cached bundle.
- name: Build the UI with the verified media
run: |
npm --prefix lilo-ui ci --ignore-scripts
make ui-build
Expand Down Expand Up @@ -189,3 +221,45 @@ jobs:
run: |
security delete-keychain "$RUNNER_TEMP/build.keychain" || true
rm -f "$RUNNER_TEMP/cert.p12"

deploy-site:
name: Deploy verified changelog website
needs: [release-media, build-and-sign]
if: github.repository == 'Alexays/Lilo'
environment: release
runs-on: ubuntu-latest
timeout-minutes: 15
steps:
- name: Check Cloudflare deployment is configured
env:
CLOUDFLARE_API_TOKEN: ${{ secrets.CLOUDFLARE_API_TOKEN }}
CLOUDFLARE_ACCOUNT_ID: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}
run: |
if [ -z "$CLOUDFLARE_API_TOKEN" ] || [ -z "$CLOUDFLARE_ACCOUNT_ID" ]; then
echo "::error::Alexays must add CLOUDFLARE_API_TOKEN and CLOUDFLARE_ACCOUNT_ID to the release environment. See docs/RELEASING.md#cloudflare-deployment-once. The GitHub release must remain a draft until this job succeeds."
exit 1
fi
- name: Checkout the release commit
uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
with:
ref: ${{ github.sha }}
persist-credentials: false
- name: Setup Node
uses: actions/setup-node@949feb2413d6458794dcd2491c4babbbce0c15c1 # v7.1.0
with:
node-version-file: 'site/.nvmrc'
- name: Download this run's verified website and media
uses: actions/download-artifact@018cc2cf5baa6db3ef3c5f8a56943fffe632ef53 # v6.0.0
with:
name: release-media-${{ github.sha }}
path: .
- name: Install pinned deployment dependencies
run: npm --prefix site ci --ignore-scripts
- name: Recheck and deploy the verified website without rebuilding
env:
CLOUDFLARE_API_TOKEN: ${{ secrets.CLOUDFLARE_API_TOKEN }}
CLOUDFLARE_ACCOUNT_ID: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}
run: |
make release-tag-check TAG="$GITHUB_REF_NAME"
make release-media-publish-check RELEASE="${GITHUB_REF_NAME#v}"
make site-deploy-verified
3 changes: 3 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -22,6 +22,9 @@ Vendor/

# Node / Svelte
node_modules/
.remotion/
lilo-ui/public/release-media/*
!lilo-ui/public/release-media/.gitkeep
site/.wrangler/
site/.astro/
site/dist/
Expand Down
Loading