wizz-method 2.21.0 → 2.23.0

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`, a piece meant as one take also runs `check_one_take.py FINAL.mp4 --timeline TIMELINE` ([references/one-take.md](references/one-take.md)), `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,10 @@ 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_one_take.py` | yes, on one-take pieces | a passage that only swaps scenes breaks the one take |
 | `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).
@@ -74,6 +78,7 @@ Full table, what each gate cannot see, and escape hatches: [references/gates.md]
 | [references/audio.md](references/audio.md) | which sound for which event, levels, ducking, loudness |
 | [references/sfx-licensing.md](references/sfx-licensing.md) | what can run in a paid ad vs an organic post, per library |
 | [references/editing-patterns.md](references/editing-patterns.md) | hook, rhythm, CTA, captions, safe zones, organic reach: what has a source and what does not |
+| [references/one-take.md](references/one-take.md) | a piece with no change of scene: what each passage carries, camera, passages to build first, its gate |
 | [references/gates.md](references/gates.md) | what each gate measures and what it misses |
 | [references/data-contract.md](references/data-contract.md) | the timeline JSON the scripts read and write |
 

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,51 @@
     "_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."
+  },
+
+  "one_take": {
+    "analysis_width": 54,
+    "analysis_height": 96,
+    "cut_min_diff": 18,
+    "cut_ratio": 4,
+    "neighbour_frames": 3,
+    "_note": "check_one_take.py on the FINAL MP4 of a piece meant as one continuous shot. A frame is a hard cut when its mean absolute luma change to the previous frame (0-255, on the analysis frame) is above cut_min_diff AND cut_ratio times the median change of the neighbour_frames frames on each side: a whip or a fast push changes many frames in a row, a cut changes one.",
+    "_source": "House rule, not an external benchmark: cut_min_diff sits well above the motion band of dead_frames.motion_band_reference (median 6.8), cut_ratio and neighbour_frames are the smallest values that keep a fast whip from reading as a cut in the tests. Recalibrate on the first real one-take pieces."
+  },
+
+  "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,

package/src/skills-lib/wizz-video-effects/references/data-contract.md

@@ -18,7 +18,7 @@ Numbers that decide anything (gaps, ceilings, depths) are never in the timeline:
 | `shakes[]` | list | same | planner | short shakes (`budget.per_effect.shake.max_dur_s`) |
 | `flashes[]` | list | same | planner, `fill_breaths.py` | opacity flashes |
 | `interrupts[]` | list | same | planner | pattern interrupts |
-| `elements[]` | list | `check_rhythm.py` | planner | element entries (cards, labels) that count as visual change |
+| `elements[]` | list | `check_rhythm.py`, `check_chrome.py` | planner | element entries (cards, labels) that count as visual change |
 | `ducking[]` | list | renderer | `sound.py duck --write` | narration duck windows |
 
 ### `words[]` (ctc-align output, unchanged)
@@ -42,6 +42,7 @@ Only `start` and `end` are required. Breaths are the gaps between words at least
 
 - `transition`: `cut`, `whip`, `zoom` or any name the renderer knows. Anything other than `""` or `cut` counts as a `transition` event in the budget. `fill_breaths.py` only fills scenes without a real transition (absent, `""` or `cut`); a transition the author declared is kept, and its `sfx` too when already set.
 - `sfx` (optional): the cut sound, played at `start`. Same shape as an `sfx[]` entry without `at`.
+- `carry` (optional, required on a one-take piece): one line saying what on screen survives the passage into this scene and what it becomes. Read by `check_one_take.py` ([one-take.md](one-take.md)).
 
 ### `sfx[]`
 
