Define project-first task and CI naming

Change-Id: Icd77be234f2638cc30dff3a0472cbb1bcddc97f3

Author: maru-ava

.bazel/Taskfile.yml

@@ -0,0 +1,84 @@
+# https://taskfile.dev
+# Bazel-owned maintenance and metadata tasks.
+
+version: '3'
+
+vars:
+  NIX_RUN: '{{printf "%s/../scripts/nix_run.sh" .TASKFILE_DIR}}'
+
+tasks:
+  cache-ci-build-dependencies:
+    desc: Cache the build dependencies expected by the Bazel CI jobs
+    cmd: '{{.NIX_RUN}} ./scripts/cache_bazel_ci_build_dependencies.sh'
+
+  check-fmt:
+    desc: Check that BUILD.bazel files are formatted with buildifier
+    cmds:
+      - task: fmt
+      - cmd: '{{.NIX_RUN}} ./scripts/run_task.sh git:check-clean-branch'
+
+  check-gazelle-generate:
+    desc: Check that generated BUILD files are up-to-date
+    cmd: '{{.NIX_RUN}} bazelisk test //:gazelle_test'
+
+  check-generate-patches:
+    desc: Checks that generated patches are up-to-date (requires a clean working tree)
+    cmds:
+      - task: generate-patches
+      - cmd: '{{.NIX_RUN}} ./scripts/run_task.sh git:check-clean-branch'
+
+  check-metadata:
+    desc: Checks Bazel metadata is current (requires clean git tree)
+    cmd: '{{.NIX_RUN}} ./scripts/check_bazel_metadata.sh'
+
+  check-module-metadata:
+    desc: Checks that Bazel module metadata is up-to-date (requires a clean working tree)
+    cmds:
+      - task: sync-module-metadata
+      - cmd: '{{.NIX_RUN}} ./scripts/run_task.sh git:check-clean-branch'
+
+  check-multiple-go-libraries:
+    desc: Check that each BUILD.bazel defines at most one go_library
+    cmd: '{{.NIX_RUN}} ./scripts/check_bazel_multiple_go_libraries.sh'
+
+  clean:
+    desc: Clean Bazel cache
+    cmd: '{{.NIX_RUN}} bazelisk clean'
+
+  clean-all:
+    desc: Clean Bazel cache (full expunge)
+    cmd: '{{.NIX_RUN}} bazelisk clean --expunge'
+
+  configure-local:
+    desc: Generate .bazelrc.local, if necessary, with appropriate values for the local host
+    cmd: '{{.NIX_RUN}} ./scripts/generate_bazelrc_local.sh'
+
+  fmt:
+    desc: Format BUILD.bazel files with buildifier
+    cmd: '{{.NIX_RUN}} bazelisk run @buildifier_prebuilt//:buildifier -- -r .'
+
+  gazelle-generate:
+    desc: Regenerate BUILD files with Gazelle (all modules)
+    cmd: '{{.NIX_RUN}} bazelisk run //:gazelle'
+
+  generate-metadata:
+    desc: Regenerate Bazel metadata for this source tree
+    cmds:
+      - task: gazelle-generate
+      - task: fmt
+      - task: generate-patches
+      - task: sync-module-metadata
+
+  generate-patches:
+    desc: Regenerate .patch files from BUILD files in .bazel/patches/build_files/
+    cmd: '{{.NIX_RUN}} ./scripts/generate_bazel_patches.sh'
+
+  mod-tidy:
+    desc: Update use_repo() in MODULE.bazel from go.mod
+    cmd: '{{.NIX_RUN}} bazelisk mod tidy'
+
+  sync-module-metadata:
+    desc: Refresh Bazel module metadata files (MODULE.bazel and MODULE.bazel.lock)
+    cmds:
+      - task: mod-tidy
+      - cmd: '{{.NIX_RUN}} bazelisk mod deps --lockfile_mode=update >/dev/null'

.envrc

@@ -1,6 +1,6 @@
 if [ -n "${AVALANCHEGO_DIRENV_USE_FLAKE}" ]; then
    if ! command -v nix > /dev/null; then
-     echo "To enable entering a dev shell via this .envrc: ./scripts/run_task.sh install-nix"
+     echo "To enable entering a dev shell via this .envrc: ./scripts/run_task.sh tools:install-nix"
    else
      # nix-direnv speeds up flake evaluation vs the built-in direnv support
      # due to caching and the avoidance of nix garbage collection.

.github/actions/c-chain-reexecution-benchmark/action.yml

@@ -146,7 +146,7 @@ runs:
       run: echo "BENCHMARK_OUTPUT_FILE=${GITHUB_WORKSPACE}/benchmark-output.json" >> "$GITHUB_ENV"
     - name: Run C-Chain Re-execution Benchmark
       shell: nix develop --impure --command bash -x {0}
-      run: ./scripts/run_task.sh test-cchain-reexecution -- "${{ inputs.test || '' }}"
+      run: ./scripts/run_task.sh avalanchego:test-cchain-reexecution -- "${{ inputs.test || '' }}"
       env:
         # Test configuration overrides
         BLOCK_DIR_SRC: ${{ inputs.block-dir-src }}

