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

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

@@ -7,6 +7,26 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [2.1.3] - 2026-02-02
+
+### Changed
+
+- **README rebrand**: Complete rewrite from "Empathy Framework" to "Attune AI" branding
+- **Cleaner documentation**: Streamlined README focusing on key features without legacy version history
+
+## [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.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: attune-ai
-Version: 2.1.1
+Version: 2.1.3
 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,11 +421,11 @@ 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
+# Attune AI
 
-**AI-powered developer workflows with Socratic discovery.**
+**AI-powered developer workflows with cost optimization and intelligent routing.**
 
-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)
@@ -438,26 +438,38 @@ pip install attune-ai[developer]
 
 ---
 
-## What's New in v2.1.0
+## Key Features
 
-**🎯 Unified `/attune` Command** - One entry point for all workflows:
+### Claude-Native Architecture
 
-```bash
-/attune                    # Start Socratic discovery
-/attune "fix a bug"        # Natural language
-/attune debug              # Direct shortcut
-```
+Attune AI is built exclusively for Anthropic/Claude, unlocking features impossible with multi-provider abstraction:
+
+- **Prompt Caching** - 90% cost reduction on repeated prompts
+- **Flexible Context** - 200K via subscription, up to 1M via API for large codebases
+- **Extended Thinking** - Access Claude's internal reasoning process
+- **Advanced Tool Use** - Optimized for agentic workflows
+
+### Multi-Agent Orchestration
+
+Full support for custom agents and Anthropic LLM agents:
 
-**Socratic Discovery** - Ask what you're trying to accomplish, not which tool to use:
+- **Agent Coordination Dashboard** - Real-time monitoring with 6 coordination patterns
+- **Custom Agents** - Build specialized agents for your workflow needs
+- **Inter-Agent Communication** - Heartbeats, signals, events, and approval gates
 
-- 🔧 **Fix or improve** → Debug, review, refactor
-- ✅ **Validate work** → Tests, coverage, security audit
-- 🚀 **Ship changes** → Commit, PR, release
-- 📚 **Understand** → Explain code, generate docs
+### Intelligent Cost Optimization
 
-**Performance Audit Improvements** - Removed false positive detection for intentional patterns like `dirs[:]` and defensive list copies.
+- **$0 in Claude Code** - Workflows run as skills through Claude's Task tool
+- **Smart Tier Routing** - Automatically selects the right model for each task
+- **Authentication Strategy** - Routes between subscription and API based on codebase size
 
-[See Full Changelog](CHANGELOG.md)
+### Socratic Workflows
+
+Workflows guide you through discovery instead of requiring upfront configuration:
+
+- **Interactive Discovery** - Asks targeted questions to understand your needs
+- **Context Gathering** - Collects relevant code, errors, and constraints
+- **Dynamic Agent Creation** - Assembles the right team based on your answers
 
 ---
 
@@ -475,74 +487,31 @@ pip install attune-ai[developer]
 # Auto-detect API keys
 python -m attune.models.cli provider
 
-# Or set explicitly
-python -m attune.models.cli provider --set anthropic
+# Or configure authentication strategy
+python -m attune.models.auth_cli setup
 ```
 
-### 3. Use
-
-**In Claude Code:**
+### 3. Use in Claude Code
 
 ```bash
 /dev           # Developer tools (debug, commit, PR, review)
-/testing       # Run tests, coverage, benchmarks
+/testing       # Run tests, coverage analysis, benchmarks
 /workflows     # Automated analysis (security, bugs, perf)
-/plan          # Planning, TDD, code review
+/plan          # Planning, TDD, code review, refactoring
 /docs          # Documentation generation
 /release       # Release preparation
 
 # Natural language support:
 /workflows "find security issues"
 /plan "review my code"
