v1.0.0

🎉 MediaProc CLI v1.0.0 is Here

MediaProc has officially reached its first stable milestone. Version 1.0.0 represents a major step forward in reliability, structure, and usability.

This release focuses on stability, consistency, and foundational architecture rather than feature overload. The goal of v1 is to provide a predictable, professional-grade media processing CLI that can serve as the base for future automation and platform-level capabilities.

---

🧩 Core Highlights

✅ Stable Plugin Architecture

MediaProc now supports a modular plugin-based system where each plugin can operate:

• Standalone
• Through the main CLI interface

This allows flexible usage while keeping commands organized and extensible.

---

🖼️ Image Plugin (Production-Ready)

• 50+ image processing commands
• Batch processing support
• Reliable input/output validation
• Works smoothly with main CLI

---

🎥 Video Plugin (Stable Core Commands)

• Core video processing commands
• Improved file validation
• Stable execution via CLI

---

🔊 Audio Plugin (Stable Core Commands)

• Audio conversion and processing commands
• Input validation fixes
• Standalone + CLI compatibility

---

🧠 Explain Engine (v1 Base)

MediaProc introduces an advanced --explain flag that provides:

• Human-readable summaries

• Detailed technical explanations

• JSON mode for structured output

• Clear reporting of:

  • Inputs
  • Flags used
  • Decisions made
  • Effects
  • Expected outcomes

This improves transparency and makes MediaProc easier for both developers and non-technical users.

---

🧱 Improved Core Infrastructure

• Unified command handling
• Shared formatters
• Path validation system
• Structured error types and exit code design (core level)
• Cleaner internal architecture

---

🛠 Stability Focus

v1.0.0 is primarily a stability and structure release:

• Major command-breaking issues resolved
• Plugins verified with the main CLI
• Consistent behavior across commands
• Improved reliability over experimental versions

---

🔮 What’s Next

Future development will focus on:

• Pipeline workflows
• Metadata tools
• Document processing
• Deeper explain engine improvements
• Automation capabilities

But v1 establishes a strong, stable base before expansion.

v0.8.0

Added

• Explain Flag System Improvements:
  • Human and Details templates now guarantee no function source, NaN, null, or undefined is ever displayed—these are always shown as [function] or N/A for safety.
  • Output is more robust, readable, and safe for all CLI and plugin commands.
  • All output is sanitized and context-enriched (timestamp, user, platform, mode).
  • Improved test coverage for output safety and formatting.
• Add Explain Hook in Command runner (cli.ts)

Changed

• Template Rendering:
  • Human template now matches test and user expectations for output (plain or boxed as required, always safe values).
  • Details template uses the same value-safety logic as human template.

Fixed

• Output Safety:
  • No function source, NaN, null, or undefined is ever shown in any explain output.
  • All output is consistent and safe for end users and developers.

v0.7.0

[0.7.0] - 2026-01-14

Added

Documentation

• ✨ Universal Commands Documentation - Comprehensive guide for all CLI commands
  • Created /docs/universal-commands.md with 13+ universal commands
  • Updated web docs /web/content/cli/universal-commands.mdx with interactive components
  • Organized commands into 4 categories:
    • Plugin Management (add, remove, list, validate, update, detect)
    • Workflow & Automation (batch, template, workspace, watch)
    • Analysis & Statistics (history, stats, compare, benchmark)
    • Utilities (doctor, search, help)
  • Added best practices, examples, and workflow guides
  • Included exit codes reference and advanced usage tips

CLI Features

• ✨ CLI Branding System - Dynamic version display across all commands

  • Created /src/utils/branding.ts with dynamic version detection
  • Reads version from package.json automatically using import.meta.url
  • Added showBranding() footer to CLI commands:
    • doctor, search, history (all actions), batch, stats, compare, template, workspace, watch, benchmark
  • Displays MediaProc version, docs URL, and GitHub link
  • Styled with separators for clean output

• ✨ Plugin Branding System - Consistent branding for plugin commands

  • Created branding utilities in image, video, and audio plugins
  • Added showPluginBranding() to plugin commands:
    • Image: resize, convert, crop
    • Video: compress, trim
    • Audio: convert, normalize
  • Shows plugin name + version with "Powered by MediaProc" footer

