@respira/wordpress-mcp-server 7.3.0 → 7.4.1

package/skills/wordpress-site-dna/telemetry.ts

@@ -0,0 +1,137 @@
+/**
+ * WordPress Site DNA — Telemetry helper
+ * Fire-and-forget usage tracking to respira.press/api/skills/track-usage
+ * Never blocks skill execution.
+ */
+
+export interface SiteDNATelemetry {
+  session_id: string;
+  user_id?: string | null;
+  wordpress_site_url?: string;
+  wordpress_version?: string;
+  php_version?: string;
+  started_at: string;
+  completed_at?: string;
+  duration_ms?: number;
+  success: boolean;
+  error_message?: string | null;
+  issues_found?: number;
+  issues_by_severity?: {
+    critical: number;
+    high: number;
+    medium: number;
+    low: number;
+    info?: number;
+  };
+  health_score?: number;
+  mcp_tools_used?: string[];
+  findings_summary?: Record<string, unknown>;
+  had_respira_before?: boolean;
+  installed_respira_after?: boolean;
+  assistant_client?: string;
+  assistant_version?: string;
+  assistant_transport?: string;
+  telemetry_source?: string;
+}
+
+const TELEMETRY_ENDPOINT = 'https://www.respira.press/api/skills/track-usage';
+
+function detectAssistantTelemetry(): {
+  assistant_client?: string;
+  assistant_version?: string;
+  assistant_transport?: string;
+  telemetry_source?: string;
+} {
+  const env: Record<string, string | undefined> =
+    typeof process !== 'undefined' && process?.env ? (process.env as Record<string, string | undefined>) : {};
+
+  const explicitClient = env.RESPIRA_AGENT_CLIENT || env.MCP_AGENT_CLIENT || env.AI_AGENT_CLIENT;
+  const explicitTransport = env.RESPIRA_AGENT_TRANSPORT || env.MCP_AGENT_TRANSPORT;
+  const explicitVersion = env.RESPIRA_AGENT_VERSION || env.MCP_AGENT_VERSION || env.AI_AGENT_VERSION;
+
+  const fingerprint = [
+    explicitClient,
+    env.CURSOR_AGENT,
+    env.CURSOR_TRACE_ID,
+    env.CLAUDECODE,
+    env.CLAUDE_CODE_ENTRYPOINT,
+    env.CODEIUM_ENV,
+    env.TERM_PROGRAM,
+    env.TERM_PROGRAM_VERSION,
+    typeof navigator !== 'undefined' ? navigator.userAgent : '',
+  ]
+    .filter(Boolean)
+    .join(' ')
+    .toLowerCase();
+
+  const inferredClient = (() => {
+    if (explicitClient) return explicitClient.toLowerCase();
+    if (fingerprint.includes('cursor')) return 'cursor';
+    if (fingerprint.includes('claude')) return 'claude-code';
+    if (fingerprint.includes('codex')) return 'codex';
+    if (fingerprint.includes('windsurf') || fingerprint.includes('codeium')) return 'windsurf';
+    if (fingerprint.includes('copilot')) return 'copilot';
+    if (fingerprint.includes('gemini')) return 'gemini';
+    return undefined;
+  })();
+
+  return {
+    assistant_client: inferredClient,
+    assistant_version: explicitVersion?.toLowerCase(),
+    assistant_transport: (explicitTransport || 'desktop-mcp').toLowerCase(),
+    telemetry_source: explicitClient ? 'env' : inferredClient ? 'heuristic' : 'skill-fetch',
+  };
+}
+
+/**
+ * Send skill usage telemetry.
+ * Non-blocking: errors are swallowed, never thrown.
+ * Call after the skill completes — success or failure.
+ */
+export function trackSkillUsage(data: SiteDNATelemetry): void {
+  const detected = detectAssistantTelemetry();
+  const payload = {
+    skill_slug: 'wordpress-site-dna',
+    had_respira_before: true,
+    ...detected,
+    ...data,
+  };
+
+  const headers: Record<string, string> = {
+    'Content-Type': 'application/json',
+  };
+
+  if (payload.assistant_client) {
+    headers['X-Respira-Agent-Client'] = payload.assistant_client;
+  }
+  if (payload.assistant_version) {
+    headers['X-Respira-Agent-Version'] = payload.assistant_version;
+  }
+  if (payload.assistant_transport) {
+    headers['X-Respira-Agent-Transport'] = payload.assistant_transport;
+  }
+
+  // Fire and forget — intentionally not awaited
+  fetch(TELEMETRY_ENDPOINT, {
+    method: 'POST',
+    headers,
+    body: JSON.stringify(payload),
+  }).catch(() => {
+    // Silently swallow all errors — telemetry must never break the skill
+  });
+}
+
+/**
+ * Generate a session ID for tracking a single skill run.
+ */
+export function generateSessionId(): string {
+  if (typeof crypto !== 'undefined' && crypto.randomUUID) {
+    return crypto.randomUUID();
+  }
+  // Fallback for environments without crypto.randomUUID
+  return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, (c) => {
+    const r = (Math.random() * 16) | 0;
+    const v = c === 'x' ? r : (r & 0x3) | 0x8;
+    return v.toString(16);
+  });
+}

