fix: optimize SQLite connection pooling for single-writer architecture

Remove misleading max_connections config option and properly configure
SQLite connection pooling in the storage layer.

Changes:
- Set MaxOpenConns(1) for optimal SQLite performance
- Set MaxIdleConns(1) to keep connection alive
- Set ConnMaxLifetime(0) to never close connection
- Remove max_connections and max_lifetime from DatabaseConfig
- Update docs to clarify SQLite's single-writer architecture

Rationale:
SQLite is an embedded database with a single-writer lock. Multiple
connections cause lock contention and reduce performance. WAL mode
allows concurrent reads from the same connection, making connection
pooling unnecessary and counterproductive.

This change makes the configuration clearer and ensures optimal
SQLite performance by using a single long-lived connection.

1 files changed, 6 insertions, 0 deletions

diff --git a/internal/storage/storage.go b/internal/storage/storage.go
index d00d7bf..9ef9956 100644
--- a/internal/storage/storage.go
+++ b/internal/storage/storage.go
@@ -22,6 +22,12 @@ func New(dbPath string) (*Storage, error) {
                 return nil, fmt.Errorf("failed to open database: %w", err)
         }
 
+        // Configure connection pool for SQLite
+        // SQLite works best with a single connection due to single-writer lock
+        db.SetMaxOpenConns(1)    // Single connection (SQLite is single-writer)
+        db.SetMaxIdleConns(1)    // Keep connection alive
+        db.SetConnMaxLifetime(0) // Never close the connection
+
         // Configure SQLite for optimal performance
         pragmas := []string{
                 "PRAGMA journal_mode=WAL",              // Write-Ahead Logging for concurrency