create-byan-agent 2.0.1 → 2.1.1

package/install/src/observability/metrics/metrics-collector.js

@@ -0,0 +1,325 @@
+/**
+ * Metrics Collector for BYAN v2.0
+ * Collects and manages system metrics (counters, gauges, timings)
+ * 
+ * @module observability/metrics/metrics-collector
+ * @version 2.0.0-HYPER-MVP
+ */
+
+/**
+ * Metrics Collector - Records and tracks system metrics
+ * 
+ * @class MetricsCollector
+ * @example
+ * const metrics = new MetricsCollector();
+ * metrics.increment('api.calls', { endpoint: '/chat' });
+ * metrics.recordDuration('request.duration', 150);
+ */
+class MetricsCollector {
+  constructor() {
+    this.metrics = new Map();
+  }
+
+  /**
+   * Record a metric with a specific value
+   * 
+   * @param {string} name - Metric name
+   * @param {number} value - Metric value
+   * @param {Object} [tags={}] - Optional tags for filtering
+   * @returns {void}
+   * 
+   * @example
+   * metrics.recordMetric('memory.usage', 1024, { unit: 'MB', service: 'api' });
+   */
+  recordMetric(name, value, tags = {}) {
+    if (!name || typeof name !== 'string') {
+      throw new Error('Metric name must be a non-empty string');
+    }
+
+    if (typeof value !== 'number') {
+      throw new Error('Metric value must be a number');
+    }
+
+    if (isNaN(value)) {
+      throw new Error('Metric value cannot be NaN');
+    }
+
+    const key = this._generateKey(name, tags);
+    
+    this.metrics.set(key, {
+      name,
+      value,
+      tags: { ...tags },
+      timestamp: new Date().toISOString(),
+      type: 'gauge',
+    });
+  }
+
+  /**
+   * Increment a counter metric
+   * 
+   * @param {string} name - Metric name
+   * @param {Object} [tags={}] - Optional tags
+   * @param {number} [delta=1] - Increment amount
+   * @returns {void}
+   * 
+   * @example
+   * metrics.increment('api.calls', { endpoint: '/chat' });
+   * metrics.increment('cache.hits', {}, 5); // Increment by 5
+   */
+  increment(name, tags = {}, delta = 1) {
+    if (!name || typeof name !== 'string') {
+      throw new Error('Metric name must be a non-empty string');
+    }
+
+    if (typeof delta !== 'number') {
+      throw new Error('Delta must be a number');
+    }
+
+    const key = this._generateKey(name, tags);
+    const existing = this.metrics.get(key);
+
+    if (existing) {
+      this.metrics.set(key, {
+        ...existing,
+        value: existing.value + delta,
+        timestamp: new Date().toISOString(),
+      });
+    } else {
+      this.metrics.set(key, {
+        name,
+        value: delta,
+        tags: { ...tags },
+        timestamp: new Date().toISOString(),
+        type: 'counter',
+      });
+    }
+  }
+
+  /**
+   * Decrement a counter metric
+   * 
+   * @param {string} name - Metric name
+   * @param {Object} [tags={}] - Optional tags
+   * @param {number} [delta=1] - Decrement amount
+   * @returns {void}
+   * 
+   * @example
+   * metrics.decrement('active.connections', { server: 'main' });
+   */
+  decrement(name, tags = {}, delta = 1) {
+    this.increment(name, tags, -delta);
+  }
+
+  /**
+   * Record a duration/timing metric
+   * 
+   * @param {string} name - Metric name
+   * @param {number} durationMs - Duration in milliseconds
+   * @param {Object} [tags={}] - Optional tags
+   * @returns {void}
+   * 
+   * @example
+   * metrics.recordDuration('request.duration', 150, { status: '200' });
+   */
+  recordDuration(name, durationMs, tags = {}) {
+    if (!name || typeof name !== 'string') {
+      throw new Error('Metric name must be a non-empty string');
+    }
+
+    if (typeof durationMs !== 'number') {
+      throw new Error('Duration must be a number');
+    }
+
+    if (durationMs < 0) {
+      throw new Error('Duration cannot be negative');
+    }
+
+    const key = this._generateKey(name, tags);
+    
+    this.metrics.set(key, {
+      name,
+      value: durationMs,
+      tags: { ...tags },
+      timestamp: new Date().toISOString(),
+      type: 'timing',
+    });
+  }
+
+  /**
+   * Generate unique key for metric with tags
+   * 
+   * @private
+   * @param {string} name - Metric name
+   * @param {Object} tags - Tags
+   * @returns {string} Unique key
+   */
+  _generateKey(name, tags) {
+    if (Object.keys(tags).length === 0) {
+      return name;
+    }
+
+    const sortedTags = Object.keys(tags)
+      .sort()
+      .map((key) => `${key}:${tags[key]}`)
+      .join(',');
+
+    return `${name}[${sortedTags}]`;
+  }
+
+  /**
+   * Get all metrics
+   * 
+   * @returns {Object} All metrics as key-value pairs
+   * 
+   * @example
+   * const allMetrics = metrics.getMetrics();
+   * Object.entries(allMetrics).forEach(([key, metric]) => {
+   *   console.log(`${key}: ${metric.value}`);
+   * });
+   */
+  getMetrics() {
+    const result = {};
+    
+    for (const [key, value] of this.metrics.entries()) {
+      result[key] = { ...value };
+    }
+
+    return result;
+  }
+
+  /**
+   * Get a specific metric
+   * 
+   * @param {string} name - Metric name
+   * @param {Object} [tags={}] - Optional tags
+   * @returns {Object|null} Metric or null if not found
+   * 
+   * @example
+   * const apiCalls = metrics.getMetric('api.calls', { endpoint: '/chat' });
+   * console.log(`API calls: ${apiCalls.value}`);
+   */
+  getMetric(name, tags = {}) {
+    const key = this._generateKey(name, tags);
+    const metric = this.metrics.get(key);
+    
+    return metric ? { ...metric } : null;
+  }
+
+  /**
+   * Get metrics filtered by name prefix
+   * 
+   * @param {string} prefix - Name prefix
+   * @returns {Object} Filtered metrics
+   * 
+   * @example
+   * const apiMetrics = metrics.getMetricsByPrefix('api.');
+   * // Returns all metrics starting with 'api.'
+   */
+  getMetricsByPrefix(prefix) {
+    const result = {};
+
+    for (const [key, value] of this.metrics.entries()) {
+      if (value.name.startsWith(prefix)) {
+        result[key] = { ...value };
+      }
+    }
+
+    return result;
+  }
+
+  /**
+   * Get metrics filtered by type
+   * 
+   * @param {string} type - Metric type (gauge, counter, timing)
+   * @returns {Object} Filtered metrics
+   * 
+   * @example
+   * const counters = metrics.getMetricsByType('counter');
+   */
+  getMetricsByType(type) {
+    const result = {};
+
+    for (const [key, value] of this.metrics.entries()) {
+      if (value.type === type) {
+        result[key] = { ...value };
+      }
+    }
+
+    return result;
+  }
+
+  /**
+   * Clear all metrics
+   * 
+   * @returns {void}
+   * 
+   * @example
+   * metrics.clear(); // Remove all metrics
+   */
+  clear() {
+    this.metrics.clear();
+  }
+
+  /**
+   * Get metrics count
+   * 
+   * @returns {number} Number of metrics
+   */
+  count() {
+    return this.metrics.size;
+  }
+
+  /**
+   * Reset a specific metric to zero
+   * 
+   * @param {string} name - Metric name
+   * @param {Object} [tags={}] - Optional tags
+   * @returns {boolean} True if metric was reset, false if not found
+   * 
+   * @example
+   * metrics.resetMetric('api.calls', { endpoint: '/chat' });
+   */
+  resetMetric(name, tags = {}) {
+    const key = this._generateKey(name, tags);
+    const existing = this.metrics.get(key);
+
+    if (existing) {
+      this.metrics.set(key, {
+        ...existing,
+        value: 0,
+        timestamp: new Date().toISOString(),
+      });
+      return true;
+    }
+
+    return false;
+  }
+
+  /**
+   * Get summary statistics
+   * 
+   * @returns {Object} Summary stats
+   * 
+   * @example
+   * const stats = metrics.getStats();
+   * // { total: 10, byType: { counter: 5, gauge: 3, timing: 2 } }
+   */
+  getStats() {
+    const byType = {};
+    
+    for (const metric of this.metrics.values()) {
+      if (!byType[metric.type]) {
+        byType[metric.type] = 0;
+      }
+      byType[metric.type]++;
+    }
+
+    return {
+      total: this.metrics.size,
+      byType,
+    };
+  }
+}
+
+module.exports = { MetricsCollector };