package/dist/__tests__/acf-tool-routing.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=acf-tool-routing.test.d.ts.map

package/dist/__tests__/acf-tool-routing.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"acf-tool-routing.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/acf-tool-routing.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/acf-tool-routing.test.js

@@ -1,37 +0,0 @@
-import { test } from 'node:test';
-import assert from 'node:assert';
-import { ACF_TOOL_NAMES, resolveAcfToolName } from '../acf-tools.js';
-// Regression guard for the "Unknown tool: wordpress_acf_*" bug (kenbi/Pedro,
-// 2026-07-14). normalizeToolName() rewrites respira_* -> wordpress_* before
-// dispatch, so ACF calls reach dispatchToolCall as wordpress_acf_*. Every ACF
-// tool must still resolve to its respira_acf_* canonical (the name ACF_ROUTES
-// and the plugin REST endpoints are keyed by), from BOTH prefixes.
-test('every ACF tool resolves from respira_ and post-normalization wordpress_ prefixes', () => {
-    assert.ok(ACF_TOOL_NAMES.size > 0, 'ACF_TOOL_NAMES should not be empty');
-    for (const respiraName of ACF_TOOL_NAMES) {
-        // called directly as advertised
-        assert.equal(resolveAcfToolName(respiraName), respiraName, `direct: ${respiraName}`);
-        // as it arrives after normalizeToolName strips respira_ -> wordpress_
-        const normalized = 'wordpress_acf_' + respiraName.slice('respira_acf_'.length);
-        assert.equal(resolveAcfToolName(normalized), respiraName, `normalized: ${normalized}`);
-    }
-});
-test('the four repeater write/read tools route (Pedro repro)', () => {
-    for (const t of [
-        'respira_acf_get_repeater',
-        'respira_acf_get_repeater_row',
-        'respira_acf_add_repeater_row',
-        'respira_acf_update_repeater_row',
-    ]) {
-        const normalized = 'wordpress_acf_' + t.slice('respira_acf_'.length);
-        assert.equal(resolveAcfToolName(normalized), t, `repeater: ${normalized}`);
-    }
-});
-test('non-ACF tools are never misrouted to the ACF dispatcher', () => {
-    assert.equal(resolveAcfToolName('wordpress_update_page'), null);
-    assert.equal(resolveAcfToolName('respira_find_element'), null);
-    assert.equal(resolveAcfToolName('wordpress_update_post'), null);
-    // a lookalike that is not a real ACF tool must not resolve
-    assert.equal(resolveAcfToolName('wordpress_acf_not_a_real_tool'), null);
-});
-//# sourceMappingURL=acf-tool-routing.test.js.map

