@xaidenlabs/uso 1.0.1 → 1.0.3

package/README.md

@@ -1,97 +1,116 @@
-# 🦀 USO ☀️
-### The **Magic Button** for Solana! ✨
+# Universal Solana Orchestrator (USO)
 
-Do you want to build cool blockchain apps on Solana? 
-Usually, installing all the tools is super hard and boring. 
-**USO does it all for you with just ONE CLICK!**
+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.
 
 ---
 
-## 🚀 Step 1: Get USO
-First, let's put USO on your computer.Open your **Terminal** (or Command Prompt) and type this magic spell:
+## Installation
+
+Install USO globally using NPM. This ensures the CLI is accessible from any terminal directory.
 
 ```bash
 npm install -g @xaidenlabs/uso
 ```
-*(If that doesn't work, ensure you have Node.js installed!)*
+
+**Prerequisites:**
+- **Node.js**: Ensure Node.js is installed on your system.
+- **Administrator Privileges**: Some installation steps (successfully creating symlinks, updating system PATH) may require elevated permissions.
 
 ---
 
-## 🩺 Step 2: Check Your Computer
-Is your computer ready? Ask the Doctor!
+## Usage
+
+### System Diagnostics
+
+Before attempting installation, you can run a diagnostic check to evaluate the current state of your environment.
+
 ```bash
 uso doctor
 ```
-It will check everything for you.
-- ✅ means GOOD!
-- ❌ means MISSING (Don't worry, USO will fix it!)
+
+This command will inspect your system for existing installations of Git, Rust, Solana CLI, and Anchor.
 
 ---
 
-## ✨ Step 3: Install Everything!
-This is the best part. To install **Rust**, **Solana**, and **Anchor** all at once, just type:
+### Full Environment Setup
+
+To perform a complete installation of the entire stack (Rust, Solana, Anchor), use the initialization command:
+
 ```bash
 uso init
 ```
-- It will download everything.
-- It might ask for permission (click **Yes**!).
-- **IMPORTANT**: When it's done, close your terminal and open it again!
+
+The installer will:
+1.  Detect your operating system.
+2.  Check for necessary build tools (C++ Build Tools on Windows).
+3.  Download and install the Rust toolchain (via `rustup`).
+4.  Install the Solana CLI (Agave release).
+5.  Build and install the Anchor Version Manager (AVM) and Anchor Framework.
+6.  Generate a new Solana wallet if one is not detected.
+
+**Note:** You may be prompted to approve administrative access during the installation of specific components.
 
 ---
 
-## 🎯 Step 4: Install Just One Thing (Optional)
-Maybe you only want one toy? You can do that too!
+### Granular Installation
 
-- **Want just Rust?** 🦀
-  ```bash
-  uso install rust
-  ```
+Use the `install` command to set up individual components if you do not require the full stack.
 
-- **Want just Solana?** ☀️
-  ```bash
-  uso install solana
-  ```
+**Install Rust:**
+```bash
+uso install rust
+```
 
-- **Want just Anchor?** ⚓
-  ```bash
-  uso install anchor
-  ```
+**Install Solana CLI:**
+```bash
+uso install solana
+```
+
+**Install Anchor Framework:**
+```bash
+uso install anchor
+```
 
 ---
 
-## ✅ Step 5: Test It!
-Let's make sure everything works perfectly.
+### Verification
+
+After installation, verify that all components are correctly configured and accessible in your system PATH.
+
 ```bash
 uso verify
 ```
-If this says "Success", you are ready to build the future! 🚀
+
+This process will validate the version of each tool and ensure the environment is ready for development.
 
 ---
 
-## 🗑️ Step 6: Removing It (Uninstall)
-If you don't want these tools anymore, USO can clean up for you.
+## Uninstallation
 
-- **Remove Everything:**
-  ```bash
-  uso uninstall
-  ```
-  *(Be careful! It might ask to delete your wallet with your crypto keys!)*
+USO provides a clean uninstallation process to remove the installed toolchains.
 
-- **Remove Just One Thing:**
-  ```bash
-  uso uninstall solana
-  ```
+**Remove All Components:**
+```bash
+uso uninstall
+```
 
----
+**Remove Individual Components:**
+```bash
+uso uninstall solana
+uso uninstall rust
+uso uninstall anchor
+```
 
-## ❓ Help! It's not working!
+---
 
-**"Permission Denied" or "Error"?**
-- Try running your terminal as **Administrator** (Right-click -> Run as Administrator).
+## Troubleshooting
 
-**"Command not found"?**
-- Did you close and reopen your terminal after installing? Do that now!
+-   **"Permission Denied" Errors**: If you encounter errors related to permissions or symlinks, try running your terminal as an Administrator.
+-   **"Command Not Found"**: After installation, your system PATH is updated. You must restart your terminal (close and reopen) for these changes to take effect.
+-   **Windows Build Tools**: If Rust fails to install on Windows, ensure you have the "Desktop development with C++" workload installed via Visual Studio Build Tools.
 
 ---
 
-**Made with ❤️ for You.**# cli-
+**Developed by Xaiden Labs**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xaidenlabs/uso",
-  "version": "1.0.1",
+  "version": "1.0.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/platforms/windows.js

@@ -50,14 +50,16 @@ const installWindows = async (shouldInstallRust, shouldInstallSolana) => {
         }
 
         // Try regular install first
+        // Try regular install first (Silently to catch 1314 error without scaring user)
         log.info("   Running Solana Installer...");
-        const installResult = shell.exec('solana-install.exe stable');
+        const installResult = shell.exec('solana-install.exe stable', { silent: true });
 
         // Check for Symlink Error (1314) for potential auto-elevation
         if (installResult.code !== 0) {
             const output = installResult.stderr + installResult.stdout;
+
             if (output.includes("os error 1314")) {
-                log.warn("⚠️  Permission denied (Symlink creation failed).");
+                log.info("ℹ️  Privilege escalation required for symlinks.");
                 log.info("🛡️  Triggering Run as Administrator (UAC)...");
                 log.info("👉 Please click 'Yes' in the popup window to allow the installer.");
 
@@ -70,18 +72,21 @@ const installWindows = async (shouldInstallRust, shouldInstallSolana) => {
 
                 if (elevatedRun.code === 0) {
                     // We can't easily capture stdout from the spawned high-privilege window, 
-                    // so we assume success if the process exited cleanly and verify existence.
-                    // A basic verification: check if we can run solana
+                    // so we assume success if the process exited cleanly.
                     log.success("✅ Solana Installer finished (Elevated).");
                 } else {
                     log.error("❌ Elevated installation failed or was cancelled.");
                     return false;
                 }
             } else {
+                // It failed for some other reason, so WE MUST show the output now
+                console.error(output);
                 log.error("❌ Solana CLI installation failed.");
                 // Don't return false hard here as we might want to continue, but usually this is fatal
             }
         } else {
+            // Success on first try
+            console.log(installResult.stdout); // Show success output if any relevant
             log.success("✅ Solana CLI installed.");
         }