mcp-wordpress 1.5.2 → 2.0.0

package/docs/api/tools/wp_update_site_settings.md

@@ -19,13 +19,11 @@ Updates one or more general settings for a WordPress site.
 Simple example of using wp_update_site_settings
 
 **Command:**
-
 ```bash
 wp_update_site_settings 
 ```
 
 **Response:**
-
 ```json
 {
   "success": true,
@@ -38,7 +36,6 @@ wp_update_site_settings
 ```
 
 **Error Example (Authentication failure):**
-
 ```json
 {
   "error": "Authentication failed",
@@ -46,18 +43,17 @@ wp_update_site_settings
 }
 ```
 
+
 ### Advanced site Configuration
 
 Comprehensive example using all available parameters
 
 **Command:**
-
 ```bash
 wp_update_site_settings --title="Example Post Title" --description="example_value" --timezone="example_value"
 ```
 
 **Response:**
-
 ```json
 {
   "success": true,
@@ -69,6 +65,13 @@ wp_update_site_settings --title="Example Post Title" --description="example_valu
 }
 ```
 
+
+
+
+
+
+
+
 ## Response Format
 
 **Return Type:** `site`
@@ -95,24 +98,30 @@ wp_update_site_settings --title="Example Post Title" --description="example_valu
 **Description:** Invalid credentials or insufficient permissions  
 **Resolution:** Check your authentication credentials and user permissions
 
+
 ### VALIDATION_ERROR
 
 **Message:** Parameter validation failed  
 **Description:** One or more required parameters are missing or invalid  
 **Resolution:** Review the required parameters and their formats
 
+
 ### NOT_FOUND
 
 **Message:** Resource not found  
 **Description:** The requested resource does not exist  
 **Resolution:** Verify the resource ID and ensure it exists
 
+
 ### PERMISSION_DENIED
 
 **Message:** Insufficient permissions  
 **Description:** The user does not have permission to perform this action  
 **Resolution:** Contact an administrator to grant the necessary permissions
 
+
+
+
 ---
 
 *Generated automatically from tool definitions - Do not edit manually*

package/docs/api/tools/wp_update_tag.md

@@ -18,13 +18,11 @@ Updates an existing tag.
 Simple example of using wp_update_tag
 
 **Command:**
-
 ```bash
 wp_update_tag --id="123"
 ```
 
 **Response:**
-
 ```json
 {
   "success": true,
@@ -37,7 +35,6 @@ wp_update_tag --id="123"
 ```
 
 **Error Example (Authentication failure):**
-
 ```json
 {
   "error": "Authentication failed",
@@ -45,6 +42,11 @@ wp_update_tag --id="123"
 }
 ```
 
+
+
+
+
+
 ## Response Format
 
 **Return Type:** `taxonomy`
@@ -71,24 +73,30 @@ wp_update_tag --id="123"
 **Description:** Invalid credentials or insufficient permissions  
 **Resolution:** Check your authentication credentials and user permissions
 
+
 ### VALIDATION_ERROR
 
 **Message:** Parameter validation failed  
 **Description:** One or more required parameters are missing or invalid  
 **Resolution:** Review the required parameters and their formats
 
+
 ### NOT_FOUND
 
 **Message:** Resource not found  
 **Description:** The requested resource does not exist  
 **Resolution:** Verify the resource ID and ensure it exists
 
+
 ### PERMISSION_DENIED
 
 **Message:** Insufficient permissions  
 **Description:** The user does not have permission to perform this action  
 **Resolution:** Contact an administrator to grant the necessary permissions
 
+
+
+
 ---
 
 *Generated automatically from tool definitions - Do not edit manually*

package/docs/api/tools/wp_update_user.md

@@ -19,13 +19,11 @@ Updates an existing user.
 Simple example of using wp_update_user
 
 **Command:**
-
 ```bash
 wp_update_user --id="123"
 ```
 
 **Response:**
-
 ```json
 {
   "success": true,
@@ -38,7 +36,6 @@ wp_update_user --id="123"
 ```
 
 **Error Example (Authentication failure):**
-
 ```json
 {
   "error": "Authentication failed",
@@ -46,18 +43,17 @@ wp_update_user --id="123"
 }
 ```
 
+
 ### Advanced user Configuration
 
 Comprehensive example using all available parameters
 
 **Command:**
-
 ```bash
 wp_update_user --id="123" --email="user@example.com" --name="example_value"
 ```
 
 **Response:**