@@ -64,6 +65,20 @@ Each item is a number (the instant) or an object with `at`:
 "elements": [{ "at": 0.6, "kind": "text" }]
 ```
 
+Text layers and bars that `check_chrome.py` should read carry their geometry (pixels of the final frame) and stay on screen until `until` (default: the end):
+
+```json
+"elements": [
+  { "at": 0.6, "until": 4.0, "kind": "text", "text": "Pare de perder dinheiro", "box": [100, 760, 980, 860], "font_px": 96, "align": "center" },
+  { "at": 1.0, "until": 3.0, "kind": "text", "text": "custa", "box": [400, 1300, 680, 1380], "font_px": 72, "role": "caption" },
+  { "at": 0.0, "kind": "bar", "box": [0, 1880, 100, 1890], "box_end": [0, 1880, 1080, 1890] }
+]
+```
+
+- `role`: `caption`, `legal` or `ui` (`chrome_lint.exempt_roles`) is not chrome. Optional `caps`, `tracking_em` (letter-spacing in em), `lines`.
+- `box_end`: the bar's box at `until`; wider than `box` means a growing bar.
+- Top-level `chrome_allow`: rules the chosen style measured on real videos (e.g. `["P1"]`), printed as allowed.
+
 ### `ducking[]`
 
 Written by `python3 scripts/sound.py duck TIMELINE --write`. One window per group of SFX that sound over the **start of a spoken word**; nothing else ducks.
@@ -132,14 +147,30 @@ export const narrationVolume = (ducking: Duck[], fps: number, startFrame = 0) =>
 }
 ```
 
+## Layout snapshot (`check_chrome.py --snapshot`)
+
+Written by `assets/chrome/collect_layout.js` from the opened HTML composition (instructions at the top of that file); not part of the timeline:
+
+```json
+{ "width": 1080, "height": 1920, "samples": [
+  { "t": 1.0,
+    "blocks": [{ "text": "02 / 05", "box": [948, 40, 1040, 75], "font_px": 30, "caps": false, "tracking_em": 0, "align": "start", "lines": 1, "role": "" }],
+    "shapes": [{ "id": "bar", "kind": "bar", "box": [0, 1880, 1080, 1888] }] } ] }
+```
+
+`kind` is `bar` (any filled or bordered box), `media` (img, video, canvas, svg) or `surface` (inside `data-role="ui"`). Samples come in pairs 0.1 s apart, so a label flying through a corner is not taken for a parked one.
+
 ## Which script touches what
 
 | Script | Reads | Writes | Exit codes |
 | --- | --- | --- | --- |
 | `fill_breaths.py TIMELINE [--narration F@OFF] [--visual MP4] [--write\|--out P]` | `words`, `scenes`, effects, `sfx`, `duration` | `scenes[].transition`, `scenes[].sfx`, `punches`, `flashes`, `sfx` | 0, 2 |
 | `sound.py duck TIMELINE [--write]` | `sfx`, `scenes[].sfx`, `words`, `fps` | `ducking` | 0, 2 |
+| `check_one_take.py FINAL.mp4 [--timeline T]` | `scenes[].carry`, `scenes[].transition` | nothing | 0 pass, 1 fail, 2 error |
 | `check_excess.py TIMELINE... [--warn]` | effects, `scenes`, `duration` | nothing | 0 pass, 1 fail, 2 error |
 | `check_rhythm.py TIMELINE...` | `scenes`, effects, `elements`, `duration` | nothing | always 0 (warn only) |
+| `check_chrome.py --timeline T \| --snapshot LAYOUT [--allow R]` | `elements[]` text layers and bars, `chrome_allow` (or the snapshot) | nothing | 0, 1, 2 |
 | `check_safe_zone.py MP4 [--timeline T]` | `safe_zone_profile` | nothing | 0, 1, 2 |
 | `measure_density.py MP4 [--timeline T]` | `safe_zone_profile` | nothing | 0, 1, 2 |
+| `check_dead_frames.py MP4` | the final file only | nothing | 0, 1, 2 |
 | `check_loudness.py MP4` | the final file only | nothing | 0, 1, 2 |

package/src/skills-lib/wizz-video-effects/references/gates.md

