@sun-asterisk/sunlint 1.0.5

package/CHANGELOG.md

@@ -0,0 +1,202 @@
+# Changelog
+
+All notable changes to Sun Lint will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.0.4] - 2025-07-08
+
+### 🔒 **Security Rules Integration** 
+
+#### Added
+- **40 Security Rules** - Complete integration of TypeScript security rules (S005-S058)
+- **Security Category Support** - New `--security` CLI option to run security rules only
+- **Quality Category Support** - New `--quality` CLI option to run quality rules only
+- **Dynamic Rule Configuration** - ESLint rules enabled/disabled based on user selection
+- **Enhanced ESLint Integration** - TypeScript parser support and improved plugin loading
+
+#### **Security Rules Implemented**
+- **S005**: No Origin Header Authentication
+- **S006**: Activation Recovery Secret Not Plaintext  
+- **S008**: Crypto Agility
+- **S009**: No Insecure Crypto
+- **S010**: No Insecure Random in Sensitive Context
+- **S011**: No Insecure UUID
+- **S012**: No Hardcoded Secrets
+- **S014-S058**: 35 additional security rules (TLS, validation, session, auth, etc.)
+
+*Complete list of all 43 security rules available in rules registry*
+
+#### **CLI Enhancements**
+```bash
+# Run security rules only
+sunlint --security --typescript --input=src/
+
+# Run quality rules only  
+sunlint --quality --typescript --input=src/
+
+# Run all rules (quality + security + typescript)
+sunlint --all --typescript --input=src/
+```
+
+#### **Architecture Improvements**
+- Enhanced rule registry with security rule metadata
+- Improved category-based rule filtering
+- Dynamic ESLint configuration based on selected rules
+- Better TypeScript parsing support in ESLint integration
+- Modular plugin architecture for custom security rules
+
+### Fixed
+- ESLint TypeScript parser configuration
+- Plugin resolution for custom security rules
+- Rule mapping between SunLint and ESLint formats
+
+### Changed
+- Updated rules registry structure to support security categories
+- Enhanced CLI with category-specific options
+- Improved rule configuration system
+
+---
+
+## [1.0.0] - 2024-01-XX (Previous Release)
+
+### 🎉 **Initial Release**
+
+#### Added
+- **☀️ Sun Lint CLI** - Universal coding standards checker
+- **Multi-rule support** - Run single, multiple, or all rules
+- **Quality & Security categories** - Separate analysis domains
+- **Multi-language support** - TypeScript, Dart, Kotlin
+- **Configuration system** - `.sunlint.json` with presets
+- **Multiple output formats** - ESLint, Summary, Detailed, GitHub
+
+#### **Quality Rules Implemented**
+- **C005** - Single Responsibility Principle
+- **C006** - Function Naming (verb/verb-noun)
+- **C007** - Comment Quality (avoid code description)
+- **C012** - Command Query Separation (CQS)
+- **C014** - Dependency Injection usage
+- **C015** - Domain Language usage
+- **C019** - Log Level Usage (stable from previous version)
+- **C031** - Validation Separation
+- **C037** - API Response Format
+- **C040** - Centralized Validation Logic
+
+#### **Security Rules Planned**
+- **S001** - SQL Injection Prevention
+- **S002** - XSS Prevention  
+- **S003** - Authentication Checks
+- **S004** - Data Encryption
+
+#### **CLI Features**
+- `sunlint --quality` - Run all quality rules
+- `sunlint --security` - Run all security rules
+- `sunlint --all` - Run all available rules
+- `sunlint --rule=C019` - Run specific rule
+- `sunlint --rules=C019,C006` - Run multiple rules
+- `sunlint --config=.sunlint.json` - Use configuration file
+- `sunlint --preset=@sun/sunlint/recommended` - Use preset
+
+#### **Configuration**
+- **Preset configurations** - recommended, strict, security, quality
+- **Rule-specific settings** - error, warn, off severity levels
+- **Language targeting** - Filter by programming language
+- **Ignore patterns** - Exclude files/directories
+- **Custom rule paths** - Extend with custom rules
+
+#### **Output Formats**
+- **ESLint format** - Compatible with IDEs and CI/CD
+- **Summary format** - Human-readable overview
+- **Detailed format** - Complete analysis results
+- **GitHub format** - GitHub Actions integration
+
+#### **Development Features**
+- **Extensible architecture** - Easy to add new rules
+- **Test framework** - Unit and integration tests
+- **VS Code integration** - Problems panel support
+- **CI/CD ready** - GitHub Actions and GitLab CI examples
+
+#### **Documentation**
+- **Comprehensive README** - Installation and usage guide
+- **Contributing guide** - Development workflow and standards
+- **Rule documentation** - Detailed rule explanations
+- **Configuration examples** - Real-world configurations
+
+### 🏗 **Architecture**
+- **Modular design** - Separate core, rules, and config
+- **Plugin system** - Extensible rule loading
+- **Multi-format output** - Flexible reporting
+- **Configuration inheritance** - Preset and custom configs
+
+### 🚀 **Performance**
+- **Fast analysis** - Optimized rule execution
+- **Incremental scanning** - Only analyze changed files
+- **Parallel processing** - Multi-rule concurrent execution
+- **Memory efficient** - Minimal resource usage
+
+### 📦 **Distribution**
+- **NPM package** - `@sun/sunlint`
+- **Global installation** - `npm install -g @sun/sunlint`
+- **Local project use** - Development dependency support
+- **VS Code extension** - Future integration planned
+
+---
+
+## **Migration from coding-standards**
+
+Sun Lint is the evolution of the previous `coding-standards` tool with enhanced features:
+
+### **What Changed**
+- **Name**: `coding-standards` → `sunlint`
+- **Command**: `coding-standards` → `sunlint`
+- **Config**: `.coding-standards.json` → `.sunlint.json`
+- **Package**: `@coding-quality/standards` → `@sun/sunlint`
+
+### **Migration Guide**
+```bash
+# Uninstall old tool
+npm uninstall -g @coding-quality/standards
+
+# Install Sun Lint
+npm install -g @sun/sunlint
+
+# Update configuration file
+mv .coding-standards.json .sunlint.json
+
+# Update config contents
+sed -i 's/coding-standards/sunlint/g' .sunlint.json
+
+# Update scripts in package.json
+sed -i 's/coding-standards/sunlint/g' package.json
+```
+
+### **What's Compatible**
+- ✅ All existing rules (C005, C006, C007, etc.)
+- ✅ Rule configurations and severity levels
+- ✅ Output formats (eslint, summary, detailed)
+- ✅ Command-line arguments and options
+- ✅ Language support (TypeScript, Dart, Kotlin)
+
+### **What's New**
+- ☀️ **Sun* branding** and unified tooling
+- 🔒 **Security rule category** with planned security rules
+- 🎯 **Quality/Security separation** with `--quality` and `--security` flags
+- 📦 **Preset configurations** for common use cases
+- 🔧 **Enhanced configuration** with extends and inheritance
+- 📊 **GitHub Actions format** for better CI/CD integration
+
+---
+
+**Release Notes Format:**
+- 🎉 Major features
+- ✨ Enhancements  
+- 🐛 Bug fixes
+- 🔒 Security updates
+- 📚 Documentation
+- 🏗 Architecture changes
+- 🚀 Performance improvements
+
+---
+
+**Built with ☀️ by Sun* Engineering Team**

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Sun* Engineering Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,490 @@
+# ☀️ Sun Lint - Universal Coding Standards
+
+**Multi-rule, Multi-language Code Quality & Security Analysis Tool with ESLint Integration**
+
+## 🎯 **Overview**
+
+Sun Lint is a universal coding standards checker that provides comprehensive code quality and security analysis. Built by Sun* Engineering Team with integrated security rules from OWASP and industry best practices.
+
+### **✨ Key Features**
+- ✅ **93+ Coding Rules**: Quality, security, and best practices
+- ✅ **ESLint Integration**: Merge with existing ESLint configurations  
+- ✅ **Git Integration**: `--changed-files`, `--staged-files`, `--pr-mode`
+- ✅ **TypeScript Support**: Native TypeScript analysis engine
+- ✅ **CI/CD Ready**: Baseline comparison, fail-on-new-violations
+- ✅ **Multiple Formats**: ESLint, JSON, Summary, Table output
+- ✅ **Team Adoption**: Zero-disruption integration for existing workflows
+
+### **🚀 Quick Start**
+- ✅ **Run single rule**: `sunlint --rule=C019`
+- ✅ **Run multiple rules**: `sunlint --rules=C019,C006,C021`  
+- ✅ **Run all rules**: `sunlint --all` (93 rules total)
+- ✅ **Run by category**: `sunlint --quality` or `sunlint --security`
+- ✅ **ESLint integration**: `sunlint --all --eslint-integration`
+- ✅ **Git workflow**: `sunlint --all --changed-files`
+
+## 📦 **Installation**
+
+### **Method 1: Global Installation (Recommended)**
+```bash
+# Install globally for command-line usage - Universal for all languages
+npm install -g @sun-asterisk/sunlint
+
+# Verify installation
+sunlint --version
+```
+
+*✨ **Why Global?** SunLint supports multiple languages (TypeScript, Dart, Kotlin, Java, Swift, etc.). Global installation provides universal access across all project types.*
+
+### **Method 2: TypeScript Project Integration** 
+For TypeScript-specific projects that prefer project-level dependencies:
+```bash
+# Add to TypeScript project dependencies  
+npm install --save-dev @sun-asterisk/sunlint
+
+# Or using yarn
+yarn add --dev @sun-asterisk/sunlint
+```
+
+**Package.json scripts for TypeScript projects:**
+```json
+{
+  "scripts": {
+    "lint": "sunlint --typescript --input=src",
+    "lint:changed": "sunlint --typescript --changed-files",
+    "lint:eslint-integration": "sunlint --typescript --eslint-integration --input=src"
+  },
+  "devDependencies": {
+    "@sun-asterisk/sunlint": "^1.0.5"
+  }
+}
+```
+
+### **🌍 Multi-Language Strategy**
+**Future Roadmap**: SunLint will expand to support:
+- ✅ **TypeScript** (Phase 1 - Current)
+- 🔄 **Dart** (Phase 2 - Planned)  
+- 🔄 **Kotlin** (Phase 3 - Planned)
+- 🔄 **Java** (Phase 4 - Planned)
+- 🔄 **Swift** (Phase 5 - Planned)
+
+**Global installation ensures**:
+- ✅ **Cross-project compatibility**: One tool for all languages
+- ✅ **Team standardization**: Consistent tool across different project types  
+- ✅ **CI/CD simplicity**: Single installation for polyglot repositories
+
+### **Method 3: GitHub Package Registry (Private)**
+```bash
+# 1. Setup GitHub Package Registry (one-time)
+curl -fsSL https://raw.githubusercontent.com/sun-asterisk/engineer-excellence/main/coding-quality/extensions/sunlint/scripts/setup-github-registry.sh | GITHUB_TOKEN=your_token bash
+
+# 2. Install SunLint globally  
+npm install -g @sun-asterisk/sunlint
+
+# 3. Verify installation
+sunlint --version
+```
+
+**Manual setup**:
+```bash
+# Configure GitHub Package Registry
+echo "@sun-asterisk:registry=https://npm.pkg.github.com" >> ~/.npmrc
+echo "//npm.pkg.github.com/:_authToken=${GITHUB_TOKEN}" >> ~/.npmrc
+
+# Install from GitHub Packages globally
+npm install -g @sun-asterisk/sunlint
+```
+
+### **Method 4: Direct GitHub Release**
+```bash
+# Install from GitHub release tarball globally
+npm install -g https://github.com/sun-asterisk/engineer-excellence/releases/download/sunlint-v1.0.5/sunlint-1.0.5.tgz
+
+# Verify installation
+sunlint --version
+```
+
+### **Method 5: Development Setup**
+```bash
+# Clone and install for development
+git clone https://github.com/sun-asterisk/engineer-excellence.git
+cd engineer-excellence/coding-quality/extensions/sunlint
+npm install
+npm install -g .
+```
+
+## 🔗 **ESLint Integration** *(New in v1.0.5)*
+
+SunLint can seamlessly integrate with existing ESLint configurations, combining both rule sets in a single execution.
+
+### **For Teams with Existing ESLint**
+```bash
+# Analyze with both SunLint + existing ESLint rules
+sunlint --all --eslint-integration --input=src
+
+# Works with git integration too
+sunlint --all --eslint-integration --changed-files
+```
+
+### **Configuration**
+```json
+{
+  "sunlint": {
+    "eslintIntegration": {
+      "enabled": true,
+      "mergeRules": true,
+      "preserveUserConfig": true
+    },
+    "rules": {
+      "C006": "warn",
+      "C019": "error"
+    }
+  }
+}
+```
+
+### **Benefits**
+- ✅ **No workflow disruption**: Existing ESLint continues working
+- ✅ **Single command**: Execute 93 SunLint + your existing ESLint rules
+- ✅ **Conflict resolution**: Your ESLint rules take precedence
+- ✅ **Combined reporting**: Unified violation tracking
+
+**Example**: Team with 20 existing ESLint rules + 93 SunLint rules = **113 total rules** in single execution!
+
+[📖 **Read Full ESLint Integration Guide**](./docs/ESLINT_INTEGRATION.md)
+
+## 🔀 **Git Integration** *(New in v1.0.5)*
+
+SunLint provides powerful Git integration for optimized CI/CD workflows and development processes.
+
+### **Basic Git Commands**
+```bash
+# Analyze only changed files (vs main branch)
+sunlint --all --changed-files
+
+# Analyze only staged files (pre-commit)
+sunlint --all --staged-files
+
+# PR mode with custom base branch
+sunlint --all --changed-files --diff-base=origin/develop
+
+# Files changed since specific commit
+sunlint --all --since=abc123
+
+# PR mode with failure only on new violations
+sunlint --all --pr-mode --fail-on-new-violations
+```
+
+### **CI/CD Integration Examples**
+```bash
+# GitHub Actions - PR check
+sunlint --all --changed-files --diff-base=origin/main --format=summary
+
+# Pre-commit hook
+sunlint --all --staged-files --format=summary --no-ai
+
+# Release validation
+sunlint --all --since=last-release --format=json --output=quality-report.json
+```
+
+### **Combined Git + ESLint Integration**
+```bash
+# Ultimate integration: Git + ESLint + SunLint
+sunlint --all --eslint-integration --changed-files --fail-on-new-violations
+```
+
+**Benefits**:
+- ✅ **Performance**: Only analyze relevant files
+- ✅ **PR-focused**: Catch issues in changed code  
+- ✅ **Incremental**: Fail only on new violations
+- ✅ **Flexible**: Support multiple Git workflows
+
+## 🎯 **Usage Examples**
+```bash
+# Install for specific project
+npm install https://github.com/sun-asterisk/engineer-excellence/releases/download/sunlint-v1.0.0/sun-sunlint-1.0.0.tgz
+
+# Use with npx
+npx sunlint --quality --input=src
+```
+
+### **Verify Installation**
+```bash
+sunlint --version
+# Should output: 1.0.0
+
+sunlint --help
+# Shows full command options
+```
+
+## � **TypeScript Support** *(New in v1.0.5)*
+
+SunLint provides native TypeScript analysis with dedicated engine and enhanced rule support.
+
+### **TypeScript-specific Commands**
+```bash
+# Force TypeScript engine for all rules
+sunlint --typescript --input=src
+
+# TypeScript with specific rules
+sunlint --typescript --rules=C006,C019,S047 --input=src
+
+# TypeScript + ESLint integration
+sunlint --typescript --eslint-integration --input=src
+
+# TypeScript + Git integration
+sunlint --typescript --changed-files --format=summary
+```
+
+### **Project Integration for TypeScript**
+*Optional: If you prefer project-level dependencies*
+```json
+{
+  "scripts": {
+    "lint:ts": "sunlint --typescript --input=src",
+    "lint:ts-changed": "sunlint --typescript --changed-files", 
+    "lint:ts-eslint": "sunlint --typescript --eslint-integration --input=src"
+  },
+  "devDependencies": {
+    "@sun-asterisk/sunlint": "^1.0.5",
+    "@typescript-eslint/eslint-plugin": "^6.0.0",
+    "@typescript-eslint/parser": "^6.0.0"
+  }
+}
+```
+
+*Note: SunLint works equally well with global installation. Project-level dependencies are optional for TypeScript projects.*
+
+### **Features**
+- ✅ **Native AST Analysis**: TypeScript parser integration
+- ✅ **ESLint Bridge**: Seamless integration with existing ESLint rules  
+- ✅ **Type Checking**: Leverage TypeScript compiler for advanced analysis
+- ✅ **Performance**: Optimized for TypeScript codebases
+
+## �📋 **Available Rules**
+
+### **Quality Rules** ✨
+| Rule ID | Name | Category | Languages | Status |
+|---------|------|----------|-----------|--------|
+| **C005** | Single Responsibility | quality | TS, Dart, Kotlin | ✅ Stable |
+| **C006** | Function Naming | quality | TS, Dart, Kotlin | ✅ Stable |
+| **C007** | Comment Quality | quality | TS, Dart, Kotlin | ✅ Stable |
+| **C012** | Command Query Separation | quality | TS, Dart, Kotlin | ✅ Stable |
+| **C014** | Dependency Injection | quality | TS, Dart, Kotlin | ✅ Stable |
+| **C015** | Domain Language | quality | TS, Dart, Kotlin | ✅ Stable |
+| **C019** | Log Level Usage | quality | TS, Dart, Kotlin | ✅ Stable |
+| **C031** | Validation Separation | quality | TS, Dart, Kotlin | ✅ Stable |
+| **C037** | API Response Format | quality | TS, Dart, Kotlin | ✅ Stable |
+
+### **Security Rules** 🔒 *(New in v1.0.4)*
+| Rule ID | Name | Category | Languages | Status |
+|---------|------|----------|-----------|--------|
+| **S005** | No Origin Header Authentication | security | TS, JS | ✅ Stable |
+| **S006** | Activation Recovery Secret Not Plaintext | security | TS, JS | ✅ Stable |
+| **S008** | Crypto Agility | security | TS, JS | ✅ Stable |
+### **Security Rules** 🔒 *(43 rules total)*
+| Rule ID | Name | Category | Languages | Status |
+|---------|------|----------|-----------|--------|
+| **S005** | No Origin Header Authentication | security | TS, JS | ✅ Stable |
+| **S008** | Crypto Agility | security | TS, JS | ✅ Stable |
+| **S012** | No Hardcoded Secrets | security | TS, JS | ✅ Stable |
+| **S014-S058** | *...40 additional security rules* | security | TS, JS | ✅ Stable |
+
+*Complete list available in CHANGELOG.md*
+
+## 🎮 **Usage Examples**
+
+### **Basic Usage**
+```bash
+# Run all rules (93 total: quality + security)
+sunlint --all --typescript --input=src/
+
+# Check specific category
+sunlint --security --typescript --input=src/
+sunlint --quality --typescript --input=src/
+
+# Check specific rules
+sunlint --rules=C019,S005 --typescript --input=src/
+```
+
+### **Complete Analysis** 🎯
+```bash
+# Run all rules (quality + security = 44 rules)
+sunlint --all --typescript --input=src/
+
+# Local development scan
+sunlint --typescript --input=. --format=summary
+
+# Check single file
+sunlint --all --typescript --input=components/Button.tsx
+```
+
+### **CI/CD Integration** 🚀
+```bash
+# Full project scan (main branch)
+sunlint --all --input=. --format=json --output=sunlint-report.json
+
+# Changed files only (PR checks)  
+sunlint --all --changed-files --format=summary
+
+# With ESLint integration
+sunlint --all --eslint-integration --changed-files
+```
+
+## ⚙️ **Configuration**
+
+Create `.sunlint.json` in your project root:
+
+```json
+{
+  "extends": "@sun/sunlint/recommended",
+  "rules": {
+    "C019": "error",
+    "C006": "warn", 
+    "S005": "error"
+  },
+  "categories": ["quality", "security"],
+  "ignorePatterns": ["node_modules/**", "dist/**"]
+}
+```
+- `@sun/sunlint/security` - Security-focused rules only
+- `@sun/sunlint/quality` - Quality-focused rules only
+
+## 📊 **Output Formats**
+
+```bash
+# ESLint-compatible JSON
+sunlint --format=eslint --input=src
+
+# Human-readable summary
+sunlint --format=summary --input=src
+
+# Detailed report
+sunlint --format=detailed --input=src
+
+# GitHub Actions format
+sunlint --format=github --input=src
+```
+
+## 🚀 **CI/CD Strategy & Best Practices**
+
+### **Vấn đề về Performance và Cost**
+
+| Approach | Ưu điểm | Nhược điểm | Khi nào sử dụng |
+|----------|---------|------------|-----------------|
+| **Full Scan** | Phát hiện hết tất cả issues, consistent | Chậm, tốn resource, nhiều noise | Main branch, weekly reports |
+| **Changed Files Only** | Nhanh, relevant, cost-effective | Miss issues từ dependency changes | PR checks, pre-commit |
+| **Baseline Comparison** | Balance giữa performance và coverage | Setup phức tạp hơn | Large projects |
+
+### **Recommended CI/CD Strategy**
+
+## 📊 **Output Formats**
+
+```bash
+# ESLint-compatible JSON
+sunlint --format=eslint --input=src
+
+# Human-readable summary  
+sunlint --format=summary --input=src
+
+# GitHub Actions format
+sunlint --format=github --input=src
+```
+
+## 🚀 **CI/CD Best Practices**
+
+### **Recommended Strategy**
+```bash
+# PR: Check changed files only (fast)
+sunlint --all --changed-files --diff-base=origin/main
+
+# Main branch: Full scan + baseline
+sunlint --all --input=. --save-baseline=baseline.json
+```
+
+**Performance**: Changed files (~10-30s) vs Full scan (~2-5min)
+
+## 🛠 **CI/CD Integration**
+
+**GitHub Actions (PR Mode):**
+```yaml
+name: Code Quality Check
+on:
+  pull_request:
+    branches: [main, develop]
+
+jobs:
+  sunlint:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v3
+      with:
+        fetch-depth: 0  # Fetch full history for diff comparison
+    
+    - name: Setup Node.js
+      uses: actions/setup-node@v3
+      with:
+        node-version: '18'
+    
+    - name: Install SunLint
+**GitHub Actions Example:**
+```yaml
+name: Code Quality Check
+on:
+  pull_request:
+    branches: [main]
+
+jobs:
+  sunlint:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v3
+      with:
+        fetch-depth: 0
+    
+    - name: Setup Node.js
+      uses: actions/setup-node@v3
+      with:
+        node-version: '18'
+    
+    - name: Install SunLint
+      run: npm install -g @sun-asterisk/sunlint
+    
+    - name: Run SunLint on Changed Files
+      run: |
+        sunlint --all --changed-files --diff-base=origin/main \
+        --format=github --fail-on-new-violations
+```
+      with:
+        name: sunlint-baseline
+        path: sunlint-baseline.json
+```
+
+**GitLab CI (PR Mode):**
+```yaml
+sunlint:pr:
+  stage: code-quality
+  rules:
+    - if: $CI_PIPELINE_SOURCE == "merge_request_event"
+  script:
+```
+
+## 📚 **Documentation**
+
+- **[Full Documentation](docs/)** - Complete guide and advanced features
+- **[AI Analysis Guide](docs/AI.md)** - AI-powered analysis setup
+- **[Debug Guide](docs/DEBUG.md)** - Debugging rules and CLI
+
+## 📜 **License**
+
+MIT License - see [LICENSE](./LICENSE) for details.
+
+## 🔗 **Links**
+
+- **Documentation**: [Sun Lint Docs](https://sunlint.docs.sun.com)
+- **Issues**: [GitHub Issues](https://github.com/sun-engineering/sunlint/issues)
+- **Changelog**: [CHANGELOG.md](./CHANGELOG.md)
+
+---
+
+**Built with ☀️ by Sun* Engineering Team**