# Changelog

All notable changes to FusionAGI will be documented in this file.

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## [Unreleased]

### Added

- Documentation review and updates: README project layout aligned with codebase (api, maa, multi_agent, config, prompts, skills, telemetry, verification, world_model); architecture.md AGI stack and agent framework updated with module paths; interfaces.md and ui_ux_implementation.md corrected imports and optional AdminControlPanel params; multi_agent_acceleration.md fixed imports (PooledExecutorRouter, AgentPool, SupervisorAgent from fusionagi.multi_agent); maa_activation.md clarified MAA is built-in; README Development section expanded with documentation index.
- Visual elements across docs: README (system-at-a-glance flowchart, task lifecycle sequence, Dvādaśa heads diagram); docs/architecture.md (component overview, data flow, self-improvement flow); docs/README.md (new documentation map with Mermaid); docs/openai_bridge.md (request flow sequence); docs/multi_agent_acceleration.md (architecture overview); docs/maa_activation.md (activation flow); docs/maa_compliance_mapping.md (standards ↔ MAA diagram); docs/interfaces.md and docs/interface_architecture_diagram.md (Mermaid overview); docs/ui_ux_implementation.md (interface layer diagram); docs/api_middleware_interface_spec.md (request flow sequence). All diagrams use Mermaid for GitHub/GitLab rendering.

- EventBus optional event history: `EventBus(history_size=N)` and `get_recent_events(limit)`.
- PolicyEngine: `get_rules()`, `get_rule(rule_id)`, `update_rule(rule_id, updates)`, `remove_rule(rule_id)`.
- AdminControlPanel: `session_count_callback` for active session count; health checks in `get_system_status()`; `get_recent_events()` delegates to EventBus when history is enabled.
- Voice: `TTSAdapter` and `STTAdapter` protocols; VoiceInterface optional `tts_adapter` and `stt_adapter` for provider integration.
- MultiModalUI: `active_session_count()`; `asyncio.Lock` for receive path to avoid race conditions; optional `llm_process_callback(session_id, user_input, context, style)` for converse().
- Orchestrator: `shutdown(wait=True)` for ThreadPoolExecutor cleanup.
- Shared time utilities: `fusionagi._time.utc_now()` and `utc_now_iso()` (timezone-aware; replaces deprecated `datetime.utcnow()`).
- Single source for task state transitions: `VALID_TASK_TRANSITIONS` in schemas; orchestrator re-exports as `VALID_STATE_TRANSITIONS`.
- Guardrails: copy of `args` at start of `pre_check()` to avoid mutating caller.
- StateManager: docstring for `list_tasks()` when backend is used.
- FusionAGILoop: protocols (`StateManagerLike`, `OrchestratorLike`, `CriticLike`, `ReflectiveMemoryLike`) instead of `Any`.
- Version from package metadata (single source) with fallback.
- Smoke tests for README public API imports (`tests/test_readme_imports.py`).
- Pyproject: Python 3.13 classifier; tighter optional deps (openai>=1.12, anthropic>=0.39, litellm>=1.40, pytest>=7.4); dev extras: mypy, ruff.
- Tooling: `[tool.mypy]` and `[tool.ruff]` in pyproject.toml.

### Changed

- README usage example: `register_agent("planner", planner_agent)` and PlannerAgent import.
- AdminControlPanel and MultiModalUI exported from `fusionagi.interfaces`.
- All `datetime.utcnow()` usages replaced with `fusionagi._time` helpers.

### Fixed

- Interfaces import: `from fusionagi.interfaces import AdminControlPanel, MultiModalUI` now works.

## [0.1.0] - Initial release

- Core: Orchestrator, EventBus, StateManager, GoalManager, Scheduler, BlockersAndCheckpoints.
- Agents: Planner, Reasoner, Executor, Critic, AdversarialReviewer.
- Schemas: Task, Message, Plan, Recommendation, Goal, Policy, Audit, etc.
- Self-improvement: SelfCorrectionLoop, AutoRecommender, AutoTrainer, FusionAGILoop.
- Memory: Working, Episodic, Reflective, Semantic, Procedural, Trust, Consolidation.
- Governance: Guardrails, RateLimiter, AccessControl, OverrideHooks, PolicyEngine, AuditLog.
- Interfaces: AdminControlPanel, MultiModalUI, VoiceInterface, ConversationManager.
- MAA: Manufacturing Authority Add-On layers and tools.
- Tools: Registry, safe runner, builtins, connectors.