fix(skills): await the player seek in seam-gate (#7454)

* fix(skills): await the player seek in seam-gate

#7378 made __player.seek() asynchronous (it resolves once the preview
picture is ready). seam-gate.mjs seeked and read in the same tick, so
every sample measured t=0: on a correct film each seam failed with
exit-visible op 0.00 and exit-moving 0 px/s, and probe found no movers.

Make the page-side seek/sample/scan helpers async and evaluate them with
awaitPromise, and note the false-failure signature in the reference doc.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>

* docs(skills): await the player seek in changelog-video spot checks

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
This commit is contained in:
James Russo
2026-11-09 19:19:09 +00:00
committed by GitHub
co-authored by Claude Opus 5.5
parent 0ca2b1ae9e
commit fc13420de8
8 changed files with 28 additions and 20 deletions
+1 -1
View File
@@ -155,7 +155,7 @@ scaffold.
truth for the composition contract this skill produces against.
2. `seam-gate.mjs verify` — 0 fail.
3. Restart the preview server (it caches the bundle), spot-check 3-4 beats
via `__player.seek` on the raw comp page.
via `await __player.seek(t)` on the raw comp page (it resolves async).
4. Do NOT render unless the user asks. After a requested render, verify
frames from the MP4 (`ffmpeg -ss <t> … -frames:v 1`): captions present,
background video not black, no tiny/frozen frames.
@@ -119,4 +119,4 @@ otherwise) and must stay flat 2D (no 3D ancestors).
(0.14 sits under the VO; use a user-supplied track only when given one).
- Preview server caches the bundle — RESTART after edits, then verify on the
raw comp page (`/api/projects/<id>/preview/comp/index.html`) via
`window.__player.seek(t)`.
`await window.__player.seek(t)` (it resolves async; read after it settles).
@@ -91,3 +91,7 @@ Lives at the project root. One row per seam; this is the vector ledger as data.
Velocities are measured on `getBoundingClientRect` (center for x/y, width-ratio for z),
so ancestor wrapper transforms are automatically included.
`__player.seek()` resolves asynchronously, so the gate awaits each seek before it reads. If every
seam fails the same way (`exit-visible op 0.00`, `exit-moving 0 px/s`) and `probe` finds no movers,
the reads landed before the seek did and the gate measured t=0, not the film.
@@ -294,7 +294,7 @@ async function openPage(compUrl) {
// ---------- in-page harness ----------
const HARNESS = `window.__seamGate = {
seek(t){ __player.pause(); __player.seek(t); void document.body.offsetHeight; },
async seek(t){ __player.pause(); await __player.seek(t); void document.body.offsetHeight; },
cumOp(el){
let op = 1, n = el;
while (n && n.nodeType === 1) {
@@ -314,7 +314,7 @@ const HARNESS = `window.__seamGate = {
return { cx: r.x + r.width/2, cy: r.y + r.height/2, w: r.width, h: r.height,
op: this.cumOp(el), es: r.width / lw, onscreen };
},
sample(t, sels){ this.seek(t); const o = {}; for (const s of sels) o[s] = this.read(s); return o; },
async sample(t, sels){ await this.seek(t); const o = {}; for (const s of sels) o[s] = this.read(s); return o; },
pathOf(el){
if (el.id) return "#" + CSS.escape(el.id);
const hf = el.getAttribute && el.getAttribute("data-hf-id");
@@ -330,8 +330,8 @@ const HARNESS = `window.__seamGate = {
}
return p.join(">");
},
scan(t, rootSel, cap){
this.seek(t);
async scan(t, rootSel, cap){
await this.seek(t);
const root = document.querySelector(rootSel || "#root");
if (!root) return [];
const els = [root, ...root.querySelectorAll("*")].slice(0, cap || 900);
@@ -389,7 +389,7 @@ async function verify() {
].filter(Boolean);
const S = {};
for (const t of [tA1, tA2, tB1, tB2])
S[t] = await evalJs(`__seamGate.sample(${t}, ${JSON.stringify([...new Set(sels)])})`);
S[t] = await evalJs(`__seamGate.sample(${t}, ${JSON.stringify([...new Set(sels)])})`, true);
if (type === "cut") {
const ex = seam.exit,
@@ -470,8 +470,8 @@ async function verify() {
// Z-sign scan: the incoming scene's OWN entrances must not fight the seam's Z sign
if (en.axis === "z") {
const scanRoot = en.scanRoot || en.selector;
const s1 = await evalJs(`__seamGate.scan(${tB1}, ${JSON.stringify(scanRoot)})`);
const s2 = await evalJs(`__seamGate.scan(${tB2}, ${JSON.stringify(scanRoot)})`);
const s1 = await evalJs(`__seamGate.scan(${tB1}, ${JSON.stringify(scanRoot)})`, true);
const s2 = await evalJs(`__seamGate.scan(${tB2}, ${JSON.stringify(scanRoot)})`, true);
const m1 = new Map(s1.map((e) => [e.sel, e]));
const offenders = [];
for (const e2 of s2) {
@@ -539,7 +539,7 @@ async function probe() {
const dt = DT;
const scans = {};
for (const tt of [t - win, t - dt, t + dt, t + win])
scans[tt] = await evalJs(`__seamGate.scan(${Math.max(0, tt)}, "#root")`);
scans[tt] = await evalJs(`__seamGate.scan(${Math.max(0, tt)}, "#root")`, true);
const join = (a, b) => {
const m = new Map(a.map((e) => [e.sel, e]));
return b.map((e2) => ({ e1: m.get(e2.sel), e2 })).filter((p) => p.e1);
+1 -1
View File
@@ -155,7 +155,7 @@ scaffold.
truth for the composition contract this skill produces against.
2. `seam-gate.mjs verify` — 0 fail.
3. Restart the preview server (it caches the bundle), spot-check 3-4 beats
via `__player.seek` on the raw comp page.
via `await __player.seek(t)` on the raw comp page (it resolves async).
4. Do NOT render unless the user asks. After a requested render, verify
frames from the MP4 (`ffmpeg -ss <t> … -frames:v 1`): captions present,
background video not black, no tiny/frozen frames.
@@ -119,4 +119,4 @@ otherwise) and must stay flat 2D (no 3D ancestors).
(0.14 sits under the VO; use a user-supplied track only when given one).
- Preview server caches the bundle — RESTART after edits, then verify on the
raw comp page (`/api/projects/<id>/preview/comp/index.html`) via
`window.__player.seek(t)`.
`await window.__player.seek(t)` (it resolves async; read after it settles).
@@ -91,3 +91,7 @@ Lives at the project root. One row per seam; this is the vector ledger as data.
Velocities are measured on `getBoundingClientRect` (center for x/y, width-ratio for z),
so ancestor wrapper transforms are automatically included.
`__player.seek()` resolves asynchronously, so the gate awaits each seek before it reads. If every
seam fails the same way (`exit-visible op 0.00`, `exit-moving 0 px/s`) and `probe` finds no movers,
the reads landed before the seek did and the gate measured t=0, not the film.
@@ -294,7 +294,7 @@ async function openPage(compUrl) {
// ---------- in-page harness ----------
const HARNESS = `window.__seamGate = {
seek(t){ __player.pause(); __player.seek(t); void document.body.offsetHeight; },
async seek(t){ __player.pause(); await __player.seek(t); void document.body.offsetHeight; },
cumOp(el){
let op = 1, n = el;
while (n && n.nodeType === 1) {
@@ -314,7 +314,7 @@ const HARNESS = `window.__seamGate = {
return { cx: r.x + r.width/2, cy: r.y + r.height/2, w: r.width, h: r.height,
op: this.cumOp(el), es: r.width / lw, onscreen };
},
sample(t, sels){ this.seek(t); const o = {}; for (const s of sels) o[s] = this.read(s); return o; },
async sample(t, sels){ await this.seek(t); const o = {}; for (const s of sels) o[s] = this.read(s); return o; },
pathOf(el){
if (el.id) return "#" + CSS.escape(el.id);
const hf = el.getAttribute && el.getAttribute("data-hf-id");
@@ -330,8 +330,8 @@ const HARNESS = `window.__seamGate = {
}
return p.join(">");
},
scan(t, rootSel, cap){
this.seek(t);
async scan(t, rootSel, cap){
await this.seek(t);
const root = document.querySelector(rootSel || "#root");
if (!root) return [];
const els = [root, ...root.querySelectorAll("*")].slice(0, cap || 900);
@@ -389,7 +389,7 @@ async function verify() {
].filter(Boolean);
const S = {};
for (const t of [tA1, tA2, tB1, tB2])
S[t] = await evalJs(`__seamGate.sample(${t}, ${JSON.stringify([...new Set(sels)])})`);
S[t] = await evalJs(`__seamGate.sample(${t}, ${JSON.stringify([...new Set(sels)])})`, true);
if (type === "cut") {
const ex = seam.exit,
@@ -470,8 +470,8 @@ async function verify() {
// Z-sign scan: the incoming scene's OWN entrances must not fight the seam's Z sign
if (en.axis === "z") {
const scanRoot = en.scanRoot || en.selector;
const s1 = await evalJs(`__seamGate.scan(${tB1}, ${JSON.stringify(scanRoot)})`);
const s2 = await evalJs(`__seamGate.scan(${tB2}, ${JSON.stringify(scanRoot)})`);
const s1 = await evalJs(`__seamGate.scan(${tB1}, ${JSON.stringify(scanRoot)})`, true);
const s2 = await evalJs(`__seamGate.scan(${tB2}, ${JSON.stringify(scanRoot)})`, true);
const m1 = new Map(s1.map((e) => [e.sel, e]));
const offenders = [];
for (const e2 of s2) {
@@ -539,7 +539,7 @@ async function probe() {
const dt = DT;
const scans = {};
for (const tt of [t - win, t - dt, t + dt, t + win])
scans[tt] = await evalJs(`__seamGate.scan(${Math.max(0, tt)}, "#root")`);
scans[tt] = await evalJs(`__seamGate.scan(${Math.max(0, tt)}, "#root")`, true);
const join = (a, b) => {
const m = new Map(a.map((e) => [e.sel, e]));
return b.map((e2) => ({ e1: m.get(e2.sel), e2 })).filter((p) => p.e1);