myaidev-method 0.2.19 → 0.2.22

package/CHANGELOG.md

@@ -5,6 +5,121 @@ All notable changes to the MyAIDev Method package will be documented in this fil
 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.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 Agent**: Specialized agent for cloud orchestration
+    - VM provisioning with cloud-init support
+    - Multi-VM deployment patterns
+    - Network and storage configuration
+    - SSH key management
+  - **`/myai-openstack` Command**: Slash command 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
+  - **`/myai-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 <workflow>` - Add a workflow
+  - `npx myaidev-method@latest remove <workflow>` - 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
@@ -15,22 +130,25 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - **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
 
-### Testing
-- All existing tests pass (Gutenberg converter, installation)
-- Added PayloadCMS Lexical format validation tests
-- Verified list type, inline formatting, and link node generation
-
 ### 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
 

package/README.md

@@ -35,6 +35,7 @@ The **MyAIDev Method** is a complete development framework for AI CLI tools (Cla
 - [Development Agents](#development-agents)
 - [Content & Publishing Agents](#content--publishing-agents)
 - [Visual Content Generation](#visual-content-generation)
+- [OpenStack Integration](#openstack-integration)
 - [Slash Commands](#slash-commands)
 - [MCP Server Integration](#mcp-server-integration)
 - [Configuration](#configuration)
@@ -68,9 +69,9 @@ The **MyAIDev Method** is a complete development framework for AI CLI tools (Cla
 - **Git-Based Workflows**: Automated publishing for static site generators
 - **WordPress Admin Agent**: Security, performance, health monitoring, and administration
 
-### 🎨 Visual Content Generation (New in v0.2.14!)
-- **AI-Powered Image Generation**: Google Gemini 2.5 Flash, Imagen 3, OpenAI DALL-E 3
-- **AI-Powered Video Generation**: Google Veo 2 (up to 8 seconds, 720p)
+### 🎨 Visual Content Generation (Updated in v0.2.22!)
+- **AI-Powered Image Generation**: Google Gemini "Nano Banana" (SOTA), OpenAI GPT Image 1.5 (SOTA), Imagen 3, FLUX 2
+- **AI-Powered Video Generation**: Google Veo 3 (latest video generation)
 - **Multi-Platform Support**: Works with Claude Code, Gemini CLI, and Codex CLI
 - **Budget Management**: Daily/monthly limits, cost tracking, and warnings
 - **Smart Service Selection**: Automatic service selection based on content type
@@ -78,6 +79,29 @@ The **MyAIDev Method** is a complete development framework for AI CLI tools (Cla
 - **Cost-Effective**: Starting at $0.02/image (Gemini Flash)
 - **Organized Storage**: Automatic file organization by date in `content-assets/`
 
+### 🔒 Security Testing (New in v0.2.21!)
+**Professional security testing capabilities inspired by [Agent Zero](https://github.com/frdel/agent-zero)**
+- **PTES Methodology**: Full penetration testing execution standard implementation
+- **OSINT & Reconnaissance**: Comprehensive intelligence gathering and passive reconnaissance
+- **Web Application Security**: OWASP Top 10 testing and web application assessment
+- **Security Auditing**: Compliance validation (PCI-DSS, GDPR, HIPAA, SOC 2)
+- **Authorization-First**: Mandatory authorization system prevents unauthorized testing
+- **Environment Flexibility**: Native Linux, Kali Docker, or hybrid deployment
+- **Professional Reporting**: Executive summaries, technical findings, remediation guidance
+- **Legal Compliance**: Built-in warnings and ethical guidelines
+
+**⚠️ IMPORTANT**: Security testing requires explicit written authorization. All security operations must comply with applicable laws and regulations.
+
+### 🌩️ OpenStack Cloud Integration (New in v0.2.22!)
+**Complete cloud infrastructure orchestration for VM management and deployment**
+- **VM Lifecycle Management**: Create, start, stop, reboot, delete virtual machines
+- **Resource Discovery**: List images, flavors, networks, security groups, keypairs
+- **Network Configuration**: Floating IPs, IP assignment, security groups
+- **Storage Management**: Volumes, volume attachments
+- **Cloud-Init Support**: Automatic VM provisioning with cloud-init scripts
+- **Session Tracking**: Operation history and session management
+- **Interactive Setup**: Parse openrc files or manual credential entry
+
 ### 🚀 Deployment & Infrastructure
 - **Coolify Integration**: Self-hosted PaaS deployment and orchestration
 - **RamNode Optimized**: Deployment patterns optimized for RamNode.com infrastructure
@@ -95,9 +119,49 @@ The **MyAIDev Method** is a complete development framework for AI CLI tools (Cla
 [![npm version](https://badge.fury.io/js/myaidev-method.svg)](https://www.npmjs.com/package/myaidev-method)
 [![npm downloads](https://img.shields.io/npm/dt/myaidev-method.svg)](https://www.npmjs.com/package/myaidev-method)
 
-### ⚡ One-Command Installation
+### ⚡ Modular Installation (New in v0.2.19!)
+
+**Install only what you need!** MyAIDev Method now supports modular workflow installation:
+
+```bash
+# Content creation only
+npx myaidev-method@latest content --claude
+
+# Development workflow only (SPARC)
+npx myaidev-method@latest dev --claude
+
+# WordPress publishing
+npx myaidev-method@latest publish --wordpress
+
+# Visual content generation
+npx myaidev-method@latest visual --claude
+
+# Security testing (NEW in v0.2.21!)
+npx myaidev-method@latest security --pentest     # Penetration testing
+npx myaidev-method@latest security --audit       # Security auditing
+npx myaidev-method@latest security --webapp      # Web app security
+npx myaidev-method@latest security --all         # All security workflows
+
+# Complete installation (all workflows)
+npx myaidev-method@latest init --claude
+```
+
+**See [MODULAR_INSTALLATION.md](MODULAR_INSTALLATION.md) for complete guide**
+
+### 💡 Quick Installation Examples
+
+**Content Creator:**
+```bash
+npx myaidev-method@latest content --claude
+npx myaidev-method@latest add publish-wordpress
+```
 
-**No setup required!** Install and configure in your project directory with a single command:
+**Software Developer:**
+```bash
+npx myaidev-method@latest dev --claude
+```
+
+**Full Installation (Backward Compatible):**
 
 ```bash
 # For Claude Code (most popular)
@@ -572,12 +636,17 @@ Self-hosted PaaS deployment for applications.
 
 ## 🎨 Visual Content Generation
 
-**New in v0.2.14!** Generate AI-powered images and videos for your content using Google AI (Gemini, Imagen, Veo) and OpenAI (DALL-E) services.
+**Updated in v0.2.22!** Generate AI-powered images and videos using state-of-the-art models.
+
+### Recommended SOTA Models
+
+- **Google Gemini 3.0 Pro Image ("Nano Banana")**: Fast, cost-effective at $0.02/image - great for high volume
+- **OpenAI GPT Image 1.5**: Best quality, best text rendering, $0.02-$0.19/image depending on quality tier
 
 ### Features
 
-- **Image Generation**: Google Gemini 2.5 Flash ($0.02), Imagen 3 ($0.03), DALL-E 3 ($0.04-0.12)
-- **Video Generation**: Google Veo 2 ($0.10 for up to 8 seconds, 720p)
+- **Image Generation**: Gemini "Nano Banana" ($0.02), OpenAI GPT Image 1.5 ($0.02-$0.19), Imagen 3 ($0.03), FLUX 2 ($0.025-$0.05)
+- **Video Generation**: Google Veo 3 ($0.40/second - latest video generation)
 - **Multi-Platform**: Works with Claude Code, Gemini CLI, and Codex CLI
 - **Budget Management**: Daily/monthly limits, cost tracking, and warnings
 - **Smart Organization**: Automatic file storage by date in `content-assets/`
@@ -596,7 +665,8 @@ Self-hosted PaaS deployment for applications.
 
 2. **Follow the interactive wizard** to set up:
    - Google AI API key (for Gemini, Imagen, Veo)
-   - OpenAI API key (for DALL-E)
+   - OpenAI API key (for GPT Image 1.5)
+   - Fal.ai API key (for FLUX 2)
    - Default service preference
    - Daily and monthly budget limits
 
@@ -633,10 +703,15 @@ npm run configure:visual
 
 | Service | Speed | Cost | Quality | Best For |
 |---------|-------|------|---------|----------|
-| **Gemini 2.5 Flash** | ⚡⚡⚡ | $0.02 | Good | Quick hero images, diagrams, high volume |
-| **Imagen 3** | ⚡⚡ | $0.03 | Excellent | Premium hero images, high-quality visuals |
-| **DALL-E 3** | ⚡⚡ | $0.04-0.12 | Excellent | Creative illustrations, detailed designs |
-| **Veo 2** | ⚡ | $0.10 | Good | Product demos, short videos |
+| **Gemini "Nano Banana"** ⭐ | ⚡⚡⚡ | $0.02 | Good | Quick hero images, diagrams, high volume (SOTA) |
+| **OpenAI GPT Image 1.5** ⭐ | ⚡⚡ | $0.02-$0.19 | Outstanding | Best text rendering, highest quality (SOTA) |
+| **Imagen 3** | ⚡⚡ | $0.03 | Excellent | Premium hero images, photorealistic |
+| **FLUX 2 Pro** | ⚡⚡⚡ | $0.05 | Outstanding | Fast quality, typography, multi-reference |
+| **FLUX 2 Flex** | ⚡⚡ | $0.04 | Outstanding | Developer control, custom parameters |
+| **FLUX 2 Dev** | ⚡⚡⚡ | $0.025 | Excellent | Cost-effective, 32B open-weight model |
+| **Veo 3** | ⚡ | $0.40/sec | Outstanding | Premium video content, latest features |
+
+⭐ = Recommended SOTA (State-of-the-Art) models
 
 ### Image Types
 
@@ -675,6 +750,123 @@ For comprehensive documentation, see:
 - **VISUAL_GENERATION_FILE_ORGANIZATION.md** - File structure details
 - **CONTENT_CREATION_GUIDE.md** - Content workflow integration
 
+## 🌩️ OpenStack Integration
+
+**New in v0.2.22!** Complete OpenStack cloud management for spinning up VMs, managing infrastructure, and orchestrating deployments.
+
+### Features
+
+- **VM Lifecycle Management**: Create, start, stop, reboot, delete virtual machines
+- **Resource Discovery**: List available images, flavors, networks, security groups, keypairs
+- **Network Configuration**: Create and assign floating IPs, manage security groups
+- **Storage Management**: Create volumes and attach to servers
+- **Cloud-Init Support**: Automatic VM provisioning with cloud-init scripts
+- **Session Management**: Track operations and maintain session state
+
+### Setup
+
+1. **Configure OpenStack credentials**:
+   ```bash
+   /myai-configure openstack
+   ```
+
+2. **Follow the interactive wizard** to:
+   - Parse existing openrc file (recommended), or
+   - Enter credentials manually
+   - Test connection
+   - Set default cloud-init URL (optional)
+
+### Usage
+
+```bash
+# Check connectivity
+/myai-openstack health
+
+# Discover available resources
+/myai-openstack images
+/myai-openstack flavors
+/myai-openstack networks
+/myai-openstack keypairs
+
+# Create a VM
+/myai-openstack create myvm --image "Ubuntu 22.04" --flavor m1.small --keypair mykey
+
+# Create VM with cloud-init
+/myai-openstack create myvm --image "Ubuntu 22.04" --flavor m1.small --use-default-cloud-init
+
+# Create VM with custom cloud-init URL
+/myai-openstack create myvm --image "Ubuntu 22.04" --flavor m1.small --cloud-init-url "https://gist.github.com/user/abc123"
+
+# List all VMs
+/myai-openstack list
+
+# Show VM details
+/myai-openstack show myvm
+
+# Manage VM lifecycle
+/myai-openstack start myvm
+/myai-openstack stop myvm
+/myai-openstack reboot myvm
+/myai-openstack delete myvm
+
+# Assign floating IP
+/myai-openstack floating-ip create external-network
+/myai-openstack floating-ip add myvm 203.0.113.10
+
+# Cloud-init management
+/myai-openstack cloud-init info
+/myai-openstack cloud-init preview
+```
+
+### Cloud-Init Support
+
+Cloud-init enables automatic VM provisioning. Sources (in priority order):
+
+1. **Inline content** (`--user-data`): Direct YAML content
+2. **URL** (`--cloud-init-url`): Fetch from any URL (GitHub Gist supported)
+3. **File** (`--cloud-init-file`): Local file path
+4. **Default** (`--use-default-cloud-init`): Uses `CLOUD_INIT` from `.env`
+
+**Example cloud-init script:**
+```yaml
+#cloud-config
+package_update: true
+packages:
+  - docker.io
+  - nodejs
+users:
+  - name: developer
+    groups: [sudo, docker]
+    ssh_authorized_keys:
+      - ssh-rsa AAAA... your-key
+runcmd:
+  - systemctl enable docker
+```
+
+### Environment Variables
+
+```bash
+# Required OpenStack credentials
+OS_AUTH_URL=https://cloud.example.com:5000/v3
+OS_USERNAME=your-username
+OS_PASSWORD=your-password
+OS_PROJECT_ID=your-project-id
+OS_REGION_NAME=RegionOne
+
+# Optional
+OS_USER_DOMAIN_ID=default
+OS_PROJECT_DOMAIN_ID=default
+OS_IDENTITY_API_VERSION=3
+CLOUD_INIT=https://gist.github.com/user/cloud-init-script
+```
+
+### 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
+
 ## 🎯 Slash Commands
 
 ### `/myai-content-writer`

package/TECHNICAL_ARCHITECTURE.md

@@ -348,14 +348,76 @@ class PayloadCMSUtils {
 Markdown Token → Lexical Node Mapping:
   heading → { type: 'heading', tag: 'h1-h6', children: [...] }
   paragraph → { type: 'paragraph', children: [...] }
-  list (ordered) → { type: 'number', listType: 'number', children: [...] }
-  list (unordered) → { type: 'bullet', listType: 'bullet', children: [...] }
+  list (ordered) → { type: 'list', listType: 'number', tag: 'ol', children: [...] }
+  list (unordered) → { type: 'list', listType: 'bullet', tag: 'ul', children: [...] }
   code → { type: 'code', language: 'lang', children: [...] }
   blockquote → { type: 'quote', children: [...] }
   hr → { type: 'horizontalrule', version: 1 }
   text → { type: 'text', text: '...', format: 0 }
 ```
 
+**Note**: As of v0.2.19, list nodes use `type: 'list'` (spec-compliant) instead of `type: 'bullet'/'number'`.
+
+**Inline Formatting** (v0.2.19+):
+```javascript
+Format Codes (bitwise flags):
+  0   → Plain text
+  1   → Bold (**text**)
+  2   → Italic (*text*)
+  3   → Bold + Italic (***text***)
+  4   → Strikethrough (~~text~~)
+  8   → Underline
+  16  → Code (`text`)
+  32  → Subscript
+  64  → Superscript
+  128 → Highlight
+
+Examples:
+  **bold**              → { type: 'text', text: 'bold', format: 1 }
+  *italic*              → { type: 'text', text: 'italic', format: 2 }
+  `code`                → { type: 'text', text: 'code', format: 16 }
+  [link](url)           → { type: 'link', url: 'url', children: [...] }
+```
+
+**Lexical Validation** (v0.2.19+):
+
+The PayloadCMS utils now include comprehensive validation methods:
+
+```javascript
+// Validate complete Lexical structure
+const validation = utils.validateLexicalStructure(lexicalJSON, {
+  strict: false,        // Warn on unknown node types
+  strictFormat: false   // Validate format codes
+});
+
+// Returns: { valid: boolean, errors: [], warnings: [] }
+
+// Validate individual format codes
+const formatInfo = utils.validateFormatCode(3); // Bold + Italic
+// Returns: {
+//   valid: true,
+//   format: 3,
+//   flags: ['BOLD', 'ITALIC'],
+//   description: 'BOLD + ITALIC'
+// }
+```
+
+**Validation Rules**:
+- Root must have `type: 'root'` and `children` array
+- Headings must have `tag: 'h1'` through `'h6'`
+- Lists must have `listType: 'bullet'|'number'|'check'` and `tag: 'ul'|'ol'`
+- List children must be `listitem` nodes
+- Text nodes must have `text` (string) and `format` (number 0-255)
+- Links must have `url` (string) and `children` array
+- Format codes must be valid bitwise combinations (0-255)
+
+**Testing Coverage** (v0.2.19+):
+- 26 comprehensive conversion tests
+- 23 validation method tests
+- 9 integration tests with real-world examples
+- Performance tested with 100+ paragraph documents
+- TECHNICAL_ARCHITECTURE.md compliance verified
+
 ### 3. Static Site Utility (src/lib/static-site-utils.js)
 
 **Purpose**: Unified publishing for git-based static site generators.