chore: Release v3.2.0

## Highlights
- Unified Typer CLI consolidating 5 entry points
- Dev Container for one-click development
- CI/CD enhancements (Python 3.13, mypy, Codecov, Dependabot)
- Documentation restructured with Diátaxis framework
- Async pattern detection for Level 3 interactions

## Changes
- 2968 tests passing, 57.84% coverage
- Package verified with twine

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

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

Author: 2 people

CHANGELOG.md

@@ -5,6 +5,70 @@ All notable changes to the Empathy Framework 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).
 
+## [3.2.0] - 2025-12-24
+
+### Added
+
+**Unified Typer CLI**
+- New `empathy` command consolidating 5 entry points into one
+- Beautiful Rich output with colored panels and tables
+- Subcommand groups: `memory`, `provider`, `workflow`, `wizard`
+- Cheatsheet command: `empathy cheatsheet`
+- Backward-compatible legacy entry points preserved
+
+**Dev Container Support**
+- One-click development environment with VS Code
+- Docker Compose setup with Python 3.11 + Redis 7
+- Pre-configured VS Code extensions (Python, Ruff, Black, MyPy, Pylance)
+- Automatic dependency installation on container creation
+
+**CI/CD Enhancements**
+- Python 3.13 added to test matrix (now 3.10-3.13 × 3 OS = 12 jobs)
+- MyPy type checking in lint workflow (non-blocking)
+- Codecov coverage upload for test tracking
+- Documentation workflow for MkDocs build and deploy
+- PR labeler for automatic label assignment
+- Dependabot for automated dependency updates (pip, actions, docker)
+
+**Async Pattern Detection**
+- Background pattern detection for Level 3 proactive interactions
+- Non-blocking pattern analysis during conversations
+- Sequential, preference, and conditional pattern types
+
+**Workflow Tests**
+- PR Review workflow tests (32 tests)
+- Dependency Check workflow tests (29 tests)
+- Security Audit workflow tests
+- Base workflow tests
+
+### Changed
+
+**Documentation Restructured with Diátaxis**
+- Tutorials: Learning-oriented guides (installation, quickstart, examples)
+- How-to: Task-oriented guides (memory, agents, integration)
+- Explanation: Understanding-oriented content (philosophy, concepts)
+- Reference: Information-oriented docs (API, CLI, glossary)
+- Internal docs moved to `docs/internal/`
+
+**Core Dependencies**
+- Added `rich>=13.0.0` for beautiful CLI output
+- Added `typer>=0.9.0` for modern CLI commands
+- Ruff auto-fix enabled (`fix = true`)
+
+**Project Structure**
+- Root directory cleaned up (36 → 7 markdown files)
+- Planning docs moved to `docs/development-logs/`
+- Architecture docs organized in `docs/architecture/`
+- Marketing materials in `docs/marketing/`
+
+### Fixed
+
+- Fixed broken internal documentation links after Diátaxis reorganization
+- Lint fixes for unused variables in test files
+- Black formatting for workflow tests
+
+---
+
 ## [3.1.0] - 2025-12-23
 
 ### Added

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "empathy-framework"
-version = "3.1.0"
+version = "3.2.0"
 description = "AI collaboration framework with persistent memory, anticipatory intelligence, code inspection, and multi-agent orchestration"
 readme = {file = "README.md", content-type = "text/markdown"}
 requires-python = ">=3.10"

tests/test_code_review_workflow.py

@@ -116,7 +116,7 @@ async def test_run_stage_classify(self):
         with patch.object(workflow, "_classify", new_callable=AsyncMock) as mock:
             mock.return_value = ({"change_type": "feature"}, 100, 50)
 
-            result = await workflow.run_stage("classify", ModelTier.CHEAP, {"diff": "..."})
+            await workflow.run_stage("classify", ModelTier.CHEAP, {"diff": "..."})
 
             mock.assert_called_once()
 
@@ -128,7 +128,7 @@ async def test_run_stage_scan(self):
         with patch.object(workflow, "_scan", new_callable=AsyncMock) as mock:
             mock.return_value = ({"security_issues": []}, 200, 100)
 
-            result = await workflow.run_stage("scan", ModelTier.CAPABLE, {"diff": "..."})
+            await workflow.run_stage("scan", ModelTier.CAPABLE, {"diff": "..."})
 
             mock.assert_called_once()
 
@@ -140,9 +140,7 @@ async def test_run_stage_architect_review(self):
         with patch.object(workflow, "_architect_review", new_callable=AsyncMock) as mock:
             mock.return_value = ({"recommendations": []}, 300, 200)
 
-            result = await workflow.run_stage(
-                "architect_review", ModelTier.PREMIUM, {"diff": "..."}
-            )
+            await workflow.run_stage("architect_review", ModelTier.PREMIUM, {"diff": "..."})
 
             mock.assert_called_once()
 
@@ -154,9 +152,7 @@ async def test_run_stage_crew_review(self):
         with patch.object(workflow, "_crew_review", new_callable=AsyncMock) as mock:
             mock.return_value = ({"crew_analysis": {}}, 500, 300)
 
