📝 docs: update comprehensive documentation and project infrastructure

Documentation Updates:
- Enhanced AGENTS.md with user authentication details
- Updated README.md with authentication API documentation
- Added CONTRIBUTING.md guidelines for BDD testing
- Version management guide improvements
- Local CI/CD testing documentation

Project Infrastructure:
- Updated .gitignore for new file patterns
- Enhanced git hooks documentation
- YAML linting configuration
- Script improvements and organization
- Configuration management updates

API Enhancements:
- Greet service integration with authentication
- Server middleware for JWT validation
- Telemetry improvements
- Version management utilities

Generated by Mistral Vibe.
Co-Authored-By: Mistral Vibe <vibe@mistral.ai>

pkg/greet/api_v1.go

@@ -88,6 +88,7 @@ func (h *apiV1GreetHandler) RegisterRoutes(router chi.Router) {
 //	@Accept			json
 //	@Produce		json
 //	@Success		200	{object}	GreetResponse	"Successful response"
+//	@Security		BearerAuth
 //	@Router			/v1/greet [get]
 func (h *apiV1GreetHandler) handleGreetQuery(w http.ResponseWriter, r *http.Request) {
 	name := r.URL.Query().Get("name")
@@ -104,6 +105,7 @@ func (h *apiV1GreetHandler) handleGreetQuery(w http.ResponseWriter, r *http.Requ
 //	@Param			name	path		string			true	"Name to greet"
 //	@Success		200		{object}	GreetResponse	"Successful response"
 //	@Failure		400		{object}	ErrorResponse	"Invalid name parameter"
+//	@Security		BearerAuth
 //	@Router			/v1/greet/{name} [get]
 func (h *apiV1GreetHandler) handleGreetPath(w http.ResponseWriter, r *http.Request) {
 	name := chi.URLParam(r, "name")

pkg/greet/api_v2.go

@@ -55,6 +55,7 @@ type greetResponse struct {
 //	@Param			request	body		GreetRequest	true	"Greeting request"
 //	@Success		200		{object}	GreetResponseV2	"Successful response"
 //	@Failure		400		{object}	ValidationError	"Validation error"
+//	@Security		BearerAuth
 //	@Router			/v2/greet [post]
 func (h *apiV2GreetHandler) handleGreetPost(w http.ResponseWriter, r *http.Request) {
 	// Read request body

pkg/greet/greet.go

@@ -3,21 +3,46 @@ package greet
 import (
 	"context"
 
+	"dance-lessons-coach/pkg/user"
+
 	"github.com/rs/zerolog/log"
 )
 
+// Context key for storing authenticated user
+type contextKey string
+
+const (
+	// UserContextKey is the context key for storing authenticated user
+	UserContextKey contextKey = "authenticatedUser"
+)
+
 type Service struct{}
 
 func NewService() *Service {
 	return &Service{}
 }
 
+// GetAuthenticatedUserFromContext extracts the authenticated user from context
+func GetAuthenticatedUserFromContext(ctx context.Context) (*user.User, bool) {
+	user, ok := ctx.Value(UserContextKey).(*user.User)
+	return user, ok
+}
+
 // Greet returns a greeting message for the given name.
-// If name is empty, it defaults to "world".
+// If name is empty, it checks for authenticated user and uses their username.
+// If no authenticated user and no name, it defaults to "world".
 // Implements the Greeter interface.
 func (s *Service) Greet(ctx context.Context, name string) string {
 	log.Trace().Ctx(ctx).Str("name", name).Msg("Greet function called")
 
+	// If no name provided, check for authenticated user
+	if name == "" {
+		if authenticatedUser, ok := GetAuthenticatedUserFromContext(ctx); ok {
+			name = authenticatedUser.Username
+			log.Trace().Ctx(ctx).Str("authenticated_user", name).Msg("Using authenticated username for greeting")
+		}
+	}
+
 	if name == "" {
 		return "Hello world!"
 	}