claude-plugin-wordpress-manager 2.6.0 → 2.9.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (50) hide show
  1. package/CHANGELOG.md +61 -0
  2. package/agents/wp-monitoring-agent.md +44 -0
  3. package/agents/wp-site-manager.md +19 -0
  4. package/docs/GUIDE.md +145 -14
  5. package/docs/plans/2026-03-01-tier4-5-implementation.md +1783 -0
  6. package/docs/plans/2026-03-01-tier4-5-observability-automation-design.md +426 -0
  7. package/docs/plans/2026-03-01-wcop-reassessment-v2.6.0.md +403 -0
  8. package/hooks/hooks.json +9 -0
  9. package/package.json +10 -3
  10. package/servers/wp-rest-bridge/build/tools/cwv.d.ts +3 -0
  11. package/servers/wp-rest-bridge/build/tools/cwv.js +196 -0
  12. package/servers/wp-rest-bridge/build/tools/ga4.d.ts +3 -0
  13. package/servers/wp-rest-bridge/build/tools/ga4.js +323 -0
  14. package/servers/wp-rest-bridge/build/tools/index.js +15 -0
  15. package/servers/wp-rest-bridge/build/tools/plausible.d.ts +3 -0
  16. package/servers/wp-rest-bridge/build/tools/plausible.js +207 -0
  17. package/servers/wp-rest-bridge/build/tools/slack.d.ts +3 -0
  18. package/servers/wp-rest-bridge/build/tools/slack.js +129 -0
  19. package/servers/wp-rest-bridge/build/tools/wc-workflows.d.ts +3 -0
  20. package/servers/wp-rest-bridge/build/tools/wc-workflows.js +222 -0
  21. package/servers/wp-rest-bridge/build/wordpress.d.ts +18 -0
  22. package/servers/wp-rest-bridge/build/wordpress.js +139 -0
  23. package/skills/wordpress-router/SKILL.md +1 -1
  24. package/skills/wordpress-router/references/decision-tree.md +8 -2
  25. package/skills/wp-alerting/SKILL.md +142 -0
  26. package/skills/wp-alerting/references/alert-thresholds.md +79 -0
  27. package/skills/wp-alerting/references/escalation-paths.md +92 -0
  28. package/skills/wp-alerting/references/report-scheduling.md +142 -0
  29. package/skills/wp-alerting/references/slack-integration.md +109 -0
  30. package/skills/wp-alerting/scripts/alerting_inspect.mjs +150 -0
  31. package/skills/wp-analytics/SKILL.md +158 -0
  32. package/skills/wp-analytics/references/analytics-dashboards.md +83 -0
  33. package/skills/wp-analytics/references/cwv-monitoring.md +101 -0
  34. package/skills/wp-analytics/references/ga4-integration.md +76 -0
  35. package/skills/wp-analytics/references/plausible-setup.md +92 -0
  36. package/skills/wp-analytics/references/traffic-attribution.md +92 -0
  37. package/skills/wp-analytics/scripts/analytics_inspect.mjs +153 -0
  38. package/skills/wp-content-attribution/SKILL.md +1 -0
  39. package/skills/wp-content-optimization/SKILL.md +1 -0
  40. package/skills/wp-content-workflows/SKILL.md +142 -0
  41. package/skills/wp-content-workflows/references/content-lifecycle-hooks.md +131 -0
  42. package/skills/wp-content-workflows/references/multi-channel-actions.md +151 -0
  43. package/skills/wp-content-workflows/references/schedule-triggers.md +118 -0
  44. package/skills/wp-content-workflows/references/trigger-management.md +159 -0
  45. package/skills/wp-content-workflows/references/wp-action-hooks.md +114 -0
  46. package/skills/wp-content-workflows/scripts/workflow_inspect.mjs +202 -0
  47. package/skills/wp-monitoring/SKILL.md +2 -0
  48. package/skills/wp-search-console/SKILL.md +1 -0
  49. package/skills/wp-social-email/SKILL.md +1 -0
  50. package/skills/wp-webhooks/SKILL.md +1 -0
package/CHANGELOG.md CHANGED
@@ -2,6 +2,67 @@
2
2
 
3
3
  All notable changes to the WordPress Manager plugin for Claude Code.
4
4
 
