chore: Release v5.0.1 - Add approval gates demo example

Added:
- Interactive approval gates demo script (examples/test_approval_gates.py)
- Demonstrates Pattern 5: Approval Gates workflow
- Shows approve/reject flow with dashboard interaction

Version: 5.0.0 → 5.0.1
CHANGELOG: Updated with v5.0.1 release notes

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

Author: silversurfer562

CHANGELOG.md

@@ -7,6 +7,19 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [5.0.1] - 2026-01-28
+
+### Added
+- **Interactive Approval Gates Demo** (`examples/test_approval_gates.py`)
+  - Demonstrates Pattern 5: Approval Gates workflow
+  - Creates test approval requests for dashboard interaction
+  - Shows approve/reject flow with timeout handling
+  - Useful for testing and understanding approval gates
+
+### Documentation
+- Added example script for approval gates testing
+- Helps users understand human-in-the-loop workflows
+
 ## [5.0.0] - 2026-01-27
 
 ### 🚨 Breaking Changes

examples/test_approval_gates.py

@@ -0,0 +1,121 @@
+#!/usr/bin/env python3
+"""Test Approval Gates - Interactive Demo
+
+This script creates approval requests and waits for you to approve/reject them
+via the dashboard UI at http://localhost:8000
+
+Usage:
+    python scripts/test_approval_gates.py
+"""
+import time
+from datetime import datetime
+
+from empathy_os.telemetry import ApprovalGate
+
+
+def create_test_approvals():
+    """Create several test approval requests for demonstration."""
+    gate = ApprovalGate(agent_id="demo-workflow")
+
+    print("=" * 60)
+    print("🚦 APPROVAL GATES DEMO")
+    print("=" * 60)
+    print("\nThis demo will create 3 approval requests.")
+    print("Open the dashboard at: http://localhost:8000")
+    print("\nYou can approve or reject each request in the dashboard UI.")
+    print("=" * 60)
+
+    # Approval 1: Deploy to Production
+    print("\n📋 Request 1: Deploy to Production")
+    print("   Creating approval request...")
+
+    response = gate.request_approval(
+        approval_type="deploy_to_production",
+        context={
+            "version": "5.0.0",
+            "changes": 60,
+            "risk": "medium",
+            "timestamp": datetime.utcnow().isoformat(),
+        },
+        timeout=60.0,  # Wait 60 seconds
+    )
+
+    print(f"   ✅ Response received!")
+    print(f"   Approved: {response.approved}")
+    print(f"   Responder: {response.responder}")
+    print(f"   Reason: {response.reason}")
+
+    if not response.approved:
+        print("\n❌ Deployment blocked by human review")
+        return
+
+    # Approval 2: Delete Resources
+    print("\n📋 Request 2: Delete Resources")
+    print("   Creating approval request...")
+
+    response = gate.request_approval(
+        approval_type="delete_resources",
+        context={
+            "resource_type": "database_records",
+            "count": 1000,
+            "impact": "high",
+        },
+        timeout=60.0,
+    )
+
+    print(f"   ✅ Response received!")
+    print(f"   Approved: {response.approved}")
+    print(f"   Responder: {response.responder}")
+    print(f"   Reason: {response.reason}")
+
+    # Approval 3: Refactor Code
+    print("\n📋 Request 3: Refactor Code")
+    print("   Creating approval request...")
+
+    response = gate.request_approval(
+        approval_type="refactor_code",
+        context={
+            "files": 50,
+            "lines_changed": 5000,
+            "risk": "low",
+        },
+        timeout=60.0,
+    )
+
+    print(f"   ✅ Response received!")
+    print(f"   Approved: {response.approved}")
+    print(f"   Responder: {response.responder}")
+    print(f"   Reason: {response.reason}")
+
+    print("\n" + "=" * 60)
+    print("✅ DEMO COMPLETE")
+    print("=" * 60)
+
+
+def create_background_approval():
+    """Create a single approval request that stays pending."""
+    gate = ApprovalGate(agent_id="background-agent")
+
+    print("\n🔄 Creating a persistent approval request...")
+    print("This will stay in your dashboard until you approve/reject it.")
+
+    gate.request_approval(
+        approval_type="run_expensive_operation",
+        context={
+            "operation": "Train ML model",
+            "estimated_cost": "$50",
+            "estimated_time": "2 hours",
+        },
+        timeout=600.0,  # 10 minutes
+    )
+
+
+if __name__ == "__main__":
+    import sys
+
+    if len(sys.argv) > 1 and sys.argv[1] == "--background":
+        # Create one that stays pending
+        create_background_approval()
+    else:
+        # Interactive demo
+        create_test_approvals()

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "empathy-framework"
-version = "5.0.0"
+version = "5.0.1"
 description = "AI collaboration framework with real LLM agent execution, AskUserQuestion tool integration, Socratic agent generation, progressive tier escalation (70-85% cost savings), meta-orchestration, dynamic agent composition (6 patterns), intelligent caching (85% hit rate), semantic workflow discovery, visual workflow editor, MCP integration for Claude Code, and multi-agent orchestration."
 readme = {file = "README.md", content-type = "text/markdown"}
 requires-python = ">=3.10"

src/empathy_os/__init__.py

@@ -55,7 +55,7 @@
 Licensed under Fair Source 0.9
 """
 
-__version__ = "5.0.0"
+__version__ = "5.0.1"
 __author__ = "Patrick Roebuck"
 __email__ = "patrick.roebuck@smartaimemory.com"