refactor: agentic comment cleanup

go/internal/auth/service.go

@@ -47,17 +47,16 @@ type Session struct {
 type AuthService interface {
 	SessionReader
 
-	// RequestSignInCode generates a code and emails it to the provided email.
-	// To retrieve a session, client must verify with VerifySignInCode.
+	// RequestSignInCode emails a one-time code; the client redeems it via VerifySignInCode.
 	RequestSignInCode(ctx context.Context, email string) error
-	// VerifySignInCode returns ErrInvalidCode if incorrect code, otherwise creates a session.
-	// humanId is stored in the session alongside the email.
+	// VerifySignInCode returns ErrInvalidCode on a wrong code, otherwise creates
+	// a session keyed to (email, humanId).
 	VerifySignInCode(ctx context.Context, email, code, humanId string) (sessionToken string, err error)
-	// ExtendSession returns ErrSessionNotFound if no valid session
+	// ExtendSession returns ErrSessionNotFound if no valid session.
 	ExtendSession(ctx context.Context, sessionToken string) error
 	SignOut(ctx context.Context, sessionToken string) error
 
-	// MintFirebaseCustomToken returns a Firebase custom token with uid=humanId and no custom claims.
+	// MintFirebaseCustomToken issues a Firebase custom token with uid=humanId and no claims.
 	MintFirebaseCustomToken(ctx context.Context, humanId string) (string, error)
 
 	IsSystemAdmin(ctx context.Context, email string) bool