Implement comprehensive LLM integration with multi-provider support

Major Features Added:
- Complete LLM orchestrator with OpenAI, Anthropic, Gemini, and Ollama support
- Tiered access system (system defaults vs. BYO API keys)
- Comprehensive usage tracking and cost monitoring at session/course levels
- Admin and user LLM configuration interfaces
- Teaching style-aware prompt generation and content adaptation
- Enhanced content enhancer with LLM-powered intelligent suggestions

Technical Improvements:
- Fixed database schema issues (added is_verified column)
- Updated email service to use pydantic settings for .env loading
- Added comprehensive test coverage for LLM components (29 new tests)
- Fixed import errors in existing tests (Session, Severity namespace issues)
- Enhanced database initialization with proper schema migrations
- Added type annotations and improved code organization

Quality Assurance:
- Resolved all linting issues (1773 ruff warnings addressed)
- Fixed type checking errors (207 basedpyright issues resolved)
- Created extensive test suites for LLM orchestrator and UI components
- Updated documentation with comprehensive guides and ADRs
- Cleaned up project structure (removed outdated implementation docs)

The application now provides a complete curriculum curation platform with
intelligent LLM-powered content generation, cost tracking, and multi-user
support while maintaining robust error handling and graceful fallbacks.

🤖 Generated with [Claude Code](https://claude.ai/code)

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

Author: michael-borck

app.py

@@ -66,21 +66,25 @@ def ContentComparison(original_analysis, suggestions, **kwargs):
             Div(
                 Button(
                     "✅ Accept Changes",
-                    onclick="alert('Changes would be applied!')",
+                    hx_post="/comparison/accept",
+                    hx_target="#comparison-message",
                     cls="btn-primary mr-4",
                 ),
                 Button(
                     "❌ Reject Changes",
-                    onclick="alert('Changes would be rejected!')",
+                    hx_post="/comparison/reject",
+                    hx_target="#comparison-message",
                     cls="btn-secondary mr-4",
                 ),
                 Button(
                     "📥 Export Final Version",
-                    onclick="alert('Export feature coming soon!')",
+                    hx_post="/export/final",
+                    hx_target="#comparison-message",
                     cls="btn-secondary",
                 ),
                 cls="text-center",
             ),
+            Div(id="comparison-message", cls="mt-4"),
         ),
         **kwargs,
     )

components/analysis.py

@@ -42,11 +42,14 @@ def EnhancementSuggestions(suggestions, **kwargs):
                 ),
                 Button(
                     "📥 Export Enhanced Content",
-                    onclick="alert('Export feature coming soon!')",
+                    hx_post="/export/enhanced",
+                    hx_target="#export-message",
                     cls="btn-secondary",
                 ),
+                Div(id="export-message", cls="mt-4"),
                 cls="mt-6",
             ),
+            Div(id="enhancement-message", cls="mt-4"),
         ),
         **kwargs,
     )
@@ -79,7 +82,9 @@ def EnhancementCard(title: str, description: str, priority: str = "medium", **kw
             P(description, cls="text-sm text-gray-600 mb-3"),
             Button(
                 "Apply Suggestion",
-                onclick=f"alert('Would apply: {title}')",
+                hx_post="/enhancement/apply",
+                hx_vals=f'{{"suggestion": "{title}"}}',
+                hx_target="#enhancement-message",
                 cls="btn btn-secondary text-xs",
             ),
             cls="p-4",

components/comparison.py

@@ -11,13 +11,15 @@ def Page(*children, title="Curriculum Curator", **kwargs):
             Navigation(),
             Main(*children, cls="container mx-auto px-4 py-8"),
             Footer(
-                P("© 2024 Curriculum Curator - Educational Content Enhancement Tool", 
-                  cls="text-center text-gray-500 text-sm"),
+                P(
+                    "© 2024 Curriculum Curator - Educational Content Enhancement Tool",
+                    cls="text-center text-gray-500 text-sm",
+                ),
                 cls="mt-16 py-4 border-t border-gray-200",
             ),
             cls="min-h-screen bg-gray-50",
         ),
-        **kwargs
+        **kwargs,
     )
 
 

components/enhancement.py

@@ -1,9 +1,10 @@
 """Content analysis engine for educational materials."""
 
-from typing import List, Dict, Any, Optional
-import re
 import logging
+import re
 from dataclasses import dataclass
+from typing import Any
+
 from .parsers import ParsedContent
 from .plugin_manager import PluginManager
 
@@ -46,13 +47,13 @@ class ContentGap:
 class AnalysisResult:
     """Complete analysis result."""
 
-    learning_objectives: List[LearningObjective]
+    learning_objectives: list[LearningObjective]
     quality_metrics: QualityMetrics
-    content_gaps: List[ContentGap]
+    content_gaps: list[ContentGap]
     pedagogical_approach: str
     total_word_count: int
     estimated_duration: str
-    key_concepts: List[str]
+    key_concepts: list[str]
 
 
 class ContentAnalyzer:
@@ -123,7 +124,7 @@ def __init__(self, use_plugins: bool = True):
             ],
         }
 
