revund-ruby-worker 0.1.0 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fe8acdfb8380e8eccf8ae7aaefec9511a8093c1784cd466d634b639b4e2ae451
-  data.tar.gz: 190b547da8748b8365f2783948a638291f0dbfc0482f2fa22d77cc80fcac20f3
+  metadata.gz: 297b104bad97b94ac3797145ee977a83fc760411b159ef91f3732f925e0efe26
+  data.tar.gz: 5e5abdb3fb0b94624c150299edccce59f25dbe442419109f3fd4dd4d6676374a
 SHA512:
-  metadata.gz: 37deb1f281054a0bd187801fef50f7d75664b5043ce8f185dbd1355198d470267cc971fac442cc6387a9f7bebbb87aa1a507734e194378804b10e966a1b5da3e
-  data.tar.gz: cc5307d080f97ddb361b02bcce78a24545e23c75f101992f7d7e831eb6f12dbc67f61babb5a58126a6df5e198d4811bf013935d477bcb3f59de3003b49510a05
+  metadata.gz: c9789c2c44ecfa8ef694bd81636ea25eeb6b4e0a8fd0852d51c2a7a0148d5a7514b43b8097c9d922bfdda73e49b184e06f56dd88cf05ee8bf55e0538e4951ee8
+  data.tar.gz: e7accdaded54025c8f3a70de761a5a7c0521fe5bb2c4e1d018d1374ab80ae9478051d14078ea6f0ad8b5b47888e30cca27c5dad3a3f1f0b37c1a5bca4a5b39e4

data/README.md

@@ -51,9 +51,9 @@ The worker advertises one capability via the `Describe` RPC:
 ## Contract
 
 The wire contract is defined in
