myaidev-method 0.1.0 → 0.2.0

package/src/scripts/docusaurus-publish.js

@@ -0,0 +1,209 @@
+#!/usr/bin/env node
+
+/**
+ * Docusaurus Publishing Script
+ * Publish markdown content to Docusaurus site
+ */
+
+import { StaticSiteUtils, detectPlatform } from '../lib/static-site-utils.js';
+
+const args = process.argv.slice(2);
+
+const options = {
+  file: null,
+  type: 'docs',
+  projectPath: null,
+  branch: 'main',
+  noPush: false,
+  commitMessage: null,
+  json: args.includes('--json'),
+  verbose: args.includes('--verbose') || args.includes('-v'),
+  dryRun: args.includes('--dry-run')
+};
+
+// Parse arguments
+for (let i = 0; i < args.length; i++) {
+  switch (args[i]) {
+    case '--file':
+    case '-f':
+      options.file = args[++i];
+      break;
+    case '--type':
+    case '-t':
+      options.type = args[++i];
+      break;
+    case '--project':
+    case '-p':
+      options.projectPath = args[++i];
+      break;
+    case '--branch':
+    case '-b':
+      options.branch = args[++i];
+      break;
+    case '--no-push':
+      options.noPush = true;
+      break;
+    case '--message':
+    case '-m':
+      options.commitMessage = args[++i];
+      break;
+    case '--help':
+    case '-h':
+      printHelp();
+      process.exit(0);
+  }
+}
+
+// If no file specified, check positional argument
+if (!options.file && args.length > 0 && !args[0].startsWith('-')) {
+  options.file = args[0];
+}
+
+function printHelp() {
+  console.log(`
+Docusaurus Publishing Script
+
+Usage: docusaurus-publish [file] [options]
+
+Arguments:
+  file                       Markdown file to publish (required)
+
+Options:
+  --type, -t <type>          Content type: docs|blog|pages (default: docs)
+  --project, -p <path>       Docusaurus project path
+  --branch, -b <branch>      Git branch to push to (default: main)
+  --no-push                  Commit but don't push to remote
+  --message, -m <msg>        Custom commit message
+  --dry-run                  Validate without committing
+  --verbose, -v              Show detailed progress
+  --json                     Output in JSON format
+  --help, -h                 Show this help
+
+Examples:
+  # Publish to docs
+  docusaurus-publish article.md
+
+  # Publish to blog
+  docusaurus-publish post.md --type blog
+
+  # Custom project path and branch
+  docusaurus-publish article.md --project ./my-docs --branch develop
+
+  # Commit only (no push)
+  docusaurus-publish article.md --no-push
+`);
+}
+
+async function publishContent() {
+  try {
+    // Validate required options
+    if (!options.file) {
+      console.error('Error: Markdown file is required');
+      console.error('Run with --help for usage information');
+      process.exit(1);
+    }
+
+    if (options.verbose) {
+      console.error('Initializing Docusaurus publishing...');
+    }
+
+    const site = new StaticSiteUtils({
+      platform: 'docusaurus',
+      projectPath: options.projectPath
+    });
+
+    if (options.verbose) {
+      console.error('✓ Docusaurus project detected');
+      console.error(`Publishing to: ${options.type}`);
+    }
+
+    // Validate project
+    site.validateProject();
+
+    if (options.verbose) {
+      console.error('✓ Project structure validated');
+    }
+
+    // Dry run - validate only
+    if (options.dryRun) {
+      if (options.verbose) {
+        console.error('✓ Dry run - validation successful');
+      }
+
+      const output = {
+        success: true,
+        dryRun: true,
+        file: options.file,
+        platform: 'docusaurus',
+        type: options.type
+      };
+
+      if (options.json) {
+        console.log(JSON.stringify(output, null, 2));
+      } else {
+        console.log('Dry run successful - ready to publish');
+      }
+
+      process.exit(0);
+    }
+
+    // Publish content
+    const result = await site.publishContent(options.file, {
+      type: options.type,
+      branch: options.branch,
+      noPush: options.noPush,
+      commitMessage: options.commitMessage
+    });
+
+    if (options.verbose) {
+      console.error(`✓ Content published successfully`);
+    }
+
+    // Prepare output
+    const output = {
+      success: true,
+      file: result.file,
+      platform: result.platform,
+      git: result.git,
+      timestamp: new Date().toISOString()
+    };
+
+    if (options.json) {
+      console.log(JSON.stringify(output, null, 2));
+    } else {
+      console.log('\\n' + '='.repeat(60));
+      console.log('Docusaurus Publishing Result');
+      console.log('='.repeat(60));
+      console.log(`Status: ✓ Success`);
+      console.log(`File: ${result.file}`);
+      console.log(`Committed: ${result.git.committed ? 'Yes' : 'No'}`);
+      console.log(`Pushed: ${result.git.pushed ? 'Yes' : 'No'}`);
+      if (result.git.branch) {
+        console.log(`Branch: ${result.git.branch}`);
+      }
+      console.log('='.repeat(60));
+    }
+
+    process.exit(0);
+  } catch (error) {
+    if (options.json) {
+      console.log(JSON.stringify({
+        success: false,
+        error: error.message,
+        timestamp: new Date().toISOString()
+      }, null, 2));
+    } else {
+      console.error(`\\nError: ${error.message}`);
+      if (options.verbose) {
+        console.error(`Stack: ${error.stack}`);
+      }
+    }
+    process.exit(1);
+  }
+}
+
+if (import.meta.url === `file://${process.argv[1]}`) {
+  publishContent();
+}
+
+export { publishContent };

