myaidev-method 0.2.9 → 0.2.11

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 Installed:'));
+        console.log(chalk.gray('   • .myaidev-method/scripts/ - Publishing and deployment scripts'));
+        console.log(chalk.gray('   • .myaidev-method/lib/ - Utility libraries and helpers'));
+        console.log(chalk.gray('   • Installing script dependencies... (this may take a moment)'));
+
         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,47 @@ 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 and utilities are in \`.myaidev-method/scripts/\` and \`.myaidev-method/lib/\`
+
+## Scripts and Utilities
+
+The \`.myaidev-method/\` directory contains self-contained scripts and utilities:
+
+\`\`\`bash
+.myaidev-method/
+├── scripts/         # Executable publishing and deployment scripts
+├── lib/             # Utility libraries (PayloadCMSUtils, etc.)
+├── node_modules/    # Script dependencies (installed automatically)
+└── package.json     # Dependency manifest
+\`\`\`
+
+**Agents can invoke scripts directly using the Bash tool**:
+
+\`\`\`bash
+# Publishing scripts
+node .myaidev-method/scripts/payloadcms-publish.js "article.md" --status published
+node .myaidev-method/scripts/wordpress-health-check.js
+node .myaidev-method/scripts/docusaurus-publish.js "guide.md" --category tutorials
+node .myaidev-method/scripts/coolify-deploy-app.js --name myapp
+\`\`\`
+
+**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
+
+**Note**: The \`.myaidev-method/\` directory includes its own \`node_modules/\` with all required dependencies.
+To update dependencies, run \`npm install\` inside the \`.myaidev-method/\` directory.
+
+**Git Ignore**: Add to your \`.gitignore\`:
+\`\`\`
+.myaidev-method/node_modules/
+\`\`\`
 
 ## Notes
 
@@ -294,6 +340,71 @@ This configuration follows Claude Code's official standards for custom commands
     await fs.copy(sourceEnvExample, path.join(projectDir, '.env.example'));
   }
 
+  // Create .myaidev-method directory for scripts and utilities
+  // This allows agents to access publishing/deployment scripts in non-Node.js projects
+  const myaidevDir = path.join(projectDir, '.myaidev-method');
+  const scriptsDir = path.join(myaidevDir, 'scripts');
+  const libDir = path.join(myaidevDir, 'lib');
+
+  await fs.ensureDir(scriptsDir);
+  await fs.ensureDir(libDir);
+
+  // Copy all executable scripts
+  const sourceScriptsDir = path.join(__dirname, '..', 'src', 'scripts');
+  if (await fs.pathExists(sourceScriptsDir)) {
+    const scriptFiles = await fs.readdir(sourceScriptsDir);
+    for (const file of scriptFiles) {
+      if (file.endsWith('.js') && file !== 'init-project.js') { // Skip init script
+        await fs.copy(
+          path.join(sourceScriptsDir, file),
+          path.join(scriptsDir, file)
+        );
+      }
+    }
+  }
+
+  // Copy all utility libraries
+  const sourceLibDir = path.join(__dirname, '..', 'src', 'lib');
+  if (await fs.pathExists(sourceLibDir)) {
+    await fs.copy(sourceLibDir, libDir);
+  }
+
+  // Copy package.json and install dependencies in .myaidev-method
+  // This ensures scripts have access to required npm packages
+  const packageJson = {
+    "name": "myaidev-method-scripts",
+    "version": "1.0.0",
+    "type": "module",
+    "private": true,
+    "dependencies": {
+      "node-fetch": "^3.3.2",
+      "marked": "^11.0.0",
+      "gray-matter": "^4.0.3",
+      "dotenv": "^16.4.1",
+      "chalk": "^5.3.0",
+      "ora": "^8.0.1"
+    }
+  };
+
+  await fs.writeFile(
+    path.join(myaidevDir, 'package.json'),
+    JSON.stringify(packageJson, null, 2)
+  );
+
+  // Install dependencies in .myaidev-method directory
+  console.log(chalk.gray('\n   Installing script dependencies...'));
+  const { execSync } = await import('child_process');
+  try {
+    execSync('npm install', {
+      cwd: myaidevDir,
+      stdio: 'inherit'
+    });
+    console.log(chalk.green('   ✓ Dependencies installed successfully'));
+  } catch (error) {
+    console.log(chalk.yellow('   ⚠ Failed to install dependencies automatically'));
+    console.log(chalk.gray('   Run: cd .myaidev-method && npm install'));
+  }
+
   // 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.11",
   "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 .myaidev-method/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 .myaidev-method/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 .myaidev-method/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 .myaidev-method/scripts/coolify-status.js
 
 # Step 2: List available servers
-node src/scripts/coolify-list-resources.js --type servers
+node .myaidev-method/scripts/coolify-list-resources.js --type servers
 
 # Step 3: Deploy application
-node src/scripts/coolify-deploy-app.js \
+node .myaidev-method/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 .myaidev-method/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 .myaidev-method/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 .myaidev-method/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 .myaidev-method/scripts/coolify-list-resources.js [--type servers|projects|applications|databases]
+node .myaidev-method/scripts/coolify-status.js
+node .myaidev-method/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 .myaidev-method/scripts/coolify-deploy-app.js [options]
+node .myaidev-method/scripts/coolify-watch-deployment.js --uuid <app-uuid>
+node .myaidev-method/scripts/coolify-restart-app.js --uuid <app-uuid>
+node .myaidev-method/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 .myaidev-method/scripts/coolify-set-env.js --uuid <app-uuid> --file .env.production
+node .myaidev-method/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 .myaidev-method/scripts/coolify-logs.js --uuid <app-uuid> [--follow]
+node .myaidev-method/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 .myaidev-method/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 .myaidev-method/scripts/coolify-logs.js --uuid <app-uuid>
 
 # Get deployment status
-node src/scripts/coolify-deployment-report.js --uuid <app-uuid>
+node .myaidev-method/scripts/coolify-deployment-report.js --uuid <app-uuid>
 
 # Restart application
-node src/scripts/coolify-restart-app.js --uuid <app-uuid>
+node .myaidev-method/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 .myaidev-method/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 .myaidev-method/scripts/coolify-server-info.js --uuid <server-uuid>
 
 # Verify application running
-node src/scripts/coolify-logs.js --uuid <app-uuid> --tail 50
+node .myaidev-method/scripts/coolify-logs.js --uuid <app-uuid> --tail 50
 ```
 
 ### Diagnostic Workflow
 
 1. **Check System Status**
    ```bash
-   node src/scripts/coolify-status.js
+   node .myaidev-method/scripts/coolify-status.js
    ```
 
 2. **Verify Application State**
    ```bash
-   node src/scripts/coolify-list-resources.js --type applications
+   node .myaidev-method/scripts/coolify-list-resources.js --type applications
    ```
 
 3. **Analyze Logs**
    ```bash
-   node src/scripts/coolify-logs.js --uuid <uuid> --follow
+   node .myaidev-method/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 .myaidev-method/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 .myaidev-method/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 .myaidev-method/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 .myaidev-method/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 .myaidev-method/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 .myaidev-method/scripts/coolify-status.js
 
 # 2. List available servers
-node src/scripts/coolify-list-resources.js --type servers
+node .myaidev-method/scripts/coolify-list-resources.js --type servers
 
 # 3. Deploy application
-node src/scripts/coolify-deploy-app.js \
+node .myaidev-method/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 .myaidev-method/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 .myaidev-method/scripts/coolify-list-resources.js --type applications | grep myapp
 
 # 2. Update environment variable
-node src/scripts/coolify-set-env.js \
+node .myaidev-method/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 .myaidev-method/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 .myaidev-method/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 .myaidev-method/scripts/coolify-get-database-connection.js --uuid "<db-uuid>"
 
 # 3. Update application with DB connection
-node src/scripts/coolify-set-env.js \
+node .myaidev-method/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 .myaidev-method/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 .myaidev-method/scripts/coolify-stop-app.js --uuid "<green-uuid>"
 ```
 
 ### Pattern: Canary Deployment
 
 ```bash
 # Deploy canary version
-node src/scripts/coolify-deploy-app.js \
+node .myaidev-method/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 .myaidev-method/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 .myaidev-method/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 .myaidev-method/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 '.myaidev-method/lib/payloadcms-utils.js'
 ```
 
 ## Configuration Setup