v3.0.0
Breaking Changes
- Minimum Python 3.11: dropped Python 3.10 support. Requires 3.11+ for
ExceptionGroupandTaskGroup. - Enterprise classes moved:
TenantRouter,Policy,Violation,AuditLogger,AuditEntrymoved fromdirector_ai/director_ai.coretodirector_ai.enterprise. Importing from the old location raisesImportErrorwith migration hint. - Removed deprecated 1.x aliases:
calculate_factual_entropy,calculate_logical_entropy,simulate_future_state,review_action(onCoherenceScorer),process_query(onCoherenceAgent),process_batch_async(onBatchProcessor). Use current names:calculate_factual_divergence,calculate_logical_divergence,compute_divergence,review,process,process_batch. - Slimmed root
__all__: internal classes (ScoreCache,ScorerBackend,ShardedNLIScorer, etc.) removed from__all__— still importable, no longer in public API surface.
Added
director_ai.enterprisepackage re-exporting all 5 enterprise classes.director-ai tuneadaptive threshold calibration (implemented in v2.8.0, now documented as stable).- Python 3.13 in CI matrix.
Migration
# Enterprise imports (before → after):
from director_ai.enterprise import TenantRouter # was: from director_ai import TenantRouter
# Deprecated methods (use current names):
scorer.calculate_factual_divergence(...) # was: calculate_factual_entropy
scorer.calculate_logical_divergence(...) # was: calculate_logical_entropy
scorer.compute_divergence(...) # was: simulate_future_state
scorer.review(...) # was: review_action
agent.process(...) # was: process_query
proc.process_batch(...) # was: process_batch_asyncFull changelog: https://github.com/anulum/director-ai/blob/main/CHANGELOG.md