attune-ai 2.1.2__py3-none-any.whl → 2.1.4__py3-none-any.whl

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.
attune/cli/__init__.py CHANGED
@@ -1,6 +1,6 @@
1
- """Empathy Framework CLI - Refactored modular structure.
1
+ """Attune AI CLI - Refactored modular structure.
2
2
 
3
- Entry point for the empathy command-line interface.
3
+ Entry point for the attune command-line interface.
4
4
 
5
5
  Copyright 2025 Smart-AI-Memory
6
6
  Licensed under Fair Source License 0.9
@@ -1,4 +1,4 @@
1
- """Profiling commands for Empathy Framework CLI.
1
+ """Profiling commands for Attune AI CLI.
2
2
 
3
3
  Performance profiling and memory analysis commands.
4
4
 
@@ -1,4 +1,4 @@
1
- """Utility commands for Empathy Framework CLI.
1
+ """Utility commands for Attune AI CLI.
2
2
 
3
3
  General-purpose utility commands (sync, cheatsheet, dashboard, etc.).
4
4
 
attune/cli/core.py CHANGED
@@ -1,4 +1,4 @@
1
- """Core utilities for Empathy Framework CLI.
1
+ """Core utilities for Attune AI CLI.
2
2
 
3
3
  Shared utilities, console configuration, and helper functions used across
4
4
  all CLI command modules.
attune/cli_minimal.py CHANGED
@@ -1,5 +1,5 @@
1
1
  #!/usr/bin/env python3
2
- """Empathy Framework CLI.
2
+ """Attune AI CLI.
3
3
 
4
4
  IMPORTANT: This CLI is for automation only (git hooks, scripts, CI/CD).
5
5
  For interactive use, use Claude Code skills in VSCode or Claude Desktop.
@@ -948,8 +948,8 @@ def cmd_version(args: Namespace) -> int:
948
948
  def create_parser() -> argparse.ArgumentParser:
949
949
  """Create the argument parser."""
