fix: Python 3.14, CI fixes, and pre-commit format check

- Fix ruff formatting and mypy return type error in download_post_attachment
- Update all Python version references to 3.14 (CI, release, Dockerfile,
  pyproject.toml, pre-commit, ruff target-version)
- Pre-commit now uses ruff format --check to match CI behavior
- Update author email to work address

Author: ivolnistov

.github/workflows/ci.yml

@@ -20,7 +20,7 @@ jobs:
     - name: Set up Python
       uses: actions/setup-python@v5
       with:
-        python-version: '3.12'
+        python-version: '3.14'
 
     - name: Install uv
       uses: astral-sh/setup-uv@v3
@@ -38,21 +38,18 @@ jobs:
       run: uv run mypy src/pararam_nexus_mcp --ignore-missing-imports
 
   test:
-    name: Test Python ${{ matrix.python-version }}
+    name: Test
     runs-on: ubuntu-latest
-    strategy:
-      matrix:
-        python-version: ['3.12', '3.13']
 
     steps:
     - uses: actions/checkout@v4
       with:
         fetch-depth: 0  # Fetch all history for proper versioning
 
-    - name: Set up Python ${{ matrix.python-version }}
+    - name: Set up Python
       uses: actions/setup-python@v5
       with:
-        python-version: ${{ matrix.python-version }}
+        python-version: '3.14'
 
     - name: Install uv
       uses: astral-sh/setup-uv@v3
@@ -77,7 +74,7 @@ jobs:
     - name: Set up Python
       uses: actions/setup-python@v5
       with:
-        python-version: '3.12'
+        python-version: '3.14'
 
     - name: Install uv
       uses: astral-sh/setup-uv@v3

.github/workflows/release.yml

@@ -20,7 +20,7 @@ jobs:
     - name: Set up Python
       uses: actions/setup-python@v5
       with:
-        python-version: '3.12'
+        python-version: '3.14'
 
     - name: Install build tools
       run: |
@@ -103,7 +103,7 @@ jobs:
     - name: Set up Python
       uses: actions/setup-python@v5
       with:
-        python-version: '3.12'
+        python-version: '3.14'
 
     - name: Install build tools
       run: |

.pre-commit-config.yaml

@@ -15,8 +15,8 @@ repos:
         require_serial: true
 
       - id: ruff-format
-        name: ruff (format)
-        entry: uv run ruff format
+        name: ruff (format check)
+        entry: uv run ruff format --check
         language: system
         types: [python]
         args: [src/]
@@ -58,7 +58,7 @@ repos:
 
 # Configuration
 default_language_version:
-  python: python3.13
+  python: python3.14
 
 # Run on all files by default
 files: ''
@@ -68,4 +68,4 @@ exclude: '^(\.git|\.venv|venv|build|dist|\.egg|\.pytest_cache|__pycache__|htmlco
 fail_fast: false
 
 # Default stages
-default_stages: [pre-commit]
+default_stages: [pre-commit]

Dockerfile

@@ -1,4 +1,4 @@
-FROM python:3.13-alpine
+FROM python:3.14-alpine
 
 WORKDIR /app
 

pyproject.toml

@@ -3,18 +3,18 @@ name = "pararam-nexus-mcp"
 version = "0.1.0"
 description = "Model Context Protocol server for pararam.io - a modern communication and collaboration platform"
 readme = "README.md"
-requires-python = ">=3.13"
+requires-python = ">=3.14"
 license = { text = "MIT" }
 authors = [
-    { name = "Ilya Volnistov", email = "i.volnistov@gmail.com" }
+    { name = "Ilya Volnistov", email = "i.volnistov@gaijin.team" }
 ]
 keywords = ["mcp", "pararam", "pararam.io", "communication", "messaging", "fastmcp", "async"]
 classifiers = [
     "Development Status :: 3 - Alpha",
     "Intended Audience :: Developers",
     "License :: OSI Approved :: MIT License",
     "Programming Language :: Python :: 3",
-    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
     "Topic :: Communications :: Chat",
     "Topic :: Software Development :: Libraries",
     "Framework :: AsyncIO",
@@ -73,7 +73,7 @@ exclude = [
 ]
 line-length = 120
 indent-width = 4
-target-version = "py313"
+target-version = "py314"
 
 [tool.ruff.lint]
 select = [
@@ -137,7 +137,7 @@ line-ending = "auto"
 
 # MyPy configuration
 [tool.mypy]
-python_version = "3.13"
+python_version = "3.14"
 strict = true
 show_column_numbers = true
 show_error_context = false

src/pararam_nexus_mcp/client.py

@@ -16,9 +16,9 @@
 class PararamClient:
     """Wrapper for AsyncPararamio with cookie storage and session management. Singleton."""
 
-    _instance: 'PararamClient | None' = None
+    _instance: PararamClient | None = None
 
-    def __new__(cls) -> 'PararamClient':
+    def __new__(cls) -> PararamClient:
         """Create or return singleton instance."""
         if cls._instance is None:
             cls._instance = super().__new__(cls)
@@ -33,7 +33,7 @@ def __init__(self) -> None:
         self._cookie_manager: AsyncFileCookieManager = AsyncFileCookieManager(str(config.pararam_cookie_file))
         self._initialized: bool = True
 
-    async def __aenter__(self) -> 'PararamClient':
+    async def __aenter__(self) -> PararamClient:
         """Async context manager entry."""
         await self.connect()
         return self

src/pararam_nexus_mcp/schemas.py

@@ -53,7 +53,7 @@ class UploadFileToChatInput(BaseModel):
     reply_to_message_id: str | None = Field(None, pattern=r'^\d+$', description='Reply to post number')
 
     @model_validator(mode='after')
-    def validate_file_source(self) -> 'UploadFileToChatInput':
+    def validate_file_source(self) -> UploadFileToChatInput:
         """Validate that only one file source is provided."""
         if self.file_path and self.file_content:
             raise ValueError('Cannot specify both file_path and file_content')

src/pararam_nexus_mcp/tools/posts.py

@@ -374,9 +374,7 @@ async def get_chat_messages(
         try:
             client = await get_client()
 
-            logger.info(
-                f'Getting messages from chat {chat_id}, limit: {limit}, before_message_id: {before_message_id}'
-            )
+            logger.info(f'Getting messages from chat {chat_id}, limit: {limit}, before_message_id: {before_message_id}')
 
             # Get chat by ID
             chat = await client.client.get_chat_by_id(int(chat_id))
@@ -817,9 +815,7 @@ async def upload_file_to_chat(
             file_size = uploaded_file.size or actual_path.stat().st_size
 
             chat_name = chat.title or 'Unknown'
-            message_text = (
-                f"File '{file_name}' uploaded successfully to chat '{chat_name}' ({file_size} bytes)"
-            )
+            message_text = f"File '{file_name}' uploaded successfully to chat '{chat_name}' ({file_size} bytes)"
 
             return success_response(
                 message=message_text,
@@ -1487,7 +1483,14 @@ async def download_post_attachment(
         except Exception as e:
             # Top-level handler to prevent MCP server crash on unexpected errors
             logger.error('Unexpected error while downloading attachment: %s', e, exc_info=True)
-            return error_response(
+            return DownloadAttachmentErrorResponse(
                 message='Unexpected error occurred',
+                success=False,
                 error=f'Unexpected error: {e!s}',
+                chat_id=chat_id,
+                post_no=post_no,
+                file_guid=file_guid,
+                filename='',
+                size=0,
+                mime_type='',
             )