-
-# Direct tool access via MCP (v5.1.1+):
-# 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
-"Check my auth configuration"           → Invokes auth_status tool
-"Analyze performance bottlenecks"       → Invokes performance_audit tool
 ```
 
-**MCP Server Integration (v5.1.1+):**
-
-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`
-- **Natural Language Access:** Describe your need and Claude invokes the appropriate tool
-- **Verification Hooks:** Automatic validation of Python/JSON files and workflow outputs
-
-To verify MCP integration:
+### 4. Use via CLI
 
 ```bash
-# Check server is running
-echo '{"method":"tools/list","params":{}}' | PYTHONPATH=./src python -m attune.mcp.server
-
-# Restart Claude Code to load the MCP server
-# Tools will appear in Claude's tool list automatically
-```
-
-See [.claude/MCP_TEST_RESULTS.md](.claude/MCP_TEST_RESULTS.md) for full integration details.
-
-**CLI:**
-
-```bash
-empathy workflow run security-audit --path ./src
-empathy workflow run test-coverage --target 90
-empathy telemetry show  # View cost savings
-```
-
-**Python:**
-
-```python
-from attune import EmpathyOS
-
-async with EmpathyOS() as empathy:
-    result = await empathy.level_2_guided(
-        "Review this code for security issues"
-    )
-    print(result["response"])
+attune workflow run security-audit --path ./src
+attune workflow run test-coverage --target 90
+attune telemetry show  # View cost savings
 ```
 
 ---
@@ -559,67 +528,14 @@ Workflows are organized into hubs for easy discovery:
 | **Release**       | `/release`    | Release prep, security scan, publishing      |
 | **Workflows**     | `/workflows`  | Automated analysis (security, bugs, perf)    |
 | **Plan**          | `/plan`       | Planning, TDD, code review, refactoring      |
-| **Utilities**     | `/utilities`  | Project init, dependencies, profiling        |
-| **Learning**      | `/learning`   | Pattern learning and session evaluation      |
-| **Context**       | `/context`    | State management and memory                  |
 | **Agent**         | `/agent`      | Create and manage custom agents              |
 
-**Natural Language Support:**
+**Natural Language Routing:**
 
 ```bash
-# Use plain English - intelligent routing matches your intent
 /workflows "find security vulnerabilities"  # → security-audit
 /workflows "check code performance"         # → perf-audit
-/workflows "predict bugs"                   # → bug-predict
 /plan "review my code"                      # → code-review
-/plan "help me plan this feature"           # → planning
-
-# Or use traditional workflow names
-/workflows security-audit
-/plan code-review
-```
-
-**Interactive menus:**
-
-```bash
-/dev                    # Show interactive menu
-/dev "debug auth error" # Jump directly to debugging
-/testing "run coverage" # Run coverage analysis
-/release                # Start release preparation
-```
-
----
-
-## Socratic Method
-
-Workflows guide you through discovery instead of requiring upfront configuration:
-
-```text
-You: /dev
-
-Claude: What development task do you need?
-  1. Debug issue
-  2. Create commit
-  3. PR workflow
-  4. Quality check
-
-You: 1
-
-Claude: What error or unexpected behavior are you seeing?
-```
-
-**How it works:**
-
-1. **Discovery** - Workflow asks targeted questions to understand your needs
-2. **Context gathering** - Collects relevant code, errors, and constraints
-3. **Dynamic agent creation** - Assembles the right team based on your answers
-4. **Execution** - Runs with appropriate tier selection
-
-**Create custom agents with Socratic guidance:**
-
-```bash
-/agent create    # Guided agent creation
-/agent team      # Build multi-agent teams interactively
 ```
 
 ---
@@ -634,120 +550,93 @@ When using Claude Code, workflows run as skills through the Task tool - **no API
 /dev           # $0 - uses your Claude subscription
 /testing       # $0
 /release       # $0
-/agent create  # $0
 ```
 
 ### API Mode (CI/CD, Automation)
 
 For programmatic use, smart tier routing saves 34-86%:
 
-| Tier    | Model               | Use Case                    | Cost        |
-| ------- | ------------------- | --------------------------- | ----------- |
-| CHEAP   | Haiku / GPT-4o-mini | Formatting, simple tasks    | ~$0.005     |
-| CAPABLE | Sonnet / GPT-4o     | Bug fixes, code review      | ~$0.08      |
-| PREMIUM | Opus / o1           | Architecture, complex design | ~$0.45      |
+| Tier    | Model         | Use Case                     | Cost    |
+| ------- | ------------- | ---------------------------- | ------- |
+| CHEAP   | Haiku         | Formatting, simple tasks     | ~$0.005 |
+| CAPABLE | Sonnet        | Bug fixes, code review       | ~$0.08  |
+| PREMIUM | Opus          | Architecture, complex design | ~$0.45  |
 
 ```bash
 # Track API usage and savings
