@ornexus/neocortex 4.0.1

package/LICENSE

@@ -0,0 +1,56 @@
+Business Source License 1.1
+
+Parameters
+
+Licensor:             OrNexus AI
+Licensed Work:        @ornexus/neocortex v3.8.0 and later versions
+Additional Use Grant: You may use the Licensed Work for personal development,
+                      evaluation, and non-commercial projects without a
+                      commercial license.
+Change Date:          Four (4) years from the date of each release of the
+                      Licensed Work.
+Change License:       Apache License, Version 2.0
+
+For the full text of the Business Source License 1.1, see:
+https://mariadb.com/bsl11/
+
+Notice
+
+The Licensed Work is (c) 2024-2026 OrNexus AI.
+
+-----------------------------------------------------------------------------
+
+IMPORTANT: The full BSL-1.1 legal text must be inserted here before
+publication. The canonical template is available at:
+
+  https://mariadb.com/bsl11/
+
+Reference implementations:
+  - HashiCorp (Terraform): https://github.com/hashicorp/terraform/blob/main/LICENSE
+  - CockroachDB: https://github.com/cockroachdb/cockroach/blob/master/licenses/BSL.txt
+  - Sentry: https://github.com/getsentry/sentry/blob/master/LICENSE.md
+
+TODO: Replace this placeholder with the complete BSL-1.1 text with the
+parameters above filled in. Have legal counsel review before publishing.
+
+-----------------------------------------------------------------------------
+
+What you CAN do:
+
+  - Use Neocortex for personal projects and learning
+  - Use Neocortex for evaluation and testing purposes
+  - Use Neocortex for non-commercial open source projects
+  - Contribute to the Neocortex project
+  - Fork and modify for personal use
+
+What you CANNOT do without a commercial license:
+
+  - Use Neocortex in production environments that generate revenue
+  - Redistribute Neocortex as part of a commercial product
+  - Offer Neocortex as a hosted service to third parties
+  - Extract, copy, or redistribute the proprietary prompts, workflows,
+    skills, or agent definitions
+
+For commercial licensing inquiries:
+  Email: licensing@ornexus.com
+  Web:   https://ornexus.com/licensing

package/README.md

