@cliangdev/conductor 0.51.0 → 0.53.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (139) hide show
  1. package/assets/claude/agents/conductor-marketing-art-director.md +2 -1
  2. package/assets/claude/skills/conductor-marketing-create/SKILL.md +12 -2
  3. package/assets/claude/skills/conductor-marketing-create/references/capabilities.md +9 -2
  4. package/assets/claude/skills/conductor-marketing-create/references/direct.md +39 -6
  5. package/assets/claude/skills/conductor-marketing-create/references/platform-specs.md +15 -4
  6. package/assets/claude/skills/conductor-marketing-create/references/shotlist-template.md +2 -2
  7. package/assets/claude/skills/conductor-marketing-create/references/slideshow-formats.md +2 -1
  8. package/assets/claude/skills/conductor-marketing-create/references/team-run.md +3 -3
  9. package/assets/claude/skills/conductor-marketing-report/SKILL.md +2 -2
  10. package/assets/cli-manifest.json +261 -23
  11. package/dist/creative/assertions.js +30 -3
  12. package/dist/creative/frame.js +2 -2
  13. package/dist/creative/job/media.mjs +2 -2
  14. package/dist/creative/job/render.mjs +3 -0
  15. package/dist/creative/placements.js +2 -2
  16. package/dist/creative/placements.json +3 -3
  17. package/dist/creative/render.js +20 -8
  18. package/dist/lib/creative-render.d.ts +14 -1
  19. package/dist/lib/creative-render.d.ts.map +1 -1
  20. package/dist/lib/creative-render.js +3 -1
  21. package/dist/lib/creative-render.js.map +1 -1
  22. package/dist/lib/safe-zone/check.d.ts +31 -0
  23. package/dist/lib/safe-zone/check.d.ts.map +1 -0
  24. package/dist/lib/safe-zone/check.js +267 -0
  25. package/dist/lib/safe-zone/check.js.map +1 -0
  26. package/dist/lib/safe-zone/frames.d.ts +35 -0
  27. package/dist/lib/safe-zone/frames.d.ts.map +1 -0
  28. package/dist/lib/safe-zone/frames.js +132 -0
  29. package/dist/lib/safe-zone/frames.js.map +1 -0
  30. package/dist/lib/safe-zone/ocr.d.ts +42 -0
  31. package/dist/lib/safe-zone/ocr.d.ts.map +1 -0
  32. package/dist/lib/safe-zone/ocr.js +139 -0
  33. package/dist/lib/safe-zone/ocr.js.map +1 -0
  34. package/dist/lib/safe-zone/overlay.d.ts +59 -0
  35. package/dist/lib/safe-zone/overlay.d.ts.map +1 -0
  36. package/dist/lib/safe-zone/overlay.js +283 -0
  37. package/dist/lib/safe-zone/overlay.js.map +1 -0
  38. package/dist/lib/safe-zone/zones.d.ts +46 -0
  39. package/dist/lib/safe-zone/zones.d.ts.map +1 -0
  40. package/dist/lib/safe-zone/zones.js +84 -0
  41. package/dist/lib/safe-zone/zones.js.map +1 -0
  42. package/dist/lib/slideshow/compose.d.ts +2 -0
  43. package/dist/lib/slideshow/compose.d.ts.map +1 -1
  44. package/dist/lib/slideshow/compose.js +1 -1
  45. package/dist/lib/slideshow/compose.js.map +1 -1
  46. package/dist/lib/slideshow/css.d.ts +2 -0
  47. package/dist/lib/slideshow/css.d.ts.map +1 -1
  48. package/dist/lib/slideshow/css.js +9 -5
  49. package/dist/lib/slideshow/css.js.map +1 -1
  50. package/dist/lib/slideshow/html.d.ts +12 -3
  51. package/dist/lib/slideshow/html.d.ts.map +1 -1
  52. package/dist/lib/slideshow/html.js +16 -10
  53. package/dist/lib/slideshow/html.js.map +1 -1
  54. package/dist/lib/slideshow/spec-transport.d.ts.map +1 -1
  55. package/dist/lib/slideshow/spec-transport.js +4 -2
  56. package/dist/lib/slideshow/spec-transport.js.map +1 -1
  57. package/dist/lib/slideshow/spec.d.ts +8 -0
  58. package/dist/lib/slideshow/spec.d.ts.map +1 -1
  59. package/dist/lib/slideshow/spec.js +6 -0
  60. package/dist/lib/slideshow/spec.js.map +1 -1
  61. package/dist/lib/slideshow-pacing.d.ts +46 -0
  62. package/dist/lib/slideshow-pacing.d.ts.map +1 -0
  63. package/dist/lib/slideshow-pacing.js +98 -0
  64. package/dist/lib/slideshow-pacing.js.map +1 -0
  65. package/dist/mcp/index.d.ts +12023 -800
  66. package/dist/mcp/index.d.ts.map +1 -1
  67. package/dist/mcp/index.js +593 -13
  68. package/dist/mcp/index.js.map +1 -1
  69. package/dist/mcp/tools/ai-visibility.d.ts +18 -0
  70. package/dist/mcp/tools/ai-visibility.d.ts.map +1 -0
  71. package/dist/mcp/tools/ai-visibility.js +124 -0
  72. package/dist/mcp/tools/ai-visibility.js.map +1 -0
  73. package/dist/mcp/tools/budget.d.ts +35 -0
  74. package/dist/mcp/tools/budget.d.ts.map +1 -0
  75. package/dist/mcp/tools/budget.js +205 -0
  76. package/dist/mcp/tools/budget.js.map +1 -0
  77. package/dist/mcp/tools/creative-drafts.d.ts +16 -2
  78. package/dist/mcp/tools/creative-drafts.d.ts.map +1 -1
  79. package/dist/mcp/tools/creative-drafts.js +237 -31
  80. package/dist/mcp/tools/creative-drafts.js.map +1 -1
  81. package/dist/mcp/tools/creatives.d.ts +12 -3
  82. package/dist/mcp/tools/creatives.d.ts.map +1 -1
  83. package/dist/mcp/tools/creatives.js +235 -17
  84. package/dist/mcp/tools/creatives.js.map +1 -1
  85. package/dist/mcp/tools/creators.d.ts +15 -0
  86. package/dist/mcp/tools/creators.d.ts.map +1 -0
  87. package/dist/mcp/tools/creators.js +69 -0
  88. package/dist/mcp/tools/creators.js.map +1 -0
  89. package/dist/mcp/tools/growth-signals.d.ts +38 -0
  90. package/dist/mcp/tools/growth-signals.d.ts.map +1 -0
  91. package/dist/mcp/tools/growth-signals.js +135 -0
  92. package/dist/mcp/tools/growth-signals.js.map +1 -0
  93. package/dist/mcp/tools/insights.d.ts +9 -0
  94. package/dist/mcp/tools/insights.d.ts.map +1 -1
  95. package/dist/mcp/tools/insights.js +6 -1
  96. package/dist/mcp/tools/insights.js.map +1 -1
  97. package/dist/mcp/tools/links.d.ts +26 -0
  98. package/dist/mcp/tools/links.d.ts.map +1 -0
  99. package/dist/mcp/tools/links.js +92 -0
  100. package/dist/mcp/tools/links.js.map +1 -0
  101. package/dist/mcp/tools/marketing-changes.d.ts +25 -0
  102. package/dist/mcp/tools/marketing-changes.d.ts.map +1 -0
  103. package/dist/mcp/tools/marketing-changes.js +108 -0
  104. package/dist/mcp/tools/marketing-changes.js.map +1 -0
  105. package/dist/mcp/tools/marketing-definitions.d.ts +11 -0
  106. package/dist/mcp/tools/marketing-definitions.d.ts.map +1 -0
  107. package/dist/mcp/tools/marketing-definitions.js +37 -0
  108. package/dist/mcp/tools/marketing-definitions.js.map +1 -0
  109. package/dist/mcp/tools/marketing-report.d.ts +7 -0
  110. package/dist/mcp/tools/marketing-report.d.ts.map +1 -1
  111. package/dist/mcp/tools/marketing-report.js +43 -5
  112. package/dist/mcp/tools/marketing-report.js.map +1 -1
  113. package/dist/mcp/tools/posts.d.ts.map +1 -1
  114. package/dist/mcp/tools/posts.js +16 -0
  115. package/dist/mcp/tools/posts.js.map +1 -1
  116. package/dist/mcp/tools/promises.d.ts +39 -0
  117. package/dist/mcp/tools/promises.d.ts.map +1 -0
  118. package/dist/mcp/tools/promises.js +98 -0
  119. package/dist/mcp/tools/promises.js.map +1 -0
  120. package/dist/mcp/tools/proposals.d.ts +26 -0
  121. package/dist/mcp/tools/proposals.d.ts.map +1 -0
  122. package/dist/mcp/tools/proposals.js +102 -0
  123. package/dist/mcp/tools/proposals.js.map +1 -0
  124. package/dist/mcp/tools/safe-zone-pixels.d.ts +165 -0
  125. package/dist/mcp/tools/safe-zone-pixels.d.ts.map +1 -0
  126. package/dist/mcp/tools/safe-zone-pixels.js +300 -0
  127. package/dist/mcp/tools/safe-zone-pixels.js.map +1 -0
  128. package/dist/mcp/tools/slideshow-render.d.ts.map +1 -1
  129. package/dist/mcp/tools/slideshow-render.js +3 -1
  130. package/dist/mcp/tools/slideshow-render.js.map +1 -1
  131. package/dist/mcp/tools/switchback.d.ts +36 -0
  132. package/dist/mcp/tools/switchback.d.ts.map +1 -0
  133. package/dist/mcp/tools/switchback.js +123 -0
  134. package/dist/mcp/tools/switchback.js.map +1 -0
  135. package/dist/mcp/tools/verification.d.ts +24 -0
  136. package/dist/mcp/tools/verification.d.ts.map +1 -0
  137. package/dist/mcp/tools/verification.js +124 -0
  138. package/dist/mcp/tools/verification.js.map +1 -0
  139. package/package.json +4 -2