-
 ```json
 {
   "success": true,
@@ -69,6 +65,11 @@ wp_update_user --id="123" --email="user@example.com" --name="example_value"
 }
 ```
 
+
+
+
+
+
 ## Required Permissions
 
 This tool requires the following WordPress user capabilities:
@@ -77,6 +78,7 @@ This tool requires the following WordPress user capabilities:
 
 **Note:** The authenticated user must have these capabilities to successfully execute this tool.
 
+
 ## Response Format
 
 **Return Type:** `user`
@@ -103,24 +105,30 @@ This tool requires the following WordPress user capabilities:
 **Description:** Invalid credentials or insufficient permissions  
 **Resolution:** Check your authentication credentials and user permissions
 
+
 ### VALIDATION_ERROR
 
 **Message:** Parameter validation failed  
 **Description:** One or more required parameters are missing or invalid  
 **Resolution:** Review the required parameters and their formats
 
+
 ### NOT_FOUND
 
 **Message:** Resource not found  
 **Description:** The requested resource does not exist  
 **Resolution:** Verify the resource ID and ensure it exists
 
+
 ### PERMISSION_DENIED
 
 **Message:** Insufficient permissions  
 **Description:** The user does not have permission to perform this action  
 **Resolution:** Contact an administrator to grant the necessary permissions
 
+
+
+
 ---
 
 *Generated automatically from tool definitions - Do not edit manually*

package/docs/api/tools/wp_upload_media.md

@@ -22,13 +22,11 @@ Uploads a file to the WordPress media library.
 Simple example of using wp_upload_media
 
 **Command:**
-
 ```bash
 wp_upload_media --file_path="example_value"
 ```
 
 **Response:**
-
 ```json
 {
   "success": true,
@@ -38,7 +36,6 @@ wp_upload_media --file_path="example_value"
 ```
 
 **Error Example (Authentication failure):**
-
 ```json
 {
   "error": "Authentication failed",
@@ -46,18 +43,17 @@ wp_upload_media --file_path="example_value"
 }
 ```
 
+
 ### Advanced media Configuration
 
 Comprehensive example using all available parameters
 
 **Command:**
-
 ```bash
 wp_upload_media --file_path="example_value" --title="Example Post Title" --alt_text="example_value" --caption="example_value" --description="example_value" --post="example_value"
 ```
 
 **Response:**
-
 ```json
 {
   "success": true,
@@ -66,6 +62,11 @@ wp_upload_media --file_path="example_value" --title="Example Post Title" --alt_t
 }
 ```
 
+
+
+
+
+
 ## Required Permissions
 
 This tool requires the following WordPress user capabilities:
@@ -74,6 +75,7 @@ This tool requires the following WordPress user capabilities:
 
 **Note:** The authenticated user must have these capabilities to successfully execute this tool.
 
+
 ## Response Format
 
 **Return Type:** `object`
@@ -100,24 +102,30 @@ This tool requires the following WordPress user capabilities:
 **Description:** Invalid credentials or insufficient permissions  
 **Resolution:** Check your authentication credentials and user permissions
 
+
 ### VALIDATION_ERROR
 
 **Message:** Parameter validation failed  
 **Description:** One or more required parameters are missing or invalid  
 **Resolution:** Review the required parameters and their formats
 
+
 ### NOT_FOUND
 
 **Message:** Resource not found  
 **Description:** The requested resource does not exist  
 **Resolution:** Verify the resource ID and ensure it exists
 
+
 ### PERMISSION_DENIED
 
 **Message:** Insufficient permissions  
 **Description:** The user does not have permission to perform this action  
 **Resolution:** Contact an administrator to grant the necessary permissions
 
+
+
+
 ---
 
 *Generated automatically from tool definitions - Do not edit manually*

package/docs/api/types/WordPressPost.md