.github/actions/setup-bazel/action.yml

@@ -69,9 +69,9 @@ runs:
     - name: Check Bazel metadata
       if: ${{ inputs.initial-setup == 'true' }}
       shell: bash
-      run: ./scripts/run_task.sh bazel-check-metadata
+      run: ./scripts/run_task.sh bazel:check-metadata
 
     - name: Cache Bazel CI build dependencies
       if: ${{ inputs.initial-setup == 'true' }}
       shell: bash
-      run: ./scripts/run_task.sh bazel-cache-ci-build-dependencies
+      run: ./scripts/run_task.sh bazel:cache-ci-build-dependencies

.github/packaging/README.md

@@ -50,7 +50,7 @@ The packaging pipeline builds two packages per format and architecture:
 Build and validate the full RPM pipeline locally with:
 
 ```bash
-./scripts/run_task.sh --taskfile .github/packaging/Taskfile.yml test-build-rpms
+./scripts/run_task.sh packaging:test-build-rpms
 ```
 
 Build and validate the full DEB pipeline locally with:

.github/workflows/bazel-ci-matrix.yml

@@ -1,49 +1,32 @@
 name: Bazel
 
-# Top-level Bazel CI entrypoint. This workflow defines the platform matrix
+# Orchestrates Bazel CI across supported platforms. The matrix fan-out happens
 # once and invokes bazel-ci.yml once per platform.
 on:
   push:
-    tags:
-      - "*"
     branches:
       - master
-      - dev
   pull_request:
   merge_group:
     types: [checks_requested]
 
 env:
   FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
 
-permissions:
-  contents: read
-
-# Cancel ongoing workflow runs if a new one is started
-concurrency:
-  group: ${{ github.workflow }}-${{ github.ref }}
-  cancel-in-progress: true
-
 jobs:
-  bz-define-matrix:
-    runs-on: ubuntu-24.04
-    outputs:
-      platforms: ${{ steps.set-platforms.outputs.platforms }}
-    steps:
-      - name: Define platform matrix
-        id: set-platforms
-        shell: bash
-        run: |
-          echo 'platforms=["linux-amd64","linux-arm64","darwin-arm64"]' >> "$GITHUB_OUTPUT"
-  matrix:
-    needs: bz-define-matrix
-    name: ${{ matrix.platform }}
+  bazel:
     strategy:
       fail-fast: false
       matrix:
-        platform: ${{ fromJSON(needs.bz-define-matrix.outputs.platforms) }}
+        include:
+          - platform_name: linux-amd64
+            runner: ubuntu-24.04
+          - platform_name: linux-arm64
+            runner: ubuntu-24.04-arm
+          - platform_name: darwin-arm64
+            runner: macos-26
     uses: ./.github/workflows/bazel-ci.yml
     with:
-      platform_name: ${{ matrix.platform }}
-      runner: ${{ matrix.platform == 'linux-amd64' && 'ubuntu-24.04' || matrix.platform == 'linux-arm64' && 'ubuntu-24.04-arm' || 'macos-26' }}
+      platform_name: ${{ matrix.platform_name }}
+      runner: ${{ matrix.runner }}
     secrets: inherit

.github/workflows/bazel-ci.yml

@@ -1,7 +1,5 @@
 name: Bazel Jobs
 
-# Reusable Bazel CI workflow for one platform. This workflow is called by
-# bazel-ci-matrix.yml with a platform name and runner.
 on:
   workflow_call:
     inputs:
@@ -20,17 +18,15 @@ permissions:
   contents: read
 
 jobs:
-  # Aggregate the per-platform Bazel checks into one stable required job.
-  # GitHub Actions job graphs are static, so Bazel still runs inside each
-  # declared job.
-  bazel-required:
+  required:
     if: ${{ always() }}
     needs:
       - setup
-      - unit-main
-      - unit-coreth
-      - unit-subnet-evm
-      - e2e
+      - avalanchego-test-unit
+      - coreth-test-unit
+      - evm-test-unit
+      - subnet-evm-test-unit
+      - avalanchego-test-e2e
     runs-on: ${{ inputs.runner }}
     steps:
       - name: Fail unless all needed jobs succeeded
@@ -52,50 +48,61 @@ jobs:
             exit 1
           fi
 
-  # Prepare Bazel CI for this platform before the later jobs run. Similar in intent to
-  # setup-go, this job uses setup-bazel to check Bazel metadata and prepare cache
-  # state for the dependencies that subsequent jobs are expected to need. That shifts
-  # network access into one upfront step instead of having each later job discover
-  # missing dependencies on its own.
   setup:
+    name: setup
     runs-on: ${{ inputs.runner }}
     steps:
       - uses: actions/checkout@v5
       - uses: ./.github/actions/setup-bazel
         with:
           initial-setup: true
 
-  unit-main:
+  avalanchego-test-unit:
+    name: avalanchego-test-unit
     needs: setup
     runs-on: ${{ inputs.runner }}
     steps:
       - uses: actions/checkout@v5
       - uses: ./.github/actions/setup-bazel
