PyPI - attune-ai - Versions diffs - 2.0.2__tar.gz → 2.1.0__tar.gz - Mend

attune-ai 2.0.2tar.gz → 2.1.0tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (755) hide show

{attune_ai-2.0.2 → attune_ai-2.1.0}/CHANGELOG.md RENAMED Viewed

@@ -7,39 +7,21 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [Unreleased]
-## [2.0.2] - 2026-02-01
+## [2.1.0] - 2026-02-01
-### Removed
-- **README.md**: Removed outdated "Transitioning to Claude-Native Architecture" section
-  - Eliminated confusing timeline with old version numbers (v4.8.0, v5.0.0, v5.0.2)
-  - Package is already Claude-native, no need for transition messaging
-  - Cleaner, more focused README presentation
+### Added
-## [2.0.1] - 2026-02-01
+- **Unified `/attune` command**: Single entry point with Socratic discovery for all workflows
+- **Interactive workflow navigation**: Question-based flow guides users to the right tool
 ### Changed
-- **README.md**: Consolidated version history into single "What's New in v2.0.0" section
-  - Removed confusing legacy version sections (v5.3.0, v5.1.0, v5.0.2, v4.9.0, v4.7.0)
-  - Clean, focused presentation of Attune AI features
-  - Updated test badge to show 13,489 tests collected
-  - Clarified $0 workflows caveat for 1M API context requirement
-- **Website Branding**: Updated all references across 20+ pages
-  - "Empathy Framework" → "Attune AI"
-  - `empathy-framework` → `attune-ai` in all install commands
-  - GitHub URLs updated to `Smart-AI-Memory/attune-ai`
-- **Documentation**: Comprehensive branding updates
-  - 1,116+ references updated across all markdown files
-  - All package names and commands updated
-  - Consistent "Attune AI" branding throughout
+- **Consolidated command hubs**: Removed 9 separate hub commands in favor of unified `/attune`
+- **Performance audit**: Removed `large_list_copy` false positive detection
 ### Fixed
-- Markdown linting: Added proper blank lines around lists in README
-- Accurate description of cost model for workflows
+- **perf_audit.py**: No longer flags intentional patterns like `dirs[:]` for os.walk or defensive list copies
 ## [2.0.0] - 2026-02-01

{attune_ai-2.0.2 → attune_ai-2.1.0}/CONTRIBUTING.md RENAMED Viewed

@@ -1,6 +1,6 @@
-# Contributing to Empathy Framework
+# Contributing to Attune AI
-Thank you for your interest in contributing to the Empathy Framework! This document provides guidelines and best practices for contributing.
+Thank you for your interest in contributing to Attune AI! This document provides guidelines and best practices for contributing.
 ## Table of Contents
