Taskfile.yml

# https://taskfile.dev
version: '3'

vars:
  BINARY_NAME: assistant
  BUILD_DIR: ./bin
  COVERAGE_DIR: ./coverage
  DATABASE_URL: '{{.DATABASE_URL | default "postgresql://localhost/assistant?sslmode=disable"}}'
  TEST_DATABASE_URL: '{{.TEST_DATABASE_URL | default "postgres://postgres:postgres@localhost:5432/assistant_test?sslmode=disable"}}'

tasks:
  # Default
  default:
    desc: List available tasks
    cmds:
      - task --list

  # ========== Build ==========
  build:
    desc: Build the binary
    cmds:
      - go build -o {{.BUILD_DIR}}/{{.BINARY_NAME}} ./cmd/assistant
    sources:
      - '**/*.go'
      - go.mod
      - go.sum
    generates:
      - '{{.BUILD_DIR}}/{{.BINARY_NAME}}'

  run:
    desc: Build and run
    deps: [build]
    cmds:
      - '{{.BUILD_DIR}}/{{.BINARY_NAME}}'

  clean:
    desc: Clean build artifacts
    cmds:
      - rm -rf {{.BUILD_DIR}}
      - rm -rf {{.COVERAGE_DIR}}
      - go clean || true

  # ========== Development ==========
  dev:
    desc: Quick rebuild (sqlc + build)
    cmds:
      - task: sqlc
      - task: build

  generate:
    desc: Generate all code (sqlc + mocks)
    cmds:
      - task: sqlc
      - task: mocks

  sqlc:
    desc: Generate SQL code
    cmds:
      - sqlc generate -f configs/sqlc.yaml
    sources:
      - configs/sqlc.yaml
      - internal/storage/database/queries/*.sql

  mocks:
    desc: Generate mocks
    cmds:
      - go generate ./...
      - mockgen -source=internal/storage/database/sqlc/querier.go -destination=internal/storage/database/mocks/mock_querier.go -package=mocks

  # ========== Testing ==========
  test:
    desc: Run all tests
    cmds:
      - go test -v ./...

  test-short:
    desc: Run unit tests only
    cmds:
      - go test -short -v ./...

  test-integration:
    desc: Run integration tests
    cmds:
      - TEST_DATABASE_URL={{.TEST_DATABASE_URL}} go test -tags=integration -v ./...

  test-race:
    desc: Run tests with race detector
    cmds:
      - go test -race -v ./...
  
  test-pkg:
    desc: Test specific package (usage- task test-pkg PKG=./internal/memory)
    cmds:
      - go test -v {{.PKG}}
    preconditions:
      - sh: test -n "{{.PKG}}"
        msg: "PKG required. Usage- task test-pkg PKG=./internal/memory"

  test-func:
    desc: Test specific function (usage- task test-func FUNC=TestMemory)
    cmds:
      - go test -v -run {{.FUNC}} ./...
    preconditions:
      - sh: test -n "{{.FUNC}}"
        msg: "FUNC required. Usage- task test-func FUNC=TestMemory"

  coverage:
    desc: Generate coverage report
    cmds:
      - mkdir -p {{.COVERAGE_DIR}}
      - go test -coverprofile={{.COVERAGE_DIR}}/coverage.out ./...
      - go tool cover -html={{.COVERAGE_DIR}}/coverage.out -o {{.COVERAGE_DIR}}/coverage.html
      - echo "Coverage report generated at {{.COVERAGE_DIR}}/coverage.html"

  coverage-func:
    desc: Show coverage by function
    deps: [coverage]
    cmds:
      - go tool cover -func={{.COVERAGE_DIR}}/coverage.out

  benchmark:
    desc: Run benchmarks
    cmds:
      - go test -bench=. -benchmem ./...

  # ========== Code Quality ==========
  lint:
    desc: Run all linters (golangci-lint + vet + staticcheck + gosec)
    cmds:
      - echo "Running go vet..."
      - go vet ./...
      - echo "Running golangci-lint..."
      - golangci-lint run --timeout=5m
      - echo "Running staticcheck..."
      - staticcheck ./... || true
      - echo "Running gosec..."
      - gosec -fmt=text -exclude=G101 -quiet ./... || true

  lint-install:
    desc: Install all linter tools
    cmds:
      - go install github.com/golangci/golangci-lint/cmd/golangci-lint@latest
      - go install honnef.co/go/tools/cmd/staticcheck@latest
      - go install github.com/securego/gosec/v2/cmd/gosec@latest

  fmt:
    desc: Format code
    cmds:
      - gofmt -w -s .
      - goimports -w .

  fmt-check:
    desc: Check formatting
    cmds:
      - test -z "$(gofmt -l .)" || (echo "Unformatted files found. Run 'task fmt'" && exit 1)

  vet:
    desc: Run go vet
    cmds:
      - go vet ./...

  # ========== Dependencies ==========
  deps:
    desc: Download dependencies
    cmds:
      - go mod download
      - go mod tidy

  deps-update:
    desc: Update dependencies
    cmds:
      - go get -u ./...
      - go mod tidy

  # ========== Database ==========
  migrate:
    desc: Run database migrations up
    cmds:
      - migrate -path internal/storage/database/migrations -database "{{.DATABASE_URL}}" up

  migrate-down:
    desc: Rollback database migrations
    cmds:
      - migrate -path internal/storage/database/migrations -database "{{.DATABASE_URL}}" down

  migrate-create:
    desc: Create new migration
    cmds:
      - migrate create -ext sql -dir internal/storage/database/migrations -seq {{.NAME}}
    preconditions:
      - sh: test -n "{{.NAME}}"
        msg: "NAME required. Usage: task migrate-create NAME=add_users"

  # ========== CI/CD ==========
  ci:
    desc: Run all CI checks
    cmds:
      - task: fmt-check
      - task: lint
      - task: test
      - task: build

  pre-commit:
    desc: Pre-commit checks
    cmds:
      - task: fmt
      - task: lint
      - task: test-short

  check:
    desc: Quick quality check
    cmds:
      - task: fmt-check
      - task: vet
      - task: test-short

  # ========== Installation ==========
  install:
    desc: Install binary
    deps: [build]
    cmds:
      - cp {{.BUILD_DIR}}/{{.BINARY_NAME}} $(go env GOPATH)/bin/

  install-tools:
    desc: Install all dev tools
    cmds:
      - task: lint-install
      - go install github.com/sqlc-dev/sqlc/cmd/sqlc@latest
      - go install -tags 'postgres' github.com/golang-migrate/migrate/v4/cmd/migrate@latest
      - go install go.uber.org/mock/mockgen@latest
      - go install golang.org/x/tools/cmd/goimports@latest
      - echo "All tools installed"

  # ========== Utility ==========
  all:
    desc: Build everything
    cmds:
      - task: deps
      - task: generate
      - task: build