empathy-framework 3.11.0__py3-none-any.whl → 4.0.0__py3-none-any.whl

{empathy_framework-3.11.0.dist-info → empathy_framework-4.0.0.dist-info}/METADATA

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: empathy-framework
-Version: 3.11.0
-Summary: AI collaboration framework with intelligent caching (up to 85% cache hit rate), tier routing (34-86% cost savings), performance optimizations (46% faster scans, 3-5x faster lookups), XML-enhanced prompts, persistent memory, CrewAI integration, and multi-agent orchestration. Includes HIPAA-compliant healthcare wizards.
+Version: 4.0.0
+Summary: AI collaboration framework with breakthrough meta-orchestration system enabling dynamic agent composition (6 composition patterns), intelligent caching (85% hit rate), tier routing (34-86% cost savings), performance optimizations (46% faster scans), XML-enhanced prompts, persistent memory, and multi-agent orchestration. Production workflows: Release Prep, Test Coverage Boost.
 Author-email: Patrick Roebuck <admin@smartaimemory.com>
 Maintainer-email: Smart-AI-Memory <admin@smartaimemory.com>
 License: # Fair Source License, version 0.9
@@ -254,6 +254,9 @@ Provides-Extra: dev
 Requires-Dist: pytest<9.0,>=7.0; extra == "dev"
 Requires-Dist: pytest-asyncio<1.0,>=0.21; extra == "dev"
 Requires-Dist: pytest-cov<5.0,>=4.0; extra == "dev"
+Requires-Dist: pytest-xdist<4.0,>=3.5.0; extra == "dev"
+Requires-Dist: pytest-testmon<3.0,>=2.1.0; extra == "dev"
+Requires-Dist: pytest-picked<1.0,>=0.5.0; extra == "dev"
 Requires-Dist: black<26.0,>=24.3.0; extra == "dev"
 Requires-Dist: mypy<2.0,>=1.0; extra == "dev"
 Requires-Dist: ruff<1.0,>=0.1; extra == "dev"
@@ -355,7 +358,9 @@ Dynamic: license-file
 
 # Empathy Framework
 