-[`proto/worker/v1/worker.proto`](./proto/worker/v1/worker.proto), vendored
-inside the gem. The canonical source lives at
-[`revund-dev/revund-workers/proto/worker/v1/worker.proto`](https://github.com/revund-dev/revund-workers/blob/main/proto/worker/v1/worker.proto).
+[`proto/worker/v1/worker.proto`](./proto/worker/v1/worker.proto),
+vendored inside the gem and loaded by the generated
+`worker_pb` / `worker_services_pb` stubs.
 
 ## License
 

data/lib/ruby_worker/service.rb

@@ -3,23 +3,18 @@
 require_relative 'parser'
 require_relative 'fetcher'
 # Generated by grpc_tools_ruby_protoc from
-# /proto/worker/v1/worker.proto. The codegen script lives at
-# scripts/gen-proto.sh (a follow-up). Uncomment once generated:
-#
-# require 'worker/v1/worker_pb'
-# require 'worker/v1/worker_services_pb'
+# proto/worker/v1/worker.proto via `rake gen_stubs`. The output
+# lands under lib/worker/v1/ so standard require paths pick it up.
+require 'worker/v1/worker_pb'
+require 'worker/v1/worker_services_pb'
 
 module RubyWorker
   # Service implements the universal `revund.worker.v1.Worker`
   # contract — the same contract ts-worker and php-worker speak.
   #
   # Each handler is thin — it translates between the gRPC wire
-  # shape and the Parser domain object. The handler bodies are
-  # written against the assumed generated message shape so
-  # swapping the stub in is mechanical.
-  class Service
-    # include ::Revund::Worker::V1::Worker::Service
-
+  # shape and the Parser domain object.
+  class Service < ::Revund::Worker::V1::Worker::Service
     NAME = 'ruby-worker'
     LANGUAGES = ['ruby'].freeze
     CAPABILITIES = %w[parse self_fetch].freeze

data/lib/ruby_worker/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module RubyWorker
-  VERSION = '0.1.0'
+  VERSION = '0.1.2'
 end

data/lib/worker/v1/worker_pb.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: worker/v1/worker.proto
+
+require 'google/protobuf'
+
+
+descriptor_data = "\n\x16worker/v1/worker.proto\x12\x10revund.worker.v1\"\x11\n\x0f\x44\x65scribeRequest\"Z\n\x10\x44\x65scribeResponse\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x0f\n\x07version\x18\x02 \x01(\t\x12\x11\n\tlanguages\x18\x03 \x03(\t\x12\x14\n\x0c\x63\x61pabilities\x18\x04 \x03(\t\"M\n\nRepoSource\x12\x0b\n\x03url\x18\x01 \x01(\t\x12\x0b\n\x03ref\x18\x02 \x01(\t\x12\x12\n\nauth_token\x18\x03 \x01(\t\x12\x11\n\tauth_user\x18\x04 \x01(\t\"\x0f\n\rHealthRequest\"!\n\x0eHealthResponse\x12\x0f\n\x07version\x18\x01 \x01(\t\"c\n\x0cParseRequest\x12\x11\n\trepo_path\x18\x01 \x01(\t\x12\r\n\x05\x66iles\x18\x02 \x03(\t\x12\x31\n\x0brepo_source\x18\x03 \x01(\x0b\x32\x1c.revund.worker.v1.RepoSource\"<\n\rParseResponse\x12+\n\x05\x66iles\x18\x01 \x03(\x0b\x32\x1c.revund.worker.v1.ParsedFile\"\x83\x02\n\nParsedFile\x12\x0c\n\x04path\x18\x01 \x01(\t\x12\x10\n\x08language\x18\x02 \x01(\t\x12,\n\x07imports\x18\x03 \x03(\x0b\x32\x1b.revund.worker.v1.ImportRef\x12(\n\x05\x64\x65\x63ls\x18\x04 \x03(\x0b\x32\x19.revund.worker.v1.DeclRef\x12\x30\n\tfunctions\x18\x05 \x03(\x0b\x32\x1d.revund.worker.v1.FunctionRef\x12\x36\n\x08\x63oncerns\x18\x07 \x03(\x0b\x32$.revund.worker.v1.ConcernEvidenceRef\x12\x13\n\x0bparse_error\x18\x06 \x01(\t\"6\n\tImportRef\x12\x0c\n\x04path\x18\x01 \x01(\t\x12\r\n\x05\x61lias\x18\x02 \x01(\t\x12\x0c\n\x04line\x18\x03 \x01(\x05\"W\n\x07\x44\x65\x63lRef\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x0c\n\x04kind\x18\x02 \x01(\t\x12\x0c\n\x04line\x18\x03 \x01(\x05\x12\x10\n\x08\x65nd_line\x18\x04 \x01(\x05\x12\x10\n\x08\x65xported\x18\x05 \x01(\x08\"\xcf\x01\n\x0b\x46unctionRef\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x12\n\nstart_line\x18\x02 \x01(\x05\x12\x10\n\x08\x65nd_line\x18\x03 \x01(\x05\x12\x12\n\ncomplexity\x18\x04 \x01(\x05\x12\x11\n\tis_method\x18\x05 \x01(\x08\x12\x13\n\x0bis_exported\x18\x06 \x01(\x08\x12\x0c\n\x04hash\x18\x07 \x01(\t\x12\x16\n\x0e\x63\x61nonical_hash\x18\x08 \x01(\t\x12*\n\x06\x62locks\x18\t \x03(\x0b\x32\x1a.revund.worker.v1.BlockRef\"d\n\x08\x42lockRef\x12\x0c\n\x04kind\x18\x01 \x01(\t\x12\x12\n\nstart_line\x18\x02 \x01(\x05\x12\x10\n\x08\x65nd_line\x18\x03 \x01(\x05\x12\x0c\n\x04hash\x18\x04 \x01(\t\x12\x16\n\x0e\x63\x61nonical_hash\x18\x05 \x01(\t\"R\n\x12\x43oncernEvidenceRef\x12\x10\n\x08\x63\x61tegory\x18\x01 \x01(\t\x12\x0c\n\x04line\x18\x02 \x01(\x05\x12\x0e\n\x06symbol\x18\x03 \x01(\t\x12\x0c\n\x04note\x18\x04 \x01(\t\"{\n\x0eResolveRequest\x12\x11\n\trepo_path\x18\x01 \x01(\t\x12\x0c\n\x04\x64iff\x18\x02 \x01(\t\x12\x15\n\rchanged_files\x18\x03 \x03(\t\x12\x31\n\x0brepo_source\x18\x04 \x01(\x0b\x32\x1c.revund.worker.v1.RepoSource\"@\n\x0fResolveResponse\x12-\n\x07symbols\x18\x01 \x03(\x0b\x32\x1c.revund.worker.v1.SymbolDecl\"a\n\nSymbolDecl\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x11\n\tfile_path\x18\x02 \x01(\t\x12\x12\n\nstart_line\x18\x03 \x01(\x05\x12\x10\n\x08\x65nd_line\x18\x04 \x01(\x05\x12\x0c\n\x04text\x18\x05 \x01(\t\"p\n\x12\x44iagnosticsRequest\x12\x11\n\trepo_path\x18\x01 \x01(\t\x12\x14\n\x0c\x66ilter_files\x18\x02 \x03(\t\x12\x31\n\x0brepo_source\x18\x03 \x01(\x0b\x32\x1c.revund.worker.v1.RepoSource\"H\n\x13\x44iagnosticsResponse\x12\x31\n\x0b\x64iagnostics\x18\x01 \x03(\x0b\x32\x1c.revund.worker.v1.Diagnostic\"T\n\nDiagnostic\x12\x0c\n\x04\x66ile\x18\x01 \x01(\t\x12\x0c\n\x04line\x18\x02 \x01(\x05\x12\x0b\n\x03\x63ol\x18\x03 \x01(\x05\x12\x0c\n\x04\x63ode\x18\x04 \x01(\t\x12\x0f\n\x07message\x18\x05 \x01(\t2\xa8\x03\n\x06Worker\x12Q\n\x08\x44\x65scribe\x12!.revund.worker.v1.DescribeRequest\x1a\".revund.worker.v1.DescribeResponse\x12K\n\x06Health\x12\x1f.revund.worker.v1.HealthRequest\x1a .revund.worker.v1.HealthResponse\x12H\n\x05Parse\x12\x1e.revund.worker.v1.ParseRequest\x1a\x1f.revund.worker.v1.ParseResponse\x12U\n\x0eResolveSymbols\x12 .revund.worker.v1.ResolveRequest\x1a!.revund.worker.v1.ResolveResponse\x12]\n\x0eRunDiagnostics\x12$.revund.worker.v1.DiagnosticsRequest\x1a%.revund.worker.v1.DiagnosticsResponseBGZEgithub.com/revund-dev/revund/core/pkg/worker/proto/worker/v1;workerpbb\x06proto3"
+
+pool = ::Google::Protobuf::DescriptorPool.generated_pool
+pool.add_serialized_file(descriptor_data)
+
+module Revund
+  module Worker
+    module V1
+      DescribeRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("revund.worker.v1.DescribeRequest").msgclass
+      DescribeResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("revund.worker.v1.DescribeResponse").msgclass
+      RepoSource = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("revund.worker.v1.RepoSource").msgclass
+      HealthRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("revund.worker.v1.HealthRequest").msgclass
+      HealthResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("revund.worker.v1.HealthResponse").msgclass
+      ParseRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("revund.worker.v1.ParseRequest").msgclass
+      ParseResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("revund.worker.v1.ParseResponse").msgclass
+      ParsedFile = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("revund.worker.v1.ParsedFile").msgclass
+      ImportRef = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("revund.worker.v1.ImportRef").msgclass
+      DeclRef = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("revund.worker.v1.DeclRef").msgclass
+      FunctionRef = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("revund.worker.v1.FunctionRef").msgclass
+      BlockRef = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("revund.worker.v1.BlockRef").msgclass
+      ConcernEvidenceRef = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("revund.worker.v1.ConcernEvidenceRef").msgclass
+      ResolveRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("revund.worker.v1.ResolveRequest").msgclass
+      ResolveResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("revund.worker.v1.ResolveResponse").msgclass
+      SymbolDecl = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("revund.worker.v1.SymbolDecl").msgclass
+      DiagnosticsRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("revund.worker.v1.DiagnosticsRequest").msgclass
+      DiagnosticsResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("revund.worker.v1.DiagnosticsResponse").msgclass
+      Diagnostic = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("revund.worker.v1.Diagnostic").msgclass
+    end
+  end
+end

data/lib/worker/v1/worker_services_pb.rb

@@ -0,0 +1,112 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# Source: worker/v1/worker.proto for package 'revund.worker.v1'
+# Original file comments:
+# worker.proto — the universal AST-worker contract.
+#
+# # Public API
+#
+# This file defines the wire contract every Revund AST
+# sidecar speaks. It is designed for STABILITY since the
+# contract may eventually be published as an open-source
+# interface that third-party language sidecars target.
+#
+# Compatibility rules:
+#
+#   - Adding fields to existing messages: ALLOWED (proto3
+#     ignores unknown fields gracefully).
+#   - Adding new RPCs: ALLOWED (clients negotiate capability
+#     via Describe).
+#   - Removing or renaming fields: BREAKING — bump the
+#     package version (v1 → v2). Old clients keep speaking v1.
+#   - Changing field types: BREAKING.
+#
+# # Sidecar contract
+#
+# A Revund worker is any process implementing this service.
+# It can be:
+#
+#   - A first-party reference implementation we maintain
+#     (ts-worker, php-worker, ruby-worker)
+#   - A community-built sidecar for any language
+#   - A proprietary worker a customer builds for their
+#     in-house DSL
+#
+# The bot dials the worker by host:port, calls `Describe`
+# to learn which languages + capabilities it advertises,
+# and routes Parse RPCs based on the response. The bot
+# does NOT hardcode language-to-worker mappings — every
+# worker self-identifies.
+#
+# # Minimum viable worker
+#
+# Implement only `Describe`, `Health`, and `Parse`. Set
+# `capabilities = ["parse"]`. The bot uses that worker for
+# its advertised languages and skips the rest gracefully.
+#
+# # Symbol resolution / diagnostics (optional)
+#
+# Capabilities are advisory. Workers that ALSO support
+# symbol resolution (returning declarations of identifiers
+# referenced in changed code) advertise
+# `capabilities = ["parse", "resolve_symbols"]`. Workers
+# that run language-specific type-checkers (TypeScript's
+# `tsc --noEmit`, PHP's PHPStan, Ruby's Sorbet) advertise
+# `["parse", "diagnostics"]`. The bot uses these features
+# when present, falls back to "just parse" when not.
+#
+
+require 'grpc'
+require 'worker/v1/worker_pb'
+
+module Revund
+  module Worker
+    module V1
+      module Worker
+        class Service
+
+          include ::GRPC::GenericService
+
+          self.marshal_class_method = :encode
+          self.unmarshal_class_method = :decode
+          self.service_name = 'revund.worker.v1.Worker'
+
+          # Describe identifies the worker. The bot calls this
+          # first to learn what languages + capabilities it
+          # supports. Idempotent, side-effect-free.
+          rpc :Describe, ::Revund::Worker::V1::DescribeRequest, ::Revund::Worker::V1::DescribeResponse
+          # Health is a standard k8s-style liveness probe.
+          rpc :Health, ::Revund::Worker::V1::HealthRequest, ::Revund::Worker::V1::HealthResponse
+          # Parse returns a minimal AST view (imports + decls +
+          # functions + concerns) for the requested files. Per-
+          # file parse errors are returned INSIDE the response,
+          # never as RPC errors. REQUIRED capability — every
+          # healthy worker implements this.
+          rpc :Parse, ::Revund::Worker::V1::ParseRequest, ::Revund::Worker::V1::ParseResponse
+          # ResolveSymbols returns the declarations of identifiers
+          # referenced in a diff but defined elsewhere in the
+          # repo. Used by the bot's ingest layer to enrich the
+          # LLM bundle with cross-file type information.
+          #
+          # OPTIONAL capability — workers advertise
+          # "resolve_symbols" in Describe.Capabilities when
+          # implemented. Workers that don't implement it return
+          # UNIMPLEMENTED; the bot's caller checks the capability
+          # list and skips the call when unsupported.
+          rpc :ResolveSymbols, ::Revund::Worker::V1::ResolveRequest, ::Revund::Worker::V1::ResolveResponse
+          # RunDiagnostics runs the language's native type-checker
+          # (tsc --noEmit for TypeScript, PHPStan for PHP, Sorbet
+          # for Ruby, etc.) and returns errors touching the
+          # changed files. Empty when the project has no errors
+          # or the worker doesn't run a type-checker — never an
+          # RPC error.
+          #
+          # OPTIONAL capability — workers advertise "diagnostics"
+          # in Describe.Capabilities when implemented.
+          rpc :RunDiagnostics, ::Revund::Worker::V1::DiagnosticsRequest, ::Revund::Worker::V1::DiagnosticsResponse
+        end
+
+        Stub = Service.rpc_stub_class
+      end
+    end
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: revund-ruby-worker
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.2
 platform: ruby
 authors:
 - Revund
@@ -86,6 +86,8 @@ files:
 - lib/ruby_worker/server.rb
 - lib/ruby_worker/service.rb
 - lib/ruby_worker/version.rb
+- lib/worker/v1/worker_pb.rb
+- lib/worker/v1/worker_services_pb.rb
 - proto/worker/v1/worker.proto
 homepage: https://revund.dev
 licenses: