Fix format inconsistency in SAM CLI help text

[vicheey]

Which issue(s) does this change fix?

Fix format inconsistency issue across SAM CLI help text.

Why is this change necessary?

SAM CLI commands had inconsistent help text formatting with different section structures, spacing, and organization. Some commands used custom formatters while others used the base CoreCommand pattern. This inconsistency made the CLI harder to read and maintain.

How does it address the issue?

• Migrated all commands to use the CoreCommand pattern with consistent section structure
• Standardized option grouping across commands (e.g., "AWS Credential Options", "Configuration Options", "Other Options")
• Implemented nested indented_section formatting for example section with descriptive titles
• Used RowDefinition(text="\n") for consistent spacing before command in example sections
• Removed 19 custom formatter files.
• Added proper type hints (-> Dict, -> CommandHelpTextFormatter, -> None) to satisfy mypy
• Created core command structures for pipeline init and bootstrap commands

What side effects does this change have?

• Help text output format changes for all commands (improved consistency and readability)
• Deleted 19 custom formatter files, reducing code duplication
• All existing tests updated to match new format expectations
• Added 2 new test files for pipeline commands

Mandatory Checklist

PRs will only be reviewed after checklist is complete

• Review the generative AI contribution guidelines
• Add input/output type hints to new functions/methods
• Write design document if needed ([Do I need to write a design document?](https://github.com/aws/aws-sam-cli/blob/develop/DEVELOPMENT_GUIDE.md#
  design-document))
• Write/update unit tests
• Write/update integration tests
• Write/update functional tests if needed
• make pr passes
• make update-reproducible-reqs if dependencies were changed
• Write documentation

By submitting this pull request, I confirm that my contribution is made under the terms of the Apache 2.0 license.

[reedham-aws]

Do you have an example of what some of the changed commands look like before and after?

[vicheey]

samdev pipeline -h

Before

After

---

samdev pipeline init -h

Before

After

---

samdev pipeline bootstrap -h

Before

After

[vicheey]

sam deploy -h

Before

After

---

sam build -h

Before

After

---

[vicheey]

sam delete -h

Before

After

[vicheey]

sam local -h

Before

After

[vicheey]

sam remote -h

Before

After

[vicheey]

sam remote invoke -h

Before

After

[vicheey]

sam remote execution -h

Before

After

[roger-zhangg]

do you have a chance to remove the new tag from the main command help as well?

sam --help

  Learn:
    docs NEW!           Launch the AWS SAM CLI documentation in a browser.

  Create an App:
    init                Initialize an AWS SAM application.

  Develop your App:
    build               Build your AWS serverless function code.
    local               Run your AWS serverless function locally.
    validate            Validate an AWS SAM template.
    sync NEW!           Sync an AWS SAM project to AWS.
    remote NEW!         Invoke or send an event to cloud resources in your AWS
                        Cloudformation stack.

  Deploy your App:
    package             Package an AWS SAM application.
    deploy              Deploy an AWS SAM application.

  Monitor your App:
    logs                Fetch AWS Cloudwatch logs for AWS Lambda Functions or
                        Cloudwatch Log groups.
    traces              Fetch AWS X-Ray traces.

  And More:
    list NEW!           Fetch the state of your AWS serverless application.

[vicheey]

sam package -h

Before

After

[vicheey]

sam -h

Before

After

[vicheey]

sam publish -h

Before

After

[vicheey]

sam traces -h

before

after

[vicheey]

sam local start-api -h

before

after

[valerena]

I personally don't like all the extra space that some of the SAM CLI help outputs had, and now it looks like now we're unifying all the commands to have that extra space. (for example sam local --help)
old

$ sam local --help
Usage: sam local [OPTIONS] COMMAND [ARGS]...

  Run your Serverless application locally for quick development & testing

Options:
  -h, --help  Show this message and exit.

Commands:
  callback        Send callbacks to durable function executions
  execution       Manage durable function executions
  generate-event  Generate events for Lambda functions.
  invoke          Invoke AWS serverless functions locally.
  start-api       Run & test AWS serverless functions locally as a HTTP API.
  start-lambda    Emulate AWS serverless functions locally.

vs new

$ sam local --help

Usage: sam local [OPTIONS] COMMAND [ARGS]...

  Run your Serverless application locally for quick development & testing

Options:

  -h, --help  Show this message and exit.

Commands:

  callback (NEW!)    Send callbacks to durable function executions

  execution (NEW!)   Manage durable function executions

  generate-event     Generate events for Lambda functions.

  invoke             Invoke AWS serverless functions locally.

  start-api          Run & test AWS serverless functions locally as a HTTP API.

  start-lambda       Emulate AWS serverless functions locally.

Do you know why we have all the extra space? Is that a conscious decision?

[valerena]

Now in the code I see that it's not just "a format thing", but we explicitly add new lines everywhere. Do we like that?

[vicheey]

Now in the code I see that it's not just "a format thing", but we explicitly add new lines everywhere. Do we like that?

Before the changes, some command had space between option description while some didn't. For consistency, either add space or remove all space. I chose to add because it provided clear separation especially for multiline description.

Do you prefer no line like the before in here: #8663 (comment)?

[vicheey]

TODO: remove the new line between command option description.