950
950
  parser = argparse.ArgumentParser(
951
- prog="empathy",
952
- description="Empathy Framework CLI (automation interface - for git hooks, scripts, CI/CD)",
951
+ prog="attune",
952
+ description="Attune AI CLI (automation interface - for git hooks, scripts, CI/CD)",
953
953
  formatter_class=argparse.RawDescriptionHelpFormatter,
954
954
  epilog="""
955
955
  NOTE: This CLI is for automation only. For interactive development,
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: attune-ai
3
- Version: 2.1.2
3
+ Version: 2.1.4
4
4
  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.
5
5
  Author-email: Patrick Roebuck <admin@smartaimemory.com>
6
6
  Maintainer-email: Smart-AI-Memory <admin@smartaimemory.com>
@@ -421,9 +421,9 @@ Requires-Dist: aiohttp<4.0.0,>=3.10.0; extra == "all"
421
421
  Requires-Dist: filelock<4.0.0,>=3.16.0; extra == "all"
422
422
  Dynamic: license-file
423
423
 
424
- # Empathy Framework
424
+ # Attune AI
425
425
 
426
- **AI-powered developer workflows with cost optimization and pattern learning.**
426
+ **AI-powered developer workflows with cost optimization and intelligent routing.**
427
427
 
428
428
  Run code review, debugging, testing, and release workflows from your terminal or Claude Code. Smart tier routing saves 34-86% on LLM costs.
429
429
 
@@ -431,7 +431,6 @@ Run code review, debugging, testing, and release workflows from your terminal or
431
431
  [![Tests](https://img.shields.io/badge/tests-7%2C168%20passing%20(99.9%25)-brightgreen)](https://github.com/Smart-AI-Memory/attune-ai/actions)
432
432
  [![Python](https://img.shields.io/badge/python-3.10+-blue)](https://www.python.org)
433
433
  [![License](https://img.shields.io/badge/license-Apache%202.0-blue)](LICENSE)
434
- [![Performance](https://img.shields.io/badge/performance-18x%20faster-success)](https://github.com/Smart-AI-Memory/attune-ai/blob/main/CHANGELOG.md)
435
434
 
436
435
  ```bash
437
436
  pip install attune-ai[developer]
@@ -439,188 +438,38 @@ pip install attune-ai[developer]
439
438
 
440
439
  ---
441
440
 
442
- ## 🎯 Transitioning to Claude-Native Architecture
443
-
444
- **Empathy Framework is evolving to focus exclusively on Anthropic/Claude** to unlock features impossible with multi-provider abstraction:
445
-
446
- - **📦 Prompt Caching:** 90% cost reduction on repeated prompts
447
- - **📖 Flexible Context:** 200K via subscription for most tasks, up to 1M via API for large codebases
448
- - **🧠 Extended Thinking:** See Claude's internal reasoning process
449
- - **🔧 Advanced Tool Use:** Optimized for agentic workflows
450
-
451
- **Timeline:**
452
-
453
- - ✅ **v4.8.0 (Jan 2026):** Deprecation warnings for OpenAI/Google/Ollama providers
454
- - ✅ **v5.0.0 (Jan 26, 2026):** Non-Anthropic providers removed (BREAKING - COMPLETE)
455
- - ✅ **v5.0.2 (Jan 28, 2026):** Cost optimization suite with batch processing and caching monitoring
456
-
457
- **Migration Guide:** [docs/CLAUDE_NATIVE.md](docs/CLAUDE_NATIVE.md)
458
-
459
- ---
460
-
461
- ## What's New in v5.3.0
462
-
463
- **🎨 Dashboard Enhancements** - Improved usability and clarity:
464
-
465
- - **Agent Display Names** - Human-readable labels for agents in dashboard (e.g., "Code Analyzer" instead of UUID)
466
- - **Comprehensive Help Panel** - 5-section accordion explaining dashboard features, use cases, and Redis setup
467
- - **UX Improvements** - "Source Agent:" label clarity, "Redis Requires Enabling" status message
468
- - **Browser Cache Busting** - Date-based versioning ensures updates appear immediately
469
-
470
- **📚 Documentation Improvements**:
471
-
472
- - Clarified flexible context strategy (200K subscription + 1M API routing)
473
- - Added Redis requirement documentation for dashboard
474
- - Root directory cleanup (8 archived files)
475
-
476
- **🧪 Test Infrastructure**:
477
-
478
- - Sequential test execution to fix import timing issues
479
- - All agent tracking tests passing (19/19)
441
+ ## Key Features
480
442
 
481
- [See Full Changelog](CHANGELOG.md#530---2026-01-31)
443
+ ### Claude-Native Architecture
482
444
 
483
- ---
445
+ Attune AI is built exclusively for Anthropic/Claude, unlocking features impossible with multi-provider abstraction:
484
446
 
485
- ## What's New in v5.1.0
447
+ - **Prompt Caching** - 90% cost reduction on repeated prompts
448
+ - **Flexible Context** - 200K via subscription, up to 1M via API for large codebases
449
+ - **Extended Thinking** - Access Claude's internal reasoning process
450
+ - **Advanced Tool Use** - Optimized for agentic workflows
486
451
 
487
- **🤖 Multi-Agent Orchestration** - Full support for custom agents and Anthropic LLM agents:
452
+ ### Multi-Agent Orchestration
488
453
 
489
- - **Agent Coordination Dashboard** - Real-time monitoring with 6 coordination patterns:
490
- - Agent heartbeats and status tracking
491
- - Inter-agent coordination signals
492
- - Event streaming across agent workflows
493
- - Approval gates for human-in-the-loop
494
- - Quality feedback and performance metrics
495
- - Demo mode with test data generation
454
+ Full support for custom agents and Anthropic LLM agents:
496
455
 
456
+ - **Agent Coordination Dashboard** - Real-time monitoring with 6 coordination patterns
497
457
  - **Custom Agents** - Build specialized agents for your workflow needs
498
- - **LLM Agents from Anthropic** - Leverage Claude's advanced capabilities
499
- - Dashboard accessible at `http://localhost:8000` with `python examples/dashboard_demo.py` **(Requires Redis)**
500
-
501
- **🔐 Authentication Strategy System** - Intelligent routing between Claude subscriptions and Anthropic API:
458
+ - **Inter-Agent Communication** - Heartbeats, signals, events, and approval gates
502
459
 
503
- ```bash
504
- # Interactive setup
505
- python -m attune.models.auth_cli setup
506
-
507
- # View current configuration
508
- python -m attune.models.auth_cli status
509
-
510
- # Get recommendation for a file
511
- python -m attune.models.auth_cli recommend src/module.py
512
- ```
513
-
514
- **💰 Automatic Cost Optimization** - Workflows choose the best auth method:
515
-
516
- - Small/medium modules (<2000 LOC) → Claude subscription (free)
517
- - Large modules (>2000 LOC) → Anthropic API (pay for what you need)
518
- - 7 workflows integrated: document-gen, test-gen, code-review, bug-predict, security-audit, perf-audit, release-prep
519
- - Auth mode tracking in all workflow outputs for telemetry
520
-
521
- **🧪 Comprehensive Testing** - 7 new integration tests for auth strategy:
522
-
523
- - All workflows tested with auth enabled/disabled
524
- - API and subscription mode verification
525
- - Cost tracking validation
526
-
527
- **📖 Documentation** - 950+ lines across 3 guides:
528
-
529
- - [AUTH_STRATEGY_GUIDE.md](docs/AUTH_STRATEGY_GUIDE.md) - User guide for configuration
530
- - [AUTH_CLI_IMPLEMENTATION.md](docs/AUTH_CLI_IMPLEMENTATION.md) - CLI command reference
531
- - [AUTH_WORKFLOW_INTEGRATIONS.md](docs/AUTH_WORKFLOW_INTEGRATIONS.md) - Integration patterns
532
-
533
- [See Full Changelog](CHANGELOG.md#510---2026-01-29)
534
-
535
- ---
536
-
537
- ## What's New in v5.0.2
538
-
539
- **💰 50% Cost Savings with Batch API** - Process non-urgent tasks asynchronously:
540
-
541
- ```bash
542
- empathy batch submit batch_requests.json # Submit batch job
543
- empathy batch status msgbatch_abc123 # Check progress
544
- empathy batch results msgbatch_abc123 output.json # Download results
545
- ```
460
+ ### Intelligent Cost Optimization
546
461
 
547
- Perfect for: log analysis, report generation, bulk classification, test generation
462
+ - **$0 in Claude Code** - Workflows run as skills through Claude's Task tool
463
+ - **Smart Tier Routing** - Automatically selects the right model for each task
464
+ - **Authentication Strategy** - Routes between subscription and API based on codebase size
548
465
 
549
- **📊 Precise Token Counting** - >98% accurate cost tracking:
466
+ ### Socratic Workflows
550
467
 
551
- - Integrated Anthropic's `count_tokens()` API for billing-accurate measurements
552
- - 3-tier fallback: API → tiktoken (local) → heuristic
553
- - Cache-aware cost calculation (25% write markup, 90% read discount)
554
-
555
- **📈 Cache Performance Monitoring** - Track your 20-30% caching savings:
556
-
557
- ```bash
558
- empathy cache stats # Show hit rates and cost savings
559
- empathy cache stats --verbose # Detailed token metrics
560
- empathy cache stats --format json # Machine-readable output
561
- ```
562
-
563
- **🧭 Adaptive Routing Analytics** - Intelligent tier recommendations:
564
-
565
- ```bash
566
- empathy routing stats <workflow> # Performance metrics
567
- empathy routing check --all # Tier upgrade recommendations
568
- empathy routing models --provider anthropic # Compare models
569
- ```
570
-
571
- **🔧 Dashboard Fixes** - All 6 agent coordination patterns now operational:
572
- - Agent heartbeats displaying correctly
573
- - Event streaming functional
574
- - Coordination signals working
575
- - Approval gates operational
576
-
577
- [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)
578
-
579
- ---
580
-
581
- ## What's New in v4.9.0
582
-
583
- **⚡ 18x Faster Performance** - Massive performance gains through Phase 2 optimizations:
584
-
585
- - **Redis Two-Tier Caching:** 2x faster memory operations (37,000x for cached keys)
586
- - **Generator Expressions:** 99.9% memory reduction across 27 optimizations
587
- - **Parallel Scanning:** Multi-core processing enabled by default (2-4x faster)
588
- - **Incremental Scanning:** Git diff-based updates (10x faster)
589
-
590
- **🧭 Natural Language Workflows** - Use plain English instead of workflow names:
591
-
592
- ```bash
593
- /workflows "find security vulnerabilities" # → security-audit
594
- /workflows "check code performance" # → perf-audit
595
- /workflows "predict bugs" # → bug-predict
596
- /plan "review my code" # → code-review
597
- ```
598
-
599
- **📊 Real-World Performance:**
600
-
601
- - Combined workflow: 3.59s → 0.2s (**18x faster**)
602
- - Full scan: 3,472 files in 0.98s (was 3.59s)
603
- - Redis cached operations: 37ms → 0.001ms
604
-
605
- **🎯 Improved Navigation:**
606
-
607
- - Split `/workflow` into `/workflows` (automated analysis) and `/plan` (planning/review)
608
- - Clearer hub organization with better categorization
609
- - Natural language routing matches intent to workflow
610
-
611
- [See CHANGELOG.md](CHANGELOG.md) | [Performance Docs](docs/REDIS_OPTIMIZATION_SUMMARY.md)
612
-
613
- ---
614
-
615
- ## What's New in v4.7.0
616
-
617
- **$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.
618
-
619
- **Socratic Workflows** - Interactive discovery through guided questions. Workflows ask what you need rather than requiring upfront configuration.
620
-
621
- **Security Hardened** - Fixed critical vulnerabilities (path traversal, JWT, SSRF).
468
+ Workflows guide you through discovery instead of requiring upfront configuration:
622
469
 
623
- **Hub-Based Commands** - Organized workflows into intuitive command hubs.
470
+ - **Interactive Discovery** - Asks targeted questions to understand your needs
471
+ - **Context Gathering** - Collects relevant code, errors, and constraints
472
+ - **Dynamic Agent Creation** - Assembles the right team based on your answers
624
473
 
625
474
  ---
626
475
 
@@ -638,74 +487,31 @@ pip install attune-ai[developer]
638
487
  # Auto-detect API keys
639
488
  python -m attune.models.cli provider
640
489
 
641
- # Or set explicitly
642
- python -m attune.models.cli provider --set anthropic
490
+ # Or configure authentication strategy
491
+ python -m attune.models.auth_cli setup
643
492
  ```
644
493
 
645
- ### 3. Use
646
-
647
- **In Claude Code:**
494
+ ### 3. Use in Claude Code
648
495
 
649
496
  ```bash
650
497
  /dev # Developer tools (debug, commit, PR, review)
651
- /testing # Run tests, coverage, benchmarks
498
+ /testing # Run tests, coverage analysis, benchmarks
652
499
  /workflows # Automated analysis (security, bugs, perf)
653
- /plan # Planning, TDD, code review
500
+ /plan # Planning, TDD, code review, refactoring
654
501
  /docs # Documentation generation
655
502
  /release # Release preparation
656
503
 
657
504
  # Natural language support:
658
505
  /workflows "find security issues"
659
506
  /plan "review my code"
660
-
661
- # Direct tool access via MCP (v5.1.1+):
662
- # Claude Code automatically discovers Empathy tools through the MCP server
663
- # Just describe what you need in natural language:
664
- "Run a security audit on src/" → Invokes security_audit tool
665
- "Generate tests for config.py" → Invokes test_generation tool
666
- "Check my auth configuration" → Invokes auth_status tool
667
- "Analyze performance bottlenecks" → Invokes performance_audit tool
668
507
  ```
669
508
 
670
- **MCP Server Integration (v5.1.1+):**
671
-
672
- Empathy Framework now includes a Model Context Protocol (MCP) server that exposes all workflows as native Claude Code tools:
673
-
674
- - **10 Tools Available:** security_audit, bug_predict, code_review, test_generation, performance_audit, release_prep, auth_status, auth_recommend, telemetry_stats, dashboard_status
675
- - **Automatic Discovery:** No manual configuration needed - Claude Code finds tools via `.claude/mcp.json`
676
- - **Natural Language Access:** Describe your need and Claude invokes the appropriate tool
677
- - **Verification Hooks:** Automatic validation of Python/JSON files and workflow outputs
678
-
679
- To verify MCP integration:
509
+ ### 4. Use via CLI
680
510
 
681
511
  ```bash
682
- # Check server is running
683
- echo '{"method":"tools/list","params":{}}' | PYTHONPATH=./src python -m attune.mcp.server
684
-
685
- # Restart Claude Code to load the MCP server
686
- # Tools will appear in Claude's tool list automatically
687
- ```
688
-
689
- See [.claude/MCP_TEST_RESULTS.md](.claude/MCP_TEST_RESULTS.md) for full integration details.
690
-
691
- **CLI:**
692
-
693
- ```bash
694
- empathy workflow run security-audit --path ./src
695
- empathy workflow run test-coverage --target 90
696
- empathy telemetry show # View cost savings
697
- ```
698
-
699
- **Python:**
700
-
701
- ```python
702
- from attune import EmpathyOS
703
-
704
- async with EmpathyOS() as empathy:
705
- result = await empathy.level_2_guided(
706
- "Review this code for security issues"
707
- )
708
- print(result["response"])
512
+ attune workflow run security-audit --path ./src
513
+ attune workflow run test-coverage --target 90
514
+ attune telemetry show # View cost savings
709
515
  ```
710
516
 
711
517
  ---
@@ -722,67 +528,14 @@ Workflows are organized into hubs for easy discovery:
722
528
  | **Release** | `/release` | Release prep, security scan, publishing |
723
529
  | **Workflows** | `/workflows` | Automated analysis (security, bugs, perf) |
724
530
  | **Plan** | `/plan` | Planning, TDD, code review, refactoring |
725
- | **Utilities** | `/utilities` | Project init, dependencies, profiling |
726
- | **Learning** | `/learning` | Pattern learning and session evaluation |
727
- | **Context** | `/context` | State management and memory |
728
531
  | **Agent** | `/agent` | Create and manage custom agents |
729
532
 
730
- **Natural Language Support:**
533
+ **Natural Language Routing:**
731
534
 
732
535
  ```bash
733
- # Use plain English - intelligent routing matches your intent
734
536
  /workflows "find security vulnerabilities" # → security-audit
735
537
  /workflows "check code performance" # → perf-audit
736
- /workflows "predict bugs" # → bug-predict
737
538
  /plan "review my code" # → code-review
738
- /plan "help me plan this feature" # → planning
739
-
740
- # Or use traditional workflow names
741
- /workflows security-audit
742
- /plan code-review
743
- ```
744
-
745
- **Interactive menus:**
746
-
747
- ```bash
748
- /dev # Show interactive menu
749
- /dev "debug auth error" # Jump directly to debugging
750
- /testing "run coverage" # Run coverage analysis
751
- /release # Start release preparation
752
- ```
753
-
754
- ---
755
-
756
- ## Socratic Method
757
-
758
- Workflows guide you through discovery instead of requiring upfront configuration:
759
-
760
- ```text
761
- You: /dev
762
-
763
- Claude: What development task do you need?
764
- 1. Debug issue
765
- 2. Create commit
766
- 3. PR workflow
767
- 4. Quality check
768
-
769
- You: 1
770
-
771
- Claude: What error or unexpected behavior are you seeing?
772
- ```
773
-
774
- **How it works:**
775
-
776
- 1. **Discovery** - Workflow asks targeted questions to understand your needs
777
- 2. **Context gathering** - Collects relevant code, errors, and constraints
778
- 3. **Dynamic agent creation** - Assembles the right team based on your answers
779
- 4. **Execution** - Runs with appropriate tier selection
780
-
781
- **Create custom agents with Socratic guidance:**
782
-
783
- ```bash
784
- /agent create # Guided agent creation
785
- /agent team # Build multi-agent teams interactively
786
539
  ```
787
540
 
788
541
  ---
@@ -797,120 +550,93 @@ When using Claude Code, workflows run as skills through the Task tool - **no API
797
550
  /dev # $0 - uses your Claude subscription
798
551
  /testing # $0
799
552
  /release # $0
800
- /agent create # $0
801
553
  ```
802
554
 
803
555
  ### API Mode (CI/CD, Automation)
804
556
 
805
557
  For programmatic use, smart tier routing saves 34-86%:
806
558
 
807
- | Tier | Model | Use Case | Cost |
808
- | ------- | ------------------- | --------------------------- | ----------- |
809
- | CHEAP | Haiku / GPT-4o-mini | Formatting, simple tasks | ~$0.005 |
810
- | CAPABLE | Sonnet / GPT-4o | Bug fixes, code review | ~$0.08 |
811
- | PREMIUM | Opus / o1 | Architecture, complex design | ~$0.45 |
559
+ | Tier | Model | Use Case | Cost |
560
+ | ------- | ------------- | ---------------------------- | ------- |
561
+ | CHEAP | Haiku | Formatting, simple tasks | ~$0.005 |
562
+ | CAPABLE | Sonnet | Bug fixes, code review | ~$0.08 |
563
+ | PREMIUM | Opus | Architecture, complex design | ~$0.45 |
812
564
 
813
565
  ```bash
814
566
  # Track API usage and savings
815
- empathy telemetry savings --days 30
567
+ attune telemetry savings --days 30
816
568
  ```
817
569
 
818
570
  ---
819
571
 
820
- ## Key Features
572
+ ## MCP Server Integration
821
573
 
822
- ### Multi-Agent Workflows
574
+ Attune AI includes a Model Context Protocol (MCP) server that exposes all workflows as native Claude Code tools:
823
575
 
824
- ```bash
825
- # 4 parallel agents check release readiness
826
- empathy orchestrate release-prep
576
+ - **10 Tools Available** - security_audit, bug_predict, code_review, test_generation, performance_audit, release_prep, and more
577
+ - **Automatic Discovery** - Claude Code finds tools via `.claude/mcp.json`
578
+ - **Natural Language Access** - Describe your need and Claude invokes the appropriate tool
827
579
 
828
- # Sequential coverage improvement
829
- empathy orchestrate test-coverage --target 90
830
- ```
831
-
832
- ### Response Caching
833
-
834
- Up to 57% cache hit rate on similar prompts. Zero config needed.
835
-
836
- ```python
837
- from attune.workflows import SecurityAuditWorkflow
838
-
839
- workflow = SecurityAuditWorkflow(enable_cache=True)
840
- result = await workflow.execute(target_path="./src")
841
- print(f"Cache hit rate: {result.cost_report.cache_hit_rate:.1f}%")
580
+ ```bash
581
+ # Verify MCP integration
582
+ echo '{"method":"tools/list","params":{}}' | PYTHONPATH=./src python -m attune.mcp.server
842
583
  ```
843
584
 
844
- ### Pattern Learning
845
-
846
- Workflows learn from outcomes and improve over time:
585
+ ---
847
586
 
848
- ```python
849
- from attune.orchestration.config_store import ConfigurationStore
587
+ ## Agent Coordination Dashboard
850
588
 
851
- store = ConfigurationStore()
852
- best = store.get_best_for_task("release_prep")
853
- print(f"Success rate: {best.success_rate:.1%}")
854
- ```
589
+ Real-time monitoring with 6 coordination patterns:
855
590
 
856
- ### Multi-Provider Support
591
+ - Agent heartbeats and status tracking
592
+ - Inter-agent coordination signals
593
+ - Event streaming across agent workflows
594
+ - Approval gates for human-in-the-loop
595
+ - Quality feedback and performance metrics
596
+ - Demo mode with test data generation
857
597
 
858
- ```python
859
- from attune_llm.providers import (
860
- AnthropicProvider, # Claude
861
- OpenAIProvider, # GPT-4
862
- GeminiProvider, # Gemini
863
- LocalProvider, # Ollama, LM Studio
864
- )
598
+ ```bash
599
+ # Launch dashboard (requires Redis)
600
+ python examples/dashboard_demo.py
601
+ # Open http://localhost:8000
865
602
  ```
866
603
 
867
604
  ---
868
605
 
869
- ## CLI Reference
606
+ ## Authentication Strategy
607
+
608
+ Intelligent routing between Claude subscription and Anthropic API:
870
609
 
871
610
  ```bash
872
- # Provider configuration
873
- python -m attune.models.cli provider
874
- python -m attune.models.cli provider --set hybrid
611
+ # Interactive setup
612
+ python -m attune.models.auth_cli setup
875
613
 
876
- # Workflows
877
- empathy workflow list
878
- empathy workflow run <workflow-name>
614
+ # View current configuration
615
+ python -m attune.models.auth_cli status
879
616
 
880
- # Cost tracking
881
- empathy telemetry show
882
- empathy telemetry savings --days 30
883
- empathy telemetry export --format csv
617
+ # Get recommendation for a file
618
+ python -m attune.models.auth_cli recommend src/module.py
619
+ ```
884
620
 
885
- # Orchestration
886
- empathy orchestrate release-prep
887
- empathy orchestrate test-coverage --target 90
621
+ **Automatic routing:**
888
622
 
889
- # Meta-workflows
890
- empathy meta-workflow list
891
- empathy meta-workflow run release-prep --real
892
- ```
623
+ - Small/medium modules (<2000 LOC) → Claude subscription (free)
624
+ - Large modules (>2000 LOC) → Anthropic API (pay for what you need)
893
625
 
894
626
  ---
895
627
 
896
- ## Install Options
628
+ ## Installation Options
897
629
 
898
630
  ```bash
899
631
  # Individual developers (recommended)
900
632
  pip install attune-ai[developer]
901
633
 
902
- # All LLM providers
903
- pip install attune-ai[llm]
904
-
905
634
  # With caching (semantic similarity)
906
635
  pip install attune-ai[cache]
907
636
 
908
637
  # Enterprise (auth, rate limiting)
909
638
  pip install attune-ai[enterprise]
910
639
 
911
- # Healthcare (HIPAA compliance)
912
- pip install attune-ai[healthcare]
913
-
914
640
  # Development
915
641
  git clone https://github.com/Smart-AI-Memory/attune-ai.git
916
642
  cd attune-ai && pip install -e .[dev]
@@ -921,74 +647,38 @@ cd attune-ai && pip install -e .[dev]
921
647
  ## Environment Setup
922
648
 
923
649
  ```bash
924
- # At least one provider required
650
+ # Required: Anthropic API key
925
651
  export ANTHROPIC_API_KEY="sk-ant-..."
926
- export OPENAI_API_KEY="sk-..."
927
- export GOOGLE_API_KEY="..."
928
652
 
929
- # Optional (but required for Agent Dashboard): Redis for memory
653
+ # Optional: Redis for Agent Dashboard and memory
930
654
  export REDIS_URL="redis://localhost:6379"
931
655
  ```
932
656
 
933
657
  ---
934
658
 
935
- ## VSCode Extension
936
-
937
- Install the Empathy VSCode extension for:
938
-
939
- - **Dashboard** - Health score, costs, patterns
940
- - **One-Click Workflows** - Run from command palette
941
- - **Memory Panel** - Manage Redis and patterns
942
- - **Cost Tracking** - Real-time savings display
943
-
944
- ---
945
-
946
- ## Documentation
947
-
948
- - [Quick Start Guide](docs/quickstart.md)
949
- - [CLI Reference](docs/cli-reference.md)
950
- - [Testing Guide](docs/testing-guide.md)
951
- - [Keyboard Shortcuts](docs/keyboard-shortcuts.md)
952
- - [Full Documentation](https://smartaimemory.com/framework-docs/)
953
-
954
- ---
955
-
956
659
  ## Security
957
660
 
958
661
  - Path traversal protection on all file operations
959
662
  - JWT authentication with rate limiting
960
663
  - PII scrubbing in telemetry
961
664
  - HIPAA/GDPR compliance options
962
- - **Automated security scanning** with 82% accuracy (Phase 3 AST-based detection)
963
-
964
- See [SECURITY.md](SECURITY.md) for vulnerability reporting.
965
-
966
- ### Security Scanning
967
-
968
- **Automated security scanning in CI/CD** - 82% accuracy, blocks critical issues:
665
+ - Automated security scanning with 82% accuracy
969
666
 
970
667
  ```bash
971
- # Run security audit locally
972
- empathy workflow run security-audit
973
-
974
- # Scan specific directory
975
- empathy workflow run security-audit --input '{"path":"./src"}'
668
+ # Run security audit
669
+ attune workflow run security-audit --path ./src
976
670
  ```
977
671
 
978
- **Documentation:**
672
+ See [SECURITY.md](SECURITY.md) for vulnerability reporting.
979
673
 
980
- - **[Developer Workflow Guide](docs/DEVELOPER_SECURITY_WORKFLOW.md)** - Quick reference for handling security findings (all developers)
981
- - **[CI/CD Integration Guide](docs/CI_SECURITY_SCANNING.md)** - Complete setup and troubleshooting (DevOps, developers)
982
- - **[Scanner Architecture](docs/SECURITY_SCANNER_ARCHITECTURE.md)** - Technical implementation details (engineers, architects)
983
- - **[Remediation Process](docs/SECURITY_REMEDIATION_PROCESS.md)** - 3-phase methodology for improving scanners (security teams, leadership)
984
- - **[API Reference](docs/api-reference/security-scanner.md)** - Complete API documentation (developers extending scanner)
674
+ ---
985
675
 
986
- **Key achievements:**
676
+ ## Documentation
987
677
 
988
- - 82.3% reduction in false positives (350 → 62 findings)
989
- - 16x improvement in scanner accuracy
990
- - <15 minute average fix time for critical issues
991
- - Zero critical vulnerabilities in production code
678
+ - [Quick Start Guide](docs/quickstart.md)
679
+ - [CLI Reference](docs/cli-reference.md)
680
+ - [Authentication Strategy Guide](docs/AUTH_STRATEGY_GUIDE.md)
681
+ - [Full Documentation](https://smartaimemory.com/framework-docs/)
992
682
 
993
683
  ---
994
684
 
@@ -1000,27 +690,20 @@ See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
1000
690
 
1001
691
  ## License
1002
692
 
1003
- **Apache License 2.0** - Free and open source for everyone. Use it, modify it, build commercial products with it. [Details →](LICENSE)
693
+ **Apache License 2.0** - Free and open source. Use it, modify it, build commercial products with it. [Details →](LICENSE)
1004
694
 
1005
695
  ---
1006
696
 
1007
697
  ## Acknowledgements
1008
698
 
1009
- 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.
1010
-
1011
- **[View Full Acknowledgements →](ACKNOWLEDGEMENTS.md)**
1012
-
1013
699
  Special thanks to:
1014
700
 
1015
701
  - **[Anthropic](https://www.anthropic.com/)** - For Claude AI and the Model Context Protocol
1016
- - **[LangChain](https://github.com/langchain-ai/langchain)** - Agent framework powering our meta-orchestration
702
+ - **[LangChain](https://github.com/langchain-ai/langchain)** - Agent framework powering our orchestration
1017
703
  - **[FastAPI](https://github.com/tiangolo/fastapi)** - Modern Python web framework
1018
- - **[pytest](https://github.com/pytest-dev/pytest)** - Testing framework making quality assurance effortless
1019
-
1020
- And to all 50+ open source projects we depend on. [See the complete list →](ACKNOWLEDGEMENTS.md)
1021
704
 
1022
- Want to contribute? See [CONTRIBUTORS.md](CONTRIBUTORS.md)
705
+ [View Full Acknowledgements ](ACKNOWLEDGEMENTS.md)
1023
706
 
1024
707
  ---
1025
708
 
1026
- **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)
709
+ **Built by [Smart AI Memory](https://smartaimemory.com)** · [Docs](https://smartaimemory.com/framework-docs/) · [Issues](https://github.com/Smart-AI-Memory/attune-ai/issues)
@@ -3,7 +3,7 @@ attune/agent_monitoring.py,sha256=s4seLC_J4AtQ3PYWrRPO8YHM-Fbm0Q36kPEdlTHf2HI,13
3
3
  attune/cache_monitor.py,sha256=lcBqODhYY9iPaH35PWkOSgyMavdvXneHv9F57dPmjnc,11190
4
4
  attune/cache_stats.py,sha256=yZvjC-lCN7rBBeUX6-HG5g5IeCOUZy-Euqu_ey1FLKY,10228
5
5
  attune/cli_legacy.py,sha256=8ZfHp50jaPs9hZ3YErBTNRpSsvRIvwwMKEmMvgDU7eQ,140079
6
- attune/cli_minimal.py,sha256=RvJT7rMh883WwFmAwyel5AiM2ez8zGt5t6GEJSqwCQA,41108
6
+ attune/cli_minimal.py,sha256=pq12dPwoI4MWL4UxrrOtRDMhb5diNb2czfxDVZjTLJo,41091
7
7
  attune/cli_router.py,sha256=iKbf3Ayb5Z5qCfAajUr8b1Y4AZcwpLBYaCEug3OqTkI,16106
8
8
  attune/cli_unified.py,sha256=PgfCbV5Cb-mKBbS4lLMpaO3m7OWUOniK9M3R6V2R1Dg,25241
9
9
  attune/config.py,sha256=eocyHkwf85r0EfQYzeskxZkDzEK-wrjGNMBL2ccsUs0,16710
@@ -38,9 +38,9 @@ attune/cache/dependency_manager.py,sha256=5syHCeunxJHBFggjcMMNSvJw4EJfICfW2mmayA
38
38
  attune/cache/hash_only.py,sha256=N9fJw-IGOzgfDOuKe15e3AzLrxkjDBbwDXEgR1DYXAo,7492
39
39
  attune/cache/hybrid.py,sha256=S73yjzbSeUi_PtE-hEWtml9CN-V3W8qzAlIGu5Y17K0,15541
40
40
  attune/cache/storage.py,sha256=-ODkX61DqbK-eDC0uUeRtjcxfKYwK4PxG7mou4x6vgU,7787
41
- attune/cli/__init__.py,sha256=2K0e6zHipMUGgBu1Fdkb4JnCPzoqklfU92qEjis-G1Q,4931
41
+ attune/cli/__init__.py,sha256=kb3erHBlW0Esb24HhfJ0pnu2x-B4OBp9w0pTtVUwUQ0,4922
42
42
  attune/cli/__main__.py,sha256=3j6xfa_jrrXAXK7zp0AaKAgG224VxJfrpu-iUmmUkY0,211
43
- attune/cli/core.py,sha256=USK7MwpSqxKcMP0rxtf9qqTgQ1GMmcPpXBw9uadQ3sM,883
43
+ attune/cli/core.py,sha256=YXGwU5nokchAgSSt22VBcK7W8wF0qa-AEgbmxn4mwMA,875
44
44
  attune/cli/commands/__init__.py,sha256=GYdoNv80KS2p7bCThuoRbhiLmIZW6ddPqPEFEx567nQ,35
45
45
  attune/cli/commands/batch.py,sha256=0TQ50VuFILN6ZTS-JrdtQi7ibuVwEUPq8xkdFsRU5_k,8562
46
46
  attune/cli/commands/cache.py,sha256=79DF06zQ7Noe7WwOLtqbDVIngpXCLkjNltP-R7t18iE,8176
@@ -52,14 +52,14 @@ attune/cli/commands/memory.py,sha256=566vPYCyqoS3231nhqCr2vDUQYCBtP3NT8iLj1-30mQ
52
52
  attune/cli/commands/metrics.py,sha256=v4KW46UWYOysCFQVLE2kqISil1YsHARbs9kE0mp_RvQ,3164
53
53
  attune/cli/commands/orchestrate.py,sha256=pGJRschCayD2E2wimTG4zXYQxEA1Kk7g_sMQFdeXM48,6541
54
54
  attune/cli/commands/patterns.py,sha256=-f6ZDrUIupZPmdjM87qitxRpBYMns1KFyiC9okq14vI,7917
55
- attune/cli/commands/profiling.py,sha256=LSv3voDCqLcicQkVR6jk-u8YjS3A4vOCdPA-Cny7jXI,6017
55
+ attune/cli/commands/profiling.py,sha256=Q6JY2Ui7mfOyT4hVtpzTi0ZlpCCW7HWTX4SrcVfhIGY,6009
56
56
  attune/cli/commands/provider.py,sha256=o1vDEIxjE6qhpFl__yx2qeiMOqkR2zDUlrCdkcrEANs,3077
57
57
  attune/cli/commands/routing.py,sha256=BwuGBVKQ4S7szQW4ubce9pO5uLaxEoHHlpR7Uljcf5I,9896
58
58
  attune/cli/commands/setup.py,sha256=0mS_ya2hQ3ZEQH9CYoozBoVWErVr-5aQ76G8NEPqXu8,3447
59
59
  attune/cli/commands/status.py,sha256=rxjQQrrIkpSLLDUOPf1OJI7MHxs36NZcVGBVIgVNh6w,8282
60
60
  attune/cli/commands/sync.py,sha256=IE9kdpUl3G-Ep3XlZcZc_5JeUmGGfPxBpC2g_cp89H4,5086
61
61
  attune/cli/commands/tier.py,sha256=ztb7GisxmlQWuoVrc7QRblKp5pM9bsLpZUBQBfM3Iw4,3737
62
- attune/cli/commands/utilities.py,sha256=CdsQ0vyW9QpN2mheLlOTpaInqAJ-JO1jVS6mXuA_on4,3717
62
+ attune/cli/commands/utilities.py,sha256=WZQsQwEGRWxfqKPPVdTlVg9Eb49uhZmccfxz5Llrckc,3709
63
63
  attune/cli/commands/workflow.py,sha256=W2Mz5oyWZChCpGBonfbSlmSN5VQcjnO9nj8B2c1aliY,23549
64
64
  attune/cli/parsers/__init__.py,sha256=Oihx1jb5wN_4GS3RxZiEYhQhglI44idOOlFJs9a6e5g,1677
65
65
  attune/cli/parsers/batch.py,sha256=wSutRqerJZxUNVNIotU9qtI8EGP6IzVihEZUViCItCQ,3236
@@ -347,8 +347,8 @@ attune/workflows/test_gen/data_models.py,sha256=wXfef60ptiG6AvygayTxWqlL5FVOss19
347
347
  attune/workflows/test_gen/report_formatter.py,sha256=RaxbDp6-9iQRfJmVwrrIReVkOkrnb668NgHrNaS-SPY,10705
348
348
  attune/workflows/test_gen/test_templates.py,sha256=4ywqGYYaSoZxOU6Y1_E-27KEgMI5-v2a1ndia406E9c,13180
349
349
  attune/workflows/test_gen/workflow.py,sha256=U0dhAcCKmlltPIvCSXUeFzt_Q4TodQI4tXtR6cz19MQ,25729
350
- attune_ai-2.1.2.dist-info/licenses/LICENSE,sha256=kqe3EeGatNB79lUTHxjLnxDe7VJr0iYetThOr4_Fx7A,11348
351
- attune_ai-2.1.2.dist-info/licenses/LICENSE_CHANGE_ANNOUNCEMENT.md,sha256=JH9yAQGv_lQej5YlztI_kawbVQ2H8uVLhPGlrWnR_34,3844
350
+ attune_ai-2.1.4.dist-info/licenses/LICENSE,sha256=kqe3EeGatNB79lUTHxjLnxDe7VJr0iYetThOr4_Fx7A,11348
351
+ attune_ai-2.1.4.dist-info/licenses/LICENSE_CHANGE_ANNOUNCEMENT.md,sha256=JH9yAQGv_lQej5YlztI_kawbVQ2H8uVLhPGlrWnR_34,3844
352
352
  attune_healthcare/__init__.py,sha256=4NioL1_86UXzkd-QNkQZUSZ8rKTQGSP0TC9VXP32kQs,295
353
353
  attune_healthcare/monitors/__init__.py,sha256=Udp8qfZR504QAq5_eQjvtIaE7v06Yguc7nuF40KllQc,196
354
354
  attune_healthcare/monitors/clinical_protocol_monitor.py,sha256=MWE5t8tW9HWZn_SNo-inx8-0nhdTNGhbcB8ZeDWyXa0,11648
@@ -450,8 +450,8 @@ workflow_scaffolding/__init__.py,sha256=UpX5vjjjPjIaAKyIV1D4GxJzLUZy5DzdzgSkePYM
450
450
  workflow_scaffolding/__main__.py,sha256=0qspuNoadTDqyskXTlT8Sahqau-XIxN35NHTSGVW6z4,236
451
451
  workflow_scaffolding/cli.py,sha256=RUVqU9SeAgm7YkM0YNd-quh8u6BNzmX8xM2y9K_p68Y,6759
452
452
  workflow_scaffolding/generator.py,sha256=2WC02A10lzF2NQgOn66ksV17Oe72kKlU2qCQs39LIlw,8861
453
- attune_ai-2.1.2.dist-info/METADATA,sha256=4aE_g9pNuVToXXW4Zwf9ck-CJUcMG_e8MZ7jMukCkFE,45033
454
- attune_ai-2.1.2.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
455
- attune_ai-2.1.2.dist-info/entry_points.txt,sha256=GVlb04zFlpkaPtaL7X3JCZI8R0AEOZRsZjJ-wIDQvdo,1458
456
- attune_ai-2.1.2.dist-info/top_level.txt,sha256=iLyjKpuOzWtwmIOZqzeBh8_SVztY2vFvhHcyo1WPtTY,73
457
- attune_ai-2.1.2.dist-info/RECORD,,
453
+ attune_ai-2.1.4.dist-info/METADATA,sha256=GxzUd0l3D9p-ExI5H4sg6hsMVbvbLBQZSszVlgjxWoI,33764
454
+ attune_ai-2.1.4.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
455
+ attune_ai-2.1.4.dist-info/entry_points.txt,sha256=GVlb04zFlpkaPtaL7X3JCZI8R0AEOZRsZjJ-wIDQvdo,1458
456
+ attune_ai-2.1.4.dist-info/top_level.txt,sha256=iLyjKpuOzWtwmIOZqzeBh8_SVztY2vFvhHcyo1WPtTY,73
457
+ attune_ai-2.1.4.dist-info/RECORD,,