@orchestrator-claude/cli 3.1.12 → 3.2.1

package/dist/templates/base/docker-compose.yml.hbs

@@ -1,19 +1,200 @@
+# docker-compose.yml — Generated by orchestrator init
+# Stack: PostgreSQL (state) + MinIO (artifacts) + Neo4j (knowledge graph, optional) + API
+#
+# Ports:
+#   API:        http://localhost:3001   (orchestrator REST API + MCP server)
+#   PostgreSQL: localhost:5432          (workflow state - direct access)
+#   MinIO S3:   http://localhost:9000   (artifact storage - S3 API)
+#   MinIO UI:   http://localhost:9001   (MinIO console)
+#   Neo4j HTTP: http://localhost:7474   (knowledge graph browser - requires --profile knowledge-graph)
+#   Neo4j Bolt: bolt://localhost:7687   (knowledge graph driver - requires --profile knowledge-graph)
+#
+# Usage:
+#   docker compose up -d                           # Start core services (API + PostgreSQL)
+#   docker compose --profile object-storage up -d  # Add MinIO
+#   docker compose --profile knowledge-graph up -d # Add Neo4j
+#   docker compose --profile full up -d            # Start everything
+
 services:
+  postgres:
+    image: postgres:15-alpine
+    container_name: {{projectName}}-postgres
+    environment:
+      POSTGRES_DB: ${POSTGRES_DB:-orchestrator}
+      POSTGRES_USER: ${POSTGRES_USER:-orchestrator}
+      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
+    volumes:
+      - {{projectName}}-postgres-data:/var/lib/postgresql/data
+    ports:
+      - "${POSTGRES_PORT:-5432}:5432"  # PostgreSQL
+    healthcheck:
+      test: ["CMD-SHELL", "pg_isready -U ${POSTGRES_USER:-orchestrator} -d ${POSTGRES_DB:-orchestrator}"]
+      interval: 10s
+      timeout: 5s
+      retries: 5
+      start_period: 10s
+    restart: unless-stopped
+    networks:
+      - {{projectName}}-network
+
+  neo4j:
+    image: neo4j:5-community
+    container_name: {{projectName}}-neo4j
+    environment:
+      NEO4J_AUTH: neo4j/${NEO4J_PASSWORD:-orchestrator_neo4j}
+      NEO4J_PLUGINS: '["apoc"]'
+      NEO4J_dbms_memory_pagecache_size: 512M
+      NEO4J_dbms_memory_heap_initial__size: 512M
+      NEO4J_dbms_memory_heap_max__size: 1G
+      NEO4J_dbms_security_procedures_unrestricted: apoc.*
+      NEO4J_dbms_security_procedures_allowlist: apoc.*
+    ports:
+      - "${NEO4J_HTTP_PORT:-7474}:7474"   # Neo4j browser
+      - "${NEO4J_BOLT_PORT:-7687}:7687"   # Neo4j bolt
+    volumes:
+      - {{projectName}}-neo4j-data:/data
+      - {{projectName}}-neo4j-logs:/logs
+    healthcheck:
+      test: ["CMD", "wget", "-qO-", "http://localhost:7474"]
+      interval: 10s
+      timeout: 5s
+      retries: 5
+      start_period: 20s
+    restart: unless-stopped
+    networks:
+      - {{projectName}}-network
+    profiles:
+      - knowledge-graph
+      - full
+
+  minio:
+    image: minio/minio:latest
+    container_name: {{projectName}}-minio
+    command: server /data --console-address ":9001"
+    environment:
+      MINIO_ROOT_USER: ${MINIO_ROOT_USER:-minioadmin}
+      MINIO_ROOT_PASSWORD: ${MINIO_ROOT_PASSWORD}
+    ports:
+      - "${MINIO_S3_PORT:-9000}:9000"     # MinIO S3 API
+      - "${MINIO_CONSOLE_PORT:-9001}:9001" # MinIO console
+    volumes:
+      - {{projectName}}-minio-data:/data
+    healthcheck:
+      test: ["CMD", "curl", "-f", "http://localhost:9000/minio/health/live"]
+      interval: 10s
+      timeout: 5s
+      retries: 5
+      start_period: 10s
+    restart: unless-stopped
+    networks:
+      - {{projectName}}-network
+    profiles:
+      - object-storage
+      - full
+
+  minio-init:
+    image: minio/mc:latest
+    container_name: {{projectName}}-minio-init
+    depends_on:
+      minio:
+        condition: service_healthy
+    entrypoint: >
+      /bin/sh -c "
+      mc alias set myminio http://minio:9000 ${MINIO_ROOT_USER:-minioadmin} ${MINIO_ROOT_PASSWORD};
+      mc mb --ignore-existing myminio/orchestrator-static;
+      mc mb --ignore-existing myminio/orchestrator-artifacts;
+      mc anonymous set download myminio/orchestrator-static;
+      echo 'MinIO buckets initialized successfully';
+      exit 0;
+      "
+    networks:
+      - {{projectName}}-network
+    profiles:
+      - object-storage
+      - full
+    restart: "no"
+
+  db-migrate:
+    image: cmac01/orchestrator-api:{{orchestratorVersion}}
+    container_name: {{projectName}}-db-migrate
+    depends_on:
+      postgres:
+        condition: service_healthy
+    environment:
+      NODE_ENV: production
+      RUN_MIGRATIONS: "true"
+      PERSISTENCE_MODE: postgres
+      DATABASE_URL: postgresql://${POSTGRES_USER:-orchestrator}:${POSTGRES_PASSWORD}@postgres:5432/${POSTGRES_DB:-orchestrator}
+      POSTGRES_HOST: postgres
+      POSTGRES_PORT: "5432"
+      POSTGRES_DB: ${POSTGRES_DB:-orchestrator}
+      POSTGRES_USER: ${POSTGRES_USER:-orchestrator}
+      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
+    networks:
+      - {{projectName}}-network
+    restart: "no"
+
   orchestrator-api:
     image: cmac01/orchestrator-api:{{orchestratorVersion}}
     container_name: {{projectName}}-orchestrator-api