@@ -13,11 +13,14 @@ Thresholds are cited by config key. Every script exits `0` pass, `1` fail, `2` i
 | `normalize_audio.py --check` | SFX folder | every file at `sound.reference_level_db`, peak under `sound.max_peak_db` | yes | silent tails: it measures the whole file, so trim first |
 | `check_excess.py` | timeline JSON | every sound together (`sfx[]` and scene cut sounds) against the three refusals: unknown event, collision, same sound in a row; per effect kind: ceiling per minute, smallest gap, longest run in a row (`budget.per_effect.*`); dominant effects of different kinds closer than `budget.gap_min_global`; always reports the densest 10 s cluster | yes (`--warn` only while calibrating) | effects drawn inside the screens themselves (HyperFrames timelines); only what the timeline declares |
 | `check_rhythm.py` | timeline JSON | longest stretch with no visual change (`rhythm.max_static_s`), cut cadence in the hook (`rhythm.hook_s`, `rhythm.hook_cut_every_s`) and body (`rhythm.body_cut_every_s`), CTA tail excluded (`rhythm.cta_tail_s`). SFX never count as change | **no, warns only** | motion inside a screen; its numbers come from weak sources ([editing-patterns.md](editing-patterns.md)) |
+| `check_chrome.py` | timeline text layers (`--timeline`) or a DOM snapshot of the screens (`--snapshot`, from `assets/chrome/collect_layout.js`) | page chrome and slide look, thresholds in `chrome_lint.*`: C1 small label parked in a corner or edge band, C2 small tracked caps, C3 counter ("02 / 05", "Parte 3"), C4 timecode or metadata, C6 wide bar or hairline in the top or bottom band, C7 kicker right above a headline, D1 left headline block with media on the right, a sub-line or 2+ lines (alone: warn), P1 thin bar that grows. Roles in `chrome_lint.exempt_roles` (caption, legal, ui) are skipped; a rule the style measured goes in `chrome_allow` or `--allow` and is printed | yes | text in canvas, images, video or burned into footage; Remotion text not declared in `elements[]`; whether the flagged thing is still the right call. Rules come from one user's verdicts on horizontal launch films (motionmaxxing G5) |
 | `check_safe_zone.py` | **final MP4** | per row, local contrast (std-dev, `safe_zone_gate.dp_min`) on every frame; the highest and lowest content rows must sit inside the piece's profile (`safe_zones.<profile>` top and bottom) | yes | whether what invades is text, a card or background glow; left and right edges. Full-screen footage fails by construction: frame it inside the zone. On a fail, extract the frame and look |
 | `measure_density.py` | **final MP4** | how many of `density.n_bands` bands across the active safe zone have content (`density.dp_min`), sampled every `density.step_s`; fails under `density.min_filled` | yes | whether the content makes sense there: a band full of noise counts like a band full of information |
+| `check_dead_frames.py` | **final MP4**, every frame | runs of flat frames (one uniform field: `dead_frames.flat_std` and `dead_frames.flat_range` on a small luma copy); more than `dead_frames.flat_max_frames` in a row fails. Frozen picture (frame difference under `dead_frames.frozen_diff`) longer than `dead_frames.frozen_warn_s` only warns. Prints the mean motion against `dead_frames.motion_band_reference` as a question | yes for flat runs; frozen is a warning | a talking head is never flat and almost never frozen (noise, breathing, compression), so a dead shot on camera passes; grain or a looping background keeps a dead slide "moving"; a dark frame with one small line of text is not flat (that is density). Thresholds come from horizontal launch films (motionmaxxing G2), not from vertical Reels |
+| `check_one_take.py` | timeline JSON (`--timeline`) + **final MP4**, every frame | only on a piece meant as one take: every scene after the first declares `carry` and is not a plain `cut`; a frame whose change is above `one_take.cut_min_diff` and `one_take.cut_ratio` times the median of its `one_take.neighbour_frames` neighbours is a hard cut ([one-take.md](one-take.md)) | yes | a dissolve between unrelated scenes (no spike); whether the declared carry is really on screen; a cut hidden under a flash or a blur. Thresholds are a house rule, not measured on real one-take pieces |
 | `check_loudness.py` | **final MP4 or audio** | integrated loudness and true peak (ffmpeg `loudnorm`) against `loudness.*`; prints the two-pass fix and warns when the fix will switch loudnorm to dynamic compression | yes | the balance inside the mix (voice vs SFX); that is the level contract and the ear |
 
