log refactor

backend/src/api/routes/git/_helpers.py

@@ -13,7 +13,9 @@ from typing import Optional
 from fastapi import HTTPException
 from sqlalchemy.orm import Session
 
-from src.core.logger import logger
+from src.core.cot_logger import MarkerLogger
+
+log = MarkerLogger("GitHelpers")
 from src.core.superset_client import SupersetClient
 from src.dependencies import get_config_manager
 from src.models.auth import User
@@ -52,7 +54,7 @@ def _build_no_repo_status_payload() -> dict:
 # @PRE: `error` is a non-HTTPException instance.
 # @POST: Raises HTTPException(500) with route-specific context.
 def _handle_unexpected_git_route_error(route_name: str, error: Exception) -> None:
-    logger.error(f"[{route_name}][Coherence:Failed] {error}")
+    log.explore(f"{route_name} failed: {error}", error=str(error))
     raise HTTPException(status_code=500, detail=f"{route_name} failed: {str(error)}")
 # [/DEF:_handle_unexpected_git_route_error:Function]
 
@@ -66,8 +68,8 @@ def _resolve_repository_status(dashboard_id: int) -> dict:
     git_service = get_git_service()
     repo_path = git_service._get_repo_path(dashboard_id)
     if not os.path.exists(repo_path):
-        logger.debug(
-            f"[get_repository_status][Action] Repository is not initialized for dashboard {dashboard_id}"
+        log.reason(
+            f"Repository is not initialized for dashboard {dashboard_id}"
         )
         return _build_no_repo_status_payload()
 
@@ -75,8 +77,8 @@ def _resolve_repository_status(dashboard_id: int) -> dict:
         return git_service.get_status(dashboard_id)
     except HTTPException as e:
         if e.status_code == 404:
-            logger.debug(
-                f"[get_repository_status][Action] Repository is not initialized for dashboard {dashboard_id}"
+            log.reason(
+                f"Repository is not initialized for dashboard {dashboard_id}"
             )
             return _build_no_repo_status_payload()
         raise
@@ -300,11 +302,7 @@ def _resolve_current_user_git_identity(
             .first()
         )
     except Exception as resolve_error:
-        logger.warning(
-            "[_resolve_current_user_git_identity][Action] Failed to load profile preference for user %s: %s",
-            user_id,
-            resolve_error,
-        )
+        log.explore(f"Failed to load profile preference for user {user_id}: {resolve_error}", error=str(resolve_error))
         return None
 
     if not preference:

backend/src/api/routes/git/_repo_operations_routes.py

@@ -10,7 +10,10 @@ from fastapi import Depends, HTTPException
 from sqlalchemy.orm import Session
 
 from src.core.database import get_db
-from src.core.logger import belief_scope, logger
+from src.core.cot_logger import MarkerLogger
+from src.core.logger import belief_scope
+
+log = MarkerLogger("GitRepoOps")
 from src.dependencies import get_config_manager, get_current_user, has_permission
 from src.models.auth import User
 from src.models.git import GitRepository, GitServerConfig
@@ -133,23 +136,13 @@ async def pull_changes(
                         config_url = config_row.url
                         config_provider = config_row.provider
             except Exception as diagnostics_error:
-                logger.warning(
-                    "[pull_changes][Action] Failed to load repository binding diagnostics for dashboard %s: %s",
-                    dashboard_id,
-                    diagnostics_error,
-                )
-            logger.info(
-                "[pull_changes][Action] Route diagnostics dashboard_ref=%s env_id=%s resolved_dashboard_id=%s "
-                "binding_exists=%s binding_local_path=%s binding_remote_url=%s binding_config_id=%s config_provider=%s config_url=%s",
-                dashboard_ref,
-                env_id,
-                dashboard_id,
-                bool(db_repo),
-                (db_repo.local_path if db_repo else None),
-                (db_repo.remote_url if db_repo else None),
-                (db_repo.config_id if db_repo else None),
-                config_provider,
-                config_url,
+                log.explore(f"Failed to load repository binding diagnostics for dashboard {dashboard_id}: {diagnostics_error}", error=str(diagnostics_error))
+            log.reason(
+                f"Route diagnostics dashboard_ref={dashboard_ref} env_id={env_id} resolved_dashboard_id={dashboard_id} "
+                f"binding_exists={bool(db_repo)} binding_local_path={(db_repo.local_path if db_repo else None)} "
+                f"binding_remote_url={(db_repo.remote_url if db_repo else None)} "
+                f"binding_config_id={(db_repo.config_id if db_repo else None)} "
+                f"config_provider={config_provider} config_url={config_url}"
             )
             _apply_git_identity_from_profile(dashboard_id, db, current_user)
             _gs.pull_changes(dashboard_id)
@@ -197,11 +190,7 @@ async def get_repository_status_batch(
     with belief_scope("get_repository_status_batch"):
         dashboard_ids = list(dict.fromkeys(request.dashboard_ids))
         if len(dashboard_ids) > MAX_REPOSITORY_STATUS_BATCH:
-            logger.warning(
-                "[get_repository_status_batch][Action] Batch size %s exceeds limit %s. Truncating request.",
-                len(dashboard_ids),
-                MAX_REPOSITORY_STATUS_BATCH,
-            )
+            log.explore(f"Batch size {len(dashboard_ids)} exceeds limit {MAX_REPOSITORY_STATUS_BATCH}. Truncating request.", error="Batch size exceeds limit")
             dashboard_ids = dashboard_ids[:MAX_REPOSITORY_STATUS_BATCH]
 
         statuses = {}
@@ -215,9 +204,7 @@ async def get_repository_status_batch(
                     "sync_status": "ERROR",
                 }
             except Exception as e:
-                logger.error(
-                    f"[get_repository_status_batch][Coherence:Failed] Failed for dashboard {dashboard_id}: {e}"
-                )
+                log.explore(f"Failed for dashboard {dashboard_id}: {e}", error=str(e))
                 statuses[str(dashboard_id)] = {
                     **_build_no_repo_status_payload(),
                     "sync_state": "ERROR",

backend/src/api/routes/git/_repo_routes.py

@@ -10,7 +10,10 @@ from fastapi import Depends, HTTPException
 from sqlalchemy.orm import Session
 
 from src.core.database import get_db
-from src.core.logger import belief_scope, logger
+from src.core.cot_logger import MarkerLogger
+from src.core.logger import belief_scope
+
+log = MarkerLogger("GitRepoRoutes")
 from src.dependencies import get_config_manager, get_current_user, has_permission
 from src.models.auth import User
 from src.models.git import GitRepository, GitServerConfig
@@ -64,9 +67,7 @@ async def init_repository(
             raise HTTPException(status_code=404, detail="Git configuration not found")
 
         try:
-            logger.info(
-                f"[init_repository][Action] Initializing repo for dashboard {dashboard_id}"
-            )
+            log.reason(f"Initializing repo for dashboard {dashboard_id}")
             _gs.init_repo(
                 dashboard_id,
                 init_data.remote_url,
@@ -97,15 +98,10 @@ async def init_repository(
                 db_repo.current_branch = "dev"
 
             db.commit()
-            logger.info(
-                f"[init_repository][Coherence:OK] Repository initialized for dashboard {dashboard_id}"
-            )
             return {"status": "success", "message": "Repository initialized"}
         except Exception as e:
             db.rollback()
-            logger.error(
-                f"[init_repository][Coherence:Failed] Failed to init repository: {e}"
-            )
+            log.explore("Failed to init repository", error=str(e))
             if isinstance(e, HTTPException):
                 raise
             _handle_unexpected_git_route_error("init_repository", e)