-    user: "${UID:-1000}:${GID:-1000}"
+    depends_on:
+      postgres:
+        condition: service_healthy
+      db-migrate:
+        condition: service_completed_successfully
+    env_file: .env
+    environment:
+      NODE_ENV: production
+      API_HOST: "0.0.0.0"
+      API_PORT: "3001"
+      PERSISTENCE_MODE: postgres
+      RUN_MIGRATIONS: "false"
+      # PostgreSQL connection (service name resolves within Docker network)
+      POSTGRES_HOST: postgres
+      POSTGRES_PORT: "5432"
+      DATABASE_URL: postgresql://${POSTGRES_USER:-orchestrator}:${POSTGRES_PASSWORD}@postgres:5432/${POSTGRES_DB:-orchestrator}
+      # MinIO object storage (requires --profile object-storage or --profile full)
+      ENABLE_OBJECT_STORAGE: "${ENABLE_OBJECT_STORAGE:-true}"
+      OBJECT_STORAGE_PROVIDER: minio
+      OBJECT_STORAGE_ENDPOINT: "http://minio:9000"
+      OBJECT_STORAGE_REGION: us-east-1
+      OBJECT_STORAGE_ACCESS_KEY: ${MINIO_ROOT_USER:-minioadmin}
+      OBJECT_STORAGE_SECRET_KEY: ${MINIO_ROOT_PASSWORD}
+      BUCKET_STATIC: orchestrator-static
+      BUCKET_ARTIFACTS: orchestrator-artifacts
+      # Neo4j knowledge graph (requires --profile knowledge-graph or --profile full)
+      NEO4J_URI: "${NEO4J_URI:-bolt://neo4j:7687}"
+      NEO4J_USER: "${NEO4J_USER:-neo4j}"
+      NEO4J_PASSWORD: "${NEO4J_PASSWORD:-orchestrator_neo4j}"
+      ENABLE_KNOWLEDGE_GRAPH: "${ENABLE_KNOWLEDGE_GRAPH:-false}"
+      # JWT Authentication
+      JWT_SECRET: ${JWT_SECRET}
     ports:
-      - "3001:3001"
+      - "3001:3001"  # Orchestrator REST API + MCP server
     volumes:
-      - .:/app/project:rw
-    environment:
-      - ORCHESTRATOR_ROOT=/app/project
-      - NODE_ENV=development
+      # Staging area for Artifact Relay Pattern (TD-039)
+      # Sub-agents write artifacts here; main agent relays to MinIO via MCP
+      - /tmp/orchestrator:/tmp/orchestrator
     healthcheck:
       test: ["CMD", "wget", "-q", "-O", "/dev/null", "http://127.0.0.1:3001/api/v1/health"]
       interval: 30s
-      timeout: 3s
-      start_period: 10s
+      timeout: 10s
       retries: 3
+      start_period: 15s
     restart: unless-stopped
+    networks:
+      - {{projectName}}-network
+
+volumes:
+  {{projectName}}-postgres-data:
+    driver: local
+  {{projectName}}-neo4j-data:
+    driver: local
+  {{projectName}}-neo4j-logs:
+    driver: local
+  {{projectName}}-minio-data:
+    driver: local
+
+networks:
+  {{projectName}}-network:
+    driver: bridge

package/dist/templates/base/mcp.json.hbs

@@ -3,22 +3,29 @@
   "mcpServers": {
     "orchestrator-tools": {
       "command": "npx",
-      "args": [
-        "@orchestrator-claude/mcp-server"
-      ],
+      "args": ["@orchestrator-claude/mcp-server"],
       "env": {
         "ORCHESTRATOR_API_URL": "http://localhost:3001",
-        "ORCHESTRATOR_ROOT": ".orchestrator",
+        "ORCHESTRATOR_PROJECT_ID": "{{projectId}}",
+        "ORCHESTRATOR_AUTH_EMAIL": "{{authEmail}}",
+        "ORCHESTRATOR_AUTH_PASSWORD": "{{authPassword}}",
+        "NODE_ENV": "production"
+      }
+    },
+    "orchestrator-extended": {
+      "command": "npx",
+      "args": ["@orchestrator-claude/mcp-server", "--server", "extended"],
+      "env": {
+        "ORCHESTRATOR_API_URL": "http://localhost:3001",
+        "ORCHESTRATOR_PROJECT_ID": "{{projectId}}",
+        "ORCHESTRATOR_AUTH_EMAIL": "{{authEmail}}",
+        "ORCHESTRATOR_AUTH_PASSWORD": "{{authPassword}}",
         "NODE_ENV": "production"
       }
     },
     "perplexity": {
       "command": "npx",
-      "args": [
-        "@orchestrator-claude/mcp-server",
-        "--server",
-        "perplexity"
-      ],
+      "args": ["@orchestrator-claude/mcp-server", "--server", "perplexity"],
       "env": {
         "ORCHESTRATOR_API_URL": "http://localhost:3001",
         "PERPLEXITY_API_KEY": "{{perplexityApiKey}}"

package/dist/templates/default/docker-compose.yml

@@ -1,20 +1,200 @@
-version: '3.8'
+# docker-compose.yml — Generated by orchestrator init
+# Stack: PostgreSQL (state) + MinIO (artifacts) + Neo4j (knowledge graph, optional) + API
+#
+# Ports:
+#   API:        http://localhost:3001   (orchestrator REST API + MCP server)
+#   PostgreSQL: localhost:5432          (workflow state - direct access)
+#   MinIO S3:   http://localhost:9000   (artifact storage - S3 API)
+#   MinIO UI:   http://localhost:9001   (MinIO console)
+#   Neo4j HTTP: http://localhost:7474   (knowledge graph browser - requires --profile knowledge-graph)
+#   Neo4j Bolt: bolt://localhost:7687   (knowledge graph driver - requires --profile knowledge-graph)
+#
+# Usage:
+#   docker compose up -d                           # Start core services (API + PostgreSQL)
+#   docker compose --profile object-storage up -d  # Add MinIO
+#   docker compose --profile knowledge-graph up -d # Add Neo4j
+#   docker compose --profile full up -d            # Start everything
 
 services:
-  orchestrator-api:
-    image: cmac01/orchestrator-api:{{orchestratorVersion}}
-    container_name: {{projectName}}-orchestrator-api
+  postgres:
+    image: postgres:15-alpine
+    container_name: my-project-postgres
+    environment:
+      POSTGRES_DB: ${POSTGRES_DB:-orchestrator}
+      POSTGRES_USER: ${POSTGRES_USER:-orchestrator}
+      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
+    volumes:
+      - my-project-postgres-data:/var/lib/postgresql/data
+    ports:
+      - "${POSTGRES_PORT:-5432}:5432"  # PostgreSQL
+    healthcheck:
+      test: ["CMD-SHELL", "pg_isready -U ${POSTGRES_USER:-orchestrator} -d ${POSTGRES_DB:-orchestrator}"]
+      interval: 10s
+      timeout: 5s
+      retries: 5
+      start_period: 10s
+    restart: unless-stopped
+    networks:
+      - my-project-network
+
+  neo4j:
+    image: neo4j:5-community
+    container_name: my-project-neo4j
+    environment:
+      NEO4J_AUTH: neo4j/${NEO4J_PASSWORD:-orchestrator_neo4j}
+      NEO4J_PLUGINS: '["apoc"]'
+      NEO4J_dbms_memory_pagecache_size: 512M
+      NEO4J_dbms_memory_heap_initial__size: 512M
+      NEO4J_dbms_memory_heap_max__size: 1G
+      NEO4J_dbms_security_procedures_unrestricted: apoc.*
+      NEO4J_dbms_security_procedures_allowlist: apoc.*
+    ports:
+      - "${NEO4J_HTTP_PORT:-7474}:7474"   # Neo4j browser
+      - "${NEO4J_BOLT_PORT:-7687}:7687"   # Neo4j bolt
+    volumes:
+      - my-project-neo4j-data:/data
+      - my-project-neo4j-logs:/logs
+    healthcheck:
+      test: ["CMD", "wget", "-qO-", "http://localhost:7474"]
+      interval: 10s
+      timeout: 5s
+      retries: 5
+      start_period: 20s
+    restart: unless-stopped
+    networks:
+      - my-project-network
+    profiles:
+      - knowledge-graph
+      - full
+
+  minio:
+    image: minio/minio:latest
+    container_name: my-project-minio
+    command: server /data --console-address ":9001"
+    environment:
+      MINIO_ROOT_USER: ${MINIO_ROOT_USER:-minioadmin}
+      MINIO_ROOT_PASSWORD: ${MINIO_ROOT_PASSWORD}
     ports:
-      - "3001:3001"
+      - "${MINIO_S3_PORT:-9000}:9000"     # MinIO S3 API
+      - "${MINIO_CONSOLE_PORT:-9001}:9001" # MinIO console
     volumes:
-      - .:/app/project:rw
+      - my-project-minio-data:/data
+    healthcheck:
+      test: ["CMD", "curl", "-f", "http://localhost:9000/minio/health/live"]
+      interval: 10s
+      timeout: 5s
+      retries: 5
+      start_period: 10s
+    restart: unless-stopped
+    networks:
+      - my-project-network
+    profiles:
+      - object-storage
+      - full
+
+  minio-init:
+    image: minio/mc:latest
+    container_name: my-project-minio-init
+    depends_on:
+      minio:
+        condition: service_healthy
+    entrypoint: >
+      /bin/sh -c "
+      mc alias set myminio http://minio:9000 ${MINIO_ROOT_USER:-minioadmin} ${MINIO_ROOT_PASSWORD};
+      mc mb --ignore-existing myminio/orchestrator-static;
+      mc mb --ignore-existing myminio/orchestrator-artifacts;
+      mc anonymous set download myminio/orchestrator-static;
+      echo 'MinIO buckets initialized successfully';
+      exit 0;
+      "
+    networks:
+      - my-project-network
+    profiles:
+      - object-storage
+      - full
+    restart: "no"
+
+  db-migrate:
+    image: cmac01/orchestrator-api:latest
+    container_name: my-project-db-migrate
+    depends_on:
+      postgres:
+        condition: service_healthy
+    environment:
+      NODE_ENV: production
+      RUN_MIGRATIONS: "true"
+      PERSISTENCE_MODE: postgres
+      DATABASE_URL: postgresql://${POSTGRES_USER:-orchestrator}:${POSTGRES_PASSWORD}@postgres:5432/${POSTGRES_DB:-orchestrator}
+      POSTGRES_HOST: postgres
+      POSTGRES_PORT: "5432"
+      POSTGRES_DB: ${POSTGRES_DB:-orchestrator}
+      POSTGRES_USER: ${POSTGRES_USER:-orchestrator}
+      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
+    networks:
+      - my-project-network
+    restart: "no"
+
+  orchestrator-api:
+    image: cmac01/orchestrator-api:latest
+    container_name: my-project-orchestrator-api
+    depends_on:
+      postgres:
+        condition: service_healthy
+      db-migrate:
+        condition: service_completed_successfully
+    env_file: .env
     environment:
-      - ORCHESTRATOR_ROOT=/app/project
-      - NODE_ENV=development
+      NODE_ENV: production
+      API_HOST: "0.0.0.0"
+      API_PORT: "3001"
+      PERSISTENCE_MODE: postgres
+      RUN_MIGRATIONS: "false"
+      # PostgreSQL connection (service name resolves within Docker network)
+      POSTGRES_HOST: postgres
+      POSTGRES_PORT: "5432"
+      DATABASE_URL: postgresql://${POSTGRES_USER:-orchestrator}:${POSTGRES_PASSWORD}@postgres:5432/${POSTGRES_DB:-orchestrator}
+      # MinIO object storage (requires --profile object-storage or --profile full)
+      ENABLE_OBJECT_STORAGE: "${ENABLE_OBJECT_STORAGE:-true}"
+      OBJECT_STORAGE_PROVIDER: minio
+      OBJECT_STORAGE_ENDPOINT: "http://minio:9000"
+      OBJECT_STORAGE_REGION: us-east-1
+      OBJECT_STORAGE_ACCESS_KEY: ${MINIO_ROOT_USER:-minioadmin}
+      OBJECT_STORAGE_SECRET_KEY: ${MINIO_ROOT_PASSWORD}
+      BUCKET_STATIC: orchestrator-static
+      BUCKET_ARTIFACTS: orchestrator-artifacts
+      # Neo4j knowledge graph (requires --profile knowledge-graph or --profile full)
+      NEO4J_URI: "${NEO4J_URI:-bolt://neo4j:7687}"
+      NEO4J_USER: "${NEO4J_USER:-neo4j}"
+      NEO4J_PASSWORD: "${NEO4J_PASSWORD:-orchestrator_neo4j}"
+      ENABLE_KNOWLEDGE_GRAPH: "${ENABLE_KNOWLEDGE_GRAPH:-false}"
+      # JWT Authentication
+      JWT_SECRET: ${JWT_SECRET}
+    ports:
+      - "3001:3001"  # Orchestrator REST API + MCP server
+    volumes:
+      # Staging area for Artifact Relay Pattern (TD-039)
+      # Sub-agents write artifacts here; main agent relays to MinIO via MCP
+      - /tmp/orchestrator:/tmp/orchestrator
     healthcheck:
       test: ["CMD", "wget", "-q", "-O", "/dev/null", "http://127.0.0.1:3001/api/v1/health"]
       interval: 30s
-      timeout: 3s
-      start_period: 10s
+      timeout: 10s
       retries: 3
+      start_period: 15s
     restart: unless-stopped
+    networks:
+      - my-project-network
+
+volumes:
+  my-project-postgres-data:
+    driver: local
+  my-project-neo4j-data:
+    driver: local
+  my-project-neo4j-logs:
+    driver: local
+  my-project-minio-data:
+    driver: local
+
+networks:
+  my-project-network:
+    driver: bridge

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@orchestrator-claude/cli",
-  "version": "3.1.12",
+  "version": "3.2.1",
   "description": "Orchestrator CLI - Project scaffolding, migration and management",
   "type": "module",
   "main": "dist/index.js",

package/templates/base/claude/skills/release/SKILL.md

@@ -0,0 +1,236 @@
+---
+name: release
+description: Executa release oficial do Orchestrator via CI/CD. NUNCA faca bump manual de versao - sempre use esta skill.
+allowed-tools: Read, Bash, Grep, Glob
+---
+
+# Release Skill
+
+## REGRA CRITICA
+
+**NUNCA faca bump de versao manualmente!**
+
+- ❌ NUNCA edite `package.json` para alterar versao
+- ❌ NUNCA crie tags git manualmente
+- ❌ NUNCA faca `docker build` + `docker push` manual
+- ✅ SEMPRE use esta skill para releases
+
+Releases manuais causam dessincronizacao entre npm, Docker e package.json.
+
+## Descricao
+
+Esta skill automatiza o processo de release do Orchestrator:
+
+1. Valida pre-requisitos (git clean, branch main)
+2. Calcula nova versao (patch/minor/major)
+3. Atualiza TODOS os arquivos de versao
+4. Cria commit e tag
+5. Push dispara CI/CD (npm publish + Docker build)
+
+## Arquivos Atualizados pelo Script
+
+O script atualiza automaticamente:
+
+- `package.json` (root)
+- `packages/cli/package.json`
+- `packages/mcp-server/package.json`
+- `packages/cli/src/index.ts` (CLI_VERSION constant)
+- `src/infrastructure/templates/base/package.json.hbs` (template versions)
+
+## Invocacao
+
+```
+/release patch     # 1.5.6 -> 1.5.7
+/release minor     # 1.5.6 -> 1.6.0
+/release major     # 1.5.6 -> 2.0.0
+/release 2.0.0     # Versao explicita
+```
+
+## Parametros
+
+| Parametro | Tipo | Obrigatorio | Descricao |
+|-----------|------|-------------|-----------|
+| `version` | string | Sim | patch, minor, major, ou x.y.z |
+| `--dry-run` | flag | Nao | Mostra o que seria feito sem executar |
+| `--force` | flag | Nao | Pula confirmacoes interativas |
+
+## Processo de Execucao
+
+### 1. Pre-verificacao
+
+Antes de executar o script, verifique:
+
+```bash
+# Working tree limpa?
+git status
+
+# Na branch main?
+git branch --show-current
+
+# Ultima tag?
+git describe --tags --abbrev=0
+```
+
+### 2. Dry Run (Recomendado)
+
+Sempre faca dry-run primeiro:
+
+```bash
+./scripts/release.sh --dry-run patch
+```
+
+### 3. Executar Release
+
+```bash
+./scripts/release.sh patch
+```
+
+### 4. Monitorar CI/CD
+
+Apos o push, monitore o pipeline:
+- GitHub Actions: https://github.com/orchestratorAII/orchestrator_claude/actions
+
+## Exemplos de Uso
+
+### Release de Patch (Bug Fix)
+
+```
+User: "Faca release do fix que acabamos de fazer"
+
+Claude:
+1. Verifico pre-requisitos
+2. Executo: ./scripts/release.sh --dry-run patch
+3. Confirmo com usuario
+4. Executo: ./scripts/release.sh patch
+5. Reporto URL do pipeline
+```
+
+### Release de Minor (Nova Feature)
+
+```
+User: "Release da nova feature de dashboard"
+
+Claude:
+1. Verifico CHANGELOG atualizado
+2. Executo: ./scripts/release.sh --dry-run minor
+3. Confirmo com usuario
+4. Executo: ./scripts/release.sh minor
+```
+
+### Release de Major (Breaking Change)
+
+```
+User: "Precisamos fazer release 2.0.0"
+
+Claude:
+1. Verifico CHANGELOG com breaking changes documentados
+2. Executo: ./scripts/release.sh --dry-run 2.0.0
+3. ALERTA sobre breaking changes
+4. Confirmo DUAS vezes com usuario
+5. Executo: ./scripts/release.sh 2.0.0
+```
+
+## Output Esperado
+
+```
+════════════════════════════════════════
+  Orchestrator Release Script
+════════════════════════════════════════
+
+🔍 Validating prerequisites...
+✅ All prerequisites satisfied
+🔍 Validating working tree...
+✅ Working tree is clean
+
+Release Plan:
+  Current version: 1.5.6
+  New version:     1.5.7
+  Git tag:         v1.5.7
+
+✅ Tag 'v1.5.7' is available
+
+Files to update:
+  - package.json (root)
+  - packages/cli/package.json
+  - packages/mcp-server/package.json
+  - packages/cli/src/index.ts (CLI_VERSION)
+  - src/infrastructure/templates/base/package.json.hbs (templates)
+
+Continue with release? (y/N): y
+
+📝 Updating versions to 1.5.7...
+✅ All versions updated to 1.5.7
+✅ Version bump committed
+✅ Tag created: v1.5.7
+⬆️  Pushing to remote...
+✅ Pushed main and tag v1.5.7
+
+════════════════════════════════════════
+  Release v1.5.7 initiated!
+════════════════════════════════════════
+
+🚀 CI/CD pipeline will now:
+   - Build and publish Docker image
+   - Publish npm packages
+
+📍 Monitor pipeline at:
+   https://github.com/orchestratorAII/orchestrator_claude/actions
+```
+
+## Troubleshooting
+
+### Working tree not clean
+
+```
+❌ Working tree is not clean
+Please commit or stash your changes
+```
+
+**Solucao:** Commit ou stash as mudancas pendentes antes do release.
+
+### Tag already exists
+
+```
+❌ Tag 'v1.5.7' already exists
+```
+
+**Solucao:** Use uma versao diferente ou delete a tag existente (se foi erro).
+
+### Not on main branch
+
+```
+⚠️ You are on branch 'feature-x', not main
+```
+
+**Solucao:** Merge para main primeiro, depois faca release.
+
+## Integracao com CI/CD
+
+O push da tag dispara automaticamente:
+
+1. **GitHub Actions** (`release.yml`)
+   - Build e teste
+   - Publish npm packages
+   - Build e push Docker image
+
+2. **Versoes Sincronizadas**
+   - npm: @orchestrator-claude/cli
+   - npm: @orchestrator-claude/mcp-server
+   - Docker: orchestrator-api:vX.Y.Z
+
+## Notas Importantes
+
+1. **Sempre faca dry-run primeiro** para verificar mudancas
+2. **CHANGELOG deve estar atualizado** antes do release
+3. **CI/CD faz o publish** - nunca publique manualmente
+4. **Uma tag = uma versao** em todos os lugares
+5. **Major releases** requerem confirmacao extra
+
+## Checklist Pre-Release
+
+- [ ] CHANGELOG.md atualizado com todas as mudancas
+- [ ] Todos os testes passando (`npm test`)
+- [ ] Build funcionando (`npm run build`)
+- [ ] Working tree limpa
+- [ ] Na branch main
+- [ ] Dry-run executado e revisado