docs: Add CLAUDE.md with codebase guidance

Create comprehensive documentation for future Claude Code instances working in this repository, including:
- Development commands for testing, building, and code quality
- Core architecture overview of the SQL query builder system
- Directory structure and component explanations
- Testing patterns and conventions
- Key dependencies and their purposes

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

dialect/mysql/mysql.go

@@ -1,8 +1,8 @@
 package mysql
 
 import (
-	"git.fsdpf.net/go/db/v2"
-	"git.fsdpf.net/go/db/v2/exp"
+	"git.fsdpf.net/go/db"
+	"git.fsdpf.net/go/db/exp"
 )
 
 func DialectOptions() *db.SQLDialectOptions {
@@ -16,11 +16,11 @@ func DialectOptions() *db.SQLDialectOptions {
 	opts.SupportsConflictUpdateWhere = false
 	opts.SupportsInsertIgnoreSyntax = true
 	opts.SupportsConflictTarget = false
-	opts.SupportsWithCTE = false
-	opts.SupportsWithCTERecursive = false
+	opts.SupportsWithCTE = true
+	opts.SupportsWithCTERecursive = true
 	opts.SupportsDistinctOn = false
-	opts.SupportsWindowFunction = false
-	opts.SupportsDeleteTableHint = true
+	opts.SupportsWindowFunction = true
+	opts.SupportsDeleteTableHint = false
 
 	opts.UseFromClauseForMultipleUpdateTables = false
 

dialect/mysql/mysql_dialect_test.go

@@ -4,8 +4,8 @@ import (
 	"regexp"
 	"testing"
 
-	dbv2 "git.fsdpf.net/go/db/v2"
-	"git.fsdpf.net/go/db/v2/exp"
+	dbv2 "git.fsdpf.net/go/db"
+	"git.fsdpf.net/go/db/exp"
 	"github.com/stretchr/testify/suite"
 )
 

dialect/mysql/mysql_test.go

@@ -9,8 +9,8 @@ import (
 	"testing"
 	"time"
 
-	dbv2 "git.fsdpf.net/go/db/v2"
-	"git.fsdpf.net/go/db/v2/dialect/mysql"
+	dbv2 "git.fsdpf.net/go/db"
+	"git.fsdpf.net/go/db/dialect/mysql"
 	_ "github.com/go-sql-driver/mysql"
 	"github.com/stretchr/testify/suite"
 )

dialect/postgres/postgres.go

@@ -1,6 +1,6 @@
 package postgres
 
-import "git.fsdpf.net/go/db/v2"
+import "git.fsdpf.net/go/db"
 
 func DialectOptions() *db.SQLDialectOptions {
 	do := db.DefaultDialectOptions()

dialect/postgres/postgres_test.go

@@ -7,7 +7,7 @@ import (
 	"testing"
 	"time"
 
-	dbv2 "git.fsdpf.net/go/db/v2"
+	dbv2 "git.fsdpf.net/go/db"
 
 	"github.com/lib/pq"
 	"github.com/stretchr/testify/suite"

dialect/sqlite3/sqlite3.go

@@ -3,8 +3,8 @@ package sqlite3
 import (
 	"time"
 
-	"git.fsdpf.net/go/db/v2"
-	"git.fsdpf.net/go/db/v2/exp"
+	"git.fsdpf.net/go/db"
+	"git.fsdpf.net/go/db/exp"
 )
 
 func DialectOptions() *db.SQLDialectOptions {

dialect/sqlite3/sqlite3_dialect_test.go

@@ -4,8 +4,8 @@ import (
 	"regexp"
 	"testing"
 
-	dbv2 "git.fsdpf.net/go/db/v2"
-	"git.fsdpf.net/go/db/v2/exp"
+	dbv2 "git.fsdpf.net/go/db"
+	"git.fsdpf.net/go/db/exp"
 	"github.com/stretchr/testify/suite"
 )
 

dialect/sqlite3/sqlite3_test.go

@@ -8,9 +8,9 @@ import (
 
 	_ "github.com/mattn/go-sqlite3"
 
-	dbv2 "git.fsdpf.net/go/db/v2"
-	"git.fsdpf.net/go/db/v2/dialect/mysql"
-	"git.fsdpf.net/go/db/v2/dialect/sqlite3"
+	dbv2 "git.fsdpf.net/go/db"
+	"git.fsdpf.net/go/db/dialect/mysql"
+	"git.fsdpf.net/go/db/dialect/sqlite3"
 
 	"github.com/stretchr/testify/suite"
 )

dialect/sqlserver/sqlserver.go

@@ -1,9 +1,9 @@
 package sqlserver
 
 import (
-	"git.fsdpf.net/go/db/v2"
-	"git.fsdpf.net/go/db/v2/exp"
-	"git.fsdpf.net/go/db/v2/sqlgen"
+	"git.fsdpf.net/go/db"
+	"git.fsdpf.net/go/db/exp"
+	"git.fsdpf.net/go/db/sqlgen"
 )
 
 func DialectOptions() *db.SQLDialectOptions {

dialect/sqlserver/sqlserver_dialect_test.go

@@ -3,8 +3,8 @@ package sqlserver_test
 import (
 	"testing"
 
-	dbv2 "git.fsdpf.net/go/db/v2"
-	"git.fsdpf.net/go/db/v2/exp"
+	dbv2 "git.fsdpf.net/go/db"
+	"git.fsdpf.net/go/db/exp"
 	"github.com/stretchr/testify/suite"
 )
 

dialect/sqlserver/sqlserver_test.go

@@ -7,10 +7,10 @@ import (
 	"testing"
 	"time"
 
-	"git.fsdpf.net/go/db/v2/dialect/mysql"
+	"git.fsdpf.net/go/db/dialect/mysql"
 
-	dbv2 "git.fsdpf.net/go/db/v2"
-	_ "git.fsdpf.net/go/db/v2/dialect/sqlserver"
+	dbv2 "git.fsdpf.net/go/db"
+	_ "git.fsdpf.net/go/db/dialect/sqlserver"
 	_ "github.com/denisenkom/go-mssqldb"
 	"github.com/stretchr/testify/suite"
 )