@facelessad/cli 2.0.0 → 2.1.0

package/README.md

@@ -9,10 +9,17 @@ facelessad tools                # what can be made
 facelessad create --tool motion-graphics --url https://your-product.com --wait
 ```
 
-Ten commands: `login`, `create`, `status`, `list`, `download`, `estimate`,
-`tools`, `voices`, `brands`, `balance`. Every command accepts `--json` for scripting;
-`create`/`estimate` accept `--dry-run` (print the request body without
-sending) and `--file body.json` (a base body that flags override).
+Commands: `login`, `create`, `status`, `list`, `download`, `estimate`,
+`tools`, `voices`, `brands`, `balance`, `parts`, `regen-part`, `regen`,
+`render`, `cancel`, and `webhooks` / `webhook-add` / `webhook-rm`. Every
+command accepts `--json` for scripting; `create`/`estimate` accept `--dry-run`
+(print the request body without sending) and `--file body.json` (a base body
+that flags override).
+
+A finished video can be fixed part by part: `parts <id>` shows what it is made
+of and `regen-part` redoes one clip, image card, graphics block — or, on
+background-image styles (marked `+bg` in `tools`), one `bg-N` AI photo
+backdrop with `--prompt`. The whole video re-renders automatically.
 
 The key is stored in `~/.facelessad/config.json` with mode 0600. The
 environment variable `FACELESSAD_API_KEY` always wins — that is the way CI

package/SKILL.md

@@ -207,6 +207,11 @@ Which flag a part takes is in its `regenerate_requires`:
   text-animation, video-banner, and the graphics layer of product-showcase):
   a plain-language change such as `"make the headline say Faster onboarding"`.
   The server applies it to the block's current code — you never send code.
+- `--prompt` on a `bg-N` part — background images (styles marked `genBg` in
+  the registry / `+bg` in `facelessad tools`): describe the new AI photo
+  backdrop, e.g. `"warm sunset gradient with soft haze"`. The graphics stay
+  untouched, text/logos/UI are always excluded automatically, and the video
+  re-renders. 6 credits per image.
 
 Product Showcase lists two parts per scene: the product clip (`--prompt`) and
 the graphics over it (`--instruction`). Continuous videos chain their clips
@@ -317,6 +322,7 @@ names the offending field and usually the valid values.
 - `card_needs_image_prompt` — a card needs `--image-prompt`, not `--prompt`.
 - `webhook_limit` / `webhook_not_found` / `invalid_url` — five endpoints per account; no such id; or a URL we cannot reach.
 - `graphics_needs_instruction` / `instruction_not_supported` — graphics blocks take `--instruction`, and only they do.
+- `bg_needs_prompt` — a `bg-N` background image is regenerated with `--prompt` describing the backdrop.
 
 ## Rules for agents
 

package/index.js

@@ -550,7 +550,10 @@ const commands = {
       const t = (d.tools || []).find((x) => x.id === flags.tool);
       if (!t) die('Unknown tool "' + flags.tool + '". Valid: ' + (d.tools || []).map((x) => x.id).join(', '), 'unknown_tool');
       const lines = [bold(t.id) + ' — ' + (t.name || '')];
-      if (t.styles?.length) lines.push('  styles: ' + t.styles.map((s) => s.id).join(', '));
+      // 2.1.0 (§848 genBg): tyylit joilla on AI-generoitu kuvatausta merkitään
+      // +bg-liitteellä — rekisterin genBg-lippu, +6 cr / partti arvioon.
+      if (t.styles?.length) lines.push('  styles: ' + t.styles.map((s) => s.id + (s.genBg ? '+bg' : '')).join(', '));
+      if (t.styles?.some((s) => s.genBg)) lines.push('  ' + dim('+bg = AI photo background, +6 credits per part (regenerable later: facelessad regen-part <id> --part bg-N --prompt "...")'));
       // 1.2.0: rekisteri kertoo rakenteet KOLMESSA muodossa (§698). Ennen tämä
       // tulosti vain adStructures-listan, joka on oletusryhmän pooli — eli
       // animated-adilla 17 rakennetta 46:sta ja motion-graphicsilla 6 sadasta
@@ -753,7 +756,7 @@ const commands = {
 
   async 'regen-part'() {
     const id = positional[0];
-    if (!id) die('Usage: facelessad regen-part <id> --part <uid> [--prompt|--image-prompt|--instruction "..."]', 'missing_id');
+    if (!id) die('Usage: facelessad regen-part <id> --part <uid> [--prompt|--image-prompt|--instruction "..."]\n  scene clip: --prompt (new take) / --image-prompt (new image first)\n  image card: --image-prompt\n  graphics block (gfx-N): --instruction (plain-language edit)\n  background image (bg-N): --prompt (describe the new backdrop — text/logos/UI always excluded)', 'missing_id');
     const uid = flags.part;
     if (!uid || uid === true) die('--part <uid> is required — run: facelessad parts ' + id, 'missing_part');
     const body = {};
@@ -899,6 +902,10 @@ Regenerate flags (regen-part) — the ONLY flags this command takes:
        Animation, banner, and the graphics layer of product-showcase:
        plain-language edit, e.g. "make the headline say Faster onboarding".
        You never send or receive code.)
+  --prompt "<backdrop>"            (bg-N background images — styles marked +bg
+       in facelessad tools: describe the new AI photo backdrop, e.g. "warm
+       sunset gradient with soft haze". Graphics stay untouched; text, logos
+       and UI are always excluded automatically. 6 credits per image.)
 
 Video Banner flags (silent looping banner — no voice, no script):
   --headline "..." --subline "..." --cta-text "..."

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@facelessad/cli",
-  "version": "2.0.0",
+  "version": "2.1.0",
   "description": "Create faceless video ads from your terminal or build scripts \u2014 the FacelessAd command line.",
   "license": "MIT",
   "type": "module",
@@ -23,4 +23,4 @@
     "cli"
   ],
   "homepage": "https://facelessad.com/developers"
-}
+}