@ornexus/neocortex 3.9.2 → 3.9.4

package/install.js

@@ -107,8 +107,7 @@ const FLAG_MAP_WIN32 = {
     '--help': '-Help',
     // Remove legacy artifacts from ~/.claude/
     '--cleanup-legacy': '-CleanupLegacy',
-    // Local mode (copy IP for development)
-    '--local': '-Local',
+    // --local removed (Epic 50): thin-client mandatory, zero IP on client
     // Server URL override
     // --server-url=<url> is passed through as-is (handled by shell scripts)
 };
@@ -214,7 +213,7 @@ function showHelp() {
     console.log(`    ${color.cyan('-s, --skip-project')}        Nao perguntar sobre projeto`);
     console.log(`    ${color.cyan('-q, --quiet')}               Modo silencioso`);
     console.log(`    ${color.cyan('--cleanup-legacy')}          Remover artefatos legados de ~/.claude/`);
-    console.log(`    ${color.cyan('--local')}                   Modo local (copia IP para desenvolvimento)`);
+    console.log(`    ${color.dim('--local')}                   ${color.dim('(Removido) Thin-client obrigatorio')}`);
     console.log(`    ${color.cyan('--server-url=<url>')}        URL do server Neocortex`);
     console.log(`    ${color.cyan('-d, --debug')}               Modo debug`);
     console.log(`    ${color.cyan('-h, --help')}                Mostra esta ajuda`);
@@ -395,37 +394,27 @@ async function main() {
         selectedTargets = ['claude-code'];
     }
 
-    // ── Remote Mode Detection (Epic 43) ─────────────────────────────
-    // Detect if running as end-user (no core/ directory = npm install)
-    // vs developer (core/ exists = git clone)
-    const hasCore = fs.existsSync(path.join(SCRIPT_DIR, 'core'));
-    const hasLocalFlag = args.includes('--local');
+    // ── Thin-Client Mode (Epic 50) ─────────────────────────────────
+    // ALL installations are thin-client. Zero IP on client, always.
     const configPath = path.join(os.homedir(), '.neocortex', 'config.json');
     const hasConfig = fs.existsSync(configPath);
 
-    if (!hasCore && !hasLocalFlag) {
-        // End-user mode: no local IP assets available
-        if (!hasConfig) {
-            // No config = not activated yet
-            log.info('');
-            log.info(color.cyan('Remote Mode Detected'));
-            log.info(color.dim('No local assets found (end-user installation).'));
-            log.info(color.dim('Content will be served by the IP Protection Server.'));
-            log.info('');
-            log.info(color.yellow('To activate your license:'));
-            log.info(color.bold('  neocortex activate NX-PRO-xxx'));
-            log.info('');
-            log.info(color.dim('Tip: Use --local to force local mode (requires core/ directory).'));
-            log.info('');
-        } else {
-            // Has config = already activated
-            try {
-                const cfg = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
-                if (cfg.mode === 'remote') {
-                    log.info(color.dim(`Remote mode active (server: ${cfg.serverUrl || 'default'})`));
-                }
-            } catch { /* ignore corrupted config */ }
-        }
+    if (!hasConfig) {
+        // Not activated yet - show activation instructions
+        log.info('');
+        log.info(color.cyan('Thin-Client Mode'));
+        log.info(color.dim('All content is served by the Neocortex remote server.'));
+        log.info('');
+        log.info(color.yellow('To activate your license:'));
+        log.info(color.bold('  neocortex activate NX-PRO-xxx'));
+        log.info('');
+    } else {
+        try {
+            const cfg = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
+            if (cfg.mode === 'remote') {
+                log.info(color.dim(`Remote mode active (server: ${cfg.serverUrl || 'default'})`));
+            }
+        } catch { /* ignore corrupted config */ }
     }
 
     // Dispatch to platform-specific installer

package/install.ps1

@@ -15,7 +15,7 @@ param(
     [string]$ServerUrl = "https://api.neocortex.ornexus.com"
 )
 
-$VERSION = "3.9.2"
+$VERSION = "3.9.4"
 
 # =============================================================================
 # CONFIGURACOES
@@ -33,7 +33,8 @@ $DEBUG_MODE = $Debug
 $SKIP_PROJECT_DIRS = $SkipProject
 $QUIET_MODE = $Quiet
 $NO_BANNER = $NoBanner
-$LOCAL_MODE = $Local
+# LOCAL_MODE removed (Epic 50): thin-client ALWAYS, zero IP on client
+$LOCAL_MODE = $false
 $NEOCORTEX_SERVER_URL = $ServerUrl
 
 function Test-Interactive {
@@ -66,7 +67,7 @@ if ($Help) {
     Write-Host "    -SkipProject     Nao perguntar sobre projeto" -ForegroundColor Cyan
     Write-Host "    -Quiet           Modo silencioso" -ForegroundColor Cyan
     Write-Host "    -CleanupLegacy   (Redundante) Limpeza agora e automatica" -ForegroundColor Cyan
-    Write-Host "    -Local           Modo local (copia IP para desenvolvimento)" -ForegroundColor Cyan
+    Write-Host "    -Local           (Removido) Thin-client obrigatorio, zero IP no client" -ForegroundColor DarkGray
     Write-Host "    -ServerUrl <url> URL do server Neocortex" -ForegroundColor Cyan
     Write-Host "    -Debug           Modo debug" -ForegroundColor Cyan
     Write-Host "    -Help            Mostra esta ajuda" -ForegroundColor Cyan

package/install.sh

@@ -4,7 +4,7 @@
 # Epic & Story Development Orchestrator
 
 # Versao do instalador
-VERSION="3.9.2"
+VERSION="3.9.4"
 
 # Flags
 MIGRATION_DETECTED=false
@@ -14,7 +14,7 @@ LEGACY_ITEMS=""
 LEGACY_WARNINGS=0
 SELECTED_TARGETS=""
 VALID_TARGETS="claude-code cursor vscode gemini-cli codex antigravity"
-LOCAL_MODE=false
+# LOCAL_MODE removed (Epic 50): thin-client ALWAYS, zero IP on client
 NEOCORTEX_SERVER_URL="https://api.neocortex.ornexus.com"
 
 # =============================================================================
@@ -59,7 +59,7 @@ while [[ $# -gt 0 ]]; do
         --cleanup-legacy) CLEANUP_LEGACY=true; shift ;;
         --targets=*) SELECTED_TARGETS="${1#--targets=}"; shift ;;
         --create-project) CREATE_PROJECT=true; shift ;;
-        --local) LOCAL_MODE=true; shift ;;
+        --local) warn "--local flag removed: thin-client mode is now mandatory (zero IP on client)"; shift ;;
         --server-url=*) NEOCORTEX_SERVER_URL="${1#--server-url=}"; shift ;;
         -h|--help)
             echo ""
