@cliangdev/conductor 0.27.0 → 0.28.0

package/assets/claude/agents/conductor-content-art-director.md

@@ -15,7 +15,7 @@ send to the draft renderer, so it has to be valid on the first try.
 - Read only the files you are given: `script.md`, `context/media.json`, `context/brand-kit.json`,
   `references/shotlist-template.md`, `references/platform-specs.md`, `references/capabilities.md` and
   `references/publish-pack-template.md` when given.
-- Write only your output files: `direction.md` and, for `RENDER`, `creative-spec.json`.
+- Write only your output files: `direction.md` and, for `RENDER`, `creative-spec.json`, plus `image-prompts.json` when `media.json` has `generate: true`.
 - Never call Conductor or any MCP tool.
 
 ## direction.md
@@ -45,7 +45,9 @@ A single JSON object whose keys are exactly `preview_creative_draft` inputs, and
 - `photoId`: only an id that appears in `media.json`; or `photoPath` only for a local file the person
   supplied, given in the request or listed as `local` in `media.json`. Never invent an id or a path.
   Every STILL, carousel and story needs a photo, and a MOTION needs a photo or clip (see
-  `references/capabilities.md`). If none is available, stop and say so in `direction.md` rather
+  `references/capabilities.md`). If `media.json` has `generate: true` and no library photo fits,
+  write `image-prompts.json` instead (below) and omit `photoPath`/`photoId` for those slots; the
+  orchestrator fills them. Otherwise, if none is available, stop and say so in `direction.md` rather
   than writing a spec the preview will refuse.
 - `typeOverrides` when text must read bigger or smaller on a placement, and `layoutOverrides` for
   photo height or focal point. Don't change layout just to resize text.
@@ -57,11 +59,21 @@ A single JSON object whose keys are exactly `preview_creative_draft` inputs, and
 - A story or carousel: `sequenceKind` (`story` 2 to 7 beats, `carousel` 2 to 10 cards, plus
   `carouselRatio` such as `4x5` or `1x1`) and a `sequence` array of beats, each with `headline`
   and optional `body`, `photoId` or `photoPath`, `cta`.
-- MOTION: `motion` (`preset`, `durationSec` 3 to 60, `background`, `endCard`) and optionally
-  `audio`. A clip background uses `background.clipMediaId` from `media.json`, or `clipPath` for a
+- MOTION: `motion.preset` (`fade-up`, `word-by-word`, `accent-pop` or `none`), `motion.durationSec`
+  (3 to 60), `motion.background` (`{source: "photo", motion: zoom-in|zoom-out|pan-left|pan-right|none}`
+  or `{source: "clip", clipMediaId}`), `motion.endCard`, and optionally top-level `audio`. A MOTION
+  renders one headline and one optional body plus an end card holding the final frame: no timed
+  multi-beat on-screen text (extra beats go in a story or carousel sequence, or the caption). A clip background uses `background.clipMediaId` from `media.json`, or `clipPath` for a
   user-supplied local file.
 - Omit any field you do not need. Do not add comments or fields the tool does not take.
 
+## image-prompts.json (only when `generate: true`)
+
+`{"photo": "<scene prompt>", "beats": {"2": "<scene prompt>"}}` next to the spec: `photo` for the
+main photo, `beats` keyed by sequence position for cards or beats that need their own. Each prompt
+describes the scene, subject, light, framing and where the negative space for the headline sits. No
+text in the image, and no product depiction unless a reference image is listed in `media.json`.
+
 ## Finish
 
 Return at most about 150 words: the layout and look in one sentence, any risk you see, and the

package/assets/claude/agents/conductor-content-scriptwriter.md

@@ -22,6 +22,10 @@ anything.
 1. Follow the script template exactly: hook, beats table, payoff, CTA, publish copy, copy-rule check.
 2. The hook lands within 3 seconds, spoken and on screen, and is what the winning idea promised.
 3. A new beat or pattern interrupt every 3 to 5 seconds. Everything works with the sound off.
+   Exception, a `MOTION` idea: Conductor renders exactly one headline and one optional body
+   (animated by preset) plus an end card that holds the final frame. Write one on-screen headline
+   and body, not timed beats of on-screen text; extra beats belong in a story or carousel sequence
+   or the caption.
 4. Respect the brief's must-say and must-avoid lists. Use approved lines verbatim. If the brand kit
    requires an accent phrase, mark exactly one `*phrase*` in on-screen headlines. Check every line
    against the copy rules and write the result in the final section.

package/assets/claude/commands/conductor/creative.md

@@ -48,7 +48,8 @@ Keep this light — one or two follow-up questions, not a form:
 
 - **Static ad / short video from a photo**: the headline (or let the skill draft one from the
   Knowledge page), and a photo. Call `list_creative_media({kind: "IMAGE"})` first and offer what's
