Add interceptors package with useful typed Goa interceptor functions

- Add Trace Stream family of interceptor functions which allow for
  tracing of individual messages sent on bidirectional, client to
  server, and server to client streams.
- Fix typos in several READMEs.

[ ] Add tests for the interceptor functions.

Author: douglaswth

README.md

@@ -30,8 +30,10 @@ Clue covers the following topics:
   downstream dependencies for testing.
 * Debugging: the [debug](debug/) package makes it possible to troubleshoot
   and profile services at runtime.
+* Interceptors: the [interceptors](interceptors/) package provides a set of
+  helpful Goa interceptors.
 
-Clue's goal is to provide all the anciallary functionality required to efficiently
+Clue's goal is to provide all the ancillary functionality required to efficiently
 operate a microservice style architecture including instrumentation, logging,
 debugging and health checks. Clue is not a framework and does not provide
 functionality that is already available in the standard library or in other
@@ -175,7 +177,7 @@ metricExporter, err := otlpmetricgrpc.New(
 ```
 
 These exporters can then be used to configure Clue:
-        
+
 ```go
 // Configure OpenTelemetry.
 cfg := clue.NewConfig(ctx, "service", "1.0.0", metricExporter, spanExporter)
@@ -190,27 +192,27 @@ HTTP clients can be instrumented using the Clue `log` and OpenTelemetry `otelhtt
 import (
     "context"
     "net/http"
-	"net/http/httptrace"
+    "net/http/httptrace"
 
-	"go.opentelemetry.io/contrib/instrumentation/net/http/otelhttp"
+    "go.opentelemetry.io/contrib/instrumentation/net/http/otelhttp"
     "go.opentelemetry.io/contrib/instrumentation/net/http/otelhttptrace"
     "goa.design/clue/log"
 )
 
 // ...
 httpc := &http.Client{
     Transport: log.Client(
-    	otelhttp.NewTransport(
-    		http.DefaultTransport,
-		    otelhttp.WithClientTrace(func(ctx context.Context) *httptrace.ClientTrace {
-			    return otelhttptrace.NewClientTrace(ctx)
-		    }),
-	    ),
+        otelhttp.NewTransport(
+            http.DefaultTransport,
+            otelhttp.WithClientTrace(func(ctx context.Context) *httptrace.ClientTrace {
+                return otelhttptrace.NewClientTrace(ctx)
+            }),
+        ),
     ),
 }
 ```
 
-Similarly, gRPC clients can be instrumented using the Clue `log` and OpenTelemtry `otelgrpc` packages.
+Similarly, gRPC clients can be instrumented using the Clue `log` and OpenTelemetry `otelgrpc` packages.
 
 ```go
 import (
@@ -265,7 +267,7 @@ handler := http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
     if _, err := w.Write([]byte("Hello, World!")); err != nil {
         log.Errorf(ctx, err, "failed to write response")
     }
- })
+})
 ```
 
 ## Goa

debug/README.md

@@ -22,7 +22,7 @@ query parameter.  The path, query parameter name and value can be customized by
 passing options to the `MountDebugLogEnabler` function.
 
 Note that for the debug log state to take effect, HTTP servers must use handlers
-returned by the HTTP function and gRPC servers must make use of the 
+returned by the HTTP function and gRPC servers must make use of the
 UnaryInterceptor or StreamInterceptor interceptors.  Also note that gRPC
 services must expose an HTTP endpoint to control the debug log state.
 
@@ -116,4 +116,4 @@ With this setup, requests made to the HTTP servers of each service of the form
 `/debug?debug-logs=on` turn on debug logs and requests of the form
 `/debug?debug-logs=off` turns them back off. Requests made to `/debug/pprof/`
 return the pprof package index page while a request to `/debug/pprof/profile`
-profile the service for 30s.
+profile the service for 30s.

go.mod

@@ -1,8 +1,8 @@
 module goa.design/clue
 
-go 1.22.0
+go 1.22.7
 
-toolchain go1.23.2
+toolchain go1.23.5
 
 require (
 	github.com/aws/smithy-go v1.22.2
@@ -20,19 +20,19 @@ require (
 	go.opentelemetry.io/otel/sdk v1.34.0
 	go.opentelemetry.io/otel/sdk/metric v1.34.0
 	go.opentelemetry.io/otel/trace v1.34.0
-	goa.design/goa/v3 v3.19.1
+	goa.design/goa/v3 v3.19.2-rc1.0.20250205231826-8035d6986989
 	golang.org/x/term v0.28.0
 	golang.org/x/tools v0.29.0
 	google.golang.org/genproto v0.0.0-20241015192408-796eee8c2d53
-	google.golang.org/grpc v1.69.4
+	google.golang.org/grpc v1.70.0
 	google.golang.org/protobuf v1.36.4
 )
 
 require (
 	github.com/cenkalti/backoff/v4 v4.3.0 // indirect
 	github.com/davecgh/go-spew v1.1.1 // indirect
 	github.com/dimfeld/httppath v0.0.0-20170720192232-ee938bf73598 // indirect
-	github.com/go-chi/chi/v5 v5.1.0 // indirect
+	github.com/go-chi/chi/v5 v5.2.0 // indirect
 	github.com/go-logr/stdr v1.2.2 // indirect
 	github.com/google/uuid v1.6.0 // indirect
 	github.com/gorilla/websocket v1.5.3 // indirect

go.sum

@@ -6,8 +6,8 @@ github.com/davecgh/go-spew v1.1.1 h1:vj9j/u1bqnvCEfJOwUhtlOARqs3+rkHYY13jYWTU97c
 github.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
 github.com/dimfeld/httppath v0.0.0-20170720192232-ee938bf73598 h1:MGKhKyiYrvMDZsmLR/+RGffQSXwEkXgfLSA08qDn9AI=
 github.com/dimfeld/httppath v0.0.0-20170720192232-ee938bf73598/go.mod h1:0FpDmbrt36utu8jEmeU05dPC9AB5tsLYVVi+ZHfyuwI=
-github.com/go-chi/chi/v5 v5.1.0 h1:acVI1TYaD+hhedDJ3r54HyA6sExp3HfXq7QWEEY/xMw=
-github.com/go-chi/chi/v5 v5.1.0/go.mod h1:DslCQbL2OYiznFReuXYUmQ2hGd1aDpCnlMNITLSKoi8=
+github.com/go-chi/chi/v5 v5.2.0 h1:Aj1EtB0qR2Rdo2dG4O94RIU35w2lvQSj6BRA4+qwFL0=
+github.com/go-chi/chi/v5 v5.2.0/go.mod h1:DslCQbL2OYiznFReuXYUmQ2hGd1aDpCnlMNITLSKoi8=
 github.com/go-logr/logr v1.2.2/go.mod h1:jdQByPbusPIv2/zmleS9BjJVeZ6kBagPoEUsqbVz/1A=
 github.com/go-logr/logr v1.4.2 h1:6pFjapn8bFcIbiKo3XT4j/BhANplGihG6tvd+8rYgrY=
 github.com/go-logr/logr v1.4.2/go.mod h1:9T104GzyrTigFIr8wt5mBrctHMim0Nb2HLGrmQ40KvY=
@@ -67,8 +67,8 @@ go.opentelemetry.io/proto/otlp v1.5.0 h1:xJvq7gMzB31/d406fB8U5CBdyQGw4P399D1aQWU
 go.opentelemetry.io/proto/otlp v1.5.0/go.mod h1:keN8WnHxOy8PG0rQZjJJ5A2ebUoafqWp0eVQ4yIXvJ4=
 go.uber.org/goleak v1.3.0 h1:2K3zAYmnTNqV73imy9J1T3WC+gmCePx2hEGkimedGto=
 go.uber.org/goleak v1.3.0/go.mod h1:CoHD4mav9JJNrW/WLlf7HGZPjdw8EucARQHekz1X6bE=
-goa.design/goa/v3 v3.19.1 h1:jpV3LEy7YANzPMwm++Lu17RoThRJgXrPxdEM0A1nlOE=
-goa.design/goa/v3 v3.19.1/go.mod h1:astNE9ube0YCxqq7DQkt1MtLxB/b3kRPEFkEZovcO2I=
+goa.design/goa/v3 v3.19.2-rc1.0.20250205231826-8035d6986989 h1:VFTZNWLuL2tdveOBHpsEmxvu9PJNrjLH9dvs6KvfieI=
+goa.design/goa/v3 v3.19.2-rc1.0.20250205231826-8035d6986989/go.mod h1:YFTHST5DUS9dPdL42h3o/Wtdb9VU6tKbytBxc5hOeLU=
 golang.org/x/mod v0.22.0 h1:D4nJWe9zXqHOmWqj4VMOJhvzj7bEZg4wEYa759z1pH4=
 golang.org/x/mod v0.22.0/go.mod h1:6SkKJ3Xj0I0BrPOZoBy3bdMptDDU9oJrpohJ3eWZ1fY=
 golang.org/x/net v0.34.0 h1:Mb7Mrk043xzHgnRM88suvJFwzVrRfHEHJEl5/71CKw0=
@@ -89,8 +89,8 @@ google.golang.org/genproto/googleapis/api v0.0.0-20250115164207-1a7da9e5054f h1:
 google.golang.org/genproto/googleapis/api v0.0.0-20250115164207-1a7da9e5054f/go.mod h1:Ic02D47M+zbarjYYUlK57y316f2MoN0gjAwI3f2S95o=
 google.golang.org/genproto/googleapis/rpc v0.0.0-20250115164207-1a7da9e5054f h1:OxYkA3wjPsZyBylwymxSHa7ViiW1Sml4ToBrncvFehI=
 google.golang.org/genproto/googleapis/rpc v0.0.0-20250115164207-1a7da9e5054f/go.mod h1:+2Yz8+CLJbIfL9z73EW45avw8Lmge3xVElCP9zEKi50=
-google.golang.org/grpc v1.69.4 h1:MF5TftSMkd8GLw/m0KM6V8CMOCY6NZ1NQDPGFgbTt4A=
-google.golang.org/grpc v1.69.4/go.mod h1:vyjdE6jLBI76dgpDojsFGNaHlxdjXN9ghpnd2o7JGZ4=
+google.golang.org/grpc v1.70.0 h1:pWFv03aZoHzlRKHWicjsZytKAiYCtNS0dHbXnIdq7jQ=
+google.golang.org/grpc v1.70.0/go.mod h1:ofIJqVKDXx/JiXrwr2IG4/zwdH9txy3IlF40RmcJSQw=
 google.golang.org/protobuf v1.36.4 h1:6A3ZDJHn/eNqc1i+IdefRzy/9PokBTPvcqMySR7NNIM=
 google.golang.org/protobuf v1.36.4/go.mod h1:9fA7Ob0pmnwhb644+1+CVWFRbNajQ6iRojtC/QF5bRE=
 gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0=

go.work

@@ -1,4 +1,6 @@
-go 1.22.0
+go 1.22.7
+
+toolchain go1.23.5
 
 use (
 	.