@@ -23,7 +23,8 @@ send to the draft renderer, so it has to be valid on the first try.
23
23
 
24
24
  Follow the shot-list template: shot list table (time, visual, on-screen text, VO or audio, asset),
25
25
  safe zones, sound, and the mapping to the Creative's fields. Keep text out of the platform's UI
26
- (top ~14%, bottom ~35%, ~6% at each side for 9:16). For a `FILM` idea, include capture settings and
26
+ (9:16 at 1080x1920: text at y >= 290, above y=1490, out of the right 15% column; see
27
+ `references/platform-specs.md`). For a `FILM` idea, include capture settings and
27
28
  the ready-to-paste text. Pick the layout per
28
29
  `references/layout-guide.md`: `bleed` by default when 9:16 is enabled, `card` when the photo must stay
29
30
  readable or a face would sit under the copy. Never `stacked` or `split` when 9:16 is enabled. Build the
@@ -74,14 +74,24 @@ Automated checks are real but incomplete. These are the ones worth looking for b
74
74
  check, because none of them read pixels for meaning. Open and look at every photo.
75
75
  - **A generated image depicting a product, result or claim that is not real** (a made-up app screen,
76
76
  a before/after, an invented package) passes every check. Only looking catches it.
77
- - **A structurally valid render is not necessarily a good one.** The checks cover spill, safe zones,
78
- fonts and contrast, never whether the headline reads at a glance or the copy sits on a face. The
77
+ - **Finished images and clips are pixels the layout engine did not place.** CAROUSEL slides, CLIP
78
+ media and anything rendered outside Conductor (HTML, ffmpeg, Veo or another generator) can carry
79
+ text under the platform UI. `preview_creative_draft` now reads their text with OCR in the UI zones
80
+ and returns `safeZoneText` checks, but OCR misses stylised or low-contrast text, so still look at
81
+ slide 1 and the first frames of each video on the UI overlay sheet. At 1080x1920: nothing above
82
+ y=290, nothing below y=1490 (keep long-caption posts above about y=1250), nothing in the right 15%
83
+ column (see `references/platform-specs.md`). A `safeZoneUnchecked` check means OCR could not run
84
+ and it did NOT look: check by eye. `checks: []` means it looked and found nothing.
85
+ - **A structurally valid render is not necessarily a good one.** The layout checks cover spill, the
86
+ top and bottom safe zones, fonts and contrast, never whether the headline reads at a glance or the copy sits on a face. The
79
87
  design critique exists for this gap.
