@sun-asterisk/sunlint 1.0.7 → 1.1.4

package/scripts/build-release.sh

@@ -0,0 +1,117 @@
+#!/bin/bash
+
+# SunLint Release Packaging Script v1.0.4
+# Following Rule C005: Single responsibility - handle release packaging only
+
+set -e
+
+echo "🚀 Building SunLint v1.0.4 Release Package..."
+
+# Clean previous builds
+echo "🧹 Cleaning previous builds..."
+rm -rf *.tgz
+rm -rf coverage/
+rm -rf reports/
+rm -rf *.log
+
+# Verify package.json version
+echo "📋 Verifying package version..."
+PACKAGE_VERSION=$(node -p "require('./package.json').version")
+if [ "$PACKAGE_VERSION" != "1.0.4" ]; then
+    echo "❌ Package version mismatch. Expected 1.0.4, got $PACKAGE_VERSION"
+    exit 1
+fi
+
+# Run tests before packaging (skip if not available)
+echo "🧪 Running tests..."
+if [ -f "test/unit/test-runner.js" ]; then
+    npm test || {
+        echo "❌ Tests failed. Aborting release."
+        exit 1
+    }
+else
+    echo "⚠️  Test files not found, skipping tests..."
+fi
+
+# Lint the codebase
+echo "🔍 Running self-lint check..."
+node cli.js --quality --typescript --input=core/ || {
+    echo "❌ Self-lint check failed. Fix issues before release."
+    exit 1
+}
+
+# Security self-check
+echo "🔒 Running security self-check..."
+node cli.js --security --typescript --input=core/ || {
+    echo "⚠️  Security issues detected, but continuing with release..."
+}
+
+# Verify critical files exist
+echo "📁 Verifying critical files..."
+CRITICAL_FILES=(
+    "cli.js"
+    "package.json"
+    "README.md"
+    "CHANGELOG.md"
+    "config/rules/rules-registry.json"
+    "core/cli-program.js"
+    "core/cli-action-handler.js"
+    "core/typescript-engine.js"
+    "core/analysis-orchestrator.js"
+    "core/rule-selection-service.js"
+    "core/rule-mapping-service.js"
+    "integrations/eslint/configs/.eslintrc.js"
+    "integrations/eslint/plugin/index.js"
+    "integrations/eslint/plugin/package.json"
+)
+
+for file in "${CRITICAL_FILES[@]}"; do
+    if [ ! -f "$file" ]; then
+        echo "❌ Critical file missing: $file"
+        exit 1
+    fi
+done
+
+# Verify security rules are present
+echo "🔒 Verifying security rules..."
+SECURITY_RULE_COUNT=$(ls integrations/eslint/plugin/rules/security/s*.js 2>/dev/null | wc -l)
+if [ "$SECURITY_RULE_COUNT" -lt 40 ]; then
+    echo "❌ Expected 40+ security rules, found $SECURITY_RULE_COUNT"
+    exit 1
+fi
+
+# Create npm package
+echo "📦 Creating npm package..."
+npm pack
+
+# Verify package was created
+PACKAGE_FILE="sun-sunlint-1.0.4.tgz"
+if [ ! -f "$PACKAGE_FILE" ]; then
+    echo "❌ Package file not created: $PACKAGE_FILE"
+    exit 1
+fi
+
+# Get package size
+PACKAGE_SIZE=$(du -h "$PACKAGE_FILE" | cut -f1)
+
+echo "✅ Release package created successfully!"
+echo ""
+echo "📦 Package Details:"
+echo "   📄 File: $PACKAGE_FILE"
+echo "   📊 Size: $PACKAGE_SIZE"
+echo "   🔢 Version: 1.0.4"
+echo "   📅 Date: $(date)"
+echo ""
+echo "🎯 Release Features:"
+echo "   ✅ 40 Security Rules (S005-S058)"
+echo "   ✅ 4 Quality Rules (C006, C019, C029, C031)"
+echo "   ✅ Category-based filtering (--security, --quality)"
+echo "   ✅ Dynamic rule configuration"
+echo "   ✅ Enhanced ESLint integration"
+echo ""
+echo "🚀 Installation Commands:"
+echo "   Global: npm install -g ./$PACKAGE_FILE"
+echo "   Local:  npm install ./$PACKAGE_FILE"
+echo "   Direct: npm install -g https://github.com/sun-asterisk/engineer-excellence/releases/download/sunlint-v1.0.4/$PACKAGE_FILE"
+echo ""
+echo "🎉 Ready for release!"

package/scripts/ci-report.js

