@ornexus/neocortex 3.9.22 → 3.9.24

package/install.ps1

@@ -15,7 +15,7 @@ param(
     [string]$ServerUrl = "https://api.neocortex.ornexus.com"
 )
 
-$VERSION = "3.9.22"
+$VERSION = "3.9.24"
 
 # =============================================================================
 # CONFIGURACOES
@@ -388,6 +388,20 @@ function Invoke-AutoCleanupLegacy {
     # --- 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) {
@@ -586,6 +600,25 @@ function Set-ThinClientConfig {
         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")
+                        }
+                        $existingConfig | ConvertTo-Json -Depth 5 | Out-File -FilePath $configFile -Encoding utf8
+                        Write-Dbg "Config migrada para configVersion 1"
+                    } catch {
+                        Write-Dbg "Falha na migracao do config: $_"
+                    }
+                }
                 Write-Dbg "Config existente preservada (mode=$($existingConfig.mode))"
                 return
             }
@@ -593,15 +626,9 @@ function Set-ThinClientConfig {
     }
 
     $config = @{
-        version = $VERSION
+        configVersion = 1
         mode = "pending-activation"
         serverUrl = $NEOCORTEX_SERVER_URL
-        tier = 3
-        cache = @{
-            enabled = $true
-            directory = "$configDir\cache"
-            encryption = "AES-256-GCM"
-        }
         resilience = @{
             circuitBreaker = $true
             maxRetries = 3
@@ -656,13 +683,42 @@ function Install-Core {
         Set-ThinClientConfig
     }
 
-    # Write version file
+    # --- 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
-        if ($pkgJson.version) {
-            $pkgJson.version | Out-File -FilePath "$script:DestDir\.version" -Encoding utf8 -NoNewline
+        $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
+        $pkgVersion | Out-File -FilePath "$script:DestDir\.version" -Encoding utf8 -NoNewline
     }
 
     if ($LOCAL_MODE) {

package/install.sh

@@ -4,7 +4,7 @@
 # Development Orchestrator
 
 # Versao do instalador
-VERSION="3.9.22"
+VERSION="3.9.24"
 
 # Flags
 MIGRATION_DETECTED=false
@@ -415,6 +415,22 @@ auto_cleanup_legacy() {
     # ─── Categoria 7: Antigravity ─────────────────────────────────────────
     # Configs legadas de Antigravity sao gerenciadas pelo adapter, sem path fixo global
 
+    # ─── Categoria 8: Plaintext cache cleanup (Epic 62 - GAP 1) ─────────
+    local cache_dir="$HOME/.neocortex/cache"
+    if [ -d "$cache_dir" ]; then
+        # Remove plaintext menu-cache.json
+        _remove_legacy "$cache_dir/menu-cache.json" "cache plaintext (menu)"
+
+        # Remove any non-.enc files in cache dir (excluding directories)
+        for cache_file in "$cache_dir"/*; do
+            [ -f "$cache_file" ] || continue
+            case "$cache_file" in
+                *.enc) continue ;;  # Keep encrypted cache files
+                *) _remove_legacy "$cache_file" "cache plaintext" ;;
+            esac
+        done
+    fi
+
     # ─── Resultado ────────────────────────────────────────────────────────
     if [ $removed -gt 0 ]; then
         ok "$removed artefato(s) legado(s) removido(s) automaticamente"
@@ -579,6 +595,33 @@ setup_thin_client_config() {
         existing_mode=$(grep '"mode"' "$config_file" 2>/dev/null | head -1 | sed 's/.*"mode"[[:space:]]*:[[:space:]]*"\([^"]*\)".*/\1/')
 
         if [ "$existing_mode" = "active" ] || [ "$existing_mode" = "local" ] || [ "$existing_mode" = "remote" ]; then
+            # ─── Config schema migration (Epic 62 - GAP 4) ────────────────
+            # Check if config needs schema migration
+            local has_config_version
+            has_config_version=$(grep '"configVersion"' "$config_file" 2>/dev/null)
+            if [ -z "$has_config_version" ]; then
+                debug "Migrando schema do config.json (adicionando configVersion)"
+                if command -v node >/dev/null 2>&1; then
+                    node -e "
+const fs = require('fs');
+const path = '$config_file';
+try {
+    const cfg = JSON.parse(fs.readFileSync(path, 'utf-8'));
+    // Add configVersion
+    cfg.configVersion = 1;
+    // Remove known obsolete fields from old base template
+    delete cfg.version;
+    delete cfg.cache;
+    // Clean obsolete tier:3 from old base template (preserve real tier values)
+    if (cfg.tier === 3 && cfg.mode === 'pending-activation') {
+        delete cfg.tier;
+    }
+    fs.writeFileSync(path, JSON.stringify(cfg, null, 2) + '\n');
+}" 2>/dev/null
+                    chmod 600 "$config_file" 2>/dev/null
+                    debug "Config migrada para configVersion 1"
+                fi
+            fi
             # Story 61.4 - ensure permissions are always enforced even on existing configs
             chmod 600 "$config_file" 2>/dev/null
             debug "Config existente preservada (mode=$existing_mode)"
@@ -589,15 +632,9 @@ setup_thin_client_config() {
     # Criar config base para thin client
     cat > "$config_file" << EOFCONFIG
 {
-  "version": "${VERSION}",
+  "configVersion": 1,
   "mode": "pending-activation",
   "serverUrl": "${NEOCORTEX_SERVER_URL}",
-  "tier": 3,
-  "cache": {
-    "enabled": true,
-    "directory": "${config_dir}/cache",
-    "encryption": "AES-256-GCM"
-  },
   "resilience": {
     "circuitBreaker": true,
     "maxRetries": 3,
@@ -646,12 +683,45 @@ install_core() {
     # Thin-client ONLY: zero IP on client, all content from server
     setup_thin_client_config
 
-    # Write version file
+    # ─── Version-aware cache purge on upgrade (Epic 62 - GAP 2+3) ───────
     local pkg_version=""
     if [ -f "$SOURCE_DIR/package.json" ]; then
         pkg_version=$(grep '"version"' "$SOURCE_DIR/package.json" 2>/dev/null | head -1 | sed 's/.*"version"[[:space:]]*:[[:space:]]*"\([^"]*\)".*/\1/')
     fi
-    [ -n "$pkg_version" ] && echo "$pkg_version" > "$DEST_DIR/.version"
+
+    if [ -n "$pkg_version" ]; then
+        local old_version=""
+        # Read existing .version from either location
+        if [ -f "$DEST_DIR/.version" ]; then
+            old_version=$(cat "$DEST_DIR/.version" 2>/dev/null | tr -d '[:space:]')
+        elif [ -f "$HOME/.neocortex/.version" ]; then
+            old_version=$(cat "$HOME/.neocortex/.version" 2>/dev/null | tr -d '[:space:]')
+        fi
+
+        # If version changed, purge all cache files
+        if [ -n "$old_version" ] && [ "$old_version" != "$pkg_version" ]; then
+            local cache_dir="$HOME/.neocortex/cache"
+            if [ -d "$cache_dir" ]; then
+                local purged=0
+                # Remove all .enc files
+                for enc_file in "$cache_dir"/*.enc; do
+                    [ -f "$enc_file" ] || continue
+                    rm -f "$enc_file" 2>/dev/null && purged=$((purged + 1))
+                done
+                # Remove menu-cache.json (redundancy with 62.1)
+                [ -f "$cache_dir/menu-cache.json" ] && rm -f "$cache_dir/menu-cache.json" 2>/dev/null && purged=$((purged + 1))
+                # Remove any other non-directory files
+                for cache_file in "$cache_dir"/*; do
+                    [ -f "$cache_file" ] || continue
+                    rm -f "$cache_file" 2>/dev/null && purged=$((purged + 1))
+                done
+                [ $purged -gt 0 ] && info "Cache purgado: versao alterada de $old_version para $pkg_version ($purged arquivo(s))"
+            fi
+        fi
+
+        # Write version file
+        echo "$pkg_version" > "$DEST_DIR/.version"
+    fi
 
     if [ $errors -eq 0 ]; then
         ok "Core instalado ${DIM}(thin client configurado) [modo remoto]${NC}"

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ornexus/neocortex",
-  "version": "3.9.22",
-  "description": "Neocortex v3.9.22 - Orquestrador de Desenvolvimento de Epics & Stories para Claude Code",
+  "version": "3.9.24",
+  "description": "Neocortex v3.9.24 - Orquestrador de Desenvolvimento de Epics & Stories para Claude Code",
   "keywords": [
     "claude",
     "claude-code",
@@ -52,6 +52,7 @@
     "install.js",
     "install.sh",
     "install.ps1",
+    "postinstall.js",
     "packages/client/dist/",
     "!packages/client/dist/**/*.js.map",
     "!packages/client/dist/**/*.d.ts.map",
@@ -62,7 +63,7 @@
     "build:clean": "rm -rf packages/shared/dist packages/client/dist && npm run build",
     "build:client": "npm run build -w packages/client",
     "build:shared": "npm run build -w packages/shared",
-    "postinstall": "node -e \"console.log('\\nNeocortex instalado!\\n\\nUso:\\n  @neocortex @docs/stories/1.1.story.md\\n  @neocortex @epic-1\\n  @neocortex *status\\n')\"",
+    "postinstall": "node postinstall.js",
     "sync": "node sync-version.js",
     "validate": "bash scripts/validate-pre-publish.sh",
     "test:e2e": "bash scripts/e2e-smoke-test.sh",

package/packages/client/dist/agent/refresh-stubs.js

@@ -39,6 +39,26 @@ const STUB_TARGETS = [
         sourceDir: 'gemini-cli',
         files: ['agent.md'],
     },
+    {
+        destDir: join(homedir(), '.cursor', 'agents'),
+        sourceDir: 'cursor',
+        files: ['agent.md'],
+    },
+    {
+        destDir: join(homedir(), '.codex'),
+        sourceDir: 'codex',
+        files: ['agents.md'],
+    },
+    {
+        destDir: join(homedir(), '.vscode'),
+        sourceDir: 'vscode',
+        files: ['agent.md'],
+    },
+    {
+        destDir: join(homedir(), '.agent', 'skills', 'neocortex'),
+        sourceDir: 'antigravity',
+        files: ['skill/SKILL.md'],
+    },
 ];
 // -- Package Root Resolution --------------------------------------------------
 /**
@@ -127,7 +147,8 @@ export function refreshStubs(cliVersion) {
                     const src = join(sourceDir, file);
                     const dest = join(target.destDir, file);
                     if (existsSync(src)) {
-                        mkdirSync(target.destDir, { recursive: true });
+                        // Ensure parent directory exists (handles nested paths like skill/SKILL.md)
+                        mkdirSync(dirname(dest), { recursive: true });
                         copyFileSync(src, dest);
                         copiedAny = true;
                     }

package/packages/client/dist/commands/activate.js

@@ -118,7 +118,8 @@ function saveConfig(config) {
     }
     else {
         // Fallback: write without license key (should not happen in normal flow)
-        writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2) + '\n', 'utf-8');
+        const fallbackConfig = { configVersion: 1, ...config };
+        writeFileSync(CONFIG_FILE, JSON.stringify(fallbackConfig, null, 2) + '\n', 'utf-8');
     }
 }
 // ── Activate Command ──────────────────────────────────────────────────────

package/packages/client/dist/config/secure-config.js

@@ -33,6 +33,9 @@ import { getMachineFingerprint } from '../machine/fingerprint.js';
 // ── Constants ────────────────────────────────────────────────────────────
 const CONFIG_DIR = join(homedir(), '.neocortex');
 const CONFIG_FILE = join(CONFIG_DIR, 'config.json');
+// ── Types ────────────────────────────────────────────────────────────────
+/** Current config schema version (Epic 62 - FR8) */
+const CURRENT_CONFIG_VERSION = 1;
 // ── License Key Encryption ──────────────────────────────────────────────
 /**
  * Encrypt a license key using the machine fingerprint as passphrase.
@@ -114,6 +117,10 @@ export function loadSecureConfig() {
             const plainKey = migratedConfig.licenseKey;
             delete migratedConfig.licenseKey;
             migratedConfig.encryptedLicenseKey = encrypted;
+            // Ensure configVersion is preserved or added during migration
+            if (!migratedConfig.configVersion) {
+                migratedConfig.configVersion = CURRENT_CONFIG_VERSION;
+            }
             writeSecureConfig(migratedConfig);
             return {
                 serverUrl: config.serverUrl,
@@ -167,6 +174,7 @@ function writeSecureConfig(config) {
 export function saveSecureConfig(config) {
     const encrypted = encryptLicenseKey(config.licenseKey);
     const diskConfig = {
+        configVersion: CURRENT_CONFIG_VERSION,
         serverUrl: config.serverUrl,
         mode: config.mode,
         machineId: config.machineId,

package/postinstall.js

@@ -0,0 +1,102 @@
+#!/usr/bin/env node
+
+/**
+ * Neocortex - Postinstall Hook
+ *
+ * For global installs: auto-runs the installer in quiet/auto mode.
+ * For local installs: prints usage message.
+ *
+ * NEVER fails npm install -- always exits 0.
+ *
+ * Epic 62 - GAP 6
+ */
+
+const { spawn } = require('child_process');
+const path = require('path');
+const os = require('os');
+const fs = require('fs');
+
+function isGlobalInstall() {
+  // npm sets npm_config_global=true for global installs
+  if (process.env.npm_config_global === 'true') return true;
+  // Fallback: check if our location is in a global prefix
+  try {
+    const globalPrefix = process.env.npm_config_prefix || '';
+    if (globalPrefix && __dirname.startsWith(globalPrefix)) return true;
+  } catch { /* ignore */ }
+  return false;
+}
+
+function showUsageMessage() {
+  console.log('\nNeocortex instalado!\n');
+  console.log('Uso:');
+  console.log('  @neocortex @docs/stories/1.1.story.md');
+  console.log('  @neocortex @epic-1');
+  console.log('  @neocortex *status\n');
+}
+
+function runInstaller() {
+  const platform = os.platform();
+
+  if (platform === 'win32') {
+    // Windows: run install.ps1
+    const scriptPath = path.join(__dirname, 'install.ps1');
+    if (!fs.existsSync(scriptPath)) {
+      showUsageMessage();
+      return;
+    }
+
+    const shells = ['pwsh', 'powershell'];
+    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 });
+
+      child.on('error', () => tryShell(index + 1));
+      child.on('exit', () => { /* always succeed */ });
+    }
+    tryShell(0);
+  } else {
+    // Unix: run install.sh
+    const scriptPath = path.join(__dirname, 'install.sh');
+    if (!fs.existsSync(scriptPath)) {
+      showUsageMessage();
+      return;
+    }
+
+    try { fs.chmodSync(scriptPath, '755'); } catch { /* ignore */ }
+
+    const child = spawn('bash', [
+      scriptPath, '--yes', '--quiet', '--skip-project'
+    ], { stdio: 'inherit', shell: false });
+
+    child.on('error', () => {
+      // Fallback to sh
+      const shChild = spawn('sh', [
+        scriptPath, '--yes', '--quiet', '--skip-project'
+      ], { stdio: 'inherit', shell: false });
+      shChild.on('error', () => showUsageMessage());
+      shChild.on('exit', () => { /* always succeed */ });
+    });
+    child.on('exit', () => { /* always succeed */ });
+  }
+}
+
+try {
+  if (isGlobalInstall()) {
+    runInstaller();
+  } else {
+    showUsageMessage();
+  }
+} catch {
+  // NEVER fail npm install
+  showUsageMessage();
+}
+
+// Always exit 0
+process.on('exit', () => { process.exitCode = 0; });

package/targets-stubs/antigravity/gemini.md

@@ -1,4 +1,4 @@
-# 🧠 Neocortex v3.9.22 (Free) | OrNexus Team
+# 🧠 Neocortex v3.9.24 (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.22 (Free) | OrNexus Team"
+description: "🧠 Neocortex v3.9.24 (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.22'
+    version: '3.9.24'
     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.22 (Free) | OrNexus Team"
+description: "🧠 Neocortex v3.9.24 (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.22                            │
+│      ###  ########      v3.9.24                            │
 │ #########      #####                                       │
 │ ##    ##############    Development Orchestrator           │
 │ ##   ###  ######  ##    OrNexus Team (Free)                │

package/targets-stubs/codex/agents.md

@@ -1,4 +1,4 @@
-# 🧠 Neocortex v3.9.22 (Free) | OrNexus Team
+# 🧠 Neocortex v3.9.24 (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.22 (Free) | OrNexus Team"
+description: "🧠 Neocortex v3.9.24 (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.22                            │
+│      ###  ########      v3.9.24                            │
 │ #########      #####                                       │
 │ ##    ##############    Development Orchestrator           │
 │ ##   ###  ######  ##    OrNexus Team (Free)                │

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

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

package/targets-stubs/vscode/agent.md

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