package/dist/__tests__/acf-tool-routing.test.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"acf-tool-routing.test.js","sourceRoot":"","sources":["../../src/__tests__/acf-tool-routing.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAErE,6EAA6E;AAC7E,4EAA4E;AAC5E,8EAA8E;AAC9E,8EAA8E;AAC9E,mEAAmE;AACnE,IAAI,CAAC,kFAAkF,EAAE,GAAG,EAAE;IAC5F,MAAM,CAAC,EAAE,CAAC,cAAc,CAAC,IAAI,GAAG,CAAC,EAAE,oCAAoC,CAAC,CAAC;IACzE,KAAK,MAAM,WAAW,IAAI,cAAc,EAAE,CAAC;QACzC,gCAAgC;QAChC,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,WAAW,CAAC,EAAE,WAAW,EAAE,WAAW,WAAW,EAAE,CAAC,CAAC;QACrF,sEAAsE;QACtE,MAAM,UAAU,GAAG,gBAAgB,GAAG,WAAW,CAAC,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;QAC/E,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,UAAU,CAAC,EAAE,WAAW,EAAE,eAAe,UAAU,EAAE,CAAC,CAAC;IACzF,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,wDAAwD,EAAE,GAAG,EAAE;IAClE,KAAK,MAAM,CAAC,IAAI;QACd,0BAA0B;QAC1B,8BAA8B;QAC9B,8BAA8B;QAC9B,iCAAiC;KAClC,EAAE,CAAC;QACF,MAAM,UAAU,GAAG,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;QACrE,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,UAAU,CAAC,EAAE,CAAC,EAAE,aAAa,UAAU,EAAE,CAAC,CAAC;IAC7E,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,yDAAyD,EAAE,GAAG,EAAE;IACnE,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,uBAAuB,CAAC,EAAE,IAAI,CAAC,CAAC;IAChE,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,sBAAsB,CAAC,EAAE,IAAI,CAAC,CAAC;IAC/D,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,uBAAuB,CAAC,EAAE,IAAI,CAAC,CAAC;IAChE,2DAA2D;IAC3D,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,+BAA+B,CAAC,EAAE,IAAI,CAAC,CAAC;AAC1E,CAAC,CAAC,CAAC"}

package/dist/__tests__/cowork-bootstrap.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=cowork-bootstrap.test.d.ts.map

package/dist/__tests__/cowork-bootstrap.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"cowork-bootstrap.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/cowork-bootstrap.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/cowork-bootstrap.test.js

