@ornexus/neocortex 3.8.0

package/install.sh

@@ -0,0 +1,1409 @@
+#!/bin/bash
+
+# Neocortex - Instalador Unix
+# Epic & Story Development Orchestrator
+
+# Versao do instalador
+VERSION="3.8.0"
+
+# Flags
+MIGRATION_DETECTED=false
+MIGRATION_SOURCES=""
+CODERABBIT_INSTALLED=false
+LEGACY_ITEMS=""
+LEGACY_WARNINGS=0
+SELECTED_TARGETS=""
+VALID_TARGETS="claude-code cursor vscode gemini-cli codex antigravity"
+LOCAL_MODE=false
+NEOCORTEX_SERVER_URL="https://api.neocortex.ornexus.com"
+
+# =============================================================================
+# DETECCAO DE AMBIENTE
+# =============================================================================
+
+is_interactive() { [ -t 0 ] && [ -t 1 ]; }
+
+supports_colors() { [ -t 1 ] && [ "$(tput colors 2>/dev/null || echo 0)" -ge 8 ]; }
+
+supports_unicode() {
+    case "${LANG:-}${LC_ALL:-}${LC_CTYPE:-}" in
+        *UTF-8*|*utf-8*|*utf8*) return 0 ;;
+        *) return 1 ;;
+    esac
+}
+
+if [ -z "$HOME" ]; then
+    HOME=$(getent passwd "$(whoami)" | cut -d: -f6 2>/dev/null || echo "/root")
+    export HOME
+fi
+
+# =============================================================================
+# PARSING DE ARGUMENTOS
+# =============================================================================
+
+AUTO_YES=false
+DEBUG_MODE=false
+SKIP_PROJECT_DIRS=false
+CREATE_PROJECT=false
+QUIET_MODE=false
+NO_BANNER=false
+CLEANUP_LEGACY=false
+
+while [[ $# -gt 0 ]]; do
+    case $1 in
+        -y|--yes) AUTO_YES=true; shift ;;
+        -d|--debug) DEBUG_MODE=true; shift ;;
+        -s|--skip-project) SKIP_PROJECT_DIRS=true; shift ;;
+        -q|--quiet) QUIET_MODE=true; shift ;;
+        --no-banner) NO_BANNER=true; shift ;;
+        --cleanup-legacy) CLEANUP_LEGACY=true; shift ;;
+        --targets=*) SELECTED_TARGETS="${1#--targets=}"; shift ;;
+        --create-project) CREATE_PROJECT=true; shift ;;
+        --local) LOCAL_MODE=true; shift ;;
+        --server-url=*) NEOCORTEX_SERVER_URL="${1#--server-url=}"; shift ;;
+        -h|--help)
+            echo ""
+            echo "  Neocortex Installer v${VERSION}"
+            echo "  Epic & Story Development Orchestrator"
+            echo ""
+            echo "  Uso: npx @ornexus/neocortex [opcoes]"
+            echo ""
+            echo "  Opcoes:"
+            echo "    -y, --yes                 Modo automatico (Claude Code only)"
+            echo "    --targets=<lista>         Plataformas separadas por virgula"
+            echo "    --create-project          Instalar estrutura no projeto"
+            echo "    -s, --skip-project        Nao perguntar sobre projeto"
+            echo "    -q, --quiet               Modo silencioso"
+            echo "    --cleanup-legacy          Remover artefatos legados de ~/.claude/"
+            echo "    --local                   Modo local (copia IP para desenvolvimento)"
+            echo "    --server-url=<url>        URL do server Neocortex (padrao: api.neocortex.ornexus.com)"
+            echo "    -d, --debug               Modo debug"
+            echo "    -h, --help                Mostra esta ajuda"
+            echo ""
+            echo "  Plataformas: claude-code, cursor, vscode, gemini-cli, codex, antigravity"
+            exit 0
+            ;;
+        *) shift ;;
+    esac
+done
+
+if ! is_interactive; then
+    AUTO_YES=true
+fi
+
+# =============================================================================
+# CORES E SIMBOLOS
+# =============================================================================
+
+if supports_colors && [ "$QUIET_MODE" = false ]; then
+    RED='\033[0;31m'
+    GREEN='\033[0;32m'
+    YELLOW='\033[1;33m'
+    BLUE='\033[0;34m'
+    MAGENTA='\033[0;35m'
+    CYAN='\033[0;36m'
+    WHITE='\033[1;37m'
+    GRAY='\033[0;90m'
+    BOLD='\033[1m'
+    DIM='\033[2m'
+    NC='\033[0m'
+else
+    RED='' GREEN='' YELLOW='' BLUE='' MAGENTA='' CYAN=''
+    WHITE='' GRAY='' BOLD='' DIM='' NC=''
+fi
+
+if supports_unicode; then
+    SYM_OK="✓"
+    SYM_FAIL="✗"
+    SYM_WARN="!"
+    SYM_ARROW="→"
+    SYM_DOT="·"
+    SYM_SPINNER_FRAMES=('⠋' '⠙' '⠹' '⠸' '⠼' '⠴' '⠦' '⠧' '⠇' '⠏')
+else
+    SYM_OK="ok"
+    SYM_FAIL="x"
+    SYM_WARN="!"
+    SYM_ARROW="->"
+    SYM_DOT="."
+    SYM_SPINNER_FRAMES=('|' '/' '-' '\')
+fi
+
+# =============================================================================
+# FUNCOES DE LOG
+# =============================================================================
+
+# Step header: [1/5] Installing core...
+step() {
+    local num=$1 total=$2 msg=$3
+    echo ""
+    echo -e "  ${BOLD}${CYAN}[$num/$total]${NC} ${BOLD}$msg${NC}"
+}
+
+# Success line
+ok() { echo -e "  ${GREEN}${SYM_OK}${NC} $1"; }
+
+# Warning line
+warn() { echo -e "  ${YELLOW}${SYM_WARN}${NC} $1"; }
+
+# Error line
+fail() { echo -e "  ${RED}${SYM_FAIL}${NC} $1"; }
+
+# Info line
+info() { echo -e "  ${DIM}${SYM_ARROW} $1${NC}"; }
+
+# Debug line
+debug() { [ "$DEBUG_MODE" = true ] && echo -e "  ${GRAY}[debug] $1${NC}"; }
+
+# Spinner for background tasks
+run_with_spinner() {
+    local msg="$1"
+    shift
+    "$@" &
+    local pid=$!
+    local i=0
+    local len=${#SYM_SPINNER_FRAMES[@]}
+
+    while kill -0 "$pid" 2>/dev/null; do
+        printf "\r  ${CYAN}%s${NC} %s" "${SYM_SPINNER_FRAMES[$((i % len))]}" "$msg"
+        i=$((i + 1))
+        sleep 0.08
+    done
+
+    wait "$pid"
+    local exit_code=$?
+
+    if [ $exit_code -eq 0 ]; then
+        printf "\r  ${GREEN}${SYM_OK}${NC} %s\n" "$msg"
+    else
+        printf "\r  ${RED}${SYM_FAIL}${NC} %s\n" "$msg"
+    fi
+
+    return $exit_code
+}
+
+# =============================================================================
+# FUNCOES DE COPIA (silenciosas - sem log individual)
+# =============================================================================
+
+copy_file() {
+    local src="$1" dest="$2"
+    debug "Copiando: $src -> $dest"
+    [ -f "$src" ] && cp "$src" "$dest" 2>/dev/null
+}
+
+copy_dir() {
+    local src="$1" dest="$2"
+    debug "Copiando dir: $src -> $dest"
+    [ -d "$src" ] && cp -r "$src" "$dest" 2>/dev/null
+}
+
+# =============================================================================
+# DETECCAO DE VERSAO ANTIGA
+# =============================================================================
+
+detect_old_installation() {
+    debug "Verificando instalacoes antigas..."
+
+    local dest_dir="${HOME}/.claude/agents/neocortex"
+
+    if [ -f "$dest_dir/.version" ]; then
+        INSTALLED_VERSION=$(cat "$dest_dir/.version" 2>/dev/null)
+        local new_version=""
+        if [ -f "$SOURCE_DIR/package.json" ]; then
+            new_version=$(grep '"version"' "$SOURCE_DIR/package.json" 2>/dev/null | head -1 | sed 's/.*"version"[[:space:]]*:[[:space:]]*"\([^"]*\)".*/\1/')
+        fi
+        if [ -n "$INSTALLED_VERSION" ] && [ -n "$new_version" ]; then
+            if [ "$INSTALLED_VERSION" = "$new_version" ]; then
+                info "Reinstalando v$new_version"
+            else
+                info "Atualizando v$INSTALLED_VERSION ${SYM_ARROW} v$new_version"
+            fi
+        fi
+    fi
+
+    # Check for old files
+    local old_files=()
+    if [ -f "$dest_dir/step-registry.json" ]; then
+        if ! grep -q "state.json" "$dest_dir/workflow.md" 2>/dev/null; then
+            old_files+=("workflow antigo")
+        fi
+    fi
+
+    if grep -r "orchestrator.db" "$dest_dir" 2>/dev/null | grep -v "backup" | grep -v "migrated" > /dev/null; then
+        old_files+=("referencias SQLite")
+    fi
+
+    if [ ${#old_files[@]} -gt 0 ]; then
+        MIGRATION_DETECTED=true
+        MIGRATION_SOURCES="${old_files[*]}"
+        debug "Detectado: $MIGRATION_SOURCES"
+    fi
+}
+
+detect_legacy_artifacts() {
+    local warnings=0
+    local legacy_items=""
+    local claude_dir="$HOME/.claude"
+
+    debug "Verificando artefatos legados em ~/.claude/..."
+
+    # Check 1: .git inside agents/ (leftover from contains-studio/agents repo)
+    if [ -d "$claude_dir/agents/.git" ]; then
+        warn "Repositorio .git detectado em ~/.claude/agents/"
+        info "Pode conflitar com instalacoes do Neocortex"
+        info "Execute com --cleanup-legacy para remover"
+        legacy_items="${legacy_items}${claude_dir}/agents/.git
+"
+        warnings=$((warnings + 1))
+    fi
+
+    # Check 2: Nested .claude/.claude/ (BMAD installation error)
+    if [ -d "$claude_dir/.claude" ]; then
+        warn "Diretorio aninhado detectado: ~/.claude/.claude/"
+        info "Possivelmente erro de instalacao anterior (BMAD)"
+        info "Execute com --cleanup-legacy para remover"
+        legacy_items="${legacy_items}${claude_dir}/.claude
+"
+        warnings=$((warnings + 1))
+    fi
+
+    # Check 3: Loose agents without namespace (files directly in agents/, not in subdirs)
+    local loose_count=0
+    if [ -d "$claude_dir/agents" ]; then
+        for f in "$claude_dir/agents"/*.md; do
+            [ -f "$f" ] || continue
+            loose_count=$((loose_count + 1))
+            debug "  Solto: $(basename "$f")"
+        done
+    fi
+    if [ $loose_count -gt 0 ]; then
+        info "$loose_count arquivo(s) .md solto(s) em ~/.claude/agents/"
+        info "Considere organizar em namespaces (ex: agents/neocortex/)"
+        warnings=$((warnings + 1))
+    fi
+
+    # Check 4: Legacy agents-ldtn/ directory
+    if [ -d "$claude_dir/agents-ldtn" ]; then
+        warn "Diretorio legado detectado: ~/.claude/agents-ldtn/"
+        info "Execute com --cleanup-legacy para remover"
+        legacy_items="${legacy_items}${claude_dir}/agents-ldtn
+"
+        warnings=$((warnings + 1))
+    fi
+
+    # Check 5: .superclaude-metadata.json
+    if [ -f "$claude_dir/.superclaude-metadata.json" ]; then
+        warn "Metadata legado detectado: ~/.claude/.superclaude-metadata.json"
+        info "Execute com --cleanup-legacy para remover"
+        legacy_items="${legacy_items}${claude_dir}/.superclaude-metadata.json
+"
+        warnings=$((warnings + 1))
+    fi
+
+    # Check 6: superclaude_backup_*.tar.gz in backups/
+    local backup_count=0
+    if [ -d "$claude_dir/backups" ]; then
+        for f in "$claude_dir/backups"/superclaude_backup_*.tar.gz; do
+            [ -f "$f" ] || continue
+            backup_count=$((backup_count + 1))
+        done
+    fi
+    if [ $backup_count -gt 0 ]; then
+        info "$backup_count backup(s) SuperClaude antigo(s) em ~/.claude/backups/"
+        warnings=$((warnings + 1))
+    fi
+
+    if [ $warnings -gt 0 ]; then
+        warn "$warnings artefato(s) legado(s) detectado(s)"
+    fi
+
+    # Export for cleanup (newline-separated for paths with spaces)
+    LEGACY_ITEMS="$legacy_items"
+    LEGACY_WARNINGS=$warnings
+
+    return 0  # Never block installation
+}
+
+cleanup_legacy_artifacts() {
+    # Only run if --cleanup-legacy was passed
+    if [ "$CLEANUP_LEGACY" != true ]; then
+        return 0
+    fi
+
+    # Check if there are items to clean
+    if [ $LEGACY_WARNINGS -eq 0 ] || [ -z "$LEGACY_ITEMS" ]; then
+        info "Nenhum artefato legado encontrado para limpeza"
+        return 0
+    fi
+
+    # Safety: refuse cleanup in --yes mode (protect against automated deletion)
+    if [ "$AUTO_YES" = true ]; then
+        warn "Cleanup requer confirmacao interativa (--yes ignorado para seguranca)"
+        return 0
+    fi
+
+    # Show what will be removed
+    echo ""
+    warn "Os seguintes artefatos serao removidos:"
+    local item_count=0
+    while IFS= read -r item; do
+        [ -z "$item" ] && continue
+        local display_item="${item/#$HOME/~}"
+        if [ -d "$item" ]; then
+            info "  - ${display_item}/ (diretorio)"
+        else
+            info "  - ${display_item} (arquivo)"
+        fi
+        item_count=$((item_count + 1))
+    done <<EOF
+$LEGACY_ITEMS
+EOF
+
+    echo -ne "  Confirmar remocao? ${BOLD}[s/N]:${NC} "
+
+    local response=""
+    if read -r -t 30 response 2>/dev/null; then
+        : # response received
+    else
+        echo ""
+        info "Timeout - cleanup cancelado"
+        return 0
+    fi
+
+    if [[ ! "$response" =~ ^([sS][iI]?[mM]?|[yY][eE]?[sS]?)$ ]]; then
+        info "Cleanup cancelado"
+        return 0
+    fi
+
+    # Execute cleanup
+    local removed=0
+    local failed=0
+    while IFS= read -r item; do
+        [ -z "$item" ] && continue
+        local display_item="${item/#$HOME/~}"
+        if rm -rf "$item" 2>/dev/null; then
+            ok "Removido: $display_item"
+            removed=$((removed + 1))
+        else
+            fail "Falha ao remover: $display_item"
+            failed=$((failed + 1))
+        fi
+    done <<EOF
+$LEGACY_ITEMS
+EOF
+
+    if [ $failed -eq 0 ]; then
+        ok "$removed artefato(s) removido(s) com sucesso"
+    else
+        warn "$removed removido(s), $failed falha(s)"
+    fi
+
+    return 0
+}
+
+detect_project_migration_needs() {
+    local migration_needed=false
+    local sources=()
+
+    [ -f ".neocortex/orchestrator.db" ] && { migration_needed=true; sources+=("orchestrator.db"); }
+    for yaml_path in "bmad-output/sprint-status.yaml" ".neocortex/sprint-status.yaml" "docs/sprint-status.yaml"; do
+        [ -f "$yaml_path" ] && { migration_needed=true; sources+=("$yaml_path"); }
+    done
+
+    if [ "$migration_needed" = true ]; then
+        echo "${sources[*]}"
+        return 0
+    fi
+    return 1
+}
+
+# =============================================================================
+# BANNER
+# =============================================================================
+
+show_banner() {
+    [ "$QUIET_MODE" = true ] && return
+    [ "$NO_BANNER" = true ] && return
+
+    # True color blue gradient (#00B4FF → #7DD3FC → #0070A8) matching neocortex-cli theme
+    local g1="\033[38;2;0;180;255m"    # #00B4FF bright blue
+    local g2="\033[38;2;48;191;254m"   # #30BFFE
+    local g3="\033[38;2;95;204;253m"   # #5FCCFD light blue
+    local g4="\033[38;2;102;192;236m"  # #66C0EC
+    local g5="\033[38;2;56;154;204m"   # #389ACC
+    local g6="\033[38;2;0;112;168m"    # #0070A8 deep blue
+    local gd="\033[38;5;236m"
+    local gt="\033[38;5;243m"
+    local rst="\033[0m"
+
+    local lines=(
+        "${g1}  ███╗   ██╗███████╗ ██████╗  ██████╗ ██████╗ ██████╗ ████████╗███████╗██╗  ██╗${rst}"
+        "${g2}  ████╗  ██║██╔════╝██╔═══██╗██╔════╝██╔═══██╗██╔══██╗╚══██╔══╝██╔════╝╚██╗██╔╝${rst}"
+        "${g3}  ██╔██╗ ██║█████╗  ██║   ██║██║     ██║   ██║██████╔╝   ██║   █████╗   ╚███╔╝${rst}"
+        "${g4}  ██║╚██╗██║██╔══╝  ██║   ██║██║     ██║   ██║██╔══██╗   ██║   ██╔══╝   ██╔██╗${rst}"
+        "${g5}  ██║ ╚████║███████╗╚██████╔╝╚██████╗╚██████╔╝██║  ██║   ██║   ███████╗██╔╝ ██╗${rst}"
+        "${g6}  ╚═╝  ╚═══╝╚══════╝ ╚═════╝  ╚═════╝ ╚═════╝ ╚═╝  ╚═╝   ╚═╝   ╚══════╝╚═╝  ╚═╝${rst}"
+        ""
+        "${gd}  ──────────────────────────────────────────────────────────────────────────────────${rst}"
+        "${gt}  Development Orchestrator | OrNexus Team                                v${VERSION}${rst}"
+    )
+
+    echo ""
+    for line in "${lines[@]}"; do
+        echo -e "$line"
+        sleep 0.02
+    done
+    echo ""
+}
+
+# =============================================================================
+# DETECCAO DO DIRETORIO FONTE
+# =============================================================================
+
+detect_source_dir() {
+    if [ -n "${BASH_SOURCE[0]}" ]; then
+        SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" 2>/dev/null && pwd)"
+    elif [ -n "$0" ]; then
+        SCRIPT_DIR="$(cd "$(dirname "$0")" 2>/dev/null && pwd)"
+    else
+        SCRIPT_DIR="$PWD"
+    fi
+
+    if [ ! -f "$SCRIPT_DIR/targets/claude-code/neocortex.md" ]; then
+        if [ ! -f "$SCRIPT_DIR/neocortex.md" ]; then
+            for possible_dir in \
+                "$SCRIPT_DIR" \
+                "$(npm root -g 2>/dev/null)/neocortex" \
+                "$(dirname "$0")" \
+                "$PWD/node_modules/neocortex" \
+                "$HOME/.npm/_npx/"*"/node_modules/neocortex"; do
+                if [ -f "$possible_dir/targets/claude-code/neocortex.md" ] 2>/dev/null || \
+                   [ -f "$possible_dir/neocortex.md" ] 2>/dev/null; then
+                    SCRIPT_DIR="$possible_dir"
+                    break
+                fi
+            done
+        fi
+    fi
+
+    SOURCE_DIR="$SCRIPT_DIR"
+    debug "Source: $SOURCE_DIR"
+}
+
+# =============================================================================
+# TIER 3: CLEANUP DE IP LEGADA E CONFIG DO THIN CLIENT
+# =============================================================================
+
+cleanup_legacy_ip() {
+    local neocortex_dir="${HOME}/.claude/agents/neocortex"
+    local skills_dir="${HOME}/.claude/skills/neocortex"
+    local cleaned=false
+
+    # Remover core/ e seus subdiretorios
+    if [ -d "$neocortex_dir/core" ]; then
+        rm -rf "$neocortex_dir/core"
+        cleaned=true
+    fi
+
+    # Remover step folders (steps-c, steps-e, steps-p, steps-r, steps-u)
+    for folder in steps-c steps-e steps-p steps-r steps-u; do
+        if [ -d "$neocortex_dir/$folder" ]; then
+            rm -rf "$neocortex_dir/$folder"
+            cleaned=true
+        fi
+    done
+
+    # Remover skills
+    if [ -d "$skills_dir" ]; then
+        rm -rf "$skills_dir"
+        cleaned=true
+    fi
+
+    # Remover arquivos desnecessarios
+    for file in package.json README.md; do
+        if [ -f "$neocortex_dir/$file" ]; then
+            rm -f "$neocortex_dir/$file"
+            cleaned=true
+        fi
+    done
+
+    if [ "$cleaned" = true ]; then
+        info "IP proprietaria removida de versao anterior (agora servida via server remoto)"
+    fi
+}
+
+setup_thin_client_config() {
+    local config_dir="${HOME}/.neocortex"
+    local config_file="${config_dir}/config.json"
+
+    mkdir -p "$config_dir" 2>/dev/null
+    mkdir -p "$config_dir/cache" 2>/dev/null
+
+    if [ -f "$config_file" ]; then
+        # Preservar config existente, atualizar apenas serverUrl se necessario
+        local existing_mode
+        existing_mode=$(grep '"mode"' "$config_file" 2>/dev/null | head -1 | sed 's/.*"mode"[[:space:]]*:[[:space:]]*"\([^"]*\)".*/\1/')
+
+        if [ "$existing_mode" = "active" ] || [ "$existing_mode" = "local" ]; then
+            debug "Config existente preservada (mode=$existing_mode)"
+            return 0
+        fi
+    fi
+
+    # Criar config base para thin client
+    cat > "$config_file" << EOFCONFIG
+{
+  "version": "${VERSION}",
+  "mode": "pending-activation",
+  "serverUrl": "${NEOCORTEX_SERVER_URL}",
+  "tier": 3,
+  "cache": {
+    "enabled": true,
+    "directory": "${config_dir}/cache",
+    "encryption": "AES-256-GCM"
+  },
+  "resilience": {
+    "circuitBreaker": true,
+    "maxRetries": 3,
+    "timeoutMs": 5000
+  },
+  "installedAt": "$(date -Iseconds 2>/dev/null || date '+%Y-%m-%dT%H:%M:%S')",
+  "installerVersion": "${VERSION}"
+}
+EOFCONFIG
+
+    debug "Thin client config criada: $config_file"
+}
+
+cleanup_legacy_ip_project() {
+    local project_dir="$1"
+    local neocortex_dir="$project_dir/.claude/agents/neocortex"
+    local skills_dir="$project_dir/.claude/skills/neocortex"
+    local cleaned=false
+
+    # Remover core/ e seus subdiretorios
+    if [ -d "$neocortex_dir/core" ]; then
+        rm -rf "$neocortex_dir/core"
+        cleaned=true
+    fi
+
+    # Remover step folders
+    for folder in steps-c steps-e steps-p steps-r steps-u; do
+        if [ -d "$neocortex_dir/$folder" ]; then
+            rm -rf "$neocortex_dir/$folder"
+            cleaned=true
+        fi
+    done
+
+    # Remover skills
+    if [ -d "$skills_dir" ]; then
+        rm -rf "$skills_dir"
+        cleaned=true
+    fi
+
+    # Remover arquivos desnecessarios
+    for file in package.json README.md; do
+        if [ -f "$neocortex_dir/$file" ]; then
+            rm -f "$neocortex_dir/$file"
+            cleaned=true
+        fi
+    done
+
+    if [ "$cleaned" = true ]; then
+        info "IP proprietaria removida do projeto (agora servida via server remoto)"
+    fi
+}
+
+# =============================================================================
+# INSTALACAO CORE
+# =============================================================================
+
+install_core() {
+    local errors=0
+
+    CLAUDE_DIR="${HOME}/.claude"
+    AGENTS_DIR="${CLAUDE_DIR}/agents"
+    DEST_DIR="${AGENTS_DIR}/neocortex"
+
+    debug "HOME=$HOME | DEST=$DEST_DIR | LOCAL_MODE=$LOCAL_MODE"
+
+    # Create directories
+    if [ ! -d "$CLAUDE_DIR" ]; then
+        mkdir -p "$CLAUDE_DIR" 2>/dev/null || { fail "Falha ao criar $CLAUDE_DIR"; return 1; }
+    fi
+    mkdir -p "$AGENTS_DIR" 2>/dev/null || { fail "Falha ao criar $AGENTS_DIR"; return 1; }
+
+    # Clean previous installation
+    if [ -d "$DEST_DIR" ]; then
+        rm -rf "$DEST_DIR" 2>/dev/null
+        debug "Instalacao anterior removida"
+    fi
+    mkdir -p "$DEST_DIR" 2>/dev/null || { fail "Falha ao criar $DEST_DIR"; return 1; }
+
+    if [ "$LOCAL_MODE" = true ]; then
+        # Mode local: copiar IP completa (comportamento legado para devs)
+        copy_dir "$SOURCE_DIR/core" "$DEST_DIR/" || ((errors++))
+        copy_file "$SOURCE_DIR/package.json" "$DEST_DIR/" || ((errors++))
+        copy_file "$SOURCE_DIR/README.md" "$DEST_DIR/" || ((errors++))
+    else
+        # Tier 3 Remote Mode: NÃO copiar IP
+        # Apenas setup do thin client - steps/skills/standards vem do server
+        cleanup_legacy_ip
+        setup_thin_client_config
+    fi
+
+    # Write version file
+    local pkg_version=""
+    if [ -f "$SOURCE_DIR/package.json" ]; then
+        pkg_version=$(grep '"version"' "$SOURCE_DIR/package.json" 2>/dev/null | head -1 | sed 's/.*"version"[[:space:]]*:[[:space:]]*"\([^"]*\)".*/\1/')
+    fi
+    [ -n "$pkg_version" ] && echo "$pkg_version" > "$DEST_DIR/.version"
+
+    if [ $errors -eq 0 ]; then
+        if [ "$LOCAL_MODE" = true ]; then
+            ok "Core instalado ${DIM}(standards, templates, scripts) [modo local]${NC}"
+        else
+            ok "Core instalado ${DIM}(thin client configurado) [modo remoto]${NC}"
+        fi
+    else
+        fail "Core instalado com erros"
+    fi
+
+    return $errors
+}
+
+# =============================================================================
+# INSTALACAO DE SKILLS
+# =============================================================================
+
+install_skills() {
+    local errors=0
+
+    SKILLS_DIR="${CLAUDE_DIR}/skills"
+    SKILLS_DEST="${SKILLS_DIR}/neocortex"
+    SKILLS_SOURCE="${SOURCE_DIR}/core/skills"
+
+    # Tier 3 Remote Mode: skills vem do server, nao copiar
+    if [ "$LOCAL_MODE" != true ]; then
+        ok "Skills ${DIM}(servidas via server remoto) [modo remoto]${NC}"
+        return 0
+    fi
+
+    if [ ! -d "$SKILLS_SOURCE" ]; then
+        debug "Skills nao encontradas no pacote"
+        return 0
+    fi
+
+    mkdir -p "$SKILLS_DIR" 2>/dev/null || { fail "Falha ao criar $SKILLS_DIR"; return 1; }
+
+    # Clean previous
+    [ -d "$SKILLS_DEST" ] && rm -rf "$SKILLS_DEST" 2>/dev/null
+
+    if cp -r "$SKILLS_SOURCE" "$SKILLS_DEST" 2>/dev/null; then
+        # Count skills
+        local skill_count=0
+        for skill_file in "$SKILLS_DEST"/step-skills/*/*.md "$SKILLS_DEST"/domain-skills/*/*.md; do
+            if [ -f "$skill_file" ] && [[ "$(basename "$skill_file")" != "_template.md" ]]; then
+                ((skill_count++))
+            fi
+        done
+        ok "Skills instaladas ${DIM}($skill_count skills) [modo local]${NC}"
+    else
+        fail "Falha ao copiar skills"
+        ((errors++))
+    fi
+
+    return $errors
+}
+
+# =============================================================================
+# INSTALACAO DE AGENT (Claude Code)
+# =============================================================================
+
+install_agent() {
+    local errors=0
+
+    CLAUDE_TARGET_DIR="$SOURCE_DIR/targets/claude-code"
+    [ ! -d "$CLAUDE_TARGET_DIR" ] && CLAUDE_TARGET_DIR="$SOURCE_DIR"
+
+    # Tier 3 Stub-Only: copiar apenas 2 arquivos de interface (stubs minimos)
+    copy_file "$CLAUDE_TARGET_DIR/neocortex.md" "$DEST_DIR/"
+    copy_file "$CLAUDE_TARGET_DIR/neocortex.agent.yaml" "$DEST_DIR/"
+
+    # Cleanup: remover workflow.md de instalacoes anteriores (v3.8 -> v3.9)
+    if [ -f "$DEST_DIR/workflow.md" ]; then
+        rm -f "$DEST_DIR/workflow.md"
+        [ "$QUIET_MODE" = false ] && echo "  Removed workflow.md (content now server-side)"
+    fi
+
+    if [ "$LOCAL_MODE" = true ]; then
+        # Modo local: copiar IP completa (comportamento legado para devs)
+        copy_file "$SOURCE_DIR/package.json" "$DEST_DIR/"
+        copy_file "$SOURCE_DIR/README.md" "$DEST_DIR/"
+        copy_dir "$SOURCE_DIR/core" "$DEST_DIR/"
+
+        for folder in steps-c steps-e steps-p steps-r steps-u; do
+            copy_dir "$SOURCE_DIR/core/steps/$folder" "$DEST_DIR/"
+        done
+    fi
+    # Tier 3 Remote Mode: apenas 2 stub files + server-side orchestration
+
+    return $errors
+}
+
+# =============================================================================
+# INSTALACAO DE TARGETS
+# =============================================================================
+
+install_targets() {
+    local targets="$1"
+    local target_errors=0
+    local target_count=0
+    local target_results=()
+
+    targets=$(echo "$targets" | tr ',' ' ')
+
+    for target in $targets; do
+        local adapter_script="$SOURCE_DIR/targets/$target/install-${target}.sh"
+        local func_name="install_$(echo "$target" | tr '-' '_')"
+
+        if [ ! -f "$adapter_script" ]; then
+            if [ "$target" = "claude-code" ]; then
+                install_agent
+                local result=$?
+                if [ $result -eq 0 ]; then
+                    target_results+=("$target:OK")
+                    ((target_count++))
+                    ok "${BOLD}claude-code${NC} ${DIM}(agent, steps, core)${NC}"
+                else
+                    target_results+=("$target:FAIL")
+                    ((target_errors++))
+                    fail "claude-code"
+                fi
+                continue
+            fi
+
+            warn "$target ${DIM}(adapter nao encontrado)${NC}"
+            target_results+=("$target:SKIP")
+            ((target_errors++))
+            continue
+        fi
+
+        . "$adapter_script"
+
+        if type "$func_name" >/dev/null 2>&1; then
+            "$func_name" "$SOURCE_DIR" "$HOME"
+            local result=$?
+            if [ $result -eq 0 ]; then
+                target_results+=("$target:OK")
+                ((target_count++))
+                ok "${BOLD}$target${NC}"
+            else
+                target_results+=("$target:WARN")
+                warn "$target ${DIM}(instalado com avisos)${NC}"
+                ((target_count++))
+            fi
+        else
+            fail "$target ${DIM}(funcao $func_name nao encontrada)${NC}"
+            target_results+=("$target:FAIL")
+            ((target_errors++))
+        fi
+    done
+
+    TARGET_RESULTS=("${target_results[@]}")
+    TARGET_COUNT=$target_count
+
+    return $target_errors
+}
+
+# =============================================================================
+# CARREGAMENTO DE .ENV
+# =============================================================================
+
+load_env_file() {
+    local env_file=""
+    for possible_env in "./.env" "$SOURCE_DIR/.env"; do
+        [ -f "$possible_env" ] && { env_file="$possible_env"; break; }
+    done
+
+    if [ -n "$env_file" ] && [ -f "$env_file" ]; then
+        local loaded=0
+        while IFS='=' read -r key value || [ -n "$key" ]; do
+            [[ -z "$key" || "$key" =~ ^[[:space:]]*# ]] && continue
+            key=$(echo "$key" | xargs)
+            value=$(echo "$value" | xargs)
+            value="${value%\"}"; value="${value#\"}"
+            value="${value%\'}"; value="${value#\'}"
+            if [ -n "$value" ] && [ -z "${!key}" ]; then
+                export "$key=$value"
+                ((loaded++))
+            fi
+        done < "$env_file"
+        [ $loaded -gt 0 ] && info "$loaded variavel(eis) carregada(s) do .env"
+        return 0
+    fi
+    return 1
+}
+
+# =============================================================================
+# CONFIGURACAO DE TOKENS
+# =============================================================================
+
+prompt_tokens() {
+    [ "$QUIET_MODE" = true ] && return
+    [ -n "$CONTEXT7_API_KEY" ] && return
+
+    if [ "$AUTO_YES" = true ]; then
+        return
+    fi
+
+    echo ""
+    info "MCP Context7 nao configurado ${DIM}(opcional)${NC}"
+    echo -ne "  Configurar agora? ${BOLD}[s/N]:${NC} "
+
+    local response=""
+    if read -r -t 15 response 2>/dev/null; then
+        : # resposta recebida
+    else
+        echo ""
+        return
+    fi
+
+    if [[ "$response" =~ ^([sS][iI]?[mM]?|[yY][eE]?[sS]?)$ ]]; then
+        echo ""
+        info "Obtenha sua API Key em: ${WHITE}https://context7.com${NC}"
+        echo -ne "  Cole sua ${BOLD}CONTEXT7_API_KEY${NC}: "
+
+        local api_key=""
+        if read -r -t 60 api_key 2>/dev/null; then
+            if [[ "$api_key" =~ ^ctx7sk- ]]; then
+                export CONTEXT7_API_KEY="$api_key"
+                ok "CONTEXT7_API_KEY configurada"
+                echo ""
+                info "Para persistir: ${DIM}echo 'export CONTEXT7_API_KEY=\"$api_key\"' >> ~/.bashrc${NC}"
+            elif [ -n "$api_key" ]; then
+                warn "Formato invalido (esperado: ctx7sk-...)"
+            fi
+        fi
+    fi
+}
+
+# =============================================================================
+# INSTALACAO DE MCP SERVERS
+# =============================================================================
+
+install_mcps() {
+    if ! command -v claude >/dev/null 2>&1; then
+        info "Claude CLI nao encontrado ${DIM}(MCPs serao instalados depois)${NC}"
+        return 0
+    fi
+
+    local mcp_results=""
+
+    if claude mcp list 2>/dev/null | grep -q "^playwright"; then
+        mcp_results="${mcp_results}playwright:OK "
+    else
+        if claude mcp add playwright npx @playwright/mcp@latest 2>/dev/null; then
+            mcp_results="${mcp_results}playwright:OK "
+        else
+            mcp_results="${mcp_results}playwright:FAIL "
+        fi
+    fi
+
+    if claude mcp list 2>/dev/null | grep -q "^context7"; then
+        mcp_results="${mcp_results}context7:OK "
+    elif [ -n "$CONTEXT7_API_KEY" ]; then
+        if claude mcp add --transport http context7 https://mcp.context7.com/mcp --header "CONTEXT7_API_KEY: $CONTEXT7_API_KEY" 2>/dev/null; then
+            mcp_results="${mcp_results}context7:OK "
+        else
+            mcp_results="${mcp_results}context7:FAIL "
+        fi
+    else
+        mcp_results="${mcp_results}context7:SKIP "
+    fi
+
+    # Show compact MCP results
+    local mcp_ok="" mcp_skip=""
+    for entry in $mcp_results; do
+        local name="${entry%%:*}"
+        local status="${entry##*:}"
+        case "$status" in
+            OK) mcp_ok="${mcp_ok}${name}, " ;;
+            SKIP) mcp_skip="${mcp_skip}${name}, " ;;
+        esac
+    done
+
+    [ -n "$mcp_ok" ] && ok "MCPs: ${DIM}${mcp_ok%, }${NC}"
+    [ -n "$mcp_skip" ] && info "MCPs pendentes: ${DIM}${mcp_skip%, }${NC}"
+
+    return 0
+}
+
+# =============================================================================
+# INSTALACAO DO CODERABBIT CLI
+# =============================================================================
+
+install_coderabbit() {
+    if command -v coderabbit >/dev/null 2>&1; then
+        ok "CodeRabbit CLI"
+        CODERABBIT_INSTALLED=true
+        return 0
+    fi
+
+    if command -v curl >/dev/null 2>&1 && curl -fsSL https://cli.coderabbit.ai/install.sh | sh 2>/dev/null; then
+        ok "CodeRabbit CLI ${DIM}(instalado)${NC}"
+        CODERABBIT_INSTALLED=true
+    elif command -v npm >/dev/null 2>&1 && npm install -g coderabbit 2>/dev/null; then
+        ok "CodeRabbit CLI ${DIM}(via npm)${NC}"
+        CODERABBIT_INSTALLED=true
+    else
+        info "CodeRabbit CLI ${DIM}(instale depois: curl -fsSL https://cli.coderabbit.ai/install.sh | sh)${NC}"
+        CODERABBIT_INSTALLED=false
+    fi
+
+    return 0
+}
+
+# =============================================================================
+# VERIFICACAO POS-INSTALACAO
+# =============================================================================
+
+verify_installation() {
+    local fails=0
+    local warns=0
+    local report=""
+
+    if ! echo "$SELECTED_TARGETS" | grep -q "claude-code"; then
+        return 0
+    fi
+
+    # ─── Layer 1: File existence + minimum size ─────────────────────────
+    local check_fname check_min check_fpath check_size check_ext check_first_line check_display
+    for check_fname in neocortex.md neocortex.agent.yaml; do
+        case "$check_fname" in
+            neocortex.md)          check_min=512 ;;
+            neocortex.agent.yaml)  check_min=128 ;;
+        esac
+        check_fpath="${DEST_DIR}/${check_fname}"
+
+        if [ ! -f "$check_fpath" ]; then
+            report="${report}FAIL ${check_fname} (nao encontrado)\n"
+            fails=$((fails + 1))
+        else
+            check_size=$(wc -c < "$check_fpath" 2>/dev/null | tr -d ' ')
+            if [ "$check_size" -lt "$check_min" ] 2>/dev/null; then
+                report="${report}FAIL ${check_fname} (${check_size} bytes - possivelmente corrompido, minimo ${check_min})\n"
+                fails=$((fails + 1))
+            else
+                # ─── Layer 2: Content marker (frontmatter) ──────────────
+                check_ext="${check_fname##*.}"
+                if [ "$check_ext" = "md" ]; then
+                    check_first_line=$(head -1 "$check_fpath" 2>/dev/null)
+                    if [ "$check_first_line" != "---" ]; then
+                        report="${report}WARN ${check_fname} (formato invalido - sem frontmatter)\n"
+                        warns=$((warns + 1))
+                    else
+                        if [ "$check_size" -ge 1024 ]; then check_display="$((check_size / 1024))KB"; else check_display="${check_size}B"; fi
+                        report="${report}OK   ${check_fname} (${check_display})\n"
+                    fi
+                else
+                    if [ "$check_size" -ge 1024 ]; then check_display="$((check_size / 1024))KB"; else check_display="${check_size}B"; fi
+                    report="${report}OK   ${check_fname} (${check_display})\n"
+                fi
+            fi
+        fi
+    done
+
+    if [ "$LOCAL_MODE" = true ]; then
+        # ─── Layer 3: Step directories (local mode only) ─────────────────
+        for dir in steps-c steps-e steps-p steps-r steps-u; do
+            local dir_path="$DEST_DIR/$dir"
+            if [ ! -d "$dir_path" ]; then
+                report="${report}FAIL ${dir}/ (diretorio nao encontrado)\n"
+                fails=$((fails + 1))
+            else
+                local md_count=0
+                for f in "$dir_path"/*.md; do
+                    [ -f "$f" ] && md_count=$((md_count + 1))
+                done
+                if [ $md_count -eq 0 ]; then
+                    report="${report}WARN ${dir}/ (vazio - nenhum arquivo .md)\n"
+                    warns=$((warns + 1))
+                else
+                    report="${report}OK   ${dir}/ (${md_count} arquivos)\n"
+                fi
+            fi
+        done
+
+        # ─── Layer 3b: Core directory (local mode only) ──────────────────
+        if [ ! -d "$DEST_DIR/core" ]; then
+            report="${report}FAIL core/ (diretorio nao encontrado)\n"
+            fails=$((fails + 1))
+        else
+            report="${report}OK   core/\n"
+        fi
+    else
+        # ─── Layer 3: Thin client config (remote mode) ───────────────────
+        local config_file="${HOME}/.neocortex/config.json"
+        if [ -f "$config_file" ]; then
+            report="${report}OK   ~/.neocortex/config.json (thin client configurado)\n"
+        else
+            report="${report}WARN ~/.neocortex/config.json (nao encontrado)\n"
+            warns=$((warns + 1))
+        fi
+
+        # Verify NO IP directories exist
+        local ip_found=false
+        for dir in core steps-c steps-e steps-p steps-r steps-u; do
+            if [ -d "$DEST_DIR/$dir" ]; then
+                report="${report}WARN ${dir}/ ainda existe (deveria ter sido removido)\n"
+                warns=$((warns + 1))
+                ip_found=true
+            fi
+        done
+        if [ "$ip_found" = false ]; then
+            report="${report}OK   Zero IP no filesystem (modo remoto)\n"
+        fi
+    fi
+
+    # ─── Display report ─────────────────────────────────────────────────
+    if [ $fails -eq 0 ] && [ $warns -eq 0 ]; then
+        # All good - compact output
+        if [ "$QUIET_MODE" != true ]; then
+            ok "Instalacao verificada"
+        fi
+        return 0
+    fi
+
+    # Show detailed report when issues found
+    if [ "$QUIET_MODE" = true ] && [ $fails -eq 0 ]; then
+        return 0  # In quiet mode, skip warnings-only report
+    fi
+
+    echo ""
+    info "Verificacao pos-instalacao:"
+    echo -e "$report" | while IFS= read -r line; do
+        [ -z "$line" ] && continue
+        local status="${line%% *}"
+        local detail="${line#* }"
+        case "$status" in
+            OK)   echo -e "    ${GREEN}${SYM_OK}${NC} $detail" ;;
+            WARN) echo -e "    ${YELLOW}${SYM_WARN}${NC} $detail" ;;
+            FAIL) echo -e "    ${RED}${SYM_FAIL}${NC} $detail" ;;
+        esac
+    done
+
+    [ $fails -gt 0 ] && return 1
+    return 0
+}
+
+# =============================================================================
+# RESULTADO
+# =============================================================================
+
+show_result() {
+    local install_status=$1
+    [ "$QUIET_MODE" = true ] && return
+
+    echo ""
+    echo -e "  ${DIM}────────────────────────────────────────${NC}"
+
+    if [ $install_status -eq 0 ] && verify_installation; then
+        echo ""
+        echo -e "  ${GREEN}${BOLD}Instalacao concluida!${NC}"
+        echo ""
+        if [ "$LOCAL_MODE" = true ]; then
+            echo -e "  ${DIM}Modo:${NC}    Local (IP completa copiada)"
+            echo -e "  ${DIM}Locais:${NC}"
+            echo -e "    ${DIM}Agente:${NC}  ~/.claude/agents/neocortex/"
+            echo -e "    ${DIM}Skills:${NC}  ~/.claude/skills/neocortex/"
+        else
+            echo -e "  ${DIM}Modo:${NC}    Remoto (Tier 3 - thin client)"
+            echo -e "  ${DIM}Locais:${NC}"
+            echo -e "    ${DIM}Agente:${NC}  ~/.claude/agents/neocortex/ ${DIM}(3 arquivos)${NC}"
+            echo -e "    ${DIM}Config:${NC}  ~/.neocortex/config.json"
+            echo ""
+            echo -e "  ${DIM}Ative sua licenca:${NC}"
+            echo -e "    ${CYAN}npx @ornexus/neocortex-client activate NX-PRO-xxx${NC}"
+        fi
+        echo ""
+        echo -e "  ${DIM}Proximo passo:${NC}"
+        echo -e "    ${CYAN}@neocortex *init @docs/epics.md${NC}"
+        echo ""
+    else
+        echo ""
+        echo -e "  ${RED}${BOLD}Instalacao com problemas${NC}"
+        echo ""
+        echo -e "  Execute novamente com ${BOLD}--debug${NC} para detalhes:"
+        echo -e "    ${YELLOW}npx @ornexus/neocortex --debug${NC}"
+        echo ""
+        return 1
+    fi
+}
+
+# =============================================================================
+# CRIACAO DE DIRETORIOS DO PROJETO
+# =============================================================================
+
+create_project_dirs() {
+    [ "$QUIET_MODE" = true ] && return
+    [ "$SKIP_PROJECT_DIRS" = true ] && return
+
+    local should_create=false
+
+    if [ "$CREATE_PROJECT" = true ] || [ "$AUTO_YES" = true ]; then
+        should_create=true
+    else
+        echo -ne "  Instalar estrutura no projeto atual? ${BOLD}[s/N]:${NC} "
+
+        local response="n"
+        if read -r -t 30 response </dev/tty 2>/dev/null; then
+            :
+        else
+            echo ""
+            response="n"
+        fi
+
+        [[ "$response" =~ ^([sS][iI]?[mM]?|[yY][eE]?[sS]?)$ ]] && should_create=true
+    fi
+
+    if [ "$should_create" = true ]; then
+        local project_dir="$PWD"
+
+        # Clean previous project files
+        rm -rf "$project_dir/targets/claude-code" 2>/dev/null
+        rm -f "$project_dir/.cursor/agents/neocortex.md" 2>/dev/null
+        rm -rf "$project_dir/.cursor/skills" 2>/dev/null
+        rm -f "$project_dir/.github/agents/neocortex.md" 2>/dev/null
+        rm -rf "$project_dir/.github/skills" 2>/dev/null
+        rm -f "$project_dir/.github/copilot-instructions.md" 2>/dev/null
+        rm -rf "$project_dir/.agent/skills/neocortex" 2>/dev/null
+        rm -f "$project_dir/AGENTS.md" 2>/dev/null
+        rm -rf "$project_dir/.agents/skills" 2>/dev/null
+        rm -f "$project_dir/GEMINI.md" 2>/dev/null
+        rm -rf "$project_dir/.claude/agents/neocortex" 2>/dev/null
+        rm -rf "$project_dir/.claude/skills/neocortex" 2>/dev/null
+
+        if [ "$LOCAL_MODE" = true ]; then
+            # Modo local: limpar e reconstruir core/
+            rm -rf "$project_dir/core" 2>/dev/null
+        fi
+
+        # Create base directories
+        mkdir -p "$project_dir/.neocortex/specs" \
+                 "$project_dir/.neocortex/planning" \
+                 "$project_dir/docs/stories" \
+                 "$project_dir/docs/epics" \
+                 "$project_dir/docs/proposals" 2>/dev/null
+
+        # Copy state template if needed
+        if [ ! -f "$project_dir/.neocortex/state.json" ]; then
+            [ -f "$SOURCE_DIR/core/data/state-template.json" ] && \
+                cp "$SOURCE_DIR/core/data/state-template.json" "$project_dir/.neocortex/state.json"
+        fi
+
+        # Copy core (ONLY in local mode)
+        if [ "$LOCAL_MODE" = true ] && [ -d "$SOURCE_DIR/core" ]; then
+            mkdir -p "$project_dir/core"
+            cp -r "$SOURCE_DIR/core"/* "$project_dir/core/" 2>/dev/null
+        fi
+
+        # Install target-specific files
+        local targets_list
+        targets_list=$(echo "$SELECTED_TARGETS" | tr ',' ' ')
+        local target_summary=""
+
+        for target in $targets_list; do
+            case "$target" in
+                claude-code)
+                    local claude_target_dir="$SOURCE_DIR/targets/claude-code"
+                    if [ -d "$claude_target_dir" ]; then
+                        mkdir -p "$project_dir/.claude/agents/neocortex"
+
+                        # Tier 3: copiar apenas 2 stub files
+                        cp "$claude_target_dir/neocortex.md" "$project_dir/.claude/agents/neocortex/" 2>/dev/null
+                        cp "$claude_target_dir/neocortex.agent.yaml" "$project_dir/.claude/agents/neocortex/" 2>/dev/null
+                        # Cleanup workflow.md from previous versions
+                        rm -f "$project_dir/.claude/agents/neocortex/workflow.md" 2>/dev/null
+
+                        if [ "$LOCAL_MODE" = true ]; then
+                            # Modo local: copiar IP completa (comportamento legado)
+                            cp "$SOURCE_DIR/package.json" "$project_dir/.claude/agents/neocortex/" 2>/dev/null
+                            cp "$SOURCE_DIR/README.md" "$project_dir/.claude/agents/neocortex/" 2>/dev/null
+                            mkdir -p "$project_dir/.claude/agents/neocortex/core"
+                            cp -r "$SOURCE_DIR/core"/* "$project_dir/.claude/agents/neocortex/core/" 2>/dev/null
+                            for folder in steps-c steps-e steps-p steps-r steps-u; do
+                                if [ -d "$SOURCE_DIR/core/steps/$folder" ]; then
+                                    mkdir -p "$project_dir/.claude/agents/neocortex/$folder"
+                                    cp -r "$SOURCE_DIR/core/steps/$folder"/* "$project_dir/.claude/agents/neocortex/$folder/" 2>/dev/null
+                                fi
+                            done
+                            if [ -d "$SOURCE_DIR/core/skills" ]; then
+                                mkdir -p "$project_dir/.claude/skills/neocortex"
+                                cp -r "$SOURCE_DIR/core/skills"/* "$project_dir/.claude/skills/neocortex/" 2>/dev/null
+                            fi
+                        else
+                            # Tier 3 Remote Mode: limpar IP de versoes anteriores no projeto
+                            cleanup_legacy_ip_project "$project_dir"
+                        fi
+                        target_summary="${target_summary}claude-code, "
+                    fi
+                    ;;
+                cursor)
+                    local adapter_script="$SOURCE_DIR/targets/cursor/install-cursor.sh"
+                    if [ -f "$adapter_script" ]; then
+                        . "$adapter_script"
+                        install_cursor "$SOURCE_DIR" "$project_dir"
+                        target_summary="${target_summary}cursor, "
+                    fi
+                    ;;
+                vscode)
+                    local adapter_script="$SOURCE_DIR/targets/vscode/install-vscode.sh"
+                    if [ -f "$adapter_script" ]; then
+                        . "$adapter_script"
+                        install_vscode "$SOURCE_DIR" "$project_dir"
+                        target_summary="${target_summary}vscode, "
+                    fi
+                    ;;
+                gemini-cli)
+                    local gemini_target="$SOURCE_DIR/targets/gemini-cli"
+                    if [ -d "$gemini_target" ]; then
+                        [ -f "$gemini_target/gemini.md" ] && cp "$gemini_target/gemini.md" "$project_dir/GEMINI.md"
+                        if [ -d "$gemini_target/commands" ]; then
+                            mkdir -p "$project_dir/.gemini/commands"
+                            cp "$gemini_target/commands"/*.toml "$project_dir/.gemini/commands/" 2>/dev/null
+                        fi
+                        if [ -f "$gemini_target/agent.md" ]; then
+                            mkdir -p "$project_dir/.gemini/agents"
+                            cp "$gemini_target/agent.md" "$project_dir/.gemini/agents/neocortex.md"
+                        fi
+                        [ -f "$gemini_target/settings-mcp.json" ] && cp "$gemini_target/settings-mcp.json" "$project_dir/.gemini/settings-mcp.json"
+                        target_summary="${target_summary}gemini-cli, "
+                    fi
+                    ;;
+                codex)
+                    local adapter_script="$SOURCE_DIR/targets/codex/install-codex.sh"
+                    if [ -f "$adapter_script" ]; then
+                        . "$adapter_script"
+                        install_codex "$SOURCE_DIR" "$project_dir"
+                        target_summary="${target_summary}codex, "
+                    fi
+                    ;;
+                antigravity)
+                    local adapter_script="$SOURCE_DIR/targets/antigravity/install-antigravity.sh"
+                    if [ -f "$adapter_script" ]; then
+                        . "$adapter_script"
+                        install_antigravity "$SOURCE_DIR" "$project_dir"
+                        target_summary="${target_summary}antigravity, "
+                    fi
+                    ;;
+            esac
+        done
+
+        echo ""
+        ok "Estrutura do projeto instalada ${DIM}(${target_summary%, })${NC}"
+        echo ""
+        info "Proximo passo: ${CYAN}@neocortex *init @docs/epics.md${NC}"
+    fi
+}
+
+# =============================================================================
+# MIGRACAO
+# =============================================================================
+
+show_migration_info() {
+    [ "$QUIET_MODE" = true ] && return
+
+    local project_sources
+    if project_sources=$(detect_project_migration_needs); then
+        echo ""
+        warn "${BOLD}Migracao detectada${NC}"
+        for src in $project_sources; do
+            info "Arquivo antigo: $src"
+        done
+        info "Execute: ${CYAN}@neocortex *init @docs/epics.md${NC} para migrar"
+    fi
+}
+
+# =============================================================================
+# MAIN
+# =============================================================================
+
+TOTAL_STEPS=3
+
+main() {
+    show_banner
+    detect_source_dir
+    detect_old_installation
+    detect_legacy_artifacts
+    cleanup_legacy_artifacts
+
+    # Determine targets
+    if [ -z "$SELECTED_TARGETS" ]; then
+        SELECTED_TARGETS="claude-code"
+    fi
+
+    debug "Targets: $SELECTED_TARGETS"
+
+    # Validate targets
+    local invalid_targets=""
+    for target in $(echo "$SELECTED_TARGETS" | tr ',' ' '); do
+        echo "$VALID_TARGETS" | grep -wq "$target" || invalid_targets="$invalid_targets $target"
+    done
+
+    if [ -n "$invalid_targets" ]; then
+        fail "Plataformas invalidas:$invalid_targets"
+        fail "Validas: $VALID_TARGETS"
+        exit 1
+    fi
+
+    # Count targets for step total
+    local target_count=$(echo "$SELECTED_TARGETS" | tr ',' ' ' | wc -w | tr -d ' ')
+    if echo "$SELECTED_TARGETS" | grep -q "claude-code"; then
+        TOTAL_STEPS=5  # core + skills + targets + mcps + tools
+    fi
+
+    # Step 1: Core
+    step 1 $TOTAL_STEPS "Instalando core"
+    install_core
+    local core_result=$?
+    if [ $core_result -ne 0 ]; then
+        fail "Falha na instalacao do core"
+        exit 1
+    fi
+
+    # Step 2: Skills
+    step 2 $TOTAL_STEPS "Instalando skills"
+    install_skills
+
+    # Step 3: Targets
+    step 3 $TOTAL_STEPS "Instalando ${BOLD}$target_count${NC} plataforma(s)"
+    install_targets "$SELECTED_TARGETS"
+
+    # Step 4-5: Claude Code extras
+    if echo "$SELECTED_TARGETS" | grep -q "claude-code"; then
+        load_env_file
+        prompt_tokens
+
+        step 4 $TOTAL_STEPS "Configurando MCPs"
+        install_mcps
+
+        step 5 $TOTAL_STEPS "Verificando ferramentas"
+        install_coderabbit
+    fi
+
+    # Result
+    show_result $core_result
+    local result_code=$?
+
+    if [ $result_code -eq 0 ]; then
+        show_migration_info
+        create_project_dirs
+        echo -e "  ${DIM}Desenvolvido por OrNexus Team${NC}"
+        echo ""
+    fi
+
+    exit $result_code
+}
+
+main