Fix lint debt and make CI gates honest

- ruff: fix all 328 errors (autofix + manual); move config to [tool.ruff.lint]
- mypy: fix all errors (annotations, nullable-column guards, stale kwargs
  in weekly report caller)
- black: reformat src/tests so black --check passes
- CI: remove `|| true` from ruff/black/mypy/pytest steps in both
  .gitea and .github workflows; install project deps and add mypy
  step in gitea python-ci so gates actually run
- docs: move 14 root status/guide markdown files into docs/, update links

src/pote/reporting/email_reporter.py

@@ -8,7 +8,6 @@ import logging
 import smtplib
 from email.mime.multipart import MIMEMultipart
 from email.mime.text import MIMEText
-from typing import List, Optional
 
 from pote.config import settings
 
@@ -20,31 +19,30 @@ class EmailReporter:
 
     def __init__(
         self,
-        smtp_host: Optional[str] = None,
-        smtp_port: Optional[int] = None,
-        smtp_user: Optional[str] = None,
-        smtp_password: Optional[str] = None,
-        from_email: Optional[str] = None,
+        smtp_host: str | None = None,
+        smtp_port: int | None = None,
+        smtp_user: str | None = None,
+        smtp_password: str | None = None,
+        from_email: str | None = None,
     ):
         """
         Initialize email reporter.
 
         If parameters are not provided, will attempt to use settings from config.
         """
-        self.smtp_host = smtp_host or getattr(settings, "smtp_host", "localhost")
-        self.smtp_port = smtp_port or getattr(settings, "smtp_port", 587)
-        self.smtp_user = smtp_user or getattr(settings, "smtp_user", None)
-        self.smtp_password = smtp_password or getattr(settings, "smtp_password", None)
-        self.from_email = from_email or getattr(
-            settings, "from_email", "pote@localhost"
-        )
+        # Settings always defines these fields (with defaults), so direct access is safe.
+        self.smtp_host: str = smtp_host or settings.smtp_host
+        self.smtp_port: int = smtp_port or settings.smtp_port
+        self.smtp_user: str = smtp_user or settings.smtp_user
+        self.smtp_password: str = smtp_password or settings.smtp_password
+        self.from_email: str = from_email or settings.from_email or "pote@localhost"
 
     def send_report(
         self,
-        to_emails: List[str],
+        to_emails: list[str],
         subject: str,
         body_text: str,
-        body_html: Optional[str] = None,
+        body_html: str | None = None,
     ) -> bool:
         """
         Send an email report.
@@ -113,4 +111,3 @@ class EmailReporter:
         except Exception as e:
             logger.error(f"SMTP connection test failed: {e}")
             return False
-