@ornexus/neocortex 3.9.29 → 3.9.30

package/install.ps1

@@ -15,7 +15,7 @@ param(
     [string]$ServerUrl = "https://api.neocortex.ornexus.com"
 )
 
-$VERSION = "3.9.29"
+$VERSION = "3.9.30"
 
 # =============================================================================
 # CONFIGURACOES
@@ -197,8 +197,26 @@ function Copy-Silent {
     param([string]$Source, [string]$Destination)
     Write-Dbg "Copiando: $Source -> $Destination"
     if (Test-Path $Source -PathType Leaf) {
-        try { Copy-Item -Path $Source -Destination $Destination -Force; return $true }
-        catch { return $false }
+        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++
@@ -209,8 +227,14 @@ 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; return $true }
-        catch { return $false }
+        try {
+            Copy-Item -Path $Source -Destination $Destination -Recurse -Force -ErrorAction Stop
+            return $true
+        }
+        catch {
+            Write-Dbg "Copy-Item dir falhou: $_"
+            return $false
+        }
     }
     return $false
 }
@@ -230,6 +254,7 @@ function Get-SourceDirectory {
     if (-not (Test-Path "$script:SourceDir\targets-stubs\claude-code\neocortex.md") -and
         -not (Test-Path "$script:SourceDir\targets\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
@@ -241,6 +266,7 @@ function Get-SourceDirectory {
             "$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"
@@ -252,9 +278,17 @@ function Get-SourceDirectory {
                 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"
         }
     }
 }
@@ -697,18 +731,30 @@ function Install-Core {
 
     Write-Dbg "DEST=$script:DestDir"
 
-    # Create directories
+    # Create directories with verification (Epic 65)
     if (-not (Test-Path $script:ClaudeDir)) {
-        try { New-Item -ItemType Directory -Path $script:ClaudeDir -Force | Out-Null }
-        catch { Write-Fail "Falha ao criar $script:ClaudeDir"; return $false }
+        try { New-Item -ItemType Directory -Path $script:ClaudeDir -Force -ErrorAction Stop | Out-Null }
+        catch { Write-Fail "Falha ao criar $script:ClaudeDir`: $_"; return $false }
     }
-    New-Item -ItemType Directory -Path $script:AgentsDir -Force | Out-Null
+    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) {
-        Remove-Item -Path $script:DestDir -Recurse -Force -ErrorAction SilentlyContinue
+        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
     }
-    New-Item -ItemType Directory -Path $script:DestDir -Force | Out-Null
 
     if ($LOCAL_MODE) {
         # Modo local: copiar IP completa (comportamento legado para devs)
@@ -828,10 +874,20 @@ function Install-Agent {
     Write-Dbg "Install-Agent: SourceDir=$($script:SourceDir)"
     Write-Dbg "Install-Agent: DestDir=$($script:DestDir)"
     Write-Dbg "Install-Agent: claudeTargetDir=$claudeTargetDir"
-    Write-Dbg "Install-Agent: neocortex.md exists=$(Test-Path "$claudeTargetDir\neocortex.md")"
-    Write-Dbg "Install-Agent: neocortex.agent.yaml exists=$(Test-Path "$claudeTargetDir\neocortex.agent.yaml")"
+    $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 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
+    }
 
-    # SEMPRE copiar os 3 arquivos de interface
     # 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\"
@@ -840,6 +896,19 @@ function Install-Agent {
     $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
@@ -864,7 +933,7 @@ function Install-Agent {
             }
         }
     }
-    # Tier 3 Remote Mode: apenas 3 arquivos de interface
+    # Tier 3 Remote Mode: apenas 2 arquivos de interface (stubs)
 
     return ($script:Errors -eq 0)
 }

package/install.sh

@@ -4,7 +4,7 @@
 # Development Orchestrator
 
 # Versao do instalador
-VERSION="3.9.29"
+VERSION="3.9.30"
 
 # Flags
 MIGRATION_DETECTED=false
@@ -553,25 +553,40 @@ detect_source_dir() {
         SCRIPT_DIR="$PWD"
     fi
 
-    if [ ! -f "$SCRIPT_DIR/targets/claude-code/neocortex.md" ]; then
-        if [ ! -f "$SCRIPT_DIR/neocortex.md" ]; then
-            for possible_dir in \
-                "$SCRIPT_DIR" \
-                "$(npm root -g 2>/dev/null)/neocortex" \
-                "$(dirname "$0")" \
-                "$PWD/node_modules/neocortex" \
-                "$HOME/.npm/_npx/"*"/node_modules/neocortex"; do
-                if [ -f "$possible_dir/targets/claude-code/neocortex.md" ] 2>/dev/null || \
-                   [ -f "$possible_dir/neocortex.md" ] 2>/dev/null; then
-                    SCRIPT_DIR="$possible_dir"
-                    break
-                fi
-            done
-        fi
+    local source_found=false
+    if [ -f "$SCRIPT_DIR/targets-stubs/claude-code/neocortex.md" ] || \
+       [ -f "$SCRIPT_DIR/targets/claude-code/neocortex.md" ] || \
+       [ -f "$SCRIPT_DIR/neocortex.md" ]; then
+        source_found=true
+    else
+        for possible_dir in \
+            "$SCRIPT_DIR" \
+            "$(npm root -g 2>/dev/null)/@ornexus/neocortex" \
+            "$(npm root -g 2>/dev/null)/neocortex" \
+            "$(dirname "$0")" \
+            "$PWD/node_modules/@ornexus/neocortex" \
+            "$PWD/node_modules/neocortex" \
+            "$HOME/.npm/_npx/"*"/node_modules/@ornexus/neocortex" \
+            "$HOME/.npm/_npx/"*"/node_modules/neocortex"; do
+            if [ -f "$possible_dir/targets-stubs/claude-code/neocortex.md" ] 2>/dev/null || \
+               [ -f "$possible_dir/targets/claude-code/neocortex.md" ] 2>/dev/null || \
+               [ -f "$possible_dir/neocortex.md" ] 2>/dev/null; then
+                SCRIPT_DIR="$possible_dir"
+                source_found=true
+                break
+            fi
+        done
     fi
 
     SOURCE_DIR="$SCRIPT_DIR"
     debug "Source: $SOURCE_DIR"
+
+    # Epic 65: Emit visible warning when stubs cannot be found
+    if [ "$source_found" = false ]; then
+        warn "Arquivos de instalacao (stubs) nao encontrados em nenhum path conhecido"
+        warn "SCRIPT_DIR: $SCRIPT_DIR"
+        warn "Tente reinstalar: npm install -g @ornexus/neocortex"
+    fi
 }
 
 # =============================================================================
@@ -784,10 +799,28 @@ install_agent() {
         CLAUDE_TARGET_DIR="$SOURCE_DIR"
     fi
 
+    # Epic 65: Early validation — if neither source file exists, emit clear error
+    if [ ! -f "$CLAUDE_TARGET_DIR/neocortex.md" ] && [ ! -f "$CLAUDE_TARGET_DIR/neocortex.agent.yaml" ]; then
+        fail "Arquivos fonte nao encontrados em: $CLAUDE_TARGET_DIR"
+        fail "Diretorio de origem ($SOURCE_DIR) pode estar incompleto"
+        fail "Tente reinstalar: npm install -g @ornexus/neocortex"
+        return 2
+    fi
+
     # Tier 3 Stub-Only: copiar apenas 2 arquivos de interface (stubs minimos)
     copy_file "$CLAUDE_TARGET_DIR/neocortex.md" "$DEST_DIR/" || ((errors++))
     copy_file "$CLAUDE_TARGET_DIR/neocortex.agent.yaml" "$DEST_DIR/" || ((errors++))
 
+    # Epic 65: Post-copy verification
+    if [ ! -f "$DEST_DIR/neocortex.md" ]; then
+        fail "neocortex.md nao encontrado no destino apos copia: $DEST_DIR/"
+        ((errors++))
+    fi
+    if [ ! -f "$DEST_DIR/neocortex.agent.yaml" ]; then
+        fail "neocortex.agent.yaml nao encontrado no destino apos copia: $DEST_DIR/"
+        ((errors++))
+    fi
+
     # Dynamic description: patch tier from existing config (if activated)
     patch_description_tier "$DEST_DIR/neocortex.md"
     patch_description_tier "$DEST_DIR/neocortex.agent.yaml"

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ornexus/neocortex",
-  "version": "3.9.29",
-  "description": "Neocortex v3.9.29 - Orquestrador de Desenvolvimento de Epics & Stories para Claude Code",
+  "version": "3.9.30",
+  "description": "Neocortex v3.9.30 - Orquestrador de Desenvolvimento de Epics & Stories para Claude Code",
   "keywords": [
     "claude",
     "claude-code",

package/postinstall.js

@@ -90,7 +90,9 @@ function runInstaller() {
 
     function tryShell(index) {
       if (index >= shells.length) {
-        showUsageMessage();
+        // Epic 65: Don't show "Neocortex instalado!" when no shell was found
+        console.error('\n[!] PowerShell nao encontrado (pwsh ou powershell).');
+        console.error('    Instale manualmente: npx @ornexus/neocortex\n');
         return;
       }
       const child = spawn(shells[index], [...baseFlags, ...quietFlags], {

package/targets-stubs/antigravity/gemini.md

@@ -1,4 +1,4 @@
-# 🧠 Neocortex v3.9.29 (Free) | OrNexus Team
+# 🧠 Neocortex v3.9.30 (Free) | OrNexus Team
 
 This project uses Neocortex, a Development Orchestrator (Free).
 

package/targets-stubs/antigravity/skill/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: neocortex
-description: "🧠 Neocortex v3.9.29 (Free) | OrNexus Team"
+description: "🧠 Neocortex v3.9.30 (Free) | OrNexus Team"
 ---
 
 # Neocortex - Thin Client Interface

package/targets-stubs/claude-code/neocortex.agent.yaml

@@ -4,7 +4,7 @@ agent:
     name: 'Neocortex'
     title: 'Development Orchestrator (Free)'
     icon: '>'
-    version: '3.9.29'
+    version: '3.9.30'
     architecture: 'thin-client'
     module: stand-alone
     hasSidecar: false

package/targets-stubs/claude-code/neocortex.md

@@ -1,6 +1,6 @@
 ---
 name: neocortex
-description: "🧠 Neocortex v3.9.29 (Free) | OrNexus Team"
+description: "🧠 Neocortex v3.9.30 (Free) | OrNexus Team"
 model: opus
 color: blue
 tools:
@@ -56,7 +56,7 @@ SEMPRE que este agente for invocado, imprima o banner abaixo como PRIMEIRO outpu
 ┌────────────────────────────────────────────────────────────┐
 │                                                            │
 │       #######           N E O C O R T E X                  │
-│      ###  ########      v3.9.29                            │
+│      ###  ########      v3.9.30                            │
 │ #########      #####                                       │
 │ ##    ##############    Development Orchestrator           │
 │ ##   ###  ######  ##    OrNexus Team (Free)                │

package/targets-stubs/codex/agents.md

@@ -1,4 +1,4 @@
-# 🧠 Neocortex v3.9.29 (Free) | OrNexus Team
+# 🧠 Neocortex v3.9.30 (Free) | OrNexus Team
 
 You are a Development Orchestrator (Free). All orchestration logic is delivered by the remote Neocortex server.
 

package/targets-stubs/cursor/agent.md

@@ -1,6 +1,6 @@
 ---
 name: neocortex
-description: "🧠 Neocortex v3.9.29 (Free) | OrNexus Team"
+description: "🧠 Neocortex v3.9.30 (Free) | OrNexus Team"
 model: fast
 readonly: false
 is_background: false
@@ -18,7 +18,7 @@ SEMPRE que este agente for invocado, imprima o banner abaixo como PRIMEIRO outpu
 ┌────────────────────────────────────────────────────────────┐
 │                                                            │
 │       #######           N E O C O R T E X                  │
-│      ###  ########      v3.9.29                            │
+│      ###  ########      v3.9.30                            │
 │ #########      #####                                       │
 │ ##    ##############    Development Orchestrator           │
 │ ##   ###  ######  ##    OrNexus Team (Free)                │

package/targets-stubs/gemini-cli/agent.md

@@ -1,6 +1,6 @@
 ---
 name: neocortex
-description: "🧠 Neocortex v3.9.29 (Free) | OrNexus Team"
+description: "🧠 Neocortex v3.9.30 (Free) | OrNexus Team"
 kind: local
 tools:
   - read_file
@@ -25,7 +25,7 @@ SEMPRE que este agente for invocado, imprima o banner abaixo como PRIMEIRO outpu
 ┌────────────────────────────────────────────────────────────┐
 │                                                            │
 │       #######           N E O C O R T E X                  │
-│      ###  ########      v3.9.29                            │
+│      ###  ########      v3.9.30                            │
 │ #########      #####                                       │
 │ ##    ##############    Development Orchestrator           │
 │ ##   ###  ######  ##    OrNexus Team (Free)                │

package/targets-stubs/vscode/agent.md

@@ -1,6 +1,6 @@
 ---
 name: "neocortex"
-description: "🧠 Neocortex v3.9.29 (Free) | OrNexus Team"
+description: "🧠 Neocortex v3.9.30 (Free) | OrNexus Team"
 tools:
   - readFile
   - editFiles
@@ -26,7 +26,7 @@ SEMPRE que este agente for invocado, imprima o banner abaixo como PRIMEIRO outpu
 ┌────────────────────────────────────────────────────────────┐
 │                                                            │
 │       #######           N E O C O R T E X                  │
-│      ###  ########      v3.9.29                            │
+│      ###  ########      v3.9.30                            │
 │ #########      #####                                       │
 │ ##    ##############    Development Orchestrator           │
 │ ##   ###  ######  ##    OrNexus Team (Free)                │