-**The AI collaboration framework that predicts problems before they happen.**
+**The AI collaboration framework with breakthrough meta-orchestration - agents that compose themselves.**
+
+🎭 **v4.0: The Meta-Orchestration Era** - Dynamic agent teams, intelligent composition, self-learning systems.
 
 [![PyPI](https://img.shields.io/pypi/v/empathy-framework)](https://pypi.org/project/empathy-framework/)
 [![Tests](https://img.shields.io/badge/tests-6%2C038%20passing-brightgreen)](https://github.com/Smart-AI-Memory/empathy-framework/actions)
@@ -368,39 +373,113 @@ Dynamic: license-file
 pip install empathy-framework[developer]  # Lightweight for individual developers
 ```
 
-## What's New in v3.11.0 (Current Release)
+## What's New in v4.0.0 🎭 **PARADIGM SHIFT**
+
+### **Meta-Orchestration: AI Agents That Compose Themselves**
+
+**The breakthrough:** Instead of manually wiring agent workflows, v4.0 introduces a meta-orchestration system that analyzes tasks, selects optimal agent teams, chooses composition patterns, and learns from outcomes.
+
+**What this means:**
+
+- 🧠 **Automatic task analysis** → Determines complexity, domain, required capabilities
+- 🤝 **Dynamic team composition** → Selects optimal agents from 7 pre-built templates
+- 📐 **Intelligent strategy selection** → Chooses from 6 composition patterns (Sequential, Parallel, Debate, Teaching, Refinement, Adaptive)
+- 📚 **Self-learning** → Saves successful compositions and improves over time
+- ⚡ **Production-ready workflows** → Release Prep (parallel validation), Test Coverage Boost (sequential improvement)
+
+### Quick Start
+
+**Release preparation with 4 parallel agents:**
+
+```bash
+empathy orchestrate release-prep
+```
+
+Automatically runs:
+
+- **Security Auditor** (vulnerability scan)
+- **Test Coverage Analyzer** (gap analysis)
+- **Code Quality Reviewer** (best practices)
+- **Documentation Writer** (completeness check)
+
+**Boost test coverage to 90%:**
+
+```bash
+empathy orchestrate test-coverage --target 90
+```
+
+Sequential workflow:
 
-### ⚡ **Phase 2 Performance Optimizations: 46% Faster, 15% Less Memory**
+1. **Coverage Analyzer** → Identify gaps
+2. **Test Generator** → Create tests
+3. **Test Validator** → Verify coverage
 
-**Data-driven performance improvements based on comprehensive profiling.**
+### Python API
 
-- ✅ **46% faster project scans** (9.5s → 5.1s for 2,000+ files)
-- ✅ **66% faster pattern queries** with intelligent caching
-- ✅ **15% less memory** through generator expression migrations
-- ✅ **3-5x faster lookups** via O(n) → O(1) optimizations
-- ✅ **Zero breaking changes** - 100% backward compatible
+```python
+from empathy_os.workflows.orchestrated_release_prep import (
+    OrchestratedReleasePrepWorkflow
+)
+
+# Create workflow with custom quality gates
+workflow = OrchestratedReleasePrepWorkflow(
+    quality_gates={
+        "min_coverage": 90.0,
+        "max_critical_issues": 0,
+    }
+)
+
+# Execute
+report = await workflow.execute(path=".")
+
+if report.approved:
+    print(f"✅ Release approved! (confidence: {report.confidence})")
+else:
+    for blocker in report.blockers:
+        print(f"❌ {blocker}")
+```
+
+### 6 Composition Patterns
+
+The meta-orchestrator automatically selects the best pattern:
+
+1. **Sequential** (A → B → C) - Pipeline processing
+2. **Parallel** (A ‖ B ‖ C) - Independent validation
+3. **Debate** (A ⇄ B ⇄ C → Synthesis) - Consensus building
+4. **Teaching** (Junior → Expert) - Cost optimization
+5. **Refinement** (Draft → Review → Polish) - Iterative improvement
+6. **Adaptive** (Classifier → Specialist) - Right-sizing
+
+### Learning System
+
+Successful compositions are saved and improved over time:
 
 ```python
-from empathy_os.pattern_library import PatternLibrary
+from empathy_os.orchestration.config_store import ConfigurationStore
+
+store = ConfigurationStore()
 
-library = PatternLibrary()
-# Automatically uses O(1) index structures - 5x faster!
-patterns = library.get_patterns_by_tag("debugging")
+# Find best composition for task
+best = store.get_best_for_task("release_prep")
+print(f"Success rate: {best.success_rate:.1%}")
+
+# Reuse proven composition
+agents = [get_template(a["role"]) for a in best.agents]
 ```
 
-**What was optimized:**
-1. **Data structures**: 5 O(n) → O(1) conversions (frozensets, dicts)
-2. **Memory**: Generator expressions reduce allocations by 50-100MB
-3. **Caching**: Pattern match cache with 60-70% hit rate
-4. **Profiling**: Complete performance baseline for future optimizations
+**Documentation:**
+
+- [Meta-Orchestration User Guide](docs/ORCHESTRATION_USER_GUIDE.md) - Complete guide with examples
+- [API Reference](docs/ORCHESTRATION_API.md) - All classes and methods
+- [Examples](examples/orchestration/) - Working code samples
 
-**Performance gains:**
-- File categorization: **5x faster**
-- Verdict merging: **3.5x faster**
-- Progress tracking: **5.8x faster**
-- GC cycles: **-50%** (4 → 2 for large operations)
+**Features:**
 
-See [CHANGELOG.md](https://github.com/Smart-AI-Memory/empathy-framework/blob/main/CHANGELOG.md#3110---2026-01-10) for complete details and benchmarks.
+- ✅ **7 pre-built agent templates** (security, testing, docs, etc.)
+- ✅ **Automatic strategy selection** based on task analysis
+- ✅ **Quality gates enforcement** with detailed reporting
+- ✅ **Configuration store** learns from outcomes
+- ✅ **Cost optimization** via tier selection (CHEAP → CAPABLE → PREMIUM)
 
 ---
 

{empathy_framework-3.11.0.dist-info → empathy_framework-4.0.0.dist-info}/RECORD

@@ -20,7 +20,7 @@ coach_wizards/refactoring_wizard.py,sha256=X0MTx3BHpOlOMAYDow-3HX5GyryY70JGAF5vA
 coach_wizards/scaling_wizard.py,sha256=n1RLtpWmj1RSEGSWssMiUPwCdpskO3z2Z3yhLlTdXro,2598
 coach_wizards/security_wizard.py,sha256=19SOClSxo6N-QqUc_QsFXOE7yEquiZF4kLi7jRomA7g,2605
 coach_wizards/testing_wizard.py,sha256=vKFgFG4uJfAVFmCIQbkrWNvZhIfLC6ve_XbvWZKrPg4,2563
-empathy_framework-3.11.0.dist-info/licenses/LICENSE,sha256=IJ9eeI5KSrD5P7alsn7sI_6_1bDihxBA5S4Sen4jf2k,4937
+empathy_framework-4.0.0.dist-info/licenses/LICENSE,sha256=IJ9eeI5KSrD5P7alsn7sI_6_1bDihxBA5S4Sen4jf2k,4937
 empathy_healthcare_plugin/__init__.py,sha256=4NioL1_86UXzkd-QNkQZUSZ8rKTQGSP0TC9VXP32kQs,295
 empathy_healthcare_plugin/monitors/__init__.py,sha256=Udp8qfZR504QAq5_eQjvtIaE7v06Yguc7nuF40KllQc,196
 empathy_healthcare_plugin/monitors/clinical_protocol_monitor.py,sha256=MWE5t8tW9HWZn_SNo-inx8-0nhdTNGhbcB8ZeDWyXa0,11648
@@ -97,7 +97,7 @@ empathy_os/__init__.py,sha256=zAvie0wQFlSpv7thmNNtdrPy0YY1NUaQfb1oD_hKmns,5896
 empathy_os/agent_monitoring.py,sha256=s4seLC_J4AtQ3PYWrRPO8YHM-Fbm0Q36kPEdlTHf2HI,13375
 empathy_os/cache_monitor.py,sha256=DTR8xr9d63czGzzdfrBFWp8hkoWPFsL-hpihPGmkbEc,11072
 empathy_os/cache_stats.py,sha256=rWJPBNFEfhuLwKYKy89D_Qa9GPIyVso2jdCKp_cdJhI,10232
-empathy_os/cli.py,sha256=nCclj4QhuV028B0Deq_sz-OcgiwSU7U0IN4YtxSCSYE,116971
+empathy_os/cli.py,sha256=27C4UBk4ZzxdLj54YcYz3ijBHGYQgUWU677vh4Z9l58,125075
 empathy_os/cli_unified.py,sha256=o6l1nokC5Ku8nvEDAEBJoP_p63g5xbVWz_JKTSFNsgE,27181
 empathy_os/config.py,sha256=jsFQuXpZP_jt6UrZtfLlkBZwPUSNbnW5VVtMS5JIhbA,16276
 empathy_os/coordination.py,sha256=E2HvHxKk1xbYswtgxhnVKB6DRxfXUV5pCt-XWHOvNKM,28509
@@ -1756,6 +1756,11 @@ empathy_os/monitoring/multi_backend.py,sha256=3w8TYUezwUtcieA9p4lWrsyIp_jVYAsPaY
 empathy_os/monitoring/otel_backend.py,sha256=dqCgiw79bYTeVFSRV3raYk-Mpnu8sNoqik3KBNl7ZXA,13503
 empathy_os/optimization/__init__.py,sha256=p9dPGmci7MIASss38ctLpKTl_tV8ApkcyPZovE1EUMA,422
 empathy_os/optimization/context_optimizer.py,sha256=lPWXuG7K1OMVNZKOdQT2SlZhLfjMREKSp5pCPQibXpk,8048
+empathy_os/orchestration/__init__.py,sha256=BuIuXDQ2MWPOIkhVkjFCkKjbiDwAqCmrL096ou2NYFE,876
+empathy_os/orchestration/agent_templates.py,sha256=t8LxeqiTdgqYvW1BE8IXswAFamVTrScycb2VnG0qBCM,16283
+empathy_os/orchestration/config_store.py,sha256=TZLjzCr1g0nAP1eEZA9fMUy3OjF6XsWIQaJnX_PpLDY,16774
+empathy_os/orchestration/execution_strategies.py,sha256=zoUyjJrfjrast4My688xCRLkvaLNT3oLrV97g6hTtAg,20999
+empathy_os/orchestration/meta_orchestrator.py,sha256=wlGeuKtmrgSSo2m-JD7yRq4Zczik_iWwM-1lj1Nop3Q,19343
 empathy_os/patterns/refactoring_memory.json,sha256=nk7Bh2QE8Zm4iz3nxzARYiqzBWqZrKXhypDHPC63f_U,2995
 empathy_os/patterns/debugging/all_patterns.json,sha256=0nxtlmJzqAn2fV162OgoTWtWXiJNzcZ04_uIRaUqC6U,2283
 empathy_os/patterns/debugging/workflow_20260107_1770825e.json,sha256=hfXZX3baBGXrVfESgze6JcIDL60TCQdE8k_4uZ0fKcw,1951
@@ -1826,6 +1831,7 @@ empathy_os/workflows/manage_docs_README.md,sha256=0v-DOpTdfXQ5qIFzVCtV2IY-QBNw5s
 empathy_os/workflows/manage_documentation.py,sha256=gknIse4MzTLxRowIAS07WSXNqWAoWCfxmoIJSbTYBNM,29419
 empathy_os/workflows/new_sample_workflow1.py,sha256=W59znXxsq5kgk4ZI3psC41KtzkLo5lmQ08SbMYXcJVg,4103
 empathy_os/workflows/new_sample_workflow1_README.md,sha256=bzLyqukgaKilG1OnCdLsc5GNWsYEagI7mn3n80BPMHY,2366
+empathy_os/workflows/orchestrated_release_prep.py,sha256=D7ABvuYwQFAmu1Jdc6TNLiriQXonB0pmKbHjeUOPLr0,19490
 empathy_os/workflows/perf_audit.py,sha256=5FW6BACMjRX5y-OmTxZBlzsqiEq-godaPISJXwy_BNY,25294
 empathy_os/workflows/pr_review.py,sha256=I-FPHHxo-WpqHtaAjdnJAtNj95opJK-Ybz3p2eb0niE,26221
 empathy_os/workflows/progress.py,sha256=J1ooVZp6WoaKz9IwDsoYFtfJGFTtSDU3kHewkGMjCJ8,15929
@@ -1839,6 +1845,7 @@ empathy_os/workflows/security_audit.py,sha256=LtGel4Tu5Nc3QGRr69w-UjMONmcVyXg8No
 empathy_os/workflows/step_config.py,sha256=CdRNAQ1SiPsuAl10s58ioyk5w8XCArecSS9AjyHWQJM,7213
 empathy_os/workflows/test5.py,sha256=6o_sFk4dAIyOIVY9nDilgQWaJIGjl551wzphbcnXwTI,3767
 empathy_os/workflows/test5_README.md,sha256=bnYhbwyNVGN0dbIcnAUhEJbwSf4cE-UAkD09p_gvThc,2406
+empathy_os/workflows/test_coverage_boost.py,sha256=a3_ScZR66YDPKpF47-JUHUz8p8wHwVKLzPH_Zsk-MJU,14824
 empathy_os/workflows/test_gen.py,sha256=Lw9Hh-feqiM9GCjWUJzlNyEPMqxP34LSNEscbuOUZjU,70621
 empathy_os/workflows/test_lifecycle.py,sha256=c6UDSd6kOQdCHmaJviwAnUVceVQuSdLNQ9eKbVooiMY,16890
 empathy_os/workflows/test_maintenance.py,sha256=jiMeYX7Qg3CnRU5xW8LuOXnARxV7uqfygDKkIsEgL0s,22941
@@ -2241,8 +2248,8 @@ workflow_scaffolding/__init__.py,sha256=UpX5vjjjPjIaAKyIV1D4GxJzLUZy5DzdzgSkePYM
 workflow_scaffolding/__main__.py,sha256=0qspuNoadTDqyskXTlT8Sahqau-XIxN35NHTSGVW6z4,236
 workflow_scaffolding/cli.py,sha256=yLgvMsPbqI-LHt7UKXMuj-Dc0-44EqWiChldysrw1YQ,6763
 workflow_scaffolding/generator.py,sha256=9eEmm324kVzf8BCtXEML090pyke06o0U7aGATzZIaPM,8869
-empathy_framework-3.11.0.dist-info/METADATA,sha256=BU6UCdFioi3K1t__40o1WRn7fJaiFMf0Va4P8MelB1Q,51465
-empathy_framework-3.11.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-empathy_framework-3.11.0.dist-info/entry_points.txt,sha256=zMu7sKCiLndbEEXjTecltS-1P_JZoEUKrifuRBBbroc,1268
-empathy_framework-3.11.0.dist-info/top_level.txt,sha256=wrNU1aVMutVDACer58H-udv0P_171Dv6z_42sZtZ-xM,124
-empathy_framework-3.11.0.dist-info/RECORD,,
+empathy_framework-4.0.0.dist-info/METADATA,sha256=tH2U4Uw3SXIrG6xAMdZtcjNnrdXhyx04C0a_Vw4uy1A,53904
+empathy_framework-4.0.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+empathy_framework-4.0.0.dist-info/entry_points.txt,sha256=zMu7sKCiLndbEEXjTecltS-1P_JZoEUKrifuRBBbroc,1268
+empathy_framework-4.0.0.dist-info/top_level.txt,sha256=wrNU1aVMutVDACer58H-udv0P_171Dv6z_42sZtZ-xM,124
+empathy_framework-4.0.0.dist-info/RECORD,,

empathy_os/cli.py

@@ -764,6 +764,182 @@ def cmd_tier_stats(args):
     print()
 
 
+def cmd_orchestrate(args):
+    """Run meta-orchestration workflows.
+
+    Orchestrates teams of agents to accomplish complex tasks through
+    intelligent composition patterns.
+    """
+    import asyncio
+    import json
+
+    from empathy_os.workflows.orchestrated_release_prep import OrchestratedReleasePrepWorkflow
+    from empathy_os.workflows.test_coverage_boost import TestCoverageBoostWorkflow
+
+    # Get workflow type
+    workflow_type = args.workflow
+
+    print()
+    print("=" * 60)
+    print(f"  META-ORCHESTRATION: {workflow_type.upper()}")
+    print("=" * 60)
+    print()
+
+    if workflow_type == "release-prep":
+        # Release Preparation workflow
+        path = args.path or "."
+        quality_gates = {}
+
+        # Collect custom quality gates
+        if hasattr(args, "min_coverage") and args.min_coverage is not None:
+            quality_gates["min_coverage"] = args.min_coverage
+        if hasattr(args, "min_quality") and args.min_quality is not None:
+            quality_gates["min_quality_score"] = args.min_quality
+        if hasattr(args, "max_critical") and args.max_critical is not None:
+            quality_gates["max_critical_issues"] = args.max_critical
+
+        print(f"  Project Path: {path}")
+        if quality_gates:
+            print(f"  Quality Gates: {quality_gates}")
+        print()
+        print("  🔍 Parallel Validation Agents:")
+        print("    • Security Auditor (vulnerability scan)")
+        print("    • Test Coverage Analyzer (gap analysis)")
+        print("    • Code Quality Reviewer (best practices)")
+        print("    • Documentation Writer (completeness)")
+        print()
+
+        # Create workflow
+        workflow = OrchestratedReleasePrepWorkflow(
+            quality_gates=quality_gates if quality_gates else None
+        )
+
+        try:
+            # Execute workflow
+            report = asyncio.run(workflow.execute(path=path))
+
+            # Display results
+            if hasattr(args, "json") and args.json:
+                print(json.dumps(report.to_dict(), indent=2))
+            else:
+                print(report.format_console_output())
+
+            # Return appropriate exit code
+            return 0 if report.approved else 1
+
+        except Exception as e:
+            print(f"  ❌ Error executing release prep workflow: {e}")
+            print()
+            logger.exception("Release prep workflow failed")
+            return 1
+
+    elif workflow_type == "test-coverage":
+        # Test Coverage Boost workflow
+        target_coverage = args.target or 80.0
+        project_root = args.project_root or "."
+
+        print(f"  Target Coverage: {target_coverage}%")
+        print(f"  Project Root: {project_root}")
+        print()
+        print("  🔍 Stage 1: Coverage Gap Analysis")
+        print("  🔨 Stage 2: Test Generation")
+        print("  ✅ Stage 3: Test Validation")
+        print()
+
+        # Create workflow
+        workflow = TestCoverageBoostWorkflow(
+            target_coverage=target_coverage,
+            project_root=project_root,
+            save_patterns=True,
+        )
+
+        # Execute workflow
+        context = {
+            "current_coverage": args.current_coverage or 0.0,
+        }
+
+        try:
+            result = asyncio.run(workflow.execute(context))
+
+            # Display results
+            print()
+            print("  📊 RESULTS")
+            print("  " + "-" * 56)
+            print()
+
+            # Analysis stage
+            print("  ✓ Stage 1: Coverage Analysis")
+            print(f"    Current Coverage: {result.analysis.current_coverage:.1f}%")
+            print(f"    Gaps Identified: {len(result.analysis.gaps)}")
+            print(f"    Recommendations: {len(result.analysis.recommendations)}")
+            print()
+
+            # Generation stage
+            print("  ✓ Stage 2: Test Generation")
+            print(f"    Tests Generated: {result.generation.tests_generated}")
+            print(f"    Expected Delta: +{result.generation.coverage_delta:.1f}%")
+            print(f"    Test Files: {len(result.generation.test_files)}")
+            print()
+
+            # Validation stage
+            print("  ✓ Stage 3: Test Validation")
+            print(f"    All Tests Passed: {'✅ Yes' if result.validation.all_passed else '❌ No'}")
+            print(f"    Final Coverage: {result.validation.final_coverage:.1f}%")
+            print(f"    Improvement: +{result.validation.coverage_improvement:.1f}%")
+            print()
+
+            # Quality gates
+            print("  🎯 QUALITY GATES")
+            print("  " + "-" * 56)
+            if result.quality_gates_passed:
+                print("  ✅ All quality gates passed!")
+            else:
+                print("  ❌ Quality gates not met")
+                if result.validation.final_coverage < target_coverage:
+                    print(
+                        f"     - Coverage below target ({result.validation.final_coverage:.1f}% < {target_coverage}%)"
+                    )
+                if not result.validation.all_passed:
+                    print(f"     - {len(result.validation.failures)} tests failed")
+                if result.validation.coverage_improvement < 10.0:
+                    print(
+                        f"     - Improvement too small ({result.validation.coverage_improvement:.1f}% < 10%)"
+                    )
+            print()
+
+            # Execution time
+            print(f"  ⏱️  Execution Time: {result.execution_time:.1f}s")
+            print()
+
+            if result.success:
+                print("  ✅ Workflow completed successfully!")
+            else:
+                print("  ❌ Workflow failed")
+                if result.errors:
+                    print(f"     Errors: {', '.join(result.errors)}")
+
+        except Exception as e:
+            print(f"  ❌ Error executing workflow: {e}")
+            print()
+            logger.exception("Orchestration workflow failed")
+            return 1
+
+    else:
+        print(f"  ❌ Unknown workflow type: {workflow_type}")
+        print()
+        print("  Available workflows:")
+        print("    - release-prep: Release readiness validation (parallel agents)")
+        print("    - test-coverage: Boost test coverage through sequential agent composition")
+        print()
+        return 1
+
+    print()
+    print("=" * 60)
+    print()
+
+    return 0
+
+
 def cmd_init(args):
     """Initialize a new Empathy Framework project
 
@@ -3293,6 +3469,59 @@ def main():
     )
     parser_tier_stats.set_defaults(func=cmd_tier_stats)
 
+    # Orchestrate command (meta-orchestration workflows)
+    parser_orchestrate = subparsers.add_parser(
+        "orchestrate",
+        help="Run meta-orchestration workflows (test-coverage, release-prep)",
+    )
+    parser_orchestrate.add_argument(
+        "workflow",
+        choices=["test-coverage", "release-prep"],
+        help="Workflow to execute",
+    )
+    parser_orchestrate.add_argument(
+        "--target",
+        type=float,
+        help="Target coverage percentage (for test-coverage workflow, default: 80)",
+    )
+    parser_orchestrate.add_argument(
+        "--current-coverage",
+        type=float,
+        help="Current coverage percentage (default: 0)",
+    )
+    parser_orchestrate.add_argument(
+        "--project-root",
+        default=".",
+        help="Project root directory (default: current directory)",
+    )
+    # Release-prep workflow arguments
+    parser_orchestrate.add_argument(
+        "--path",
+        default=".",
+        help="Path to codebase to analyze (for release-prep, default: current directory)",
+    )
+    parser_orchestrate.add_argument(
+        "--min-coverage",
+        type=float,
+        help="Minimum test coverage threshold (for release-prep, default: 80.0)",
+    )
+    parser_orchestrate.add_argument(
+        "--min-quality",
+        type=float,
+        help="Minimum code quality score (for release-prep, default: 7.0)",
+    )
+    parser_orchestrate.add_argument(
+        "--max-critical",
+        type=float,
+        help="Maximum critical security issues (for release-prep, default: 0)",
+    )
+    parser_orchestrate.add_argument(
+        "--json",
+        action="store_true",
+        help="Output results as JSON",
+    )
+    parser_orchestrate.set_defaults(func=cmd_orchestrate)
+
     # Wizard Factory commands (create wizards 12x faster)
     add_wizard_factory_commands(subparsers)
 

empathy_os/orchestration/__init__.py

@@ -0,0 +1,32 @@
+"""Meta-orchestration system for dynamic agent composition.
+
+This package provides the infrastructure for dynamically composing
+agent teams based on task requirements. It enables intelligent task
+analysis, agent spawning, and execution strategy selection.
+
+Example:
+    >>> from empathy_os.orchestration import AgentTemplate, get_template
+    >>> template = get_template("test_coverage_analyzer")
+    >>> print(template.role)
+    Test Coverage Expert
+"""
+
+from empathy_os.orchestration.agent_templates import (
+    AgentCapability,
+    AgentTemplate,
+    ResourceRequirements,
+    get_all_templates,
+    get_template,
+    get_templates_by_capability,
+    get_templates_by_tier,
+)
+
+__all__ = [
+    "AgentTemplate",
+    "AgentCapability",
+    "ResourceRequirements",
+    "get_template",
+    "get_all_templates",
+    "get_templates_by_capability",
+    "get_templates_by_tier",
+]