feat: Publish empathy-framework v1.6.1 to PyPI

Published the Empathy Framework to PyPI under the name "empathy-framework"
since "empathy" was already taken. Package is now publicly available at:
https://pypi.org/project/empathy-framework/

Major Changes:
- Changed package name from "empathy" to "empathy-framework" in pyproject.toml
- Updated README.md with new installation instructions and badge URLs
- Ran black formatter and ruff linter across entire codebase
- Fixed 307 linting issues automatically with ruff --fix
- Temporarily excluded 2 example files with syntax errors from distribution
- Applied isort to fix import ordering in wizard files

Package Details:
- Version: 1.6.1
- Size: 206KB (wheel), 816KB (source)
- Python: 3.10+
- License: Fair Source 0.9

Installation:
  pip install empathy-framework
  pip install empathy-framework[full]  # Recommended

Distribution Files:
- empathy_framework-1.6.1-py3-none-any.whl
- empathy_framework-1.6.1.tar.gz

Code Quality:
- Black formatting applied to empathy_llm_toolkit/providers.py
- Ruff auto-fixes applied to 17 wizard files
- Import sorting fixed with isort on 7 wizard files
- All packages validated with twine check

Next Steps:
- Fix syntax errors in bug_prediction.py and debugging_assistant.py
- Address remaining linting warnings for future release

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

Co-Authored-By: Claude <[email protected]>

Author: GeneAI

MANIFEST.in

@@ -39,3 +39,7 @@ global-exclude .git*
 global-exclude .env
 global-exclude .vscode
 global-exclude .idea
+
+# Temporarily exclude examples with syntax errors (to be fixed)
+exclude examples/bug_prediction.py
+exclude examples/debugging_assistant.py

README.md

