@defai.digital/automatosx 5.3.3 → 5.3.4

package/CHANGELOG.md

@@ -5,6 +5,101 @@ All notable changes to AutomatosX will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [5.3.4] - 2025-10-14
+
+### 🚀 Enhanced Delegation Depth for Coordinators (Phase 2 Pilot)
+
+**This release implements Phase 2 of the user-requested delegation enhancements, increasing delegation depth from 1-2 to 3 layers for coordinator agents while maintaining robust safety mechanisms.**
+
+#### Added
+
+- **3-Layer Delegation Support**:
+  - **CTO (Tony)**: Strategic coordinator (`maxDelegationDepth: 3`) - orchestrate multi-phase technical initiatives
+    - Layer 1: Direct delegation to implementation teams
+    - Layer 2: Coordinated cross-team initiatives
+    - Layer 3: Strategic multi-phase projects with sub-coordination
+  - **DevOps (Oliver)**: Infrastructure coordinator (`maxDelegationDepth: 3`) - manage complex deployment pipelines
+    - Layer 1: Direct delegation to development teams
+    - Layer 2: Cross-team infrastructure initiatives
+    - Layer 3: Complex deployment pipelines with multiple coordination points
+  - **Data Scientist (Dana)**: Data science coordinator (`maxDelegationDepth: 3`) - orchestrate end-to-end ML workflows
+    - Layer 1: Direct delegation to data engineer, backend, quality
+    - Layer 2: Cross-functional analytics initiatives
+    - Layer 3: End-to-end ML pipelines with multiple coordination points
+
+- **Improved Depth Enforcement Logic** (`src/agents/executor.ts:755-757`):
+  - Changed depth checking from `fromAgent` to delegation chain `initiator`
+  - Allows coordinators to delegate through implementers without hitting depth limits
+  - Example: CTO (depth 3) → Backend (depth 1) → Frontend (depth 1) → Done ✅
+  - Previously would fail at 2nd delegation due to Backend's depth 1 limit ❌
+
+- **Comprehensive Test Coverage**:
+  - Created `tests/unit/executor-delegation-depth-3.test.ts` with 15 new tests
+  - 5 tests for 3-layer success scenarios
+  - 3 tests for 4-layer rejection (exceeds limit)
+  - 3 tests for backward compatibility
+  - 2 tests for cycle detection at 3 layers
+  - 2 tests for delegation chain tracking
+  - **All 1,717 tests passing** (100% pass rate)
+
+#### Changed
+
+- **Agent Configuration Updates**:
+  - `.automatosx/agents/cto.yaml`: `maxDelegationDepth: 1 → 3` (strategic coordinator)
+  - `.automatosx/agents/devops.yaml`: `maxDelegationDepth: 0 → 3` (infrastructure coordinator)
+  - `.automatosx/agents/data-scientist.yaml`: `maxDelegationDepth: 1 → 3` (data science coordinator)
+  - Updated system prompts to reflect new coordinator roles
+
+- **Delegation Safety**:
+  - Existing cycle detection continues to work at all depth levels
+  - 4-layer delegation attempts are rejected with clear error messages
+  - Implementer agents (Backend, Frontend, etc.) remain at `maxDelegationDepth: 1`
+
+#### Fixed
+
+- **Windows Provider Detection** (`src/providers/base-provider.ts`):
+  - Fixed provider CLI detection on Windows by using cross-platform `findOnPath()` from `cli-provider-detector`
+  - Previously, `spawn('claude', ['--version'])` would fail on Windows because Node.js doesn't auto-append `.cmd` extension
+  - Now uses `where.exe` + PATH×PATHEXT fallback for proper Windows detection
+  - **Impact**: Providers installed via npm on Windows (e.g., `claude.cmd`) are now correctly detected
+  - **Issue**: Users could run `claude` in terminal but AutomatosX showed "provider unavailable"
+
+#### Documentation
+
+- **CLAUDE.md**: Updated Agent Directory & Governance section with v5.3.4 enhancements
+- **CHANGELOG.md**: This entry documenting all Phase 2 changes
+
+#### Technical Details
+
+**Depth Enforcement Change** (Breaking for test implementations, not user-facing):
+
+```typescript
+// Before (v5.3.3 and earlier):
+const maxDepth = fromAgentProfile.orchestration?.maxDelegationDepth ?? 2;
+
+// After (v5.3.4):
+const initiatorName = delegationChain.length > 0 ? delegationChain[0] : request.fromAgent;
+const initiatorProfile = await this.profileLoader.loadProfile(initiatorName);
+const maxDepth = initiatorProfile.orchestration?.maxDelegationDepth ?? 2;
+```
+
+**Impact**: Allows coordinators to orchestrate deep delegation chains through implementers without hitting depth limits. Implementers can still only delegate once, but coordinator's depth limit applies to the entire chain.
+
+#### Performance
+
+- No performance impact: Logic change is O(1) (single profile lookup)
+- All existing tests passing (1,717 tests, 100% pass rate)
+- Test execution time: ~50s (no regression)
+
+#### Migration
+
+**100% Backward Compatible** - No action required for existing deployments:
+
+- Default `maxDelegationDepth` remains 2 for agents without orchestration config
+- Implementer agents (Backend, Frontend, etc.) remain at depth 1
+- Only 3 coordinator agents updated to depth 3 (CTO, DevOps, Data Scientist)
+- Existing delegation logic fully preserved
+
 ## [5.3.3] - 2025-10-14
 
 ### 🏗️ Foundation for Agent Optimization

