feat: deprecate the "branch" and "template" flag for the samples command

[zimeg]

Changelog

We've deprecated the --branch and --template flag for the slack samples command. If those were used prior, we recommend using the slack create command with these options.

Summary

This PR deprecates the the --branch and --template flags of the slack samples command.

Preview

$ slack samples -t slack-samples/bolt-js-getting-started-app
Check /Users/eden.zimbelman/.slack/logs/slack-debug-20250813.log for error logs
⚠️ DEPRECATED: The '--branch' and '--template' flags are deprecated for the 'samples' command; use the 'create' command instead
📂 Created a new Slack project
Cloning template slack-samples/bolt-js-getting-started-app
To path ~/programming/tools/slack-cli/optimistic-orca-30
...

Reviewers

Confirm the samples command continues to work as expected:

$ slack samples --list --language node
$ slack samples my-app

Requirements

• I've read and understood the Contributing Guidelines and have done my best effort to follow them.
• I've read and agree to the Code of Conduct.

[codecov]

Codecov Report

❌ Patch coverage is 70.00000% with 3 lines in your changes missing coverage. Please review.
✅ Project coverage is 62.98%. Comparing base (1d23e94) to head (fbdd02e).
⚠️ Report is 1 commits behind head on main.

Files with missing lines	Patch %	Lines
cmd/project/samples.go	70.00%	2 Missing and 1 partial ⚠️

Additional details and impacted files

@@ Coverage Diff @@## main #193 +/- ##
==========================================
- Coverage 63.00% 62.98% -0.03% 
==========================================
Files 212 212 Lines 21848 21857 +9 ==========================================
Hits 13766 13766 - Misses 7018 7022 +4 - Partials 1064 1069 +5 

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[mwbrooks]

✅ Looks good to me and thanks for adding the (semver:major) comments and deprecation warning!

📝 I left a small suggestion and question. FWIW I'm in favour of deprecated both of these flags to simplify the code and command usage. 👌🏻

[mwbrooks]

thought: FWIW I think --branch has a legit use-case with the slack samples command. However, I get the idea that slack samples is meant to discover the available templates and isn't meant to target advanced use-cases. The slack create command is designed to handle the general-purpose and advanced ones.

[zimeg]

@mwbrooks Thanks for sharing this - I was thinking the same to recommend the create command when creating a specific branch.

I'm wondering if we can revisit this in following change to show samples that have an existing branch when this flag is provided to avoid errors during a git clone?

Will be thinking about this and related docs! 📚

[mwbrooks]

Sounds good! All in all, I'm in favour of a simpler samples command and leaving the advanced usage to create.

[zimeg]

@mwbrooks The review and suggestion is appreciated as always!

I'm hoping we can move to more opinionated options with these flags and commands with the next major set of changes but for now let's deprecate 🪓