@tailor-platform/sdk 1.71.0 → 1.72.0

package/dist/completion/zsh-worker.zsh

@@ -1,5 +1,5 @@
 # politty-completion-version: 1
-# politty-bin-sig: 1782903555
+# politty-bin-sig: 1782914535
 # politty-bin-path: /home/runner/work/sdk/sdk/node_modules/.bin/tailor-sdk
 # program: tailor-sdk
 # shell: zsh
@@ -686,12 +686,27 @@ __tailor_sdk_worker_opt_takes_value() {
         secret:delete:--profile|secret:delete:-p|secret:delete:--p) return 0 ;;
         secret:delete:--vault-name|secret:delete:--vaultName|secret:delete:-V|secret:delete:--V) return 0 ;;
         secret:delete:--name|secret:delete:-n|secret:delete:--n) return 0 ;;
-        setup:--provider|setup:-p|setup:--p) return 0 ;;
-        setup:--workspace-name|setup:--workspaceName|setup:-n|setup:--n) return 0 ;;
-        setup:--branch) return 0 ;;
-        setup:--tag-pattern|setup:--tagPattern) return 0 ;;
-        setup:--environment) return 0 ;;
-        setup:--dir|setup:-d|setup:--d) return 0 ;;
+        setup:branch:--name|setup:branch:-n|setup:branch:--n) return 0 ;;
+        setup:branch:--branch) return 0 ;;
+        setup:branch:--environment) return 0 ;;
+        setup:branch:--dir|setup:branch:-d|setup:branch:--d) return 0 ;;
+        setup:tag:--name|setup:tag:-n|setup:tag:--n) return 0 ;;
+        setup:tag:--tag-pattern|setup:tag:--tagPattern) return 0 ;;
+        setup:tag:--branch) return 0 ;;
+        setup:tag:--environment) return 0 ;;
+        setup:tag:--dir|setup:tag:-d|setup:tag:--d) return 0 ;;
+        setup:preview:--name|setup:preview:-n|setup:preview:--n) return 0 ;;
+        setup:preview:--branch) return 0 ;;
+        setup:preview:--region) return 0 ;;
+        setup:preview:--environment) return 0 ;;
+        setup:preview:--dir|setup:preview:-d|setup:preview:--d) return 0 ;;
+        setup:action:--name|setup:action:-n|setup:action:--n) return 0 ;;
+        setup:action:--dir|setup:action:-d|setup:action:--d) return 0 ;;
+        setup:action:--environment) return 0 ;;
+        setup:coordinate:--name|setup:coordinate:-n|setup:coordinate:--n) return 0 ;;
+        setup:coordinate:--action) return 0 ;;
+        setup:coordinate:--branch) return 0 ;;
+        setup:coordinate:--environment) return 0 ;;
         show:--workspace-id|show:--workspaceId|show:-w|show:--w) return 0 ;;
         show:--profile|show:-p|show:--p) return 0 ;;
         show:--config|show:-c|show:--c) return 0 ;;
@@ -912,6 +927,11 @@ __tailor_sdk_worker_is_subcmd() {
         secret:list) return 0 ;;
         secret:delete) return 0 ;;
         :secret) return 0 ;;
+        setup:branch) return 0 ;;
+        setup:tag) return 0 ;;
+        setup:preview) return 0 ;;
+        setup:action) return 0 ;;
+        setup:coordinate) return 0 ;;
         setup:check) return 0 ;;
         :setup) return 0 ;;
         :show) return 0 ;;
@@ -2524,12 +2544,102 @@ __tailor_sdk_worker_complete_secret() {
     __tailor_sdk_worker_cdescribe 'subcommands' _subs
 }
 
