@leverageaiapps/locus-dev 1.1.3

package/package.json

@@ -0,0 +1,69 @@
+{
+    "name": "@leverageaiapps/locus-dev",
+    "version": "1.1.3",
+    "description": "Locus - Forward your terminal to your mobile device. Code anywhere from your pocket.",
+    "main": "dist/index.js",
+    "bin": {
+        "locus": "./dist/index.js"
+    },
+    "scripts": {
+        "build": "tsc",
+        "dev": "ts-node src/index.ts",
+        "start": "node dist/index.js",
+        "postinstall": "node scripts/postinstall.js",
+        "verify": "node scripts/verify-install.js",
+        "prepublishOnly": "npm run build",
+        "global-install": "npm install && npm run build && npm link"
+    },
+    "keywords": [
+        "terminal",
+        "mobile",
+        "vortex",
+        "tunnel",
+        "remote",
+        "ssh",
+        "cli",
+        "claude-code",
+        "ai",
+        "coding",
+        "locus",
+        "no-ansi",
+        "clean-output"
+    ],
+    "author": "LeverageAI Apps",
+    "license": "MIT",
+    "dependencies": {
+        "axios": "^1.7.9",
+        "commander": "^12.1.0",
+        "cookie-parser": "^1.4.7",
+        "cors": "^2.8.5",
+        "dotenv": "^16.4.7",
+        "eventsource": "^2.0.2",
+        "express": "^5.2.1",
+        "node-pty": "^1.1.0",
+        "qrcode-terminal": "^0.12.0",
+        "ws": "^8.19.0"
+    },
+    "devDependencies": {
+        "@types/cookie-parser": "^1.4.10",
+        "@types/cors": "^2.8.19",
+        "@types/eventsource": "^1.1.15",
+        "@types/express": "^5.0.6",
+        "@types/node": "^20.17.12",
+        "@types/qrcode-terminal": "^0.12.2",
+        "@types/ws": "^8.18.1",
+        "ts-node": "^10.9.2",
+        "typescript": "^5.7.2"
+    },
+    "engines": {
+        "node": ">=18.0.0"
+    },
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/leverageaiapp/Locus.git"
+    },
+    "bugs": {
+        "url": "https://github.com/leverageaiapp/Locus/issues"
+    },
+    "homepage": "https://github.com/leverageaiapp/Locus#readme"
+}

package/scripts/postinstall.js

@@ -0,0 +1,66 @@
+#!/usr/bin/env node
+
+/**
+ * Post-install script to fix node-pty permissions on macOS/Linux
+ * This ensures the spawn-helper binary has execute permissions
+ */
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+const platform = os.platform();
+
+// Only run on macOS and Linux
+if (platform !== 'darwin' && platform !== 'linux') {
+    console.log('Skipping node-pty permission fix (not macOS/Linux)');
+    process.exit(0);
+}
+
+// Determine the architecture
+const arch = os.arch();
+let prebuildDir;
+
+if (platform === 'darwin') {
+    prebuildDir = arch === 'arm64' ? 'darwin-arm64' : 'darwin-x64';
+} else if (platform === 'linux') {
+    prebuildDir = arch === 'arm64' ? 'linux-arm64' : 'linux-x64';
+}
+
+const spawnHelperPath = path.join(
+    __dirname,
+    '..',
+    'node_modules',
+    'node-pty',
+    'prebuilds',
+    prebuildDir,
+    'spawn-helper'
+);
+
+// Check if spawn-helper exists
+if (!fs.existsSync(spawnHelperPath)) {
+    console.log(`spawn-helper not found at: ${spawnHelperPath}`);
+    console.log('This is normal if node-pty uses a different installation method');
+    process.exit(0);
+}
+
+try {
+    // Get current permissions
+    const stats = fs.statSync(spawnHelperPath);
+    const currentMode = stats.mode;
+    
+    // Add execute permission (chmod +x)
+    const newMode = currentMode | fs.constants.S_IXUSR | fs.constants.S_IXGRP | fs.constants.S_IXOTH;
+    
+    if (currentMode !== newMode) {
+        fs.chmodSync(spawnHelperPath, newMode);
+        console.log('✓ Fixed node-pty spawn-helper permissions');
+    } else {
+        console.log('✓ node-pty spawn-helper permissions already correct');
+    }
+} catch (error) {
+    console.error('Warning: Failed to fix node-pty permissions:', error.message);
+    console.error('You may need to run manually: chmod +x node_modules/node-pty/prebuilds/*/spawn-helper');
+    // Don't fail the installation
+    process.exit(0);
+}

package/scripts/verify-install.js

