@xaidenlabs/uso 1.0.3 → 1.1.1

package/README.md

@@ -75,6 +75,23 @@ uso install anchor
 
 ---
 
+---
+
+### Project Scaffolding
+
+Start a new project with a robust, pre-configured Anchor template.
+
+```bash
+uso create <project-name>
+```
+
+This generates a "batteries-included" workspace with:
+-   **Localnet Configuration**: `Anchor.toml` pre-wired for local development.
+-   **Test Suite**: A running example test file using the latest Anchor syntax.
+-   **Scripts**: NPM scripts for linting and testing.
+
+---
+
 ### Verification
 
 After installation, verify that all components are correctly configured and accessible in your system PATH.

package/bin/index.js

@@ -3,6 +3,7 @@ const { program } = require('commander');
 const { init } = require('../src/commands/init');
 const { doctor } = require('../src/commands/doctor');
 const { verify } = require('../src/commands/verify');
+const { create } = require('../src/commands/create');
 const { build, test, deploy, clean } = require('../src/commands/workflow');
 const { uninstall } = require('../src/commands/uninstall');
 
@@ -27,6 +28,11 @@ program
     .description('Verify installation by building a test Anchor project')
     .action(verify);
 
+program
+    .command('create <project_name>')
+    .description('Scaffold a new Anchor project')
+    .action(create);
+
 program
     .command('build')
     .description('Build the Anchor project (wraps "anchor build")')

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xaidenlabs/uso",
-  "version": "1.0.3",
+  "version": "1.1.1",
   "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

@@ -0,0 +1,115 @@
+const fs = require('fs');
+const path = require('path');
+const shell = require('shelljs');
+const { log, spinner } = require('../utils/logger');
+const { getCargoBinPath } = require('../utils/paths');
+
+const create = async (projectName) => {
+    if (!projectName) {
+        log.error("❌ Please provide a project name: uso create <project-name>");
+        return;
+    }
+
+    // Validate project name (basic check for valid folder name)
+    if (!/^[a-z0-9-_]+$/.test(projectName)) {
+        log.error("❌ Project name can only contain lowercase letters, numbers, hyphens, and underscores.");
+        return;
+    }
+
+    const targetDir = path.resolve(process.cwd(), projectName);
+    if (fs.existsSync(targetDir)) {
+        log.error(`❌ Directory '${projectName}' already exists.`);
+        return;
+    }
+
+    log.header(`🏗️  Scaffolding new project: ${projectName}`);
+
+    // 1. Copy Template
+    const templateDir = path.resolve(__dirname, '../../templates/default');
+    const spin = spinner('Copying template files...').start();
+
+    try {
+        shell.cp('-R', templateDir, targetDir);
+        spin.succeed('Template copied.');
+    } catch (e) {
+        spin.fail('Failed to copy template.');
+        log.error(e.message);
+        return;
+    }
+
+    // 2. Customize Project (Rename files and content)
+    log.info("✏️  Customizing project details...");
+
+    // Rename programs/my-project to programs/<project-name>
+    // Note: Rust crate names typically use underscores, not hyphens.
+    const crateName = projectName.replace(/-/g, '_');
+
+    const oldProgramDir = path.join(targetDir, 'programs', 'my-project');
+    const newProgramDir = path.join(targetDir, 'programs', crateName);
+
+    // Rename tests/my-project.ts to tests/<project-name>.ts
+    const oldTestFile = path.join(targetDir, 'tests', 'my-project.ts');
+    const newTestFile = path.join(targetDir, 'tests', `${projectName}.ts`);
+
+    try {
+        if (fs.existsSync(oldProgramDir)) {
+            fs.renameSync(oldProgramDir, newProgramDir);
+        }
+        if (fs.existsSync(oldTestFile)) {
+            fs.renameSync(oldTestFile, newTestFile);
+        }
+
+        // Replace placeholders in files
+        const replaceInFile = (filePath, searchValue, replaceValue) => {
+            if (fs.existsSync(filePath)) {
+                let content = fs.readFileSync(filePath, 'utf8');
+                // Global replace
+                const regex = new RegExp(searchValue, 'g');
+                content = content.replace(regex, replaceValue);
+                fs.writeFileSync(filePath, content, 'utf8');
+            }
+        };
+
+        // Update Anchor.toml
+        replaceInFile(path.join(targetDir, 'Anchor.toml'), 'my_project', crateName);
+
+        // Update Cargo.toml
+        replaceInFile(path.join(newProgramDir, 'Cargo.toml'), 'my-project', projectName);
+        replaceInFile(path.join(newProgramDir, 'Cargo.toml'), 'my_project', crateName);
+
+        // Update lib.rs (if specific project name usage exists beyond mod name which is file-based in lib.rs typically, but here we defined inside lib.rs)
+        // Actually, in lib.rs: pub mod my_project -> pub mod crate_name
+        replaceInFile(path.join(newProgramDir, 'src', 'lib.rs'), 'my_project', crateName);
+
+        // Update test file
+        replaceInFile(newTestFile, 'my-project', projectName); // describe("my-project")
+        replaceInFile(newTestFile, 'my_project', crateName); // import ... "../target/types/my_project"
+
+        // Update class name in test file (MyProject -> ProjectNamePascalCase)
+        const toPascalCase = (str) => {
+            return str.match(/[a-z0-9]+/gi)
+                .map(word => word.charAt(0).toUpperCase() + word.substr(1).toLowerCase())
+                .join('');
+        };
+        const pascalName = toPascalCase(projectName);
+        replaceInFile(newTestFile, 'MyProject', pascalName);
+
+    } catch (e) {
+        log.error(`❌ Failed during customization: ${e.message}`);
+        // clean up? maybe not, let user see what happened
+        return;
+    }
+
+    // 4. Generate Keypair if needed? 
+    // Anchor usually handles this on first build, but let's check if they have a wallet.
+    // We won't force it here, "uso init" or "uso verify" handles wallet creation.
+
+    log.header("\n🎉 Project Created Successfully!");
+    log.info(`\n👉 Next steps:\n`);
+    log.info(`   cd ${projectName}`);
+    log.info(`   npm install`);
+    log.info(`   uso test`);
+    log.info(`\nHappy building! 🚀`);
+};
+
+module.exports = { create };

