@ornexus/neocortex 4.0.1 → 4.0.2

package/targets-stubs/cursor/install-cursor.sh

@@ -2,6 +2,55 @@
 # Neocortex - Cursor IDE Install Adapter (Thin Client)
 # Simplified installer for npm tarball mode (targets-stubs only)
 
+# Additive JSON merge for MCP config. Preserves user-defined servers.
+# Uses jq (preferred) or python3 (fallback). On total failure, only creates
+# the file if it does not exist (never overwrites).
+_merge_cursor_mcp() {
+    local stub_file="$1"
+    local dest_file="$2"
+
+    if [ ! -f "$dest_file" ]; then
+        cp "$stub_file" "$dest_file"
+        echo "[CURSOR] Created MCP config: $dest_file"
+        return 0
+    fi
+
+    if command -v jq >/dev/null 2>&1; then
+        local tmp="${dest_file}.neocortex.tmp"
+        if jq -s '.[0] * .[1]' "$dest_file" "$stub_file" > "$tmp" 2>/dev/null; then
+            mv "$tmp" "$dest_file"
+            echo "[CURSOR] Merged MCP config into: $dest_file (via jq)"
+            return 0
+        fi
+        rm -f "$tmp"
+    fi
+
+    if command -v python3 >/dev/null 2>&1; then
+        if python3 - "$dest_file" "$stub_file" <<'PYEOF' 2>/dev/null
+import json, sys
+dest_path, stub_path = sys.argv[1], sys.argv[2]
+with open(dest_path) as f:
+    dest = json.load(f)
+with open(stub_path) as f:
+    stub = json.load(f)
+dest.setdefault('mcpServers', {})
+for k, v in stub.get('mcpServers', {}).items():
+    dest['mcpServers'][k] = v
+with open(dest_path, 'w') as f:
+    json.dump(dest, f, indent=2)
+    f.write('\n')
+PYEOF
+        then
+            echo "[CURSOR] Merged MCP config into: $dest_file (via python3)"
+            return 0
+        fi
+    fi
+
+    echo "[CURSOR] WARN: jq and python3 not found; leaving existing $dest_file untouched"
+    echo "[CURSOR] WARN: Stub available at: $stub_file"
+    return 0
+}
+
 install_cursor() {
     local source_dir="${1:?SOURCE_DIR required}"
     local dest_dir="${2:?DEST_DIR required}"
@@ -23,10 +72,9 @@ install_cursor() {
         echo "[CURSOR] Installed agent stub: .cursor/agents/neocortex.md"
     fi
 
-    # 2. Copy MCP config
+    # 2. Additive merge MCP config (preserves user-configured servers)
     if [ -f "$cursor_target/mcp.json" ]; then
-        cp "$cursor_target/mcp.json" "$dest_dir/.cursor/mcp.json"
-        echo "[CURSOR] Installed MCP config: .cursor/mcp.json"
+        _merge_cursor_mcp "$cursor_target/mcp.json" "$dest_dir/.cursor/mcp.json" || true
     fi
 
     echo "[CURSOR] Thin-client installation complete!"

package/targets-stubs/cursor/mcp.json

@@ -6,6 +6,13 @@
     },
     "context7": {
       "url": "https://mcp.context7.com/mcp"
+    },
+    "browser_use": {
+      "command": "npx",
+      "args": ["-y", "browser-use-mcp"],
+      "env": {
+        "BROWSER_USE_API_KEY": "${BROWSER_USE_API_KEY}"
+      }
     }
   }
 }

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

@@ -1,13 +1,23 @@
 ---
 name: neocortex
-description: "🧠 Neocortex v4.0.1 | OrNexus Team"
+description: "🧠 Neocortex v4.0.2 | OrNexus Team"
 kind: local
 tools:
+  # File operations (Gemini CLI built-ins)
   - read_file
   - write_file
   - replace
+  - list_directory
+  - glob
+  - grep_search
+  # Shell access
   - run_shell_command
-  - search_file_content
+  # Web research (Gemini CLI built-ins)
+  - google_web_search
+  - web_fetch
+  # MCP tools (wildcards grant access to all tools from each connected server)
+  - mcp_context7_*
+  - mcp_playwright_*
 model: gemini-2.5-pro
 max_turns: 50
 timeout_mins: 30