Web Documentation

• ✨ Enhanced Search Functionality - Fixed and improved search component

  • Shows all pages on open (Ctrl+K / Cmd+K)
  • Real-time filtering as you type
  • Fuzzy search with relevance scoring
  • Keyboard navigation support (arrows, Enter, Escape)
  • Proper Next.js Link integration for navigation
  • Fixed onClick handler structure for proper routing

• ✨ Improved "On This Page" Navigation - Compact and clean TOC

  • Reduced line height matching LangChain style
  • Tighter spacing (space-y-0.5, py-1, py-0.5)
  • Added leading-tight for compact text
  • Better visual hierarchy for H2 and H3 headings

Improved

Documentation Structure

• 📚 Root README Enhancements

  • Organized documentation section into logical categories
  • Added references to all /docs folder markdown files:
    • Getting Started section
    • Plugin Development section (5 guides)
    • Architecture & Design section (2 docs)
    • Project Guidelines section (3 docs)
  • Updated documentation website URL to https://docs-mediaproc.vercel.app

• 📚 Web Documentation

  • Refactored root README from 1530 lines to ~320 lines (79% reduction)
  • Transformed web README to Next.js development guide
  • Added interactive grid cards for quick reference in universal commands
  • Color-coded sections with borders and callouts
  • Linked "See Also" cards for better navigation

Fixed

• 🐛 TypeScript Compilation Errors

  • Fixed async return type in benchmark.ts (Promise)
  • Removed unused imports across multiple command files
  • Fixed variable access before declaration in Search component
  • Resolved cascading render warning in useEffect

• 🐛 Search Component Issues

  • Fixed search not initializing when modal opens
  • Fixed onClick handler on Link component preventing navigation
  • Moved onClick to div wrapper for proper routing
  • Added setTimeout to avoid cascading renders in useEffect

Changed

• 🔄 Version Management - All version references now dynamic
  • CLI version pulled from root package.json (0.7.0)
  • Plugin versions pulled from respective package.json files
  • No more hardcoded version strings to update manually

v0.5.2-beta

📊 Current Status

Version: 0.5.2-beta
Status: ✅ Image plugin (51 commands) + ✅ Video plugin (6 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

✅ Architecture - Plugin system designed and implemented
✅ Core CLI - Command framework with plugin discovery
✅ Built-in Plugins - Image & Video plugins ship with CLI
✅ Plugin Registry - Smart plugin management
✅ Documentation - Comprehensive guides and standards
✅ Community Guidelines - Contributing, security, code of conduct

0.3.0 - Config System + Auto-Init + Enhanced Plugin Management

Major improvements to configuration and plugin management:

🏗️ Configuration System

• Global Config: Configuration now lives in ~/.mediaproc/config.json (not project-specific)
• Auto-initialization: Config is automatically created on first run
• Plugin Tracking: System now tracks installed and loaded plugins separately
• Better State Management: No more manual package.json scanning

🔧 Enhanced Commands

• mediaproc init: Initialize or reset configuration with --reset flag
• mediaproc config show: Beautiful display of config with plugin status
• mediaproc config path: Quickly find your config file location
• mediaproc config get <key>: Get specific config values

🎯 Improved Plugin Management

• Smart Detection: System automatically detects plugin installation/loading status
• Config Integration: Add/remove commands update config state automatically
• Status Indicators: Universal commands show plugin status (loaded/installed/not installed)
• Cleaner Architecture: Removed redundant plugin discovery logic

🐛 Bug Fixes

• Fixed unused variable warnings in plugin-manager
• Improved plugin prefix detection
• Better error handling in config operations
• Cleaner import statements

📝 Breaking Changes

• Config file moved from ./mediaproc.config.json to ~/.mediaproc/config.json
• Run mediaproc init to create new config structure
• Old project-level configs need manual migration (or just reinstall plugins)

0.2.0- Image Plugin with 40 commands + Universal convert/info/optimize commands

Image Plugin with 40 commands + Universal convert/info/optimize commands