@@ -3,30 +3,30 @@
 **A five-level maturity model for AI-human collaboration**
 
 [![License](https://img.shields.io/badge/License-Fair%20Source%200.9-blue.svg)](LICENSE)
-[![PyPI version](https://img.shields.io/pypi/v/empathy.svg)](https://pypi.org/project/empathy/)
-[![Python 3.10+](https://img.shields.io/pypi/pyversions/empathy.svg)](https://www.python.org/downloads/)
+[![PyPI version](https://img.shields.io/pypi/v/empathy-framework.svg)](https://pypi.org/project/empathy-framework/)
+[![Python 3.10+](https://img.shields.io/pypi/pyversions/empathy-framework.svg)](https://www.python.org/downloads/)
 [![Tests](https://github.com/Smart-AI-Memory/empathy/actions/workflows/tests.yml/badge.svg)](https://github.com/Smart-AI-Memory/empathy/actions/workflows/tests.yml)
 [![codecov](https://codecov.io/gh/Smart-AI-Memory/empathy/branch/main/graph/badge.svg)](https://codecov.io/gh/Smart-AI-Memory/empathy)
 [![OpenSSF Scorecard](https://api.securityscorecards.dev/projects/github.com/Smart-AI-Memory/empathy/badge)](https://securityscorecards.dev/viewer/?uri=github.com/Smart-AI-Memory/empathy)
 [![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
 [![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
-[![Downloads](https://img.shields.io/pypi/dm/empathy.svg)](https://pypi.org/project/empathy/)
+[![Downloads](https://img.shields.io/pypi/dm/empathy-framework.svg)](https://pypi.org/project/empathy-framework/)
 
 ---
 
 ## Quick Start
 
 ```bash
 # Install core framework
-pip install empathy
+pip install empathy-framework
 
 # Install with Claude Code + MemDocs transformative stack (recommended)
-pip install empathy[full]
+pip install empathy-framework[full]
 
 # Or install specific components:
-pip install empathy[llm]      # LLM providers (Anthropic, OpenAI)
-pip install empathy[memdocs]  # MemDocs integration
-pip install empathy[all]      # Everything including dev tools
+pip install empathy-framework[llm]      # LLM providers (Anthropic, OpenAI)
+pip install empathy-framework[memdocs]  # MemDocs integration
+pip install empathy-framework[all]      # Everything including dev tools
 ```
 
 **Development installation:**

empathy_llm_toolkit/providers.py

@@ -109,7 +109,9 @@ def __init__(
 
             self.client = anthropic.Anthropic(api_key=api_key)
         except ImportError as e:
-            raise ImportError("anthropic package required. Install with: pip install anthropic") from e
+            raise ImportError(
+                "anthropic package required. Install with: pip install anthropic"
+            ) from e
 
     async def generate(
         self,

examples/bug_prediction.py

@@ -16,14 +16,15 @@
 Licensed under the Apache License, Version 2.0
 """
 
-from typing import Dict, List, Any
+from typing import Any, Dict, List
+
 from empathy_os import (
     EmpathyOS,
+    FeedbackLoopDetector,
     Level4Anticipatory,
     LeveragePointAnalyzer,
-    PatternLibrary,
     Pattern,
-    FeedbackLoopDetector
+    PatternLibrary,
 )
 
 
@@ -413,19 +414,19 @@ def main():
         print("Bug Prediction - Level 4 Anticipatory Empathy")
         print("=" * 70)
 
-    # Initialize predictor
-    predictor = BugPredictor(team_id="team_backend")
+        # Initialize predictor
+        predictor = BugPredictor(team_id="team_backend")
 
-    print(f"\n✓ Bug predictor initialized for team: team_backend")
-    print(f"  Empathy Level: {predictor.empathy.target_level} (Anticipatory)")
-    print(f"  Anti-patterns loaded: {len(predictor.pattern_library.patterns)}")
+        print(f"\n✓ Bug predictor initialized for team: team_backend")
+        print(f"  Empathy Level: {predictor.empathy.target_level} (Anticipatory)")
+        print(f"  Anti-patterns loaded: {len(predictor.pattern_library.patterns)}")
 
-    # ========================================
-    # Scenario: Analyze codebase trajectory
-    # ========================================
-    print("\n" + "=" * 70)
-    print("Analyzing Codebase Trajectory")
-    print("=" * 70)
+        # ========================================
+        # Scenario: Analyze codebase trajectory
+        # ========================================
+        print("\n" + "=" * 70)
+        print("Analyzing Codebase Trajectory")
+        print("=" * 70)
 
     # Current state
     current_metrics = {

examples/debugging_assistant.py

@@ -14,15 +14,15 @@
 Licensed under the Apache License, Version 2.0
 """
 
-from typing import Dict, List, Any
+from typing import Any, Dict, List
 
 from empathy_os import (
     EmpathyOS,
+    FeedbackLoopDetector,
     Level3Proactive,
-    PatternLibrary,
     Pattern,
+    PatternLibrary,
     TrustBuildingBehaviors,
-    FeedbackLoopDetector
 )
 
 
@@ -357,8 +357,8 @@ def main():
         print("Debugging Assistant - Level 3 Proactive Empathy")
         print("=" * 70)
 
-    # Initialize assistant
-    assistant = DebuggingAssistant(developer_id="dev_alice")
+        # Initialize assistant
+        assistant = DebuggingAssistant(developer_id="dev_alice")
 
     print(f"\n✓ Debugging assistant initialized for developer: dev_alice")
     print(f"  Empathy Level: {assistant.empathy.target_level} (Proactive)")

pyproject.toml

@@ -3,7 +3,7 @@ requires = ["setuptools>=68.0", "wheel"]
 build-backend = "setuptools.build_meta"
 
 [project]
-name = "empathy"
+name = "empathy-framework"
 version = "1.6.1"
 description = "A five-level maturity model for AI-human collaboration with anticipatory empathy"
 readme = {file = "README.md", content-type = "text/markdown"}

wizards/__init__.py

@@ -6,70 +6,77 @@
 # Wizard router imports following Conditional Imports Pattern
 try:
     from .sbar_wizard import router as sbar_wizard_router
+
     _has_sbar_wizard = True
 except ImportError:
     _has_sbar_wizard = False
     sbar_wizard_router = None
 
 try:
     from .treatment_plan_wizard import router as treatment_plan_router
+
     _has_treatment_plan = True
 except ImportError:
     _has_treatment_plan = False
     treatment_plan_router = None
 
 try:
     from .dosage_calculation import router as dosage_calculation_router
+
     _has_dosage_calculation = True
 except ImportError:
     _has_dosage_calculation = False
     dosage_calculation_router = None
 
 try:
     from .clinical_assessment import router as clinical_assessment_router
+
     _has_clinical_assessment = True
 except ImportError:
     _has_clinical_assessment = False
     clinical_assessment_router = None
 
 try:
     from .patient_education import router as patient_education_router
+
     _has_patient_education = True
 except ImportError:
     _has_patient_education = False
     patient_education_router = None
 
 try:
     from .quality_improvement import router as quality_improvement_router
+
     _has_quality_improvement = True
 except ImportError:
     _has_quality_improvement = False
     quality_improvement_router = None
 
 # Export available wizards
 __all__ = [
-    'sbar_wizard_router',
-    'treatment_plan_router',
-    'dosage_calculation_router',
-    'clinical_assessment_router',
-    'patient_education_router',
-    'quality_improvement_router'
+    "sbar_wizard_router",
+    "treatment_plan_router",
+    "dosage_calculation_router",
+    "clinical_assessment_router",
+    "patient_education_router",
+    "quality_improvement_router",
 ]
 
+
 def get_available_wizards():
     """Get list of available wizard routers."""
     available = {}
     if _has_sbar_wizard and sbar_wizard_router:
-        available['sbar'] = sbar_wizard_router
+        available["sbar"] = sbar_wizard_router
     if _has_treatment_plan and treatment_plan_router:
-        available['treatment_plan'] = treatment_plan_router
+        available["treatment_plan"] = treatment_plan_router
     if _has_dosage_calculation and dosage_calculation_router:
-        available['dosage_calculation'] = dosage_calculation_router
+        available["dosage_calculation"] = dosage_calculation_router
     if _has_clinical_assessment and clinical_assessment_router:
-        available['clinical_assessment'] = clinical_assessment_router
+        available["clinical_assessment"] = clinical_assessment_router
     if _has_patient_education and patient_education_router:
-        available['patient_education'] = patient_education_router
+        available["patient_education"] = patient_education_router
     if _has_quality_improvement and quality_improvement_router:
-        available['quality_improvement'] = quality_improvement_router
+        available["quality_improvement"] = quality_improvement_router
 
-    return available
+    return available

wizards/admission_assessment_wizard.py

@@ -8,11 +8,10 @@
 
 import logging
 from datetime import datetime
-from typing import Any, Dict, Optional
+from typing import Any
 from uuid import uuid4
 
 from fastapi import APIRouter, HTTPException, status
-
 from src.services import get_service
 from src.utils.api_responses import create_success_response
 from src.utils.config import get_settings
@@ -57,7 +56,7 @@ async def translate_text(
 except ImportError:
     _has_redis = False
 
-_wizard_sessions: Dict[str, Dict[str, Any]] = {}
+_wizard_sessions: dict[str, dict[str, Any]] = {}
 
 
 # Admission assessment wizard steps
@@ -160,19 +159,15 @@ async def translate_text(
 """
 
 
-async def _store_wizard_session(wizard_id: str, session_data: Dict[str, Any]) -> bool:
+async def _store_wizard_session(wizard_id: str, session_data: dict[str, Any]) -> bool:
     """Store wizard session in Redis (preferred) or memory (fallback)"""
     try:
         if _has_redis:
             redis_client = await get_redis_client()
             if redis_client:
                 cache_key = f"wizard:admission_assessment:{wizard_id}"
-                await redis_client.setex(
-                    cache_key, 7200, str(session_data)  # 2 hour TTL
-                )
-                logger.info(
-                    f"Stored admission assessment wizard session {wizard_id} in Redis"
-                )
+                await redis_client.setex(cache_key, 7200, str(session_data))  # 2 hour TTL
+                logger.info(f"Stored admission assessment wizard session {wizard_id} in Redis")
                 return True
     except Exception as e:
         logger.warning(f"Failed to store session in Redis: {e}, using memory fallback")
@@ -183,7 +178,7 @@ async def _store_wizard_session(wizard_id: str, session_data: Dict[str, Any]) ->
     return True
 
 
-async def _get_wizard_session(wizard_id: str) -> Optional[Dict[str, Any]]:
+async def _get_wizard_session(wizard_id: str) -> dict[str, Any] | None:
     """Retrieve wizard session from Redis (preferred) or memory (fallback)"""
     try:
         if _has_redis:
@@ -202,7 +197,7 @@ async def _get_wizard_session(wizard_id: str) -> Optional[Dict[str, Any]]:
     return _wizard_sessions.get(wizard_id)
 
 
-def _get_step_data(step: int) -> Dict[str, Any]:
+def _get_step_data(step: int) -> dict[str, Any]:
     """Get step configuration data"""
     if step not in ADMISSION_ASSESSMENT_STEPS:
         raise HTTPException(
@@ -220,9 +215,7 @@ def _get_step_data(step: int) -> Dict[str, Any]:
     }
 
 
-def _generate_admission_assessment_report(
-    collected_data: Dict[str, Any]
-) -> Dict[str, Any]:
+def _generate_admission_assessment_report(collected_data: dict[str, Any]) -> dict[str, Any]:
     """Generate final admission assessment report from collected data"""
 
     # Generate formatted narrative
@@ -347,7 +340,7 @@ async def start_admission_assessment_wizard():
 
 
 @router.post("/{wizard_id}/step", summary="Submit admission assessment wizard step")
-async def submit_admission_assessment_step(wizard_id: str, step_data: Dict[str, Any]):
+async def submit_admission_assessment_step(wizard_id: str, step_data: dict[str, Any]):
     """
     Submit data for current step and advance to next step.
 
@@ -438,10 +431,8 @@ async def submit_admission_assessment_step(wizard_id: str, step_data: Dict[str,
         )
 
 
-@router.post(
-    "/{wizard_id}/enhance", summary="Enhance admission assessment text with AI"
-)
-async def enhance_admission_assessment_text(wizard_id: str, text_data: Dict[str, Any]):
+@router.post("/{wizard_id}/enhance", summary="Enhance admission assessment text with AI")
+async def enhance_admission_assessment_text(wizard_id: str, text_data: dict[str, Any]):
     """
     Enhance user-provided text with AI to improve clinical documentation quality.
 
@@ -501,9 +492,7 @@ async def enhance_admission_assessment_text(wizard_id: str, text_data: Dict[str,
             "field": field_name,
         }
 
-        return create_success_response(
-            data=response_data, message="Text enhanced successfully"
-        )
+        return create_success_response(data=response_data, message="Text enhanced successfully")
 
     except HTTPException:
         raise