-            result = await workflow.run_stage(
-                "crew_review", ModelTier.PREMIUM, {"diff": "..."}
-            )
+            await workflow.run_stage("crew_review", ModelTier.PREMIUM, {"diff": "..."})
 
             mock.assert_called_once()
 

tests/test_health_check_workflow.py

@@ -7,7 +7,6 @@
 import json
 import os
 import tempfile
-from datetime import datetime
 from unittest.mock import AsyncMock, MagicMock, patch
 
 import pytest
@@ -267,7 +266,7 @@ async def test_run_stage_fix(self):
 
             from src.empathy_os.workflows.base import ModelTier
 
-            result = await workflow.run_stage("fix", ModelTier.CAPABLE, {"path": "."})
+            await workflow.run_stage("fix", ModelTier.CAPABLE, {"path": "."})
 
             mock_fix.assert_called_once()
 

tests/test_security_audit_workflow.py

@@ -6,7 +6,6 @@
 """
 
 import json
-import os
 import tempfile
 from pathlib import Path
 from unittest.mock import AsyncMock, MagicMock, patch
@@ -42,7 +41,7 @@ def test_pattern_structure(self):
     def test_severity_values(self):
         """Test that severities are valid values."""
         valid_severities = {"critical", "high", "medium", "low"}
-        for vuln_type, info in SECURITY_PATTERNS.items():
+        for _vuln_type, info in SECURITY_PATTERNS.items():
             assert info["severity"] in valid_severities
 
 
@@ -203,7 +202,7 @@ async def test_run_stage_triage(self):
         with patch.object(workflow, "_triage", new_callable=AsyncMock) as mock:
             mock.return_value = ({"findings": []}, 100, 50)
 
-            result = await workflow.run_stage("triage", ModelTier.CHEAP, {"path": "."})
+            await workflow.run_stage("triage", ModelTier.CHEAP, {"path": "."})
 
             mock.assert_called_once()
 
@@ -215,9 +214,7 @@ async def test_run_stage_analyze(self):
         with patch.object(workflow, "_analyze", new_callable=AsyncMock) as mock:
             mock.return_value = ({"analysis": {}}, 200, 100)
 
-            result = await workflow.run_stage(
-                "analyze", ModelTier.CAPABLE, {"findings": []}
-            )
+            await workflow.run_stage("analyze", ModelTier.CAPABLE, {"findings": []})
 
             mock.assert_called_once()
 
@@ -229,7 +226,7 @@ async def test_run_stage_assess(self):
         with patch.object(workflow, "_assess", new_callable=AsyncMock) as mock:
             mock.return_value = ({"risk_score": 0}, 150, 75)
 
-            result = await workflow.run_stage("assess", ModelTier.CAPABLE, {})
+            await workflow.run_stage("assess", ModelTier.CAPABLE, {})
 
             mock.assert_called_once()
 
@@ -241,7 +238,7 @@ async def test_run_stage_remediate(self):
         with patch.object(workflow, "_remediate", new_callable=AsyncMock) as mock:
             mock.return_value = ({"remediation_plan": []}, 300, 200)
 
-            result = await workflow.run_stage("remediate", ModelTier.PREMIUM, {})
+            await workflow.run_stage("remediate", ModelTier.PREMIUM, {})
 
             mock.assert_called_once()
 
@@ -348,7 +345,7 @@ async def test_triage_skips_node_modules(self):
         with tempfile.TemporaryDirectory() as tmpdir:
             node_dir = Path(tmpdir) / "node_modules"
             node_dir.mkdir()
-            (node_dir / "lib.js").write_text('eval(user_input)')
+            (node_dir / "lib.js").write_text("eval(user_input)")
 
             workflow = SecurityAuditWorkflow()
 
@@ -463,9 +460,7 @@ def get_user(user_id: int) -> Optional[dict]:
             )
 
             # Clean code should have minimal findings
-            critical_findings = [
-                f for f in result["findings"] if f["severity"] == "critical"
-            ]
+            critical_findings = [f for f in result["findings"] if f["severity"] == "critical"]
             assert len(critical_findings) == 0
 
     @pytest.mark.asyncio

tests/test_workflow_base.py

@@ -6,9 +6,6 @@
 
 from dataclasses import asdict
 from datetime import datetime
-from unittest.mock import AsyncMock, MagicMock, patch
-
-import pytest
 
 from src.empathy_os.workflows.base import (
     PROVIDER_MODELS,
@@ -104,8 +101,8 @@ def test_hybrid_models_exist(self):
 
     def test_model_names_are_strings(self):
         """Test all model names are strings."""
-        for provider, models in PROVIDER_MODELS.items():
-            for tier, model_name in models.items():
+        for _provider, models in PROVIDER_MODELS.items():
+            for _tier, model_name in models.items():
                 assert isinstance(model_name, str)
                 assert len(model_name) > 0