myconvergio 2.1.0

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "myconvergio",
+  "version": "2.1.0",
+  "description": "60 specialized Claude Code subagents for enterprise software development, strategic leadership, and organizational excellence",
+  "keywords": [
+    "claude",
+    "claude-code",
+    "ai-agents",
+    "subagents",
+    "anthropic",
+    "enterprise",
+    "productivity"
+  ],
+  "homepage": "https://github.com/roberdan/MyConvergio",
+  "bugs": {
+    "url": "https://github.com/roberdan/MyConvergio/issues"
+  },
+  "repository": {
+    "type": "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"
+  },
+  "files": [
+    "bin/",
+    "scripts/",
+    ".claude/agents/",
+    ".claude/rules/",
+    ".claude/skills/",
+    "VERSION",
+    "LICENSE"
+  ],
+  "scripts": {
+    "postinstall": "node scripts/postinstall.js",
+    "test": "make test"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/scripts/bump-agent-version.sh

@@ -0,0 +1,220 @@
+#!/bin/bash
+
+# =============================================================================
+# AGENT VERSION BUMP SCRIPT
+# =============================================================================
+# Bumps version for specific agent or all agents
+# Updates both frontmatter and changelog
+# Part of WAVE 5 Agent Optimization Plan 2025
+# Version: 1.0.0
+# =============================================================================
+
+set -euo pipefail
+
+# Colors
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+BLUE='\033[0;34m'
+YELLOW='\033[1;33m'
+NC='\033[0m'
+
+# Paths
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+ROOT_DIR="$(dirname "$SCRIPT_DIR")"
+AGENTS_DIR="$ROOT_DIR/.claude/agents"
+
+# Get current date
+CURRENT_DATE=$(date +%Y-%m-%d)
+
+# Function to extract current version from frontmatter
+get_current_version() {
+    local file="$1"
+    grep '^version:' "$file" | sed 's/version: "\(.*\)"/\1/' | tr -d '"'
+}
+
+# Function to bump version
+bump_version() {
+    local version="$1"
+    local bump_type="$2"
+
+    IFS='.' read -r major minor patch <<< "$version"
+
+    case "$bump_type" in
+        major)
+            echo "$((major + 1)).0.0"
+            ;;
+        minor)
+            echo "${major}.$((minor + 1)).0"
+            ;;
+        patch)
+            echo "${major}.${minor}.$((patch + 1))"
+            ;;
+        *)
+            echo "$version"
+            ;;
+    esac
+}
+
+# Function to update version in file
+update_agent_version() {
+    local file="$1"
+    local new_version="$2"
+    local change_description="$3"
+
+    local agent_name=$(basename "$file" .md)
+    local current_version=$(get_current_version "$file")
+
+    if [ -z "$current_version" ]; then
+        echo -e "${RED}Error: Could not find version in $agent_name${NC}" >&2
+        return 1
+    fi
+
+    echo -e "${BLUE}Updating $agent_name: $current_version → $new_version${NC}"
+
+    # Update version in frontmatter
+    if [[ "$OSTYPE" == "darwin"* ]]; then
+        # macOS
+        sed -i '' "s/^version: \".*\"/version: \"$new_version\"/" "$file"
+    else
+        # Linux
+        sed -i "s/^version: \".*\"/version: \"$new_version\"/" "$file"
+    fi
+
+    # Add changelog entry
+    local changelog_entry="- **$new_version** ($CURRENT_DATE): $change_description"
+
+    # Find the changelog section and add the new entry after "## Changelog"
+    if grep -q "^## Changelog" "$file"; then
+        if [[ "$OSTYPE" == "darwin"* ]]; then
+            # macOS
+            sed -i '' "/^## Changelog/a\\
+$changelog_entry
+" "$file"
+        else
+            # Linux
+            sed -i "/^## Changelog/a $changelog_entry" "$file"
+        fi
+    else
+        echo -e "${YELLOW}Warning: No changelog section found in $agent_name${NC}"
+    fi
+
+    echo -e "${GREEN}✓ Updated $agent_name${NC}"
+}
+
+# Show help
+show_help() {
+    echo -e "${BLUE}MyConvergio Agent Version Bump${NC}"
+    echo "Usage: $0 [options] <bump_type> [agent_name] [change_description]"
+    echo ""
+    echo "Bump Types:"
+    echo "  major         Bump major version (X.0.0)"
+    echo "  minor         Bump minor version (0.X.0)"
+    echo "  patch         Bump patch version (0.0.X)"
+    echo ""
+    echo "Options:"
+    echo "  --all         Bump all agents"
+    echo "  --help, -h    Show this help message"
+    echo ""
+    echo "Examples:"
+    echo "  $0 patch ali-chief-of-staff 'Fixed bug in orchestration'"
+    echo "  $0 minor baccio-tech-architect 'Added new architecture patterns'"
+    echo "  $0 --all patch 'Security framework updates'"
+    echo ""
+}
+
+# Main function
+main() {
+    local bump_all=false
+    local bump_type=""
+    local agent_name=""
+    local change_description=""
+
+    # Parse arguments
+    while [[ $# -gt 0 ]]; do
+        case "$1" in
+            --all)
+                bump_all=true
+                shift
+                ;;
+            --help|-h)
+                show_help
+                exit 0
+                ;;
+            major|minor|patch)
+                bump_type="$1"
+                shift
+                ;;
+            *)
+                if [ -z "$agent_name" ]; then
+                    agent_name="$1"
+                elif [ -z "$change_description" ]; then
+                    change_description="$1"
+                fi
+                shift
+                ;;
+        esac
+    done
+
+    # Validate arguments
+    if [ -z "$bump_type" ]; then
+        echo -e "${RED}Error: Bump type required (major|minor|patch)${NC}" >&2
+        show_help
+        exit 1
+    fi
+
+    if [ -z "$change_description" ]; then
+        echo -e "${RED}Error: Change description required${NC}" >&2
+        show_help
+        exit 1
+    fi
+
+    if [ "$bump_all" = true ]; then
+        echo -e "${BLUE}Bumping all agents ($bump_type)...${NC}"
+        echo ""
+
+        local count=0
+        find "$AGENTS_DIR" -type f -name "*.md" \
+            ! -name "CONSTITUTION.md" \
+            ! -name "MICROSOFT_VALUES.md" \
+            ! -name "CommonValuesAndPrinciples.md" \
+            ! -name "SECURITY_FRAMEWORK_TEMPLATE.md" | while read -r file; do
+
+            local current_version=$(get_current_version "$file")
+            local new_version=$(bump_version "$current_version" "$bump_type")
+            update_agent_version "$file" "$new_version" "$change_description"
+            count=$((count + 1))
+        done
+
+        echo ""
+        echo -e "${GREEN}✨ All agents updated!${NC}"
+    else
+        if [ -z "$agent_name" ]; then
+            echo -e "${RED}Error: Agent name required${NC}" >&2
+            show_help
+            exit 1
+        fi
+
+        # Find the agent file
+        local agent_file=$(find "$AGENTS_DIR" -type f -name "$agent_name.md" | head -1)
+
+        if [ -z "$agent_file" ]; then
+            echo -e "${RED}Error: Agent '$agent_name' not found${NC}" >&2
+            exit 1
+        fi
+
+        local current_version=$(get_current_version "$agent_file")
+        local new_version=$(bump_version "$current_version" "$bump_type")
+        update_agent_version "$agent_file" "$new_version" "$change_description"
+
+        echo ""
+        echo -e "${GREEN}✨ Version bumped successfully!${NC}"
+    fi
+}
+
+# Run the script
+if [ $# -eq 0 ]; then
+    show_help
+    exit 0
+fi
+
+main "$@"

package/scripts/postinstall.js

@@ -0,0 +1,172 @@
+#!/usr/bin/env node
+
+/**
+ * MyConvergio Post-Install Script
+ *
+ * Automatically copies agents, rules, and skills to ~/.claude/
+ * after npm install -g myconvergio
+ *
+ * Features:
+ * - Creates backup if existing installation found
+ * - Saves manifest of installed files for safe uninstall
+ * - Preserves user's custom files and CLAUDE.md
+ */
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+const CLAUDE_HOME = path.join(os.homedir(), '.claude');
+const PACKAGE_ROOT = path.join(__dirname, '..');
+const MANIFEST_FILE = path.join(CLAUDE_HOME, '.myconvergio-manifest.json');
+
+// Colors for terminal output
+const colors = {
+  reset: '\x1b[0m',
+  green: '\x1b[32m',
+  yellow: '\x1b[33m',
+  blue: '\x1b[34m',
+};
+
+function log(color, message) {
+  console.log(`${color}${message}${colors.reset}`);
+}
+
+function copyRecursive(src, dest, installedFiles = []) {
+  if (!fs.existsSync(src)) {
+    return installedFiles;
+  }
+
+  fs.mkdirSync(dest, { recursive: true });
+
+  const items = fs.readdirSync(src);
+
+  for (const item of items) {
+    const srcPath = path.join(src, item);
+    const destPath = path.join(dest, item);
+    const stat = fs.statSync(srcPath);
+
+    if (stat.isDirectory()) {
+      copyRecursive(srcPath, destPath, installedFiles);
+    } else {
+      fs.copyFileSync(srcPath, destPath);
+      installedFiles.push(destPath);
+    }
+  }
+
+  return installedFiles;
+}
+
+function loadManifest() {
+  try {
+    if (fs.existsSync(MANIFEST_FILE)) {
+      return JSON.parse(fs.readFileSync(MANIFEST_FILE, 'utf8'));
+    }
+  } catch {}
+  return { files: [], version: null };
+}
+
+function saveManifest(files, version) {
+  const manifest = {
+    version,
+    installedAt: new Date().toISOString(),
+    files
+  };
+  fs.mkdirSync(CLAUDE_HOME, { recursive: true });
+  fs.writeFileSync(MANIFEST_FILE, JSON.stringify(manifest, null, 2));
+}
+
+function getVersion() {
+  try {
+    const versionFile = path.join(PACKAGE_ROOT, 'VERSION');
+    const content = fs.readFileSync(versionFile, 'utf8');
+    const match = content.match(/SYSTEM_VERSION=(.+)/);
+    return match ? match[1].trim() : 'unknown';
+  } catch {
+    const pkg = require('../package.json');
+    return pkg.version;
+  }
+}
+
+function createBackup() {
+  const backupDir = path.join(os.homedir(), '.claude-backup-' + Date.now());
+  const dirs = ['agents', 'rules', 'skills'];
+  let hasContent = false;
+
+  for (const dir of dirs) {
+    const srcDir = path.join(CLAUDE_HOME, dir);
+    if (fs.existsSync(srcDir) && fs.readdirSync(srcDir).length > 0) {
+      hasContent = true;
+      copyRecursive(srcDir, path.join(backupDir, dir));
+    }
+  }
+
+  return hasContent ? backupDir : null;
+}
+
+function countDirs(dir) {
+  if (!fs.existsSync(dir)) return 0;
+  return fs.readdirSync(dir).filter(f =>
+    fs.statSync(path.join(dir, f)).isDirectory()
+  ).length;
+}
+
+function main() {
+  // Skip if running in CI or if MYCONVERGIO_SKIP_POSTINSTALL is set
+  if (process.env.CI || process.env.MYCONVERGIO_SKIP_POSTINSTALL) {
+    console.log('Skipping postinstall (CI environment or MYCONVERGIO_SKIP_POSTINSTALL set)');
+    return;
+  }
+
+  log(colors.blue, '\n📦 MyConvergio Post-Install\n');
+
+  const srcAgents = path.join(PACKAGE_ROOT, '.claude', 'agents');
+  const srcRules = path.join(PACKAGE_ROOT, '.claude', 'rules');
+  const srcSkills = path.join(PACKAGE_ROOT, '.claude', 'skills');
+
+  // Check if source directories exist
+  if (!fs.existsSync(srcAgents)) {
+    log(colors.yellow, 'Warning: Source agents directory not found. Skipping installation.');
+    return;
+  }
+
+  // Check for existing installation and backup
+  const existingManifest = loadManifest();
+  if (existingManifest.version) {
+    log(colors.yellow, `Existing installation found (v${existingManifest.version})`);
+    log(colors.yellow, 'Creating backup before upgrade...\n');
+    const backupDir = createBackup();
+    if (backupDir) {
+      log(colors.green, `  ✓ Backup created: ${backupDir}\n`);
+    }
+  }
+
+  const installedFiles = [];
+
+  // Install agents
+  copyRecursive(srcAgents, path.join(CLAUDE_HOME, 'agents'), installedFiles);
+  log(colors.green, `  ✓ Installed agents`);
+
+  // Install rules
+  copyRecursive(srcRules, path.join(CLAUDE_HOME, 'rules'), installedFiles);
+  log(colors.green, `  ✓ Installed rules`);
+
+  // Install skills
+  copyRecursive(srcSkills, path.join(CLAUDE_HOME, 'skills'), installedFiles);
+  const skillsCount = countDirs(path.join(CLAUDE_HOME, 'skills'));
+  log(colors.green, `  ✓ Installed ${skillsCount} skills`);
+
+  // Save manifest for safe uninstall
+  const version = getVersion();
+  saveManifest(installedFiles, version);
+  log(colors.green, `  ✓ Saved manifest (${installedFiles.length} files)`);
+
+  console.log('');
+  log(colors.green, '✅ MyConvergio installed successfully!');
+  console.log('');
+  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');
+}
+
+main();

package/scripts/sync-from-convergiocli.sh

@@ -0,0 +1,169 @@
+#!/bin/bash
+
+# =============================================================================
+# MYCONVERGIO SYNC FROM CONVERGIOCLI
+# =============================================================================
+# Syncs agent definitions from the ConvergioCLI repository
+# Source: https://github.com/Roberdan/convergio-cli/tree/main/src/agents/definitions
+# =============================================================================
+
+set -euo pipefail
+
+# Colors
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+BLUE='\033[0;34m'
+YELLOW='\033[1;33m'
+NC='\033[0m'
+
+# Paths
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+ROOT_DIR="$(dirname "$SCRIPT_DIR")"
+TARGET_DIR="$ROOT_DIR/.claude/agents"
+TEMP_DIR="/tmp/convergiocli-sync-$$"
+
+# Source repository
+REPO_URL="https://github.com/Roberdan/convergio-cli.git"
+SOURCE_PATH="src/agents/definitions"
+
+# Parse arguments
+DRY_RUN=false
+VERBOSE=false
+
+while [[ $# -gt 0 ]]; do
+    case $1 in
+        --dry-run)
+            DRY_RUN=true
+            shift
+            ;;
+        --verbose|-v)
+            VERBOSE=true
+            shift
+            ;;
+        --help|-h)
+            echo "Usage: $0 [--dry-run] [--verbose]"
+            echo ""
+            echo "Options:"
+            echo "  --dry-run   Show what would be synced without making changes"
+            echo "  --verbose   Show detailed output"
+            exit 0
+            ;;
+        *)
+            echo -e "${RED}Unknown option: $1${NC}"
+            exit 1
+            ;;
+    esac
+done
+
+cleanup() {
+    rm -rf "$TEMP_DIR"
+}
+trap cleanup EXIT
+
+echo -e "${BLUE}MyConvergio Agent Sync${NC}"
+echo "Source: $REPO_URL"
+echo "Target: $TARGET_DIR"
+echo ""
+
+# Clone repository with sparse checkout
+echo -e "${BLUE}Fetching latest agents from ConvergioCLI...${NC}"
+mkdir -p "$TEMP_DIR"
+cd "$TEMP_DIR"
+
+git clone --depth 1 --filter=blob:none --sparse "$REPO_URL" repo 2>/dev/null
+cd repo
+git sparse-checkout set "$SOURCE_PATH" 2>/dev/null
+
+if [ ! -d "$SOURCE_PATH" ]; then
+    echo -e "${RED}Error: Could not find $SOURCE_PATH in repository${NC}"
+    exit 1
+fi
+
+# Count files
+SOURCE_COUNT=$(find "$SOURCE_PATH" -name '*.md' | wc -l | tr -d ' ')
+TARGET_COUNT=$(find "$TARGET_DIR" -name '*.md' ! -name 'CONSTITUTION.md' ! -name 'CommonValuesAndPrinciples.md' 2>/dev/null | wc -l | tr -d ' ')
+
+echo -e "${BLUE}Found $SOURCE_COUNT agents in ConvergioCLI${NC}"
+echo -e "${BLUE}Current $TARGET_COUNT agents in MyConvergio${NC}"
+echo ""
+
+if [ "$DRY_RUN" = true ]; then
+    echo -e "${YELLOW}DRY RUN - No changes will be made${NC}"
+    echo ""
+fi
+
+# Compare and sync
+NEW_COUNT=0
+UPDATED_COUNT=0
+UNCHANGED_COUNT=0
+
+for src_file in $(find "$SOURCE_PATH" -name '*.md'); do
+    filename=$(basename "$src_file")
+
+    # Skip non-agent files
+    if [[ "$filename" == "README.md" ]] || [[ "$filename" == "index.md" ]]; then
+        continue
+    fi
+
+    # Determine target category (from source path)
+    rel_path="${src_file#$SOURCE_PATH/}"
+    category=$(dirname "$rel_path")
+
+    if [ "$category" = "." ]; then
+        # Root level file, put in core_utility
+        category="core_utility"
+    fi
+
+    target_file="$TARGET_DIR/$category/$filename"
+
+    if [ ! -f "$target_file" ]; then
+        echo -e "${GREEN}NEW: $category/$filename${NC}"
+        NEW_COUNT=$((NEW_COUNT + 1))
+
+        if [ "$DRY_RUN" = false ]; then
+            mkdir -p "$TARGET_DIR/$category"
+            cp "$src_file" "$target_file"
+        fi
+    elif ! diff -q "$src_file" "$target_file" >/dev/null 2>&1; then
+        echo -e "${YELLOW}UPDATED: $category/$filename${NC}"
+        UPDATED_COUNT=$((UPDATED_COUNT + 1))
+
+        if [ "$DRY_RUN" = false ]; then
+            cp "$src_file" "$target_file"
+        fi
+
+        if [ "$VERBOSE" = true ]; then
+            echo "  Diff:"
+            diff "$target_file" "$src_file" | head -10 || true
+            echo ""
+        fi
+    else
+        UNCHANGED_COUNT=$((UNCHANGED_COUNT + 1))
+        if [ "$VERBOSE" = true ]; then
+            echo -e "  UNCHANGED: $category/$filename"
+        fi
+    fi
+done
+
+echo ""
+echo -e "${BLUE}Summary:${NC}"
+echo -e "  New agents:       ${GREEN}$NEW_COUNT${NC}"
+echo -e "  Updated agents:   ${YELLOW}$UPDATED_COUNT${NC}"
+echo -e "  Unchanged agents: $UNCHANGED_COUNT"
+
+if [ "$DRY_RUN" = true ]; then
+    echo ""
+    echo -e "${YELLOW}Run without --dry-run to apply changes${NC}"
+else
+    if [ $NEW_COUNT -gt 0 ] || [ $UPDATED_COUNT -gt 0 ]; then
+        echo ""
+        echo -e "${GREEN}✅ Sync complete${NC}"
+        echo ""
+        echo "Next steps:"
+        echo "  1. Review changes: git diff"
+        echo "  2. Commit: git add -A && git commit -m 'feat: sync agents from ConvergioCLI'"
+    else
+        echo ""
+        echo -e "${GREEN}✅ Already up to date${NC}"
+    fi
+fi