@ornexus/neocortex 4.59.1

package/targets-stubs/antigravity/README.md

@@ -0,0 +1,36 @@
+# Target Stub: Google Antigravity
+
+**Thin Client Mode** | Remote content delivery
+
+> **EXPERIMENTAL**: Google Antigravity is in public preview.
+
+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 YOUR-LICENSE-KEY  # Get yours at https://neocortex.sh/portal/login
+```
+
+## Contents
+
+| 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://neocortex.sh

package/targets-stubs/antigravity/gemini.md

@@ -0,0 +1,29 @@
+# 🧠 Neocortex v4.59.1 | OrNexus Team
+
+This project uses Neocortex, a 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.
+
+## Canonical Project Memory
+
+`NEOCORTEX.md` is the canonical project-memory source. Antigravity/Gemini memory
+must resolve shared context back to that file. When durable platform context
+changes here, run `*update-memory` so `NEOCORTEX.md` is refreshed instead of
+letting platform-only memory drift.
+
+## Usage
+
+Invoke the Neocortex skill with your command. The skill will call `neocortex-client invoke` to fetch instructions from the server.
+
+### Examples
+
+- `@neocortex *menu` - Show interactive menu with all available commands
+- `@neocortex *status` - Show project status dashboard
+- `@neocortex *implement @docs/stories/1.1.story.md` - Implement a story
+
+## Activation
+
+```bash
+neocortex activate YOUR-LICENSE-KEY  # Get yours at https://neocortex.sh/portal/login
+```

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

@@ -0,0 +1,153 @@
+#!/bin/sh
+# Neocortex - Google Antigravity Install Adapter (Thin Client)
+# Simplified installer for npm tarball mode (targets-stubs only)
+
+# Additive JSON merge for Antigravity MCP config.
+# Canonical schema: root `mcpServers`; remote servers use `serverUrl`.
+# Managed legacy top-level entries are migrated into `mcpServers`; custom entries
+# are preserved as-is to avoid destructive conversion of user-owned config.
+_merge_antigravity_mcp() {
+    local stub_file="$1"
+    local dest_file="$2"
+
+    if [ ! -f "$dest_file" ]; then
+        cp "$stub_file" "$dest_file"
+        echo "[ANTIGRAVITY] Created MCP config: $dest_file"
+        return 0
+    fi
+
+    if command -v python3 >/dev/null 2>&1; then
+        local tmp="${dest_file}.neocortex.tmp"
+        if python3 - "$dest_file" "$stub_file" "$tmp" <<'PYEOF'
+import json, sys
+from pathlib import Path
+dest_path, stub_path, tmp_path = map(Path, sys.argv[1:4])
+managed = {"playwright", "context7", "browser_use", "figma", "shadcn", "chrome-devtools"}
+try:
+    with dest_path.open() as f:
+        dest = json.load(f)
+except Exception:
+    backup = dest_path.with_name(dest_path.name + ".neocortex-backup-parse-error")
+    backup.write_bytes(dest_path.read_bytes())
+    print(f"[ANTIGRAVITY] WARN: parseError backupCreated={backup}; original preserved")
+    sys.exit(0)
+with stub_path.open() as f:
+    stub = json.load(f)
+
+if not isinstance(dest, dict):
+    backup = dest_path.with_name(dest_path.name + ".neocortex-backup-structural")
+    backup.write_bytes(dest_path.read_bytes())
+    dest = {}
+    print(f"[ANTIGRAVITY] backupCreated={backup}")
+
+changed = False
+if not isinstance(dest.get("mcpServers"), dict):
+    if "mcpServers" in dest:
+        backup = dest_path.with_name(dest_path.name + ".neocortex-backup-structural")
+        backup.write_bytes(dest_path.read_bytes())
+        print(f"[ANTIGRAVITY] backupCreated={backup}")
+    dest["mcpServers"] = {}
+    changed = True
+
+migrated = []
+for name in list(dest.keys()):
+    if name in managed:
+        value = dest.pop(name)
+        if isinstance(value, dict) and "httpUrl" in value and "serverUrl" not in value:
+            value = dict(value)
+            value["serverUrl"] = value.pop("httpUrl")
+        dest["mcpServers"][name] = value
+        migrated.append(name)
+        changed = True
+
+updated = []
+added = []
+for name, value in stub.get("mcpServers", {}).items():
+    if name in dest["mcpServers"]:
+        updated.append(name)
+    else:
+        added.append(name)
+    dest["mcpServers"][name] = value
+    changed = True
+
+if changed:
+    with tmp_path.open('w') as f:
+        json.dump(dest, f, indent=2)
+        f.write('\n')
+else:
+    tmp_path.write_text(json.dumps(dest, indent=2) + '\n')
+print("[ANTIGRAVITY] migration summary: "
+      f"added={','.join(added) or '-'} updated={','.join(updated) or '-'} "
+      f"migrated={','.join(migrated) or '-'} preserved=custom")
+PYEOF
+        then
+            if [ -f "$tmp" ]; then
+                if ! cmp -s "$tmp" "$dest_file"; then
+                    cp "$dest_file" "${dest_file}.neocortex-backup-structural" 2>/dev/null || true
+                    mv "$tmp" "$dest_file"
+                else
+                    rm -f "$tmp"
+                fi
+            fi
+            echo "[ANTIGRAVITY] Merged MCP config into: $dest_file (via python3)"
+            return 0
+        fi
+        rm -f "$tmp"
+    fi
+
+    if command -v jq >/dev/null 2>&1; then
+        local tmp="${dest_file}.neocortex.tmp"
+        if jq -s '.[0].mcpServers = ((.[0].mcpServers // {}) * (.[1].mcpServers // {})) | .[0]' "$dest_file" "$stub_file" > "$tmp" 2>/dev/null; then
+            cp "$dest_file" "${dest_file}.neocortex-backup-structural" 2>/dev/null || true
+            mv "$tmp" "$dest_file"
+            echo "[ANTIGRAVITY] Merged MCP config into: $dest_file (via jq)"
+            return 0
+        fi
+        cp "$dest_file" "${dest_file}.neocortex-backup-parse-error" 2>/dev/null || true
+        rm -f "$tmp"
+    fi
+
+    echo "[ANTIGRAVITY] WARN: jq and python3 not found; leaving existing $dest_file untouched"
+    echo "[ANTIGRAVITY] WARN: Stub available at: $stub_file"
+    return 0
+}
+
+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. Additive merge MCP config (preserves user-configured servers)
+    if [ -f "$ag_target/mcp-config.json" ]; then
+        _merge_antigravity_mcp "$ag_target/mcp-config.json" "$gemini_home/antigravity/mcp_config.json" || true
+    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 YOUR-LICENSE-KEY  # Get yours at https://neocortex.sh/portal/login"
+    return 0
+}

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

@@ -0,0 +1,30 @@
+{
+  "mcpServers": {
+    "playwright": {
+      "command": "npx",
+      "args": ["-y", "@playwright/mcp@latest"]
+    },
+    "context7": {
+      "serverUrl": "https://mcp.context7.com/mcp"
+    },
+    "browser_use": {
+      "command": "uvx",
+      "args": ["--from", "browser-use[cli]", "browser-use", "--mcp"],
+      "env": {
+        "OPENAI_API_KEY": "${OPENAI_API_KEY}",
+        "ANTHROPIC_API_KEY": "${ANTHROPIC_API_KEY}"
+      }
+    },
+    "figma": {
+      "serverUrl": "https://mcp.figma.com/mcp"
+    },
+    "shadcn": {
+      "command": "npx",
+      "args": ["shadcn@latest", "mcp"]
+    },
+    "chrome-devtools": {
+      "command": "npx",
+      "args": ["-y", "chrome-devtools-mcp@latest"]
+    }
+  }
+}

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

@@ -0,0 +1,159 @@
+---
+name: neocortex
+description: "🧠 Neocortex v4.59.1 | OrNexus Team"
+---
+
+<!--
+  /loop equivalent in Antigravity (P95.09): Antigravity usa skill system proprio.
+  Quando o server retornar instrucoes de wrappers `loop-ci-watch`, `loop-deploy-health`
+  ou `loop-flaky-retry` (epic P95 -- YOLO Hardening), tente invocar uma skill `loop`
+  equivalente (se existir em Antigravity). Fail-open: se skill ausente, orquestre via
+  shell loop fallback. Cap iteracoes recomendado: 30.
+-->
+
+<!-- CRITICAL: Plugin Conflict Prevention -->
+## IMPORTANT: Do NOT Intercept Neocortex Arguments
+
+**ALL text after `@neocortex` or trigger keywords MUST be passed VERBATIM to `neocortex-client invoke`.**
+
+Tokens starting with `*` (e.g. `*commit-push`, `*implement`, `*status`, `*diagnose`,
+`*yolo`, `*review`, `*create-epic`, `*help`) are **Neocortex server triggers**, NOT
+Antigravity built-in commands, skills, or workflows.
+
+**Rules**:
+- NEVER interpret `*`-prefixed arguments as Antigravity built-in commands, skills, or workflows
+- NEVER invoke any local tool, skill, or workflow based on these arguments
+- NEVER attempt to resolve or execute these tokens as anything other than neocortex-client args
+- ALWAYS delegate the ENTIRE argument string to `neocortex-client invoke --args "..."`
+- The ONLY action this agent takes is: collect args -> invoke thin client -> follow server instructions
+
+<!-- END: Plugin Conflict Prevention -->
+
+# Neocortex - Thin Client Interface
+
+Voce e o agente Neocortex. Toda a logica de orquestracao e resolvida pelo server remoto.
+
+## Canonical Project Memory
+
+`NEOCORTEX.md` is the canonical project-memory source. This Antigravity skill
+preserves thin-client invocation while shared memory resolves back to
+`NEOCORTEX.md`. Run `*update-memory` when durable Antigravity-side context should
+be fed back into the canonical file.
+
+## Auto-Update Check
+
+BEFORE the first `neocortex-client invoke` call in each session, run this silent update check:
+
+```bash
+UPDATE_MARKER="$HOME/.neocortex/.update-check"
+if [ -f "$UPDATE_MARKER" ] && [ "$(find "$UPDATE_MARKER" -mmin -1440 2>/dev/null)" ]; then
+  : # Recently checked, skip
+else
+  INSTALLED=$(neocortex --version 2>/dev/null | head -1 | grep -oE '[0-9]+\.[0-9]+\.[0-9]+')
+  LATEST=$(npm view @ornexus/neocortex version 2>/dev/null)
+  if [ -n "$INSTALLED" ] && [ -n "$LATEST" ] && [ "$INSTALLED" != "$LATEST" ]; then
+    npm install -g @ornexus/neocortex@latest 2>/dev/null
+  fi
+  mkdir -p "$HOME/.neocortex" && touch "$UPDATE_MARKER" 2>/dev/null
+fi
+```
+
+Rules:
+- Run ONCE per session, NEVER repeat within the same conversation
+- If ANY command fails, ignore and proceed with `neocortex-client invoke` normally
+- Do NOT show output to user unless explicitly asked
+
+## 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 2>/dev/null || pwd -P)" \
+  --format plain
+```
+
+3. **Seguir EXATAMENTE as instrucoes retornadas** pelo thin client no stdout
+
+### Compatibilidade para entrada grande
+
+Use `--args` exatamente como mostrado acima para triggers normais e prompts
+delegados; isso preserva o encaminhamento legado verbatim. Se o usuario fornecer
+explicitamente uma story sintetica ou mega prompt grande demais para caber com
+seguranca em um argumento de shell, use exatamente uma fonte de entrada grande:
+
+```bash
+neocortex-client invoke --stdin --project-root "$(git rev-parse --show-toplevel 2>/dev/null || pwd -P)" --format plain < synthetic.story.md
+neocortex-client invoke --args-file ./synthetic.story.md --project-root "$(git rev-parse --show-toplevel 2>/dev/null || pwd -P)" --format plain
+```
+
+Nao force migracao para estas opcoes, nao combine com `--args`, e nao use estas
+opcoes para passar uma invocacao root externa ou historico completo para um
+child agent.
+
+## Exemplos
+
+| Invocacao do Usuario | Comando invoke |
+|---------------------|----------------|
+| `@neocortex *menu` | `invoke --args "*menu"` |
+| `@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: "Visite https://neocortex.sh/portal/login para obter sua license key, depois execute: `neocortex activate SUA-LICENSE-KEY`" |
+
+## Regras
+
+### 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 Antigravity:
+
+- **File operations** (read / write / edit / glob / grep) - exploracao e manipulacao do projeto local
+- **Shell / terminal** - qualquer ferramenta CLI (jq, curl, psql, docker, fly, gh, etc.)
+- **Browser automation** (built-in via Antigravity's browser tools) - screenshots,
+  visual research, scraping
+- **Web search / fetch** - pesquisa de mercado, validacao de hipoteses, references reais
+- **MCP servers configurados** (context7, playwright) - documentacao atualizada de
+  libs/frameworks, automacao de navegador adicional. Ver `~/.gemini/antigravity/mcp_config.json`.
+
+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.
+
+## Yoloop on Antigravity (P122.05)
+
+If your Antigravity runtime exposes a `/loop` analog, follow the Claude Code pattern
+from `targets-stubs/claude-code/neocortex.md` (Yoloop Auto-Orchestration section).
+
+If not, fall back to the shell-loop pattern from
+`docs/arquitetura-software/loop-usage-guide.md` (Platform Matrix).
+
+```bash
+while true; do
+  RESPONSE=$(neocortex-client invoke --args "*yoloop @docs/epics/" --format plain)
+  echo "$RESPONSE"
+  echo "$RESPONSE" | grep -q '\[YOLOOP_COMPLETE\]' && break
+  echo "$RESPONSE" | grep -q '\[YOLOOP_ABORTED\]' && break
+done
+```
+
+Termination tokens: `[YOLOOP_COMPLETE]` (success) and `[YOLOOP_ABORTED]` (failure).

package/targets-stubs/claude-code/.mcp.json

@@ -0,0 +1,32 @@
+{
+  "mcpServers": {
+    "playwright": {
+      "command": "npx",
+      "args": ["-y", "@playwright/mcp@latest"]
+    },
+    "context7": {
+      "type": "http",
+      "url": "https://mcp.context7.com/mcp"
+    },
+    "browser_use": {
+      "command": "uvx",
+      "args": ["--from", "browser-use[cli]", "browser-use", "--mcp"],
+      "env": {
+        "OPENAI_API_KEY": "${OPENAI_API_KEY}",
+        "ANTHROPIC_API_KEY": "${ANTHROPIC_API_KEY}"
+      }
+    },
+    "figma": {
+      "type": "http",
+      "url": "https://mcp.figma.com/mcp"
+    },
+    "shadcn": {
+      "command": "npx",
+      "args": ["shadcn@latest", "mcp"]
+    },
+    "chrome-devtools": {
+      "command": "npx",
+      "args": ["-y", "chrome-devtools-mcp@latest"]
+    }
+  }
+}

package/targets-stubs/claude-code/README.md

@@ -0,0 +1,20 @@
+# Neocortex Target Stub
+
+This content is served by the **IP Protection Server**.
+
+The full target configuration, agent definitions, and pipeline instructions
+are delivered securely via the Neocortex remote content delivery system.
+
+## To activate remote mode:
+
+```bash
+neocortex activate YOUR-LICENSE-KEY  # Get yours at https://neocortex.sh/portal/login
+```
+
+## To use local mode (developers only):
+
+```bash
+neocortex install --local
+```
+
+For more information, visit: https://neocortex.sh

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

@@ -0,0 +1,42 @@
+agent:
+  metadata:
+    id: agents/neocortex-root
+    name: 'Neocortex Root Agent'
+    title: 'Development Orchestrator (Root)'
+    icon: '>'
+    version: '4.59.1'
+    architecture: 'thin-client'
+    module: stand-alone
+    hasSidecar: false
+    language: 'pt-BR'
+    resolution: 'remote'
+
+  model: opus
+
+  tools:
+    - Bash
+    - Read
+    - Write
+    - Edit
+    - NotebookEdit
+    - Glob
+    - Grep
+    - Task
+    - TaskCreate
+    - Skill
+    - WebSearch
+    - WebFetch
+    - mcp__context7__resolve-library-id
+    - mcp__context7__query-docs
+    - mcp__playwright__browser_navigate
+    - mcp__playwright__browser_snapshot
+    - mcp__playwright__browser_take_screenshot
+    - mcp__playwright__browser_click
+    - mcp__playwright__browser_type
+    - mcp__playwright__browser_evaluate
+    - mcp__playwright__browser_console_messages
+    - mcp__playwright__browser_network_requests
+    - mcp__playwright__browser_wait_for
+    - mcp__playwright__browser_close
+
+  instructions: neocortex-root.md