Updated docstrings for auth module

src/auth/interface.py

@@ -1,4 +1,9 @@
-"""Abstract base class for authentication methods."""
+"""Abstract base class for all authentication method implementations.
+
+Defines the abstract base class used by all authentication method implementations.
+Contract: subclasses must implement `__call__(request: Request) -> AuthTuple`
+where `AuthTuple = (UserID, UserName, Token)`.
+"""
 
 from abc import ABC, abstractmethod
 

src/auth/noop_with_token.py

@@ -1,4 +1,13 @@
-"""Manage authentication flow for FastAPI endpoints with no-op auth."""
+"""Manage authentication flow for FastAPI endpoints with no-op auth and provided user token.
+
+Intended for local/dev use only — do not use in production.
+
+Behavior:
+- Reads a user token from request headers via `auth.utils.extract_user_token`.
+- Reads `user_id` from query params (falls back to `DEFAULT_USER_UID`) and
+  pairs it with `DEFAULT_USER_NAME`.
+- Returns a tuple: (user_id, DEFAULT_USER_NAME, user_token).
+"""
 
 import logging