myaidev-method 0.2.17 → 0.2.19

package/CHANGELOG.md

@@ -5,6 +5,50 @@ 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.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
+
+### 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
+
+## [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

package/bin/cli.js

@@ -321,10 +321,16 @@ COOLIFY_API_KEY=your-api-key
 ## Documentation
 
 - **USER_GUIDE.md** - Getting started and customization
+- **DEV_WORKFLOW_GUIDE.md** - SPARC development workflow and best practices
 - **PUBLISHING_GUIDE.md** - Comprehensive multi-platform publishing guide
-- **COOLIFY_DEPLOYMENT.md** - Application deployment guide
-- **WORDPRESS_ADMIN_SCRIPTS.md** - WordPress admin utilities
-- **TECHNICAL_ARCHITECTURE.md** - Developer and architecture guide
+
+## Content Customization
+
+- **content-rules.md** - Customize content generation rules for the content-writer agent
+  - Define brand voice, tone, and style preferences
+  - Set formatting guidelines and SEO requirements
+  - Specify required/optional content elements
+  - See the file for comprehensive customization options
 
 ## Project Conventions
 
@@ -476,15 +482,11 @@ This configuration follows Claude Code's official standards for custom commands
 
   // Note: MCP integration disabled for now - using native tools for WordPress REST API
 
-  // Copy documentation files to project root
+  // Copy documentation files to project root (limited to essential guides)
   const docsToMerge = [
     'USER_GUIDE.md',
     'DEV_WORKFLOW_GUIDE.md',
-    'MCP_INTEGRATION.md',
-    'PUBLISHING_GUIDE.md',
-    'COOLIFY_DEPLOYMENT.md',
-    'WORDPRESS_ADMIN_SCRIPTS.md',
-    'TECHNICAL_ARCHITECTURE.md'
+    'PUBLISHING_GUIDE.md'
   ];
 
   for (const docFile of docsToMerge) {
@@ -494,6 +496,18 @@ This configuration follows Claude Code's official standards for custom commands
     }
   }
 
+  // Create content-rules.md if it doesn't already exist
+  const contentRulesPath = path.join(projectDir, 'content-rules.md');
+  if (!await fs.pathExists(contentRulesPath)) {
+    const contentRulesTemplate = path.join(__dirname, '..', 'content-rules.example.md');
+    if (await fs.pathExists(contentRulesTemplate)) {
+      await fs.copy(contentRulesTemplate, contentRulesPath);
+      console.log(chalk.green('   ✓ Created content-rules.md for customizable content generation'));
+    }
+  } else {
+    console.log(chalk.gray('   ℹ content-rules.md already exists, skipping creation'));
+  }
+
   // Save installation version for update tracking
   const pkgJson = await fs.readJson(path.join(__dirname, '..', 'package.json'));
   const versionFile = path.join(claudeDir, '.myaidev-version');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "myaidev-method",
-  "version": "0.2.17",
+  "version": "0.2.19",
   "description": "Comprehensive development framework with SPARC methodology for AI-assisted software development, AI visual content generation (Gemini, Imagen, DALL-E, Veo, FLUX), multi-platform publishing (WordPress, PayloadCMS, Astro, Docusaurus, Mintlify), and Coolify deployment",
   "mcpName": "io.github.myaione/myaidev-method",
   "main": "src/index.js",

package/src/lib/payloadcms-utils.js