@@ -35,3 +35,5 @@ WordPress blog post object
   "slug": "welcome-to-wordpress"
 }
 ```
+
+

package/docs/code-improvements.md

@@ -0,0 +1,40 @@
+# Code Improvements TODO
+
+## Test Coverage Improvements Needed
+
+Based on coverage analysis, the following areas need attention:
+
+### Critical Areas (0% coverage)
+
+1. **Tool Implementations** (`src/tools/`):
+   - site.ts (0% coverage)
+   - taxonomies.ts (0% coverage)
+   - users.ts (0% coverage)
+   - media.ts (0.78% coverage)
+   - posts.ts (0.58% coverage)
+
+2. **Utility Functions** (`src/utils/`):
+   - enhancedError.ts (0% coverage)
+   - error.ts (0% coverage)
+   - streaming.ts (0% coverage)
+   - toolWrapper.ts (3.12% coverage)
+   - validation.ts (2.56% coverage)
+
+### Recommendations
+
+1. Add unit tests for all tool implementations
+2. Create test cases for error handling utilities
+3. Test streaming functionality with mock data
+4. Improve validation test coverage
+
+## Performance Optimizations
+
+1. Consider lazy loading for tool implementations
+2. Implement connection pooling for multi-site setups
+3. Add request batching for bulk operations
+
+## Documentation Improvements
+
+1. Add API documentation for each tool
+2. Create troubleshooting guide
+3. Add performance tuning guide

package/docs/contract-testing.md

@@ -115,7 +115,7 @@ The contract tests verify:
 - Retrieve posts with pagination
 - Response format validation
 
-### ✅ Media API  
+### ✅ Media API
 
 - File upload handling
 - Multipart form data

package/docs/developer/API_REFERENCE.md

@@ -55,18 +55,9 @@ Handles multiple WordPress authentication methods.
 ```typescript
 class AuthenticationManager {
   // Authentication methods
-  async authenticateWithAppPassword(
-    username: string,
-    password: string,
-  ): Promise<AuthResult>;
-  async authenticateWithJWT(
-    username: string,
-    password: string,
-  ): Promise<AuthResult>;
-  async authenticateWithBasic(
-    username: string,
-    password: string,
-  ): Promise<AuthResult>;
+  async authenticateWithAppPassword(username: string, password: string): Promise<AuthResult>;
+  async authenticateWithJWT(username: string, password: string): Promise<AuthResult>;
+  async authenticateWithBasic(username: string, password: string): Promise<AuthResult>;
   async authenticateWithApiKey(apiKey: string): Promise<AuthResult>;
 
   // Token management
@@ -119,9 +110,7 @@ class PostTools {
   async deletePost(params: DeletePostParams): Promise<DeleteResult>;
   async getPost(params: GetPostParams): Promise<PostResult>;
   async listPosts(params: ListPostsParams): Promise<PostListResult>;
-  async getPostRevisions(
-    params: GetPostRevisionsParams,
-  ): Promise<PostRevisionsResult>;
+  async getPostRevisions(params: GetPostRevisionsParams): Promise<PostRevisionsResult>;
 }
 ```
 
@@ -168,9 +157,7 @@ class PageTools {
   async deletePage(params: DeletePageParams): Promise<DeleteResult>;
   async getPage(params: GetPageParams): Promise<PageResult>;
   async listPages(params: ListPagesParams): Promise<PageListResult>;
-  async getPageRevisions(
-    params: GetPageRevisionsParams,
-  ): Promise<PageRevisionsResult>;
+  async getPageRevisions(params: GetPageRevisionsParams): Promise<PageRevisionsResult>;
 }
 ```
 
@@ -224,9 +211,7 @@ class CommentTools {
   async getComment(params: GetCommentParams): Promise<CommentResult>;
   async listComments(params: ListCommentsParams): Promise<CommentListResult>;
   async moderateComment(params: ModerateCommentParams): Promise<CommentResult>;
-  async bulkModerateComments(
-    params: BulkModerateCommentsParams,
-  ): Promise<BulkResult>;
+  async bulkModerateComments(params: BulkModerateCommentsParams): Promise<BulkResult>;
 }
 ```
 
@@ -239,9 +224,7 @@ class TaxonomyTools {
   async updateCategory(params: UpdateCategoryParams): Promise<CategoryResult>;
   async deleteCategory(params: DeleteCategoryParams): Promise<DeleteResult>;
   async getCategory(params: GetCategoryParams): Promise<CategoryResult>;
-  async listCategories(
-    params: ListCategoriesParams,
-  ): Promise<CategoryListResult>;
+  async listCategories(params: ListCategoriesParams): Promise<CategoryListResult>;
 
   // Tags
   async createTag(params: CreateTagParams): Promise<TagResult>;
@@ -257,9 +240,7 @@ class TaxonomyTools {
 ```typescript
 class SiteTools {
   async getSiteInfo(params: GetSiteInfoParams): Promise<SiteInfoResult>;
-  async updateSiteSettings(
-    params: UpdateSiteSettingsParams,
-  ): Promise<SiteSettingsResult>;
+  async updateSiteSettings(params: UpdateSiteSettingsParams): Promise<SiteSettingsResult>;
   async getSiteStats(params: GetSiteStatsParams): Promise<SiteStatsResult>;
   async getPlugins(params: GetPluginsParams): Promise<PluginsResult>;
   async getThemes(params: GetThemesParams): Promise<ThemesResult>;
@@ -273,9 +254,7 @@ class SiteTools {
 class AuthTools {
   async testAuth(params: TestAuthParams): Promise<AuthTestResult>;
   async refreshToken(params: RefreshTokenParams): Promise<TokenResult>;
-  async validatePermissions(
-    params: ValidatePermissionsParams,
-  ): Promise<PermissionsResult>;
+  async validatePermissions(params: ValidatePermissionsParams): Promise<PermissionsResult>;
 }
 ```
 
@@ -286,9 +265,7 @@ class CacheTools {
   async getCacheStats(params: GetCacheStatsParams): Promise<CacheStatsResult>;
   async clearCache(params: ClearCacheParams): Promise<ClearCacheResult>;
   async warmCache(params: WarmCacheParams): Promise<WarmCacheResult>;
-  async setCacheConfig(
-    params: SetCacheConfigParams,
-  ): Promise<CacheConfigResult>;
+  async setCacheConfig(params: SetCacheConfigParams): Promise<CacheConfigResult>;
 }
 ```
 
@@ -296,24 +273,12 @@ class CacheTools {
 
 ```typescript
 class PerformanceTools {
-  async getPerformanceMetrics(
-    params: GetPerformanceMetricsParams,
-  ): Promise<PerformanceMetricsResult>;
-  async runPerformanceTest(
-    params: RunPerformanceTestParams,
-  ): Promise<PerformanceTestResult>;
-  async getSystemHealth(
-    params: GetSystemHealthParams,
-  ): Promise<SystemHealthResult>;
-  async benchmarkOperations(
-    params: BenchmarkOperationsParams,
-  ): Promise<BenchmarkResult>;
-  async getOptimizationSuggestions(
-    params: GetOptimizationSuggestionsParams,
-  ): Promise<OptimizationResult>;
-  async monitorRealTimeMetrics(
-    params: MonitorRealTimeMetricsParams,
-  ): Promise<RealTimeMetricsResult>;
+  async getPerformanceMetrics(params: GetPerformanceMetricsParams): Promise<PerformanceMetricsResult>;
+  async runPerformanceTest(params: RunPerformanceTestParams): Promise<PerformanceTestResult>;
+  async getSystemHealth(params: GetSystemHealthParams): Promise<SystemHealthResult>;
+  async benchmarkOperations(params: BenchmarkOperationsParams): Promise<BenchmarkResult>;
+  async getOptimizationSuggestions(params: GetOptimizationSuggestionsParams): Promise<OptimizationResult>;
+  async monitorRealTimeMetrics(params: MonitorRealTimeMetricsParams): Promise<RealTimeMetricsResult>;
 }
 ```
 
@@ -573,12 +538,7 @@ class DebugLogger {
   static log(level: LogLevel, message: string, context?: any): void;
   static error(error: Error, context?: any): void;
   static performance(operation: string, duration: number): void;
-  static http(
-    method: string,
-    url: string,
-    status: number,
-    duration: number,
-  ): void;
+  static http(method: string, url: string, status: number, duration: number): void;
 }
 ```
 
@@ -664,5 +624,5 @@ const server = new MCPWordPressServer({
 
 ---
 
-**Need more details?** This API reference covers the complete technical interface. For implementation
-examples, see the source code in `src/` directory.
+**Need more details?** This API reference covers the complete technical interface. For implementation examples, see the
+source code in `src/` directory.

package/docs/developer/ARCHITECTURE.md

@@ -4,7 +4,8 @@ This guide explains the system architecture and design patterns used in the MCP
 
 ## 🏗️ Overall Architecture
 
-The MCP WordPress Server follows a modular, layered architecture designed for scalability, maintainability, and extensibility.
+The MCP WordPress Server follows a modular, layered architecture designed for scalability, maintainability, and
+extensibility.
 
 ```text
 ┌─────────────────────────────────────────────────────────────┐
@@ -309,10 +310,8 @@ Commit → CI/CD Pipeline → Tests → Security Scan → Publishing
 
 ### Request Optimization
 
-**Batching**: Group related requests
-**Deduplication**: Eliminate duplicate requests
-**Connection Pooling**: Reuse HTTP connections
-**Compression**: Reduce payload size
+**Batching**: Group related requests **Deduplication**: Eliminate duplicate requests **Connection Pooling**: Reuse HTTP
+connections **Compression**: Reduce payload size
 
 ## 🔮 Extensibility
 
@@ -356,10 +355,8 @@ Commit → CI/CD Pipeline → Tests → Security Scan → Publishing
 
 ### Logging Strategy
 
-**Structured Logging**: JSON format for parsing
-**Log Levels**: DEBUG, INFO, WARN, ERROR
-**Contextual Information**: Request IDs, user context
-**Security Logging**: Authentication events, suspicious activity
+**Structured Logging**: JSON format for parsing **Log Levels**: DEBUG, INFO, WARN, ERROR **Contextual Information**:
+Request IDs, user context **Security Logging**: Authentication events, suspicious activity
 
 ## 📚 Further Reading
 
@@ -370,5 +367,5 @@ Commit → CI/CD Pipeline → Tests → Security Scan → Publishing
 
 ---
 
-**Understanding the architecture?** This foundation enables the system's reliability, performance,
-and extensibility. Each component is designed to be testable, maintainable, and scalable.
+**Understanding the architecture?** This foundation enables the system's reliability, performance, and extensibility.
+Each component is designed to be testable, maintainable, and scalable.

package/docs/developer/BUILD_SYSTEM.md

@@ -456,5 +456,5 @@ npm install -g webpack-bundle-analyzer
 
 ---
 
-**Optimizing your build?** This build system is designed for both development speed and
-production efficiency. Each configuration option is tuned for optimal performance.
+**Optimizing your build?** This build system is designed for both development speed and production efficiency. Each
+configuration option is tuned for optimal performance.

package/docs/developer/CONTRIBUTING.md

@@ -215,9 +215,7 @@ describe("PostTools", () => {
     test("should handle API errors gracefully", async () => {
       mockClient.posts.create.mockRejectedValue(new Error("API Error"));
 
-      await expect(postTools.createPost(validParams)).rejects.toThrow(
-        "API Error",
-      );
+      await expect(postTools.createPost(validParams)).rejects.toThrow("API Error");
     });
   });
 });
@@ -465,5 +463,5 @@ Please read it to understand the expected behavior in our community.
 
 ---
 
-**Ready to contribute?** Thank you for your interest in improving the MCP WordPress Server! Every
-contribution, no matter how small, helps make this project better for everyone. 🚀
+**Ready to contribute?** Thank you for your interest in improving the MCP WordPress Server! Every contribution, no
+matter how small, helps make this project better for everyone. 🚀

package/docs/developer/GITHUB_ACTIONS_SETUP.md

@@ -2,8 +2,8 @@
 
 ## Overview
 
-The MCP WordPress project includes comprehensive GitHub Actions workflows for automated testing, quality
-assurance, and NPM publishing.
+The MCP WordPress project includes comprehensive GitHub Actions workflows for automated testing, quality assurance, and
+NPM publishing.
 
 ## Workflows
 

package/docs/developer/MIGRATION_GUIDE.md

@@ -1,7 +1,7 @@
 # Migration Guide: Single-Site to Multi-Site Configuration
 
-This guide helps you migrate from the previous single-site configuration to the new multi-site
-configuration introduced in v2.0.0.
+This guide helps you migrate from the previous single-site configuration to the new multi-site configuration introduced
+in v2.0.0.
 
 ## Breaking Changes
 
@@ -15,8 +15,7 @@ WORDPRESS_USERNAME=admin
 WORDPRESS_APP_PASSWORD=xxxx xxxx xxxx xxxx xxxx xxxx
 ```
 
-**New Method (Configuration File):**
-Create a `mcp-wordpress.config.json` file:
+**New Method (Configuration File):** Create a `mcp-wordpress.config.json` file:
 
 ```json
 {
@@ -162,8 +161,8 @@ wp_create_post --site="site2" --title="New Blog Post"
 
 ## Backward Compatibility
 
-The server maintains backward compatibility with environment variables. If no `mcp-wordpress.config.json`
-file is found, it will fall back to using environment variables as before.
+The server maintains backward compatibility with environment variables. If no `mcp-wordpress.config.json` file is found,
+it will fall back to using environment variables as before.
 
 ## Troubleshooting
 

package/docs/developer/README.md

@@ -239,4 +239,5 @@ npm run status             # Check connection status
 
 ---
 
-**Ready to contribute?** Start with the [Development Setup](DEVELOPMENT_SETUP.md) guide and join our community of contributors!
+**Ready to contribute?** Start with the [Development Setup](DEVELOPMENT_SETUP.md) guide and join our community of
+contributors!