.windsurf

# MAIASS - AI Context

## Project Purpose
Node.js replica of MAIASS Bash script (`maiass.sh`). Converting 109KB+ Bash workflow automation to modern Node.js CLI.

## AI Assistant Guidelines

### Critical Rules
1. **Always update `docs/README.maiass.md`** when making significant changes
2. **Use ES module syntax** (`import`/`export`) throughout
3. **Cross-platform compatibility** required for all features
4. **Preserve original MAIASS functionality** while modernizing

### Technical Patterns
- **Colors**: `chalk.bold(chalk.cyan(text))` (Chalk v5+ compatible)
- **Paths**: Always use `path.join()` for cross-platform support
- **Config**: Multi-source loading via `lib/config.js`
- **CLI**: yargs-based command structure

### Key Files
- `maiass.js` - Main CLI entry (ES modules)
- `lib/config.js` - Cross-platform environment loading
- `lib/colors.js` - Chalk v5+ color utilities
- `docs/README.maiass.md` - **MUST KEEP UPDATED**

### Environment Loading Priority
1. `.env` (project)
2. `.maiass.env` (user home)
3. `config.env` (OS config dir)
4. `secure.env` (OS secure dir)

### Current State
- ✅ Basic CLI with `hello` command
- ✅ Cross-platform config system
- ✅ Comprehensive documentation
- 🔄 Porting additional MAIASS commands

### Testing
```bash
nma hello  # Basic test
node setup-env.js  # Environment setup
```

### Related Locations
- Original: `/Users/sysop/static/maiass-whole/maiass/maiass.sh`
- Test repo: `/Users/sysop/static/dummy-repos-for-tests/wordpress-repo`