@mediaproc/cli 0.6.0 → 0.7.0

package/README.md

@@ -1,1530 +1,333 @@
 # MediaProc
 
-Universal media processing CLI with an extensible plugin architecture. One tool to process all your media - images, videos, audio, documents, and more.
+> Universal media processing CLI with plugin architecture. One tool for images, videos, audio, and more.
 
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-[![Version](https://img.shields.io/badge/version-0.6.0-blue.svg)](https://www.npmjs.com/package/@mediaproc/cli)
-[![Node.js Version](https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen)](https://nodejs.org/)
-[![TypeScript](https://img.shields.io/badge/TypeScript-5.3.3-blue)](https://www.typescriptlang.org/)
-[![Status](https://img.shields.io/badge/status-beta-green)](https://github.com/0xshariq/mediaproc)
-[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](CONTRIBUTING.md)
-
----
-
-## 📋 Table of Contents
-
-- [The Problem](#-the-problem)
-- [Our Solution](#-our-solution)
-- [Current Status](#-current-status)
-- [Features](#-features)
-- [Quick Start](#-quick-start)
-- [Available Plugins](#-available-plugins)
-- [Plugin Terminology](#-plugin-terminology)
-- [Documentation](#-documentation)
-- [Examples](#-examples)
-- [Development](#-development)
-- [Roadmap](#-roadmap)
-- [Contributing](#-contributing)
-- [Community](#-community)
-- [License](#-license)
-
----
-
-## 🎯 The Problem
-
-Media processing in modern development workflows is **fragmented and complex**:
-
-### Current Pain Points
-
-1. **Too Many Tools**
-
-   - FFmpeg for videos
-   - ImageMagick for images
-   - SoX for audio
-   - Ghostscript for PDFs
-   - Different tools for each media type
-
-2. **Inconsistent Interfaces**
-
-   - Each tool has different command syntax
-   - Different parameter names and formats
-   - Steep learning curve for each tool
-   - Hard to remember all the commands
-
-3. **Complex Workflows**
-
-   - Chaining multiple tools together
-   - Writing custom shell scripts
-   - Managing dependencies across tools
-   - Debugging is painful
-
-4. **Lack of Flexibility**
-
-   - Hard to extend with custom processing
-   - No plugin ecosystem
-   - Difficult to integrate into CI/CD
-   - Limited automation capabilities
-
-5. **Performance Issues**
-   - Manual parallelization
-   - No built-in batch processing
-   - Memory management challenges
-   - Inefficient for large files
-
-### Real-World Scenarios
-
-**Web Developer:** "I need to resize 100 images, convert to WebP, and optimize for web. Should I use Sharp? ImageMagick? Write a Node script? Use Gulp/Webpack?"
-
-**Video Editor:** "I need to transcode videos, extract thumbnails, and create HLS streams. Do I write FFmpeg commands? Use a GUI tool? Build a custom pipeline?"
-
-**DevOps Engineer:** "I need to automate media processing in CI/CD. How do I make it reliable, fast, and easy to maintain across different media types?"
-
-**Content Manager:** "I need to batch process documents, add watermarks to images, and compress videos. I don't want to learn 5 different tools."
-
----
-
-## 💡 Our Solution
-
-**MediaProc is a unified CLI that solves these problems:**
-
-### Core Philosophy
-
-🎯 **One Tool for Everything** - Process any media type with consistent commands  
-🔌 **Plugin Architecture** - Extend with official or community plugins  
-⚡ **Performance First** - Multi-threaded, streaming, optimized for large files  
-🎨 **Simple & Intuitive** - Clear commands, helpful errors, great DX  
-🔧 **Automation Ready** - Perfect for scripts, CI/CD, and workflows  
-🌍 **Community Driven** - Open source, extensible, third-party plugins welcome
-
-### What Makes MediaProc Different
-
-| Feature            | Traditional Tools          | MediaProc                       |
-| ------------------ | -------------------------- | ------------------------------- |
-| **Interface**      | Different for each tool    | Unified, consistent CLI         |
-| **Installation**   | Install 5+ separate tools  | One tool, add plugins as needed |
-| **Learning Curve** | Learn each tool separately | Learn once, use everywhere      |
-| **Extensibility**  | Limited or none            | Built-in plugin system          |
-| **Performance**    | Manual optimization        | Auto-parallelization, streaming |
-| **Automation**     | Write custom scripts       | Built-in pipeline workflows     |
-| **Community**      | Separate ecosystems        | Unified plugin marketplace      |
-
-### How It Works
-
-```bash
-# Traditional approach (multiple tools)
-convert input.jpg -resize 1920x1080 output.jpg
-ffmpeg -i input.mp4 -c:v h264 -crf 23 output.mp4
-sox input.wav -r 44100 output.mp3
-gs -sDEVICE=pdfwrite -dCompatibilityLevel=1.4 -o output.pdf input.pdf
-
-# MediaProc approach (one tool, consistent syntax)
-mediaproc image resize input.jpg --width 1920 --height 1080
-mediaproc video transcode input.mp4 --codec h264 --crf 23
-mediaproc audio convert input.wav --samplerate 44100 --format mp3
-mediaproc document compress input.pdf --quality high
-```
-
----
-
-## 📊 Current Status
-
-**Version**: 0.6.0 (Beta - Production Ready!)  
-**Status**: ✅ Image plugin (51 commands) + ✅ Video plugin (6 commands) + Audio plugin (5 commands) + Universal CLI  
-**Next Release**: Audio & Document plugins (Q1 2026)  
-**Expected v1.0**: Q2 2026
-
-### Plugin Management
-
-MediaProc provides comprehensive plugin lifecycle management:
-
-- `mediaproc list` - List all installed plugins with versions
-- `mediaproc add <plugin>` - Install plugins from npm registry
-- `mediaproc remove <plugin>` - Safely uninstall plugins
-- `mediaproc delete <plugin>` - Delete plugins (alias for remove)
-- `mediaproc update [plugin]` - Update plugin(s) to latest versions
-  - Without plugin name: updates all installed plugins
-  - With plugin name: updates specific plugin
-  - Shows version changes and update summary
-- `mediaproc validate [plugin]` - Validate plugin installation and integrity
-  - Check plugin structure and dependencies
-  - Verify command registrations
-  - Detect issues before execution
-
-### Universal Commands (Work Without Plugins)
-
-Core CLI commands available immediately after installation:
-
-**Media Operations:**
-
-- `mediaproc convert <input> <output>` - Auto-detect and suggest the conversion
-- `mediaproc info <file>` - Display comprehensive file information
-- `mediaproc optimize <file>` - Analyze and suggest optimization strategies
-
-**Help & Configuration:**
-
-- `mediaproc help [command]` - Show help for commands
-- `mediaproc init` - Initialize configuration file
-- `mediaproc config` - Manage configuration settings
-- `mediaproc run <command>` - Execute plugin commands
-
-### Image Processing (@mediaproc/image)
-
-**Install:** `mediaproc add image`
-
-**51 Professional Commands Available:**
-
-**Transform & Resize** (10 commands)
-
-- `resize` - Resize with fit modes (cover, contain, fill, inside, outside)
-- `crop` - Extract rectangular regions with positioning
-- `rotate` - Any angle rotation with background control
-- `flip` - Vertical mirroring (top-bottom)
-- `flop` - Horizontal mirroring (left-right)
-- `auto-orient` - Auto-rotate based on EXIF orientation
-- `affine` - Apply affine transformation matrix (scale, shear, reflect)
-- `trim` - Auto-remove uniform borders
-- `extend` - Add padding/borders with custom colors
-- `thumbnail` - Generate thumbnails (64px to 512px)
-
-**Color & Tone** (10 commands)
-
-- `modulate` - Adjust brightness, saturation, hue
-- `gamma` - Gamma correction for midtones (0.1-3.0)
-- `tint` - Apply color tint overlays (RGB hex)
-- `grayscale` - Convert to black & white
-- `negate` - Create negative/inverted images
-- `normalize` - Auto-enhance contrast and brightness
-- `linear` - Apply linear formula: output = (a \* input) + b
-- `recomb` - Recombine RGB channels using matrix
-- `flatten` - Remove alpha transparency with background color
-- `unflatten` - Add alpha channel (RGB→RGBA)
-
-**Effects & Filters** (9 commands)
-
-- `blur` - Gaussian blur (0.3-1000 sigma)
-- `sharpen` - Enhance details and edges (flat/jagged modes)
-- `median` - Noise reduction filter (1-50 size)
-- `sepia` - Vintage sepia tone effect
-- `vignette` - Darken edges for artistic focus
-- `pixelate` - Retro pixel art effect (custom pixel size)
-- `threshold` - Binary black/white conversion (0-255)
-- `dilate` - Morphological dilation (expand bright regions)
-- `erode` - Morphological erosion (expand dark regions)
-
-**Advanced Operations** (6 commands)
-
-- `composite` - Layer images with blend modes (overlay, multiply, screen)
-- `extract` - Extract color channels (red, green, blue, alpha)
-- `border` - Add decorative frames with custom colors
-- `clahe` - Contrast-limited adaptive histogram equalization
-- `convolve` - Apply custom convolution kernels (sharpen, emboss, edge)
-- `boolean` - Perform boolean operations between images (AND, OR, XOR)
-
-**Smart/AI Operations** (6 commands)
-
-- `smart-crop` - Intelligent content-aware cropping (attention/entropy)
-- `auto-enhance` - Automatic color and contrast enhancement
-- `palette` - Extract dominant color palettes (2-256 colors)
-- `dominant-color` - Quick dominant color extraction
-- `grid` - Combine images into collage layouts
-- `batch` - Process multiple images at once with any operation
-
-**Utility** (10 commands)
-
-- `compress` - Advanced compression with quality control
-- `convert` - Format conversion (JPG, PNG, WebP, AVIF, TIFF, GIF)
-- `optimize` - Size optimization (up to 70% reduction, lossless/lossy)
-- `info` - Display detailed image metadata
-- `watermark` - Add watermarks with positioning and opacity
-- `stats` - Technical image statistics (channels, depth, color space)
-- `split` - Split image into grid tiles
-- `stack` - Stack images horizontally/vertically
-- `mirror` - Create mirror/kaleidoscope effects
-- `metadata` - View, export, or remove EXIF data
-
-**Format Support:**
-
-- Input: JPG, PNG, WebP, AVIF, TIFF, GIF, SVG, HEIF
-- Output: JPG, PNG, WebP, AVIF, TIFF, GIF
-- Modern formats: WebP (25-35% smaller), AVIF (50% smaller)
-
-**Professional Features:**
-
-- Quality control (1-100)
-- Dry-run mode (preview before executing)
-- Verbose logging
-- Built-in help for every command
-- Comprehensive error handling
-- File size reporting
-
-### Video Processing (@mediaproc/video)
-
-**Install:** `mediaproc add video`
-
-**6 Professional Commands Available:**
-
-**Format & Quality**
-
-- `compress` - CRF-based compression with presets (ultrafast to veryslow)
-  - H.264/H.265 codec support
-  - Quality control via CRF (0-51)
-  - Two-pass encoding option
-  - Hardware acceleration support
-- `transcode` - Convert between formats with codec control
-  - MP4, WebM, AVI, MKV, MOV support
-  - Video: H.264, H.265, VP9, AV1
-  - Audio: AAC, MP3, Opus, Vorbis
-  - Custom bitrate and quality settings
-
-**Editing & Manipulation**
-
-- `trim` - Cut videos by time or percentage
-  - Start/end time specification (HH:MM:SS)
-  - Duration-based trimming
-  - Percentage-based cutting
-  - Frame-accurate cutting
-- `resize` - Scale videos to target resolution
-  - Preset sizes: 4K, 1080p, 720p, 480p, 360p
-  - Custom dimensions with aspect ratio preservation
-  - Multiple scaling algorithms (fast/quality)
-
-**Merging & Extraction**
-
-- `merge` - Concatenate multiple videos
-  - Fast concat mode (no re-encode)
-  - Re-encode mode for different formats
-  - Automatic format compatibility detection
-- `extract` - Extract media from videos
-  - `extract-audio` - Extract audio tracks (MP3, AAC, WAV, FLAC)
-  - `extract-frames` - Export frame sequences (JPG, PNG)
-  - `extract-thumbnail` - Generate video thumbnails
-
-**Technical Features:**
-
-- FFmpeg-powered processing
-- Hardware acceleration (when available)
-- Progress tracking with ETA
-- Dry-run mode for preview
-- Comprehensive metadata display
-- File size reporting
-- Quality presets for common use cases
-
-### Audio Processing (@mediaproc/audio)
-
-**Install:** Built-in with CLI (or standalone: `npm install -g @mediaproc/audio`)
-
-**5 Professional Commands Available:**
-
-**Format Conversion**
-
-- `convert` - Convert between audio formats
-  - Formats: MP3, AAC, WAV, FLAC, OGG, Opus, M4A
-  - Quality presets: low, medium, high, lossless
-  - Bitrate control (128k, 192k, 256k, 320k)
-  - Sample rate adjustment (44.1kHz, 48kHz, 96kHz)
-  - Channel control (mono/stereo)
-
-**Extraction & Processing**
-
-- `extract` - Extract audio from video files
-  - Support for all major video formats
-  - Multiple output formats
-  - Quality and bitrate control
-  - Preserves audio metadata
-
-**Audio Enhancement**
-
-- `normalize` - Audio level normalization
-  - EBU R128 loudness standard (loudnorm)
-  - Peak normalization method
-  - Target LUFS: -16 (broadcast), -23 (streaming), -14 (podcasts)
-  - True peak limiting to prevent clipping
-  - Consistent volume across files
-
-**Editing**
-
-- `trim` - Cut audio segments
-  - Time-based trimming (HH:MM:SS or seconds)
-  - Duration-based cutting
-  - Optional fade-in/fade-out effects
-  - Fast mode (stream copy, no re-encoding)
-  - Frame-accurate cutting
-
-**Merging**
-
-- `merge` - Concatenate multiple audio files
-  - Seamless joining of audio files
-  - Optional crossfade between tracks
-  - Automatic format normalization
-  - Multi-file batch processing
-
-**Technical Features:**
-
-- FFmpeg/FFprobe powered processing
-- Comprehensive format support
-- Quality presets for common use cases
-- Progress tracking with detailed output
-- Dry-run mode for command preview
-- Metadata preservation
-- File size reporting
-- Built-in help for every command
-
-✅ **Architecture** - Plugin system designed and implemented  
-✅ **Core CLI** - Command framework with plugin discovery  
-✅ **Built-in Plugins** - Image, Video, and Audio plugins ship with CLI  
-✅ **Plugin Registry** - Smart plugin management  
-✅ **Documentation** - Comprehensive guides and standards  
-✅ **Community Guidelines** - Contributing, security, code of conduct
-
-### 🚧 In Development
-
-🚧 **Testing** - Comprehensive test coverage  
-🚧 **Examples** - Real-world usage examples
-
-### What's Next
-
-📋 **Document Plugin** - PDF processing, OCR (Q2 2026)  
-📋 **Advanced Plugins** - 3D, streaming, AI features (Q2-Q3 2026)  
-📋 **Plugin Marketplace** - Community plugin directory (Q3 2026)
-
-See [Upcoming Features](docs/upcoming-features.md) for detailed roadmap.
-
----
-
-## ✨ Features
-
-### Core Architecture
-
-#### 🎁 **Built-in Plugins** (Out of the Box)
-
-MediaProc ships with essential plugins pre-installed, giving you immediate productivity:
-
-- **@mediaproc/image** - Professional image processing (49 commands)
-
-  - Resize, crop, rotate, flip, convert formats
-  - Filters: blur, sharpen, tint, grayscale, median
-  - Color adjustments: modulate, gamma, normalize
-  - Utilities: thumbnail, watermark, optimize, trim, extend
-
-- **@mediaproc/video** - Professional video processing (7 commands)
-  - Compress: CRF-based compression with quality presets
-  - Transcode: Format conversion (MP4, WebM, AVI, MKV)
-  - Convert: Simple format conversion with remux support
-  - Trim: Time-based cutting and clipping
-  - Resize: Scale to 4K, 1080p, 720p, or custom
-  - Merge: Concatenate multiple videos
-  - Extract: Audio tracks, frame sequences, thumbnails
-
-- **@mediaproc/audio** - Professional audio processing (5 commands)
-  - Convert: Format conversion (MP3, AAC, WAV, FLAC, OGG, Opus)
-  - Extract: Extract audio from video files
-  - Normalize: Audio level normalization (EBU R128 standard)
-  - Trim: Cut audio segments with fade effects
-  - Merge: Concatenate multiple audio files with crossfade
-
-#### 🔌 **Add-on Plugins** (Install as Needed)
-
-Extend functionality by installing additional plugins from npm:
+[![Version](https://img.shields.io/badge/version-0.6.0--beta-blue.svg)](https://www.npmjs.com/package/@mediaproc/cli)
+[![Node.js](https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen)](https://nodejs.org/)
 
 ```bash
-# Add more plugins from npm
-mediaproc add animation  # GIF, WebP, Lottie optimization
-mediaproc add 3d         # glTF, OBJ, FBX processing
-mediaproc add stream     # HLS/DASH streaming
-mediaproc add ai         # AI-powered enhancements
-```
-
-#### 💡 **Why This Architecture?**
-
-**Universal CLI Benefits:**
-
-- ✅ Get started instantly with built-in plugins
-- ✅ Consistent command syntax across all plugins
-- ✅ Unified plugin management (`add`, `remove`, `list`)
-- ✅ Shared configuration and settings
-- ✅ Better integration between different media types
-- ✅ One tool to learn instead of many
-
-**Standalone Plugin Benefits:**
-
-- ✅ Each plugin can also run independently
-- ✅ Lightweight installs (only what you need)
-- ✅ Faster startup for single-purpose usage
-- ✅ Easy to distribute and share
+# Install
+npm install -g @mediaproc/cli
 
-**Example: Two Ways to Use**
+# Process images
+mediaproc image resize photo.jpg --width 1920 --height 1080
+mediaproc image convert *.jpg --format webp --quality 85
 
-```bash
-# Option 1: Use with universal CLI (recommended)
-npm install -g @mediaproc/cli  # Includes @mediaproc/image built-in
-mediaproc image resize photo.jpg -w 1920
+# Process videos  
+mediaproc video compress movie.mp4 --quality high
+mediaproc video trim video.mp4 --start 00:01:30 --end 00:03:45
 
-# Option 2: Use plugin standalone (if you only need images)
-npm install -g @mediaproc/image
-mediaproc-image resize photo.jpg -w 1920
+# Process audio
+mediaproc audio convert song.wav --format mp3 --quality high
+mediaproc audio normalize podcast.mp3 --target -16
 ```
 
-### Current Features (v0.2.0)
-
-#### Core CLI
-
-- ✅ Plugin discovery and loading
-- ✅ Built-in plugins (ship with CLI)
-- ✅ Add-on plugins (install from npm)
-- ✅ Smart installation (auto-detects global/local)
-- ✅ Plugin registry with short names
-- ✅ Configuration management
-- ✅ TypeScript with strict mode
-- ✅ Cross-platform support
-
-#### Plugin Management
-
-- `mediaproc list` - List all plugins (built-in and installed)
-- `mediaproc add <plugin>` - Install add-on plugins from npm
-- `mediaproc remove <plugin>` - Uninstall add-on plugins
-- `mediaproc delete <plugin>` - Delete/uninstall plugins (alias: uninstall)
-  - `--global` - Delete globally installed plugin
-  - `--local` - Delete locally installed plugin
-  - `--yes` - Skip confirmation prompt
-  - `--verbose` - Show detailed output
-- `mediaproc update [plugin]` - Update plugin(s) to latest version
-  - `--version <version>` - Update to specific version
-  - `--global` - Update globally installed plugins
-  - `--verbose` - Show detailed output
-- `mediaproc plugins` - Show available plugins
-- `mediaproc init` - Initialize configuration
-- `mediaproc config` - Manage settings
-
-#### Universal Commands (Work Without Plugins)
-
-- `mediaproc convert <input> <output>` - Auto-detect and convert any media file
-- `mediaproc info <file>` - Show file information for any media type
-- `mediaproc optimize <file>` - Suggest optimization strategy based on file type
-
-#### Image Processing (@mediaproc/image) ★ BUILT-IN
-
-**40 Professional Commands Ready to Use:**
-
-**Transform & Resize** (7 commands)
-
-- `resize` - Resize with fit modes (cover, contain, fill, inside, outside)
-- `crop` - Extract rectangular regions with positioning
-- `rotate` - Any angle rotation with background control
-- `flip` - Horizontal/vertical/both mirroring
-- `trim` - Auto-remove uniform borders
-- `extend` - Add padding/borders with custom colors
-- `thumbnail` - Generate thumbnails (64px to 512px)
-
-**Color & Tone** (6 commands)
-
-- `modulate` - Adjust brightness, saturation, hue
-- `gamma` - Gamma correction for midtones (0.1-3.0)
-- `tint` - Apply color tint overlays (RGB hex)
-- `grayscale` - Convert to black & white
-- `negate` - Create negative/inverted images
-- `normalize` - Auto-enhance contrast and brightness
-
-**Effects & Filters** (6 commands)
-
-- `blur` - Gaussian blur (0.3-1000 sigma)
-- `sharpen` - Enhance details and edges (flat/jagged modes)
-- `median` - Noise reduction filter (1-50 size)
-- `sepia` - Vintage sepia tone effect
-- `vignette` - Darken edges for artistic focus
-- `pixelate` - Retro pixel art effect (custom pixel size)
-
-**Advanced Operations** (6 commands)
-
-- `composite` - Layer images with blend modes
-- `extract` - Extract color channels or regions
-- `border` - Add decorative frames
-- `clahe` - Contrast-limited adaptive histogram equalization
-- `convolve` - Apply custom convolution kernels
-- `text` - Add text overlays with styling
-
-**Utility & Metadata** (8 commands)
-
-- `convert` - Format conversion
-- `optimize` - Smart size optimization
-- `compress` - Advanced compression control
-- `watermark` - Add watermarks with positioning
-- `info` - Display image metadata
-- `metadata` - Manage EXIF/IPTC data
-- `thumbnail` - Generate optimized thumbnails
-- `stats` - Technical image statistics
-
-**Format Support:**
-
-- Input: JPG, PNG, WebP, AVIF, TIFF, GIF, SVG, HEIF
-- Output: JPG, PNG, WebP, AVIF, TIFF, GIF
-- Modern formats: WebP (25-35% smaller), AVIF (50% smaller)
-
-**Professional Features:**
-
-- Quality control (1-100)
-- Dry-run mode (preview before executing)
-- Verbose logging
-- Built-in help for every command
-- Comprehensive error handling
-- File size reporting
-
-See [plugins/image/README.md](plugins/image/README.md) for complete image plugin documentation.
-
-### Planned Features (Add-on Plugins)
-
-#### Document Processing (@mediaproc/document) - Q2 2026
-
-- PDF compression
-- Page extraction and splitting
-- OCR text extraction
-- PDF merging
-- Format conversion
-- Watermarking
-
-#### Advanced Features (Q3-Q4 2026)
-
-- Animation optimization (GIF, WebP, Lottie)
-- 3D model optimization
-- Metadata management
-- HLS/DASH streaming
-- AI-assisted processing
-- Pipeline workflows
-
-See [docs/upcoming-features.md](docs/upcoming-features.md) for complete feature list.
-
----
-
-## 🚀 Quick Start
+## Why MediaProc?
 
-### Prerequisites
+**The Problem:** Modern development workflows require multiple tools for media processing:
+- FFmpeg for videos
+- ImageMagick for images  
+- SoX for audio
+- Each with different syntax, steep learning curves, and complex workflows
 
-- **Node.js** >= 18.0.0
-- **pnpm** (recommended) or npm
-- **System dependencies** (installed as needed by plugins):
-  - FFmpeg (for video/audio)
-  - Sharp/libvips (for images)
-  - Ghostscript (for PDFs)
+**The Solution:** MediaProc provides a unified CLI with consistent commands across all media types.
 
-### Installation
+| Feature | Traditional | MediaProc |
+|---------|------------|-----------|
+| **Tools Needed** | 5+ separate tools | One tool |
+| **Installation** | Complex setup | `npm install -g @mediaproc/cli` |
+| **Syntax** | Different for each | Consistent everywhere |
+| **Extensibility** | Limited | Plugin architecture |
 
-#### From npm (when published)
+## Quick Start
 
 ```bash
-# Install the universal CLI (includes built-in plugins)
+# Install CLI
 npm install -g @mediaproc/cli
 
-# Start using immediately - image plugin is built-in!
-mediaproc image resize photo.jpg -w 1920
-mediaproc image convert photo.jpg -f webp
+# Install plugins (or use built-in ones)
+mediaproc add image
+mediaproc add video
+mediaproc add audio
 
-# Check version and list plugins
-mediaproc --version
+# List available plugins
 mediaproc list
-```
-
-#### From Source (current)
-
-```bash
-# Clone repository
-git clone https://github.com/0xshariq/mediaproc.git
-cd mediaproc
-
-# Install dependencies
-pnpm install
-
-# Build all packages (including built-in plugins)
-pnpm build:all
 
-# Link globally
-cd plugins/image && pnpm link --global
-cd ../.. && pnpm link --global
-
-# Verify
-mediaproc --version
-mediaproc list  # Should show @mediaproc/image as built-in
-```
-
-### Basic Usage
-
-```bash
-# Image processing (built-in - works immediately!)
-mediaproc image resize photo.jpg --width 1920 --height 1080
-mediaproc image convert photo.jpg -f webp -q 85
-mediaproc image thumbnail photo.jpg -s 300
-
-# Get help anytime
+# Get help
 mediaproc --help
 mediaproc image --help
-mediaproc image resize --help
 ```
 
-### Adding More Plugins
-
-```bash
-# Install additional plugins from npm
-mediaproc add video    # Video processing
-mediaproc add audio    # Audio processing
-mediaproc add document # PDF processing
-
-# Update plugins to latest version
-mediaproc update           # Update all plugins
-mediaproc update image     # Update specific plugin
-
-# View all plugins (built-in + installed)
-mediaproc list
-
-# Example output:
-# 📦 Built-in Plugins:
-# ✓ image ★ BUILT-IN
-#
-# 🔌 User-Installed:
-# ✓ video
-# ✓ audio
-```
-
-# View installed plugins
-
-mediaproc list
-
-````
-
----
-
-## 📦 Available Plugins
-
-### Official Plugins
-
-| Plugin                             | Commands | Status         | Description                              |
-| ---------------------------------- | -------- | -------------- | ---------------------------------------- |
-| **[image](plugins/image)**         | 10       | 🚧 In Progress | Resize, convert, optimize, filter images |
-| **[video](plugins/video)**         | 6        | 🚧 In Progress | Transcode, compress, trim, merge videos  |
-| **[audio](plugins/audio)**         | 5        | 🚧 In Progress | Convert, normalize, trim, merge audio    |
-| **[document](plugins/document)**   | 5        | 📋 Planned     | Process PDFs and documents               |
-| **[animation](plugins/animation)** | 2        | 📋 Planned     | Optimize GIFs and animations             |
-| **[3d](plugins/3d)**               | 4        | 📋 Planned     | Optimize 3D models                       |
-| **[metadata](plugins/metadata)**   | 4        | 📋 Planned     | Manage media metadata                    |
-| **[stream](plugins/stream)**       | 3        | 📋 Planned     | HLS/DASH packaging                       |
-| **[ai](plugins/ai)**               | 4        | 💡 Concept     | AI-powered processing                    |
-| **[pipeline](plugins/pipeline)**   | 2        | 📋 Planned     | Workflow automation                      |
-
-**Legend:** ✅ Complete | 🚧 In Progress | 📋 Planned | 💡 Concept
-
-### Community Plugins
-
-Third-party plugins are welcome! See [Creating Plugins](#-creating-your-own-plugins) below.
-
-**Plugin Development Resources:**
-
-- 📖 [Plugin Integration Guide](docs/plugin-integration-guide.md) - Complete tutorial
-- 🏗️ [Plugin Template](https://github.com/0xshariq/mediaproc-plugin-template) - Starter template (coming soon)
-- 📚 [Example Plugins](https://github.com/0xshariq/mediaproc-examples) - Real examples (coming soon)
-
-_Coming soon: Browse community plugins at https://plugins.mediaproc.dev_
-
----
-
-## � Plugin Terminology
-
-### Important: No Plugins Are Pre-Installed!
-
-MediaProc CLI is lightweight and contains **NO plugin code**. All plugins must be explicitly installed.
-
-### Plugin Types
-
-1. **Official Plugins** (`@mediaproc/*`) - Maintained by MediaProc team
-   - Example: `@mediaproc/image`, `@mediaproc/video`
-   - High quality, regularly updated
-   - Install: `mediaproc add image`
-
-2. **Community Plugins** (`mediaproc-*`) - Community-maintained
-   - Example: `mediaproc-custom-filter`
-   - Follow community standards
-   - Install: `mediaproc add mediaproc-custom-filter`
-
-3. **Third-Party Plugins** - Any compatible npm package
-   - No naming convention required
-   - Must implement MediaProc plugin interface
-   - Install: `mediaproc add package-name`
-
-### Quick Reference
-
-```bash
-# Install CLI (no plugins included)
-npm install -g @mediaproc/cli
-
-# Browse available plugins
-mediaproc plugins
+## Available Plugins
 
-# Install official plugins
-mediaproc add image    # Image processing
-mediaproc add video    # Video processing
+### Built-in Plugins
 
-# Check what's installed
-mediaproc list
-
-# Use installed plugins
-mediaproc image resize photo.jpg -w 800
-```
-
-### Updating Plugins
-
-Keep plugins up-to-date for latest features and bug fixes:
+Included with CLI installation:
 
+#### Image Plugin (51 commands)
 ```bash
-# Update all installed plugins
-mediaproc update
-
-# Update specific plugin
-mediaproc update image
-mediaproc update video
-
-# Update with scope control
-mediaproc update --global     # Global plugins only
-mediaproc update image --local  # Local plugin only
-
-# Verbose output
-mediaproc update --verbose
+mediaproc image resize photo.jpg --width 1920
+mediaproc image convert *.png --format webp
+mediaproc image compress image.jpg --quality 85
+mediaproc image blur photo.jpg --sigma 10
+mediaproc image watermark photo.jpg --text "Copyright 2026"
 ```
 
-See full documentation for version control and advanced options.
-   - Example: `mediaproc-custom-filter`
-   - Full name required: `mediaproc update mediaproc-custom-filter`
-
-3. **Third-Party Plugins** - ◇ THIRD-PARTY
-   - Any other npm package
-   - Full package name: `mediaproc update @company/plugin-name`
-
-**What the update command does:**
+**Commands:** resize, crop, rotate, flip, convert, compress, optimize, blur, sharpen, grayscale, tint, watermark, thumbnail, and 36 more...
 
-1. **Detects Plugin Type**: Identifies official, community, or third-party plugins
-2. **Detects Installation Scope**: Automatically determines if plugins are installed globally or locally
-3. **Fetches Latest Versions**: Checks npm registry for the newest versions (or specific version)
-4. **Updates Dependencies**: Uses the appropriate package manager (npm, pnpm, yarn, bun, deno)
-5. **Shows Changes**: Displays version changes (old → new)
-6. **Auto-Reload**: Plugins are automatically available after update
+**Formats:** JPG, PNG, WebP, AVIF, TIFF, GIF, SVG
 
-**Examples:**
+[Full Image Plugin Documentation →](plugins/image/README.md)
 
+#### Video Plugin (6 commands)
 ```bash
-# Update all plugins (recommended)
-$ mediaproc update
-✓ Updating all MediaProc plugins...
-✓ All MediaProc plugins updated successfully
-
-# Update official plugin to latest
-$ mediaproc update image
-✓ Detecting plugin type for image...
-✓ image ★ OFFICIAL updated successfully (1.2.0 → 1.2.2)
-
-# Update to specific version
-$ mediaproc update image --version 1.2.1
-✓ image ★ OFFICIAL updated successfully (1.2.0 → 1.2.1)
-
-# Update community plugin
-$ mediaproc update mediaproc-custom-filter
-✓ mediaproc-custom-filter ◆ COMMUNITY updated successfully
-
-# Update with verbose output
-$ mediaproc update image --verbose
-ℹ Package manager: pnpm
-ℹ Plugin type: ★ OFFICIAL
-ℹ Package name: @mediaproc/image
-ℹ Current version: 1.2.0
-ℹ Running: pnpm add @mediaproc/image
-✓ image ★ OFFICIAL updated successfully (1.2.0 → 1.2.2)
+mediaproc video compress movie.mp4 --quality medium
+mediaproc video transcode video.mp4 --format webm --codec vp9
+mediaproc video trim video.mp4 --start 10 --end 60
+mediaproc video resize 4k-video.mp4 --preset 1080p
+mediaproc video merge video1.mp4 video2.mp4 video3.mp4
+mediaproc video extract movie.mp4 --type audio --output audio.mp3
 ```
 
-**📘 Full Guide:** See [Plugin Terminology Guide](docs/plugin-terminology.md) for detailed explanations.
-
----
+**Commands:** compress, transcode, trim, resize, merge, extract
 
-### Deleting Plugins
+**Formats:** MP4, WebM, AVI, MKV, MOV
 
-Remove plugins you no longer need to free up disk space:
+[Full Video Plugin Documentation →](plugins/video/README.md)
 
+#### Audio Plugin (5 commands)
 ```bash
-# Delete a plugin (auto-detects installation scope)
-mediaproc delete image
-mediaproc delete video
-
-# Delete specific scope
-mediaproc delete image --global    # Delete globally installed
-mediaproc delete image --local     # Delete locally installed
-
-# Skip confirmation prompt
-mediaproc delete image --yes       # No confirmation
-
-# Verbose output
-mediaproc delete image --verbose   # Show detailed information
+mediaproc audio convert song.wav --format mp3 --quality high
+mediaproc audio normalize podcast.mp3 --target -16
+mediaproc audio trim audio.wav --start 10 --duration 30
+mediaproc audio merge track1.mp3 track2.mp3 track3.mp3
+mediaproc audio extract video.mp4 --format mp3
 ```
 
-**Plugin Type Detection:**
-
-The delete command automatically detects and handles three types of plugins:
+**Commands:** convert, normalize, trim, merge, extract
 
-1. **Official Plugins** (`@mediaproc/*`) - ★ OFFICIAL
-   ```bash
-   mediaproc delete image                    # Short name
-   mediaproc delete @mediaproc/image        # Full name
-   ```
+**Formats:** MP3, AAC, WAV, FLAC, OGG, Opus
 
-2. **Community Plugins** (`mediaproc-*`) - ◆ COMMUNITY
-   ```bash
-   mediaproc delete mediaproc-custom-filter  # Full name required
-   ```
+[Full Audio Plugin Documentation →](plugins/audio/README.md)
 
-3. **Third-Party Plugins** - ◇ THIRD-PARTY
-   ```bash
-   mediaproc delete @company/plugin-name     # Full package name
-   ```
+### Coming Soon
 
-**What the delete command does:**
+- **Document** - PDF processing (Q2 2026)
+- **Animation** - GIF/Lottie optimization (Q2 2026)
+- **3D** - 3D model processing (Q3 2026)
+- **Stream** - HLS/DASH streaming (Q3 2026)
+- **AI** - AI-powered features (Q3 2026)
 
-1. **Detects Plugin Type**: Identifies official, community, or third-party plugins
-2. **Detects Installation Scope**: Automatically determines if plugin is installed globally or locally
-3. **Confirms Deletion**: Shows confirmation prompt (skip with `--yes`)
-4. **Uninstalls Package**: Uses the appropriate package manager (npm, pnpm, yarn, bun)
-5. **Shows Status**: Displays deletion status with plugin type badge
-6. **Frees Memory**: Removes all plugin files from disk
-
-**Examples:**
+## Plugin Management
 
 ```bash
-# Delete a plugin
-mediaproc delete image
-mediaproc delete video --global
-
-# Skip confirmation
-mediaproc delete image --yes
-
-# Alias: uninstall
-mediaproc uninstall image
-```
-
-**📘 Full Guide:** See [Plugin Terminology Guide](docs/plugin-terminology.md) for detailed explanations.
-
----
-
-## �📚 Documentation
-
-Comprehensive documentation is available in the [docs/](docs/) folder:
-
-### Core Documentation
-
-- **[Plugin Terminology](docs/plugin-terminology.md)** - **START HERE!** Clear definitions and common misconceptions
-
-  - Official vs Community vs Third-Party plugins
-  - No plugins are pre-installed (explained)
-  - Installation workflow and plugin states
-  - Best practices and FAQ
-
-- **[Plugin Architecture](docs/plugin-architecture.md)** - How the plugin system works
-
-  - On-demand loading architecture
-  - Plugin discovery and lifecycle
-  - Why no auto-loading
-  - Technical implementation
-
-- **[Plugin System](docs/plugin-system.md)** - Complete guide to the plugin architecture
-
-  - How plugins work
-  - Plugin discovery and loading
-  - Creating plugins
-  - **Third-party plugin standards**
-  - Plugin submission process
-  - Quality standards
-  - Testing and publishing
-
-- **[Configuration](docs/configuration.md)** - Configure MediaProc for your workflow
-
-  - Configuration file format
-  - Global and project-level settings
-  - Plugin-specific options
-  - Environment variables
-  - Pipeline configuration
-
-- **[Upcoming Features](docs/upcoming-features.md)** - Roadmap and planned features
-  - Phase 1: Core plugins (Q1-Q2 2026)
-  - Phase 2: Advanced plugins (Q3 2026)
-  - Phase 3: AI & future-proof (Q4 2026)
-  - Long-term vision (2027+)
-
-### Plugin Documentation
-
-- **[Image Plugin Documentation](docs/image-plugin-documentation.md)** - Complete reference for the Image Plugin
-  - All 40 commands documented
-  - Usage examples and workflows
-  - Best practices and tips
-  - Social media presets
-  - Real-world use cases
-  - Troubleshooting guide
-
-### Community Guides
-
-- **[Contributing](CONTRIBUTING.md)** - How to contribute to MediaProc
-
-  - Reporting bugs
-  - Suggesting features
-  - Pull request guidelines
-  - Development setup
-  - Plugin development
-
-- **[Security](SECURITY.md)** - Security policy and vulnerability reporting
-
-  - Supported versions
-  - Reporting vulnerabilities
-  - Security best practices
-  - Disclosure policy
-
-- **[Code of Conduct](CODE_OF_CONDUCT.md)** - Community guidelines
-
-  - Our pledge
-  - Standards and expectations
-  - Enforcement
-  - Reporting process
+# List installed plugins
+mediaproc list
 
-- **[Changelog](CHANGELOG.md)** - Release history and changes
-- **[License](LICENSE)** - MIT License
+# Install plugins
+mediaproc add <plugin-name>
 
-### External Resources (Coming Soon)
+# Remove plugins  
+mediaproc remove <plugin-name>
 
-- 🌐 Website: https://mediaproc.dev
-- 📖 Full Docs: https://docs.mediaproc.dev
-- 🎓 Tutorials: https://tutorials.mediaproc.dev
-- 📦 Plugin Marketplace: https://plugins.mediaproc.dev
-- 💻 GitHub: https://github.com/0xshariq/mediaproc
+# Update plugins
+mediaproc update              # Update all
+mediaproc update <plugin>     # Update specific
 
----
+# Browse available plugins
+mediaproc plugins
+```
 
-## 💡 Examples
+## Examples
 
 ### Image Processing
 
 ```bash
-# Resize image
+# Resize for web
 mediaproc image resize photo.jpg --width 1920 --height 1080 --fit cover
 
-# Convert format
-mediaproc image convert photo.jpg --format webp --quality 85
+# Batch convert to WebP
+mediaproc image convert *.jpg --format webp --quality 85
 
-# Apply filter
-mediaproc image grayscale photo.jpg --output bw-photo.jpg
+# Create thumbnails
+mediaproc image thumbnail photo.jpg --size 256 --output thumb.jpg
 
-# Watermark
-mediaproc image watermark photo.jpg --text "© 2025" --position bottom-right
+# Add watermark
+mediaproc image watermark photo.jpg --text "© 2026" --position southeast
 
-# Batch processing
-for img in photos/*.jpg; do
-  mediaproc image convert "$img" --format webp --quality 85
-done
-````
+# Optimize for web
+mediaproc image optimize image.jpg --quality 80
+```
 
 ### Video Processing
 
 ```bash
 # Compress video
-mediaproc video compress large-video.mp4 --quality 80 --codec h264
+mediaproc video compress movie.mp4 --quality medium --output compressed.mp4
 
-# Transcode format
-mediaproc video transcode input.avi --format mp4
+# Convert to WebM
+mediaproc video transcode video.mp4 --format webm --codec vp9
 
-# Extract frames
-mediaproc video extract video.mp4 --fps 1 --format png
+# Cut segment
+mediaproc video trim long-video.mp4 --start 00:10:00 --end 00:15:00
 
-# Trim video
-mediaproc video trim video.mp4 --start 00:01:30 --end 00:02:45
+# Scale down
+mediaproc video resize 4k-video.mp4 --preset 1080p
 
-# Merge videos
-mediaproc video merge video1.mp4 video2.mp4 video3.mp4 --output combined.mp4
+# Extract audio
+mediaproc video extract movie.mp4 --type audio --output soundtrack.mp3
 ```
 
 ### Audio Processing
 
 ```bash
-# Convert format
-mediaproc audio convert song.wav --format mp3 --bitrate 320k
+# Convert to MP3
+mediaproc audio convert song.wav --format mp3 --quality 320k
 
 # Normalize volume
-mediaproc audio normalize podcast.mp3 --target -16
-
-# Extract audio from video
-mediaproc audio extract video.mp4 --format flac
+mediaproc audio normalize podcast.mp3 --target -16 --output normalized.mp3
 
-# Trim audio
-mediaproc audio trim song.mp3 --start 00:30 --end 03:45
-```
+# Merge tracks
+mediaproc audio merge intro.mp3 main.mp3 outro.mp3 --output complete.mp3
 
-### Pipeline Workflows
-
-```yaml
-# workflow.yaml
-name: "Optimize Images for Web"
-description: "Batch image optimization pipeline"
-
-steps:
-  - plugin: image
-    command: resize
-    options:
-      width: 1920
-      height: 1080
-      fit: contain
-
-  - plugin: image
-    command: convert
-    options:
-      format: webp
-      quality: 85
-
-  - plugin: image
-    command: optimize
-    options:
-      level: 9
-```
-
-```bash
-# Run pipeline
-mediaproc run workflow.yaml --input images/ --output optimized/
+# Extract from video
+mediaproc audio extract video.mp4 --format flac
 ```
 
-_Note: Image processing commands are **fully implemented and ready to use**! Video, audio, and other commands are planned for Q1-Q2 2026. See [Current Status](#-current-status) for details._
-
----
-
-## 🔧 Development
-
-### Setup Development Environment
+## CLI Commands
 
-```bash
-# Clone repository
-git clone https://github.com/0xshariq/mediaproc.git
-cd mediaproc
-
-# Install dependencies
-pnpm install
+### Plugin Management
+- `mediaproc add <plugin>` - Install plugin
+- `mediaproc remove <plugin>` - Uninstall plugin
+- `mediaproc list` - List installed plugins
+- `mediaproc plugins` - Browse available plugins
+- `mediaproc update [plugin]` - Update plugin(s)
 
-# Build all packages
-pnpm build
+### Help & Info
+- `mediaproc --help` - Show help
+- `mediaproc <plugin> --help` - Plugin-specific help
+- `mediaproc --version` - Show version
 
-# Link CLI globally
-pnpm link --global
+## Requirements
 
-# Run in dev mode (watch mode)
-pnpm dev
-```
+- **Node.js** >= 18.0.0
+- **FFmpeg** (for video/audio plugins)
+  ```bash
+  # macOS
+  brew install ffmpeg
+  
+  # Ubuntu/Debian
+  sudo apt install ffmpeg
+  
+  # Windows
+  choco install ffmpeg
+  ```
+
+## Development
 
 ### Project Structure
 
 ```
 mediaproc/
-├── src/                    # Core CLI source code
-│   ├── cli.ts             # Main entry point
-│   ├── plugin-manager.ts  # Plugin discovery & loading
-│   ├── plugin-registry.ts # Plugin name mapping
-│   ├── types.ts           # TypeScript types
-│   └── commands/          # Core commands
-│
-├── plugins/               # Plugin packages
-│   ├── image/            # Image processing plugin
-│   ├── video/            # Video processing plugin
-│   ├── audio/            # Audio processing plugin
-│   └── .../              # More plugins
-│
-├── docs/                  # Documentation
-├── bin/                   # Executable files
-├── CONTRIBUTING.md        # Contribution guidelines
-├── SECURITY.md           # Security policy
-├── CODE_OF_CONDUCT.md    # Community guidelines
-├── CHANGELOG.md          # Release history
-└── package.json          # Root package config
-```
-
-### Building
-
-```bash
-# Build all packages
-pnpm build
-
-# Build specific plugin
-pnpm --filter @mediaproc/image build
-
-# Clean build artifacts
-pnpm clean
-
-# Clean and rebuild
-pnpm clean && pnpm build
+├── src/              # Core CLI source
+├── plugins/          # Official plugins
+│   ├── image/       # Image processing
+│   ├── video/       # Video processing  
+│   └── audio/       # Audio processing
+├── docs/            # Documentation
+└── web/             # Documentation website
 ```
 
-### Testing
+### Build & Test
 
 ```bash
-# Run all tests (when implemented)
-pnpm test
-
-# Test specific plugin
-pnpm --filter @mediaproc/image test
-
-# Watch mode
-pnpm test --watch
-
-# Coverage
-pnpm test --coverage
-```
-
----
-
-## 🎨 Creating Your Own Plugins
-
-MediaProc welcomes third-party plugins! Anyone can create and publish plugins.
-
-### Quick Start
-
-```bash
-# Create plugin directory
-mkdir mediaproc-plugin-myprocessor
-cd mediaproc-plugin-myprocessor
-
-# Initialize
-npm init -y
-
 # Install dependencies
-npm install --save-peer @mediaproc/cli
-npm install --save-dev typescript @types/node
-npm install chalk commander ora
-```
-
-### Plugin Structure
-
-```typescript
-// src/index.ts
-import { Command } from "commander";
-
-export const name = "myprocessor";
-export const version = "1.0.0";
-export const description = "My custom processor";
-
-export function register(program: Command): void {
-  const cmd = program.command(name).description(description);
-
-  cmd
-    .command("process <input>")
-    .description("Process a file")
-    .option("-o, --output <path>", "Output path")
-    .action(async (input, options) => {
-      // Your processing logic
-      console.log("Processing:", input);
-    });
-}
-```
-
-### Publishing
-
-```bash
-# Build
-npm run build
-
-# Test locally
-npm link
-mediaproc myprocessor process test.jpg
-
-# Publish
-npm publish
-```
-
-### Getting Listed
-
-Submit your plugin to be featured in the plugin directory:
-
-1. Publish to npm
-2. Open an issue with [Plugin Submission] tag
-3. We'll review and list it!
-
-**Full Guide:** See [docs/plugin-system.md](docs/plugin-system.md) for complete plugin development guide, including:
-
-- Naming conventions
-- Required exports and structure
-- Quality standards
-- Submission process
-- Testing and best practices
-
----
-
-## 🗺️ Roadmap
-
-### Q1 2026 - Core Plugins
-
-- ✅ Complete image plugin implementation
-- ✅ Complete video plugin implementation
-- ✅ Complete audio plugin implementation
-- ✅ Performance optimization
-- ✅ Comprehensive testing
-- ✅ Beta release
-
-### Q2 2026 - Advanced Features
-
-- ✅ Document plugin (PDF processing)
-- ✅ Animation plugin (GIF optimization)
-- ✅ Metadata plugin
-- ✅ Pipeline workflows
-- ✅ Plugin marketplace launch
-
-### Q3 2026 - Specialized Plugins
-
-- ✅ 3D model optimization
-- ✅ Streaming (HLS/DASH)
-- ✅ GUI wrapper (Electron)
-- ✅ VS Code extension
-
-### Q4 2026 - AI & Future-Proof
-
-- ✅ AI-assisted features
-- ✅ Background removal
-- ✅ Auto-captioning
-- ✅ v1.0 stable release
-
-### 2027+ - Long-Term Vision
-
-- Cloud integration (S3, CDN)
-- Serverless function support
-- Enterprise features
-- Mobile SDK
-- WebAssembly support
-
-**Full Roadmap:** See [docs/upcoming-features.md](docs/upcoming-features.md) for detailed feature plans.
-
----
-
-## 🤝 Contributing
-
-We welcome contributions of all kinds! MediaProc is in active development and there are many ways to help:
-
-### Ways to Contribute
-
-- 🐛 **Report Bugs** - [Open an issue](https://github.com/0xshariq/mediaproc/issues/new?template=bug_report.md)
-- 💡 **Suggest Features** - [Start a discussion](https://github.com/0xshariq/mediaproc/discussions/new?category=ideas)
-- 📝 **Improve Docs** - Fix typos, add examples, clarify explanations
-- 🔧 **Write Code** - Implement features, fix bugs, optimize performance
-- 🧪 **Write Tests** - Improve test coverage
-- 🎨 **Create Plugins** - Build community plugins
-- 💬 **Help Others** - Answer questions in discussions
-- 🌟 **Spread the Word** - Star the repo, share on social media
-
-### Getting Started
-
-1. Read the [Contributing Guide](CONTRIBUTING.md)
-2. Check the [Code of Conduct](CODE_OF_CONDUCT.md)
-3. Look for [good first issues](https://github.com/0xshariq/mediaproc/labels/good%20first%20issue)
-4. Join discussions and ask questions
-5. Submit your first PR!
-
-### Development Workflow
-
-```bash
-# Fork and clone
-git clone https://github.com/YOUR_USERNAME/mediaproc.git
+pnpm install
 
-# Create branch
-git checkout -b feature/my-feature
+# Build CLI
+pnpm build
 
-# Make changes
-# ... edit files ...
+# Build all plugins
+pnpm build:all
 
-# Build and test
-pnpm build
+# Test
 pnpm test
 
-# Commit
-git commit -m "feat(image): add AVIF support"
-
-# Push and create PR
-git push origin feature/my-feature
+# Run locally
+node dist/cli.js
 ```
 
-**Full Guide:** See [CONTRIBUTING.md](CONTRIBUTING.md) for detailed contribution guidelines.
-
----
-
-## 👥 Community
-
-### Get Help & Connect
-
-- **💬 GitHub Discussions** - Ask questions, share ideas
-- **🐛 GitHub Issues** - Report bugs, request features
-- **📧 Email** - support@mediaproc.dev (coming soon)
-- **🐦 Twitter** - @mediaproc (coming soon)
-- **💬 Discord** - Join our community (coming soon)
-
-### Recognition
-
-Contributors are recognized in:
-
-- [CHANGELOG.md](CHANGELOG.md) - Release contributions
-- [GitHub Contributors](https://github.com/0xshariq/mediaproc/graphs/contributors) - Code contributions
-- Social media shoutouts
-- Plugin spotlights
-
----
-
-## 📄 License
+### Creating Plugins
 
-MediaProc is [MIT licensed](LICENSE).
+See [Plugin Integration Guide](docs/plugin-integration-guide.md) for complete documentation on creating your own plugins.
 
-```
-MIT License
+## Documentation
 
-Copyright (c) 2025 0xshariq and MediaProc contributors
-
-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...
-```
+- [Installation Guide](docs/configuration.md#installation)
+- [Plugin Integration Guide](docs/plugin-integration-guide.md)
+- [Plugin System Architecture](docs/plugin-system.md)
+- [Architecture Overview](docs/architecture-decisions.md)
+- [Contributing Guide](CONTRIBUTING.md)
+- [Code of Conduct](CODE_OF_CONDUCT.md)
 
-See [LICENSE](LICENSE) for full license text.
+**📚 Full Documentation:** [https://mediaproc.dev](https://mediaproc.dev)
 
----
+## Roadmap
 
-## 🙏 Acknowledgments
+**Current (v0.6.0-beta):**
+- ✅ Core CLI with plugin system
+- ✅ Image Plugin (51 commands)
+- ✅ Video Plugin (6 commands)
+- ✅ Audio Plugin (5 commands)
 
-MediaProc is built on top of amazing open-source projects:
+**Q1 2026:**
+- 🚧 Document Plugin
+- 🚧 Comprehensive testing
+- 🚧 CI/CD pipeline
 
-### Core Technologies
+**Q2 2026:**
+- 📋 Animation Plugin
+- 📋 Metadata Plugin
+- 📋 v1.0 Release
 
-- **[Sharp](https://sharp.pixelplumbing.com/)** - High-performance image processing (libvips)
-- **[FFmpeg](https://ffmpeg.org/)** - Complete multimedia framework
-- **[Commander.js](https://github.com/tj/commander.js)** - Node.js CLI framework
-- **[Chalk](https://github.com/chalk/chalk)** - Terminal string styling
-- **[Ora](https://github.com/sindresorhus/ora)** - Elegant terminal spinners
-- **[Execa](https://github.com/sindresorhus/execa)** - Better child_process
+**Q3-Q4 2026:**
+- 📋 3D Plugin
+- 📋 Stream Plugin  
+- 📋 AI Plugin
+- 📋 Plugin Marketplace
 
-### Inspiration
+See [Upcoming Features](docs/upcoming-features.md) for details.
 
-- **FFmpeg** - The gold standard for media processing
-- **Sharp** - Blazing fast image processing
-- **ImageMagick** - Comprehensive image manipulation
-- **Homebrew** - Plugin-like package management
-- **VS Code** - Extension architecture
+## Contributing
 
----
+We welcome contributions! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
 
-## 🌟 Star History
+**Ways to contribute:**
+- 🐛 Report bugs
+- 💡 Suggest features
+- 📝 Improve documentation
+- 🔧 Submit pull requests
+- 🎨 Create plugins
 
-If you find MediaProc useful, please consider giving it a star ⭐️
+## Community
 
-It helps us grow and shows appreciation for the work!
+- **Issues:** [GitHub Issues](https://github.com/0xshariq/mediaproc-cli/issues)
+- **Discussions:** [GitHub Discussions](https://github.com/0xshariq/mediaproc-cli/discussions)
+- **Twitter:** [@0xshariq](https://twitter.com/0xshariq)
 
----
+## License
 
-## 📞 Contact
+MIT © [0xshariq](https://github.com/0xshariq)
 
-- **Author**: [@0xshariq](https://github.com/0xshariq)
-- **Email**: support@mediaproc.dev (coming soon)
-- **Website**: https://mediaproc.dev (coming soon)
-- **Issues**: [GitHub Issues](https://github.com/0xshariq/mediaproc/issues)
-- **Discussions**: [GitHub Discussions](https://github.com/0xshariq/mediaproc/discussions)
-
----
-
-## ⚠️ Development Notice
-
-**MediaProc is under active development.**
-
-- API and commands may change before v1.0
-- Not recommended for production use yet
-- Feedback and contributions highly appreciated!
-- Expected stable release: Q4 2026
+See [LICENSE](LICENSE) for details.
 
 ---
 
 <div align="center">
 
-**Built with ❤️ by [@0xshariq](https://github.com/0xshariq) and [contributors](https://github.com/0xshariq/mediaproc/graphs/contributors)**
-
-[⬆ Back to Top](#mediaproc)
-
-</div>
-
----
-
-## 📖 Plugin Development
-
-### Creating Third-Party Plugins
-
-Want to extend MediaProc with your own functionality? Follow our comprehensive guide:
-
-**\ud83d\udcd8 [Plugin Integration Guide](docs/plugin-integration-guide.md)** - Complete step-by-step tutorial covering:
-
-- Quick start (5-minute plugin)
-- Plugin architecture explained
-- Step-by-step tutorial with real example
-- Plugin standards and requirements
-- Testing and debugging
-- Publishing to npm
-- Getting your plugin featured
-
-**Additional Resources:**
-
-- \ud83d\udcd6 [Plugin System Architecture](docs/plugin-system.md) - Deep dive into how plugins work
-- \ud83c\udfd7\ufe0f [Plugin Template](https://github.com/0xshariq/mediaproc-plugin-template) - Starter template (coming soon)
-- \ud83d\udcda [Example Plugins](https://github.com/0xshariq/mediaproc-examples) - Real-world examples (coming soon)
-
-### Plugin Ideas
-
-Need inspiration? Here are some plugin ideas:
-
-- **Filters** - Instagram-style filters, artistic effects
-- **Converters** - Specialized format conversions
-- **Social Media** - Platform-specific optimizations (Twitter, Facebook, Instagram)
-- **Analysis** - Media analysis, quality checking, metadata extraction
-- **Cloud Integration** - S3, Cloudinary, Imgur upload
-- **AI/ML** - Face detection, object recognition, style transfer
-- **Automation** - Batch processing, workflow templates
-
----
-
-## 📄 License
+**Built with ❤️ by [@0xshariq](https://github.com/0xshariq)**
 
-MediaProc is licensed under the **MIT License** - see the [LICENSE](LICENSE) file for details.
+Give us a ⭐️ if you find this project useful!
 
-### What This Means
-
-✅ **You CAN:**
-
-- Use MediaProc commercially
-- Modify the source code
-- Distribute your modifications
-- Use it privately
-- Contribute to the project
-
-⚠️ **You MUST:**
-
-- Include the original copyright notice
-- Include the license text
-- Give credit to **[@0xshariq](https://github.com/0xshariq)** (original author)
-
-❌ **We're NOT LIABLE:**
-
-- No warranty is provided
-- Authors are not liable for any damages
-
-### Attribution
-
-If you use MediaProc in your project, a mention would be appreciated:
-
-```
-Powered by MediaProc - https://github.com/0xshariq/mediaproc-cli
-Created by @0xshariq
-```
-
----
-
-## 👥 Credits
-
-**Created and maintained by:**
-
-- **[@0xshariq](https://github.com/0xshariq)** - Original Author & Lead Developer
-
-**Contributors:**
-See [CONTRIBUTORS.md](CONTRIBUTORS.md) for the list of amazing people who have contributed to this project.
-
-Want to be listed here? Check out our [Contributing Guide](CONTRIBUTING.md)!
-
----
+</div>