fix: Fix ruff linting errors and missing imports in socratic-docs

Changes:
- Fix __init__.py: Import MultiFileCodeSplitter (not MultiFileSplitter)
- Add missing imports:
  * artifact_saver.py: Add LanguageExtractorRegistry import
  * multi_file_splitter.py: Add LanguageExtractorRegistry and ProjectTemplateGenerator imports
- Fix ambiguous variable names:
  * code_extractor.py: Replace 'l' with 'line' in list comprehensions
  * extractors/base.py: Replace 'l' with 'line' in list comprehensions
- Sort imports with ruff --fix
- Remove unused imports

All ruff checks now pass.
Module imports successfully.

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>

Author: Socratic Developer

src/socratic_docs/__init__.py

@@ -11,7 +11,7 @@
 from .documentation_generator import DocumentationGenerator
 from .git_initializer import GitInitializer
 from .git_repository_manager import GitRepositoryManager
-from .multi_file_splitter import MultiFileSplitter
+from .multi_file_splitter import MultiFileCodeSplitter
 from .project_templates import ProjectTemplate
 
 __version__ = "0.2.0"
@@ -21,6 +21,6 @@
     "DocumentationGenerator",
     "GitInitializer",
     "GitRepositoryManager",
-    "MultiFileSplitter",
+    "MultiFileCodeSplitter",
     "ProjectTemplate",
 ]

src/socratic_docs/artifact_saver.py

@@ -11,6 +11,8 @@
 from datetime import datetime
 from pathlib import Path
 
+from .extractors import LanguageExtractorRegistry
+
 logger = logging.getLogger("socrates.utils.artifact_saver")
 
 

src/socratic_docs/code_extractor.py

@@ -10,10 +10,10 @@
 - Solution: Extract actual Python code from markdown before processing
 """
 
-import re
 import ast
 import logging
-from typing import Tuple, Optional, List
+import re
+from typing import Optional, Tuple
 
 logger = logging.getLogger(__name__)
 
@@ -220,14 +220,14 @@ def get_code_statistics(content: str) -> dict:
             Dictionary with code statistics
         """
         lines = content.split("\n")
-        code_lines = [l for l in lines if l.strip() and not l.strip().startswith("#")]
-        comment_lines = [l for l in lines if l.strip().startswith("#")]
+        code_lines = [line for line in lines if line.strip() and not line.strip().startswith("#")]
+        comment_lines = [line for line in lines if line.strip().startswith("#")]
 
         stats = {
             "total_lines": len(lines),
             "code_lines": len(code_lines),
             "comment_lines": len(comment_lines),
-            "blank_lines": len([l for l in lines if not l.strip()]),
+            "blank_lines": len([line for line in lines if not line.strip()]),
             "is_valid_python": CodeExtractor.validate_python_syntax(content)[0],
         }
 

src/socratic_docs/extractors/__init__.py

@@ -25,10 +25,10 @@
 """
 
 from .base import BaseLanguageExtractor
-from .models import ValidationResult, ExtractionResult
-from .registry import LanguageExtractorRegistry, LanguageExtractorMetadata
-from .python_extractor import PythonExtractor
 from .generic_extractor import GenericExtractor
+from .models import ExtractionResult, ValidationResult
+from .python_extractor import PythonExtractor
+from .registry import LanguageExtractorMetadata, LanguageExtractorRegistry
 
 __all__ = [
     "BaseLanguageExtractor",

src/socratic_docs/extractors/base.py

@@ -4,12 +4,12 @@
 Defines the interface that all language extractors must implement.
 """
 
-import re
 import logging
+import re
 from abc import ABC, abstractmethod
-from typing import List, Optional
+from typing import List
 
-from .models import ValidationResult, ExtractionResult
+from .models import ExtractionResult, ValidationResult
 
 logger = logging.getLogger(__name__)
 
@@ -271,8 +271,8 @@ def get_code_statistics(self, code: str) -> dict:
             Dictionary with line counts and validity
         """
         lines = code.split("\n")
-        code_lines = [l for l in lines if l.strip() and not l.strip().startswith("#")]
-        comment_lines = [l for l in lines if l.strip().startswith("#")]
+        code_lines = [line for line in lines if line.strip() and not line.strip().startswith("#")]
+        comment_lines = [line for line in lines if line.strip().startswith("#")]
 
         validation = self.validate_syntax(code)
 
@@ -281,6 +281,6 @@ def get_code_statistics(self, code: str) -> dict:
             "total_lines": len(lines),
             "code_lines": len(code_lines),
             "comment_lines": len(comment_lines),
-            "blank_lines": len([l for l in lines if not l.strip()]),
+            "blank_lines": len([line for line in lines if not line.strip()]),
             "is_valid": validation.is_valid,
         }

src/socratic_docs/extractors/models.py

@@ -5,7 +5,7 @@
 """
 
 from dataclasses import dataclass, field
-from typing import Optional, List
+from typing import List, Optional
 
 
 @dataclass

src/socratic_docs/extractors/registry.py

@@ -6,8 +6,8 @@
 """
 
 import logging
-from typing import Dict, Optional, Type, List
 from dataclasses import dataclass, field
+from typing import Dict, List, Optional, Type
 
 from .base import BaseLanguageExtractor
 

src/socratic_docs/multi_file_splitter.py

@@ -12,6 +12,9 @@
 import logging
 from typing import Dict
 
+from .extractors import LanguageExtractorRegistry
+from .project_templates import ProjectTemplateGenerator
+
 logger = logging.getLogger("socrates.utils.multi_file_splitter")