feat(teams): implement comprehensive teams editing phase 2 functionality

[tbrandenburg]

Problem

The work CLI needed comprehensive teams editing capabilities beyond basic CRUD operations. Users required:

• Programmatic control over team lifecycle management
• Safe editing operations with backup/restore functionality
• Granular member management (agents and humans)
• Bulk import/export capabilities
• Robust error handling and validation

Solution

Implemented Teams Editing Phase 2 functionality providing complete programmatic control over team management through both CLI commands and core engine methods.

Changes Made

Core Engine Extensions (src/core/teams-engine.ts)

• 9 new CRUD methods: createTeam, updateTeam, deleteTeam, addAgentToTeam, editTeamAgent, removeAgentFromTeam, addHumanToTeam, editTeamHuman, removeHumanFromTeam
• Backup functionality: Automatic backup creation before destructive operations
• Atomic operations: Rollback support with comprehensive error handling
• Input validation: Rigorous validation for all team data and member operations

New Error Types (src/types/errors.ts)

• TeamEditingError: Base error class for all teams editing operations
• DuplicateTeamIdError: Specific error for duplicate team ID conflicts
• TeamNotFoundError: Error when referencing non-existent teams
• InvalidTeamDataError: Validation error for malformed team data

Request/Response Types (src/types/teams.ts)

• 6 new TypeScript interfaces for strongly typed CRUD operations
• Support for partial updates and batch operations
• Comprehensive type safety throughout the editing pipeline

CLI Commands (11 new commands)

Team Management:

• work teams create: Create new teams with validation and confirmation
• work teams edit: Edit existing team metadata with backup
• work teams remove: Remove teams with --force and --no-backup flags

Agent Management:

• work teams add-agent: Add AI agents to teams with role assignment
• work teams edit-agent: Modify agent assignments and metadata
• work teams remove-agent: Remove agents with safety flags

Human Management:

• work teams add-human: Add human members with role and contact info
• work teams edit-human: Update human member details
• work teams remove-human: Remove human members with confirmation

Bulk Operations:

• work teams import: Import teams from JSON with validation
• work teams export: Export teams to JSON with formatting options

Test Coverage

Unit Tests (tests/unit/cli/commands/teams/crud.test.ts):

• 23 comprehensive test cases covering all CRUD operations
• Full mocking of file system operations and teams engine
• Error scenario testing and edge case coverage

Integration Tests (tests/integration/cli/commands/teams-editing.test.ts):

• 11 end-to-end workflow tests with temporary directories
• Real file system operations and command parsing
• Full CLI integration testing from command input to file output

Testing Results

✓ Unit Tests: 23/23 passed (100%)
✓ Integration Tests: 11/11 passed (100%) 
✓ Overall Test Suite: 362/362 passed (100%)
✓ TypeScript compilation: No errors
✓ ESLint: No violations

Example Usage

Create and manage a team:

work teams create --id "backend-team" --name "Backend Development Team"
work teams add-agent --team-id "backend-team" --agent-id "code-reviewer" --role "reviewer"
work teams add-human --team-id "backend-team" --name "Alice Smith" --email "alice@company.com" --role "lead"

Bulk operations:

work teams export --format json --output teams-backup.json
work teams import --file teams-config.json --validate

Safe removal:

work teams remove --id "old-team" --force --no-backup

Safety Features

• Backup creation: Automatic backups before all destructive operations
• Force flags: --force to bypass confirmations for automation
• No-backup flags: --no-backup for performance-critical scenarios
• Input validation: Comprehensive validation and sanitization
• Error recovery: Rollback capabilities for failed operations

Notes

• All commands follow conventional CLI patterns with consistent flag naming
• Full backward compatibility maintained with existing teams functionality
• Comprehensive error messages guide users through resolution steps
• Ready for production use with complete test coverage and documentation

This completes Teams Editing Phase 2 as planned, providing the foundation for advanced team management workflows.