-      - name: Run unit tests with Bazel
+      - name: Run avalanchego unit tests with Bazel
         shell: bash
-        run: ./scripts/run_task.sh bazel-test-main
+        run: ./scripts/run_task.sh avalanchego:test-unit-bazel
 
-  unit-coreth:
+  coreth-test-unit:
+    name: coreth-test-unit
     needs: setup
     runs-on: ${{ inputs.runner }}
     steps:
       - uses: actions/checkout@v5
       - uses: ./.github/actions/setup-bazel
       - name: Run coreth unit tests with Bazel
         shell: bash
-        run: ./scripts/run_task.sh bazel-test-coreth
+        run: ./scripts/run_task.sh coreth:test-unit-bazel
 
-  unit-subnet-evm:
+  evm-test-unit:
+    name: evm-test-unit
+    needs: setup
+    runs-on: ${{ inputs.runner }}
+    steps:
+      - uses: actions/checkout@v5
+      - uses: ./.github/actions/setup-bazel
+      - name: Run evm unit tests with Bazel
+        shell: bash
+        run: ./scripts/run_task.sh evm:test-unit-bazel
+
+  subnet-evm-test-unit:
+    name: subnet-evm-test-unit
     needs: setup
     runs-on: ${{ inputs.runner }}
     steps:
       - uses: actions/checkout@v5
       - uses: ./.github/actions/setup-bazel
       - name: Run subnet-evm unit tests with Bazel
         shell: bash
-        run: ./scripts/run_task.sh bazel-test-subnet-evm
+        run: ./scripts/run_task.sh subnet-evm:test-unit-bazel
 
-  e2e:
+  avalanchego-test-e2e:
+    name: avalanchego-test-e2e
     needs: setup
     runs-on: ${{ inputs.runner }}
     steps:
@@ -104,7 +111,7 @@ jobs:
       - name: Run e2e tests with Bazel-built binary
         uses: ./.github/actions/run-monitored-tmpnet-cmd
         with:
-          run: ./scripts/run_task.sh bazel-test-e2e-ci
+          run: ./scripts/run_task.sh avalanchego:test-e2e-bazel-ci
           artifact_prefix: e2e-bazel-${{ inputs.platform_name }}
           filter_by_owner: avalanchego-e2e
           prometheus_url: ${{ secrets.PROMETHEUS_URL || '' }}

.github/workflows/build-linux-binaries.yml

@@ -28,11 +28,10 @@ jobs:
       - run: go version
 
       - name: Build the avalanchego binaries
-        run: ./scripts/run_task.sh build
+        run: ./scripts/run_task.sh avalanchego:build-gomod
 
       - name: Build subnet-evm plugin
-        working-directory: ./graft/subnet-evm
-        run: ./scripts/run_task.sh build
+        run: ./scripts/run_task.sh subnet-evm:build
 
       - name: Install aws cli
         run: sudo snap install aws-cli --classic
@@ -98,11 +97,10 @@ jobs:
       - run: go version
 
       - name: Build the avalanchego binaries
-        run: ./scripts/run_task.sh build
+        run: ./scripts/run_task.sh avalanchego:build-gomod
 
       - name: Build subnet-evm plugin
-        working-directory: ./graft/subnet-evm
-        run: ./scripts/run_task.sh build
+        run: ./scripts/run_task.sh subnet-evm:build
 
       - name: Install aws cli
         run: sudo snap install aws-cli --classic
@@ -150,6 +148,6 @@ jobs:
           path: /tmp/avalanchego/subnet-evm-linux-arm64-${{ env.TAG }}.tar.gz
 
       - name: Cleanup
-        run: |
+        run: |-
           rm -rf ./build
           rm -rf /tmp/avalanchego

.github/workflows/build-macos-release.yml

@@ -38,11 +38,10 @@ jobs:
 
       # Runs a single command using the runners shell
       - name: Build the avalanchego binary
-        run: ./scripts/run_task.sh build
+        run: ./scripts/run_task.sh avalanchego:build-gomod
 
       - name: Build subnet-evm plugin
-        working-directory: ./graft/subnet-evm
-        run: ./scripts/run_task.sh build
+        run: ./scripts/run_task.sh subnet-evm:build
 
       - name: Try to get tag from git
         if: "${{ github.event.inputs.tag == '' }}"
@@ -103,5 +102,5 @@ jobs:
           path: subnet-evm-macos-${{ env.TAG }}.zip
 
       - name: Cleanup
-        run: |
+        run: |-
           rm -rf ./build

.github/workflows/c-chain-reexecution-benchmark-container.yml

@@ -111,7 +111,7 @@ jobs:
       - name: Configure dependency versions
         if: matrix.libevm-ref != '' || matrix.firewood-ref != ''
         shell: nix develop --command bash {0}
-        run: ./scripts/run_task.sh run-polyrepo
+        run: ./scripts/run_task.sh tools:run-polyrepo
         env:
           LIBEVM_REF: ${{ matrix.libevm-ref }}
           FIREWOOD_REF: ${{ matrix.firewood-ref }}