@@ -0,0 +1,179 @@
+#!/usr/bin/env node
+
+/**
+ * CI Report Generator - Creates CI/CD optimized reports
+ * Usage: node ci-report.js eslint-results.json sunlint-results.json
+ */
+
+const fs = require('fs');
+const path = require('path');
+const chalk = require('chalk');
+
+class CIReporter {
+  constructor() {
+    this.isCI = process.env.CI === 'true' || process.env.GITHUB_ACTIONS === 'true';
+    this.isGitHub = process.env.GITHUB_ACTIONS === 'true';
+    this.isGitLab = process.env.GITLAB_CI === 'true';
+  }
+
+  async generateCIReport(eslintPath, sunlintPath) {
+    const ReportMerger = require('./merge-reports.js');
+    const merger = new ReportMerger();
+    
+    const unifiedReport = await merger.mergeReports(eslintPath, sunlintPath);
+    
+    if (this.isGitHub) {
+      this.generateGitHubReport(unifiedReport);
+    } else if (this.isGitLab) {
+      this.generateGitLabReport(unifiedReport);
+    } else {
+      this.generateGenericReport(unifiedReport);
+    }
+    
+    return this.determineExitCode(unifiedReport);
+  }
+
+  generateGitHubReport(report) {
+    console.log('::group::📊 Code Quality Summary');
+    console.log(this.formatSummaryForCI(report));
+    console.log('::endgroup::');
+
+    // Create annotations for errors
+    const errors = report.violations.filter(v => v.severity === 'error').slice(0, 10);
+    errors.forEach(violation => {
+      console.log(`::error file=${violation.file},line=${violation.line},col=${violation.column},title=${violation.ruleId}::${violation.message}`);
+    });
+
+    // Create warnings
+    const warnings = report.violations.filter(v => v.severity === 'warning').slice(0, 10);
+    warnings.forEach(violation => {
+      console.log(`::warning file=${violation.file},line=${violation.line},col=${violation.column},title=${violation.ruleId}::${violation.message}`);
+    });
+
+    // Set output variables
+    console.log(`::set-output name=total-violations::${report.summary.total.violations}`);
+    console.log(`::set-output name=errors::${report.summary.total.errors}`);
+    console.log(`::set-output name=warnings::${report.summary.total.warnings}`);
+  }
+
+  generateGitLabReport(report) {
+    console.log(chalk.blue('📊 GitLab CI Code Quality Report'));
+    console.log(this.formatSummaryForCI(report));
+
+    // GitLab Code Quality format
+    const gitlabReport = this.convertToGitLabFormat(report);
+    fs.writeFileSync('gl-code-quality-report.json', JSON.stringify(gitlabReport, null, 2));
+    
+    console.log('✅ GitLab Code Quality report: gl-code-quality-report.json');
+  }
+
+  generateGenericReport(report) {
+    console.log(chalk.blue('📊 CI Code Quality Report'));
+    console.log(this.formatSummaryForCI(report));
+
+    // Save JSON for further processing
+    fs.writeFileSync('ci-report.json', JSON.stringify(report, null, 2));
+  }
+
+  formatSummaryForCI(report) {
+    const { summary } = report;
+    
+    return `
+Files analyzed: ${summary.total.files}
+Total violations: ${summary.total.violations}
+├─ Errors: ${summary.total.errors}
+├─ Warnings: ${summary.total.warnings}
+└─ Info: ${summary.total.info}
+
+Tool breakdown:
+├─ ESLint: ${summary.by_tool.eslint.violations} violations
+└─ SunLint: ${summary.by_tool.sunlint.violations} violations
+
+Quality Score: ${this.calculateQualityScore(report)}%
+`;
+  }
+
+  calculateQualityScore(report) {
+    const { total } = report.summary;
+    const totalFiles = total.files;
+    const violations = total.violations;
+    
+    if (totalFiles === 0) return 100;
+    
+    // Quality score formula: base 100, deduct points for violations
+    // Errors: -5 points, Warnings: -2 points, Info: -1 point
+    const penalty = (total.errors * 5) + (total.warnings * 2) + (total.info * 1);
+    const maxPenalty = totalFiles * 10; // Max 10 points per file
+    
+    const score = Math.max(0, 100 - Math.round((penalty / maxPenalty) * 100));
+    return score;
+  }
+
+  convertToGitLabFormat(report) {
+    return report.violations.map(violation => ({
+      description: violation.message,
+      check_name: violation.ruleId,
+      fingerprint: this.generateFingerprint(violation),
+      severity: this.mapSeverityForGitLab(violation.severity),
+      location: {
+        path: violation.file,
+        lines: {
+          begin: violation.line
+        }
+      }
+    }));
+  }
+
+  generateFingerprint(violation) {
+    const crypto = require('crypto');
+    const content = `${violation.file}:${violation.line}:${violation.ruleId}`;
+    return crypto.createHash('md5').update(content).digest('hex');
+  }
+
+  mapSeverityForGitLab(severity) {
+    switch (severity) {
+      case 'error': return 'major';
+      case 'warning': return 'minor';
+      case 'info': return 'info';
+      default: return 'info';
+    }
+  }
+
+  determineExitCode(report) {
+    const { total } = report.summary;
+    
+    // Exit with error if there are any errors
+    if (total.errors > 0) {
+      console.log(chalk.red(`❌ Quality gate failed: ${total.errors} errors found`));
+      return 1;
+    }
+    
+    // Warning if too many warnings
+    if (total.warnings > 50) {
+      console.log(chalk.yellow(`⚠️  Quality gate warning: ${total.warnings} warnings found`));
+    }
+    
+    console.log(chalk.green('✅ Quality gate passed'));
+    return 0;
+  }
+}
+
+// CLI execution
+if (require.main === module) {
+  const [eslintReport, sunlintReport] = process.argv.slice(2);
+  
+  if (!eslintReport || !sunlintReport) {
+    console.error('Usage: node ci-report.js <eslint-report.json> <sunlint-report.json>');
+    process.exit(1);
+  }
+
+  const reporter = new CIReporter();
+  reporter.generateCIReport(eslintReport, sunlintReport)
+    .then(exitCode => process.exit(exitCode))
+    .catch(error => {
+      console.error(chalk.red('❌ CI report generation failed:'), error.message);
+      process.exit(1);
+    });
+}
+
+module.exports = CIReporter;

