@ornexus/neocortex 3.8.1 → 3.8.2

package/install.ps1

@@ -15,7 +15,7 @@ param(
     [string]$ServerUrl = "https://api.neocortex.ornexus.com"
 )
 
-$VERSION = "3.8.1"
+$VERSION = "3.8.2"
 
 # =============================================================================
 # CONFIGURACOES
@@ -65,7 +65,7 @@ if ($Help) {
     Write-Host "    -CreateProject   Instalar estrutura no projeto" -ForegroundColor Cyan
     Write-Host "    -SkipProject     Nao perguntar sobre projeto" -ForegroundColor Cyan
     Write-Host "    -Quiet           Modo silencioso" -ForegroundColor Cyan
-    Write-Host "    -CleanupLegacy   Remover artefatos legados de ~/.claude/" -ForegroundColor Cyan
+    Write-Host "    -CleanupLegacy   (Redundante) Limpeza agora e automatica" -ForegroundColor Cyan
     Write-Host "    -Local           Modo local (copia IP para desenvolvimento)" -ForegroundColor Cyan
     Write-Host "    -ServerUrl <url> URL do server Neocortex" -ForegroundColor Cyan
     Write-Host "    -Debug           Modo debug" -ForegroundColor Cyan
@@ -264,136 +264,178 @@ function Test-ProjectMigrationNeeds {
 }
 
 # =============================================================================
-# DETECCAO DE ARTEFATOS LEGADOS
+# LIMPEZA AUTOMATICA DE ARTEFATOS LEGADOS (Invoke-AutoCleanupLegacy)
+# Unifica: Test-LegacyArtifacts + Invoke-CleanupLegacy + Remove-LegacyIP
+#          + Remove-LegacyIPProject + npm globals + cross-platform cleanup
+# Roda AUTOMATICAMENTE a cada instalacao - sem necessidade de -CleanupLegacy
+# Idempotente: rodar multiplas vezes sem efeitos colaterais
+# Seguro: NAO remove dados do usuario (stories, epics, state.json, config.json)
 # =============================================================================
 
-function Test-LegacyArtifacts {
-    $warnings = 0
-    $script:LegacyItems = @()
+function Invoke-AutoCleanupLegacy {
+    $removed = 0
+    $claudeDir = "$env:USERPROFILE\.claude"
+    $neocortexDir = "$claudeDir\agents\neocortex"
+    $skillsDir = "$claudeDir\skills\neocortex"
+
+    Write-Dbg "Executando limpeza automatica de artefatos legados..."
+
+    # --- Helper: remove e loga ---
+    function Remove-LegacyItem {
+        param([string]$Target, [string]$Label)
+        if (Test-Path $Target) {
+            $displayItem = $Target -replace [regex]::Escape($env:USERPROFILE), "~"
+            try {
+                Remove-Item -Path $Target -Recurse -Force -ErrorAction Stop
+                Write-Info "Removido: $displayItem ($Label)"
+                $script:autoRemoved++
+            } catch {
+                Write-Dbg "Falha ao remover: $displayItem"
+            }
+        }
+    }
 
-    Write-Dbg "Verificando artefatos legados em ~/.claude/..."
+    $script:autoRemoved = 0
 
-    $claudeDir = "$env:USERPROFILE\.claude"
+    # --- Categoria 1: Pacotes NPM globais legados ---
+    $npmCmd = Get-Command npm -ErrorAction SilentlyContinue
+    if ($npmCmd) {
+        foreach ($pkg in @("@ornexus/neocortex-cli", "@ornexus-ai/neocortex")) {
+            $npmList = & npm list -g $pkg --depth=0 2>$null
+            if ($npmList -match [regex]::Escape($pkg)) {
+                try {
+                    & npm uninstall -g $pkg 2>$null
+                    if ($LASTEXITCODE -eq 0) {
+                        Write-Info "Removido: $pkg (pacote npm global legado)"
+                        $script:autoRemoved++
+                    }
+                } catch {
+                    Write-Dbg "Falha ao remover pacote npm: $pkg"
+                }
+            }
+        }
 
-    # Check 1: .git inside agents/ (leftover from contains-studio/agents repo)
-    if (Test-Path "$claudeDir\agents\.git" -PathType Container) {
-        Write-Warn "Repositorio .git detectado em ~\.claude\agents\"
-        Write-Info "Pode conflitar com instalacoes do Neocortex"
-        Write-Info "Execute com -CleanupLegacy para remover"
-        $script:LegacyItems += "$claudeDir\agents\.git"
-        $warnings++
+        # Verificar binario neocortex-cli no PATH
+        $ncliCmd = Get-Command neocortex-cli -ErrorAction SilentlyContinue
+        if ($ncliCmd -and $ncliCmd.Source -match "node_modules|npm") {
+            try {
+                Remove-Item -Path $ncliCmd.Source -Force -ErrorAction Stop
+                Write-Info "Removido: $($ncliCmd.Source) (binario neocortex-cli legado)"
+                $script:autoRemoved++
+            } catch {
+                Write-Dbg "Falha ao remover binario neocortex-cli"
+            }
+        }
     }
 
-    # Check 2: Nested .claude\.claude\ (BMAD installation error)
-    if (Test-Path "$claudeDir\.claude" -PathType Container) {
-        Write-Warn "Diretorio aninhado detectado: ~\.claude\.claude\"
-        Write-Info "Possivelmente erro de instalacao anterior (BMAD)"
-        Write-Info "Execute com -CleanupLegacy para remover"
-        $script:LegacyItems += "$claudeDir\.claude"
-        $warnings++
-    }
+    # --- Categoria 2: Claude Code (~\.claude\) ---
+    # IP proprietaria de versoes anteriores
+    Remove-LegacyItem "$neocortexDir\core"             "IP legada"
+    Remove-LegacyItem $skillsDir                       "skills legadas"
+    Remove-LegacyItem "$neocortexDir\workflow.md"      "workflow removido no Tier 3"
+    Remove-LegacyItem "$neocortexDir\package.json"     "arquivo desnecessario"
+    Remove-LegacyItem "$neocortexDir\README.md"        "arquivo desnecessario"
 
-    # Check 3: Loose agents without namespace (files directly in agents\, not in subdirs)
-    $looseFiles = @()
-    if (Test-Path "$claudeDir\agents" -PathType Container) {
-        $looseFiles = Get-ChildItem -Path "$claudeDir\agents" -Filter "*.md" -File -ErrorAction SilentlyContinue
+    # Step folders legados
+    foreach ($folder in @("steps-c", "steps-e", "steps-p", "steps-r", "steps-u")) {
+        Remove-LegacyItem "$neocortexDir\$folder"      "steps legados"
     }
-    if ($looseFiles.Count -gt 0) {
-        Write-Info "$($looseFiles.Count) arquivo(s) .md solto(s) em ~\.claude\agents\"
-        foreach ($f in $looseFiles) {
-            Write-Dbg "  Solto: $($f.Name)"
+
+    # Artefatos de instalacoes anteriores
+    Remove-LegacyItem "$claudeDir\agents\.git"         "repo git antigo"
+    Remove-LegacyItem "$claudeDir\.claude"             "diretorio aninhado (erro BMAD)"
+    Remove-LegacyItem "$claudeDir\agents-ldtn"         "diretorio legado"
+    Remove-LegacyItem "$claudeDir\.superclaude-metadata.json" "metadata SuperClaude"
+
+    # Backups SuperClaude antigos
+    if (Test-Path "$claudeDir\backups" -PathType Container) {
+        Get-ChildItem -Path "$claudeDir\backups" -Filter "superclaude_backup_*.tar.gz" -File -ErrorAction SilentlyContinue | ForEach-Object {
+            Remove-LegacyItem $_.FullName "backup SuperClaude antigo"
         }
-        Write-Info "Considere organizar em namespaces (ex: agents\neocortex\)"
-        $warnings++
     }
 
-    # Check 4: Legacy agents-ldtn\ directory
-    if (Test-Path "$claudeDir\agents-ldtn" -PathType Container) {
-        Write-Warn "Diretorio legado detectado: ~\.claude\agents-ldtn\"
-        Write-Info "Execute com -CleanupLegacy para remover"
-        $script:LegacyItems += "$claudeDir\agents-ldtn"
-        $warnings++
+    # --- Categoria 3: Cursor ---
+    Remove-LegacyItem "$env:USERPROFILE\.cursor\neocortex" "configs Cursor legadas"
+    # .cursorrules com referencias neocortex (verificar antes de remover)
+    $cursorrules = "$env:USERPROFILE\.cursorrules"
+    if (Test-Path $cursorrules -PathType Leaf) {
+        $content = Get-Content $cursorrules -Raw -ErrorAction SilentlyContinue
+        if ($content -match "(?i)neocortex|ornexus|synapse") {
+            Remove-LegacyItem $cursorrules "cursorrules com refs legadas"
+        }
     }
 
-    # Check 5: .superclaude-metadata.json
-    if (Test-Path "$claudeDir\.superclaude-metadata.json" -PathType Leaf) {
-        Write-Warn "Metadata legado detectado: ~\.claude\.superclaude-metadata.json"
-        Write-Info "Execute com -CleanupLegacy para remover"
-        $script:LegacyItems += "$claudeDir\.superclaude-metadata.json"
-        $warnings++
+    # --- Categoria 4: VS Code ---
+    Remove-LegacyItem "$env:USERPROFILE\.vscode\neocortex" "configs VS Code legadas"
+    # .instructions.md com referencias neocortex antigo
+    $instructionsMd = "$env:USERPROFILE\.instructions.md"
+    if (Test-Path $instructionsMd -PathType Leaf) {
+        $content = Get-Content $instructionsMd -Raw -ErrorAction SilentlyContinue
+        if ($content -match "(?i)neocortex|ornexus|synapse") {
+            Remove-LegacyItem $instructionsMd "instructions.md com refs legadas"
+        }
     }
 
-    # Check 6: superclaude_backup_*.tar.gz in backups\
-    $backupCount = 0
-    if (Test-Path "$claudeDir\backups" -PathType Container) {
-        $backupCount = (Get-ChildItem -Path "$claudeDir\backups" -Filter "superclaude_backup_*.tar.gz" -File -ErrorAction SilentlyContinue).Count
-    }
-    if ($backupCount -gt 0) {
-        Write-Info "$backupCount backup(s) SuperClaude antigo(s) em ~\.claude\backups\"
-        $warnings++
-    }
+    # --- Categoria 5: Gemini CLI ---
+    Remove-LegacyItem "$env:USERPROFILE\.gemini\neocortex" "configs Gemini legadas"
+
+    # --- Categoria 6: Codex ---
+    Remove-LegacyItem "$env:USERPROFILE\.codex\neocortex" "configs Codex legadas"
+
+    # --- Categoria 7: Antigravity ---
+    # Configs legadas de Antigravity sao gerenciadas pelo adapter, sem path fixo global
 
-    if ($warnings -gt 0) {
-        Write-Warn "$warnings artefato(s) legado(s) detectado(s)"
+    # --- Resultado ---
+    $removed = $script:autoRemoved
+    if ($removed -gt 0) {
+        Write-Ok "$removed artefato(s) legado(s) removido(s) automaticamente"
+    } else {
+        Write-Dbg "Nenhum artefato legado encontrado"
     }
 
-    $script:LegacyWarnings = $warnings
-    return $warnings
+    # Resetar contadores legados (compatibilidade)
+    $script:LegacyItems = @()
+    $script:LegacyWarnings = 0
 }
 
-function Invoke-CleanupLegacy {
-    if (-not $CleanupLegacy) { return }
+# Cleanup de IP legada em projetos individuais (project-level)
+function Invoke-AutoCleanupLegacyProject {
+    param([string]$ProjectDir)
 
-    if ($script:LegacyWarnings -eq 0 -or $script:LegacyItems.Count -eq 0) {
-        Write-Info "Nenhum artefato legado encontrado para limpeza"
-        return
-    }
+    $neocortexDir = "$ProjectDir\.claude\agents\neocortex"
+    $skillsDir = "$ProjectDir\.claude\skills\neocortex"
+    $cleaned = $false
 
-    # Safety: refuse cleanup in -Yes mode (protect against automated deletion)
-    if ($AUTO_YES) {
-        Write-Warn "Cleanup requer confirmacao interativa (-Yes ignorado para seguranca)"
-        return
+    # Remover core/ e seus subdiretorios
+    if (Test-Path "$neocortexDir\core") {
+        Remove-Item -Path "$neocortexDir\core" -Recurse -Force -ErrorAction SilentlyContinue
+        $cleaned = $true
     }
 
-    # Show what will be removed
-    Write-Host ""
-    Write-Warn "Os seguintes artefatos serao removidos:"
-    foreach ($item in $script:LegacyItems) {
-        $displayItem = $item -replace [regex]::Escape($env:USERPROFILE), "~"
-        if (Test-Path $item -PathType Container) {
-            Write-Info "  - $displayItem\ (diretorio)"
-        } else {
-            Write-Info "  - $displayItem (arquivo)"
+    # Remover step folders
+    foreach ($folder in @("steps-c", "steps-e", "steps-p", "steps-r", "steps-u")) {
+        if (Test-Path "$neocortexDir\$folder") {
+            Remove-Item -Path "$neocortexDir\$folder" -Recurse -Force -ErrorAction SilentlyContinue
+            $cleaned = $true
         }
     }
 
-    Write-Host "  Confirmar remocao? [s/N]: " -NoNewline -ForegroundColor White
-    $response = Read-HostWithTimeout -TimeoutSeconds 30 -Default "n"
-
-    if ($response -notmatch "^[sS]([iI][mM]?)?$|^[yY]([eE][sS]?)?$") {
-        Write-Info "Cleanup cancelado"
-        return
+    # Remover skills
+    if (Test-Path $skillsDir) {
+        Remove-Item -Path $skillsDir -Recurse -Force -ErrorAction SilentlyContinue
+        $cleaned = $true
     }
 
-    # Execute cleanup
-    $removed = 0
-    $failed = 0
-    foreach ($item in $script:LegacyItems) {
-        $displayItem = $item -replace [regex]::Escape($env:USERPROFILE), "~"
-        try {
-            Remove-Item -Path $item -Recurse -Force -ErrorAction Stop
-            Write-Ok "Removido: $displayItem"
-            $removed++
-        } catch {
-            Write-Fail "Falha ao remover: $displayItem"
-            $failed++
+    # Remover arquivos desnecessarios
+    foreach ($file in @("package.json", "README.md", "workflow.md")) {
+        if (Test-Path "$neocortexDir\$file") {
+            Remove-Item -Path "$neocortexDir\$file" -Force -ErrorAction SilentlyContinue
+            $cleaned = $true
         }
     }
 
-    if ($failed -eq 0) {
-        Write-Ok "$removed artefato(s) removido(s) com sucesso"
-    } else {
-        Write-Warn "$removed removido(s), $failed falha(s)"
+    if ($cleaned) {
+        Write-Info "IP proprietaria removida do projeto (agora servida via server remoto)"
     }
 }
 
@@ -450,30 +492,54 @@ function Verify-Installation {
         }
     }
 
-    # --- Layer 3: Step directories ---
-    foreach ($dir in @("steps-c", "steps-e", "steps-p", "steps-r", "steps-u")) {
-        $dirPath = Join-Path $script:DestDir $dir
-        if (-not (Test-Path $dirPath -PathType Container)) {
-            $report += @{ Status = "FAIL"; Detail = "$dir/ (diretorio nao encontrado)" }
-            $fails++
-        } else {
-            $mdCount = (Get-ChildItem -Path $dirPath -Filter "*.md" -File -ErrorAction SilentlyContinue).Count
-            if ($mdCount -eq 0) {
-                $report += @{ Status = "WARN"; Detail = "$dir/ (vazio - nenhum arquivo .md)" }
-                $warns++
+    if ($LOCAL_MODE) {
+        # --- Layer 3: Step directories (local mode only) ---
+        foreach ($dir in @("steps-c", "steps-e", "steps-p", "steps-r", "steps-u")) {
+            $dirPath = Join-Path $script:DestDir $dir
+            if (-not (Test-Path $dirPath -PathType Container)) {
+                $report += @{ Status = "FAIL"; Detail = "$dir/ (diretorio nao encontrado)" }
+                $fails++
             } else {
-                $report += @{ Status = "OK"; Detail = "$dir/ ($mdCount arquivos)" }
+                $mdCount = (Get-ChildItem -Path $dirPath -Filter "*.md" -File -ErrorAction SilentlyContinue).Count
+                if ($mdCount -eq 0) {
+                    $report += @{ Status = "WARN"; Detail = "$dir/ (vazio - nenhum arquivo .md)" }
+                    $warns++
+                } else {
+                    $report += @{ Status = "OK"; Detail = "$dir/ ($mdCount arquivos)" }
+                }
             }
         }
-    }
 
-    # --- Layer 3b: Core directory ---
-    $corePath = Join-Path $script:DestDir "core"
-    if (-not (Test-Path $corePath -PathType Container)) {
-        $report += @{ Status = "FAIL"; Detail = "core/ (diretorio nao encontrado)" }
-        $fails++
+        # --- Layer 3b: Core directory (local mode only) ---
+        $corePath = Join-Path $script:DestDir "core"
+        if (-not (Test-Path $corePath -PathType Container)) {
+            $report += @{ Status = "FAIL"; Detail = "core/ (diretorio nao encontrado)" }
+            $fails++
+        } else {
+            $report += @{ Status = "OK"; Detail = "core/" }
+        }
     } else {
-        $report += @{ Status = "OK"; Detail = "core/" }
+        # --- Layer 3: Thin client config (remote mode) ---
+        $configFile = "$env:USERPROFILE\.neocortex\config.json"
+        if (Test-Path $configFile -PathType Leaf) {
+            $report += @{ Status = "OK"; Detail = "~\.neocortex\config.json (thin client configurado)" }
+        } else {
+            $report += @{ Status = "WARN"; Detail = "~\.neocortex\config.json (nao encontrado)" }
+            $warns++
+        }
+
+        # Verify NO IP directories exist
+        $ipFound = $false
+        foreach ($dir in @("core", "steps-c", "steps-e", "steps-p", "steps-r", "steps-u")) {
+            if (Test-Path (Join-Path $script:DestDir $dir) -PathType Container) {
+                $report += @{ Status = "WARN"; Detail = "$dir/ ainda existe (deveria ter sido removido)" }
+                $warns++
+                $ipFound = $true
+            }
+        }
+        if (-not $ipFound) {
+            $report += @{ Status = "OK"; Detail = "Zero IP no filesystem (modo remoto)" }
+        }
     }
 
     # --- Display report ---
@@ -503,47 +569,9 @@ function Verify-Installation {
 }
 
 # =============================================================================
-# TIER 3: CLEANUP DE IP LEGADA E CONFIG DO THIN CLIENT
+# TIER 3: CONFIG DO THIN CLIENT
 # =============================================================================
 
-function Remove-LegacyIP {
-    $neocortexDir = "$env:USERPROFILE\.claude\agents\neocortex"
-    $skillsDir = "$env:USERPROFILE\.claude\skills\neocortex"
-    $cleaned = $false
-
-    # Remover core/ e seus subdiretorios
-    if (Test-Path "$neocortexDir\core") {
-        Remove-Item -Path "$neocortexDir\core" -Recurse -Force -ErrorAction SilentlyContinue
-        $cleaned = $true
-    }
-
-    # Remover step folders
-    foreach ($folder in @("steps-c", "steps-e", "steps-p", "steps-r", "steps-u")) {
-        if (Test-Path "$neocortexDir\$folder") {
-            Remove-Item -Path "$neocortexDir\$folder" -Recurse -Force -ErrorAction SilentlyContinue
-            $cleaned = $true
-        }
-    }
-
-    # Remover skills
-    if (Test-Path $skillsDir) {
-        Remove-Item -Path $skillsDir -Recurse -Force -ErrorAction SilentlyContinue
-        $cleaned = $true
-    }
-
-    # Remover arquivos desnecessarios
-    foreach ($file in @("package.json", "README.md")) {
-        if (Test-Path "$neocortexDir\$file") {
-            Remove-Item -Path "$neocortexDir\$file" -Force -ErrorAction SilentlyContinue
-            $cleaned = $true
-        }
-    }
-
-    if ($cleaned) {
-        Write-Info "IP proprietaria removida de versao anterior (agora servida via server remoto)"
-    }
-}
-
 function Set-ThinClientConfig {
     $configDir = "$env:USERPROFILE\.neocortex"
     $configFile = "$configDir\config.json"
@@ -584,41 +612,8 @@ function Set-ThinClientConfig {
     Write-Dbg "Thin client config criada: $configFile"
 }
 
-function Remove-LegacyIPProject {
-    param([string]$ProjectDir)
-
-    $neocortexDir = "$ProjectDir\.claude\agents\neocortex"
-    $skillsDir = "$ProjectDir\.claude\skills\neocortex"
-    $cleaned = $false
-
-    if (Test-Path "$neocortexDir\core") {
-        Remove-Item -Path "$neocortexDir\core" -Recurse -Force -ErrorAction SilentlyContinue
-        $cleaned = $true
-    }
-
-    foreach ($folder in @("steps-c", "steps-e", "steps-p", "steps-r", "steps-u")) {
-        if (Test-Path "$neocortexDir\$folder") {
-            Remove-Item -Path "$neocortexDir\$folder" -Recurse -Force -ErrorAction SilentlyContinue
-            $cleaned = $true
-        }
-    }
-
-    if (Test-Path $skillsDir) {
-        Remove-Item -Path $skillsDir -Recurse -Force -ErrorAction SilentlyContinue
-        $cleaned = $true
-    }
-
-    foreach ($file in @("package.json", "README.md")) {
-        if (Test-Path "$neocortexDir\$file") {
-            Remove-Item -Path "$neocortexDir\$file" -Force -ErrorAction SilentlyContinue
-            $cleaned = $true
-        }
-    }
-
-    if ($cleaned) {
-        Write-Info "IP proprietaria removida do projeto (agora servida via server remoto)"
-    }
-}
+# Remove-LegacyIPProject substituida por Invoke-AutoCleanupLegacyProject
+# (definida na secao de limpeza automatica acima)
 
 # =============================================================================
 # INSTALACAO CORE
@@ -654,7 +649,7 @@ function Install-Core {
         Copy-Silent "$($script:SourceDir)\README.md" "$script:DestDir\" | Out-Null
     } else {
         # Tier 3 Remote Mode: NAO copiar IP
-        Remove-LegacyIP
+        # Nota: Invoke-AutoCleanupLegacy ja rodou no inicio - aqui apenas config
         Set-ThinClientConfig
     }
 
@@ -1239,7 +1234,7 @@ function New-ProjectDirectories {
                         }
                     } else {
                         # Tier 3 Remote Mode: limpar IP de versoes anteriores no projeto
-                        Remove-LegacyIPProject -ProjectDir $projectDir
+                        Invoke-AutoCleanupLegacyProject -ProjectDir $projectDir
                     }
                     $targetSummary += "claude-code"
                 }
@@ -1379,9 +1374,20 @@ function Show-Result {
         Write-Host ""
         Write-Host "  Instalacao concluida!" -ForegroundColor Green
         Write-Host ""
-        Write-Host "  Locais:" -ForegroundColor DarkGray
-        Write-Host "    Agente:  ~\.claude\agents\neocortex\" -ForegroundColor DarkGray
-        Write-Host "    Skills:  ~\.claude\skills\neocortex\" -ForegroundColor DarkGray
+        if ($LOCAL_MODE) {
+            Write-Host "  Modo:    Local (IP completa copiada)" -ForegroundColor DarkGray
+            Write-Host "  Locais:" -ForegroundColor DarkGray
+            Write-Host "    Agente:  ~\.claude\agents\neocortex\" -ForegroundColor DarkGray
+            Write-Host "    Skills:  ~\.claude\skills\neocortex\" -ForegroundColor DarkGray
+        } else {
+            Write-Host "  Modo:    Remoto (Tier 3 - thin client)" -ForegroundColor DarkGray
+            Write-Host "  Locais:" -ForegroundColor DarkGray
+            Write-Host "    Agente:  ~\.claude\agents\neocortex\ (3 arquivos)" -ForegroundColor DarkGray
+            Write-Host "    Config:  ~\.neocortex\config.json" -ForegroundColor DarkGray
+            Write-Host ""
+            Write-Host "  Ative sua licenca:" -ForegroundColor DarkGray
+            Write-Host "    npx @ornexus/neocortex-client activate NX-PRO-xxx" -ForegroundColor Cyan
+        }
         Write-Host ""
         Write-Host "  Proximo passo:" -ForegroundColor DarkGray
         Write-Host "    @neocortex *init @docs/epics.md" -ForegroundColor Cyan
@@ -1407,8 +1413,6 @@ function Show-Result {
 Show-Banner
 Get-SourceDirectory
 Test-OldInstallation
-Test-LegacyArtifacts | Out-Null
-Invoke-CleanupLegacy
 
 # Determine targets
 if ($Targets) {
@@ -1427,11 +1431,15 @@ if ($Targets) {
 
 Write-Dbg "Targets: $($script:SelectedTargets -join ', ')"
 
-$totalSteps = 3
-if ($script:SelectedTargets -contains "claude-code") { $totalSteps = 5 }
+$totalSteps = 4
+if ($script:SelectedTargets -contains "claude-code") { $totalSteps = 6 }
+
+# Step 1: Limpeza automatica de versoes anteriores
+Write-Step 1 $totalSteps "Limpeza de versoes anteriores"
+Invoke-AutoCleanupLegacy
 
-# Step 1: Core
-Write-Step 1 $totalSteps "Instalando core"
+# Step 2: Core
+Write-Step 2 $totalSteps "Instalando core"
 $coreSuccess = Install-Core
 
 if (-not $coreSuccess) {
@@ -1439,23 +1447,23 @@ if (-not $coreSuccess) {
     exit 1
 }
 
-# Step 2: Skills
-Write-Step 2 $totalSteps "Instalando skills"
+# Step 3: Skills
+Write-Step 3 $totalSteps "Instalando skills"
 Install-Skills | Out-Null
 
-# Step 3: Targets
-Write-Step 3 $totalSteps "Instalando $($script:SelectedTargets.Count) plataforma(s)"
+# Step 4: Targets
+Write-Step 4 $totalSteps "Instalando $($script:SelectedTargets.Count) plataforma(s)"
 Install-Targets -TargetList $script:SelectedTargets
 
-# Step 4-5: Claude Code extras
+# Step 5-6: Claude Code extras
 if ($script:SelectedTargets -contains "claude-code") {
     Import-EnvFile | Out-Null
     Request-Tokens
 
-    Write-Step 4 $totalSteps "Configurando MCPs"
+    Write-Step 5 $totalSteps "Configurando MCPs"
     Install-MCPs
 
-    Write-Step 5 $totalSteps "Verificando ferramentas"
+    Write-Step 6 $totalSteps "Verificando ferramentas"
     Install-CodeRabbit
 }
 

package/install.sh

@@ -4,7 +4,7 @@
 # Epic & Story Development Orchestrator
 
 # Versao do instalador
-VERSION="3.8.1"
+VERSION="3.8.2"
 
 # Flags
 MIGRATION_DETECTED=false
@@ -74,7 +74,7 @@ while [[ $# -gt 0 ]]; do
             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 "    --cleanup-legacy          (Redundante) Limpeza agora e automatica"
             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"
@@ -240,165 +240,172 @@ detect_old_installation() {
     fi
 }
 
-detect_legacy_artifacts() {
-    local warnings=0
-    local legacy_items=""
-    local claude_dir="$HOME/.claude"
+# =============================================================================
+# LIMPEZA AUTOMATICA DE ARTEFATOS LEGADOS (auto_cleanup_legacy)
+# Unifica: detect_legacy_artifacts + cleanup_legacy_artifacts + cleanup_legacy_ip
+#          + cleanup_legacy_ip_project + npm globals + cross-platform cleanup
+# Roda AUTOMATICAMENTE a cada instalacao - sem necessidade de --cleanup-legacy
+# Idempotente: rodar multiplas vezes sem efeitos colaterais
+# Seguro: NAO remove dados do usuario (stories, epics, state.json, config.json)
+# =============================================================================
 
-    debug "Verificando artefatos legados em ~/.claude/..."
+auto_cleanup_legacy() {
+    local removed=0
+    local claude_dir="$HOME/.claude"
+    local neocortex_dir="$claude_dir/agents/neocortex"
+    local skills_dir="$claude_dir/skills/neocortex"
+
+    debug "Executando limpeza automatica de artefatos legados..."
+
+    # ─── Helper: remove e loga ───────────────────────────────────────────
+    _remove_legacy() {
+        local target="$1"
+        local label="$2"
+        if [ -e "$target" ]; then
+            local display="${target/#$HOME/~}"
+            if rm -rf "$target" 2>/dev/null; then
+                info "Removido: $display ($label)"
+                removed=$((removed + 1))
+            else
+                debug "Falha ao remover: $display"
+            fi
+        fi
+    }
+
+    # ─── Categoria 1: Pacotes NPM globais legados ────────────────────────
+    if command -v npm >/dev/null 2>&1; then
+        # Verificar e remover pacotes npm globais legados
+        for pkg in "@ornexus/neocortex-cli" "@ornexus-ai/neocortex"; do
+            if npm list -g "$pkg" --depth=0 2>/dev/null | grep -q "$pkg"; then
+                if npm uninstall -g "$pkg" 2>/dev/null; then
+                    info "Removido: $pkg (pacote npm global legado)"
+                    removed=$((removed + 1))
+                else
+                    debug "Falha ao remover pacote npm: $pkg"
+                fi
+            fi
+        done
 
-    # 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))
+        # Verificar binario neocortex-cli no PATH
+        local ncli_path
+        ncli_path=$(command -v neocortex-cli 2>/dev/null || true)
+        if [ -n "$ncli_path" ]; then
+            # Verificar se e um link/binario npm (nao remover se for outro tool)
+            if [[ "$ncli_path" == *"node_modules"* ]] || [[ "$ncli_path" == *"npm"* ]]; then
+                rm -f "$ncli_path" 2>/dev/null && {
+                    info "Removido: $ncli_path (binario neocortex-cli legado)"
+                    removed=$((removed + 1))
+                }
+            fi
+        fi
     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
+    # ─── Categoria 2: Claude Code (~/.claude/) ────────────────────────────
+    # IP proprietaria de versoes anteriores
+    _remove_legacy "$neocortex_dir/core"             "IP legada"
+    _remove_legacy "$skills_dir"                     "skills legadas"
+    _remove_legacy "$neocortex_dir/workflow.md"      "workflow removido no Tier 3"
+    _remove_legacy "$neocortex_dir/package.json"     "arquivo desnecessario"
+    _remove_legacy "$neocortex_dir/README.md"        "arquivo desnecessario"
 
-    # 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
+    # Step folders legados
+    for folder in steps-c steps-e steps-p steps-r steps-u; do
+        _remove_legacy "$neocortex_dir/$folder"      "steps legados"
+    done
 
-    # 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
+    # Artefatos de instalacoes anteriores
+    _remove_legacy "$claude_dir/agents/.git"         "repo git antigo"
+    _remove_legacy "$claude_dir/.claude"             "diretorio aninhado (erro BMAD)"
+    _remove_legacy "$claude_dir/agents-ldtn"         "diretorio legado"
+    _remove_legacy "$claude_dir/.superclaude-metadata.json" "metadata SuperClaude"
 
-    # Check 6: superclaude_backup_*.tar.gz in backups/
-    local backup_count=0
+    # Backups SuperClaude antigos
     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))
+            _remove_legacy "$f"                      "backup SuperClaude antigo"
         done
     fi
-    if [ $backup_count -gt 0 ]; then
-        info "$backup_count backup(s) SuperClaude antigo(s) em ~/.claude/backups/"
-        warnings=$((warnings + 1))
+
+    # ─── Categoria 3: Cursor ──────────────────────────────────────────────
+    _remove_legacy "$HOME/.cursor/neocortex"         "configs Cursor legadas"
+    # .cursorrules com referencias neocortex (verificar antes de remover)
+    if [ -f "$HOME/.cursorrules" ]; then
+        if grep -qi "neocortex\|ornexus\|synapse" "$HOME/.cursorrules" 2>/dev/null; then
+            _remove_legacy "$HOME/.cursorrules"      "cursorrules com refs legadas"
+        fi
     fi
 
-    if [ $warnings -gt 0 ]; then
-        warn "$warnings artefato(s) legado(s) detectado(s)"
+    # ─── Categoria 4: VS Code ─────────────────────────────────────────────
+    _remove_legacy "$HOME/.vscode/neocortex"         "configs VS Code legadas"
+    # .instructions.md com referencias neocortex antigo
+    if [ -f "$HOME/.instructions.md" ]; then
+        if grep -qi "neocortex\|ornexus\|synapse" "$HOME/.instructions.md" 2>/dev/null; then
+            _remove_legacy "$HOME/.instructions.md"  "instructions.md com refs legadas"
+        fi
     fi
 
-    # Export for cleanup (newline-separated for paths with spaces)
-    LEGACY_ITEMS="$legacy_items"
-    LEGACY_WARNINGS=$warnings
+    # ─── Categoria 5: Gemini CLI ──────────────────────────────────────────
+    _remove_legacy "$HOME/.gemini/neocortex"         "configs Gemini legadas"
 
-    return 0  # Never block installation
-}
+    # ─── Categoria 6: Codex ───────────────────────────────────────────────
+    _remove_legacy "$HOME/.codex/neocortex"          "configs Codex legadas"
 
-cleanup_legacy_artifacts() {
-    # Only run if --cleanup-legacy was passed
-    if [ "$CLEANUP_LEGACY" != true ]; then
-        return 0
-    fi
+    # ─── Categoria 7: Antigravity ─────────────────────────────────────────
+    # Configs legadas de Antigravity sao gerenciadas pelo adapter, sem path fixo global
 
-    # 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
+    # ─── Resultado ────────────────────────────────────────────────────────
+    if [ $removed -gt 0 ]; then
+        ok "$removed artefato(s) legado(s) removido(s) automaticamente"
+    else
+        debug "Nenhum artefato legado encontrado"
     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
+    # Resetar contadores legados (compatibilidade)
+    LEGACY_ITEMS=""
+    LEGACY_WARNINGS=0
 
-    # 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
+    return 0
+}
 
-    echo -ne "  Confirmar remocao? ${BOLD}[s/N]:${NC} "
+# Cleanup de IP legada em projetos individuais (project-level)
+auto_cleanup_legacy_project() {
+    local project_dir="$1"
+    local neocortex_dir="$project_dir/.claude/agents/neocortex"
+    local skills_dir="$project_dir/.claude/skills/neocortex"
+    local cleaned=false
 
-    local response=""
-    if read -r -t 30 response 2>/dev/null; then
-        : # response received
-    else
-        echo ""
-        info "Timeout - cleanup cancelado"
-        return 0
+    # Remover core/ e seus subdiretorios
+    if [ -d "$neocortex_dir/core" ]; then
+        rm -rf "$neocortex_dir/core"
+        cleaned=true
     fi
 
-    if [[ ! "$response" =~ ^([sS][iI]?[mM]?|[yY][eE]?[sS]?)$ ]]; then
-        info "Cleanup cancelado"
-        return 0
+    # 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
 
-    # 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))
+    # Remover arquivos desnecessarios
+    for file in package.json README.md workflow.md; do
+        if [ -f "$neocortex_dir/$file" ]; then
+            rm -f "$neocortex_dir/$file"
+            cleaned=true
         fi
-    done <<EOF
-$LEGACY_ITEMS
-EOF
+    done
 
-    if [ $failed -eq 0 ]; then
-        ok "$removed artefato(s) removido(s) com sucesso"
-    else
-        warn "$removed removido(s), $failed falha(s)"
+    if [ "$cleaned" = true ]; then
+        info "IP proprietaria removida do projeto (agora servida via server remoto)"
     fi
-
-    return 0
 }
 
 detect_project_migration_needs() {
@@ -491,47 +498,9 @@ detect_source_dir() {
 }
 
 # =============================================================================
-# TIER 3: CLEANUP DE IP LEGADA E CONFIG DO THIN CLIENT
+# TIER 3: 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"
@@ -575,44 +544,8 @@ 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
-}
+# cleanup_legacy_ip_project() substituida por auto_cleanup_legacy_project()
+# (definida na secao de limpeza automatica acima)
 
 # =============================================================================
 # INSTALACAO CORE
@@ -654,7 +587,7 @@ install_core() {
     else
         # Tier 3 Remote Mode: NÃO copiar IP
         # Apenas setup do thin client - steps/skills/standards vem do server
-        cleanup_legacy_ip
+        # Nota: auto_cleanup_legacy() ja rodou no inicio - aqui apenas config
         setup_thin_client_config
     fi
 
@@ -1250,7 +1183,7 @@ create_project_dirs() {
                             fi
                         else
                             # Tier 3 Remote Mode: limpar IP de versoes anteriores no projeto
-                            cleanup_legacy_ip_project "$project_dir"
+                            auto_cleanup_legacy_project "$project_dir"
                         fi
                         target_summary="${target_summary}claude-code, "
                     fi
@@ -1335,14 +1268,12 @@ show_migration_info() {
 # MAIN
 # =============================================================================
 
-TOTAL_STEPS=3
+TOTAL_STEPS=4
 
 main() {
     show_banner
     detect_source_dir
     detect_old_installation
-    detect_legacy_artifacts
-    cleanup_legacy_artifacts
 
     # Determine targets
     if [ -z "$SELECTED_TARGETS" ]; then
@@ -1366,11 +1297,15 @@ main() {
     # 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
+        TOTAL_STEPS=6  # cleanup + core + skills + targets + mcps + tools
     fi
 
-    # Step 1: Core
-    step 1 $TOTAL_STEPS "Instalando core"
+    # Step 1: Limpeza automatica de versoes anteriores
+    step 1 $TOTAL_STEPS "Limpeza de versoes anteriores"
+    auto_cleanup_legacy
+
+    # Step 2: Core
+    step 2 $TOTAL_STEPS "Instalando core"
     install_core
     local core_result=$?
     if [ $core_result -ne 0 ]; then
@@ -1378,23 +1313,23 @@ main() {
         exit 1
     fi
 
-    # Step 2: Skills
-    step 2 $TOTAL_STEPS "Instalando skills"
+    # Step 3: Skills
+    step 3 $TOTAL_STEPS "Instalando skills"
     install_skills
 
-    # Step 3: Targets
-    step 3 $TOTAL_STEPS "Instalando ${BOLD}$target_count${NC} plataforma(s)"
+    # Step 4: Targets
+    step 4 $TOTAL_STEPS "Instalando ${BOLD}$target_count${NC} plataforma(s)"
     install_targets "$SELECTED_TARGETS"
 
-    # Step 4-5: Claude Code extras
+    # Step 5-6: Claude Code extras
     if echo "$SELECTED_TARGETS" | grep -q "claude-code"; then
         load_env_file
         prompt_tokens
 
-        step 4 $TOTAL_STEPS "Configurando MCPs"
+        step 5 $TOTAL_STEPS "Configurando MCPs"
         install_mcps
 
-        step 5 $TOTAL_STEPS "Verificando ferramentas"
+        step 6 $TOTAL_STEPS "Verificando ferramentas"
         install_coderabbit
     fi
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ornexus/neocortex",
-  "version": "3.8.1",
-  "description": "Neocortex v3.8.1 - Orquestrador de Desenvolvimento de Epics & Stories para Claude Code",
+  "version": "3.8.2",
+  "description": "Neocortex v3.8.2 - Orquestrador de Desenvolvimento de Epics & Stories para Claude Code",
   "keywords": [
     "claude",
     "claude-code",