feat: init project (#161)

* feat(cli): add init-project command

Added new 'init-project' command for creating a new project. Also updated root command to include 'init-project'. Added checks for project id in 'internal/projects' package. Additionally, changed an error message in 'internal/app' package to correctly state "invalid app ID".

* fix typo

* feat: use gitutil.EnsureGitignore in initialize and initproject

- Import gitutil in initialize.go and initproject.go
- Replace ensureGitignore() usage with gitutil.EnsureGitignore() in initialize.go
- Add gitutil.EnsureGitignore() call in initproject.go

* fix typo

Author: Abraxas-365

cmd/initialize/initialize.go

@@ -13,6 +13,7 @@ import (
 	"github.com/Hyphen/cli/pkg/cprint"
 	"github.com/Hyphen/cli/pkg/errors"
 	"github.com/Hyphen/cli/pkg/flags"
+	"github.com/Hyphen/cli/pkg/gitutil"
 	"github.com/Hyphen/cli/pkg/prompt"
 	"github.com/spf13/cobra"
 )
@@ -166,7 +167,7 @@ func runInit(cmd *cobra.Command, args []string) {
 		return
 	}
 
-	if err := ensureGitignore(manifest.ManifestSecretFile); err != nil {
+	if err := gitutil.EnsureGitignore(manifest.ManifestSecretFile); err != nil {
 		printer.Error(cmd, fmt.Errorf("error adding .hxkey to .gitignore: %w. Please do this manually if you wish", err))
 	}
 
@@ -279,7 +280,7 @@ func createGitignoredFile(cmd *cobra.Command, fileName string) error {
 		return err
 	}
 
-	if err := ensureGitignore(fileName); err != nil {
+	if err := gitutil.EnsureGitignore(fileName); err != nil {
 		printer.Error(cmd, fmt.Errorf("error adding %s to .gitignore: %w. Please do this manually if you wish", fileName, err))
 		// don't error here. Keep going.
 	}

cmd/initproject/initproject.go

@@ -0,0 +1,243 @@
+package initproject
+
+import (
+	"fmt"
+	"os"
+	"path/filepath"
+	"strings"
+
+	"github.com/Hyphen/cli/internal/manifest"
+	"github.com/Hyphen/cli/internal/projects"
+	"github.com/Hyphen/cli/pkg/cprint"
+	"github.com/Hyphen/cli/pkg/errors"
+	"github.com/Hyphen/cli/pkg/flags"
+	"github.com/Hyphen/cli/pkg/gitutil"
+	"github.com/Hyphen/cli/pkg/prompt"
+	"github.com/spf13/cobra"
+)
+
+var projectIDFlag string
+var printer *cprint.CPrinter
+
+var InitProjectCmd = &cobra.Command{
+	Use:   "init-project <project name>",
+	Short: "Initialize a new Hyphen project in the current directory",
+	Long: `
+The init-project command sets up a new Hyphen project in your current directory.
+
+This command will:
+- Create a new project in Hyphen
+- Generate a local configuration file
+
+If no project name is provided, it will prompt to use the current directory name.
+
+The command will guide you through:
+- Confirming or entering a project name
+- Generating or providing a project ID
+- Creating necessary local files
+
+After initialization, you'll receive a summary of the new project, including its name, 
+ID, and associated organization.
+
+Examples:
+  hyphen init-project
+  hyphen init-project "My New Project"
+  hyphen init-project "My New Project" --id my-custom-project-id
+`,
+	Args: cobra.MaximumNArgs(1),
+	Run:  runInitProject,
+}
+
+func init() {
+	InitProjectCmd.Flags().StringVarP(&projectIDFlag, "id", "i", "", "Project ID (optional)")
+}
+
+func runInitProject(cmd *cobra.Command, args []string) {
+	printer = cprint.NewCPrinter(flags.VerboseFlag)
+
+	if err := isValidDirectory(cmd); err != nil {
+		printer.Error(cmd, err)
+		printer.Info("Please change to a project directory and try again.")
+		return
+	}
+
+	orgID, err := flags.GetOrganizationID()
+	if err != nil {
+		printer.Error(cmd, err)
+		return
+	}
+
+	projectService := projects.NewService(orgID)
+
+	projectName := ""
+	if len(args) == 0 {
+		cwd, err := os.Getwd()
+		if err != nil {
+			printer.Error(cmd, err)
+			return
+		}
+
+		projectName = filepath.Base(cwd)
+		response := prompt.PromptYesNo(cmd, fmt.Sprintf("Use the current directory name '%s' as the project name?", projectName), true)
+		if !response.Confirmed {
+			if response.IsFlag {
+				printer.Info("Operation cancelled due to --no flag.")
+				return
+			} else {
+				projectName, err = prompt.PromptString(cmd, "What would you like the project name to be?")
+				if err != nil {
+					printer.Error(cmd, err)
+					return
+				}
+			}
+		}
+	} else {
+		projectName = args[0]
+	}
+
+	projectAlternateId := getProjectID(cmd, projectName)
+	if projectAlternateId == "" {
+		return
+	}
+
+	if manifest.ExistsLocal() {
+		response := prompt.PromptYesNo(cmd, "Config file exists. Do you want to overwrite it?", false)
+		if !response.Confirmed {
+			if response.IsFlag {
+				printer.Info("Operation cancelled due to --no flag.")
+			} else {
+				printer.Info("Operation cancelled.")
+			}
+			return
+		}
+	}
+
+	newProject := projects.Project{
+		Name:        projectName,
+		AlternateID: projectAlternateId,
+	}
+
+	createdProject, err := projectService.CreateProject(newProject)
+	if err != nil {
+		if !errors.Is(err, errors.ErrConflict) {
+			printer.Error(cmd, err)
+			return
+		}
+
+		existingProject, handleErr := handleExistingProject(cmd, projectService, projectAlternateId)
+		if handleErr != nil {
+			printer.Error(cmd, handleErr)
+			return
+		}
+		if existingProject == nil {
+			printer.Info("Operation cancelled.")
+			return
+		}
+
+		createdProject = *existingProject
+	}
+
+	mcl := manifest.Config{
+		ProjectId:          createdProject.ID,
+		ProjectAlternateId: &createdProject.AlternateID,
+		ProjectName:        &createdProject.Name,
+		OrganizationId:     orgID,
+	}
+
+	_, err = manifest.LocalInitialize(mcl)
+	if err != nil {
+		printer.Error(cmd, err)
+		return
+	}
+
+	if err := gitutil.EnsureGitignore(manifest.ManifestSecretFile); err != nil {
+		printer.Error(cmd, fmt.Errorf("error adding .hxkey to .gitignore: %w. Please do this manually if you wish", err))
+	}
+	printInitializationSummary(createdProject.Name, createdProject.AlternateID, *createdProject.ID, orgID)
+}
+
+func getProjectID(cmd *cobra.Command, projectName string) string {
+	defaultProjectAlternateId := generateDefaultProjectId(projectName)
+	projectAlternateId := projectIDFlag
+	if projectAlternateId == "" {
+		projectAlternateId = defaultProjectAlternateId
+	}
+
+	err := projects.CheckProjectId(projectAlternateId)
+	if err != nil {
+		suggestedID := strings.TrimSpace(strings.Split(err.Error(), ":")[1])
+		response := prompt.PromptYesNo(cmd, fmt.Sprintf("Invalid app ID. Do you want to use the suggested ID [%s]?", suggestedID), true)
+
+		if !response.Confirmed {
+			if response.IsFlag {
+				printer.Info("Operation cancelled due to --no flag.")
+				return ""
+			} else {
+				// Prompt for a custom project ID
+				for {
+					var err error
+					projectAlternateId, err = prompt.PromptString(cmd, "Enter a custom app ID:")
+					if err != nil {
+						printer.Error(cmd, err)
+						return ""
+					}
+
+					err = projects.CheckProjectId(projectAlternateId)
+					if err == nil {
+						return projectAlternateId
+					}
+					printer.Warning("Invalid app ID. Please try again.")
+				}
+			}
+		} else {
+			projectAlternateId = suggestedID
+		}
+	}
+	return projectAlternateId
+}
+
+func generateDefaultProjectId(projectName string) string {
+	return strings.ToLower(strings.ReplaceAll(projectName, " ", "-"))
+}
+
+func printInitializationSummary(projectName, projectAlternateId, projectID, orgID string) {
+	printer.Success("Project successfully initialized")
+	printer.Print("") // Print an empty line for spacing
+	printer.PrintDetail("Project Name", projectName)
+	printer.PrintDetail("Project AlternateId", projectAlternateId)
+	printer.PrintDetail("Project ID", projectID)
+	printer.PrintDetail("Organization ID", orgID)
+}
+
+func isValidDirectory(cmd *cobra.Command) error {
+	cwd, err := os.Getwd()
+	if err != nil {
+		return err
+	}
+
+	homeDir, err := os.UserHomeDir()
+	if err != nil {
+		return err
+	}
+
+	if cwd == homeDir {
+		return fmt.Errorf("initialization in home directory not allowed")
+	}
+
+	return nil
+}
+
+func handleExistingProject(cmd *cobra.Command, projectService projects.ProjectService, projectAlternateId string) (*projects.Project, error) {
+	response := prompt.PromptYesNo(cmd, fmt.Sprintf("A project with ID '%s' already exists. Do you want to use this existing project?", projectAlternateId), true)
+	if !response.Confirmed {
+		return nil, nil
+	}
+
+	existingProject, err := projectService.GetProject(projectAlternateId)
+	if err != nil {
+		return nil, err
+	}
+
+	printer.Info(fmt.Sprintf("Using existing project '%s' (%s)", existingProject.Name, existingProject.AlternateID))
+	return &existingProject, nil
+}

cmd/root.go

@@ -10,6 +10,7 @@ import (
 	"github.com/Hyphen/cli/cmd/env/pull"
 	"github.com/Hyphen/cli/cmd/env/push"
 	"github.com/Hyphen/cli/cmd/initialize"
+	"github.com/Hyphen/cli/cmd/initproject"
 	"github.com/Hyphen/cli/cmd/link"
 	"github.com/Hyphen/cli/cmd/project"
 	"github.com/Hyphen/cli/cmd/setorg"
@@ -42,6 +43,7 @@ func init() {
 	rootCmd.AddCommand(app.AppCmd)
 	rootCmd.AddCommand(project.ProjectCmd)
 	rootCmd.AddCommand(env.EnvCmd)
+	rootCmd.AddCommand(initproject.InitProjectCmd)
 
 	// Override the default completion command with a hidden no-op command
 	rootCmd.AddCommand(&cobra.Command{

internal/app/app.go

@@ -36,7 +36,7 @@ func CheckAppId(appId string) error {
 		suggested = strings.Trim(suggested, "-")
 
 		return errors.Wrapf(
-			errors.New("invalid project ID"),
+			errors.New("invalid app ID"),
 			"You are using unpermitted characters. A valid App ID can only contain lowercase letters, numbers, hyphens, and underscores. Suggested valid ID: %s",
 			suggested,
 		)

internal/projects/projects.go

@@ -1,7 +1,33 @@
 package projects
 
+import (
+	"regexp"
+	"strings"
+
+	"github.com/Hyphen/cli/pkg/errors"
+)
+
 type Project struct {
 	ID          *string `json:"id,omitempty"`
 	AlternateID string  `json:"alternateId"`
 	Name        string  `json:"name"`
 }
+
+func CheckProjectId(appId string) error {
+	validRegex := regexp.MustCompile("^[a-z0-9-_]+$")
+	if !validRegex.MatchString(appId) {
+		suggested := strings.ToLower(appId)
+		suggested = strings.ReplaceAll(suggested, " ", "-")
+		suggested = regexp.MustCompile("[^a-z0-9-_]").ReplaceAllString(suggested, "-")
+		suggested = regexp.MustCompile("-+").ReplaceAllString(suggested, "-")
+		suggested = strings.Trim(suggested, "-")
+
+		return errors.Wrapf(
+			errors.New("invalid project ID"),
+			"You are using unpermitted characters. A valid Project ID can only contain lowercase letters, numbers, hyphens, and underscores. Suggested valid ID: %s",
+			suggested,
+		)
+	}
+
+	return nil
+}

cmd/initialize/utils.go pkg/gitutil/gitutil.go

@@ -1,4 +1,4 @@
-package initialize
+package gitutil
 
 import (
 	"bufio"
@@ -96,7 +96,7 @@ func fileEndsWithNewline(file *os.File) (bool, error) {
 	return buf[0] == '\n', nil
 }
 
-func ensureGitignore(appendStr string) error {
+func EnsureGitignore(appendStr string) error {
 	if !gitExists() {
 		return nil
 	}