5
+ ## [2.9.0] - 2026-03-01
6
+
7
+ ### Added — Automated Workflows (WCOP Tier 4+5 Complete)
8
+ - **wp-content-workflows skill** — workflow triggers for scheduled events, content lifecycle hooks, and WP action/filter hooks
9
+ - **4 new MCP tools**: `wf_list_triggers`, `wf_create_trigger`, `wf_update_trigger`, `wf_delete_trigger`
10
+ - **5 reference files**: schedule-triggers, content-lifecycle-hooks, wp-action-hooks, multi-channel-actions, trigger-management
11
+ - **Detection script**: `workflow_inspect.mjs` — detects action channels, automation plugins, custom REST endpoints, WP-Cron config
12
+ - **Safety hook**: PreToolUse confirmation for `wf_delete_trigger` (prevents accidental deletion of active workflows)
13
+
14
+ ### Changed
15
+ - **wp-site-manager agent**: added Workflow Automation Management section (6-step procedure), 4 Workflow MCP tools, wp-content-workflows in Related Skills
16
+ - **Router v16**: added 9 workflow keywords and `wp-content-workflows` route
17
+ - **Cross-references**: wp-webhooks → wp-content-workflows, wp-social-email → wp-content-workflows
18
+
19
+ ### Metrics
20
+ - Skills: 39 (+1) | MCP tools: 132 (+4) | Reference files: 192 (+5) | Detection scripts: 27 (+1) | Safety hooks: 5 (+1)
21
+
22
+ ### WCOP Score (Final)
23
+ | Layer | v2.6.0 | v2.9.0 |
24
+ |-------|--------|--------|
25
+ | Content Factory | 9/10 | 9/10 |
26
+ | Quality Assurance | 9/10 | 9/10 |
27
+ | Distribution | 8/10 | 8/10 |
28
+ | Observability | 7/10 | **9/10** |
29
+ | Automation | 7/10 | **9/10** |
30
+ | **Total** | **8/10** | **8.8/10** |
31
+
32
+ ## [2.8.0] - 2026-03-01
33
+
34
+ ### Added — Smart Alerting (WCOP Tier 4b)
35
+ - **wp-alerting skill** — severity-based alert routing via Slack and SendGrid
36
+ - **3 new MCP tools**: `slack_send_alert` (webhook), `slack_send_message` (Bot Token + Block Kit), `slack_list_channels`
37
+ - **4 reference files**: slack-integration, alert-thresholds, escalation-paths, report-scheduling
38
+ - **Detection script**: `alerting_inspect.mjs` — detects Slack, SendGrid, monitoring setup
39
+ - **SiteConfig extension**: `slack_webhook_url`, `slack_bot_token`, `slack_channel`
40
+
41
+ ### Changed
42
+ - **wp-monitoring-agent**: added Procedure 10 (Alert Dispatch — severity-based routing: info→Slack webhook, warning→Slack Bot + thread, critical→Slack + email), added Alerting MCP Tools section (3 Slack + 2 SendGrid)
43
+ - **Router v15**: added 13 alerting keywords and `wp-alerting` route
44
+ - **Cross-references**: wp-monitoring → wp-alerting + wp-analytics
45
+
46
+ ### Metrics
47
+ - Skills: 38 (+1) | MCP tools: 128 (+3) | Reference files: 187 (+4) | Detection scripts: 26 (+1)
48
+
49
+ ## [2.7.0] - 2026-03-01
50
+
51
+ ### Added — Analytics (WCOP Tier 4a)
52
+ - **wp-analytics skill** — unified analytics: GA4, Plausible, Core Web Vitals
53
+ - **14 new MCP tools**: 6 GA4 (`ga4_run_report`, `ga4_get_realtime`, `ga4_top_pages`, `ga4_traffic_sources`, `ga4_user_demographics`, `ga4_conversion_events`), 4 Plausible (`pl_get_stats`, `pl_get_timeseries`, `pl_get_breakdown`, `pl_get_realtime`), 4 CWV (`cwv_analyze_url`, `cwv_batch_analyze`, `cwv_get_field_data`, `cwv_compare_pages`)
54
+ - **5 reference files**: ga4-integration, plausible-setup, cwv-monitoring, analytics-dashboards, traffic-attribution
55
+ - **Detection script**: `analytics_inspect.mjs` — detects GA4, Plausible, Google API key config
56
+ - **SiteConfig extension**: `ga4_property_id`, `ga4_service_account_key`, `plausible_api_key`, `plausible_base_url`, `google_api_key`
57
+
58
+ ### Changed
59
+ - **wp-monitoring-agent**: added Procedure 8 (Analytics Monitoring) and Procedure 9 (CWV Trend Check) with 14 analytics MCP tools
60
+ - **Router v14**: added GA4, Plausible, CWV keywords and route
61
+ - **Cross-references**: wp-search-console, wp-content-attribution, wp-content-optimization → wp-analytics
62
+
63
+ ### Metrics
64
+ - Skills: 37 (+1) | MCP tools: 125 (+14) | Reference files: 183 (+5) | Detection scripts: 25 (+1)
65
+
5
66
  ## [2.6.0] - 2026-03-01
6
67
 
7
68
  ### Added
@@ -54,6 +54,15 @@ You are a WordPress monitoring specialist. You perform comprehensive site health
54
54
  - **Hosting**: `hosting_listWebsites` — check hosting status and resources
55
55
  - **DNS**: `DNS_getDNSRecordsV1` — verify DNS records and email auth (SPF, DKIM, DMARC)
56
56
 
57
+ ### Analytics MCP Tools (`mcp__wp-rest-bridge__ga4_*`, `mcp__wp-rest-bridge__pl_*`, `mcp__wp-rest-bridge__cwv_*`)
58
+ - **GA4**: `ga4_run_report`, `ga4_get_realtime`, `ga4_top_pages`, `ga4_traffic_sources`, `ga4_user_demographics`, `ga4_conversion_events`
59
+ - **Plausible**: `pl_get_stats`, `pl_get_timeseries`, `pl_get_breakdown`, `pl_get_realtime`
60
+ - **CWV**: `cwv_analyze_url`, `cwv_batch_analyze`, `cwv_get_field_data`, `cwv_compare_pages`
61
+
62
+ ### Alerting MCP Tools (`mcp__wp-rest-bridge__slack_*`, `mcp__wp-rest-bridge__sg_*`)
63
+ - **Slack**: `slack_send_alert`, `slack_send_message`, `slack_list_channels`
64
+ - **SendGrid**: `sg_send_email`, `sg_send_template_email` (for critical severity email alerts)
65
+
57
66
  ### External Tools
58
67
  - **Bash**: Run health-check scripts, SSL checks, Lighthouse CLI, file integrity scans
59
68
  - **WebFetch**: Fetch PageSpeed Insights, check external URLs, verify sitemap
