@kandiforge/spectacle 0.45.8 → 0.45.17

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kandiforge/spectacle",
-  "version": "0.45.8",
+  "version": "0.45.17",
   "description": "Spectacle server and CLI tools for KandiForge ecosystem",
   "author": "Abstract Class Consulting Inc.",
   "license": "PROPRIETARY",
@@ -21,7 +21,7 @@
     "development"
   ],
   "dependencies": {
-    "@kandiforge/kandi-cli": "latest"
+    "@kandiforge/kandi-cli": "^0.45.7"
   },
   "scripts": {
     "postinstall": "node scripts/install.js",

package/scripts/install.js

@@ -6,13 +6,58 @@ const https = require('https');
 const { execSync } = require('child_process');
 
 // This version MUST match package.json
-const RELEASE_VERSION = '0.45.8';
+const RELEASE_VERSION = '0.45.17';
 const GITHUB_REPO = 'KandiForge/distribution';
+const PACKAGE_NAME = '@kandiforge/spectacle';
+
+// ANSI color codes
+const colors = {
+  reset: '\x1b[0m',
+  bold: '\x1b[1m',
+  dim: '\x1b[2m',
+  cyan: '\x1b[36m',
+  green: '\x1b[32m',
+  yellow: '\x1b[33m',
+  blue: '\x1b[34m',
+  magenta: '\x1b[35m',
+};
+
+function log(message) {
+  console.log(message);
+}
+
+function logStep(step, message) {
+  log(`${colors.cyan}[${step}]${colors.reset} ${message}`);
+}
+
+function logSuccess(message) {
+  log(`${colors.green}OK${colors.reset} ${message}`);
+}
+
+function logInfo(message) {
+  log(`${colors.dim}    ${message}${colors.reset}`);
+}
+
+function getPlatformName(platform) {
+  const names = {
+    darwin: 'macOS',
+    linux: 'Linux',
+    win32: 'Windows',
+  };
+  return names[platform] || platform;
+}
+
+function getArchName(arch) {
+  const names = {
+    arm64: 'Apple Silicon',
+    x64: 'x64',
+    ia32: 'x86',
+  };
+  return names[arch] || arch;
+}
 
 function downloadFile(url, destPath) {
   return new Promise((resolve, reject) => {
-    console.log(`Downloading from: ${url}`);
-
     https.get(url, (response) => {
       if (response.statusCode === 302 || response.statusCode === 301) {
         // Follow redirect
@@ -57,6 +102,15 @@ function extractZip(zipPath, destDir) {
 async function install() {
   try {
     const platform = process.platform;
+    const arch = process.arch;
+
+    // Print installation header
+    log('');
+    log(`${colors.bold}${colors.cyan}Spectacle${colors.reset} ${colors.dim}v${RELEASE_VERSION}${colors.reset}`);
+    log(`${colors.dim}Server and CLI tools for KandiForge ecosystem${colors.reset}`);
+    log('');
+
+    logStep('1/4', `Detecting platform: ${colors.bold}${getPlatformName(platform)}${colors.reset} (${getArchName(arch)})`);
 
     // Determine archive name and binary extension based on platform
     let fileName, isZip, ext;
@@ -101,7 +155,6 @@ async function install() {
     }
 
     // Clean bin directory - remove any existing binaries to avoid mixing platforms
-    console.log('Cleaning bin directory...');
     const existingFiles = fs.readdirSync(binDir);
     for (const file of existingFiles) {
       // Skip .gitkeep or other dotfiles
@@ -110,20 +163,19 @@ async function install() {
       try {
         fs.unlinkSync(filePath);
       } catch (e) {
-        console.warn(`Warning: Could not remove ${file}: ${e.message}`);
+        // Ignore cleanup errors
       }
     }
 
-    // Download the release archive
-    console.log(`Installing Spectacle v${RELEASE_VERSION} for ${platform}...`);
+    logStep('2/4', 'Downloading binaries from GitHub releases...');
+    logInfo(downloadUrl);
     await downloadFile(downloadUrl, tempFile);
 
-    // Extract the archive
-    console.log('Extracting binaries...');
+    logStep('3/4', 'Extracting binaries...');
     if (isZip) {
       extractZip(tempFile, binDir);
     } else {
-      execSync(`tar -xzf "${tempFile}" -C "${binDir}"`, { stdio: 'inherit' });
+      execSync(`tar -xzf "${tempFile}" -C "${binDir}"`, { stdio: 'pipe' });
     }
 
     // Clean up archive
@@ -148,8 +200,6 @@ async function install() {
         }
 
         installedBinaries.push({ name: baseName, path: destPath });
-      } else {
-        console.warn(`Warning: ${srcName} not found in archive`);
       }
     }
 
@@ -162,15 +212,85 @@ async function install() {
       throw new Error('No binaries were found in the archive');
     }
 
-    console.log('Spectacle installed successfully!');
-    console.log(`\nInstalled ${installedBinaries.length} binaries:`);
+    logStep('4/4', 'Setting up CLI commands...');
+
+    // Create symlinks in npm global bin directory
+    // npm doesn't create symlinks for binaries that don't exist at install time,
+    // so we need to create them manually after downloading
+    let symlinkSuccess = false;
+    try {
+      // Get npm prefix and construct bin path (npm bin -g is deprecated)
+      const npmPrefix = execSync('npm config get prefix', { encoding: 'utf8' }).trim();
+      const npmGlobalBin = path.join(npmPrefix, 'bin');
+
+      for (const binary of installedBinaries) {
+        const binaryName = `${binary.name}${ext}`;
+        const sourcePath = binary.path;
+        const linkPath = path.join(npmGlobalBin, binaryName);
+
+        if (fs.existsSync(sourcePath)) {
+          // Remove existing symlink if it exists
+          try {
+            if (fs.existsSync(linkPath) || fs.lstatSync(linkPath).isSymbolicLink()) {
+              fs.unlinkSync(linkPath);
+            }
+          } catch (e) {
+            // Ignore if file doesn't exist
+          }
+
+          // Create symlink
+          if (platform === 'win32') {
+            // On Windows, copy the file instead of symlinking (requires admin for symlinks)
+            fs.copyFileSync(sourcePath, linkPath);
+          } else {
+            fs.symlinkSync(sourcePath, linkPath);
+          }
+        }
+      }
+      symlinkSuccess = true;
+    } catch (symlinkError) {
+      // Symlink creation failed - will show path instructions below
+    }
+
+    // Print success message
+    log('');
+    log(`${colors.green}Installation complete!${colors.reset}`);
+    log('');
+    log(`${colors.bold}Installed ${installedBinaries.length} binaries:${colors.reset}`);
     for (const binary of installedBinaries) {
-      console.log(`  - ${path.basename(binary.path)}`);
+      log(`  ${colors.cyan}${binary.name}${colors.reset}`);
     }
 
+    // Print next steps
+    log('');
+    log(`${colors.bold}Next steps:${colors.reset}`);
+    log(`  ${colors.dim}1.${colors.reset} Start the Spectacle server:`);
+    log(`     ${colors.cyan}kandi-spectacle serve${colors.reset}`);
+    log('');
+    log(`  ${colors.dim}2.${colors.reset} Or use individual CLI tools:`);
+    log(`     ${colors.cyan}kandi-plan --help${colors.reset}     ${colors.dim}# Planning and specs${colors.reset}`);
+    log(`     ${colors.cyan}kandi-gpt --help${colors.reset}      ${colors.dim}# GPT integration${colors.reset}`);
+    log(`     ${colors.cyan}kandi-deploy --help${colors.reset}   ${colors.dim}# Deployment automation${colors.reset}`);
+    log('');
+
+    if (!symlinkSuccess) {
+      log(`${colors.yellow}Note:${colors.reset} Commands may not be in your PATH.`);
+      log(`Add this to your shell profile:`);
+      log(`  ${colors.dim}export PATH="${binDir}:$PATH"${colors.reset}`);
+      log('');
+    }
+
+    log(`${colors.dim}Documentation: https://docs.kandiforge.com${colors.reset}`);
+    log('');
+
   } catch (error) {
-    console.error('Installation failed:', error.message);
-    console.error('\nPlease report this issue at: https://github.com/KandiForge/apps/issues');
+    log('');
+    log(`${colors.bold}Installation failed${colors.reset}`);
+    log(`${colors.dim}${error.message}${colors.reset}`);
+    log('');
+    log(`Please report this issue at:`);
+    log(`${colors.cyan}https://github.com/KandiForge/apps/issues${colors.reset}`);
+    log('');
     process.exit(1);
   }
 }