@ornexus/neocortex 3.9.28 → 3.9.30

package/install.ps1

@@ -15,7 +15,7 @@ param(
     [string]$ServerUrl = "https://api.neocortex.ornexus.com"
 )
 
-$VERSION = "3.9.28"
+$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,16 +266,29 @@ 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"
             $expandedDirs = Get-Item $dir -ErrorAction SilentlyContinue
             foreach ($expanded in $expandedDirs) {
-                if ((Test-Path "$($expanded.FullName)\targets-stubs\claude-code\neocortex.md") -or
+                $found = (Test-Path "$($expanded.FullName)\targets-stubs\claude-code\neocortex.md") -or
                     (Test-Path "$($expanded.FullName)\targets\claude-code\neocortex.md") -or
-                    (Test-Path "$($expanded.FullName)\neocortex.md")) {
+                    (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"
         }
     }
 }
@@ -502,6 +540,10 @@ function Verify-Installation {
     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)" }
@@ -591,7 +633,16 @@ function Verify-Installation {
         return $true
     }
 
-    if ($QUIET_MODE -and $fails -eq 0) {
+    # 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
     }
 
@@ -680,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)
@@ -699,8 +762,10 @@ function Install-Core {
         if (Test-Path $coreSource -PathType Container) {
             Copy-Item -Path $coreSource -Destination "$script:DestDir\" -Recurse -Force -ErrorAction SilentlyContinue
         }
-        Copy-Silent "$($script:SourceDir)\package.json" "$script:DestDir\" | Out-Null
-        Copy-Silent "$($script:SourceDir)\README.md" "$script:DestDir\" | Out-Null
+        $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
@@ -805,10 +870,45 @@ function Install-Agent {
         $claudeTargetDir = $script:SourceDir
     }
 
-    # SEMPRE copiar os 3 arquivos de interface
+    # 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 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
-    Copy-Silent "$claudeTargetDir\neocortex.md" "$script:DestDir\" | Out-Null
-    Copy-Silent "$claudeTargetDir\neocortex.agent.yaml" "$script:DestDir\" | Out-Null
+    # 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
@@ -816,8 +916,10 @@ function Install-Agent {
 
     if ($LOCAL_MODE) {
         # Modo local: copiar IP completa (comportamento legado para devs)
-        Copy-Silent "$($script:SourceDir)\package.json" "$script:DestDir\" | Out-Null
-        Copy-Silent "$($script:SourceDir)\README.md" "$script:DestDir\" | Out-Null
+        $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) {
@@ -831,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)
 }
@@ -1296,8 +1398,11 @@ function New-ProjectDirectories {
 
                     # SEMPRE copiar os 3 arquivos de interface
                     # Tier 3: Copy only 2 stub files
-                    Copy-Silent "$claudeTargetDir\neocortex.md" "$agentDest\" | Out-Null
-                    Copy-Silent "$claudeTargetDir\neocortex.agent.yaml" "$agentDest\" | Out-Null
+                    # 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
@@ -1305,8 +1410,10 @@ function New-ProjectDirectories {
 
                     if ($LOCAL_MODE) {
                         # Modo local: copiar IP completa (comportamento legado)
-                        Copy-Silent "$($script:SourceDir)\package.json" "$agentDest\" | Out-Null
-                        Copy-Silent "$($script:SourceDir)\README.md" "$agentDest\" | Out-Null
+                        $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")) {

package/install.sh

@@ -4,7 +4,7 @@
 # Development Orchestrator
 
 # Versao do instalador
-VERSION="3.9.28"
+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.28",
-  "description": "Neocortex v3.9.28 - 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

@@ -35,9 +35,20 @@ function showUsageMessage() {
   console.log('  @neocortex *status\n');
 }
 
+function showErrorMessage() {
+  console.error('\n[x] Instalacao do Neocortex falhou.\n');
+  console.error('Troubleshooting:');
+  console.error('  1. Execute manualmente: npx @ornexus/neocortex -Debug');
+  console.error('  2. Verifique permissoes no diretorio ~/.claude/');
+  console.error('  3. Reporte em: https://github.com/OrNexus-AI/neocortex/issues\n');
+}
+
 function runInstaller() {
   const platform = os.platform();
 
+  // Epic 64: Check NEOCORTEX_DEBUG env var for debug mode
+  const debugMode = process.env.NEOCORTEX_DEBUG === '1';
+
   if (platform === 'win32') {
     // Windows: run install.ps1
     const scriptPath = path.join(__dirname, 'install.ps1');
@@ -46,19 +57,56 @@ function runInstaller() {
       return;
     }
 
+    const baseFlags = ['-NoProfile', '-ExecutionPolicy', 'Bypass', '-File', scriptPath];
+    const quietFlags = ['-Yes', '-Quiet', '-SkipProject'];
+    const retryFlags = ['-Yes', '-SkipProject'];
+    if (debugMode) {
+      quietFlags.push('-Debug');
+      retryFlags.push('-Debug');
+    }
+
     const shells = ['pwsh', 'powershell'];
+    let hasRetried = false;
+
+    function retryWithoutQuiet(shellCmd) {
+      if (hasRetried) {
+        showErrorMessage();
+        return;
+      }
+      hasRetried = true;
+      console.log('\nInstalacao falhou. Re-executando com output detalhado...\n');
+      const retryChild = spawn(shellCmd, [...baseFlags, ...retryFlags], {
+        stdio: 'inherit', shell: false, timeout: 60000
+      });
+      retryChild.on('error', () => showErrorMessage());
+      retryChild.on('exit', (retryCode) => {
+        if (retryCode === 0) {
+          showUsageMessage();
+        } else {
+          showErrorMessage();
+        }
+      });
+    }
+
     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], [
-        '-NoProfile', '-ExecutionPolicy', 'Bypass', '-File', scriptPath,
-        '-Yes', '-Quiet', '-SkipProject'
-      ], { stdio: 'inherit', shell: false });
+      const child = spawn(shells[index], [...baseFlags, ...quietFlags], {
+        stdio: 'inherit', shell: false
+      });
 
       child.on('error', () => tryShell(index + 1));
-      child.on('exit', () => { /* always succeed */ });
+      child.on('exit', (code) => {
+        if (code === 0) {
+          showUsageMessage();
+        } else {
+          retryWithoutQuiet(shells[index]);
+        }
+      });
     }
     tryShell(0);
   } else {
@@ -71,19 +119,55 @@ function runInstaller() {
 
     try { fs.chmodSync(scriptPath, '755'); } catch { /* ignore */ }
 
-    const child = spawn('bash', [
-      scriptPath, '--yes', '--quiet', '--skip-project'
-    ], { stdio: 'inherit', shell: false });
+    const quietArgs = [scriptPath, '--yes', '--quiet', '--skip-project'];
+    const retryArgs = [scriptPath, '--yes', '--skip-project'];
+    if (debugMode) {
+      quietArgs.push('--debug');
+      retryArgs.push('--debug');
+    }
+    let hasRetried = false;
+
+    function retryUnixWithoutQuiet(shellCmd) {
+      if (hasRetried) {
+        showErrorMessage();
+        return;
+      }
+      hasRetried = true;
+      console.log('\nInstalacao falhou. Re-executando com output detalhado...\n');
+      const retryChild = spawn(shellCmd, retryArgs, {
+        stdio: 'inherit', shell: false, timeout: 60000
+      });
+      retryChild.on('error', () => showErrorMessage());
+      retryChild.on('exit', (retryCode) => {
+        if (retryCode === 0) {
+          showUsageMessage();
+        } else {
+          showErrorMessage();
+        }
+      });
+    }
+
+    const child = spawn('bash', quietArgs, { stdio: 'inherit', shell: false });
 
     child.on('error', () => {
       // Fallback to sh
-      const shChild = spawn('sh', [
-        scriptPath, '--yes', '--quiet', '--skip-project'
-      ], { stdio: 'inherit', shell: false });
+      const shChild = spawn('sh', quietArgs, { stdio: 'inherit', shell: false });
       shChild.on('error', () => showUsageMessage());
-      shChild.on('exit', () => { /* always succeed */ });
+      shChild.on('exit', (code) => {
+        if (code === 0) {
+          showUsageMessage();
+        } else {
+          retryUnixWithoutQuiet('sh');
+        }
+      });
+    });
+    child.on('exit', (code) => {
+      if (code === 0) {
+        showUsageMessage();
+      } else {
+        retryUnixWithoutQuiet('bash');
+      }
     });
-    child.on('exit', () => { /* always succeed */ });
   }
 }
 

package/targets-stubs/antigravity/gemini.md

@@ -1,4 +1,4 @@
-# 🧠 Neocortex v3.9.28 (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.28 (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.28'
+    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.28 (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.28                            │
+│      ###  ########      v3.9.30                            │
 │ #########      #####                                       │
 │ ##    ##############    Development Orchestrator           │
 │ ##   ###  ######  ##    OrNexus Team (Free)                │

package/targets-stubs/codex/agents.md

@@ -1,4 +1,4 @@
-# 🧠 Neocortex v3.9.28 (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.28 (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.28                            │
+│      ###  ########      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.28 (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.28                            │
+│      ###  ########      v3.9.30                            │
 │ #########      #####                                       │
 │ ##    ##############    Development Orchestrator           │
 │ ##   ###  ######  ##    OrNexus Team (Free)                │

package/targets-stubs/vscode/agent.md

@@ -1,6 +1,6 @@
 ---
 name: "neocortex"
-description: "🧠 Neocortex v3.9.28 (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.28                            │
+│      ###  ########      v3.9.30                            │
 │ #########      #####                                       │
 │ ##    ##############    Development Orchestrator           │
 │ ##   ###  ######  ##    OrNexus Team (Free)                │