@@ -0,0 +1,32 @@
+# Neocortex
+
+**AI-powered development orchestrator. From idea to pull request.**
+
+Neocortex automates the full software development lifecycle -- architecture planning, implementation, code review, and deployment -- across 6 AI platforms including Claude Code, Cursor, Gemini CLI, Codex, VS Code, and Antigravity.
+
+## Get Started
+
+Visit **[neocortex.sh](https://neocortex.sh)** to create your account, install, and activate.
+
+```bash
+npm install -g @ornexus/neocortex
+```
+
+After installing, activate your license and start building:
+
+```
+neocortex activate YOUR-LICENSE-KEY
+```
+
+Full documentation, pricing, and support available at [neocortex.sh](https://neocortex.sh).
+
+## License
+
+Business Source License 1.1 (BSL-1.1). See [LICENSE](./LICENSE) for details.
+
+Personal and development use is free. Commercial production use requires a license.
+Contact: licensing@ornexus.com
+
+---
+
+Built by [OrNexus Team](https://neocortex.sh)

package/install.js

@@ -0,0 +1,486 @@
+#!/usr/bin/env node
+
+/**
+ * Neocortex - Cross-Platform Multi-Target Installer
+ * Interactive platform selection with @clack/prompts + OS detection + shell dispatch
+ */
+
+const { spawn } = require('child_process');
+const path = require('path');
+const os = require('os');
+const fs = require('fs');
+const {
+    intro, outro, multiselect, confirm, spinner, cancel, isCancel, note, log
+} = require('@clack/prompts');
+const color = require('picocolors');
+
+const SCRIPT_DIR = __dirname;
+const args = process.argv.slice(2);
+
+// Read version from package.json
+const pkg = JSON.parse(fs.readFileSync(path.join(SCRIPT_DIR, 'package.json'), 'utf8'));
+const VERSION = pkg.version;
+
+// ═══════════════════════════════════════════════════════════════════
+// PLATFORM DEFINITIONS
+// ═══════════════════════════════════════════════════════════════════
+
+const PLATFORMS = [
+    { name: 'Claude Code CLI', key: 'claude-code', tier: 1, default: true, detect: 'claude', label: 'Tier 1 - Full Pipeline' },
+    { name: 'Cursor IDE', key: 'cursor', tier: 2, default: false, detect: 'cursor', label: 'Tier 2 - CLI Pipeline' },
+    { name: 'VS Code / GitHub Copilot', key: 'vscode', tier: 3, default: false, detect: 'code', label: 'Tier 3 - Agent-Directed' },
+    { name: 'Gemini CLI', key: 'gemini-cli', tier: 2, default: false, detect: 'gemini', label: 'Tier 2 - CLI Pipeline' },
+    { name: 'OpenAI Codex CLI', key: 'codex', tier: 2, default: false, detect: 'codex', label: 'Tier 2 - CLI Pipeline' },
+    { name: 'Google Antigravity', key: 'antigravity', tier: 3, default: false, detect: 'agy', label: 'Tier 3 - Agent-Directed', experimental: true },
+];
+
+// ═══════════════════════════════════════════════════════════════════
+// PLATFORM DETECTION
+// ═══════════════════════════════════════════════════════════════════
+
+function detectPlatform(command) {
+    const { execSync } = require('child_process');
+    try {
+        // Platform-aware detection: `where.exe` on Windows, `which` on Unix
+        // `which` does not exist natively on Windows (Epic 63 - Story 63.4)
+        if (process.platform === 'win32') {
+            // Epic 67 - Story 67.4: Use where.exe /Q (quiet mode) to suppress
+            // localized error messages (e.g., "INFO: ..." in non-EN locales).
+            // /Q returns only exit code without any stdout/stderr output.
+            execSync(`where.exe /Q ${command}`, { stdio: 'pipe' });
+        } else {
+            execSync(`which ${command} 2>/dev/null`, { stdio: 'pipe' });
+        }
+        return true;
+    } catch {
+        return false;
+    }
+}
+
+function detectInstalledPlatforms() {
+    const detected = {};
+    for (const p of PLATFORMS) {
+        detected[p.key] = detectPlatform(p.detect);
+    }
+    return detected;
+}
+
+// ═══════════════════════════════════════════════════════════════════
+// ARGUMENT HANDLING
+// ═══════════════════════════════════════════════════════════════════
+
+function parseTargetsArg() {
+    for (const arg of args) {
+        if (arg.startsWith('--targets=')) {
+            return arg.replace('--targets=', '').split(',').map(t => t.trim()).filter(Boolean);
+        }
+    }
+    return null;
+}
+
+function isAutoYes() {
+    return args.includes('-y') || args.includes('--yes') || args.includes('-Yes');
+}
+
+function isVersion() {
+    return args.includes('-v') || args.includes('--version') || args.includes('-V');
+}
+
+function isHelp() {
+    return args.includes('-h') || args.includes('--help') || args.includes('-Help');
+}
+
+function isDebug() {
+    return args.includes('-d') || args.includes('--debug') || args.includes('-Debug');
+}
+
+/**
+ * Declarative flag mapping: Unix CLI flags -> PowerShell parameters.
+ * To add a new flag, just add an entry here. No switch/case to update.
+ */
+const FLAG_MAP_WIN32 = {
+    // Auto-confirm mode
+    '-y': '-Yes',
+    '--yes': '-Yes',
+    // Debug output
+    '-d': '-Debug',
+    '--debug': '-Debug',
+    // Skip project directory creation
+    '-s': '-SkipProject',
+    '--skip-project': '-SkipProject',
+    // Force project directory creation
+    '--create-project': '-CreateProject',
+    // Suppress non-essential output
+    '-q': '-Quiet',
+    '--quiet': '-Quiet',
+    // Suppress ASCII banner
+    '--no-banner': '-NoBanner',
+    // Show help text
+    '-h': '-Help',
+    '--help': '-Help',
+    // Remove legacy artifacts from ~/.claude/
+    '--cleanup-legacy': '-CleanupLegacy',
+    // --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)
+};
+
+function mapArgs(platform, originalArgs) {
+    const filtered = originalArgs.filter(a => !a.startsWith('--targets='));
+    if (platform === 'win32') {
+        return filtered.map(arg => FLAG_MAP_WIN32[arg] || arg);
+    }
+    return filtered;
+}
+
+// ═══════════════════════════════════════════════════════════════════
+// SCRIPT EXECUTION
+// ═══════════════════════════════════════════════════════════════════
+
+function checkScript(scriptPath) {
+    if (!fs.existsSync(scriptPath)) {
+        log.error(`Script nao encontrado: ${scriptPath}`);
+        process.exit(1);
+    }
+}
+
+function runWindows(selectedTargets) {
+    const scriptPath = path.join(SCRIPT_DIR, 'install.ps1');
+    checkScript(scriptPath);
+
+    const mappedArgs = mapArgs('win32', args);
+    if (selectedTargets) {
+        mappedArgs.push('-Targets', selectedTargets.join(','));
+    }
+
+    const shells = ['pwsh', 'powershell'];
+
+    function tryShell(index) {
+        if (index >= shells.length) {
+            log.error('PowerShell nao encontrado.');
+            log.info('Instale o PowerShell Core: https://aka.ms/powershell');
+            process.exit(1);
+        }
+
+        const shell = shells[index];
+        const psArgs = ['-NoProfile', '-ExecutionPolicy', 'Bypass', '-File', scriptPath, ...mappedArgs];
+
+        const child = spawn(shell, psArgs, { stdio: 'inherit', shell: false });
+
+        child.on('error', (err) => {
+            if (err.code === 'ENOENT') tryShell(index + 1);
+            else {
+                log.error(`Falha ao executar ${shell}: ${err.message}`);
+                process.exit(1);
+            }
+        });
+
+        child.on('exit', (code) => process.exit(code || 0));
+    }
+
+    tryShell(0);
+}
+
+function runUnix(selectedTargets) {
+    const scriptPath = path.join(SCRIPT_DIR, 'install.sh');
+    checkScript(scriptPath);
+
+    try { fs.chmodSync(scriptPath, '755'); } catch { }
+
+    const filteredArgs = mapArgs('unix', args);
+    if (selectedTargets) {
+        filteredArgs.push(`--targets=${selectedTargets.join(',')}`);
+    }
+
+    const child = spawn('bash', [scriptPath, ...filteredArgs], { stdio: 'inherit', shell: false });
+
+    child.on('error', (err) => {
+        if (err.code === 'ENOENT') {
+            const shChild = spawn('sh', [scriptPath, ...filteredArgs], { stdio: 'inherit', shell: false });
+            shChild.on('error', (e) => { log.error(`Shell nao encontrado: ${e.message}`); process.exit(1); });
+            shChild.on('exit', (code) => process.exit(code || 0));
+        } else {
+            log.error(`Falha ao executar instalador: ${err.message}`);
+            process.exit(1);
+        }
+    });
+
+    child.on('exit', (code) => process.exit(code || 0));
+}
+
+// ═══════════════════════════════════════════════════════════════════
+// HELP
+// ═══════════════════════════════════════════════════════════════════
+
+function showHelp() {
+    console.log('');
+    console.log(color.bold(`  Neocortex Installer v${VERSION}`));
+    console.log(color.dim('  Development Orchestrator'));
+    console.log('');
+    console.log(`  ${color.dim('Uso:')} npx @ornexus/neocortex ${color.dim('[opcoes]')}`);
+    console.log(`        npx @ornexus/neocortex activate ${color.dim('<KEY>')}`);
+    console.log('');
+    console.log(color.dim('  Comandos:'));
+    console.log(`    ${color.cyan('activate <KEY>')}            Ativar licenca (repara config se necessario)`);
+    console.log(`    ${color.cyan('invoke --args <args>')}      Invocar o server (thin-client)`);
+    console.log('');
+    console.log(color.dim('  Opcoes:'));
+    console.log(`    ${color.cyan('-y, --yes')}                 Modo automatico (Claude Code only)`);
+    console.log(`    ${color.cyan('--targets=<lista>')}         Plataformas separadas por virgula`);
+    console.log(`    ${color.cyan('--create-project')}          Instalar estrutura no projeto`);
+    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.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('-v, --version')}             Mostra a versao instalada`);
+    console.log(`    ${color.cyan('-h, --help')}                Mostra esta ajuda`);
+    console.log('');
+    console.log(color.dim('  Plataformas:'));
+    for (const p of PLATFORMS) {
+        const tag = p.experimental ? color.red(' [experimental]') : '';
+        console.log(`    ${color.cyan(p.key.padEnd(20))} ${p.name} ${color.dim(`(${p.label})`)}${tag}`);
+    }
+    console.log('');
+    console.log(color.dim('  Exemplos:'));
+    console.log(`    npx @ornexus/neocortex                              ${color.dim('# Selecao interativa')}`);
+    console.log(`    npx @ornexus/neocortex --yes                        ${color.dim('# Claude Code (auto)')}`);
+    console.log(`    npx @ornexus/neocortex --targets=claude-code,cursor`);
+    console.log('');
+    process.exit(0);
+}
+
+// ═══════════════════════════════════════════════════════════════════
+// INTERACTIVE WIZARD
+// ═══════════════════════════════════════════════════════════════════
+
+async function interactiveWizard() {
+    // Detect installed platforms
+    const s = spinner();
+    s.start('Detectando plataformas instaladas...');
+    const detected = detectInstalledPlatforms();
+    const detectedNames = PLATFORMS.filter(p => detected[p.key]).map(p => p.name);
+    s.stop(
+        detectedNames.length > 0
+            ? `${detectedNames.length} plataforma(s) detectada(s): ${color.dim(detectedNames.join(', '))}`
+            : 'Nenhuma plataforma detectada automaticamente'
+    );
+
+    // Platform selection
+    const options = PLATFORMS.map(p => {
+        const hints = [];
+        if (detected[p.key]) hints.push('detectado');
+        if (p.experimental) hints.push('experimental');
+        hints.push(p.label);
+
+        return {
+            value: p.key,
+            label: p.name,
+            hint: hints.join(' | '),
+        };
+    });
+
+    const selectedPlatforms = await multiselect({
+        message: 'Selecione as plataformas de destino:',
+        options,
+        initialValues: PLATFORMS.filter(p => p.default).map(p => p.key),
+        required: true,
+    });
+
+    if (isCancel(selectedPlatforms)) {
+        cancel('Instalacao cancelada.');
+        process.exit(0);
+    }
+
+    // Show selection summary
+    const selectedNames = selectedPlatforms.map(key => {
+        const p = PLATFORMS.find(pl => pl.key === key);
+        return p.name;
+    });
+    log.info(`Plataformas: ${color.bold(selectedNames.join(', '))}`);
+
+    // Ask about project-level installation
+    let createProject = false;
+    if (!args.includes('-s') && !args.includes('--skip-project')) {
+        const projectInstall = await confirm({
+            message: 'Instalar estrutura completa no diretorio atual do projeto?',
+            initialValue: false,
+        });
+
+        if (isCancel(projectInstall)) {
+            cancel('Instalacao cancelada.');
+            process.exit(0);
+        }
+
+        createProject = projectInstall;
+    }
+
+    return { selectedPlatforms, createProject };
+}
+
+// ═══════════════════════════════════════════════════════════════════
+// ASCII BANNER
+// ═══════════════════════════════════════════════════════════════════
+
+function showAsciiBanner() {
+    const c = '\x1b[36m';  // cyan
+    const b = '\x1b[1m';  // bold
+    const d = '\x1b[2m';  // dim
+    const r = '\x1b[0m';  // reset
+
+    console.log('');
+    console.log(`${c}       #######${r}`);
+    console.log(`${c}      ###  ########${r}`);
+    console.log(`${c} #########      #####${r}`);
+    console.log(`${c} ##    ##############    ${b}N E O C O R T E X${r}`);
+    console.log(`${c} ##   ###  ######  ##    ${b}v${VERSION}${r}`);
+    console.log(`${c} ##   ###    ###   ##${r}`);
+    console.log(`${c} ##  ######  ###   ##    ${d}OrNexus Team${r}`);
+    console.log(`${c} ###############   ##${r}`);
+    console.log(`${c} #####       ########${r}`);
+    console.log(`${c}   ########  ##${r}`);
+    console.log(`${c}        #######${r}`);
+    console.log('');
+}
+
+// ═══════════════════════════════════════════════════════════════════
+// MAIN
+// ═══════════════════════════════════════════════════════════════════
+
+async function main() {
+    const platform = os.platform();
+
+    // ── Subcommand delegation (Epic 70 - Story 70.01) ─────────────────
+    // Delegate known subcommands to neocortex-client binary.
+    // This ensures `neocortex activate KEY` reaches the activate handler
+    // instead of running the installation wizard.
+    const DELEGATED_COMMANDS = new Set(['activate', 'invoke', 'cache-status']);
+    const firstArg = args[0]?.toLowerCase();
+    if (firstArg && DELEGATED_COMMANDS.has(firstArg)) {
+        // Resolve neocortex-client: prefer sibling in same bin directory (npm shim),
+        // fallback to direct path to dist/cli.js within the package.
+        const clientBinDirect = path.join(SCRIPT_DIR, 'packages', 'client', 'dist', 'cli.js');
+        const child = spawn(process.execPath, [clientBinDirect, ...args], {
+            stdio: 'inherit',
+            env: process.env,
+        });
+        child.on('error', (err) => {
+            console.error(`Failed to delegate to neocortex-client: ${err.message}`);
+            process.exit(1);
+        });
+        child.on('exit', (code) => process.exit(code ?? 1));
+        return; // Do not continue with install wizard
+    }
+
+    // Version flag -- print just the version number and exit (for scripting)
+    if (isVersion()) {
+        console.log(VERSION);
+        return;
+    }
+
+    // Debug info
+    if (isDebug()) {
+        console.log(color.dim(`  [debug] Platform: ${platform} | Node: ${process.version} | Dir: ${SCRIPT_DIR}`));
+        console.log(color.dim(`  [debug] Args: ${args.join(' ') || '(none)'}`));
+        console.log('');
+    }
+
+    // Help
+    if (isHelp()) {
+        showHelp();
+        return;
+    }
+
+    // Determine selected targets
+    let selectedTargets = null;
+    let createProject = false;
+
+    // Priority 1: --targets= argument
+    const targetsArg = parseTargetsArg();
+    if (targetsArg) {
+        const validKeys = PLATFORMS.map(p => p.key);
+        const invalid = targetsArg.filter(t => !validKeys.includes(t));
+        if (invalid.length > 0) {
+            console.log('');
+            log.error(`Plataformas invalidas: ${color.bold(invalid.join(', '))}`);
+            log.info(`Validas: ${validKeys.join(', ')}`);
+            process.exit(1);
+        }
+        selectedTargets = targetsArg;
+
+        // In non-interactive mode with explicit targets, still check for project flag
+        if (args.includes('--create-project')) createProject = true;
+    }
+    // Priority 2: --yes flag = Claude Code only (backward compat)
+    else if (isAutoYes()) {
+        selectedTargets = ['claude-code'];
+        createProject = true;
+    }
+    // Priority 3: Interactive selection (if TTY)
+    else if (process.stdin.isTTY && process.stdout.isTTY) {
+        showAsciiBanner();
+        intro(color.bgWhite(color.black(` Neocortex v${VERSION} `)));
+
+        const result = await interactiveWizard();
+        selectedTargets = result.selectedPlatforms;
+        createProject = result.createProject;
+
+        if (selectedTargets.length === 0) {
+            cancel('Nenhuma plataforma selecionada.');
+            process.exit(0);
+        }
+    }
+    // Priority 4: Non-interactive, no flags = Claude Code only
+    else {
+        selectedTargets = ['claude-code'];
+    }
+
+    // ── 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 (!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 {
+            // Strip UTF-8 BOM if present (PowerShell 5.1 writes BOM via Out-File -Encoding utf8)
+            // Defense in depth: handles configs written by old PS 5.1 installers (Epic 63 - Story 63.1)
+            const cfg = JSON.parse(fs.readFileSync(configPath, 'utf-8').replace(/^\uFEFF/, ''));
+            if (cfg.mode === 'remote') {
+                log.info(color.dim(`Remote mode active (server: ${cfg.serverUrl || 'default'})`));
+            }
+        } catch { /* ignore corrupted config */ }
+    }
+
+    // Dispatch to platform-specific installer
+    if (createProject) {
+        args.push('--create-project');
+    } else if (!args.includes('-s') && !args.includes('--skip-project')) {
+        args.push('--skip-project');
+    }
+
+    // Suppress shell banner when JS wizard already showed it (avoid duplicate)
+    if (process.stdin.isTTY && process.stdout.isTTY && !args.includes('-q') && !args.includes('--quiet')) {
+        args.push('--no-banner');
+    }
+
+    if (platform === 'win32') {
+        runWindows(selectedTargets);
+    } else {
+        runUnix(selectedTargets);
+    }
+}
+
+main().catch(err => {
+    log.error(err.message);
+    process.exit(1);
+});