pak-sh 2.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 449e8ad868594ed2fc644a521f500baa0c59c1110461690127e108c42c3815b0
+  data.tar.gz: d71070bcbb8f6be35167dc909cb3ea8c38d42aa1d31ed75009f7c18509566da3
+SHA512:
+  metadata.gz: 3b1e92bfb728ae1b13025a14d61ae2e5ea12ab23edd2eb1c6418095698b897db274d6313fe6867ff648af76025a5db4d47da7caf06e34368fdab012d1ed7fbf5
+  data.tar.gz: 6d81ba926fb94008256b1741f930f58193ba6369c4634ae9858870e4b94a5b341c86a176bdfacf7feab4f908a9cf7c61497c72c1f6854dd0a35fd6253bc909b0

data/README.md

@@ -0,0 +1,731 @@
+<div align="center">
+
+<!-- Logo -->
+<img src="https://raw.githubusercontent.com/pak/pak.sh/main/assets/logo.svg" alt="PAK.sh Logo" width="400">
+
+# PAK.sh - Universal Package Automation Kit
+
+### 🚀 Deploy Everywhere, Effortlessly
+
+[![Version](https://img.shields.io/badge/version-2.0.0-4A90E2?style=for-the-badge)](https://github.com/pak/pak.sh/releases)
+[![Platforms](https://img.shields.io/badge/platforms-30+-10B981?style=for-the-badge)](https://pak.sh/platforms)
+[![License](https://img.shields.io/badge/license-MIT-F59E0B?style=for-the-badge)](LICENSE)
+[![Downloads](https://img.shields.io/badge/downloads-1M+-06B6D4?style=for-the-badge)](https://pak.sh/stats)
+
+<p align="center">
+  <strong>One command to rule them all. Deploy to 30+ package platforms simultaneously.</strong>
+</p>
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│ $ pak deploy my-package --version 1.2.3                         │
+│                                                                 │
+│ 📦 Deploying to npm, pypi, cargo, nuget, packagist...           │
+│ ✓ npm: published v1.2.3                                         │
+│ ✓ pypi: published v1.2.3                                        │
+│ ✓ cargo: published v1.2.3                                       │
+│ ✓ nuget: published v1.2.3                                       │
+│ ✓ packagist: published v1.2.3                                   │
+│                                                                 │
+│ 🎉 Successfully deployed to 5 platforms in 45s                  │
+└─────────────────────────────────────────────────────────────────┘
+```
+
+[**Documentation**](https://pak.sh/docs) • [**Quick Start**](#-quick-start) • [**Features**](#-features) • [**API Reference**](https://pak.sh/api)
+
+</div>
+
+---
+
+## 🌟 Why PAK.sh?
+
+<table>
+<tr>
+<td width="50%">
+
+### 📊 **Track Everything**
+```bash
+$ pak track my-package
+
+📊 Tracking statistics...
+npm: 45,231 downloads (↑ 23%)
+pypi: 12,543 downloads (↑ 15%)
+cargo: 8,921 downloads (↑ 31%)
+
+📈 7-day trend: +18% growth
+🎯 Predicted next week: ~52,000
+```
+
+</td>
+<td width="50%">
+
+### 🔐 **Security First**
+```bash
+$ pak scan my-package
+
+🔍 Running security scan...
+✓ No vulnerabilities found
+✓ All licenses compatible
+⚠️  1 outdated dependency
+
+🔧 Run 'pak security fix' to resolve
+```
+
+</td>
+</tr>
+<tr>
+<td width="50%">
+
+### 🔐 **Register Everywhere**
+```bash
+$ pak register
+
+🧙 PAK.sh Registration Wizard
+=============================
+
+👤 USER PREFERENCES
+------------------
+Your name: John Doe
+Your email: john@example.com
+
+🎯 PLATFORM SELECTION
+-------------------
+Registering with ALL platforms:
+✓ npm, pypi, cargo, nuget, maven, packagist...
+
+🔐 REGISTRATION PROCESS
+---------------------
+📋 Registering with npm...
+✅ NPM credentials valid
+📋 Registering with pypi...
+✅ PyPI credentials saved
+📋 Registering with cargo...
+✅ Cargo credentials saved
+
+🎉 Successfully registered with 13 platforms!
+```
+
+</td>
+<td width="50%">
+
+### 🤖 **Automate Everything**
+```bash
+$ pak pipeline create
+
+🤖 Creating CI/CD pipeline...
+✓ GitHub Actions workflow created
+✓ Auto-deploy on tags enabled
+✓ Security scanning integrated
+✓ Multi-platform testing configured
+
+🚀 Your pipeline is ready!
+```
+
+</td>
+</tr>
+</table>
+
+## ✨ Features
+
+<div align="center">
+
+| Feature | Description |
+|---------|-------------|
+| 🚀 **Multi-Platform Deployment** | Deploy to 30+ platforms with one command |
+| 📊 **Real-time Analytics** | Track downloads, trends, and predictions |
+| 🔐 **Security Scanning** | Automated vulnerability and license checks |
+| 🔐 **Registration Wizard** | One-click setup for all platform credentials |
+| 🤖 **CI/CD Integration** | GitHub Actions, GitLab CI, Jenkins support |
+| 📈 **Smart Monitoring** | 24/7 health checks and alerts |
+| 🎨 **Beautiful CLI** | Interactive wizards and dynamic ASCII art |
+| 🔧 **Modular Architecture** | Extensible plugin system |
+| 🌍 **Global CDN** | Fast deployments worldwide |
+
+</div>
+
+## 🚀 Quick Start
+
+### Installation
+
+<details>
+<summary><b>🐧 Linux/macOS</b></summary>
+
+```bash
+# Download and install from pak.sh
+curl -sSL https://pak.sh/install | bash
+
+# Or download manually and run local installer
+curl -sSL https://pak.sh/latest.tar.gz | tar -xz
+cd pak.sh-*
+./install/install.sh
+
+# The installer will:
+# 1. Download latest release from pak.sh/latest.tar.gz
+# 2. Extract and set executable permissions
+# 3. Install to /usr/local/bin (or ~/.local/bin if no permissions)
+# 4. Set up web interface and auto-start
+# 5. Create configuration and data directories
+```
+
+</details>
+
+<details>
+<summary><b>🪟 Windows</b></summary>
+
+### Option 1: WSL2 (Recommended)
+```powershell
+# Install WSL2 with Ubuntu
+wsl --install
+
+# Restart your computer, then open Ubuntu terminal and run:
+curl -sSL https://pak.sh/install | bash
+```
+
+### Option 2: Git Bash
+```bash
+# Install Git for Windows, then in Git Bash:
+curl -sSL https://pak.sh/install | bash
+```
+
+### Option 3: PowerShell (Advanced)
+```powershell
+# Install WSL2 first, then use bash scripts
+wsl --install
+wsl curl -sSL https://pak.sh/install | wsl bash
+```
+</details>
+
+<details>
+<summary><b>📦 Package Managers</b></summary>
+
+```bash
+# npm (Recommended)
+npm install -g pak-sh
+pak-sh install
+
+# pip (Python)
+pip install pak-sh
+pak-sh install
+
+# Cargo (Rust)
+cargo install pak-sh
+pak-sh install
+
+# Homebrew (macOS/Linux)
+brew install pak-sh
+pak-sh install
+
+# Chocolatey (Windows)
+choco install pak-sh
+pak-sh install
+
+# Scoop (Windows)
+scoop install pak-sh
+pak-sh install
+
+# Packagist (PHP Composer)
+composer global require pak/pak-sh
+pak-sh install
+
+# Go Modules
+go install github.com/pak/pak-sh@latest
+pak-sh install
+```
+
+</details>
+
+### Your First Deployment
+
+```bash
+# 1. Register with all platforms (one-time setup)
+$ pak register
+
+🧙 PAK.sh Registration Wizard
+=============================
+✓ Successfully registered with 13 platforms!
+
+# 2. Initialize PAK in your project
+$ pak init
+
+🚀 Initializing Package Automation Kit...
+✓ Detected: my-awesome-package (npm, pypi, cargo)
+✓ Configuration created
+✓ Ready to deploy!
+
+# 3. Deploy to all platforms
+$ pak deploy --version 1.0.0
+
+📦 Deploying to 3 platforms...
+✓ All deployments successful!
+
+# 4. Track your package
+$ pak track
+
+📊 Real-time statistics:
+├── npm: 1,234 downloads
+├── pypi: 567 downloads
+└── cargo: 89 downloads
+
+# 5. Start web interface (optional)
+$ pak web
+
+🌐 Web interface available at: http://localhost:5000
+```
+
+## 🛠️ Command Reference
+
+### Core Commands
+
+```bash
+pak init                    # Initialize PAK in current directory
+pak register               # Interactive platform registration wizard
+pak deploy [package]        # Deploy to all configured platforms
+pak track [package]         # Track package statistics
+pak scan [package]          # Security vulnerability scan
+pak monitor [package]       # Start real-time monitoring
+pak status                  # Show system status
+pak version                 # Show version information
+pak web                     # Start web interface
+```
+
+### Deployment Commands
+
+```bash
+pak deploy [package]        # Deploy to all configured platforms
+pak deploy list             # List deployment history
+pak deploy rollback         # Rollback deployment
+pak deploy verify           # Verify deployment
+pak deploy clean            # Clean deployment artifacts
+```
+
+### Registration Commands
+
+```bash
+pak register               # Interactive registration wizard
+pak register-all           # Register with all supported platforms
+pak register-platform      # Register with specific platform
+pak register-test          # Test platform credentials
+pak register-list          # List registered platforms
+pak register-export        # Export credentials
+pak register-import        # Import credentials
+pak register-clear         # Clear all credentials
+```
+
+### Embed & Telemetry Commands
+
+```bash
+pak embed init             # Initialize embed system
+pak embed telemetry        # Track telemetry events
+pak embed analytics        # Analytics operations
+pak embed track            # Track various events
+pak embed report           # Generate reports
+```
+
+### Help & Documentation
+
+```bash
+pak help [command]          # Command-specific help
+pak docs                    # Show documentation
+pak docs search             # Search documentation
+```
+
+### Platform Management
+
+```bash
+pak platform list           # List all supported platforms
+pak platform add <name>     # Add platform to project
+pak platform remove <name>  # Remove platform from project
+pak platform test <name>    # Test platform connectivity
+```
+
+### Tracking & Analytics
+
+```bash
+pak track [package]         # Track package statistics
+pak stats [package]         # Show package statistics
+pak export [package]        # Export tracking data
+pak analytics [package]     # Generate analytics report
+```
+
+### Developer Experience (Devex)
+
+```bash
+pak devex wizard            # Interactive project setup wizard
+pak devex init              # Initialize new project
+pak devex setup             # Setup development environment
+pak devex template create   # Create project template
+pak devex docs              # Generate documentation
+pak devex scaffold          # Scaffold project structure
+pak devex env               # Manage environment
+pak devex lint              # Run linting
+pak devex format            # Format code
+```
+
+### Web Interface & Integration
+
+```bash
+pak web                     # Start web interface
+pak web start               # Start web server
+pak web stop                # Stop web server
+pak web status              # Check web server status
+pak webhook add             # Add webhook
+pak api start               # Start API server
+pak plugin install          # Install plugin
+```
+
+### Database & Storage
+
+```bash
+pak db                      # Database operations
+pak sqlite                  # SQLite operations
+pak backup                  # Create backup
+pak restore                 # Restore from backup
+pak migrate                 # Run migrations
+pak query                   # Execute queries
+pak stats                   # Show statistics
+```
+
+### Enterprise Features
+
+```bash
+pak billing                 # Billing management
+pak sla                     # SLA monitoring
+pak cost                    # Cost analysis
+pak team add                # Add team member
+pak audit start             # Start audit logging
+```
+
+### Security Commands
+
+```bash
+pak security audit          # Full security audit
+pak security fix            # Auto-fix security issues
+pak license check           # Check license compliance
+pak license validate        # Validate licenses
+pak scan [package]          # Security vulnerability scan
+```
+
+### Automation Commands
+
+```bash
+pak pipeline create         # Create CI/CD pipeline
+pak pipeline list           # List pipelines
+pak git hooks install       # Install Git hooks
+pak workflow create         # Create workflow
+pak auto-deploy             # Automated deployment
+pak schedule                # Schedule deployments
+pak release                 # Release management
+pak test                    # Run tests
+pak build                   # Build package
+```
+
+### Monitoring Commands
+
+```bash
+pak monitor [package]       # Start real-time monitoring
+pak health [package]        # Health check package
+pak alerts list             # List alerts
+pak alerts create           # Create alert
+pak dashboard               # Show monitoring dashboard
+pak metrics                 # Show metrics
+pak availability            # Check availability
+pak performance             # Performance monitoring
+```
+
+### User Interface Commands
+
+```bash
+pak ascii show              # Show ASCII art
+pak config get/set          # Manage configuration
+pak db status               # Show database status
+pak log show                # Show recent logs
+```
+
+### Lifecycle Commands
+
+```bash
+pak lifecycle deprecate     # Deprecate package
+pak lifecycle sunset        # Sunset package
+pak lifecycle migrate       # Migrate package
+pak version bump            # Bump version
+pak release create          # Create release
+pak deps check              # Check dependencies
+```
+
+### Debugging & Performance
+
+```bash
+pak debug enable            # Enable debug mode
+pak troubleshoot            # Troubleshoot issue
+pak optimize cache          # Optimize cache
+pak perf benchmark          # Benchmark package
+```
+
+### Networking & API
+
+```bash
+pak network test            # Test network connectivity
+pak api key                 # Set API key
+pak api test                # Test API connection
+pak api start               # Start API server
+```
+
+### Update & Maintenance
+
+```bash
+pak update check            # Check for updates
+pak maintenance start       # Start maintenance mode
+pak backup create           # Create backup
+```
+
+### Reporting & Compliance
+
+```bash
+pak report generate         # Generate report
+pak gdpr check              # Check GDPR compliance
+pak policy enforce          # Enforce policies
+```
+
+### Specialized Commands
+
+```bash
+pak unity deploy            # Deploy Unity asset
+pak docker build            # Build Docker image
+pak aws deploy              # Deploy to AWS
+pak vscode setup            # Setup VS Code integration
+```
+
+### Advanced Features
+
+```bash
+pak rollback <version>      # Rollback to previous version
+pak analytics <package>     # Generate analytics report
+```
+
+<div align="center">
+  <a href="https://pak.sh/commands">📚 View Full Command Reference</a>
+</div>
+
+## 📦 Supported Platforms
+
+<div align="center">
+
+### Language-Specific Registries
+
+| Platform | Language | Command |
+|----------|----------|---------|
+| 📦 **npm** | JavaScript/Node.js | `pak deploy --platform npm` |
+| 🐍 **PyPI** | Python | `pak deploy --platform pypi` |
+| 🦀 **Cargo** | Rust | `pak deploy --platform cargo` |
+| 🔷 **NuGet** | .NET/C# | `pak deploy --platform nuget` |
+| 💎 **RubyGems** | Ruby | `pak deploy --platform rubygems` |
+| ☕ **Maven** | Java | `pak deploy --platform maven` |
+| 🐘 **Packagist** | PHP | `pak deploy --platform packagist` |
+| 🐹 **Go Modules** | Go | `pak deploy --platform go` |
+
+### Container & Cloud Platforms
+
+| Platform | Type | Command |
+|----------|------|---------|
+| 🐳 **Docker Hub** | Containers | `pak deploy --platform docker` |
+| ☸️ **Helm** | Kubernetes | `pak deploy --platform helm` |
+| 🐙 **GitHub Packages** | Universal | `pak deploy --platform github` |
+| 🦊 **GitLab Registry** | Universal | `pak deploy --platform gitlab` |
+
+<a href="https://pak.sh/platforms">🌐 View All 30+ Platforms</a>
+
+</div>
+
+## 🔧 Configuration
+
+### Basic Configuration
+
+```yaml
+# pak.yaml
+name: my-awesome-package
+version: 1.2.3
+description: An awesome package deployed with PAK.sh
+
+platforms:
+  npm:
+    enabled: true
+    registry: https://registry.npmjs.org
+    
+  pypi:
+    enabled: true
+    repository: https://pypi.org
+    
+  docker:
+    enabled: true
+    registry: docker.io
+    image: myuser/mypackage
+
+deployment:
+  auto_deploy: true
+  environments:
+    - production
+    - staging
+    
+monitoring:
+  alerts:
+    email: team@example.com
+    slack: https://hooks.slack.com/...
+```
+
+### Environment Variables
+
+```bash
+# Platform Tokens (set up via 'pak register')
+export NPM_TOKEN="npm_xxxxxxxxxxxx"
+export PYPI_TOKEN="pypi-xxxxxxxxxxxx"
+export DOCKER_TOKEN="dckr_xxxxxxxxxxxx"
+
+# PAK Configuration
+export PAK_LOG_LEVEL="INFO"
+export PAK_PARALLEL_JOBS="5"
+export PAK_TIMEOUT="300"
+```
+
+## 📊 Dashboard & Analytics
+
+<div align="center">
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│                    📊 PAK.sh Analytics Dashboard                │
+├─────────────────────────────────────────────────────────────────┤
+│                                                                 │
+│  Total Downloads     Unique Users      Active Platforms        │
+│    1,234,567           45,678              12/30              │
+│       ↑23%               ↑15%               ✓                  │
+│                                                                 │
+│  ┌─────────────────────────────────────────────────────────┐  │
+│  │ Weekly Downloads                                         │  │
+│  │ 10k ┤                                          ╭────────│  │
+│  │  8k ┤                                    ╭─────╯        │  │
+│  │  6k ┤                             ╭──────╯             │  │
+│  │  4k ┤                      ╭──────╯                    │  │
+│  │  2k ┤───────────────╭──────╯                           │  │
+│  │   0 └─────────────────────────────────────────────────│  │
+│  │     Mon   Tue   Wed   Thu   Fri   Sat   Sun          │  │
+│  └─────────────────────────────────────────────────────────┘  │
+│                                                                 │
+│  Top Platforms:     Recent Activity:                          │
+│  1. npm    (45%)    • Deployed v1.2.3 (2 min ago)           │
+│  2. pypi   (25%)    • Security scan passed                   │
+│  3. docker (15%)    • 1,234 new downloads                    │
+│                                                                 │
+└─────────────────────────────────────────────────────────────┘
+```
+
+<a href="https://pak.sh/demo">🖥️ View Live Demo</a>
+
+</div>
+
+## 🤝 Contributing
+
+We love contributions! PAK.sh is built by developers, for developers.
+
+```bash
+# 1. Fork the repository
+git clone https://github.com/YOUR_USERNAME/pak.sh
+cd pak.sh
+
+# 2. Create a feature branch
+git checkout -b feature/amazing-feature
+
+# 3. Make your changes
+code .
+
+# 4. Run tests
+pak test
+
+# 5. Submit a pull request
+git push origin feature/amazing-feature
+```
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for detailed guidelines.
+
+## 🗺️ Roadmap
+
+<details>
+<summary><b>2024 Q1</b> ✅ Completed</summary>
+
+- ✅ Multi-platform deployment engine
+- ✅ Real-time analytics dashboard
+- ✅ Security scanning integration
+- ✅ CLI interface v2.0
+
+</details>
+
+<details>
+<summary><b>2024 Q2</b> 🚧 In Progress</summary>
+
+- 🚧 AI-powered deployment optimization
+- 🚧 Mobile app (iOS/Android)
+- 🚧 Enhanced webhook system
+- 🚧 GraphQL API
+
+</details>
+
+<details>
+<summary><b>2024 Q3</b> 📋 Planned</summary>
+
+- 📋 Blockchain package verification
+- 📋 Decentralized deployment network
+- 📋 Machine learning predictions
+- 📋 Voice control integration
+
+</details>
+
+## 📈 Stats & Community
+
+<div align="center">
+
+| Metric | Value |
+|--------|-------|
+| **Total Packages Deployed** | 1M+ |
+| **Active Users** | 45K+ |
+| **Platform Integrations** | 30+ |
+| **Average Deploy Time** | 45s |
+| **Uptime** | 99.9% |
+| **Community Stars** | ⭐ 12.5K |
+
+### Join Our Community
+
+[![Discord](https://img.shields.io/badge/Discord-5865F2?style=for-the-badge&logo=discord&logoColor=white)](https://discord.gg/paksh)
+[![Twitter](https://img.shields.io/badge/Twitter-1DA1F2?style=for-the-badge&logo=twitter&logoColor=white)](https://twitter.com/paksh)
+[![GitHub](https://img.shields.io/badge/GitHub-181717?style=for-the-badge&logo=github&logoColor=white)](https://github.com/pak/pak.sh)
+
+</div>
+
+## 📄 License
+
+PAK.sh is open source software licensed under the [MIT License](LICENSE).
+
+```
+MIT License
+
+Copyright (c) 2024 PAK.sh
+
+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...
+```
+
+---
+
+<div align="center">
+
+### Built with ❤️ by developers, for developers
+
+<br>
+
+<img src="https://raw.githubusercontent.com/pak/pak.sh/main/assets/terminal-demo.gif" alt="PAK.sh Demo" width="600">
+
+<br>
+<br>
+
+**[Get Started](https://pak.sh)** • **[Documentation](https://pak.sh/docs)** • **[API](https://pak.sh/api)** • **[Blog](https://pak.sh/blog)**
+
+</div>

data/bin/pak-sh

@@ -0,0 +1,229 @@
+#!/usr/bin/env bash
+# PAK.sh Wrapper Script
+# This script provides a unified interface for PAK.sh regardless of installation method
+
+set -euo pipefail
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+PURPLE='\033[0;35m'
+CYAN='\033[0;36m'
+WHITE='\033[1;37m'
+NC='\033[0m' # No Color
+
+# PAK.sh configuration
+PAK_VERSION="2.0.0"
+PAK_DOMAIN="pak.sh"
+PAK_INSTALL_URL="https://pak.sh/install"
+PAK_LATEST_URL="https://pak.sh/latest.tar.gz"
+
+# Installation paths to check (in order of preference)
+PAK_PATHS=(
+    "/usr/local/bin/pak"
+    "/opt/pak/bin/pak"
+    "$HOME/.local/bin/pak"
+    "$HOME/.pak/bin/pak"
+    "./pak/pak.sh"
+    "./node_modules/.bin/pak"
+    "./venv/bin/pak"
+    "./.cargo/bin/pak"
+)
+
+# Function to find PAK.sh installation
+find_pak_installation() {
+    for path in "${PAK_PATHS[@]}"; do
+        if [[ -f "$path" && -x "$path" ]]; then
+            echo "$path"
+            return 0
+        fi
+    done
+    return 1
+}
+
+# Function to install PAK.sh
+install_pak() {
+    echo -e "${BLUE}🚀 Installing PAK.sh...${NC}"
+    
+    # Create installation directory
+    local install_dir="$HOME/.pak"
+    mkdir -p "$install_dir/bin"
+    
+    # Download and install
+    echo -e "${BLUE}📥 Downloading PAK.sh...${NC}"
+    local temp_dir=$(mktemp -d)
+    cd "$temp_dir"
+    
+    if command -v curl >/dev/null 2>&1; then
+        curl -L -o pak.tar.gz "$PAK_LATEST_URL"
+    elif command -v wget >/dev/null 2>&1; then
+        wget -O pak.tar.gz "$PAK_LATEST_URL"
+    else
+        echo -e "${RED}❌ Error: Neither curl nor wget found${NC}"
+        exit 1
+    fi
+    
+    # Extract and install
+    echo -e "${BLUE}📦 Extracting PAK.sh...${NC}"
+    tar -xzf pak.tar.gz
+    
+    # Find extracted directory
+    local extracted_dir=""
+    if [[ -d "pak.sh-main" ]]; then
+        extracted_dir="pak.sh-main"
+    elif [[ -d "pak.sh-*" ]]; then
+        extracted_dir=$(ls -d pak.sh-* | head -1)
+    else
+        echo -e "${RED}❌ Error: Could not find extracted directory${NC}"
+        exit 1
+    fi
+    
+    cd "$extracted_dir"
+    
+    # Set permissions
+    echo -e "${BLUE}🔐 Setting permissions...${NC}"
+    find . -name "*.sh" -type f -exec chmod +x {} \;
+    find . -name "*.py" -type f -exec chmod +x {} \;
+    
+    # Run installer
+    if [[ -f "install/install.sh" ]]; then
+        echo -e "${BLUE}🔧 Running installer...${NC}"
+        INSTALL_DIR="$install_dir/bin" ./install/install.sh
+    else
+        # Manual installation
+        echo -e "${BLUE}📁 Installing to $install_dir/bin...${NC}"
+        cp -r pak "$install_dir/bin/"
+        chmod +x "$install_dir/bin/pak"
+    fi
+    
+    # Cleanup
+    cd /
+    rm -rf "$temp_dir"
+    
+    echo -e "${GREEN}✅ PAK.sh installed successfully!${NC}"
+    echo -e "${CYAN}📁 Installation location: $install_dir/bin/pak${NC}"
+    echo -e "${YELLOW}💡 Add to PATH: export PATH=\"$install_dir/bin:\$PATH\"${NC}"
+}
+
+# Function to show help
+show_help() {
+    cat << EOF
+PAK.sh Wrapper Script v$PAK_VERSION
+
+Usage: pak-sh [command] [options]
+
+Commands:
+  install                    Install PAK.sh locally
+  run [command] [options]    Run PAK.sh command
+  update                     Update PAK.sh installation
+  status                     Check PAK.sh installation status
+  help                       Show this help message
+
+Examples:
+  pak-sh install             # Install PAK.sh
+  pak-sh run deploy          # Run: pak deploy
+  pak-sh run init            # Run: pak init
+  pak-sh status              # Check installation status
+
+Installation Methods:
+  1. Direct: curl -sSL https://pak.sh/install | bash
+  2. Wrapper: pak-sh install
+  3. Package Managers:
+     - npm: npm install -g pak-sh
+     - pip: pip install pak-sh
+     - cargo: cargo install pak-sh
+     - brew: brew install pak-sh
+
+For more information, visit: https://pak.sh
+EOF
+}
+
+# Function to check status
+check_status() {
+    echo -e "${BLUE}🔍 Checking PAK.sh installation status...${NC}"
+    
+    local pak_path=$(find_pak_installation)
+    if [[ -n "$pak_path" ]]; then
+        echo -e "${GREEN}✅ PAK.sh found at: $pak_path${NC}"
+        
+        # Get version
+        if "$pak_path" version >/dev/null 2>&1; then
+            local version=$("$pak_path" version 2>/dev/null | head -1)
+            echo -e "${GREEN}📦 Version: $version${NC}"
+        fi
+        
+        # Check if in PATH
+        if command -v pak >/dev/null 2>&1; then
+            echo -e "${GREEN}✅ 'pak' command available in PATH${NC}"
+        else
+            echo -e "${YELLOW}⚠️  'pak' command not in PATH${NC}"
+            echo -e "${CYAN}💡 Add to PATH: export PATH=\"$(dirname "$pak_path"):\$PATH\"${NC}"
+        fi
+    else
+        echo -e "${RED}❌ PAK.sh not found${NC}"
+        echo -e "${YELLOW}💡 Run 'pak-sh install' to install PAK.sh${NC}"
+        return 1
+    fi
+}
+
+# Function to update PAK.sh
+update_pak() {
+    echo -e "${BLUE}🔄 Updating PAK.sh...${NC}"
+    
+    local pak_path=$(find_pak_installation)
+    if [[ -z "$pak_path" ]]; then
+        echo -e "${RED}❌ PAK.sh not found. Run 'pak-sh install' first.${NC}"
+        exit 1
+    fi
+    
+    # Backup current installation
+    local backup_dir="$HOME/.pak/backup/$(date +%Y%m%d_%H%M%S)"
+    mkdir -p "$backup_dir"
+    cp -r "$(dirname "$pak_path")" "$backup_dir/"
+    
+    echo -e "${BLUE}💾 Backup created at: $backup_dir${NC}"
+    
+    # Reinstall
+    install_pak
+    
+    echo -e "${GREEN}✅ PAK.sh updated successfully!${NC}"
+}
+
+# Main function
+main() {
+    local command="${1:-help}"
+    
+    case "$command" in
+        install)
+            install_pak
+            ;;
+        run)
+            shift
+            local pak_path=$(find_pak_installation)
+            if [[ -z "$pak_path" ]]; then
+                echo -e "${RED}❌ PAK.sh not found. Run 'pak-sh install' first.${NC}"
+                exit 1
+            fi
+            exec "$pak_path" "$@"
+            ;;
+        status)
+            check_status
+            ;;
+        update)
+            update_pak
+            ;;
+        help|--help|-h)
+            show_help
+            ;;
+        *)
+            echo -e "${RED}❌ Unknown command: $command${NC}"
+            echo -e "${YELLOW}💡 Run 'pak-sh help' for usage information${NC}"
+            exit 1
+            ;;
+    esac
+}
+
+# Run main function with all arguments
+main "$@" 

data/lib/pak_sh.rb

@@ -0,0 +1,20 @@
+# PAK.sh Wrapper Ruby Library
+# Provides Ruby interface for PAK.sh operations
+
+module PakSh
+  VERSION = "2.0.1"
+  
+  class Wrapper
+    def self.install
+      system("pak-sh install")
+    end
+    
+    def self.status
+      system("pak-sh status")
+    end
+    
+    def self.run(command, *args)
+      system("pak-sh run #{command}", *args)
+    end
+  end
+end

metadata

@@ -0,0 +1,115 @@
+--- !ruby/object:Gem::Specification
+name: pak-sh
+version: !ruby/object:Gem::Version
+  version: 2.0.1
+platform: ruby
+authors:
+- PAK.sh Team
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2025-07-23 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+description: Professional wrapper for PAK.sh installation and management via various
+  package managers
+email:
+- team@pak.sh
+executables:
+- pak-sh
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- bin/pak-sh
+- lib/pak_sh.rb
+homepage: https://pak.sh
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://pak.sh
+  source_code_uri: https://github.com/cyber-boost/pak
+  changelog_uri: https://github.com/cyber-boost/pak/blob/main/CHANGELOG.md
+  bug_tracker_uri: https://github.com/cyber-boost/pak/issues
+  documentation_uri: https://pak.sh/docs
+post_install_message: "\U0001F680 PAK.sh Wrapper has been installed!\n\nTo install
+  PAK.sh, run:\n  pak-sh install\n\nTo check status:\n  pak-sh status\n\nTo run PAK.sh
+  commands:\n  pak-sh run init\n  pak-sh run deploy my-package\n  pak-sh run web\n\nDocumentation:
+  https://pak.sh/docs\nGitHub: https://github.com/cyber-boost/pak\n"
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.6.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements:
+- Bash shell
+- curl
+- git
+rubygems_version: 3.4.20
+signing_key:
+specification_version: 4
+summary: PAK.sh - Universal Package Automation Kit Wrapper
+test_files: []