Merge branch 'main' into ale-feat-app-naming

Author: srtaalej

cmd/platform/deploy.go

@@ -316,16 +316,13 @@ func printDeployHostingCompletion(clients *shared.ClientFactory, cmd *cobra.Comm
 func errorMissingDeployHook(clients *shared.ClientFactory) error {
 	if !clients.SDKConfig.Hooks.Deploy.IsAvailable() {
 		return slackerror.New(slackerror.ErrSDKHookNotFound).
-			WithMessage("Missing the `deploy` hook from the `%s` file", config.GetProjectHooksJSONFilePath()).
+			WithMessage("No deploy script found").
 			WithRemediation("%s", strings.Join([]string{
-				"Provide a command or script to run with the deploy command by adding a new hook.",
+				"For deployment options, see:",
+				"  https://docs.slack.dev/tools/slack-cli/reference/hooks/#deploy",
 				"",
-				fmt.Sprintf("Example `%s` `deploy` hook:", config.GetProjectHooksJSONFilePath()),
-				"{",
-				`  "hooks": {`,
-				`    "deploy": "./deploy.sh"`,
-				"  }",
-				"}",
+				"To start a local development server, use:",
+				fmt.Sprintf("  %s", style.Commandf("run", false)),
 			}, "\n"))
 	}
 	return nil

cmd/platform/deploy_test.go

@@ -111,12 +111,14 @@ func TestDeployCommand(t *testing.T) {
 
 func TestDeployCommand_HasValidDeploymentMethod(t *testing.T) {
 	tests := map[string]struct {
-		app            types.App
-		manifest       types.SlackYaml
-		manifestError  error
-		manifestSource config.ManifestSource
-		deployScript   string
-		expectedError  error
+		app                 types.App
+		manifest            types.SlackYaml
+		manifestError       error
+		manifestSource      config.ManifestSource
+		deployScript        string
+		expectedError       error
+		expectedMessage     string
+		expectedRemediation []string
 	}{
 		"fails when no manifest exists": {
 			manifestError:  slackerror.New(slackerror.ErrInvalidManifest),
@@ -142,8 +144,10 @@ func TestDeployCommand_HasValidDeploymentMethod(t *testing.T) {
 			deployScript:   "sleep 4",
 		},
 		"fails if no deploy hook is provided": {
-			manifestSource: config.ManifestSourceLocal,
-			expectedError:  slackerror.New(slackerror.ErrSDKHookNotFound),
+			manifestSource:      config.ManifestSourceLocal,
+			expectedError:       slackerror.New(slackerror.ErrSDKHookNotFound),
+			expectedMessage:     "No deploy script found",
+			expectedRemediation: []string{"https://docs.slack.dev/tools/slack-cli/reference/hooks/#deploy", "run"},
 		},
 		"succeeds if the app exists and the manifest source is remote": {
 			app: types.App{
@@ -183,11 +187,14 @@ func TestDeployCommand_HasValidDeploymentMethod(t *testing.T) {
 			err := hasValidDeploymentMethod(ctx, clients, app, types.SlackAuth{})
 			if tc.expectedError != nil {
 				require.Error(t, err)
-				assert.Equal(
-					t,
-					slackerror.ToSlackError(tc.expectedError).Code,
-					slackerror.ToSlackError(err).Code,
-				)
+				slackErr := slackerror.ToSlackError(err)
+				assert.Equal(t, slackerror.ToSlackError(tc.expectedError).Code, slackErr.Code)
+				if tc.expectedMessage != "" {
+					assert.Contains(t, slackErr.Message, tc.expectedMessage)
+				}
+				for _, r := range tc.expectedRemediation {
+					assert.Contains(t, slackErr.Remediation, r)
+				}
 			} else {
 				require.NoError(t, err)
 			}

cmd/project/create.go

@@ -35,6 +35,7 @@ import (
 var createTemplateURLFlag string
 var createGitBranchFlag string
 var createAppNameFlag string
+var createListFlag bool
 
 // Handle to client's create function used for testing
 // TODO - Find best practice, such as using an Interface and Struct to create a client
@@ -80,6 +81,7 @@ name your app 'agent' (not create an AI Agent), use the --name flag instead.`,
 	cmd.Flags().StringVarP(&createTemplateURLFlag, "template", "t", "", "template URL for your app")
 	cmd.Flags().StringVarP(&createGitBranchFlag, "branch", "b", "", "name of git branch to checkout")
 	cmd.Flags().StringVarP(&createAppNameFlag, "name", "n", "", "name for your app (overrides the name argument)")
+	cmd.Flags().BoolVar(&createListFlag, "list", false, "list available app templates")
 
 	return cmd
 }
@@ -124,6 +126,11 @@ func runCreateCommand(clients *shared.ClientFactory, cmd *cobra.Command, args []
 		appNameArg = createAppNameFlag
 	}
 
+	// List templates and exit early if the --list flag is set
+	if createListFlag {
+		return listTemplates(ctx, clients, categoryShortcut)
+	}
+
 	// Collect the template URL or select a starting template
 	template, err := promptTemplateSelection(cmd, clients, categoryShortcut)
 	if err != nil {

cmd/project/create_template.go

@@ -15,6 +15,7 @@
 package project
 
 import (
+	"context"
 	"fmt"
 	"strings"
 	"time"
@@ -240,6 +241,42 @@ func confirmExternalTemplateSelection(cmd *cobra.Command, clients *shared.Client
 	return true, nil
 }
 
+// listTemplates prints available templates for the create command
+func listTemplates(ctx context.Context, clients *shared.ClientFactory, categoryShortcut string) error {
+	type categoryInfo struct {
+		id   string
+		name string
+	}
+
+	var categories []categoryInfo
+	if categoryShortcut == "agent" {
+		categories = []categoryInfo{
+			{id: "slack-cli#ai-apps", name: "AI Agent apps"},
+		}
+	} else {
+		categories = []categoryInfo{
+			{id: "slack-cli#getting-started", name: "Getting started"},
+			{id: "slack-cli#ai-apps", name: "AI Agent apps"},
+			{id: "slack-cli#automation-apps", name: "Automation apps"},
+		}
+	}
+
+	for _, category := range categories {
+		templates := getSelectionOptions(clients, category.id)
+		secondary := make([]string, len(templates))
+		for i, tmpl := range templates {
+			secondary[i] = tmpl.Repository
+		}
+		clients.IO.PrintInfo(ctx, false, style.Sectionf(style.TextSection{
+			Emoji:     "house_buildings",
+			Text:      style.Bold(category.name),
+			Secondary: secondary,
+		}))
+	}
+
+	return nil
+}
+
 // getSelectionTemplate returns a custom formatted template used for selecting a
 // project template during creation
 func getSelectionTemplate(clients *shared.ClientFactory) string {

cmd/project/create_test.go

@@ -414,6 +414,46 @@ func TestCreateCommand(t *testing.T) {
 				cm.IO.AssertNotCalled(t, "InputPrompt", mock.Anything, "Name your app:", mock.Anything)
 			},
 		},
+		"lists all templates with --list flag": {
+			CmdArgs: []string{"--list"},
+			Setup: func(t *testing.T, ctx context.Context, cm *shared.ClientsMock, cf *shared.ClientFactory) {
+				createClientMock = new(CreateClientMock)
+				CreateFunc = createClientMock.Create
+			},
+			ExpectedOutputs: []string{
+				"Getting started",
+				"AI Agent apps",
+				"Automation apps",
+				"slack-samples/bolt-js-starter-template",
+				"slack-samples/bolt-python-starter-template",
+				"slack-samples/bolt-js-assistant-template",
+				"slack-samples/bolt-python-assistant-template",
+				"slack-samples/bolt-js-custom-function-template",
+				"slack-samples/bolt-python-custom-function-template",
+				"slack-samples/deno-starter-template",
+			},
+			ExpectedAsserts: func(t *testing.T, ctx context.Context, cm *shared.ClientsMock) {
+				createClientMock.AssertNotCalled(t, "Create", mock.Anything, mock.Anything, mock.Anything, mock.Anything)
+			},
+		},
+		"lists agent templates with agent --list flag": {
+			CmdArgs: []string{"agent", "--list"},
+			Setup: func(t *testing.T, ctx context.Context, cm *shared.ClientsMock, cf *shared.ClientFactory) {
+				createClientMock = new(CreateClientMock)
+				CreateFunc = createClientMock.Create
+			},
+			ExpectedOutputs: []string{
+				"AI Agent apps",
+				"slack-samples/bolt-js-assistant-template",
+				"slack-samples/bolt-python-assistant-template",
+			},
+			ExpectedAsserts: func(t *testing.T, ctx context.Context, cm *shared.ClientsMock) {
+				createClientMock.AssertNotCalled(t, "Create", mock.Anything, mock.Anything, mock.Anything, mock.Anything)
+				output := cm.GetCombinedOutput()
+				assert.NotContains(t, output, "Getting started")
+				assert.NotContains(t, output, "Automation apps")
+			},
+		},
 	}, func(cf *shared.ClientFactory) *cobra.Command {
 		return NewCreateCommand(cf)
 	})

docs/guides/installing-the-slack-cli-for-mac-and-linux.md

@@ -99,11 +99,11 @@ Manual installation allows you to customize certain paths used when installing t
 
 **2\. Download the** `slack` **CLI installer for your environment.**
 
-🍎 ⚡️ [**Download for macOS Apple Silicon (.tar.gz)**](https://downloads.slack-edge.com/slack-cli/slack_cli_3.12.0_macOS_arm64.tar.gz)
+🍎 ⚡️ [**Download for macOS Apple Silicon (.tar.gz)**](https://downloads.slack-edge.com/slack-cli/slack_cli_3.13.0_macOS_arm64.tar.gz)
 
-🍏 🪨 [**Download for macOS Intel (.tar.gz)**](https://downloads.slack-edge.com/slack-cli/slack_cli_3.12.0_macOS_amd64.tar.gz)
+🍏 🪨 [**Download for macOS Intel (.tar.gz)**](https://downloads.slack-edge.com/slack-cli/slack_cli_3.13.0_macOS_amd64.tar.gz)
 
-🐧 💾 [**Download for Linux (.tar.gz)**](https://downloads.slack-edge.com/slack-cli/slack_cli_3.12.0_linux_64-bit.tar.gz)
+🐧 💾 [**Download for Linux (.tar.gz)**](https://downloads.slack-edge.com/slack-cli/slack_cli_3.13.0_linux_64-bit.tar.gz)
 
 **3\. Add the** `slack` **CLI to your path.**
 
@@ -121,7 +121,7 @@ We recommend using an alias if another `slack` binary exists. To do this, change
 
 ```sh
 $ slack version
-Using slack v3.12.0
+Using slack v3.13.0
 ```
 
 </TabItem>

docs/guides/installing-the-slack-cli-for-windows.md

@@ -88,7 +88,7 @@ Manual installation allows you to customize certain paths used when installing t
 
 **2\. Download the** `slack` **CLI installer for your environment.**
 
-<ts-icon class="ts_icon_windows"></ts-icon> &nbsp; <a href="https://downloads.slack-edge.com/slack-cli/slack_cli_3.12.0_windows_64-bit.zip"><strong>Windows (.zip)</strong></a>
+<ts-icon class="ts_icon_windows"></ts-icon> &nbsp; <a href="https://downloads.slack-edge.com/slack-cli/slack_cli_3.13.0_windows_64-bit.zip"><strong>Windows (.zip)</strong></a>
 
 **3\. Add the** `slack` **CLI to your path.**
 
@@ -104,7 +104,7 @@ We recommend using an alias if another `slack` binary exists. To do this, change
 
 ```pwsh
 $ slack version
-Using slack v3.12.0
+Using slack v3.13.0
 ```
 
 </TabItem>

docs/reference/commands/slack_create.md

@@ -4,17 +4,22 @@ Create a new Slack project
 
 ## Description
 
-Create a new Slack project on your local machine from an optional template
+Create a new Slack project on your local machine from an optional template.
+
+The 'agent' argument is a shortcut to create an AI Agent app. If you want to
+name your app 'agent' (not create an AI Agent), use the --name flag instead.
 
 ```
-slack create [name] [flags]
+slack create [name | agent <name>] [flags]
 ```
 
 ## Flags
 
 ```
   -b, --branch string     name of git branch to checkout
   -h, --help              help for create
+      --list              list available app templates
+  -n, --name string       name for your app (overrides the name argument)
   -t, --template string   template URL for your app
 ```
 
@@ -38,8 +43,14 @@ slack create [name] [flags]
 # Create a new project from a template
 $ slack create my-project
 
+# Create a new AI Agent app
+$ slack create agent my-agent-app
+
 # Start a new project from a specific template
 $ slack create my-project -t slack-samples/deno-hello-world
+
+# Create a project named 'my-project'
+$ slack create --name my-project
 ```
 
 ## See also

docs/reference/commands/slack_project_create.md

@@ -4,17 +4,22 @@ Create a new Slack project
 
 ## Description
 
-Create a new Slack project on your local machine from an optional template
+Create a new Slack project on your local machine from an optional template.
+
+The 'agent' argument is a shortcut to create an AI Agent app. If you want to
+name your app 'agent' (not create an AI Agent), use the --name flag instead.
 
 ```
-slack project create [name] [flags]
+slack project create [name | agent <name>] [flags]
 ```
 
 ## Flags
 
 ```
   -b, --branch string     name of git branch to checkout
   -h, --help              help for create
+      --list              list available app templates
+  -n, --name string       name for your app (overrides the name argument)
   -t, --template string   template URL for your app
 ```
 
@@ -38,8 +43,14 @@ slack project create [name] [flags]
 # Create a new project from a template
 $ slack create my-project
 
+# Create a new AI Agent app
+$ slack create agent my-agent-app
+
 # Start a new project from a specific template
 $ slack create my-project -t slack-samples/deno-hello-world
+
+# Create a project named 'my-project'
+$ slack create --name my-project
 ```
 
 ## See also

internal/prompts/app_select.go

@@ -245,12 +245,21 @@ func getAuths(ctx context.Context, clients *shared.ClientFactory) ([]types.Slack
 		}
 	}
 	if len(allAuths) == 0 {
-		auth := types.SlackAuth{}
-		err := validateAuth(ctx, clients, &auth)
+		// No workspaces connected - prompt user to login if interactive
+		if !clients.IO.IsTTY() {
+			return nil, slackerror.New(slackerror.ErrNotAuthed).
+				WithMessage("No workspaces connected").
+				WithRemediation("Run %s to sign in to a workspace", style.Commandf("login", false))
+		}
+		clients.IO.PrintInfo(ctx, false, "\n%s", style.Sectionf(style.TextSection{
+			Emoji: "wave",
+			Text:  "No workspaces connected. Sign in to get started.",
+		}))
+		newAuth, _, err := authpkg.LoginWithClients(ctx, clients, "", false)
 		if err != nil {
-			return nil, slackerror.New(slackerror.ErrNotAuthed)
+			return nil, slackerror.New(slackerror.ErrNotAuthed).WithRootCause(err)
 		}
-		allAuths = append(allAuths, auth)
+		allAuths = append(allAuths, newAuth)
 	}
 	return allAuths, nil
 }