@@ -133,6 +142,39 @@ Run health assessments across all configured sites and generate a fleet-wide com
133
142
  - Common configuration drift from baselines
134
143
  5. **Generate fleet report** (see Fleet Report template below)
135
144
 
145
+ ### Procedure 8: Analytics Monitoring (Performance Dashboard)
146
+
147
+ 1. Fetch traffic data from GA4 (`ga4_top_pages`, `ga4_traffic_sources`) or Plausible (`pl_get_stats`, `pl_get_breakdown`)
148
+ 2. Fetch CWV for top pages (`cwv_batch_analyze`)
149
+ 3. Fetch keyword data from GSC (`gsc_top_queries`) if available
150
+ 4. Correlate: pages with high traffic + Poor CWV = optimization priority
151
+ 5. Generate Performance Dashboard Report
152
+ 6. If CWV Poor on top pages → recommend delegation to `wp-performance-optimizer`
153
+
154
+ ### Procedure 9: CWV Trend Check
155
+
156
+ 1. Run `cwv_analyze_url` on homepage and top landing pages
157
+ 2. Compare with CWV thresholds (Good: LCP<2.5s, INP<200ms, CLS<0.1)
158
+ 3. If available, fetch field data via `cwv_get_field_data` for real-user metrics
159
+ 4. Report status (Good/Needs Improvement/Poor) per metric
160
+ 5. If any metric is Poor → alert with specific pages and metrics
161
+
162
+ ### Procedure 10: Alert Dispatch (Severity-Based Routing)
163
+
164
+ Route monitoring findings to notification channels based on severity. See `wp-alerting` skill for full threshold and escalation configuration.
165
+
166
+ 1. **Classify severity** for each finding:
167
+ - **Info**: Plugin updates available, backup completed, minor metric changes
168
+ - **Warning**: LCP > 2.5s, error rate > 2%, disk > 80%, SSL < 30 days
169
+ - **Critical**: Site down, LCP > 4s, error rate > 5%, disk > 95%, security vulnerability
170
+ 2. **Dispatch by severity**:
171
+ - **Info** → `slack_send_alert` to general channel (simple text)
172
+ - **Warning** → `slack_send_message` with Block Kit formatting + threaded details
173
+ - **Critical** → `slack_send_message` with `<!channel>` mention + `sg_send_email` to alert recipients
174
+ 3. **Deduplication**: Check `{site}:{metric}:{severity}` key against cooldown window (info: 60m, warning: 30m, critical: 10m). Severity escalation bypasses cooldown.
175
+ 4. **Recovery**: When a metric returns to normal after an alert, send recovery notification to the same channel/thread.
176
+ 5. **Scheduled reports**: Use Procedure 8 output to generate daily/weekly health digests via Slack Block Kit.
177
+
136
178
  ## Report Generation
137
179
 
138
180
  After completing relevant procedures, generate a report following the templates in `references/reporting-templates.md`:
@@ -232,3 +274,5 @@ For issues found during monitoring:
232
274
  - **`wp-audit` skill** — one-time comprehensive audit (security + performance + SEO)
233
275
  - **`wp-security` skill** — security hardening procedures
234
276
  - **`wp-performance` skill** — backend profiling and optimization
277
+ - **`wp-analytics` skill** — analytics setup, traffic reports, CWV monitoring
278
+ - **`wp-alerting` skill** — alert thresholds, severity routing, Slack/email escalation, scheduled reports
@@ -52,6 +52,7 @@ Content and data management via WordPress REST API:
52
52
  - **Comments**: `list_comments`, `get_comment`, `create_comment`, `update_comment`, `delete_comment`
53
53
  - **Plugins**: `list_plugins`, `get_plugin`, `activate_plugin`, `deactivate_plugin`, `create_plugin`
54
54
  - **WP.org**: `search_plugin_repository`, `get_plugin_details`
55
+ - **Workflows**: `wf_list_triggers`, `wf_create_trigger`, `wf_update_trigger`, `wf_delete_trigger`
55
56
 
56
57
  ### 2. Hostinger MCP (`mcp__hostinger-mcp__*`)
57
58
  Infrastructure and hosting management:
@@ -148,11 +149,28 @@ When setting up or managing a multi-language WordPress Multisite network:
148
149
 
149
150
  See the `wp-multilang-network` skill for detailed reference files on network architecture, hreflang, content sync, language routing, and international SEO.
150
151
 
152
+ ### Workflow Automation Management
153
+
154
+ Manage automated workflow triggers that connect WordPress events to notification channels.
155
+
156
+ 1. **Detect existing workflows**: Run `node skills/wp-content-workflows/scripts/workflow_inspect.mjs` to assess current configuration
157
+ 2. **List triggers**: Use `wf_list_triggers` to see all configured workflows, filter by `status` or `type`
158
+ 3. **Create trigger**: Use `wf_create_trigger` with:
159
+ - `type`: `schedule` (cron-based), `hook` (WP action/filter), or `content` (post lifecycle)
160
+ - `conditions`: Trigger-specific conditions (cron interval, hook name, post status transition)
161
+ - `actions`: Array of notification actions (Slack, email, webhook) with templates and recipients
162
+ 4. **Update trigger**: Use `wf_update_trigger` to modify conditions, actions, or status (activate/deactivate)
163
+ 5. **Delete trigger**: Use `wf_delete_trigger` — requires user confirmation via safety hook
164
+ 6. **Test trigger**: Create with `status: "inactive"`, review configuration, then update to `status: "active"`
165
+
166
+ See the `wp-content-workflows` skill for reference files on schedule patterns, content lifecycle hooks, WP action hooks, multi-channel actions, and trigger management.
167
+
151
168
  ### Safety Rules
