Taskfile.yml

version: "3"

includes:
  debug:
    taskfile: ./taskfiles/debug.yml

vars:
  CPU_COUNT:
    sh: nproc 2>/dev/null || sysctl -n hw.ncpu 2>/dev/null || echo "4"
  PARALLEL_COUNT:
    sh: echo $(({{.CPU_COUNT}} * 2))

tasks:
  # ===========================================================================
  # Primary workflows (what you'll use most)
  # ===========================================================================

  setup:
    desc: One-time local dev setup (git hooks)
    cmds:
      - git config core.hooksPath .githooks

  do:
    desc: Format, lint, and test (pre-commit check)
    cmds:
      - task: fmt
      - task: lint
      - task: test

  signoff:
    desc: Full validation before push
    aliases: [sign, s]
    deps: [do, check, build]
    cmds:
      - gh signoff

  # ===========================================================================
  # Code generation
  # ===========================================================================

  generate:
    desc: Generate all code (GraphQL client + SQLite schema)
    cmds:
      - task: generate:client
      - task: generate:schema

  generate:client:
    desc: Generate GraphQL client (requires control plane at localhost:18081)
    dir: internal/boundary/graphql/gen
    cmds:
      - npx get-graphql-schema http://localhost:18081/graphql > schema.graphql
      - go run github.com/Khan/genqlient

  generate:schema:
    desc: Generate PowerSync and SQLite schema (uses local control plane)
    cmds:
      - go generate ./internal/powersync
      - go generate ./internal/sqlite
      - sed '/^-- Auto-generated/d; /^-- Run .task generate/d' ../control-plane/internal/powersync/schema.sql > internal/chat/tools/query_schema.sql

  # ===========================================================================
  # Build
  # ===========================================================================

  build:
    desc: Build the tero binary
    cmds:
      - go build -o tero cmd/tero/main.go
    sources:
      - "**/*.go"
    generates:
      - tero

  build:version:
    desc: Build with version info (same as CI)
    cmds:
      - |
        VERSION=$(git describe --tags --always --dirty 2>/dev/null || echo "dev")
        go build -ldflags "-X main.version=${VERSION}" -o tero cmd/tero/main.go
        echo "Built tero ${VERSION}"

  install:
    desc: Install tero to GOPATH
    deps: [build]
    cmds:
      - go install cmd/tero/main.go

  # ===========================================================================
  # Quality checks
  # ===========================================================================

  fmt:
    desc: Format code
    cmds:
      - go fmt ./...

  lint:
    desc: Run all linters
    deps: [lint:go, lint:scripts, lint:naming, lint:architecture]

  lint:go:
    desc: Run golangci-lint
    cmds:
      - golangci-lint run ./...

  lint:scripts:
    desc: Lint shell scripts with shellcheck
    cmds:
      - find scripts -type f -name "*.sh" -print0 | xargs -0 shellcheck

  lint:naming:
    desc: Enforce UI message/event naming conventions
    deps: [lint:naming:events, lint:naming:local]

  lint:naming:events:
    desc: Enforce app event naming conventions
    cmds:
      - ./scripts/lint/check-event-naming.sh

  lint:naming:local:
    desc: Enforce local app message naming conventions
    cmds:
      - ./scripts/lint/check-local-msg-naming.sh

  lint:architecture:
    desc: Enforce Bubble Tea event-loop architecture guardrails
    deps: [lint:architecture:event-loop, lint:architecture:ownership]
    cmds: []

  lint:architecture:event-loop:
    desc: Enforce no blocking work in Update/View
    cmds:
      - ./scripts/lint/check-event-loop-safety.sh

  lint:architecture:ownership:
    desc: Enforce feature event package ownership boundaries
    cmds:
      - ./scripts/lint/check-event-ownership.sh

  check:
    desc: Validate build
    cmds:
      - go vet ./...
      - task: check:task-run-env

  check:task-run-env:
    desc: Validate task run env wiring for local and prd
    cmds:
      - |
        RUN_CMD="$(TERO_ENV=prd task -n run 2>&1 | tail -n 1)"
        echo "$RUN_CMD" | rg './scripts/with-env.sh go run ./cmd/tero' >/dev/null
        rg 'env_name="\$\{TERO_ENV:-local\}"' ./scripts/with-env.sh >/dev/null
        rg 'exec doppler run -c "\$env_name" -- "\$@"' ./scripts/with-env.sh >/dev/null

  # ===========================================================================
  # Testing
  # ===========================================================================

  test:
    desc: Run unit and component tests
    cmds:
      - gotestsum --format short-verbose -- -race -p {{.CPU_COUNT}} -parallel {{.PARALLEL_COUNT}} -skip "^TestIntegration_|^TestCorrectness_" ./...

  test:integration:
    desc: Run hermetic integration tests (deterministic, no external services)
    cmds:
      - gotestsum --format short-verbose -- -race -tags=integration -run "^TestIntegration_" ./...

  test:integration:live:
    desc: Run live integration tests against non-production services (TERO_ENV=dev|prd)
    cmds:
      - './scripts/with-env.sh gotestsum --format short-verbose -- -race -tags=integration_live -run "^TestIntegrationLive_" ./...'

  test:tags:compile:
    desc: Compile all opt-in tagged tests (integration/live/correctness)
    cmds:
      - go test -tags=integration -run "^$" ./...
      - go test -tags=integration_live -run "^$" ./...
      - go test -tags=correctness -run "^$" ./...

  test:correctness:
    desc: Run correctness tests (TERO_ENV=dev|prd)
    cmds:
      - './scripts/with-env.sh gotestsum --format short-verbose -- -v -tags=correctness -run "^TestCorrectness_" ./...'

  test:correctness:powersync-replay:
    desc: Run deterministic PowerSync fixture replay correctness test
    cmds:
      - |
        if [ -n "{{.FIXTURE}}" ]; then
          TERO_POWERSYNC_FIXTURE_PATH="{{.FIXTURE}}" ./scripts/with-env.sh gotestsum --format short-verbose -- \
            -v -tags=correctness -run "^TestCorrectness_PowerSync_ControllerFixtureReplayDeterministic$" ./internal/powersync/extension
        else
          ./scripts/with-env.sh gotestsum --format short-verbose -- \
            -v -tags=correctness -run "^TestCorrectness_PowerSync_ControllerFixtureReplayDeterministic$" ./internal/powersync/extension
        fi

  test:all:
    desc: Run CI test suite (unit + hermetic integration + correctness replay)
    cmds:
      - task: test
      - task: test:integration
      - task: test:correctness:powersync-replay

  test:all:full:
    desc: Run full test suite including live integration checks
    cmds:
      - task: test:all
      - task: test:integration:live

  # ===========================================================================
  # Development helpers
  # ===========================================================================

  run:
    desc: Run tero (TERO_ENV=local|dev|prd)
    cmds:
      - "./scripts/with-env.sh go run ./cmd/tero {{.CLI_ARGS}}"

  dev:
    desc: Generate code and build
    deps: [generate]
    cmds:
      - task: build

  auth:login:
    desc: Login to Tero (TERO_ENV=local|dev|prd)
    cmds:
      - "./scripts/with-env.sh go run ./cmd/tero auth login"

  auth:token:
    desc: Print current access token (TERO_ENV=local|dev|prd)
    cmds:
      - "./scripts/with-env.sh go run ./cmd/tero auth token"

  auth:status:
    desc: Show auth status (TERO_ENV=local|dev|prd)
    cmds:
      - "./scripts/with-env.sh go run ./cmd/tero auth status"

  auth:switch:
    desc: Switch organization (TERO_ENV=local|dev|prd)
    cmds:
      - "./scripts/with-env.sh go run ./cmd/tero auth switch {{.CLI_ARGS}}"

  internal:powersync:capture:
    desc: Capture raw PowerSync stream to NDJSON (TERO_ENV=dev|prd)
    vars:
      OUTPUT: '{{.OUTPUT | default "fixtures/powersync/capture.ndjson"}}'
      DURATION: '{{.DURATION | default "90s"}}'
      MAX_BYTES: '{{.MAX_BYTES | default "26214400"}}'
    cmds:
      - |
        CMD="./scripts/with-env.sh go run ./cmd/tero internal powersync capture --output {{.OUTPUT}} --duration {{.DURATION}} --max-bytes {{.MAX_BYTES}}"
        if [ -n "{{.ACCOUNT_ID}}" ]; then
          CMD="$CMD --account-id {{.ACCOUNT_ID}}"
        fi
        eval "$CMD"

  internal:powersync:sanitize-fixture:
    desc: Sanitize raw PowerSync fixture to commit-safe NDJSON
    cmds:
      - |
        if [ -z "{{.INPUT}}" ] || [ -z "{{.OUTPUT}}" ]; then
          echo "INPUT and OUTPUT are required"
          exit 1
        fi
        CMD="./scripts/with-env.sh go run ./cmd/tero internal powersync sanitize-fixture --input {{.INPUT}} --output {{.OUTPUT}}"
        if [ -n "{{.MAX_LINES}}" ]; then
          CMD="$CMD --max-lines {{.MAX_LINES}}"
        fi
        eval "$CMD"

  # ===========================================================================
  # Admin (internal tooling, not shipped)
  # ===========================================================================

  admin:join-org:
    desc: Join a client organization (TERO_ENV=dev|prd)
    cmds:
      - "./scripts/with-env.sh go run ./cmd/admin join-org {{.CLI_ARGS}}"

  admin:leave-org:
    desc: Leave a client organization (TERO_ENV=dev|prd)
    cmds:
      - "./scripts/with-env.sh go run ./cmd/admin leave-org {{.CLI_ARGS}}"

  # ===========================================================================
  # Dependencies
  # ===========================================================================

  update:powersync:
    desc: Update PowerSync SQLite extension to latest release
    cmds:
      - ./scripts/update-powersync.sh {{.CLI_ARGS}}

  # ===========================================================================
  # Cleanup
  # ===========================================================================

  clean:
    desc: Clean build artifacts and caches
    cmds:
      - rm -f tero
      - rm -rf dist/
      - go clean -cache -testcache -modcache
      - echo "Cleaned build artifacts and Go caches"

  reset:
    desc: Reset dev environment (auth, config, database, logs)
    cmds:
      - go run ./cmd/tero reset --db
      - rm -f ~/.tero/environments/*/tero.log
      - echo "Reset complete"

  # ===========================================================================
  # Release
  # ===========================================================================

  release:check:
    desc: Check commits follow conventional format
    cmds:
      - |
        echo "Recent commits (should follow conventional commit format):"
        git log --oneline -10
        echo ""
        echo "Valid prefixes: feat, fix, chore, docs, refactor, test, ci, perf, revert"

  release:snapshot:
    desc: Test release build locally
    cmds:
      - |
        VERSION=$(git describe --tags --always --dirty 2>/dev/null || echo "dev")
        CGO_ENABLED=1 go build -trimpath -ldflags "-s -w -X main.version=${VERSION}" -o dist/tero ./cmd/tero
        echo "Built dist/tero ${VERSION}"
        ls -lh dist/tero

  release:test-install:
    desc: Test install.sh script against latest release
    cmds:
      - |
        echo "Testing install script..."
        export TERO_INSTALL_DIR="/tmp/tero-install-test"
        rm -rf "$TERO_INSTALL_DIR"
        sh scripts/install.sh --help
        echo ""
        echo "Installing latest release to $TERO_INSTALL_DIR..."
        sh scripts/install.sh -y
        if [ -x "$TERO_INSTALL_DIR/tero" ]; then
          echo ""
          echo "Installation successful!"
          "$TERO_INSTALL_DIR/tero" --version
        else
          echo "Installation failed"
          exit 1
        fi
        rm -rf "$TERO_INSTALL_DIR"