@xaidenlabs/uso 1.1.2 → 1.1.3

package/README.md

@@ -2,7 +2,7 @@
 
 The Universal Solana Orchestrator (USO) is a command-line interface designed to streamline the initialization and management of Solana development environments. By automating the installation of the Rust toolchain, Solana CLI, and Anchor framework, USO eliminates the complexity often associated with setting up a Web3 development workspace on Windows, macOS, and Linux.
 
-This tool is engineered to support developers at all levels—from beginners setting up their first environment to senior engineers managing multiple workstations.
+This tool is engineered to support developers at all levels, from beginners setting up their first environment to senior engineers managing multiple workstations.
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xaidenlabs/uso",
-  "version": "1.1.2",
+  "version": "1.1.3",
   "description": "Universal Solana Orchestrator - A one-command setup tool for Solana and Anchor development environments on Windows, macOS, and Linux.",
   "bin": {
     "uso": "bin/index.js"

package/src/commands/create.js

@@ -1,8 +1,8 @@
 const fs = require('fs');
 const path = require('path');
+const os = require('os');
 const shell = require('shelljs');
 const { log, spinner } = require('../utils/logger');
-const { getCargoBinPath } = require('../utils/paths');
 
 const create = async (projectName) => {
     if (!projectName) {
@@ -37,6 +37,19 @@ const create = async (projectName) => {
         return;
     }
 
+    // 1b. Add Windows Defender exclusion for the project directory (prevents build blocks)
+    if (os.platform() === 'win32') {
+        const defSpin = spinner('Adding Windows Defender exclusion...').start();
+        const cargoHome = path.join(os.homedir(), '.cargo');
+        const cmd = `powershell -Command "Start-Process powershell -ArgumentList '-NoProfile', '-Command', 'Add-MpPreference -ExclusionPath \\\"${targetDir.replace(/\\/g, '\\\\')}\\\"; Add-MpPreference -ExclusionPath \\\"${cargoHome.replace(/\\/g, '\\\\')}\\\"' -Verb RunAs -WindowStyle Hidden -Wait"`;
+        const defResult = shell.exec(cmd, { silent: true });
+        if (defResult.code === 0) {
+            defSpin.succeed('Defender exclusion added (builds won\'t be blocked).');
+        } else {
+            defSpin.warn('Could not add Defender exclusion. Builds may be blocked by antivirus.');
+        }
+    }
+
     // 2. Customize Project (Rename files and content)
     log.info("✏️  Customizing project details...");
 

package/src/commands/workflow.js

@@ -4,6 +4,17 @@ const fs = require('fs');
 const path = require('path');
 const { log, spinner } = require('../utils/logger');
 
+/**
+ * Adds a Windows Defender exclusion for a given path (requires elevation).
+ * Returns true if successful.
+ */
+const addDefenderExclusion = (dirPath) => {
+    const normalized = dirPath.replace(/\//g, '\\');
+    const cmd = `powershell -Command "Start-Process powershell -ArgumentList '-NoProfile', '-Command', 'Add-MpPreference -ExclusionPath \\\"${normalized}\\\"' -Verb RunAs -WindowStyle Hidden -Wait"`;
+    const result = shell.exec(cmd, { silent: true });
+    return result.code === 0;
+};
+
 const runProxyCommand = async (command, args = []) => {
     // Check if anchor is available
     if (!shell.which('anchor')) {
@@ -22,18 +33,56 @@ const runProxyCommand = async (command, args = []) => {
         return;
     }
 
-    // Check for Windows privilege error (os error 1314 — symlink creation requires elevation)
     const output = (execution.stderr || '') + (execution.stdout || '');
-    const isPrivilegeError = output.includes('os error 1314') || output.includes('A required privilege is not held by the client');
 
+    // --- Error Detection & Auto-Fix ---
+
+    // 1. Windows Defender / Application Control blocking build scripts (os error 4551)
+    const isDefenderBlock = output.includes('os error 4551') || output.includes('Application Control policy has blocked');
+    if (isDefenderBlock && os.platform() === 'win32') {
+        log.warn("⚠️  Windows Defender is blocking Cargo build scripts.");
+        log.info("🛡️  Adding project directory to Defender exclusions...\n");
+
+        const cwd = process.cwd();
+        const cargoHome = path.join(os.homedir(), '.cargo');
+
+        const success = addDefenderExclusion(cwd) && addDefenderExclusion(cargoHome);
+
+        if (success) {
+            log.success("✅ Defender exclusions added.");
+            log.info("🔄 Cleaning build cache and retrying...\n");
+
+            // Clean stale blocked artifacts
+            shell.exec('cargo clean', { silent: true });
+
+            // Retry the command
+            const retry = shell.exec(fullCommand);
+            if (retry.code === 0) {
+                log.success(`✅ '${command}' completed successfully.`);
+            } else {
+                log.error(`❌ '${command}' still failed after adding exclusions.`);
+                log.warn("👉 Try running your terminal as Administrator.");
+            }
+        } else {
+            log.error("❌ Could not add Defender exclusions. Was the UAC prompt declined?");
+            log.info("👉 Manually add exclusions in Windows Security > Virus & threat protection > Exclusions:");
+            log.info(`   - ${cwd}`);
+            log.info(`   - ${cargoHome}`);
+        }
+        return;
+    }
+
+    // 2. Privilege error (os error 1314 — symlink creation requires elevation)
+    const isPrivilegeError = output.includes('os error 1314') || output.includes('A required privilege is not held by the client');
     if (isPrivilegeError && os.platform() === 'win32') {
         log.warn("⚠️  Windows requires Administrator privileges for this operation.");
         log.info("🔑 Requesting elevated access...\n");
 
         await runElevatedWithProgress(command, args);
-    } else {
-        log.error(`❌ '${command}' failed.`);
+        return;
     }
+
+    log.error(`❌ '${command}' failed.`);
 };
 
 /**
@@ -44,18 +93,14 @@ const runProxyCommand = async (command, args = []) => {
 const runElevatedWithProgress = (command, args = []) => {
     return new Promise((resolve) => {
         const tmpDir = os.tmpdir();
-        const logFile = path.join(tmpDir, `uso-elevated-${Date.now()}.log`);
-        const doneFile = path.join(tmpDir, `uso-elevated-${Date.now()}.done`);
+        const ts = Date.now();
+        const logFile = path.join(tmpDir, `uso-elevated-${ts}.log`);
+        const doneFile = path.join(tmpDir, `uso-elevated-${ts}.done`);
         const cwd = process.cwd();
 
         // Write an empty log file so we can start reading immediately
         fs.writeFileSync(logFile, '', 'utf8');
 
-        // Build the elevated command:
-        // 1. cd into the user's project directory
-        // 2. Run anchor <command>
-        // 3. Write exit code to a .done file so we know it finished
-        // 4. All stdout/stderr piped to the log file
         const anchorCmd = `anchor ${command} ${args.join(' ')}`;
         const innerScript = `
             Set-Location '${cwd.replace(/'/g, "''")}';
@@ -67,7 +112,6 @@ const runElevatedWithProgress = (command, args = []) => {
         // Launch hidden elevated process
         const elevateCmd = `powershell -Command "Start-Process powershell -ArgumentList '-NoProfile', '-ExecutionPolicy', 'Bypass', '-Command', '${innerScript.replace(/'/g, "''")}' -Verb RunAs -WindowStyle Hidden"`;
 
-        // This triggers the UAC prompt (that one still shows — it's Windows security, can't bypass it)
         const elevateResult = shell.exec(elevateCmd, { silent: true });
 
         if (elevateResult.code !== 0) {
@@ -79,18 +123,15 @@ const runElevatedWithProgress = (command, args = []) => {
         // Now poll the log file and show progress
         const spin = spinner('Building with elevated privileges...').start();
         let lastSize = 0;
-        let lastLine = '';
 
         const pollInterval = setInterval(() => {
             try {
-                // Check if process finished
                 if (fs.existsSync(doneFile)) {
                     clearInterval(pollInterval);
 
                     const exitCode = fs.readFileSync(doneFile, 'utf8').trim();
                     const fullLog = fs.readFileSync(logFile, 'utf8');
 
-                    // Cleanup temp files
                     try { fs.unlinkSync(logFile); } catch (e) { /* ignore */ }
                     try { fs.unlinkSync(doneFile); } catch (e) { /* ignore */ }
 
@@ -100,7 +141,6 @@ const runElevatedWithProgress = (command, args = []) => {
                         spin.fail(`'${command}' failed (elevated, exit code: ${exitCode}).`);
                     }
 
-                    // Print the captured output
                     if (fullLog.trim()) {
                         console.log('\n' + fullLog.trim());
                     }
@@ -109,25 +149,24 @@ const runElevatedWithProgress = (command, args = []) => {
                     return;
                 }
 
-                // Read new content from log file for progress
+                // Read new content for live progress
                 const stats = fs.statSync(logFile);
                 if (stats.size > lastSize) {
                     const content = fs.readFileSync(logFile, 'utf8');
                     const lines = content.trim().split('\n').filter(l => l.trim());
                     if (lines.length > 0) {
-                        lastLine = lines[lines.length - 1].trim();
-                        // Show the last meaningful line as spinner text
+                        const lastLine = lines[lines.length - 1].trim();
                         const displayLine = lastLine.length > 70 ? lastLine.substring(0, 67) + '...' : lastLine;
                         spin.text = displayLine;
                     }
                     lastSize = stats.size;
                 }
             } catch (e) {
-                // File might not exist yet or be locked, just keep polling
+                // File might not exist yet or be locked
             }
         }, 500);
 
-        // Safety timeout: 10 minutes max
+        // Safety timeout: 10 minutes
         setTimeout(() => {
             if (!fs.existsSync(doneFile)) {
                 clearInterval(pollInterval);