Address AI feedback

Signed-off-by: Lukasz Gryglicki <[email protected]>

Assisted by [OpenAI](https://platform.openai.com/)

Assisted by [GitHub Copilot](https://github.com/features/copilot)

Author: lukaszgryglicki

COMMIT_AUTHORS_CACHING.md

@@ -14,14 +14,14 @@
 ---
 
 ## Caching 
-- **Co-authors cache key** are cached based on their commit traile's (`Co-authored-by:`) normalized email and name.
+- **Co-author cache keys** are based on normalized email and name from the commit trailers (`Co-authored-by:`).
 - **General cache key**: `(author_id, lower(login), lower(email)) → (user | None)`
 - **Per-project cache key**: `(project_id, author_id, lower(login), lower(email)) → (user | None, authorized, affiliated)`
 - **TTL policy**: positives **~12h** (**~3h** for per-project with signature status); negative/uncertain states use **Negative TTL = 3m**.
 - **Flow**: per-project cache → general cache → cold DB path. Results are stored back with the appropriate TTL.
 - **When signature is signed**: per-project and general caches are updated to reflect the new status (general cache is updated because given user could have no DynamoDB entry yet before signing the CLA).
-- There are /v2/clear-cache and /v4/clear-cache endpoints to clear the caches (for testing and operational purposes).
 - Thread-safe with periodic expired entries cleanup (once per hour).
+- There are `/v2/clear-cache` and `/v4/clear-cache` endpoints to clear caches (testing & ops).
 
 ---
 

cla-backend-go/github/github_repository.go

@@ -370,7 +370,7 @@ func init() {
 // ClearCaches clears all in-memory caches maintained by the GitHub module.
 func ClearCaches() {
 	f := logrus.Fields{
-		"functionName": "github.github_repository.ClearAllCaches",
+		"functionName": "github.github_repository.ClearCaches",
 	}
 	GithubUserCache.Clear()
 	ModelUserCache.Clear()

cla-backend/cla/models/github_models.py

@@ -90,11 +90,11 @@ def run():
 
 start_cache_cleanup()
 
-def clear_all_caches():
+def clear_caches():
     """
     Clears in-memory caches maintained by this module.
     """
-    fn = "cla.models.github_models.clear_all_caches"
+    fn = "cla.models.github_models.clear_caches"
     try:
         github_user_cache.clear()
         cla.log.info(f"{fn} - cleared github_user_cache")

cla-backend/cla/routes.py

@@ -29,7 +29,7 @@
 from cla.controllers.github_activity import v4_easycla_github_activity
 from cla.controllers.project_cla_group import get_project_cla_group
 from cla.models.dynamo_models import Repository, Gerrit
-from cla.models.github_models import clear_all_caches
+from cla.models.github_models import clear_caches
 from cla.project_service import ProjectService
 from cla.utils import (
     get_supported_repository_providers,
@@ -1888,7 +1888,7 @@ def clear_cache(auth_user: check_auth):
     Clears in-memory caches used by the Python GitHub layer and returns
     before/after sizes for basic observability.
     """
-    return clear_all_caches()
+    return clear_caches()
 
 @hug.post("/events", versions=1)
 def create_event(