@ornexus/neocortex 4.59.1

package/install.ps1

@@ -0,0 +1,2214 @@
+# Neocortex - Instalador Windows
+# Development Orchestrator
+
+param(
+    [switch]$Yes,
+    [switch]$Debug,
+    [switch]$SkipProject,
+    [switch]$CreateProject,
+    [switch]$Quiet,
+    [switch]$DryRun,
+    [switch]$NoBanner,
+    [switch]$CleanupLegacy,
+    [switch]$Local,
+    [switch]$Help,
+    [string]$Targets = "",
+    # SSoT: packages/client/src/constants.ts DEFAULT_SERVER_URL
+    [string]$ServerUrl = "https://api.neocortex.sh"
+)
+
+$VERSION = "4.59.1"
+
+# =============================================================================
+# CONFIGURACOES
+# =============================================================================
+
+$ErrorActionPreference = "Continue"
+$script:Errors = 0
+$script:MigrationDetected = $false
+$script:MigrationSources = @()
+$script:LegacyItems = @()
+$script:LegacyWarnings = 0
+
+$AUTO_YES = $Yes
+$DEBUG_MODE = $Debug
+$SKIP_PROJECT_DIRS = $SkipProject
+$QUIET_MODE = $Quiet
+$NO_BANNER = $NoBanner
+# LOCAL_MODE removed (Epic 50): thin-client ALWAYS, zero IP on client
+$LOCAL_MODE = $false
+$NEOCORTEX_SERVER_URL = $ServerUrl
+
+function Test-Interactive {
+    try {
+        if (-not [Environment]::UserInteractive) { return $false }
+        if ($null -eq $Host.UI -or $null -eq $Host.UI.RawUI) { return $false }
+        return $true
+    } catch { return $false }
+}
+
+if (-not (Test-Interactive)) {
+    $AUTO_YES = $true
+}
+
+# =============================================================================
+# AJUDA
+# =============================================================================
+
+if ($Help) {
+    Write-Host ""
+    Write-Host "  Neocortex Installer v$VERSION" -ForegroundColor White
+    Write-Host "  Development Orchestrator" -ForegroundColor DarkGray
+    Write-Host ""
+    Write-Host "  Uso: npx @ornexus/neocortex [opcoes]"
+    Write-Host ""
+    Write-Host "  Opcoes:" -ForegroundColor DarkGray
+    Write-Host "    -Yes             Modo automatico (Claude Code only)" -ForegroundColor Cyan
+    Write-Host "    -Targets <lista> Plataformas separadas por virgula" -ForegroundColor Cyan
+    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 "    -DryRun          Mostra adapters/stubs resolvidos sem modificar arquivos" -ForegroundColor Cyan
+    Write-Host "    -CleanupLegacy   (Redundante) Limpeza agora e automatica" -ForegroundColor Cyan
+    Write-Host "    -Local           (Removido) Thin-client obrigatorio, zero IP no client" -ForegroundColor DarkGray
+    Write-Host "    -ServerUrl <url> URL do server Neocortex" -ForegroundColor Cyan
+    Write-Host "    -Debug           Modo debug" -ForegroundColor Cyan
+    Write-Host "    -Help            Mostra esta ajuda" -ForegroundColor Cyan
+    Write-Host ""
+    Write-Host "  Plataformas: claude-code, cursor, vscode, gemini, codex, antigravity, opencode, kimi, openclaw" -ForegroundColor DarkGray
+    exit 0
+}
+
+# =============================================================================
+# FUNCOES DE LOG
+# =============================================================================
+
+function Write-Step {
+    param([int]$Num, [int]$Total, [string]$Message)
+    Write-Host ""
+    Write-Host "  [$Num/$Total] " -ForegroundColor Cyan -NoNewline
+    Write-Host $Message -ForegroundColor White
+}
+
+function Write-Ok {
+    param([string]$Message)
+    if (-not $QUIET_MODE) {
+        Write-Host "  " -NoNewline
+        Write-Host "[ok]" -ForegroundColor Green -NoNewline
+        Write-Host " $Message"
+    }
+}
+
+function Write-Warn {
+    param([string]$Message)
+    Write-Host "  " -NoNewline
+    Write-Host "[!]" -ForegroundColor Yellow -NoNewline
+    Write-Host " $Message"
+}
+
+function Write-Fail {
+    param([string]$Message)
+    Write-Host "  " -NoNewline
+    Write-Host "[x]" -ForegroundColor Red -NoNewline
+    Write-Host " $Message"
+}
+
+function Test-NeocortexSourceProject {
+    param([string]$Path)
+
+    $packageFile = Join-Path $Path "package.json"
+    if (-not (Test-Path $packageFile -PathType Leaf)) { return $false }
+
+    try {
+        $packageJson = Get-Content -Path $packageFile -Raw | ConvertFrom-Json
+    } catch {
+        return $false
+    }
+
+    if ($packageJson.name -ne "@ornexus/neocortex") { return $false }
+    if (-not (Test-Path (Join-Path $Path "core") -PathType Container)) { return $false }
+    if (-not (Test-Path (Join-Path $Path "packages\server") -PathType Container)) { return $false }
+    if (-not (Test-Path (Join-Path $Path "targets-stubs") -PathType Container)) { return $false }
+    if (-not (Test-Path (Join-Path $Path "install.ps1") -PathType Leaf)) { return $false }
+
+    return $true
+}
+
+function Resolve-TargetDir {
+    param([string]$Target)
+
+    $stubName = if ($Target -eq "gemini") { "gemini-cli" } else { $Target }
+    $stubDir = Join-Path $script:SourceDir "targets-stubs\$stubName"
+    $devDir = Join-Path $script:SourceDir "targets\$stubName"
+
+    if (Test-Path $stubDir -PathType Container) { return $stubDir }
+    if ((Test-NeocortexSourceProject $script:SourceDir) -and (Test-Path $devDir -PathType Container)) {
+        Write-Dbg "Fallback dev targets/ para $Target`: $devDir"
+        return $devDir
+    }
+
+    Write-Warn "$Target (adapter nao encontrado; paths tentados: $stubDir, $devDir)"
+    return $null
+}
+
+function Show-TargetResolutionDryRun {
+    param([string[]]$TargetList)
+    Write-Info "Dry-run: nenhum arquivo do usuario sera modificado"
+    foreach ($target in $TargetList) {
+        $resolved = Resolve-TargetDir -Target $target
+        if ($resolved) {
+            Write-Info "Dry-run target=$target adapter=$resolved scope=published-stub"
+            switch ($target) {
+                "cursor" { Write-Info "Dry-run MCP target=cursor file=$HOME\.cursor\mcp.json root=mcpServers managed=playwright,context7,browser_use,figma,shadcn,chrome-devtools action=add-or-update-preserve-custom" }
+                "vscode" { Write-Info "Dry-run MCP target=vscode file=$(Get-VsCodeUserMcpPath) root=servers managed=playwright,context7,browser_use,figma,shadcn,chrome-devtools action=add-or-update-preserve-custom" }
+                "gemini" { Write-Info "Dry-run MCP target=gemini file=$HOME\.gemini\settings.json root=mcpServers managed=playwright,context7,browser_use,figma,shadcn,chrome-devtools action=add-or-update-preserve-custom" }
+                "gemini-cli" { Write-Info "Dry-run MCP target=gemini file=$HOME\.gemini\settings.json root=mcpServers managed=playwright,context7,browser_use,figma,shadcn,chrome-devtools action=add-or-update-preserve-custom" }
+                "codex" { Write-Info "Dry-run MCP target=codex file=$HOME\.codex\config.toml root=mcp_servers managed=playwright,context7,browser_use,figma,shadcn,chrome-devtools action=replace-managed-sections-preserve-unknown" }
+                "opencode" { Write-Info "Dry-run MCP target=opencode file=$(Join-Path (Get-OpenCodeHome) 'opencode.json') root=mcp managed=playwright,context7,browser_use,figma,shadcn,chrome-devtools action=add-or-update-preserve-custom" }
+                "kimi" { Write-Info "Dry-run MCP target=kimi file=$(Join-Path (Get-KimiHome) 'mcp.json') root=mcpServers managed=playwright,context7,browser_use,figma,shadcn,chrome-devtools action=add-or-update-preserve-custom" }
+                "openclaw" {
+                    $openClawHome = if ($env:OPENCLAW_HOME) { $env:OPENCLAW_HOME } else { Join-Path $HOME ".openclaw" }
+                    Write-Info "Dry-run Skill target=openclaw file=$(Join-Path $openClawHome 'skills\neocortex\SKILL.md') action=copy-skill-preserve-openclaw-json config=$(Join-Path $openClawHome 'openclaw.json') non-overwrite"
+                    Write-Info "Dry-run project target=openclaw file=.openclaw\skills\neocortex\SKILL.md action=copy-skill-when-create-project"
+                }
+            }
+        } else {
+            Write-Info "Dry-run target=$target adapter=NOT_FOUND"
+        }
+    }
+}
+
+function Write-Info {
+    param([string]$Message)
+    if (-not $QUIET_MODE) {
+        Write-Host "  -> " -ForegroundColor DarkGray -NoNewline
+        Write-Host $Message -ForegroundColor DarkGray
+    }
+}
+
+function ConvertTo-PublicDiagnosticText {
+    param([string]$Value)
+    $text = if ($null -eq $Value) { "" } else { [string]$Value }
+    if ($HOME) { $text = $text.Replace($HOME, "~") }
+    if ($env:USERPROFILE) { $text = $text.Replace($env:USERPROFILE, "~") }
+    if ($script:SourceDir) { $text = $text.Replace($script:SourceDir, "<install-dir>") }
+    try { $text = $text.Replace((Get-Location).Path, "<project-dir>") } catch { }
+    $text = [regex]::Replace($text, '/home/[^\s"'']+', '<redacted-path>')
+    $text = [regex]::Replace($text, '/Users/[^\s"'']+', '<redacted-path>')
+    $text = [regex]::Replace($text, '/(tmp|media|mnt|workspace|workspaces)/[^\s"'']+', '<redacted-path>')
+    $text = [regex]::Replace($text, 'C:\\Users\\[^\s"'']+', '<redacted-path>', 'IgnoreCase')
+    $text = [regex]::Replace($text, '[A-Z0-9._%+-]+@[A-Z0-9.-]+\.[A-Z]{2,}', '<redacted-email>', 'IgnoreCase')
+    $text = [regex]::Replace($text, '\b(NX|ghp|github_pat|ctx7sk|sk|pk)[_-][A-Za-z0-9_.-]{8,}\b', '<redacted-token>')
+    return $text.Trim()
+}
+
+function ConvertTo-PublicDiagnosticToken {
+    param([string]$Value, [string]$Fallback = "unknown")
+    $text = ConvertTo-PublicDiagnosticText -Value $Value
+    $token = [regex]::Replace($text, '[^A-Za-z0-9_.:/-]', '_')
+    $token = [regex]::Replace($token, '_+', '_').Trim('_')
+    if ($token) { return $token }
+    return $Fallback
+}
+
+function Write-InstallerDiagnostic {
+    param(
+        [string]$Tool = "neocortex",
+        [string]$Phase = "installer",
+        [string]$Status = "info",
+        [string]$ReasonCode = "P177_PUBLIC_SAFE_LOG_REDACTED",
+        [string]$Code = "null",
+        [string]$Signal = "null",
+        [bool]$TimedOut = $false,
+        [int]$RetryAttempt = 0,
+        [int]$TimeoutMs = 0,
+        [string]$Summary = "public_safe_bounded_diagnostic",
+        [string]$DocPath = "docs/install/coderabbit-manual-setup.md"
+    )
+    $toolToken = ConvertTo-PublicDiagnosticToken -Value $Tool -Fallback "neocortex"
+    $phaseToken = ConvertTo-PublicDiagnosticToken -Value $Phase -Fallback "installer"
+    $statusToken = ConvertTo-PublicDiagnosticToken -Value $Status -Fallback "info"
+    $reasonToken = ConvertTo-PublicDiagnosticToken -Value $ReasonCode -Fallback "P177_PUBLIC_SAFE_LOG_REDACTED"
+    $codeToken = ConvertTo-PublicDiagnosticToken -Value $Code -Fallback "null"
+    $signalToken = ConvertTo-PublicDiagnosticToken -Value $Signal -Fallback "null"
+    $summaryToken = ConvertTo-PublicDiagnosticToken -Value $Summary -Fallback "public_safe_bounded_diagnostic"
+    $docToken = ConvertTo-PublicDiagnosticToken -Value $DocPath -Fallback "docs/install/coderabbit-manual-setup.md"
+    $timedOutText = if ($TimedOut) { "true" } else { "false" }
+    Write-Host "  [neocortex-installer] tool=$toolToken phase=$phaseToken status=$statusToken reasonCode=$reasonToken code=$codeToken signal=$signalToken timedOut=$timedOutText retryAttempt=$RetryAttempt timeoutMs=$TimeoutMs docPath=$docToken redactionReasonCode=P177_PUBLIC_SAFE_LOG_REDACTED summary=$summaryToken"
+}
+
+function Write-Dbg {
+    param([string]$Message)
+    if ($DEBUG_MODE) {
+        Write-Host "  [debug] $(ConvertTo-PublicDiagnosticText -Value $Message)" -ForegroundColor DarkGray
+    }
+}
+
+# =============================================================================
+# UTF-8 BOM-FREE WRITE HELPER (Epic 63 - Story 63.1)
+# PowerShell 5.1 writes UTF-8 WITH BOM via Out-File -Encoding utf8 and
+# Set-Content -Encoding utf8. Node.js JSON.parse fails on BOM prefix.
+# This helper uses .NET API to write UTF-8 WITHOUT BOM, compatible with
+# both PowerShell 5.1 and 7+.
+# =============================================================================
+
+function Write-Utf8NoBom {
+    param(
+        [string]$Path,
+        [string]$Content
+    )
+    $utf8NoBom = [System.Text.UTF8Encoding]::new($false)
+    [System.IO.File]::WriteAllText($Path, $Content, $utf8NoBom)
+}
+
+# =============================================================================
+# ACL HELPERS (Story 66.1 - Windows file permission hardening)
+# Fail-open: never throws, never blocks installation
+# =============================================================================
+
+function Set-FileAcl {
+    param([string]$Path)
+    try {
+        $username = $env:USERNAME
+        if (-not $username) { return }
+        & icacls $Path /inheritance:r /grant:r "${username}:(F)" 2>$null | Out-Null
+    } catch { }
+}
+
+function Set-DirAcl {
+    param([string]$Path)
+    try {
+        $username = $env:USERNAME
+        if (-not $username) { return }
+        & icacls $Path /inheritance:r /grant:r "${username}:(OI)(CI)(F)" 2>$null | Out-Null
+    } catch { }
+}
+
+# =============================================================================
+# MCP JSON CONFIG MERGE HELPER (additive, preserves user-defined servers)
+# Fail-open: on error, leaves existing file untouched.
+# $RootKey: top-level key containing the servers map.
+#   - "mcpServers" for Cursor and Gemini CLI settings
+#   - "servers" for VS Code
+#   - ""         for Antigravity (flat JSON: keys are server names)
+# =============================================================================
+
+function Remove-DisabledOptionalMcpServers {
+    param(
+        [object]$Config,
+        [string]$RootKey = "mcpServers"
+    )
+
+    $optionalServers = @{
+        "storybook" = $env:NEOCORTEX_ENABLE_STORYBOOK_MCP
+    }
+
+    $container = $Config
+    if ($RootKey -ne "") {
+        $container = $Config.$RootKey
+    }
+    if (-not $container) { return $Config }
+
+    foreach ($name in $optionalServers.Keys) {
+        if ($optionalServers[$name] -ne "1" -and ($container.PSObject.Properties.Name -contains $name)) {
+            $container.PSObject.Properties.Remove($name)
+        }
+    }
+
+    return $Config
+}
+
+function Select-EnabledMcpToml {
+    param([string]$Content)
+
+    $enabled = @{
+        "storybook" = $env:NEOCORTEX_ENABLE_STORYBOOK_MCP
+    }
+    $out = New-Object System.Collections.Generic.List[string]
+    $include = $true
+
+    foreach ($line in ($Content -split "`r?`n")) {
+        if ($line -match '^\[mcp_servers\.([^\]]+)\]$') {
+            $name = $Matches[1]
+            $include = -not $enabled.ContainsKey($name) -or $enabled[$name] -eq "1"
+        }
+        if ($include) { $out.Add($line) }
+    }
+
+    return (($out -join "`n").TrimEnd() + "`n")
+}
+
+function Merge-JsonMcpConfig {
+    param(
+        [string]$StubFile,
+        [string]$DestFile,
+        [string]$RootKey = "mcpServers",
+        [string[]]$ManagedTopLevelNames = @()
+    )
+
+    if (-not (Test-Path $StubFile)) { return }
+
+    if (-not (Test-Path $DestFile)) {
+        $destDir = Split-Path -Parent $DestFile
+        if ($destDir -and -not (Test-Path $destDir)) {
+            New-Item -ItemType Directory -Path $destDir -Force -ErrorAction SilentlyContinue | Out-Null
+            Set-DirAcl -Path $destDir
+        }
+        try {
+            $stub = Get-Content $StubFile -Raw -ErrorAction Stop | ConvertFrom-Json
+            $stub = Remove-DisabledOptionalMcpServers -Config $stub -RootKey $RootKey
+            Write-Utf8NoBom -Path $DestFile -Content ($stub | ConvertTo-Json -Depth 20)
+        } catch { }
+        return
+    }
+
+    try {
+        $existing = Get-Content $DestFile -Raw -ErrorAction Stop | ConvertFrom-Json
+        $stub = Get-Content $StubFile -Raw -ErrorAction Stop | ConvertFrom-Json
+        $stub = Remove-DisabledOptionalMcpServers -Config $stub -RootKey $RootKey
+
+        if ($RootKey -eq "") {
+            # Flat JSON: iterate over stub top-level properties
+            foreach ($prop in $stub.PSObject.Properties) {
+                if ($existing.PSObject.Properties.Name -contains $prop.Name) {
+                    $existing.$($prop.Name) = $prop.Value
+                } else {
+                    $existing | Add-Member -NotePropertyName $prop.Name -NotePropertyValue $prop.Value -Force
+                }
+            }
+        } else {
+            if (-not $stub.$RootKey) { return }
+            if (-not $existing.$RootKey) {
+                $existing | Add-Member -NotePropertyName $RootKey -NotePropertyValue ([pscustomobject]@{}) -Force
+            }
+
+            $antigravityMigrated = $false
+            foreach ($managedName in $ManagedTopLevelNames) {
+                if ($existing.PSObject.Properties.Name -contains $managedName) {
+                    $value = $existing.$managedName
+                    if ($value -and ($value.PSObject.Properties.Name -contains "httpUrl") -and -not ($value.PSObject.Properties.Name -contains "serverUrl")) {
+                        $value | Add-Member -NotePropertyName "serverUrl" -NotePropertyValue $value.httpUrl -Force
+                        $value.PSObject.Properties.Remove("httpUrl")
+                    }
+                    $existing.$RootKey | Add-Member -NotePropertyName $managedName -NotePropertyValue $value -Force
+                    $existing.PSObject.Properties.Remove($managedName)
+                    $antigravityMigrated = $true
+                }
+            }
+
+            foreach ($prop in $stub.$RootKey.PSObject.Properties) {
+                if ($existing.$RootKey.PSObject.Properties.Name -contains $prop.Name) {
+                    $existing.$RootKey.$($prop.Name) = $prop.Value
+                } else {
+                    $existing.$RootKey | Add-Member -NotePropertyName $prop.Name -NotePropertyValue $prop.Value -Force
+                }
+            }
+
+            if ($ManagedTopLevelNames.Count -gt 0) {
+                if ($antigravityMigrated) {
+                    $stamp = (Get-Date).ToString("yyyyMMddTHHmmss")
+                    $backup = "$DestFile.neocortex-backup-structural-$stamp"
+                    Copy-Item -Path $DestFile -Destination $backup -Force -ErrorAction SilentlyContinue
+                    Write-Info "Antigravity MCP backupCreated=$backup"
+                }
+                Write-Info "Antigravity MCP merge: managed entries migrated/updated under mcpServers; custom top-level entries preserved."
+            }
+        }
+
+        Write-Utf8NoBom -Path $DestFile -Content ($existing | ConvertTo-Json -Depth 20)
+    } catch {
+        try {
+            $stamp = (Get-Date).ToString("yyyyMMddTHHmmss")
+            $backup = "$DestFile.neocortex-backup-$stamp"
+            Copy-Item -Path $DestFile -Destination $backup -Force -ErrorAction Stop
+            Write-Warn "MCP config invalido: $DestFile; backup criado em $backup; corrija a sintaxe e execute novamente. Original preservado."
+        } catch { }
+    }
+}
+
+function Get-VsCodeUserMcpPath {
+    if ($env:VSCODE_MCP_FILE) { return $env:VSCODE_MCP_FILE }
+    if ($env:APPDATA) { return (Join-Path $env:APPDATA "Code\User\mcp.json") }
+    return (Join-Path $HOME ".vscode\mcp.json")
+}
+
+function Get-OpenCodeHome {
+    if ($env:OPENCODE_HOME) { return $env:OPENCODE_HOME }
+    if ($env:XDG_CONFIG_HOME) { return (Join-Path $env:XDG_CONFIG_HOME "opencode") }
+    return (Join-Path $HOME ".config\opencode")
+}
+
+function Get-KimiHome {
+    if ($env:KIMI_HOME) { return $env:KIMI_HOME }
+    return (Join-Path $HOME ".kimi")
+}
+
+function Merge-CodexMcpToml {
+    param([string]$StubFile, [string]$DestFile)
+
+    if (-not (Test-Path $StubFile)) { return }
+    $managed = @("playwright", "context7", "browser_use", "figma", "shadcn", "chrome-devtools")
+    $destDir = Split-Path -Parent $DestFile
+    if ($destDir -and -not (Test-Path $destDir)) { New-Item -ItemType Directory -Path $destDir -Force -ErrorAction SilentlyContinue | Out-Null }
+    $stub = Get-Content $StubFile -Raw
+
+    $sections = New-Object System.Collections.Generic.List[string]
+    foreach ($name in $managed) {
+        $pattern = "(?ms)^\[mcp_servers\." + [regex]::Escape($name) + "\].*?(?=^\[|\z)"
+        $match = [regex]::Match($stub, $pattern)
+        if ($match.Success) { $sections.Add($match.Value.Trim()) }
+    }
+    $block = ($sections -join "`n`n")
+
+    if (-not (Test-Path $DestFile)) {
+        Write-Utf8NoBom -Path $DestFile -Content ("# Neocortex MCP Servers`n$block`n")
+        return
+    }
+
+    try {
+        $existing = Get-Content $DestFile -Raw -ErrorAction Stop
+        foreach ($line in ($existing -split "`r?`n")) {
+            $trimmed = $line.Trim()
+            if ($trimmed.StartsWith("[") -and ($trimmed -notmatch '^\[[^\]]+\]$')) { throw "invalid table header: $trimmed" }
+            $quoteCount = ([regex]::Matches($trimmed, '(?<!\\)"')).Count
+            if (($quoteCount % 2) -ne 0) { throw "unbalanced quote: $trimmed" }
+        }
+
+        foreach ($name in $managed) {
+            $pattern = "(?ms)^\[mcp_servers\." + [regex]::Escape($name) + "\].*?(?=^\[|\z)"
+            $existing = [regex]::Replace($existing, $pattern, "")
+        }
+        $existing = ($existing -replace '(?ms)\n*# Neocortex MCP Servers\s*\z', '').TrimEnd()
+        $next = "$existing`n`n# Neocortex MCP Servers`n$block`n"
+        if ($next -ne (Get-Content $DestFile -Raw)) { Write-Utf8NoBom -Path $DestFile -Content $next }
+    } catch {
+        try {
+            $stamp = (Get-Date).ToString("yyyyMMddTHHmmss")
+            $backup = "$DestFile.neocortex-backup-$stamp"
+            Copy-Item -Path $DestFile -Destination $backup -Force -ErrorAction Stop
+            Write-Warn "Codex config.toml invalido: $DestFile; backup criado em $backup; corrija a sintaxe e execute novamente. Original preservado."
+        } catch { }
+    }
+}
+
+function Read-HostWithTimeout {
+    param([int]$TimeoutSeconds = 10, [string]$Default = "n")
+    try {
+        if (-not (Test-Interactive)) { return $Default }
+        $endTime = [DateTime]::Now.AddSeconds($TimeoutSeconds)
+        while (-not $Host.UI.RawUI.KeyAvailable) {
+            if ([DateTime]::Now -ge $endTime) {
+                Write-Host ""
+                return $Default
+            }
+            Start-Sleep -Milliseconds 100
+        }
+        return Read-Host
+    } catch { return $Default }
+}
+
+# =============================================================================
+# BANNER
+# =============================================================================
+
+function Show-Banner {
+    if ($QUIET_MODE) { return }
+    if ($NO_BANNER) { return }
+
+    Write-Host ""
+    Write-Host "       #######" -ForegroundColor Cyan
+    Write-Host "      ###  ########" -ForegroundColor Cyan
+    Write-Host " #########      #####" -ForegroundColor Cyan
+    Write-Host -NoNewline " ##    ##############    " -ForegroundColor Cyan
+    Write-Host "N E O C O R T E X" -ForegroundColor White
+    Write-Host -NoNewline " ##   ###  ######  ##    " -ForegroundColor Cyan
+    Write-Host "v$VERSION" -ForegroundColor White
+    Write-Host " ##   ###    ###   ##" -ForegroundColor Cyan
+    Write-Host -NoNewline " ##  ######  ###   ##    " -ForegroundColor Cyan
+    Write-Host "OrNexus Team" -ForegroundColor DarkGray
+    Write-Host " ###############   ##" -ForegroundColor Cyan
+    Write-Host " #####       ########" -ForegroundColor Cyan
+    Write-Host "   ########  ##" -ForegroundColor Cyan
+    Write-Host "        #######" -ForegroundColor Cyan
+    Write-Host ""
+}
+
+# =============================================================================
+# FUNCOES DE COPIA (silenciosas)
+# =============================================================================
+
+function Copy-Silent {
+    param([string]$Source, [string]$Destination)
+    Write-Dbg "Copiando: $Source -> $Destination"
+    if (Test-Path $Source -PathType Leaf) {
+        try {
+            # Epic 65: -ErrorAction Stop converts non-terminating errors to terminating
+            # Without this, Copy-Item on Windows silently fails and try/catch never triggers
+            Copy-Item -Path $Source -Destination $Destination -Force -ErrorAction Stop
+            # Post-copy verification: confirm file arrived at destination
+            $destFile = if ($Destination.EndsWith('\') -or $Destination.EndsWith('/') -or (Test-Path $Destination -PathType Container)) {
+                Join-Path $Destination (Split-Path $Source -Leaf)
+            } else { $Destination }
+            if (-not (Test-Path $destFile -PathType Leaf)) {
+                Write-Dbg "Copy-Item retornou OK mas arquivo nao existe no destino: $destFile"
+                $script:Errors++
+                return $false
+            }
+            return $true
+        }
+        catch {
+            Write-Dbg "Copy-Item falhou: $_"
+            $script:Errors++
+            return $false
+        }
+    }
+    Write-Dbg "Arquivo nao encontrado: $Source"
+    $script:Errors++
+    return $false
+}
+
+function Copy-DirSilent {
+    param([string]$Source, [string]$Destination)
+    Write-Dbg "Copiando dir: $Source -> $Destination"
+    if (Test-Path $Source -PathType Container) {
+        try {
+            Copy-Item -Path $Source -Destination $Destination -Recurse -Force -ErrorAction Stop
+            return $true
+        }
+        catch {
+            Write-Dbg "Copy-Item dir falhou: $_"
+            return $false
+        }
+    }
+    return $false
+}
+
+# =============================================================================
+# DETECCAO DO DIRETORIO FONTE
+# =============================================================================
+
+function Get-SourceDirectory {
+    if ($PSScriptRoot) {
+        $script:SourceDir = $PSScriptRoot
+    } else {
+        $script:SourceDir = Get-Location
+    }
+    Write-Dbg "Source: $script:SourceDir"
+
+    if (-not (Test-Path "$script:SourceDir\targets-stubs\claude-code\neocortex.md") -and
+        -not (Test-Path "$script:SourceDir\neocortex.md")) {
+        Write-Dbg "Stubs nao encontrados em PSScriptRoot, buscando em paths alternativos..."
+        $possibleDirs = @(
+            $script:SourceDir,
+            # Scoped paths (primary) -- npm publishes as @ornexus/neocortex
+            "$env:APPDATA\npm\node_modules\@ornexus\neocortex",
+            "$env:LOCALAPPDATA\npm-cache\_npx\*\node_modules\@ornexus\neocortex",
+            ".\node_modules\@ornexus\neocortex",
+            # Unscoped paths (fallback for backward compat)
+            "$env:APPDATA\npm\node_modules\neocortex",
+            "$env:LOCALAPPDATA\npm-cache\_npx\*\node_modules\neocortex",
+            ".\node_modules\neocortex"
+        )
+        $script:SourceFound = $false
+        foreach ($dir in $possibleDirs) {
+            # Epic 64 (Story 64.6): Debug each possibleDir tested
+            Write-Dbg "Get-SourceDirectory: testing $dir"
+            $expandedDirs = Get-Item $dir -ErrorAction SilentlyContinue
+            foreach ($expanded in $expandedDirs) {
+                $found = (Test-Path "$($expanded.FullName)\targets-stubs\claude-code\neocortex.md") -or
+                    (Test-Path "$($expanded.FullName)\neocortex.md")
+                Write-Dbg "Get-SourceDirectory: $($expanded.FullName) found=$found"
+                if ($found) {
+                    $script:SourceDir = $expanded.FullName
+                    $script:SourceFound = $true
+                    break
+                }
+            }
+            if ($script:SourceFound) { break }
+        }
+        # Epic 65: Emit visible warning when stubs cannot be found anywhere
+        if (-not $script:SourceFound) {
+            Write-Warn "Arquivos de instalacao (stubs) nao encontrados em nenhum path conhecido"
+            Write-Warn "PSScriptRoot: $PSScriptRoot"
+            Write-Warn "Tente reinstalar: npm install -g @ornexus/neocortex"
+        }
+    }
+}
+
+# =============================================================================
+# DETECCAO DE VERSAO ANTIGA
+# =============================================================================
+
+function Test-OldInstallation {
+    Write-Dbg "Verificando instalacoes antigas..."
+    $destDir = "$env:USERPROFILE\.claude\agents\neocortex"
+
+    $versionFile = "$destDir\.version"
+    if (Test-Path $versionFile) {
+        $installedVersion = (Get-Content $versionFile -Raw).Trim()
+        $pkgJsonPath = Join-Path $script:SourceDir "package.json"
+        if (Test-Path $pkgJsonPath) {
+            $pkgJson = Get-Content $pkgJsonPath -Raw | ConvertFrom-Json -ErrorAction SilentlyContinue
+            if ($pkgJson.version) {
+                if ($installedVersion -eq $pkgJson.version) {
+                    Write-Info "Reinstalando v$($pkgJson.version)"
+                } else {
+                    Write-Info "Atualizando v$installedVersion -> v$($pkgJson.version)"
+                }
+            }
+        }
+    }
+}
+
+function Test-ProjectMigrationNeeds {
+    $sources = @()
+    if (Test-Path ".neocortex\orchestrator.db") { $sources += "orchestrator.db" }
+    @("bmad-output\sprint-status.yaml", ".neocortex\sprint-status.yaml", "docs\sprint-status.yaml") | ForEach-Object {
+        if (Test-Path $_) { $sources += $_ }
+    }
+    if ($sources.Count -gt 0) { return $sources }
+    return $null
+}
+
+# =============================================================================
+# 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 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"
+            }
+        }
+    }
+
+    $script:autoRemoved = 0
+
+    # --- 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"
+                }
+            }
+        }
+
+        # 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"
+            }
+        }
+    }
+
+    # --- 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"
+
+    # Step folders legados
+    foreach ($folder in @("steps-c", "steps-e", "steps-p", "steps-r", "steps-u")) {
+        Remove-LegacyItem "$neocortexDir\$folder"      "steps legados"
+    }
+
+    # 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"
+        }
+    }
+
+    # --- 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"
+        }
+    }
+
+    # --- 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"
+        }
+    }
+
+    # --- 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
+
+    # --- Categoria 8: Plaintext cache cleanup (Epic 62 - GAP 1) ---
+    $cacheDir = "$env:USERPROFILE\.neocortex\cache"
+    if (Test-Path $cacheDir -PathType Container) {
+        # Remove plaintext menu-cache.json
+        Remove-LegacyItem "$cacheDir\menu-cache.json" "cache plaintext (menu)"
+
+        # Remove any non-.enc files in cache dir (excluding directories)
+        Get-ChildItem -Path $cacheDir -File -ErrorAction SilentlyContinue | Where-Object {
+            $_.Extension -ne ".enc"
+        } | ForEach-Object {
+            Remove-LegacyItem $_.FullName "cache plaintext"
+        }
+    }
+
+    # --- 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"
+    }
+
+    # Resetar contadores legados (compatibilidade)
+    $script:LegacyItems = @()
+    $script:LegacyWarnings = 0
+}
+
+# Cleanup de IP legada em projetos individuais (project-level)
+function Invoke-AutoCleanupLegacyProject {
+    param([string]$ProjectDir)
+
+    $neocortexDir = "$ProjectDir\.claude\agents\neocortex"
+    $skillsDir = "$ProjectDir\.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", "workflow.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)"
+    }
+}
+
+# =============================================================================
+# VERIFICACAO POS-INSTALACAO
+# =============================================================================
+
+function Verify-Installation {
+    $fails = 0
+    $warns = 0
+    $report = @()
+
+    if ($script:SelectedTargets -notcontains "claude-code") {
+        return $true
+    }
+
+    # --- Layer 1: File existence + minimum size ---
+    $criticalFiles = @(
+        @{ Name = "neocortex.md";          MinBytes = 512; Label = "Agent principal (stub)" },
+        @{ Name = "neocortex.agent.yaml";  MinBytes = 128; Label = "Agent config YAML (stub)" }
+    )
+
+    foreach ($entry in $criticalFiles) {
+        $fpath = Join-Path $script:DestDir $entry.Name
+        $fname = $entry.Name
+        # Epic 64 (Story 64.6): Debug file verification details
+        $fileExists = Test-Path $fpath -PathType Leaf
+        $fileSize = if ($fileExists) { (Get-Item $fpath).Length } else { 0 }
+        Write-Dbg "Verify-Installation: $fname exists=$fileExists size=$fileSize path=$fpath"
+
+        if (-not (Test-Path $fpath -PathType Leaf)) {
+            $report += @{ Status = "FAIL"; Detail = "$fname (nao encontrado)" }
+            $fails++
+        } else {
+            $fileInfo = Get-Item $fpath
+            $size = $fileInfo.Length
+
+            if ($size -lt $entry.MinBytes) {
+                $report += @{ Status = "FAIL"; Detail = "$fname ($size bytes - possivelmente corrompido, minimo $($entry.MinBytes))" }
+                $fails++
+            } else {
+                # --- Layer 2: Content marker (frontmatter) ---
+                $ext = [System.IO.Path]::GetExtension($fname)
+                if ($ext -eq ".md") {
+                    $firstLine = (Get-Content $fpath -TotalCount 1 -ErrorAction SilentlyContinue)
+                    if ($firstLine -ne "---") {
+                        $report += @{ Status = "WARN"; Detail = "$fname (formato invalido - sem frontmatter)" }
+                        $warns++
+                    } else {
+                        $displaySize = if ($size -ge 1024) { "$([math]::Floor($size / 1024))KB" } else { "${size}B" }
+                        $report += @{ Status = "OK"; Detail = "$fname ($displaySize)" }
+                    }
+                } else {
+                    $displaySize = if ($size -ge 1024) { "$([math]::Floor($size / 1024))KB" } else { "${size}B" }
+                    $report += @{ Status = "OK"; Detail = "$fname ($displaySize)" }
+                }
+            }
+        }
+    }
+
+    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 {
+                $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 (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 {
+        # --- 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 configured)" }
+        } 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)" }
+        }
+    }
+
+    # --- Layer 4: Tool availability (Story 66.4 AC1/AC2) ---
+    $claudeCmd = Get-Command claude -ErrorAction SilentlyContinue
+    if (-not $claudeCmd) {
+        $claudeCmd = Get-Command claude.exe -ErrorAction SilentlyContinue
+    }
+    if (-not $claudeCmd) {
+        $report += @{ Status = "WARN"; Detail = "Claude Code CLI nao encontrado no PATH" }
+        $warns++
+        Write-Info "Instale Claude Code: https://claude.ai/download"
+    } else {
+        $report += @{ Status = "OK"; Detail = "Claude Code CLI encontrado" }
+    }
+
+    $ncCmd = Get-Command neocortex-client -ErrorAction SilentlyContinue
+    if (-not $ncCmd) {
+        $ncCmd = Get-Command "neocortex-client.cmd" -ErrorAction SilentlyContinue
+    }
+    if (-not $ncCmd) {
+        $report += @{ Status = "WARN"; Detail = "neocortex-client nao encontrado no PATH" }
+        $warns++
+        Write-Info "Pode ser necessario reabrir o terminal apos npm install -g"
+    } else {
+        $report += @{ Status = "OK"; Detail = "neocortex-client encontrado" }
+    }
+
+    # --- Display report ---
+    if ($fails -eq 0 -and $warns -eq 0) {
+        if (-not $QUIET_MODE) {
+            Write-Ok "Instalacao verificada"
+        }
+        return $true
+    }
+
+    # Epic 64 (Story 64.3): In quiet mode, report FAILs before returning
+    if ($QUIET_MODE) {
+        if ($fails -gt 0) {
+            # Critical failures MUST be visible even in quiet mode
+            Write-Fail "Verificacao falhou: $fails arquivo(s) critico(s) faltando"
+            foreach ($entry in ($report | Where-Object { $_.Status -eq "FAIL" })) {
+                Write-Fail "  $($entry.Detail)"
+            }
+            return $false
+        }
+        return $true  # In quiet mode, skip warnings-only report
+    }
+
+    Write-Host ""
+    Write-Info "Verificacao pos-instalacao:"
+    foreach ($entry in $report) {
+        switch ($entry.Status) {
+            "OK"   { Write-Host "    " -NoNewline; Write-Host "[ok]" -ForegroundColor Green -NoNewline; Write-Host " $($entry.Detail)" }
+            "WARN" { Write-Host "    " -NoNewline; Write-Host "[!]" -ForegroundColor Yellow -NoNewline; Write-Host " $($entry.Detail)" }
+            "FAIL" { Write-Host "    " -NoNewline; Write-Host "[x]" -ForegroundColor Red -NoNewline; Write-Host " $($entry.Detail)" }
+        }
+    }
+
+    if ($fails -gt 0) { return $false }
+    return $true
+}
+
+# =============================================================================
+# TIER 3: CONFIG DO THIN CLIENT
+# =============================================================================
+
+function Set-ThinClientConfig {
+    $configDir = "$env:USERPROFILE\.neocortex"
+    $configFile = "$configDir\config.json"
+
+    New-Item -ItemType Directory -Path $configDir -Force -ErrorAction SilentlyContinue | Out-Null
+    New-Item -ItemType Directory -Path "$configDir\cache" -Force -ErrorAction SilentlyContinue | Out-Null
+
+    # Story 66.1 AC5: Apply ACLs on ~/.neocortex/ and cache/
+    Set-DirAcl $configDir
+    Set-DirAcl "$configDir\cache"
+
+    if (Test-Path $configFile) {
+        try {
+            $existingConfig = Get-Content $configFile -Raw | ConvertFrom-Json -ErrorAction SilentlyContinue
+            if ($existingConfig.mode -eq "active" -or $existingConfig.mode -eq "local" -or $existingConfig.mode -eq "remote") {
+                # --- Config schema migration (Epic 62 - GAP 4) ---
+                if (-not $existingConfig.configVersion) {
+                    Write-Dbg "Migrando schema do config.json (adicionando configVersion)"
+                    try {
+                        # Add configVersion
+                        $existingConfig | Add-Member -NotePropertyName "configVersion" -NotePropertyValue 1 -Force
+                        # Remove known obsolete fields
+                        $existingConfig.PSObject.Properties.Remove("version")
+                        $existingConfig.PSObject.Properties.Remove("cache")
+                        # Clean obsolete tier:3 from old base template
+                        if ($existingConfig.tier -eq 3 -and $existingConfig.mode -eq "pending-activation") {
+                            $existingConfig.PSObject.Properties.Remove("tier")
+                        }
+                        Write-Utf8NoBom -Path $configFile -Content ($existingConfig | ConvertTo-Json -Depth 5)
+                        Write-Dbg "Config migrada para configVersion 1"
+                    } catch {
+                        Write-Dbg "Falha na migracao do config: $_"
+                    }
+                }
+                # --- Fix stale localhost serverUrl (Epic 70 - Story 70.02) ----
+                # If config has localhost serverUrl and installer has production URL,
+                # update serverUrl while preserving all other config fields.
+                $existingServerUrl = $existingConfig.serverUrl
+                if ($existingServerUrl -match '^https?://(localhost|127\.0\.0\.1|0\.0\.0\.0)(:\d+)?') {
+                    if ($NEOCORTEX_SERVER_URL -ne $existingServerUrl) {
+                        Write-Dbg "Fixing stale localhost serverUrl: $existingServerUrl -> $NEOCORTEX_SERVER_URL"
+                        try {
+                            $existingConfig.serverUrl = $NEOCORTEX_SERVER_URL
+                            Write-Utf8NoBom -Path $configFile -Content ($existingConfig | ConvertTo-Json -Depth 5)
+                            Set-FileAcl $configFile
+                            Write-Dbg "serverUrl updated to $NEOCORTEX_SERVER_URL"
+                        } catch {
+                            Write-Dbg "Failed to update serverUrl: $_"
+                        }
+                    }
+                }
+
+                # --- Fix stale legacy serverUrl (Epic P46 - Story P46.04) ----
+                $legacyServerHost = @('api', 'neocortex', 'ornexus', 'com') -join '.'
+                if ($existingServerUrl -like "*$legacyServerHost*") {
+                    Write-Dbg "Fixing legacy serverUrl: $existingServerUrl -> $NEOCORTEX_SERVER_URL"
+                    try {
+                        $existingConfig.serverUrl = $NEOCORTEX_SERVER_URL
+                        Write-Utf8NoBom -Path $configFile -Content ($existingConfig | ConvertTo-Json -Depth 5)
+                        Set-FileAcl $configFile
+                        Write-Dbg "serverUrl updated from legacy host to $NEOCORTEX_SERVER_URL"
+                    } catch {
+                        Write-Dbg "Failed to update serverUrl: $_"
+                    }
+                }
+
+                Write-Dbg "Config existente preservada (mode=$($existingConfig.mode))"
+                return
+            }
+        } catch { }
+    }
+
+    $config = @{
+        configVersion = 1
+        mode = "pending-activation"
+        serverUrl = $NEOCORTEX_SERVER_URL
+        resilience = @{
+            circuitBreaker = $true
+            maxRetries = 3
+            timeoutMs = 5000
+        }
+        installedAt = (Get-Date -Format "o")
+        installerVersion = $VERSION
+    }
+
+    Write-Utf8NoBom -Path $configFile -Content ($config | ConvertTo-Json -Depth 5)
+    # Story 66.1 AC4: Apply ACL on config.json
+    Set-FileAcl $configFile
+    Write-Dbg "Thin client config criada: $configFile"
+}
+
+# Remove-LegacyIPProject substituida por Invoke-AutoCleanupLegacyProject
+# (definida na secao de limpeza automatica acima)
+
+# =============================================================================
+# INSTALACAO CORE
+# =============================================================================
+
+function Install-Core {
+    $script:ClaudeDir = "$env:USERPROFILE\.claude"
+    $script:AgentsDir = "$script:ClaudeDir\agents"
+    $script:DestDir = "$script:AgentsDir\neocortex"
+
+    Write-Dbg "DEST=$script:DestDir"
+
+    # Create directories with verification (Epic 65)
+    if (-not (Test-Path $script:ClaudeDir)) {
+        try { New-Item -ItemType Directory -Path $script:ClaudeDir -Force -ErrorAction Stop | Out-Null }
+        catch { Write-Fail "Falha ao criar $script:ClaudeDir`: $_"; return $false }
+    }
+    try { New-Item -ItemType Directory -Path $script:AgentsDir -Force -ErrorAction Stop | Out-Null }
+    catch { Write-Fail "Falha ao criar $script:AgentsDir`: $_"; return $false }
+
+    # Clean previous
+    if (Test-Path $script:DestDir) {
+        try {
+            Remove-Item -Path $script:DestDir -Recurse -Force -ErrorAction Stop
+        } catch {
+            Write-Warn "Falha ao remover instalacao anterior: $_ (tentando continuar)"
+        }
+    }
+    try { New-Item -ItemType Directory -Path $script:DestDir -Force -ErrorAction Stop | Out-Null }
+    catch { Write-Fail "Falha ao criar $script:DestDir`: $_"; return $false }
+
+    # Verify directory was actually created (Epic 65: anti-silent-failure)
+    if (-not (Test-Path $script:DestDir -PathType Container)) {
+        Write-Fail "Diretorio $script:DestDir nao existe apos criacao"
+        return $false
+    }
+
+    if ($LOCAL_MODE) {
+        # Modo local: copiar IP completa (comportamento legado para devs)
+        $coreSource = Join-Path $script:SourceDir "core"
+        if (Test-Path $coreSource -PathType Container) {
+            Copy-Item -Path $coreSource -Destination "$script:DestDir\" -Recurse -Force -ErrorAction SilentlyContinue
+        }
+        $r = Copy-Silent "$($script:SourceDir)\package.json" "$script:DestDir\"
+        if (-not $r) { Write-Fail "Falha ao copiar package.json (Install-Core)" }
+        $r = Copy-Silent "$($script:SourceDir)\README.md" "$script:DestDir\"
+        if (-not $r) { Write-Fail "Falha ao copiar README.md (Install-Core)" }
+    } else {
+        # Tier 3 Remote Mode: NAO copiar IP
+        # Nota: Invoke-AutoCleanupLegacy ja rodou no inicio - aqui apenas config
+        Set-ThinClientConfig
+    }
+
+    # --- Version-aware cache purge on upgrade (Epic 62 - GAP 2+3) ---
+    $pkgJsonPath = Join-Path $script:SourceDir "package.json"
+    $pkgVersion = $null
+    if (Test-Path $pkgJsonPath) {
+        $pkgJson = Get-Content $pkgJsonPath -Raw | ConvertFrom-Json -ErrorAction SilentlyContinue
+        $pkgVersion = $pkgJson.version
+    }
+
+    if ($pkgVersion) {
+        $oldVersion = $null
+        # Read existing .version from either location
+        $versionPaths = @("$script:DestDir\.version", "$env:USERPROFILE\.neocortex\.version")
+        foreach ($vp in $versionPaths) {
+            if (Test-Path $vp -PathType Leaf) {
+                $oldVersion = (Get-Content $vp -Raw -ErrorAction SilentlyContinue).Trim()
+                if ($oldVersion) { break }
+            }
+        }
+
+        # If version changed, purge all cache files
+        if ($oldVersion -and $oldVersion -ne $pkgVersion) {
+            $cachePurgeDir = "$env:USERPROFILE\.neocortex\cache"
+            if (Test-Path $cachePurgeDir -PathType Container) {
+                $purged = 0
+                Get-ChildItem -Path $cachePurgeDir -File -ErrorAction SilentlyContinue | ForEach-Object {
+                    Remove-Item $_.FullName -Force -ErrorAction SilentlyContinue
+                    $purged++
+                }
+                if ($purged -gt 0) {
+                    Write-Info "Cache purgado: versao alterada de $oldVersion para $pkgVersion ($purged arquivo(s))"
+                }
+            }
+        }
+
+        # Write version file
+        Write-Utf8NoBom -Path "$script:DestDir\.version" -Content $pkgVersion
+    }
+
+    if ($LOCAL_MODE) {
+        Write-Ok "Core instalado (standards, templates, scripts) [modo local]"
+    } else {
+        Write-Ok "Remote mode configured (thin client ready)"
+    }
+    return $true
+}
+
+# =============================================================================
+# INSTALACAO DE SKILLS
+# =============================================================================
+
+function Install-Skills {
+    $script:SkillsDir = "$script:ClaudeDir\skills"
+    $script:SkillsDest = "$script:SkillsDir\neocortex"
+    $skillsSource = "$script:SourceDir\core\skills"
+
+    # Tier 3 Remote Mode: skills vem do server, nao copiar
+    if (-not $LOCAL_MODE) {
+        Write-Ok "Skills: delivered by remote server"
+        return $true
+    }
+
+    if (-not (Test-Path $skillsSource -PathType Container)) { return $true }
+
+    New-Item -ItemType Directory -Path $script:SkillsDir -Force | Out-Null
+
+    if (Test-Path $script:SkillsDest) {
+        Remove-Item -Path $script:SkillsDest -Recurse -Force -ErrorAction SilentlyContinue
+    }
+
+    try {
+        Copy-Item -Path $skillsSource -Destination $script:SkillsDest -Recurse -Force
+
+        # Count skills
+        $skillCount = 0
+        Get-ChildItem "$script:SkillsDest\step-skills\*\*.md", "$script:SkillsDest\domain-skills\*\*.md" -File -ErrorAction SilentlyContinue |
+            Where-Object { $_.Name -ne "_template.md" } | ForEach-Object { $skillCount++ }
+
+        Write-Ok "Skills instaladas ($skillCount skills) [modo local]"
+        return $true
+    } catch {
+        Write-Fail "Falha ao copiar skills"
+        return $false
+    }
+}
+
+# =============================================================================
+# INSTALACAO DE AGENT (Claude Code)
+# =============================================================================
+
+function Install-Agent {
+    $claudeTargetDir = Join-Path $script:SourceDir "targets-stubs\claude-code"
+    if ((-not (Test-Path $claudeTargetDir)) -and (Test-NeocortexSourceProject $script:SourceDir) -and (Test-Path (Join-Path $script:SourceDir "targets\claude-code") -PathType Container)) {
+        $claudeTargetDir = Join-Path $script:SourceDir "targets\claude-code"
+    }
+    if (-not (Test-Path $claudeTargetDir)) {
+        $claudeTargetDir = $script:SourceDir
+    }
+
+    # Epic 64 (Story 64.6): Debug diagnostics for Install-Agent
+    Write-Dbg "Install-Agent: SourceDir=$($script:SourceDir)"
+    Write-Dbg "Install-Agent: DestDir=$($script:DestDir)"
+    Write-Dbg "Install-Agent: claudeTargetDir=$claudeTargetDir"
+    $srcMdExists = Test-Path "$claudeTargetDir\neocortex.md"
+    $srcYamlExists = Test-Path "$claudeTargetDir\neocortex.agent.yaml"
+    Write-Dbg "Install-Agent: neocortex.md exists=$srcMdExists"
+    Write-Dbg "Install-Agent: neocortex.agent.yaml exists=$srcYamlExists"
+
+    # Epic 65: Early validation -- if NEITHER source file exists, emit clear error
+    if (-not $srcMdExists -and -not $srcYamlExists) {
+        Write-Fail "Arquivos fonte nao encontrados para target claude-code em: $claudeTargetDir"
+        Write-Fail "Diretorio de origem ($($script:SourceDir)) pode estar incompleto"
+        Write-Fail "Tente reinstalar: npm install -g @ornexus/neocortex"
+        $script:Errors += 2
+        return $false
+    }
+
+    # Tier 3: Copy only 2 stub files
+    # Epic 64 (Story 64.2): Capture Copy-Silent return and check for errors
+    $stubResult1 = Copy-Silent "$claudeTargetDir\neocortex.md" "$script:DestDir\"
+    if (-not $stubResult1) { Write-Fail "Falha ao copiar neocortex.md de $claudeTargetDir" }
+    Write-Dbg "Install-Agent: Copy neocortex.md result=$stubResult1"
+    $stubResult2 = Copy-Silent "$claudeTargetDir\neocortex.agent.yaml" "$script:DestDir\"
+    if (-not $stubResult2) { Write-Fail "Falha ao copiar neocortex.agent.yaml de $claudeTargetDir" }
+    Write-Dbg "Install-Agent: Copy neocortex.agent.yaml result=$stubResult2"
+
+    # Epic 65: Post-copy verification -- belt and suspenders
+    $destMd = Join-Path $script:DestDir "neocortex.md"
+    $destYaml = Join-Path $script:DestDir "neocortex.agent.yaml"
+    if (-not (Test-Path $destMd -PathType Leaf)) {
+        Write-Fail "neocortex.md nao encontrado no destino apos copia: $destMd"
+        if (-not $stubResult1) {} else { $script:Errors++ }
+    }
+    if (-not (Test-Path $destYaml -PathType Leaf)) {
+        Write-Fail "neocortex.agent.yaml nao encontrado no destino apos copia: $destYaml"
+        if (-not $stubResult2) {} else { $script:Errors++ }
+    }
+
+    # Cleanup workflow.md from previous versions
+    if (Test-Path "$script:DestDir\workflow.md") {
+        Remove-Item "$script:DestDir\workflow.md" -Force -ErrorAction SilentlyContinue
+    }
+
+    if ($LOCAL_MODE) {
+        # Modo local: copiar IP completa (comportamento legado para devs)
+        $r = Copy-Silent "$($script:SourceDir)\package.json" "$script:DestDir\"
+        if (-not $r) { Write-Fail "Falha ao copiar package.json" }
+        $r = Copy-Silent "$($script:SourceDir)\README.md" "$script:DestDir\"
+        if (-not $r) { Write-Fail "Falha ao copiar README.md" }
+
+        $coreSource = Join-Path $script:SourceDir "core"
+        if (Test-Path $coreSource -PathType Container) {
+            Copy-Item -Path $coreSource -Destination "$script:DestDir\" -Recurse -Force -ErrorAction SilentlyContinue
+        }
+
+        foreach ($folder in @("steps-c", "steps-e", "steps-p", "steps-r", "steps-u")) {
+            $stepSrc = "$($script:SourceDir)\core\steps\$folder"
+            if (Test-Path $stepSrc -PathType Container) {
+                Copy-Item -Path $stepSrc -Destination "$script:DestDir\" -Recurse -Force -ErrorAction SilentlyContinue
+            }
+        }
+    }
+    # Tier 3 Remote Mode: apenas 2 arquivos de interface (stubs)
+
+    return ($script:Errors -eq 0)
+}
+
+# =============================================================================
+# CARREGAMENTO DE .ENV
+# =============================================================================
+
+function Import-EnvFile {
+    $envFile = $null
+    @(".\.env", "$script:SourceDir\.env") | ForEach-Object {
+        if ((Test-Path $_ -PathType Leaf) -and -not $envFile) { $envFile = $_ }
+    }
+    if (-not $envFile) { return $false }
+
+    $loaded = 0
+    Get-Content $envFile | ForEach-Object {
+        $line = $_.Trim()
+        if (-not $line -or $line.StartsWith("#")) { return }
+        if ($line -match "^([^=]+)=(.*)$") {
+            $key = $matches[1].Trim()
+            $value = $matches[2].Trim() -replace '^["'']|["'']$', ''
+            if ($value -and -not [Environment]::GetEnvironmentVariable($key)) {
+                [Environment]::SetEnvironmentVariable($key, $value, "Process")
+                Set-Item -Path "env:$key" -Value $value -ErrorAction SilentlyContinue
+                $loaded++
+            }
+        }
+    }
+    if ($loaded -gt 0) { Write-Info "$loaded variavel(eis) carregada(s) do .env" }
+    return $true
+}
+
+# =============================================================================
+# CONFIGURACAO DE TOKENS
+# =============================================================================
+
+function Request-Tokens {
+    if ($QUIET_MODE -or $AUTO_YES -or $env:CONTEXT7_API_KEY) { return }
+
+    Write-Host ""
+    Write-Info "MCP Context7 nao configurado (opcional)"
+    Write-Host "  Configurar agora? [s/N]: " -NoNewline -ForegroundColor White
+    $response = Read-HostWithTimeout -TimeoutSeconds 15 -Default "n"
+
+    if ($response -match "^[sS]([iI][mM]?)?$|^[yY]([eE][sS]?)?$") {
+        Write-Host ""
+        Write-Info "Obtenha sua API Key em: https://context7.com"
+        Write-Host "  Cole sua CONTEXT7_API_KEY: " -NoNewline -ForegroundColor White
+        try {
+            $apiKey = Read-Host
+            if ($apiKey -match "^ctx7sk-") {
+                $env:CONTEXT7_API_KEY = $apiKey
+                Write-Ok "CONTEXT7_API_KEY configurada"
+                Write-Info "Para persistir: `$env:CONTEXT7_API_KEY = `"$apiKey`" em `$PROFILE"
+            } elseif ($apiKey) {
+                Write-Warn "Formato invalido (esperado: ctx7sk-...)"
+            }
+        } catch {}
+    }
+}
+
+# =============================================================================
+# INSTALACAO DE MCP SERVERS
+# =============================================================================
+
+function Install-MCPs {
+    $claudeCmd = Get-Command claude -ErrorAction SilentlyContinue
+    if (-not $claudeCmd) {
+        Write-Warn "Claude CLI nao encontrado (MCPs Claude user-scope serao instalados depois; outros targets continuam)"
+        return
+    }
+
+    $mcpOk = @()
+    $mcpSkip = @()
+    $browserUseEnvArgs = @()
+    if ($env:OPENAI_API_KEY) { $browserUseEnvArgs += @('-e', "OPENAI_API_KEY=$env:OPENAI_API_KEY") }
+    if ($env:ANTHROPIC_API_KEY) { $browserUseEnvArgs += @('-e', "ANTHROPIC_API_KEY=$env:ANTHROPIC_API_KEY") }
+
+    # Playwright
+    try {
+        & claude mcp add --scope user playwright -- npx -y @playwright/mcp@latest 2>$null
+        if ($LASTEXITCODE -eq 0) { $mcpOk += "playwright" }
+    } catch {}
+
+    # Context7
+    if ($env:CONTEXT7_API_KEY) {
+        try {
+            & claude mcp add --scope user --transport http context7 https://mcp.context7.com/mcp --header "CONTEXT7_API_KEY: $env:CONTEXT7_API_KEY" 2>$null
+            if ($LASTEXITCODE -eq 0) { $mcpOk += "context7" }
+        } catch {}
+    } else {
+        $mcpSkip += "context7"
+    }
+
+    # browser_use: optional (requires uvx and at least one supported LLM API key).
+    # Supported env vars are referenced by name only in logs: OPENAI_API_KEY,
+    # ANTHROPIC_API_KEY.
+    if ($browserUseEnvArgs.Count -gt 0) {
+        if (-not (Get-Command uvx -ErrorAction SilentlyContinue)) {
+            Write-Warn "uvx nao encontrado (Browser Use MCP requer uvx; instale uv/uvx e tente novamente)"
+            $mcpSkip += "browser_use"
+        } else {
+            try {
+                & claude mcp add --scope user browser_use @browserUseEnvArgs -- uvx --from 'browser-use[cli]' browser-use --mcp 2>$null
+                if ($LASTEXITCODE -eq 0) { $mcpOk += "browser_use" }
+            } catch {}
+        }
+    } else {
+        $mcpSkip += "browser_use"
+    }
+
+    # Design/component MCPs follow the same baseline install pattern as
+    # Playwright because public target fragments include them by default.
+    try {
+        & claude mcp add --scope user --transport http figma https://mcp.figma.com/mcp 2>$null
+        if ($LASTEXITCODE -eq 0) { $mcpOk += "figma" }
+    } catch {}
+
+    try {
+        & claude mcp add --scope user shadcn -- npx shadcn@latest mcp 2>$null
+        if ($LASTEXITCODE -eq 0) { $mcpOk += "shadcn" }
+    } catch {}
+
+    try {
+        & claude mcp add --scope user chrome-devtools -- npx -y chrome-devtools-mcp@latest 2>$null
+        if ($LASTEXITCODE -eq 0) { $mcpOk += "chrome-devtools" }
+    } catch {}
+
+    if ($mcpOk.Count -gt 0) { Write-Ok "MCPs: $($mcpOk -join ', ')" }
+    if ($mcpSkip.Count -gt 0) { Write-Info "MCPs pendentes: $($mcpSkip -join ', ')" }
+}
+
+# =============================================================================
+# STATUS DO CODERABBIT CLI (OPCIONAL / MANUAL)
+# =============================================================================
+
+function Test-CiEnvironment {
+    return ($env:CI -eq "true" -or $env:GITHUB_ACTIONS -eq "true" -or $env:TF_BUILD -eq "true")
+}
+
+function Get-CodeRabbitSkipReason {
+    if (Test-CiEnvironment) { return "P177_OPTIONAL_TOOL_SKIPPED_CI" }
+    if ((-not (Test-Interactive)) -or $AUTO_YES -or $QUIET_MODE) { return "P177_OPTIONAL_TOOL_SKIPPED_NONINTERACTIVE" }
+    return "P177_OPTIONAL_TOOL_OPT_IN_REQUIRED"
+}
+
+function Write-OptionalToolInfo {
+    param([string]$Message)
+    Write-Host "  -> " -ForegroundColor DarkGray -NoNewline
+    Write-Host $Message -ForegroundColor DarkGray
+}
+
+function Report-CodeRabbitStatus {
+    $coderabbitCmd = Get-Command coderabbit -ErrorAction SilentlyContinue
+    if ($coderabbitCmd) {
+        Write-InstallerDiagnostic -Tool "coderabbit" -Phase "optional-tool-setup" -Status "detected" -ReasonCode "P177_OPTIONAL_TOOL_DETECTED_MANUAL" -Code "0" -Summary "manual_optional_tool_detected"
+        Write-Ok "CodeRabbit CLI (opcional/manual detectado)"
+        $script:CodeRabbitInstalled = $true
+        return
+    }
+
+    $reasonCode = Get-CodeRabbitSkipReason
+    Write-InstallerDiagnostic -Tool "coderabbit" -Phase "optional-tool-setup" -Status "skipped" -ReasonCode $reasonCode -Code "null" -Summary "optional_tool_setup_skipped"
+    Write-OptionalToolInfo "CodeRabbit CLI (opcional; setup manual em docs/install/coderabbit-manual-setup.md; $reasonCode)"
+    $script:CodeRabbitInstalled = $false
+}
+
+# =============================================================================
+# MULTI-TARGET SUPPORT
+# =============================================================================
+
+$script:ValidTargets = @("claude-code", "cursor", "vscode", "gemini", "gemini-cli", "codex", "antigravity", "opencode", "kimi", "openclaw")
+$script:SelectedTargets = @()
+$script:TargetResults = @()
+$script:TargetCount = 0
+
+function Install-Targets {
+    param([string[]]$TargetList)
+
+    $homeDir = $env:USERPROFILE
+
+    foreach ($target in $TargetList) {
+        switch ($target) {
+            "claude-code" {
+                $success = Install-Agent
+                if ($success) {
+                    $script:TargetResults += "$target`:OK"
+                    $script:TargetCount++
+                    Write-Ok "claude-code (thin client)"
+                } else {
+                    $script:TargetResults += "$target`:FAIL"
+                    Write-Fail "claude-code"
+                }
+            }
+            "cursor" {
+                $cursorTargetDir = Resolve-TargetDir -Target "cursor"
+                if ($cursorTargetDir -and (Test-Path $cursorTargetDir -PathType Container)) {
+                    # Clean previous (NOTE: mcp.json is NOT deleted -- it is merged additively below)
+                    Remove-Item -Path "$homeDir\.cursor\agents\neocortex.md" -Force -ErrorAction SilentlyContinue
+                    if (Test-Path "$homeDir\.cursor\skills") { Remove-Item -Path "$homeDir\.cursor\skills" -Recurse -Force -ErrorAction SilentlyContinue }
+
+                    # Agent
+                    if (Test-Path "$cursorTargetDir\agent.md") {
+                        New-Item -ItemType Directory -Path "$homeDir\.cursor\agents" -Force | Out-Null
+                        Copy-Item -Path "$cursorTargetDir\agent.md" -Destination "$homeDir\.cursor\agents\neocortex.md" -Force
+                    }
+                    # Rules
+                    if (Test-Path "$cursorTargetDir\rules" -PathType Container) {
+                        New-Item -ItemType Directory -Path "$homeDir\.cursor\rules" -Force | Out-Null
+                        Copy-Item -Path "$cursorTargetDir\rules\*.mdc" -Destination "$homeDir\.cursor\rules\" -Force -ErrorAction SilentlyContinue
+                    }
+                    # Commands
+                    if (Test-Path "$cursorTargetDir\commands" -PathType Container) {
+                        New-Item -ItemType Directory -Path "$homeDir\.cursor\commands" -Force | Out-Null
+                        Copy-Item -Path "$cursorTargetDir\commands\*.md" -Destination "$homeDir\.cursor\commands\" -Force -ErrorAction SilentlyContinue
+                    }
+                    # MCP config (additive merge -- preserves user-defined servers)
+                    if (Test-Path "$cursorTargetDir\mcp.json") {
+                        Merge-JsonMcpConfig -StubFile "$cursorTargetDir\mcp.json" -DestFile "$homeDir\.cursor\mcp.json" -RootKey "mcpServers"
+                    }
+                    # Skills
+                    $skillsSource = Join-Path $script:SourceDir "core\skills"
+                    if (Test-Path $skillsSource -PathType Container) {
+                        New-Item -ItemType Directory -Path "$homeDir\.cursor\skills" -Force | Out-Null
+                        Copy-Item -Path "$skillsSource\*" -Destination "$homeDir\.cursor\skills\" -Recurse -Force -ErrorAction SilentlyContinue
+                    }
+
+                    Write-Ok "cursor"
+                    $script:TargetResults += "$target`:OK"
+                    $script:TargetCount++
+                } else {
+                    Write-Warn "cursor (adapter nao encontrado)"
+                    $script:TargetResults += "$target`:SKIP"
+                }
+            }
+            "vscode" {
+                $vscodeTargetDir = Resolve-TargetDir -Target "vscode"
+                if ($vscodeTargetDir -and (Test-Path $vscodeTargetDir -PathType Container)) {
+                    # Clean previous
+                    Remove-Item -Path "$homeDir\.github\agents\neocortex.md" -Force -ErrorAction SilentlyContinue
+                    Remove-Item -Path "$homeDir\.github\agents\neocortex.agent.md" -Force -ErrorAction SilentlyContinue
+                    Remove-Item -Path "$homeDir\.github\copilot-instructions.md" -Force -ErrorAction SilentlyContinue
+                    if (Test-Path "$homeDir\.github\skills") { Remove-Item -Path "$homeDir\.github\skills" -Recurse -Force -ErrorAction SilentlyContinue }
+
+                    # P124.02: source filename is neocortex.agent.md (canonical Custom Agents extension).
+                    if (Test-Path "$vscodeTargetDir\neocortex.agent.md") {
+                        New-Item -ItemType Directory -Path "$homeDir\.github\agents" -Force | Out-Null
+                        Copy-Item -Path "$vscodeTargetDir\neocortex.agent.md" -Destination "$homeDir\.github\agents\neocortex.agent.md" -Force
+                        Copy-Item -Path "$vscodeTargetDir\neocortex.agent.md" -Destination "$homeDir\.github\agents\neocortex.md" -Force
+                        New-Item -ItemType Directory -Path "$homeDir\.copilot\agents" -Force | Out-Null
+                        Copy-Item -Path "$vscodeTargetDir\neocortex.agent.md" -Destination "$homeDir\.copilot\agents\neocortex.agent.md" -Force
+                    }
+                    if (Test-Path "$vscodeTargetDir\instructions" -PathType Container) {
+                        New-Item -ItemType Directory -Path "$homeDir\.github\instructions" -Force | Out-Null
+                        Copy-Item -Path "$vscodeTargetDir\instructions\*.instructions.md" -Destination "$homeDir\.github\instructions\" -Force -ErrorAction SilentlyContinue
+                    }
+                    if (Test-Path "$vscodeTargetDir\prompts" -PathType Container) {
+                        New-Item -ItemType Directory -Path "$homeDir\.github\prompts" -Force | Out-Null
+                        Copy-Item -Path "$vscodeTargetDir\prompts\*.prompt.md" -Destination "$homeDir\.github\prompts\" -Force -ErrorAction SilentlyContinue
+                    }
+                    if (Test-Path "$vscodeTargetDir\mcp.json") {
+                        # User-level additive merge -- preserves user-defined servers (root key is "servers" in VS Code)
+                        Merge-JsonMcpConfig -StubFile "$vscodeTargetDir\mcp.json" -DestFile (Get-VsCodeUserMcpPath) -RootKey "servers"
+                    }
+                    if (Test-Path "$vscodeTargetDir\copilot-instructions.md") {
+                        Copy-Item -Path "$vscodeTargetDir\copilot-instructions.md" -Destination "$homeDir\.github\copilot-instructions.md" -Force
+                    }
+                    $skillsSource = Join-Path $script:SourceDir "core\skills"
+                    if (Test-Path $skillsSource -PathType Container) {
+                        New-Item -ItemType Directory -Path "$homeDir\.github\skills" -Force | Out-Null
+                        Copy-Item -Path "$skillsSource\*" -Destination "$homeDir\.github\skills\" -Recurse -Force -ErrorAction SilentlyContinue
+                    }
+
+                    Write-Ok "vscode"
+                    $script:TargetResults += "$target`:OK"
+                    $script:TargetCount++
+                } else {
+                    Write-Warn "vscode (adapter nao encontrado)"
+                    $script:TargetResults += "$target`:SKIP"
+                }
+            }
+            { $_ -in @("gemini", "gemini-cli") } {
+                $geminiTargetDir = Resolve-TargetDir -Target "gemini-cli"
+                $geminiHome = if ($env:GEMINI_HOME) { $env:GEMINI_HOME } else { "$homeDir\.gemini" }
+                if ($geminiTargetDir -and (Test-Path $geminiTargetDir -PathType Container)) {
+                    Remove-Item -Path "$geminiHome\agents\neocortex.md" -Force -ErrorAction SilentlyContinue
+                    if (Test-Path "$geminiHome\skills") { Remove-Item -Path "$geminiHome\skills" -Recurse -Force -ErrorAction SilentlyContinue }
+
+                    if (Test-Path "$geminiTargetDir\agents\neocortex.md") {
+                        New-Item -ItemType Directory -Path "$geminiHome\agents" -Force | Out-Null
+                        Copy-Item -Path "$geminiTargetDir\agents\neocortex.md" -Destination "$geminiHome\agents\neocortex.md" -Force
+                    } elseif (Test-Path "$geminiTargetDir\agent.md") {
+                        New-Item -ItemType Directory -Path "$geminiHome\agents" -Force | Out-Null
+                        Copy-Item -Path "$geminiTargetDir\agent.md" -Destination "$geminiHome\agents\neocortex.md" -Force
+                    }
+                    if (Test-Path "$geminiTargetDir\gemini.md") {
+                        Copy-Item -Path "$geminiTargetDir\gemini.md" -Destination "$homeDir\GEMINI.md" -Force
+                    }
+                    if (Test-Path "$geminiTargetDir\commands" -PathType Container) {
+                        New-Item -ItemType Directory -Path "$geminiHome\commands" -Force | Out-Null
+                        Copy-Item -Path "$geminiTargetDir\commands\*.toml" -Destination "$geminiHome\commands\" -Force -ErrorAction SilentlyContinue
+                    }
+                    if (Test-Path "$geminiTargetDir\settings-mcp.json") {
+                        # Additive merge into ~/.gemini/settings.json (root key is "mcpServers")
+                        Merge-JsonMcpConfig -StubFile "$geminiTargetDir\settings-mcp.json" -DestFile "$geminiHome\settings.json" -RootKey "mcpServers"
+                    }
+                    $skillsSource = Join-Path $script:SourceDir "core\skills"
+                    if (Test-Path $skillsSource -PathType Container) {
+                        New-Item -ItemType Directory -Path "$geminiHome\skills" -Force | Out-Null
+                        Copy-Item -Path "$skillsSource\*" -Destination "$geminiHome\skills\" -Recurse -Force -ErrorAction SilentlyContinue
+                    }
+
+                    Write-Ok "gemini"
+                    $script:TargetResults += "$target`:OK"
+                    $script:TargetCount++
+                } else {
+                    Write-Warn "gemini (adapter nao encontrado)"
+                    $script:TargetResults += "$target`:SKIP"
+                }
+            }
+            "codex" {
+                $codexTargetDir = Resolve-TargetDir -Target "codex"
+                $codexHome = if ($env:CODEX_HOME) { $env:CODEX_HOME } else { "$homeDir\.codex" }
+                if ($codexTargetDir -and (Test-Path $codexTargetDir -PathType Container)) {
+                    Remove-Item -Path "$codexHome\AGENTS.md" -Force -ErrorAction SilentlyContinue
+                    New-Item -ItemType Directory -Path $codexHome -Force | Out-Null
+                    New-Item -ItemType Directory -Path "$codexHome\agents" -Force | Out-Null
+
+                    if (Test-Path "$codexTargetDir\AGENTS.md") {
+                        Copy-Item -Path "$codexTargetDir\AGENTS.md" -Destination "$codexHome\AGENTS.md" -Force
+                    }
+                    if (Test-Path "$codexTargetDir\neocortex.toml") {
+                        Copy-Item -Path "$codexTargetDir\neocortex.toml" -Destination "$codexHome\agents\neocortex.toml" -Force
+                    }
+                    if (Test-Path "$codexTargetDir\config-mcp.toml") {
+                        $configFile = "$codexHome\config.toml"
+                        Merge-CodexMcpToml -StubFile "$codexTargetDir\config-mcp.toml" -DestFile $configFile
+                    }
+
+                    Write-Ok "codex"
+                    $script:TargetResults += "$target`:OK"
+                    $script:TargetCount++
+                } else {
+                    Write-Warn "codex (adapter nao encontrado)"
+                    $script:TargetResults += "$target`:SKIP"
+                }
+            }
+            "antigravity" {
+                $antiTargetDir = Resolve-TargetDir -Target "antigravity"
+                $geminiHome = if ($env:GEMINI_HOME) { $env:GEMINI_HOME } else { "$homeDir\.gemini" }
+                if ($antiTargetDir -and (Test-Path $antiTargetDir -PathType Container)) {
+                    # NOTE: Do NOT recursively delete $geminiHome\antigravity -- merge mcp_config.json instead
+                    if (Test-Path "$antiTargetDir\skill\SKILL.md") {
+                        New-Item -ItemType Directory -Path "$homeDir\.agent\skills\neocortex" -Force | Out-Null
+                        Copy-Item -Path "$antiTargetDir\skill\SKILL.md" -Destination "$homeDir\.agent\skills\neocortex\SKILL.md" -Force
+                    }
+                    if (Test-Path "$antiTargetDir\rules" -PathType Container) {
+                        New-Item -ItemType Directory -Path "$homeDir\.agent\rules" -Force | Out-Null
+                        Copy-Item -Path "$antiTargetDir\rules\*.md" -Destination "$homeDir\.agent\rules\" -Force -ErrorAction SilentlyContinue
+                    }
+                    if (Test-Path "$antiTargetDir\workflows" -PathType Container) {
+                        New-Item -ItemType Directory -Path "$homeDir\.agent\workflows" -Force | Out-Null
+                        Copy-Item -Path "$antiTargetDir\workflows\*.md" -Destination "$homeDir\.agent\workflows\" -Force -ErrorAction SilentlyContinue
+                    }
+                    if (Test-Path "$antiTargetDir\mcp-config.json") {
+                        New-Item -ItemType Directory -Path "$geminiHome\antigravity" -Force | Out-Null
+                        # Antigravity uses root mcpServers; preserve custom entries while migrating managed legacy top-level entries.
+                        Merge-JsonMcpConfig -StubFile "$antiTargetDir\mcp-config.json" -DestFile "$geminiHome\antigravity\mcp_config.json" -RootKey "mcpServers" -ManagedTopLevelNames @("playwright", "context7", "browser_use", "figma", "shadcn", "chrome-devtools")
+                    }
+                    if (Test-Path "$antiTargetDir\gemini.md") {
+                        Copy-Item -Path "$antiTargetDir\gemini.md" -Destination "$homeDir\GEMINI.md" -Force
+                    }
+                    $skillsSource = Join-Path $script:SourceDir "core\skills"
+                    if (Test-Path $skillsSource -PathType Container) {
+                        $skillsDest = "$homeDir\.agent\skills\neocortex\skills"
+                        New-Item -ItemType Directory -Path $skillsDest -Force | Out-Null
+                        Copy-Item -Path "$skillsSource\*" -Destination "$skillsDest\" -Recurse -Force -ErrorAction SilentlyContinue
+                    }
+
+                    Write-Ok "antigravity"
+                    $script:TargetResults += "$target`:OK"
+                    $script:TargetCount++
+                } else {
+                    Write-Warn "antigravity (adapter nao encontrado)"
+                    $script:TargetResults += "$target`:SKIP"
+                }
+            }
+            "opencode" {
+                $opencodeTargetDir = Resolve-TargetDir -Target "opencode"
+                $opencodeHome = Get-OpenCodeHome
+                if ($opencodeTargetDir -and (Test-Path "$opencodeTargetDir\neocortex.md") -and (Test-Path "$opencodeTargetDir\neocortex-root.md")) {
+                    New-Item -ItemType Directory -Path "$opencodeHome\agents" -Force | Out-Null
+                    Copy-Item -Path "$opencodeTargetDir\neocortex.md" -Destination "$opencodeHome\agents\neocortex.md" -Force -ErrorAction SilentlyContinue
+                    Copy-Item -Path "$opencodeTargetDir\neocortex-root.md" -Destination "$opencodeHome\agents\neocortex-root.md" -Force -ErrorAction SilentlyContinue
+                    if (Test-Path "$opencodeTargetDir\opencode-mcp.json") {
+                        Merge-JsonMcpConfig -StubFile "$opencodeTargetDir\opencode-mcp.json" -DestFile "$opencodeHome\opencode.json" -RootKey "mcp"
+                    }
+                    Write-Ok "opencode"
+                    $script:TargetResults += "$target`:OK"
+                    $script:TargetCount++
+                } else {
+                    Write-Warn "opencode (root/subagent stubs nao encontrados)"
+                    $script:TargetResults += "opencode`:SKIP"
+                }
+            }
+            "kimi" {
+                $kimiTargetDir = Resolve-TargetDir -Target "kimi"
+                $kimiHome = Get-KimiHome
+                if ($kimiTargetDir -and (Test-Path "$kimiTargetDir\neocortex.md")) {
+                    New-Item -ItemType Directory -Path "$kimiHome\skills\neocortex" -Force | Out-Null
+                    New-Item -ItemType Directory -Path "$homeDir\.config\agents\skills\neocortex" -Force | Out-Null
+                    Copy-Item -Path "$kimiTargetDir\neocortex.md" -Destination "$kimiHome\skills\neocortex\SKILL.md" -Force -ErrorAction SilentlyContinue
+                    Copy-Item -Path "$kimiTargetDir\neocortex.md" -Destination "$homeDir\.config\agents\skills\neocortex\SKILL.md" -Force -ErrorAction SilentlyContinue
+                    if (Test-Path "$kimiTargetDir\mcp.json") {
+                        Merge-JsonMcpConfig -StubFile "$kimiTargetDir\mcp.json" -DestFile "$kimiHome\mcp.json" -RootKey "mcpServers"
+                    }
+                    Write-Ok "kimi"
+                    $script:TargetResults += "$target`:OK"
+                    $script:TargetCount++
+                } else {
+                    Write-Warn "kimi (adapter nao encontrado)"
+                    $script:TargetResults += "$target`:SKIP"
+                }
+            }
+            "openclaw" {
+                $openclawTargetDir = Resolve-TargetDir -Target "openclaw"
+                $openclawHome = if ($env:OPENCLAW_HOME) { $env:OPENCLAW_HOME } else { Join-Path $homeDir ".openclaw" }
+                $skillSource = if ($openclawTargetDir) { Join-Path $openclawTargetDir "SKILL.md" } else { $null }
+                if ($skillSource -and (Test-Path $skillSource -PathType Leaf)) {
+                    $skillDestDir = Join-Path $openclawHome "skills\neocortex"
+                    New-Item -ItemType Directory -Path $skillDestDir -Force | Out-Null
+                    Copy-Item -Path $skillSource -Destination (Join-Path $skillDestDir "SKILL.md") -Force -ErrorAction SilentlyContinue
+                    Write-Ok "openclaw (Skill thin-client; openclaw.json preservado)"
+                    $script:TargetResults += "$target`:OK"
+                    $script:TargetCount++
+                } else {
+                    Write-Warn "openclaw (Skill stub nao encontrado; path tentado: $skillSource)"
+                    $script:TargetResults += "$target`:SKIP"
+                }
+            }
+            default {
+                Write-Warn "'$target' nao reconhecido"
+                $script:TargetResults += "$target`:SKIP"
+            }
+        }
+    }
+}
+
+# =============================================================================
+# CRIACAO DE DIRETORIOS DO PROJETO
+# =============================================================================
+
+function New-ProjectDirectories {
+    if ($QUIET_MODE -or $SKIP_PROJECT_DIRS) { return }
+
+    $shouldCreate = $false
+
+    if ($CreateProject -or $AUTO_YES) {
+        $shouldCreate = $true
+    } else {
+        Write-Host "  Instalar estrutura no projeto atual? [s/N]: " -NoNewline -ForegroundColor White
+        $response = Read-HostWithTimeout -TimeoutSeconds 30 -Default "n"
+        if ($response -match "^[sS]([iI][mM]?)?$|^[yY]([eE][sS]?)?$") { $shouldCreate = $true }
+    }
+
+    if (-not $shouldCreate) { return }
+
+    $projectDir = Get-Location
+
+    if (Test-NeocortexSourceProject -Path $projectDir) {
+        Write-Warn "Recusando -CreateProject dentro do repo fonte do Neocortex"
+        Write-Warn "Isso preserva core/ e arquivos de desenvolvimento locais"
+        return
+    }
+
+    # Clean previous
+    @("$projectDir\core", "$projectDir\targets\claude-code", "$projectDir\.cursor\skills",
+      "$projectDir\.github\skills", "$projectDir\.agent\skills\neocortex",
+      "$projectDir\.agents\skills", "$projectDir\.claude\agents\neocortex",
+      "$projectDir\.claude\skills\neocortex", "$projectDir\.kimi\skills\neocortex",
+      "$projectDir\.openclaw\skills\neocortex") | ForEach-Object {
+        if (Test-Path $_) { Remove-Item -Path $_ -Recurse -Force -ErrorAction SilentlyContinue }
+    }
+    @("$projectDir\.cursor\agents\neocortex.md", "$projectDir\.github\agents\neocortex.md",
+      "$projectDir\.github\copilot-instructions.md", "$projectDir\AGENTS.md",
+      "$projectDir\GEMINI.md", "$projectDir\.opencode\agents\neocortex.md") | ForEach-Object {
+        if (Test-Path $_) { Remove-Item -Path $_ -Force -ErrorAction SilentlyContinue }
+    }
+
+    # Create base dirs
+    @("$projectDir\.neocortex\specs", "$projectDir\.neocortex\planning",
+      "$projectDir\docs\stories", "$projectDir\docs\epics", "$projectDir\docs\proposals") | ForEach-Object {
+        New-Item -ItemType Directory -Path $_ -Force | Out-Null
+    }
+
+    # State template
+    $stateTemplate = Join-Path $script:SourceDir "core\data\state-template.json"
+    $stateTarget = "$projectDir\.neocortex\state.json"
+    if (-not (Test-Path $stateTarget) -and (Test-Path $stateTemplate)) {
+        Copy-Item -Path $stateTemplate -Destination $stateTarget -Force
+    }
+
+    # Core (ONLY in local mode)
+    $coreSource = Join-Path $script:SourceDir "core"
+    if ($LOCAL_MODE -and (Test-Path $coreSource -PathType Container)) {
+        New-Item -ItemType Directory -Path "$projectDir\core" -Force | Out-Null
+        Copy-Item -Path "$coreSource\*" -Destination "$projectDir\core\" -Recurse -Force
+    }
+
+    # Target-specific files
+    $targetSummary = @()
+    foreach ($target in $script:SelectedTargets) {
+        switch ($target) {
+            "claude-code" {
+                $claudeTargetDir = Resolve-TargetDir -Target "claude-code"
+                if ($claudeTargetDir -and (Test-Path $claudeTargetDir -PathType Container)) {
+                    $agentDest = "$projectDir\.claude\agents\neocortex"
+                    New-Item -ItemType Directory -Path $agentDest -Force | Out-Null
+
+                    # SEMPRE copiar os 3 arquivos de interface
+                    # Tier 3: Copy only 2 stub files
+                    # Epic 64 (Story 64.2): Capture Copy-Silent return
+                    $r = Copy-Silent "$claudeTargetDir\neocortex.md" "$agentDest\"
+                    if (-not $r) { Write-Fail "Falha ao copiar neocortex.md (projeto)" }
+                    $r = Copy-Silent "$claudeTargetDir\neocortex.agent.yaml" "$agentDest\"
+                    if (-not $r) { Write-Fail "Falha ao copiar neocortex.agent.yaml (projeto)" }
+                    # Cleanup workflow.md from previous versions
+                    if (Test-Path "$agentDest\workflow.md") {
+                        Remove-Item "$agentDest\workflow.md" -Force -ErrorAction SilentlyContinue
+                    }
+
+                    if ($LOCAL_MODE) {
+                        # Modo local: copiar IP completa (comportamento legado)
+                        $r = Copy-Silent "$($script:SourceDir)\package.json" "$agentDest\"
+                        if (-not $r) { Write-Fail "Falha ao copiar package.json (projeto)" }
+                        $r = Copy-Silent "$($script:SourceDir)\README.md" "$agentDest\"
+                        if (-not $r) { Write-Fail "Falha ao copiar README.md (projeto)" }
+                        New-Item -ItemType Directory -Path "$agentDest\core" -Force | Out-Null
+                        Copy-Item -Path "$coreSource\*" -Destination "$agentDest\core\" -Recurse -Force -ErrorAction SilentlyContinue
+                        foreach ($folder in @("steps-c", "steps-e", "steps-p", "steps-r", "steps-u")) {
+                            $stepSrc = "$($script:SourceDir)\core\steps\$folder"
+                            if (Test-Path $stepSrc -PathType Container) {
+                                New-Item -ItemType Directory -Path "$agentDest\$folder" -Force | Out-Null
+                                Copy-Item -Path "$stepSrc\*" -Destination "$agentDest\$folder\" -Recurse -Force -ErrorAction SilentlyContinue
+                            }
+                        }
+                        $skillsSource = Join-Path $script:SourceDir "core\skills"
+                        if (Test-Path $skillsSource -PathType Container) {
+                            New-Item -ItemType Directory -Path "$projectDir\.claude\skills\neocortex" -Force | Out-Null
+                            Copy-Item -Path "$skillsSource\*" -Destination "$projectDir\.claude\skills\neocortex\" -Recurse -Force -ErrorAction SilentlyContinue
+                        }
+                    } else {
+                        # Tier 3 Remote Mode: limpar IP de versoes anteriores no projeto
+                        Invoke-AutoCleanupLegacyProject -ProjectDir $projectDir
+                    }
+                    $targetSummary += "claude-code"
+                }
+            }
+            "cursor" {
+                $cursorTargetDir = Resolve-TargetDir -Target "cursor"
+                if ($cursorTargetDir -and (Test-Path $cursorTargetDir -PathType Container)) {
+                    if (Test-Path "$cursorTargetDir\agent.md") {
+                        New-Item -ItemType Directory -Path "$projectDir\.cursor\agents" -Force | Out-Null
+                        Copy-Item -Path "$cursorTargetDir\agent.md" -Destination "$projectDir\.cursor\agents\neocortex.md" -Force
+                    }
+                    if (Test-Path "$cursorTargetDir\rules" -PathType Container) {
+                        New-Item -ItemType Directory -Path "$projectDir\.cursor\rules" -Force | Out-Null
+                        Copy-Item -Path "$cursorTargetDir\rules\*.mdc" -Destination "$projectDir\.cursor\rules\" -Force -ErrorAction SilentlyContinue
+                    }
+                    if (Test-Path "$cursorTargetDir\commands" -PathType Container) {
+                        New-Item -ItemType Directory -Path "$projectDir\.cursor\commands" -Force | Out-Null
+                        Copy-Item -Path "$cursorTargetDir\commands\*.md" -Destination "$projectDir\.cursor\commands\" -Force -ErrorAction SilentlyContinue
+                    }
+                    if (Test-Path "$cursorTargetDir\mcp.json") {
+                        New-Item -ItemType Directory -Path "$projectDir\.cursor" -Force | Out-Null
+                        Merge-JsonMcpConfig -StubFile "$cursorTargetDir\mcp.json" -DestFile "$projectDir\.cursor\mcp.json" -RootKey "mcpServers"
+                    }
+                    $skillsSource = Join-Path $script:SourceDir "core\skills"
+                    if (Test-Path $skillsSource -PathType Container) {
+                        New-Item -ItemType Directory -Path "$projectDir\.cursor\skills" -Force | Out-Null
+                        Copy-Item -Path "$skillsSource\*" -Destination "$projectDir\.cursor\skills\" -Recurse -Force -ErrorAction SilentlyContinue
+                    }
+                    $targetSummary += "cursor"
+                }
+            }
+            "vscode" {
+                $vscodeTargetDir = Resolve-TargetDir -Target "vscode"
+                if ($vscodeTargetDir -and (Test-Path $vscodeTargetDir -PathType Container)) {
+                    # P124.02: source filename is neocortex.agent.md (canonical Custom Agents extension).
+                    if (Test-Path "$vscodeTargetDir\neocortex.agent.md") {
+                        New-Item -ItemType Directory -Path "$projectDir\.github\agents" -Force | Out-Null
+                        Copy-Item -Path "$vscodeTargetDir\neocortex.agent.md" -Destination "$projectDir\.github\agents\neocortex.agent.md" -Force
+                        Copy-Item -Path "$vscodeTargetDir\neocortex.agent.md" -Destination "$projectDir\.github\agents\neocortex.md" -Force
+                    }
+                    if (Test-Path "$vscodeTargetDir\instructions" -PathType Container) {
+                        New-Item -ItemType Directory -Path "$projectDir\.github\instructions" -Force | Out-Null
+                        Copy-Item -Path "$vscodeTargetDir\instructions\*.instructions.md" -Destination "$projectDir\.github\instructions\" -Force -ErrorAction SilentlyContinue
+                    }
+                    if (Test-Path "$vscodeTargetDir\prompts" -PathType Container) {
+                        New-Item -ItemType Directory -Path "$projectDir\.github\prompts" -Force | Out-Null
+                        Copy-Item -Path "$vscodeTargetDir\prompts\*.prompt.md" -Destination "$projectDir\.github\prompts\" -Force -ErrorAction SilentlyContinue
+                    }
+                    if (Test-Path "$vscodeTargetDir\mcp.json") {
+                        New-Item -ItemType Directory -Path "$projectDir\.vscode" -Force | Out-Null
+                        Merge-JsonMcpConfig -StubFile "$vscodeTargetDir\mcp.json" -DestFile "$projectDir\.vscode\mcp.json" -RootKey "servers"
+                    }
+                    if (Test-Path "$vscodeTargetDir\copilot-instructions.md") {
+                        Copy-Item -Path "$vscodeTargetDir\copilot-instructions.md" -Destination "$projectDir\.github\copilot-instructions.md" -Force
+                    }
+                    $skillsSource = Join-Path $script:SourceDir "core\skills"
+                    if (Test-Path $skillsSource -PathType Container) {
+                        New-Item -ItemType Directory -Path "$projectDir\.github\skills" -Force | Out-Null
+                        Copy-Item -Path "$skillsSource\*" -Destination "$projectDir\.github\skills\" -Recurse -Force -ErrorAction SilentlyContinue
+                    }
+                    $targetSummary += "vscode"
+                }
+            }
+            { $_ -in @("gemini", "gemini-cli") } {
+                $geminiTargetDir = Resolve-TargetDir -Target "gemini-cli"
+                if ($geminiTargetDir -and (Test-Path $geminiTargetDir -PathType Container)) {
+                    if (Test-Path "$geminiTargetDir\gemini.md") { Copy-Item -Path "$geminiTargetDir\gemini.md" -Destination "$projectDir\GEMINI.md" -Force }
+                    if (Test-Path "$geminiTargetDir\commands" -PathType Container) {
+                        New-Item -ItemType Directory -Path "$projectDir\.gemini\commands" -Force | Out-Null
+                        Copy-Item -Path "$geminiTargetDir\commands\*.toml" -Destination "$projectDir\.gemini\commands\" -Force -ErrorAction SilentlyContinue
+                    }
+                    if (Test-Path "$geminiTargetDir\agents\neocortex.md") {
+                        New-Item -ItemType Directory -Path "$projectDir\.gemini\agents" -Force | Out-Null
+                        Copy-Item -Path "$geminiTargetDir\agents\neocortex.md" -Destination "$projectDir\.gemini\agents\neocortex.md" -Force
+                    } elseif (Test-Path "$geminiTargetDir\agent.md") {
+                        New-Item -ItemType Directory -Path "$projectDir\.gemini\agents" -Force | Out-Null
+                        Copy-Item -Path "$geminiTargetDir\agent.md" -Destination "$projectDir\.gemini\agents\neocortex.md" -Force
+                    }
+                    if (Test-Path "$geminiTargetDir\settings-mcp.json") {
+                        Copy-Item -Path "$geminiTargetDir\settings-mcp.json" -Destination "$projectDir\.gemini\settings-mcp.json" -Force
+                    }
+                    $targetSummary += "gemini"
+                }
+            }
+            "codex" {
+                $codexTargetDir = Resolve-TargetDir -Target "codex"
+                if ($codexTargetDir -and (Test-Path $codexTargetDir -PathType Container)) {
+                    if (Test-Path "$codexTargetDir\AGENTS.md") { Copy-Item -Path "$codexTargetDir\AGENTS.md" -Destination "$projectDir\AGENTS.md" -Force }
+                    if (Test-Path "$codexTargetDir\neocortex.toml") {
+                        New-Item -ItemType Directory -Path "$projectDir\.codex\agents" -Force | Out-Null
+                        Copy-Item -Path "$codexTargetDir\neocortex.toml" -Destination "$projectDir\.codex\agents\neocortex.toml" -Force
+                    }
+                    $skillsSource = Join-Path $script:SourceDir "core\skills"
+                    if (Test-Path $skillsSource -PathType Container) {
+                        New-Item -ItemType Directory -Path "$projectDir\.agents\skills" -Force | Out-Null
+                        Copy-Item -Path "$skillsSource\*" -Destination "$projectDir\.agents\skills\" -Recurse -Force -ErrorAction SilentlyContinue
+                    }
+                    $targetSummary += "codex"
+                }
+            }
+            "antigravity" {
+                $antiTargetDir = Resolve-TargetDir -Target "antigravity"
+                if ($antiTargetDir -and (Test-Path $antiTargetDir -PathType Container)) {
+                    if (Test-Path "$antiTargetDir\skill\SKILL.md") {
+                        New-Item -ItemType Directory -Path "$projectDir\.agent\skills\neocortex" -Force | Out-Null
+                        Copy-Item -Path "$antiTargetDir\skill\SKILL.md" -Destination "$projectDir\.agent\skills\neocortex\SKILL.md" -Force
+                    }
+                    if (Test-Path "$antiTargetDir\rules" -PathType Container) {
+                        New-Item -ItemType Directory -Path "$projectDir\.agent\rules" -Force | Out-Null
+                        Copy-Item -Path "$antiTargetDir\rules\*.md" -Destination "$projectDir\.agent\rules\" -Force -ErrorAction SilentlyContinue
+                    }
+                    if (Test-Path "$antiTargetDir\workflows" -PathType Container) {
+                        New-Item -ItemType Directory -Path "$projectDir\.agent\workflows" -Force | Out-Null
+                        Copy-Item -Path "$antiTargetDir\workflows\*.md" -Destination "$projectDir\.agent\workflows\" -Force -ErrorAction SilentlyContinue
+                    }
+                    if (Test-Path "$antiTargetDir\gemini.md") { Copy-Item -Path "$antiTargetDir\gemini.md" -Destination "$projectDir\GEMINI.md" -Force }
+                    $skillsSource = Join-Path $script:SourceDir "core\skills"
+                    if (Test-Path $skillsSource -PathType Container) {
+                        $skillsDest = "$projectDir\.agent\skills\neocortex\skills"
+                        New-Item -ItemType Directory -Path $skillsDest -Force | Out-Null
+                        Copy-Item -Path "$skillsSource\*" -Destination "$skillsDest\" -Recurse -Force -ErrorAction SilentlyContinue
+                    }
+                    $targetSummary += "antigravity"
+                }
+            }
+            "opencode" {
+                $opencodeTargetDir = Resolve-TargetDir -Target "opencode"
+                if ($opencodeTargetDir -and (Test-Path "$opencodeTargetDir\neocortex.md") -and (Test-Path "$opencodeTargetDir\neocortex-root.md")) {
+                    New-Item -ItemType Directory -Path "$projectDir\.opencode\agents" -Force | Out-Null
+                    Copy-Item -Path "$opencodeTargetDir\neocortex.md" -Destination "$projectDir\.opencode\agents\neocortex.md" -Force
+                    Copy-Item -Path "$opencodeTargetDir\neocortex-root.md" -Destination "$projectDir\.opencode\agents\neocortex-root.md" -Force
+                    $targetSummary += "opencode"
+                }
+            }
+            "kimi" {
+                $kimiTargetDir = Resolve-TargetDir -Target "kimi"
+                if ($kimiTargetDir -and (Test-Path "$kimiTargetDir\neocortex.md")) {
+                    New-Item -ItemType Directory -Path "$projectDir\.kimi\skills\neocortex" -Force | Out-Null
+                    Copy-Item -Path "$kimiTargetDir\neocortex.md" -Destination "$projectDir\.kimi\skills\neocortex\SKILL.md" -Force
+                    $targetSummary += "kimi"
+                }
+            }
+            "openclaw" {
+                $openclawTargetDir = Resolve-TargetDir -Target "openclaw"
+                $skillSource = if ($openclawTargetDir) { Join-Path $openclawTargetDir "SKILL.md" } else { $null }
+                if ($skillSource -and (Test-Path $skillSource -PathType Leaf)) {
+                    $skillDestDir = "$projectDir\.openclaw\skills\neocortex"
+                    New-Item -ItemType Directory -Path $skillDestDir -Force | Out-Null
+                    Copy-Item -Path $skillSource -Destination "$skillDestDir\SKILL.md" -Force
+                    $targetSummary += "openclaw"
+                }
+            }
+        }
+    }
+
+    Write-Host ""
+    Write-Ok "Estrutura do projeto instalada ($($targetSummary -join ', '))"
+    Write-Host ""
+    Write-Info "Proximo passo: @neocortex *init @docs/epics.md"
+}
+
+# =============================================================================
+# RESULTADO
+# =============================================================================
+
+function Show-Result {
+    param([bool]$Success)
+    if ($QUIET_MODE) { return $Success }
+
+    Write-Host ""
+    Write-Host "  ----------------------------------------" -ForegroundColor DarkGray
+
+    if ($Success) {
+        Write-Host ""
+
+        # Success logo (brain/cortex shape, text centered vertically)
+        Write-Host "       #######" -ForegroundColor Cyan
+        Write-Host "      ###  ########" -ForegroundColor Cyan
+        Write-Host " #########      #####" -ForegroundColor Cyan
+        Write-Host -NoNewline " ##    ##############    " -ForegroundColor Cyan
+        Write-Host "N E O C O R T E X" -ForegroundColor White
+        Write-Host -NoNewline " ##   ###  ######  ##    " -ForegroundColor Cyan
+        Write-Host "v$VERSION" -ForegroundColor White
+        Write-Host " ##   ###    ###   ##" -ForegroundColor Cyan
+        Write-Host -NoNewline " ##  ######  ###   ##    " -ForegroundColor Cyan
+        Write-Host "Installation complete!" -ForegroundColor Green
+        Write-Host -NoNewline " ###############   ##    " -ForegroundColor Cyan
+        Write-Host "OrNexus Team" -ForegroundColor DarkGray
+        Write-Host " #####       ########" -ForegroundColor Cyan
+        Write-Host "   ########  ##" -ForegroundColor Cyan
+        Write-Host "        #######" -ForegroundColor Cyan
+        Write-Host ""
+
+        # Story 66.4 AC6: Target count
+        $okTargets = ($script:TargetResults | Where-Object { $_ -match ":OK$" }).Count
+        if ($okTargets -gt 0) {
+            Write-Host "  $okTargets plataforma(s) instalada(s)" -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 "  Mode:    Remote (thin client)" -ForegroundColor DarkGray
+            Write-Host "  Status:  Ready to activate" -ForegroundColor DarkGray
+            Write-Host ""
+            Write-Host "  Activate your license:" -ForegroundColor DarkGray
+            Write-Host "    neocortex activate YOUR-LICENSE-KEY" -ForegroundColor Cyan
+            Write-Host ""
+            Write-Host "  Get your key at: https://neocortex.sh/portal/login" -ForegroundColor DarkGray
+            Write-Host ""
+            Write-Host "  After activation:" -ForegroundColor DarkGray
+            Write-Host "    @neocortex *menu" -ForegroundColor Cyan
+        }
+        Write-Host ""
+        Write-Host "  Proximo passo:" -ForegroundColor DarkGray
+        Write-Host "    @neocortex *init @docs/epics.md" -ForegroundColor Cyan
+        Write-Host ""
+        return $true
+    } else {
+        Write-Host ""
+        Write-Host "  Instalacao com problemas" -ForegroundColor Red
+        Write-Host ""
+        # Story 66.4 AC5: Windows troubleshooting
+        Write-Host "  Execute novamente com " -NoNewline
+        Write-Host "-Debug" -ForegroundColor White -NoNewline
+        Write-Host " para detalhes:"
+        Write-Host "    npx @ornexus/neocortex -Debug" -ForegroundColor Yellow
+        Write-Host ""
+        return $false
+    }
+}
+
+# =============================================================================
+# MAIN
+# =============================================================================
+
+Show-Banner
+Get-SourceDirectory
+Test-OldInstallation
+
+# Determine targets
+if ($Targets) {
+    $script:SelectedTargets = $Targets -split ',' | ForEach-Object { $_.Trim() } | Where-Object { $_ }
+    $invalid = $script:SelectedTargets | Where-Object { $_ -notin $script:ValidTargets }
+    if ($invalid) {
+        Write-Fail "Plataformas invalidas: $($invalid -join ', ')"
+        Write-Host "  Validas: $($script:ValidTargets -join ', ')"
+        exit 1
+    }
+} elseif ($Yes) {
+    $script:SelectedTargets = @("claude-code")
+} else {
+    $script:SelectedTargets = @("claude-code")
+}
+
+Write-Dbg "Targets: $($script:SelectedTargets -join ', ')"
+
+if ($DryRun) {
+    Show-TargetResolutionDryRun -TargetList $script:SelectedTargets
+    exit 0
+}
+
+$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 2: Core
+Write-Step 2 $totalSteps "Instalando core"
+$coreSuccess = Install-Core
+
+if (-not $coreSuccess) {
+    Write-Fail "Falha na instalacao do core"
+    exit 1
+}
+
+# Step 3: Skills
+Write-Step 3 $totalSteps "Instalando skills"
+Install-Skills | Out-Null
+
+# Step 4: Targets
+Write-Step 4 $totalSteps "Instalando $($script:SelectedTargets.Count) plataforma(s)"
+Install-Targets -TargetList $script:SelectedTargets
+
+# Step 5-6: Claude Code extras
+if ($script:SelectedTargets -contains "claude-code") {
+    Import-EnvFile | Out-Null
+    Request-Tokens
+
+    Write-Step 5 $totalSteps "Configurando MCPs"
+    Install-MCPs
+
+    Write-Step 6 $totalSteps "Verificando ferramentas"
+    Report-CodeRabbitStatus
+}
+
+$installSuccess = ($script:TargetResults | Where-Object { $_ -match ":FAIL$" }).Count -eq 0
+$verifySuccess = Verify-Installation
+$installSuccess = $installSuccess -and $verifySuccess
+
+if (Show-Result $installSuccess) {
+    $projectSources = Test-ProjectMigrationNeeds
+    if ($projectSources) {
+        Write-Warn "Migracao detectada"
+        Write-Info "Execute: @neocortex *init @docs/epics.md para migrar"
+    }
+    New-ProjectDirectories
+    Write-Host "  Desenvolvido por OrNexus Team" -ForegroundColor DarkGray
+    Write-Host ""
+    exit 0
+} else {
+    exit 1
+}