80
88
  - **A Brand Kit with no copy rules, or no accent-phrase requirement, never fails a save on that
81
89
  account.** That is permissive by design, which makes the model the only check on brand voice until
82
90
  someone configures rules.
83
91
  - **A draft is not a saved Creative.** A Creative or media id does not exist until
84
92
  `commit_creative_draft` runs; do not hand a draft's folder to `attach_creative_to_post` or a Post.
93
+ `attach_creative_to_post` also refuses a Creative whose finished pixels have a blocking safe-zone
94
+ error; fix the media, and use `ignoreSafeZone: true` only when the person has looked and accepts it.
85
95
  - **A stale write is refused, not overwritten.** `update_creative` requires the current `version`; a
86
96
  409 names the conflict. Reread with `get_creative` and reapply, do not retry blind.
87
97
  - **Rejected copy stays rejected.** Copy rules with ids starting `banned-` are lines or visuals the
@@ -28,9 +28,16 @@ needs changing until it fits.
28
28
  when the slides already exist as image files or library media. Slides are ordered per placement
29
29
  (`slides`, with `default` as the fallback) and each must match its placement's aspect. Reels,
30
30
  Stories and YouTube cannot take its photos. With a library music track (`audio.source` `track`)
31
- it also gets a 9:16 slideshow video (`slideshow.slideDurations`, 1 to 10 s per slide, default 3 s
32
- then 2.5 s; `zoom` default on), because no platform accepts a chosen track on photos. Each
31
+ it also gets a 9:16 slideshow video (`slideshow.slideDurations`, 1 to 10 s per slide; `zoom` default on), because no platform accepts a chosen track on photos. Each
33
32
  destination then sends the photos (silent) or that video (`carouselAs`: `photos` or `video`).