@@ -144,7 +144,7 @@ export class PayloadCMSUtils {
 
         case 'list':
           return {
-            type: token.ordered ? 'number' : 'bullet',
+            type: 'list',
             listType: token.ordered ? 'number' : 'bullet',
             start: token.start || 1,
             tag: token.ordered ? 'ol' : 'ul',
@@ -213,7 +213,10 @@ export class PayloadCMSUtils {
       }
     };
 
-    const children = tokens.map(convertToken);
+    // Filter out space tokens and convert remaining tokens
+    const children = tokens
+      .filter(token => token.type !== 'space')
+      .map(convertToken);
 
     return {
       root: {
@@ -229,24 +232,147 @@ export class PayloadCMSUtils {
 
   /**
    * Parse inline text with formatting (bold, italic, code, links)
+   * Supports markdown formatters and converts to Lexical format codes:
+   * - **bold** → format: 1
+   * - *italic* → format: 2
+   * - `code` → format: 16
+   * - ***bold+italic*** → format: 3
    */
   parseInlineText(text) {
-    // Simple inline parser for bold, italic, code, links
     const children = [];
 
-    // For now, return simple text node
-    // TODO: Enhance with full inline formatting support
-    children.push({
+    // Strip HTML tags first
+    text = text.replace(/<[^>]+>/g, '');
+
+    // Parse markdown inline formatting using marked's inline lexer
+    try {
+      const tokens = marked.lexer(text);
+
+      // Extract inline tokens from paragraph if present
+      let inlineTokens = [];
+      if (tokens[0]?.type === 'paragraph' && tokens[0].tokens) {
+        inlineTokens = tokens[0].tokens;
+      } else if (tokens[0]?.tokens) {
+        inlineTokens = tokens[0].tokens;
+      } else {
+        // No inline tokens, return plain text
+        return [{
+          type: 'text',
+          text: text,
+          format: 0,
+          mode: 'normal',
+          style: '',
+          detail: 0,
+          version: 1
+        }];
+      }
+
+      // Convert each inline token to Lexical format
+      for (const token of inlineTokens) {
+        switch (token.type) {
+          case 'text':
+            children.push({
+              type: 'text',
+              text: token.text,
+              format: 0,
+              mode: 'normal',
+              style: '',
+              detail: 0,
+              version: 1
+            });
+            break;
+
+          case 'strong':
+            children.push({
+              type: 'text',
+              text: token.text,
+              format: 1, // IS_BOLD
+              mode: 'normal',
+              style: '',
+              detail: 0,
+              version: 1
+            });
+            break;
+
+          case 'em':
+            children.push({
+              type: 'text',
+              text: token.text,
+              format: 2, // IS_ITALIC
+              mode: 'normal',
+              style: '',
+              detail: 0,
+              version: 1
+            });
+            break;
+
+          case 'codespan':
+            children.push({
+              type: 'text',
+              text: token.text,
+              format: 16, // IS_CODE
+              mode: 'normal',
+              style: '',
+              detail: 0,
+              version: 1
+            });
+            break;
+
+          case 'link':
+            children.push({
+              type: 'link',
+              url: token.href,
+              children: [{
+                type: 'text',
+                text: token.text,
+                format: 0,
+                mode: 'normal',
+                style: '',
+                detail: 0,
+                version: 1
+              }],
+              direction: 'ltr',
+              format: '',
+              indent: 0,
+              version: 3
+            });
+            break;
+
+          default:
+            // Fallback for any unhandled token types
+            children.push({
+              type: 'text',
+              text: token.raw || token.text || '',
+              format: 0,
+              mode: 'normal',
+              style: '',
+              detail: 0,
+              version: 1
+            });
+        }
+      }
+    } catch (error) {
+      // If parsing fails, return plain text
+      children.push({
+        type: 'text',
+        text: text,
+        format: 0,
+        mode: 'normal',
+        style: '',
+        detail: 0,
+        version: 1
+      });
+    }
+
+    return children.length > 0 ? children : [{
       type: 'text',
-      text: text.replace(/<[^>]+>/g, ''), // Strip HTML tags
+      text: text,
       format: 0,
       mode: 'normal',
       style: '',
       detail: 0,
       version: 1
-    });
-
-    return children;
+    }];
   }
 
   /**
@@ -372,11 +498,12 @@ export class PayloadCMSUtils {
   }
 
   /**
-   * Health check
+   * Health check - verifies PayloadCMS connectivity and database access
+   * Uses /api/posts endpoint to verify both API and database are accessible
    */
   async healthCheck() {
     try {
-      const response = await fetch(`${this.url}/api`);
+      const response = await fetch(`${this.url}/api/posts?limit=1`);
       return response.ok;
     } catch (error) {
       return false;