feat: add Forms management commands

Makefile

@@ -166,7 +166,7 @@ test-unit: ## Run unit tests
 	${call print, "Running unit tests"}
 	@go test -v -race ${GO_PACKAGES} -coverprofile="coverage-unit-tests.out"
 
-test-integration: install-with-cover $(GO_BIN)/auth0 $(GO_BIN)/commander ## Run integration tests. To run a specific test pass the FILTER var. Usage: `make test-integration FILTER="attack protection"`
+test-integration: install-with-cover $(GO_BIN)/auth0 $(GO_BIN)/commander ## Run integration tests. To run a specific test pass the FILTER var. Usage: `make test-integration FILTER="attack protection"`. To run a single suite file pass the FILE var. Usage: `make test-integration FILE="./test/integration/forms-test-cases.yaml"`
 	${call print, "Running integration tests"}
 	@mkdir -p "coverage"
 	@PATH=$(GO_BIN):$$PATH \

README.md

@@ -273,6 +273,7 @@ Select **y** to proceed with your default tenant, or **N** to choose a different
 - [auth0 completion](https://auth0.github.io/auth0-cli/auth0_completion.html) - Setup autocomplete features for this CLI on your terminal
 - [auth0 domains](https://auth0.github.io/auth0-cli/auth0_domains.html) - Manage custom domains
 - [auth0 email](https://auth0.github.io/auth0-cli/auth0_email.html) - Manage email settings
+- [auth0 forms](https://auth0.github.io/auth0-cli/auth0_forms.html) - Manage Forms
 - [auth0 login](https://auth0.github.io/auth0-cli/auth0_login.html) - Authenticate the Auth0 CLI
 - [auth0 logout](https://auth0.github.io/auth0-cli/auth0_logout.html) - Log out of a tenant's session
 - [auth0 logs](https://auth0.github.io/auth0-cli/auth0_logs.html) - View tenant logs

docs/auth0_forms.md

@@ -0,0 +1,20 @@
+---
+layout: default
+has_toc: false
+has_children: true
+---
+# auth0 forms
+
+Forms are customizable screens you can insert into a flow to collect input from users during authentication and other journeys.
+
+## Commands
+
+- [auth0 forms create](auth0_forms_create.md) - Create a new form
+- [auth0 forms delete](auth0_forms_delete.md) - Delete a form
+- [auth0 forms export](auth0_forms_export.md) - Export a form
+- [auth0 forms import](auth0_forms_import.md) - Import a form
+- [auth0 forms list](auth0_forms_list.md) - List your forms
+- [auth0 forms open](auth0_forms_open.md) - Open a form in the Auth0 Dashboard
+- [auth0 forms show](auth0_forms_show.md) - Show a form
+- [auth0 forms update](auth0_forms_update.md) - Update a form
+

docs/auth0_forms_create.md

@@ -0,0 +1,68 @@
+---
+layout: default
+parent: auth0 forms
+has_toc: false
+---
+# auth0 forms create
+
+Create a new form.
+
+Interactive behavior: `auth0 forms create` asks only for the name and creates a minimal scaffold; it does not open an editor. You can then refine the form in the dashboard builder.
+
+Pass `--edit` to open an editor and author the form graph before it is created, or supply the whole body via `--file` (or piped stdin) with optional `--name` and `--language-*` overrides. Run `auth0 forms create --example > form.json` to generate an accepted file payload.
+
+## Usage
+```
+auth0 forms create [flags]
+```
+
+## Examples
+
+```
+  auth0 forms create
+  auth0 forms create --name "My Form"
+  auth0 forms create --name "My Form" --edit
+  auth0 forms create --example > form.json
+  auth0 forms create --file ./form.json
+  auth0 forms create --file ./form.json --name "My Form" --language-primary en
+  cat form.json | auth0 forms create -f -
+```
+
+
+## Flags
+
+```
+      --edit                      Open an editor to author the form graph after entering the name.
+      --example                   Print an example form JSON body and exit.
+  -f, --file string               Path to a JSON file with the form body. Use '-' to read from stdin.
+      --json                      Output in json format.
+      --json-compact              Output in compact json format.
+      --language-default string   Default language of the Form (e.g. en).
+      --language-primary string   Primary language of the Form (e.g. en).
+      --name string               Name of the Form.
+```
+
+
+## Inherited Flags
+
+```
+      --agent-mode      Output JSON, disable prompts and colors. Auto-enabled for AI agents; set AUTH0_AGENT_MODE=false to disable.
+      --debug           Enable debug mode.
+      --no-color        Disable colors.
+      --no-input        Disable interactivity.
+      --tenant string   Specific tenant to use.
+```
+
+
+## Related Commands
+
+- [auth0 forms create](auth0_forms_create.md) - Create a new form
+- [auth0 forms delete](auth0_forms_delete.md) - Delete a form
+- [auth0 forms export](auth0_forms_export.md) - Export a form
+- [auth0 forms import](auth0_forms_import.md) - Import a form
+- [auth0 forms list](auth0_forms_list.md) - List your forms
+- [auth0 forms open](auth0_forms_open.md) - Open a form in the Auth0 Dashboard
+- [auth0 forms show](auth0_forms_show.md) - Show a form
+- [auth0 forms update](auth0_forms_update.md) - Update a form
+
+

docs/auth0_forms_delete.md

@@ -0,0 +1,59 @@
+---
+layout: default
+parent: auth0 forms
+has_toc: false
+---
+# auth0 forms delete
+
+Delete a form.
+
+To delete interactively, use `auth0 forms delete` with no arguments.
+
+To delete non-interactively, supply the form id and the `--force` flag to skip confirmation.
+
+## Usage
+```
+auth0 forms delete [flags]
+```
+
+## Examples
+
+```
+  auth0 forms delete
+  auth0 forms rm
+  auth0 forms delete <form-id>
+  auth0 forms delete <form-id> --force
+  auth0 forms delete <form-id> <form-id2> <form-idn>
+```
+
+
+## Flags
+
+```
+      --force   Skip confirmation.
+```
+
+
+## Inherited Flags
+
+```
+      --agent-mode      Output JSON, disable prompts and colors. Auto-enabled for AI agents; set AUTH0_AGENT_MODE=false to disable.
+      --debug           Enable debug mode.
+      --no-color        Disable colors.
+      --no-input        Disable interactivity.
+      --tenant string   Specific tenant to use.
+```
+
+
+## Related Commands
+
+- [auth0 forms create](auth0_forms_create.md) - Create a new form
+- [auth0 forms delete](auth0_forms_delete.md) - Delete a form
+- [auth0 forms export](auth0_forms_export.md) - Export a form
+- [auth0 forms import](auth0_forms_import.md) - Import a form
+- [auth0 forms list](auth0_forms_list.md) - List your forms
+- [auth0 forms open](auth0_forms_open.md) - Open a form in the Auth0 Dashboard
+- [auth0 forms show](auth0_forms_show.md) - Show a form
+- [auth0 forms update](auth0_forms_update.md) - Update a form
+
+

docs/auth0_forms_export.md

@@ -0,0 +1,55 @@
+---
+layout: default
+parent: auth0 forms
+has_toc: false
+---
+# auth0 forms export
+
+Export a form as JSON. Writes to stdout by default (pipe-friendly) or to a file with `--output`. The output uses the same envelope as the Auth0 Dashboard (`version`, `form`, `flows`, `connections`), bundling the flows and vault connections the form references with portable `#FLOW-N#`/`#CONN-N#` placeholders, so it can be imported by the CLI or opened in the Dashboard.
+
+## Usage
+```
+auth0 forms export [flags]
+```
+
+## Examples
+
+```
+  auth0 forms export <form-id>
+  auth0 forms export <form-id> --output ./form.json
+  auth0 forms export <form-id> --json-compact
+  auth0 forms export <form-id> | auth0 forms import -f -
+```
+
+
+## Flags
+
+```
+      --json-compact    Output in compact json format.
+  -o, --output string   Path to write the exported form. Writes to stdout when omitted.
+```
+
+
+## Inherited Flags
+
+```
+      --agent-mode      Output JSON, disable prompts and colors. Auto-enabled for AI agents; set AUTH0_AGENT_MODE=false to disable.
+      --debug           Enable debug mode.
+      --no-color        Disable colors.
+      --no-input        Disable interactivity.
+      --tenant string   Specific tenant to use.
+```
+
+
+## Related Commands
+
+- [auth0 forms create](auth0_forms_create.md) - Create a new form
+- [auth0 forms delete](auth0_forms_delete.md) - Delete a form
+- [auth0 forms export](auth0_forms_export.md) - Export a form
+- [auth0 forms import](auth0_forms_import.md) - Import a form
+- [auth0 forms list](auth0_forms_list.md) - List your forms
+- [auth0 forms open](auth0_forms_open.md) - Open a form in the Auth0 Dashboard
+- [auth0 forms show](auth0_forms_show.md) - Show a form
+- [auth0 forms update](auth0_forms_update.md) - Update a form
+
+

docs/auth0_forms_import.md

@@ -0,0 +1,60 @@
+---
+layout: default
+parent: auth0 forms
+has_toc: false
+---
+# auth0 forms import
+
+Import a form from a JSON file (or piped stdin). Without `--id` a new form is created; with `--id` the existing form is replaced.
+
+Both a flat form graph and the Dashboard envelope (`version`, `form`, `flows`, `connections`) are accepted. For an envelope, the bundled flows are created and each `#CONN-N#` connection placeholder is mapped to an existing vault connection, either interactively or with `--connection`.
+
+## Usage
+```
+auth0 forms import [flags]
+```
+
+## Examples
+
+```
+  auth0 forms import --file ./form.json
+  auth0 forms import --file ./form.json --id <form-id>
+  auth0 forms import --file ./form.json --connection '#CONN-1#=ac_123'
+  cat form.json | auth0 forms import -f -
+```
+
+
+## Flags
+
+```
+      --connection stringToString   Map an exported connection placeholder to an existing vault connection ID, e.g. --connection '#CONN-1#=ac_123'. Repeatable. (default [])
+  -f, --file string                 Path to a JSON file with the form body. Use '-' to read from stdin.
+      --id string                   Id of an existing Form to replace. When omitted, a new form is created.
+      --json                        Output in json format.
+      --json-compact                Output in compact json format.
+```
+
+
+## Inherited Flags
+
+```
+      --agent-mode      Output JSON, disable prompts and colors. Auto-enabled for AI agents; set AUTH0_AGENT_MODE=false to disable.
+      --debug           Enable debug mode.
+      --no-color        Disable colors.
+      --no-input        Disable interactivity.
+      --tenant string   Specific tenant to use.
+```
+
+
+## Related Commands
+
+- [auth0 forms create](auth0_forms_create.md) - Create a new form
+- [auth0 forms delete](auth0_forms_delete.md) - Delete a form
+- [auth0 forms export](auth0_forms_export.md) - Export a form
+- [auth0 forms import](auth0_forms_import.md) - Import a form
+- [auth0 forms list](auth0_forms_list.md) - List your forms
+- [auth0 forms open](auth0_forms_open.md) - Open a form in the Auth0 Dashboard
+- [auth0 forms show](auth0_forms_show.md) - Show a form
+- [auth0 forms update](auth0_forms_update.md) - Update a form
+
+

docs/auth0_forms_list.md

@@ -0,0 +1,58 @@
+---
+layout: default
+parent: auth0 forms
+has_toc: false
+---
+# auth0 forms list
+
+List your existing forms. To create one, run: `auth0 forms create`.
+
+## Usage
+```
+auth0 forms list [flags]
+```
+
+## Examples
+
+```
+  auth0 forms list
+  auth0 forms ls
+  auth0 forms ls --number 100
+  auth0 forms ls --json
+  auth0 forms ls --csv
+```
+
+
+## Flags
+
+```
+      --csv            Output in csv format.
+      --json           Output in json format.
+      --json-compact   Output in compact json format.
+  -n, --number int     Number of forms to retrieve. Fetched across pages. (default 100)
+```
+
+
+## Inherited Flags
+
+```
+      --agent-mode      Output JSON, disable prompts and colors. Auto-enabled for AI agents; set AUTH0_AGENT_MODE=false to disable.
+      --debug           Enable debug mode.
+      --no-color        Disable colors.
+      --no-input        Disable interactivity.
+      --tenant string   Specific tenant to use.
+```
+
+
+## Related Commands
+
+- [auth0 forms create](auth0_forms_create.md) - Create a new form
+- [auth0 forms delete](auth0_forms_delete.md) - Delete a form
+- [auth0 forms export](auth0_forms_export.md) - Export a form
+- [auth0 forms import](auth0_forms_import.md) - Import a form
+- [auth0 forms list](auth0_forms_list.md) - List your forms
+- [auth0 forms open](auth0_forms_open.md) - Open a form in the Auth0 Dashboard
+- [auth0 forms show](auth0_forms_show.md) - Show a form
+- [auth0 forms update](auth0_forms_update.md) - Update a form
+
+

docs/auth0_forms_open.md

@@ -0,0 +1,47 @@
+---
+layout: default
+parent: auth0 forms
+has_toc: false
+---
+# auth0 forms open
+
+Open a form's page in the Auth0 Dashboard form builder.
+
+## Usage
+```
+auth0 forms open [flags]
+```
+
+## Examples
+
+```
+  auth0 forms open
+  auth0 forms open <form-id>
+```
+
+
+
+
+## Inherited Flags
+
+```
+      --agent-mode      Output JSON, disable prompts and colors. Auto-enabled for AI agents; set AUTH0_AGENT_MODE=false to disable.
+      --debug           Enable debug mode.
+      --no-color        Disable colors.
+      --no-input        Disable interactivity.
+      --tenant string   Specific tenant to use.
+```
+
+
+## Related Commands
+
+- [auth0 forms create](auth0_forms_create.md) - Create a new form
+- [auth0 forms delete](auth0_forms_delete.md) - Delete a form
+- [auth0 forms export](auth0_forms_export.md) - Export a form
+- [auth0 forms import](auth0_forms_import.md) - Import a form
+- [auth0 forms list](auth0_forms_list.md) - List your forms
+- [auth0 forms open](auth0_forms_open.md) - Open a form in the Auth0 Dashboard
+- [auth0 forms show](auth0_forms_show.md) - Show a form
+- [auth0 forms update](auth0_forms_update.md) - Update a form
+
+