+__tailor_sdk_worker_complete_setup_branch() {
+    local -a _vals=()
+    if __tailor_sdk_worker_opt_takes_value "setup:branch" "${words[CURRENT-1]}"; then return 0; fi
+    if (( _after_dd )); then return 0; fi
+    if [[ "${words[CURRENT]}" == -* ]]; then
+        local -a _opts=()
+        __tailor_sdk_worker_not_used "--name" "-n" "--n" && _opts+=("--name:Name (defaults to the config 'name')")
+        __tailor_sdk_worker_not_used "--branch" && _opts+=("--branch:Deploy trigger branch (defaults to the detected default branch)")
+        __tailor_sdk_worker_not_used "--environment" && _opts+=("--environment:GitHub Environment for the plan/deploy jobs (defaults to the workspace name)")
+        __tailor_sdk_worker_not_used "--erd-preview" "--erdPreview" && _opts+=("--erd-preview:Add PR ERD viewer artifacts with current/diff previews for TailorDB namespaces")
+        __tailor_sdk_worker_not_used "--dir" "-d" "--d" && _opts+=("--dir:App directory (for monorepo setups)")
+        __tailor_sdk_worker_not_used "--force" && _opts+=("--force:Discard hand edits / take over unmanaged files and regenerate")
+        __tailor_sdk_worker_not_used "--help" && _opts+=("--help:Show help")
+        __tailor_sdk_worker_cdescribe 'options' _opts
+        return 0
+    fi
+}
+
+__tailor_sdk_worker_complete_setup_tag() {
+    local -a _vals=()
+    if __tailor_sdk_worker_opt_takes_value "setup:tag" "${words[CURRENT-1]}"; then return 0; fi
+    if (( _after_dd )); then return 0; fi
+    if [[ "${words[CURRENT]}" == -* ]]; then
+        local -a _opts=()
+        __tailor_sdk_worker_not_used "--name" "-n" "--n" && _opts+=("--name:Name (defaults to the config 'name')")
+        __tailor_sdk_worker_not_used "--tag-pattern" "--tagPattern" && _opts+=("--tag-pattern:Tag glob to match (defaults to v*)")
+        __tailor_sdk_worker_not_used "--branch" && _opts+=("--branch:Tag-reachability guard branch (no guard when omitted)")
+        __tailor_sdk_worker_not_used "--environment" && _opts+=("--environment:GitHub Environment for the plan/deploy jobs (defaults to the workspace name)")
+        __tailor_sdk_worker_not_used "--dir" "-d" "--d" && _opts+=("--dir:App directory (for monorepo setups)")
+        __tailor_sdk_worker_not_used "--force" && _opts+=("--force:Discard hand edits / take over unmanaged files and regenerate")
+        __tailor_sdk_worker_not_used "--help" && _opts+=("--help:Show help")
+        __tailor_sdk_worker_cdescribe 'options' _opts
+        return 0
+    fi
+}
+
+__tailor_sdk_worker_complete_setup_preview() {
+    local -a _vals=()
+    if __tailor_sdk_worker_opt_takes_value "setup:preview" "${words[CURRENT-1]}"; then return 0; fi
+    if (( _after_dd )); then return 0; fi
+    if [[ "${words[CURRENT]}" == -* ]]; then
+        local -a _opts=()
+        __tailor_sdk_worker_not_used "--name" "-n" "--n" && _opts+=("--name:Name (defaults to the config 'name')")
+        __tailor_sdk_worker_not_used "--branch" && _opts+=("--branch:Branch to filter PRs by (defaults to the detected default branch)")
+        __tailor_sdk_worker_not_used "--region" && _opts+=("--region:Workspace region for preview workspace creation (e.g. us-west). Required.")
+        __tailor_sdk_worker_not_used "--require-preview-label" "--requirePreviewLabel" && _opts+=("--require-preview-label:Deploy preview only for PRs labeled \`tailor\:preview\` instead of all PRs.")
+        __tailor_sdk_worker_not_used "--environment" && _opts+=("--environment:GitHub Environment for the preview jobs (defaults to the workspace name)")
+        __tailor_sdk_worker_not_used "--dir" "-d" "--d" && _opts+=("--dir:App directory (for monorepo setups)")
+        __tailor_sdk_worker_not_used "--force" && _opts+=("--force:Discard hand edits / take over unmanaged files and regenerate")
+        __tailor_sdk_worker_not_used "--help" && _opts+=("--help:Show help")
+        __tailor_sdk_worker_cdescribe 'options' _opts
+        return 0
+    fi
+}
+
+__tailor_sdk_worker_complete_setup_action() {
+    local -a _vals=()
+    if __tailor_sdk_worker_opt_takes_value "setup:action" "${words[CURRENT-1]}"; then return 0; fi
+    if (( _after_dd )); then return 0; fi
+    if [[ "${words[CURRENT]}" == -* ]]; then
+        local -a _opts=()
+        __tailor_sdk_worker_not_used "--name" "-n" "--n" && _opts+=("--name:Name (defaults to the config 'name')")
+        __tailor_sdk_worker_not_used "--dir" "-d" "--d" && _opts+=("--dir:App directory")
+        __tailor_sdk_worker_not_used "--environment" && _opts+=("--environment:GitHub Environment (defaults to the workspace name)")
+        __tailor_sdk_worker_not_used "--force" && _opts+=("--force:Discard hand edits and regenerate")
+        __tailor_sdk_worker_not_used "--help" && _opts+=("--help:Show help")
+        __tailor_sdk_worker_cdescribe 'options' _opts
+        return 0
+    fi
+}
+
+__tailor_sdk_worker_complete_setup_coordinate() {
+    local -a _vals=()
+    if __tailor_sdk_worker_opt_takes_value "setup:coordinate" "${words[CURRENT-1]}"; then return 0; fi
+    if (( _after_dd )); then return 0; fi
+    if [[ "${words[CURRENT]}" == -* ]]; then
+        local -a _opts=()
+        __tailor_sdk_worker_not_used "--name" "-n" "--n" && _opts+=("--name:Coordinator name (used in the generated workflow file name and job names)")
+        _opts+=("--action:Composite action to include (can be specified multiple times). tailor- prefix optional.")
+        __tailor_sdk_worker_not_used "--branch" && _opts+=("--branch:Branch target\: deploy trigger branch (defaults to the detected default branch)")
+        __tailor_sdk_worker_not_used "--tag" && _opts+=("--tag:Generate a tag target coordinator")
+        __tailor_sdk_worker_not_used "--environment" && _opts+=("--environment:GitHub Environment for the plan/deploy jobs")
+        __tailor_sdk_worker_not_used "--force" && _opts+=("--force:Discard hand edits and regenerate")
+        __tailor_sdk_worker_not_used "--help" && _opts+=("--help:Show help")
+        __tailor_sdk_worker_cdescribe 'options' _opts
+        return 0
+    fi
+}
+
 __tailor_sdk_worker_complete_setup_check() {
     local -a _vals=()
     if __tailor_sdk_worker_opt_takes_value "setup:check" "${words[CURRENT-1]}"; then return 0; fi
     if (( _after_dd )); then return 0; fi
     if [[ "${words[CURRENT]}" == -* ]]; then
         local -a _opts=()
+        __tailor_sdk_worker_not_used "--ci" && _opts+=("--ci:Run in CI mode\: skip checks that are handled by the runtime (e.g. TAILOR_PLATFORM_WORKSPACE_ID).")
         __tailor_sdk_worker_not_used "--help" && _opts+=("--help:Show help")
         __tailor_sdk_worker_cdescribe 'options' _opts
         return 0
@@ -2538,31 +2648,15 @@ __tailor_sdk_worker_complete_setup_check() {
 
 __tailor_sdk_worker_complete_setup() {
     local -a _vals=()
-    case "${words[CURRENT-1]}" in
-            --provider|-p|--p)
-                _vals=("github")
-                __tailor_sdk_worker_cdescribe 'completions' _vals
-                return 0 ;;
-    esac
     if __tailor_sdk_worker_opt_takes_value "setup" "${words[CURRENT-1]}"; then return 0; fi
     if (( _after_dd )); then return 0; fi
     if [[ "${words[CURRENT]}" == -* ]]; then
         local -a _opts=()
-        __tailor_sdk_worker_not_used "--provider" "-p" "--p" && _opts+=("--provider:CI provider to generate for (only 'github' is supported)")
-        __tailor_sdk_worker_not_used "--workspace-name" "--workspaceName" "-n" "--n" && _opts+=("--workspace-name:Workspace name (defaults to the config 'name')")
-        __tailor_sdk_worker_not_used "--branch" && _opts+=("--branch:Branch target\: deploy trigger branch (defaults to the detected default branch). Tag target\: tag-reachability guard branch (no guard when omitted)")
-        __tailor_sdk_worker_not_used "--tag" && _opts+=("--tag:Generate a tag target (deploy on tag push)")
-        __tailor_sdk_worker_not_used "--tag-pattern" "--tagPattern" && _opts+=("--tag-pattern:Tag glob to match (requires --tag; defaults to v*)")
-        __tailor_sdk_worker_not_used "--environment" && _opts+=("--environment:GitHub Environment for the plan/deploy jobs (defaults to the workspace name)")
-        __tailor_sdk_worker_not_used "--no-plan" "--noPlan" && _opts+=("--no-plan:Disable the plan job for a branch target (cannot be combined with --tag)")
-        __tailor_sdk_worker_not_used "--erd-preview" "--erdPreview" && _opts+=("--erd-preview:Add PR ERD viewer artifacts with current/diff previews for TailorDB namespaces")
-        __tailor_sdk_worker_not_used "--dir" "-d" "--d" && _opts+=("--dir:App directory (for monorepo setups)")
-        __tailor_sdk_worker_not_used "--force" && _opts+=("--force:Discard hand edits / take over unmanaged files and regenerate")
         __tailor_sdk_worker_not_used "--help" && _opts+=("--help:Show help")
         __tailor_sdk_worker_cdescribe 'options' _opts
         return 0
     fi
-    local -a _subs=("check:Audit generated workflows for drift against the current config/repo (read-only).")
+    local -a _subs=("branch:Generate a branch-target deploy workflow (push to branch triggers deploy)." "tag:Generate a tag-target deploy workflow (tag push triggers deploy)." "preview:Generate a preview workflow (PR open/sync triggers deploy to a per-PR workspace)." "action:Generate a per-app composite action for use with setup coordinate (monorepo multi-app deploys)." "coordinate:Generate a coordinator workflow that orchestrates multiple --action-generated composite actions." "check:Audit generated workflows for drift against the current config/repo (read-only).")
     __tailor_sdk_worker_cdescribe 'subcommands' _subs
 }
 
@@ -4097,7 +4191,7 @@ __tailor_sdk_worker_complete_root() {
         __tailor_sdk_worker_not_used "--help" && _opts+=("--help:Show help")
         __tailor_sdk_worker_cdescribe 'options' _opts
     else
-        local -a _subs=("api:Call Tailor Platform API endpoints directly." "authconnection:Manage auth connections." "crashreport:Manage crash reports." "crash-report:Manage crash reports." "deploy:Deploy your application by applying the Tailor configuration." "apply:Deploy your application by applying the Tailor configuration." "executor:Manage executors" "function:Manage functions" "generate:Generate files using Tailor configuration." "init:Initialize a new project using create-sdk." "login:Login to Tailor Platform." "logout:Logout from Tailor Platform." "machineuser:Manage machine users in your Tailor Platform application." "oauth2client:Manage OAuth2 clients in your Tailor Platform application." "open:Open Tailor Platform Console." "organization:Manage Tailor Platform organizations." "profile:Manage workspace profiles (user + workspace combinations)." "query:Run SQL/GraphQL query." "remove:Remove all resources managed by the application from the workspace." "secret:Manage Secret Manager vaults and secrets." "setup:Generate a CI deploy workflow for your project. (beta)" "show:Show information about the deployed application." "skills:Manage Tailor SDK agent skills." "staticwebsite:Manage static websites in your workspace." "tailordb:Manage TailorDB tables and data." "upgrade:Run codemods to upgrade your project to a newer SDK version." "user:Manage Tailor Platform users." "workflow:Manage workflows and workflow executions." "workspace:Manage Tailor Platform workspaces." "completion:Generate shell completion script")
+        local -a _subs=("api:Call Tailor Platform API endpoints directly." "authconnection:Manage auth connections." "crashreport:Manage crash reports." "crash-report:Manage crash reports." "deploy:Deploy your application by applying the Tailor configuration." "apply:Deploy your application by applying the Tailor configuration." "executor:Manage executors" "function:Manage functions" "generate:Generate files using Tailor configuration." "init:Initialize a new project using create-sdk." "login:Login to Tailor Platform." "logout:Logout from Tailor Platform." "machineuser:Manage machine users in your Tailor Platform application." "oauth2client:Manage OAuth2 clients in your Tailor Platform application." "open:Open Tailor Platform Console." "organization:Manage Tailor Platform organizations." "profile:Manage workspace profiles (user + workspace combinations)." "query:Run SQL/GraphQL query." "remove:Remove all resources managed by the application from the workspace." "secret:Manage Secret Manager vaults and secrets." "setup:Generate CI deploy workflows for your project. (beta)" "show:Show information about the deployed application." "skills:Manage Tailor SDK agent skills." "staticwebsite:Manage static websites in your workspace." "tailordb:Manage TailorDB tables and data." "upgrade:Run codemods to upgrade your project to a newer SDK version." "user:Manage Tailor Platform users." "workflow:Manage workflows and workflow executions." "workspace:Manage Tailor Platform workspaces." "completion:Generate shell completion script")
         __tailor_sdk_worker_cdescribe 'subcommands' _subs
     fi
 }
@@ -4211,6 +4305,11 @@ _tailor_sdk_worker_completions() {
         secret:list) __tailor_sdk_worker_complete_secret_list ;;
         secret:delete) __tailor_sdk_worker_complete_secret_delete ;;
         secret) __tailor_sdk_worker_complete_secret ;;
