Cursor rule

1---
2description: Required libraries and project utilities for Compozy development
3globs: **/*.go
4alwaysApply: true
5---
6# Core Libraries & Project Utilities
7 
8## Required Libraries
9 
10<library_requirements type="web_framework">
11**Web Framework:**
12- **MUST use:** `gin-gonic/gin` for HTTP APIs
13</library_requirements>
14 
15<library_requirements type="database">
16**Database:**
17- **PostgreSQL:** `jackc/pgx/v5`
18- **Redis:** `redis/go-redis/v9`
19- Always use connection pooling and proper cleanup
20</library_requirements>
21 
22<library_requirements type="testing">
23**Testing:**
24- **MUST use:** `stretchr/testify` for assertions and mocks
25- Import as: `github.com/stretchr/testify/assert`, `github.com/stretchr/testify/mock`
26- **STANDARDIZE:** Replace all custom mocks with `testify/mock` implementations
27</library_requirements>
28 
29<library_requirements type="validation">
30**Validation:**
31- **MUST use:** `go-playground/validator/v10` for input validation
32</library_requirements>
33 
34<library_requirements type="logging">
35**Logging:**
36- **MUST use:** `charmbracelet/log`
37- **NEVER use:** `fmt.Printf` or `log.Printf` for application logging
38</library_requirements>
39 
40<library_requirements type="cli">
41**CLI:**
42- **MUST use:** `spf13/cobra` for commands
43</library_requirements>
44 
45<library_requirements type="documentation">
46**Documentation:**
47- **MUST use:** `swaggo/swag` for API documentation
48</library_requirements>
49 
50## Project Utilities
51 
52<utility_pattern type="core_types">
53```go
54// Use project core types
55var taskID core.ID  // UUIDs
56var reference core.Ref  // Polymorphic references
57```
58</utility_pattern>
59 
60<utility_pattern type="test_helpers">
61```go
62// Use project test utilities
63func TestService(t *testing.T) {
64    t.Run("Should setup test environment", func(t *testing.T) {
65        db := utils.SetupTest()
66        defer db.Close()
67 
68        fixture := utils.SetupFixture("user_data.json")
69        // test implementation
70    })
71}
72```
73</utility_pattern>
74 
75<utility_pattern type="template_engine">
76```go
77// Use pkg/tplengine for dynamic configurations
78engine := tplengine.New()
79result, err := engine.Process(template, variables)
80```
81</utility_pattern>
82