myaidev-method 0.2.9 → 0.2.10

package/bin/cli.js

@@ -111,6 +111,11 @@ program
         console.log(chalk.gray('   • COOLIFY_DEPLOYMENT.md - Application deployment'));
         console.log(chalk.gray('   • WORDPRESS_ADMIN_SCRIPTS.md - WordPress utilities'));
 
+        console.log(chalk.magenta('\n🛠️  Scripts and Utilities Available:'));
+        console.log(chalk.gray('   • node_modules/myaidev-method/src/scripts/ - Publishing scripts'));
+        console.log(chalk.gray('   • node_modules/myaidev-method/src/lib/ - Utility libraries'));
+        console.log(chalk.gray('   • Agents can invoke scripts via Bash tool with full dependencies'));
+
         console.log(chalk.magenta('\n🔧 MCP Server Integration (Optional Advanced Features):'));
         console.log(chalk.gray('   • SPARC Orchestrator: Workflow automation with MCP tools'));
         console.log(chalk.gray('   • Chrome DevTools: Browser testing and debugging'));
@@ -280,6 +285,32 @@ COOLIFY_API_KEY=your-api-key
 - All custom commands are in \`.claude/commands/\`
 - All agents are in \`.claude/agents/\`
 - Commands and agents use Markdown format with YAML frontmatter
+- Executable scripts are in the npm package: \`node_modules/myaidev-method/src/scripts/\`
+
+## Scripts and Utilities
+
+Publishing and deployment scripts are available via the installed npm package.
+Agents can invoke these scripts using the Bash tool:
+
+\`\`\`bash
+# Publishing scripts
+node node_modules/myaidev-method/src/scripts/payloadcms-publish.js "article.md" --status published
+node node_modules/myaidev-method/src/scripts/wordpress-health-check.js
+node node_modules/myaidev-method/src/scripts/docusaurus-publish.js "guide.md" --category tutorials
+
+# Or use the global CLI if installed globally
+npx myaidev-method [script-name]
+\`\`\`
+
+**Available Scripts**:
+- \`payloadcms-publish.js\` - Publish to PayloadCMS
+- \`astro-publish.js\` - Publish to Astro
+- \`docusaurus-publish.js\` - Publish to Docusaurus
+- \`mintlify-publish.js\` - Publish to Mintlify
+- \`coolify-deploy-app.js\` - Deploy to Coolify
+- \`wordpress-health-check.js\` - WordPress health check
+- \`wordpress-security-scan.js\` - WordPress security scan
+- \`wordpress-performance-check.js\` - WordPress performance analysis
 
 ## Notes
 
@@ -294,6 +325,9 @@ This configuration follows Claude Code's official standards for custom commands
     await fs.copy(sourceEnvExample, path.join(projectDir, '.env.example'));
   }
 
+  // Note: Scripts are NOT copied locally because they need access to npm dependencies
+  // Agents should reference scripts in node_modules: node_modules/myaidev-method/src/scripts/
+
   // Note: MCP integration disabled for now - using native tools for WordPress REST API
 
   // Copy documentation files to project root

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "myaidev-method",
-  "version": "0.2.9",
+  "version": "0.2.10",
   "description": "Comprehensive development framework with SPARC methodology for AI-assisted software development, multi-platform publishing (WordPress, PayloadCMS, Astro, Docusaurus, Mintlify), and Coolify deployment",
   "mcpName": "io.github.myaione/myaidev-method",
   "main": "src/index.js",

package/src/templates/claude/agents/coolify-deploy.md

@@ -25,7 +25,7 @@ COOLIFY_API_KEY=your_api_key_here
 
 Verify configuration:
 ```bash
-node src/scripts/coolify-status.js
+node node_modules/myaidev-method/src/scripts/coolify-status.js
 ```
 
 ## Operational Patterns (Claude Code 2.0)
@@ -37,10 +37,10 @@ node src/scripts/coolify-status.js
 
 ```bash
 # Deploy application
-node src/scripts/coolify-deploy-app.js --name myapp --repo https://github.com/user/repo
+node node_modules/myaidev-method/src/scripts/coolify-deploy-app.js --name myapp --repo https://github.com/user/repo
 
 # Check status
-node src/scripts/coolify-list-resources.js --type applications
+node node_modules/myaidev-method/src/scripts/coolify-list-resources.js --type applications
 ```
 
 ### Pattern 2: Extended Thinking
@@ -69,13 +69,13 @@ Main agent → Deploy subagent (App A) → Verify subagent
 
 ```bash
 # Step 1: Verify Coolify connectivity
-node src/scripts/coolify-status.js
+node node_modules/myaidev-method/src/scripts/coolify-status.js
 
 # Step 2: List available servers
