@ornexus/neocortex 3.9.28 → 3.9.29

package/install.ps1

@@ -15,7 +15,7 @@ param(
     [string]$ServerUrl = "https://api.neocortex.ornexus.com"
 )
 
-$VERSION = "3.9.28"
+$VERSION = "3.9.29"
 
 # =============================================================================
 # CONFIGURACOES
@@ -242,11 +242,15 @@ function Get-SourceDirectory {
             ".\node_modules\neocortex"
         )
         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
                     break
                 }
@@ -502,6 +506,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 +599,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
     }
 
@@ -699,8 +716,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 +824,22 @@ function Install-Agent {
         $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"
+    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")"
+
     # SEMPRE copiar os 3 arquivos de interface
     # 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"
     # Cleanup workflow.md from previous versions
     if (Test-Path "$script:DestDir\workflow.md") {
         Remove-Item "$script:DestDir\workflow.md" -Force -ErrorAction SilentlyContinue
@@ -816,8 +847,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) {
@@ -1296,8 +1329,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 +1341,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.29"
 
 # Flags
 MIGRATION_DETECTED=false

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.29",
+  "description": "Neocortex v3.9.29 - 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,54 @@ 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();
         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 +117,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.29 (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.29 (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.29'
     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.29 (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.29                            │
 │ #########      #####                                       │
 │ ##    ##############    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.29 (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.29 (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.29                            │
 │ #########      #####                                       │
 │ ##    ##############    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.29 (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.29                            │
 │ #########      #####                                       │
 │ ##    ##############    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.29 (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.29                            │
 │ #########      #####                                       │
 │ ##    ##############    Development Orchestrator           │
 │ ##   ###  ######  ##    OrNexus Team (Free)                │