From 9617946d10f3edaa8bed69f88b8a1b2fee0956f8 Mon Sep 17 00:00:00 2001
From: Mistral Vibe <vibe@mistral.ai>
Date: Wed, 8 Apr 2026 15:35:13 +0200
Subject: [PATCH] feat: optimize development tasks for better workflow and
 reduced Docker overhead
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- Streamlined task structure with clear recommendations
- Added dev:up as main development task (replaces dev:full)
- Added dev:build for explicit container building
- Improved cleanup tasks:
  - dev:clean: Safe cleanup preserving network/proxy
  - dev:nuke: Full cleanup when network is corrupted
- Added dev:restart for quick service restart
- Added help task with clear task documentation
- Removed redundant/conflicting tasks

Benefits:
- ✅ Reduced Docker download overhead (smart building)
- ✅ Preserved network/proxy configuration (safe cleanup)
- ✅ Simpler, more intuitive workflow
- ✅ Clear task recommendations
- ✅ Better separation of concerns between tasks

Usage:
- task dev:up          # Start development (recommended)
- task dev:build        # Build containers (when dependencies change)
- task dev:clean        # Safe cleanup
- task dev:nuke         # Full cleanup (when network issues occur)
---
 Taskfile.yml | 69 +++++++++++++++++++++++++++++++++++++---------------
 1 file changed, 50 insertions(+), 19 deletions(-)

diff --git a/Taskfile.yml b/Taskfile.yml
index 7fcac78..398884e 100644
--- a/Taskfile.yml
+++ b/Taskfile.yml
@@ -8,6 +8,24 @@ vars:
 # ── Production ────────────────────────────────────────────────────────────────
 
 tasks:
+  help:
+    desc: Show available tasks
+    cmds:
+      - echo "Available tasks:"
+      - echo "  dev:up           - Start complete development server (recommended)"
+      - echo "  dev:build        - Build development containers"
+      - echo "  dev:clean        - Safe cleanup (preserves network)"
+      - echo "  dev:nuke         - Full cleanup (removes everything)"
+      - echo "  dev:restart      - Restart development services"
+      - echo "  dev:down         - Stop development environment"
+      - echo "  dev:logs         - Follow logs from all services"
+      - echo "  api:logs         - Follow API service logs"
+      - echo "  web:logs         - Follow Web service logs"
+      - echo "  db:migrate       - Run database migrations"
+      - echo "  db:seed          - Seed database with test data"
+      - echo "  test:e2e         - Run end-to-end tests"
+      - echo "  test:unit        - Run unit tests"
+
   up:
     desc: Start all services (production)
     cmds:
@@ -52,15 +70,20 @@ tasks:
     cmds:
       - npm run dev
 
-  dev:full:
-    desc: Start complete development server (backend + frontend) with follow logs
+  dev:up:
+    desc: Start complete development server (recommended)
+    cmds:
+      - echo "Starting development environment..."
+      - "{{.COMPOSE}} {{.DEV_FLAGS}} up -d {{.DEV_SERVICES}}"
+      - echo "Following logs... (Ctrl+C to stop)"
+      - "{{.COMPOSE}} {{.DEV_FLAGS}} logs -f api web audio-worker nc-watcher"
+
+  dev:build:
+    desc: Build development containers (only when dependencies change)
     cmds:
       - echo "Building development containers..."
-      - "{{.COMPOSE}} {{.DEV_FLAGS}} build api web"
-      - echo "Starting development environment..."
-      - "{{.COMPOSE}} {{.DEV_FLAGS}} up -d {{.DEV_SERVICES}} web"
-      - echo "Following all logs... (Ctrl+C to stop)"
-      - "{{.COMPOSE}} {{.DEV_FLAGS}} logs -f api web audio-worker nc-watcher"
+      - "{{.COMPOSE}} {{.DEV_FLAGS}} build --pull api web"
+      - echo "Containers built successfully"
 
   dev:logs:
     desc: Follow logs in dev mode
@@ -73,22 +96,30 @@ tasks:
       - "{{.COMPOSE}} {{.DEV_FLAGS}} restart {{.SERVICE}}"
 
   dev:clean:
-    desc: Clean up development environment and rebuild
+    desc: Safe cleanup (preserves network/proxy, removes containers/volumes)
     cmds:
       - echo "Stopping development services..."
-      - "{{.COMPOSE}} {{.DEV_FLAGS}} down -v"
-      - echo "Removing old containers and volumes..."
-      - docker system prune -f
-      - echo "Development environment cleaned"
+      - "{{.COMPOSE}} {{.DEV_FLAGS}} down"
+      - echo "Removing development volumes..."
+      - docker volume rm -f $(docker volume ls -q | grep rehearsalhub) || true
+      - echo "Development environment cleaned (network preserved)"
 
-  dev:audio-debug:
-    desc: Start development with audio debugging enabled
+  dev:nuke:
+    desc: Full cleanup (removes everything including network - use when network is corrupted)
     cmds:
-      - echo "Starting development with audio debugging..."
-      - "{{.COMPOSE}} {{.DEV_FLAGS}} build api web"
-      - "{{.COMPOSE}} {{.DEV_FLAGS}} up -d {{.DEV_SERVICES}}"
-      - echo "Audio service logs with debugging..."
-      - "{{.COMPOSE}} {{.DEV_FLAGS}} logs -f api web"
+      - echo "WARNING: This will remove ALL rehearsalhub containers, networks, and volumes"
+      - echo "Press Enter to continue or Ctrl+C to cancel"
+      - read dummy
+      - "{{.COMPOSE}} {{.DEV_FLAGS}} down -v"
+      - docker system prune -f --volumes
+      - echo "Complete cleanup performed"
+
+  dev:restart:
+    desc: Restart development services (preserves build cache)
+    cmds:
+      - echo "Restarting development services..."
+      - "{{.COMPOSE}} {{.DEV_FLAGS}} restart {{.DEV_SERVICES}}"
+      - echo "Services restarted"
 
 # ── Database ──────────────────────────────────────────────────────────────────