claude-plugin-wordpress-manager 2.6.0 → 2.9.1

package/servers/wp-rest-bridge/build/tools/slack.js

@@ -0,0 +1,129 @@
+import { hasSlackWebhook, getSlackWebhookUrl, hasSlackBot, makeSlackBotRequest } from '../wordpress.js';
+import axios from 'axios';
+import { z } from 'zod';
+// ── Zod Schemas ─────────────────────────────────────────────────
+const slackSendAlertSchema = z.object({
+    text: z.string().describe('Alert message text (supports Slack markdown)'),
+    channel: z.string().optional().describe('Override channel (webhook default if omitted)'),
+    username: z.string().optional().default('WP Monitor').describe('Bot display name'),
+    icon_emoji: z.string().optional().default(':warning:').describe('Bot icon emoji'),
+    blocks: z.array(z.any()).optional().describe('Slack Block Kit blocks (optional, overrides text for rich formatting)'),
+}).strict();
+const slackSendMessageSchema = z.object({
+    channel: z.string().describe('Channel ID or name (e.g., #general or C01234ABC)'),
+    text: z.string().describe('Message text (required as fallback even with blocks)'),
+    blocks: z.array(z.any()).optional().describe('Slack Block Kit blocks for rich formatting'),
+    thread_ts: z.string().optional().describe('Thread timestamp for threaded replies'),
+}).strict();
+const slackListChannelsSchema = z.object({
+    limit: z.number().optional().default(100).describe('Max channels to return (default 100)'),
+    types: z.string().optional().default('public_channel').describe('Channel types (default: public_channel)'),
+}).strict();
+// ── Tool Definitions ────────────────────────────────────────────
+export const slackTools = [
+    {
+        name: "slack_send_alert",
+        description: "Sends an alert notification to Slack via Incoming Webhook (zero-config, no Bot Token needed)",
+        inputSchema: {
+            type: "object",
+            properties: {
+                text: { type: "string", description: "Alert message text (Slack markdown)" },
+                channel: { type: "string", description: "Override channel (optional)" },
+                username: { type: "string", description: "Bot display name (default: WP Monitor)" },
+                icon_emoji: { type: "string", description: "Bot icon emoji (default: :warning:)" },
+                blocks: { type: "array", items: { type: "object" }, description: "Block Kit blocks (optional)" },
+            },
+            required: ["text"],
+        },
+    },
+    {
+        name: "slack_send_message",
+        description: "Sends a message to a Slack channel via Bot Token (supports Block Kit, threads)",
+        inputSchema: {
+            type: "object",
+            properties: {
+                channel: { type: "string", description: "Channel ID or name" },
+                text: { type: "string", description: "Message text (fallback for blocks)" },
+                blocks: { type: "array", items: { type: "object" }, description: "Block Kit blocks" },
+                thread_ts: { type: "string", description: "Thread timestamp for replies" },
+            },
+            required: ["channel", "text"],
+        },
+    },
+    {
+        name: "slack_list_channels",
+        description: "Lists Slack workspace channels via Bot Token",
+        inputSchema: {
+            type: "object",
+            properties: {
+                limit: { type: "number", description: "Max channels (default 100)" },
+                types: { type: "string", description: "Channel types (default: public_channel)" },
+            },
+        },
+    },
+];
+// ── Handlers ────────────────────────────────────────────────────
+export const slackHandlers = {
+    slack_send_alert: async (params) => {
+        if (!hasSlackWebhook()) {
+            return { toolResult: { isError: true, content: [{ type: "text", text: "Slack webhook not configured. Add slack_webhook_url to WP_SITES_CONFIG." }] } };
+        }
+        try {
+            const { text, channel, username, icon_emoji, blocks } = params;
+            const webhookUrl = getSlackWebhookUrl();
+            const payload = { text, username: username || 'WP Monitor', icon_emoji: icon_emoji || ':warning:' };
+            if (channel)
+                payload.channel = channel;
+            if (blocks)
+                payload.blocks = blocks;
+            await axios.post(webhookUrl, payload, { timeout: 10000 });
+            return { toolResult: { content: [{ type: "text", text: "Alert sent successfully to Slack." }] } };
+        }
+        catch (error) {
+            const errorMessage = error.response?.data || error.message;
+            return { toolResult: { isError: true, content: [{ type: "text", text: `Error sending Slack alert: ${typeof errorMessage === 'string' ? errorMessage : JSON.stringify(errorMessage)}` }] } };
+        }
+    },
+    slack_send_message: async (params) => {
+        if (!hasSlackBot()) {
+            return { toolResult: { isError: true, content: [{ type: "text", text: "Slack Bot not configured. Add slack_bot_token to WP_SITES_CONFIG." }] } };
+        }
+        try {
+            const { channel, text, blocks, thread_ts } = params;
+            const payload = { channel, text };
+            if (blocks)
+                payload.blocks = blocks;
+            if (thread_ts)
+                payload.thread_ts = thread_ts;
+            const response = await makeSlackBotRequest('POST', 'chat.postMessage', payload);
+            if (!response.ok) {
+                return { toolResult: { isError: true, content: [{ type: "text", text: `Slack API error: ${response.error}` }] } };
+            }
+            return { toolResult: { content: [{ type: "text", text: JSON.stringify({ ok: true, channel: response.channel, ts: response.ts }, null, 2) }] } };
+        }
+        catch (error) {
+            const errorMessage = error.response?.data?.error || error.message;
+            return { toolResult: { isError: true, content: [{ type: "text", text: `Error sending Slack message: ${errorMessage}` }] } };
+        }
+    },
+    slack_list_channels: async (params) => {
+        if (!hasSlackBot()) {
+            return { toolResult: { isError: true, content: [{ type: "text", text: "Slack Bot not configured. Add slack_bot_token to WP_SITES_CONFIG." }] } };
+        }
+        try {
+            const { limit, types } = params;
+            const response = await makeSlackBotRequest('GET', `conversations.list?limit=${limit || 100}&types=${types || 'public_channel'}`);
+            if (!response.ok) {
+                return { toolResult: { isError: true, content: [{ type: "text", text: `Slack API error: ${response.error}` }] } };
+            }
+            const channels = (response.channels || []).map((ch) => ({
+                id: ch.id, name: ch.name, topic: ch.topic?.value, num_members: ch.num_members,
+            }));
+            return { toolResult: { content: [{ type: "text", text: JSON.stringify(channels, null, 2) }] } };
+        }
+        catch (error) {
+            const errorMessage = error.response?.data?.error || error.message;
+            return { toolResult: { isError: true, content: [{ type: "text", text: `Error listing Slack channels: ${errorMessage}` }] } };
+        }
+    },
+};

package/servers/wp-rest-bridge/build/tools/wc-workflows.d.ts

@@ -0,0 +1,3 @@
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+export declare const wcWorkflowTools: Tool[];
+export declare const wcWorkflowHandlers: Record<string, Function>;

package/servers/wp-rest-bridge/build/tools/wc-workflows.js

@@ -0,0 +1,222 @@
+import { makeWordPressRequest } from '../wordpress.js';
+import { z } from 'zod';
+const WF_NAMESPACE = 'wp-manager/v1';
+// ── Zod Schemas ─────────────────────────────────────────────────
+const actionSchema = z.object({
+    channel: z.enum(['slack', 'email', 'webhook']).describe('Notification channel'),
+    template: z.string().describe('Message template (supports {{variable}} placeholders)'),
+    recipients: z.array(z.string()).describe('Recipients (emails, Slack channels, or webhook URLs)'),
+}).strict();
+const conditionsSchema = z.record(z.any())
+    .describe('Trigger conditions object (structure depends on trigger type)');
+const wfListTriggersSchema = z.object({
+    status: z.enum(['active', 'inactive', 'all']).optional()
+        .describe('Filter by trigger status (default: all)'),
+    type: z.enum(['schedule', 'hook', 'content']).optional()
+        .describe('Filter by trigger type'),
+    limit: z.number().optional().default(50)
+        .describe('Max triggers to return (default 50)'),
+}).strict();
+const wfCreateTriggerSchema = z.object({
+    name: z.string().describe('Trigger name (human-readable identifier)'),
+    type: z.enum(['schedule', 'hook', 'content'])
+        .describe('Trigger type: schedule (cron-based), hook (WP action/filter), content (post lifecycle)'),
+    conditions: conditionsSchema,
+    actions: z.array(actionSchema).min(1)
+        .describe('Actions to execute when trigger fires'),
+    status: z.enum(['active', 'inactive']).optional()
+        .describe('Initial status (default: active)'),
+    description: z.string().optional()
+        .describe('Human-readable description of what this trigger does'),
+}).strict();
+const wfUpdateTriggerSchema = z.object({
+    trigger_id: z.number().describe('Trigger ID to update'),
+    name: z.string().optional().describe('Updated trigger name'),
+    status: z.enum(['active', 'inactive']).optional()
+        .describe('Updated trigger status'),
+    conditions: conditionsSchema.optional(),
+    actions: z.array(actionSchema).optional()
+        .describe('Updated actions array'),
+    description: z.string().optional()
+        .describe('Updated description'),
+}).strict();
+const wfDeleteTriggerSchema = z.object({
+    trigger_id: z.number().describe('Trigger ID to delete'),
+}).strict();
+// ── Tool Definitions ────────────────────────────────────────────
+export const wcWorkflowTools = [
+    {
+        name: "wf_list_triggers",
+        description: "Lists all configured workflow triggers (scheduled events, WP hooks, content lifecycle) with their status, conditions, and actions",
+        inputSchema: {
+            type: "object",
+            properties: {
+                status: {
+                    type: "string",
+                    enum: ["active", "inactive", "all"],
+                    description: "Filter by trigger status (default: all)",
+                },
+                type: {
+                    type: "string",
+                    enum: ["schedule", "hook", "content"],
+                    description: "Filter by trigger type",
+                },
+                limit: {
+                    type: "number",
+                    description: "Max triggers to return (default 50)",
+                },
+            },
+        },
+    },
+    {
+        name: "wf_create_trigger",
+        description: "Creates a new workflow trigger that fires Slack alerts, emails, or webhook notifications on scheduled events, WP hooks, or content lifecycle changes",
+        inputSchema: {
+            type: "object",
+            properties: {
+                name: { type: "string", description: "Trigger name (human-readable identifier)" },
+                type: {
+                    type: "string",
+                    enum: ["schedule", "hook", "content"],
+                    description: "Trigger type: schedule (cron), hook (WP action/filter), content (post lifecycle)",
+                },
+                conditions: {
+                    type: "object",
+                    description: "Trigger conditions (structure depends on type)",
+                },
+                actions: {
+                    type: "array",
+                    items: {
+                        type: "object",
+                        properties: {
+                            channel: { type: "string", enum: ["slack", "email", "webhook"], description: "Notification channel" },
+                            template: { type: "string", description: "Message template (supports {{variable}} placeholders)" },
+                            recipients: { type: "array", items: { type: "string" }, description: "Recipients list" },
+                        },
+                        required: ["channel", "template", "recipients"],
+                    },
+                    description: "Actions to execute when trigger fires",
+                },
+                status: {
+                    type: "string",
+                    enum: ["active", "inactive"],
+                    description: "Initial status (default: active)",
+                },
+                description: { type: "string", description: "What this trigger does" },
+            },
+            required: ["name", "type", "conditions", "actions"],
+        },
+    },
+    {
+        name: "wf_update_trigger",
+        description: "Updates an existing workflow trigger (name, status, conditions, actions, or description)",
+        inputSchema: {
+            type: "object",
+            properties: {
+                trigger_id: { type: "number", description: "Trigger ID to update" },
+                name: { type: "string", description: "Updated trigger name" },
+                status: {
+                    type: "string",
+                    enum: ["active", "inactive"],
+                    description: "Updated trigger status",
+                },
+                conditions: {
+                    type: "object",
+                    description: "Updated trigger conditions",
+                },
+                actions: {
+                    type: "array",
+                    items: {
+                        type: "object",
+                        properties: {
+                            channel: { type: "string", enum: ["slack", "email", "webhook"], description: "Notification channel" },
+                            template: { type: "string", description: "Message template" },
+                            recipients: { type: "array", items: { type: "string" }, description: "Recipients list" },
+                        },
+                        required: ["channel", "template", "recipients"],
+                    },
+                    description: "Updated actions array",
+                },
+                description: { type: "string", description: "Updated description" },
+            },
+            required: ["trigger_id"],
+        },
+    },
+    {
+        name: "wf_delete_trigger",
+        description: "Deletes a workflow trigger (stops all associated automation and notifications)",
+        inputSchema: {
+            type: "object",
+            properties: {
+                trigger_id: { type: "number", description: "Trigger ID to delete" },
+            },
+            required: ["trigger_id"],
+        },
+    },
+];
+// ── Handlers ────────────────────────────────────────────────────
+export const wcWorkflowHandlers = {
+    wf_list_triggers: async (params) => {
+        try {
+            const queryParts = [];
+            if (params.status && params.status !== 'all')
+                queryParts.push(`status=${params.status}`);
+            if (params.type)
+                queryParts.push(`type=${params.type}`);
+            if (params.limit)
+                queryParts.push(`per_page=${params.limit}`);
+            const query = queryParts.length > 0 ? `?${queryParts.join('&')}` : '';
+            const response = await makeWordPressRequest('GET', `workflows${query}`, undefined, {
+                namespace: WF_NAMESPACE,
+            });
+            return { toolResult: { content: [{ type: "text", text: JSON.stringify(response, null, 2) }] } };
+        }
+        catch (error) {
+            const errorMessage = error.response?.data?.message || error.message;
+            return { toolResult: { isError: true, content: [{ type: "text", text: `Error listing workflow triggers: ${errorMessage}` }] } };
+        }
+    },
+    wf_create_trigger: async (params) => {
+        try {
+            const { name, type, conditions, actions, status, description } = params;
+            const body = { name, type, conditions, actions };
+            if (status)
+                body.status = status;
+            if (description)
+                body.description = description;
+            const response = await makeWordPressRequest('POST', 'workflows', body, {
+                namespace: WF_NAMESPACE,
+            });
+            return { toolResult: { content: [{ type: "text", text: JSON.stringify(response, null, 2) }] } };
+        }
+        catch (error) {
+            const errorMessage = error.response?.data?.message || error.message;
+            return { toolResult: { isError: true, content: [{ type: "text", text: `Error creating workflow trigger: ${errorMessage}` }] } };
+        }
+    },
+    wf_update_trigger: async (params) => {
+        try {
+            const { trigger_id, ...updates } = params;
+            const response = await makeWordPressRequest('PUT', `workflows/${trigger_id}`, updates, {
+                namespace: WF_NAMESPACE,
+            });
+            return { toolResult: { content: [{ type: "text", text: JSON.stringify(response, null, 2) }] } };
+        }
+        catch (error) {
+            const errorMessage = error.response?.data?.message || error.message;
+            return { toolResult: { isError: true, content: [{ type: "text", text: `Error updating workflow trigger: ${errorMessage}` }] } };
+        }
+    },
+    wf_delete_trigger: async (params) => {
+        try {
+            const response = await makeWordPressRequest('DELETE', `workflows/${params.trigger_id}?force=true`, undefined, {
+                namespace: WF_NAMESPACE,
+            });
+            return { toolResult: { content: [{ type: "text", text: JSON.stringify(response, null, 2) }] } };
+        }
+        catch (error) {
+            const errorMessage = error.response?.data?.message || error.message;
+            return { toolResult: { isError: true, content: [{ type: "text", text: `Error deleting workflow trigger: ${errorMessage}` }] } };
+        }
+    },
+};

package/servers/wp-rest-bridge/build/wordpress.d.ts

@@ -16,6 +16,13 @@ interface SiteConfig {
     sendgrid_api_key?: string;
     gsc_service_account_key?: string;
     gsc_site_url?: string;
+    ga4_property_id?: string;
+    ga4_service_account_key?: string;
+    plausible_api_key?: string;
+    plausible_base_url?: string;
+    google_api_key?: string;
+    slack_webhook_url?: string;
+    slack_bot_token?: string;
 }
 /**
  * Parse WP_SITES_CONFIG JSON and initialize all site clients
@@ -83,6 +90,17 @@ export declare function makeSendGridRequest(method: string, endpoint: string, da
 export declare function hasGSC(siteId?: string): boolean;
 export declare function getGSCSiteUrl(siteId?: string): string;
 export declare function getGSCAuth(siteId?: string): Promise<any>;
+export declare function hasGA4(siteId?: string): boolean;
+export declare function getGA4PropertyId(siteId?: string): string;
+export declare function getGA4Auth(siteId?: string): Promise<any>;
+export declare function hasPlausible(siteId?: string): boolean;
+export declare function makePlausibleRequest(method: string, endpoint: string, params?: Record<string, any>, siteId?: string): Promise<any>;
+export declare function hasGoogleApiKey(siteId?: string): boolean;
+export declare function getGoogleApiKey(siteId?: string): string;
+export declare function hasSlackWebhook(siteId?: string): boolean;
+export declare function getSlackWebhookUrl(siteId?: string): string;
+export declare function hasSlackBot(siteId?: string): boolean;
+export declare function makeSlackBotRequest(method: string, endpoint: string, data?: Record<string, any>, siteId?: string): Promise<any>;
 /**
  * Search the WordPress.org Plugin Repository
  */

