claude-plugin-wordpress-manager 1.7.2 → 1.8.0

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "wordpress-manager",
-  "version": "1.7.2",
-  "description": "Unified WordPress management plugin for Claude Code. Orchestrates Hostinger MCP (infrastructure), WP REST API bridge (content), and WordPress.com MCP (hosted sites) with 8 specialized agents, 24 skills, and security hooks for multi-site WordPress operations. Includes local dev environment support for WordPress Studio, LocalWP, and wp-env. Covers development, testing, security, i18n, accessibility, headless, and operations.",
+  "version": "1.8.0",
+  "description": "Unified WordPress management plugin for Claude Code. Orchestrates Hostinger MCP (infrastructure), WP REST API bridge (content + WooCommerce), and WordPress.com MCP (hosted sites) with 9 specialized agents, 25 skills, and security hooks for multi-site WordPress operations. Includes WooCommerce store management (30 tools), local dev environment support, development, testing, security, i18n, accessibility, headless, and operations.",
   "author": {
     "name": "vinmor",
     "email": "morreale.v@gmail.com"
@@ -17,7 +17,9 @@
     "local-development",
     "wordpress-studio",
     "localwp",
-    "wp-env"
+    "wp-env",
+    "woocommerce",
+    "ecommerce"
   ],
   "mcpServers": "./.mcp.json"
 }

package/CHANGELOG.md

@@ -2,6 +2,34 @@
 
 All notable changes to the WordPress Manager plugin for Claude Code.
 
+## [1.8.0] - 2026-02-28
+
+### Added
+- **WooCommerce support** — 30 new MCP tools via WP REST Bridge (`wc/v3` namespace)
+  - `wc-products.ts` (7 tools): CRUD products, categories, variations
+  - `wc-orders.ts` (6 tools): List, get, update status, notes, refunds
+  - `wc-customers.ts` (4 tools): List, get, create, update customers
+  - `wc-coupons.ts` (4 tools): CRUD coupons with discount rules
+  - `wc-reports.ts` (5 tools): Sales, top sellers, order/product/customer totals
+  - `wc-settings.ts` (4 tools): Payment gateways, shipping zones, tax classes, system status
+- **`wp-woocommerce` skill** — WooCommerce operations with decision tree and 8 reference files
+  - Reference files: product-management, order-workflow, analytics-reports, coupon-marketing, shipping-setup, payment-gateways, tax-configuration, wc-extensions
+- **`wp-ecommerce-manager` agent** — WooCommerce store management (color: orange)
+  - 5 procedures: product catalog, order processing, sales analytics, coupon campaigns, store health
+  - Report template with KPIs and recommendations
+- **`woocommerce_inspect.mjs`** detection script — scans for WC plugin, hooks, composer deps, API config
+- WooCommerce authentication: Consumer Key/Secret via separate AxiosInstance in WP REST Bridge
+  - `SiteConfig` extended with optional `wc_consumer_key`/`wc_consumer_secret`
+  - `makeWooCommerceRequest()` reusing existing retry and concurrency logic
+- WC types: `WCProduct`, `WCOrder`, `WCCustomer`, `WCCoupon` in types.ts
+
+### Changed
+- Router upgraded to v5 — WooCommerce keywords in Step 0 + Step 2b routing entry
+- `wp-site-manager` agent — added `wp-ecommerce-manager` to delegation table
+- Cross-references added to `wp-audit`, `wp-deploy`, `wp-backup` skills
+- WP REST Bridge: 41 → 71 total tools
+- Version bumps: plugin.json + package.json → 1.8.0 (25 skills, 9 agents)
+
 ## [1.7.2] - 2026-02-28
 
 ### Changed

package/agents/wp-ecommerce-manager.md

