Implement API-backed init command with project creation and linking

ceritium · claude · ceritium · commit b20645b4079b · 2026-01-02T23:32:30.000+01:00
Add the ability for users to create new projects or link to existing ones during initialization via API calls to stacktodate.club. This improves the user experience by immediately registering projects and validating UUIDs. Key changes: - Add cmd/helpers/api.go with API integration functions: * CreateTechStack() - POST /api/tech_stacks to create new project * GetTechStack() - GET /api/tech_stacks/{id} to fetch and validate projects * ConvertStackToComponents() - Convert detected techs to API format * Common error handling for API responses (401, 404, 422, 5xx) - Enhanced cmd/init.go with interactive menu: * promptProjectChoice() - Menu: "Create new" or "Link existing" * createNewProject() - Create project via API with autodetected components * linkExistingProject() - Validate and link to existing project by UUID * New flow branches based on user choice - Updated cmd/push.go: * Use helpers.Component instead of local type * Use helpers.ConvertStackToComponents() from shared API module UX improvements: - Interactive menu for choosing new vs existing project - Progress messages during API calls - Clear error messages for authentication, validation, and network issues - Support for empty tech stacks with helpful warnings - Backward compatible with --uuid and --name flags for automation API endpoints used: - POST /api/tech_stacks - Create new project (returns UUID) - GET /api/tech_stacks/{id} - Validate and fetch project details Error handling: - 401: Invalid token with hint to update credentials - 404: Project not found with helpful message - 422: Validation errors from API - 5xx: API issues with retry suggestion - Network errors: Connection issues with helpful context 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
diff --git a/cmd/helpers/api.go b/cmd/helpers/api.go
@@ -0,0 +1,167 @@
+package helpers
+
+import (
+	"bytes"
+	"encoding/json"
+	"fmt"
+	"io"
+	"net/http"
+
+	"github.com/stacktodate/stacktodate-cli/cmd/lib/cache"
+)
+
+// Component represents a single technology in the stack
+type Component struct {
+	Name    string `json:"name"`
+	Version string `json:"version"`
+}
+
+// ConvertStackToComponents converts the detected stack format to API component format
+func ConvertStackToComponents(stack map[string]StackEntry) []Component {
+	components := make([]Component, 0)
+
+	for name, entry := range stack {
+		components = append(components, Component{
+			Name:    name,
+			Version: entry.Version,
+		})
+	}
+
+	return components
+}
+
+// TechStackRequest is used for POST /api/tech_stacks
+type TechStackRequest struct {
+	TechStack struct {
+		Name       string      `json:"name"`
+		Components []Component `json:"components"`
+	} `json:"tech_stack"`
+}
+
+// TechStackResponse is the response from both GET and POST tech stack endpoints
+type TechStackResponse struct {
+	Success   bool   `json:"success,omitempty"`
+	Message   string `json:"message,omitempty"`
+	TechStack struct {
+		ID         string      `json:"id"`
+		Name       string      `json:"name"`
+		Components []Component `json:"components"`
+	} `json:"tech_stack"`
+}
+
+// CreateTechStack creates a new tech stack on the API
+// Returns the newly created tech stack with UUID
+func CreateTechStack(token, name string, components []Component) (*TechStackResponse, error) {
+	apiURL := cache.GetAPIURL()
+	url := fmt.Sprintf("%s/api/tech_stacks", apiURL)
+
+	request := TechStackRequest{}
+	request.TechStack.Name = name
+	request.TechStack.Components = components
+
+	var response TechStackResponse
+	if err := makeAPIRequest("POST", url, token, request, &response); err != nil {
+		return nil, err
+	}
+
+	if !response.Success {
+		return nil, fmt.Errorf("API error: %s", response.Message)
+	}
+
+	if response.TechStack.ID == "" {
+		return nil, fmt.Errorf("API response missing project ID")
+	}
+
+	return &response, nil
+}
+
+// GetTechStack retrieves an existing tech stack from the API by UUID
+// This validates that the project exists and returns its details
+func GetTechStack(token, uuid string) (*TechStackResponse, error) {
+	apiURL := cache.GetAPIURL()
+	url := fmt.Sprintf("%s/api/tech_stacks/%s", apiURL, uuid)
+
+	var response TechStackResponse
+	if err := makeAPIRequest("GET", url, token, nil, &response); err != nil {
+		return nil, err
+	}
+
+	if response.TechStack.ID == "" {
+		return nil, fmt.Errorf("API response missing project ID")
+	}
+
+	return &response, nil
+}
+
+// makeAPIRequest is a private helper that handles common API request logic
+func makeAPIRequest(method, url, token string, requestBody interface{}, response interface{}) error {
+	var req *http.Request
+	var err error
+
+	// Create request with body if provided
+	if requestBody != nil {
+		requestBodyJSON, err := json.Marshal(requestBody)
+		if err != nil {
+			return fmt.Errorf("failed to marshal request: %w", err)
+		}
+		req, err = http.NewRequest(method, url, bytes.NewBuffer(requestBodyJSON))
+	} else {
+		req, err = http.NewRequest(method, url, nil)
+	}
+
+	if err != nil {
+		return fmt.Errorf("failed to create request: %w", err)
+	}
+
+	// Set headers
+	req.Header.Set("Content-Type", "application/json")
+	req.Header.Set("Authorization", fmt.Sprintf("Bearer %s", token))
+
+	// Make request
+	client := &http.Client{}
+	resp, err := client.Do(req)
+	if err != nil {
+		return fmt.Errorf("failed to connect to StackToDate API: %w\n\nPlease check your internet connection and try again", err)
+	}
+	defer resp.Body.Close()
+
+	// Read response body
+	body, err := io.ReadAll(resp.Body)
+	if err != nil {
+		return fmt.Errorf("failed to read response: %w", err)
+	}
+
+	// Handle error responses first
+	if resp.StatusCode == http.StatusUnauthorized {
+		return fmt.Errorf("authentication failed: invalid or expired token\n\nPlease update your token with: stacktodate global-config set")
+	}
+
+	if resp.StatusCode == http.StatusNotFound {
+		return fmt.Errorf("project not found: UUID does not exist\n\nPlease check the UUID or create a new project")
+	}
+
+	if resp.StatusCode == http.StatusUnprocessableEntity {
+		var errResp struct {
+			Message string `json:"message"`
+		}
+		if err := json.Unmarshal(body, &errResp); err == nil && errResp.Message != "" {
+			return fmt.Errorf("validation error: %s", errResp.Message)
+		}
+		return fmt.Errorf("validation error: the server rejected your request")
+	}
+
+	if resp.StatusCode >= 500 {
+		return fmt.Errorf("StackToDate API is experiencing issues (status %d)\n\nPlease try again later", resp.StatusCode)
+	}
+
+	if resp.StatusCode != http.StatusOK && resp.StatusCode != http.StatusCreated {
+		return fmt.Errorf("API error (status %d): %s", resp.StatusCode, string(body))
+	}
+
+	// Parse successful response
+	if err := json.Unmarshal(body, response); err != nil {
+		return fmt.Errorf("failed to parse API response: %w", err)
+	}
+
+	return nil
+}
diff --git a/cmd/init.go b/cmd/init.go
@@ -28,7 +28,7 @@ var initCmd = &cobra.Command{
 		reader := bufio.NewReader(os.Stdin)
 
 		// Check if token is configured, prompt if not
-		_, err := helpers.GetToken()
+		token, err := helpers.GetToken()
 		if err != nil {
 			fmt.Println("Authentication token not configured.")
 			fmt.Print("Would you like to set one up now? (y/n): ")
@@ -61,24 +61,50 @@ var initCmd = &cobra.Command{
 			}
 		}
 
-		// Get UUID
-		if uuid == "" {
-			fmt.Print("Enter UUID: ")
-			input, _ := reader.ReadString('\n')
-			uuid = strings.TrimSpace(input)
-		}
+		// NEW: Menu-based project selection (create new or link existing)
+		var projUUID, projName string
+		if uuid == "" && name == "" {
+			// Interactive mode: prompt user for choice
+			choice := promptProjectChoice(reader)
 
-		// Get Name
-		if name == "" {
-			fmt.Print("Enter name: ")
-			input, _ := reader.ReadString('\n')
-			name = strings.TrimSpace(input)
+			if choice == 1 {
+				// Create new project on API
+				var createErr error
+				projUUID, projName, createErr = createNewProject(reader, detectedTechs, token)
+				if createErr != nil {
+					helpers.ExitOnError(createErr, "failed to create project")
+				}
+			} else {
+				// Link to existing project on API
+				var linkErr error
+				projUUID, projName, linkErr = linkExistingProject(reader, token)
+				if linkErr != nil {
+					helpers.ExitOnError(linkErr, "failed to link project")
+				}
+			}
+		} else {
+			// Non-interactive mode: use provided flags or fallback to old prompts
+			if uuid == "" {
+				fmt.Print("Enter UUID: ")
+				input, _ := reader.ReadString('\n')
+				projUUID = strings.TrimSpace(input)
+			} else {
+				projUUID = uuid
+			}
+
+			if name == "" {
+				fmt.Print("Enter name: ")
+				input, _ := reader.ReadString('\n')
+				projName = strings.TrimSpace(input)
+			} else {
+				projName = name
+			}
 		}
 
 		// Create config
 		config := helpers.Config{
-			UUID:  uuid,
-			Name:  name,
+			UUID:  projUUID,
+			Name:  projName,
 			Stack: detectedTechs,
 		}
 
@@ -96,8 +122,8 @@ var initCmd = &cobra.Command{
 
 		fmt.Println("\nProject initialized successfully!")
 		fmt.Println("Created stacktodate.yml with:")
-		fmt.Printf("  UUID: %s\n", uuid)
-		fmt.Printf("  Name: %s\n", name)
+		fmt.Printf("  UUID: %s\n", projUUID)
+		fmt.Printf("  Name: %s\n", projName)
 		if len(detectedTechs) > 0 {
 			fmt.Println("  Stack:")
 			for tech, entry := range detectedTechs {
@@ -107,6 +133,85 @@ var initCmd = &cobra.Command{
 	},
 }
 
+// promptProjectChoice displays a menu for choosing between creating a new project or linking an existing one
+func promptProjectChoice(reader *bufio.Reader) int {
+	for {
+		fmt.Println("\nDo you want to:")
+		fmt.Println("  1) Create a new project on StackToDate")
+		fmt.Println("  2) Link to an existing project")
+		fmt.Print("\nEnter your choice (1 or 2): ")
+
+		input, _ := reader.ReadString('\n')
+		choice := strings.TrimSpace(input)
+
+		if choice == "1" {
+			return 1
+		} else if choice == "2" {
+			return 2
+		}
+
+		fmt.Println("Invalid choice. Please enter 1 or 2.")
+	}
+}
+
+// createNewProject prompts for project name and creates a new project via API
+func createNewProject(reader *bufio.Reader, detectedTechs map[string]helpers.StackEntry, token string) (uuid, projName string, err error) {
+	fmt.Print("\nEnter project name: ")
+	input, _ := reader.ReadString('\n')
+	projName = strings.TrimSpace(input)
+
+	if projName == "" {
+		return "", "", fmt.Errorf("project name cannot be empty")
+	}
+
+	// Convert detected technologies to API components
+	components := helpers.ConvertStackToComponents(detectedTechs)
+
+	if len(components) == 0 {
+		fmt.Println("⚠️  Warning: No technologies detected")
+		fmt.Println("You can add them later by editing stacktodate.yml and running 'stacktodate push'")
+	}
+
+	fmt.Println("\nCreating project on StackToDate...")
+
+	// Call API to create project
+	response, err := helpers.CreateTechStack(token, projName, components)
+	if err != nil {
+		return "", "", err
+	}
+
+	uuid = response.TechStack.ID
+	fmt.Println("✓ Project created successfully!")
+	fmt.Printf("  UUID: %s\n", uuid)
+	fmt.Printf("  Name: %s\n\n", projName)
+
+	return uuid, projName, nil
+}
+
+// linkExistingProject prompts for UUID and links to an existing project via API
+func linkExistingProject(reader *bufio.Reader, token string) (projUUID, projName string, err error) {
+	fmt.Print("\nEnter project UUID: ")
+	input, _ := reader.ReadString('\n')
+	projUUID = strings.TrimSpace(input)
+
+	if projUUID == "" {
+		return "", "", fmt.Errorf("UUID cannot be empty")
+	}
+
+	fmt.Println("\nValidating project UUID...")
+
+	// Call API to fetch project details
+	response, err := helpers.GetTechStack(token, projUUID)
+	if err != nil {
+		return "", "", err
+	}
+
+	projName = response.TechStack.Name
+	fmt.Printf("✓ Linked to existing project: %s\n\n", projName)
+
+	return projUUID, projName, nil
+}
+
 // selectCandidates allows user to select from detected candidates
 func selectCandidates(reader *bufio.Reader, info DetectedInfo) map[string]helpers.StackEntry {
 	selected := make(map[string]helpers.StackEntry)
diff --git a/cmd/push.go b/cmd/push.go
@@ -16,22 +16,17 @@ var (
 	configFile string
 )
 
-type Component struct {
-	Name    string `json:"name"`
-	Version string `json:"version"`
-}
-
 type PushRequest struct {
-	Components []Component `json:"components"`
+	Components []helpers.Component `json:"components"`
 }
 
 type PushResponse struct {
 	Success   bool   `json:"success"`
 	Message   string `json:"message"`
 	TechStack struct {
-		ID         string        `json:"id"`
-		Name       string        `json:"name"`
-		Components []Component   `json:"components"`
+		ID         string               `json:"id"`
+		Name       string               `json:"name"`
+		Components []helpers.Component  `json:"components"`
 	} `json:"tech_stack"`
 }
 
@@ -56,7 +51,7 @@ var pushCmd = &cobra.Command{
 		apiURL := cache.GetAPIURL()
 
 		// Convert stack to components
-		components := convertStackToComponents(config.Stack)
+		components := helpers.ConvertStackToComponents(config.Stack)
 
 		// Create request
 		request := PushRequest{
@@ -72,19 +67,6 @@ var pushCmd = &cobra.Command{
 	},
 }
 
-func convertStackToComponents(stack map[string]helpers.StackEntry) []Component {
-	var components []Component
-
-	for name, entry := range stack {
-		components = append(components, Component{
-			Name:    name,
-			Version: entry.Version,
-		})
-	}
-
-	return components
-}
-
 func pushToAPI(apiURL, techStackID, token string, request PushRequest) error {
 	// Build URL
 	url := fmt.Sprintf("%s/api/tech_stacks/%s/components", apiURL, techStackID)
diff --git a/stacktodate-cli b/stacktodate-cli