-node src/scripts/coolify-list-resources.js --type servers
+node node_modules/myaidev-method/src/scripts/coolify-list-resources.js --type servers
 
 # Step 3: Deploy application
-node src/scripts/coolify-deploy-app.js \
+node node_modules/myaidev-method/src/scripts/coolify-deploy-app.js \
   --name "myapp" \
   --repo "https://github.com/user/myapp" \
   --branch "main" \
@@ -86,7 +86,7 @@ node src/scripts/coolify-deploy-app.js \
   --domain "myapp.example.com"
 
 # Step 4: Monitor deployment
-node src/scripts/coolify-watch-deployment.js --uuid "app-uuid"
+node node_modules/myaidev-method/src/scripts/coolify-watch-deployment.js --uuid "app-uuid"
 
 # Step 5: Verify deployment
 curl https://myapp.example.com
@@ -118,14 +118,14 @@ curl https://myapp.example.com
 
 ```bash
 # Deploy to staging
-node src/scripts/coolify-deploy-app.js \
+node node_modules/myaidev-method/src/scripts/coolify-deploy-app.js \
   --name "myapp-staging" \
   --branch "develop" \
   --env-file ".env.staging"
 
 # Deploy to production (with approval gate)
 # Agent prompts: "Ready to deploy to production? (y/n)"
-node src/scripts/coolify-deploy-app.js \
+node node_modules/myaidev-method/src/scripts/coolify-deploy-app.js \
   --name "myapp-prod" \
   --branch "main" \
   --env-file ".env.production"
@@ -139,23 +139,23 @@ All scripts use credentials from `.env` automatically:
 
 ```bash
 # Resource Management
-node src/scripts/coolify-list-resources.js [--type servers|projects|applications|databases]
-node src/scripts/coolify-status.js
-node src/scripts/coolify-server-info.js --uuid <server-uuid>
+node node_modules/myaidev-method/src/scripts/coolify-list-resources.js [--type servers|projects|applications|databases]
+node node_modules/myaidev-method/src/scripts/coolify-status.js
+node node_modules/myaidev-method/src/scripts/coolify-server-info.js --uuid <server-uuid>
 
 # Application Deployment
-node src/scripts/coolify-deploy-app.js [options]
-node src/scripts/coolify-watch-deployment.js --uuid <app-uuid>
-node src/scripts/coolify-restart-app.js --uuid <app-uuid>
-node src/scripts/coolify-stop-app.js --uuid <app-uuid>
+node node_modules/myaidev-method/src/scripts/coolify-deploy-app.js [options]
+node node_modules/myaidev-method/src/scripts/coolify-watch-deployment.js --uuid <app-uuid>
+node node_modules/myaidev-method/src/scripts/coolify-restart-app.js --uuid <app-uuid>
+node node_modules/myaidev-method/src/scripts/coolify-stop-app.js --uuid <app-uuid>
 
 # Environment Variables
-node src/scripts/coolify-set-env.js --uuid <app-uuid> --file .env.production
-node src/scripts/coolify-get-env.js --uuid <app-uuid>
+node node_modules/myaidev-method/src/scripts/coolify-set-env.js --uuid <app-uuid> --file .env.production
+node node_modules/myaidev-method/src/scripts/coolify-get-env.js --uuid <app-uuid>
 
 # Logs & Debugging
-node src/scripts/coolify-logs.js --uuid <app-uuid> [--follow]
-node src/scripts/coolify-deployment-report.js --uuid <app-uuid>
+node node_modules/myaidev-method/src/scripts/coolify-logs.js --uuid <app-uuid> [--follow]
+node node_modules/myaidev-method/src/scripts/coolify-deployment-report.js --uuid <app-uuid>
 ```
 
 ### Using Coolify Utils Library
@@ -249,7 +249,7 @@ const result = await coolify.waitForDeployment(uuid, {
 **Issue: API Authentication Failed**
 ```bash
 # Verify API key
-node src/scripts/coolify-status.js
+node node_modules/myaidev-method/src/scripts/coolify-status.js
 
 # Check .env file
 cat .env | grep COOLIFY
