Implement wire protocol as wool-protocol namespace package

[conradbzura]

Summary

Implement Wool's wire protocol — protobuf schemas, generated Python bindings, and wrapper modules — as a namespace package importable as wool.protocol. Include protobuf definitions for task and worker messages, gRPC service wrappers, a service registry, and CI/CD workflows for testing, releasing, and repo hygiene.

Closes #1

Proposed changes

Add wool.protocol namespace package

Create protobuf schemas (task.proto, worker.proto) defining the gRPC Worker service, task dispatch messages (Task, Result, Exception, TaskVersionEnvelope), and the response streaming protocol (Ack, Nack, Response). Add wrapper modules under src/wool/protocol/ providing a clean public API with error handling and a service registry. Configure pyproject.toml with package metadata, build hooks for git-based versioning and gRPC import fixup, and dependencies.

Add CI/CD workflows

Add 7 workflow files for test execution (pyright + pytest across Python 3.11–3.13), release cutting, publishing, PR validation, labeling, and branch sync. Include 6 composite actions and supporting shell scripts for versioning, publishing, and setup.

Add protobuf wrapper tests

Add tests for the wrapper modules (task.py, worker.py, exception.py, __init__.py) covering public API exports, error handling, and the service registry.

Test cases

Test Suite	Test ID	Given	When	Then	Coverage Target
TestTaskModule	TM-001	The task module is imported	Accessing Task symbol	Returns the protobuf Task class	task.py public export
TestTaskModule	TM-002	The task module is imported	Accessing Result symbol	Returns the protobuf Result class	task.py public export
TestTaskModule	TM-003	The task module is imported	Accessing Exception symbol	Returns the protobuf Exception class	task.py public export
TestTaskModule	TM-004	The task module is imported	Accessing TaskVersionEnvelope symbol	Returns the protobuf TaskVersionEnvelope class	task.py public export
TestTaskModule	TM-005	The task module is imported	Checking __all__	Contains exactly Exception, Result, Task, TaskVersionEnvelope, Worker	task.py __all__
TestWorkerModule	WM-001	The worker module is imported	Accessing WorkerServicer symbol	Returns the gRPC servicer base class	worker.py public export
TestWorkerModule	WM-002	The worker module is imported	Accessing WorkerStub symbol	Returns the gRPC stub class	worker.py public export
TestWorkerModule	WM-003	The worker module is imported	Accessing WorkerMetadata symbol	Returns the protobuf WorkerMetadata class	worker.py public export
TestWorkerModule	WM-004	The worker module is imported	Checking __all__	Contains exactly 9 symbols: Ack, Nack, Response, StopRequest, Void, WorkerMetadata, WorkerServicer, WorkerStub, add_WorkerServicer_to_server	worker.py __all__
TestProtobufImportError	PE-001	An ImportError with message "No module named 'foo'"	Raising ProtobufImportError wrapping it	Error message includes original message and compilation hint	exception.py
TestServiceRegistry	SR-001	The protobuf package is imported	Accessing add_to_server dict	Maps WorkerServicer to add_WorkerServicer_to_server	__init__.py registry

Implementation plan

1. • Add protobuf schemas (task.proto, worker.proto) and configure pyproject.toml with package metadata, build hooks, and dependencies
2. • Add wrapper modules (task.py, worker.py, exception.py, __init__.py) under src/wool/protocol/ with public API, error handling, and service registry
3. • Add CI/CD workflow files, composite actions, and shell scripts
4. • Add protobuf wrapper test suite (tests/protocol/) covering TM-001 through SR-001