Skip to content

Anchor tweens to scene windows; name every literal second's replacement - #17

Merged
leochenpm merged 5 commits into
sync/composition-qa-fidelityfrom
sync/scaffold-scene-anchors
Aug 12, 2026
Merged

Anchor tweens to scene windows; name every literal second's replacement#17
leochenpm merged 5 commits into
sync/composition-qa-fidelityfrom
sync/scaffold-scene-anchors

Conversation

@leochenpm

Copy link
Copy Markdown
Collaborator

Batch 4/8 of the release_1.6.5 sync (scene anchors). Stacked on #16. Re-mapped by hand from Orkas commits 77aaebf4c, 814e2c5a1.

The defect

Scene windows live on data-start/data-duration, and ovs composition reconcile rewrites them when timing changes — which happens after the HTML is authored whenever narration is measured. The scaffold itself emits absolute-second tweens (scaffold.ts line ~85), reconcile only rewrites its own reveal via an exact-shape regex, and stage-compose explicitly told the author to "position every tween with an explicit time so it is reproducible". Result: every authored tween strands on the old window after a retime and its scene captures blank. Upstream's incident: 46 stranded literals, 11 minutes and 13 round trips of hand-retiming that did not finish.

The fix

  1. The scaffold defines S(id)/D(id) (they read each section's own data-start/data-duration) and positions its reveals from S(id) — anchored tweens follow a retime by construction. Reconcile keeps them anchored; a legacy literal-positioned scaffold stays literal (rewriting it would reference an undefined helper).
  2. New AUTHORED_ABSOLUTE_TIMELINE_SECONDS advisory in contract QA scans tl.set/to/from/fromTo/add/addLabel/call positions (call's position is its third argument — upstream fixed exactly that), skips S()/D() and relative string positions, and hands back the exact replacement expression per finding (line N: tl.to(..., 6.5) -> S("payoff") + 1.5). Advisory, not blocking: existing hand-timed compositions were valid under the old rule.
  3. stage-compose's Timing rule now prescribes the anchor form and says why (narration is measured after authoring).

Verification

Build green; full OVS_E2E=1 suite 269/270, including a real hyperframes render of the S()-anchored scaffold, a reconcile round-trip asserting reveals stay anchored while a legacy scaffold stays literal, and detector cases (offset suggestion, tl.call third-arg, string/anchor skips).

🤖 Generated with Claude Code

https://claude.ai/code/session_01VL7mRpmEphLAbcH7YmABnV

leochenpm and others added 2 commits August 12, 2026 01:22
…eral second's replacement

Sync of the scene-anchor work from Orkas release_1.6.5 (77aaebf4c,
814e2c5a1, e78b20c0f context), re-mapped onto the ovs scaffold:

- buildCompositionScaffold defines S(id)/D(id) helpers that read each
  section's data-start/data-duration, and positions its reveal tweens
  from S(id) instead of a literal second. Scene windows move when
  `ovs composition reconcile` rewrites the attributes (e.g. once
  narration is measured, after the HTML is authored); an anchored tween
  follows by construction, a literal keeps playing against the old
  window and captures blank at that scene's QA frames.
- reconcileCompositionHtml keeps S()-anchored reveals anchored, and
  keeps a legacy literal-positioned scaffold literal (rewriting it to
  S() would reference an undefined helper).
- New AUTHORED_ABSOLUTE_TIMELINE_SECONDS advisory in contract QA: scans
  tl.set/to/from/fromTo/add/addLabel/call positions (call's position is
  its THIRD argument), skips S()/D() and relative string positions, and
  hands back the exact replacement — `line N: tl.to(..., 6.5) ->
  S("payoff") + 1.5` — instead of only the complaint. The checker knows
  every window; the upstream incident left 46 stranded literals and 13
  round trips of hand-retiming.
- stage-compose's Timing rule now prescribes S()/D() anchoring; the old
  rule ("position every tween with an explicit time so it is
  reproducible") is what authored the stranded literals.

Verified: build green; full OVS_E2E=1 suite 269/270 (1 intentional
skip), including a real hyperframes render of the S()-anchored
scaffold, a legacy-scaffold reconcile case, and detector unit cases.

Prompt audit: stage-compose "Timing" bullet replaced (explicit-time
rule -> scene-anchor rule with the retime rationale); no other prompt
clause added or removed; the new rule states what the scaffold now
actually emits, so prompt and code cannot disagree.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VL7mRpmEphLAbcH7YmABnV
… directly, and findings can be waived

Sync of the gate-authority reversal from Orkas release_1.6.5
(d2c477f34, e6a71cc8f, 274678ccf, 33904ce59 context), re-mapped onto
the ovs resolver and draft gate:

- resolveGateTransition: an exhausted visual-QA cycle is now a USER
  FORK, not a silent wait. `present_findings_and_ask_user_direction`
  replaces `report_visual_qa_blocker`: show the current frames and
  remaining findings, offer another repair round or skipping the named
  check, and end the turn; the user's reply grants the next cycle, and
  the follow-up edit must be materially different — the failed
  strategies are recorded, and repeating one spends the new budget for
  nothing. A real revise decision still starts the fresh cycle
  directly, unchanged.
- New `origin` input: who asked for the change decides whether to ask
  again. A gate_b_payload revision the CURRENT user turn names in the
  user's own words resolves to `apply_user_instruction_then_approve_plan`
  — the instruction is itself the authorization; asking the user to
  confirm a change they just dictated costs a full round trip and
  teaches them their instructions are not taken at face value. A
  model-initiated or mixed reply stays on the amendment path. Origin is
  the driving agent's honest self-report; nothing verifies it in OVS,
  and the skill says so.
- QA waivers make the skip option honorable: `ovs draft --waive <codes>`
  (CLI + MCP) downgrades the named blocking findings to informational
  with a "[skipped by user decision]" suffix, persists them in
  qa/waivers.json so the user is never asked to skip the same check
  twice, and refuses evidence-integrity codes (missing frames/maps,
  parse failures) — those are repaired, not offered.
- gate-control SKILL.md carries the matching contract: the exhausted
  fork with real choices, the origin classification step, the
  offer-the-waiver rule, and "repair passes that remain never stop for
  the user; an exhausted cycle does".

Verified: build green; full OVS_E2E=1 suite 275/276 (1 intentional
skip). New cases: exhausted fork (with and without an error code),
user-dictated vs model/mixed amendment, waivable/refused codes, and a
draft-gate integration proving a waiver moves past the blocking design
finding, refuses the integrity code, persists, and never re-asks.

Prompt audit: gate-control SKILL.md — replaced the "technical QA
exhaustion must never create a recovery form" clause with the
user-fork contract (behavioral reversal shipped in the resolver);
added the origin classification step and the offer-the-waiver rule
(both state what the resolver/draft now enforce); inverted the closing
exhausted-cycle bullet. No clause duplicates another rule; each names
the code path that backs it.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VL7mRpmEphLAbcH7YmABnV
… the direction stop first

Sync of the checkpoint-protocol craft from Orkas release_1.6.5
(c4ba98815 end-state, 707a8bf1f, 734cfc675, ed5d22684, 2182ad89a,
72e541a87, b0514f075, f0e0c348a), prompt-only, re-mapped onto the OSS
orchestration/gate-control/video-router split:

- orchestration: "Show the work; stop only five times" — the stops are
  a closed set and showing an artifact is not an ending in itself; the
  visual preview stops once per VISUAL IDENTITY (narration-only changes
  inherit the accepted frames); artifacts ride the message that ENDS
  the turn; an enumerated-option reply IS the decision; everything
  outside a tool call is user-facing copy (no finding codes or severity
  words; passing checks stay silent); repair every independent finding
  in one message and never re-read to confirm a successful write.
- Gate A: the direction stop comes first, before any plan file exists;
  2-3 genuinely different concepts; an exact brief still stops with ONE
  concept; propose instead of interrogating for creative preferences.
- AUTO: an assembled production is ONE video — the stop count is fixed
  by the gate table, never per segment; an edit invalidates only its
  own segment.
- gate-control: Gate B opens with the locked direction summary and
  restates settled facts instead of reopening them; a different-language
  reply is a revise instruction; amendment aftermath follows the visual
  identity; a recovery is executed, not narrated (the concrete mutation
  precedes the validator retry).
- video-router: routing ends at the direction boundary — no plan file,
  script, narration copy, or art direction before the user picks.

Verified: skills content tests pin each new clause; suite 266 pass.

Prompt audit: every clause above is NEW behavioral guidance absent from
the OSS pack (verified against current SKILL.md text); none duplicates
gate-control's authorization rules — orchestration carries presentation
/stop craft, gate-control carries authorization; the five-stops set
matches the resolver's gate enum; no clause contradicts the PR5
user-fork/waiver contract, and the preview-identity rule is consistent
with the PR5 amendment-aftermath resolver reasons.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VL7mRpmEphLAbcH7YmABnV
Checkpoint craft: five stops, visual identity, and the direction stop first
Exhausted QA becomes a user fork; dictated changes apply directly; findings can be waived
@leochenpm
leochenpm merged commit ec3aeff into sync/composition-qa-fidelity Aug 12, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant