@ornexus/neocortex 4.0.1

package/postinstall.js

@@ -0,0 +1,272 @@
+#!/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');
+
+  // Story 32.09: Force stub refresh after successful install
+  forceStubRefresh();
+
+  // Story 32.07: Check server compatibility (fire-and-forget)
+  checkServerCompatibility();
+}
+
+function showErrorMessage() {
+  console.error('\n[x] Neocortex installation failed.\n');
+  console.error('Troubleshooting:');
+  console.error('  1. Try again: npm install -g @ornexus/neocortex');
+  console.error('  2. Check file permissions in your home directory');
+  console.error('  3. Report at: https://github.com/OrNexus-AI/neocortex/issues\n');
+}
+
+function runInstaller() {
+  const platform = os.platform();
+
+  // Epic 64: Check NEOCORTEX_DEBUG env var for debug mode
+  const debugMode = process.env.NEOCORTEX_DEBUG === '1';
+
+  if (platform === 'win32') {
+    // Windows: run install.ps1
+    const scriptPath = path.join(__dirname, 'install.ps1');
+    if (!fs.existsSync(scriptPath)) {
+      showUsageMessage();
+      return;
+    }
+
+    const baseFlags = ['-NoProfile', '-ExecutionPolicy', 'Bypass', '-File', scriptPath];
+    const quietFlags = ['-Yes', '-Quiet', '-SkipProject'];
+    const retryFlags = ['-Yes', '-SkipProject'];
+    if (debugMode) {
+      quietFlags.push('-Debug');
+      retryFlags.push('-Debug');
+    }
+
+    const shells = ['pwsh', 'powershell'];
+    let hasRetried = false;
+
+    function retryWithoutQuiet(shellCmd) {
+      if (hasRetried) {
+        showErrorMessage();
+        return;
+      }
+      hasRetried = true;
+      console.log('\nInstalacao falhou. Re-executando com output detalhado...\n');
+      const retryChild = spawn(shellCmd, [...baseFlags, ...retryFlags], {
+        stdio: 'inherit', shell: false, timeout: 60000
+      });
+      retryChild.on('error', () => showErrorMessage());
+      retryChild.on('exit', (retryCode) => {
+        if (retryCode === 0) {
+          showUsageMessage();
+        } else {
+          showErrorMessage();
+        }
+      });
+    }
+
+    function tryShell(index) {
+      if (index >= shells.length) {
+        // Epic 65: Don't show "Neocortex instalado!" when no shell was found
+        console.error('\n[!] PowerShell nao encontrado (pwsh ou powershell).');
+        console.error('    Instale manualmente: npx @ornexus/neocortex\n');
+        return;
+      }
+      const child = spawn(shells[index], [...baseFlags, ...quietFlags], {
+        stdio: 'inherit', shell: false
+      });
+
+      child.on('error', () => tryShell(index + 1));
+      child.on('exit', (code) => {
+        if (code === 0) {
+          showUsageMessage();
+        } else {
+          retryWithoutQuiet(shells[index]);
+        }
+      });
+    }
+    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 quietArgs = [scriptPath, '--yes', '--quiet', '--skip-project'];
+    const retryArgs = [scriptPath, '--yes', '--skip-project'];
+    if (debugMode) {
+      quietArgs.push('--debug');
+      retryArgs.push('--debug');
+    }
+    let hasRetried = false;
+
+    function retryUnixWithoutQuiet(shellCmd) {
+      if (hasRetried) {
+        showErrorMessage();
+        return;
+      }
+      hasRetried = true;
+      console.log('\nInstalacao falhou. Re-executando com output detalhado...\n');
+      const retryChild = spawn(shellCmd, retryArgs, {
+        stdio: 'inherit', shell: false, timeout: 60000
+      });
+      retryChild.on('error', () => showErrorMessage());
+      retryChild.on('exit', (retryCode) => {
+        if (retryCode === 0) {
+          showUsageMessage();
+        } else {
+          showErrorMessage();
+        }
+      });
+    }
+
+    const child = spawn('bash', quietArgs, { stdio: 'inherit', shell: false });
+
+    child.on('error', () => {
+      // Fallback to sh
+      const shChild = spawn('sh', quietArgs, { stdio: 'inherit', shell: false });
+      shChild.on('error', () => showUsageMessage());
+      shChild.on('exit', (code) => {
+        if (code === 0) {
+          showUsageMessage();
+        } else {
+          retryUnixWithoutQuiet('sh');
+        }
+      });
+    });
+    child.on('exit', (code) => {
+      if (code === 0) {
+        showUsageMessage();
+      } else {
+        retryUnixWithoutQuiet('bash');
+      }
+    });
+  }
+}
+
+/**
+ * Story 32.09: Force stub refresh by deleting .version files from target directories.
+ * This ensures next invoke detects version mismatch and copies updated stubs.
+ * Fire-and-forget, fail-open.
+ */
+function forceStubRefresh() {
+  try {
+    const homeDir = os.homedir();
+    const targets = [
+      path.join(homeDir, '.claude', 'agents', 'neocortex', '.version'),
+      path.join(homeDir, '.cursor', 'agents', '.version'),
+      path.join(homeDir, '.gemini', 'agents', '.version'),
+      path.join(homeDir, '.codex', '.version'),
+      path.join(homeDir, '.vscode', '.version'),
+      path.join(homeDir, '.agent', 'skills', 'neocortex', '.version'),
+    ];
+
+    for (const versionFile of targets) {
+      try {
+        if (fs.existsSync(versionFile)) {
+          fs.unlinkSync(versionFile);
+        }
+      } catch { /* ignore per-file errors */ }
+    }
+  } catch { /* ignore */ }
+}
+
+/**
+ * Story 32.07: Check server compatibility after install.
+ * Informative only -- never blocks. Timeout 5s, all errors ignored.
+ */
+function checkServerCompatibility() {
+  try {
+    const https = require('https');
+    let clientVersion;
+    try {
+      const pkg = require('./package.json');
+      clientVersion = pkg.version;
+    } catch { return; }
+
+    const serverUrl = 'https://api.neocortex.sh/health';
+
+    const req = https.get(serverUrl, { timeout: 5000 }, (res) => {
+      let data = '';
+      res.on('data', (chunk) => { data += chunk; });
+      res.on('end', () => {
+        try {
+          const health = JSON.parse(data);
+          if (health.minClientVersion && !isVersionAtLeastInline(clientVersion, health.minClientVersion)) {
+            console.log('\n[!] Aviso: esta versao do client (' + clientVersion + ') pode nao ser compativel.');
+            console.log('    Versao minima do server: ' + health.minClientVersion);
+            console.log('    Atualize: npm install -g @ornexus/neocortex@latest\n');
+          }
+        } catch { /* ignore */ }
+      });
+    });
+
+    req.on('error', () => { /* ignore - network may not be available */ });
+    req.on('timeout', () => { req.destroy(); });
+  } catch { /* ignore */ }
+}
+
+/**
+ * Story 32.07: Inline semver comparison (no external deps).
+ */
+function isVersionAtLeastInline(version, minVersion) {
+  try {
+    const parse = (v) => {
+      const m = v.replace(/^v/, '').match(/^(\d+)\.(\d+)\.(\d+)/);
+      return m ? [parseInt(m[1]), parseInt(m[2]), parseInt(m[3])] : null;
+    };
+    const v = parse(version);
+    const min = parse(minVersion);
+    if (!v || !min) return true;
+    if (v[0] !== min[0]) return v[0] > min[0];
+    if (v[1] !== min[1]) return v[1] > min[1];
+    return v[2] >= min[2];
+  } catch { return true; }
+}
+
+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/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.ornexus.com/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://github.com/OrNexus-AI/neocortex

package/targets-stubs/antigravity/gemini.md

@@ -0,0 +1,22 @@
+# 🧠 Neocortex v4.0.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.
+
+## 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.ornexus.com/login
+```

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 YOUR-LICENSE-KEY  # Get yours at https://neocortex.ornexus.com/login"
+    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,67 @@
+---
+name: neocortex
+description: "🧠 Neocortex v4.0.1 | OrNexus Team"
+---
+
+<!-- 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.
+
+## 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 *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.ornexus.com/login para obter sua license key, depois execute: `neocortex activate SUA-LICENSE-KEY`" |
+
+## 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/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.ornexus.com/login
+```
+
+## To use local mode (developers only):
+
+```bash
+neocortex install --local
+```
+
+For more information, visit: https://github.com/OrNexus-AI/neocortex

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

@@ -0,0 +1,24 @@
+agent:
+  metadata:
+    id: agents/neocortex
+    name: 'Neocortex'
+    title: 'Development Orchestrator'
+    icon: '>'
+    version: '4.0.1'
+    architecture: 'thin-client'
+    module: stand-alone
+    hasSidecar: false
+    language: 'pt-BR'
+    resolution: 'remote'
+
+  model: opus
+
+  tools:
+    - Bash
+    - Read
+    - Write
+    - Edit
+    - Glob
+    - Grep
+
+  instructions: neocortex.md

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

