attune-ai 2.1.1__tar.gz → 2.1.2__tar.gz

{attune_ai-2.1.1 → attune_ai-2.1.2}/CHANGELOG.md

@@ -7,6 +7,19 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [2.1.2] - 2026-02-02
+
+### Fixed
+
+- **PyPI packaging**: Re-release to include `.attune` branding fix (2.1.1 was built before the fix was merged)
+
+## [2.1.1] - 2026-02-02
+
+### Fixed
+
+- **vscode_bridge.py**: Updated `get_empathy_dir()` to use `.attune` directory (completes branding migration from `.empathy`)
+- **test_vscode_bridge_coverage_boost.py**: Aligned test expectations with `.attune` directory naming
+
 ## [2.1.0] - 2026-02-01
 
 ### Added

{attune_ai-2.1.1 → attune_ai-2.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: attune-ai
-Version: 2.1.1
+Version: 2.1.2
 Summary: 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 (10 patterns including Anthropic-inspired), intelligent caching (85% hit rate), semantic workflow discovery, visual workflow editor, MCP integration for Claude Code, and multi-agent orchestration.
 Author-email: Patrick Roebuck <admin@smartaimemory.com>
 Maintainer-email: Smart-AI-Memory <admin@smartaimemory.com>
@@ -421,16 +421,17 @@ Requires-Dist: aiohttp<4.0.0,>=3.10.0; extra == "all"
 Requires-Dist: filelock<4.0.0,>=3.16.0; extra == "all"
 Dynamic: license-file
 
-# attune-ai
+# Empathy Framework
 
-**AI-powered developer workflows with Socratic discovery.**
+**AI-powered developer workflows with cost optimization and pattern learning.**
 
-Run code review, debugging, testing, and release workflows from Claude Code. One command guides you to the right workflow.
+Run code review, debugging, testing, and release workflows from your terminal or Claude Code. Smart tier routing saves 34-86% on LLM costs.
 
 [![PyPI](https://img.shields.io/pypi/v/attune-ai?color=blue)](https://pypi.org/project/attune-ai/)
 [![Tests](https://img.shields.io/badge/tests-7%2C168%20passing%20(99.9%25)-brightgreen)](https://github.com/Smart-AI-Memory/attune-ai/actions)
 [![Python](https://img.shields.io/badge/python-3.10+-blue)](https://www.python.org)
 [![License](https://img.shields.io/badge/license-Apache%202.0-blue)](LICENSE)
+[![Performance](https://img.shields.io/badge/performance-18x%20faster-success)](https://github.com/Smart-AI-Memory/attune-ai/blob/main/CHANGELOG.md)
 
 ```bash
 pip install attune-ai[developer]
@@ -438,26 +439,188 @@ pip install attune-ai[developer]
 
 ---
 
-## What's New in v2.1.0
+## 🎯 Transitioning to Claude-Native Architecture
 
-**🎯 Unified `/attune` Command** - One entry point for all workflows:
+**Empathy Framework is evolving to focus exclusively on Anthropic/Claude** to unlock features impossible with multi-provider abstraction:
+
+- **📦 Prompt Caching:** 90% cost reduction on repeated prompts
+- **📖 Flexible Context:** 200K via subscription for most tasks, up to 1M via API for large codebases
+- **🧠 Extended Thinking:** See Claude's internal reasoning process
+- **🔧 Advanced Tool Use:** Optimized for agentic workflows
+
+**Timeline:**
+
+- ✅ **v4.8.0 (Jan 2026):** Deprecation warnings for OpenAI/Google/Ollama providers
+- ✅ **v5.0.0 (Jan 26, 2026):** Non-Anthropic providers removed (BREAKING - COMPLETE)
+- ✅ **v5.0.2 (Jan 28, 2026):** Cost optimization suite with batch processing and caching monitoring
+
+**Migration Guide:** [docs/CLAUDE_NATIVE.md](docs/CLAUDE_NATIVE.md)
+
+---
+
+## What's New in v5.3.0
+
+**🎨 Dashboard Enhancements** - Improved usability and clarity:
+
+- **Agent Display Names** - Human-readable labels for agents in dashboard (e.g., "Code Analyzer" instead of UUID)
+- **Comprehensive Help Panel** - 5-section accordion explaining dashboard features, use cases, and Redis setup
+- **UX Improvements** - "Source Agent:" label clarity, "Redis Requires Enabling" status message
+- **Browser Cache Busting** - Date-based versioning ensures updates appear immediately
+
+**📚 Documentation Improvements**:
+
+- Clarified flexible context strategy (200K subscription + 1M API routing)
+- Added Redis requirement documentation for dashboard
+- Root directory cleanup (8 archived files)
+
+**🧪 Test Infrastructure**:
+
+- Sequential test execution to fix import timing issues
+- All agent tracking tests passing (19/19)
+
+[See Full Changelog](CHANGELOG.md#530---2026-01-31)
+
+---
+
+## What's New in v5.1.0
+
+**🤖 Multi-Agent Orchestration** - Full support for custom agents and Anthropic LLM agents:
+
+- **Agent Coordination Dashboard** - Real-time monitoring with 6 coordination patterns:
+  - Agent heartbeats and status tracking
+  - Inter-agent coordination signals
+  - Event streaming across agent workflows
+  - Approval gates for human-in-the-loop
+  - Quality feedback and performance metrics
+  - Demo mode with test data generation
+
+- **Custom Agents** - Build specialized agents for your workflow needs
+- **LLM Agents from Anthropic** - Leverage Claude's advanced capabilities
+- Dashboard accessible at `http://localhost:8000` with `python examples/dashboard_demo.py` **(Requires Redis)**
+
+**🔐 Authentication Strategy System** - Intelligent routing between Claude subscriptions and Anthropic API:
 
 ```bash
-/attune                    # Start Socratic discovery
-/attune "fix a bug"        # Natural language
-/attune debug              # Direct shortcut
+# Interactive setup
+python -m attune.models.auth_cli setup
+
+# View current configuration
+python -m attune.models.auth_cli status
+
+# Get recommendation for a file
+python -m attune.models.auth_cli recommend src/module.py
 ```
 
-**Socratic Discovery** - Ask what you're trying to accomplish, not which tool to use:
+**💰 Automatic Cost Optimization** - Workflows choose the best auth method:
+
+- Small/medium modules (<2000 LOC) → Claude subscription (free)
+- Large modules (>2000 LOC) → Anthropic API (pay for what you need)
+- 7 workflows integrated: document-gen, test-gen, code-review, bug-predict, security-audit, perf-audit, release-prep
+- Auth mode tracking in all workflow outputs for telemetry
+
+**🧪 Comprehensive Testing** - 7 new integration tests for auth strategy:
+
+- All workflows tested with auth enabled/disabled
+- API and subscription mode verification
+- Cost tracking validation
+
+**📖 Documentation** - 950+ lines across 3 guides:
+
+- [AUTH_STRATEGY_GUIDE.md](docs/AUTH_STRATEGY_GUIDE.md) - User guide for configuration
+- [AUTH_CLI_IMPLEMENTATION.md](docs/AUTH_CLI_IMPLEMENTATION.md) - CLI command reference
+- [AUTH_WORKFLOW_INTEGRATIONS.md](docs/AUTH_WORKFLOW_INTEGRATIONS.md) - Integration patterns
+
+[See Full Changelog](CHANGELOG.md#510---2026-01-29)
+
+---
+
+## What's New in v5.0.2
+
+**💰 50% Cost Savings with Batch API** - Process non-urgent tasks asynchronously:
+
+```bash
+empathy batch submit batch_requests.json  # Submit batch job
+empathy batch status msgbatch_abc123      # Check progress
+empathy batch results msgbatch_abc123 output.json  # Download results
+```
+
+Perfect for: log analysis, report generation, bulk classification, test generation
+
+**📊 Precise Token Counting** - >98% accurate cost tracking:
+
+- Integrated Anthropic's `count_tokens()` API for billing-accurate measurements
+- 3-tier fallback: API → tiktoken (local) → heuristic
+- Cache-aware cost calculation (25% write markup, 90% read discount)
+
+**📈 Cache Performance Monitoring** - Track your 20-30% caching savings:
+
+```bash
+empathy cache stats           # Show hit rates and cost savings
+empathy cache stats --verbose # Detailed token metrics
+empathy cache stats --format json  # Machine-readable output
+```
+
+**🧭 Adaptive Routing Analytics** - Intelligent tier recommendations:
+
+```bash
+empathy routing stats <workflow>    # Performance metrics
+empathy routing check --all         # Tier upgrade recommendations
+empathy routing models --provider anthropic  # Compare models
+```
+
+**🔧 Dashboard Fixes** - All 6 agent coordination patterns now operational:
+- Agent heartbeats displaying correctly
+- Event streaming functional
+- Coordination signals working
+- Approval gates operational
+
+[See Full Changelog](CHANGELOG.md#502---2026-01-28) | [Batch API Guide](docs/BATCH_API_GUIDE.md) | [User API Docs](docs/USER_API_DOCUMENTATION.md)
+
+---
+
+## What's New in v4.9.0
+
+**⚡ 18x Faster Performance** - Massive performance gains through Phase 2 optimizations:
+
+- **Redis Two-Tier Caching:** 2x faster memory operations (37,000x for cached keys)
+- **Generator Expressions:** 99.9% memory reduction across 27 optimizations
+- **Parallel Scanning:** Multi-core processing enabled by default (2-4x faster)
+- **Incremental Scanning:** Git diff-based updates (10x faster)
+
+**🧭 Natural Language Workflows** - Use plain English instead of workflow names:
+
+```bash
+/workflows "find security vulnerabilities"  # → security-audit
+/workflows "check code performance"         # → perf-audit
+/workflows "predict bugs"                   # → bug-predict
+/plan "review my code"                      # → code-review
+```
+
+**📊 Real-World Performance:**
+
+- Combined workflow: 3.59s → 0.2s (**18x faster**)
+- Full scan: 3,472 files in 0.98s (was 3.59s)
+- Redis cached operations: 37ms → 0.001ms
+
+**🎯 Improved Navigation:**
+
+- Split `/workflow` into `/workflows` (automated analysis) and `/plan` (planning/review)
+- Clearer hub organization with better categorization
+- Natural language routing matches intent to workflow
+
+[See CHANGELOG.md](CHANGELOG.md) | [Performance Docs](docs/REDIS_OPTIMIZATION_SUMMARY.md)
+
+---
+
+## What's New in v4.7.0
+
+**$0 Workflows via Skills** - Multi-agent workflows run through Claude Code's Task tool instead of API calls. No additional cost with your Claude subscription.
 
-- 🔧 **Fix or improve** → Debug, review, refactor
-- ✅ **Validate work** → Tests, coverage, security audit
-- 🚀 **Ship changes** → Commit, PR, release
-- 📚 **Understand** → Explain code, generate docs
+**Socratic Workflows** - Interactive discovery through guided questions. Workflows ask what you need rather than requiring upfront configuration.
 
-**Performance Audit Improvements** - Removed false positive detection for intentional patterns like `dirs[:]` and defensive list copies.
+**Security Hardened** - Fixed critical vulnerabilities (path traversal, JWT, SSRF).
 
-[See Full Changelog](CHANGELOG.md)
+**Hub-Based Commands** - Organized workflows into intuitive command hubs.
 
 ---
 

{attune_ai-2.1.1 → attune_ai-2.1.2}/README.md

@@ -1,13 +1,14 @@
-# attune-ai
+# Empathy Framework
 
-**AI-powered developer workflows with Socratic discovery.**
+**AI-powered developer workflows with cost optimization and pattern learning.**
 
-Run code review, debugging, testing, and release workflows from Claude Code. One command guides you to the right workflow.
+Run code review, debugging, testing, and release workflows from your terminal or Claude Code. Smart tier routing saves 34-86% on LLM costs.
 
 [![PyPI](https://img.shields.io/pypi/v/attune-ai?color=blue)](https://pypi.org/project/attune-ai/)
 [![Tests](https://img.shields.io/badge/tests-7%2C168%20passing%20(99.9%25)-brightgreen)](https://github.com/Smart-AI-Memory/attune-ai/actions)
 [![Python](https://img.shields.io/badge/python-3.10+-blue)](https://www.python.org)
 [![License](https://img.shields.io/badge/license-Apache%202.0-blue)](LICENSE)
+[![Performance](https://img.shields.io/badge/performance-18x%20faster-success)](https://github.com/Smart-AI-Memory/attune-ai/blob/main/CHANGELOG.md)
 
 ```bash
 pip install attune-ai[developer]
@@ -15,26 +16,188 @@ pip install attune-ai[developer]
 
 ---
 
-## What's New in v2.1.0
+## 🎯 Transitioning to Claude-Native Architecture
 
-**🎯 Unified `/attune` Command** - One entry point for all workflows:
+**Empathy Framework is evolving to focus exclusively on Anthropic/Claude** to unlock features impossible with multi-provider abstraction:
+
+- **📦 Prompt Caching:** 90% cost reduction on repeated prompts
+- **📖 Flexible Context:** 200K via subscription for most tasks, up to 1M via API for large codebases
+- **🧠 Extended Thinking:** See Claude's internal reasoning process
+- **🔧 Advanced Tool Use:** Optimized for agentic workflows
+
+**Timeline:**
+
+- ✅ **v4.8.0 (Jan 2026):** Deprecation warnings for OpenAI/Google/Ollama providers
+- ✅ **v5.0.0 (Jan 26, 2026):** Non-Anthropic providers removed (BREAKING - COMPLETE)
+- ✅ **v5.0.2 (Jan 28, 2026):** Cost optimization suite with batch processing and caching monitoring
+
+**Migration Guide:** [docs/CLAUDE_NATIVE.md](docs/CLAUDE_NATIVE.md)
+
+---
+
+## What's New in v5.3.0
+
+**🎨 Dashboard Enhancements** - Improved usability and clarity:
+
+- **Agent Display Names** - Human-readable labels for agents in dashboard (e.g., "Code Analyzer" instead of UUID)
+- **Comprehensive Help Panel** - 5-section accordion explaining dashboard features, use cases, and Redis setup
+- **UX Improvements** - "Source Agent:" label clarity, "Redis Requires Enabling" status message
+- **Browser Cache Busting** - Date-based versioning ensures updates appear immediately
+
+**📚 Documentation Improvements**:
+
+- Clarified flexible context strategy (200K subscription + 1M API routing)
+- Added Redis requirement documentation for dashboard
+- Root directory cleanup (8 archived files)
+
+**🧪 Test Infrastructure**:
+
+- Sequential test execution to fix import timing issues
+- All agent tracking tests passing (19/19)
+
+[See Full Changelog](CHANGELOG.md#530---2026-01-31)
+
+---
+
+## What's New in v5.1.0
+
+**🤖 Multi-Agent Orchestration** - Full support for custom agents and Anthropic LLM agents:
+
+- **Agent Coordination Dashboard** - Real-time monitoring with 6 coordination patterns:
+  - Agent heartbeats and status tracking
+  - Inter-agent coordination signals
+  - Event streaming across agent workflows
+  - Approval gates for human-in-the-loop
+  - Quality feedback and performance metrics
+  - Demo mode with test data generation
+
+- **Custom Agents** - Build specialized agents for your workflow needs
+- **LLM Agents from Anthropic** - Leverage Claude's advanced capabilities
+- Dashboard accessible at `http://localhost:8000` with `python examples/dashboard_demo.py` **(Requires Redis)**
+
+**🔐 Authentication Strategy System** - Intelligent routing between Claude subscriptions and Anthropic API:
 
 ```bash
-/attune                    # Start Socratic discovery
-/attune "fix a bug"        # Natural language
-/attune debug              # Direct shortcut
+# Interactive setup
+python -m attune.models.auth_cli setup
+
+# View current configuration
+python -m attune.models.auth_cli status
+
+# Get recommendation for a file
+python -m attune.models.auth_cli recommend src/module.py
 ```
 
-**Socratic Discovery** - Ask what you're trying to accomplish, not which tool to use:
+**💰 Automatic Cost Optimization** - Workflows choose the best auth method:
+
+- Small/medium modules (<2000 LOC) → Claude subscription (free)
+- Large modules (>2000 LOC) → Anthropic API (pay for what you need)
+- 7 workflows integrated: document-gen, test-gen, code-review, bug-predict, security-audit, perf-audit, release-prep
+- Auth mode tracking in all workflow outputs for telemetry
+
+**🧪 Comprehensive Testing** - 7 new integration tests for auth strategy:
+
+- All workflows tested with auth enabled/disabled
+- API and subscription mode verification
+- Cost tracking validation
+
+**📖 Documentation** - 950+ lines across 3 guides:
+
+- [AUTH_STRATEGY_GUIDE.md](docs/AUTH_STRATEGY_GUIDE.md) - User guide for configuration
+- [AUTH_CLI_IMPLEMENTATION.md](docs/AUTH_CLI_IMPLEMENTATION.md) - CLI command reference
+- [AUTH_WORKFLOW_INTEGRATIONS.md](docs/AUTH_WORKFLOW_INTEGRATIONS.md) - Integration patterns
+
+[See Full Changelog](CHANGELOG.md#510---2026-01-29)
+
+---
+
+## What's New in v5.0.2
+
+**💰 50% Cost Savings with Batch API** - Process non-urgent tasks asynchronously:
+
+```bash
+empathy batch submit batch_requests.json  # Submit batch job
+empathy batch status msgbatch_abc123      # Check progress
+empathy batch results msgbatch_abc123 output.json  # Download results
+```
+
+Perfect for: log analysis, report generation, bulk classification, test generation
+
+**📊 Precise Token Counting** - >98% accurate cost tracking:
+
+- Integrated Anthropic's `count_tokens()` API for billing-accurate measurements
+- 3-tier fallback: API → tiktoken (local) → heuristic
+- Cache-aware cost calculation (25% write markup, 90% read discount)
+
+**📈 Cache Performance Monitoring** - Track your 20-30% caching savings:
+
+```bash
+empathy cache stats           # Show hit rates and cost savings
+empathy cache stats --verbose # Detailed token metrics
+empathy cache stats --format json  # Machine-readable output
+```
+
+**🧭 Adaptive Routing Analytics** - Intelligent tier recommendations:
+
+```bash
+empathy routing stats <workflow>    # Performance metrics
+empathy routing check --all         # Tier upgrade recommendations
+empathy routing models --provider anthropic  # Compare models
+```
+
+**🔧 Dashboard Fixes** - All 6 agent coordination patterns now operational:
+- Agent heartbeats displaying correctly
+- Event streaming functional
+- Coordination signals working
+- Approval gates operational
+
+[See Full Changelog](CHANGELOG.md#502---2026-01-28) | [Batch API Guide](docs/BATCH_API_GUIDE.md) | [User API Docs](docs/USER_API_DOCUMENTATION.md)
+
+---
+
+## What's New in v4.9.0
+
+**⚡ 18x Faster Performance** - Massive performance gains through Phase 2 optimizations:
+
+- **Redis Two-Tier Caching:** 2x faster memory operations (37,000x for cached keys)
+- **Generator Expressions:** 99.9% memory reduction across 27 optimizations
+- **Parallel Scanning:** Multi-core processing enabled by default (2-4x faster)
+- **Incremental Scanning:** Git diff-based updates (10x faster)
+
+**🧭 Natural Language Workflows** - Use plain English instead of workflow names:
+
+```bash
+/workflows "find security vulnerabilities"  # → security-audit
+/workflows "check code performance"         # → perf-audit
+/workflows "predict bugs"                   # → bug-predict
+/plan "review my code"                      # → code-review
+```
+
+**📊 Real-World Performance:**
+
+- Combined workflow: 3.59s → 0.2s (**18x faster**)
+- Full scan: 3,472 files in 0.98s (was 3.59s)
+- Redis cached operations: 37ms → 0.001ms
+
+**🎯 Improved Navigation:**
+
+- Split `/workflow` into `/workflows` (automated analysis) and `/plan` (planning/review)
+- Clearer hub organization with better categorization
+- Natural language routing matches intent to workflow
+
+[See CHANGELOG.md](CHANGELOG.md) | [Performance Docs](docs/REDIS_OPTIMIZATION_SUMMARY.md)
+
+---
+
+## What's New in v4.7.0
+
+**$0 Workflows via Skills** - Multi-agent workflows run through Claude Code's Task tool instead of API calls. No additional cost with your Claude subscription.
 
-- 🔧 **Fix or improve** → Debug, review, refactor
-- ✅ **Validate work** → Tests, coverage, security audit
-- 🚀 **Ship changes** → Commit, PR, release
-- 📚 **Understand** → Explain code, generate docs
+**Socratic Workflows** - Interactive discovery through guided questions. Workflows ask what you need rather than requiring upfront configuration.
 
-**Performance Audit Improvements** - Removed false positive detection for intentional patterns like `dirs[:]` and defensive list copies.
+**Security Hardened** - Fixed critical vulnerabilities (path traversal, JWT, SSRF).
 
-[See Full Changelog](CHANGELOG.md)
+**Hub-Based Commands** - Organized workflows into intuitive command hubs.
 
 ---