From 92e3886cfaedb4577806b3d3ede8ed2a14137610 Mon Sep 17 00:00:00 2001
From: Andrew Altshuler <andrew@collectivelab.io>
Date: Fri, 8 May 2026 15:48:37 +0300
Subject: [PATCH] ci: add publish-crates workflow for crates.io releases (#74)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The release.yml workflow builds binaries and updates Homebrew but never
published to crates.io — v0.4.0 and v0.4.1 are missing from the registry
even though the local Cargo.toml and the v0.4.1 tag are at 0.4.1.

This adds a separate workflow that:
- auto-publishes on every v* tag push (future releases self-publish)
- can be manually dispatched with a tag input (catch up on v0.4.1)
- is idempotent: skips a crate if its current crates.io version already
  matches local, so a partial failure is safe to retry
- gates on CARGO_REGISTRY_TOKEN (already in repo secrets); skips cleanly
  if the token is ever rotated out

Publishes in dependency order: omnigraph-compiler → omnigraph-engine →
omnigraph-server → omnigraph-cli. Path-only deps in Cargo.toml carry
explicit version fields, so cargo publish strips paths and resolves
against crates.io.

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
---
 .github/workflows/publish-crates.yml | 99 ++++++++++++++++++++++++++++
 1 file changed, 99 insertions(+)
 create mode 100644 .github/workflows/publish-crates.yml

diff --git a/.github/workflows/publish-crates.yml b/.github/workflows/publish-crates.yml
new file mode 100644
index 0000000..d7f783f
--- /dev/null
+++ b/.github/workflows/publish-crates.yml
@@ -0,0 +1,99 @@
+name: Publish to crates.io
+
+# Publishes the four workspace crates to crates.io in dependency order.
+#
+# Triggers:
+#   - push of any v* tag (future releases auto-publish alongside release.yml)
+#   - workflow_dispatch with an explicit tag input (catch-up runs for past tags)
+#
+# Idempotent: each crate's current crates.io version is checked before publish,
+# so a partial failure can be re-run without "crate version already exists" errors.
+#
+# Prerequisite: repo secret CARGO_REGISTRY_TOKEN. The job exits cleanly if absent.
+
+on:
+  push:
+    tags:
+      - "v*"
+  workflow_dispatch:
+    inputs:
+      tag:
+        description: "Tag to publish (e.g. v0.4.1). Required for manual dispatches."
+        required: true
+        type: string
+
+jobs:
+  publish_crates:
+    name: Publish crates
+    runs-on: ubuntu-latest
+    env:
+      CARGO_REGISTRY_TOKEN: ${{ secrets.CARGO_REGISTRY_TOKEN }}
+      CARGO_TERM_COLOR: always
+    steps:
+      - name: Skip if CARGO_REGISTRY_TOKEN is not configured
+        if: env.CARGO_REGISTRY_TOKEN == ''
+        run: |
+          echo "CARGO_REGISTRY_TOKEN is not set; skipping crates.io publish."
+          echo "CARGO_PUBLISH_SKIP=1" >> "$GITHUB_ENV"
+
+      - name: Resolve ref
+        if: env.CARGO_PUBLISH_SKIP != '1'
+        id: ref
+        run: |
+          ref="${{ inputs.tag || github.ref_name }}"
+          echo "ref=${ref}" >> "$GITHUB_OUTPUT"
+          echo "Publishing from ref: ${ref}"
+
+      - name: Checkout source at tag
+        if: env.CARGO_PUBLISH_SKIP != '1'
+        uses: actions/checkout@v5.0.1
+        with:
+          ref: ${{ steps.ref.outputs.ref }}
+
+      - name: Install Linux dependencies
+        if: env.CARGO_PUBLISH_SKIP != '1'
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y protobuf-compiler libprotobuf-dev
+
+      - name: Install Rust stable
+        if: env.CARGO_PUBLISH_SKIP != '1'
+        uses: dtolnay/rust-toolchain@stable
+        with:
+          toolchain: stable
+
+      - name: Cache Rust build data
+        if: env.CARGO_PUBLISH_SKIP != '1'
+        uses: Swatinem/rust-cache@v2
+        with:
+          workspaces: |
+            . -> target
+
+      - name: Publish crates in dependency order
+        if: env.CARGO_PUBLISH_SKIP != '1'
+        run: |
+          set -euo pipefail
+
+          publish_if_new() {
+            local crate="$1"
+            local version
+            version=$(cargo metadata --format-version=1 --no-deps \
+              | jq -r --arg c "$crate" '.packages[] | select(.name==$c) | .version')
+
+            local current
+            current=$(curl -fsSL "https://crates.io/api/v1/crates/${crate}" \
+              | jq -r '.crate.max_version' || echo "")
+
+            if [[ "$current" == "$version" ]]; then
+              echo "==> ${crate} ${version} already on crates.io, skipping"
+              return 0
+            fi
+
+            echo "==> publishing ${crate} ${version} (current crates.io: ${current:-none})"
+            cargo publish -p "$crate" --locked
+          }
+
+          publish_if_new omnigraph-compiler
+          publish_if_new omnigraph-engine
+          publish_if_new omnigraph-server
+          publish_if_new omnigraph-cli