package/src/commands/workflow.js

@@ -1,4 +1,5 @@
 const shell = require('shelljs');
+const os = require('os');
 const { log, spinner } = require('../utils/logger');
 
 const runProxyCommand = async (command, args = []) => {
@@ -16,9 +17,29 @@ const runProxyCommand = async (command, args = []) => {
 
     if (execution.code === 0) {
         log.success(`✅ '${command}' completed successfully.`);
+        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');
+
+    if (isPrivilegeError && os.platform() === 'win32') {
+        log.warn("⚠️  Windows requires Administrator privileges for this operation.");
+        log.info("🔑 Requesting elevated access...");
+
+        const elevateCmd = `powershell -Command "Start-Process powershell -ArgumentList '-NoProfile', '-Command', 'cd \\"${process.cwd()}\\"; anchor ${command} ${args.join(' ')}; Read-Host \\"Press Enter to close\\"' -Verb RunAs -Wait"`;
+
+        const elevatedRun = shell.exec(elevateCmd);
+
+        if (elevatedRun.code === 0) {
+            log.success(`✅ '${command}' completed successfully (elevated).`);
+        } else {
+            log.error(`❌ '${command}' failed even with elevated privileges.`);
+            log.warn("👉 Try running your terminal as Administrator manually.");
+        }
     } else {
         log.error(`❌ '${command}' failed.`);
-        // We don't exit process here strictly, but let the user know
     }
 };
 
@@ -27,9 +48,6 @@ const test = () => runProxyCommand('test');
 const deploy = () => runProxyCommand('deploy');
 const clean = () => runProxyCommand('clean');
 
-// Generic run command for other anchor commands? 
-// For now, explicit functions are safer for help generation.
-
 module.exports = {
     build,
     test,

package/templates/default/Anchor.toml

@@ -0,0 +1,18 @@
+[toolchain]
+
+[features]
+seeds = false
+skip-lint = false
+
+[programs.localnet]
+my_project = "Fg6PaFpoGXkYsidMpWTK6W2BeZ7FEfcYkg476zPFsLnS"
+
+[registry]
+url = "https://api.apr.dev"
+
+[provider]
+cluster = "Localnet"
+wallet = "~/.config/solana/id.json"
+
+[scripts]
+test = "yarn run ts-mocha -p ./tsconfig.json -t 1000000 tests/**/*.ts"

package/templates/default/README.md

@@ -0,0 +1,36 @@
+# Welcome to Your USO Project 🚀
+
+Congratulations! You've just scaffolded a professional Solana workspace using the **Universal Solana Orchestrator (USO)**.
+
+This isn't just a folder with files. It's a battle-tested setup ready for serious development.
+
+## 📂 Structure
+- `programs/`: Your Rust smart contracts live here.
+- `tests/`: Robust TypeScript tests using Anchor.
+- `Anchor.toml`: Your project configuration.
+
+## ⚡ Quick Start
+
+### 1. Build
+Compile your smart contract:
+```bash
+uso build
+```
+
+### 2. Test
+Run your test suite against a local validator:
+```bash
+uso test
+```
+*Note: This automatically spins up a local validator, deploys your program, runs tests, and shuts down.*
+
+### 3. Deploy (Devnet)
+When you're ready to go public:
+1. Switch to devnet: `solana config set --url devnet`
+2. Airdrop SOL: `solana airdrop 2`
+3. Deploy: `uso deploy`
+
+## 🧠 Need Help?
+Run `uso doctor` if your environment feels weird. Usage instructions are also available via `uso help`.
+
+Happy coding!

package/templates/default/package.json

@@ -0,0 +1,19 @@
+{
+    "scripts": {
+        "lint:fix": "prettier */*.js \"*/**/*{.js,.ts}\" -w",
+        "lint": "prettier */*.js \"*/**/*{.js,.ts}\" --check"
+    },
+    "dependencies": {
+        "@coral-xyz/anchor": "^0.32.1"
+    },
+    "devDependencies": {
+        "chai": "^4.3.7",
+        "mocha": "^9.0.3",
+        "ts-mocha": "^10.0.0",
+        "@types/mocha": "^9.0.0",
+        "@types/chai": "^4.3.0",
+        "@types/node": "^16.0.0",
+        "typescript": "^4.3.5",
+        "prettier": "^2.6.2"
+    }
+}