chore: revive and improve release automation

.github/workflows/release-check.yml

@@ -0,0 +1,48 @@
+name: Release Checker
+
+on:
+  pull_request_target:
+    paths:
+      - "**/Cargo.toml"
+    types: [ opened, synchronize, reopened, labeled, unlabeled ]
+  workflow_dispatch:
+
+permissions:
+  contents: write
+  pull-requests: write
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  release-check:
+    uses: ipdxco/unified-github-workflows/.github/workflows/release-check.yml@v1.0
+    with:
+      sources: |
+        [
+          "fvm/Cargo.toml",
+          "testing/integration/Cargo.toml",
+          "ipld/amt/Cargo.toml",
+          "ipld/bitfield/Cargo.toml",
+          "ipld/blockstore/Cargo.toml",
+          "ipld/car/Cargo.toml",
+          "ipld/encoding/Cargo.toml",
+          "ipld/hamt/Cargo.toml",
+          "ipld/kamt/Cargo.toml",
+          "sdk/Cargo.toml",
+          "shared/Cargo.toml"
+        ]
+      separator: "@"
+  cargo-publish:
+    needs: [release-check]
+    if: needs.release-check.outputs.json != '{}'
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Dry-run publish
+        run: |
+          # Use cargo publish --workspace --dry-run to verify the entire workspace at once.
+          # This correctly handles interdependent crates which a matrix-based approach misses.
+          # We use --no-default-features to avoid OpenCL dependencies which are not available in the CI environment.
+          cargo publish --workspace --dry-run --no-default-features

.github/workflows/releaser.yml

@@ -0,0 +1,50 @@
+name: Releaser
+
+on:
+  push:
+    paths:
+      - "**/Cargo.toml"
+  workflow_dispatch:
+
+permissions:
+  contents: write
+  id-token: write
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.sha }}
+  cancel-in-progress: true
+
+jobs:
+  releaser:
+    uses: ipdxco/unified-github-workflows/.github/workflows/releaser.yml@v1.0
+    with:
+      sources: |
+        [
+          "fvm/Cargo.toml",
+          "testing/integration/Cargo.toml",
+          "ipld/amt/Cargo.toml",
+          "ipld/bitfield/Cargo.toml",
+          "ipld/blockstore/Cargo.toml",
+          "ipld/car/Cargo.toml",
+          "ipld/encoding/Cargo.toml",
+          "ipld/hamt/Cargo.toml",
+          "ipld/kamt/Cargo.toml",
+          "sdk/Cargo.toml",
+          "shared/Cargo.toml"
+        ]
+      separator: "@"
+    secrets:
+      UCI_GITHUB_TOKEN: ${{ secrets.UCI_GITHUB_TOKEN }}
+
+  cargo-publish:
+    needs: [releaser]
+    if: needs.releaser.outputs.json != '{}'
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Publish to crates.io
+        run: |
+          # Use cargo publish --workspace to publish all changed crates in the workspace.
+          # This handles interdependent crates correctly and only publishes those with version bumps.
+          # We use --no-default-features to avoid OpenCL dependencies which are not available in the CI environment.
+          cargo publish --workspace --no-default-features

RELEASE.md

@@ -14,7 +14,7 @@ The FVM is a workspace of crates which have different release schedules:
 > When releasing a new version of the FVM, make sure to check if any backports are needed and do them in separate PRs targeting the appropriate branches. Afterwards, make sure to create a new release for the backported changes.
 > Note that the v2 and v3 tracks no longer contain the `fvm_integration_tests` crate so there is no need to backport and release it.
 
