wizz-method 2.21.0 → 2.22.0

package/src/skills-lib/wizz-premium-landing-ui-researcher/scripts/tests/test_design_sources.py

@@ -0,0 +1,130 @@
+# /// script
+# requires-python = ">=3.10"
+# dependencies = ["pytest>=8.0", "ruamel.yaml>=0.18"]
+# ///
+"""Tests for design_sources.py: list by need tag, cache freshness, refresh."""
+
+import datetime as dt
+import importlib.util
+import json
+import os
+import subprocess
+from pathlib import Path
+
+import pytest
+
+SCRIPT = Path(__file__).resolve().parents[1] / "design_sources.py"
+REAL_CATALOGUE = Path(__file__).resolve().parents[2] / "references" / "design-sources.yaml"
+
+spec = importlib.util.spec_from_file_location("design_sources", SCRIPT)
+mod = importlib.util.module_from_spec(spec)
+spec.loader.exec_module(mod)
+
+GIT_ENV = {
+    **os.environ,
+    "GIT_AUTHOR_NAME": "t",
+    "GIT_AUTHOR_EMAIL": "t@t",
+    "GIT_COMMITTER_NAME": "t",
+    "GIT_COMMITTER_EMAIL": "t@t",
+}
+
+
+def run_main(capsys, *argv):
+    with pytest.raises(SystemExit) as exit_info:
+        mod.main(list(argv))
+    return exit_info.value.code, json.loads(capsys.readouterr().out)
+
+
+def git(cwd, *args):
+    subprocess.run(["git", "-C", str(cwd), *args], check=True, capture_output=True, env=GIT_ENV)
+
+
+def make_clone(tmp_path, name):
+    upstream = tmp_path / f"{name}-upstream"
+    upstream.mkdir()
+    git(upstream, "init", "-q", "-b", "main")
+    (upstream / "a.txt").write_text("1", encoding="utf-8")
+    git(upstream, "add", "a.txt")
+    git(upstream, "commit", "-q", "-m", "one")
+    root = tmp_path / "cache"
+    root.mkdir(exist_ok=True)
+    subprocess.run(["git", "clone", "-q", str(upstream), str(root / name)], check=True, capture_output=True, env=GIT_ENV)
+    return upstream, root
+
+
+def write_catalogue(tmp_path, cache_name):
+    path = tmp_path / "sources.yaml"
+    path.write_text(
+        "version: 1\nmax_cache_age_days: 30\nsources:\n"
+        f"  - {{ id: demo, kind: registry, access: free, cache: {cache_name}, need_tags: [hover] }}\n"
+        "  - { id: paid, kind: code, access: paid, need_tags: [hover, card] }\n"
+        "  - { id: study, kind: visual, access: free, study_only: true, need_tags: [shader] }\n",
+        encoding="utf-8",
+    )
+    return path
+
+
+def test_real_catalogue_parses_and_every_source_has_tags(capsys):
+    code, out = run_main(capsys, "--catalogue", str(REAL_CATALOGUE), "list")
+    assert code == 0
+    assert out["count"] > 20
+    data = mod.load_catalogue(REAL_CATALOGUE)
+    for source in data["sources"]:
+        assert source.get("need_tags"), source["id"]
+        assert source.get("kind") in {"code", "registry", "engine", "visual", "taste", "extractor"}, source["id"]
+
+
+def test_real_catalogue_keeps_the_no_license_source_study_only():
+    data = mod.load_catalogue(REAL_CATALOGUE)
+    ali = next(source for source in data["sources"] if source["id"] == "ali-imam")
+    assert ali["study_only"] is True and ali["kind"] == "visual" and ali["license"] is None
+
+
+def test_list_filters_by_need_and_ranks_free_first(tmp_path, capsys):
+    catalogue = write_catalogue(tmp_path, "demo")
+    code, out = run_main(capsys, "--catalogue", str(catalogue), "list", "--need", "hover")
+    assert code == 0
+    assert [row["id"] for row in out["sources"]] == ["demo", "paid"]
+    _, shader = run_main(capsys, "--catalogue", str(catalogue), "list", "--need", "shader")
+    assert shader["sources"][0]["study_only"] is True
+
+
+def test_freshness_marks_old_sync_as_stale(tmp_path, capsys):
+    _, root = make_clone(tmp_path, "demo")
+    catalogue = write_catalogue(tmp_path, "demo")
+    future = (dt.date.today() + dt.timedelta(days=45)).isoformat()
+    code, out = run_main(capsys, "--catalogue", str(catalogue), "--cache-root", str(root), "freshness", "--today", future)
+    assert code == 0
+    assert out["stale"] == ["demo"]
+    row = out["caches"][0]
+    assert row["present"] is True and row["local_changes"] is False and row["age_days"] >= 45
+
+
+def test_freshness_today_is_fresh_and_absent_cache_is_reported(tmp_path, capsys):
+    _, root = make_clone(tmp_path, "demo")
+    catalogue = write_catalogue(tmp_path, "demo")
+    _, out = run_main(capsys, "--catalogue", str(catalogue), "--cache-root", str(root), "freshness")
+    assert out["stale"] == []
+    missing = write_catalogue(tmp_path, "nowhere")
+    _, absent = run_main(capsys, "--catalogue", str(missing), "--cache-root", str(root), "freshness")
+    assert absent["caches"][0]["present"] is False
+
+
+def test_refresh_fast_forwards_clean_clone_and_skips_dirty_one(tmp_path, capsys):
+    upstream, root = make_clone(tmp_path, "demo")
+    (upstream / "a.txt").write_text("2", encoding="utf-8")
+    git(upstream, "commit", "-q", "-am", "two")
+    catalogue = write_catalogue(tmp_path, "demo")
+    _, out = run_main(capsys, "--catalogue", str(catalogue), "--cache-root", str(root), "refresh")
+    assert out["caches"][0]["result"] == "updated"
+    (root / "demo" / "a.txt").write_text("local edit", encoding="utf-8")
+    _, dirty = run_main(capsys, "--catalogue", str(catalogue), "--cache-root", str(root), "refresh")
+    assert dirty["caches"][0]["result"] == "skipped: local changes"
+    assert (root / "demo" / "a.txt").read_text(encoding="utf-8") == "local edit"
+
+
+def test_bad_catalogue_is_a_json_error(tmp_path, capsys):
+    bad = tmp_path / "bad.yaml"
+    bad.write_text("nothing: here\n", encoding="utf-8")
+    code, out = run_main(capsys, "--catalogue", str(bad), "list")
+    assert code == 1 and "sources" in out["error"]