@@ -43,7 +53,7 @@ SEMPRE que este agente for invocado, imprima o banner abaixo como PRIMEIRO outpu
 ┌────────────────────────────────────────────────────────────┐
 │                                                            │
 │       #######           N E O C O R T E X                  │
-│      ###  ########      v4.0.1                             │
+│      ###  ########      v4.0.2                             │
 │ #########      #####                                       │
 │ ##    ##############    Development Orchestrator           │
 │ ##   ###  ######  ##    OrNexus Team                       │
@@ -95,7 +105,28 @@ neocortex-client invoke \
 
 ## Regras
 
-- NUNCA invente logica de orquestracao - toda logica vem do server
-- NUNCA pule o thin client - sempre execute o invoke
-- SEMPRE siga as instrucoes retornadas literalmente
+### Orquestracao (triggers `*xxx`)
+- NUNCA invente logica de orquestracao - toda logica de pipeline/step/workflow vem do server
+- NUNCA pule o thin client para argumentos prefixados com `*` - sempre execute `neocortex-client invoke`
+- SEMPRE siga as instrucoes retornadas pelo server literalmente
 - Se o thin client falhar, mostre o erro e aguarde input do usuario
+
+### Pesquisa livre / analise (sem prefixo `*`)
+Quando o usuario pedir pesquisa, analise, brainstorm, validacao de hipotese, ou qualquer
+tarefa free-form que NAO seja um trigger de orquestracao, voce TEM permissao para usar
+diretamente as tools do Gemini CLI:
+
+- **`google_web_search` / `web_fetch`** - pesquisa de mercado, validacao de hipoteses,
+  references reais (docs, blogs, repos)
+- **`read_file` / `write_file` / `replace` / `list_directory` / `glob` / `grep_search`** -
+  exploracao e manipulacao do projeto local
+- **`run_shell_command`** - qualquer ferramenta CLI (jq, curl, psql, docker, fly, gh, etc.)
+- **`browser_agent`** (built-in subagent do Gemini CLI) - navegacao/screenshot/scraping
+  via chrome-devtools-mcp, se habilitado em `~/.gemini/settings.json`
+- **MCP servers configurados** (`mcp_context7_*`, `mcp_playwright_*`) - documentacao
+  atualizada de libs/frameworks, browser automation para visual research
+
+NUNCA recuse uma pesquisa por falta de tools. NUNCA fabrique fontes - se nao encontrar
+dados reais, diga isso explicitamente. Quando a pesquisa resultar em decisoes que
+precisem virar epic/stories, ai sim invoque `neocortex-client invoke --args "*create-epic ..."`
+para entrar no fluxo de orquestracao.

package/targets-stubs/gemini-cli/install-gemini.sh

@@ -2,6 +2,54 @@
 # Neocortex - Gemini CLI Install Adapter (Thin Client)
 # Simplified installer for npm tarball mode (targets-stubs only)
 
