@@ -0,0 +225,4 @@
+   }
+   ```
+   Falls back to `fmt.Stringer`, then `%+v` dump.
+

@@ -0,0 +332,4 @@
+```go
+type UpdateTaskRequest struct {
+    TaskID      int
+    Title       *string  // nil means don't update

@@ -0,0 +335,4 @@
+    Title       *string  // nil means don't update
+    Description *string
+    PriorityID  *int
+    TypeID      *int

@@ -0,0 +369,4 @@
+
+3. **Factory** (`factory.go`, line 53-77):
+   ```go
+   func NewQuerier(db any, dbType DatabaseType) (Querier, error)

@@ -0,0 +592,4 @@
+type createHandler struct{}
+
+func (h *createHandler) Execute(ctx context.Context, args *Arguments) (any, error) {
+    cliInstance, _ := cli.GetCLIFromContext(ctx)

@@ -0,0 +796,4 @@
+
+1. **Create command file** (`internal/cli/task/my_command.go`):
+   ```go
+   func MyCommandCmd() *cobra.Command {

@@ -0,0 +778,4 @@
+func TestParseAssignArgs(t *testing.T) { /* ... */ }
+```
+
+**Result**: Coverage metrics reflect actual tested code. Went from 0% → 33.2% on CLI task package.

@@ -0,0 +706,4 @@
+type TaskWriter interface {
+    CreateTask(ctx, req) (*Task, error)
+    UpdateTask(ctx, req) error
+    DeleteTask(ctx, taskID) error

@@ -0,0 +735,4 @@
+
+2. **Integration tests** (within service/database packages):
+   - Use in-memory SQLite via `fixtures.SetupTestDB()`
+   - Test service methods with real database operations

@@ -0,0 +219,4 @@
+   Errors: `{"success": false, "error": {"code": "...", "message": "..."}}`
+
+3. **Human-readable** (default): Checks if data implements `PrettyPrintable`:
+   ```go

@@ -0,0 +353,4 @@
+---
+
+### Database Layer (`internal/database/`)
+

@@ -0,0 +399,4 @@
+
+### Models (`internal/models/`)
+
+**Purpose**: Plain data transfer objects with no database dependencies.

@@ -0,0 +460,4 @@
+    Databases      []DatabaseConfig   `yaml:"databases"`
+    ActiveDatabase string             `yaml:"active_database,omitempty"`
+    ActiveAssignee string             `yaml:"active_assignee,omitempty"`
+}

@@ -0,0 +547,4 @@
+func FormatAssignJSON(result *AssignResult) map[string]any
+```
+
+Command handler becomes thin orchestration:

@@ -0,0 +857,4 @@
+   }
+   ```
+
+4. **Register command** (`internal/cli/task/task.go`):

@@ -0,0 +888,4 @@
+
+- **SQLC docs**: https://docs.sqlc.dev/
+- **Cobra docs**: https://cobra.dev/
+- **Bubble Tea tutorial**: https://github.com/charmbracelet/bubbletea

@@ -0,0 +746,4 @@
+4. **Acceptance tests**:
+   - `tests/acceptance/cli_validation.sh` - Shell-based CLI validation
+
+### Test Infrastructure

@@ -0,0 +627,4 @@
+   ```go
+   // SQLite: returns sqlite.Adapter wrapping generated_sqlite.Queries
+   // PostgreSQL: returns postgres.Adapter wrapping generated_postgres.Queries
+   ```

@@ -0,0 +277,4 @@
+
+**`App` struct** (line 19-35):
+```go
+type App struct {