33
+ Pacing: always pass `slideshow.slideDurations` explicitly, per slide `clamp(2.4 + 0.14 x words, 3.0,
34
+ 4.8)` s from the words on that slide, plus 0.5 s for slide 1 and 0.5 s for an app-screen or chart
35
+ slide. The 0.5 s cross-fade comes out of each slide's time. Write each `slideAltText` entry as a
36
+ description ending in `Text: "first line" / "second line"` (the words on the slide, exactly, lines
37
+ separated by " / "; `Text: none` when there are none): the tool times each slide from these words
38
+ (and screen readers get the on-slide text), and when `slideDurations` is omitted it computes the
39
+ same formula itself (from the `Text:` part, or OCR). With no text at all the default is 3.5 s for
40
+ slide 1 and 3.0 s for the rest. Say the total length when showing the draft.
34
41
 
35
42
  - **Slideshow** (organic posts): native-looking slides made locally by `compose_slideshow` (photo with
36
43
  text, app screenshot with callouts, Notes page, chat, photo grid, stacked before/after, tier list,
@@ -296,8 +296,16 @@ Not every video needs the brand layout above — a finished clip (a demo recordi
296
296
  something a person or another tool already produced) can go up as-is. That's a CLIP Creative: no
297
297
  photo, headline or layout, just the video.
298
298
 
299
- A CLIP has no artwork to render, so it is the one flow without a draft preview: open the video
300
- itself and check it with the person before uploading.
299
+ A CLIP has no brand artwork to render, but `preview_creative_draft({kind: "CLIP", clipPath})` (or
300
+ `clipPaths` per placement) checks the finished video without uploading anything: it samples frames
301
+ every 0.5 s and at each scene cut, reads their text with OCR, returns the safe-zone `checks` and an
302
+ overlay sheet (see "Safe zones in finished pixels" below). Open the video itself and check it with the
303
+ person before uploading.
304
+
305
+ If you made the clip outside Conductor (ffmpeg, Veo or another generator, burned-in captions), lay
306
+ its text inside the safe zone before upload (numbers in `references/platform-specs.md`) and do not
307
+ rely on the preview check alone. Self-check: export frame 1 and the first frame after each cut, and
308
+ confirm every line of text starts below y=290.
301
309
 
302
310
  1. Check `list_creative_media({kind: "VIDEO"})` for a clip already in the project before uploading a
303
311
  new one. A new one goes through `upload_creative_media` (local path or URL) — same provenance
@@ -311,7 +319,7 @@ itself and check it with the person before uploading.
311
319
  nothing renders in a browser). With `audio` (below) it encodes a new MP4 on this machine with