@@ -75,7 +75,7 @@ while [[ $# -gt 0 ]]; do
             echo "    -s, --skip-project        Nao perguntar sobre projeto"
             echo "    -q, --quiet               Modo silencioso"
             echo "    --cleanup-legacy          (Redundante) Limpeza agora e automatica"
-            echo "    --local                   Modo local (copia IP para desenvolvimento)"
+            echo "    --local                   (Removido) Thin-client obrigatorio, zero IP no client"
             echo "    --server-url=<url>        URL do server Neocortex (padrao: api.neocortex.ornexus.com)"
             echo "    -d, --debug               Modo debug"
             echo "    -h, --help                Mostra esta ajuda"
@@ -563,7 +563,7 @@ install_core() {
     AGENTS_DIR="${CLAUDE_DIR}/agents"
     DEST_DIR="${AGENTS_DIR}/neocortex"
 
-    debug "HOME=$HOME | DEST=$DEST_DIR | LOCAL_MODE=$LOCAL_MODE"
+    debug "HOME=$HOME | DEST=$DEST_DIR | MODE=thin-client"
 
     # Create directories
     if [ ! -d "$CLAUDE_DIR" ]; then
@@ -578,23 +578,8 @@ install_core() {
     fi
     mkdir -p "$DEST_DIR" 2>/dev/null || { fail "Falha ao criar $DEST_DIR"; return 1; }
 
-    if [ "$LOCAL_MODE" = true ]; then
-        if [ ! -d "$SOURCE_DIR/core" ]; then
-            fail "Modo --local indisponível nesta distribuição."
-            warn "Os arquivos protegidos não estão incluídos no pacote npm."
-            warn "Este modo é restrito a ambientes autorizados."
-            info "Use sem --local para operar via servidor licenciado."
-            return 1
-        fi
-        copy_dir "$SOURCE_DIR/core" "$DEST_DIR/" || ((errors++))
-        copy_file "$SOURCE_DIR/package.json" "$DEST_DIR/" || ((errors++))
-        copy_file "$SOURCE_DIR/README.md" "$DEST_DIR/" || ((errors++))
-    else
-        # Tier 3 Remote Mode: NÃO copiar IP
-        # Apenas setup do thin client - steps/skills/standards vem do server
-        # Nota: auto_cleanup_legacy() ja rodou no inicio - aqui apenas config
-        setup_thin_client_config
-    fi
+    # Thin-client ONLY: zero IP on client, all content from server
+    setup_thin_client_config
 
     # Write version file
     local pkg_version=""
@@ -604,11 +589,7 @@ install_core() {
     [ -n "$pkg_version" ] && echo "$pkg_version" > "$DEST_DIR/.version"
 
     if [ $errors -eq 0 ]; then
-        if [ "$LOCAL_MODE" = true ]; then
-            ok "Core instalado ${DIM}(standards, templates, scripts) [modo local]${NC}"
-        else
-            ok "Core instalado ${DIM}(thin client configurado) [modo remoto]${NC}"
-        fi
+        ok "Core instalado ${DIM}(thin client configurado) [modo remoto]${NC}"
     else
         fail "Core instalado com erros"
     fi
@@ -627,16 +608,9 @@ install_skills() {
     SKILLS_DEST="${SKILLS_DIR}/neocortex"
     SKILLS_SOURCE="${SOURCE_DIR}/core/skills"
 
-    # Tier 3 Remote Mode: skills vem do server, nao copiar
-    if [ "$LOCAL_MODE" != true ]; then
-        ok "Skills ${DIM}(servidas via server remoto) [modo remoto]${NC}"
-        return 0
-    fi
-
-    if [ ! -d "$SKILLS_SOURCE" ]; then
-        debug "Skills nao encontradas no pacote"
-        return 0
-    fi
+    # Thin-client: skills delivered by remote server, never copied
+    ok "Skills ${DIM}(servidas via server remoto) [modo remoto]${NC}"
+    return 0
 
     mkdir -p "$SKILLS_DIR" 2>/dev/null || { fail "Falha ao criar $SKILLS_DIR"; return 1; }
 
@@ -685,17 +659,7 @@ install_agent() {
         [ "$QUIET_MODE" = false ] && echo "  Removed workflow.md (content now server-side)"
     fi
 
-    if [ "$LOCAL_MODE" = true ]; then
-        # Modo local: copiar IP completa (comportamento legado para devs)
-        copy_file "$SOURCE_DIR/package.json" "$DEST_DIR/"
-        copy_file "$SOURCE_DIR/README.md" "$DEST_DIR/"
-        copy_dir "$SOURCE_DIR/core" "$DEST_DIR/"
-
-        for folder in steps-c steps-e steps-p steps-r steps-u; do
-            copy_dir "$SOURCE_DIR/core/steps/$folder" "$DEST_DIR/"
-        done
-    fi
-    # Tier 3 Remote Mode: apenas 2 stub files + server-side orchestration
+    # Thin-client ONLY: 2 stub files + server-side orchestration
 
     return $errors
 }
@@ -963,8 +927,8 @@ verify_installation() {
         fi
     done
 
-    if [ "$LOCAL_MODE" = true ]; then
-        # ─── Layer 3: Step directories (local mode only) ─────────────────
+    if false; then
+        # ─── Layer 3: Step directories (removed - thin-client only) ──────
         for dir in steps-c steps-e steps-p steps-r steps-u; do
             local dir_path="$DEST_DIR/$dir"
             if [ ! -d "$dir_path" ]; then
@@ -1061,20 +1025,13 @@ show_result() {
         echo ""
         echo -e "  ${GREEN}${BOLD}Instalacao concluida!${NC}"
         echo ""
-        if [ "$LOCAL_MODE" = true ]; then
-            echo -e "  ${DIM}Modo:${NC}    Local (IP completa copiada)"
-            echo -e "  ${DIM}Locais:${NC}"
-            echo -e "    ${DIM}Agente:${NC}  ~/.claude/agents/neocortex/"
-            echo -e "    ${DIM}Skills:${NC}  ~/.claude/skills/neocortex/"
-        else
-            echo -e "  ${DIM}Modo:${NC}    Remoto (Tier 3 - thin client)"
-            echo -e "  ${DIM}Locais:${NC}"
-            echo -e "    ${DIM}Agente:${NC}  ~/.claude/agents/neocortex/ ${DIM}(3 arquivos)${NC}"
-            echo -e "    ${DIM}Config:${NC}  ~/.neocortex/config.json"
-            echo ""
-            echo -e "  ${DIM}Ative sua licenca:${NC}"
-            echo -e "    ${CYAN}neocortex-client activate NX-PRO-xxx${NC}"
-        fi
+        echo -e "  ${DIM}Modo:${NC}    Remoto (thin client - zero IP)"
+        echo -e "  ${DIM}Locais:${NC}"
+        echo -e "    ${DIM}Agente:${NC}  ~/.claude/agents/neocortex/ ${DIM}(3 arquivos)${NC}"
+        echo -e "    ${DIM}Config:${NC}  ~/.neocortex/config.json"
+        echo ""
+        echo -e "  ${DIM}Ative sua licenca:${NC}"
+        echo -e "    ${CYAN}neocortex-client activate NX-PRO-xxx${NC}"
         echo ""
         echo -e "  ${DIM}Proximo passo:${NC}"
         echo -e "    ${CYAN}@neocortex *init @docs/epics.md${NC}"
@@ -1133,10 +1090,8 @@ create_project_dirs() {
         rm -rf "$project_dir/.claude/agents/neocortex" 2>/dev/null
         rm -rf "$project_dir/.claude/skills/neocortex" 2>/dev/null
 
-        if [ "$LOCAL_MODE" = true ]; then
-            # Modo local: limpar e reconstruir core/
-            rm -rf "$project_dir/core" 2>/dev/null
-        fi
+        # Thin-client: cleanup any legacy core/ from previous local installs
+        rm -rf "$project_dir/core" 2>/dev/null
 
         # Create base directories
         mkdir -p "$project_dir/.neocortex/specs" \
@@ -1151,11 +1106,7 @@ create_project_dirs() {
                 cp "$SOURCE_DIR/core/data/state-template.json" "$project_dir/.neocortex/state.json"
         fi
 
-        # Copy core (ONLY in local mode)
-        if [ "$LOCAL_MODE" = true ] && [ -d "$SOURCE_DIR/core" ]; then
-            mkdir -p "$project_dir/core"
-            cp -r "$SOURCE_DIR/core"/* "$project_dir/core/" 2>/dev/null
-        fi
+        # Thin-client: never copy core/ to project
 
         # Install target-specific files
         local targets_list
@@ -1175,73 +1126,48 @@ create_project_dirs() {
                         # Cleanup workflow.md from previous versions
                         rm -f "$project_dir/.claude/agents/neocortex/workflow.md" 2>/dev/null
 
-                        if [ "$LOCAL_MODE" = true ] && [ -d "$SOURCE_DIR/core" ]; then
-                            # Modo local: copiar IP completa (restrito a ambientes autorizados)
-                            cp "$SOURCE_DIR/package.json" "$project_dir/.claude/agents/neocortex/" 2>/dev/null
-                            cp "$SOURCE_DIR/README.md" "$project_dir/.claude/agents/neocortex/" 2>/dev/null
-                            mkdir -p "$project_dir/.claude/agents/neocortex/core"
-                            cp -r "$SOURCE_DIR/core"/* "$project_dir/.claude/agents/neocortex/core/" 2>/dev/null
-                            for folder in steps-c steps-e steps-p steps-r steps-u; do
-                                if [ -d "$SOURCE_DIR/core/steps/$folder" ]; then
-                                    mkdir -p "$project_dir/.claude/agents/neocortex/$folder"
-                                    cp -r "$SOURCE_DIR/core/steps/$folder"/* "$project_dir/.claude/agents/neocortex/$folder/" 2>/dev/null
-                                fi
-                            done
-                            if [ -d "$SOURCE_DIR/core/skills" ]; then
-                                mkdir -p "$project_dir/.claude/skills/neocortex"
-                                cp -r "$SOURCE_DIR/core/skills"/* "$project_dir/.claude/skills/neocortex/" 2>/dev/null
-                            fi
-                        else
-                            # Tier 3 Remote Mode: limpar IP de versoes anteriores no projeto
-                            auto_cleanup_legacy_project "$project_dir"
-                        fi
+                        # Thin-client: cleanup legacy IP from previous installs
+                        auto_cleanup_legacy_project "$project_dir"
                         target_summary="${target_summary}claude-code, "
                     fi
                     ;;
                 cursor)
-                    local adapter_script="$SOURCE_DIR/targets/cursor/install-cursor.sh"
-                    if [ -f "$adapter_script" ]; then
-                        . "$adapter_script"
+                    # IP Protection: ALWAYS thin-client, zero IP on client
+                    local stub_adapter="$SOURCE_DIR/targets-stubs/cursor/install-cursor.sh"
+                    if [ -f "$stub_adapter" ]; then
+                        . "$stub_adapter"
                         install_cursor "$SOURCE_DIR" "$project_dir"
                         target_summary="${target_summary}cursor, "
                     fi
                     ;;
                 vscode)
-                    local adapter_script="$SOURCE_DIR/targets/vscode/install-vscode.sh"
-                    if [ -f "$adapter_script" ]; then
-                        . "$adapter_script"
+                    local stub_adapter="$SOURCE_DIR/targets-stubs/vscode/install-vscode.sh"
+                    if [ -f "$stub_adapter" ]; then
+                        . "$stub_adapter"
                         install_vscode "$SOURCE_DIR" "$project_dir"
                         target_summary="${target_summary}vscode, "
                     fi
                     ;;
                 gemini-cli)
-                    local gemini_target="$SOURCE_DIR/targets/gemini-cli"
-                    if [ -d "$gemini_target" ]; then
-                        [ -f "$gemini_target/gemini.md" ] && cp "$gemini_target/gemini.md" "$project_dir/GEMINI.md"
-                        if [ -d "$gemini_target/commands" ]; then
-                            mkdir -p "$project_dir/.gemini/commands"
-                            cp "$gemini_target/commands"/*.toml "$project_dir/.gemini/commands/" 2>/dev/null
-                        fi
-                        if [ -f "$gemini_target/agent.md" ]; then
-                            mkdir -p "$project_dir/.gemini/agents"
-                            cp "$gemini_target/agent.md" "$project_dir/.gemini/agents/neocortex.md"
-                        fi
-                        [ -f "$gemini_target/settings-mcp.json" ] && cp "$gemini_target/settings-mcp.json" "$project_dir/.gemini/settings-mcp.json"
+                    local stub_adapter="$SOURCE_DIR/targets-stubs/gemini-cli/install-gemini.sh"
+                    if [ -f "$stub_adapter" ]; then
+                        . "$stub_adapter"
+                        install_gemini "$SOURCE_DIR" "$project_dir"
                         target_summary="${target_summary}gemini-cli, "
                     fi
                     ;;
                 codex)
-                    local adapter_script="$SOURCE_DIR/targets/codex/install-codex.sh"
-                    if [ -f "$adapter_script" ]; then
-                        . "$adapter_script"
+                    local stub_adapter="$SOURCE_DIR/targets-stubs/codex/install-codex.sh"
+                    if [ -f "$stub_adapter" ]; then
+                        . "$stub_adapter"
                         install_codex "$SOURCE_DIR" "$project_dir"
                         target_summary="${target_summary}codex, "
                     fi
                     ;;
                 antigravity)
-                    local adapter_script="$SOURCE_DIR/targets/antigravity/install-antigravity.sh"
-                    if [ -f "$adapter_script" ]; then
-                        . "$adapter_script"
+                    local stub_adapter="$SOURCE_DIR/targets-stubs/antigravity/install-antigravity.sh"
+                    if [ -f "$stub_adapter" ]; then
+                        . "$stub_adapter"
                         install_antigravity "$SOURCE_DIR" "$project_dir"
                         target_summary="${target_summary}antigravity, "
                     fi

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ornexus/neocortex",
-  "version": "3.9.2",
-  "description": "Neocortex v3.9.2 - Orquestrador de Desenvolvimento de Epics & Stories para Claude Code",
+  "version": "3.9.4",
+  "description": "Neocortex v3.9.4 - Orquestrador de Desenvolvimento de Epics & Stories para Claude Code",
   "keywords": [
     "claude",
     "claude-code",

package/targets-stubs/antigravity/README.md

@@ -1,20 +1,36 @@
-# Neocortex Target Stub
+# Target Stub: Google Antigravity
 
-This content is served by the **IP Protection Server**.
+**Thin Client Mode** | Remote content delivery
 
-The full target configuration, agent definitions, and pipeline instructions
-are delivered securely via the Neocortex remote content delivery system.
+> **EXPERIMENTAL**: Google Antigravity is in public preview.
 
-## To activate remote mode:
+This is a thin-client stub. The full target configuration, agent definitions,
+and pipeline instructions are delivered securely via the Neocortex remote
+content delivery system.
+
+## Quick Start
 
 ```bash
+# Install Neocortex
+npx @ornexus/neocortex
+
+# Activate license for remote content
 neocortex activate NX-PRO-xxx
 ```
 
-## To use local mode (developers only):
+## Contents
 
-```bash
-neocortex install --local
-```
+| File | Description |
+|---|---|
+| `skill/SKILL.md` | Thin-client skill stub (delegates to neocortex-client) |
+| `gemini.md` | Thin-client GEMINI.md (no @import directives) |
+| `mcp-config.json` | MCP server configuration (Playwright + Context7) |
+
+## How It Works
+
+1. The stub skill receives user invocations
+2. It calls `neocortex-client invoke` with the user's arguments
+3. The server returns full pipeline instructions
+4. The agent follows the returned instructions exactly
 
 For more information, visit: https://github.com/OrNexus-AI/neocortex

package/targets-stubs/antigravity/gemini.md

@@ -0,0 +1,16 @@
+# Neocortex - Antigravity Configuration (Thin Client)
+
+This project uses Neocortex, an Epic & Story Development Orchestrator.
+
+All orchestration logic, standards, skills, and workflows are delivered by the remote Neocortex server.
+Use the Neocortex skill to interact with the pipeline.
+
+## Usage
+
+Invoke the Neocortex skill with your command. The skill will call `neocortex-client invoke` to fetch instructions from the server.
+
+## Activation
+
+```bash
+neocortex activate NX-PRO-xxx
+```

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

@@ -0,0 +1,44 @@
+#!/bin/sh
+# Neocortex - Google Antigravity Install Adapter (Thin Client)
+# Simplified installer for npm tarball mode (targets-stubs only)
+
+install_antigravity() {
+    local source_dir="${1:?SOURCE_DIR required}"
+    local dest_dir="${2:?DEST_DIR required}"
+    local ag_target="$source_dir/targets-stubs/antigravity"
+    local gemini_home="${GEMINI_HOME:-$HOME/.gemini}"
+
+    if [ ! -d "$ag_target" ]; then
+        echo "[ANTIGRAVITY] ERROR: Stub directory not found: $ag_target" >&2
+        return 1
+    fi
+
+    echo "[ANTIGRAVITY] Installing Neocortex for Google Antigravity (thin-client mode)..."
+    echo "[ANTIGRAVITY] WARNING: Antigravity is in public preview - APIs may change"
+
+    # Create destination directories
+    mkdir -p "$dest_dir/.agent/skills/neocortex" \
+             "$gemini_home/antigravity"
+
+    # 1. Copy SKILL.md stub
+    if [ -f "$ag_target/skill/SKILL.md" ]; then
+        cp "$ag_target/skill/SKILL.md" "$dest_dir/.agent/skills/neocortex/SKILL.md"
+        echo "[ANTIGRAVITY] Installed skill stub: .agent/skills/neocortex/SKILL.md"
+    fi
+
+    # 2. Copy MCP config
+    if [ -f "$ag_target/mcp-config.json" ]; then
+        cp "$ag_target/mcp-config.json" "$gemini_home/antigravity/mcp_config.json"
+        echo "[ANTIGRAVITY] Installed MCP config: ~/.gemini/antigravity/mcp_config.json"
+    fi
+
+    # 3. Copy GEMINI.md stub to project root
+    if [ -f "$ag_target/gemini.md" ]; then
+        cp "$ag_target/gemini.md" "$dest_dir/GEMINI.md"
+        echo "[ANTIGRAVITY] Installed: GEMINI.md (project root)"
+    fi
+
+    echo "[ANTIGRAVITY] Thin-client installation complete!"
+    echo "[ANTIGRAVITY] Content delivered by remote server. Activate: neocortex activate NX-PRO-xxx"
+    return 0
+}

package/targets-stubs/antigravity/mcp-config.json

@@ -0,0 +1,9 @@
+{
+  "playwright": {
+    "command": "npx",
+    "args": ["-y", "@playwright/mcp@latest"]
+  },
+  "context7": {
+    "httpUrl": "https://mcp.context7.com/mcp"
+  }
+}

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

@@ -0,0 +1,48 @@
+---
+name: neocortex
+description: "Neocortex - Orquestrador de Desenvolvimento (Thin Client). Use when user asks to manage epics, stories, or development pipelines."
+---
+
+# Neocortex - Thin Client Interface
+
+Voce e o agente Neocortex. Toda a logica de orquestracao e resolvida pelo server remoto.
+
+## Invocacao
+
+Quando o usuario invocar esta skill, siga EXATAMENTE este protocolo:
+
+1. **Coletar argumentos do usuario** - Tudo que o usuario escreveu
+2. **Executar o thin client** para obter instrucoes do server:
+
+```bash
+neocortex-client invoke \
+  --args "{ARGS_DO_USUARIO}" \
+  --project-root "$(git rev-parse --show-toplevel)" \
+  --format plain
+```
+
+3. **Seguir EXATAMENTE as instrucoes retornadas** pelo thin client no stdout
+
+## Exemplos
+
+| Invocacao do Usuario | Comando invoke |
+|---------------------|----------------|
+| `@neocortex` (vazio) | `invoke --args ""` |
+| `@neocortex *status` | `invoke --args "*status"` |
+| `@neocortex *yolo @docs/stories/1.1.story.md` | `invoke --args "*yolo @docs/stories/1.1.story.md"` |
+| `@neocortex *implement @docs/stories/1.1.story.md` | `invoke --args "*implement @docs/stories/1.1.story.md"` |
+
+## Erros
+
+| Exit Code | Significado | Acao |
+|-----------|-------------|------|
+| 0 | Sucesso | Seguir instrucoes do stdout |
+| 1 | Erro do server | Mostrar stderr ao usuario |
+| 2 | Nao configurado | Instruir: `neocortex activate NX-PRO-xxx` |
+
+## 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
+- Se o thin client falhar, mostre o erro e aguarde input do usuario

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

@@ -4,7 +4,7 @@ agent:
     name: 'Neocortex'
     title: 'Epic & Story Development Orchestrator'
     icon: '>'
-    version: '3.9.2'
+    version: '3.9.4'
     architecture: 'thin-client'
     module: stand-alone
     hasSidecar: false

package/targets-stubs/codex/README.md

@@ -1,20 +1,32 @@
-# Neocortex Target Stub
+# Target Stub: OpenAI Codex CLI
 
-This content is served by the **IP Protection Server**.
+**Thin Client Mode** | Remote content delivery
 
-The full target configuration, agent definitions, and pipeline instructions
-are delivered securely via the Neocortex remote content delivery system.
+This is a thin-client stub. The full target configuration, agent definitions,
+and pipeline instructions are delivered securely via the Neocortex remote
+content delivery system.
 
-## To activate remote mode:
+## Quick Start
 
 ```bash
+# Install Neocortex
+npx @ornexus/neocortex
+
+# Activate license for remote content
 neocortex activate NX-PRO-xxx
 ```
 
-## To use local mode (developers only):
+## Contents
 
-```bash
-neocortex install --local
-```
+| File | Description |
+|---|---|
+| `agents.md` | Thin-client AGENTS.md stub (delegates to neocortex-client) |
+| `config-mcp.toml` | MCP server configuration (Playwright + Context7) |
+
+## How It Works
+
+1. The stub AGENTS.md instructs Codex to run `neocortex-client invoke`
+2. The server returns full pipeline instructions
+3. Codex follows the returned instructions exactly
 
 For more information, visit: https://github.com/OrNexus-AI/neocortex

package/targets-stubs/codex/agents.md

@@ -0,0 +1,42 @@
+# Neocortex - Epic & Story Development Orchestrator (Thin Client)
+
+You are an Epic & Story Development Orchestrator. All orchestration logic is delivered by the remote Neocortex server.
+
+## Invocation Protocol
+
+When the user invokes Neocortex, follow this protocol EXACTLY:
+
+1. **Collect user arguments** - Everything the user wrote after the trigger
+2. **Execute the thin client** to get instructions from the server:
+
+```bash
+neocortex-client invoke \
+  --args "{USER_ARGS}" \
+  --project-root "$(git rev-parse --show-toplevel)" \
+  --format plain
+```
+
+3. **Follow EXACTLY the instructions returned** by the thin client on stdout
+
+## Examples
+
+| User Input | invoke Command |
+|---------------------|----------------|
+| `*status` | `invoke --args "*status"` |
+| `*yolo @docs/stories/1.1.story.md` | `invoke --args "*yolo @docs/stories/1.1.story.md"` |
+| `*implement @docs/stories/1.1.story.md` | `invoke --args "*implement @docs/stories/1.1.story.md"` |
+
+## Error Handling
+
+| Exit Code | Meaning | Action |
+|-----------|---------|--------|
+| 0 | Success | Follow stdout instructions |
+| 1 | Server error | Show stderr to user |
+| 2 | Not configured | Instruct: `neocortex activate NX-PRO-xxx` |
+
+## Rules
+
+- NEVER invent orchestration logic - all logic comes from the server
+- NEVER skip the thin client - always execute invoke
+- ALWAYS follow the returned instructions literally
+- If the thin client fails, show the error and wait for user input

package/targets-stubs/codex/config-mcp.toml

@@ -0,0 +1,6 @@
+[mcp_servers.playwright]
+command = "npx"
+args = ["-y", "@playwright/mcp@latest"]
+
+[mcp_servers.context7]
+url = "https://mcp.context7.com/mcp"

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

@@ -0,0 +1,61 @@
+#!/bin/sh
+# Neocortex - OpenAI Codex CLI Install Adapter (Thin Client)
+# Simplified installer for npm tarball mode (targets-stubs only)
+
+install_codex() {
+    local source_dir="${1:?SOURCE_DIR required}"
+    local dest_dir="${2:?DEST_DIR required}"
+    local codex_target="$source_dir/targets-stubs/codex"
+    local codex_home="${CODEX_HOME:-$HOME/.codex}"
+
+    if [ ! -d "$codex_target" ]; then
+        echo "[CODEX] ERROR: Stub directory not found: $codex_target" >&2
+        return 1
+    fi
+
+    echo "[CODEX] Installing Neocortex for OpenAI Codex CLI (thin-client mode)..."
+
+    # Create destination directories
+    mkdir -p "$codex_home"
+
+    # 1. Copy AGENTS.md stub to project root
+    if [ -f "$codex_target/agents.md" ]; then
+        cp "$codex_target/agents.md" "$dest_dir/AGENTS.md"
+        echo "[CODEX] Installed: AGENTS.md (project root)"
+    fi
+
+    # 2. Copy AGENTS.md stub to global
+    if [ -f "$codex_target/agents.md" ]; then
+        cp "$codex_target/agents.md" "$codex_home/AGENTS.md"
+        echo "[CODEX] Installed: ~/.codex/AGENTS.md (global)"
+    fi
+
+    # 3. Merge MCP config into config.toml
+    if [ -f "$codex_target/config-mcp.toml" ]; then
+        local config_file="$codex_home/config.toml"
+        if [ -f "$config_file" ]; then
+            if grep -q "# Neocortex MCP Servers" "$config_file" 2>/dev/null; then
+                local tmp_file="${config_file}.tmp"
+                sed '/# Neocortex MCP Servers/,$d' "$config_file" > "$tmp_file"
+                echo "" >> "$tmp_file"
+                echo "# Neocortex MCP Servers" >> "$tmp_file"
+                cat "$codex_target/config-mcp.toml" >> "$tmp_file"
+                mv "$tmp_file" "$config_file"
+                echo "[CODEX] Updated MCP config in ~/.codex/config.toml"
+            else
+                echo "" >> "$config_file"
+                echo "# Neocortex MCP Servers" >> "$config_file"
+                cat "$codex_target/config-mcp.toml" >> "$config_file"
+                echo "[CODEX] Appended MCP config to ~/.codex/config.toml"
+            fi
+        else
+            echo "# Neocortex MCP Servers" > "$config_file"
+            cat "$codex_target/config-mcp.toml" >> "$config_file"
+            echo "[CODEX] Created ~/.codex/config.toml with MCP config"
+        fi
+    fi
+
+    echo "[CODEX] Thin-client installation complete!"
+    echo "[CODEX] Content delivered by remote server. Activate: neocortex activate NX-PRO-xxx"
+    return 0
+}

package/targets-stubs/cursor/README.md

@@ -1,20 +1,33 @@
-# Neocortex Target Stub
+# Target Stub: Cursor IDE
 
-This content is served by the **IP Protection Server**.
+**Thin Client Mode** | Remote content delivery
 
-The full target configuration, agent definitions, and pipeline instructions
-are delivered securely via the Neocortex remote content delivery system.
+This is a thin-client stub. The full target configuration, agent definitions,
+and pipeline instructions are delivered securely via the Neocortex remote
+content delivery system.
 
-## To activate remote mode:
+## Quick Start
 
 ```bash
+# Install Neocortex
+npx @ornexus/neocortex
+
+# Activate license for remote content
 neocortex activate NX-PRO-xxx
 ```
 
-## To use local mode (developers only):
+## Contents
 
-```bash
-neocortex install --local
-```
+| File | Description |
+|---|---|
+| `agent.md` | Thin-client agent stub (delegates to neocortex-client) |
+| `mcp.json` | MCP server configuration (Playwright + Context7) |
+
+## How It Works
+
+1. The stub agent receives user invocations
+2. It calls `neocortex-client invoke` with the user's arguments
+3. The server returns full pipeline instructions
+4. The agent follows the returned instructions exactly
 
 For more information, visit: https://github.com/OrNexus-AI/neocortex

package/targets-stubs/cursor/agent.md

@@ -0,0 +1,51 @@
+---
+name: neocortex
+description: "Neocortex - Orquestrador de Desenvolvimento (Thin Client)"
+model: fast
+readonly: false
+is_background: false
+---
+
+# Neocortex - Thin Client Interface
+
+Voce e o agente Neocortex. Toda a logica de orquestracao e resolvida pelo server remoto.
+
+## Invocacao
+
+Quando o usuario invocar este agente, siga EXATAMENTE este protocolo:
+
+1. **Coletar argumentos do usuario** - Tudo que o usuario escreveu apos `@neocortex`
+2. **Executar o thin client** para obter instrucoes do server:
+
+```bash
+neocortex-client invoke \
+  --args "{ARGS_DO_USUARIO}" \
+  --project-root "$(git rev-parse --show-toplevel)" \
+  --format plain
+```
+
+3. **Seguir EXATAMENTE as instrucoes retornadas** pelo thin client no stdout
+
+## Exemplos
+
+| Invocacao do Usuario | Comando invoke |
+|---------------------|----------------|
+| `@neocortex` (vazio) | `invoke --args ""` |
+| `@neocortex *status` | `invoke --args "*status"` |
+| `@neocortex *yolo @docs/stories/1.1.story.md` | `invoke --args "*yolo @docs/stories/1.1.story.md"` |
+| `@neocortex *implement @docs/stories/1.1.story.md` | `invoke --args "*implement @docs/stories/1.1.story.md"` |
+
+## Erros
+
+| Exit Code | Significado | Acao |
+|-----------|-------------|------|
+| 0 | Sucesso | Seguir instrucoes do stdout |
+| 1 | Erro do server | Mostrar stderr ao usuario |
+| 2 | Nao configurado | Instruir: `neocortex activate NX-PRO-xxx` |
+
+## 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
+- Se o thin client falhar, mostre o erro e aguarde input do usuario

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

@@ -0,0 +1,35 @@
+#!/bin/sh
+# Neocortex - Cursor IDE Install Adapter (Thin Client)
+# Simplified installer for npm tarball mode (targets-stubs only)
+
+install_cursor() {
+    local source_dir="${1:?SOURCE_DIR required}"
+    local dest_dir="${2:?DEST_DIR required}"
+    local cursor_target="$source_dir/targets-stubs/cursor"
+
+    if [ ! -d "$cursor_target" ]; then
+        echo "[CURSOR] ERROR: Stub directory not found: $cursor_target" >&2
+        return 1
+    fi
+
+    echo "[CURSOR] Installing Neocortex for Cursor IDE (thin-client mode)..."
+
+    # Create destination directories
+    mkdir -p "$dest_dir/.cursor/agents"
+
+    # 1. Copy agent stub
+    if [ -f "$cursor_target/agent.md" ]; then
+        cp "$cursor_target/agent.md" "$dest_dir/.cursor/agents/neocortex.md"
+        echo "[CURSOR] Installed agent stub: .cursor/agents/neocortex.md"
+    fi
+
+    # 2. Copy MCP config
+    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"
+    fi
+
+    echo "[CURSOR] Thin-client installation complete!"
+    echo "[CURSOR] Content delivered by remote server. Activate: neocortex activate NX-PRO-xxx"
+    return 0
+}

package/targets-stubs/cursor/mcp.json

@@ -0,0 +1,11 @@
+{
+  "mcpServers": {
+    "playwright": {
+      "command": "npx",
+      "args": ["-y", "@playwright/mcp@latest"]
+    },
+    "context7": {
+      "url": "https://mcp.context7.com/mcp"
+    }
+  }
+}

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

@@ -1,20 +1,34 @@
-# Neocortex Target Stub
+# Target Stub: Gemini CLI
 
-This content is served by the **IP Protection Server**.
+**Thin Client Mode** | Remote content delivery
 
-The full target configuration, agent definitions, and pipeline instructions
-are delivered securely via the Neocortex remote content delivery system.
+This is a thin-client stub. The full target configuration, agent definitions,
+and pipeline instructions are delivered securely via the Neocortex remote
+content delivery system.
 
-## To activate remote mode:
+## Quick Start
 
 ```bash
+# Install Neocortex
+npx @ornexus/neocortex
+
+# Activate license for remote content
 neocortex activate NX-PRO-xxx
 ```
 
-## To use local mode (developers only):
+## Contents
 
-```bash
-neocortex install --local
-```
+| File | Description |
+|---|---|
+| `agent.md` | Thin-client agent stub (delegates to neocortex-client) |
+| `gemini.md` | Thin-client GEMINI.md (no @import directives) |
+| `settings-mcp.json` | MCP server configuration (Playwright + Context7) |
+
+## How It Works
+
+1. The stub agent receives user invocations
+2. It calls `neocortex-client invoke` with the user's arguments
+3. The server returns full pipeline instructions
+4. The agent follows the returned instructions exactly
 
 For more information, visit: https://github.com/OrNexus-AI/neocortex

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

@@ -0,0 +1,58 @@
+---
+name: neocortex
+description: "Neocortex - Orquestrador de Desenvolvimento (Thin Client)"
+kind: local
+tools:
+  - read_file
+  - write_file
+  - replace
+  - run_shell_command
+  - search_file_content
+model: gemini-2.5-pro
+max_turns: 50
+timeout_mins: 30
+---
+
+# Neocortex - Thin Client Interface
+
+Voce e o agente Neocortex. Toda a logica de orquestracao e resolvida pelo server remoto.
+
+## Invocacao
+
+Quando o usuario invocar este agente, siga EXATAMENTE este protocolo:
+
+1. **Coletar argumentos do usuario** - Tudo que o usuario escreveu apos `@neocortex`
+2. **Executar o thin client** para obter instrucoes do server:
+
+```bash
+neocortex-client invoke \
+  --args "{ARGS_DO_USUARIO}" \
+  --project-root "$(git rev-parse --show-toplevel)" \
+  --format plain
+```
+
+3. **Seguir EXATAMENTE as instrucoes retornadas** pelo thin client no stdout
+
+## Exemplos
+
+| Invocacao do Usuario | Comando invoke |
+|---------------------|----------------|
+| `@neocortex` (vazio) | `invoke --args ""` |
+| `@neocortex *status` | `invoke --args "*status"` |
+| `@neocortex *yolo @docs/stories/1.1.story.md` | `invoke --args "*yolo @docs/stories/1.1.story.md"` |
+| `@neocortex *implement @docs/stories/1.1.story.md` | `invoke --args "*implement @docs/stories/1.1.story.md"` |
+
+## Erros
+
+| Exit Code | Significado | Acao |
+|-----------|-------------|------|
+| 0 | Sucesso | Seguir instrucoes do stdout |
+| 1 | Erro do server | Mostrar stderr ao usuario |
+| 2 | Nao configurado | Instruir: `neocortex activate NX-PRO-xxx` |
+
+## 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
+- Se o thin client falhar, mostre o erro e aguarde input do usuario

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

@@ -0,0 +1,16 @@
+# Neocortex - Gemini Configuration (Thin Client)
+
+This project uses Neocortex, an Epic & Story Development Orchestrator.
+
+All orchestration logic, standards, and skills are delivered by the remote Neocortex server.
+Use the `@neocortex` agent to interact with the pipeline.
+
+## Usage
+
+Invoke the `@neocortex` agent with your command. The agent will call `neocortex-client invoke` to fetch instructions from the server.
+
+## Activation
+
+```bash
+neocortex activate NX-PRO-xxx
+```

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

@@ -0,0 +1,56 @@
+#!/bin/sh
+# Neocortex - Gemini CLI Install Adapter (Thin Client)
+# Simplified installer for npm tarball mode (targets-stubs only)
+
+install_gemini() {
+    local source_dir="${1:?SOURCE_DIR required}"
+    local dest_dir="${2:?DEST_DIR required}"
+    local gemini_target="$source_dir/targets-stubs/gemini-cli"
+    local gemini_home="${GEMINI_HOME:-$HOME/.gemini}"
+
+    if [ ! -d "$gemini_target" ]; then
+        echo "[GEMINI] ERROR: Stub directory not found: $gemini_target" >&2
+        return 1
+    fi
+
+    echo "[GEMINI] Installing Neocortex for Gemini CLI (thin-client mode)..."
+
+    # Create destination directories
+    mkdir -p "$gemini_home/agents"
+
+    # 1. Copy agent stub
+    if [ -f "$gemini_target/agent.md" ]; then
+        cp "$gemini_target/agent.md" "$gemini_home/agents/neocortex.md"
+        echo "[GEMINI] Installed agent stub: ~/.gemini/agents/neocortex.md"
+    fi
+
+    # 2. Copy GEMINI.md stub to project root
+    if [ -f "$gemini_target/gemini.md" ]; then
+        cp "$gemini_target/gemini.md" "$dest_dir/GEMINI.md"
+        echo "[GEMINI] Installed: GEMINI.md (project root)"
+    fi
+
+    # 3. 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
+    fi
+
+    echo "[GEMINI] Thin-client installation complete!"
+    echo "[GEMINI] Content delivered by remote server. Activate: neocortex activate NX-PRO-xxx"
+    return 0
+}

package/targets-stubs/gemini-cli/settings-mcp.json

@@ -0,0 +1,11 @@
+{
+  "mcpServers": {
+    "playwright": {
+      "command": "npx",
+      "args": ["-y", "@playwright/mcp@latest"]
+    },
+    "context7": {
+      "httpUrl": "https://mcp.context7.com/mcp"
+    }
+  }
+}

package/targets-stubs/vscode/README.md

@@ -1,20 +1,34 @@
-# Neocortex Target Stub
+# Target Stub: VSCode / GitHub Copilot
 
-This content is served by the **IP Protection Server**.
+**Thin Client Mode** | Remote content delivery
 
-The full target configuration, agent definitions, and pipeline instructions
-are delivered securely via the Neocortex remote content delivery system.
+This is a thin-client stub. The full target configuration, agent definitions,
+and pipeline instructions are delivered securely via the Neocortex remote
+content delivery system.
 
-## To activate remote mode:
+## Quick Start
 
 ```bash
+# Install Neocortex
+npx @ornexus/neocortex
+
+# Activate license for remote content
 neocortex activate NX-PRO-xxx
 ```
 
-## To use local mode (developers only):
+## Contents
 
-```bash
-neocortex install --local
-```
+| File | Description |
+|---|---|
+| `agent.md` | Thin-client agent stub (delegates to neocortex-client) |
+| `copilot-instructions.md` | Thin-client Copilot instructions |
+| `mcp.json` | MCP server configuration (Playwright + Context7) |
+
+## How It Works
+
+1. The stub agent receives user invocations
+2. It calls `neocortex-client invoke` with the user's arguments
+3. The server returns full pipeline instructions
+4. The agent follows the returned instructions exactly
 
 For more information, visit: https://github.com/OrNexus-AI/neocortex

package/targets-stubs/vscode/agent.md

@@ -0,0 +1,59 @@
+---
+name: "neocortex"
+description: "Neocortex - Orquestrador de Desenvolvimento (Thin Client)"
+tools:
+  - readFile
+  - editFiles
+  - textSearch
+  - runInTerminal
+  - codebase
+agents:
+  - "*"
+model:
+  - "claude-sonnet-4"
+user-invokable: true
+---
+
+# Neocortex - Thin Client Interface
+
+Voce e o agente Neocortex. Toda a logica de orquestracao e resolvida pelo server remoto.
+
+## Invocacao
+
+Quando o usuario invocar este agente, siga EXATAMENTE este protocolo:
+
+1. **Coletar argumentos do usuario** - Tudo que o usuario escreveu apos `@neocortex`
+2. **Executar o thin client** para obter instrucoes do server:
+
+```bash
+neocortex-client invoke \
+  --args "{ARGS_DO_USUARIO}" \
+  --project-root "$(git rev-parse --show-toplevel)" \
+  --format plain
+```
+
+3. **Seguir EXATAMENTE as instrucoes retornadas** pelo thin client no stdout
+
+## Exemplos
+
+| Invocacao do Usuario | Comando invoke |
+|---------------------|----------------|
+| `@neocortex` (vazio) | `invoke --args ""` |
+| `@neocortex *status` | `invoke --args "*status"` |
+| `@neocortex *yolo @docs/stories/1.1.story.md` | `invoke --args "*yolo @docs/stories/1.1.story.md"` |
+| `@neocortex *implement @docs/stories/1.1.story.md` | `invoke --args "*implement @docs/stories/1.1.story.md"` |
+
+## Erros
+
+| Exit Code | Significado | Acao |
+|-----------|-------------|------|
+| 0 | Sucesso | Seguir instrucoes do stdout |
+| 1 | Erro do server | Mostrar stderr ao usuario |
+| 2 | Nao configurado | Instruir: `neocortex activate NX-PRO-xxx` |
+
+## 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
+- Se o thin client falhar, mostre o erro e aguarde input do usuario

package/targets-stubs/vscode/copilot-instructions.md

@@ -0,0 +1,16 @@
+# Neocortex - Copilot Instructions (Thin Client)
+
+This project uses Neocortex, an Epic & Story Development Orchestrator.
+
+All orchestration logic is delivered by the remote Neocortex server.
+Use the `@neocortex` agent (in `.github/agents/neocortex.md`) to interact with the pipeline.
+
+## Usage
+
+Invoke the `@neocortex` agent with your command. The agent will call `neocortex-client invoke` to fetch instructions from the server.
+
+## Activation
+
+```bash
+neocortex activate NX-PRO-xxx
+```

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

@@ -0,0 +1,42 @@
+#!/bin/sh
+# Neocortex - VSCode / GitHub Copilot Install Adapter (Thin Client)
+# Simplified installer for npm tarball mode (targets-stubs only)
+
+install_vscode() {
+    local source_dir="${1:?SOURCE_DIR required}"
+    local dest_dir="${2:?DEST_DIR required}"
+    local vscode_target="$source_dir/targets-stubs/vscode"
+
+    if [ ! -d "$vscode_target" ]; then
+        echo "[VSCODE] ERROR: Stub directory not found: $vscode_target" >&2
+        return 1
+    fi
+
+    echo "[VSCODE] Installing Neocortex for VSCode / GitHub Copilot (thin-client mode)..."
+
+    # Create destination directories
+    mkdir -p "$dest_dir/.github/agents" \
+             "$dest_dir/.vscode"
+
+    # 1. Copy agent stub
+    if [ -f "$vscode_target/agent.md" ]; then
+        cp "$vscode_target/agent.md" "$dest_dir/.github/agents/neocortex.md"
+        echo "[VSCODE] Installed agent stub: .github/agents/neocortex.md"
+    fi
+
+    # 2. Copy copilot-instructions stub
+    if [ -f "$vscode_target/copilot-instructions.md" ]; then
+        cp "$vscode_target/copilot-instructions.md" "$dest_dir/.github/copilot-instructions.md"
+        echo "[VSCODE] Installed: .github/copilot-instructions.md"
+    fi
+
+    # 3. Copy 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"
+    fi
+
+    echo "[VSCODE] Thin-client installation complete!"
+    echo "[VSCODE] Content delivered by remote server. Activate: neocortex activate NX-PRO-xxx"
+    return 0
+}

package/targets-stubs/vscode/mcp.json

@@ -0,0 +1,13 @@
+{
+  "servers": {
+    "playwright": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["-y", "@playwright/mcp@latest"]
+    },
+    "context7": {
+      "type": "http",
+      "url": "https://mcp.context7.com/mcp"
+    }
+  }
+}