-The primary crates are `fvm`, `fvm_shared`, `fvm_sdk`, and the integration testing framework `fvm_integration_tests`.  These are the crates that have [`version.workspace = true`](https://github.com/search?q=repo%3Afilecoin-project%2Fref-fvm%20version.workspace%20%3D%20true&type=code).
+The primary crates are `fvm`, `fvm_shared`, `fvm_sdk`, and the integration testing framework `fvm_integration_tests`. These are the crates that have [`version.workspace = true`](https://github.com/search?q=repo%3Afilecoin-project%2Fref-fvm%20version.workspace%20%3D%20true&type=code).
 
 ## Versioning
 Versioning of the [primary crates](#primary-crates) is not strictly semver compatible:
@@ -33,9 +33,6 @@ To propose a new release, open a pull request with the following changes:
 2. Update the version of the coupled workspace dependencies in `Cargo.toml` to match the new version
    (leaving semver range specifier `~` intact):
    1. `workspace.dependencies→fvm→version`
-   2. `wokspace.dependencies→fvm_shared→version`
-   3. `wokspace.dependencies→fvm_sdk→version`
-   1. `workspace.dependencies→fvm→version`
    2. `workspace.dependencies→fvm_shared→version`
    3. `workspace.dependencies→fvm_sdk→version`
    4. `workspace.dependencies→fvm_integration_tests→version`
@@ -47,6 +44,11 @@ To propose a new release, open a pull request with the following changes:
 
 See [PR #2002](https://github.com/filecoin-project/ref-fvm/pull/2002) for an example.
 
+When a release PR is opened or updated, the **Release Checker** GitHub Action will:
+* Verify that the version bump is correct.
+* Perform a workspace-wide dry-run publish (`cargo publish --workspace --dry-run`) to ensure all crates are in a valid state for release.
+* Create a draft GitHub Release and comment on the PR with a summary.
+
 ## Preparing Other/Non-Primary Crates
 
 To propose a release of a crate other than `fvm`, `fvm_shared`, `fvm_sdk`, or
@@ -58,59 +60,28 @@ To propose a release of a crate other than `fvm`, `fvm_shared`, `fvm_sdk`, or
 3. Make sure the `CHANGELOG.md` files are all up-to-date (look through `git log -- path/to/crate`),
    set the release date & version, and add a new "Unreleased" section.
 
+The **Release Checker** will also handle these crates independently based on the paths modified in the PR.
+
 ## Review and Release
 
 Once the release is prepared, it'll go through a review:
 
 1. Make sure that we're _ready_ to release. E.g., make sure downstream can consume the release.
 2. Make sure that we're correctly following semver.
 3. Make sure that we're not missing anything in the changelogs.
+4. Verify that the **Release Checker** action has passed, including the "Dry-run publish" step.
 
 Finally, an [FVM "owner"](https://github.com/orgs/filecoin-project/teams/fvm-crate-owners/members) will:
 
 1. Merge the release PR to master.
-2. For each released crate, create a git tag: `crate_name@crate_version`.
-3. Run `cargo publish` for each released crate (in dependency order).
-
-Example steps for an FVM "owner" to release `MINOR` and `PATCH` crates:
-
-1. Merge the `PATCH` release PR to master (e.g., [PR #2030](https://github.com/filecoin-project/ref-fvm/pull/2030)).
-2. Publish all [primary crates](#primary-crates) . For each crate (fvm, fvm_shared, fvm_sdk, fvm_integration_tests):
-
-```bash
-# Declare an associative array for crate_name → crate_directory
-declare -A crates
-crates["fvm"]="fvm"
-crates["fvm_shared"]="shared"
-crates["fvm_sdk"]="fvm_sdk"
-crates["fvm_integration_tests"]="testing/integration"
-
-workspace_package_version = `tomlq '.workspace.package.version' Cargo.toml`
-
-for crate_name in "${!crates[@]}"; do
-   crate_directory = ${crates[$key]}     
-   pushd $crate_directory
-   cargo publish
-workspace_package_version=`tomlq '.workspace.package.version' Cargo.toml`
-
-for crate_name in "${!my_map[@]}"; do
-   crate_directory=${crates[$key]}     
-   pushd $crate_directory
-   cargo publish
-   git_tag="$crate_name@v$workspace_package_version"
-   git tag $git_tag
-   popd
-done
-```
-
-3. After creating all tags, push them:
-
-```shell
-git push --tags
-```
-
-4. Verify the releases on crates.io:
+2. The **Releaser** GitHub Action will automatically:
+   * Create git tags for each released crate (`crate_name@vX.Y.Z`).
+   * Publish the draft GitHub Release(s).
+   * Publish the crates to [crates.io](https://crates.io) using `cargo publish --workspace --no-default-features`.
+     - Note: This repository uses **trusted publishing** via OIDC. No `CARGO_REGISTRY_TOKEN` secret is required, but the repository must be configured as a trusted publisher on crates.io.
+
+3. Verify the releases on crates.io:
    https://crates.io/crates/fvm/versions
    https://crates.io/crates/fvm_shared/versions
    https://crates.io/crates/fvm_sdk/versions
-   https://crates.io/crates/fvm_integration_tests/versions
+   https://crates.io/crates/fvm_integration_tests/versions