@hypersocial/decks-cli 0.9.5 → 0.9.7

package/README.md

@@ -34,7 +34,7 @@ decks activity
 
 ## Auth
 
-`decks login` opens the production broker at `https://decks.hypersocial.ai` and
+`decks login` opens the production broker at `https://hyperdecks.ai` and
 stores a refresh credential in:
 
 ```text
@@ -261,7 +261,7 @@ Capture defaults to the initial slide, 4 seconds, 600px width and 10 fps, with a
 `--json` prints one line on stdout, identical to `<out>/manifest.json`:
 
 ```json
-{ "status": "exported | uploaded | failed", "shareUrl": "https://decks.hypersocial.ai/v/<token>",
+{ "status": "exported | uploaded | failed", "shareUrl": "https://hyperdecks.ai/v/<token>",
   "files": [{ "type": "gif | png | mp4", "path": "...", "url": "https://...convex.cloud/api/storage/...", "bytes": 74662, "width": 600, "height": 338 }],
   "email": { "sendable": true, "path": "<out>/email.html", "html": "<a href=\"<shareUrl>\"><img src=\"<gif url>\" ...></a>" },
   "warnings": [] }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hypersocial/decks-cli",
-  "version": "0.9.5",
+  "version": "0.9.7",
   "description": "Command-line client for Hypersocial Decks live analytics and share management.",
   "type": "module",
   "main": "./src/commands.mjs",

package/skills/hyperdecks/SKILL.md

@@ -225,7 +225,7 @@ The deck contract (`check` enforces or warns on each line):
   so put slots on different sides across slides, as the scaffold's
   `.slot-left` does); the first slide has `data-intro`.
 - The player script stays
-  `<script type="module" src="https://decks.hypersocial.ai/player/v1/player.js" data-manifest="…">`.
+  `<script type="module" src="https://hyperdecks.ai/player/v1/player.js" data-manifest="…">`.
   `narrate` fills `data-manifest`; do not edit it by hand.
 - A deck with no narration (a product tour, an imported design deck, a silent
   walkthrough) says so: `data-silent` on the player script. `check` then warns
@@ -448,11 +448,8 @@ saves one.
 
 <!-- font pairings -->
 
-**Icons: real ones first.** `hyperdecks icons search <word>` (`search_icons`)
-returns Lucide line icons as inline SVG stroked in `currentColor`, so they take
-the deck's colours: paste the `<svg>` in place of a features card's icon. Use
-`icons <subject...> --style` (`generate_icon_set`) only for illustrated icons
-in a style of your own.
+**Textures, icons, pictures:** the `look` topic (one texture, one icon set
+from `search_icons` or `generate_icon_set`, a picture on every other slide).
 
 **Pick the layout from what the slide says.** Each layout's file in
 `templates/layouts/` opens with its slot side, presenter and the cues that
@@ -463,6 +460,7 @@ suit it.
 | `hero` | the opening, a section opener; the presenter is the visual, no `.art` unless it shows the real subject (check fails while the placeholder `<div class="art">` is in: swap it for an `<img class="art">` or delete it) | stage, bottom-right; `[wave]`, `[look: h1]` |
 | `number` | one number with its source: proof, traction, a delta | stage; `[look: #<id>-figure]` as it is said |
 | `product` | a screenshot in a browser frame (`.frame.card` for a phone) with the point beside it | stage; `[look: #<id>-frame]`, `[reveal: #<id>-callout]` |
+| `split` | the workhorse: a real picture (phone, laptop, 16:9) beside sticker, title, three ticks | stage, bottom-left; `[look: #<id>-frame]`, `[go: #<id>-t1]` … `t3` |
 | `phones` | a phone app's flow: a fanned row of phone cards | stage, bottom-left; `[go: #<id>-p1]` … `p3`, `[go: slot]` |
 | `quote` | a customer or user in their own words, quoted exactly | stage, bottom-left; `[look: #<id>-quote]` |
 | `compare` | before/after, them/us, three parallel lines each | stage; `[look: #<id>-before]`, `[go: #<id>-after]` |
