revund-ruby-worker

The Ruby AST sidecar for Revund. A gRPC server that implements revund.worker.v1.Worker — the universal contract every Revund worker speaks. Built on whitequark/parser, the same library RuboCop, Sorbet, and Brakeman use.

Install

gem install revund-ruby-worker

You also need the revund CLI itself. The CLI discovers revund-ruby-worker on PATH and spawns it on demand.

Usage

The worker is normally launched by the Revund CLI. To run it standalone:

revund-ruby-worker                              # binds 0.0.0.0:50053
REVUND_RUBY_WORKER_PORT=0 revund-ruby-worker    # OS-assigned port; prints "ready: 0.0.0.0:<port>" on stdout

Point the CLI at it via the REVUND_WORKERS env var (plain host:port — the CLI calls Describe to learn the worker's languages and capabilities):

REVUND_WORKERS=localhost:50053 revund review

What it does

The worker advertises one capability via the Describe RPC:

Capability	RPC	Purpose
`parse`	`Parse`	Returns the universal `ParsedFile` shape — requires, top-level decls (`class` / `module` / `def` / `defs` / `casgn`), method bodies (with cyclomatic complexity, hash, canonical hash, blocks), and concern evidence (Presentation/State/Network/IO/Config/Business/DataAccess/Transport).

ResolveSymbols and RunDiagnostics are not implemented yet — the Revund CLI checks the capability list from Describe and skips RPCs the worker hasn't advertised.

Environment

Variable	Default	Purpose
`REVUND_RUBY_WORKER_PORT`	`50053`	Bind port. Use `0` for OS-assigned (recommended when the CLI spawns the worker).

Contract

The wire contract is defined in proto/worker/v1/worker.proto, vendored inside the gem and loaded by the generated worker_pb / worker_services_pb stubs.

License

Apache-2.0