-empathy telemetry savings --days 30
+attune telemetry savings --days 30
 ```
 
 ---
 
-## Key Features
-
-### Multi-Agent Workflows
-
-```bash
-# 4 parallel agents check release readiness
-empathy orchestrate release-prep
-
-# Sequential coverage improvement
-empathy orchestrate test-coverage --target 90
-```
+## MCP Server Integration
 
-### Response Caching
+Attune AI includes a Model Context Protocol (MCP) server that exposes all workflows as native Claude Code tools:
 
-Up to 57% cache hit rate on similar prompts. Zero config needed.
+- **10 Tools Available** - security_audit, bug_predict, code_review, test_generation, performance_audit, release_prep, and more
+- **Automatic Discovery** - Claude Code finds tools via `.claude/mcp.json`
+- **Natural Language Access** - Describe your need and Claude invokes the appropriate tool
 
-```python
-from attune.workflows import SecurityAuditWorkflow
-
-workflow = SecurityAuditWorkflow(enable_cache=True)
-result = await workflow.execute(target_path="./src")
-print(f"Cache hit rate: {result.cost_report.cache_hit_rate:.1f}%")
+```bash
+# Verify MCP integration
+echo '{"method":"tools/list","params":{}}' | PYTHONPATH=./src python -m attune.mcp.server
 ```
 
-### Pattern Learning
-
-Workflows learn from outcomes and improve over time:
+---
 
-```python
-from attune.orchestration.config_store import ConfigurationStore
+## Agent Coordination Dashboard
 
-store = ConfigurationStore()
-best = store.get_best_for_task("release_prep")
-print(f"Success rate: {best.success_rate:.1%}")
-```
+Real-time monitoring with 6 coordination patterns:
 
-### Multi-Provider Support
+- 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
 
-```python
-from attune_llm.providers import (
-    AnthropicProvider,  # Claude
-    OpenAIProvider,     # GPT-4
-    GeminiProvider,     # Gemini
-    LocalProvider,      # Ollama, LM Studio
-)
+```bash
+# Launch dashboard (requires Redis)
+python examples/dashboard_demo.py
+# Open http://localhost:8000
 ```
 
 ---
 
-## CLI Reference
+## Authentication Strategy
+
+Intelligent routing between Claude subscription and Anthropic API:
 
 ```bash
-# Provider configuration
-python -m attune.models.cli provider
-python -m attune.models.cli provider --set hybrid
+# Interactive setup
+python -m attune.models.auth_cli setup
 
-# Workflows
-empathy workflow list
-empathy workflow run <workflow-name>
+# View current configuration
+python -m attune.models.auth_cli status
 
-# Cost tracking
-empathy telemetry show
-empathy telemetry savings --days 30
-empathy telemetry export --format csv
+# Get recommendation for a file
+python -m attune.models.auth_cli recommend src/module.py
+```
 
-# Orchestration
-empathy orchestrate release-prep
-empathy orchestrate test-coverage --target 90
+**Automatic routing:**
 
-# Meta-workflows
-empathy meta-workflow list
-empathy meta-workflow run release-prep --real
-```
+- Small/medium modules (<2000 LOC) → Claude subscription (free)
+- Large modules (>2000 LOC) → Anthropic API (pay for what you need)
 
 ---
 
-## Install Options
+## Installation Options
 
 ```bash
 # Individual developers (recommended)
 pip install attune-ai[developer]
 
-# All LLM providers
-pip install attune-ai[llm]
-
 # With caching (semantic similarity)
 pip install attune-ai[cache]
 
 # Enterprise (auth, rate limiting)
 pip install attune-ai[enterprise]
 
-# Healthcare (HIPAA compliance)
-pip install attune-ai[healthcare]
-
 # Development
 git clone https://github.com/Smart-AI-Memory/attune-ai.git
 cd attune-ai && pip install -e .[dev]
@@ -758,74 +647,38 @@ cd attune-ai && pip install -e .[dev]
 ## Environment Setup
 
 ```bash
-# At least one provider required
+# Required: Anthropic API key
 export ANTHROPIC_API_KEY="sk-ant-..."
-export OPENAI_API_KEY="sk-..."
-export GOOGLE_API_KEY="..."
 