+        setup:branch) __tailor_sdk_worker_complete_setup_branch ;;
+        setup:tag) __tailor_sdk_worker_complete_setup_tag ;;
+        setup:preview) __tailor_sdk_worker_complete_setup_preview ;;
+        setup:action) __tailor_sdk_worker_complete_setup_action ;;
+        setup:coordinate) __tailor_sdk_worker_complete_setup_coordinate ;;
         setup:check) __tailor_sdk_worker_complete_setup_check ;;
         setup) __tailor_sdk_worker_complete_setup ;;
         show) __tailor_sdk_worker_complete_show ;;

package/docs/cli/setup.md

@@ -4,36 +4,70 @@ Commands for setting up project infrastructure.
 
 ## setup
 
-Generate a CI deploy workflow for your project. (beta)
+Generate CI deploy workflows for your project. (beta)
 
 **Usage**
 
 ```
-tailor-sdk setup [options] [command]
+tailor-sdk setup <command>
+```
+
+See [Global Options](../cli-reference.md#global-options) for options available to all commands.
+
+**Commands**
+
+| Command                                 | Description                                                                                      |
+| --------------------------------------- | ------------------------------------------------------------------------------------------------ |
+| [`setup branch`](#setup-branch)         | Generate a branch-target deploy workflow (push to branch triggers deploy).                       |
+| [`setup tag`](#setup-tag)               | Generate a tag-target deploy workflow (tag push triggers deploy).                                |
+| [`setup preview`](#setup-preview)       | Generate a preview workflow (PR open/sync triggers deploy to a per-PR workspace).                |
+| [`setup action`](#setup-action)         | Generate a per-app composite action for use with setup coordinate (monorepo multi-app deploys).  |
+| [`setup coordinate`](#setup-coordinate) | Generate a coordinator workflow that orchestrates multiple --action-generated composite actions. |
+| [`setup check`](#setup-check)           | Audit generated workflows for drift against the current config/repo (read-only).                 |
+
+### setup action
+
+Generate a per-app composite action for use with setup coordinate (monorepo multi-app deploys).
+
+**Usage**
+
+```
+tailor-sdk setup action [options]
 ```
 
 **Options**
 
-| Option                              | Alias | Description                                                                                                                                       | Required | Default    |
-| ----------------------------------- | ----- | ------------------------------------------------------------------------------------------------------------------------------------------------- | -------- | ---------- |
-| `--provider <PROVIDER>`             | `-p`  | CI provider to generate for (only 'github' is supported)                                                                                          | No       | `"github"` |
-| `--workspace-name <WORKSPACE_NAME>` | `-n`  | Workspace name (defaults to the config 'name')                                                                                                    | No       | -          |
-| `--branch <BRANCH>`                 | -     | Branch target: deploy trigger branch (defaults to the detected default branch). Tag target: tag-reachability guard branch (no guard when omitted) | No       | -          |
-| `--tag`                             | -     | Generate a tag target (deploy on tag push)                                                                                                        | No       | `false`    |
-| `--tag-pattern <TAG_PATTERN>`       | -     | Tag glob to match (requires --tag; defaults to v\*)                                                                                               | No       | -          |
-| `--environment <ENVIRONMENT>`       | -     | GitHub Environment for the plan/deploy jobs (defaults to the workspace name)                                                                      | No       | -          |
-| `--no-plan`                         | -     | Disable the plan job for a branch target (cannot be combined with --tag)                                                                          | No       | `false`    |
-| `--erd-preview`                     | -     | Add PR ERD viewer artifacts with current/diff previews for TailorDB namespaces                                                                    | No       | `false`    |
-| `--dir <DIR>`                       | `-d`  | App directory (for monorepo setups)                                                                                                               | No       | `"."`      |
-| `--force`                           | -     | Discard hand edits / take over unmanaged files and regenerate                                                                                     | No       | `false`    |
+| Option                        | Alias | Description                                         | Required | Default |
+| ----------------------------- | ----- | --------------------------------------------------- | -------- | ------- |
+| `--name <NAME>`               | `-n`  | Name (defaults to the config 'name')                | No       | -       |
+| `--dir <DIR>`                 | `-d`  | App directory                                       | No       | `"."`   |
+| `--environment <ENVIRONMENT>` | -     | GitHub Environment (defaults to the workspace name) | No       | -       |
+| `--force`                     | -     | Discard hand edits and regenerate                   | No       | `false` |
 
 See [Global Options](../cli-reference.md#global-options) for options available to all commands.
 
-**Commands**
+### setup branch
+
+Generate a branch-target deploy workflow (push to branch triggers deploy).
 
-| Command                       | Description                                                                      |
-| ----------------------------- | -------------------------------------------------------------------------------- |
-| [`setup check`](#setup-check) | Audit generated workflows for drift against the current config/repo (read-only). |
+**Usage**
+
+```
+tailor-sdk setup branch [options]
+```
+
+**Options**
+
+| Option                        | Alias | Description                                                                    | Required | Default |
+| ----------------------------- | ----- | ------------------------------------------------------------------------------ | -------- | ------- |
+| `--name <NAME>`               | `-n`  | Name (defaults to the config 'name')                                           | No       | -       |
+| `--branch <BRANCH>`           | -     | Deploy trigger branch (defaults to the detected default branch)                | No       | -       |
+| `--environment <ENVIRONMENT>` | -     | GitHub Environment for the plan/deploy jobs (defaults to the workspace name)   | No       | -       |
+| `--erd-preview`               | -     | Add PR ERD viewer artifacts with current/diff previews for TailorDB namespaces | No       | `false` |
+| `--dir <DIR>`                 | `-d`  | App directory (for monorepo setups)                                            | No       | `"."`   |
+| `--force`                     | -     | Discard hand edits / take over unmanaged files and regenerate                  | No       | `false` |
+
+See [Global Options](../cli-reference.md#global-options) for options available to all commands.
 
 ### setup check
 
@@ -42,9 +76,85 @@ Audit generated workflows for drift against the current config/repo (read-only).
 **Usage**
 
 ```
-tailor-sdk setup check
+tailor-sdk setup check [options]
+```
+
+**Options**
+
+| Option | Alias | Description                                                                                      | Required | Default |
+| ------ | ----- | ------------------------------------------------------------------------------------------------ | -------- | ------- |
+| `--ci` | -     | Run in CI mode: skip checks that are handled by the runtime (e.g. TAILOR_PLATFORM_WORKSPACE_ID). | No       | `false` |
+
+See [Global Options](../cli-reference.md#global-options) for options available to all commands.
+
+### setup coordinate
+
+Generate a coordinator workflow that orchestrates multiple --action-generated composite actions.
+
+**Usage**
+
+```
+tailor-sdk setup coordinate [options]
+```
+
+**Options**
+
+| Option                        | Alias | Description                                                                             | Required | Default |
+| ----------------------------- | ----- | --------------------------------------------------------------------------------------- | -------- | ------- |
+| `--name <NAME>`               | `-n`  | Coordinator name (used in the generated workflow file name and job names)               | Yes      | -       |
+| `--action <ACTION>`           | -     | Composite action to include (can be specified multiple times). tailor- prefix optional. | Yes      | -       |
+| `--branch <BRANCH>`           | -     | Branch target: deploy trigger branch (defaults to the detected default branch)          | No       | -       |
+| `--tag`                       | -     | Generate a tag target coordinator                                                       | No       | `false` |
+| `--environment <ENVIRONMENT>` | -     | GitHub Environment for the plan/deploy jobs                                             | No       | -       |
+| `--force`                     | -     | Discard hand edits and regenerate                                                       | No       | `false` |
+
+See [Global Options](../cli-reference.md#global-options) for options available to all commands.
+
+### setup preview
+
+Generate a preview workflow (PR open/sync triggers deploy to a per-PR workspace).
+
+**Usage**
+
+```
+tailor-sdk setup preview [options]
 ```
 
+**Options**
+
+| Option                        | Alias | Description                                                               | Required | Default |
+| ----------------------------- | ----- | ------------------------------------------------------------------------- | -------- | ------- |
+| `--name <NAME>`               | `-n`  | Name (defaults to the config 'name')                                      | No       | -       |
+| `--branch <BRANCH>`           | -     | Branch to filter PRs by (defaults to the detected default branch)         | No       | -       |
+| `--region <REGION>`           | -     | Workspace region for preview workspace creation (e.g. us-west). Required. | Yes      | -       |
+| `--require-preview-label`     | -     | Deploy preview only for PRs labeled `tailor:preview` instead of all PRs.  | No       | `false` |
+| `--environment <ENVIRONMENT>` | -     | GitHub Environment for the preview jobs (defaults to the workspace name)  | No       | -       |
+| `--dir <DIR>`                 | `-d`  | App directory (for monorepo setups)                                       | No       | `"."`   |
+| `--force`                     | -     | Discard hand edits / take over unmanaged files and regenerate             | No       | `false` |
+
+See [Global Options](../cli-reference.md#global-options) for options available to all commands.
+
+### setup tag
+
+Generate a tag-target deploy workflow (tag push triggers deploy).
+
+**Usage**
+
+```
+tailor-sdk setup tag [options]
+```
+
+**Options**
+
+| Option                        | Alias | Description                                                                  | Required | Default |
+| ----------------------------- | ----- | ---------------------------------------------------------------------------- | -------- | ------- |
+| `--name <NAME>`               | `-n`  | Name (defaults to the config 'name')                                         | No       | -       |
+| `--tag-pattern <TAG_PATTERN>` | -     | Tag glob to match (defaults to v\*)                                          | No       | `"v*"`  |
+| `--branch <BRANCH>`           | -     | Tag-reachability guard branch (no guard when omitted)                        | No       | -       |
+| `--environment <ENVIRONMENT>` | -     | GitHub Environment for the plan/deploy jobs (defaults to the workspace name) | No       | -       |
+| `--dir <DIR>`                 | `-d`  | App directory (for monorepo setups)                                          | No       | `"."`   |
+| `--force`                     | -     | Discard hand edits / take over unmanaged files and regenerate                | No       | `false` |
+
 See [Global Options](../cli-reference.md#global-options) for options available to all commands.
 
 ## Further reading

package/docs/cli-reference.md

@@ -313,10 +313,15 @@ Commands for managing crash reports.
 
 Commands for setting up project infrastructure.
 
-| Command                                   | Description                                                                      |
-| ----------------------------------------- | -------------------------------------------------------------------------------- |
-| [setup](./cli/setup.md#setup)             | Generate a CI deploy workflow for your project. (beta)                           |
-| [setup check](./cli/setup.md#setup-check) | Audit generated workflows for drift against the current config/repo (read-only). |
+| Command                                             | Description                                                                                      |
+| --------------------------------------------------- | ------------------------------------------------------------------------------------------------ |
+| [setup](./cli/setup.md#setup)                       | Generate CI deploy workflows for your project. (beta)                                            |
+| [setup action](./cli/setup.md#setup-action)         | Generate a per-app composite action for use with setup coordinate (monorepo multi-app deploys).  |
+| [setup branch](./cli/setup.md#setup-branch)         | Generate a branch-target deploy workflow (push to branch triggers deploy).                       |
+| [setup check](./cli/setup.md#setup-check)           | Audit generated workflows for drift against the current config/repo (read-only).                 |
+| [setup coordinate](./cli/setup.md#setup-coordinate) | Generate a coordinator workflow that orchestrates multiple --action-generated composite actions. |
+| [setup preview](./cli/setup.md#setup-preview)       | Generate a preview workflow (PR open/sync triggers deploy to a per-PR workspace).                |
+| [setup tag](./cli/setup.md#setup-tag)               | Generate a tag-target deploy workflow (tag push triggers deploy).                                |
 
 ### [Upgrade Commands](./cli/upgrade.md)
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tailor-platform/sdk",
-  "version": "1.71.0",
+  "version": "1.72.0",
   "description": "Tailor Platform SDK - The SDK to work with Tailor Platform",
   "license": "MIT",
   "repository": {