@@ -28,8 +28,8 @@ We are committed to providing a welcoming and inclusive environment. Please be r
 ```bash
 # Clone the repository
-git clone https://github.com/Deep-Study-AI/Empathy.git
-cd Empathy
+git clone https://github.com/Smart-AI-Memory/attune-ai.git
+cd attune-ai
 # Create virtual environment
 python3 -m venv venv
@@ -49,8 +49,7 @@ pytest tests/
 ### Branch Strategy
-- `main` - Stable releases
-- `develop` - Development branch
+- `main` - Stable releases (merge via pull request)
 - `feature/*` - New features
 - `fix/*` - Bug fixes
 - `docs/*` - Documentation updates
@@ -58,9 +57,9 @@ pytest tests/
 ### Creating a Feature
 ```bash
-# Create feature branch from develop
-git checkout develop
-git pull origin develop
+# Create feature branch from main
+git checkout main
+git pull origin main
 git checkout -b feature/your-feature-name
 # Make your changes
@@ -82,7 +81,7 @@ git push origin feature/your-feature-name
 We follow conventional commits:
-```
+```text
 <type>: <subject>
 <body>
@@ -91,6 +90,7 @@ We follow conventional commits:
 ```
 **Types:**
 - `feat`: New feature
 - `fix`: Bug fix
 - `docs`: Documentation changes
@@ -102,7 +102,7 @@ We follow conventional commits:
 **Examples:**
-```
+```text
 feat: Add Level 5 systems thinking module
 Implements pattern sharing between multiple AI agents
@@ -111,7 +111,7 @@ for emergent collaboration capabilities.
 Closes #42
 ```
-```
+```text
 fix: Correct trust calculation in feedback loops
 Trust erosion was not properly clamped to [0,1] range.
@@ -132,8 +132,8 @@ All new code must include tests. We aim for **70%+ coverage**.
 """
 Tests for Module Name
-Copyright 2025 Smart AI Memory, LLC
-Licensed under Fair Source 0.9
+Copyright 2025 Patrick Roebuck
+Licensed under Apache License 2.0
 """
 import pytest
@@ -186,9 +186,9 @@ pytest tests/ -s
 ### Coverage Requirements
-- Minimum **70% overall coverage**
-- New modules should have **80%+ coverage**
-- Critical modules (core, levels) should have **90%+ coverage**
+- Minimum **80% overall coverage**
+- New modules should have **90%+ coverage**
+- Critical modules (core, workflows, security) should have **95%+ coverage**
 ### Test Categories
@@ -256,6 +256,7 @@ class LeveragePointAnalyzer:
 ```
 **Docstring Sections:**
 - **Summary**: One-line description
 - **Extended Description**: Detailed explanation (optional)
 - **Example**: Usage example with >>> prompts
@@ -332,6 +333,7 @@ def process_data(data: List[Dict]) -> Dict:
 ### When to Update Documentation
 Update documentation when:
 - Adding new features
 - Changing public APIs
 - Adding examples
@@ -348,6 +350,7 @@ Update documentation when:
 ### Writing Examples
 Good examples are:
 - **Self-contained**: Run without external dependencies
 - **Well-commented**: Explain what and why
 - **Practical**: Show real-world use cases
@@ -360,8 +363,8 @@ Example: Building Trust Through Anticipation
 Demonstrates Level 4 Anticipatory Empathy by predicting
 user needs before they arise.
-Copyright 2025 Smart AI Memory, LLC
-Licensed under Fair Source 0.9
+Copyright 2025 Patrick Roebuck
+Licensed under Apache License 2.0
 """
 from attune import EmpathyOS
@@ -386,7 +389,7 @@ if __name__ == "__main__":
 ### Before Submitting
 1. **Run all tests**: `pytest tests/ --cov=src/attune`
-2. **Check coverage**: Ensure 70%+ coverage
+2. **Check coverage**: Ensure 80%+ coverage
 3. **Update documentation**: Add/update relevant docs
 4. **Add examples**: If adding features, add example
 5. **Self-review**: Read through your changes
@@ -394,13 +397,13 @@ if __name__ == "__main__":
 ### PR Checklist
 - [ ] Tests pass locally
-- [ ] Coverage is 70%+ overall
-- [ ] New code has tests (80%+ coverage for new modules)
+- [ ] Coverage is 80%+ overall
+- [ ] New code has tests (90%+ coverage for new modules)
 - [ ] Documentation updated
 - [ ] Examples added/updated if relevant
 - [ ] Commit messages follow conventional format
 - [ ] Code follows style guide
-- [ ] No merge conflicts with develop
+- [ ] No merge conflicts with main
 ### PR Template
@@ -445,7 +448,7 @@ Any additional context or notes for reviewers.
 - Your contribution will be included in next release
 - You'll be added to contributors list
-- Thank you for improving Empathy Framework!
+- Thank you for improving Attune AI!
 ## Getting Help
@@ -456,6 +459,7 @@ Any additional context or notes for reviewers.
 ## Recognition
 Contributors are recognized in:
 - README.md contributors section
 - Release notes
 - Project documentation
@@ -466,4 +470,4 @@ By contributing, you agree that your contributions will be licensed under the Ap
 ---
-Thank you for contributing to Empathy Framework! 🤝
+Thank you for contributing to Attune AI! 🤝

{attune_ai-2.0.2 → attune_ai-2.1.0}/PKG-INFO RENAMED Viewed

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: attune-ai
-Version: 2.0.2
+Version: 2.1.0
 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,14 +421,14 @@ 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 cost optimization and pattern learning.**
 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-13%2C489%20collected-brightgreen)](https://github.com/Smart-AI-Memory/attune-ai/actions)
+[![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)
@@ -439,64 +439,188 @@ pip install attune-ai[developer]
 ---
-## What's New in v2.0.0
+## 🎯 Transitioning to Claude-Native Architecture
-**🎉 Introducing Attune AI** - A fresh start with a new name and renewed focus:
+**Empathy Framework is evolving to focus exclusively on Anthropic/Claude** to unlock features impossible with multi-provider abstraction:
-**Package Rebrand**: `empathy-framework` is now `attune-ai`
+- **📦 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
-- New package name, same powerful features
-- All capabilities from v5.x preserved
-- Starting fresh at v2.0.0 to mark the new brand
+**Timeline:**
-**🤖 Multi-Agent Orchestration** - Build and coordinate specialized AI agents:
+- ✅ **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
-- **Agent Coordination Dashboard** - Real-time monitoring with 6 coordination patterns
-- **Custom Agents** - Create specialized agents for your workflow needs
-- **LLM Agents** - Leverage Claude's advanced capabilities
-- Dashboard at `http://localhost:8000` with `python examples/dashboard_demo.py` (requires Redis)
+**Migration Guide:** [docs/CLAUDE_NATIVE.md](docs/CLAUDE_NATIVE.md)
-**💰 Intelligent Cost Optimization**:
+---
+## 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
-- **Authentication Strategy** - Smart routing between Claude subscription (free) and Anthropic API
-- **Batch API** - 50% cost savings for non-urgent tasks
-- **Smart Tier Routing** - Automatic model selection saves 34-86% on costs
-- **Precise Token Counting** - >98% accurate cost tracking
+**📚 Documentation Improvements**:
-**⚡ Performance & Scale**:
+- Clarified flexible context strategy (200K subscription + 1M API routing)
+- Added Redis requirement documentation for dashboard
+- Root directory cleanup (8 archived files)
-- **18x Faster** - Redis caching, parallel scanning, incremental updates
-- **99.9% Memory Reduction** - Generator expressions across 27 optimizations
-- **Natural Language** - Use plain English for workflow commands
-- **13,489 Tests** - Comprehensive test coverage (99.9% passing)
+**🧪 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)
+---
-**🔐 Security & Quality**:
+## What's New in v5.1.0
-- **Automated Security Scanning** - 82% accuracy, blocks critical issues
-- **Path Traversal Protection** - All file operations validated
-- **HIPAA/GDPR Compliance** - Enterprise-ready security options
+**🤖 Multi-Agent Orchestration** - Full support for custom agents and Anthropic LLM agents:
-**🧭 Developer Experience**:
+- **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
-- **MCP Integration** - 10 tools auto-discovered by Claude Code
-- **Hub-Based Commands** - Organized workflows (`/dev`, `/testing`, `/release`, etc.)
-- **Socratic Workflows** - Interactive discovery through guided questions
-- **$0 Workflows** - Run via Claude Code with no API costs, unless a 1 million API context is required.
+- **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)**
-**Migration from Empathy Framework**:
+**🔐 Authentication Strategy System** - Intelligent routing between Claude subscriptions and Anthropic API:
 ```bash
-# Old package
-pip uninstall empathy-framework
+# Interactive setup
+python -m attune.models.auth_cli setup
-# New package
-pip install attune-ai[developer]
+# 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
+```
+**💰 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)
-# Update imports in your code
-# from empathy_os → from attune
+---
+## 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
 ```
-[See Full Changelog](CHANGELOG.md) | [Migration Guide](docs/MIGRATION_GUIDE.md)
+**📊 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.
+**Socratic Workflows** - Interactive discovery through guided questions. Workflows ask what you need rather than requiring upfront configuration.
+**Security Hardened** - Fixed critical vulnerabilities (path traversal, JWT, SSRF).
+**Hub-Based Commands** - Organized workflows into intuitive command hubs.
 ---
@@ -535,7 +659,7 @@ python -m attune.models.cli provider --set anthropic
 /plan "review my code"
 # Direct tool access via MCP (v5.1.1+):
-# Claude Code automatically discovers Attune AI tools through the MCP server
+# Claude Code automatically discovers Empathy tools through the MCP server
 # Just describe what you need in natural language:
 "Run a security audit on src/"          → Invokes security_audit tool
 "Generate tests for config.py"          → Invokes test_generation tool
@@ -545,7 +669,7 @@ python -m attune.models.cli provider --set anthropic
 **MCP Server Integration (v5.1.1+):**
-Attune AI now includes a Model Context Protocol (MCP) server that exposes all workflows as native Claude Code tools:
+Empathy Framework now includes a Model Context Protocol (MCP) server that exposes all workflows as native Claude Code tools:
 - **10 Tools Available:** security_audit, bug_predict, code_review, test_generation, performance_audit, release_prep, auth_status, auth_recommend, telemetry_stats, dashboard_status
 - **Automatic Discovery:** No manual configuration needed - Claude Code finds tools via `.claude/mcp.json`
@@ -567,9 +691,9 @@ See [.claude/MCP_TEST_RESULTS.md](.claude/MCP_TEST_RESULTS.md) for full integrat
 **CLI:**
 ```bash
-attune workflow run security-audit --path ./src
-attune workflow run test-coverage --target 90
-attune telemetry show  # View cost savings
+empathy workflow run security-audit --path ./src
+empathy workflow run test-coverage --target 90
+empathy telemetry show  # View cost savings
 ```
 **Python:**
@@ -577,8 +701,8 @@ attune telemetry show  # View cost savings
 ```python
 from attune import EmpathyOS
-async with EmpathyOS() as attune:
-    result = await attune.level_2_guided(
+async with EmpathyOS() as empathy:
+    result = await empathy.level_2_guided(
         "Review this code for security issues"
     )
     print(result["response"])
@@ -688,7 +812,7 @@ For programmatic use, smart tier routing saves 34-86%:
 ```bash
 # Track API usage and savings
-attune telemetry savings --days 30
+empathy telemetry savings --days 30
 ```
 ---
@@ -699,10 +823,10 @@ attune telemetry savings --days 30
 ```bash
 # 4 parallel agents check release readiness
-attune orchestrate release-prep
+empathy orchestrate release-prep
 # Sequential coverage improvement
-attune orchestrate test-coverage --target 90
+empathy orchestrate test-coverage --target 90
 ```
 ### Response Caching
@@ -750,21 +874,21 @@ python -m attune.models.cli provider
 python -m attune.models.cli provider --set hybrid
 # Workflows
-attune workflow list
-attune workflow run <workflow-name>
+empathy workflow list
+empathy workflow run <workflow-name>
 # Cost tracking
-attune telemetry show
-attune telemetry savings --days 30
-attune telemetry export --format csv
+empathy telemetry show
+empathy telemetry savings --days 30
+empathy telemetry export --format csv
 # Orchestration
-attune orchestrate release-prep
-attune orchestrate test-coverage --target 90
+empathy orchestrate release-prep
+empathy orchestrate test-coverage --target 90
 # Meta-workflows
-attune meta-workflow list
-attune meta-workflow run release-prep --real
+empathy meta-workflow list
+empathy meta-workflow run release-prep --real
 ```
 ---
@@ -810,7 +934,7 @@ export REDIS_URL="redis://localhost:6379"
 ## VSCode Extension
-Install the Attune AI VSCode extension for:
+Install the Empathy VSCode extension for:
 - **Dashboard** - Health score, costs, patterns
 - **One-Click Workflows** - Run from command palette
@@ -845,10 +969,10 @@ See [SECURITY.md](SECURITY.md) for vulnerability reporting.
 ```bash
 # Run security audit locally
-attune workflow run security-audit
+empathy workflow run security-audit
 # Scan specific directory
-attune workflow run security-audit --input '{"path":"./src"}'
+empathy workflow run security-audit --input '{"path":"./src"}'
 ```
 **Documentation:**

attune-ai 2.0.2__tar.gz → 2.1.0__tar.gz

attune-ai 2.0.2tar.gz → 2.1.0tar.gz