cskit-cli 1.0.28 → 1.0.30

package/package.json

@@ -1,13 +1,14 @@
 {
   "name": "cskit-cli",
-  "version": "1.0.28",
+  "version": "1.0.30",
   "description": "Content Suite Kit CLI - Download and manage CSK skills from private repository",
   "main": "src/index.js",
   "bin": {
     "cskit": "bin/csk.js"
   },
   "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1"
+    "test": "echo \"Error: no test specified\" && exit 1",
+    "postinstall": "node src/postinstall.js"
   },
   "keywords": [
     "claude",
@@ -45,6 +46,7 @@
   "files": [
     "bin",
     "src",
-    "README.md"
+    "README.md",
+    "postinstall.js"
   ]
 }

package/src/commands/init.js

@@ -66,8 +66,7 @@ class Timeline {
     this.steps = [];
     this.currentStep = -1;
     this.lastLineCount = 0;
-    this.isFirstRender = true;
-    this.isPaused = false;
+    this.inPlaceEnabled = true;  // Disable after any prompt
   }
 
   addStep(name) {
@@ -102,44 +101,39 @@ class Timeline {
     this.steps[stepIndex].children.push({ text, type });
   }
 
-  // Call before any external output (prompts, logs, etc.)
+  // Call before any prompt - disables in-place updates for rest of session
   pause() {
-    // Don't update in-place after external output - just continue below
+    this.inPlaceEnabled = false;
     this.lastLineCount = 0;
-    this.isPaused = true;
   }
 
-  // Re-render timeline after external output
+  // Re-render after prompt (just prints fresh, no in-place)
   resume() {
-    if (this.isPaused) {
-      // Print separator and continue fresh (no in-place update)
-      console.log(chalk.dim('  ─'.repeat(20)));
-      this.isPaused = false;
-    }
-    this.isFirstRender = true;
-    this.render();
+    console.log(chalk.dim('\n  ─'.repeat(20) + '\n'));
+    this.renderFresh();
   }
 
-  // Print final summary (no in-place update)
-  printSummary() {
-    this.lastLineCount = 0; // Disable in-place update
-    this.render();
+  // Print without in-place update
+  renderFresh() {
+    const lines = this.buildLines();
+    console.log('');
+    for (const line of lines) {
+      console.log(line);
+    }
+    console.log('');
   }
 
-  render() {
-    // Build output lines
+  buildLines() {
     const lines = [];
-
     for (let i = 0; i < this.steps.length; i++) {
       const step = this.steps[i];
       const symbol = SYMBOLS[step.status];
       const num = chalk.dim(`${i + 1}.`);
       const name = step.status === 'active' ? chalk.cyan(step.name) : step.name;
       const msg = step.message ? chalk.dim(` (${step.message})`) : '';
-
       lines.push(`  ${symbol} ${num} ${name}${msg}`);
 
-      // Show children only for active or done steps (not pending)
+      // Children for non-pending steps
       if (step.status !== 'pending') {
         for (let j = 0; j < step.children.length; j++) {
           const child = step.children[j];
@@ -149,35 +143,37 @@ class Timeline {
                          child.type === 'update' ? chalk.blue('~') :
                          child.type === 'skip' ? chalk.yellow('!') :
                          child.type === 'delete' ? chalk.red('-') :
+                         child.type === 'info' ? chalk.cyan('i') :
                          chalk.dim('•');
           lines.push(`  ${SYMBOLS.indent}${branch} ${prefix} ${child.text}`);
         }
       }
     }
+    return lines;
+  }
 
-    // Clear previous output (move cursor up and clear lines)
-    // Only do in-place update when not paused and have previous output
-    if (!this.isFirstRender && this.lastLineCount > 0 && !this.isPaused) {
-      // Move cursor up and clear each line
+  render() {
+    const lines = this.buildLines();
+
+    // In-place update only if enabled and have previous output
+    if (this.inPlaceEnabled && this.lastLineCount > 0) {
       process.stdout.write(`\x1b[${this.lastLineCount}A`);
       for (let i = 0; i < this.lastLineCount; i++) {
-        process.stdout.write('\x1b[2K\n'); // Clear line
+        process.stdout.write('\x1b[2K\n');
       }
-      process.stdout.write(`\x1b[${this.lastLineCount}A`); // Move back up
-    }
-
-    // Print new output
-    if (this.isFirstRender) {
-      console.log(''); // Initial blank line
-      this.isFirstRender = false;
+      process.stdout.write(`\x1b[${this.lastLineCount}A`);
+    } else if (this.lastLineCount === 0) {
+      // First render
+      console.log('');
     }
 
+    // If in-place disabled, just print below (no cursor movement)
     for (const line of lines) {
       console.log(line);
     }
-    console.log(''); // Trailing blank line
+    console.log('');
 
-    this.lastLineCount = lines.length + 1; // +1 for trailing blank
+    this.lastLineCount = this.inPlaceEnabled ? lines.length + 1 : 0;
   }
 }
 

package/src/commands/update.js

@@ -4,6 +4,7 @@
  * Update Command
  *
  * Updates the CSK CLI tool itself to latest version.
+ * Shows clear version comparison before and after update.
  */
 
 const chalk = require('chalk');
@@ -11,15 +12,33 @@ const ora = require('ora');
 const { execSync } = require('child_process');
 const pkg = require('../../package.json');
 
+/**
+ * Compare semantic versions
+ * @returns -1 if a < b, 0 if equal, 1 if a > b
+ */
+function compareVersions(a, b) {
+  const partsA = a.replace(/^v/, '').split('.').map(Number);
+  const partsB = b.replace(/^v/, '').split('.').map(Number);
+  for (let i = 0; i < 3; i++) {
+    if (partsA[i] > partsB[i]) return 1;
+    if (partsA[i] < partsB[i]) return -1;
+  }
+  return 0;
+}
+
 /**
  * Main update command handler
  */
 async function updateCommand() {
   console.log(chalk.cyan('\n  CSK CLI - Update\n'));
 
-  console.log(chalk.dim(`  Current version: v${pkg.version}\n`));
+  const currentVersion = pkg.version;
+
+  // Show version info box
+  console.log(chalk.dim('  ┌─────────────────────────────────────┐'));
+  console.log(chalk.dim('  │') + ` Current version: ${chalk.yellow('v' + currentVersion)}`.padEnd(46) + chalk.dim('│'));
 
-  const spinner = ora('Checking for updates...').start();
+  const spinner = ora({ text: 'Checking npm registry...', indent: 2 }).start();
 
   try {
     // Get latest version from npm
@@ -28,29 +47,53 @@ async function updateCommand() {
       stdio: ['pipe', 'pipe', 'pipe']
     }).trim();
 
-    if (latestVersion === pkg.version) {
-      spinner.succeed(chalk.green('Already on latest version'));
+    spinner.stop();
+    console.log(chalk.dim('  │') + ` Latest version:  ${chalk.green('v' + latestVersion)}`.padEnd(46) + chalk.dim('│'));
+    console.log(chalk.dim('  └─────────────────────────────────────┘\n'));
+
+    const comparison = compareVersions(currentVersion, latestVersion);
+
+    if (comparison === 0) {
+      console.log(chalk.green('  ✓ Already on latest version\n'));
       return;
     }
 
-    spinner.text = `Updating to v${latestVersion}...`;
+    if (comparison > 0) {
+      console.log(chalk.yellow('  ⚠ Local version is newer than npm (dev build?)\n'));
+      return;
+    }
+
+    // Need update
+    console.log(chalk.cyan(`  Updating v${currentVersion} → v${latestVersion}...\n`));
+
+    const updateSpinner = ora({ text: 'Installing update...', indent: 2 }).start();
 
-    // Run npm update
+    // Run npm update (hide npm output)
     execSync('npm install -g cskit-cli@latest', {
-      stdio: ['pipe', 'pipe', 'pipe']
+      stdio: 'ignore'  // Hide npm noise
     });
 
-    spinner.succeed(chalk.green(`Updated to v${latestVersion}`));
+    updateSpinner.succeed(chalk.green('Update complete'));
+
+    // Show summary
+    console.log('');
+    console.log(chalk.dim('  ┌─────────────────────────────────────┐'));
+    console.log(chalk.dim('  │') + ` ${chalk.red('v' + currentVersion)} → ${chalk.green('v' + latestVersion)}`.padEnd(55) + chalk.dim('│'));
+    console.log(chalk.dim('  └─────────────────────────────────────┘'));
+    console.log(chalk.dim('\n  Run `cskit init` to update project files.\n'));
 
-    console.log(chalk.dim('\n  Run `csk init` to update project files.\n'));
   } catch (error) {
-    if (error.message.includes('npm view')) {
-      spinner.fail(chalk.red('Could not check for updates'));
-      console.log(chalk.dim('\n  Package may not be published yet.\n'));
+    spinner.stop();
+    console.log(chalk.dim('  │') + ` Latest version:  ${chalk.red('(unavailable)')}`.padEnd(46) + chalk.dim('│'));
+    console.log(chalk.dim('  └─────────────────────────────────────┘\n'));
+
+    if (error.message.includes('npm view') || error.message.includes('404')) {
+      console.log(chalk.red('  ✗ Could not check for updates'));
+      console.log(chalk.dim('    Package may not be published yet.\n'));
     } else {
-      spinner.fail(chalk.red('Update failed'));
-      console.log(chalk.dim(`\n  ${error.message}`));
-      console.log(chalk.dim('\n  Try manually: npm install -g cskit-cli@latest\n'));
+      console.log(chalk.red('  ✗ Update failed'));
+      console.log(chalk.dim(`    ${error.message}`));
+      console.log(chalk.dim('\n    Try manually: npm install -g cskit-cli@latest\n'));
     }
   }
 }

package/src/postinstall.js

@@ -0,0 +1,29 @@
+#!/usr/bin/env node
+'use strict';
+
+/**
+ * Postinstall script - shows welcome message after npm install
+ */
+
+const pkg = require('../package.json');
+
+// Simple colors without requiring chalk (postinstall runs before deps ready)
+const cyan = (s) => `\x1b[36m${s}\x1b[0m`;
+const green = (s) => `\x1b[32m${s}\x1b[0m`;
+const dim = (s) => `\x1b[2m${s}\x1b[0m`;
+const bold = (s) => `\x1b[1m${s}\x1b[0m`;
+
+console.log('');
+console.log(cyan('  ┌─────────────────────────────────────────────────┐'));
+console.log(cyan('  │') + bold('       CSK CLI - Content Suite Kit              ') + cyan('│'));
+console.log(cyan('  └─────────────────────────────────────────────────┘'));
+console.log('');
+console.log(`  ${green('✓')} Installed ${bold('cskit-cli')} v${pkg.version}`);
+console.log('');
+console.log(dim('  Quick Start:'));
+console.log(`    ${bold('cskit auth')}     - Login with GitHub`);
+console.log(`    ${bold('cskit init')}     - Initialize project with skills`);
+console.log(`    ${bold('cskit update')}   - Update CLI to latest version`);
+console.log('');
+console.log(dim(`  Docs: ${pkg.homepage}`));
+console.log('');