@@ -0,0 +1,136 @@
+---
+name: wp-ecommerce-manager
+color: orange
+description: |
+  Use this agent when the user needs to manage a WooCommerce store: products, orders,
+  customers, coupons, analytics, or store configuration.
+
+  <example>
+  Context: User wants to check recent orders and update their status.
+  user: "Mostrami gli ordini degli ultimi 7 giorni e segna come completati quelli spediti"
+  assistant: "I'll use the wp-ecommerce-manager agent to list recent orders and update their status."
+  <commentary>Order management with status updates requires the WooCommerce agent for safe multi-step operations.</commentary>
+  </example>
+
+  <example>
+  Context: User needs to set up a product catalog.
+  user: "Crea 5 prodotti nel catalogo WooCommerce con variazioni di taglia"
+  assistant: "I'll use the wp-ecommerce-manager agent to create variable products with size variations."
+  <commentary>Bulk product creation with variations is a multi-step WooCommerce operation.</commentary>
+  </example>
+
+  <example>
+  Context: User wants a sales performance overview.
+  user: "Fammi un report delle vendite di questo mese con i prodotti piu venduti"
+  assistant: "I'll use the wp-ecommerce-manager agent to generate a monthly sales report with top sellers."
+  <commentary>Sales analytics combining multiple report endpoints requires the WooCommerce agent.</commentary>
+  </example>
+
+model: inherit
+tools: Read, Grep, Glob, Bash, WebFetch, WebSearch
+---
+
+# WooCommerce E-Commerce Manager
+
+Specialized agent for WooCommerce store management. Handles product catalog, order processing, customer management, coupon marketing, sales analytics, and store configuration through the WP REST Bridge WooCommerce tools (30 MCP tools, `wc/v3` namespace).
+
+## Available MCP Tool Sets
+
+### 1. WP REST Bridge — WooCommerce (wc_ prefix)
+
+All tools require WooCommerce credentials in `WP_SITES_CONFIG` (`wc_consumer_key` + `wc_consumer_secret`).
+
+- **Products (7)**: `wc_list_products`, `wc_get_product`, `wc_create_product`, `wc_update_product`, `wc_delete_product`, `wc_list_product_categories`, `wc_list_product_variations`
+- **Orders (6)**: `wc_list_orders`, `wc_get_order`, `wc_update_order_status`, `wc_list_order_notes`, `wc_create_order_note`, `wc_create_refund`
+- **Customers (4)**: `wc_list_customers`, `wc_get_customer`, `wc_create_customer`, `wc_update_customer`
+- **Coupons (4)**: `wc_list_coupons`, `wc_get_coupon`, `wc_create_coupon`, `wc_delete_coupon`
+- **Reports (5)**: `wc_get_sales_report`, `wc_get_top_sellers`, `wc_get_orders_totals`, `wc_get_products_totals`, `wc_get_customers_totals`
+- **Settings (4)**: `wc_list_payment_gateways`, `wc_list_shipping_zones`, `wc_get_tax_classes`, `wc_get_system_status`
+
+### 2. WP REST Bridge — WordPress (wp/v2)
+
+For cross-referencing with WordPress content:
+- **Content**: `list_content`, `get_content`, `create_content` (pages for shop, cart, checkout)
+- **Plugins**: `list_plugins` (verify WooCommerce active)
+- **Media**: `upload_media` (product images)
+
+## Operating Procedures
+
+### Product Catalog Setup
+
+1. Verify WooCommerce active: `list_plugins` → check woocommerce status
+2. Create categories: use WooCommerce admin or REST API
+3. Create products: `wc_create_product` with name, price, description, categories, images
+4. For variable products: create parent (type: 'variable') → add attributes → create variations
+5. Verify: `wc_list_products` with status filter
+
+### Order Processing
+
+1. List pending orders: `wc_list_orders` with status='processing'
+2. Review order details: `wc_get_order` for each order
+3. Update status: `wc_update_order_status` (processing → completed)
+4. Add notes: `wc_create_order_note` for tracking info
+5. Handle refunds: `wc_create_refund` with amount and reason
+
+### Sales Analytics
+
+1. Get sales overview: `wc_get_sales_report` with period or date range
+2. Get top products: `wc_get_top_sellers`
+3. Get totals: `wc_get_orders_totals` + `wc_get_products_totals` + `wc_get_customers_totals`
+4. Present as structured report with KPIs (AOV, revenue trend, top sellers)
+
+### Coupon Campaign
+
+1. Define strategy: discount type (percent/fixed), target, limits
+2. Create coupon: `wc_create_coupon` with rules
+3. Verify: `wc_get_coupon` to confirm settings
+4. Monitor: `wc_list_coupons` to check usage_count
+
+### Store Health Check
+
+1. System status: `wc_get_system_status` (WC version, environment, DB)
+2. Payment gateways: `wc_list_payment_gateways` (verify active gateways)
+3. Shipping: `wc_list_shipping_zones` (verify zone coverage)
+4. Tax: `wc_get_tax_classes` (verify tax configuration)
+
+## Report Format
+
+```
+## WooCommerce Store Report — [Site Name]
+
+### Sales Summary (period)
+- Total Sales: $X,XXX
+- Net Sales: $X,XXX
+- Orders: XX
+- Average Order Value: $XX.XX
+- Items Sold: XX
+
+### Top Sellers
+1. Product Name — XX units ($X,XXX revenue)
+2. ...
+
+### Order Status
+- Processing: XX
+- Completed: XX
+- On Hold: XX
+- Refunded: XX
+
+### Recommendations
+- [Actionable items based on data]
+```
+
+## Safety Rules
+
+- NEVER delete products without explicit user confirmation
+- NEVER process refunds without verifying order details and getting user approval
+- ALWAYS confirm before changing order status (especially to cancelled/refunded)
+- ALWAYS verify WooCommerce credentials are configured before attempting operations
+- NEVER expose Consumer Key/Secret in output or logs
+- When creating bulk products, confirm the list with user before executing
+
+## Related Skills
+
+- `wp-woocommerce` — Decision tree and reference files for all WC operations
+- `wp-deploy` — Deploy store changes to production
+- `wp-backup` — Backup store database before bulk operations
+- `wp-audit` — Security and performance audit for WC stores