package/install/switch-to-v2.sh

@@ -0,0 +1,126 @@
+#!/bin/bash
+# Switch BYAN Installer to v2.0
+# This script updates package.json to use the new v2.0 installer
+
+set -e
+
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m'
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+echo -e "${BLUE}╔════════════════════════════════════════════════════════════╗${NC}"
+echo -e "${BLUE}║  Switch to BYAN v2.0 Installer                            ║${NC}"
+echo -e "${BLUE}╚════════════════════════════════════════════════════════════╝${NC}"
+echo ""
+
+cd "${SCRIPT_DIR}"
+
+# Check if package.json exists
+if [ ! -f "package.json" ]; then
+    echo -e "${RED}✗ package.json not found in ${SCRIPT_DIR}${NC}"
+    exit 1
+fi
+
+# Backup original
+echo -e "${YELLOW}[1/4] Creating backup...${NC}"
+cp package.json package.json.backup
+echo -e "${GREEN}✓ Backup created: package.json.backup${NC}"
+
+# Show current version
+echo ""
+echo -e "${YELLOW}[2/4] Current configuration:${NC}"
+CURRENT_VERSION=$(grep '"version"' package.json | head -1 | cut -d'"' -f4)
+CURRENT_BIN=$(grep '"create-byan-agent"' package.json | head -1 | cut -d'"' -f4)
+echo "  Version: ${CURRENT_VERSION}"
+echo "  Binary:  ${CURRENT_BIN}"
+
+# Update package.json
+echo ""
+echo -e "${YELLOW}[3/4] Updating to v2.0...${NC}"
+
+# Use Node.js to safely update JSON
+node -e "
+const fs = require('fs');
+const pkg = JSON.parse(fs.readFileSync('package.json', 'utf8'));
+
+// Update version
+pkg.version = '2.0.0-alpha.1';
+
+// Update description
+pkg.description = 'NPX installer for BYAN v2.0 - Agent creators with v2.0 runtime support';
+
+// Update bin
+pkg.bin['create-byan-agent'] = 'bin/create-byan-agent-v2.js';
+
+// Write back
+fs.writeFileSync('package.json', JSON.stringify(pkg, null, 2) + '\n', 'utf8');
+console.log('✓ package.json updated');
+"
+
+if [ $? -eq 0 ]; then
+    echo -e "${GREEN}✓ package.json updated successfully${NC}"
+else
+    echo -e "${RED}✗ Failed to update package.json${NC}"
+    echo -e "${YELLOW}Restoring backup...${NC}"
+    mv package.json.backup package.json
+    exit 1
+fi
+
+# Verify changes
+echo ""
+echo -e "${YELLOW}[4/4] Verifying changes...${NC}"
+NEW_VERSION=$(grep '"version"' package.json | head -1 | cut -d'"' -f4)
+NEW_BIN=$(grep '"create-byan-agent"' package.json | head -1 | cut -d'"' -f4)
+echo "  New Version: ${NEW_VERSION}"
+echo "  New Binary:  ${NEW_BIN}"
+
+# Check if v2 installer exists
+if [ -f "bin/create-byan-agent-v2.js" ]; then
+    echo -e "${GREEN}✓ v2.0 installer found${NC}"
+else
+    echo -e "${RED}✗ v2.0 installer not found: bin/create-byan-agent-v2.js${NC}"
+    exit 1
+fi
+
+# Set executable permissions
+chmod +x bin/create-byan-agent-v2.js
+echo -e "${GREEN}✓ Executable permissions set${NC}"
+
+# Summary
+echo ""
+echo -e "${GREEN}╔════════════════════════════════════════════════════════════╗${NC}"
+echo -e "${GREEN}║  ✅ Successfully switched to v2.0 installer                 ║${NC}"
+echo -e "${GREEN}╚════════════════════════════════════════════════════════════╝${NC}"
+echo ""
+
+echo -e "${BLUE}Changes made:${NC}"
+echo "  • Version: ${CURRENT_VERSION} → ${NEW_VERSION}"
+echo "  • Binary:  ${CURRENT_BIN} → ${NEW_BIN}"
+echo "  • Backup:  package.json.backup (preserved)"
+echo ""
+
+echo -e "${YELLOW}Next steps:${NC}"
+echo "  1. Test the installer locally:"
+echo "     ${BLUE}cd /tmp && mkdir test-project && cd test-project && git init${NC}"
+echo "     ${BLUE}node ${SCRIPT_DIR}/bin/create-byan-agent-v2.js${NC}"
+echo ""
+echo "  2. Commit the changes:"
+echo "     ${BLUE}git add package.json${NC}"
+echo "     ${BLUE}git commit -m 'feat: upgrade to BYAN v2.0 installer'${NC}"
+echo ""
+echo "  3. Publish to npm (alpha):"
+echo "     ${BLUE}npm publish --tag alpha${NC}"
+echo ""
+echo "  4. Test installation:"
+echo "     ${BLUE}npx create-byan-agent@alpha${NC}"
+echo ""
+
+echo -e "${YELLOW}To rollback:${NC}"
+echo "  ${BLUE}cp package.json.backup package.json${NC}"
+echo ""
+
+echo -e "${GREEN}Ready to deploy! 🚀${NC}"

