# Quick Reference - CI/CD Commands

## Pre-Commit Workflow

```bash
# Before committing
make pre-commit        # Quick check + warning count

# Before creating PR
make pre-merge         # Full CI validation locally
```

## Common Development Commands

### Quality Checks
```bash
make check-all         # All quality gates
make check             # Compilation only
make clippy            # Lint checks
make fmt               # Format code
make warnings          # Count warnings
```

### Testing
```bash
make test              # All tests
make test-unit         # Unit tests only
make test-fast         # Skip external deps
make coverage          # Generate coverage report
```

### Security
```bash
make audit             # Security audit
make outdated          # Check outdated deps
```

### Build & Run
```bash
make build             # Debug build
make build-release     # Release build
make run-trading       # Run trading service
make run-tli           # Run terminal interface
```

### Cleanup
```bash
make clean             # Clean build artifacts
make clean-all         # Deep clean
```

## CI/CD Workflows

### GitHub Actions Triggers

**Main CI (ci.yml)**:
- Push to: main, master, develop
- Pull requests to: main, master
- Runs: compilation, tests, coverage, security

**Security Audit (security.yml)**:
- Daily at midnight UTC
- Push to: main, master
- Manual trigger available

**Financial Security (financial-security-audit.yml)**:
- Weekly on Mondays
- Push to: main, master, develop
- Pull requests to: main, master

## Quality Standards

### Zero Tolerance
- ❌ Compilation errors
- ❌ Clippy warnings
- ❌ Security vulnerabilities
- ❌ Placeholder code (TODO, FIXME)
- ❌ Formatting issues

### Thresholds
- ⚠️ Max 50 warnings workspace-wide
- 📊 Code coverage targets enforced
- 🔒 No known security vulnerabilities

## Troubleshooting

### Fix Common Issues
```bash
make fix               # Auto-fix clippy + fmt issues
make clean-rebuild     # Clean and rebuild from scratch
```

### Check Specific Issue
```bash
cargo check            # Compilation errors
cargo clippy           # Lint warnings
cargo test -- --nocapture  # Test failures
cargo audit            # Security issues
```

## Tool Installation

```bash
# Install all dev tools
make install-tools

# Individual tools
cargo install cargo-audit
cargo install cargo-tarpaulin
cargo install cargo-deny
cargo install cargo-outdated
cargo install just
```

## Environment Info

```bash
make env-info          # Show environment details
make stats             # Project statistics
make help              # Show all commands
```

## File Locations

- **CI workflows**: `.github/workflows/`
- **Local commands**: `Makefile`, `justfile`
- **Documentation**: `CI_CD_SETUP.md`
- **Verification**: `scripts/verify_ci_setup.sh`

---

**Tip**: Run `make help` to see all available commands!