@gravirei/reis 2.6.0 → 2.6.2

package/CHANGELOG.md

@@ -1,5 +1,55 @@
 # Changelog
 
+## [2.6.2] - 2026-01-26
+
+### 🐛 Critical Bug Fix
+
+#### Subagents Not Installed/Updated on `npm install`
+- **Added `postinstall` script** to automatically install REIS files when package is installed
+- **Subagents now always update** to latest version (previously skipped if files existed)
+- **Fixed missing `reis_plan_reviewer.md`** subagent not being installed
+- Added `--silent` flag support for clean postinstall output
+
+### 📦 What Changed
+
+- `npm install -g @gravirei/reis` now automatically installs all subagents
+- Subagent files are always overwritten to stay in sync with package version
+- Silent mode: no output during `npm install` (cleaner experience)
+
+---
+
+## [2.6.1] - 2026-01-26
+
+### 🐛 Bug Fixes
+
+#### Fixed `reis update` Command
+- **Fixed crash** when a new version was available (missing `showWarning` function)
+- Command now works correctly for all scenarios
+
+### ✨ UI Improvements
+
+#### Redesigned `reis update` Command
+- Added welcome banner (consistent with `reis help`)
+- Shows current version first, then checks for updates
+- Beautiful bordered info boxes for status display
+- **User confirmation prompt** before downloading updates
+- Clear success/error messages with helpful instructions
+- Non-interactive mode fallback with manual instructions
+
+#### Redesigned `reis whats-new` Command
+- Added welcome banner (consistent with `reis help`)
+- **Now parses actual `CHANGELOG.md`** instead of hardcoded content
+- Shows up to 3 major sections with smart truncation
+- Displays bullet points, headers, and code examples nicely
+- Fallback message if version not found in changelog
+- Links to full changelog and documentation
+
+### 🔧 Internal Changes
+
+- Added `showWarning` function to `lib/utils/command-helpers.js`
+
+---
+
 ## [2.6.0] - 2026-01-26
 
 ### 🎯 Major Features

package/lib/commands/update.js

@@ -1,5 +1,6 @@
-const { showInfo, showSuccess, showError, showWarning, getVersion } = require('../utils/command-helpers.js');
+const chalk = require('chalk');
 const { execSync } = require('child_process');