package/servers/wp-rest-bridge/build/wordpress.js

@@ -37,6 +37,8 @@ const wcSiteClients = new Map();
 const mcSiteClients = new Map();
 const bufSiteClients = new Map();
 const sgSiteClients = new Map();
+const plSiteClients = new Map();
+const slackBotClients = new Map();
 let activeSiteId = '';
 const parsedSiteConfigs = new Map();
 const MAX_CONCURRENT_PER_SITE = 5;
@@ -101,6 +103,14 @@ export async function initWordPress() {
             await initSendGridClient(site.id, site.sendgrid_api_key);
             logToStderr(`Initialized SendGrid for site: ${site.id}`);
         }
+        if (site.plausible_api_key) {
+            await initPlausibleClient(site.id, site.plausible_api_key, site.plausible_base_url);
+            logToStderr(`Initialized Plausible for site: ${site.id}`);
+        }
+        if (site.slack_bot_token) {
+            await initSlackBotClient(site.id, site.slack_bot_token);
+            logToStderr(`Initialized Slack Bot for site: ${site.id}`);
+        }
     }
     activeSiteId = defaultSite || sites[0].id;
     logToStderr(`Active site: ${activeSiteId}`);
@@ -203,6 +213,27 @@ async function initSendGridClient(id, apiKey) {
     });
     sgSiteClients.set(id, client);
 }