@@ -1,61 +0,0 @@
-import { test } from 'node:test';
-import assert from 'node:assert/strict';
-import { loadConfig } from '../config.js';
-// A path that reliably does not exist, standing in for the Cowork/Windows case
-// where RESPIRA_CONFIG_FILE resolves to a sandbox home path the user's real
-// ~/.respira/config.json (written to the Windows home) never occupies.
-const MISSING = '/tmp/respira-nonexistent-cowork-test-xyz/config.json';
-const ENV_KEYS = [
-    'RESPIRA_CONFIG_FILE',
-    'RESPIRA_CONFIG_B64',
-    'RESPIRA_CONFIG_MODE',
-    'RESPIRA_BOOTSTRAP_OK',
-    'RESPIRA_STRICT_CONFIG',
-    'WORDPRESS_URL',
-    'WORDPRESS_API_KEY',
-];
-function withEnv(overrides, fn) {
-    const saved = {};
-    for (const k of ENV_KEYS) {
-        saved[k] = process.env[k];
-        delete process.env[k];
-    }
-    for (const [k, v] of Object.entries(overrides)) {
-        if (v === undefined)
-            delete process.env[k];
-        else
-            process.env[k] = v;
-    }
-    try {
-        fn();
-    }
-    finally {
-        for (const k of ENV_KEYS) {
-            if (saved[k] === undefined)
-                delete process.env[k];
-            else
-                process.env[k] = saved[k];
-        }
-    }
-}
-test('missing RESPIRA_CONFIG_FILE boots to bootstrap mode by default (no throw, zero sites)', () => {
-    withEnv({ RESPIRA_CONFIG_FILE: MISSING }, () => {
-        const config = loadConfig();
-        assert.deepEqual(config.sites, []);
-    });
-});
-test('bootstrap-by-default holds even WITHOUT RESPIRA_BOOTSTRAP_OK (Cowork/Windows sandbox-home case, Igor / prisma.gallery)', () => {
-    // Pre-fix, a missing config file with BOOTSTRAP_OK unset threw and the npx
-    // server exited, so Cowork advertised zero tools. Now it must boot so
-    // respira_redeem_token stays reachable and the user can self-provision.
-    withEnv({ RESPIRA_CONFIG_FILE: MISSING, RESPIRA_BOOTSTRAP_OK: undefined }, () => {
-        const config = loadConfig();
-        assert.deepEqual(config.sites, []);
-    });
-});
-test('RESPIRA_STRICT_CONFIG=1 restores the hard startup failure on a missing config file', () => {
-    withEnv({ RESPIRA_CONFIG_FILE: MISSING, RESPIRA_STRICT_CONFIG: '1' }, () => {
-        assert.throws(() => loadConfig(), /missing file|No WordPress sites/);
-    });
-});
-//# sourceMappingURL=cowork-bootstrap.test.js.map

package/dist/__tests__/cowork-bootstrap.test.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"cowork-bootstrap.test.js","sourceRoot":"","sources":["../../src/__tests__/cowork-bootstrap.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,+EAA+E;AAC/E,4EAA4E;AAC5E,uEAAuE;AACvE,MAAM,OAAO,GAAG,sDAAsD,CAAC;AAEvE,MAAM,QAAQ,GAAG;IACf,qBAAqB;IACrB,oBAAoB;IACpB,qBAAqB;IACrB,sBAAsB;IACtB,uBAAuB;IACvB,eAAe;IACf,mBAAmB;CACpB,CAAC;AAEF,SAAS,OAAO,CAAC,SAA6C,EAAE,EAAc;IAC5E,MAAM,KAAK,GAAuC,EAAE,CAAC;IACrD,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,KAAK,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QAC1B,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACxB,CAAC;IACD,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QAC/C,IAAI,CAAC,KAAK,SAAS;YAAE,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;;YACtC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAC1B,CAAC;IACD,IAAI,CAAC;QACH,EAAE,EAAE,CAAC;IACP,CAAC;YAAS,CAAC;QACT,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;YACzB,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,SAAS;gBAAE,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;;gBAC7C,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;AACH,CAAC;AAED,IAAI,CAAC,uFAAuF,EAAE,GAAG,EAAE;IACjG,OAAO,CAAC,EAAE,mBAAmB,EAAE,OAAO,EAAE,EAAE,GAAG,EAAE;QAC7C,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;QAC5B,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,wHAAwH,EAAE,GAAG,EAAE;IAClI,2EAA2E;IAC3E,sEAAsE;IACtE,wEAAwE;IACxE,OAAO,CAAC,EAAE,mBAAmB,EAAE,OAAO,EAAE,oBAAoB,EAAE,SAAS,EAAE,EAAE,GAAG,EAAE;QAC9E,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;QAC5B,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,oFAAoF,EAAE,GAAG,EAAE;IAC9F,OAAO,CAAC,EAAE,mBAAmB,EAAE,OAAO,EAAE,qBAAqB,EAAE,GAAG,EAAE,EAAE,GAAG,EAAE;QACzE,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,UAAU,EAAE,EAAE,iCAAiC,CAAC,CAAC;IACvE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}