package/agents/wp-site-manager.md

@@ -121,3 +121,4 @@ For domain-specific tasks, delegate to specialized agents:
 | Performance optimization | `wp-performance-optimizer` | Speed analysis and optimization |
 | Content creation / SEO | `wp-content-strategist` | Content workflows and SEO |
 | Deploy to production | `wp-deployment-engineer` | Plugin, theme, site deployment |
+| WooCommerce store management | `wp-ecommerce-manager` | Products, orders, customers, coupons, analytics |

package/docs/plans/2026-02-28-roadmap-v1.8-v2.1-design.md

@@ -0,0 +1,314 @@
+# Roadmap v1.8.0 — v2.1.0: WooCommerce, Multisite, CI/CD, Monitoring
+
+**Data:** 2026-02-28
+**Stato:** Approvato
+**Baseline:** v1.7.2 (24 skill, 8 agent, ~175 MCP tools, 12 detection scripts)
+
+---
+
+## Approccio
+
+Release incrementali — ogni feature e una minor release indipendente, dalla piu autocontenuta alla piu complessa. Questo permette testing e pubblicazione progressiva.
+
+| Release | Feature | Complessita |
+|---------|---------|-------------|
+| v1.8.0 | WooCommerce | Alta (nuovi MCP tools + skill + agent) |
+| v1.9.0 | Multisite | Media (skill + MCP tools, no agent nuovo) |
+| v2.0.0 | CI/CD | Media (agent + skill, no MCP tools) |
+| v2.1.0 | Monitoring | Alta (agent + skill, orchestrazione multi-check) |
+
+---
+
+## v1.8.0 — WooCommerce
+
+### Contesto
+
+WooCommerce usa il namespace REST `/wc/v3/` (separato da `/wp/v2/`). Richiede autenticazione propria (Consumer Key + Consumer Secret). Target: siti futuri e siti clienti/terzi.
+
+### Componenti
+
+| Tipo | Nome | Descrizione |
+|------|------|-------------|
+| Skill | `wp-woocommerce` | Prodotti, ordini, analytics, coupon, impostazioni |
+| Agent | `wp-ecommerce-manager` | Gestione operativa negozio (color: orange) |
+| MCP Tools | 6 file TypeScript | ~30 nuovi tool nel WP REST Bridge |
+| Detection | `woocommerce_inspect.mjs` | Rileva WooCommerce, versione, estensioni |
+
+### WP REST Bridge — Nuovi Tool
+
+| File | Categoria | Tool | Endpoint |
+|------|-----------|------|----------|
+| `wc-products.ts` | Prodotti | 7 | CRUD prodotti, variazioni, categorie, tag, attributi |
+| `wc-orders.ts` | Ordini | 6 | Lista, dettaglio, aggiorna stato, note, refund |
+| `wc-customers.ts` | Clienti | 4 | Lista, dettaglio, ordini cliente, totale speso |
+| `wc-coupons.ts` | Coupon | 4 | CRUD coupon, validazione |
+| `wc-reports.ts` | Report | 5 | Vendite, top prodotti, top categorie, revenue |
+| `wc-settings.ts` | Impostazioni | 4 | Valuta, tasse, spedizione, pagamenti |
+
+### Autenticazione
+
+Estensione di `WP_SITES_CONFIG` con campi opzionali:
+
+```json
+{
+  "id": "myshop",
+  "url": "https://myshop.com",
+  "username": "admin",
+  "password": "xxxx xxxx xxxx xxxx",
+  "wc_consumer_key": "ck_xxxx",
+  "wc_consumer_secret": "cs_xxxx"
+}
+```
+
+Se `wc_consumer_key` e assente, i tool WooCommerce non sono disponibili per quel sito. Il server TypeScript crea un secondo AxiosInstance per `/wc/v3/` con Basic Auth (consumer_key:consumer_secret).
+
+### Skill Reference Files (8)
+
+| File | Contenuto |
+|------|-----------|
+| `product-management.md` | CRUD prodotti, variazioni, bulk operations |
+| `order-workflow.md` | Ciclo di vita ordine, stati, transizioni |
+| `analytics-reports.md` | Report vendite, metriche chiave, date range |
+| `coupon-marketing.md` | Strategie coupon, condizioni, limiti |
+| `shipping-setup.md` | Zone spedizione, metodi, classi |
+| `payment-gateways.md` | Configurazione gateway, test mode |
+| `tax-configuration.md` | Tasse per paese, classi fiscali |
+| `wc-extensions.md` | Estensioni comuni, compatibilita |
+
+### Agent `wp-ecommerce-manager`
+
+- Color: orange
+- Tools: Read, Grep, Glob, Bash, WebFetch, WebSearch
+- Procedure: gestione catalogo, monitoraggio ordini, report vendite, setup negozio, troubleshooting
+- Safety: conferma prima di modificare ordini, non cancellare prodotti senza backup, verifica stock prima di aggiornamenti bulk
+
+### Router
+
+Step 2b (operations):
+```
+"prodotto, ordine, WooCommerce, negozio, coupon, vendite, catalogo, inventario"
+  → wp-woocommerce skill + wp-ecommerce-manager agent
+```
+
+### Modifiche al Server TypeScript
+
+- `types.ts`: aggiungere tipo `WooCommerceConfig` e estendere `SiteConfig`
+- `wordpress.ts`: creare `wcClientMap: Map<siteId, AxiosInstance>` per richieste WC
+- `tools/index.ts`: importare e registrare i 6 nuovi file tool
+
+---
+
+## v1.9.0 — Multisite
+
+### Contesto
+
+WordPress Multisite usa le stesse REST API ma richiede utente Super Admin. Nessun agent nuovo — il `wp-site-manager` viene esteso.
+
+### Componenti
+
+| Tipo | Nome | Descrizione |
+|------|------|-------------|
+| Skill | `wp-multisite` | Network admin, site management, domain mapping |
+| Agent | — | Estensione di `wp-site-manager` |
+| MCP Tools | 2 file TypeScript | ~10 nuovi tool |
+| Detection | `multisite_inspect.mjs` | Rileva multisite, sub-siti, network admin |
+
+### WP REST Bridge — Nuovi Tool
+
+| File | Categoria | Tool | Endpoint |
+|------|-----------|------|----------|
+| `multisite-sites.ts` | Siti network | 5 | Lista, crea, attiva/disattiva, elimina, dettaglio |
+| `multisite-network.ts` | Network admin | 5 | Plugin/temi network, utenti network, impostazioni |
+
+I tool verificano automaticamente che l'utente sia Super Admin prima di eseguire operazioni network.
+
+### Skill Reference Files (6)
+
+| File | Contenuto |
+|------|-----------|
+| `network-setup.md` | Installazione multisite, sub-directory vs sub-domain |
+| `site-management.md` | CRUD sub-siti, template, clonazione |
+| `domain-mapping.md` | Domini personalizzati, SSL per sub-siti |
+| `network-plugins.md` | Plugin network-activated vs per-sito |
+| `user-roles.md` | Super Admin, site roles, capabilities |
+| `migration-multisite.md` | Single → multisite e viceversa |
+
+### Router
+
+Step 2b (operations):
+```
+"multisite, network, sub-sito, domain mapping, super admin"
+  → wp-multisite skill + wp-site-manager agent
+```
+
+### Aggiornamento `wp-site-manager`
+
+Aggiungere sezione "## Multisite Network Management" con procedure per lista sub-siti, creazione, plugin network-wide, domain mapping.
+
+---
+
+## v2.0.0 — CI/CD
+
+### Contesto
+
+Agent e skill per pipeline CI/CD WordPress. Supporto multi-piattaforma (GitHub Actions, GitLab CI, Bitbucket Pipelines). Nessun nuovo MCP tool — usa Bash, Read, Write.
+
+### Componenti
+
+| Tipo | Nome | Descrizione |
+|------|------|-------------|
+| Skill | `wp-cicd` | Pipeline CI/CD per WordPress multi-piattaforma |
+| Agent | `wp-cicd-engineer` | Configura e gestisce pipeline (color: cyan) |
+| Detection | `cicd_inspect.mjs` | Rileva CI config, workflow, secret |
+
+### Piattaforme
+
+| Piattaforma | Config | Template |
+|-------------|--------|----------|
+| GitHub Actions | `.github/workflows/*.yml` | PHP lint + PHPStan + Playwright + deploy |
+| GitLab CI | `.gitlab-ci.yml` | Pipeline multi-stage equivalente |
+| Bitbucket Pipelines | `bitbucket-pipelines.yml` | Pipeline equivalente |
+
+### Skill Reference Files (7)
+
+| File | Contenuto |
+|------|-----------|
+| `github-actions-wordpress.md` | Workflow completi per WP |
+| `gitlab-ci-wordpress.md` | Pipeline GitLab |
+| `bitbucket-pipelines-wordpress.md` | Pipeline Bitbucket |
+| `wp-env-ci.md` | Setup wp-env in CI per test E2E |
+| `deploy-strategies.md` | Blue-green, rolling, canary per WP |
+| `secrets-management.md` | SSH keys, API tokens, env vars sicure |
+| `quality-gates.md` | PHPStan, PHPCS, coverage threshold |
+
+### Agent `wp-cicd-engineer`
+
+- Color: cyan
+- Tools: Read, Grep, Glob, Bash, Write, WebFetch, WebSearch
+- Procedure: detect CI, generate pipeline, configure secrets, quality gates, deploy stage, troubleshoot
+- Safety: non eseguire deploy da CI senza approvazione, non esporre secret in log, validare YAML prima di commit
+
+### Router
+
+Step 2a (development):
+```
+"CI, CD, pipeline, GitHub Actions, GitLab CI, deploy automatico, workflow, quality gate"
+  → wp-cicd skill + wp-cicd-engineer agent
+```
+
+### Cross-references
+
+- `wp-e2e-testing` → "Per integrazione CI, vedi `wp-cicd`"
+- `wp-deploy` → "Per deploy automatici, vedi `wp-cicd`"
+- `wp-phpstan` → "Per quality gates, vedi `wp-cicd`"
+
+---
+
+## v2.1.0 — Monitoring
+
+### Contesto
+
+Agent e skill per monitoraggio unificato: uptime, performance, security, content integrity. Usa tool MCP esistenti + script Bash per metriche esterne.
+
+### Componenti
+
+| Tipo | Nome | Descrizione |
+|------|------|-------------|
+| Skill | `wp-monitoring` | Strategie monitoraggio WordPress |
+| Agent | `wp-monitoring-agent` | Monitoraggio unificato (color: teal) |
+| Detection | `monitoring_inspect.mjs` | Rileva monitoring esistente |
+
+### Aree di Monitoraggio
+
+| Area | Cosa | Come |
+|------|------|------|
+| Uptime | HTTP, SSL, response time | WP REST Bridge + health-check.sh |
+| Performance | TTFB, CWV trends | Lighthouse CLI, WebFetch |
+| Security | Plugin outdated, vulnerabilita, file integrity | list_plugins + security_inspect.mjs |
+| Content | Modifiche non autorizzate, link rotti, spam | list_content + list_comments |
+
+### Skill Reference Files (6)
+
+| File | Contenuto |
+|------|-----------|
+| `uptime-checks.md` | HTTP probe, SSL monitoring, cron |
+| `performance-baseline.md` | Baseline CWV, trend analysis |
+| `security-scanning.md` | CVE check, file integrity, malware |
+| `content-integrity.md` | Rilevamento modifiche, link checking |
+| `alerting-strategies.md` | Soglie alert, escalation |
+| `reporting-templates.md` | Template report giornaliero/settimanale |
+
+### Agent `wp-monitoring-agent`
+
+- Color: teal
+- Tools: Read, Grep, Glob, Bash, WebFetch, WebSearch
+- Procedure: baseline, uptime check, performance scan, security scan, content audit, generate report
+- Report format: markdown strutturato con severity e raccomandazioni
+- Safety: no modifiche al sito (solo lettura), segnala anomalie senza intervenire
+
+### Router
+
+Step 2b (operations):
+```
+"monitora, uptime, health report, trend, scansione periodica"
+  → wp-monitoring skill + wp-monitoring-agent agent
+```
+
+### Cross-references
+
+- `wp-audit` → "Per monitoraggio continuo, vedi `wp-monitoring`"
+- `wp-security-auditor` → "Per scansioni periodiche, vedi `wp-monitoring-agent`"
+- `wp-performance-optimizer` → "Per trend performance, vedi `wp-monitoring`"
+
+---
+
+## Riepilogo Finale
+
+### Conteggi a fine roadmap
+
+| Metrica | v1.7.2 (oggi) | v2.1.0 (target) | Delta |
+|---------|---------------|-----------------|-------|
+| Skills | 24 | 28 | +4 |
+| Agents | 8 | 11 | +3 |
+| MCP Tools | ~175 | ~215 | +40 |
+| Detection scripts | 12 | 16 | +4 |
+| Reference files | 106 | 133 | +27 |
+
+### Ordine di Implementazione
+
+```
+v1.8.0 — WooCommerce
+  1. Estensione types.ts e wordpress.ts per WC auth
+  2. 6 file tool TypeScript (wc-products, wc-orders, wc-customers, wc-coupons, wc-reports, wc-settings)
+  3. Detection script woocommerce_inspect.mjs
+  4. Skill wp-woocommerce (SKILL.md + 8 reference files)
+  5. Agent wp-ecommerce-manager.md
+  6. Router update + cross-references
+  7. Version bump + CHANGELOG + GUIDE.md
+  8. Build, test, commit, publish npm + GitHub release
+
+v1.9.0 — Multisite
+  1. 2 file tool TypeScript (multisite-sites, multisite-network)
+  2. Detection script multisite_inspect.mjs
+  3. Skill wp-multisite (SKILL.md + 6 reference files)
+  4. Aggiornamento wp-site-manager.md
+  5. Router update + cross-references
+  6. Version bump + CHANGELOG + GUIDE.md
+  7. Build, test, commit, publish npm + GitHub release
+
+v2.0.0 — CI/CD
+  1. Detection script cicd_inspect.mjs
+  2. Skill wp-cicd (SKILL.md + 7 reference files)
+  3. Agent wp-cicd-engineer.md
+  4. Router update + cross-references
+  5. Version bump + CHANGELOG + GUIDE.md
+  6. Commit, publish npm + GitHub release
+
+v2.1.0 — Monitoring
+  1. Detection script monitoring_inspect.mjs
+  2. Skill wp-monitoring (SKILL.md + 6 reference files)
+  3. Agent wp-monitoring-agent.md
+  4. Router update + cross-references
+  5. Version bump + CHANGELOG + GUIDE.md
+  6. Commit, publish npm + GitHub release
+```