312
320
  ffmpeg instead.
313
321
  4. `preview_creative` — returns a small poster sheet across placements instead of the STILL contact
314
- sheet, plus each placement's duration. Still worth a look: a poster is one frame, not the whole
322
+ sheet, plus each placement's duration, and runs the same safe-zone check on a saved 9:16 CLIP. Still worth a look: a poster is one frame, not the whole
315
323
  cut, so open the actual video before calling a rough or misframed clip done.
316
324
  5. `attach_creative_to_post`, same as any other Creative.
317
325
 
@@ -327,6 +335,10 @@ broadly.
327
335
 
328
336
  ## Finished images (carousel or single still)
329
337
 
338
+ When you render the slides yourself (HTML, Playwright, ffmpeg or any generator), lay the text inside
339
+ the safe zone before upload (numbers in `references/platform-specs.md`) and do not rely on the preview
340
+ check alone. Self-check: export slide 1 and confirm every line of text starts below y=290.
341
+
330
342
  Slides made by `compose_slideshow` take this same CAROUSEL route: pass its `slidePaths` to
331
343
  `preview_creative_draft` (see `references/slideshow-formats.md`).
332
344
 
@@ -356,10 +368,18 @@ thing).
356
368
  library (see "Music" below) also renders a 9:16 slideshow MP4 here: `preview_creative_draft`
357
369
  returns it as `slideshowVideoPath` beside the contact sheet, so watch it with the person, not
358
370
  just the sheet. `slideshow: {slideDurations, zoom}` sets the pace (one entry per 9x16 slide, 1 to
359
- 10 s; default 3 s for the first slide and 2.5 s for the rest) and the slow push-in (default on).
360
- Keep the total short: a 20-slide default runs about 40 s.
371
+ 10 s) and the slow push-in (default on). Always pass `slideDurations` explicitly, per slide
372
+ `clamp(2.4 + 0.14 x words, 3.0, 4.8)` s from the words on that slide, plus 0.5 s for slide 1 and
373
+ 0.5 s for an app-screen or chart slide. The 0.5 s cross-fade comes out of each slide's time, so
374
+ the total is the sum minus 0.5 s per cut. The tool computes the same formula itself when
375
+ `slideDurations` is omitted (from the `Text:` part of `slideAltText`, or OCR); with no text it
376
+ falls back to 3.5 s for the first slide and 3.0 s for the rest, so 20 slides run about 51 s.
377
+ Say the total length when showing the draft, and keep it short.
361
378
  4. Alt text: `slideAltText` has one entry per slide, in order (or a single Creative `altText`); readiness
362
- blocks without it. Slides are never rewritten, so check them for burned-in text, logos and claims
379
+ blocks without it. Each entry describes the picture, then ends with `Text: "first line" / "second
380
+ line"`, quoting the words on the slide exactly (lines separated by " / "); write `Text: none` for
381
+ a slide with no words. The tool times each slide from these words, and screen readers get the
382
+ on-slide text. Slides are never rewritten, so check them for burned-in text, logos and claims
363
383
  and approve with `photoChecked: true`.
364
384
  5. `get_creative` for `readiness` (slides, caption, altText, photoChecked block going READY), then
365
385
  `attach_creative_to_post` (it renders first if needed). The mapping: Instagram feed gets `4x5`
