@cloudkinetix/bmad-enhanced/ck-layer/lib/README.md

Cloud-Kinetix enhanced fork of BMAD-METHOD - Breakthrough Method of Agile AI-driven Development with robust versioning and unified validation.

# Core Library Modules

## Enterprise Features

- **`enterprise-manager.js`** - Manages enterprise feature installation and lifecycle
- **`enhanced-commands.js`** - CLI command implementations (install-all, status, backup)

## Backup System

- **`bmad-backup-manager.js`** - Professional backup system with integrity verification
- **`bmad-config-merger.js`** - Smart configuration merging and overlay system

## Core Infrastructure

- **`config-loader.js`** - Configuration loading and validation
- **`bmad-installer-wrapper.js`** - Wraps upstream BMAD installer for dependency handling
- **`ide-discovery.js`** - **Auto-discovery system for IDEs and expansion packs (Future-Proof)**
- **`file-manager.js`** - File operations and management
- **`dependency-resolver.js`** - Dependency resolution and management
- **`ide-setup.js`** - IDE-specific setup (Cursor, VS Code, etc.)

## Auto-Discovery System (NEW)

**`ide-discovery.js`** - Revolutionary auto-discovery makes the system completely future-proof:

### Key Innovation

Instead of hardcoded lists, the system **dynamically discovers** available IDEs and expansion packs:

```javascript
const ideDiscovery = require("./ide-discovery");

// Auto-discover IDEs from config file
const ides = await ideDiscovery.getAvailableIDEs();
// Returns: ['cursor', 'claude-code', 'windsurf', 'roo', 'cline', 'gemini']

// Auto-discover expansion packs from filesystem
const packs = await ideDiscovery.getAvailableExpansionPacks();
// Returns: ['bmad-jira-integration', 'ck-ai-agent-dev', 'ck-jira-integration', 'ck-parallel-dev']

// Validate requests
const isValid = ideDiscovery.validateIDERequest(["cursor", "claude-code"]);
// Returns: { valid: true, invalid: [] }
```

### Benefits

- ✅ **Future-Proof** - New IDEs/packs auto-discovered without code changes
- ✅ **Dynamic** - System adapts to available configuration
- ✅ **Maintainable** - Zero hardcoded lists to maintain
- ✅ **Extensible** - Easy to add new IDE/expansion pack support

### Testing

Auto-discovery is fully tested with 8 comprehensive test cases covering all scenarios.

## Architecture Pattern

```
Enhanced Commands → Enterprise Manager → BMAD Delegate → Upstream BMAD
                 ↓                    ↓
             Backup Manager    Config Merger
                 ↓                    ↓
            File Manager        Config Loader
                 ↓
           IDE Discovery (Auto-detect IDEs/Packs)
```

## Test Coverage

- **bmad-backup-manager.js**: 90.75% (enterprise-grade)
- **bmad-config-merger.js**: 82.25% (good coverage)
- **enhanced-commands.js**: 4.97% (CLI interface - normal)