myconvergio 2.1.0 → 2.1.2

package/README.md

@@ -4,7 +4,7 @@
 
 <img src="./CovergioLogoTransparent.png" alt="Convergio Logo" width="200"/>
 
-**v2.1.0** | 60 Specialized Agents | Enterprise-Grade AI Ecosystem
+**v2.1.2** | 60 Specialized Agents | Enterprise-Grade AI Ecosystem
 
 > *"Intent is human, momentum is agent"*
 > — [The Agentic Manifesto](./AgenticManifesto.md)
@@ -36,7 +36,7 @@ MyConvergio is an **open-source collection** of 60 specialized Claude Code subag
 
 Claude Code subagents are specialized AI assistants that can be invoked to handle specific types of tasks within the Claude Code environment. [Learn more in the official Anthropic documentation](https://docs.anthropic.com/en/docs/claude-code/sub-agents).
 
-### Key Features (v2.1.0)
+### Key Features (v2.1.2)
 
 | Feature | Description |
 |---------|-------------|
@@ -253,7 +253,7 @@ MyConvergio/
 │   ├── version-manager.sh
 │   └── bump-agent-version.sh
 ├── Makefile                       # Build and deploy commands
-├── VERSION                        # System version (2.1.0)
+├── VERSION                        # System version (2.1.2)
 └── CLAUDE.md                      # Project instructions
 ```
 
@@ -267,6 +267,7 @@ MyConvergio/
 myconvergio help        # Show available commands
 myconvergio install     # Install/reinstall to ~/.claude/
 myconvergio uninstall   # Remove from ~/.claude/
+myconvergio agents      # List all agents with versions and model tiers
 myconvergio version     # Show version and installation status
 ```
 
@@ -315,6 +316,7 @@ All major decisions are documented in `docs/adr/`:
 | ADR-008 | ConvergioCLI relationship |
 | ADR-009 | Skills & Rules system |
 | ADR-010 | ISE Engineering Playbook standard |
+| ADR-011 | Modular Execution Plans and Security Framework |
 
 ---
 
@@ -374,6 +376,6 @@ For questions about commercial licensing: roberdan@fightthestroke.org
 
 *Built with AI assistance in Milano, following the Agentic Manifesto principles*
 
-**v2.0.0** | December 2025
+**v2.1.2** | December 2025
 
 </div>

package/VERSION

@@ -3,7 +3,7 @@
 # Follows Semantic Versioning 2.0.0 (https://semver.org/)
 
 # System Version
-SYSTEM_VERSION=2.1.0
+SYSTEM_VERSION=2.1.2
 
 # Version Schema
 # AGENT_NAME=MAJOR.MINOR.PATCH[-PRERELEASE] TIMESTAMP

package/bin/myconvergio.js

@@ -131,18 +131,37 @@ function createBackup() {
   return null;
 }
 
+function hasExistingContent() {
+  const dirs = ['agents', 'rules', 'skills'];
+  for (const dir of dirs) {
+    const dirPath = path.join(CLAUDE_HOME, dir);
+    if (fs.existsSync(dirPath) && fs.readdirSync(dirPath).length > 0) {
+      return true;
+    }
+  }
+  return false;
+}
+
 function install(skipBackup = false) {
   log(colors.blue, 'Installing MyConvergio to ~/.claude/...\n');
 
-  // Check for existing installation
+  // Check for existing content and ALWAYS backup if found
   const existingManifest = loadManifest();
-  if (existingManifest.version && !skipBackup) {
-    log(colors.yellow, `Existing installation found (v${existingManifest.version})`);
-    log(colors.yellow, 'Creating backup before upgrade...\n');
+  const hasContent = hasExistingContent();
+
+  if (!skipBackup && hasContent) {
+    if (existingManifest.version) {
+      log(colors.yellow, `Upgrading from v${existingManifest.version}...`);
+    } else {
+      log(colors.yellow, 'Existing ~/.claude/ content detected.');
+    }
+    log(colors.yellow, 'Creating backup before installation...\n');
     const backupDir = createBackup();
     if (backupDir) {
       log(colors.green, `  ✓ Backup created: ${backupDir}\n`);
     }
+  } else if (!hasContent) {
+    log(colors.blue, 'Fresh installation to ~/.claude/\n');
   }
 
   const srcAgents = path.join(PACKAGE_ROOT, '.claude', 'agents');
@@ -253,6 +272,56 @@ function showVersion() {
   console.log(`  Skills: ${counts.skills > 0 ? counts.skills : colors.red + 'not installed' + colors.reset}`);
 }
 
+function listAgents() {
+  log(colors.blue, 'Installed Agents:\n');
+
+  const agentsDir = path.join(CLAUDE_HOME, 'agents');
+  if (!fs.existsSync(agentsDir)) {
+    log(colors.red, 'No agents installed. Run: myconvergio install');
+    return;
+  }
+
+  const categories = fs.readdirSync(agentsDir).filter(f =>
+    fs.statSync(path.join(agentsDir, f)).isDirectory()
+  );
+
+  let totalAgents = 0;
+
+  for (const category of categories.sort()) {
+    const categoryPath = path.join(agentsDir, category);
+    const agents = fs.readdirSync(categoryPath).filter(f =>
+      f.endsWith('.md') &&
+      !['CONSTITUTION.md', 'CommonValuesAndPrinciples.md', 'SECURITY_FRAMEWORK_TEMPLATE.md', 'MICROSOFT_VALUES.md'].includes(f)
+    );
+
+    if (agents.length === 0) continue;
+
+    log(colors.yellow, `\n${category}/`);
+
+    for (const agent of agents.sort()) {
+      const agentPath = path.join(categoryPath, agent);
+      const content = fs.readFileSync(agentPath, 'utf8');
+
+      // Extract version from YAML frontmatter
+      const versionMatch = content.match(/^version:\s*["']?([^"'\n]+)["']?/m);
+      const version = versionMatch ? versionMatch[1] : 'unknown';
+
+      // Extract model from YAML frontmatter
+      const modelMatch = content.match(/^model:\s*["']?([^"'\n]+)["']?/m);
+      const model = modelMatch ? modelMatch[1] : 'haiku';
+
+      const agentName = agent.replace('.md', '');
+      const modelColor = model === 'opus' ? colors.red : model === 'sonnet' ? colors.yellow : colors.reset;
+
+      console.log(`  ${agentName.padEnd(45)} v${version.padEnd(8)} ${modelColor}${model}${colors.reset}`);
+      totalAgents++;
+    }
+  }
+
+  console.log('');
+  log(colors.green, `Total: ${totalAgents} agents`);
+}
+
 function showHelp() {
   console.log(`
 ${colors.blue}MyConvergio - Claude Code Subagents Suite${colors.reset}
@@ -263,11 +332,13 @@ ${colors.yellow}Usage:${colors.reset}
 ${colors.yellow}Commands:${colors.reset}
   install     Install/reinstall agents, rules, and skills to ~/.claude/
   uninstall   Remove all installed components from ~/.claude/
+  agents      List all installed agents with versions
   version     Show version and installation status
   help        Show this help message
 
 ${colors.yellow}Examples:${colors.reset}
   myconvergio install     # Install or update components
+  myconvergio agents      # List all agents with versions
   myconvergio version     # Check what's installed
   myconvergio uninstall   # Remove everything
 
@@ -290,6 +361,10 @@ switch (command) {
   case 'remove':
     uninstall();
     break;
+  case 'agents':
+  case 'list':
+    listAgents();
+    break;
   case 'version':
   case '-v':
   case '--version':

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "myconvergio",
-  "version": "2.1.0",
+  "version": "2.1.2",
   "description": "60 specialized Claude Code subagents for enterprise software development, strategic leadership, and organizational excellence",
   "keywords": [
     "claude",
@@ -11,18 +11,18 @@
     "enterprise",
     "productivity"
   ],
-  "homepage": "https://github.com/roberdan/MyConvergio",
+  "homepage": "https://github.com/Roberdan/MyConvergio",
   "bugs": {
-    "url": "https://github.com/roberdan/MyConvergio/issues"
+    "url": "https://github.com/Roberdan/MyConvergio/issues"
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/roberdan/MyConvergio.git"
+    "url": "git+https://github.com/Roberdan/MyConvergio.git"
   },
   "license": "CC-BY-NC-SA-4.0",
   "author": "Roberto D'Angelo <roberdan@fightthestroke.org>",
   "bin": {
-    "myconvergio": "./bin/myconvergio.js"
+    "myconvergio": "bin/myconvergio.js"
   },
   "files": [
     "bin/",

package/scripts/postinstall.js

@@ -29,7 +29,8 @@ const colors = {
 };
 
 function log(color, message) {
-  console.log(`${color}${message}${colors.reset}`);
+  // Use stderr for npm postinstall visibility (npm suppresses stdout)
+  process.stderr.write(`${color}${message}${colors.reset}\n`);
 }
 
 function copyRecursive(src, dest, installedFiles = []) {
@@ -111,6 +112,17 @@ function countDirs(dir) {
   ).length;
 }
 
+function hasExistingContent() {
+  const dirs = ['agents', 'rules', 'skills'];
+  for (const dir of dirs) {
+    const dirPath = path.join(CLAUDE_HOME, dir);
+    if (fs.existsSync(dirPath) && fs.readdirSync(dirPath).length > 0) {
+      return true;
+    }
+  }
+  return false;
+}
+
 function main() {
   // Skip if running in CI or if MYCONVERGIO_SKIP_POSTINSTALL is set
   if (process.env.CI || process.env.MYCONVERGIO_SKIP_POSTINSTALL) {
@@ -130,15 +142,24 @@ function main() {
     return;
   }
 
-  // Check for existing installation and backup
+  // Check for existing content and ALWAYS backup if found
   const existingManifest = loadManifest();
+  const hasContent = hasExistingContent();
+
   if (existingManifest.version) {
-    log(colors.yellow, `Existing installation found (v${existingManifest.version})`);
-    log(colors.yellow, 'Creating backup before upgrade...\n');
+    log(colors.yellow, `Upgrading from v${existingManifest.version}...`);
+  } else if (hasContent) {
+    log(colors.yellow, 'Existing ~/.claude/ content detected (not installed via npm).');
+  }
+
+  if (hasContent) {
+    log(colors.yellow, 'Creating backup before installation...\n');
     const backupDir = createBackup();
     if (backupDir) {
       log(colors.green, `  ✓ Backup created: ${backupDir}\n`);
     }
+  } else {
+    log(colors.blue, 'Fresh installation to ~/.claude/\n');
   }
 
   const installedFiles = [];
@@ -161,12 +182,12 @@ function main() {
   saveManifest(installedFiles, version);
   log(colors.green, `  ✓ Saved manifest (${installedFiles.length} files)`);
 
-  console.log('');
+  process.stderr.write('\n');
   log(colors.green, '✅ MyConvergio installed successfully!');
-  console.log('');
+  process.stderr.write('\n');
   log(colors.yellow, 'Your ~/.claude/CLAUDE.md was NOT modified.');
-  console.log('Create your own configuration file if needed.\n');
-  console.log('Run `myconvergio help` for available commands.\n');
+  process.stderr.write('Create your own configuration file if needed.\n');
+  process.stderr.write('Run `myconvergio help` for available commands.\n\n');
 }
 
 main();