-# Optional (but required for Agent Dashboard): Redis for memory
+# Optional: Redis for Agent Dashboard and memory
 export REDIS_URL="redis://localhost:6379"
 ```
 
 ---
 
-## VSCode Extension
-
-Install the Empathy VSCode extension for:
-
-- **Dashboard** - Health score, costs, patterns
-- **One-Click Workflows** - Run from command palette
-- **Memory Panel** - Manage Redis and patterns
-- **Cost Tracking** - Real-time savings display
-
----
-
-## Documentation
-
-- [Quick Start Guide](docs/quickstart.md)
-- [CLI Reference](docs/cli-reference.md)
-- [Testing Guide](docs/testing-guide.md)
-- [Keyboard Shortcuts](docs/keyboard-shortcuts.md)
-- [Full Documentation](https://smartaimemory.com/framework-docs/)
-
----
-
 ## Security
 
 - Path traversal protection on all file operations
 - JWT authentication with rate limiting
 - PII scrubbing in telemetry
 - HIPAA/GDPR compliance options
-- **Automated security scanning** with 82% accuracy (Phase 3 AST-based detection)
-
-See [SECURITY.md](SECURITY.md) for vulnerability reporting.
-
-### Security Scanning
-
-**Automated security scanning in CI/CD** - 82% accuracy, blocks critical issues:
+- Automated security scanning with 82% accuracy
 
 ```bash
-# Run security audit locally
-empathy workflow run security-audit
-
-# Scan specific directory
-empathy workflow run security-audit --input '{"path":"./src"}'
+# Run security audit
+attune workflow run security-audit --path ./src
 ```
 
-**Documentation:**
+See [SECURITY.md](SECURITY.md) for vulnerability reporting.
 
-- **[Developer Workflow Guide](docs/DEVELOPER_SECURITY_WORKFLOW.md)** - Quick reference for handling security findings (all developers)
-- **[CI/CD Integration Guide](docs/CI_SECURITY_SCANNING.md)** - Complete setup and troubleshooting (DevOps, developers)
-- **[Scanner Architecture](docs/SECURITY_SCANNER_ARCHITECTURE.md)** - Technical implementation details (engineers, architects)
-- **[Remediation Process](docs/SECURITY_REMEDIATION_PROCESS.md)** - 3-phase methodology for improving scanners (security teams, leadership)
-- **[API Reference](docs/api-reference/security-scanner.md)** - Complete API documentation (developers extending scanner)
+---
 
-**Key achievements:**
+## Documentation
 
-- 82.3% reduction in false positives (350 → 62 findings)
-- 16x improvement in scanner accuracy
-- <15 minute average fix time for critical issues
-- Zero critical vulnerabilities in production code
+- [Quick Start Guide](docs/quickstart.md)
+- [CLI Reference](docs/cli-reference.md)
+- [Authentication Strategy Guide](docs/AUTH_STRATEGY_GUIDE.md)
+- [Full Documentation](https://smartaimemory.com/framework-docs/)
 
 ---
 
@@ -837,27 +690,20 @@ See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
 
 ## License
 
-**Apache License 2.0** - Free and open source for everyone. Use it, modify it, build commercial products with it. [Details →](LICENSE)
+**Apache License 2.0** - Free and open source. Use it, modify it, build commercial products with it. [Details →](LICENSE)
 
 ---
 
 ## Acknowledgements
 
-This project stands on the shoulders of giants. We are deeply grateful to the open source community and all the amazing projects that make this framework possible.
-
-**[View Full Acknowledgements →](ACKNOWLEDGEMENTS.md)**
-
 Special thanks to:
 
 - **[Anthropic](https://www.anthropic.com/)** - For Claude AI and the Model Context Protocol
-- **[LangChain](https://github.com/langchain-ai/langchain)** - Agent framework powering our meta-orchestration
+- **[LangChain](https://github.com/langchain-ai/langchain)** - Agent framework powering our orchestration
 - **[FastAPI](https://github.com/tiangolo/fastapi)** - Modern Python web framework
-- **[pytest](https://github.com/pytest-dev/pytest)** - Testing framework making quality assurance effortless
-
-And to all 50+ open source projects we depend on. [See the complete list →](ACKNOWLEDGEMENTS.md)
 
-Want to contribute? See [CONTRIBUTORS.md](CONTRIBUTORS.md)
+[View Full Acknowledgements →](ACKNOWLEDGEMENTS.md)
 
 ---
 
-**Built by [Smart AI Memory](https://smartaimemory.com)** · [Docs](https://smartaimemory.com/framework-docs/) · [Examples](examples/) · [Issues](https://github.com/Smart-AI-Memory/attune-ai/issues)
+**Built by [Smart AI Memory](https://smartaimemory.com)** · [Docs](https://smartaimemory.com/framework-docs/) · [Issues](https://github.com/Smart-AI-Memory/attune-ai/issues)