+# Additive JSON merge for Gemini CLI settings.json (root key: mcpServers).
+# Preserves user-defined servers and any other settings present.
+_merge_gemini_mcp() {
+    local stub_file="$1"
+    local dest_file="$2"
+
+    if [ ! -f "$dest_file" ]; then
+        cp "$stub_file" "$dest_file"
+        echo "[GEMINI] Created settings: $dest_file"
+        return 0
+    fi
+
+    if command -v jq >/dev/null 2>&1; then
+        local tmp="${dest_file}.neocortex.tmp"
+        if jq -s '.[0] * .[1]' "$dest_file" "$stub_file" > "$tmp" 2>/dev/null; then
+            mv "$tmp" "$dest_file"
+            echo "[GEMINI] Merged MCP config into: $dest_file (via jq)"
+            return 0
+        fi
+        rm -f "$tmp"
+    fi
+
+    if command -v python3 >/dev/null 2>&1; then
+        if python3 - "$dest_file" "$stub_file" <<'PYEOF' 2>/dev/null
+import json, sys
+dest_path, stub_path = sys.argv[1], sys.argv[2]
+with open(dest_path) as f:
+    dest = json.load(f)
+with open(stub_path) as f:
+    stub = json.load(f)
+dest.setdefault('mcpServers', {})
+for k, v in stub.get('mcpServers', {}).items():
+    dest['mcpServers'][k] = v
+with open(dest_path, 'w') as f:
+    json.dump(dest, f, indent=2)
+    f.write('\n')
+PYEOF
+        then
+            echo "[GEMINI] Merged MCP config into: $dest_file (via python3)"
+            return 0
+        fi
+    fi
+
+    echo "[GEMINI] WARN: jq and python3 not found; leaving existing $dest_file untouched"
+    echo "[GEMINI] WARN: Stub available at: $stub_file"
+    return 0
+}
+
 install_gemini() {
     local source_dir="${1:?SOURCE_DIR required}"
     local dest_dir="${2:?DEST_DIR required}"
@@ -30,24 +78,9 @@ install_gemini() {
         echo "[GEMINI] Installed: GEMINI.md (project root)"
     fi
 
-    # 3. Merge MCP config into settings.json
+    # 3. Additive merge MCP config into settings.json
     if [ -f "$gemini_target/settings-mcp.json" ]; then
-        local settings_file="$gemini_home/settings.json"
-        if [ -f "$settings_file" ]; then
-            if command -v jq >/dev/null 2>&1; then
-                local mcp_fragment
-                mcp_fragment=$(cat "$gemini_target/settings-mcp.json")
-                jq --argjson mcp "$mcp_fragment" '. * $mcp' "$settings_file" > "${settings_file}.tmp"
-                mv "${settings_file}.tmp" "$settings_file"
-                echo "[GEMINI] Merged MCP config into ~/.gemini/settings.json"
-            else
-                cp "$gemini_target/settings-mcp.json" "$gemini_home/settings-mcp.json"
-                echo "[GEMINI] WARN: jq not found - copy settings-mcp.json manually"
-            fi
-        else
-            cp "$gemini_target/settings-mcp.json" "$settings_file"
-            echo "[GEMINI] Created ~/.gemini/settings.json with MCP config"
-        fi
+        _merge_gemini_mcp "$gemini_target/settings-mcp.json" "$gemini_home/settings.json" || true
     fi
 
     echo "[GEMINI] Thin-client installation complete!"

package/targets-stubs/vscode/agent.md

@@ -1,12 +1,24 @@
 ---
 name: "neocortex"
-description: "🧠 Neocortex v4.0.1 | OrNexus Team"
+description: "🧠 Neocortex v4.0.2 | OrNexus Team"
 tools:
-  - readFile
-  - editFiles
-  - textSearch
-  - runInTerminal
-  - codebase
+  # Read / Edit (built-in tool sets)
+  - read
+  - edit
+  # Search codebase, files, usages
+  - search
+  # Execute commands in terminal
+  - execute
+  # Web fetch + search
+  - web
+  # Delegate to subagents
+  - agent
+  # Todo tracking
+  - todos
+  # MCP servers (wildcards grant access to all tools from each connected server)
+  - context7/*
+  - playwright/*
+  - browser_use/*
 agents:
   - "*"
 model:
@@ -44,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                  │
-│      ###  ########      v4.0.1                             │
+│      ###  ########      v4.0.2                             │
 │ #########      #####                                       │
 │ ##    ##############    Development Orchestrator           │
 │ ##   ###  ######  ##    OrNexus Team                       │
@@ -96,7 +108,32 @@ neocortex-client invoke \
 
 ## Regras
 
-- NUNCA invente logica de orquestracao - toda logica vem do server
-- NUNCA pule o thin client - sempre execute o invoke
-- SEMPRE siga as instrucoes retornadas literalmente
+### Orquestracao (triggers `*xxx`)
+- NUNCA invente logica de orquestracao - toda logica de pipeline/step/workflow vem do server
+- NUNCA pule o thin client para argumentos prefixados com `*` - sempre execute `neocortex-client invoke`
+- SEMPRE siga as instrucoes retornadas pelo server literalmente
 - Se o thin client falhar, mostre o erro e aguarde input do usuario
+
+### Pesquisa livre / analise (sem prefixo `*`)
+Quando o usuario pedir pesquisa, analise, brainstorm, validacao de hipotese, ou qualquer
+tarefa free-form que NAO seja um trigger de orquestracao, voce TEM permissao para usar
+diretamente as tools do VS Code / Copilot Chat:
+
+- **`search` tool set** (`search/codebase`, `search/fileSearch`, `search/textSearch`,
+  `search/usages`) - exploracao e analise do projeto local
+- **`read` tool set** (`read/readFile`, `read/problems`, `read/terminalLastCommand`) -
+  leitura de arquivos, problemas e output de terminal
+- **`web` tool set** (`web/fetch`) - pesquisa de mercado, validacao de hipoteses,
+  fetching de documentacao oficial
+- **`execute` tool set** (`execute/runInTerminal`, `execute/getTerminalOutput`) -
+  qualquer ferramenta CLI (jq, curl, psql, docker, fly, gh, etc.)
+- **`edit` tool set** (`edit/editFiles`, `edit/createFile`, `edit/createDirectory`) -
+  manipulacao direta do projeto quando solicitado
+- **`agent` tool set** - delegar trabalho a subagents especializados quando util
+- **MCP servers configurados** (`context7/*`, `playwright/*`, `browser_use/*`) -
+  documentacao atualizada, browser automation, visual research
+
+NUNCA recuse uma pesquisa por falta de tools. NUNCA fabrique fontes - se nao encontrar
+dados reais, diga isso explicitamente. Quando a pesquisa resultar em decisoes que
+precisem virar epic/stories, ai sim invoque `neocortex-client invoke --args "*create-epic ..."`
+para entrar no fluxo de orquestracao.

package/targets-stubs/vscode/install-vscode.sh

@@ -2,6 +2,54 @@
 # Neocortex - VSCode / GitHub Copilot Install Adapter (Thin Client)
 # Simplified installer for npm tarball mode (targets-stubs only)
 
+# Additive JSON merge for VSCode MCP config (uses "servers" key).
+# Preserves user-defined servers. Never overwrites silently.
+_merge_vscode_mcp() {
+    local stub_file="$1"
+    local dest_file="$2"
+
+    if [ ! -f "$dest_file" ]; then
+        cp "$stub_file" "$dest_file"
+        echo "[VSCODE] Created MCP config: $dest_file"
+        return 0
+    fi
+
+    if command -v jq >/dev/null 2>&1; then
+        local tmp="${dest_file}.neocortex.tmp"
+        if jq -s '.[0] * .[1]' "$dest_file" "$stub_file" > "$tmp" 2>/dev/null; then
+            mv "$tmp" "$dest_file"
+            echo "[VSCODE] Merged MCP config into: $dest_file (via jq)"
+            return 0
+        fi
+        rm -f "$tmp"
+    fi
+
+    if command -v python3 >/dev/null 2>&1; then
+        if python3 - "$dest_file" "$stub_file" <<'PYEOF' 2>/dev/null
+import json, sys
+dest_path, stub_path = sys.argv[1], sys.argv[2]
+with open(dest_path) as f:
+    dest = json.load(f)
+with open(stub_path) as f:
+    stub = json.load(f)
+dest.setdefault('servers', {})
+for k, v in stub.get('servers', {}).items():
+    dest['servers'][k] = v
+with open(dest_path, 'w') as f:
+    json.dump(dest, f, indent=2)
+    f.write('\n')
+PYEOF
+        then
+            echo "[VSCODE] Merged MCP config into: $dest_file (via python3)"
+            return 0
+        fi
+    fi
+
+    echo "[VSCODE] WARN: jq and python3 not found; leaving existing $dest_file untouched"
+    echo "[VSCODE] WARN: Stub available at: $stub_file"
+    return 0
+}
+
 install_vscode() {
     local source_dir="${1:?SOURCE_DIR required}"
     local dest_dir="${2:?DEST_DIR required}"
@@ -30,10 +78,9 @@ install_vscode() {
         echo "[VSCODE] Installed: .github/copilot-instructions.md"
     fi
 
-    # 3. Copy MCP config
+    # 3. Additive merge MCP config
     if [ -f "$vscode_target/mcp.json" ]; then
-        cp "$vscode_target/mcp.json" "$dest_dir/.vscode/mcp.json"
-        echo "[VSCODE] Installed MCP config: .vscode/mcp.json"
+        _merge_vscode_mcp "$vscode_target/mcp.json" "$dest_dir/.vscode/mcp.json" || true
     fi
 
     echo "[VSCODE] Thin-client installation complete!"

package/targets-stubs/vscode/mcp.json

@@ -8,6 +8,14 @@
     "context7": {
       "type": "http",
       "url": "https://mcp.context7.com/mcp"
+    },
+    "browser_use": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["-y", "browser-use-mcp"],
+      "env": {
+        "BROWSER_USE_API_KEY": "${env:BROWSER_USE_API_KEY}"
+      }
     }
   }
 }