package/src/scripts/init-project.js

@@ -0,0 +1,91 @@
+#!/usr/bin/env node
+
+/**
+ * MyAIDev Method - Project Initialization Script
+ * Enhanced welcome and quick start guide
+ */
+
+import chalk from 'chalk';
+
+function printWelcome() {
+  console.log('');
+  console.log(chalk.cyan.bold('🚀 Welcome to MyAIDev Method!'));
+  console.log('');
+  console.log(chalk.gray('A comprehensive AI-powered content creation and publishing toolkit'));
+  console.log(chalk.gray('for Claude Code, optimized for modern development workflows'));
+  console.log('');
+
+  console.log(chalk.yellow.bold('📝 CONTENT CREATION'));
+  console.log(chalk.white('   • AI-powered content writing agent'));
+  console.log(chalk.white('   • SEO-optimized article generation'));
+  console.log(chalk.white('   • Multiple tone and style options'));
+  console.log(chalk.cyan('   Command: ') + chalk.green('/myai-content-writer'));
+  console.log('');
+
+  console.log(chalk.yellow.bold('📤 PUBLISHING PLATFORMS'));
+  console.log(chalk.white('   • ') + chalk.bold('WordPress') + chalk.gray(' - REST API publishing with Gutenberg blocks'));
+  console.log(chalk.white('   • ') + chalk.bold('PayloadCMS') + chalk.gray(' - Headless CMS publishing with Lexical editor'));
+  console.log(chalk.white('   • ') + chalk.bold('Docusaurus') + chalk.gray(' - Documentation site publishing'));
+  console.log(chalk.white('   • ') + chalk.bold('Mintlify') + chalk.gray(' - API documentation publishing'));
+  console.log(chalk.white('   • ') + chalk.bold('Astro') + chalk.gray(' - Static site publishing'));
+  console.log('');
+  console.log(chalk.cyan('   Configure: ') + chalk.green('/myai-configure'));
+  console.log(chalk.cyan('   Publish:   ') + chalk.green('/myai-[platform]-publish "content.md"'));
+  console.log('');
+
+  console.log(chalk.yellow.bold('🚀 DEPLOYMENT'));
+  console.log(chalk.white('   • ') + chalk.bold('Coolify') + chalk.gray(' - Self-hosted PaaS deployment'));
+  console.log(chalk.white('   • Automated app deployment and management'));
+  console.log(chalk.white('   • Health monitoring and status checks'));
+  console.log(chalk.cyan('   Command: ') + chalk.green('/myai-coolify-deploy'));
+  console.log('');
+
+  console.log(chalk.yellow.bold('⚙️  WORDPRESS ADMIN'));
+  console.log(chalk.white('   • Health checks and security scanning'));
+  console.log(chalk.white('   • Performance monitoring'));
+  console.log(chalk.white('   • Comprehensive reporting'));
+  console.log(chalk.cyan('   Scripts: ') + chalk.green('npm run wordpress:health-check'));
+  console.log('');
+
+  console.log(chalk.yellow.bold('📚 QUICK START'));
+  console.log(chalk.white('   1. Configure your platform:'));
+  console.log(chalk.gray('      ') + chalk.green('/myai-configure'));
+  console.log('');
+  console.log(chalk.white('   2. Create content:'));
+  console.log(chalk.gray('      ') + chalk.green('/myai-content-writer "your topic"'));
+  console.log('');
+  console.log(chalk.white('   3. Publish to your platform:'));
+  console.log(chalk.gray('      ') + chalk.green('/myai-wordpress-publish "content.md"'));
+  console.log(chalk.gray('      ') + chalk.green('/myai-payloadcms-publish "content.md" --status published'));
+  console.log(chalk.gray('      ') + chalk.green('/myai-docusaurus-publish "content.md" --type blog'));
+  console.log('');
+  console.log(chalk.white('   4. Deploy your application:'));
+  console.log(chalk.gray('      ') + chalk.green('/myai-coolify-deploy'));
+  console.log('');
+
+  console.log(chalk.yellow.bold('📖 DOCUMENTATION'));
+  console.log(chalk.white('   • Publishing Guide:     ') + chalk.cyan('PUBLISHING_GUIDE.md'));
+  console.log(chalk.white('   • WordPress Admin:      ') + chalk.cyan('WORDPRESS_ADMIN_SCRIPTS.md'));
+  console.log(chalk.white('   • PayloadCMS:          ') + chalk.cyan('PAYLOADCMS_PUBLISHING.md'));
+  console.log(chalk.white('   • Static Sites:        ') + chalk.cyan('STATIC_SITE_PUBLISHING.md'));
+  console.log(chalk.white('   • Coolify Deployment:  ') + chalk.cyan('COOLIFY_DEPLOYMENT.md'));
+  console.log(chalk.white('   • User Guide:          ') + chalk.cyan('USER_GUIDE.md'));
+  console.log('');
+
+  console.log(chalk.yellow.bold('🔗 LINKS'));
+  console.log(chalk.white('   • GitHub:      ') + chalk.cyan('https://github.com/myaione/myaidev-method'));
+  console.log(chalk.white('   • NPM Package: ') + chalk.cyan('https://www.npmjs.com/package/myaidev-method'));
+  console.log(chalk.white('   • Issues:      ') + chalk.cyan('https://github.com/myaione/myaidev-method/issues'));
+  console.log('');
+
+  console.log(chalk.gray('─'.repeat(70)));
+  console.log(chalk.green('✨ Ready to create and publish amazing content!'));
+  console.log(chalk.gray('─'.repeat(70)));
+  console.log('');
+}
+
+if (import.meta.url === `file://${process.argv[1]}`) {
+  printWelcome();
+}
+
+export { printWelcome };

