@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.
- package/assets/claude/agents/conductor-marketing-art-director.md +2 -1
- package/assets/claude/skills/conductor-marketing-create/SKILL.md +12 -2
- package/assets/claude/skills/conductor-marketing-create/references/capabilities.md +9 -2
- package/assets/claude/skills/conductor-marketing-create/references/direct.md +39 -6
- package/assets/claude/skills/conductor-marketing-create/references/platform-specs.md +15 -4
- package/assets/claude/skills/conductor-marketing-create/references/shotlist-template.md +2 -2
- package/assets/claude/skills/conductor-marketing-create/references/slideshow-formats.md +2 -1
- package/assets/claude/skills/conductor-marketing-create/references/team-run.md +3 -3
- package/assets/claude/skills/conductor-marketing-report/SKILL.md +2 -2
- package/assets/cli-manifest.json +261 -23
- package/dist/creative/assertions.js +30 -3
- package/dist/creative/frame.js +2 -2
- package/dist/creative/job/media.mjs +2 -2
- package/dist/creative/job/render.mjs +3 -0
- package/dist/creative/placements.js +2 -2
- package/dist/creative/placements.json +3 -3
- package/dist/creative/render.js +20 -8
- package/dist/lib/creative-render.d.ts +14 -1
- package/dist/lib/creative-render.d.ts.map +1 -1
- package/dist/lib/creative-render.js +3 -1
- package/dist/lib/creative-render.js.map +1 -1
- package/dist/lib/safe-zone/check.d.ts +31 -0
- package/dist/lib/safe-zone/check.d.ts.map +1 -0
- package/dist/lib/safe-zone/check.js +267 -0
- package/dist/lib/safe-zone/check.js.map +1 -0
- package/dist/lib/safe-zone/frames.d.ts +35 -0
- package/dist/lib/safe-zone/frames.d.ts.map +1 -0
- package/dist/lib/safe-zone/frames.js +132 -0
- package/dist/lib/safe-zone/frames.js.map +1 -0
- package/dist/lib/safe-zone/ocr.d.ts +42 -0
- package/dist/lib/safe-zone/ocr.d.ts.map +1 -0
- package/dist/lib/safe-zone/ocr.js +139 -0
- package/dist/lib/safe-zone/ocr.js.map +1 -0
- package/dist/lib/safe-zone/overlay.d.ts +59 -0
- package/dist/lib/safe-zone/overlay.d.ts.map +1 -0
- package/dist/lib/safe-zone/overlay.js +283 -0
- package/dist/lib/safe-zone/overlay.js.map +1 -0
- package/dist/lib/safe-zone/zones.d.ts +46 -0
- package/dist/lib/safe-zone/zones.d.ts.map +1 -0
- package/dist/lib/safe-zone/zones.js +84 -0
- package/dist/lib/safe-zone/zones.js.map +1 -0
- package/dist/lib/slideshow/compose.d.ts +2 -0
- package/dist/lib/slideshow/compose.d.ts.map +1 -1
- package/dist/lib/slideshow/compose.js +1 -1
- package/dist/lib/slideshow/compose.js.map +1 -1
- package/dist/lib/slideshow/css.d.ts +2 -0
- package/dist/lib/slideshow/css.d.ts.map +1 -1
- package/dist/lib/slideshow/css.js +9 -5
- package/dist/lib/slideshow/css.js.map +1 -1
- package/dist/lib/slideshow/html.d.ts +12 -3
- package/dist/lib/slideshow/html.d.ts.map +1 -1
- package/dist/lib/slideshow/html.js +16 -10
- package/dist/lib/slideshow/html.js.map +1 -1
- package/dist/lib/slideshow/spec-transport.d.ts.map +1 -1
- package/dist/lib/slideshow/spec-transport.js +4 -2
- package/dist/lib/slideshow/spec-transport.js.map +1 -1
- package/dist/lib/slideshow/spec.d.ts +8 -0
- package/dist/lib/slideshow/spec.d.ts.map +1 -1
- package/dist/lib/slideshow/spec.js +6 -0
- package/dist/lib/slideshow/spec.js.map +1 -1
- package/dist/lib/slideshow-pacing.d.ts +46 -0
- package/dist/lib/slideshow-pacing.d.ts.map +1 -0
- package/dist/lib/slideshow-pacing.js +98 -0
- package/dist/lib/slideshow-pacing.js.map +1 -0
- package/dist/mcp/index.d.ts +12023 -800
- package/dist/mcp/index.d.ts.map +1 -1
- package/dist/mcp/index.js +593 -13
- package/dist/mcp/index.js.map +1 -1
- package/dist/mcp/tools/ai-visibility.d.ts +18 -0
- package/dist/mcp/tools/ai-visibility.d.ts.map +1 -0
- package/dist/mcp/tools/ai-visibility.js +124 -0
- package/dist/mcp/tools/ai-visibility.js.map +1 -0
- package/dist/mcp/tools/budget.d.ts +35 -0
- package/dist/mcp/tools/budget.d.ts.map +1 -0
- package/dist/mcp/tools/budget.js +205 -0
- package/dist/mcp/tools/budget.js.map +1 -0
- package/dist/mcp/tools/creative-drafts.d.ts +16 -2
- package/dist/mcp/tools/creative-drafts.d.ts.map +1 -1
- package/dist/mcp/tools/creative-drafts.js +237 -31
- package/dist/mcp/tools/creative-drafts.js.map +1 -1
- package/dist/mcp/tools/creatives.d.ts +12 -3
- package/dist/mcp/tools/creatives.d.ts.map +1 -1
- package/dist/mcp/tools/creatives.js +235 -17
- package/dist/mcp/tools/creatives.js.map +1 -1
- package/dist/mcp/tools/creators.d.ts +15 -0
- package/dist/mcp/tools/creators.d.ts.map +1 -0
- package/dist/mcp/tools/creators.js +69 -0
- package/dist/mcp/tools/creators.js.map +1 -0
- package/dist/mcp/tools/growth-signals.d.ts +38 -0
- package/dist/mcp/tools/growth-signals.d.ts.map +1 -0
- package/dist/mcp/tools/growth-signals.js +135 -0
- package/dist/mcp/tools/growth-signals.js.map +1 -0
- package/dist/mcp/tools/insights.d.ts +9 -0
- package/dist/mcp/tools/insights.d.ts.map +1 -1
- package/dist/mcp/tools/insights.js +6 -1
- package/dist/mcp/tools/insights.js.map +1 -1
- package/dist/mcp/tools/links.d.ts +26 -0
- package/dist/mcp/tools/links.d.ts.map +1 -0
- package/dist/mcp/tools/links.js +92 -0
- package/dist/mcp/tools/links.js.map +1 -0
- package/dist/mcp/tools/marketing-changes.d.ts +25 -0
- package/dist/mcp/tools/marketing-changes.d.ts.map +1 -0
- package/dist/mcp/tools/marketing-changes.js +108 -0
- package/dist/mcp/tools/marketing-changes.js.map +1 -0
- package/dist/mcp/tools/marketing-definitions.d.ts +11 -0
- package/dist/mcp/tools/marketing-definitions.d.ts.map +1 -0
- package/dist/mcp/tools/marketing-definitions.js +37 -0
- package/dist/mcp/tools/marketing-definitions.js.map +1 -0
- package/dist/mcp/tools/marketing-report.d.ts +7 -0
- package/dist/mcp/tools/marketing-report.d.ts.map +1 -1
- package/dist/mcp/tools/marketing-report.js +43 -5
- package/dist/mcp/tools/marketing-report.js.map +1 -1
- package/dist/mcp/tools/posts.d.ts.map +1 -1
- package/dist/mcp/tools/posts.js +16 -0
- package/dist/mcp/tools/posts.js.map +1 -1
- package/dist/mcp/tools/promises.d.ts +39 -0
- package/dist/mcp/tools/promises.d.ts.map +1 -0
- package/dist/mcp/tools/promises.js +98 -0
- package/dist/mcp/tools/promises.js.map +1 -0
- package/dist/mcp/tools/proposals.d.ts +26 -0
- package/dist/mcp/tools/proposals.d.ts.map +1 -0
- package/dist/mcp/tools/proposals.js +102 -0
- package/dist/mcp/tools/proposals.js.map +1 -0
- package/dist/mcp/tools/safe-zone-pixels.d.ts +165 -0
- package/dist/mcp/tools/safe-zone-pixels.d.ts.map +1 -0
- package/dist/mcp/tools/safe-zone-pixels.js +300 -0
- package/dist/mcp/tools/safe-zone-pixels.js.map +1 -0
- package/dist/mcp/tools/slideshow-render.d.ts.map +1 -1
- package/dist/mcp/tools/slideshow-render.js +3 -1
- package/dist/mcp/tools/slideshow-render.js.map +1 -1
- package/dist/mcp/tools/switchback.d.ts +36 -0
- package/dist/mcp/tools/switchback.d.ts.map +1 -0
- package/dist/mcp/tools/switchback.js +123 -0
- package/dist/mcp/tools/switchback.js.map +1 -0
- package/dist/mcp/tools/verification.d.ts +24 -0
- package/dist/mcp/tools/verification.d.ts.map +1 -0
- package/dist/mcp/tools/verification.js +124 -0
- package/dist/mcp/tools/verification.js.map +1 -0
- 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
|
-
(
|
|
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
|
-
- **
|
|
78
|
-
|
|
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
|
|
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,
|
|
300
|
-
|
|
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
|
|
360
|
-
|
|
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.
|
|
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
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
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
|
-
-
|
|
17
|
-
platform
|
|
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
|
|