Fix Python static analysis and code quality issues

✅ Resolve CI failures:
- Fixed all mypy type annotation errors in src/parsers/ module
- Added proper type hints for variables and functions
- Resolved import sorting and formatting issues with ruff

🔧 Type annotation improvements:
- Added type hints for dictionary/list variables in database utils
- Fixed return type annotations in database models
- Used cast() for runtime-validated values
- Added proper type annotations for class properties

📝 Code formatting and style:
- Fixed import ordering across all Python files
- Removed unnecessary trailing whitespace in __init__.py files
- Applied consistent string quoting and formatting
- Fixed function signatures and argument formatting

✅ All tests passing (78/78)
✅ MyPy static analysis clean
✅ Core functionality verified

The CI pipeline should now pass all Python static analysis and unit test checks.

Author: vinod0m

doc/CodeDocs/conf.py

@@ -7,19 +7,22 @@
 - Run the agent with a session ID to demonstrate conversational memory.
 """
 
-import sys
 from pathlib import Path
+import sys
 
 # Add src to path for imports
 sys.path.insert(0, str(Path(__file__).parent.parent / "src"))
 
 from agents.deepagent import FlexibleAgent
+
 try:
     from dotenv import load_dotenv  # type: ignore
 except Exception:
+
     def load_dotenv(*_args, **_kwargs):  # type: ignore
         return False
 
+
 def main():
     """Main demonstration function."""
     print("🤖 FlexibleAgent Demo")
@@ -43,7 +46,6 @@ def main():
         print(f"  ❌ Error: {e}")
         print("  Please ensure you have a valid API key in your .env file.")
 
-
     # --- Conversational Memory with Session ID ---
     print("\n--- Conversational Memory with Session ID ---")
     try:

examples/deepagent_demo.py

@@ -6,14 +6,17 @@
 from diagram files and store them in the database.
 """
 
-import sys
 from pathlib import Path
+import sys
 
 # Add src to path for imports
 sys.path.insert(0, str(Path(__file__).parent.parent / "src"))
 
-from parsers import PlantUMLParser, MermaidParser, DrawIOParser
-from parsers.database import DiagramDatabase, get_diagram_statistics
+from parsers import DrawIOParser
+from parsers import MermaidParser
+from parsers import PlantUMLParser
+from parsers.database import DiagramDatabase
+from parsers.database import get_diagram_statistics
 
 
 def create_sample_diagrams():
@@ -82,9 +85,9 @@ class Cat {
     </mxGraphModel>"""
 
     return {
-        'plantuml': plantuml_content,
-        'mermaid': mermaid_content,
-        'drawio': drawio_content
+        "plantuml": plantuml_content,
+        "mermaid": mermaid_content,
+        "drawio": drawio_content,
     }
 
 
@@ -99,9 +102,9 @@ def main():
 
     # Create parsers
     parsers = {
-        'PlantUML': PlantUMLParser(),
-        'Mermaid': MermaidParser(),
-        'DrawIO': DrawIOParser()
+        "PlantUML": PlantUMLParser(),
+        "Mermaid": MermaidParser(),
+        "DrawIO": DrawIOParser(),
     }
 
     # Get sample diagrams
@@ -114,14 +117,14 @@ def main():
         print(f"\n📊 Testing {parser_name} Parser")
         print("-" * 30)
 
-        if parser_name == 'PlantUML':
-            content = samples['plantuml']
+        if parser_name == "PlantUML":
+            content = samples["plantuml"]
             filename = "sample.puml"
-        elif parser_name == 'Mermaid':
-            content = samples['mermaid']
+        elif parser_name == "Mermaid":
+            content = samples["mermaid"]
             filename = "sample.mmd"
         else:  # DrawIO
-            content = samples['drawio']
+            content = samples["drawio"]
             filename = "sample.drawio"
 
         try:

examples/parser_demo.py

@@ -1,12 +1,16 @@
-import os
 import argparse
+import os
+
 from src.agents import deepagent
+
 try:
     from dotenv import load_dotenv  # type: ignore
 except Exception:
+
     def load_dotenv(*_args, **_kwargs):  # type: ignore
         return False
 
+
 def main():
     # Load environment variables from .env file in the repo root
     dotenv_path = os.path.join(os.path.dirname(os.path.dirname(__file__)), ".env")
@@ -20,7 +24,7 @@ def main():
     parser.add_argument("--output-file", required=True)
     args = parser.parse_args()
 
-    with open(args.prompt_file, 'r') as f:
+    with open(args.prompt_file) as f:
         prompt = f.read()
 
     api_key = None
@@ -30,15 +34,13 @@ def main():
         api_key = os.getenv("OPENAI_API_KEY")
 
     agent = deepagent.FlexibleAgent(
-        provider=args.provider,
-        api_key=api_key,
-        model=args.model,
-        dry_run=False
+        provider=args.provider, api_key=api_key, model=args.model, dry_run=False
     )
     response = agent.run(prompt)
 
-    with open(args.output_file, 'w') as f:
-        f.write(response.get('output', ''))
+    with open(args.output_file, "w") as f:
+        f.write(response.get("output", ""))
+
 
 if __name__ == "__main__":
     main()