@ornexus/neocortex 4.59.1

package/install.js

@@ -0,0 +1,572 @@
+#!/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', key: 'gemini', tier: 2, default: false, detect: 'gemini', label: 'Tier 2 - CLI Pipeline' },
+    { 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 },
+    { name: 'OpenCode', key: 'opencode', tier: 2, default: false, detect: 'opencode', label: 'Tier 2 - CLI Pipeline' },
+    { name: 'Kimi Code CLI', key: 'kimi', tier: 3, default: false, detect: 'kimi', label: 'Tier 3 - Agent-Directed' },
+    { name: 'OpenClaw', key: 'openclaw', tier: 3, default: false, detect: 'openclaw', label: 'Tier 3 - Skill Thin-Client' },
+];
+
+// ═══════════════════════════════════════════════════════════════════
+// 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',
+    '--dry-run': '-DryRun',
+    // 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 printNoSudoGlobalInstallGuidance() {
+    console.error(color.red('  Permission denied while updating Neocortex.'));
+    console.error(color.yellow('  Prefer a no-sudo global install path before retrying:'));
+    console.error(color.dim('    1. Use a Node version manager (npm recommended), then run:'));
+    console.error(color.cyan('       npm install -g @ornexus/neocortex@latest'));
+    console.error(color.dim('    2. Or on Unix, configure an npm user prefix:'));
+    console.error(color.cyan('       npm config set prefix ~/.local'));
+    console.error(color.cyan('       export PATH="$HOME/.local/bin:$PATH"'));
+    console.error(color.cyan('       npm install -g @ornexus/neocortex@latest'));
+    console.error(color.dim('  Avoid starting with elevated installs; root/sudo HOME can target the wrong user config.'));
+    console.error(color.dim('  Reason: P177_NOSUDO_EACCES_GUIDANCE'));
+}
+
+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(`    ${color.cyan('refresh-memory')}           Reparar NEOCORTEX.md e wrappers/symlinks`);
+    console.log(`    ${color.cyan('update')}                    Atualizar para a ultima versao`);
+    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('--dry-run')}                 Mostra adapters/stubs resolvidos sem modificar arquivos`);
+    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('');
+    console.log(color.dim('  Linux global install:'));
+    console.log(`    ${color.cyan('npm install -g @ornexus/neocortex')} ${color.dim('# use Node version manager or npm user prefix; avoid sudo-first flows')}`);
+    console.log(`    ${color.dim('See docs/install/linux-global-install.md for root HOME recovery guidance.')}`);
+    console.log('');
+    // Epic P72 - Story P72.04: BSL-1.1 license notice in --help output.
+    console.log(color.dim('  Licenca: BSL-1.1 (Business Source License 1.1)'));
+    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', 'refresh-memory']);
+    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
+    }
+
+    // ── Update command (Epic P86 - Story P86.07) ─────────────────────────
+    // Handled directly (not delegated to neocortex-client) because update
+    // needs npm which is in the installer's scope, not the client's.
+    if (firstArg === 'update') {
+        const currentVersion = VERSION;
+        console.log('');
+        console.log(color.cyan('  Neocortex Update'));
+        console.log(color.dim(`  Current version: v${currentVersion}`));
+        console.log('');
+        console.log(color.dim('  Updating to latest version...'));
+
+        const { execSync } = require('child_process');
+        try {
+            // Run npm install -g silently, capture output
+            execSync('npm install -g @ornexus/neocortex@latest', {
+                stdio: ['pipe', 'pipe', 'pipe'],
+                timeout: 120000, // 2 min timeout
+            });
+
+            // Read new version
+            let newVersion = currentVersion;
+            try {
+                const newPkg = JSON.parse(fs.readFileSync(path.join(SCRIPT_DIR, 'package.json'), 'utf8'));
+                newVersion = newPkg.version;
+            } catch {
+                // Fallback: query npm for installed version
+                try {
+                    const lsOutput = execSync('npm ls -g @ornexus/neocortex --depth=0 --json 2>/dev/null', {
+                        encoding: 'utf-8', timeout: 10000,
+                    });
+                    const match = lsOutput.match(/"version":\s*"([^"]+)"/);
+                    if (match) newVersion = match[1];
+                } catch { /* keep currentVersion */ }
+            }
+
+            if (newVersion === currentVersion) {
+                console.log(color.green(`  Already at latest version: v${currentVersion}`));
+            } else {
+                console.log(color.green(`  Updated: v${currentVersion} -> v${newVersion}`));
+            }
+            console.log('');
+        } catch (err) {
+            const msg = (err.stderr && err.stderr.toString()) || err.message || '';
+            if (msg.includes('EACCES') || msg.includes('permission denied')) {
+                printNoSudoGlobalInstallGuidance();
+            } else if (msg.includes('ENETUNREACH') || msg.includes('ENOTFOUND') || msg.includes('fetch failed')) {
+                console.error(color.red('  Network error. Check your internet connection and try again.'));
+            } else {
+                console.error(color.red(`  Update failed: ${msg.split('\n')[0]}`));
+            }
+            console.error('');
+            process.exit(1);
+        }
+        process.exit(0);
+    }
+
+    // Version flag -- print just the version number and exit (for scripting)
+    // Epic P72 - Story P72.04: include BSL-1.1 license notice.
+    if (isVersion()) {
+        console.log(VERSION);
+        console.log('Licensed under BSL-1.1 (Business Source License 1.1)');
+        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);
+});