@@ -410,6 +430,19 @@ destination rewards video over an image.
410
430
 
411
431
  A reel or other vertical placement takes exactly one video, same as a CLIP.
412
432
 
433
+ ## Safe zones in finished pixels
434
+
435
+ The layout engine places text for STILL and MOTION Creatives, and checks it. Finished images and
436
+ clips (CAROUSEL slides, CLIP media, anything rendered outside Conductor) are pixels it did not place,
437
+ so `preview_creative_draft` reads their text with OCR in the UI zones instead and reports
438
+ `safeZoneText` checks (slide index or `atSeconds`, the box, the text, which platform's UI covers it).
439
+ It also returns an overlay sheet with Instagram and TikTok chrome drawn over the frames: `uiOverlay`
440
+ is `instagram | tiktok | both | none`, inlined by default for 9:16 CAROUSEL and CLIP (the TikTok
441
+ sheet is written to disk and its path returned). Look at it. OCR misses stylised or low-contrast
442
+ text, and a `safeZoneUnchecked` check means OCR could not run and nothing was checked. A blocking
443
+ error (text in the top zone on slide 1 or in the first 3 s) fails `passed`, and
444
+ `attach_creative_to_post` refuses the Creative unless `ignoreSafeZone: true`.
445
+
413
446
  ## Video from a still (generated clip)
414
447
 
415
448
  Only when the person asks for animation, motion, real movement or a video hook. Never offer it
@@ -18,10 +18,21 @@ ranking signals without notice, and the brief's own platform list always wins.
18
18
 
19
19
  ## Safe zone (9:16, 1080x1920)
20
20
 
21
- Use the Reels zone as the default for every vertical placement: keep text and faces out of the top
22
- ~14%, the bottom ~35% and ~6% at each side. That leaves a central band of roughly 1000 px of height
23
- for the hook, headline and CTA. TikTok's right-hand button column and caption area, and the Shorts
24
- channel and title strip, take comparable space (check current platform guidance).
21
+ Use one zone for every 9:16 surface: Reels, TikTok, Shorts, Stories and slideshow videos. Keep text
22
+ and faces inside this box:
23
+
24
+ | Zone | At 1080x1920 | Share | What covers it |
25
+ |---|---|---|---|
26
+ | Top | text at y >= 290 | about 15% | Reels header (about 260 px measured on iOS), TikTok tabs and search |
27
+ | Bottom | text above y=1490 (430 px reserved) | about 22% | caption, username, music row |
28
+ | Right | nothing right of x=918 between y=576 and y=1632 | right 15% (140 to 162 px) | like, comment and share column |
29
+
30
+ Long captions and hashtags grow upward, so on a post with a long caption keep text above about
31
+ y=1250 (the bottom ~35%). That leaves a central band of roughly 1000 px for the hook, headline and
32
+ CTA. Shorts' channel and title strip takes comparable space (check current platform guidance). The
33
+ layout engine reserves the top 290 px on `9x16` and `story` and checks it; for finished images and
34
+ clips, `preview_creative_draft` reads their text with OCR and its overlay sheet shows the platform UI
35
+ on top of the frames.
25
36
 
26
37
  ## Platforms
27
38
 
@@ -13,8 +13,8 @@ the Creative's own fields.
13
13
  | 0-3s | ... | ... | ... | <media id, "to film", or none> |
14
14
 
15
15
  ## Safe zones
16
- - Keep text out of the top ~14%, the bottom ~35% and ~6% at each side (9:16; check current
17
- platform guidance).
16
+ - At 1080x1920 keep text at y >= 290 and above y=1490 (above about y=1250 when the caption is long),
17
+ and out of the right 15% column (9:16; numbers in `references/platform-specs.md`).
18
18
  - Headline and CTA sit in the middle band. Nothing on a face.
19
19
 
20
20
  ## Sound
@@ -90,7 +90,8 @@ detail, and none may state a fact the brief does not support.
90
90
  - Every card reads like a person posted it (`voice.md`): a speaker, one real detail, no template
91
91
  frames, never a description of the photo.
92
92
  - Keep text between about y 16 and y 75 (percent of the 9:16 frame). That survives the 4:5 Instagram
93
- cut and the platform UI (top bar, bottom caption, right button column).
93
+ cut and the platform UI (top bar, bottom caption, right button column). In pixels the top limit is
94
+ y=290 of 1920 (15.1%), which y 16 (307 px) clears.
94
95
  - The first text of every slide needs `y`.
95
96
  - Read the composer's `checks`; an `error` severity blocks the preview.
96
97
 
@@ -345,7 +345,7 @@ any placement is fixed now, not shown.
345
345
  (layers: native, then the kit, then the spec's own top-level `style`, then the inline `style`); keep the
346
346
  result's `style`. Then
347
347
  `preview_creative_draft({kind: "CAROUSEL", brandKitId: <run.json brandKitId, the Creative's brand kit>, slidePaths, slideStyle: style, caption, slideAltText})` with the returned `slidePaths` (`9x16` for TikTok, `4x5` for Instagram),
348
- the caption from `publish-pack.json` and the alt text from `direction.md`. Record the preview's
348
+ the caption from `publish-pack.json` and the alt text from `direction.md`. Each `slideAltText` entry describes the picture, then ends with `Text: "first line" / "second line"`, quoting the words on the slide exactly (lines separated by " / "), or `Text: none` for a slide with no words; the tool times each slide from these words (and screen readers get the on-slide text). Pass `slideshow.slideDurations` computed per `references/capabilities.md`. Record the preview's
349
349
  `draftDir` as `drafts.final`.
350
350
  **Music:** a slideshow or clip with music uses `audio` on the Creative, and a track from
351
351
  `context/media.json` (`kind: "AUDIO"`, unblocked) is reused before any new file. A new music file
@@ -359,8 +359,8 @@ any placement is fixed now, not shown.
359
359
  `references/design-critique.md` (the slideshow criteria for a slideshow, the STILL criteria
360
360
  otherwise; any criterion below 3 is fixed before anyone sees it). For a STILL: does the headline read at a
361
361
  glance, does the accent phrase fall on the words that carry the meaning, is copy on a face, are
362
- the safe zones clear. For a slideshow: does slide 1 stop the scroll, is the text inside y 16 to 75,
363
- is the screenshot real, and is there no logo, badge or offer. Also read the result's `checks`/`passed`: while any blocking check fails,
362
+ the safe zones clear. For a slideshow: does slide 1 stop the scroll, is the text inside y 16 to 75 (and that holds for burned-in captions in CLIP videos too),
363
+ is the screenshot real, and is there no logo, badge or offer. Look at the UI overlay sheet the preview returns (`uiOverlay`), not just the clean frames. Also read the result's `checks`/`passed`: while any blocking check fails,
364
364
  fix it (`layoutOverrides` for photo height, `typeOverrides` for text size, a shorter body) and
365
365
  re-preview **before** showing anything, and never offer Approve & upload while one still fails.
366
366
  Revise at most twice beyond that; if it is still wrong, show it honestly and say what is off.
@@ -117,8 +117,8 @@ Change Work Item: `create_work_item` with `workflow` `MARKETING_CHANGES` (confir
117
117
  PRODUCT, CONTENT, BASELINE, OTHER), a `title`, `fields` `{hypothesis, baseline, evidence}` and `dueOn`
118
118
  as the review date. It starts PLANNED. Verify with `get_work_item`.
119
119
 
120
- For each change in `dueForReview`, offer to fill `outcome`, `verdict` (worked, did_not_work,
121
- inconclusive) and `lesson` with `update_work_item`, then move it to REVIEWED with `transition_work_item`
120
+ For each change in `dueForReview`, offer to fill `outcome`, `verdict` (worked, did_not_work, no_effect,
121
+ expected, inconclusive) and `lesson` with `update_work_item`, then move it to REVIEWED with `transition_work_item`
122
122
  (`get_available_transitions` first; that move may need a reviewer's approval, so report what happened).
123
123
  Use the person's wording for the verdict; propose, do not decide.
124
124