-    def analyze(self, content_items: List[ParsedContent]) -> AnalysisResult:
+    def analyze(self, content_items: list[ParsedContent]) -> AnalysisResult:
         """Perform comprehensive content analysis."""
         logger.info(f"Starting analysis of {len(content_items)} content items")
 
@@ -165,8 +166,8 @@ def analyze(self, content_items: List[ParsedContent]) -> AnalysisResult:
         return result
 
     def _extract_learning_objectives(
-        self, content_items: List[ParsedContent]
-    ) -> List[LearningObjective]:
+        self, content_items: list[ParsedContent]
+    ) -> list[LearningObjective]:
         """Extract and analyze learning objectives."""
         objectives = []
 
@@ -248,7 +249,7 @@ def _is_measurable(self, text: str) -> bool:
         return any(indicator in text_lower for indicator in measurable_indicators)
 
     def _calculate_quality_metrics(
-        self, content_items: List[ParsedContent], full_text: str
+        self, content_items: list[ParsedContent], full_text: str
     ) -> QualityMetrics:
         """Calculate various quality metrics."""
 
@@ -294,7 +295,7 @@ def _calculate_avg_sentence_length(self, text: str) -> float:
         )
         return total_words / len([s for s in sentences if s.strip()])
 
-    def _calculate_structure_score(self, content_items: List[ParsedContent]) -> float:
+    def _calculate_structure_score(self, content_items: list[ParsedContent]) -> float:
         """Score based on content organization."""
         score = 0.5  # Base score
 
@@ -319,7 +320,7 @@ def _calculate_structure_score(self, content_items: List[ParsedContent]) -> floa
         return min(1.0, score)
 
     def _calculate_engagement_score(
-        self, content_items: List[ParsedContent], full_text: str
+        self, content_items: list[ParsedContent], full_text: str
     ) -> float:
         """Score based on engagement indicators."""
         score = 0.3  # Base score
@@ -348,7 +349,7 @@ def _calculate_engagement_score(
         return min(1.0, score)
 
     def _calculate_completeness_score(
-        self, content_items: List[ParsedContent]
+        self, content_items: list[ParsedContent]
     ) -> float:
         """Score based on content completeness."""
         score = 0.4  # Base score
@@ -371,8 +372,8 @@ def _calculate_completeness_score(
         return min(1.0, score)
 
     def _identify_content_gaps(
-        self, content_items: List[ParsedContent], objectives: List[LearningObjective]
-    ) -> List[ContentGap]:
+        self, content_items: list[ParsedContent], objectives: list[LearningObjective]
+    ) -> list[ContentGap]:
         """Identify gaps in the content."""
         gaps = []
 
@@ -413,7 +414,7 @@ def _identify_content_gaps(
 
         return gaps
 
-    def _detect_pedagogical_approach(self, content_items: List[ParsedContent]) -> str:
+    def _detect_pedagogical_approach(self, content_items: list[ParsedContent]) -> str:
         """Detect the main pedagogical approach used."""
         total_content = " ".join(item.content for item in content_items).lower()
 
@@ -434,7 +435,7 @@ def _detect_pedagogical_approach(self, content_items: List[ParsedContent]) -> st
 
         return max(scores, key=scores.get).title()
 
-    def _extract_key_concepts(self, text: str) -> List[str]:
+    def _extract_key_concepts(self, text: str) -> list[str]:
         """Extract key concepts from the text."""
         # Simple keyword extraction (in production, use more sophisticated NLP)
         words = re.findall(r"\b[A-Z][a-z]+\b", text)  # Capitalized words
@@ -461,8 +462,8 @@ def _estimate_duration(self, word_count: int) -> str:
             return f"{hours}h {minutes}m"
 
     def _infer_objectives_from_content(
-        self, content_items: List[ParsedContent]
-    ) -> List[LearningObjective]:
+        self, content_items: list[ParsedContent]
+    ) -> list[LearningObjective]:
         """Infer learning objectives from content when none are explicit."""
         objectives = []
 
@@ -482,31 +483,30 @@ def _infer_objectives_from_content(
                 )
 
         return objectives[:5]  # Limit inferred objectives
-    
-    async def analyze_with_validation(self, content_items: List[ParsedContent]) -> Dict[str, Any]:
+
+    async def analyze_with_validation(
+        self, content_items: list[ParsedContent]
+    ) -> dict[str, Any]:
         """Perform analysis with plugin-based validation."""
         # First do standard analysis
         analysis_result = self.analyze(content_items)
-        
-        result = {
-            "analysis": analysis_result,
-            "validation": None
-        }
-        
+
+        result = {"analysis": analysis_result, "validation": None}
+
         # If plugins enabled, run validation
         if self.use_plugins and self.plugin_manager:
             full_text = " ".join([item.content for item in content_items])
-            
+
             # Run validation
             validation_result = await self.plugin_manager.validate_and_remediate(
                 full_text,
                 auto_remediate=False,
                 context={
                     "content_type": "educational",
-                    "content_items": len(content_items)
-                }
+                    "content_items": len(content_items),
+                },
             )
-            
+
             result["validation"] = validation_result["validation"]
-            
+
         return result