@revund/ts-worker

The TypeScript / JavaScript AST sidecar for Revund. A gRPC server that implements revund.worker.v1.Worker — the universal contract every Revund worker speaks. Built on ts-morph for AST traversal and tsc for diagnostics.

Install

npm install -g @revund/ts-worker

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

Usage

The worker is normally launched by the Revund CLI. To run it standalone (for debugging or to share a single instance across reviews):

revund-ts-worker                  # binds 0.0.0.0:50051
TS_WORKER_PORT=0 revund-ts-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:50051 revund review

What it does

The worker advertises three capabilities via the Describe RPC:

| Capability | RPC | Purpose | |---|---|---| | parse | Parse | Returns the universal ParsedFile shape — imports, top-level decls, functions (with hash + canonical hash + blocks), and concern evidence (Presentation/State/Network/IO/Config/Business). | | resolve_symbols | ResolveSymbols | Given a diff, finds declarations of external symbols referenced in the changed code. | | diagnostics | RunDiagnostics | Runs tsc --noEmit against the repo and returns errors touching the changed files. |

Environment

| Variable | Default | Purpose | |---|---|---| | TS_WORKER_PORT | 50051 | Bind port. Use 0 for OS-assigned (recommended when the CLI spawns the worker). | | REVUND_WORKER_PROTO | (auto-resolved) | Override path to worker.proto. Auto-resolution covers monorepo, npm-installed, and Docker layouts. |

Contract

The wire contract is defined in proto/worker/v1/worker.proto, vendored inside the package and loaded at startup by @grpc/proto-loader.

License

Apache-2.0