Taskfile.yml

version: "3"

vars:
  TARGET: ./cmd/betteralign
  GIT_LAST_TAG:
    sh: git describe --abbrev=0 --tags 2>/dev/null || echo latest
  GIT_HEAD_COMMIT:
    sh: git rev-parse --short HEAD 2>/dev/null || echo unknown
  GIT_TAG_COMMIT:
    sh: git rev-parse --short {{.GIT_LAST_TAG}} 2>/dev/null || echo unknown
  GIT_MODIFIED1:
    sh: git diff {{.GIT_HEAD_COMMIT}} {{.GIT_TAG_COMMIT}} --quiet 2>/dev/null || echo .dev
  GIT_MODIFIED2:
    sh: git diff --quiet 2>/dev/null || echo .dirty
  GIT_MODIFIED:
    sh: echo "{{.GIT_MODIFIED1}}{{.GIT_MODIFIED2}}"
  BUILD_DATE:
    sh: date -u '+%Y-%m-%dT%H:%M:%SZ'
  GOSENTRY: '{{.GOSENTRY | default "/usr/local/bin/gosentry"}}'
  GRAMMAR: '{{.GRAMMAR | default "false"}}'
  GRAMMAR_FLAGS: '--use-grammar --grammar=golang-nautilus-grammar.json'
  LIBAFL_FLAGS: '{{.LIBAFL_FLAGS | default "--use-libafl --focus-on-new-code=false --catch-races=false --catch-leaks=false"}}{{if eq .GRAMMAR "true"}} {{.GRAMMAR_FLAGS}}{{end}}'
  FUZZTIME: '{{.FUZZTIME | default "3600s"}}'
  CLEAN: '{{.CLEAN | default "false"}}'

env:
  CGO_ENABLED: 0
  NEWPATH: "{{.GOPATH}}/bin:{{.PATH}}"

