npm package: @git.zone/cli
Description: A comprehensive CLI tool for enhancing and managing local development workflows with gitzone utilities, focusing on project setup, version control, code formatting, and template management.
Author: Task Venture Capital GmbH
Latest version: 2.13.15

# GitZone Services Command Implementation Plan

## Overview

Implement the `gitzone services` command to manage MongoDB and MinIO containers for development projects.

## Tasks

### Module Structure Setup

- [x] Create `ts/mod_services/` directory
- [x] Create `mod.plugins.ts` with required imports
- [x] Create `helpers.ts` with utility functions
- [x] Create `classes.serviceconfiguration.ts` for config handling
- [x] Create `classes.dockercontainer.ts` for Docker operations
- [x] Create `classes.servicemanager.ts` for service management
- [x] Create `index.ts` with main command logic

### Core Functionality

- [x] Implement ServiceConfiguration class
  - [x] Load/create `.nogit/env.json` configuration
  - [x] Generate random available ports (20000-30000 range)
  - [x] Preserve existing custom values
  - [x] Provide default values for missing fields

- [x] Implement DockerContainer class
  - [x] Check container status
  - [x] Start/stop/restart containers
  - [x] Execute Docker commands
  - [x] Handle container logs
  - [x] Manage volumes and port bindings

- [x] Implement ServiceManager class
  - [x] Manage MongoDB containers
  - [x] Manage MinIO containers
  - [x] Handle container lifecycle
  - [x] Generate project-specific container names
  - [x] Manage data directories in `.nogit/`
  - [x] Generate MongoDB Compass connection strings

### Commands Implementation

- [x] `start` command - Start services (mongo|s3|all)
- [x] `stop` command - Stop services (mongo|s3|all)
- [x] `restart` command - Restart services (mongo|s3|all)
- [x] `status` command - Show service status
- [x] `config` command - Show current configuration
- [x] `compass` command - Show MongoDB Compass connection string
- [x] `logs` command - Show service logs with line count
- [x] `remove` command - Remove containers (preserve data)
- [x] `clean` command - Remove containers and data

### Integration

- [x] Add `@push.rocks/smartshell` to main plugins.ts
- [x] Add `@push.rocks/smartnetwork` to main plugins.ts
- [x] Add `@push.rocks/smartinteraction` to main plugins.ts
- [x] Register services command in `gitzone.cli.ts`

### Features

- [x] Auto-configuration with smart defaults
- [x] Random port assignment to avoid conflicts
- [x] Project isolation with unique container names
- [x] Data persistence in `.nogit/` directories
- [x] Status display (running/stopped/not installed)
- [x] Interactive confirmations for destructive operations
- [x] Colored console output
- [x] MinIO bucket auto-creation
- [x] MongoDB Compass connection string with network IP

### Testing

- [ ] Test service start/stop operations
- [ ] Test configuration creation and updates
- [ ] Test port collision handling
- [ ] Test data persistence
- [ ] Test MongoDB Compass connection string generation
- [ ] Test all command variations

## Configuration Format

```json
{
  "PROJECT_NAME": "derived-from-package-name",
  "MONGODB_HOST": "localhost",
  "MONGODB_NAME": "project-name",
  "MONGODB_PORT": "random-port",
  "MONGODB_USER": "defaultadmin",
  "MONGODB_PASS": "defaultpass",
  "S3_HOST": "localhost",
  "S3_PORT": "random-port",
  "S3_CONSOLE_PORT": "s3-port+1",
  "S3_USER": "defaultadmin",
  "S3_PASS": "defaultpass",
  "S3_BUCKET": "project-name-documents"
}
```

## Command Examples

```bash
gitzone services start          # Start all services
gitzone services start mongo    # Start only MongoDB
gitzone services stop           # Stop all services
gitzone services status         # Check service status
gitzone services config         # Show configuration
gitzone services compass        # Show MongoDB Compass connection string
gitzone services logs mongo 50  # Show last 50 lines of MongoDB logs
gitzone services remove         # Remove containers (preserve data)
gitzone services clean          # Remove containers and data
```

## Progress Notes

Implementation started: 2025-08-14
Implementation completed: 2025-08-14

## Summary

Successfully implemented the `gitzone services` command in TypeScript, providing a complete replacement for the `services.sh` shell script. The implementation includes:

1. **Complete Docker service management** for MongoDB and MinIO containers
2. **Smart configuration management** with automatic port assignment and conflict avoidance
3. **MongoDB Compass support** with network IP detection for remote connections
4. **Project isolation** using project-specific container names
5. **Data persistence** in `.nogit/` directories
6. **Interactive confirmations** for destructive operations
7. **Comprehensive command set** including start, stop, restart, status, config, compass, logs, remove, and clean commands

The module is fully integrated into the gitzone CLI and ready for testing.