@orchestrator-claude/cli 3.1.12 → 3.2.0

package/dist/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

package/dist/templates/base/claude/skills/release/release.sh

@@ -0,0 +1,460 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# ============================================================================
+# Release Script - Orchestrator v1.5.x
+# ============================================================================
+# Automates version bump and tag creation. CI/CD handles npm/Docker publish.
+#
+# Usage:
+#   ./scripts/release.sh patch    # 1.5.0 -> 1.5.1
+#   ./scripts/release.sh minor    # 1.5.0 -> 1.6.0
+#   ./scripts/release.sh major    # 1.5.0 -> 2.0.0
+#   ./scripts/release.sh 1.5.1    # Explicit version
+#
+# Files updated:
+#   - 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)
+#
+# ============================================================================
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+
+# Global variables
+FORCE=false
+DRY_RUN=false
+
+# Parse arguments
+VERSION_ARG=""
+while [[ $# -gt 0 ]]; do
+  case $1 in
+    -y|--yes|--force)
+      FORCE=true
+      shift
+      ;;
+    --dry-run)
+      DRY_RUN=true
+      shift
+      ;;
+    -h|--help)
+      echo "Usage: $0 [options] <version>"
+      echo ""
+      echo "Version can be:"
+      echo "  patch         Increment patch version (1.4.1 -> 1.4.2)"
+      echo "  minor         Increment minor version (1.4.1 -> 1.5.0)"
+      echo "  major         Increment major version (1.4.1 -> 2.0.0)"
+      echo "  x.y.z         Explicit version number"
+      echo ""
+      echo "Options:"
+      echo "  -y, --yes, --force  Skip confirmation prompts"
+      echo "  --dry-run           Show what would be done without making changes"
+      echo "  -h, --help          Show this help message"
+      echo ""
+      echo "Examples:"
+      echo "  $0 patch            # Bump patch version"
+      echo "  $0 1.4.2            # Set explicit version"
+      echo "  $0 --dry-run patch  # Preview changes"
+      echo ""
+      echo "What this script does:"
+      echo "  1. Validates prerequisites and working tree"
+      echo "  2. Bumps version in all package files"
+      echo "  3. Updates CLI_VERSION constant"
+      echo "  4. Commits version bump"
+      echo "  5. Creates and pushes git tag"
+      echo "  6. Tag push triggers CI/CD pipeline (npm + Docker publish)"
+      exit 0
+      ;;
+    *)
+      if [ -z "$VERSION_ARG" ]; then
+        VERSION_ARG="$1"
+      else
+        echo "Unknown option: $1"
+        exit 1
+      fi
+      shift
+      ;;
+  esac
+done
+
+if [ -z "$VERSION_ARG" ]; then
+  echo -e "${RED}❌ Version argument required${NC}"
+  echo "Usage: $0 [patch|minor|major|x.y.z]"
+  echo "Run '$0 --help' for more information"
+  exit 1
+fi
+
+# ============================================================================
+# Utility Functions
+# ============================================================================
+
+log_info() {
+  echo -e "${BLUE}ℹ${NC} $1"
+}
+
+log_success() {
+  echo -e "${GREEN}✅${NC} $1"
+}
+
+log_warning() {
+  echo -e "${YELLOW}⚠️${NC} $1"
+}
+
+log_error() {
+  echo -e "${RED}❌${NC} $1"
+}
+
+# ============================================================================
+# Validation Functions
+# ============================================================================
+
+validate_prerequisites() {
+  echo "🔍 Validating prerequisites..."
+  local missing=()
+
+  # Check git
+  if ! command -v git &> /dev/null; then
+    missing+=("git")
+  fi
+
+  # Check node
+  if ! command -v node &> /dev/null; then
+    missing+=("node")
+  fi
+
+  # Check we're in the right directory
+  if [ ! -f "package.json" ] || [ ! -d "packages/cli" ]; then
+    log_error "Must be run from orchestrator root directory"
+    exit 1
+  fi
+
+  if [ ${#missing[@]} -ne 0 ]; then
+    log_error "Missing required tools: ${missing[*]}"
+    exit 1
+  fi
+
+  log_success "All prerequisites satisfied"
+}
+
+validate_working_tree() {
+  echo "🔍 Validating working tree..."
+
+  # Check if working tree is clean
+  if [ -n "$(git status --porcelain)" ]; then
+    log_error "Working tree is not clean"
+    echo "Please commit or stash your changes:"
+    git status --short
+    exit 1
+  fi
+
+  # Check if on main branch
+  local branch
+  branch=$(git rev-parse --abbrev-ref HEAD)
+
+  if [[ "$branch" != "main" ]]; then
+    log_warning "You are on branch '$branch', not main"
+    if [ "$FORCE" = true ]; then
+      echo "Continuing with --force flag..."
+    else
+      read -p "Continue anyway? (y/N): " -n 1 -r
+      echo
+      if [[ ! $REPLY =~ ^[Yy]$ ]]; then
+        echo "Aborted by user"
+        exit 1
+      fi
+    fi
+  fi
+
+  log_success "Working tree is clean"
+}
+
+validate_tag_not_exists() {
+  local tag=$1
+
+  if git rev-parse "$tag" &> /dev/null; then
+    log_error "Tag '$tag' already exists"
+    echo "Choose a different version or delete the existing tag"
+    exit 1
+  fi
+
+  log_success "Tag '$tag' is available"
+}
+
+# ============================================================================
+# Version Functions
+# ============================================================================
+
+get_current_version() {
+  node -p "require('./packages/cli/package.json').version"
+}
+
+calculate_new_version() {
+  local current=$1
+  local bump_type=$2
+
+  # Parse current version
+  local major minor patch
+  IFS='.' read -r major minor patch <<< "$current"
+
+  case $bump_type in
+    patch)
+      echo "${major}.${minor}.$((patch + 1))"
+      ;;
+    minor)
+      echo "${major}.$((minor + 1)).0"
+      ;;
+    major)
+      echo "$((major + 1)).0.0"
+      ;;
+    *)
+      # Assume it's an explicit version
+      if [[ "$bump_type" =~ ^[0-9]+\.[0-9]+\.[0-9]+$ ]]; then
+        echo "$bump_type"
+      else
+        log_error "Invalid version format: $bump_type"
+        echo "Use: patch, minor, major, or x.y.z format"
+        exit 1
+      fi
+      ;;
+  esac
+}
+
+# ============================================================================
+# Update Functions
+# ============================================================================
+
+update_package_version() {
+  local file=$1
+  local version=$2
+
+  if [ ! -f "$file" ]; then
+    log_warning "File not found: $file"
+    return
+  fi
+
+  if [ "$DRY_RUN" = true ]; then
+    echo "  [dry-run] Would update: $file"
+    return
+  fi
+
+  # Use node to update version (handles JSON properly)
+  node -e "
+    const fs = require('fs');
+    const pkg = JSON.parse(fs.readFileSync('$file', 'utf8'));
+    pkg.version = '$version';
+    fs.writeFileSync('$file', JSON.stringify(pkg, null, 2) + '\n');
+  "
+
+  log_info "Updated: $file"
+}
+
+update_cli_version_constant() {
+  local version=$1
+  local file="packages/cli/src/index.ts"
+
+  if [ ! -f "$file" ]; then
+    log_warning "File not found: $file"
+    return
+  fi
+
+  if [ "$DRY_RUN" = true ]; then
+    echo "  [dry-run] Would update CLI_VERSION in: $file"
+    return
+  fi
+
+  # Update CLI_VERSION constant
+  sed -i "s/export const CLI_VERSION = '[^']*'/export const CLI_VERSION = '${version}'/" "$file"
+
+  log_info "Updated CLI_VERSION in: $file"
+}
+
+update_template_version() {
+  local version=$1
+  local file="src/infrastructure/templates/base/package.json.hbs"
+
+  if [ ! -f "$file" ]; then
+    log_warning "Template file not found: $file"
+    return
+  fi
+
+  if [ "$DRY_RUN" = true ]; then
+    echo "  [dry-run] Would update template: $file"
+    return
+  fi
+
+  # Update @orchestrator-claude/cli and @orchestrator-claude/mcp-server versions
+  sed -i "s|\"@orchestrator-claude/cli\": \"\\^[0-9]*\\.[0-9]*\\.[0-9]*\"|\"@orchestrator-claude/cli\": \"^${version}\"|g" "$file"
+  sed -i "s|\"@orchestrator-claude/mcp-server\": \"\\^[0-9]*\\.[0-9]*\\.[0-9]*\"|\"@orchestrator-claude/mcp-server\": \"^${version}\"|g" "$file"
+
+  log_info "Updated template: $file"
+}
+
+update_all_versions() {
+  local version=$1
+
+  echo "📝 Updating versions to $version..."
+
+  # Update root package.json
+  update_package_version "package.json" "$version"
+
+  # Update CLI package
+  update_package_version "packages/cli/package.json" "$version"
+
+  # Update MCP server package
+  update_package_version "packages/mcp-server/package.json" "$version"
+
+  # Update CLI_VERSION constant
+  update_cli_version_constant "$version"
+
+  # Update templates
+  update_template_version "$version"
+
+  log_success "All versions updated to $version"
+}
+
+# ============================================================================
+# Git Functions
+# ============================================================================
+
+commit_version_bump() {
+  local version=$1
+  local tag="v${version}"
+
+  if [ "$DRY_RUN" = true ]; then
+    echo "  [dry-run] Would commit: chore: bump version to ${tag}"
+    return
+  fi
+
+  git add package.json \
+    packages/cli/package.json \
+    packages/mcp-server/package.json \
+    packages/cli/src/index.ts \
+    src/infrastructure/templates/base/package.json.hbs
+
+  git commit -m "chore: bump version to ${tag}
+
+Updates:
+- 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)
+
+Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>"
+
+  log_success "Version bump committed"
+}
+
+create_and_push_tag() {
+  local version=$1
+  local tag="v${version}"
+
+  if [ "$DRY_RUN" = true ]; then
+    echo "  [dry-run] Would create tag: $tag"
+    echo "  [dry-run] Would push: main and $tag"
+    return
+  fi
+
+  # Create annotated tag
+  git tag -a "$tag" -m "Release $tag"
+  log_success "Tag created: $tag"
+
+  # Push commit and tag
+  echo "⬆️  Pushing to remote..."
+  git push origin main
+  git push origin "$tag"
+
+  log_success "Pushed main and tag $tag"
+}
+
+# ============================================================================
+# Main Flow
+# ============================================================================
+
+main() {
+  echo ""
+  echo -e "${BLUE}════════════════════════════════════════${NC}"
+  echo -e "${BLUE}  Orchestrator Release Script${NC}"
+  echo -e "${BLUE}════════════════════════════════════════${NC}"
+  echo ""
+
+  validate_prerequisites
+  validate_working_tree
+
+  # Get current and new versions
+  local current_version
+  current_version=$(get_current_version)
+
+  local new_version
+  new_version=$(calculate_new_version "$current_version" "$VERSION_ARG")
+
+  local tag="v${new_version}"
+
+  echo ""
+  echo -e "${BLUE}Release Plan:${NC}"
+  echo "  Current version: $current_version"
+  echo "  New version:     $new_version"
+  echo "  Git tag:         $tag"
+  echo ""
+
+  if [ "$DRY_RUN" = true ]; then
+    echo -e "${YELLOW}[DRY RUN MODE - No changes will be made]${NC}"
+    echo ""
+  fi
+
+  validate_tag_not_exists "$tag"
+
+  # Show what will be updated
+  echo ""
+  echo "Files to update:"
+  echo "  - package.json (root)"
+  echo "  - packages/cli/package.json"
+  echo "  - packages/mcp-server/package.json"
+  echo "  - packages/cli/src/index.ts (CLI_VERSION)"
+  echo "  - src/infrastructure/templates/base/package.json.hbs (templates)"
+  echo ""
+  echo "Actions:"
+  echo "  1. Update version in all files"
+  echo "  2. Commit version bump"
+  echo "  3. Create git tag $tag"
+  echo "  4. Push main + tag to origin"
+  echo "  5. CI/CD pipeline will publish npm + Docker"
+  echo ""
+
+  if [ "$FORCE" = false ] && [ "$DRY_RUN" = false ]; then
+    read -p "Continue with release? (y/N): " -n 1 -r
+    echo
+    if [[ ! $REPLY =~ ^[Yy]$ ]]; then
+      echo "Aborted by user"
+      exit 1
+    fi
+  fi
+
+  # Execute release steps
+  update_all_versions "$new_version"
+  commit_version_bump "$new_version"
+  create_and_push_tag "$new_version"
+
+  echo ""
+  echo -e "${GREEN}════════════════════════════════════════${NC}"
+  echo -e "${GREEN}  Release $tag initiated!${NC}"
+  echo -e "${GREEN}════════════════════════════════════════${NC}"
+  echo ""
+  echo "🚀 CI/CD pipeline will now:"
+  echo "   - Build and publish Docker image"
+  echo "   - Publish npm packages"
+  echo ""
+  echo "📍 Monitor pipeline at:"
+  echo "   https://github.com/orchestratorAII/orchestrator/actions"
+  echo ""
+}
+
+# Entry point
+main