@@ -261,47 +261,47 @@ curl -H "Authorization: Bearer $COOLIFY_API_KEY" https://coolify.myai1.ai/api/v1
 **Issue: Deployment Stuck or Failed**
 ```bash
 # Check deployment logs
-node src/scripts/coolify-logs.js --uuid <app-uuid>
+node node_modules/myaidev-method/src/scripts/coolify-logs.js --uuid <app-uuid>
 
 # Get deployment status
-node src/scripts/coolify-deployment-report.js --uuid <app-uuid>
+node node_modules/myaidev-method/src/scripts/coolify-deployment-report.js --uuid <app-uuid>
 
 # Restart application
-node src/scripts/coolify-restart-app.js --uuid <app-uuid>
+node node_modules/myaidev-method/src/scripts/coolify-restart-app.js --uuid <app-uuid>
 ```
 
 **Issue: Application Not Accessible**
 ```bash
 # Verify domains configured
-node src/scripts/coolify-list-resources.js --type applications | grep -A 5 "myapp"
+node node_modules/myaidev-method/src/scripts/coolify-list-resources.js --type applications | grep -A 5 "myapp"
 
 # Check server status
-node src/scripts/coolify-server-info.js --uuid <server-uuid>
+node node_modules/myaidev-method/src/scripts/coolify-server-info.js --uuid <server-uuid>
 
 # Verify application running
-node src/scripts/coolify-logs.js --uuid <app-uuid> --tail 50
+node node_modules/myaidev-method/src/scripts/coolify-logs.js --uuid <app-uuid> --tail 50
 ```
 
 ### Diagnostic Workflow
 
 1. **Check System Status**
    ```bash
-   node src/scripts/coolify-status.js
+   node node_modules/myaidev-method/src/scripts/coolify-status.js
    ```
 
 2. **Verify Application State**
    ```bash
-   node src/scripts/coolify-list-resources.js --type applications
+   node node_modules/myaidev-method/src/scripts/coolify-list-resources.js --type applications
    ```
 
 3. **Analyze Logs**
    ```bash
-   node src/scripts/coolify-logs.js --uuid <uuid> --follow
+   node node_modules/myaidev-method/src/scripts/coolify-logs.js --uuid <uuid> --follow
    ```
 
 4. **Generate Deployment Report**
    ```bash
-   node src/scripts/coolify-deployment-report.js --uuid <uuid> --output report.json
+   node node_modules/myaidev-method/src/scripts/coolify-deployment-report.js --uuid <uuid> --output report.json
    ```
 
 ## Security Best Practices
@@ -349,7 +349,7 @@ fi
 /myai-content-writer "10 Tips for Productivity"
 
 # Coolify-deploy agent deploys WordPress if needed
-node src/scripts/coolify-deploy-app.js --name wordpress --template wordpress
+node node_modules/myaidev-method/src/scripts/coolify-deploy-app.js --name wordpress --template wordpress
 
 # WordPress-admin agent publishes content
 /myai-wordpress-publish content.md
@@ -370,7 +370,7 @@ node src/scripts/coolify-deploy-app.js --name wordpress --template wordpress
 
 ```bash
 # List servers with metrics
-node src/scripts/coolify-list-resources.js --type servers --detailed
+node node_modules/myaidev-method/src/scripts/coolify-list-resources.js --type servers --detailed
 
 # Agent analyzes:
 # - Server load
@@ -397,7 +397,7 @@ node src/scripts/coolify-list-resources.js --type servers --detailed
 
 ```bash
 # Real-time deployment monitoring
-node src/scripts/coolify-watch-deployment.js --uuid <uuid>
+node node_modules/myaidev-method/src/scripts/coolify-watch-deployment.js --uuid <uuid>
 
 # Output:
 # [12:00:00] 🚀 Deployment started
@@ -411,7 +411,7 @@ node src/scripts/coolify-watch-deployment.js --uuid <uuid>
 
 ```bash
 # System-wide health check
-node src/scripts/coolify-status.js --comprehensive
+node node_modules/myaidev-method/src/scripts/coolify-status.js --comprehensive
 
 # Per-application health check
 curl -I https://myapp.example.com/health
@@ -426,13 +426,13 @@ curl -I https://myapp.example.com/health
 **Agent workflow**:
 ```bash
 # 1. Verify connectivity
-node src/scripts/coolify-status.js
+node node_modules/myaidev-method/src/scripts/coolify-status.js
 
 # 2. List available servers
-node src/scripts/coolify-list-resources.js --type servers
+node node_modules/myaidev-method/src/scripts/coolify-list-resources.js --type servers
 
 # 3. Deploy application
-node src/scripts/coolify-deploy-app.js \
+node node_modules/myaidev-method/src/scripts/coolify-deploy-app.js \
   --name "nextjs-app" \
   --repo "https://github.com/user/nextjs-app" \
   --branch "main" \
@@ -442,7 +442,7 @@ node src/scripts/coolify-deploy-app.js \
   --server-uuid "ho4k04okko0wks8g0gsccww4"
 
 # 4. Watch deployment
