Merge pull request #2 from anthropics/setup-artifactory-publishing

ci: add Artifactory publishing workflow

Author: njsmith

.github/workflows/publish.yml

@@ -0,0 +1,54 @@
+# Security notes:
+# - GitHub-owned actions (actions/checkout) use tag pins
+# - Third-party actions (jfrog/setup-jfrog-cli) are pinned to full commit SHAs
+# - Rust toolchain comes from the runner's pre-installed rustup
+# - The publish environment requires the anthropic-1.49.0 branch
+name: Publish to Artifactory
+
+on:
+  push:
+    branches:
+      - anthropic-1.49.0
+
+permissions:
+  contents: read
+  id-token: write
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    environment: publish
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Rust
+        run: |
+          rustup default stable
+          rustup show
+
+      - name: Setup JFrog CLI
+        uses: jfrog/setup-jfrog-cli@ff5cb544114ffc152db9cea1cd3d5978d5074946  # v4.5.11
+        env:
+          JF_URL: https://artifactory.infra.ant.dev
+        with:
+          oidc-provider-name: github
+          oidc-audience: jfrog-github
+
+      - name: Configure Cargo
+        run: |
+          ARTIFACTORY_TOKEN=$(jf config show | grep "Access Token" | awk '{print $3}')
+          mkdir -p ~/.cargo
+          cat >> ~/.cargo/config.toml << EOF
+          [registries.crates-internal]
+          index = "sparse+https://artifactory.infra.ant.dev/artifactory/api/cargo/crates-internal/index/"
+          credential-provider = ["cargo:token"]
+          EOF
+          # TODO: Consider adding crates-io source replacement through Artifactory proxy
+          # once OIDC token read access to the crates-io proxy is confirmed.
+          # For now, cargo resolves dependencies from public crates.io directly.
+          cargo login --registry crates-internal <<< "Bearer ${ARTIFACTORY_TOKEN}"
+
+      - name: Publish tokio to Artifactory
+        run: |
+          cd tokio
+          cargo publish --registry crates-internal --allow-dirty

ANTHROPIC.md

@@ -0,0 +1,42 @@
+# Anthropic Tokio Fork
+
+This is Anthropic's fork of [tokio](https://github.com/tokio-rs/tokio), published to our internal Artifactory registry as `crates-internal`.
+
+## Version Convention
+
+Versions follow the `+anthropic.N` suffix convention per `go/fork`:
+- `1.49.0+anthropic.1` = tokio 1.49.0 + stall detection feature
+
+## Features Added
+
+### `stall-detection`
+
+Detects when a tokio worker thread is stalled (blocked in a task poll for too long) and reports diagnostics including stack traces via `tracing`.
+
+```rust
+let rt = tokio::runtime::Builder::new_multi_thread()
+    .enable_stall_detection()
+    .stall_detection_poll_interval(Duration::from_millis(100))
+    .stall_detection_escalation_threshold(Duration::from_secs(10))
+    .build()
+    .unwrap();
+```
+
+## Publishing
+
+Publishing happens automatically when changes are pushed to the `anthropic-1.49.0` branch. The GitHub Actions workflow uses OIDC authentication with Artifactory.
+
+### Prerequisites
+
+1. The `anthropics/tokio` repo must be added to the OIDC config in `anthropics/terraform-config`
+2. A `publish-cli` GitHub environment must be configured in repo settings
+3. The `jfrog/setup-jfrog-cli` action must be allowed in repo settings
+
+## Using in the Monorepo
+
+In the workspace `Cargo.toml`:
+
+```toml
+[patch.crates-io]
+tokio = { version = "1.49.0+anthropic.1", registry = "crates-internal" }
+```

CLAUDE.md

@@ -0,0 +1,42 @@
+# Anthropic Tokio Fork - Development Guide
+
+## Version Bumping
+
+Every PR merged to an `anthropic-*` branch MUST bump the `+anthropic.N` version suffix.
+Increment `N` by 1 from whatever the current value is.
+
+### Files to update
+
+All publishable crates need matching version suffixes:
+
+- `tokio/Cargo.toml` - main tokio crate
+- `tokio-macros/Cargo.toml` - proc macros
+- `tokio-stream/Cargo.toml` - stream utilities
+- `tokio-test/Cargo.toml` - test utilities
+- `tokio-util/Cargo.toml` - additional utilities
+
+Example: if current versions end in `+anthropic.3`, update them all to `+anthropic.4`.
+
+### Version format
+
+`<upstream_version>+anthropic.<N>`
+
+Examples:
+- `1.49.0+anthropic.1` (first anthropic release based on tokio 1.49.0)
+- `1.49.0+anthropic.2` (second anthropic release)
+
+The `+anthropic.N` suffix is a semver build metadata tag — it does not affect dependency resolution but uniquely identifies our builds in Artifactory.
+
+## Publishing
+
+Publishing to the `crates-internal` Artifactory registry happens automatically via GitHub Actions when changes are pushed to an `anthropic-*` branch. See `.github/workflows/publish.yml`.
+
+## Stall Detection Feature
+
+The `stall-detection` feature is our primary addition. See `ANTHROPIC.md` for user-facing documentation.
+
+Key implementation files:
+- `tokio/src/runtime/stall_detection.rs` - monitor thread, signal handler, frame-pointer walker
+- `tokio/src/runtime/scheduler/multi_thread/worker.rs` - generation counter increments
+- `tokio/src/runtime/metrics/worker.rs` - WorkerMetrics fields
+- `tokio/src/runtime/builder.rs` - builder API methods

tokio-macros/Cargo.toml

@@ -4,7 +4,7 @@ name = "tokio-macros"
 # - Remove path dependencies
 # - Update CHANGELOG.md.
 # - Create "tokio-macros-x.y.z" git tag.
-version = "2.6.0"
+version = "2.6.0+anthropic.1"
 edition = "2021"
 rust-version = "1.71"
 authors = ["Tokio Contributors <team@tokio.rs>"]

tokio-stream/Cargo.toml

@@ -4,7 +4,7 @@ name = "tokio-stream"
 # - Remove path dependencies
 # - Update CHANGELOG.md.
 # - Create "tokio-stream-0.1.x" git tag.
-version = "0.1.17"
+version = "0.1.17+anthropic.1"
 edition = "2021"
 rust-version = "1.71"
 authors = ["Tokio Contributors <team@tokio.rs>"]

tokio-test/Cargo.toml

@@ -4,7 +4,7 @@ name = "tokio-test"
 # - Remove path dependencies
 # - Update CHANGELOG.md.
 # - Create "tokio-test-0.4.x" git tag.
-version = "0.4.4"
+version = "0.4.4+anthropic.1"
 edition = "2021"
 rust-version = "1.71"
 authors = ["Tokio Contributors <team@tokio.rs>"]

tokio-util/Cargo.toml

@@ -4,7 +4,7 @@ name = "tokio-util"
 # - Remove path dependencies
 # - Update CHANGELOG.md.
 # - Create "tokio-util-0.7.x" git tag.
-version = "0.7.17"
+version = "0.7.17+anthropic.1"
 edition = "2021"
 rust-version = "1.71"
 authors = ["Tokio Contributors <team@tokio.rs>"]

tokio/Cargo.toml

@@ -6,7 +6,7 @@ name = "tokio"
 #   - README.md
 # - Update CHANGELOG.md.
 # - Create "v1.x.y" git tag.
-version = "1.49.0"
+version = "1.49.0+anthropic.1"
 edition = "2021"
 rust-version = "1.71"
 authors = ["Tokio Contributors <team@tokio.rs>"]