fix(lint): resolve ruff E501, I001, and F541 errors breaking CI

Line-length, import-sort, and extraneous f-prefix violations that
failed the GitHub Actions linter step.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: ayhammouda

src/mcp_server_python_docs/models.py

@@ -148,7 +148,10 @@ class DetectPythonVersionResult(BaseModel):
         description="Python major.minor detected from the user's environment (e.g. '3.13')"
     )
     source: str = Field(
-        description="How the version was detected: '.python-version file', 'python3 in PATH', or 'server runtime'"
+        description=(
+            "How the version was detected: '.python-version file',"
+            " 'python3 in PATH', or 'server runtime'"
+        )
     )
     matched_index_version: str | None = Field(
         default=None,

src/mcp_server_python_docs/services/search.py

@@ -9,8 +9,6 @@
 import sqlite3
 
 from mcp_server_python_docs.models import SearchDocsResult
-from mcp_server_python_docs.services.observability import log_tool_call
-from mcp_server_python_docs.services.version_resolution import resolve_version_permissive
 from mcp_server_python_docs.retrieval.query import (
     build_match_expression,
     classify_query,
@@ -22,10 +20,13 @@
     search_sections,
     search_symbols,
 )
+from mcp_server_python_docs.services.observability import log_tool_call
+from mcp_server_python_docs.services.version_resolution import resolve_version_permissive
 
 
 class SearchService:
-    """Search service dispatching queries through classifier, synonym expansion, and FTS5/symbol fast-path."""
+    """Search service dispatching queries through classifier, synonym expansion,
+    and FTS5/symbol fast-path."""
 
     def __init__(self, db: sqlite3.Connection, synonyms: dict[str, list[str]]) -> None:
         self._db = db

tests/test_packaging.py

@@ -39,7 +39,7 @@ def test_synonyms_yaml_in_wheel(self, built_wheel):
             names = zf.namelist()
         synonym_paths = [n for n in names if n.endswith("data/synonyms.yaml")]
         assert len(synonym_paths) == 1, (
-            f"synonyms.yaml not found in wheel. Wheel contents:\n"
+            "synonyms.yaml not found in wheel. Wheel contents:\n"
             + "\n".join(sorted(names))
         )
         assert "mcp_server_python_docs/data/synonyms.yaml" in synonym_paths[0]
@@ -50,7 +50,7 @@ def test_schema_sql_in_wheel(self, built_wheel):
             names = zf.namelist()
         schema_paths = [n for n in names if n.endswith("storage/schema.sql")]
         assert len(schema_paths) >= 1, (
-            f"schema.sql not found in wheel. Wheel contents:\n"
+            "schema.sql not found in wheel. Wheel contents:\n"
             + "\n".join(sorted(names))
         )
 

tests/test_retrieval.py

@@ -61,15 +61,24 @@ def fts_db():
         "'asyncio Task', 'Documentation about asyncio tasks and TaskGroup', 50)"
     )
     conn.execute(
-        "INSERT INTO sections (id, document_id, uri, anchor, heading, level, ordinal, content_text, char_count) "
-        "VALUES (1, 1, 'library/asyncio-task.html#asyncio.TaskGroup', 'asyncio.TaskGroup', "
-        "'asyncio.TaskGroup', 2, 1, "
-        "'A context manager that holds a group of tasks. Tasks can be added with create_task. All tasks are awaited on exit.', 100)"
+        "INSERT INTO sections"
+        " (id, document_id, uri, anchor, heading, level, ordinal,"
+        " content_text, char_count) "
+        "VALUES (1, 1, 'library/asyncio-task.html#asyncio.TaskGroup',"
+        " 'asyncio.TaskGroup', 'asyncio.TaskGroup', 2, 1, "
+        "'A context manager that holds a group of tasks."
+        " Tasks can be added with create_task."
+        " All tasks are awaited on exit.', 100)"
     )
     conn.execute(
-        "INSERT INTO sections (id, document_id, uri, anchor, heading, level, ordinal, content_text, char_count) "
-        "VALUES (2, 1, 'library/asyncio-task.html#introduction', 'introduction', "
-        "'Introduction', 1, 0, 'This page describes asyncio tasks and how to use TaskGroup for concurrent execution.', 80)"
+        "INSERT INTO sections"
+        " (id, document_id, uri, anchor, heading, level, ordinal,"
+        " content_text, char_count) "
+        "VALUES (2, 1, 'library/asyncio-task.html#introduction',"
+        " 'introduction', "
+        "'Introduction', 1, 0,"
+        " 'This page describes asyncio tasks and how to use"
+        " TaskGroup for concurrent execution.', 80)"
     )
     conn.execute(
         "INSERT INTO symbols (id, doc_set_id, qualified_name, normalized_name, module, "