package/README.md

@@ -7,9 +7,9 @@
 [![npm version](https://img.shields.io/npm/v/@defai.digital/automatosx.svg)](https://www.npmjs.com/package/@defai.digital/automatosx)
 [![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE)
 [![TypeScript](https://img.shields.io/badge/TypeScript-100%25-blue.svg)](https://www.typescriptlang.org/)
-[![Tests](https://img.shields.io/badge/tests-1,657%20passing-brightgreen.svg)](#)
+[![Tests](https://img.shields.io/badge/tests-1,717%20passing-brightgreen.svg)](#)
 
-**Status**: ✅ Production Ready · v5.3.3 · October 2025
+**Status**: ✅ Production Ready · v5.3.4 · October 2025
 
 Looking for answers? See the [FAQ](FAQ.md).
 
@@ -179,6 +179,7 @@ Product response:
 ## 🎭 12 Specialized Agents with Clear Governance
 
 **v5.0.12 introduces strict role ownership and delegation controls to eliminate cycles**:
+**v5.3.4 Phase 2 Pilot**: 3 coordinator agents now support 3-layer delegation for complex multi-phase workflows
 
 ### 💻 Engineering Team (Implementers)
 **maxDelegationDepth: 1** - Can delegate once for cross-domain needs, no re-delegation
@@ -186,12 +187,16 @@ Product response:
   - Can delegate to: frontend, data, security, quality, devops
 - **Frank** (frontend) - Component architecture, state management, accessibility
   - Can delegate to: backend, design, security, quality, devops
-- **Oliver** (devops) - Infrastructure as code, CI/CD pipelines, observability
+- **Oliver** (devops) - **🆕 v5.3.4: Infrastructure Coordinator (depth 3)** - Orchestrate complex deployment pipelines
   - Can delegate to: backend, frontend, security, quality
+  - 3-layer capability for multi-phase infrastructure workflows
 - **Daisy** (data) - Data modeling, ETL pipelines, SQL optimization
   - Can delegate to: backend, security, quality
 - **Steve** (security) - **Sole owner** of security-audit, threat modeling, secure coding review
   - Can delegate to: backend, frontend, devops, quality
+- **Dana** (data-scientist) - **🆕 v5.3.4: Data Science Coordinator (depth 3)** - End-to-end ML pipelines
+  - Can delegate to: data, backend, quality
+  - 3-layer capability for complex data science workflows
 
 ### 🎯 Quality Team (Coordinator Role)
 **maxDelegationDepth: 1** - Can delegate fixes back to implementers, no re-delegation
@@ -206,13 +211,16 @@ Product response:
   - Can delegate to: backend, frontend, design, quality
 
 ### 📊 Leadership Team (Coordinators)
-**maxDelegationDepth: 1** - Delegate to implementers, focus on strategy, no re-delegation
+**maxDelegationDepth: 1-3** - Delegate to implementers, focus on strategy
 - **Paris** (product) - Product strategy, feature planning, roadmap
   - Can delegate to: backend, frontend, design, writer, quality
+  - maxDelegationDepth: 1
 - **Eric** (ceo) - Business strategy, organizational leadership
   - Can delegate to: paris, tony, all agents
-- **Tony** (cto) - Technology strategy, technical leadership
+  - maxDelegationDepth: 1
+- **Tony** (cto) - **🆕 v5.3.4: Strategic Coordinator (depth 3)** - Multi-phase technical initiatives
   - Can delegate to: backend, frontend, devops, security, quality
+  - 3-layer capability for strategic technology projects with sub-coordination
 
 ### 🔬 Research Team (Specialist)
 **maxDelegationDepth: 0** - Execute research work directly, no delegation
@@ -222,6 +230,8 @@ Product response:
 
 **New in v5.0.12**: Each agent has role-specific workflow stages, smart ability loading (abilitySelection), and explicit delegation scopes. Most agents have `maxDelegationDepth: 1` to allow cross-domain collaboration while preventing delegation cycles.
 
+**New in v5.3.4 (Phase 2 Pilot)**: 3 coordinator agents (Tony/CTO, Oliver/DevOps, Dana/Data Scientist) now support `maxDelegationDepth: 3` for orchestrating complex multi-layer workflows. This enables strategic coordination of multi-phase projects while maintaining safety through depth limits and cycle detection.
+
 [📖 Complete Agent Directory](examples/AGENTS_INFO.md)
 
 ---