Cascade

Validate and register a cascade configuration from a YAML file

• sfp cascade create
• sfp cascade list
• sfp cascade merge-assist
• sfp cascade run
• 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

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

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

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

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