tasks:
  default:
    desc: Run update + build (default action when invoked as `task` with no args).
    cmds:
      - task: update
      - task: build

  update:
    desc: Update Go dependencies (go get -u on module + CLI, then go mod tidy).
    cmds:
      - go get -u
      - go get -u ./cmd/betteralign
      - go mod tidy

  check:
    desc: List Go modules that have newer major versions available (via gomajor).
    cmds:
      - gomajor list

  fmt:
    desc: Format Go sources with gci (import grouping) and gofumpt (stricter gofmt).
    cmds:
      - gci write .
      - gofumpt -l -w .

  generate:
    desc: Regenerate match_generated.go (DFA matcher for generated-file comments), then format.
    cmds:
      - PATH={{.NEWPATH}} rec -import=unicode/utf8 -pkg betteralign -matchstringutf8=reGeneratedBy '^//\s*Code generated by .* DO NOT EDIT\.$$' > match_generated.go
      - task: fmt

  test:
    desc: Run all Go tests with verbose output.
    cmds:
      - go test -v ./...

  build:
    desc: Build the betteralign CLI with release ldflags (static, stripped, version-stamped, PGO).
    cmds:
      - task: generate
      - go build -trimpath -pgo=auto -ldflags="-s -w -extldflags '-static' -X main.Version={{.GIT_LAST_TAG}}{{.GIT_MODIFIED}} -X main.Commit={{.GIT_HEAD_COMMIT}} -X main.Date={{.BUILD_DATE}}" -o {{.TARGET}} ./cmd/betteralign

  build-debug:
    desc: Build with -race and CGO_ENABLED=1 after running update + generate + fmt.
    env:
      CGO_ENABLED: 1
    cmds:
      - task: update
      - task: generate
      - go build -ldflags="-X main.Version={{.GIT_LAST_TAG}}{{.GIT_MODIFIED}} -X main.Commit={{.GIT_HEAD_COMMIT}} -X main.Date={{.BUILD_DATE}}" -race -o {{.TARGET}} ./cmd/betteralign

  lint:
    desc: Run golangci-lint (5m timeout) after regenerate + format.
    cmds:
      - task: generate
      - golangci-lint run --timeout 5m

  release:
    desc: Cut a release via goreleaser (parallelism 4).
    cmds:
      - goreleaser release --clean -p 4

  fuzz-optimalorder:
    desc: 'Run native FuzzOptimalOrder. Override: task fuzz-optimalorder FUZZTIME=2h (default 3600s). CLEAN=true clears the coverage cache first.'
    cmds:
      - task: _clean-fuzz
      - go test -run='^$' -fuzz=^FuzzOptimalOrder$ -fuzztime={{.FUZZTIME}} .

  fuzz-gcsizes:
    desc: 'Run native FuzzGCSizes. Override: task fuzz-gcsizes FUZZTIME=2h (default 3600s). CLEAN=true clears the coverage cache first.'
    cmds:
      - task: _clean-fuzz
      - go test -run='^$' -fuzz=^FuzzGCSizes$ -fuzztime={{.FUZZTIME}} .

  fuzz-decoratefileidentity:
    desc: 'Run native FuzzDecorateFileIdentity. Override: task fuzz-decoratefileidentity FUZZTIME=2h (default 3600s). CLEAN=true clears the coverage cache first.'
    cmds:
      - task: _clean-fuzz
      - go test -run='^$' -fuzz=^FuzzDecorateFileIdentity$ -fuzztime={{.FUZZTIME}} ./internal/dstmin

  fuzz-decoratefilereorder:
    desc: 'Run native FuzzDecorateFileReorder. Override: task fuzz-decoratefilereorder FUZZTIME=2h (default 3600s). CLEAN=true clears the coverage cache first.'
    cmds:
      - task: _clean-fuzz
      - go test -run='^$' -fuzz=^FuzzDecorateFileReorder$ -fuzztime={{.FUZZTIME}} ./internal/dstmin

  fuzz-decoratefilereorderall:
    desc: 'Run native FuzzDecorateFileReorderAll. Override: task fuzz-decoratefilereorderall FUZZTIME=2h (default 3600s). CLEAN=true clears the coverage cache first.'
    cmds:
      - task: _clean-fuzz
      - go test -run='^$' -fuzz=^FuzzDecorateFileReorderAll$ -fuzztime={{.FUZZTIME}} ./internal/dstmin

  fuzz-commentrun:
    desc: 'Run native FuzzCommentRun. Override: task fuzz-commentrun FUZZTIME=2h (default 3600s). CLEAN=true clears the coverage cache first.'
    cmds:
      - task: _clean-fuzz
      - go test -run='^$' -fuzz=^FuzzCommentRun$ -fuzztime={{.FUZZTIME}} ./internal/dstmin

  fuzz-generatedbymatcher:
    desc: 'Run native FuzzGeneratedByMatcher. Override: task fuzz-generatedbymatcher FUZZTIME=2h (default 3600s). CLEAN=true clears the coverage cache first.'
    cmds:
      - task: _clean-fuzz
      - go test -run='^$' -fuzz=^FuzzGeneratedByMatcher$ -fuzztime={{.FUZZTIME}} .

  afl-fuzz-optimalorder:
    desc: 'Run FuzzOptimalOrder under gosentry/LibAFL (runs until Ctrl+C).'
    env:
      CGO_ENABLED: 1
    cmds:
      - task: _clean-fuzz-sentry
      - '{{.GOSENTRY}} test -run=''^$'' -fuzz=^FuzzOptimalOrder$ {{.LIBAFL_FLAGS}} .'

  afl-fuzz-gcsizes:
    desc: 'Run FuzzGCSizes under gosentry/LibAFL (runs until Ctrl+C).'
    env:
      CGO_ENABLED: 1
    cmds:
      - task: _clean-fuzz-sentry
      - '{{.GOSENTRY}} test -run=''^$'' -fuzz=^FuzzGCSizes$ {{.LIBAFL_FLAGS}} .'

  afl-fuzz-decoratefileidentity:
    desc: 'Run FuzzDecorateFileIdentity under gosentry/LibAFL (runs until Ctrl+C).'
    env:
      CGO_ENABLED: 1
    cmds:
      - task: _clean-fuzz-sentry
      - '{{.GOSENTRY}} test -run=''^$'' -fuzz=^FuzzDecorateFileIdentity$ {{.LIBAFL_FLAGS}} ./internal/dstmin'

  afl-fuzz-decoratefilereorder:
    desc: 'Run FuzzDecorateFileReorder under gosentry/LibAFL (runs until Ctrl+C).'
    env:
      CGO_ENABLED: 1
    cmds:
      - task: _clean-fuzz-sentry
      - '{{.GOSENTRY}} test -run=''^$'' -fuzz=^FuzzDecorateFileReorder$ {{.LIBAFL_FLAGS}} ./internal/dstmin'

  afl-fuzz-decoratefilereorderall:
    desc: 'Run FuzzDecorateFileReorderAll under gosentry/LibAFL (runs until Ctrl+C).'
    env:
      CGO_ENABLED: 1
    cmds:
      - task: _clean-fuzz-sentry
      - '{{.GOSENTRY}} test -run=''^$'' -fuzz=^FuzzDecorateFileReorderAll$ {{.LIBAFL_FLAGS}} ./internal/dstmin'

  afl-fuzz-commentrun:
    desc: 'Run FuzzCommentRun under gosentry/LibAFL (runs until Ctrl+C).'
    env:
      CGO_ENABLED: 1
    cmds:
      - task: _clean-fuzz-sentry
      - '{{.GOSENTRY}} test -run=''^$'' -fuzz=^FuzzCommentRun$ {{.LIBAFL_FLAGS}} ./internal/dstmin'

  afl-fuzz-generatedbymatcher:
    desc: 'Run FuzzGeneratedByMatcher under gosentry/LibAFL (runs until Ctrl+C).'
    env:
      CGO_ENABLED: 1
    cmds:
      - task: _clean-fuzz-sentry
      - '{{.GOSENTRY}} test -run=''^$'' -fuzz=^FuzzGeneratedByMatcher$ {{.LIBAFL_FLAGS}} .'

  _clean-fuzz:
    internal: true
    desc: Clear the Go fuzz coverage cache only when CLEAN=true (preserves corpus by default).
    cmds:
      - '{{if eq .CLEAN "true"}}go clean -fuzzcache{{else}}true{{end}}'

  _clean-fuzz-sentry:
    internal: true
    desc: Clear the gosentry fuzz coverage cache only when CLEAN=true (preserves corpus by default).
    cmds:
      - '{{if eq .CLEAN "true"}}{{.GOSENTRY}} clean -fuzzcache{{else}}true{{end}}'