package/scripts/install.sh

@@ -0,0 +1,196 @@
+#!/bin/bash
+
+# SunLint CLI Installer Script
+# Install SunLint from GitHub release
+
+set -e
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+
+# Configuration
+REPO_URL="https://github.com/sun-asterisk/engineer-excellence"
+LATEST_RELEASE_URL="https://api.github.com/repos/sun-asterisk/engineer-excellence/releases/latest"
+PACKAGE_NAME="@sun/sunlint"
+
+echo -e "${BLUE}☀️  SunLint CLI Installer${NC}"
+echo -e "${BLUE}=================================${NC}"
+
+# Check if Node.js and npm are installed
+check_prerequisites() {
+    echo -e "${YELLOW}Checking prerequisites...${NC}"
+    
+    if ! command -v node &> /dev/null; then
+        echo -e "${RED}❌ Node.js is required but not installed.${NC}"
+        echo -e "${YELLOW}Please install Node.js from: https://nodejs.org/${NC}"
+        exit 1
+    fi
+    
+    if ! command -v npm &> /dev/null; then
+        echo -e "${RED}❌ npm is required but not installed.${NC}"
+        exit 1
+    fi
+    
+    echo -e "${GREEN}✅ Node.js $(node --version) and npm $(npm --version) found${NC}"
+}
+
+# Get latest release version
+get_latest_version() {
+    echo -e "${YELLOW}Fetching latest release...${NC}"
+    
+    if command -v curl &> /dev/null; then
+        LATEST_TAG=$(curl -s "$LATEST_RELEASE_URL" | grep '"tag_name":' | grep 'sunlint-v' | cut -d '"' -f 4 | head -1)
+    elif command -v wget &> /dev/null; then
+        LATEST_TAG=$(wget -qO- "$LATEST_RELEASE_URL" | grep '"tag_name":' | grep 'sunlint-v' | cut -d '"' -f 4 | head -1)
+    else
+        echo -e "${RED}❌ Neither curl nor wget found. Cannot fetch latest release.${NC}"
+        echo -e "${YELLOW}Please install curl or wget, or use manual installation.${NC}"
+        exit 1
+    fi
+    
+    if [ -z "$LATEST_TAG" ]; then
+        echo -e "${RED}❌ Could not find latest SunLint release.${NC}"
+        echo -e "${YELLOW}Using default version: sunlint-v1.0.0${NC}"
+        LATEST_TAG="sunlint-v1.0.0"
+    fi
+    
+    # Extract version number (remove 'sunlint-v' prefix)
+    VERSION=${LATEST_TAG#sunlint-v}
+    echo -e "${GREEN}✅ Latest version: ${VERSION}${NC}"
+}
+
+# Uninstall existing version
+uninstall_existing() {
+    if npm list -g "$PACKAGE_NAME" &> /dev/null; then
+        echo -e "${YELLOW}Removing existing SunLint installation...${NC}"
+        npm uninstall -g "$PACKAGE_NAME" || true
+    fi
+}
+
+# Install SunLint
+install_sunlint() {
+    echo -e "${YELLOW}Installing SunLint CLI v${VERSION}...${NC}"
+    
+    DOWNLOAD_URL="${REPO_URL}/releases/download/${LATEST_TAG}/sun-sunlint-${VERSION}.tgz"
+    
+    echo -e "${BLUE}Download URL: ${DOWNLOAD_URL}${NC}"
+    
+    # Install from GitHub release
+    if npm install -g "$DOWNLOAD_URL"; then
+        echo -e "${GREEN}✅ SunLint CLI v${VERSION} installed successfully!${NC}"
+    else
+        echo -e "${RED}❌ Installation failed.${NC}"
+        echo -e "${YELLOW}Trying alternative installation method...${NC}"
+        
+        # Fallback: Clone and install
+        TEMP_DIR=$(mktemp -d)
+        cd "$TEMP_DIR"
+        
+        echo -e "${YELLOW}Cloning repository...${NC}"
+        if git clone "$REPO_URL.git"; then
+            cd engineer-excellence/coding-quality/extensions/sunlint
+            echo -e "${YELLOW}Installing from source...${NC}"
+            if npm install -g .; then
+                echo -e "${GREEN}✅ SunLint CLI installed from source!${NC}"
+            else
+                echo -e "${RED}❌ Source installation also failed.${NC}"
+                exit 1
+            fi
+        else
+            echo -e "${RED}❌ Could not clone repository.${NC}"
+            exit 1
+        fi
+        
+        # Cleanup
+        cd /
+        rm -rf "$TEMP_DIR"
+    fi
+}
+
+# Verify installation
+verify_installation() {
+    echo -e "${YELLOW}Verifying installation...${NC}"
+    
+    if command -v sunlint &> /dev/null; then
+        INSTALLED_VERSION=$(sunlint --version)
+        echo -e "${GREEN}✅ SunLint CLI is working!${NC}"
+        echo -e "${GREEN}   Version: ${INSTALLED_VERSION}${NC}"
+        echo -e "${GREEN}   Location: $(which sunlint)${NC}"
+        
+        echo -e "${BLUE}🚀 Quick Test:${NC}"
+        echo -e "${YELLOW}sunlint --help${NC}"
+        return 0
+    else
+        echo -e "${RED}❌ SunLint command not found after installation.${NC}"
+        echo -e "${YELLOW}Try restarting your terminal or check your PATH.${NC}"
+        return 1
+    fi
+}
+
+# Usage examples
+show_usage() {
+    echo -e "${BLUE}📋 Usage Examples:${NC}"
+    echo -e "${YELLOW}# Check code quality${NC}"
+    echo -e "sunlint --quality --input=src"
+    echo ""
+    echo -e "${YELLOW}# TypeScript analysis${NC}"
+    echo -e "sunlint --typescript --input=src"
+    echo ""
+    echo -e "${YELLOW}# All rules with JSON output (CI/CD)${NC}"
+    echo -e "sunlint --all --format=json --quiet --input=src"
+    echo ""
+    echo -e "${YELLOW}# Get help${NC}"
+    echo -e "sunlint --help"
+    echo ""
+    echo -e "${BLUE}📖 Documentation:${NC}"
+    echo -e "${BLUE}https://github.com/sun-asterisk/engineer-excellence/tree/main/coding-quality/extensions/sunlint${NC}"
+}
+
+# Main execution
+main() {
+    check_prerequisites
+    get_latest_version
+    uninstall_existing
+    install_sunlint
+    
+    if verify_installation; then
+        echo ""
+        echo -e "${GREEN}🎉 Installation completed successfully!${NC}"
+        echo ""
+        show_usage
+    else
+        echo -e "${RED}❌ Installation verification failed.${NC}"
+        exit 1
+    fi
+}
+
+# Handle script arguments
+case "${1:-}" in
+    --help|-h)
+        echo "SunLint CLI Installer"
+        echo ""
+        echo "Usage: $0 [options]"
+        echo ""
+        echo "Options:"
+        echo "  --help, -h     Show this help message"
+        echo "  --version, -v  Show installer version"
+        echo ""
+        echo "This script will:"
+        echo "1. Check for Node.js and npm"
+        echo "2. Fetch the latest SunLint release"
+        echo "3. Install SunLint CLI globally"
+        echo "4. Verify the installation"
+        exit 0
+        ;;
+    --version|-v)
+        echo "SunLint Installer v1.0.0"
+        exit 0
+        ;;
+    *)
+        main "$@"
+        ;;
+esac