# Cascade

Validate and register a cascade configuration from a YAML file

* [`sfp cascade create`](#sfp-cascade-create)
* [`sfp cascade list`](#sfp-cascade-list)
* [`sfp cascade merge-assist`](#sfp-cascade-merge-assist)
* [`sfp cascade run`](#sfp-cascade-run)
* [`sfp cascade status`](#sfp-cascade-status)

## `sfp cascade create`

Validate and register a cascade configuration from a YAML file

```
USAGE
  $ sfp cascade create -f <value> [--json] [--repository <value>] [-e <value>] [-t <value>] [--sfp-server-url
    <value>] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]

FLAGS
  -e, --email=<value>              Email address for authenticated user. Ignored if --application-token is provided. Can
                                   be set via SFP_SERVER_USER env var.
  -f, --config=<value>             (required) Path to cascade YAML configuration file
  -t, --application-token=<value>  Application token for CI/CD authentication. Can be set via SFP_SERVER_TOKEN env var
                                   (CLI flags take precedence over env vars).
      --loglevel=<option>          [default: info] logging level for this command invocation
                                   <options: trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL>
      --repository=<value>         The repository identifier. E.g `owner/repo` for GitHub/GitLab or `org/project/repo`
                                   for Azure DevOps
      --sfp-server-url=<value>     URL of the SFP server. Can be set via SFP_SERVER_URL env var or config: sfp
                                   config:set server-url

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Validate and register a cascade configuration from a YAML file

EXAMPLES
  $ sfp cascade:create --repository flxbl-io/sf-core --config cascade.yml

  $ sfp cascade:create --repository flxbl-io/sf-core --config cascade.yml --json
```

*See code:* [*src/commands/cascade/create.ts*](https://source.flxbl.io/flxbl/sfp-pro)

## `sfp cascade list`

List cascade configurations for a repository

```
USAGE
  $ sfp cascade list [--json] [--repository <value>] [-e <value>] [-t <value>] [--sfp-server-url <value>]
    [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]

FLAGS
  -e, --email=<value>              Email address for authenticated user. Ignored if --application-token is provided. Can
                                   be set via SFP_SERVER_USER env var.
  -t, --application-token=<value>  Application token for CI/CD authentication. Can be set via SFP_SERVER_TOKEN env var
                                   (CLI flags take precedence over env vars).
      --loglevel=<option>          [default: info] logging level for this command invocation
                                   <options: trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL>
      --repository=<value>         The repository identifier. E.g `owner/repo` for GitHub/GitLab or `org/project/repo`
                                   for Azure DevOps
      --sfp-server-url=<value>     URL of the SFP server. Can be set via SFP_SERVER_URL env var or config: sfp
                                   config:set server-url

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  List cascade configurations for a repository

EXAMPLES
  $ sfp cascade:list --repository flxbl-io/sf-core

  $ sfp cascade:list --repository flxbl-io/sf-core --json
```

*See code:* [*src/commands/cascade/list.ts*](https://source.flxbl.io/flxbl/sfp-pro)

## `sfp cascade merge-assist`

Analyze merge conflicts between branches using AI and optionally create a PR with resolution

```
USAGE
  $ sfp cascade merge-assist -n <value> --edge <value> [--json] [--repository <value>] [-e <value>] [-t <value>]
    [--sfp-server-url <value>] [--provider <value>] [--dry-run] [--loglevel
    trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]

FLAGS
  -e, --email=<value>              Email address for authenticated user. Ignored if --application-token is provided. Can
                                   be set via SFP_SERVER_USER env var.
  -n, --name=<value>               (required) Name of the cascade configuration
  -t, --application-token=<value>  Application token for CI/CD authentication. Can be set via SFP_SERVER_TOKEN env var
                                   (CLI flags take precedence over env vars).
      --dry-run                    Analyze conflicts only without creating a PR
      --edge=<value>               (required) Edge to analyze in format source:target (e.g., main:release/1.0)
      --loglevel=<option>          [default: info] logging level for this command invocation
                                   <options: trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL>
      --provider=<value>           AI provider to use (e.g., anthropic, openai, github-copilot)
      --repository=<value>         The repository identifier. E.g `owner/repo` for GitHub/GitLab or `org/project/repo`
                                   for Azure DevOps
      --sfp-server-url=<value>     URL of the SFP server. Can be set via SFP_SERVER_URL env var or config: sfp
                                   config:set server-url

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Analyze merge conflicts between branches using AI and optionally create a PR with resolution

EXAMPLES
  $ sfp cascade:merge-assist --repository flxbl-io/sf-core --name my-cascade --edge main:release/1.0

  $ sfp cascade:merge-assist --repository flxbl-io/sf-core --name my-cascade --edge main:release/1.0 --dry-run

  $ sfp cascade:merge-assist --repository flxbl-io/sf-core --name my-cascade --edge main:release/1.0 --provider anthropic
```

*See code:* [*src/commands/cascade/merge-assist.ts*](https://source.flxbl.io/flxbl/sfp-pro)

## `sfp cascade run`

Run a cascade edge to propagate changes from source to target branch

```
USAGE
  $ sfp cascade run -n <value> --edge <value> [--json] [--repository <value>] [-e <value>] [-t <value>]
    [--sfp-server-url <value>] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]

FLAGS
  -e, --email=<value>              Email address for authenticated user. Ignored if --application-token is provided. Can
                                   be set via SFP_SERVER_USER env var.
  -n, --name=<value>               (required) Name of the cascade configuration
  -t, --application-token=<value>  Application token for CI/CD authentication. Can be set via SFP_SERVER_TOKEN env var
                                   (CLI flags take precedence over env vars).
      --edge=<value>               (required) Edge to run in format source:target (e.g., main:release/1.0)
      --loglevel=<option>          [default: info] logging level for this command invocation
                                   <options: trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL>
      --repository=<value>         The repository identifier. E.g `owner/repo` for GitHub/GitLab or `org/project/repo`
                                   for Azure DevOps
      --sfp-server-url=<value>     URL of the SFP server. Can be set via SFP_SERVER_URL env var or config: sfp
                                   config:set server-url

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Run a cascade edge to propagate changes from source to target branch

EXAMPLES
  $ sfp cascade:run --repository flxbl-io/sf-core --name my-cascade --edge main:release/1.0

  $ sfp cascade:run --repository flxbl-io/sf-core --name my-cascade --edge main:release/1.0 --json
```

*See code:* [*src/commands/cascade/run.ts*](https://source.flxbl.io/flxbl/sfp-pro)

## `sfp cascade status`

Show the status of a cascade configuration including latest run results per edge

```
USAGE
  $ sfp cascade status -n <value> [--json] [--repository <value>] [-e <value>] [-t <value>] [--sfp-server-url
    <value>] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]

FLAGS
  -e, --email=<value>              Email address for authenticated user. Ignored if --application-token is provided. Can
                                   be set via SFP_SERVER_USER env var.
  -n, --name=<value>               (required) Name of the cascade configuration
  -t, --application-token=<value>  Application token for CI/CD authentication. Can be set via SFP_SERVER_TOKEN env var
                                   (CLI flags take precedence over env vars).
      --loglevel=<option>          [default: info] logging level for this command invocation
                                   <options: trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL>
      --repository=<value>         The repository identifier. E.g `owner/repo` for GitHub/GitLab or `org/project/repo`
                                   for Azure DevOps
      --sfp-server-url=<value>     URL of the SFP server. Can be set via SFP_SERVER_URL env var or config: sfp
                                   config:set server-url

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Show the status of a cascade configuration including latest run results per edge

EXAMPLES
  $ sfp cascade:status --repository flxbl-io/sf-core --name my-cascade

  $ sfp cascade:status --repository flxbl-io/sf-core --name my-cascade --json
```

*See code:* [*src/commands/cascade/status.ts*](https://source.flxbl.io/flxbl/sfp-pro)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.flxbl.io/flxbl/sfp/sfp-community/cli-reference-v51-release-v3/advanced/cascade.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.