@@ -0,0 +1,128 @@
+#!/usr/bin/env node
+
+/**
+ * Installation verification script
+ * Checks if all dependencies and permissions are correctly set up
+ */
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+const { execSync } = require('child_process');
+
+console.log('🔍 Verifying Locus installation...\n');
+
+let hasErrors = false;
+let hasWarnings = false;
+
+// Check 1: Node.js version
+console.log('1. Checking Node.js version...');
+const nodeVersion = process.version;
+const majorVersion = parseInt(nodeVersion.slice(1).split('.')[0]);
+if (majorVersion >= 18) {
+    console.log(`   ✓ Node.js ${nodeVersion} (>= 18.0.0)\n`);
+} else {
+    console.log(`   ✗ Node.js ${nodeVersion} is too old. Required: >= 18.0.0\n`);
+    hasErrors = true;
+}
+
+// Check 2: node-pty installation
+console.log('2. Checking node-pty...');
+const nodePtyPath = path.join(__dirname, '..', 'node_modules', 'node-pty');
+if (fs.existsSync(nodePtyPath)) {
+    console.log('   ✓ node-pty installed\n');
+} else {
+    console.log('   ✗ node-pty not found. Run: npm install\n');
+    hasErrors = true;
+}
+
+// Check 3: spawn-helper permissions (macOS/Linux only)
+if (os.platform() === 'darwin' || os.platform() === 'linux') {
+    console.log('3. Checking spawn-helper permissions...');
+
+    const arch = os.arch();
+    const platform = os.platform();
+    let prebuildDir;
+
+    if (platform === 'darwin') {
+        prebuildDir = arch === 'arm64' ? 'darwin-arm64' : 'darwin-x64';
+    } else {
+        prebuildDir = arch === 'arm64' ? 'linux-arm64' : 'linux-x64';
+    }
+
+    const spawnHelperPath = path.join(nodePtyPath, 'prebuilds', prebuildDir, 'spawn-helper');
+
+    if (fs.existsSync(spawnHelperPath)) {
+        try {
+            const stats = fs.statSync(spawnHelperPath);
+            const hasExecute = (stats.mode & fs.constants.S_IXUSR) !== 0;
+
+            if (hasExecute) {
+                console.log('   ✓ spawn-helper has execute permissions\n');
+            } else {
+                console.log('   ✗ spawn-helper missing execute permissions');
+                console.log(`   Fix: chmod +x ${spawnHelperPath}\n`);
+                hasErrors = true;
+            }
+        } catch (error) {
+            console.log(`   ⚠ Could not check permissions: ${error.message}\n`);
+            hasWarnings = true;
+        }
+    } else {
+        console.log(`   ⚠ spawn-helper not found at expected location`);
+        console.log(`   This may be normal if using a different node-pty version\n`);
+        hasWarnings = true;
+    }
+} else {
+    console.log('3. Skipping spawn-helper check (Windows)\n');
+}
+
+// Check 4: Built files
+console.log('4. Checking built files...');
+const distPath = path.join(__dirname, '..', 'dist', 'index.js');
+if (fs.existsSync(distPath)) {
+    console.log('   ✓ Project built successfully\n');
+} else {
+    console.log('   ⚠ Project not built yet. Run: npm run build\n');
+    hasWarnings = true;
+}
+
+// Check 5: Shell availability
+console.log('5. Checking shell...');
+const shell = process.env.SHELL || (os.platform() === 'win32' ? 'cmd.exe' : '/bin/sh');
+if (fs.existsSync(shell)) {
+    console.log(`   ✓ Shell available: ${shell}\n`);
+} else {
+    console.log(`   ⚠ Default shell not found: ${shell}\n`);
+    hasWarnings = true;
+}
+
+// Check 6: Vortex gateway connectivity
+console.log('6. Checking Vortex gateway...');
+try {
+    execSync('curl -s -o /dev/null -w "%{http_code}" https://vortex.futuretech.social/health', {
+        encoding: 'utf8',
+        stdio: ['pipe', 'pipe', 'pipe'],
+        timeout: 5000
+    });
+    console.log('   ✓ Vortex gateway is accessible\n');
+} catch (error) {
+    console.log('   ⚠ Could not reach Vortex gateway');
+    console.log('   This may be a network issue or the gateway may be temporarily unavailable\n');
+    hasWarnings = true;
+}
+
+// Summary
+console.log('═'.repeat(50));
+if (hasErrors) {
+    console.log('❌ Installation has errors. Please fix the issues above.');
+    process.exit(1);
+} else if (hasWarnings) {
+    console.log('⚠️  Installation complete with warnings.');
+    console.log('   You may want to address the warnings above.');
+    process.exit(0);
+} else {
+    console.log('✅ Installation verified successfully!');
+    console.log('\nYou can now run: locus');
+    process.exit(0);
+}