refactor: agentic comment cleanup

go/internal/pusher/authorizer.go

@@ -10,20 +10,19 @@ import (
 
 var ErrUnauthorized = errors.New("unauthorized")
 
-// Authorizer validates whether a user can access a given channel.
 type Authorizer struct {
 	networkReader network.Reader
 }
 
-// NewAuthorizer creates a new channel authorizer.
 func NewAuthorizer(networkReader network.Reader) *Authorizer {
 	return &Authorizer{networkReader: networkReader}
 }
 
-// Authorize checks if the given humanID is allowed to subscribe to the channel.
-// Channel formats:
-//   - network:{networkId}
-//   - stream:{networkId}:{streamId}
+// Authorize accepts channel IDs of the form:
+//
+//	network:{networkId}
+//	stream:{networkId}:{streamId}
+//	_presence:{humanId}
 func (a *Authorizer) Authorize(ctx context.Context, channelID, humanID string) error {
 	parts := strings.SplitN(channelID, ":", 2)
 	if len(parts) < 2 {
@@ -39,8 +38,7 @@ func (a *Authorizer) Authorize(ctx context.Context, channelID, humanID string) e
 	case "stream":
 		return a.authorizeStream(ctx, rest, humanID)
 	case "_presence":
-		// Always allowed — used for global online presence tracking.
-		// The channel ID is _presence:{humanId}, so verify the humanId matches.
+		// Only the owning human may subscribe to their presence channel.
 		if rest != humanID {
 			return ErrUnauthorized
 		}
@@ -61,8 +59,7 @@ func (a *Authorizer) authorizeNetwork(ctx context.Context, networkID, humanID st
 	return nil
 }
 
-// authorizeStream expects rest to be "{networkId}:{streamId}".
-// We only check network membership — stream visibility is handled by network access.
+// rest is "{networkId}:{streamId}"; stream-level visibility is enforced by network access.
 func (a *Authorizer) authorizeStream(ctx context.Context, rest, humanID string) error {
 	parts := strings.SplitN(rest, ":", 2)
 	if len(parts) < 2 {