@@ -476,12 +474,10 @@ suit it.
 two to four: `phones` (`--tilt`, `--shadow` on a card). A few slides at most:
 `bg-dots` (never under text), a `.deco` of inked tiles.
 
-Presenter style follows the deck (step 2, *Which presenter style*): `stage`
-when the presenter carries the story, which is what the layouts are drawn for
-(they keep the slot's corner clear); `corner` on a slide where a big
-visual is the point and moves are not needed; `glass` on a dark or busy
-picture. Three layouts (`quote`, `phones`, `closer`) sit left; put a `slot-left` on others
-where there is room so slide changes move the presenter.
+Presenter style follows the deck (step 2): `stage` when the presenter carries
+the story (the layouts keep the slot's corner clear); `corner` where a big
+visual is the point; `glass` on a dark or busy picture. `quote`, `split`,
+`phones` and `closer` sit left; add `slot-left` elsewhere where there is room.
 
 **Visuals: real first, generated second.**
 
@@ -495,10 +491,12 @@ where there is room so slide changes move the presenter.
   floating shapes, abstract "tech" art, clip-art metaphors) makes a deck look
   cheap. A visual earns its place only if it shows something real from the
   story: the product, the data, a concrete situation or object. When in doubt,
-  leave it out: one big statement in type beats a picture of nothing. The
-  presenter is the hero of the opening slide; don't put art behind it.
-- Icons: only when they label something the viewer must tell apart at a
-  glance. Three short statements set large usually beat three icon cards.
+  leave it out: one big statement in type beats a picture of nothing. But a
+  deck of nothing but type is not the answer: reach for the real things
+  first (`look` topic). The presenter is the hero of the opening slide;
+  don't put generated art behind it.
+- Icons: from the deck's one set (`look` topic), labelling things or in a
+  `.sticker`; not one per sentence. Bullets are `.ticks`.
 - Images: `gen-image` (`generate_image`) only for a concrete subject the
   deck is about (a product in use, a place, a real object), never a metaphor.
   One style per deck, described the same way every time (subject, medium,
@@ -543,6 +541,61 @@ still.
 - No CSS animation on slides beyond `.reveal`; the player animates the slide
   change.
 
+<!-- topic: look -->
+#### Look: textures, icons, pictures
+
+What the house decks do that a plain agent deck doesn't. Decide these three
+once per deck, before writing slides, and say them in your plan.
+
+**1. A picture on at least every other slide**, the most real one you have:
+
+1. the product itself: `capture_url` (phone: width 390, height 844), or a
+   screen recording or photo the person gives you (`upload_deck_asset`);
+2. their people, logos and app icons (with permission);
+3. real data drawn with `render_chart`;
+4. only then `generate_image`, of a concrete subject (a place, an object,
+   the product in use), never a metaphor or abstract "tech" art.
+
+No product to show (a plan, a strategy)? Make the slides visual with type
+and the kit below: a `number` slide, stickers, ticks on a `panel`.
+
+**2. One texture**, on two or three slides (an opener, a closer, a slide
+with a visual), never under body text. On the section:
+
+| Class | Looks like | For |
+|---|---|---|
+| `bg-lines` | diagonal speed lines fading toward `--fade-at` | product slides, beside a picture |
+| `bg-halftone` | a corner of halftone dots | openers, numbers |
+| `bg-rays` | rays from `--rays-at` | an opener or a closer |
+| `bg-dots` | a fading dot grid | a phones row |
+
+Grounds carry the rest: alternate `on-accent`, plain, `on-ink` and the soft
+washes `on-tint`, `on-tint-2`, `on-tint-3` so each slide change reads.
+
+**3. One icon set.** Pick one source and keep it for every icon in the deck:
+Lucide (`search_icons`, same `strokeWidth` throughout); or one
+`generate_icon_set` call with every subject you need and one `preset`
+(`line`, `duotone`, `sticker`, `clay`; the palette defaults to the brand's);
+or the product's own app icons and logos. Never mix two.
+Put an icon or logo in a `.sticker` (tilted tile, hard shadow) on openers
+and product slides; use `.ticks` (accent squares) for lists, not icons.
+
+**Kit (in every layout deck's shell):** `.sticker` (`--tilt`; `.photo` for
+an app icon or a face), `.ticks`, `.panel`, `.pill`, `.frame.card` (a phone),
+`.frame.laptop` (a desktop shot). The `split` layout is image plus copy.
+
+**Image prompts.** One recipe per deck, the same every time:
+`<concrete subject>, <setting>, <medium: e.g. editorial photo, soft daylight>,
+palette <ink hex> <accent hex> <paper hex>, no text, no logos`
+(`generate_image { brand: true }` adds the palette and the "no text" for
+you). Generate at the slide's shape (wide for a hero), in one batch.
+
+**Slide recipes.** Opener: `on-accent` + `bg-rays` or `bg-halftone`, the logo
+or a few app-icon stickers, one display line. Product or feature: `split`
+with a real screen. Proof: `number` (huge, sourced) or `chart`. Plan:
+`timeline` on a tint. People: `team` with real faces. Closer: `on-ink`, the
+one action, stickers again.
+
 <!-- topic: script -->
 ### 3. Write slides and script
 
@@ -653,7 +706,7 @@ overflowing slide; `check <slug> --hosted --layout` measures a hosted draft.
 `--forbid` lists phrases that must not reach this audience (another customer,
 an internal codename). It matches the page's text, alt text, titles and
 script.md, not URLs in attributes, so forbidding your own brand still passes
-with the player's `decks.hypersocial.ai` script tag. Messages and what to do:
+with the player's `hyperdecks.ai` script tag. Messages and what to do:
 
 | Message starts with | Fix |
 |---|---|
@@ -842,7 +895,7 @@ Capture defaults to the initial slide, 4 seconds, 600px width and 10 fps, with a
 `--json` prints one line on stdout, identical to `<out>/manifest.json`:
 
 ```json
-{ "status": "exported | uploaded | failed", "shareUrl": "https://decks.hypersocial.ai/v/<token>",
+{ "status": "exported | uploaded | failed", "shareUrl": "https://hyperdecks.ai/v/<token>",
   "files": [{ "type": "gif | png | mp4", "path": "...", "url": "https://...convex.cloud/api/storage/...", "bytes": 74662, "width": 600, "height": 338 }],
   "email": { "sendable": true, "path": "<out>/email.html", "html": "<a href=\"<shareUrl>\"><img src=\"<gif url>\" ...></a>" },
   "warnings": [] }

package/skills/hyperdecks/chat.md

@@ -4,7 +4,7 @@ You are building a narrated deck through the Hyperdecks connector: no terminal,
 no git, no folder. The deck's files (`index.html`, `script.md`, `evidence.md`)
 live on Hyperdecks as a draft; you read and edit them with tools, and nothing
 reaches a recipient until `release_deck`. Topics: call `deck_guide` with
-`format`, `script`, `scripts`, `design`, `layouts`, `presenter`, `transitions` or `check`
+`format`, `script`, `scripts`, `design`, `look`, `layouts`, `presenter`, `transitions` or `check`
 before the step that needs it.
 
 ## First time here?
@@ -21,7 +21,8 @@ makes the hello deck; continue from step 5 below.
 
 ## The loop
 
-1. `deck_guide` (this page), then `deck_guide { topic: "layouts" }` to pick slides.
+1. `deck_guide` (this page), then `deck_guide { topic: "layouts" }` to pick slides
+   and `deck_guide { topic: "look" }` to pick the deck's texture, icon set and pictures.
    `get_brand` for the person's saved brand: write in its designMd's voice.
    None yet? Offer to import it from what they have: `import_brand` with
    their website (`url`), a PowerPoint or PDF they attach (`file`) or one of
@@ -46,8 +47,8 @@ makes the hello deck; continue from step 5 below.
    layouts' stand-ins (hero's `<div class="art">`, product's
    `<div class="shot">`, chart's placeholder `<svg>`) fail `check_deck` until
    you swap each for an `<img>` of its real file, or delete the hero's art.
-   Icons: `search_icons { query }` returns real line icons as inline `<svg>`
-   in `currentColor`; paste one where a features card has its icon.
+   Icons: one set per deck (`look` topic): `search_icons { query }` for real
+   line icons as inline `<svg>` in `currentColor`, or one `generate_icon_set`.
    For motion, `generate_video` (poll `check_video_job`): `loop: true` for a
    clip that repeats with no jump, `transparent: true` for a moving cut-out
    over the slide. Paste the finished job's `markup` as is (a transparent

package/src/checkRules.mjs

@@ -5,7 +5,11 @@
 // the deck's index.html and script.md as text, with the manifest and clip fetches
 // injected.
 
-export const PLAYER_V1 = "https://decks.hypersocial.ai/player/v1/player.js";
+export const PLAYER_V1 = "https://hyperdecks.ai/player/v1/player.js";
+// Decks released before the app moved to hyperdecks.ai load the same player
+// from the old host, which serves it forever; both pass.
+export const PLAYER_V1_LEGACY = "https://decks.hypersocial.ai/player/v1/player.js";
+export const isPlayerV1 = (src) => src === PLAYER_V1 || src === PLAYER_V1_LEGACY;
 export const DEFAULT_MAX_DURATION = 180;
 export const MOBILE_TITLE_CHARS = 28;
 export const CAPTION_MIN_CHARS = 4;
@@ -61,6 +65,9 @@ export const MESSAGES = {
   morphPair: (id, prev) => `slide ${id}: morph needs an element with the same data-morph="<name>" on this slide and the one before it (${prev})`,
   transitionStale: (where, script, manifest) => `${where}: script.md says transition "${script}" but the manifest has "${manifest}": run \`hyperdecks narrate\` so the player gets it`,
   flyTwice: (ids) => `fly is for the deck's one big moment, but slides ${ids.join(", ")} all use it`,
+  // Warnings from the look topic (deck_guide look): the deck passes, but a person should look.
+  fewPictures: (shown, total) => `only ${shown} of ${total} slides show a picture (a screenshot, a recording, a photo, a chart); aim for a real one on every other slide (deck_guide topic look)`,
+  mixedIcons: (sets) => `the deck mixes icon sets (${sets.join(" and ")}); keep one set per deck (deck_guide topic look)`,
   // A layout's stand-in left in: `how` is the tool (hosted) or command (CLI) that makes the real file.
   placeholder: (id, what, el, how, img) => `slide ${id}: ${what} is still the layout's placeholder (${el}); ${how}, then put it in as ${img}`,
   // Warnings (check --layout): the deck still passes.
@@ -522,6 +529,10 @@ const PLACEHOLDERS = [
     layout: "l-product", tag: "div", cls: "shot", what: "the product screenshot", img: '<img class="shot" src="…" alt="…">',
     how: { hosted: "capture the real page with capture_url", cli: "capture the real page with `hyperdecks screenshot <url>`" },
   },
+  {
+    layout: "l-split", tag: "div", cls: "shot", what: "the picture", img: '<img class="shot" src="…" alt="…"> (or <video class="shot" src="…" autoplay muted loop playsinline>)',
+    how: { hosted: "capture the app at phone size with capture_url (width 390, height 844), or upload a screen recording or photo with upload_deck_asset", cli: "capture the app at phone size with `hyperdecks screenshot <url> --width 390 --height 844`, or add a screen recording or photo with `hyperdecks asset add`" },
+  },
   {
     layout: "l-phones", tag: "div", cls: "shot", what: "each phone screen", img: '<img class="shot" src="…" alt="…"> (or <video class="shot" src="…" autoplay muted loop playsinline>) in each card',
     how: { hosted: "capture the app at phone size with capture_url (width 390, height 844), or upload a screen recording with upload_deck_asset", cli: "capture the app at phone size with `hyperdecks screenshot <url> --width 390 --height 844`, or add a screen recording with `hyperdecks asset add`" },
@@ -549,7 +560,7 @@ export function htmlErrors(html, { exists = () => true, forbid = [], script = ""
   const errs = [...presenterStyleErrors(html, script), ...transitionErrors(html, script), ...cueSelectorErrors(html, script), ...cueGestureErrors(script), ...placeholderErrors(html, { hosted })];
   const player = playerScript(html);
   if (!player) errs.push(MESSAGES.noPlayer());
-  else if (player.src !== PLAYER_V1) errs.push(MESSAGES.player(player.src));
+  else if (!isPlayerV1(player.src)) errs.push(MESSAGES.player(player.src));
   // The loading state must be in <head> to hold the page from its first paint,
   // with its fail-open so a deck whose player never loads still shows.
   const loading = /<style\b[^>]*\sdata-hd-loading(?=[\s>=])[^>]*>([\s\S]*?)<\/style>/i.exec(/<head\b[\s\S]*?<\/head>/i.exec(uncommented(html))?.[0] ?? "");
@@ -574,7 +585,7 @@ export function htmlErrors(html, { exists = () => true, forbid = [], script = ""
   const page = textOf(uncommented(html).replace(/<(script|style)\b[\s\S]*?<\/\1>/g, " ")).toLowerCase();
   // The raw HTML too (alt text, <title>, meta content, inline script), less
   // attribute values that are URLs: the player's own src (PLAYER_V1) names
-  // decks.hypersocial.ai, so forbidding the brand would otherwise always fail.
+  // hyperdecks.ai (or decks.hypersocial.ai), so forbidding the brand would otherwise always fail.
   const raw = withoutUrlAttrs(uncommented(html)).toLowerCase();
   for (const phrase of phraseList(forbid)) {
     const p = phrase.toLowerCase();
@@ -740,7 +751,7 @@ export function absoluteRefs(html) {
 }
 
 // Hosts a released deck can rely on: our storage and app, the player, and fonts.
-const HOSTED_ASSET_HOSTS = [/\.convex\.cloud$/, /\.convex\.site$/, /(^|\.)hypersocial\.ai$/, /^fonts\.(googleapis|gstatic)\.com$/];
+const HOSTED_ASSET_HOSTS = [/\.convex\.cloud$/, /\.convex\.site$/, /(^|\.)hypersocial\.ai$/, /(^|\.)hyperdecks\.ai$/, /^fonts\.(googleapis|gstatic)\.com$/];
 const isHostedAsset = (url) => {
   try {
     const host = new URL(url).hostname;
@@ -750,6 +761,35 @@ const isHostedAsset = (url) => {
   }
 };
 
+// The look topic as warnings. A slide shows a picture when it holds an <img>
+// (not the brand logo or an icon), <video>, <canvas>, <iframe>, a chart <svg> or an
+// inline-style url() background (not a stylesheet's: that is usually a texture); a deck of three or more slides with fewer than a third that do
+// reads as all type (the topic aims for every other slide; a plan with no
+// product to show may have fewer). Icons count as one set each: inline Lucide <svg> (by stroke width),
+// and <img> icons (class icon, or a generated icon-* asset).
+const iconImg = (tag) => /\bicon\b/.test(attr(tag, "class") ?? "") || /\/icon-[\w-]+\.(png|webp|svg)\b/i.test(attr(tag, "src") ?? "");
+export function lookWarnings(html) {
+  const all = slides(html);
+  const out = [];
+  const picture = (body) =>
+    /<(video|canvas|iframe)\b/i.test(body) ||
+    /<svg\b[^>]*class=["'][^"']*\bchart\b/i.test(body) ||
+    [...body.matchAll(/\bstyle=("[^"]*"|'[^']*')/gi)].some(([, v]) => /\burl\(/i.test(v)) ||
+    [...body.matchAll(/<img\b[^>]*>/gi)].some(([tag]) => !/\bbrand-logo\b/.test(attr(tag, "class") ?? "") && !iconImg(tag));
+  const shown = all.filter((s) => picture(uncommented(s.body)) || /\burl\(/i.test(attr(s.tag, "style") ?? "")).length;
+  if (all.length >= 3 && shown * 3 < all.length) out.push(MESSAGES.fewPictures(shown, all.length));
+  const body = uncommented(all.map((s) => s.body).join("\n"));
+  const sets = new Set();
+  for (const [tag] of body.matchAll(/<svg\b[^>]*>/gi)) {
+    if (/\blucide/.test(attr(tag, "class") ?? "")) sets.add(`Lucide at stroke-width ${attr(tag, "stroke-width") ?? "2"}`);
+  }
+  for (const [tag] of body.matchAll(/<img\b[^>]*>/gi)) {
+    if (iconImg(tag)) sets.add("image icons");
+  }
+  if (sets.size > 1) out.push(MESSAGES.mixedIcons([...sets].sort()));
+  return out;
+}
+
 // Every rule on the deck's text. `exists(ref)` answers whether a local reference
 // resolves (true, false or "outside"); `hosted: true` means there is no folder,
 // so every local reference is an error naming upload_deck_asset, a hotlinked
@@ -769,6 +809,7 @@ export async function checkSources({ html, script = "" }, opts = {}, { fetch: fe
   const errors = htmlErrors(html, { exists, forbid, script, hosted: !!opts.hosted, strict });
   const warnings = [];
   if (!notesRequired(html, { strict })) for (const id of slidesWithoutNotes(html)) warnings.push(MESSAGES.noteSoft(id));
+  warnings.push(...lookWarnings(html));
   // Without a folder (hosted, or a caller that passes no reader) only the inline scripts are read.
   const walked = deckFiles(html, opts.hosted ? {} : { pathExists: opts.pathExists, read: opts.read, isDir: opts.isDir });
   for (const m of walked.missing) errors.push(MESSAGES.scriptRef(m.ref, m.from));

package/src/commands.mjs

@@ -376,8 +376,9 @@ commands:
   engagement <recipient|token> [--deck <slug>] [--json]
                    what one recipient watched per deck: narration heard, replays, drop-off, visits
   gen-image "<prompt>" [--model gpt-image-2.5|nano-banana-2.1|gpt-image-2] [--transparent] [--image <url>] [--size <s>]
-            [--quality <q>] [--count <n>] [--seed <n>] [--slug <deck>] [--download <file>]
-                   default model gpt-image-2.5; --seed applies to nano-banana-2.1
+            [--quality <q>] [--count <n>] [--seed <n>] [--brand] [--slug <deck>] [--download <file>]
+                   default model gpt-image-2.5; --seed applies to nano-banana-2.1;
+                   --brand adds your brand's colours and "no text, no logos" to the prompt
   image-job <jobId> [--json]
   gen-video "<prompt>" [--model h3-max|kling-v3] [--image <url>] [--seconds 5] [--aspect 16:9|9:16] [--loop] [--transparent] [--slug <deck>] [--name <name>] [--download <file>]
                    a 3–10s clip via fal (default MiniMax H3 Max); --image animates that still and keeps its aspect
@@ -390,8 +391,9 @@ commands:
                    a branded SVG: { "kind": "bar|line|donut|number", "labels", "series", "values", "value", "palette" }
   icons search <word...> [--limit 8] [--stroke-width 2] [--json]
                    real icons from the Lucide library as inline SVG in currentColor (free, offline)
-  icons <subject...> --style "<style>" [--palette "#hex,#hex"] [--slug <deck>] [--name <prefix>]
-                   a style-consistent set of generated (illustrated) icons, one per subject (max 12)
+  icons <subject...> --preset line|duotone|sticker|clay | --style "<style>" [--palette "#hex,#hex"] [--slug <deck>] [--name <prefix>]
+                   a style-consistent set of generated (illustrated) icons, one per subject (max 12);
+                   palette defaults to your brand's colours
   brand [show]     your saved brand (colours, fonts, logo, design.md) that every new deck starts from
   brand set [--accent "#hex"] [--ink|--paper|--accent-2|--card "#hex"] [--fonts <pairing>]
             [--display|--body|--mono "<Google Fonts family>"] [--logo <url|file>] [--no-logo]
@@ -415,13 +417,16 @@ commands:
                    a PDF of the released deck: one 1600x900 page per slide (a script page after each
                    with --notes), a footer with the deck's tracked link; kept 30 days
   export <slug|deck-dir> --video [--size 1080p|720p|4k] [--shape 16:9|9:16|1:1] [--no-captions]
-         [--no-avatar] [--title-card] [--end-card [--link <url>]] [--upload] [--out <file.mp4>] [--json]
+         [--no-avatar] [--title-card] [--end-card [--link <url>]] [--slides <a-b>] [--upload]
+         [--out <file.mp4>] [--json]
                    an MP4 of the narrated deck, drawn frame by frame so the avatar is smooth (slower
                    than real time: a 4-minute deck takes about 25 minutes with the live head on a
-                   laptop): the avatar, voice and captions, none of the player's chrome. A slug records
-                   the released copy, a deck folder its working copy. --title-card adds the title
-                   and presenter (2s), --end-card the deck's "Video viewers" link (3s); --upload
-                   keeps it with the deck's exports for 30 days
+                   laptop; the dashboard's Export → Video splits it across machines, about 10
+                   minutes): the avatar, voice and captions, none of the player's chrome. A slug
+                   records the released copy, a deck folder its working copy. --slides 3-5 records
+                   only those slides (counting from 1). --title-card adds the title and presenter
+                   (2s), --end-card the deck's "Video viewers" link (3s); --upload keeps it with the
+                   deck's exports for 30 days
   export list [<slug>] [--json]    your exports and their download links
   export status <exportId> [--json]  one export: a hosted video's progress, its link when done
   export cancel <exportId>         stop a hosted video export (Export → Video, export_deck mp4)
@@ -474,7 +479,7 @@ async function genImage(pos, opts) {
   const prompt = pos.join(" ").trim() || opts.prompt;
   if (!prompt) {
     throw new Error(
-      'usage: gen-image "<prompt>" [--model gpt-image-2.5|nano-banana-2.1|gpt-image-2] [--image <url>] [--transparent] [--size <s>] [--quality <q>] [--count <n>] [--format png|jpeg|webp] [--seed <n>] [--slug <deck>] [--name <name>] [--download <file>]',
+      'usage: gen-image "<prompt>" [--model gpt-image-2.5|nano-banana-2.1|gpt-image-2] [--image <url>] [--transparent] [--size <s>] [--quality <q>] [--count <n>] [--format png|jpeg|webp] [--seed <n>] [--brand] [--slug <deck>] [--name <name>] [--download <file>]',
     );
   }
   let out = await ops.generateImage(opts, {
@@ -487,6 +492,7 @@ async function genImage(pos, opts) {
     format: opts.format,
     model: opts.model,
     seed: opts.seed,
+    brand: opts.brand,
     slug: opts.slug,
     name: opts.name,
   });
@@ -625,12 +631,13 @@ async function chart(pos, opts) {
 }
 
 async function icons(pos, opts) {
-  if (!pos.length || !opts.style) {
-    throw new Error('usage: icons <subject...> --style "<style>" [--palette "#hex,#hex"] [--model nano-banana-2.1|gpt-image-2.5|gpt-image-2] [--slug <deck>] [--name <prefix>]');
+  if (!pos.length || (!opts.style && !opts.preset)) {
+    throw new Error('usage: icons <subject...> --preset line|duotone|sticker|clay | --style "<style>" [--palette "#hex,#hex"] [--model nano-banana-2.1|gpt-image-2.5|gpt-image-2] [--slug <deck>] [--name <prefix>]');
   }
   const queued = await ops.generateIconSet(opts, {
     subjects: pos,
     style: opts.style,
+    preset: opts.preset,
     palette: opts.palette ? String(opts.palette).split(",").map((c) => c.trim()).filter(Boolean) : undefined,
     model: opts.model,
     slug: opts.slug,