+const { getVersion } = require('../utils/command-helpers.js');
 
 /**
  * Update command - check for and install REIS updates
@@ -8,68 +9,130 @@ const { execSync } = require('child_process');
 module.exports = async function(args) {
   const currentVersion = getVersion();
   const packageName = '@gravirei/reis';
+  const w = chalk.bold.white;
+  const g = chalk.green;
+  const y = chalk.yellow;
+  const r = chalk.red;
+  const c = chalk.cyan;
+
+  // ASCII Art Banner
+  console.log(w(`
+                       ██████╗ ███████╗██╗███████╗
+                       ██╔══██╗██╔════╝██║██╔════╝
+                       ██████╔╝█████╗  ██║███████╗
+                       ██╔══██╗██╔══╝  ██║╚════██║
+                       ██║  ██║███████╗██║███████║
+                       ╚═╝  ╚═╝╚══════╝╚═╝╚══════╝
+`));
   
+  console.log(w('             REIS - Roadmap Execution & Implementation System'));
+  console.log(w('                  Specially designed for Atlassian Rovo Dev'));
   console.log('');
-  showInfo('🔍 Checking for REIS updates...');
+  console.log(w('●  Update Manager'));
+  console.log(w('   ───────────────'));
   console.log('');
-  showInfo(`   Current version: v${currentVersion}`);
-  
+  console.log(w(`   Current Version:  v${currentVersion}`));
+  console.log('');
+  console.log(c('   🔍 Checking for updates...'));
+  console.log('');
+
   try {
     // Check latest version from npm
     const latestVersion = execSync(`npm view ${packageName} version 2>/dev/null`, { 
       encoding: 'utf-8' 
     }).trim();
-    
-    showInfo(`   Latest version:  v${latestVersion}`);
-    console.log('');
-    
+
     if (currentVersion === latestVersion) {
-      showSuccess('✅ You are already on the latest version!');
+      // Already up to date
+      console.log(w('   ┌──────────────────────────────────────────────────────┐'));
+      console.log(w('   │  ') + g('✅ You\'re up to date!') + w('                              │'));
+      console.log(w('   │                                                      │'));
+      console.log(w('   │     Installed: ') + g(`v${currentVersion}`) + w(' (latest)' + ' '.repeat(Math.max(0, 22 - currentVersion.length))) + w('│'));
+      console.log(w('   └──────────────────────────────────────────────────────┘'));
       console.log('');
       return 0;
     }
-    
+
     // New version available
-    showWarning(`📦 New version available: v${currentVersion} → v${latestVersion}`);
+    console.log(w(`   Latest Version:   v${latestVersion}`));
     console.log('');
-    showInfo('   Updating REIS...');
+    console.log(w('   ┌──────────────────────────────────────────────────────┐'));
+    console.log(w('   │  ') + y('📦 New version available!') + w('                          │'));
+    console.log(w('   │                                                      │'));
+    const versionLine = `v${currentVersion}  →  v${latestVersion}`;
+    const padding = Math.max(0, 38 - versionLine.length);
+    console.log(w('   │     ') + c(versionLine) + w(' '.repeat(padding) + '│'));
+    console.log(w('   └──────────────────────────────────────────────────────┘'));
     console.log('');
-    
+
+    // Ask user for confirmation
+    const inquirer = require('inquirer');
     try {
-      // Try global update
-      execSync(`npm install -g ${packageName}@latest`, { 
-        stdio: 'inherit',
-        encoding: 'utf-8'
-      });
-      
-      console.log('');
-      showSuccess(`✅ Successfully updated to v${latestVersion}!`);
-      console.log('');
-      showInfo('   Run "reis whats-new" to see what\'s changed.');
+      const { confirmUpdate } = await inquirer.prompt([
+        {
+          type: 'confirm',
+          name: 'confirmUpdate',
+          message: 'Do you want to update REIS now?',
+          default: true
+        }
+      ]);
+
       console.log('');
-      
-    } catch (installError) {
-      // If global install fails, suggest manual update
+
+      if (!confirmUpdate) {
+        console.log(c('   ℹ Update skipped. Run "reis update" anytime to update.'));
+        console.log('');
+        return 0;
+      }
+
+      // User confirmed, proceed with update
+      console.log(c(`   ⏳ Downloading and installing v${latestVersion}...`));
       console.log('');
-      showError('❌ Automatic update failed (may need sudo/admin privileges)');
+
+      try {
+        // Try global update
+        execSync(`npm install -g ${packageName}@latest`, { 
+          stdio: 'inherit',
+          encoding: 'utf-8'
+        });
+        
+        console.log('');
+        console.log(g(`   ✓ Successfully updated to v${latestVersion}!`));
+        console.log('');
+        console.log(c('   Run "reis whats-new" to see what\'s changed.'));
+        console.log('');
+        return 0;
+
+      } catch (installError) {
+        // If global install fails, suggest manual update
+        console.log('');
+        console.log(r('   ❌ Update failed (may need elevated privileges)'));
+        console.log('');
+        console.log(w('   Try manually:'));
+        console.log(c(`   $ sudo npm install -g ${packageName}@latest`));
+        console.log('');
+        return 1;
+      }
+
+    } catch (promptError) {
+      // Non-interactive mode - show manual instructions
+      console.log(y('   Non-interactive mode detected.'));
       console.log('');
-      showInfo('   Try manually:');
-      showInfo(`   $ sudo npm install -g ${packageName}@latest`);
-      showInfo('   or');
-      showInfo(`   $ npm install -g ${packageName}@latest --force`);
+      console.log(w('   To update manually, run:'));
+      console.log(c(`   $ npm install -g ${packageName}@latest`));
       console.log('');
-      return 1;
+      return 0;
     }
-    
+
   } catch (error) {
-    showError('❌ Failed to check for updates');
-    showInfo('   Check your internet connection and try again.');
+    // Network error or npm not available
+    console.log(r('   ❌ Could not check for updates'));
     console.log('');
-    showInfo('   Manual update:');
-    showInfo(`   $ npm install -g ${packageName}@latest`);
+    console.log(w('   Please check your internet connection and try again.'));
+    console.log('');
+    console.log(w('   Manual update:'));
+    console.log(c(`   $ npm install -g ${packageName}@latest`));
     console.log('');
     return 1;
   }
-  
-  return 0;
 };

package/lib/commands/whats-new.js

@@ -1,4 +1,116 @@
-const { showInfo, getVersion } = require('../utils/command-helpers.js');
+const chalk = require('chalk');
+const fs = require('fs');
+const path = require('path');
+const { getVersion } = require('../utils/command-helpers.js');
+
+/**
+ * Parse CHANGELOG.md and extract changes for a specific version
+ * @param {string} version - Version to find (e.g., "2.6.0")
+ * @returns {object} - { found: boolean, title: string, sections: [{header, items}] }
+ */
+function parseChangelog(version) {
+  const changelogPaths = [
+    path.join(__dirname, '../../CHANGELOG.md'),
+    path.join(process.cwd(), 'CHANGELOG.md')
+  ];
+
+  let changelogContent = null;
+  for (const p of changelogPaths) {
+    if (fs.existsSync(p)) {
+      changelogContent = fs.readFileSync(p, 'utf-8');
+      break;
+    }
+  }
+
+  if (!changelogContent) {
+    return { found: false, title: '', sections: [] };
+  }
+
+  // Find the section for this version
+  const versionRegex = new RegExp(`^## \\[${version.replace(/\./g, '\\.')}\\].*$`, 'm');
+  const match = changelogContent.match(versionRegex);
+  
+  if (!match) {
+    return { found: false, title: '', sections: [] };
+  }
+
+  const startIndex = match.index;
+  const title = match[0];
+
+  // Find the next version section (or end of file)
+  const nextVersionRegex = /^## \[/m;
+  const afterStart = changelogContent.substring(startIndex + title.length);
+  const nextMatch = afterStart.match(nextVersionRegex);
+  
+  const endIndex = nextMatch 
+    ? startIndex + title.length + nextMatch.index 
+    : changelogContent.length;
+
+  const versionContent = changelogContent.substring(startIndex + title.length, endIndex).trim();
+
+  // Parse sections (### headers)
+  const sections = [];
+  const sectionRegex = /^### (.+)$/gm;
+  let lastIndex = 0;
+  let currentSection = null;
+  let sectionMatch;
+
+  while ((sectionMatch = sectionRegex.exec(versionContent)) !== null) {
+    if (currentSection) {
+      currentSection.content = versionContent.substring(lastIndex, sectionMatch.index).trim();
+      sections.push(currentSection);
+    }
+    currentSection = { header: sectionMatch[1], content: '' };
+    lastIndex = sectionMatch.index + sectionMatch[0].length;
+  }
+
+  if (currentSection) {
+    currentSection.content = versionContent.substring(lastIndex).trim();
+    sections.push(currentSection);
+  }
+
+  // If no ### sections, treat entire content as one section
+  if (sections.length === 0 && versionContent) {
+    sections.push({ header: 'Changes', content: versionContent });
+  }
+
+  return { found: true, title, sections };
+}
+
+/**
+ * Format and display a section's content
+ * @param {string} content - Section content
+ * @param {function} w - White chalk function
+ * @param {function} c - Cyan chalk function
+ */
+function displaySectionContent(content, w, c) {
+  const lines = content.split('\n');
+  
+  for (const line of lines) {
+    // Skip code blocks for cleaner display
+    if (line.startsWith('```')) continue;
+    
+    // Handle bullet points
+    if (line.startsWith('- ') || line.startsWith('* ')) {
+      console.log(c('   •') + w(' ' + line.substring(2)));
+    }
+    // Handle sub-headers (####)
+    else if (line.startsWith('#### ')) {
+      console.log('');
+      console.log(w('   ' + line.substring(5)));
+    }
+    // Handle code in backticks (command examples)
+    else if (line.includes('`') && !line.startsWith('```')) {
+      // Display inline code lines
+      const formatted = line.replace(/`([^`]+)`/g, chalk.cyan('$1'));
+      console.log(w('   ' + formatted));
+    }
+    // Skip empty lines at start, show others
+    else if (line.trim()) {
+      console.log(w('   ' + line));
+    }
+  }
+}
 
 /**
  * Whats-new command - show recent changes and features
@@ -6,14 +118,78 @@ const { showInfo, getVersion } = require('../utils/command-helpers.js');
  */
 module.exports = function(args) {
   const version = getVersion();
+  const w = chalk.bold.white;
+  const g = chalk.green;
+  const c = chalk.cyan;
+  const y = chalk.yellow;
+
+  // ASCII Art Banner
+  console.log(w(`
+                       ██████╗ ███████╗██╗███████╗
+                       ██╔══██╗██╔════╝██║██╔════╝
+                       ██████╔╝█████╗  ██║███████╗
+                       ██╔══██╗██╔══╝  ██║╚════██║
+                       ██║  ██║███████╗██║███████║
+                       ╚═╝  ╚═╝╚══════╝╚═╝╚══════╝
+`));
   
-  showInfo(`REIS v${version} - What's New`);
-  showInfo('');
-  showInfo('• Initial release');
-  showInfo('• 29 commands for systematic development');
-  showInfo('• Parallel subagent execution (up to 4 simultaneous)');
-  showInfo('• Fresh context per task (200k tokens)');
-  showInfo('• Transformed from GSD for Rovo Dev');
-  showInfo('');
-  showInfo('Full documentation: ~/.rovodev/reis/README.md');
+  console.log(w('             REIS - Roadmap Execution & Implementation System'));
+  console.log(w('                  Specially designed for Atlassian Rovo Dev'));
+  console.log('');
+  console.log(w('●  What\'s New in v' + version));
+  console.log(w('   ' + '─'.repeat(18 + version.length)));
+  console.log('');
+
+  // Parse changelog for current version
+  const changelog = parseChangelog(version);
+
+  if (!changelog.found) {
+    // Fallback if version not found in changelog
+    console.log(y('   No changelog entry found for v' + version));
+    console.log('');
+    console.log(w('   This may be a development version or the changelog'));
+    console.log(w('   hasn\'t been updated yet.'));
+    console.log('');
+    console.log(w('   For full documentation:'));
+    console.log(c('   ~/.rovodev/reis/README.md'));
+    console.log('');
+    return;
+  }
+
+  // Display sections (limit to first 3 major sections for readability)
+  const maxSections = 3;
+  const displaySections = changelog.sections.slice(0, maxSections);
+
+  for (const section of displaySections) {
+    console.log(g('   ' + section.header));
+    console.log('');
+    
+    // Limit content display for very long sections
+    const contentLines = section.content.split('\n');
+    const maxLines = 20;
+    const truncatedContent = contentLines.slice(0, maxLines).join('\n');
+    
+    displaySectionContent(truncatedContent, w, c);
+    
+    if (contentLines.length > maxLines) {
+      console.log('');
+      console.log(y('   ... and more'));
+    }
+    console.log('');
+  }
+
+  if (changelog.sections.length > maxSections) {
+    console.log(y(`   + ${changelog.sections.length - maxSections} more sections`));
+    console.log('');
+  }
+
+  // Footer
+  console.log(w('   ───────────────────────────────────────────────────────'));
+  console.log('');
+  console.log(w('   Full changelog:'));
+  console.log(c('   ~/.rovodev/reis/CHANGELOG.md'));
+  console.log('');
+  console.log(w('   Documentation:'));
+  console.log(c('   ~/.rovodev/reis/README.md'));
+  console.log('');
 };

package/lib/install.js

@@ -19,7 +19,8 @@ ${chalk.white.bold('  ██   ██ ███████ ██ ████
 `;
 
 // Check if running in CI environment or sudo (where stdin is not available)
-const isCIEnvironment = process.env.CI === 'true' || process.argv.includes('--silent');
+const isSilentMode = process.argv.includes('--silent');
+const isCIEnvironment = process.env.CI === 'true' || isSilentMode;
 const isSudo = process.getuid && process.getuid() === 0;
 // Check if stdin is actually readable (not just isTTY)
 const hasInteractiveStdin = process.stdin.isTTY && !process.stdin.destroyed && typeof process.stdin.read === 'function';
@@ -28,29 +29,39 @@ const isInteractive = !isCIEnvironment && !isSudo && hasInteractiveStdin;
 // Main installation function
 async function install() {
   try {
-    // Always show banner
-    console.log(banner);
+    // Show banner unless in silent mode
+    if (!isSilentMode) {
+      console.log(banner);
+    }
     
     // Check for non-interactive modes
     if (isCIEnvironment) {
-      console.log(chalk.gray('Running in CI mode - installing automatically...\n'));
-      await performInstallation();
+      if (!isSilentMode) {
+        console.log(chalk.gray('Running in CI mode - installing automatically...\n'));
+      }
+      await performInstallation(false, isSilentMode);
       return;
     }
     
     if (isSudo) {
-      console.log(chalk.gray('Running with sudo - installing automatically...\n'));
-      await performInstallation();
+      if (!isSilentMode) {
+        console.log(chalk.gray('Running with sudo - installing automatically...\n'));
+      }
+      await performInstallation(false, isSilentMode);
       return;
     }
     
     // Interactive mode - show prompt
-    console.log(chalk.white('This will install REIS files to ~/.rovodev/reis/\n'));
+    if (!isSilentMode) {
+      console.log(chalk.white('This will install REIS files to ~/.rovodev/reis/\n'));
+    }
     
     // Double-check we can actually prompt
     if (!isInteractive) {
-      console.log(chalk.gray('Non-interactive mode detected - installing automatically...\n'));
-      await performInstallation();
+      if (!isSilentMode) {
+        console.log(chalk.gray('Non-interactive mode detected - installing automatically...\n'));
+      }
+      await performInstallation(false, isSilentMode);
       return;
     }
     
@@ -71,11 +82,13 @@ async function install() {
       }
       
       console.log('');
-      await performInstallation();
+      await performInstallation(false, false);
     } catch (promptError) {
       // inquirer failed, install anyway
-      console.log(chalk.gray('Prompt failed - installing automatically...\n'));
-      await performInstallation();
+      if (!isSilentMode) {
+        console.log(chalk.gray('Prompt failed - installing automatically...\n'));
+      }
+      await performInstallation(false, isSilentMode);
     }
     
   } catch (error) {
@@ -124,13 +137,15 @@ async function performInstallation(overwrite = false, silent = false) {
   }
   
   // Copy subagents from subagents/ to ~/.rovodev/subagents/
+  // ALWAYS overwrite subagents - they should stay up-to-date with package version
   const subagentsSourceDir = path.join(packageDir, 'subagents');
   if (fs.existsSync(subagentsSourceDir)) {
     const subagentFiles = fs.readdirSync(subagentsSourceDir);
     subagentFiles.forEach(file => {
       const src = path.join(subagentsSourceDir, file);
       const dest = path.join(subagentsDir, file);
-      if (copyFile(src, dest, overwrite)) {
+      // Always overwrite subagent files to ensure they're up-to-date
+      if (copyFile(src, dest, true)) {
         fileCount++;
       }
     });

package/lib/utils/command-helpers.js

@@ -36,6 +36,14 @@ function showInfo(message) {
   console.log(chalk.cyan(message));
 }
 
+/**
+ * Display a warning message
+ * @param {string} message - The warning message
+ */
+function showWarning(message) {
+  console.log(chalk.yellow(`⚠ ${message}`));
+}
+
 /**
  * Get the package version
  * @returns {string} - The version string
@@ -77,6 +85,7 @@ module.exports = {
   showError,
   showSuccess,
   showInfo,
+  showWarning,
   getVersion,
   checkPlanningDir,
   validatePhaseNumber

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gravirei/reis",
-  "version": "2.6.0",
+  "version": "2.6.2",
   "description": "Roadmap Execution & Implementation System v2.0 - Wave-based execution with checkpoints, metrics, and visualization for Atlassian Rovo Dev",
   "main": "lib/index.js",
   "bin": {
@@ -8,7 +8,8 @@
   },
   "scripts": {
     "test": "mocha test/**/*.test.js --timeout 5000",
-    "test:watch": "mocha test/**/*.test.js --watch"
+    "test:watch": "mocha test/**/*.test.js --watch",
+    "postinstall": "node lib/install.js --silent"
   },
   "keywords": [
     "reis",