package/src/skills-lib/wizz-router/references/routing-table-flat.md

@@ -19,6 +19,7 @@ Use this table to map skills/CLIs/MCPs directly **outside a Wizz project** (no `
 | **Autonomous, offensive** pentest that actually runs the app and proves each finding with a real PoC | CLI `strix` (qa registry). CONDITIONAL, never the default: only on an app the user owns/is authorized to test, and only when they ask for validated exploitation rather than a review. Start from `wizz-security-audit-pentest` | 2 |
 | Error monitoring, crash/exception triage, releases and source maps in Sentry | CLI `sentry-cli` (architect registry). CONDITIONAL: only if the project ALREADY uses Sentry (`SENTRY_DSN` in env, `sentry.properties`, or `@sentry/` in package.json) and it's at production stage — never propose adopting Sentry from this row | 2 |
 | Launch-readiness audit, "is it ready to launch?", broad release checklist (technical, security, SEO, analytics, content, legal, infra), "what's missing before going to production" | `wizz-launch-readiness` | 1 |
+| Understand how a feature of a THIRD-PARTY app, Electron app, APK, binary or HAR capture works, without its source, to build a similar one | MCP `rea` (dev registry, optional: recommended, never configured by default; own code is `wizz-investigate`) | 2 |
 | Desktop, Electron, contextIsolation, code signing | `wizz-desktop-security` | 2 |
 
 ## Technical Area — Code and Quality
@@ -88,6 +89,7 @@ Use this table to map skills/CLIs/MCPs directly **outside a Wizz project** (no `
 | Tear down ONE viral Instagram post (Reel, carousel, caption) from its link: why it worked, which hook, a mould to do one like it | `wizz-hook-extractor` (social registry; reads the post itself) | 2 |
 | Audit and rewrite an Instagram PROFILE: bio, search NAME, link, highlights, pinned posts | `wizz-ig-profile-optimizer` (social registry) | 2 |
 | Actually PUBLISH/schedule to social networks (Instagram, TikTok, YouTube, LinkedIn and more), not write it | CLI `buffer` (social registry; needs `BUFFER_API_KEY`; media must be a public HTTPS URL). Separates "generate" (Wizz skills above) from "publish" | 2 |
+| VSL (video sales letter) script: expert interview, problem and solution mechanism, spoken offer, leads to test, production beat sheet | `wizz-vsl` (copy registry; the page around the player stays with `wizz-copywriting`) | 2 |
 | Cold email, B2B outbound, prospecting | `wizz-cold-email` | 2 |
 | Referral, referrals, affiliate program | `wizz-referral-program` | 2 |
 | Sales material, pitch, deck, proposal | `wizz-sales-enablement` | 2 |

package/src/skills-lib/wizz-taste-skill/references/anti-slop-tells.md

@@ -91,6 +91,14 @@ These patterns came out of real LLM-generated landing-page tests. They are the s
 * **Scroll cues are banned.** `Scroll`, `↓ scroll`, `Scroll to explore`, `Scroll to walk through it`, animated mouse-wheel icons. If the user has not scrolled yet, they are looking at the hero. They know what scroll is. The bottom of the viewport does not need a label.
 * **ZERO decorative status dots by default.** A coloured dot before nav items, before list rows, before badges, before status labels is a Tell. Only acceptable when conveying real semantic state (a live indicator on actual server status, a live availability flag) and limited to one per page section.
 
+### 9.H Landing-page tells (Wizz addition, moved here from the landing Audit Protocol)
+* **NO identity-free hero formula.** Big headline + subtitle + two side-by-side CTAs, with nothing that could only belong to this brand.
+* **NO `rounded-3xl` on everything.** Radius is a scale with a reason per level, not one oversized value.
+* **NO card stacks on the default `shadow-xl`.** See Section 4.4 for tinted, purposeful elevation.
+* **NO generic testimonial card.** Round avatar + name + title + quoted sentence, repeated in a row. See Section 4.10 for quote formats.
+* **NO centered gradient "Most Popular" badge** on pricing cards.
+* **NO decorative emoji** anywhere other than status microcopy (policy in Section 3.D).
+
 ### 9.G EM-DASH BAN (the single most-violated Tell)
 
 **Em-dash (`—`) is COMPLETELY banned.** It is the LLM's signature stylistic crutch and it is the #1 visual Tell in production tests. There is no "limited use" allowance, no "natural language frequency" allowance, no "in body copy is fine" allowance. None.

package/src/skills-lib/wizz-ui-component-curator/SKILL.md

@@ -40,7 +40,7 @@ Do not ask the user to describe the style unless the project has no inspectable
 
 ## 2. Search and inspect public sources
 
-Start with existing project components. Then search the public sources. The full authorized list (React Bits, Cult UI, Watermelon, StyleUI, Skiper UI, Bklit UI, Componentry, shadcn/ui, Ali Imam for study only, plus the reference galleries) lives in one place: [component-sources](../wizz-premium-landing-ui-researcher/references/component-sources.md). Read it instead of relying on memory. Check which registries are healthy today in the live index (`https://ui.shadcn.com/r/registries.json`, see [source-first-protocol](../wizz-premium-landing-ui-researcher/references/source-first-protocol.md) Phase 3). Compare at least two suitable sources per need.
+Start with existing project components. Then search the public sources. The full authorized list (React Bits, Cult UI, Watermelon, StyleUI, Skiper UI, Bklit UI, Componentry, shadcn/ui, Ali Imam for study only, plus the reference galleries) lives in one place, as data: [design-sources.yaml](../wizz-premium-landing-ui-researcher/references/design-sources.yaml). Query it with `uv run --no-cache ../wizz-premium-landing-ui-researcher/scripts/design_sources.py list --need <tag>` instead of relying on memory; [component-sources](../wizz-premium-landing-ui-researcher/references/component-sources.md) holds the policy behind each row. Check which registries are healthy today in the live index (`https://ui.shadcn.com/r/registries.json`, see [source-first-protocol](../wizz-premium-landing-ui-researcher/references/source-first-protocol.md) Phase 3). Compare at least two suitable sources per need.
 
 Before the first query, open the access as described in [web-access-and-evidence](../wizz-premium-landing-ui-researcher/references/web-access-and-evidence.md): load the web tools (on Claude Code, WebSearch and WebFetch are deferred and need `ToolSearch`), then fall back to `curl`, `agent-browser` and the local source cache. Search with whatever that step opened: web search (Exa when configured, WebSearch otherwise), WebFetch, scrapling, and `agent-browser` to watch hover and motion live. A tool that errors or hangs is not the end of the research: record the failure, move to the next tool, and never stop without reporting what was and was not checked. With no web and no cache, return BLOCKED instead of recommending from memory.
 
@@ -53,20 +53,21 @@ Use the inferred style DNA as the search filter. Prefer:
 - components that can be integrated with minimal stylistic friction
 - effects that enhance the current direction rather than replace it
 
-## 3. Curate: show 1–3 candidates max
+## 3. Judge, select, stop
 
-Do not present unranked lists. Shortlist internally, then surface only the strongest matches.
+Judge every candidate with [mining-rubric](../wizz-premium-landing-ui-researcher/references/mining-rubric.md), in its order: evidence gate, dedup against what the project already selected, entry conditions, the 0-10 score with the cut at 6, the verdict. Select by its selection rule and close the need on its stop conditions (a 9 or more, the source budget, or 2 dry sources in a row). With a `design-state.yaml`, every candidate goes back as a discovery, rejected ones with their reason, so the next round does not open them again. Then run `uv run --no-cache ../wizz-design-needs/scripts/design_state.py validate {output_folder}/design-state.yaml` and fix its findings before handing off.
 
 Only candidates that pass the evidence gate in [web-access-and-evidence](../wizz-premium-landing-ui-researcher/references/web-access-and-evidence.md) can be shown here. The rest are UNVERIFIED and go to the evidence section.
 
-For each candidate, say briefly:
-- why it fits
+Show the selected one and at most two runners-up. For each, say briefly:
+- verdict and score
+- why it fits (the rubric's `por_que`)
 - what role it plays
 - any tradeoff
 
 ## 4. Plan before editing
 
-Provide a compact plan: what changes, which files, any dependency or styling adaptation needed.
+Write the adaptation in the rubric's order (pattern, why it works, invariant, variable, reimplementation), then a compact plan: what changes, which files, any dependency or styling adaptation needed. A visual reference gives structure and principle, never CSS.
 
 ## 5. Present evidence and proceed within scope
 
@@ -124,7 +125,7 @@ If the project is stylistically mixed: anchor to the direction already establish
 Short summary of inferred design language (3–5 lines max).
 
 ## Best fit
-Top recommendation + why it fits + role it plays.
+Top recommendation + verdict and score + why it fits + role it plays + which stop condition closed the need.
 
 ## Alternatives
 Up to 2 backup options only if genuinely different and useful.

package/src/skills-lib/wizz-video-effects/LICENSE-motionmaxxing.txt

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/src/skills-lib/wizz-video-effects/SKILL.md

@@ -39,6 +39,7 @@ Requires Python 3 (stdlib only) and ffmpeg/ffprobe.
 
 ## Per piece
 
+0. **Taste.** Read `_wizz-output/video-styles/gosto.md` if it exists: what this user rejected is refused like an unknown event. After their review, append with `taste.mjs add` (`wizz-video-styles`).
 1. **Timeline.** Write the piece's timeline JSON ([references/data-contract.md](references/data-contract.md)): `words[]` from wizz-ctc-align, `scenes[]`, `elements[]`, and the safe-zone profile (`ad` or `organic`).
 2. **Events to sounds.** List what happens in the narration as semantic events with their times, from the words: a price appears, a verdict lands, a message arrives. Map them with `res = sound.map_requests([(5.4, "verdict"), (7.1, "element_in")], cfg)` from `scripts/sound.py`; it returns the shots (file and `vol` from the config) plus the refusals, with the reason. Write the accepted shots into `sfx[]` with their `event`. Events that trigger an effect (a `verdict` triggers `shake`): pass `sound.effect_candidates(res)` through `budget.select(...)` from `scripts/budget.py` and write the accepted ones into `shakes[]`; no other step writes them.
 3. **Effects on breaths.** `python3 scripts/fill_breaths.py TIMELINE --narration NARRATION.mp3 --visual LAYOUT_RENDER.mp4 --write` anchors punches and flashes on real speech breaths, runs every candidate through the budget, and sets scene transitions and cut sounds by speech pace. Without `--write` it only reports.
@@ -46,9 +47,9 @@ Requires Python 3 (stdlib only) and ffmpeg/ffprobe.
    - `--visual` must be a silent render **in the piece's final layout**. It decides punch vs flash by how close content sits to the safe-zone edge; measured on full-screen footage, every breath turns into a flash. Content inside a clipped card can take a punch.
    - Cut sounds are added here, after step 2: if the report lists sounds that would no longer be accepted together, map everything again. `check_excess.py` checks all sounds together and blocks on collisions.
 4. **Ducking.** `python3 scripts/sound.py duck TIMELINE --write` writes `ducking[]`; the Remotion volume callback is in the data contract.
-5. **Before rendering.** `python3 scripts/check_excess.py TIMELINE` (blocks) and `python3 scripts/check_rhythm.py TIMELINE` (warns).
+5. **Before rendering.** `python3 scripts/check_excess.py TIMELINE` (blocks), `python3 scripts/check_rhythm.py TIMELINE` (warns) and `python3 scripts/check_chrome.py --timeline TIMELINE` (blocks the slide look; for HyperFrames screens use `--snapshot` from `assets/chrome/collect_layout.js`).
 6. **Render** in Remotion from the timeline: SFX at their `vol`, narration with the ducking callback. `assets/remotion/` holds a reference `EffectsLayer.tsx` that consumes the timeline (copy it into the project). For the Remotion API itself, invoke `wizz-remotion-best-practices`.
-7. **Gate the final MP4.** Footage (an actor take, b-roll) edge to edge fails the safe zone by construction: the gate measures contrast, not text. Put footage in a frame inside the zone over a plain or darkened background. `check_safe_zone.py FINAL.mp4 --timeline TIMELINE` (the piece's profile; run with `--profile` for the other one if the piece also runs there), `measure_density.py FINAL.mp4 --timeline TIMELINE`, `check_loudness.py FINAL.mp4` (prints the ffmpeg command that fixes it when it fails, and warns when that fix will compress; a quiet narration is better raised before the render).
+7. **Gate the final MP4.** Footage (an actor take, b-roll) edge to edge fails the safe zone by construction: the gate measures contrast, not text. Put footage in a frame inside the zone over a plain or darkened background. `check_safe_zone.py FINAL.mp4 --timeline TIMELINE` (the piece's profile; run with `--profile` for the other one if the piece also runs there), `measure_density.py FINAL.mp4 --timeline TIMELINE`, `check_dead_frames.py FINAL.mp4`, `check_loudness.py FINAL.mp4` (prints the ffmpeg command that fixes it when it fails, and warns when that fix will compress; a quiet narration is better raised before the render).
 8. **Look.** Extract frames of the final file, including one of the CTA block, and read them.
 
 Every script takes `--config PATH`; without it, `VIDEO_EFFECTS_CONFIG`, then `./effects.config.json`.
@@ -60,7 +61,9 @@ Every script takes `--config PATH`; without it, `VIDEO_EFFECTS_CONFIG`, then `./
 | `check_excess.py` | yes (unless `--warn`) | an effect that always happens stops marking anything |
 | `check_safe_zone.py` | yes | text under the platform UI is text nobody reads |
 | `measure_density.py` | yes | an empty frame loses the scroll |
+| `check_dead_frames.py` | yes on blank runs, warns on frozen picture | a blank gap reads as a broken video |
 | `check_loudness.py` | yes | platforms normalise to about -14 LUFS; louder only distorts |
+| `check_chrome.py` | yes | a corner label or a counter makes an ad read as a slide |
 | `check_rhythm.py` | **warns only** | its numbers come from weak sources |
 
 Full table, what each gate cannot see, and escape hatches: [references/gates.md](references/gates.md).

package/src/skills-lib/wizz-video-effects/assets/chrome/collect_layout.js

@@ -0,0 +1,113 @@
+// collect_layout.js: layout snapshot of an HTML composition for check_chrome.py.
+//
+// Paste the whole file as the expression of a browser eval on the opened
+// composition (HyperFrames preview, a plain HTML film, or Remotion Studio on
+// the composition), e.g. with agent-browser:
+//   agent-browser open file:///.../index.html
+//   agent-browser eval "$(cat collect_layout.js)" > layout.json
+// It seeks each sample time, waits two frames, and returns
+// {width, height, samples: [{t, blocks, shapes}]} as JSON text.
+//
+// Times: window.__chromeTimes if set (array of seconds), else 12 evenly
+// spaced plus each one again 0.1 s later (the pair tells a parked label from
+// one flying through). Seek: window.__seek(t), else the paused GSAP
+// timelines in window.__timelines (HyperFrames), else gsap.globalTimeline.
+// Remotion Studio has none of these: set window.__seek yourself, or take one
+// snapshot per frame with ?frame=N and merge.
+//
+// Roles: an element (or ancestor) with data-role="caption|legal|ui" is
+// written with that role, so the lint skips it. Text in <canvas>, <img>,
+// <video> or WebGL is invisible here.
+//
+// Rules ported from motionmaxxing (Apache-2.0); see THIRD-PARTY-NOTICES.md.
+(async () => {
+  const root = document.querySelector('[data-composition-id="main"]') || document.body;
+  const rect = root.getBoundingClientRect();
+  const W = Number(root.dataset?.width) || rect.width || window.innerWidth;
+  const H = Number(root.dataset?.height) || rect.height || window.innerHeight;
+  const sx = W / (rect.width || W);
+  const sy = H / (rect.height || H);
+  const tls = window.__timelines && typeof window.__timelines === 'object' ? Object.values(window.__timelines) : [];
+  const duration =
+    Number(root.dataset?.duration) ||
+    (tls[0] && typeof tls[0].duration === 'function' ? tls[0].duration() : 0) ||
+    (window.gsap ? window.gsap.globalTimeline.duration() : 0);
+
+  const seek = async (t) => {
+    if (typeof window.__seek === 'function') await window.__seek(t);
+    else if (tls.length > 0) for (const tl of tls) tl.seek(t, false);
+    else if (window.gsap) window.gsap.globalTimeline.seek(t, false);
+    await new Promise((r) => requestAnimationFrame(() => requestAnimationFrame(r)));
+  };
+
+  const box = (r) => [
+    Math.round((r.left - rect.left) * sx),
+    Math.round((r.top - rect.top) * sy),
+    Math.round((r.right - rect.left) * sx),
+    Math.round((r.bottom - rect.top) * sy),
+  ];
+  const opacity = (el) => {
+    let o = 1;
+    for (let e = el; e && e !== document.documentElement; e = e.parentElement) o *= Number(getComputedStyle(e).opacity);
+    return o;
+  };
+  const roleOf = (el) => el.closest('[data-role]')?.dataset.role || '';
+  const visible = (el, r) => r.width >= 1 && r.height >= 1 && getComputedStyle(el).visibility !== 'hidden' && opacity(el) >= 0.05;
+
+  const textBlocks = () => {
+    const out = [];
+    for (const el of root.querySelectorAll('*')) {
+      const own = [...el.childNodes].filter((n) => n.nodeType === 3 && n.textContent.trim());
+      if (own.length === 0) continue;
+      const range = document.createRange();
+      range.selectNodeContents(el);
+      const r = range.getBoundingClientRect();
+      if (!visible(el, r)) continue;
+      const cs = getComputedStyle(el);
+      const fontPx = Number.parseFloat(cs.fontSize) * sy;
+      const spacing = cs.letterSpacing === 'normal' ? 0 : Number.parseFloat(cs.letterSpacing) / Number.parseFloat(cs.fontSize);
+      const lineH = Number.parseFloat(cs.lineHeight) || Number.parseFloat(cs.fontSize) * 1.2;
+      out.push({
+        text: el.textContent.trim().replaceAll(/\s+/g, ' ').slice(0, 120),
+        box: box(r),
+        font_px: Math.round(fontPx),
+        caps: cs.textTransform === 'uppercase',
+        tracking_em: Math.round(spacing * 100) / 100,
+        align: cs.textAlign,
+        lines: Math.max(1, Math.round(r.height / lineH)),
+        role: roleOf(el),
+      });
+    }
+    return out;
+  };
+
+  const shapes = () => {
+    const out = [];
+    let i = 0;
+    for (const el of root.querySelectorAll('*')) {
+      i += 1;
+      const r = el.getBoundingClientRect();
+      if (!visible(el, r)) continue;
+      const tag = el.tagName.toLowerCase();
+      const cs = getComputedStyle(el);
+      const media = /^(img|video|canvas|svg|picture)$/.test(tag) || /url\(/.test(cs.backgroundImage);
+      const filled = !/rgba\(0, 0, 0, 0\)|transparent/.test(cs.backgroundColor);
+      const border = Number.parseFloat(cs.borderTopWidth) >= 1 || Number.parseFloat(cs.borderBottomWidth) >= 1;
+      if (!media && !filled && !border) continue;
+      const kind = media ? 'media' : roleOf(el) === 'ui' ? 'surface' : 'bar';
+      out.push({ id: el.id || `${tag}-${i}`, kind, box: box(r) });
+    }
+    return out;
+  };
+
+  const base = Array.isArray(window.__chromeTimes)
+    ? window.__chromeTimes
+    : Array.from({ length: 12 }, (_, k) => (duration * (k + 0.5)) / 12);
+  const times = Array.isArray(window.__chromeTimes) ? base : base.flatMap((t) => [t, t + 0.1]);
+  const samples = [];
+  for (const t of times) {
+    await seek(t);
+    samples.push({ t: Math.round(t * 1000) / 1000, blocks: textBlocks(), shapes: shapes() });
+  }
+  return JSON.stringify({ width: W, height: H, duration, samples });
+})();

package/src/skills-lib/wizz-video-effects/assets/effects.config.template.json

@@ -57,6 +57,41 @@
     "_source": "min_filled 3 of 7 is a house rule of the source project, not an external benchmark."
   },
 
+  "dead_frames": {
+    "analysis_width": 54,
+    "analysis_height": 96,
+    "flat_std": 1.5,
+    "flat_range": 8,
+    "flat_max_frames": 3,
+    "frozen_diff": 0.35,
+    "frozen_warn_s": 1.5,
+    "motion_band_reference": [4.4, 6.8, 9.8],
+    "_note": "check_dead_frames.py on the FINAL MP4. A flat frame is one uniform field (luma std-dev under flat_std AND range under flat_range on the analysis frame); a run of more than flat_max_frames blocks. A frozen frame differs from the previous one by less than frozen_diff (mean absolute luma, 0-255); a frozen run longer than frozen_warn_s only warns.",
+    "_source": "flat_std, flat_range and flat_max_frames are gate G2 of motionmaxxing (Apache-2.0, github.com/Tejashmakwana/motionmaxxing), measured on horizontal pro launch films at 96x54; the analysis frame here keeps the same pixel count in 9:16. frozen_diff is their hold epsilon; frozen_warn_s is the top of their 'designed breath' (0.6-1.5 s). motion_band_reference is their Q1, median and Q3 of mean frame-to-frame luma change over human-made horizontal brand films: printed as a question, never a gate, and never measured on vertical Reels."
+  },
+
+  "chrome_lint": {
+    "small_text": 0.04,
+    "corner_x": 0.2,
+    "corner_y": 0.14,
+    "edge_band": 0.07,
+    "caps_tracking_em": 0.05,
+    "caps_max_size": 0.045,
+    "counter_max_size": 0.06,
+    "headline_min_size": 0.05,
+    "kicker_ratio": 2.0,
+    "kicker_gap": 0.06,
+    "deck_left_x": 0.2,
+    "bar_min_width": 0.6,
+    "bar_max_height": 0.14,
+    "bar_band": 0.12,
+    "progress_min_growth": 0.08,
+    "held_s": 0.3,
+    "exempt_roles": ["caption", "legal", "ui"],
+    "_note": "check_chrome.py. Positions are fractions of the frame (0-1). Text sizes (font size) are fractions of the SHORT side of the frame (1080 px in 9:16), so they keep the pixel size of the horizontal source. held_s: a timeline text layer shorter than this is in flight, not a held label.",
+    "_source": "Rules C1-C4, C6, C7, D1 and P1 of motionmaxxing's lint.mjs (gate G5, Apache-2.0, github.com/Tejashmakwana/motionmaxxing), built from one user's verdicts on horizontal launch films. exempt_roles is a house decision: captions, legally required ad text and product UI are not chrome."
+  },
+
   "budget": {
     "_readme": "The anti-excess engine. An effect only enters if its curve section still has budget, it respects the minimum distance and it does not repeat too much. When two candidates collide, the higher narrative strength wins.",
     "gap_min_global": 2.0,