Refactor codebase

internal/cmd/openai_login.go

@@ -1,3 +1,6 @@
+// Package cmd provides command-line interface functionality for the CLI Proxy API.
+// It implements the main application commands including login/authentication
+// and server startup, handling the complete user onboarding and service lifecycle.
 package cmd
 
 import (
@@ -17,12 +20,20 @@ import (
 	log "github.com/sirupsen/logrus"
 )
 
-// LoginOptions contains options for login
+// LoginOptions contains options for the Codex login process.
 type LoginOptions struct {
+	// NoBrowser indicates whether to skip opening the browser automatically.
 	NoBrowser bool
 }
 
-// DoCodexLogin handles the Codex OAuth login process
+// DoCodexLogin handles the Codex OAuth login process for OpenAI Codex services.
+// It initializes the OAuth flow, opens the user's browser for authentication,
+// waits for the callback, exchanges the authorization code for tokens,
+// and saves the authentication information to a file.
+//
+// Parameters:
+//   - cfg: The application configuration
+//   - options: The login options containing browser preferences
 func DoCodexLogin(cfg *config.Config, options *LoginOptions) {
 	if options == nil {
 		options = &LoginOptions{}
@@ -50,7 +61,7 @@ func DoCodexLogin(cfg *config.Config, options *LoginOptions) {
 	oauthServer := codex.NewOAuthServer(1455)
 
 	// Start OAuth callback server
-	if err = oauthServer.Start(ctx); err != nil {
+	if err = oauthServer.Start(); err != nil {
 		if strings.Contains(err.Error(), "already in use") {
 			authErr := codex.NewAuthenticationError(codex.ErrPortInUse, err)
 			log.Error(codex.GetUserFriendlyMessage(authErr))
@@ -164,6 +175,11 @@ func DoCodexLogin(cfg *config.Config, options *LoginOptions) {
 }
 
 // generateRandomState generates a cryptographically secure random state parameter
+// for OAuth2 flows to prevent CSRF attacks.
+//
+// Returns:
+//   - string: A hexadecimal encoded random state string
+//   - error: An error if the random generation fails, nil otherwise
 func generateRandomState() (string, error) {
 	bytes := make([]byte, 16)
 	if _, err := rand.Read(bytes); err != nil {