+async function initPlausibleClient(id, apiKey, baseUrl) {
+    const client = axios.create({
+        baseURL: (baseUrl || 'https://plausible.io') + '/api/v1/',
+        headers: {
+            'Authorization': `Bearer ${apiKey}`,
+        },
+        timeout: DEFAULT_TIMEOUT_MS,
+    });
+    plSiteClients.set(id, client);
+}
+async function initSlackBotClient(id, botToken) {
+    const client = axios.create({
+        baseURL: 'https://slack.com/api/',
+        headers: {
+            'Authorization': `Bearer ${botToken}`,
+            'Content-Type': 'application/json; charset=utf-8',
+        },
+        timeout: DEFAULT_TIMEOUT_MS,
+    });
+    slackBotClients.set(id, client);
+}
 // ── Site Management ──────────────────────────────────────────────────
 /**
  * Get the active site's client, or a specific site's client
@@ -508,6 +539,114 @@ export async function getGSCAuth(siteId) {
     gscAuthClients.set(id, authClient);
     return authClient;
 }
+// ── Google Analytics 4 Interface ─────────────────────────────────
+const ga4AuthClients = new Map();
+export function hasGA4(siteId) {
+    const id = siteId || activeSiteId;
+    const sites = JSON.parse(process.env.WP_SITES_CONFIG || '[]');
+    const site = sites.find((s) => s.id === id);
+    return !!(site?.ga4_property_id && site?.ga4_service_account_key);
+}
+export function getGA4PropertyId(siteId) {
+    const id = siteId || activeSiteId;
+    const sites = JSON.parse(process.env.WP_SITES_CONFIG || '[]');
+    const site = sites.find((s) => s.id === id);
+    if (!site?.ga4_property_id) {
+        throw new Error(`GA4 property not configured for site "${id}". Add ga4_property_id to WP_SITES_CONFIG.`);
+    }
+    return site.ga4_property_id;
+}
+export async function getGA4Auth(siteId) {
+    const id = siteId || activeSiteId;
+    if (ga4AuthClients.has(id))
+        return ga4AuthClients.get(id);
+    const sites = JSON.parse(process.env.WP_SITES_CONFIG || '[]');
+    const site = sites.find((s) => s.id === id);
+    if (!site?.ga4_service_account_key) {
+        throw new Error(`GA4 not configured for site "${id}". Add ga4_service_account_key to WP_SITES_CONFIG.`);
+    }
+    const keyContent = JSON.parse(readFileSync(site.ga4_service_account_key, 'utf-8'));
+    const auth = new google.auth.GoogleAuth({
+        credentials: keyContent,
+        scopes: ['https://www.googleapis.com/auth/analytics.readonly'],
+    });
+    const authClient = await auth.getClient();
+    ga4AuthClients.set(id, authClient);
+    return authClient;
+}
+// ── Plausible Analytics Interface ────────────────────────────────
+export function hasPlausible(siteId) {
+    const id = siteId || activeSiteId;
+    return plSiteClients.has(id);
+}
+export async function makePlausibleRequest(method, endpoint, params, siteId) {
+    const id = siteId || activeSiteId;
+    const client = plSiteClients.get(id);
+    if (!client) {
+        throw new Error(`Plausible not configured for site "${id}". Add plausible_api_key to WP_SITES_CONFIG.`);
+    }
+    const limiter = getLimiter(id);
+    await limiter.acquire();
+    try {
+        const response = await client.request({ method, url: endpoint, params });
+        return response.data;
+    }
+    finally {
+        limiter.release();
+    }
+}
+// ── Core Web Vitals Interface (Google API Key) ───────────────────
+export function hasGoogleApiKey(siteId) {
+    const id = siteId || activeSiteId;
+    const sites = JSON.parse(process.env.WP_SITES_CONFIG || '[]');
+    const site = sites.find((s) => s.id === id);
+    return !!site?.google_api_key;
+}
+export function getGoogleApiKey(siteId) {
+    const id = siteId || activeSiteId;
+    const sites = JSON.parse(process.env.WP_SITES_CONFIG || '[]');
+    const site = sites.find((s) => s.id === id);
+    if (!site?.google_api_key) {
+        throw new Error(`Google API key not configured for site "${id}". Add google_api_key to WP_SITES_CONFIG.`);
+    }
+    return site.google_api_key;
+}
+// ── Slack Interface ─────────────────────────────────────────────
+export function hasSlackWebhook(siteId) {
+    const id = siteId || activeSiteId;
+    const sites = JSON.parse(process.env.WP_SITES_CONFIG || '[]');
+    const site = sites.find((s) => s.id === id);
+    return !!site?.slack_webhook_url;
+}
+export function getSlackWebhookUrl(siteId) {
+    const id = siteId || activeSiteId;
+    const sites = JSON.parse(process.env.WP_SITES_CONFIG || '[]');
+    const site = sites.find((s) => s.id === id);
+    if (!site?.slack_webhook_url) {
+        throw new Error(`Slack webhook not configured for site "${id}". Add slack_webhook_url to WP_SITES_CONFIG.`);
+    }
+    return site.slack_webhook_url;
+}
+export function hasSlackBot(siteId) {
+    const id = siteId || activeSiteId;
+    return slackBotClients.has(id);
+}
+export async function makeSlackBotRequest(method, endpoint, data, siteId) {
+    const id = siteId || activeSiteId;
+    const client = slackBotClients.get(id);
+    if (!client) {
+        throw new Error(`Slack Bot not configured for site "${id}". Add slack_bot_token to WP_SITES_CONFIG.`);
+    }
+    const limiter = getLimiter(id);
+    await limiter.acquire();
+    try {
+        const response = await client.request({ method, url: endpoint, data });
+        return response.data;
+    }
+    finally {
+        limiter.release();
+    }
+}
 // ── Plugin Repository (External API) ────────────────────────────────
 /**
  * Search the WordPress.org Plugin Repository

package/skills/wordpress-router/SKILL.md

@@ -4,7 +4,7 @@ description: “Use when the user asks about WordPress — whether development (
   blocks, REST API) or operations (deploy, audit, backup, migrate, content management).
   Classifies the task and routes to the correct development or operational skill/agent.”
 compatibility: “Targets WordPress 6.9+ (PHP 7.2.24+). Filesystem-based agent with bash + node. Some workflows require WP-CLI.”
-version: 1.1.0
+version: 1.4.0
 source: “WordPress/agent-skills (GPL-2.0-or-later) + wordpress-manager extensions”
 ---
 

package/skills/wordpress-router/references/decision-tree.md

@@ -1,4 +1,4 @@
-# Router decision tree (v13 — development + local environment + operations + multisite + CI/CD + monitoring + webhooks + content repurposing + programmatic SEO + content attribution + multi-language network + social/email distribution + search console + content optimization)
+# Router decision tree (v16 — development + local environment + operations + multisite + CI/CD + monitoring + webhooks + content repurposing + programmatic SEO + content attribution + multi-language network + social/email distribution + search console + content optimization + analytics + alerting + workflows)
 
 This routing guide covers WordPress **development**, **local environment**, and **operations** workflows.
 
@@ -14,7 +14,7 @@ Keywords that indicate **local environment**:
 local site, Studio, LocalWP, Local by Flywheel, wp-env, local WordPress, start site, stop site, create local site, local development, symlink plugin, local database, switch PHP version, localhost, local preview, detect environment, WASM, SQLite local
 
 Keywords that indicate **operations**:
-deploy, push to production, audit, security check, backup, restore, migrate, move site, create post, manage content, site status, check plugins, performance check, SEO audit, WooCommerce, prodotto, ordine, coupon, negozio, catalogo, inventario, vendite, carrello, multisite, network, sub-site, sub-sito, domain mapping, super admin, network activate, monitor, uptime, health report, trend, scansione periodica, alerting, performance baseline, fleet, all sites, network health, cross-site, webhook, outbound notification, event propagation, Zapier, content sync, repurpose content, social posts from blog, content atomization, newsletter from posts, content distribution, programmatic SEO, template pages, city pages, location pages, bulk page generation, scalable landing pages, content ROI, attribution, which content drives sales, conversion tracking, UTM tracking, revenue per post, multilingual, multi-language, hreflang, international SEO, translate site, language sites, localize content, social publish, schedule post, Buffer, email campaign, Mailchimp, SendGrid, transactional email, content distribution, newsletter send, Google Search Console, GSC, keyword tracking, keyword rankings, search analytics, indexing status, URL inspection, sitemap submit, search performance, SERP data, optimize content, headline scoring, readability analysis, SEO score, content scoring, meta optimization, content freshness, content triage, bulk optimize, Flesch-Kincaid, keyword density
+deploy, push to production, audit, security check, backup, restore, migrate, move site, create post, manage content, site status, check plugins, performance check, SEO audit, WooCommerce, prodotto, ordine, coupon, negozio, catalogo, inventario, vendite, carrello, multisite, network, sub-site, sub-sito, domain mapping, super admin, network activate, monitor, uptime, health report, trend, scansione periodica, alerting, performance baseline, fleet, all sites, network health, cross-site, webhook, outbound notification, event propagation, Zapier, content sync, repurpose content, social posts from blog, content atomization, newsletter from posts, content distribution, programmatic SEO, template pages, city pages, location pages, bulk page generation, scalable landing pages, content ROI, attribution, which content drives sales, conversion tracking, UTM tracking, revenue per post, multilingual, multi-language, hreflang, international SEO, translate site, language sites, localize content, social publish, schedule post, Buffer, email campaign, Mailchimp, SendGrid, transactional email, content distribution, newsletter send, Google Search Console, GSC, keyword tracking, keyword rankings, search analytics, indexing status, URL inspection, sitemap submit, search performance, SERP data, optimize content, headline scoring, readability analysis, SEO score, content scoring, meta optimization, content freshness, content triage, bulk optimize, Flesch-Kincaid, keyword density, Google Analytics, GA4, traffic analytics, pageviews, sessions, user analytics, Plausible, privacy analytics, Core Web Vitals, CWV, LCP, INP, CLS, PageSpeed, page speed, site speed, performance score, Slack alert, email alert, notification channel, alert threshold, severity routing, escalation, incident notification, uptime alert, error alert, performance alert, scheduled report, health digest, alert cooldown, alert dedup, workflow trigger, automation, scheduled event, content lifecycle, cron trigger, hook trigger, workflow rule, automate, trigger management
 
 Keywords that indicate **development**:
 create block, block.json, theme.json, register_rest_route, plugin development, hooks, PHPStan, build, test, scaffold, i18n, translation, accessibility, a11y, headless, decoupled, WPGraphQL, CI, CD, pipeline, GitHub Actions, GitLab CI, deploy automatico, workflow, quality gate
@@ -110,6 +110,12 @@ Priority: `gutenberg` > `wp-core` > `wp-site` > `wp-block-theme` > `wp-block-plu
   → `wp-search-console` skill + `wp-content-strategist` agent
 - **Content optimization / headline scoring / readability / SEO score / meta optimization / content freshness / content triage / optimize posts / Flesch-Kincaid / keyword density**
   → `wp-content-optimization` skill + `wp-content-strategist` agent
+- **Google Analytics / GA4 / Plausible / traffic analytics / pageviews / sessions / user analytics / Core Web Vitals / CWV / PageSpeed / site speed / performance score**
+  → `wp-analytics` skill + `wp-monitoring-agent` agent
+- **Slack alert / email alert / notification channel / alert threshold / severity routing / escalation / incident notification / uptime alert / performance alert / scheduled report / health digest / alert cooldown**
+  → `wp-alerting` skill + `wp-monitoring-agent` agent
+- **Workflow trigger / automation / scheduled event / content lifecycle / cron trigger / hook trigger / workflow rule / automate / trigger management**
+  → `wp-content-workflows` skill + `wp-site-manager` agent
 
 ## Step 2c: route by local environment intent (keywords)