package/src/scripts/mintlify-publish.js

@@ -0,0 +1,205 @@
+#!/usr/bin/env node
+
+/**
+ * Mintlify Publishing Script
+ * Publish markdown content to Mintlify documentation
+ */
+
+import { StaticSiteUtils } from '../lib/static-site-utils.js';
+
+const args = process.argv.slice(2);
+
+const options = {
+  file: null,
+  projectPath: null,
+  navSection: null,
+  branch: 'main',
+  noPush: false,
+  commitMessage: null,
+  json: args.includes('--json'),
+  verbose: args.includes('--verbose') || args.includes('-v'),
+  dryRun: args.includes('--dry-run')
+};
+
+// Parse arguments
+for (let i = 0; i < args.length; i++) {
+  switch (args[i]) {
+    case '--file':
+    case '-f':
+      options.file = args[++i];
+      break;
+    case '--nav-section':
+    case '-n':
+      options.navSection = args[++i];
+      break;
+    case '--project':
+    case '-p':
+      options.projectPath = args[++i];
+      break;
+    case '--branch':
+    case '-b':
+      options.branch = args[++i];
+      break;
+    case '--no-push':
+      options.noPush = true;
+      break;
+    case '--message':
+    case '-m':
+      options.commitMessage = args[++i];
+      break;
+    case '--help':
+    case '-h':
+      printHelp();
+      process.exit(0);
+  }
+}
+
+// If no file specified, check positional argument
+if (!options.file && args.length > 0 && !args[0].startsWith('-')) {
+  options.file = args[0];
+}
+
+function printHelp() {
+  console.log(`
+Mintlify Publishing Script
+
+Usage: mintlify-publish [file] [options]
+
+Arguments:
+  file                       Markdown/MDX file to publish (required)
+
+Options:
+  --nav-section, -n <name>   Add to navigation section in mint.json
+  --project, -p <path>       Mintlify project path
+  --branch, -b <branch>      Git branch to push to (default: main)
+  --no-push                  Commit but don't push to remote
+  --message, -m <msg>        Custom commit message
+  --dry-run                  Validate without committing
+  --verbose, -v              Show detailed progress
+  --json                     Output in JSON format
+  --help, -h                 Show this help
+
+Examples:
+  # Publish documentation
+  mintlify-publish guide.mdx
+
+  # Add to specific navigation section
+  mintlify-publish api-reference.mdx --nav-section "API Reference"
+
+  # Custom project path
+  mintlify-publish article.mdx --project ./docs --branch develop
+`);
+}
+
+async function publishContent() {
+  try {
+    // Validate required options
+    if (!options.file) {
+      console.error('Error: Markdown file is required');
+      console.error('Run with --help for usage information');
+      process.exit(1);
+    }
+
+    if (options.verbose) {
+      console.error('Initializing Mintlify publishing...');
+    }
+
+    const site = new StaticSiteUtils({
+      platform: 'mintlify',
+      projectPath: options.projectPath
+    });
+
+    if (options.verbose) {
+      console.error('✓ Mintlify project detected');
+    }
+
+    // Validate project
+    site.validateProject();
+
+    if (options.verbose) {
+      console.error('✓ Project structure validated');
+    }
+
+    // Dry run - validate only
+    if (options.dryRun) {
+      if (options.verbose) {
+        console.error('✓ Dry run - validation successful');
+      }
+
+      const output = {
+        success: true,
+        dryRun: true,
+        file: options.file,
+        platform: 'mintlify',
+        navSection: options.navSection
+      };
+
+      if (options.json) {
+        console.log(JSON.stringify(output, null, 2));
+      } else {
+        console.log('Dry run successful - ready to publish');
+      }
+
+      process.exit(0);
+    }
+
+    // Publish content
+    const result = await site.publishContent(options.file, {
+      navSection: options.navSection,
+      branch: options.branch,
+      noPush: options.noPush,
+      commitMessage: options.commitMessage
+    });
+
+    if (options.verbose) {
+      console.error(`✓ Content published successfully`);
+    }
+
+    // Prepare output
+    const output = {
+      success: true,
+      file: result.file,
+      platform: result.platform,
+      git: result.git,
+      timestamp: new Date().toISOString()
+    };
+
+    if (options.json) {
+      console.log(JSON.stringify(output, null, 2));
+    } else {
+      console.log('\\n' + '='.repeat(60));
+      console.log('Mintlify Publishing Result');
+      console.log('='.repeat(60));
+      console.log(`Status: ✓ Success`);
+      console.log(`File: ${result.file}`);
+      console.log(`Committed: ${result.git.committed ? 'Yes' : 'No'}`);
+      console.log(`Pushed: ${result.git.pushed ? 'Yes' : 'No'}`);
+      if (result.git.branch) {
+        console.log(`Branch: ${result.git.branch}`);
+      }
+      console.log('='.repeat(60));
+    }
+
+    process.exit(0);
+  } catch (error) {
+    if (options.json) {
+      console.log(JSON.stringify({
+        success: false,
+        error: error.message,
+        timestamp: new Date().toISOString()
+      }, null, 2));
+    } else {
+      console.error(`\\nError: ${error.message}`);
+      if (options.verbose) {
+        console.error(`Stack: ${error.stack}`);
+      }
+    }
+    process.exit(1);
+  }
+}
+
+if (import.meta.url === `file://${process.argv[1]}`) {
+  publishContent();
+}
+
+export { publishContent };