152
169
  - NEVER delete content without explicit user confirmation
153
170
  - NEVER deactivate plugins without listing dependencies first
154
171
  - NEVER modify published content status without confirmation
155
172
  - Always show a summary of changes before executing bulk operations
173
+ - NEVER delete workflow triggers without explicit user confirmation (safety hook enforced)
156
174
 
157
175
  ## Specialized Agents
158
176
 
@@ -176,3 +194,4 @@ For domain-specific tasks, delegate to specialized agents:
176
194
 
177
195
  - **`wp-multisite` skill** — multisite network management with 10 MCP tools
178
196
  - **`wp-multilang-network` skill** — multi-language network orchestration (hreflang, content sync, international SEO)
197
+ - **`wp-content-workflows` skill** — workflow triggers, scheduled events, content lifecycle automation
package/docs/GUIDE.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # WordPress Manager - Guida Completa per Utenti e Amministratori
2
2
 
3
- **Versione:** 2.6.0
3
+ **Versione:** 2.9.0
4
4
  **Ultimo aggiornamento:** 2026-03-01
5
5
  **Repository:** https://github.com/morrealev/wordpress-manager
6
6
 
@@ -66,6 +66,9 @@ WordPress Manager e un plugin per **Claude Code** (la CLI ufficiale di Anthropic
66
66
  - **Distribuzione social/email**: distribuire contenuti su Mailchimp, Buffer e SendGrid con workflow multi-canale
67
67
  - **Google Search Console**: monitorare keyword, indicizzazione, performance pagine e feedback SEO da GSC
68
68
  - **Ottimizzazione contenuti AI**: headline scoring, readability analysis, SEO scoring, meta optimization, content freshness e bulk triage
69
+ - **Analytics unificata**: GA4, Plausible e Core Web Vitals in un unico punto di accesso, con dashboard, trend e confronto pagine
70
+ - **Smart alerting**: routing alerting basato su severity (info→Slack webhook, warning→Slack Bot con thread, critical→Slack + email) via Slack e SendGrid
71
+ - **Workflow automatizzati**: trigger basati su schedule (cron), hook WordPress e lifecycle contenuti con azioni multi-canale (Slack, email, webhook)
69
72
 
70
73
  ### Requisiti
71
74
 
@@ -102,7 +105,7 @@ WordPress Manager e un plugin per **Claude Code** (la CLI ufficiale di Anthropic
102
105
  ### Componenti del Plugin
103
106
 
104
107
  ```
105
- wordpress-manager/ # v2.6.0
108
+ wordpress-manager/ # v2.9.0
106
109
  +-- .claude-plugin/plugin.json # Manifest
107
110
  +-- .mcp.json # Server MCP bundled
108
111
  +-- LICENSE # MIT + GPL-2.0-or-later
@@ -122,7 +125,7 @@ wordpress-manager/ # v2.6.0
122
125
  | +-- wp-distribution-manager.md # Multi-channel distribution (v2.4.0)
123
126
  +-- commands/ # 5 slash commands
124
127
  | +-- wp-status.md / wp-deploy.md / wp-audit.md / wp-backup.md / wp-setup.md
125
- +-- skills/ # 36 skill totali
128
+ +-- skills/ # 39 skill totali
126
129
  | +-- [OPERATIVE - 5 skill]
127
130
  | +-- wp-deploy/ # Procedure deploy
128
131
  | +-- wp-audit/ # Checklist audit
@@ -132,7 +135,7 @@ wordpress-manager/ # v2.6.0
132
135
  | +-- [AMBIENTE LOCALE - 1 skill]
133
136
  | +-- wp-local-env/ # Studio/LocalWP/wp-env
134
137
  | +-- [SVILUPPO - 13 skill da WordPress/agent-skills]
135
- | +-- wordpress-router/ # Router unificato v13 (dev + local + ops + multisite + cicd + monitoring + webhooks + repurposing + pseo + attribution + multilang + distribution + gsc + content-optimization)
138
+ | +-- wordpress-router/ # Router unificato v16 (dev + local + ops + multisite + cicd + monitoring + webhooks + repurposing + pseo + attribution + multilang + distribution + gsc + content-optimization + analytics + alerting + workflows)
136
139
  | +-- wp-project-triage/ # Auto-detect tipo progetto
137
140
  | +-- wp-block-development/ # Blocchi Gutenberg
138
141
  | +-- wp-block-themes/ # Temi a blocchi
@@ -166,8 +169,12 @@ wordpress-manager/ # v2.6.0
166
169
  | +-- wp-social-email/ # Distribuzione social/email multi-canale (v2.4.0)
167
170
  | +-- wp-search-console/ # Google Search Console integration (v2.5.0)
168
171
  | +-- wp-content-optimization/ # AI content optimization e bulk triage (v2.6.0)
169
- +-- hooks/ # 9 hook di sicurezza
170
- | +-- hooks.json # 7 prompt + 2 command
172
+ | +-- [ANALYTICS + ALERTING + AUTOMAZIONE - 3 skill]
173
+ | +-- wp-analytics/ # GA4, Plausible, Core Web Vitals unificati (v2.7.0)
174
+ | +-- wp-alerting/ # Smart alerting severity-based via Slack/SendGrid (v2.8.0)
175
+ | +-- wp-content-workflows/ # Workflow triggers (schedule, lifecycle, hooks) con azioni multi-canale (v2.9.0)
176
+ +-- hooks/ # 10 hook di sicurezza
177
+ | +-- hooks.json # 8 prompt + 2 command
171
178
  | +-- scripts/ # Script per hook command-type
172
179
  +-- scripts/ # Utility
173
180
  +-- servers/wp-rest-bridge/ # MCP Server custom (TypeScript)
@@ -358,6 +365,9 @@ WordPress Manager comprende richieste in linguaggio naturale. Ecco come formular
358
365
  | Distribuzione social/email | "Distribuisci il post" / "Mailchimp campaign" / "Buffer schedule" / "SendGrid email" |
359
366
  | Google Search Console | "Keyword tracking" / "Search analytics" / "Indicizzazione" / "GSC performance" |
360
367
  | Ottimizzazione contenuti | "Ottimizza titoli" / "Headline score" / "Readability" / "Content triage" / "Quick wins" |
368
+ | Analytics unificata | "GA4 report" / "Plausible stats" / "Core Web Vitals" / "Traffic sources" / "Page performance" |
369
+ | Smart alerting | "Configura alert Slack" / "Notifica critiche" / "Severity routing" / "Alert su Slack" |
370
+ | Workflow automatizzati | "Crea trigger" / "Workflow cron" / "Automatizza notifiche" / "Content lifecycle trigger" |
361
371
 
362
372
  ---
363
373
 
@@ -815,7 +825,7 @@ Complementa `wp-security-auditor`: l'auditor **trova** i problemi, l'hardener **
815
825
  | Ruolo | Monitoring continuo del sito (read-only, non modifica nulla) |
816
826
  | Attivazione | "Monitora il sito", "health report", "uptime check", "performance trend", "security scan periodico", "fleet health", "monitora tutti i siti" |
817
827
 
818
- **5 aree di monitoraggio + fleet**:
828
+ **8 aree di monitoraggio + fleet**:
819
829
 
820
830
  | Area | Cosa monitora |
821
831
  |------|--------------|
@@ -825,6 +835,9 @@ Complementa `wp-security-auditor`: l'auditor **trova** i problemi, l'hardener **
825
835
  | Content | Modifiche non autorizzate, broken links, spam comments, media integrity |
826
836
  | Alerting | Threshold P0-P3, notifiche email/Slack/webhook, escalation |
827
837
  | Fleet (v2.2.0) | Cross-site health comparison, fleet-wide patterns, per-site breakdown |
838
+ | Analytics (v2.7.0) | GA4 report, Plausible stats, traffic sources, user demographics, conversion events |
839
+ | CWV Trend (v2.7.0) | Core Web Vitals trend analysis, field data, page comparison |
840
+ | Alert Dispatch (v2.8.0) | Severity-based routing: info→Slack webhook, warning→Slack Bot + thread, critical→Slack + email |
828
841
 
829
842
  **Report disponibili**: Daily Health Summary, Weekly Performance, Monthly Security, Quarterly Trend, Executive Dashboard, Fleet Health Report (v2.2.0).
830
843
 
@@ -838,7 +851,7 @@ Complementa `wp-security-auditor`: l'auditor **trova** i problemi, l'hardener **
838
851
 
839
852
  **Detection**: `monitoring_inspect.mjs` rileva setup monitoring esistente (uptime tools, Lighthouse CI, security plugins, logging config).
840
853
 
841
- **Skill correlata**: `wp-monitoring`
854
+ **Skill correlata**: `wp-monitoring`, `wp-analytics`, `wp-alerting`
842
855
 
843
856
  ---
844
857
 
@@ -934,10 +947,11 @@ Le skill di sviluppo provengono da due fonti:
934
947
  - **6 skill e-commerce + infrastruttura** (MIT) aggiunte in v1.8.0-v2.2.0: WooCommerce, Multisite, CI/CD, Monitoring, Content Repurposing, Webhooks.
935
948
  - **3 skill strategia + SEO internazionale** (MIT) aggiunte in v2.3.0: Programmatic SEO, Content-Commerce Attribution, Multi-Language Network.
936
949
  - **3 skill distribuzione + SEO avanzato** (MIT) aggiunte in v2.4.0-v2.6.0: Social/Email Distribution, Google Search Console, AI Content Optimization.
950
+ - **3 skill analytics + alerting + automazione** (MIT) aggiunte in v2.7.0-v2.9.0: Analytics (GA4/Plausible/CWV), Smart Alerting (Slack/SendGrid severity routing), Automated Workflows (triggers + multi-channel actions).
937
951
 
938
952
  ### Il Router Unificato
939
953
 
940
- La skill `wordpress-router` (v13) e il punto d'ingresso per tutti i task WordPress. Classifica automaticamente il task in **quattordici categorie**: sviluppo, ambiente locale, operativo, multisite, CI/CD, monitoring, content repurposing, webhook, programmatic SEO, content attribution, multi-language network, social/email distribution, search console, content optimization.
954
+ La skill `wordpress-router` (v16) e il punto d'ingresso per tutti i task WordPress. Classifica automaticamente il task in **diciassette categorie**: sviluppo, ambiente locale, operativo, multisite, CI/CD, monitoring, content repurposing, webhook, programmatic SEO, content attribution, multi-language network, social/email distribution, search console, content optimization, analytics, alerting, content workflows.
941
955
 
942
956
  ```
943
957
  Utente: "Crea un blocco custom per la gallery"
@@ -1061,6 +1075,30 @@ wordpress-router: TASK = operativo (content optimization)
1061
1075
  wp-content-optimization skill + wp-content-strategist agent
1062
1076
  ```
1063
1077
 
1078
+ ```
1079
+ Utente: "Mostrami il report GA4 e le Core Web Vitals del mio sito"
1080
+ |
1081
+ wordpress-router: TASK = operativo (analytics)
1082
+ |
1083
+ wp-analytics skill + wp-monitoring-agent agent
1084
+ ```
1085
+
1086
+ ```
1087
+ Utente: "Configura un alert Slack quando il sito va giu"
1088
+ |
1089
+ wordpress-router: TASK = operativo (alerting)
1090
+ |
1091
+ wp-alerting skill + wp-monitoring-agent agent
1092
+ ```
1093
+
1094
+ ```
1095
+ Utente: "Crea un trigger che invia su Slack quando un post viene pubblicato"
1096
+ |
1097
+ wordpress-router: TASK = operativo (content workflows)
1098
+ |
1099
+ wp-content-workflows skill + wp-site-manager agent
1100
+ ```
1101
+
1064
1102
  ### Panoramica Skills di Sviluppo — Community (13)
1065
1103
 
1066
1104
  | Skill | Si attiva quando... | Risorse |
@@ -1126,9 +1164,19 @@ Aggiunte in v2.4.0-v2.6.0, queste skill coprono distribuzione multi-canale, Goog
1126
1164
  | `wp-search-console` | "Search Console", "keyword tracking", "indicizzazione", "GSC", "search analytics" | 5 reference files, search_console_inspect.mjs | `wp-content-strategist` |
1127
1165
  | `wp-content-optimization` | "ottimizza titoli", "readability", "headline score", "content triage", "meta optimization" | 5 reference files, content_optimization_inspect.mjs | `wp-content-strategist` |
1128
1166
 
1167
+ ### Panoramica Skills Analytics + Alerting + Automazione (3)
1168
+
1169
+ Aggiunte in v2.7.0-v2.9.0, queste skill completano il WCOP (WordPress Content Operations Pipeline) portando il punteggio da 8/10 a 8.8/10.
1170
+
1171
+ | Skill | Si attiva quando... | Risorse | Agent dedicato |
1172
+ |-------|---------------------|---------|----------------|
1173
+ | `wp-analytics` | "GA4 report", "Plausible stats", "Core Web Vitals", "traffic sources", "page performance", "conversion events" | 5 reference files, analytics_inspect.mjs | `wp-monitoring-agent` |
1174
+ | `wp-alerting` | "alert Slack", "notifica critiche", "severity routing", "escalation", "alert email" | 4 reference files, alerting_inspect.mjs | `wp-monitoring-agent` |
1175
+ | `wp-content-workflows` | "crea trigger", "workflow cron", "content lifecycle", "automatizza notifiche", "trigger schedule" | 5 reference files, workflow_inspect.mjs | `wp-site-manager` |
1176
+
1129
1177
  ### Script di Rilevamento Automatico
1130
1178
 
1131
- Le skill includono 24 script Node.js (`.mjs`) che eseguono analisi automatica del progetto:
1179
+ Le skill includono 27 script Node.js (`.mjs`) che eseguono analisi automatica del progetto:
1132
1180
 
1133
1181
  | Script | Cosa rileva |
1134
1182
  |--------|-------------|
@@ -1156,6 +1204,9 @@ Le skill includono 24 script Node.js (`.mjs`) che eseguono analisi automatica de
1156
1204
  | `distribution_inspect.mjs` | Mailchimp, Buffer, SendGrid config, API keys, servizi attivi (v2.4.0) |
1157
1205
  | `search_console_inspect.mjs` | GSC service account, siti verificati, sitemap, keyword data (v2.5.0) |
1158
1206
  | `content_optimization_inspect.mjs` | Content volume, titoli, meta description, readability readiness (v2.6.0) |
1207
+ | `analytics_inspect.mjs` | GA4 property ID, Plausible config, Google API key, analytics setup (v2.7.0) |
1208
+ | `alerting_inspect.mjs` | Slack webhook/bot token, SendGrid config, monitoring setup, alert readiness (v2.8.0) |
1209
+ | `workflow_inspect.mjs` | Action channel config, automation plugins, custom REST endpoints, WP-Cron, webhook config (v2.9.0) |
1159
1210
 
1160
1211
  ### WordPress Playground — Ambienti Disposable
1161
1212
 
@@ -1190,7 +1241,7 @@ Senza il server MCP, la skill usa conoscenza generale di `@wordpress/components`
1190
1241
  ```
1191
1242
  1. cd mio-progetto-wordpress/
1192
1243
  2. Claude esegue wp-project-triage → rileva "wp-block-plugin"
1193
- 3. wordpress-router v13 → instrada a wp-block-development
1244
+ 3. wordpress-router v16 → instrada a wp-block-development
1194
1245
  4. Claude guida la creazione con block.json, edit.js, save.js
1195
1246
  5. wp-e2e-testing + wp-test-engineer → esegue test E2E con Playwright
1196
1247
  6. wp-accessibility + wp-accessibility-auditor → verifica WCAG 2.2
@@ -1271,6 +1322,7 @@ Questi hook chiedono a Claude di valutare se l'operazione e stata esplicitamente
1271
1322
  | 5 | Eliminazione webhook WC | `wc_delete_webhook` | Conferma prima di eliminare un webhook (le integrazioni esterne smetteranno di ricevere eventi) |
1272
1323
  | 6 | Invio campagna Mailchimp | `mc_send_campaign` | Conferma prima di inviare una campagna email (azione irreversibile verso tutti i destinatari) |
1273
1324
  | 7 | Invio email SendGrid | `sg_send_email` | Conferma prima di inviare email transazionali (azione irreversibile) |
1325
+ | 8 | Eliminazione workflow trigger | `wf_delete_trigger` | Conferma prima di eliminare un trigger di automazione (ferma tutte le notifiche e azioni associate) |
1274
1326
 
1275
1327
  ### Hook Command-Based (Validazione Script)
1276
1328
 
@@ -1327,7 +1379,7 @@ MCP (Model Context Protocol) e il protocollo che permette a Claude di comunicare
1327
1379
  | Sorgente | Custom TypeScript server in `servers/wp-rest-bridge/` |
1328
1380
  | Trasporto | stdio (JSON-RPC via stdin/stdout) |
1329
1381
  | Autenticazione | `WP_SITES_CONFIG` JSON env var |
1330
- | Tool disponibili | 111 (41 WordPress + 34 WooCommerce + 10 Multisite + 18 Distribution + 8 GSC) |
1382
+ | Tool disponibili | 132 (41 WordPress + 34 WooCommerce + 10 Multisite + 18 Distribution + 8 GSC + 14 Analytics + 3 Alerting + 4 Workflows) |
1331
1383
 
1332
1384
  **Categorie tool WordPress** (`wp/v2`):
1333
1385
 
@@ -1379,6 +1431,26 @@ MCP (Model Context Protocol) e il protocollo che permette a Claude di comunicare
1379
1431
  | Search Analytics | 3 | `gsc_search_analytics`, `gsc_top_queries`, `gsc_page_performance` |
1380
1432
  | Sitemaps | 3 | `gsc_list_sitemaps`, `gsc_submit_sitemap`, `gsc_delete_sitemap` |
1381
1433
 
1434
+ **Categorie tool Analytics** (richiede GA4 Property ID, Plausible API key, o Google API key):
1435
+
1436
+ | Categoria | Tool | Esempio |
1437
+ |-----------|------|---------|
1438
+ | GA4 | 6 | `ga4_run_report`, `ga4_get_realtime`, `ga4_top_pages`, `ga4_traffic_sources`, `ga4_user_demographics`, `ga4_conversion_events` |
1439
+ | Plausible | 4 | `pl_get_stats`, `pl_get_timeseries`, `pl_get_breakdown`, `pl_get_realtime` |
1440
+ | Core Web Vitals | 4 | `cwv_analyze_url`, `cwv_batch_analyze`, `cwv_get_field_data`, `cwv_compare_pages` |
1441
+
1442
+ **Categorie tool Alerting** (richiede Slack webhook URL o Bot Token):
1443
+
1444
+ | Categoria | Tool | Esempio |
1445
+ |-----------|------|---------|
1446
+ | Slack | 3 | `slack_send_alert` (webhook), `slack_send_message` (Bot Token + Block Kit), `slack_list_channels` |
1447
+
1448
+ **Categorie tool Workflows** (namespace `wp-manager/v1/workflows`):
1449
+
1450
+ | Categoria | Tool | Esempio |
1451
+ |-----------|------|---------|
1452
+ | Trigger Management | 4 | `wf_list_triggers`, `wf_create_trigger`, `wf_update_trigger`, `wf_delete_trigger` |
1453
+
1382
1454
  **Architettura multi-sito**: Il server mantiene una `Map<siteId, AxiosInstance>` dove ogni sito ha la propria istanza HTTP autenticata. Il cambio sito e istantaneo.
1383
1455
 
1384
1456
  #### WordPress.com MCP
@@ -1814,6 +1886,54 @@ Claude (attiva wp-content-strategist + skill wp-content-optimization):
1814
1886
  -> Report: matrice triage, top 10 titoli da migliorare, 5 contenuti obsoleti, azioni immediate
1815
1887
  ```
1816
1888
 
1889
+ ### Scenario 26: Analytics Unificata con GA4 e Plausible
1890
+
1891
+ ```
1892
+ Tu: "Mostrami il report GA4, le top pages e le Core Web Vitals del mio sito"
1893
+
1894
+ Claude (attiva wp-monitoring-agent + skill wp-analytics):
1895
+ 1. Detection con analytics_inspect.mjs (GA4 configurato? Plausible? Google API key?)
1896
+ 2. GA4 report: ga4_run_report per sessioni, pageviews, bounce rate ultimi 28 giorni
1897
+ 3. Top pages: ga4_top_pages con traffic sources breakdown
1898
+ 4. Traffic sources: ga4_traffic_sources per organic vs direct vs referral vs social
1899
+ 5. Core Web Vitals: cwv_analyze_url per homepage + landing pages principali
1900
+ 6. CWV field data: cwv_get_field_data per dati reali degli utenti
1901
+ 7. Confronto pagine: cwv_compare_pages per identificare pagine lente
1902
+ -> Report: dashboard analytics unificata, CWV score per pagina, raccomandazioni
1903
+ ```
1904
+
1905
+ ### Scenario 27: Smart Alerting con Slack
1906
+
1907
+ ```
1908
+ Tu: "Configura alert Slack per quando il sito ha problemi critici"
1909
+
1910
+ Claude (attiva wp-monitoring-agent + skill wp-alerting):
1911
+ 1. Detection con alerting_inspect.mjs (Slack webhook? Bot token? SendGrid?)
1912
+ 2. Configura severity routing:
1913
+ - P3 (info): slack_send_alert via webhook (canale #wp-info)
1914
+ - P2 (warning): slack_send_message via Bot Token con thread per dettagli
1915
+ - P1/P0 (critical): Slack message + email via SendGrid ai responsabili
1916
+ 3. Imposta threshold per metriche chiave (response time > 3s, SSL < 14 giorni, errori 5xx)
1917
+ 4. Test alert: invia messaggio di test su canale Slack
1918
+ -> Report: severity routing configurato, threshold impostati, test completato
1919
+ ```
1920
+
1921
+ ### Scenario 28: Workflow Automatizzato per Content Lifecycle
1922
+
1923
+ ```
1924
+ Tu: "Crea un workflow che notifica su Slack quando un post viene pubblicato e invia un'email di recap settimanale"
1925
+
1926
+ Claude (attiva wp-site-manager + skill wp-content-workflows):
1927
+ 1. Detection con workflow_inspect.mjs (action channels, automation plugins, WP-Cron)
1928
+ 2. Crea trigger "hook": wf_create_trigger con hook "transition_post_status" (publish)
1929
+ - Azione: Slack notification con titolo, autore, link del post
1930
+ 3. Crea trigger "schedule": wf_create_trigger con cron "0 9 * * 1" (lunedi ore 9)
1931
+ - Azione: email recap settimanale con post pubblicati nell'ultima settimana
1932
+ 4. Verifica trigger attivi: wf_list_triggers
1933
+ 5. Test trigger manuale per verificare funzionamento
1934
+ -> Report: 2 trigger configurati, Slack + email, prossima esecuzione cron
1935
+ ```
1936
+
1817
1937
  ---
1818
1938
 
1819
1939
  ## 14. Amministrazione Avanzata
@@ -2097,7 +2217,7 @@ bash ~/.claude/plugins/local/wordpress-manager/scripts/validate-wp-operation.sh
2097
2217
  | **x-default** | Valore hreflang speciale che indica la pagina fallback per utenti senza match di lingua |
2098
2218
  | **Content Sync** | Sincronizzazione di contenuti tra sub-site di lingua diversa in un network multilingua |
2099
2219
  | **MultilingualPress** | Plugin WordPress nativo per multisite multilingua — connessioni tra contenuti cross-site |
2100
- | **WCOP** | WordPress Content Optimization Pipeline — pipeline AI a 5 step per ottimizzazione contenuti (headline readability SEO meta freshness) |
2220
+ | **WCOP** | WordPress Content Operations Pipeline — framework a 5 layer per la gestione completa dei contenuti WordPress (Content Factory, Quality Assurance, Distribution, Observability, Automation). Score attuale: 8.8/10 |
2101
2221
  | **CTR (Click-Through Rate)** | Rapporto percentuale tra impressioni e click — metrica chiave in Google Search Console e email marketing |
2102
2222
  | **Flesch-Kincaid** | Formula di leggibilita che stima il livello scolastico necessario per comprendere un testo — usata nell'AI content optimization |
2103
2223
  | **Content Triage** | Classificazione rapida di tutti i contenuti in categorie di azione: Quick Wins, Maintain, Deep Review, Outdated |
@@ -2107,8 +2227,19 @@ bash ~/.claude/plugins/local/wordpress-manager/scripts/validate-wp-operation.sh
2107
2227
  | **Buffer** | Piattaforma di social media scheduling — integrata via API con 5 tool MCP (prefix `buf_*`) |
2108
2228
  | **SendGrid** | Servizio di email transazionale e marketing — integrato via API con 6 tool MCP (prefix `sg_*`) |
2109
2229
  | **GSC (Google Search Console)** | Strumento Google per monitorare presence del sito nei risultati di ricerca — integrato con 8 tool MCP (prefix `gsc_*`) |
2230
+ | **GA4 (Google Analytics 4)** | Piattaforma di analytics web di Google — integrata via API con 6 tool MCP (prefix `ga4_*`) per report, realtime, traffic sources e conversioni |
2231
+ | **Plausible Analytics** | Alternativa privacy-first a Google Analytics — integrata via API con 4 tool MCP (prefix `pl_*`) per stats, timeseries e breakdown |
2232
+ | **CWV (Core Web Vitals)** | Metriche Google (LCP, INP, CLS) per UX — 4 tool MCP (prefix `cwv_*`) per analisi URL, batch, field data e confronto pagine |
2233
+ | **Slack Webhook** | URL di callback per inviare messaggi a un canale Slack — usato per alert di severity info (P3) |
2234
+ | **Slack Bot Token** | Token di autenticazione per Slack Bot API — permette messaggi formattati con Block Kit, thread e interazioni avanzate |
2235
+ | **Severity Routing** | Pattern di alerting dove il livello di gravita (P0-P3) determina il canale di notifica (webhook, bot, email) |
2236
+ | **Workflow Trigger** | Regola di automazione che esegue azioni (Slack, email, webhook) in risposta a eventi (schedule, hook WordPress, lifecycle contenuto) |
2237
+ | **WP-Cron** | Sistema di scheduling di WordPress — usato per trigger workflow basati su cron expression (es. "ogni lunedi alle 9") |
2238
+ | **Content Lifecycle Hook** | Hook WordPress legato al ciclo di vita dei contenuti (publish, update, trash) — usato come trigger per workflow automatizzati |
2239
+ | **WCOP Score** | WordPress Content Operations Pipeline — score 0-10 su 5 layer: Content Factory, Quality Assurance, Distribution, Observability, Automation |
2110
2240
 
2111
2241
  ---
2112
2242
 
2113
- *Guida v2.6.0 - WordPress Manager Plugin per Claude Code*
2243
+ *Guida v2.9.0 WordPress Manager Plugin per Claude Code*
2114
2244
  *Ultimo aggiornamento: 2026-03-01*
2245
+ *WCOP Score: 8.8/10 (Tier 4+5 complete)*