-Order that matches the pipeline: config and coverage once per project; excess and rhythm on the timeline before the expensive render; safe zone, density and loudness on the final file.
+Order that matches the pipeline: config and coverage once per project; excess, rhythm and chrome on the timeline before the expensive render; safe zone, density, dead frames and loudness on the final file.
 
 ## Two profiles, measured separately
 

package/src/skills-lib/wizz-video-effects/references/one-take.md

@@ -0,0 +1,41 @@
+# One take: a piece with no change of scene
+
+A one-take piece is one continuous shot. Nothing replaces anything: every beat grows out of something already on screen, and a single camera carries the viewer from the hook to the CTA. It fits pieces drawn in code (HyperFrames): a product film, a UI walkthrough, an explainer. It does not fit footage that was shot in separate takes. Idea seen in onetake (github.com/feitangyuan/onetake, PolyForm Noncommercial); nothing here is copied from it. The onetake skill itself is installable as the optional CLI `onetake` (designer area), free only for personal or noncommercial work; client work or content that sells needs onetake Pro. This technique needs neither.
+
+## The rule
+
+**No passage is only a change of scene.** At every boundary, something on screen survives and becomes the next beat. Write it in the timeline as the scene's `carry` ([data-contract.md](data-contract.md)), in one line: what it is and what it turns into. If that line cannot be written, the passage is a cut, and the piece is not one take.
+
+## Ways to carry
+
+- **Grow into:** an element of this beat becomes the frame of the next one (a price chip opens into the checkout card; a search bar opens into the app window).
+- **Push through:** the camera flies into an element (a card, a phone screen, a letter of the headline) until its inside is the next scene.
+- **Pull back:** the camera opens from a detail to reveal it was part of a bigger picture (one cell of a table, one post in a feed).
+- **Travel:** a line, a dot or a cursor leaves this beat and becomes the first stroke of the next one.
+- **Gather:** the closing lockup collects the pieces seen along the way.
+
+## Camera
+
+- Lead the subject: the camera arrives where the next element will land a moment before it lands.
+- Rest between moves. A hold of about a beat after each move is what makes the move read; a camera that never stops reads as a screensaver.
+- Vary the length of the moves; equal lengths read as a template.
+- Fast moves get motion blur; a sharp whip looks like a glitch.
+- Build every move as a function of time (seek(t)), so every frame renders the same.
+
+## Passages to build first (agency Reels)
+
+From the pauta of effect names collected on 2026-10-25, the ones that are carries and serve agency Reels:
+
+| Passage | Carry |
+|---|---|
+| Zoom Through Cut | push through an element into the next scene |
+| Pullback Reveal | pull back from a detail to the whole |
+| Phone Mockup | the screen of a phone grows out of the frame or the frame flies into it |
+| Chart Grow | a number on screen becomes the bar or line of a chart |
+| Headline Wall | a headline pulls back to reveal a wall of headlines |
+
+Still only names, no recipe yet: Orbit, Couch Wall, UI World, Frame Break, Digital Zoom, Checklist, Greenscreen, Paper Cut, Doodle Boy, Vertigo, Cover Story, Glass Type.
+
+## Gate
+
+`scripts/check_one_take.py FINAL.mp4 --timeline TIMELINE` blocks a scene without `carry`, a `transition` that is a plain cut, and any hard cut measured in the file (`one_take.*` in the config). A dissolve between unrelated scenes passes the measurement: the `carry` line and the eye are what catch it. Extract the frames around each passage and look.