@clickraft/cli 0.11.2 → 0.13.0

package/CHANGELOG.md

@@ -1,9 +1,16 @@
-## [0.11.2](https://github.com/clickraft/cli/compare/v0.11.1...v0.11.2) (2026-06-21)
+## [0.13.0](https://github.com/clickraft/cli/compare/v0.12.0...v0.13.0) (2026-08-08)
+
+### Features
+
+* **cli:** add product create ([fe46251](https://github.com/clickraft/cli/commit/fe4625100ae9af7571e0b97156d58eba59e9aea1))
+* **cli:** request products:write at login and degrade when the server refuses it ([a8b6db2](https://github.com/clickraft/cli/commit/a8b6db24d2789df834bffdf6290cb1bebd41116c))
+* **errors:** recognize the five product-create error codes ([9e0aef4](https://github.com/clickraft/cli/commit/9e0aef4a3eb0cf188b1016f70b7c326b14b7cd8b))
+* **mcp:** add the product_create tool ([f725172](https://github.com/clickraft/cli/commit/f725172c9df13af80c244c93506036c178008284))
+* **sdk:** add the product create request contract ([75ae3c7](https://github.com/clickraft/cli/commit/75ae3c78b011b5278a21da75d247e7452e2c630c))
 
 ### Bug Fixes
 
-* **sdk:** accept input.width/height in GenerateCreateRequestSchema ([6f92a22](https://github.com/clickraft/cli/commit/6f92a22f8152ce48bbb7ce95e1f4c3134fe81b5d)), closes [#3](https://github.com/clickraft/cli/issues/3)
-* **sdk:** widen declaredParams required (optional) + defaultValue (any-typed) to match server ([03eb961](https://github.com/clickraft/cli/commit/03eb961f9c05272c96cbb7de8667ef0222e08691)), closes [#5](https://github.com/clickraft/cli/issues/5) [#6](https://github.com/clickraft/cli/issues/6) [#N](https://github.com/clickraft/cli/issues/N) [5/#6](https://github.com/5/cli/issues/6)
+* **cli:** point the insufficient-scope hint at login --force-reauth ([398abd3](https://github.com/clickraft/cli/commit/398abd3ba7928706faf7f505038c4b52361b4a68))
 
 # Changelog
 
@@ -11,6 +18,30 @@ All notable changes to the Clickraft CLI are documented here.
 
 ## Unreleased
 
+### Added
+
+- **`generate create --start-frame <url|path>`** — sets the image-to-video start
+  frame. It is emitted as the scalar `referenceImageUrl`, which the server maps
+  to `start_image`. Accepts an http(s) URL or a local path (auto-uploaded, like
+  `--reference-image`).
+
+### Changed
+
+- **BREAKING: `generate create --reference-image` now always routes to the
+  references category**, regardless of how many are supplied. Previously a
+  *single* `--reference-image` was collapsed into the scalar `referenceImageUrl`
+  (which the server treats as the image-to-video start frame), so it was rejected
+  by image models such as `gpt-image-2` that only accept references — while two
+  or more images worked. A single reference image is now sent as
+  `referenceImages: [{ url }]` and is accepted correctly.
+
+  **Migration (image-to-video users):** a lone `--reference-image <url>` no
+  longer sets the start frame. To set the start frame, use the new
+  `--start-frame <url>` flag. `--reference-image` remains for reference images
+  (repeatable, max 8). The same routing change applies to the `generate_create`
+  MCP tool: `referenceImages` is always references; the new `startFrame` input
+  sets the start frame.
+
 ### Fixed
 
 - **Workflow docs taught fictional node types and port names.** All examples in

package/README.md

@@ -45,6 +45,50 @@ clickraft generate create --model-slug nano-banana-2 \
 
 > **Note:** `--brand-model` only works with reference-supporting models (nano-banana-2 recommended).
 
+### Products
+
+Create a product from images you have already uploaded, then generate against it:
+
+```bash
+# 1. Upload each image. Note the assetId that comes back.
+clickraft upload ./mug-front.png
+clickraft upload ./mug-side.png
+
+# 2. Create the product. --image is repeatable (1-10) and takes
+#    <assetId>[:<altText>]; alt text may contain colons.
+clickraft product create --name "Ceramic Mug" \
+  --description "Hand-glazed stoneware" \
+  --image "1f7c1e8e-2a4b-4c9d-8e5f-3b2a1c0d9e8f:Front view" \
+  --image "2a8d2f9f-3b5c-4d0e-9f6a-4c3b2d1e0f9a:Side view" \
+  --primary 1f7c1e8e-2a4b-4c9d-8e5f-3b2a1c0d9e8f
+
+# 3. Use the returned product id in a generation.
+clickraft generate create --model-slug nano-banana-2 \
+  --prompt "the mug on a marble worktop, morning light" \
+  --product <product-id>
+
+clickraft product list
+```
+
+Without `--primary`, the first `--image` becomes the primary image. That matters
+downstream: `generate create --product <id>` resolves the primary image when no
+image id is given.
+
+Retries are safe. Each invocation sends an idempotency key, and it is reused
+across the automatic retries within that invocation, so a transient storage
+error cannot create the product twice. To make a retry safe **across**
+invocations, for example in a shell loop of your own, pass the same
+`--idempotency-key` each time. Reusing a key with a changed body is rejected
+rather than silently creating a second product.
+
+`product create` needs the `products:write` scope. Tokens minted before this
+command shipped do not carry it, and the CLI will say so before making any
+request:
+
+```bash
+clickraft login --force-reauth
+```
+
 ### Workflows
 
 Create, inspect, and mutate visual workflows from your terminal:
@@ -93,6 +137,15 @@ The Clickraft CLI is designed to work with Claude Code, Cursor, Codex, and other
 npx skills add clickraft/skills
 ```
 
+### After upgrading: re-authorize for product creation
+
+`product create` and the `product_create` MCP tool both require the
+`products:write` scope, which is new. Existing credentials do not carry it.
+
+- **CLI:** run `clickraft login --force-reauth`.
+- **Clickraft MCP connector:** reconnect it, then confirm the tool works. If it
+  still reports a missing scope, remove the connector and add it again.
+
 ## Development
 
 ```bash