package/install/test-chalk-fix.sh

@@ -0,0 +1,210 @@
+#!/bin/bash
+# Test script for create-byan-agent
+# Tests the fixed Chalk compatibility
+
+set -e  # Exit on error
+
+echo "🧪 Testing create-byan-agent installer..."
+echo ""
+
+# Colors
+GREEN='\033[0;32m'
+RED='\033[0;31m'
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+
+# Test directory
+TEST_DIR="/tmp/byan-test-$(date +%s)"
+INSTALL_DIR="/home/yan/conception/install"
+
+# Clean up function
+cleanup() {
+    echo ""
+    echo "🧹 Cleaning up..."
+    rm -rf "$TEST_DIR"
+}
+
+trap cleanup EXIT
+
+# Create test directory
+echo "📁 Creating test directory: $TEST_DIR"
+mkdir -p "$TEST_DIR"
+cd "$TEST_DIR"
+
+# Test 1: Check dependencies
+echo ""
+echo "📦 Test 1: Checking package.json dependencies..."
+cd "$INSTALL_DIR"
+
+CHALK_VERSION=$(node -p "require('./package.json').dependencies.chalk")
+INQUIRER_VERSION=$(node -p "require('./package.json').dependencies.inquirer")
+ORA_VERSION=$(node -p "require('./package.json').dependencies.ora")
+
+echo "  • chalk: $CHALK_VERSION"
+echo "  • inquirer: $INQUIRER_VERSION"
+echo "  • ora: $ORA_VERSION"
+
+if [[ "$CHALK_VERSION" == "^4.1.2" ]]; then
+    echo -e "${GREEN}✅ Chalk version correct (CommonJS compatible)${NC}"
+else
+    echo -e "${RED}❌ Chalk version incorrect: $CHALK_VERSION${NC}"
+    exit 1
+fi
+
+if [[ "$INQUIRER_VERSION" == "^8.2.5" ]]; then
+    echo -e "${GREEN}✅ Inquirer version correct (CommonJS compatible)${NC}"
+else
+    echo -e "${RED}❌ Inquirer version incorrect: $INQUIRER_VERSION${NC}"
+    exit 1
+fi
+
+if [[ "$ORA_VERSION" == "^5.4.1" ]]; then
+    echo -e "${GREEN}✅ Ora version correct (CommonJS compatible)${NC}"
+else
+    echo -e "${RED}❌ Ora version incorrect: $ORA_VERSION${NC}"
+    exit 1
+fi
+
+# Test 2: Check node_modules
+echo ""
+echo "📚 Test 2: Checking installed packages..."
+
+if [ -d "$INSTALL_DIR/node_modules/chalk" ]; then
+    INSTALLED_CHALK=$(node -p "require('$INSTALL_DIR/node_modules/chalk/package.json').version")
+    echo "  • Installed chalk: v$INSTALLED_CHALK"
+    
+    if [[ "$INSTALLED_CHALK" =~ ^4\. ]]; then
+        echo -e "${GREEN}✅ Chalk v4.x installed${NC}"
+    else
+        echo -e "${RED}❌ Wrong chalk version installed: v$INSTALLED_CHALK${NC}"
+        exit 1
+    fi
+else
+    echo -e "${RED}❌ Chalk not installed${NC}"
+    exit 1
+fi
+
+# Test 3: Version flag
+echo ""
+echo "🏷️  Test 3: Testing --version flag..."
+VERSION_OUTPUT=$(node "$INSTALL_DIR/bin/create-byan-agent.js" --version 2>&1)
+echo "  Output: $VERSION_OUTPUT"
+
+if [[ "$VERSION_OUTPUT" == "1.0.0" ]]; then
+    echo -e "${GREEN}✅ Version command works${NC}"
+else
+    echo -e "${RED}❌ Version command failed${NC}"
+    exit 1
+fi
+
+# Test 4: Help flag
+echo ""
+echo "❓ Test 4: Testing --help flag..."
+HELP_OUTPUT=$(node "$INSTALL_DIR/bin/create-byan-agent.js" --help 2>&1)
+
+if echo "$HELP_OUTPUT" | grep -q "Install BYAN"; then
+    echo -e "${GREEN}✅ Help command works${NC}"
+else
+    echo -e "${RED}❌ Help command failed${NC}"
+    echo "$HELP_OUTPUT"
+    exit 1
+fi
+
+# Test 5: Chalk import works
+echo ""
+echo "🎨 Test 5: Testing Chalk import in script..."
+TEST_CHALK_SCRIPT="$TEST_DIR/test-chalk.js"
+
+cat > "$TEST_CHALK_SCRIPT" << 'EOF'
+const chalk = require('chalk');
+
+// Test that chalk methods exist and are functions
+const tests = [
+    { name: 'chalk.blue', fn: chalk.blue },
+    { name: 'chalk.green', fn: chalk.green },
+    { name: 'chalk.red', fn: chalk.red },
+    { name: 'chalk.yellow', fn: chalk.yellow },
+    { name: 'chalk.gray', fn: chalk.gray },
+    { name: 'chalk.bold', fn: chalk.bold }
+];
+
+let allPass = true;
+
+tests.forEach(test => {
+    if (typeof test.fn !== 'function') {
+        console.error(`❌ ${test.name} is not a function`);
+        allPass = false;
+    }
+});
+
+if (allPass) {
+    console.log('✅ All chalk methods are functions');
+    console.log(chalk.blue('✅ Chalk.blue works!'));
+    console.log(chalk.green('✅ Chalk.green works!'));
+    console.log(chalk.bold('✅ Chalk.bold works!'));
+} else {
+    process.exit(1);
+}
+EOF
+
+cd "$TEST_DIR"
+npm init -y > /dev/null 2>&1
+npm install chalk@4.1.2 > /dev/null 2>&1
+
+CHALK_TEST_OUTPUT=$(node "$TEST_CHALK_SCRIPT" 2>&1)
+echo "$CHALK_TEST_OUTPUT"
+
+if echo "$CHALK_TEST_OUTPUT" | grep -q "All chalk methods are functions"; then
+    echo -e "${GREEN}✅ Chalk import and methods work correctly${NC}"
+else
+    echo -e "${RED}❌ Chalk import failed${NC}"
+    exit 1
+fi
+
+# Test 6: Simulate banner rendering
+echo ""
+echo "🎨 Test 6: Testing banner rendering..."
+BANNER_TEST="$TEST_DIR/test-banner.js"
+
+cat > "$BANNER_TEST" << 'EOF'
+const chalk = require('chalk');
+
+const banner = `
+${chalk.blue('╔════════════════════════════════════════════════════════════╗')}
+${chalk.blue('║')}                                                            ${chalk.blue('║')}
+${chalk.blue('║')}   ${chalk.bold('🏗️  BYAN INSTALLER v1.0.0')}                        ${chalk.blue('║')}
+${chalk.blue('║')}   ${chalk.gray('Builder of YAN - Agent Creator')}                          ${chalk.blue('║')}
+${chalk.blue('║')}                                                            ${chalk.blue('║')}
+${chalk.blue('╚════════════════════════════════════════════════════════════╝')}
+`;
+
+console.log(banner);
+console.log('✅ Banner rendered successfully');
+EOF
+
+BANNER_OUTPUT=$(node "$BANNER_TEST" 2>&1)
+
+if echo "$BANNER_OUTPUT" | grep -q "Banner rendered successfully"; then
+    echo -e "${GREEN}✅ Banner renders without errors${NC}"
+else
+    echo -e "${RED}❌ Banner rendering failed${NC}"
+    echo "$BANNER_OUTPUT"
+    exit 1
+fi
+
+# Final summary
+echo ""
+echo "═══════════════════════════════════════════════════════════"
+echo -e "${GREEN}🎉 ALL TESTS PASSED!${NC}"
+echo "═══════════════════════════════════════════════════════════"
+echo ""
+echo "Summary:"
+echo "  ✅ Package.json dependencies correct"
+echo "  ✅ CommonJS-compatible versions installed"
+echo "  ✅ --version flag works"
+echo "  ✅ --help flag works"
+echo "  ✅ Chalk import works correctly"
+echo "  ✅ Banner renders without errors"
+echo ""
+echo -e "${BLUE}🏗️  create-byan-agent is ready for use!${NC}"
+echo ""