# Changelog All notable changes to the MyAIDev Method package will be documented in this file. The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). ## [0.3.2] - 2026-02-05 ### Fixed - Fix CLI version string (was showing 0.2.25 instead of actual version) ## [0.3.1] - 2026-02-03 ### Fixed - Fix `init` command crash caused by unescaped backtick in CLAUDE.md template - Update installation tests from legacy commands/agents to skills-based architecture ## [0.3.0] - 2026-02-03 ### Added - **🧩 Skills-Based Architecture**: Migrated from legacy templates to a discoverable skills system - 24 skills in `skills/` directory, each self-contained and discoverable - Runtime scripts in `.myaidev-method/` for clean project separation - Backward compatible: existing methods and workflows continue to work alongside new skills - **đŸĒ Addon Marketplace**: CLI commands for community skill ecosystem - `install` - Install skills from the marketplace - `list` - List installed or available skills - `search` - Search the marketplace for skills - `remove` - Uninstall a skill - `publish` - Publish your own skills to the marketplace - **📤 Skill Contribution Pipeline**: PR-based review system for community skill submissions - `addon submit` - Fork marketplace repo, validate, and create PR for review - `addon validate` - Run comprehensive validation on local SKILL.md files - `addon status` - Check submission review status - `skill-contributor` skill - Guided creation and submission inside Claude Code sessions - `skill-validator.js` - Validation engine (frontmatter, content structure, security scanning, size limits) - **🔐 CLI Authentication**: Secure identity for marketplace interactions - `login` - Authenticate with the MyAIDev platform - `logout` - Clear local credentials - `whoami` - Show current authenticated user - Auth helper for marketplace API requests - **🔧 Utilities** - HTML conversion utilities for content processing ### Changed - Architecture refactored from monolithic templates to modular skills - CLI restructured around skills discovery and marketplace commands ## [0.2.22] - 2025-12-18 ### Added - **🌩ī¸ OpenStack VM Management Integration**: Complete cloud infrastructure orchestration - **OpenStack MCP Server**: 26 tools for comprehensive VM and cloud management - VM lifecycle: create, list, show, delete, start, stop, reboot, console - Resource discovery: images, flavors, networks, security groups, keypairs - Networking: floating IPs, IP assignment to servers - Storage: volumes, volume attachments - Session tracking and operation history - **openstack-vm-manager Skill**: Specialized skill for cloud orchestration - VM provisioning with cloud-init support - Multi-VM deployment patterns - Network and storage configuration - SSH key management - **`/openstack-manager` Skill**: Skill for VM operations - `health` - Check OpenStack connectivity - `images`, `flavors`, `networks` - Resource discovery - `create`, `list`, `show`, `delete` - VM management - `floating-ip create/add` - Network configuration - `cloud-init info/fetch/preview` - Cloud-init management - **`/configure openstack`**: Interactive credential setup - Parse existing openrc files automatically - Manual credential entry option - Connection testing and validation - Cloud-init default URL configuration - **☁ī¸ Cloud-Init Support**: Automatic VM provisioning - URL-based cloud-init (GitHub Gist URLs auto-converted to raw) - File-based cloud-init from local paths - Inline cloud-init content - Default cloud-init from `CLOUD_INIT` environment variable - Priority system: inline > URL > file > default ### Changed - **Visual Generation**: Updated image generation services - **🎨 OpenAI GPT Image 1.5** (SOTA Recommended): State-of-the-art image generation - Best-in-class text rendering in images - Multiple quality tiers: low ($0.02), medium ($0.07), high ($0.19) - Transparency support (PNG with transparent backgrounds) - Multiple output formats: PNG, JPEG, WebP - Sizes: 1024x1024, 1536x1024, 1024x1536, auto - **FLUX 2 Models**: Added Black Forest Labs FLUX 2 (Pro, Flex, Dev) - FLUX 2 Pro: $0.05/image - State-of-the-art quality, fastest - FLUX 2 Flex: $0.04/image - Developer-controlled parameters - FLUX 2 Dev: $0.025/image - 32B open-weight model - **Multi-Reference Support**: FLUX 2 supports up to 10 reference images - **Legacy FLUX**: FLUX 1.x models still available for backwards compatibility - Removed DALL-E 3 in favor of FLUX 2 and OpenAI GPT Image models ### Recommended SOTA Models - **Google Gemini 3.0 Pro Image ("Nano Banana")**: Fast, cost-effective at $0.02/image - **OpenAI GPT Image 1.5**: Best quality, best text rendering, $0.02-$0.19/image depending on quality tier ### Documentation - Updated CLAUDE.md with OpenStack integration documentation - Added comprehensive VM management examples - Cloud-init configuration guide with examples ### Use Cases - **Content Deployment**: Spin up VMs for content testing and preview - **Development Environments**: Create dev/test infrastructure on demand - **CI/CD Runners**: Deploy CI/CD runners and test infrastructure - **Production Deployments**: Provision production application servers ## [0.2.20] - 2025-11-20 ### Added - **🎉 Modular Workflow Installation**: Install only the components you need - `npx myaidev-method@latest content --claude` - Content creation only - `npx myaidev-method@latest dev --claude` - Development workflow (SPARC) - `npx myaidev-method@latest visual --claude` - Visual content generation - `npx myaidev-method@latest publish --wordpress` - WordPress publishing - `npx myaidev-method@latest publish --payloadcms` - PayloadCMS publishing - `npx myaidev-method@latest publish --static` - Static site publishing - `npx myaidev-method@latest deploy --coolify` - Coolify deployment - **Workflow Management Commands**: - `npx myaidev-method@latest list` - List installed workflows - `npx myaidev-method@latest status` - Show installation status - `npx myaidev-method@latest add ` - Add a workflow - `npx myaidev-method@latest remove ` - Remove a workflow - **Workflow Configuration System**: - `src/config/workflows.js` - Complete workflow definitions (9 workflows) - `src/lib/workflow-installer.js` - Modular installation engine - `.myaidev-manifest.json` - Installation tracking manifest - Automatic dependency resolution (e.g., `publish-wordpress` auto-installs `core` + `content`) - **Documentation**: - `MODULAR_INSTALLATION.md` - Comprehensive modular installation guide - Updated README.md with modular installation examples - Use case guides for different user types ### Changed - **CLI Commands**: - `init --claude` remains backward compatible (installs all workflows) - New modular commands reduce installation size for focused use cases - Support for `--dry-run` and `--verbose` flags on all commands ### Benefits - ✅ **Smaller installations**: Install only what you need (e.g., content creators don't need dev workflow) - ✅ **Faster setup**: Reduced file copying and dependency installation - ✅ **Cleaner projects**: Fewer unused commands, agents, and scripts - ✅ **Better organization**: Clear separation of workflows and dependencies - ✅ **Easier management**: Add/remove workflows as needs change - ✅ **Backward compatible**: Existing `init --claude` works exactly as before ### Use Cases - **Content Creator**: `content` + `publish-wordpress` (minimal installation) - **Software Developer**: `dev` only (24 SPARC commands, no publishing) - **Visual Content Creator**: `content` + `visual` + `publish-wordpress` - **Full Stack Developer**: `dev` + `deploy` (development + deployment, no content) - **Everything**: `init --claude` (backward compatible, all workflows) ## [0.2.19] - 2025-11-19 ### Fixed - **PayloadCMS Lexical Format**: Critical fixes for proper PayloadCMS Lexical editor compatibility - **List Type Bug**: Changed list `type` from `'bullet'/'number'` to `'list'` (spec-compliant) - **Inline Formatters**: Implemented markdown formatting support for bold (**text**), italic (*text*), and code (`text`) - **Link Support**: Added proper link node generation for markdown links [text](url) - **Space Token Filter**: Filter out space tokens to prevent incorrect paragraph generation between lists - Format codes follow Lexical specification: Bold=1, Italic=2, Code=16, combinations via bitwise addition ### Added - **Comprehensive Testing**: 58 new tests for PayloadCMS Lexical converter - 26 comprehensive conversion tests (all node types, formatters, edge cases) - 23 validation method tests (validateLexicalStructure, validateFormatCode) - 9 integration tests (real-world examples, documentation compliance) - Total test suite: 77 tests (10 Gutenberg + 9 installation + 58 PayloadCMS) ### Changed - **Health Check Endpoint**: Updated from `/api` to `/api/posts?limit=1` for better connectivity verification - Now verifies both API accessibility AND database connectivity - More meaningful health indicator for PayloadCMS instances ### Benefits - ✅ Content published to PayloadCMS now displays correctly with proper formatting - ✅ Lists render as actual ordered/unordered lists (not as numbered text) - ✅ Bold, italic, and code markdown formatters work as expected - ✅ Links are properly rendered as clickable hyperlinks - ✅ Health checks provide more accurate connectivity status - ✅ Comprehensive test coverage ensures format correctness ## [0.2.18] - 2025-11-19 ### Changed - **Init Command**: Automatic content-rules.md creation and streamlined documentation - Creates `content-rules.md` in project root automatically if it doesn't exist - Copies from `content-rules.example.md` template during `init --claude` - Streamlined documentation: Only copies USER_GUIDE.md, DEV_WORKFLOW_GUIDE.md, PUBLISHING_GUIDE.md - Removed redundant docs (MCP_INTEGRATION, COOLIFY_DEPLOYMENT, WORDPRESS_ADMIN_SCRIPTS, TECHNICAL_ARCHITECTURE) - Updated CLAUDE.md to document content-rules.md customization - Shows helpful message when content-rules.md is created or already exists ### Benefits - ✅ Users get content-rules.md automatically without manual copying - ✅ Cleaner project directory with only essential documentation - ✅ content-rules.md ready to customize immediately after init - ✅ Respects existing content-rules.md files (won't overwrite) ## [0.2.17] - 2025-11-19 ### Added - **Custom Content Rules**: content-rules.md support for customizable content generation - content-writer agent now checks for `content-rules.md` in project root - Apply custom brand voice, formatting, SEO guidelines without modifying agents - Gracefully continues if file doesn't exist (backward compatible) - Added comprehensive `content-rules.example.md` template with examples - Includes brand voice, formatting preferences, SEO requirements, required elements ### Changed - **Content Writer Agent**: Enhanced with Phase 0 for loading custom rules - Documented content-rules.md usage and examples - Merged custom rules with default best practices - Instructions for checking and applying custom rules ### Documentation - **README.md**: Added "Content Writer Custom Rules" section with quick start - **USER_GUIDE.md**: Added "Customizing Content Generation (Recommended)" best practices - **package.json**: Added content-rules.example.md to published files ### Benefits - ✅ No agent modification required for customization - ✅ Preserves agent updates when upgrading MyAIDev Method - ✅ Easy to version control (commit content-rules.md to git) - ✅ Project-specific customization - ✅ Backward compatible (works without file) ### Testing - Verified with content-rules.md: Applied custom rules (emoji, Quick Takeaways, author signature) - Verified without content-rules.md: Used default professional standards - Both scenarios work correctly ## [0.2.16] - 2025-11-19 ### Fixed - **Package Publishing**: Removed `.claude/` from published npm package - `.claude/` folder is for local development/testing only - Users get proper setup via `npx myaidev-method@latest init --claude` - Reduces package size and prevents settings.local.json from being distributed - Templates correctly published from `skills/` ### Added - **Fal.ai Integration**: Hybrid provider strategy for premium models - Added `@fal-ai/client` dependency for Fal.ai API access - `generateImageFal()` function for FLUX models (Pro v1.1 Ultra, Dev) - `generateVideoFal()` function for Veo 3 video generation - Auto-provider selection (uses direct APIs when cheaper, Fal.ai for exclusives) - Support for FLUX Pro ($0.06/image), FLUX Dev ($0.025/MP) - Support for Veo 3 ($0.40/second), Veo 3 Fast - FAL_KEY environment variable configuration ### Changed - **Visual Generation**: Enhanced provider ecosystem - Updated pricing constants with Fal.ai models - Enhanced `getServiceInfo()` with FLUX and Veo 3 details - Updated `generateImage()` to support FLUX services - `.env.example` updated with FAL_KEY and hybrid strategy documentation - Hybrid strategy: Direct APIs primary (cost-effective), Fal.ai for premium/exclusive models ### Strategy - **Cost Optimization**: Use direct APIs for better pricing (Gemini $0.02 vs Fal $0.0398) - **Premium Access**: Use Fal.ai for FLUX (artistic) and Veo 3 (latest video) - **Fallback**: Fal.ai available when direct APIs are rate-limited ## [0.2.15] - 2025-11-19 ### Added - **Vertex AI Integration**: Full OAuth2 support for Google Cloud Vertex AI - Implemented OAuth2 Bearer token authentication with `google-auth-library` - Added `getVertexAIToken()` function for automatic token management - Updated Imagen 4 integration to use Vertex AI endpoints - Support for both service account and Application Default Credentials (ADC) - Comprehensive setup documentation in GOOGLE_API_ENDPOINTS.md ### Changed - **Visual Generation**: Enhanced Google API support - Imagen now uses Vertex AI (imagen-4.0-generate-001) with OAuth2 authentication - Updated Gemini Nanobanana (Gemini 2.5 Flash Image) endpoint - Veo 2 video generation support - Updated .env.example with Vertex AI configuration options ### Dependencies - Added `google-auth-library` for OAuth2 authentication (36 packages) ### Documentation - Created GOOGLE_API_ENDPOINTS.md with complete Vertex AI setup guide - Updated .env.example with clear instructions for both Google AI API and Vertex AI - Documented service account creation and API enablement steps - Added alternative ADC setup instructions for development workflows ## [0.2.13] - 2025-11-13 ### Added - **Content Production Workflow**: Complete batch content processing system - `content-production-coordinator` skill - Orchestrates end-to-end content production pipeline - `proprietary-content-verifier` skill - Validates content uniqueness and quality - `/content-production-coordinator` skill - CLI skill for coordinated content production - Parallel processing for verification and publishing (dramatic efficiency gains) - Automated content categorization (Ready for Publishing / Needs Review) - Timestamped reports for audit trail and review - User confirmation checkpoints before verification and publishing - **Content Quality Gates**: Systematic verification before publishing - Knowledge redundancy assessment (High/Medium/Low/Minimal) - AI-generated content detection - Unique value identification - Actionable recommendations for improvement - **Coordinator Pattern**: First agent that orchestrates other agents - Foundation for future multi-agent workflows - Enables complex multi-step automated processes - Maintains clear separation of concerns ### Changed - CLAUDE.md template updated with content production workflow documentation - bin/cli.js updated with new agents and commands in installation template - Enhanced skill architecture with coordinator pattern ### Documentation - Added comprehensive feature analysis in claudedocs/content-production-feature-analysis.md - Updated CLAUDE.md with Content Production Workflow section - Documented use cases: content marketing agencies, SEO production, documentation teams - Migration path guidance for existing users ### Technical - Zero new dependencies required - Compatible with existing infrastructure - Works with all existing publishing platforms (WordPress, PayloadCMS, etc.) - Package size impact: +3 files (~2.5KB markdown) ## [0.2.12] - 2025-11-10 ### Added - **Update Command**: `npx myaidev-method@latest update` for intelligent component updates - Interactive conflict resolution for modified files - Automatic backup creation before updates - Dry-run mode to preview changes - Force mode for clean updates - Version tracking with `.claude/.myaidev-version` - Updates all components: commands, agents, scripts, libs, docs, MCP configs - Comprehensive update documentation in USER_GUIDE.md - Update instructions in README.md - CHANGELOG.md for version history tracking ### Changed - Init command now saves installation version for update tracking - Enhanced documentation with update best practices ## [0.2.11] - 2025-11-10 ### Fixed - Script installation for non-Node.js projects - Scripts now installed to `.myaidev-method/` with self-contained dependencies - No longer requires Node.js project structure (package.json in root) - Works in any project type (WordPress themes, Hugo sites, plain folders) - Agent documentation updated to reference `.myaidev-method/` paths ### Changed - Scripts copied to `.myaidev-method/scripts/` directory - Libraries copied to `.myaidev-method/lib/` directory - Dependencies installed locally in `.myaidev-method/node_modules/` - Added `.gitignore` guidance in CLAUDE.md template ## [0.2.10] - 2025-11-06 ### Changed - ⚠ī¸ **Deprecated approach**: Attempted node_modules path (reverted in v0.2.11) ## [0.2.9] - 2025-11-06 ### Added - User Pathways section in USER_GUIDE.md - Content Creator pathway with complete publishing pipeline - Developer pathway with SPARC methodology guidance - End-to-end workflow examples ### Changed - Enhanced documentation structure - Improved onboarding experience ## [0.2.8] - 2025-11-06 ### Changed - Package documentation distribution updates - Fixed package.json files array ## [0.2.7] - 2025-11-06 ### Added - Comprehensive content creation pipeline examples - Multi-platform publishing workflows ## [0.2.6] - 2025-11-05 ### Changed - Documentation updates and improvements ## [0.2.5] - 2025-11-04 ### Added - PayloadCMS authentication simplification - JWT-based authentication for PayloadCMS - Improved publishing workflows ## [0.2.4] - 2025-11-03 ### Added - Skill fixes and improvements - 14 skill updates with proper Task tool invocations ## [0.2.3] - 2025-11-02 ### Added - Enhanced MCP server integration - SPARC orchestrator improvements ## [0.2.2] - 2025-11-01 ### Added - WordPress admin utilities - Security scanning scripts - Performance checking tools ## [0.2.1] - 2025-10-31 ### Added - Coolify deployment integration - Multi-platform publishing support ## [0.2.0] - 2025-10-30 ### Added - SPARC methodology implementation - Development workflow agents - Git & CI/CD workflows ## [0.1.0] - 2025-10-29 ### Added - Initial release - Content writer agent - WordPress publishing integration - Basic skills - MCP server foundation --- ## Release Notes ### Version 0.2.12 Highlights **Major Feature: Update Command** The highlight of this release is the new intelligent update system. Users can now easily keep their MyAIDev Method installation current while preserving customizations: ```bash npx myaidev-method@latest update --claude ``` Key features: - Interactive conflict resolution - choose what to update - Automatic backups - safe rollback if needed - Dry-run mode - preview changes first - Version tracking - know what version you're running This solves a major pain point where users had to manually track updates or risk losing customizations by re-running init. ### Migration Guide **From v0.2.10 or earlier to v0.2.12**: 1. Your scripts are now in `.myaidev-method/` instead of `node_modules/` 2. If you have any custom scripts referencing the old path, update them 3. Add `.myaidev-method/node_modules/` to your `.gitignore` 4. Use the new update command going forward instead of re-running init **Checking Your Version**: ```bash cat .claude/.myaidev-version ``` **First-Time Update Setup**: If you installed before v0.2.12, the version file won't exist. The update command will still work, but it won't know your current version. Consider it an upgrade from "unknown" to v0.2.12. --- For more details on any release, see the [commit history](https://github.com/myaione/myaidev-method/commits/master) or [release notes](https://github.com/myaione/myaidev-method/releases).