package/src/scripts/payloadcms-publish.js

@@ -0,0 +1,202 @@
+#!/usr/bin/env node
+
+/**
+ * PayloadCMS Publishing Script
+ * Publish markdown content to PayloadCMS
+ */
+
+import { PayloadCMSUtils } from '../lib/payloadcms-utils.js';
+
+const args = process.argv.slice(2);
+
+const options = {
+  file: null,
+  collection: 'posts',
+  status: 'draft',
+  id: null,
+  json: args.includes('--json'),
+  verbose: args.includes('--verbose') || args.includes('-v'),
+  dryRun: args.includes('--dry-run')
+};
+
+// Parse arguments
+for (let i = 0; i < args.length; i++) {
+  switch (args[i]) {
+    case '--file':
+    case '-f':
+      options.file = args[++i];
+      break;
+    case '--collection':
+    case '-c':
+      options.collection = args[++i];
+      break;
+    case '--status':
+    case '-s':
+      options.status = args[++i];
+      break;
+    case '--id':
+      options.id = args[++i];
+      break;
+    case '--help':
+    case '-h':
+      printHelp();
+      process.exit(0);
+  }
+}
+
+// If no file specified, check positional argument
+if (!options.file && args.length > 0 && !args[0].startsWith('-')) {
+  options.file = args[0];
+}
+
+function printHelp() {
+  console.log(`
+PayloadCMS Publishing Script
+
+Usage: payloadcms-publish [file] [options]
+
+Arguments:
+  file                       Markdown file to publish (required)
+
+Options:
+  --collection, -c <name>    Target collection (default: posts)
+  --status, -s <status>      Publish status: draft|published (default: draft)
+  --id <doc-id>              Update existing document by ID
+  --dry-run                  Validate without publishing
+  --verbose, -v              Show detailed progress
+  --json                     Output in JSON format
+  --help, -h                 Show this help
+
+Examples:
+  # Publish as draft
+  payloadcms-publish article.md --collection posts --status draft
+
+  # Publish to production
+  payloadcms-publish article.md --status published
+
+  # Update existing document
+  payloadcms-publish article.md --id 60d5ec49f8d2e
+
+  # Dry run
+  payloadcms-publish article.md --dry-run --verbose
+`);
+}
+
+async function publishContent() {
+  try {
+    // Validate required options
+    if (!options.file) {
+      console.error('Error: Markdown file is required');
+      console.error('Run with --help for usage information');
+      process.exit(1);
+    }
+
+    if (options.verbose) {
+      console.error('Initializing PayloadCMS connection...');
+    }
+
+    const payload = new PayloadCMSUtils();
+
+    // Health check
+    const healthy = await payload.healthCheck();
+    if (!healthy) {
+      throw new Error('PayloadCMS is not reachable');
+    }
+
+    if (options.verbose) {
+      console.error('✓ PayloadCMS is reachable');
+      console.error(`Authenticating...`);
+    }
+
+    // Authenticate
+    const authResult = await payload.authenticate();
+
+    if (options.verbose) {
+      console.error(`✓ Authenticated via ${authResult.method}`);
+      console.error(`Publishing to collection: ${options.collection}`);
+      console.error(`Status: ${options.status}`);
+    }
+
+    // Dry run - validate only
+    if (options.dryRun) {
+      if (options.verbose) {
+        console.error('✓ Dry run - validation successful');
+      }
+
+      const output = {
+        success: true,
+        dryRun: true,
+        file: options.file,
+        collection: options.collection,
+        status: options.status
+      };
+
+      if (options.json) {
+        console.log(JSON.stringify(output, null, 2));
+      } else {
+        console.log('Dry run successful - ready to publish');
+      }
+
+      process.exit(0);
+    }
+
+    // Publish content
+    const result = await payload.publishContent(options.file, options.collection, {
+      status: options.status,
+      id: options.id
+    });
+
+    if (options.verbose) {
+      console.error(`✓ Content ${options.id ? 'updated' : 'created'} successfully`);
+    }
+
+    // Prepare output
+    const output = {
+      success: true,
+      action: options.id ? 'updated' : 'created',
+      document: {
+        id: result.doc?.id || result.id,
+        collection: options.collection,
+        status: result.doc?.status || options.status,
+        title: result.doc?.title
+      },
+      timestamp: new Date().toISOString()
+    };
+
+    if (options.json) {
+      console.log(JSON.stringify(output, null, 2));
+    } else {
+      console.log('\\n' + '='.repeat(60));
+      console.log('PayloadCMS Publishing Result');
+      console.log('='.repeat(60));
+      console.log(`Status: ✓ Success`);
+      console.log(`Action: ${output.action}`);
+      console.log(`Document ID: ${output.document.id}`);
+      console.log(`Collection: ${output.document.collection}`);
+      console.log(`Status: ${output.document.status}`);
+      console.log('='.repeat(60));
+    }
+
+    process.exit(0);
+  } catch (error) {
+    if (options.json) {
+      console.log(JSON.stringify({
+        success: false,
+        error: error.message,
+        timestamp: new Date().toISOString()
+      }, null, 2));
+    } else {
+      console.error(`\\nError: ${error.message}`);
+      if (options.verbose) {
+        console.error(`Stack: ${error.stack}`);
+      }
+    }
+    process.exit(1);
+  }
+}
+
+if (import.meta.url === `file://${process.argv[1]}`) {
+  publishContent();
+}
+
+export { publishContent };