@@ -0,0 +1,125 @@
+---
+name: neocortex
+description: "🧠 Neocortex v4.0.1 | OrNexus Team"
+model: opus
+color: blue
+tools:
+  - Read
+  - Write
+  - Edit
+  - Glob
+  - Grep
+  - Task
+  - "Bash(neocortex-client:*)"
+  - "Bash(neocortex:*)"
+  - "Bash(git:*)"
+  - "Bash(gh:*)"
+  - "Bash(npm:*)"
+  - "Bash(npx:*)"
+  - "Bash(node:*)"
+  - "Bash(tsx:*)"
+  - "Bash(curl:*)"
+  - "Bash(docker:*)"
+  - "Bash(fly:*)"
+  - "Bash(flyctl:*)"
+  - "Bash(jq:*)"
+  - "Bash(mkdir:*)"
+  - "Bash(rm:*)"
+  - "Bash(mv:*)"
+  - "Bash(cp:*)"
+  - "Bash(ls:*)"
+  - "Bash(cat:*)"
+  - "Bash(date:*)"
+  - "Bash(stat:*)"
+  - "Bash(hostname:*)"
+  - "Bash(mktemp:*)"
+  - "Bash(ps:*)"
+---
+
+<!-- CRITICAL: Plugin Conflict Prevention -->
+## IMPORTANT: Do NOT Intercept Neocortex Arguments
+
+**ALL text after `@neocortex` 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
+Claude Code Skills, Slash Commands, or MCP plugins.
+
+**Rules**:
+- NEVER interpret `*`-prefixed arguments as local Skills (`Skill()`), Commands, or plugins
+- NEVER invoke any local Skill, Command, or plugin based on these arguments
+- NEVER attempt fuzzy-matching against installed plugins (e.g. `commit-commands:commit-push-pr`)
+- 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.
+
+## Banner
+
+SEMPRE que este agente for invocado, imprima o banner abaixo como PRIMEIRO output, dentro de um bloco de codigo (triple backticks). Copie o conteudo entre as tags `<banner>` EXATAMENTE como esta:
+
+<banner>
+┌────────────────────────────────────────────────────────────┐
+│                                                            │
+│       #######           N E O C O R T E X                  │
+│      ###  ########      v4.0.1                             │
+│ #########      #####                                       │
+│ ##    ##############    Development Orchestrator           │
+│ ##   ###  ######  ##    OrNexus Team                       │
+│ ##   ###    ###   ##                                       │
+│ ##  ######  ###   ##                                       │
+│ ###############   ##                                       │
+│ #####       ########                                       │
+│   ########  ##                                             │
+│        #######                                             │
+│                                                            │
+└────────────────────────────────────────────────────────────┘
+</banner>
+
+Apos imprimir o banner, prossiga com o protocolo de invocacao abaixo.
+
+## 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 *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"` |
+| `@neocortex *create-epic "COMO dev, QUERO auth, PARA seguranca"` | `invoke --args '*create-epic "COMO dev, QUERO auth, PARA seguranca"'` |
+
+## 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.ornexus.com/login para obter sua license key, depois execute: `neocortex activate SUA-LICENSE-KEY`" |
+
+## 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/codex/README.md

@@ -0,0 +1,32 @@
+# Target Stub: OpenAI Codex CLI
+
+**Thin Client Mode** | Remote content delivery
+
+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.ornexus.com/login
+```
+
+## Contents
+
+| 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