wizz-method 2.22.0 → 2.23.0

package/src/skills-lib/wizz-video-styles/references/film-styles.md

@@ -0,0 +1,140 @@
+# Film styles: 59 looks drawn in code (lemo-opuscar)
+
+A second catalogue, next to the measured one. These are **art-directed film styles**, each a full prompt (`STYLE.md`) for a medium drawn entirely in code: ink wash, risograph, Swiss grid, dark keynote, pixel RPG, newsreel and 53 more. They come from [lemo-opuscar](https://github.com/lemomo-ai/lemo-opuscar) (commit `413a6bd6`, MIT, (c) 2026 LemoLab; licence in `../LICENSE-lemo-opuscar.txt`). The cards are copied verbatim into `film-styles/`, one file per style; their demo films stay upstream (CC BY 4.0) and are linked below.
+
+**Not measured.** Nothing here passed `scripts/analyze.sh`: these are looks, not reach data. The measured catalogue ([style-picker.md](style-picker.md)) still decides what a Reel should look like when the goal is reach; a film style is for when the piece wants a distinct visual medium (a launch film, a brand story, an explainer that should not look like every other explainer).
+
+## How to use one
+
+1. Pick a style from the index below by what the piece is for ("Good for") and by the material: most styles need nothing but a voice or a music track, the Evidence Films want real data or imagery.
+2. Read its card in `film-styles/<slug>.md` whole, then [film-styles/DIRECTOR.md](film-styles/DIRECTOR.md) for the directing method (benchmark first, one subject, one turn, hook in 3 s, one native move at the peak).
+3. Run the check-ins of [check-ins.md](check-ins.md): story, look (2 to 4 frames in the card's palette and type), storyboard.
+4. **Build in HyperFrames or Remotion, not with the card's engine.** Section 10 ("Engine") and every `demo/` or `core/` path in a card describe lemo-opuscar's own toolkit, which is not shipped here. Rebuild the look with HTML, CSS, SVG and GSAP (or Canvas/WebGL inside HyperFrames when the card's material really needs a shader). The three examples in `../assets/film-styles/` show how: risograph plates are layers with `mix-blend-mode: multiply` and halftone tints are a dotted CSS mask; the Swiss grid is DOM lines with the card's `cubic-bezier(.7,0,.2,1)`; the dark keynote UI kit is plain divs. The same risograph rebuilt as a Remotion component (frame-driven `interpolate`, steps by `Math.floor`, the kick with `Easing.elastic`) is in `../assets/film-styles/remotion/Riso.tsx`.
+5. **Recompose for 9:16 and the safe zone.** The cards are written for 1920×1080 with edge-to-edge material. In a Reel, keep every textured or typeset element inside the profile's safe zone (`safe_zones.*` in `wizz-video-effects`): the paper or stage colour can bleed, but halftone, grid notes, cards and type cannot. Run `check_safe_zone.py`, `measure_density.py` and `check_dead_frames.py` on the render.
+6. Hand over to `wizz-video-effects` as usual; the card's sound palette (section 7) replaces this skill's audio defaults.
+
+## What the test renders taught (2026-10-25)
+
+Three styles were rebuilt as 6 s vertical pieces in HyperFrames 0.8.198 (`swiss-motion`, `risograph`, `dark-keynote`), rendered with one worker and gated:
+
+- All three render with the current pipeline; no new engine was needed. The card's rules (one signal colour, overprint mixing, misregistration kick, one accent, grid snaps on the beat) translate directly to CSS and GSAP.
+- **The first renders all failed the organic safe zone**: Swiss notes at the top edge, the risograph halftone sky bleeding to the top, keynote cards down to the bottom. After recomposing inside y = 250..1570 all three passed safe zone, density and dead frames. Expect this on every card.
+- HyperFrames lint refuses `random()` in tweens and a CSS `transform` on an element GSAP moves; set initial offsets with `tl.set` at 0 and derive "random" values from the index.
+- **Remotion works too.** The risograph was ported to Remotion 4.0.527 (React 18, 24 fps, one worker): same frames as the HyperFrames render, same blend modes and masks, and it passed safe zone, density and dead frames. The Swiss and keynote pieces use only transforms and opacity and were not ported.
+- A held end card triggers the frozen-picture warning; in the keynote it is the point (the number holds), so read the warning, do not chase it.
+
+## Index
+
+### Cartoon & Anime
+
+| Style | Card | Good for | Demo film |
+|---|---|---|---|
+| 80s Cel Anime | [`cel-anime-80s`](film-styles/cel-anime-80s.md) | Music videos, Game trailers, Nostalgia | [City Lights, 1987](https://github.com/lemomo-ai/lemo-opuscar/tree/413a6bd6/styles/cel-anime-80s) |
+| Mid-century Cartoon | [`midcentury-toon`](film-styles/midcentury-toon.md) | Set-up guides, Help centres, How-to | [Meet Pip](https://github.com/lemomo-ai/lemo-opuscar/tree/413a6bd6/styles/midcentury-toon) |
+| 1930s Rubber Hose Cartoon | [`rubber-hose`](film-styles/rubber-hose.md) | Food & drink, Retro ads, Kids | [Coffee Cup Chase](https://github.com/lemomo-ai/lemo-opuscar/tree/413a6bd6/styles/rubber-hose) |
+| Sci-Fi Sitcom Toon | [`scifi-toon`](film-styles/scifi-toon.md) | Comedy, Tech brands, Social shorts | [Coffee Run](https://github.com/lemomo-ai/lemo-opuscar/tree/413a6bd6/styles/scifi-toon) |
+
+### Cinema & Eras
+
+| Style | Card | Good for | Demo film |
+|---|---|---|---|
+| Liminal Found Footage | [`backrooms`](film-styles/backrooms.md) | Horror, Mystery & ARG, Game teasers | [Night Shift Orientation](https://github.com/lemomo-ai/lemo-opuscar/tree/413a6bd6/styles/backrooms) |
+| 1920s Silent Film | [`silent-film`](film-styles/silent-film.md) | Comedy, Retro brands, Silent storytelling | [The Runaway Loaf](https://github.com/lemomo-ai/lemo-opuscar/tree/413a6bd6/styles/silent-film) |
+
+### East Asian Traditions
+
+| Style | Card | Good for | Demo film |
+|---|---|---|---|
+| Paper-cut Lightbox | [`paper-lantern`](film-styles/paper-lantern.md) | Festivals, Gift brands, Cultural stories | [A Mooncake's Longing](https://github.com/lemomo-ai/lemo-opuscar/tree/413a6bd6/styles/paper-lantern) |
+| Red Paper-cut | [`papercut-red`](film-styles/papercut-red.md) | Lunar New Year, Festive greetings, Folk tales | [Nian Comes to Town](https://github.com/lemomo-ai/lemo-opuscar/tree/413a6bd6/styles/papercut-red) |
+| Shadow Puppetry | [`shadow-puppet`](film-styles/shadow-puppet.md) | Myths & folklore, Heritage, Festivals | [Hou Yi Shoots the Suns](https://github.com/lemomo-ai/lemo-opuscar/tree/413a6bd6/styles/shadow-puppet) |
+| Ukiyo-e | [`ukiyoe`](film-styles/ukiyoe.md) | Travel, Japanese culture, Poetry | [Toward the Mountain](https://github.com/lemomo-ai/lemo-opuscar/tree/413a6bd6/styles/ukiyoe) |
+
+### Edit & Documentary
+
+| Style | Card | Good for | Demo film |
+|---|---|---|---|
+| Caption News | [`caption-news`](film-styles/caption-news.md) | Social news, Report explainers, Data shorts | [The Bee Ledger](https://github.com/lemomo-ai/lemo-opuscar/tree/413a6bd6/styles/caption-news) |
+| Time-lapse Symphony | [`city-symphony`](film-styles/city-symphony.md) | City films, Music montages, Openers | [One Day in New York](https://github.com/lemomo-ai/lemo-opuscar/tree/413a6bd6/styles/city-symphony) |
+| Live Countdown Split-screen | [`countdown`](film-styles/countdown.md) | Launches, Countdowns, Live events | [Counting Itself Down](https://github.com/lemomo-ai/lemo-opuscar/tree/413a6bd6/styles/countdown) |
+| Constructivist Montage | [`kino-montage`](film-styles/kino-montage.md) | Industry histories, Milestones, Collective effort | [410 Days](https://github.com/lemomo-ai/lemo-opuscar/tree/413a6bd6/styles/kino-montage) |
+| Broadcast News Package | [`news-package`](film-styles/news-package.md) | News round-ups, Bulletins, Market updates | [The Week in AI](https://github.com/lemomo-ai/lemo-opuscar/tree/413a6bd6/styles/news-package) |
+| 1920s Newsreel | [`newsreel`](film-styles/newsreel.md) | History stories, Fads & eras, Anniversaries | [Knock-Knee Alert](https://github.com/lemomo-ai/lemo-opuscar/tree/413a6bd6/styles/newsreel) |
+| Sports Telestrator | [`telestrator`](film-styles/telestrator.md) | Sports analysis, Match recaps, Coaching | [Freeze Frame](https://github.com/lemomo-ai/lemo-opuscar/tree/413a6bd6/styles/telestrator) |
+| Visual Investigation | [`visual-investigation`](film-styles/visual-investigation.md) | Reconstructions, Fact-checks, Incident reports | [The Hindenburg: Four Minutes, 32 Seconds](https://github.com/lemomo-ai/lemo-opuscar/tree/413a6bd6/styles/visual-investigation) |
+
+### Evidence Films
+
+| Style | Card | Good for | Demo film |
+|---|---|---|---|
+| Archive Light Table | [`archive-lighttable`](film-styles/archive-lighttable.md) | Brand history, Archive stories, Museums | [Two Seconds Short](https://github.com/lemomo-ai/lemo-opuscar/tree/413a6bd6/styles/archive-lighttable) |
+| Engineering Briefing Board | [`briefing-board`](film-styles/briefing-board.md) | Engineering, Option comparisons, Briefings | [The Ship Decides](https://github.com/lemomo-ai/lemo-opuscar/tree/413a6bd6/styles/briefing-board) |
+| Data Physicalization | [`data-physical`](film-styles/data-physical.md) | Annual reports, Investor decks, Energy data | [Two Spirals](https://github.com/lemomo-ai/lemo-opuscar/tree/413a6bd6/styles/data-physical) |
+| LiDAR Survey | [`lidar-survey`](film-styles/lidar-survey.md) | Heritage, Environment, Site surveys | [The Fields Under the Forest](https://github.com/lemomo-ai/lemo-opuscar/tree/413a6bd6/styles/lidar-survey) |
+| Microscope Story | [`microscope`](film-styles/microscope.md) | Biomedicine, Materials science, Skincare science | [Measured Blue](https://github.com/lemomo-ai/lemo-opuscar/tree/413a6bd6/styles/microscope) |
+| Satellite Briefing | [`satellite-briefing`](film-styles/satellite-briefing.md) | Climate, News explainers, Geography | [The Map Still Says Sea](https://github.com/lemomo-ai/lemo-opuscar/tree/413a6bd6/styles/satellite-briefing) |
+| Exploded Teardown | [`teardown`](film-styles/teardown.md) | Hardware launches, Product pages, Spec explainers | [21 Keys, Opened](https://github.com/lemomo-ai/lemo-opuscar/tree/413a6bd6/styles/teardown) |
+| Projection on White Model | [`white-model`](film-styles/white-model.md) | Urban planning, Exhibitions, City data | [How a Flattened City Grew Back](https://github.com/lemomo-ai/lemo-opuscar/tree/413a6bd6/styles/white-model) |
+
+### Games
+
+| Style | Card | Good for | Demo film |
+|---|---|---|---|
+| Game Show Flat | [`game-show`](film-styles/game-show.md) | Tech timelines, Year in review, Variety shows | [Rhythm of AI, 1997 → 2026](https://github.com/lemomo-ai/lemo-opuscar/tree/413a6bd6/styles/game-show) |
+| HD-2D | [`hd-2d`](film-styles/hd-2d.md) | Game trailers, Fantasy, Story films | [The Lampbearer](https://github.com/lemomo-ai/lemo-opuscar/tree/413a6bd6/styles/hd-2d) |
+| Microgame Frenzy | [`microgame`](film-styles/microgame.md) | Game trailers, Onboarding, Social shorts | [Five-Second Astronaut](https://github.com/lemomo-ai/lemo-opuscar/tree/413a6bd6/styles/microgame) |
+| 16-bit Pixel RPG | [`pixel-rpg`](film-styles/pixel-rpg.md) | Game trailers, Recaps, Nostalgia | [The Last Save Point](https://github.com/lemomo-ai/lemo-opuscar/tree/413a6bd6/styles/pixel-rpg) |
+
+### Graphic & Type
+
+| Style | Card | Good for | Demo film |
+|---|---|---|---|
+| Art Deco | [`art-deco`](film-styles/art-deco.md) | Luxury & hospitality, Galas, Invitations | [Midnight at the Starlight Hotel](https://github.com/lemomo-ai/lemo-opuscar/tree/413a6bd6/styles/art-deco) |
+| ASCII / CRT Terminal | [`ascii-crt`](film-styles/ascii-crt.md) | Developer tools, Sci-fi, Tech brands | [Tranquility.log](https://github.com/lemomo-ai/lemo-opuscar/tree/413a6bd6/styles/ascii-crt) |
+| Blueprint | [`blueprint`](film-styles/blueprint.md) | Engineering, Hardware launches, Tech explainers | [Patent Pending: The Cloud Catcher](https://github.com/lemomo-ai/lemo-opuscar/tree/413a6bd6/styles/blueprint) |
+| Pictogram Motion | [`pictogram-motion`](film-styles/pictogram-motion.md) | Sports events, Visual identity, Event openers | [Aichi-Nagoya 2026 — All 43 Sports](https://github.com/lemomo-ai/lemo-opuscar/tree/413a6bd6/styles/pictogram-motion) |
+| 60s Spy Title Sequence | [`spy-titles`](film-styles/spy-titles.md) | Title sequences, Event openers, Trailers | [The Velvet Cipher](https://github.com/lemomo-ai/lemo-opuscar/tree/413a6bd6/styles/spy-titles) |
+| Stained Glass | [`stained-glass`](film-styles/stained-glass.md) | Legends, Heritage, Holiday stories | [The Dragon of the East Window](https://github.com/lemomo-ai/lemo-opuscar/tree/413a6bd6/styles/stained-glass) |
+| Swiss Motion Graphics | [`swiss-motion`](film-styles/swiss-motion.md) | Brand identity, Events, Design education | [Five Rules for a Poster](https://github.com/lemomo-ai/lemo-opuscar/tree/413a6bd6/styles/swiss-motion) |
+
+### Hand-drawn & Painting
+
+| Style | Card | Good for | Demo film |
+|---|---|---|---|
+| Crayon Picture Book | [`crayon-book`](film-styles/crayon-book.md) | Picture books, Bedtime stories, Kids' learning | [The Moon Can't Sleep](https://github.com/lemomo-ai/lemo-opuscar/tree/413a6bd6/styles/crayon-book) |
+| Impasto Oil Painting | [`impasto`](film-styles/impasto.md) | Music videos, Art & culture, Emotional ads | [The Colour of Rain](https://github.com/lemomo-ai/lemo-opuscar/tree/413a6bd6/styles/impasto) |
+| Chinese Ink Wash | [`ink-wash`](film-styles/ink-wash.md) | Wuxia, Cultural brands, Poetry | [The Swordsman and the River](https://github.com/lemomo-ai/lemo-opuscar/tree/413a6bd6/styles/ink-wash) |
+| One-line Drawing | [`one-line`](film-styles/one-line.md) | Brand stories, Life milestones, Minimal ads | [The Line That Never Lifted](https://github.com/lemomo-ai/lemo-opuscar/tree/413a6bd6/styles/one-line) |
+| Urban Sketch · Pen & Wash | [`urban-sketch`](film-styles/urban-sketch.md) | City & travel, Architecture, Lifestyle brands | [Where the Wind Went](https://github.com/lemomo-ai/lemo-opuscar/tree/413a6bd6/styles/urban-sketch) |
+| Watercolor Brush | [`watercolor`](film-styles/watercolor.md) | Nature documentary, Travel, Science explainers | [Follow the Rain](https://github.com/lemomo-ai/lemo-opuscar/tree/413a6bd6/styles/watercolor) |
+| Whiteboard Explainer | [`whiteboard`](film-styles/whiteboard.md) | Explainers, Online courses, Science | [Einstein in Your Pocket](https://github.com/lemomo-ai/lemo-opuscar/tree/413a6bd6/styles/whiteboard) |
+
+### Information & Keynote
+
+| Style | Card | Good for | Demo film |
+|---|---|---|---|
+| Dark Tech Keynote | [`dark-keynote`](film-styles/dark-keynote.md) | Product launches, SaaS, Keynotes | [Room to Think](https://github.com/lemomo-ai/lemo-opuscar/tree/413a6bd6/styles/dark-keynote) |
+| Data Storytelling | [`dataviz`](film-styles/dataviz.md) | Data journalism, Reports, Climate & science | [A Hundred Summers](https://github.com/lemomo-ai/lemo-opuscar/tree/413a6bd6/styles/dataviz) |
+| Sci-fi Hologram HUD | [`hologram-hud`](film-styles/hologram-hud.md) | Spec walkthroughs, Launch videos, Trade shows | [Volt · Spec Scan](https://github.com/lemomo-ai/lemo-opuscar/tree/413a6bd6/styles/hologram-hud) |
+| Isometric Infographic | [`iso-infographic`](film-styles/iso-infographic.md) | Process explainers, Supply chains, Annual reports | [From Bean to Cup](https://github.com/lemomo-ai/lemo-opuscar/tree/413a6bd6/styles/iso-infographic) |
+| Living Screencast | [`living-screencast`](film-styles/living-screencast.md) | Product tutorials, Feature launches, Onboarding | [Clawd Moves In](https://github.com/lemomo-ai/lemo-opuscar/tree/413a6bd6/styles/living-screencast) |
+
+### Materials & 3D
+
+| Style | Card | Good for | Demo film |
+|---|---|---|---|
+| Brick Toy | [`brick-toy`](film-styles/brick-toy.md) | Toys & kids, Product builds, Space | [Rocket from Spare Parts](https://github.com/lemomo-ai/lemo-opuscar/tree/413a6bd6/styles/brick-toy) |
+| Glass Product Render | [`glass-product`](film-styles/glass-product.md) | Product launches, Consumer tech, Beauty | [Aura — Hear the Light](https://github.com/lemomo-ai/lemo-opuscar/tree/413a6bd6/styles/glass-product) |
+| Low-poly Isometric Island | [`lowpoly-island`](film-styles/lowpoly-island.md) | Game trailers, World building, Calm content | [The Island That Grew](https://github.com/lemomo-ai/lemo-opuscar/tree/413a6bd6/styles/lowpoly-island) |
+| Paper Pop-up Book | [`paper-popup`](film-styles/paper-popup.md) | Children's books, Game trailers, Story films | [Pip's Paper Adventure](https://github.com/lemomo-ai/lemo-opuscar/tree/413a6bd6/styles/paper-popup) |
+| Tilt-Shift Miniature | [`tilt-shift`](film-styles/tilt-shift.md) | City promos, Real estate, Transport | [Toy Town Rush Hour](https://github.com/lemomo-ai/lemo-opuscar/tree/413a6bd6/styles/tilt-shift) |
+
+### Print & Printmaking
+
+| Style | Card | Good for | Demo film |
+|---|---|---|---|
+| Copperplate Engraving | [`engraving`](film-styles/engraving.md) | Museum labels, Science explainers, Brand heritage | [The Honeybee, Plate VII](https://github.com/lemomo-ai/lemo-opuscar/tree/413a6bd6/styles/engraving) |
+| Halftone Dossier | [`halftone-dossier`](film-styles/halftone-dossier.md) | Humour, Pet content, Social shorts | [Case File: Chubby](https://github.com/lemomo-ai/lemo-opuscar/tree/413a6bd6/styles/halftone-dossier) |
+| Risograph Print | [`risograph`](film-styles/risograph.md) | Indie brands, Zines, Lifestyle | [Sunday Ride](https://github.com/lemomo-ai/lemo-opuscar/tree/413a6bd6/styles/risograph) |
+| Silkscreen Travel Poster | [`silkscreen-poster`](film-styles/silkscreen-poster.md) | Destination guides, Tourism, Event posters | [Three Trails](https://github.com/lemomo-ai/lemo-opuscar/tree/413a6bd6/styles/silkscreen-poster) |
+| Woodcut Print | [`woodcut`](film-styles/woodcut.md) | Folk tales, Craft brands, Book trailers | [The Bell Founder](https://github.com/lemomo-ai/lemo-opuscar/tree/413a6bd6/styles/woodcut) |

package/src/skills-lib/wizz-video-styles/references/insert-recipes.md

@@ -0,0 +1,33 @@
+# Insert recipes: b-roll treatments that sit inside a style
+
+An insert is a short silent clip under the narration, cut into a style that already exists (talking head, motion editorial, explainer). It is not a style: it never carries a whole piece, and it does not enter `data/recipes.json` or the style picker. **Nothing on this page was measured**; the recipes come from open-source projects and are written here so they run without a paid API.
+
+## Collage b-roll (paper cutout, halftone)
+
+Source: idea from [gbro-collage-broll](https://github.com/pyang5166/gbro-collage-broll) (MIT), which generates the clip with Gemini. Here it is drawn in code (HyperFrames), so no key is needed.
+
+**When it fits:** one abstract sentence of the script that has no footage ("money leaks every month", "the algorithm decides") in a talking head or a motion editorial. One or two per piece; more and the piece turns into a collage film.
+
+**Output:** 9:16, about 5 s, 24 fps, silent (the narration and the style's music carry the sound).
+
+**Look**
+
+- One flat, saturated paper background per insert (deep purple, mustard, red, teal), with a faint paper grain.
+- Photo cutouts in black and white halftone, with a rough white cut edge and a small hard shadow; one or two cardstock accents in a second colour (arrow, circle, torn strip).
+- Three to five elements at most, each a literal object of the metaphor.
+
+**Motion**
+
+- The frame starts **empty** (only the paper). Elements arrive one at a time, slide in from the edge and land in place, in the order the sentence says them.
+- Stop-motion feel: hold each pose for 2 frames (12 fps steps at 24 fps) and give each landing a 1 to 2 degree settle. Never a fade or a slow zoom on a finished collage.
+- The last element lands about 1 s before the end; hold the finished collage.
+
+**Three gates (keep them; only the generator changes)**
+
+1. **Metaphor:** for each sentence, write the core meaning, the 3 to 5 objects, the background colour and the order of arrival. Show it before drawing anything; only approved sentences move on.
+2. **Still:** render the finished last frame plus a contact sheet. Approve the composition before animating.
+3. **Clip:** animate, then check frames once per second: the first frame is empty paper, the last frame matches the approved still.
+
+**Material:** cutouts come from real photos (the project's own, or licensed via `get-brolls`), turned into halftone in code (an SVG/CSS halftone filter or ffmpeg). No generated faces of real people.
+
+**Do not:** collage over the whole piece, more than one background colour inside an insert, moving the camera over the collage, or an insert that does not illustrate a specific sentence.

package/src/skills-lib/wizz-video-styles/scripts/beat_grid.py

@@ -1,14 +1,18 @@
 """Beat grid of a song: tempo, beats and downbeats, so scene cuts can snap to the music.
 
-Usage: python3 beat_grid.py <audio_file> [--meter 4] [--fps 30] > grid.json
+Usage: python3 beat_grid.py <audio_file> [--meter 4] [--fps 30] [--hits 3] > grid.json
 
 Prints JSON: {"bpm", "meter", "duration_s", "beats": [s...], "downbeats": [s...],
-"downbeat_frames": [frame...]}. Needs librosa + numpy (same Python as analyze.sh;
+"downbeat_frames": [frame...], "hits": [{"t", "frame"}...], "drops": [{"t", "frame"}...]}.
+`hits` are the loudest beats (in time order): the payoff lands on the loudest one.
+`drops` are downbeats where the next bar is clearly louder than the previous one. Needs librosa + numpy (same Python as analyze.sh;
 set VIDEO_STYLES_PY and call it with that interpreter).
 
 Downbeats are estimated, not detected: of the `meter` possible phases, the one
 whose beats carry the most low-frequency onset energy is taken as beat 1. Check
 two or three of them by ear before cutting a whole film on the grid.
+librosa trims weak beats at the start and end, so a very quiet intro can fall
+outside the grid (and a drop out of it goes unreported).
 """
 
 import argparse
@@ -20,6 +24,8 @@ import numpy as np
 
 HOP = 512
 LOW_HZ = 150
+# A downbeat is a drop when the bar after it is this many times louder (RMS) than the bar before.
+DROP_RATIO = 1.6
 
 
 def downbeat_phase(y_perc, sr, beat_frames, meter):
@@ -31,7 +37,27 @@ def downbeat_phase(y_perc, sr, beat_frames, meter):
     return int(np.argmax(scores))
 
 
-def beat_grid(path, meter, fps):
+def loud_hits(rms, beat_frames, count):
+    at_beats = rms[np.minimum(beat_frames, len(rms) - 1)]
+    loudest = np.argsort(at_beats)[::-1][:count]
+    return sorted(int(i) for i in loudest)
+
+
+def drop_indexes(rms, downbeat_frames):
+    drops = []
+    for i in range(1, len(downbeat_frames) - 1):
+        before = rms[downbeat_frames[i - 1]:downbeat_frames[i]].mean()
+        after = rms[downbeat_frames[i]:downbeat_frames[i + 1]].mean()
+        if before > 0 and after / before >= DROP_RATIO:
+            drops.append(i)
+    return drops
+
+
+def marks(times, fps):
+    return [{"t": round(float(t), 3), "frame": int(round(t * fps))} for t in times]
+
+
+def beat_grid(path, meter, fps, hits=3):
     y, sr = librosa.load(path, sr=22050, mono=True)
     _, y_perc = librosa.effects.hpss(y)
     _, beat_frames = librosa.beat.beat_track(y=y_perc, sr=sr, hop_length=HOP)
@@ -40,6 +66,9 @@ def beat_grid(path, meter, fps):
     beats = librosa.frames_to_time(beat_frames, sr=sr, hop_length=HOP)
     phase = downbeat_phase(y_perc, sr, beat_frames, meter)
     downbeats = beats[phase::meter]
+    rms = librosa.feature.rms(y=y, hop_length=HOP)[0]
+    hit_times = beats[loud_hits(rms, beat_frames, hits)]
+    drop_times = downbeats[drop_indexes(rms, beat_frames[phase::meter])]
     return {
         # librosa's tempo and single beat intervals are quantised to the hop; the slope of a
         # line fitted through every beat time averages that out.
@@ -49,6 +78,8 @@ def beat_grid(path, meter, fps):
         "beats": [round(float(t), 3) for t in beats],
         "downbeats": [round(float(t), 3) for t in downbeats],
         "downbeat_frames": [int(round(t * fps)) for t in downbeats],
+        "hits": marks(hit_times, fps),
+        "drops": marks(drop_times, fps),
     }
 
 
@@ -57,10 +88,11 @@ def main():
     parser.add_argument("audio")
     parser.add_argument("--meter", type=int, default=4)
     parser.add_argument("--fps", type=int, default=30)
+    parser.add_argument("--hits", type=int, default=3)
     args = parser.parse_args()
-    if args.meter < 2 or args.fps < 1:
-        sys.exit("--meter must be >= 2 and --fps >= 1")
-    json.dump(beat_grid(args.audio, args.meter, args.fps), sys.stdout, indent=1)
+    if args.meter < 2 or args.fps < 1 or args.hits < 1:
+        sys.exit("--meter must be >= 2, --fps >= 1 and --hits >= 1")
+    json.dump(beat_grid(args.audio, args.meter, args.fps, args.hits), sys.stdout, indent=1)
     print()
 
 

package/src/skills-lib/wizz-vsl/SKILL.md

@@ -12,7 +12,7 @@ Everything delivered to the user is in `{communication_language}` (Brazilian Por
 ## Step 0 · Inputs and the ruler in effect
 
 1. **Resume first.** Look for `{output_folder}/vsl/<slug>/manifest.json`. If it exists, read it and `00-briefing.md`, say in one line where the work stopped, and resume from the first pending phase. Never re-interview someone who already answered.
-2. **Reuse what the method already produced.** An approved offer from the `wizz-offer-forge` skill (`{output_folder}/offers/OFFER-*.md`) is the source for the offer block and for the solution mechanism: record it in the manifest instead of re-deriving it. Audience research from the `wizz-pesquisa-de-publico-do-piva` skill (`{output_folder}/pesquisa-piva/`) is the source for blocks 2, 3, 8 and 10 of the interview: VoC, awareness levels, lexicon and angles come from there, quoted with file and section. When there is no approved offer, say so and invoke the `wizz-offer-forge` skill before Phase 4; when there is no audience research and the expert has no material, offer to invoke the `wizz-pesquisa-de-publico-do-piva` skill first.
+2. **Reuse what the method already produced.** An approved offer from the `wizz-offer-forge` skill (`{output_folder}/offers/OFFER-*.md`) is the source for the offer block and for the solution mechanism: record it in the manifest instead of re-deriving it. Audience research from the `wizz-pesquisa-de-publico` skill (`{output_folder}/pesquisa-de-publico/`) is the source for blocks 2, 3, 8 and 10 of the interview: VoC, awareness levels, lexicon and angles come from there, quoted with file and section. When there is no approved offer, say so and invoke the `wizz-offer-forge` skill before Phase 4; when there is no audience research and the expert has no material, offer to invoke the `wizz-pesquisa-de-publico` skill first.
 3. **Low ticket ruler.** The low ticket base applies only when BOTH are true: the `wizz-lowticket-metodologia` skill is installed in this project, AND the project context or the request itself establishes that the operation is low ticket (price range, cheap product, direct traffic). Do not presume low ticket because the product is a course or there is a campaign running. When both hold, before Phase 2, read its `knowledge/INDEX.md`, then `knowledge/13-benchmarks-vsl.md` and the VSL entries the INDEX names (`04b` §4.7 and §4.7-A, `18` §18.8). That ruler sets the length, the pitch position and the number of leads to test; where it contradicts this skill (the 16 to 20 minute default below), **the ruler wins**, and say so in the reply. In practice: a product that proves itself on screen stays at 90 s to 2 min, an offer that needs to build mechanism and authority goes to 7 to 9 min, below R$60 the ceiling is 7 to 8 min, the pitch enters at about two thirds of the video, and 3 to 8 leads get tested.
 
 ## The six phases

package/src/skills-lib/wizz-vsl/references/assembly-qa.md

@@ -39,7 +39,7 @@ At the seams, check the **transitions**: each block ends pulling the next. Cut a
 > **Diagnóstico:** consciência N / sofisticação M
 > **GUARDRAIL (LEI):** <proibições do Bloco 9>
 > **Voz:** <resumo do Bloco 10>
-> **Fontes:** `00-briefing.md`, <oferta aprovada>, <pesquisa do Piva>
+> **Fontes:** `00-briefing.md`, <oferta aprovada>, <pesquisa de público>
 ```
 
 ## Claims ledger

package/src/skills-lib/wizz-vsl/references/blocks-and-leads.md

@@ -99,7 +99,7 @@ From Block 10, in every block:
 | **Talking screenshot** | Opens with the real result on screen, no context | Curiosity and proof in one move |
 | **The wrong ruler** | "Você teve resultado. Só mediu na régua errada." | Counterintuitive: reopens a market that gave up |
 
-Copying a winning structure word for word produces echo ads the market already discounted. When the user wants hook raw material, the 7 Blueprint types the method already uses (wizz-social) and the angle matrix of the Piva research are the bank; numbers in a hook come from the briefing, never invented.
+Copying a winning structure word for word produces echo ads the market already discounted. When the user wants hook raw material, the 7 Blueprint types the method already uses (wizz-social) and the angle matrix of the audience research are the bank; numbers in a hook come from the briefing, never invented.
 
 ### Output · one file per lead
 

package/src/skills-lib/wizz-vsl/references/diagnosis.md

@@ -1,6 +1,6 @@
 # Phase 2 · Market diagnosis (Schwartz)
 
-> Three questions, in this order, **before** any mechanism or lead. Getting this wrong means a technically correct VSL that speaks to a market that does not exist. When the Piva research exists, its awareness-levels report is the first evidence: quote it.
+> Three questions, in this order, **before** any mechanism or lead. Getting this wrong means a technically correct VSL that speaks to a market that does not exist. When the audience research exists, its awareness-levels report is the first evidence: quote it.
 
 ## 1. What is the mass desire?
 
@@ -69,7 +69,7 @@ Sophistication measures **how many promises the market already heard**, not how
 - Descartados: <outros candidatos e por que perderam>
 
 ## Nível de consciência: <1-5>
-**Evidência:** <citação literal do briefing, da call ou da pesquisa do Piva>
+**Evidência:** <citação literal do briefing, da call ou da pesquisa de público>
 **Implicação para a lead:** …
 
 ## Estágio de sofisticação: <1-5>

package/src/skills-lib/wizz-vsl/references/intake.md

@@ -8,12 +8,12 @@ Before the first question, ask only this (in the user's language):
 
 > "Antes de te entrevistar: você já tem material sobre esse expert ou essa oferta? Transcrição de call, questionário preenchido, página de vendas antiga, VSL anterior, aulas gravadas, site, Instagram, documento de oferta? Me passa os caminhos ou os links que eu leio antes."
 
-Also check what the method already produced: an approved offer from `wizz-offer-forge` and the audience research from `wizz-pesquisa-de-publico-do-piva` (paths in SKILL.md, Step 0). They pre-fill whole blocks.
+Also check what the method already produced: an approved offer from `wizz-offer-forge` and the audience research from `wizz-pesquisa-de-publico` (paths in SKILL.md, Step 0). They pre-fill whole blocks.
 
 When there is material:
 
 1. **Read all of it.** A call transcript is the richest source there is: the expert talking loosely about their own method beats any rushed questionnaire.
-2. **Pre-fill the briefing, marking the source of each answer:** `(call 01:07:22)`, `(questionario.md §12.1)`, `(OFFER-x.md §mecanismo)`, `(pesquisa-piva/voc.md)`.
+2. **Pre-fill the briefing, marking the source of each answer:** `(call 01:07:22)`, `(questionario.md §12.1)`, `(OFFER-x.md §mecanismo)`, `(pesquisa-de-publico/voc.md)`.
 3. **Then interview only the gaps.** Nothing degrades a briefing faster than asking what the person already answered.
 4. **Return what you extracted before asking:** "do material eu já tirei X, Y e Z; me confirma e responde só o que falta".
 
@@ -62,7 +62,7 @@ Without material, start at Block 1.
 
 ## Block 2 · Audience `[MANDATORY]`
 
-*Pre-filled by the Piva research when it exists (VoC, psychographic profile, lexicon).*
+*Pre-filled by the audience research when it exists (VoC, psychographic profile, lexicon).*
 
 1. Who buys this? The real person: age, occupation, life moment, income.
 2. Who **pays you the most** today (real profile, not the desired one)?
@@ -121,7 +121,7 @@ Without material, start at Block 1.
 
 ## Block 8 · Market `[MANDATORY]`
 
-*This defines the sophistication stage in Phase 2. Pre-filled by the Piva trend report and angle matrix when they exist.*
+*This defines the sophistication stage in Phase 2. Pre-filled by the audience research trend report and angle matrix when they exist.*
 
 1. Competitors and references: what do they promise?
 2. What is **everyone** in your market saying right now? The standard promise?
@@ -175,7 +175,7 @@ A gap in a mandatory block does not stop the work, but it must not stay silent:
 ```markdown
 # Briefing · <expert> / <produto>
 
-> Fontes: <arquivos lidos, oferta aprovada, pesquisa do Piva>. Entrevista em <data>.
+> Fontes: <arquivos lidos, oferta aprovada, pesquisa de público>. Entrevista em <data>.
 > Toda resposta traz a fonte entre parênteses. `[LACUNA]` = não respondido.
 
 ## 1. Produto e oferta

package/src/skills-lib/wizz-web-security/SKILL.md

@@ -32,6 +32,8 @@ The ones that show up most in an audit, with the direct fix. Use as a quick tria
 
 > The first four (SQLi, IDOR, mass assignment, and permissive RLS) are **stop-the-line**: if it shows up, fix it before anything else.
 >
+> Free trial abuse (the same person opening trial after trial) is not fixed by blocking the IP: NAT puts a whole house or office behind one address. Use the risk score in the `wizz-signup-flow-cro` skill (trial abuse).
+>
 > For a full adversarial audit (hunting with exploit proof + a prioritized plan), use the `wizz-security-audit-pentest` skill. This skill here is for **fixing** a specific finding from the table.
 
 ## References (load on demand)

package/tools/installer/guided/labels.js

@@ -79,6 +79,7 @@ const NEED_LABELS = {
   docker: { en: 'Docker', pt: 'Docker' },
   python: { en: 'Python', pt: 'Python' },
   ffmpeg: { en: 'ffmpeg', pt: 'ffmpeg' },
+  chrome: { en: 'Chrome', pt: 'Chrome' },
   heavy: { en: 'heavy download', pt: 'download pesado' },
 };
 
@@ -123,6 +124,16 @@ const CLI_LABELS = {
     en: 'review native iOS/macOS UI against Apple HIG',
     pt: 'revisar UI nativa iOS/macOS pelo guia da Apple',
   },
+  'claude-animation-base': {
+    needs: ['ffmpeg', 'chrome'],
+    en: 'hand-painted cartoon with Clawd, the Claude character',
+    pt: 'desenho animado pintado à mão com o Clawd, do Claude',
+  },
+  onetake: {
+    needs: ['ffmpeg', 'python'],
+    en: 'one-take product film (personal use free; commercial needs Pro)',
+    pt: 'filme de produto em plano-sequência (pessoal grátis; comercial é Pro)',
+  },
   distribb: {
     needs: ['account', 'paid'],
     en: 'publish SEO articles and build backlinks',
@@ -143,6 +154,11 @@ const CLI_LABELS = {
     en: 'draw validated architecture diagrams',
     pt: 'desenhar diagramas de arquitetura validados',
   },
+  xtool: {
+    needs: [],
+    en: 'build and install an iOS app on the iPhone without Xcode',
+    pt: 'compilar e instalar app iOS no iPhone sem o Xcode',
+  },
   'agent-browser': {
     needs: [],
     en: 'drive a real browser for checks and screenshots',

package/tools/installer/install-text.js

@@ -64,6 +64,7 @@ const MESSAGES = {
     mcpPluginSkipped: 'MCPs already covered by a Claude Code plugin (user scope), skipped: {list}',
     mcpQuestion: 'Which MCPs should go into .mcp.json? (unticked ones become a command to run later)',
     unknownClis: 'Unknown or already installed CLIs ignored: {list}',
+    cliNotice: 'Before choosing {id}: {notice}',
     cliQuestion: 'Which CLIs should be installed now? (unticked ones become a command to run later)',
     traceQuestion: 'Turn on the routing meter? (local, writes only to ~/.claude/wizz-trace.jsonl on your machine, never leaves it)',
     quickUpdateNoSkills:
@@ -123,6 +124,7 @@ const MESSAGES = {
     mcpPluginSkipped: 'MCPs já cobertos por plugin do Claude Code (user scope), pulados: {list}',
     mcpQuestion: 'Quais MCPs configurar no .mcp.json? (não marcados viram comando pra rodar depois)',
     unknownClis: 'CLIs desconhecidos/já instalados ignorados: {list}',
+    cliNotice: 'Antes de escolher {id}: {notice}',
     cliQuestion: 'Quais CLIs instalar agora? (não marcados viram comando pra rodar depois)',
     traceQuestion: 'Quer ligar o medidor de roteamento? (local, grava só em ~/.claude/wizz-trace.jsonl na sua máquina, nunca sai daqui)',
     quickUpdateNoSkills:

package/tools/installer/modules/cli-config.js

@@ -109,6 +109,9 @@ function resolveClis(registry, selectedAreas, platformTag = currentPlatformTag()
       // opt-in multiselect (e.g. rtk — the router assumes it active). Coerced
       // to a real boolean so a missing field is `false`, never undefined.
       recommended: !!cli.recommended,
+      // notice (2026-10-25): license/cost warning the UI shows before the
+      // choice. Coerced to '' so callers test truthiness, never undefined.
+      notice: cli.notice || '',
     }),
   });
 }

package/tools/installer/ui.js

@@ -783,6 +783,12 @@ class UI {
     const missing = detected.filter((c) => !c.installed);
     if (missing.length === 0) return { toInstall: [], toRecommend: [], alreadyInstalled };
 
+    // Registry `notice` (license or cost) is shown before any path decides,
+    // so --clis, --yes and the multiselect all see it before the choice.
+    for (const c of missing.filter((m) => m.notice)) {
+      await prompts.log.warn(it('cliNotice', { id: c.id, notice: c.notice }));
+    }
+
     const byId = new Map(missing.map((c) => [c.id, c]));
     const split = (installIds) => {
       const installSet = new Set(installIds);