@clickraft/cli 0.7.1 → 0.7.3

package/CHANGELOG.md

@@ -1,9 +1,21 @@
-## [0.7.1](https://github.com/clickraft/cli/compare/v0.7.0...v0.7.1) (2026-05-26)
+## [0.7.3](https://github.com/clickraft/cli/compare/v0.7.2...v0.7.3) (2026-05-26)
 
 ### Bug Fixes
 
-* **workflows:** declared_params is an array, not a record ([59c6d6e](https://github.com/clickraft/cli/commit/59c6d6eaf17d46dde16e541c95dd391c0704fde5))
+* **docs:** correct workflow examples — previous docs taught fictional node types ([bc45a97](https://github.com/clickraft/cli/commit/bc45a975c216120d753bea8fb92dbed14646cbc0))
 
 # Changelog
 
 All notable changes to the Clickraft CLI are documented here.
+
+## Unreleased
+
+### Fixed
+
+- **Workflow docs taught fictional node types and port names.** All examples in
+  `docs/workflows.md` and `README.md` now use real node types from the server
+  registry (`textPrompt`, `imageGeneration`, `assistant`, etc.) and kebab-case
+  handle IDs (`text-output`, `prompt-input`, `image-output`, `image-input`).
+  Users who were following the old examples with `generate`/`upload` node types
+  or `image`/`file` port names will need to switch to the canonical values
+  listed in the new reference table in `docs/workflows.md`.

package/README.md

@@ -60,7 +60,7 @@ clickraft workflow apply <workflow-id> --auto-rev --from-file ops.json
 
 # Or inline a single operation
 clickraft workflow apply <workflow-id> --auto-rev \
-  --op '{"op":"add_node","node":{"id":"n1","type":"generate","config":{}}}'
+  --op '{"op":"add_node","node":{"id":"gen-1","type":"imageGeneration","config":{}}}'
 ```
 
 The `--auto-rev` flag is recommended for agent use — it fetches the current `canvas_rev` before mutating and retries once if a conflict occurs.

package/dist/cli.js

@@ -4513,6 +4513,13 @@ function exitCodeForResult(result) {
   }
   return 0;
 }
+function splitCsvArray(values) {
+  if (!values || values.length === 0) return void 0;
+  const result = values.flatMap(
+    (v) => v.split(",").map((s) => s.trim()).filter(Boolean)
+  );
+  return result.length > 0 ? result : void 0;
+}
 async function runTemplateList(argv, ctx, rc) {
   const parsed = parseArgs(argv, {
     string: [...COMMON_RICH_STRING_FLAGS, "scope", "q", "cursor", "limit"],
@@ -4521,7 +4528,7 @@ async function runTemplateList(argv, ctx, rc) {
   });
   const result = await listTemplates({
     q: parsed.string.q,
-    tags: parsed.array.tags,
+    tags: splitCsvArray(parsed.array.tags),
     scope: parsed.string.scope,
     cursor: parsed.string.cursor,
     limit: optionalInt(parsed.string.limit, "limit"),
@@ -4561,7 +4568,7 @@ async function runTemplateFind(argv, ctx, rc) {
   if (!query) throw new ArgError("Missing required <query> argument.");
   const result = await findTemplates({
     query,
-    tags: parsed.array.tags,
+    tags: splitCsvArray(parsed.array.tags),
     scope: parsed.string.scope,
     cursor: parsed.string.cursor,
     limit: optionalInt(parsed.string.limit, "limit"),
@@ -4692,7 +4699,7 @@ async function runWorkflowCreate(argv, ctx, rc) {
   });
   let name = parsed.string.name;
   let description = parsed.string.description;
-  let tags = parsed.array.tags;
+  let tags = splitCsvArray(parsed.array.tags);
   let declaredParams;
   if (parsed.string["from-file"]) {
     const raw = await readJsonFile(parsed.string["from-file"]);