-  already on hand before asking for a new photo. A new photo is a local file path (a URL: download it
+  already on hand before asking for a new photo; no photo fits and none is offered? Offer to generate one with
+  `generate_creative_image` (needs Codex installed and `codex login`). A new photo is a local file path (a URL: download it
   to a local file first) — it is only uploaded after the person approves the preview.
 - **Video from a clip I have / Post an existing video as-is**: call
   `list_creative_media({kind: "VIDEO"})` first; if nothing fits, ask for a local path (a URL:

package/assets/claude/skills/conductor-content-studio/SKILL.md

@@ -44,8 +44,9 @@ folder; give subagents absolute paths.
 
 ```
 request.md  run.json  brief.md  script.md  direction.md  creative-spec.json  decision.md
+image-prompts.json   (S5, only when generation is enabled)
 context/   brand-kit.json  knowledge.md  performance.md  learning.md  media.json
-ideas/     angle-1.md  angle-2.md  angle-3.md  pool.md
+ideas/     angle-1.md  angle-2.md  angle-3.md  pool.md  winner.md
 judging/   scores.md
 drafts/    finalist-<id>/   (contact sheets from the finalist renders)
 publish-pack.md  publish-pack.json   (S5b; see references/publish-pack-template.md)
@@ -124,8 +125,16 @@ Write `request.md` (the request verbatim, `--quick` if given, the platform if st
 6. Every renderable idea needs a photo (or, for MOTION, a clip); see `references/capabilities.md`. If
    `media.json` has no unblocked image and no clip, ask once with `AskUserQuestion` before ideating:
    **Give a photo or two** (local paths; record them in `context/media.json` as `local` entries the
-   art director may use via `photoPath`) or **Plan for filming** (ideas will be `FILM`). Never let
-   the team design a type-only still; the preview refuses it.
+   art director may use via `photoPath`), **Generate with Codex** (record `"generate": true` in
+   `context/media.json`; ideas can then be `RENDER` with no library photo, each giving an
+   `imagePrompt`, and photos are made with `generate_creative_image` from the person's local Codex CLI)
+   or **Plan for filming** (ideas will be `FILM`). Never let the team design a type-only still; the
+   preview refuses it.
+   When the library does have usable images, or the request itself asks for generated imagery, set
+   `"generate": true` without asking: ideas use a library photo when one fits and give an
+   `imagePrompt` only when none does. If `generate_creative_image` later fails (Codex missing, logged
+   out, or a plan without image generation), treat that finalist as unrenderable in S3b; at S6, say
+   why and ask for a photo instead of offering Approve & upload.
 
 ### S1 — Strategist -> `brief.md`
 
@@ -165,7 +174,9 @@ before each score, and names the top 3. Store the finalists in `run.json`.
 
 For each `RENDER` finalist, call `preview_creative_draft` with that idea's draft spec (map the
 draft-spec block to the tool's fields) and `draftDir` set to `<run>/drafts/finalist-<id>`. Use
-`full: false`. Record each draft dir in `run.json`.
+`full: false`. Record each draft dir in `run.json`. For a finalist whose draft spec carries an
+`imagePrompt`, call `generate_creative_image({prompt})` first, eye-check the result, and use its
+path as `photoPath` (generate only for finalists, not the whole pool).
 
 - If the validator refuses the copy (accent phrase or a copy rule), fix the copy once yourself and
   retry. If it still fails, mark that finalist unrenderable in `run.json`, keep its text score, and
@@ -176,7 +187,7 @@ draft-spec block to the tool's fields) and `draftDir` set to `<run>/drafts/final
   shorter body) and re-preview; otherwise keep it and record the failure for the judge.
 - `FILM` finalists have no render.
 
-### S3c — Creative director, visual round -> `decision.md`
+### S3c — Creative director, visual round (text-only with `--quick`) -> `decision.md`
 
 Same agent, mode `visual-round`. Inputs: `brief.md`, `judging/scores.md`, `ideas/pool.md`, the
 finalist image paths (`drafts/finalist-<id>/sheet.jpg`; the director views them with Read), the
@@ -194,11 +205,13 @@ which idea to take; show the decision at the gate.
 
 ### S4 — Scriptwriter -> `script.md`
 
-`Agent(subagent_type: "conductor-content-scriptwriter")` with `brief.md`, `decision.md`, the winning
-idea from `ideas/pool.md`, `references/script-template.md`, `references/platform-specs.md` and
+First copy the winning idea's block from `ideas/pool.md` to `ideas/winner.md`. Then
+`Agent(subagent_type: "conductor-content-scriptwriter")` with `brief.md`, `decision.md`, `ideas/winner.md`, `references/script-template.md`, `references/platform-specs.md` and
 `references/publish-pack-template.md`. Besides the script it writes the Publish copy section: a
 caption per platform, hashtags, a first comment and 2 to 3 alternate hooks with a hookType each.
-When merging into `publish-pack.json`, append each platform's hashtags to its `captionOverride`
+For a `MOTION` winner tell it that the render shows one headline and one optional body, animated
+by preset, then an end card that holds the final frame: no timed multi-beat on-screen text. Extra
+beats belong in a story or carousel sequence, or in the caption. When merging into `publish-pack.json`, append each platform's hashtags to its `captionOverride`
 (caption, blank line, hashtags): that field is posted verbatim.
 
 ### S5 — Art director (`RENDER` only) -> `direction.md` + `creative-spec.json`
@@ -212,8 +225,12 @@ Tell it the supported options: the kit's enabled placements, and the layouts and
 the creative registry supports (at the time of writing `stacked`, `bleed`, `split` dark only, `card` dark or
 light; a refusal from the validator names the valid ones). The spec's keys must be exactly
 `preview_creative_draft` inputs. Give it `references/capabilities.md` too. The spec's `name` is the
-idea's title only: never include the internal `I<n>` ID, which means nothing outside this run. A
-`FILM` winner skips S5 and goes to the shoot script, below.
+idea's title only: never include the internal `I<n>` ID, which means nothing outside this run. When
+`media.json` has `generate: true`, the art director may also write `image-prompts.json`
+(`{"photo": "...", "beats": {"2": "..."}}`) next to the spec. Before S6, call
+`generate_creative_image` for each prompt, eye-check each image, and set `photoPath` (or
+`sequence[i].photoPath`) in `creative-spec.json`. A `FILM` winner skips S5 and goes to the shoot
+script, below.
 
 ### S5b — Publish pack and pre-publish checks (you; RENDER after S5, FILM after the shoot script)
 
@@ -253,18 +270,23 @@ does not apply is answered "not applicable".
    re-preview **before** showing anything, and never offer Approve & upload while one still fails.
    Revise at most twice beyond that; if it is still wrong, show it honestly and say what is off.
 3. Show the person: the draft image, the finalist sheets of the runners-up (view them from
-   `drafts/finalist-<id>/sheet.jpg`; say when a runner-up could not be rendered), and a short decision
+   `drafts/finalist-<id>/sheet.jpg`; say when a runner-up could not be rendered; with `--quick` no
+   sheets exist, so show runners-up by title and tag only), and a short decision
    summary (the winner and why, the runners-up, what was cut and why), and a short pack summary: the
    disclosure setting (which toggle, or none), the AI-label setting, the sound and its licence, and
    the alternate hooks with their types.
 4. Ask with `AskUserQuestion`, header "Draft", with exactly these four options. `AskUserQuestion`
    allows at most four, so never add one per runner-up, and **Stop** must always be among them:
-   - **Approve & upload**: if the spec used a local file (`photoPath`, `clipPath`, `audioPath`),
-     first ask for its provenance (`source`, `licence`, and whether it is AI-generated) and pass
-     them to `commit_creative_draft({draftDir, source, licence, aiGenerated})`. Then
-     `get_creative` and read its `readiness`. If provenance or anything else blocking is missing,
-     say exactly what and ask for it; never call a Creative done while `ready` is false. After the
-     commit, write the Creative's id into `publish-pack.json` as `creativeId` (and into `run.json`).
+   - **Approve & upload**: the question says approving also confirms the photo carries no burned-in
+     text, logo or claim. Ask for provenance (`source`, `licence`, and whether it is AI-generated)
+     only for local files the preview lists in `provenance.needed` (a file from
+     `generate_creative_image` already carries it), then
+     `commit_creative_draft({draftDir, photoChecked: true, source, licence, aiGenerated})` (provenance
+     fields only when needed). Then `get_creative` and read its `readiness`. If `state` is the only
+     blocking item, `update_creative({creativeId, state: "READY"})` and verify with `get_creative`;
+     otherwise say exactly what is missing and ask for it. Never call a Creative done while `ready`
+     is false. After the commit, write the Creative's id into `publish-pack.json` as `creativeId` and
+     its state into `publish-pack.json` as `creativeState` (and both into `run.json`).
    - **Use a runner-up**: ask a second `AskUserQuestion` listing the runners-up by title (with
      their tag; label one that could not be rendered as such and say why, rather than offering it as
      if it would work). Then set the chosen idea as `winner` and re-run S4 onward for it (S5, S5b and S6,

package/assets/claude/skills/conductor-content-studio/references/capabilities.md

@@ -26,7 +26,8 @@ needs changing until it fits.
 
 - **A photo.** Every STILL needs one, and so does a carousel or story, whose beats inherit the main
   photo. A MOTION needs a photo or a clip as its background. There are no type-only stills. If
-  `media.json` has no usable (unblocked) image, a `RENDER` idea needs the person to supply a photo.
+  `media.json` has no usable (unblocked) image, a `RENDER` idea needs the person to supply a photo,
+  or `media.json` must have `generate: true` so the photo is made with `generate_creative_image`.
 - **A headline.** If the Brand Kit requires an accent phrase, the headline needs exactly one
   `*accent phrase*`.
 - **Copy rules and approved lines.** Every Brand Kit copy rule applies to the headline, body,
@@ -51,11 +52,19 @@ needs changing until it fits.
   text or a badge under the platform's buttons, is fixed before anyone is asked to approve.
 - **The caption is never drawn on the artwork.** It goes with the post.
 
+## Generated photos
+
+When `media.json` has `generate: true`, one generated photo per card or beat (or as a MOTION
+background) is renderable. It comes from `generate_creative_image` (the person's local Codex CLI):
+photographic, no text, logos or screens in the picture, and no depiction of the product unless a real
+reference image is supplied. It is `aiGenerated: true`. Collages, charts and text-in-image stay out.
+Ask for a mid-tone scene: under `bleed`, a dark or night scene can render almost black. For a dark scene, use `card` or `stacked`.
+
 ## What it cannot do (so the idea needs filming or a rethink)
 
 - Footage of people, places, cooking or the product in use. Screen recordings of an app.
 - Voiceover or spoken dialogue: MOTION has music or clip sound, not speech.
-- Grids, charts, collages of several photos on one card, illustrations, or generated images.
+- Grids, charts, collages of several photos on one card, illustrations, or text inside an image.
   Each card is one photo plus text.
 - Anything that relies on a product claim the brief can't confirm. That's a copy problem, not a
   rendering one: soften the claim or drop the idea.

package/assets/claude/skills/conductor-content-studio/references/compliance-checklist.md

@@ -41,6 +41,7 @@ disclose paid, gifted, employee and affiliate relationships; in video, disclose
 **Is any realistic imagery, video or voice AI-generated or AI-altered?** Check the Creative's and
 each media file's provenance (`aiGenerated` in `context/media.json`) and the script's visuals.
 
+- A photo from `generate_creative_image` is `aiGenerated: true`, so this is a **Yes**: the AI label / `isAigc` applies.
 - **Yes**: set TikTok `isAigc: true` on a video post. Conductor does not send `isAigc` on a TikTok
   photo post, so for a photo post note "turn on TikTok's AI label by hand" as a manual step. Set
   YouTube `containsSyntheticMedia: true`. Meta has no option: note that Instagram's and Facebook's

package/assets/claude/skills/conductor-content-studio/references/idea-template.md

@@ -28,10 +28,15 @@ Draft spec (RENDER only):
 - body: <max 20 words, or none>
 - caption: <the post caption, within the platform's limit>
 - photoId: <id from media.json, or none>
+- imagePrompt: <only when media.json has `generate: true` and no library photo fits: the scene in one line, no text in the image, no product depiction>
 - sequence: <for a story or carousel only: one line per beat, "headline | body">
 - motion: <MOTION only: preset, durationSec, background>
 ```
 
+The idea's format maps to the publish pack's `tags.format` as: still -> `still`; carousel ->
+`carousel`; story sequence -> `story`; motion text over photo or clip -> `motion`; talking head,
+demo, skit or other -> `film`.
+
 ## Sound
 
 An idea may not rely on a trending song. A business account cannot license most trending tracks, so
@@ -40,7 +45,7 @@ name original audio or a Commercial Music Library track, or leave sound out of t
 ## Tagging honestly
 
 - `RENDER` means Conductor can make it end to end: a still, a carousel, a story sequence, or motion
-  text over photos or clips that exist in `media.json` (or need no photo at all). Nothing in it
+  text over photos or clips that exist in `media.json` (or a generated photo, via `imagePrompt`, when `media.json` has `generate: true`; there are no type-only renders). Nothing in it
   requires a person to be filmed or footage that is not on hand.
 - `FILM` means it needs real filming: a person speaking to camera, a demonstration, a skit, a
   product in use. A `FILM` idea has no draft spec; it gets a shoot-ready script instead.

package/assets/claude/skills/conductor-content-studio/references/publish-pack-template.md

@@ -60,6 +60,7 @@ Run: <runId>   Creative: <display id, or "not yet committed">   Tags: hook <type
 ```json
 {
   "creativeId": null,
+  "creativeState": null,
   "platforms": [
     {
       "platform": "tiktok",
@@ -84,6 +85,7 @@ Rules:
 
 - `creativeId` is null until the person approves the commit (S6, On Approve), then it is the
   Creative's id. A `FILM` run leaves it null: the publisher is pointed at the pack by the person.
+- `creativeState` is the Creative's state after S6 (`READY`, or `DRAFT` if something still blocks it).
 - `platforms[]` items are shaped to drop straight into `create_post` targets or
   `set_publish_targets` targets: `platform`, `format` (`feed`, `reel` or `story`, and only one the destination's `formats` offers: at the time
   of writing TikTok and YouTube are feed only, Facebook and Instagram offer all three),
@@ -117,5 +119,5 @@ Rules:
 - `alternateHooks` and `tags` are for learning and experiments, not for publishing. `tags` is also
   copied into `run.json`.
 - `tags.angle` is the ideator's angle: `story-emotion`, `utility-education` or `trend-humor`.
-  `tags.format` is the idea's format (`still`, `carousel`, `story`, `motion`, `clip` or `film`).
+  `tags.format` is the idea's format (`still`, `carousel`, `story`, `motion`, `clip` or `film`; map the idea template's formats: story sequence -> `story`, motion text over photo or clip -> `motion`, talking head, demo, skit or other -> `film`; `clip` is for a finished video posted as-is).
 - Valid JSON, no comments.

package/assets/claude/skills/conductor-content-studio/references/script-template.md

@@ -48,6 +48,6 @@ curiosity-gap, story, social-proof.
 <each must-say / must-avoid item from brief.md, and ok or the fix>
 ```
 
-Rules: a beat every 3 to 5 seconds; no beat longer than 5 seconds without a visual or text change;
+Rules: a beat every 3 to 5 seconds (a `MOTION` idea instead has one headline, one optional body and an end card, with no timed on-screen beats); no beat longer than 5 seconds without a visual or text change;
 caption limits are in `platform-specs.md`; alternates differ from the main hook in hook type, not just wording (check current platform guidance); approved lines run
 verbatim; leave out platforms the brief did not ask for.

package/assets/claude/skills/conductor-creative/SKILL.md

@@ -83,7 +83,20 @@ to `commit_creative_draft`, which records them on every file it uploads. This cl
 exposure: an unattributed or unlicensed photo running as paid or organic media. A photo already in
 the library is used by its id (`photoId`) with no upload at all.
 
-**Open the photo and look at it before using it.** A picture can break every copy rule with text,
+**Nothing in the library fits, or the person asks for a generated one?** Call
+`generate_creative_image` with a scene prompt drawn from the brand's Knowledge page and the angle:
+the scene, subject, light, framing and where the headline's negative space sits. The tool adds its own
+fixed rules (photographic, no text, letters, logos, UI or phone screens) and runs the person's local
+Codex CLI, so it needs `codex login` on a ChatGPT Plus (or higher) plan (`conductor doctor` reports the login), takes about 30-90 s and uses
+their Codex quota. It returns the first image plus `files[].path`; pass a path as `photoPath` (or
+`sequence[].photoPath`). When the real product must appear, list a real shot in
+`referenceImagePaths` — never describe an invented product. Each file gets a provenance sidecar
+(`aiGenerated: true`) that the preview and commit use automatically, so don't ask about it, and the
+AI label applies. A 1024x1536 image cropped to 9:16 may draw the "soft, upscaled photo" warning:
+mention it, don't fight it.
+
+**Open the photo and look at it before using it** — a generated one most of all (pseudo-text, warped
+hands or faces, a fake product or app screen). A picture can break every copy rule with text,
 a logo or a claim burned into its pixels, and no automated check can see that — this is the first
 of this skill's silent failure modes (the full list is below). A human or a prior pass marks a bad
 photo `blocked`; if you notice one that should be, say so rather than using it anyway.
@@ -155,15 +168,25 @@ Only once `passed` is true, show the image to the person and ask with `AskUserQu
 **Approve & upload**, **Request changes**, **Stop**. If `passed` is false you are not at this step
 yet: fix it and re-preview first (step 6). On changes, preview again with the edits (another draft; nothing was saved). On
 Stop, leave it: the draft stays on this machine under `.conductor/drafts/` and is cleaned up
-automatically once it is committed or two weeks old. Only on **Approve & upload**, call
-`commit_creative_draft({draftDir})` with the `draftDir` the approved preview returned.
+automatically once it is committed or two weeks old. Say in the question that approving
+also confirms the photo carries no burned-in text, logo or claim. Only on **Approve & upload**, call
+`commit_creative_draft({draftDir, photoChecked: true})` with the `draftDir` the approved preview
+returned, plus provenance (`source`, `licence`, `aiGenerated`) only for local files the preview
+lists in `provenance.needed`. Pass `photoChecked` only after that approval, never on your own
+judgement.
 
 ### 8. Check readiness before calling it done
 
-The preview already lists the readiness gaps, so fix what you can (caption, alt text, a checked
-photo) before asking for approval. After the commit, `get_creative` includes a `readiness` block: caption, alt text, the photo's checked/blocked state
-and provenance, and the Creative's own state (not `DRAFT`) are blocking; an AI-generation disclosure
-is informational only. Do not call a Creative done while `ready` is false.
+The preview already lists the readiness gaps (including a local file's sidecar provenance), so fix
+what you can (caption, alt text) before asking for approval; the photo check is cleared by the
+approval itself (`photoChecked: true` on the commit, for files that commit uploads; a library photo
+keeps its own verdict). After the commit, `get_creative` includes a `readiness` block: caption, alt
+text, the photo's checked/blocked state and provenance, and the Creative's own state (not `DRAFT`)
+are blocking; an AI-generation disclosure is informational only (when publishing, turn on the
+platform's AI-generated label). If the only blocking item left is `state`, call
+`update_creative({creativeId, state: "READY"})` and verify with `get_creative`; the backend refuses
+READY while anything else blocking fails. Otherwise name exactly what is missing and ask. Do not
+call a Creative done while `ready` is false.
 
 ### 9. Commit, then hand off
 
@@ -223,7 +246,7 @@ A MOTION Creative animates the same brand layout from steps 1-5 above into a sho
 of a static frame — no separate video tool needed. Use it when a still doesn't hold attention, or a
 destination rewards video over an image.
 
-1. Pick a photo (step 5) or, for a moving background, a video — check `list_creative_media({kind:
+1. Pick a photo (step 5; a generated photo works here too) or, for a moving background, a video — check `list_creative_media({kind:
    "VIDEO"})` first and use its media id if something fits; otherwise pass the local file as
    `clipPath` (previewed from disk, uploaded on commit). For background music,
    `list_creative_media({kind: "AUDIO"})` the same way, else `audioPath`.
@@ -240,6 +263,10 @@ destination rewards video over an image.
    - `audio` — `source: "clip"` (the background clip's own recorded sound — the default when there
      is one), `"track"` (a separate library track: `trackId` from `upload_creative_media`, plus
      `volume` and `fadeOutSec`), or `"none"`.
+
+   A MOTION Creative is one animated frame per placement: it cannot also be a story or a carousel
+   (`sequenceKind`/`sequence`) — that is refused with a 422 (`motionNoSequence`). For several beats, make
+   one MOTION Creative per beat, or a STILL story/carousel.
 3. The preview renders three key moments across the timeline into one sheet image (not the finished
    video). Judge it the same honest way as step 7 above — does the copy's entrance finish before the
    next beat, does the end card actually hold long enough to read — and get approval before
@@ -260,6 +287,8 @@ Automated checks are real but incomplete. These are the ones worth remembering t
 - **A photo with text, a logo or a claim burned into its pixels** passes every copy-rule and
   render check, because none of them look at pixels for meaning — only step 5's "open and look at
   it" catches this.
+- **A generated image depicting a product, result or claim that isn't real** (a made-up app screen,
+  a before/after, an invented package) passes every check — only looking at it catches it.
 - **A structurally valid render is not necessarily a good one.** The render's own assertions check
   spill, safe zones, fonts and contrast — never whether the headline reads at a glance or the copy
   sits on the subject's face. Step 7 exists because of this gap.

package/assets/cli-manifest.json

@@ -832,6 +832,14 @@
         "creativeId"
       ]
     },
+    {
+      "name": "generate_creative_image",
+      "description": "Generate a photo locally with the Codex CLI (needs codex login): no text in the image, returns it with local paths and a provenance sidecar. Pass a path as photoPath to preview_creative_draft.",
+      "category": "marketing",
+      "requiredParams": [
+        "prompt"
+      ]
+    },
     {
       "name": "preview_creative_draft",
       "description": "Look at a Creative before anything is saved: renders a draft locally from the create_creative fields plus local files (photoPath, clipPath, audioPath) and returns the contact sheet as an image. Never writes to Conductor; commit only after the person approves.",

package/dist/commands/doctor.d.ts

@@ -1,6 +1,11 @@
 import { Command } from 'commander';
+import { type CodexStatus } from '../lib/codex-image.js';
 export declare function checkApiHealth(apiUrl: string): Promise<boolean>;
 export declare function checkMcpJson(workingDir: string): boolean;
 export declare function checkConfigFile(): boolean;
+export declare function describeCodexStatus(status: CodexStatus): {
+    status: 'pass' | 'warn';
+    message: string;
+};
 export declare function registerDoctor(program: Command): void;
 //# sourceMappingURL=doctor.d.ts.map

package/dist/commands/doctor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAMnC,wBAAsB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOrE;AAED,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAExD;AAED,wBAAgB,eAAe,IAAI,OAAO,CAEzC;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA+GrD"}
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAInC,OAAO,EAAiB,KAAK,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAGvE,wBAAsB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOrE;AAED,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAExD;AAED,wBAAgB,eAAe,IAAI,OAAO,CAEzC;AAID,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,WAAW,GAAG;IAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAMrG;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA0HrD"}

package/dist/commands/doctor.js

@@ -4,6 +4,7 @@ import * as os from 'os';
 import chalk from 'chalk';
 import { readConfig, CONFIG_PATH } from '../lib/config.js';
 import { getAssetSrcDir, getPluginInstallStatus } from '../lib/plugin-assets.js';
+import { checkCodexCli } from '../lib/codex-image.js';
 import { printNextSteps } from '../lib/next-steps.js';
 export async function checkApiHealth(apiUrl) {
     try {
@@ -20,6 +21,15 @@ export function checkMcpJson(workingDir) {
 export function checkConfigFile() {
     return fs.existsSync(CONFIG_PATH);
 }
+const CODEX_CHECK_NAME = 'Codex CLI (image generation)';
+export function describeCodexStatus(status) {
+    if (status.state === 'ready')
+        return { status: 'pass', message: `${CODEX_CHECK_NAME}: ${status.version}, logged in` };
+    if (status.state === 'logged-out') {
+        return { status: 'warn', message: `${CODEX_CHECK_NAME}: ${status.version} installed but not logged in — run \`codex login\`` };
+    }
+    return { status: 'warn', message: `${CODEX_CHECK_NAME}: not found — npm i -g @openai/codex, then \`codex login\` (optional; only needed to generate photos)` };
+}
 export function registerDoctor(program) {
     program
         .command('doctor')
@@ -72,6 +82,8 @@ Examples:
             if (location !== 'none' && outdated) {
                 checks.push({ name: 'plugin-version', status: 'warn', message: 'Claude plugin outdated — re-run conductor init to update' });
             }
+            const codex = describeCodexStatus(await checkCodexCli());
+            checks.push({ name: 'codex', status: codex.status, message: codex.message });
             const allPass = checks.every(c => c.status !== 'fail');
             process.stdout.write(JSON.stringify({ checks }, null, 2) + '\n');
             process.exit(allPass ? 0 : 1);
@@ -118,6 +130,14 @@ Examples:
             console.log(`${chalk.yellow('⚠')} Claude plugin outdated — re-run conductor init to update`);
             warnings++;
         }
+        const codex = describeCodexStatus(await checkCodexCli());
+        if (codex.status === 'pass') {
+            console.log(`${chalk.green('✓')} ${codex.message}`);
+        }
+        else {
+            console.log(`${chalk.yellow('⚠')} ${codex.message}`);
+            warnings++;
+        }
         if (failures === 0 && warnings === 0) {
             printNextSteps();
         }

package/dist/commands/doctor.js.map

@@ -1 +1 @@
-{"version":3,"file":"doctor.js","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"doctor.js","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"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"}

package/dist/creative/assertions.js

@@ -22,6 +22,12 @@
  * loaded (including a bleed layout's CSS background photo, invisible to a
  * plain <img> check), headline contrast, the accent colour, and the
  * rendered box size.
+ *
+ * Presence checks (`missingPhoto`, `missingLockup`, `missingHeadline`): every check above judges what
+ * IS on the board, so a board that silently lost its photo or logo used to pass them all. The caller
+ * says what the spec requires (`expect`, see expectedElements) and a required element that is absent,
+ * collapsed or hidden fails. `bodyDropped` is the one warning in this family: a layout that has no room
+ * for the body line at a placement drops it by design, but the author supplied that copy.
  */
 
 /* ── pure math ─────────────────────────────────────────────────────────── */
@@ -86,6 +92,19 @@ export function safeZoneIntrusion(boardRect, nodes, safe) {
   return issues;
 }
 
+/** Pure: what a render requires on the board, from the resolved ad and the brand kit it renders with —
+ * `{ photo, lockup, headline }`. A photo is required when the ad has a photo URL (a clip-only background
+ * does not need one); a lockup when the kit has a mark or a wordmark (a kit without logos renders none,
+ * by design); a headline when the ad has one. Pass the result as `runAssertions`'s `expect`. */
+export function expectedElements(ad, brand) {
+  const logos = (brand && brand.logos) || {};
+  return {
+    photo: Boolean(ad && ad.photoUrl),
+    lockup: Boolean(logos.mark || logos.wordmarkLight || logos.wordmarkDark),
+    headline: Boolean(ad && ad.headline && String(ad.headline).trim()),
+  };
+}
+
 /* ── DOM-dependent (real browser only) ────────────────────────────────────── */
 
 const CHECKED_SELECTOR = '.cc-headline, .cc-body, .cc-cta, .cc-lockup';
@@ -116,9 +135,10 @@ function sameRgb(a, b) {
 /* Runs every check against a live, fitted `.cc-board` and returns
  * `{ errors, warnings, width, height }`. `placement` is this placement's own
  * registry entry (pixel size, safe zone); `brand` is the same object handed
- * to renderBoard. An empty `errors` array means the frame is safe to ship;
- * `warnings` are non-fatal (e.g. a soft, upscaled photo). */
-export async function runAssertions(board, placement, brand, { outputScale = 2 } = {}) {
+ * to renderBoard; `expect` (optional, see expectedElements) names the elements the spec requires, so a
+ * missing one fails. An empty `errors` array means the frame is safe to ship; `warnings` are non-fatal
+ * (e.g. a soft, upscaled photo, or a body line the layout drops at this placement). */
+export async function runAssertions(board, placement, brand, { outputScale = 2, expect = null } = {}) {
   const errors = [];
   const warnings = [];
   // The same findings with a stable `rule` id each, for callers (the draft preview) that report them
@@ -128,9 +148,9 @@ export async function runAssertions(board, placement, brand, { outputScale = 2 }
     errors.push(message);
     checks.push({ rule, severity: 'error', message });
   };
-  const warn = (rule, message) => {
+  const warn = (rule, message, extra) => {
     warnings.push(message);
-    checks.push({ rule, severity: 'warning', message });
+    checks.push({ rule, severity: 'warning', message, ...extra });
   };
   const br = rectOf(board);
 
@@ -155,14 +175,44 @@ export async function runAssertions(board, placement, brand, { outputScale = 2 }
     }
   }
 
+  // ── required elements: present, sized and visible (a spec that names them must get them) ──
+  if (expect) {
+    const shown = (n) => {
+      if (!n) return false;
+      const r = n.getBoundingClientRect();
+      const cs = getComputedStyle(n);
+      return r.width > 0 && r.height > 0 && cs.display !== 'none' && cs.visibility !== 'hidden';
+    };
+    if (expect.headline) {
+      const h = board.querySelector('.cc-headline');
+      if (!h || !h.textContent.trim() || !shown(h)) fail('missingHeadline', 'the headline is missing from the rendered frame');
+    }
+    if (expect.lockup && !shown(board.querySelector('.cc-lockup:not(.cc-lockup--spacer)'))) {
+      fail('missingLockup', 'the brand logo lockup is missing from the rendered frame (the brand kit has a logo)');
+    }
+    if (expect.photo) {
+      const layer = board.querySelector('.cc-bg-photo') || board.querySelector('.cc-board__band img, .cc-board__card img');
+      const hasImage = layer && (layer.tagName === 'IMG'
+        ? Boolean(layer.getAttribute('src')) && layer.complete && layer.naturalWidth > 0
+        : /url\(/.test(getComputedStyle(layer).backgroundImage || ''));
+      if (!shown(layer) || !hasImage) fail('missingPhoto', 'the photo is missing from the rendered frame (the spec has a photo URL)');
+    }
+  }
+  if (board.dataset.bodyDropped === 'true') {
+    const layout = board.dataset.layout || 'this layout';
+    const key = board.dataset.ratio;
+    warn('bodyDropped', `the body line is not shown: the ${layout} layout drops the body at ${key}. Put the words in the headline, or pick another layout or placement.`, { placementKey: key });
+  }
+
   const imgs = [...board.querySelectorAll('img')];
   const broken = imgs.filter((i) => !i.complete || i.naturalWidth === 0).map((i) => i.getAttribute('src'));
   if (broken.length) fail('image', `image(s) failed to load: ${broken.join(', ')}`);
 
-  // A bleed/card layout paints its photo as a CSS background, invisible to
+  // A bleed layout paints its photo as a CSS background (the `.cc-bg-photo` layer), invisible to
   // the <img> check above — probe it directly, the same way a typo'd path
   // would otherwise export a flat, photo-less board and pass everything else.
-  const bgImage = getComputedStyle(board).backgroundImage;
+  const photoLayer = board.querySelector('.cc-bg-photo');
+  const bgImage = getComputedStyle(photoLayer || board).backgroundImage;
   const bgUrlMatch = /url\("?(.+?)"?\)/.exec(bgImage || '');
   if (bgUrlMatch && bgUrlMatch[1]) {
     const probe = await new Promise((done) => {

package/dist/creative/font.js

@@ -37,3 +37,32 @@ export async function ensureBrandFont(brand) {
     await Promise.all([400, 700].map((w) => document.fonts.load(`${w} 32px "${family}"`).catch(() => [])));
   }
 }
+
+/* Waits until every picture under `root` has loaded: each <img> (the logo lockup, the badge, a band/card
+ * photo) AND each bleed photo layer, which is a CSS background and so is not in `document.images` — the
+ * page's `load` event does not wait for it either. Without this a screenshot (the contact sheet most of
+ * all, which never ran this wait) could be taken before the photo or logos had arrived: a board with no
+ * photo and no logo that nothing flagged. A picture that fails to load resolves anyway; it is
+ * assertions.js's job (frame.html) to report it. Browser-only; a no-op outside a document. */
+export async function settleImages(root) {
+  if (typeof document === 'undefined') return;
+  const scope = root || document;
+  const loads = [...scope.querySelectorAll('img')].map((img) => (
+    img.complete ? Promise.resolve() : new Promise((done) => {
+      img.addEventListener('load', done, { once: true });
+      img.addEventListener('error', done, { once: true });
+    })
+  ));
+  for (const layer of scope.querySelectorAll('.cc-bg-photo')) {
+    const m = /url\("?(.+?)"?\)/.exec(getComputedStyle(layer).backgroundImage || '');
+    if (!m) continue;
+    loads.push(new Promise((done) => {
+      const probe = new Image();
+      probe.onload = done;
+      probe.onerror = done;
+      probe.src = m[1];
+    }));
+  }
+  await Promise.all(loads);
+  await Promise.all([...scope.querySelectorAll('img')].map((img) => (img.decode ? img.decode().catch(() => {}) : null)));
+}