-node src/scripts/coolify-watch-deployment.js --uuid "<new-app-uuid>"
+node node_modules/myaidev-method/src/scripts/coolify-watch-deployment.js --uuid "<new-app-uuid>"
 ```
 
 ### Example 2: Update Environment Variables
@@ -452,16 +452,16 @@ node src/scripts/coolify-watch-deployment.js --uuid "<new-app-uuid>"
 **Agent workflow**:
 ```bash
 # 1. Find application
-node src/scripts/coolify-list-resources.js --type applications | grep myapp
+node node_modules/myaidev-method/src/scripts/coolify-list-resources.js --type applications | grep myapp
 
 # 2. Update environment variable
-node src/scripts/coolify-set-env.js \
+node node_modules/myaidev-method/src/scripts/coolify-set-env.js \
   --uuid "<app-uuid>" \
   --key "API_KEY" \
   --value "<new-api-key>"
 
 # 3. Restart application to apply changes
-node src/scripts/coolify-restart-app.js --uuid "<app-uuid>"
+node node_modules/myaidev-method/src/scripts/coolify-restart-app.js --uuid "<app-uuid>"
 ```
 
 ### Example 3: Deploy Database
@@ -471,7 +471,7 @@ node src/scripts/coolify-restart-app.js --uuid "<app-uuid>"
 **Agent workflow**:
 ```bash
 # 1. Create database
-node src/scripts/coolify-create-database.js \
+node node_modules/myaidev-method/src/scripts/coolify-create-database.js \
   --name "myapp-db" \
   --type "postgresql" \
   --version "16" \
@@ -479,10 +479,10 @@ node src/scripts/coolify-create-database.js \
   --project-uuid "<project-uuid>"
 
 # 2. Get connection string
-node src/scripts/coolify-get-database-connection.js --uuid "<db-uuid>"
+node node_modules/myaidev-method/src/scripts/coolify-get-database-connection.js --uuid "<db-uuid>"
 
 # 3. Update application with DB connection
-node src/scripts/coolify-set-env.js \
+node node_modules/myaidev-method/src/scripts/coolify-set-env.js \
   --uuid "<app-uuid>" \
   --key "DATABASE_URL" \
   --value "<connection-string>"
@@ -494,21 +494,21 @@ node src/scripts/coolify-set-env.js \
 
 ```bash
 # Deploy to blue environment
-node src/scripts/coolify-deploy-app.js --name "myapp-blue" --branch "release"
+node node_modules/myaidev-method/src/scripts/coolify-deploy-app.js --name "myapp-blue" --branch "release"
 
 # Test blue environment
 curl https://blue.myapp.com/health
 
 # Switch traffic (update DNS or proxy)
 # Stop green environment
-node src/scripts/coolify-stop-app.js --uuid "<green-uuid>"
+node node_modules/myaidev-method/src/scripts/coolify-stop-app.js --uuid "<green-uuid>"
 ```
 
 ### Pattern: Canary Deployment
 
 ```bash
 # Deploy canary version
-node src/scripts/coolify-deploy-app.js \
+node node_modules/myaidev-method/src/scripts/coolify-deploy-app.js \
   --name "myapp-canary" \
   --branch "canary" \
   --domain "canary.myapp.com"
@@ -522,12 +522,12 @@ node src/scripts/coolify-deploy-app.js \
 
 ```bash
 # Deploy to US server
-node src/scripts/coolify-deploy-app.js \
+node node_modules/myaidev-method/src/scripts/coolify-deploy-app.js \
   --name "myapp-us" \
   --server-uuid "<us-server-uuid>"
 
 # Deploy to EU server
-node src/scripts/coolify-deploy-app.js \
+node node_modules/myaidev-method/src/scripts/coolify-deploy-app.js \
   --name "myapp-eu" \
   --server-uuid "<eu-server-uuid>"
 

package/src/templates/claude/agents/payloadcms-publish.md

@@ -124,10 +124,18 @@ Agent:
 
 ```
 1. Read(markdown_file) → Extract content
-2. authenticatePayload() → Get JWT token
-3. markdownToLexical() → Convert format
-4. publishToPayload() → Create/update document
-5. Report success with URLs
+2. Use Bash tool to execute publishing script:
+   node node_modules/myaidev-method/src/scripts/payloadcms-publish.js [file] [options]
+3. The script handles:
+   - Authentication (JWT token from .env credentials)
+   - Markdown to Lexical conversion
+   - Document creation/update via API
+4. Report success with URLs from script output
+```
+
+**Alternative**: Use PayloadCMSUtils library directly if you prefer programmatic control:
+```
+import { PayloadCMSUtils } from 'node_modules/myaidev-method/src/lib/payloadcms-utils.js'
 ```
 
 ## Configuration Setup